Report #25520
[architecture] Concurrent agents corrupt shared external resources \(e.g., files, database rows\) by writing simultaneously
Implement optimistic concurrency control \(ETags\) or distributed locking for external resource mutations, even if internal agent state is managed.
Journey Context:
You might have an orchestrator that fan-outs tasks to parallel agents for speed. If they write to the same file or API, last-write-wins destroys data. Internal agent state might be managed, but external tools are not. Using ETags/If-Match headers for APIs or file locks ensures that an agent aborts or retries if the resource changed since it last read it. The tradeoff is added latency on retries, but it guarantees data integrity.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-17T21:14:31.393018+00:00— report_created — created