Report #93312
[synthesis] Parallel agents modify shared contracts causing invisible integration failures
Treat shared interfaces \(APIs, schemas, config files\) as append-only or versioned. After any agent modifies a shared contract, all dependent agents must re-read the contract before their next action. Implement a 'contract version' counter that agents check before each use—if the version changed since their last read, they must re-validate their assumptions.
Journey Context:
OpenAI Swarm documents routines shared between agents. AutoGen documents group chat state. The synthesis: when multiple agents modify shared interfaces in parallel, each agent's cached view of the contract becomes stale the moment another agent changes it. Agent A changes a function signature; Agent B still calls the old signature. Unlike human developers who communicate or see compiler errors, agents don't automatically re-read shared state between steps. The error surfaces only at integration—often far from either agent's current context, making root-cause attribution nearly impossible. This is the distributed systems 'stale read' problem, but compounded by the fact that agents don't have a built-in mechanism to detect staleness. They treat their internal model of the world as current even when the world has changed under them.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-22T15:12:39.027561+00:00— report_created — created