Coordinator-subagent orchestration
What this covers
- Explain the benefits and costs of routing subagent communication through a coordinator
- Select subagents based on what the query needs rather than always running the full pipeline
- Partition scope so subagents do not duplicate each other
- Put everything a subagent needs into its prompt, because it inherits no conversation history
- Recognize over-narrow decomposition by slices that are each correct while the question goes unanswered
- Decide when a single agent holding every tool beats decomposing at all
process plate / 1.2
Delegate only when the work can be separated
Decide how to divide the work. The coordinator can keep an inseparable task together, brief separate specialists, or assign a focused follow-up when the combined answer has a gap.
process reading / one bounded task
Keep one agent.
The work uses one small context and one manageable tool set; delegation would only resend context and add a handoff.
Read the complete diagram as text
- Inspect whether the task contains separable scopes before delegating.
- Put every required constraint and expected output into each isolated subagent prompt.
- Route every result and failure back through the coordinator rather than between siblings.
- Check the combined answer for coverage and re-delegate only the missing scope.
- Keep inseparable work in one agent when handoffs would add no architectural benefit.
Key terms
In a hub-and-spoke architecture, one coordinator sends work to the subagents and receives their results and errors. Subagents do not communicate directly with one another.
Why route everything through the hub
Central routing is what makes a multi-agent system observable. One place shows what was delegated, what came back, and what failed. It's also the only place error handling can be applied consistently.
Direct communication between subagents may reduce latency, but it makes the system harder to monitor. The coordinator no longer has a complete record of what each subagent did.
Isolated context is the default
A subagent does not inherit the coordinator's history. Whatever it needs has to be in the prompt you send it. If the prompt omits a constraint known by the coordinator, the subagent may confidently produce an answer that violates that constraint.
Ask a classmate to draft the methods section and they draft it from what you told them. Nothing in their work can reflect the professor's revised brief if you forgot to forward it, and they have no way to notice it's missing.
Siblings are invisible to each other too. Two subagents running from the same coordinator share nothing, so neither can see what the other covered or avoid repeating it. Ordering them doesn't help; only the coordinator can keep them apart, by sending each one a different scope.
Choose subagents for the request
A coordinator should inspect the request and invoke only the subagents needed to answer it. If it always runs the same sequence, it behaves like a fixed pipeline and doesn't adapt to the request.
Divide the work without creating too many subagents
Split scope so two subagents are not researching the same thing — distinct subtopics, distinct source types.
But decomposition can go too far. Slice a broad research question narrowly enough and every subagent answers its sliver correctly while the question as a whole goes unanswered. Coverage is the coordinator's responsibility: evaluate the synthesis for gaps, re-delegate with targeted follow-ups, and synthesize again until the answer is actually complete.
When not to decompose at all
Decomposition can also be wrong from the start. Splitting gives each agent its own scope and tool access, and it can allow work to run in parallel. The tradeoff is more handoffs and repeated context for every separate agent. Where the work has no separable scope, one agent holding every tool is the cheaper design.
Claude Agent SDKAgent toolcoordinator agents
Field note — common misconceptions
- MythThat subagents inherit the coordinator's conversation history
- ActuallyWhatever a subagent needs has to be in the prompt you send it; its context starts isolated.
- MythThat finer decomposition is always better decomposition
- ActuallySlice too narrowly and every subagent answers its sliver while the whole question goes unanswered.
- MythThat letting subagents call each other is a reasonable optimization
- ActuallyDirect edges buy a little latency and cost you observability and one place to handle errors.
Guided review
Review this lesson as a study deck
Review the lesson's main ideas in five guided slides, then test yourself with three flashcards.
Open Task 1.2 study deckCross-domain reasoning
Connect this idea
Delegation depends on context
A delegated task succeeds only when its scope is clear and the receiving agent gets the instructions, facts, saved state, and sources it needs.
- 1.3 · Configure subagent invocation, context passing, and spawning
- 1.6 · Design task decomposition strategies for complex workflows
- 5.1 · Manage conversation context to preserve critical information
- 5.4 · Manage context effectively in large codebase exploration
- 5.6 · Preserve information provenance and handle uncertainty in multi-agent systems
Applied practice
Practice this lesson in a lab
Use a related lab to create a decision, implementation or diagram, evidence record, and review.
- Lab 2 · Coordinator and specialist agents
Coordinate three bounded specialists without losing provenance or hiding a coverage gap.