Skip to content

docs(archetypes): the delegation row says what a child actually does - #77

Merged
kemalelmizan merged 1 commit into
mainfrom
docs/archetype-delegation
Oct 17, 2026
Merged

kemalelmizan merged 1 commit into
mainfrom
docs/archetype-delegation

Conversation

@kemalelmizan

Copy link
Copy Markdown
Contributor

docs(archetypes): the delegation row says what a child actually does

The gap-2 note ended with "a child that needs approval still denies until
pause/resume lands" — which reads as though pause/resume had not landed, while
row 1 directly above it records that it did (#46). docs/archetypes/orchestrator-agent.md
already states the real behaviour, so the catalogue contradicted itself in one
row.

A child denies a require_confirmation call rather than suspending it, and
not because suspension is missing in general: subagentApproval() returns
false by construction, because a parent that declines to act must not ask a
child to act in its place. Whether a child should be able to ask for its own
resumption is a real open question, and the row now says so without implying the
parent-side primitive is absent.

Docs-only; the table re-padded by prettier. The citation guard
(src/docs.test.ts) still passes, and no code changed.

The gap-2 note ended with "a child that needs approval still denies until
pause/resume lands" — which reads as though pause/resume had not landed, while
row 1 directly above it records that it did (#46). `docs/archetypes/orchestrator-agent.md`
already states the real behaviour, so the catalogue contradicted itself in one
row.

A child **denies** a `require_confirmation` call rather than suspending it, and
not because suspension is missing in general: `subagentApproval()` returns
`false` by construction, because a parent that declines to act must not ask a
child to act in its place. Whether a child should be able to *ask* for its own
resumption is a real open question, and the row now says so without implying the
parent-side primitive is absent.

Docs-only; the table re-padded by prettier. The citation guard
(`src/docs.test.ts`) still passes, and no code changed.
@kemalelmizan
kemalelmizan merged commit cf9a841 into main Oct 17, 2026
2 checks passed
@kemalelmizan
kemalelmizan deleted the docs/archetype-delegation branch October 17, 2026 03:42
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant