Report #13360
[architecture] Concurrent file or state mutations by multiple agents cause race conditions and lost updates
Assign exclusive, unambiguous ownership of mutable resources \(files, database tables\) to a single agent, or implement an optimistic locking/ACID transaction layer for shared state.
Journey Context:
Developers often treat agents like human developers who can merge via Git. Agents execute concurrently and will blindly overwrite each other's changes without an external coordination mechanism. Exclusive ownership eliminates write-write conflicts but creates bottlenecks. Optimistic locking allows parallelism but requires retry logic. For code generation, exclusive ownership per module is usually the right call to avoid complex merge conflicts.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-16T18:37:39.506048+00:00— report_created — created