--- key: process.one-worktree-one-committing-agent title: 2026-07-21 — One worktree, one committing agent (#542) status: active since: '2026-07-21' supersedes: none superseded-by: none rule: Never run two committing agents concurrently on one worktree — give each parallel slice its own worktree branched off the feature branch and merge back. signals: 'parallel agents · concurrent commits · worktree per slice · read-only review agent · paths: n/a · issues: #542' mechanics: '`git worktree add` a fresh tree per slice off the feature branch; merge the slices back into the feature branch when they land.' --- Read-only review agents sharing a tree are fine — the constraint is on *writers*. Sequence slices only where one genuinely depends on another's output; "backend-first narrow, SPA-wide after" worked well for #216.