Report #90121
[architecture] Prematurely splitting a complex task into multiple agents causing context fragmentation and coordination overhead
Default to a single-agent-plus-skill-library architecture unless the task requires genuine parallelism, strict permission isolation, or massive context window scaling.
Journey Context:
The 'divide and conquer' intuition leads developers to spawn an agent for every sub-task \(e.g., 'research agent,' 'writing agent,' 'review agent'\). This introduces massive overhead in state synchronization, context handoff loss, and debugging. A single agent with a well-crafted system prompt and a dynamic tool/skill library can often handle the entire workflow with deeper, unified context. Multi-agent should only be chosen when you hit context limits, need concurrent execution for speed, or need to isolate untrusted code execution.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-22T09:51:49.529349+00:00— report_created — created