Skip to main content
sourceSource: corpus/docs/adrs/0010-write-side-single-threaded.mdModified: 2026-06-03

ADR 0010: Write-side single-threading

Status

Accepted

Context

Parallel autonomous writers collide on merges, violating determinism and bypassing coherent review narratives.

Decision

Parallelism is acceptable on read paths / research; writes that land in one branch must serialize through orchestration (Lead Engineer pattern) unless human explicitly forks work with merge policy.

Encoded in recursion limits and orchestration semantics (docs/concepts/10-subagent-strategy.md).

Consequences

  • Positive: merges stay reviewable; fewer conflict-induced silent behaviour changes.
  • Negative: throughput cap — tackled via batching orchestration waves, not uncontrolled agents.

Ready to run the loop on your own repo? Get started — copy the kit and write your first spec.