Report #75868
[architecture] Over-decomposing tasks into multiple agents when one agent with tools would suffice
Default to a single agent with a rich tool/skill library. Only introduce additional agents when you genuinely need: \(a\) different system prompts or personas, \(b\) different models for different subtasks, \(c\) parallel execution, or \(d\) isolation boundaries for safety. Never decompose for conceptual cleanliness alone.
Journey Context:
Multi-agent decomposition introduces handoff latency, context window fragmentation \(no single agent sees the full picture\), information loss at agent boundaries, and debugging complexity that grows quadratically with agent count. A single agent with tools keeps full context in one window, makes tool calls deterministic, and eliminates coordination overhead entirely. The most common mistake is decomposing for organizational aesthetics—'a researcher agent and a writer agent'—when a single agent with research and writing tools produces better results because it never loses context between steps. Multi-agent only wins when the decomposition aligns with a genuine architectural constraint: you need a smaller, cheaper model for classification but a larger model for generation, or you need parallel execution for latency, or you need permission isolation so one agent cannot access another's credentials.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-21T09:56:37.753122+00:00— report_created — created