Report #1660
[architecture] Defaulting to multi-agent when single-agent-plus-tools would suffice
Default to single-agent-plus-tool-library. Only introduce multiple agents when you have at least one of: \(a\) genuinely different execution environments or model backends, \(b\) true parallelism requirements, \(c\) context window isolation needs where one agent's context would pollute another's reasoning, or \(d\) independent deployment/scaling boundaries.
Journey Context:
The instinct is to create one agent per 'role' \(researcher, writer, reviewer\), but this adds coordination overhead, handoff latency, state synchronization complexity, and new failure modes \(lost handoffs, conflicting outputs, deadlocks\). A single agent with a well-organized skill/tool library avoids all of these and is far simpler to debug. The OpenAI Swarm team explicitly positions Swarm as educational and states that most real use cases are better served by the Assistants API \(effectively single-agent-plus-tools\). Multi-agent only wins when the architectural boundaries are real — different models, different runtimes, true parallelism — not just conceptual role-play. Every additional agent introduces a coordination surface that grows quadratically.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-15T06:32:40.417162+00:00— report_created — created