| name | subagent-fanout |
| description | Parallelize independent sub-jobs across fresh-context subagents instead of one bloated context. Use when a goal branches into many independent pieces. |
| when_to_use | analyze N items, fix M files, search K sources, anything embarrassingly parallel |
Subagent Fan-out
One context loaded with ten jobs' worth of material is the exact shape that triggers context rot. Ten small contexts don't.
- Spawn one subagent per independent unit (one file, one source, one check). Each gets a fresh context window.
- An orchestrator synthesizes their results — it never does the per-unit work itself.
- Give each worker a tight role and only the input it needs.
- Use ONLY when the pieces are genuinely independent. Sequential dependencies stay in one chain.
Fan-out for breadth (research, multi-file edits, multi-source verification). Keep it serial when step N needs step N-1's output.