Orchestrate Agent Work
Use this skill at the delegation boundary. The coordinator owns the user goal,
decomposition, authority, final decision, validation, and closure; workers own
only their assigned slice.
Workflow
- Confirm delegation is requested or required by the active workflow. Prefer a
single agent when the work is sequential or one small write target.
- Split only independent work. Assign one coordinator and one owner per
artifact, worktree, branch, validation lane, and external side effect.
- Give every worker a launch envelope:
- task and coordinator identity;
- objective, bounded scope, inputs, and source-of-truth locations;
- allowed and forbidden actions, including write authority;
- acceptance criteria, validation owner, and output location;
- required terminal report and escalation conditions.
- State whether the coordinator waits for all results, consumes partial
reports, or hands work to a durable task surface.
- Track each worker until it is
completed, blocked, needs-decision,
cancelled, or failed. A worker must not silently stop.
- Acknowledge each result: consume it, request one bounded follow-up, mark it
superseded, or cancel it explicitly. Then synthesize and verify the result
in the coordinator thread.
Worker Report Contract
Require the final report to contain the terminal state, outcome, evidence or
artifacts, validation run or intentionally skipped, uncertainty, and one
recommended next action. Workers escalate rather than improvise when scope,
authority, ownership, evidence, or acceptance criteria change.
Boundaries
- Keep user-facing decisions, final edits, merge, release, and final validation
with the coordinator unless a user-approved disjoint ownership plan says
otherwise.
- Default to one delegation layer. Nested orchestration needs an explicit
reason, bounded fan-out/depth, and host support.
- Use
coordinate-external-agents when work crosses a host, session, or
durable ownership boundary.
- Use
coordinate-worktrees-and-threads when workers need repository state.
When the selected host is Codex and the worktree mode, local environment, or
app-owned thread association needs a decision, compose it with
repository-skills:codex-gui-worktree-workflow. On Hermes or another host,
keep the ownership contract host-neutral and use ordinary Git worktrees.
1---2name: orchestrate-agent-work3description: Coordinate bounded worker tasks with a launch envelope, report-back, escalation, and synthesis contract. Use before spawning, resuming, steering, cancelling, or closing subagents.4---56# Orchestrate Agent Work78Use this skill at the delegation boundary. The coordinator owns the user goal,9decomposition, authority, final decision, validation, and closure; workers own10only their assigned slice.1112## Workflow13141. Confirm delegation is requested or required by the active workflow. Prefer a15 single agent when the work is sequential or one small write target.162. Split only independent work. Assign one coordinator and one owner per17 artifact, worktree, branch, validation lane, and external side effect.183. Give every worker a launch envelope:19 - task and coordinator identity;20 - objective, bounded scope, inputs, and source-of-truth locations;21 - allowed and forbidden actions, including write authority;22 - acceptance criteria, validation owner, and output location;23 - required terminal report and escalation conditions.244. State whether the coordinator waits for all results, consumes partial25 reports, or hands work to a durable task surface.265. Track each worker until it is `completed`, `blocked`, `needs-decision`,27 `cancelled`, or `failed`. A worker must not silently stop.286. Acknowledge each result: consume it, request one bounded follow-up, mark it29 superseded, or cancel it explicitly. Then synthesize and verify the result30 in the coordinator thread.3132## Worker Report Contract3334Require the final report to contain the terminal state, outcome, evidence or35artifacts, validation run or intentionally skipped, uncertainty, and one36recommended next action. Workers escalate rather than improvise when scope,37authority, ownership, evidence, or acceptance criteria change.3839## Boundaries4041- Keep user-facing decisions, final edits, merge, release, and final validation42 with the coordinator unless a user-approved disjoint ownership plan says43 otherwise.44- Default to one delegation layer. Nested orchestration needs an explicit45 reason, bounded fan-out/depth, and host support.46- Use `coordinate-external-agents` when work crosses a host, session, or47 durable ownership boundary.48- Use `coordinate-worktrees-and-threads` when workers need repository state.49 When the selected host is Codex and the worktree mode, local environment, or50 app-owned thread association needs a decision, compose it with51 `repository-skills:codex-gui-worktree-workflow`. On Hermes or another host,52 keep the ownership contract host-neutral and use ordinary Git worktrees.