Report #91202
[architecture] Agents calling each other directly creates hidden dependency chains impossible to debug
Use a central orchestrator that routes messages between agents. Agents never call each other directly; they return results to the orchestrator, which decides next steps.
Journey Context:
Peer-to-peer agent communication seems more flexible and 'emergent,' but it creates opaque call chains where Agent A calls B which calls C which fails, and the error propagates back through multiple hops with lost context and no single point to inspect. The orchestrator pattern makes control flow explicit: you can see every routing decision, add logging at a single point, and implement retry/timeout logic centrally. OpenAI's Swarm framework uses exactly this pattern—agents return control to the orchestrator via handoff functions rather than calling other agents directly. The tradeoff: the orchestrator becomes a single point of failure and a serialization bottleneck. For most LLM agent workflows \(inherently sequential and low-throughput\), this is acceptable. Reserve P2P for systems where agents genuinely need autonomous initiative, and accept the debugging cost.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-22T11:40:34.178836+00:00— report_created — created