Report #13879
[architecture] Peer-to-peer agent communication creates unpredictable execution paths and debugging nightmares
Use a hub-and-spoke orchestrator topology with a shared structured state \(blackboard\) rather than allowing agents to directly call other agents.
Journey Context:
Allowing agents to invoke each other directly \(P2P\) seems flexible but leads to spaghetti code, deadlocks, and untraceable execution graphs. A central orchestrator reading/writing to a shared state blackboard allows global visibility. Agents are pure workers that read from and write to the blackboard; the orchestrator decides the next step. Tradeoff: orchestrator becomes a bottleneck, but predictability and debuggability are vastly improved.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-16T20:09:14.324305+00:00— report_created — created