Report #92626
[architecture] Expecting all agents to have a perfectly consistent view of shared state at all times, leading to complex locking, deadlocks, or stale reads
Design for eventual consistency using an append-only event log \(blackboard pattern\). Agents subscribe to the event stream and maintain their own local derived state. Include timestamps and sequence numbers so agents can detect staleness before acting.
Journey Context:
Distributed systems 101: you cannot have consistency, availability, and partition tolerance simultaneously. Multi-agent systems are distributed systems. The mistake is trying to keep all agents' worldviews synchronized in real-time via shared mutable state with locks. This leads to deadlocks \(Agent A waits for Agent B's lock, Agent B waits for Agent A's\), stale reads, and complex failure modes. Instead, use the blackboard pattern: a shared append-only log where agents post events and consume others' events. Each agent maintains its own local state derived from the event stream. This eliminates distributed locks and makes the system resilient to agent failures \(events are persisted and replayable\). Tradeoff: agents may act on slightly stale information. Mitigate by having agents check the event log for recent relevant events before taking action, and by including timestamps so actions can be ordered. This pattern is essential for long-running multi-agent workflows where agents operate concurrently.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-22T14:03:48.626296+00:00— report_created — created