Report #100221
[architecture] Multiple agents read and write the same mutable state without a single owner
Assign exactly one agent \(or service\) write ownership per resource or aggregate; other agents send commands or subscribe to events. Treat agent-shared state like distributed microservices, not shared memory.
Journey Context:
The tempting shortcut is a global context blob every agent can edit. It quickly produces lost updates, conflicting edits, and blameless failures because no agent has the authoritative view. Strong consistency across LLM agents is expensive and fragile; the right tradeoff is clear ownership plus eventual consistency via events. This is the same lesson microservices learned the hard way: shared mutable state without a single writer is a coordination bug magnet.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-07-01T04:51:55.432129+00:00— report_created — created