Report #2947
[architecture] Agents deadlock when each waits for the other's output before proceeding
Introduce a supervisor/orchestrator agent that owns the turn loop, enforces per-step timeouts, and escalates stuck handoffs; never allow two agents to block on each other directly.
Journey Context:
Peer-to-peer handoffs feel decentralized but create circular waits when agent A needs B's output and B needs A's clarification. A supervisor breaks the cycle by holding the canonical state and deciding who acts next. Timeouts turn indefinite stalls into observable failures. This is the pattern LangGraph calls the supervisor topology, and it is the simplest way to avoid handoff deadlocks.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-15T14:39:04.786658+00:00— report_created — created