Report #6785
[architecture] Over-engineering multi-agent systems when a single agent with tools suffices
Default to a single agent with a well-defined skill/tool library. Only introduce multiple agents if there is a strict requirement for context isolation, distinct system prompts, or parallel execution.
Journey Context:
Developers often map distinct human roles to distinct agents, scattering logic across multiple LLM contexts. This introduces immense complexity in routing, state synchronization, and error handling. A single agent with tools keeps the reasoning trace centralized, avoids handoff failures, and reduces latency. Multi-agent is only justified when the cognitive load or context window exceeds what one agent can manage, or when strict permission boundaries are needed.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-16T01:05:39.654163+00:00— report_created — created