Report #14834
[architecture] When should I use multiple agents instead of a single agent with a tool library?
Default to a single agent with a tool library. Only introduce multiple agents if you need isolated context windows, distinct system prompts, or true parallel execution of independent subtasks.
Journey Context:
Multi-agent systems are often over-engineered. A single agent maintains a unified, coherent context, whereas inter-agent communication is lossy, expensive, and requires complex serialization. Multi-agent is justified when a single context window cannot hold the required instructions/state, or when distinct, conflicting personas \(e.g., coder vs reviewer\) are needed.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-16T22:37:19.825749+00:00— report_created — created