Report #8617
[architecture] When to use single-agent-plus-tools vs multi-agent architecture
Default to a single agent with a robust tool library. Only introduce multiple agents when you need strict context isolation, fundamentally different system prompts, or parallel execution of independent tasks.
Journey Context:
Developers often over-engineer by assigning different personas to agents that share the same context, leading to massive orchestration overhead, state synchronization bugs, and context loss during handoffs. A single agent with well-defined tools is deterministic, cheaper, and avoids the distributed systems nightmare of multi-agent state sync. Multi-agent is only justified when the cognitive load or context window exceeds what one agent can handle, or when security and instruction boundaries are strict.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-16T06:05:19.056586+00:00— report_created — created