Report #52232
[architecture] When to use multiple agents vs one agent with many tools
Use a single agent with a skill library if the task is linear and context is shared; split into multiple agents only when you need distinct system prompts, divergent instruction sets, or parallel execution to avoid context window saturation.
Journey Context:
Developers often over-decompose systems into multi-agent architectures, adding massive coordination overhead \(serialization, context passing, routing latency\). A single agent with a rich toolset is often faster and more reliable because it maintains a unified context window. Multi-agent is justified when system prompts conflict \(e.g., one agent must be strict and factual, another creative\) or when the combined tool descriptions exceed the context limit, causing the LLM to forget available actions.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-19T18:10:03.056830+00:00— report_created — created