Skip to content

Docs: decisions.md still lists per-Agent worktrees as deferred despite ADR-0015 #96

Description

@dichovsky

docs/design/decisions.md states twice that per-Agent worktrees are not built:

  • :77-78 (DEC-12) — "Launching mixed Participant CLIs and per-Agent worktrees are deferred."
  • :149 ("Deferred product decisions") — "Claim/acknowledge Messages, session displacement, memory/brief, approvals, Task dependencies, launching mixed Participant CLIs, and per-Agent worktrees remain candidates. See requirements FR-X*."

Accepted ADR-0015 shipped the feature as the opt-in group W contract: src/config.ts:17 admits worker_worktrees and :78-87 parses enabled/base_ref; src/worktree.ts exists; src/store/schema.ts:43-59 carries the worktree_path/worktree_branch/worktree_base_ref triple and :117 creates the STRICT review_worktrees table. The SRS records the promotion at docs/design/srs.md:1009 (FR-W01 — Opt-in gate (ADR-0015, promoting FR-X07)), :1388-1389, and :1406-1409 ("promoted … no longer deferred or unscheduled"), so the "See requirements FR-X*" pointer at :149-150 sends a reader to an id that is annotated as promoted.

The mixed-Participant-CLI half of both sentences is still true — assertHomogeneousClient (src/launcher/plan.ts:104-116) throws USAGE on mixed platform hints unless --client or runtime.client overrides — so each sentence needs splitting, not deleting.

Impact: the decision index, which readers consult to learn which decisions are accepted versus provisional, disclaims a shipped, ADR-backed capability in two places, and points at a deferred-requirement range that no longer covers it.

Acceptance: both sentences drop the per-Agent-worktrees clause while keeping the mixed-CLI one, and :149-150's FR-X* pointer no longer implies FR-X07 is among the deferred set.

Not a duplicate: #40 covers docs/design/product-spec.md's Non-goals bullet and architecture.md §11; #42 covers the same claim in docs-site/sections/limits.tsx. Neither reaches decisions.md.

Metadata

Metadata

Assignees

No one assigned

    Labels

    documentationImprovements or additions to documentationgood first issueGood for newcomers

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions