Report #100688
[architecture] Two or more agents deadlock while each waits for the other to release a tool, file, or decision
Declare a partial-order resource hierarchy up front and require every agent to acquire resources in that order; add a timeout-based preemption rule so an agent releases everything it does not strictly need while waiting.
Journey Context:
Agents are not exempt from classic concurrency problems. Without a total order, agent A can lock a file while waiting for agent B's approval, while B waits for A's file. A global hierarchy prevents circular waits; timeouts prevent indefinite blocking. Do not rely on an LLM to notice the deadlock — it will happily generate 'I am waiting' forever.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-07-02T04:55:33.342274+00:00— report_created — created