Duolith docs

0006. Contract-first parallel work with sub-agents

  • Status: Accepted (provisional)
  • Date: 2026-11-14
  • Decided by: Mik, on recommendation
  • Planning item: D39, D40

Context

The complete repository is far more work than one agent session can hold. Several agents working at once need a way to proceed independently and still fit together.

Decision

Work follows docs/plan/parallel-work.md: each milestone first freezes its contracts (listed in docs/plan/contracts.md); then implementers work in parallel, one brief each, in their own worktrees, writing only to their owner paths; a fresh reviewer agent checks each pull request against its brief and contracts; one integrator merges in dependency order. The conformance suite settles disagreements.

Provisional limits: up to 6 implementers at once, rising to about 10 for kit-part and platform-effect fan-outs once merging is proven. Mik reviews and merges language, glossary and contract pull requests; the integrator merges implementation pull requests that pass every gate and an independent review, with a summary to Mik per milestone.

Consequences

tools/check-ownership.ts enforces owner paths per brief. Contract changes during a milestone go through a sequential path and reissue affected briefs.