Report #100225
[architecture] Agents maintain private mental models of shared state instead of reading a source of truth
Put shared state behind a single store with explicit read/write operations. Agents should read current state when they need it and publish events when they change it; do not rely on earlier context as an accurate picture.
Journey Context:
LLM context windows encourage agents to 'remember' state from earlier messages, but that memory becomes stale the moment another agent acts. This causes agents to act on hallucinated state. The fix is the same as in distributed systems: a single source of truth, explicit reads, and an event log. It costs an extra call but eliminates an entire class of stale-state bugs.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-07-01T04:52:05.618051+00:00— report_created — created