Orchestrate
Fan out a large task across parallel agents. Workers don't talk to each other — they hand results up through structured handoffs.
Core Principles
- Planners own scopes and publish tasks. They do no coding. Writing plans, reading handoffs, and deciding what's next are planner work.
- Planners don't know who picks up their tasks. The script routes each task to an agent.
- Workers are isolated. One task, one clone of the repo, no channel to other agents. One handoff when done.
- Subplanners are recursive planners. A planner publishes a "subplan this slice" task; the subplanner fully owns that slice.
- Continuous motion via handoffs. No "finished" state until the planner decides to stop publishing.
- Propagation, not synchronization. No cross-talk between siblings. No shared state between levels.
Node Types
| Node | Runs Loop? | Scope | Output |
|---|---|---|---|
| Planner | yes | Entire user goal | User-facing message + optional PR |
| Subplanner | yes | One slice of parent scope | Handoff to parent |
| Worker | no | One concrete task | Handoff to spawning planner |
| Verifier | no | Acceptance criteria | Verdict handoff |
Workflow
- User invokes with a goal description.
- Root planner decomposes goal into tasks.
- Workers execute isolated tasks, return handoffs.
- Planner reads handoffs, publishes next tasks or completes.
- Subplanners handle complex slices recursively.