Skip to content

Commit 6ce4e1b

Browse files
bradygasterclaude
andauthored
docs(adr-003): accept option C (#2501)
The maintainers agreed on option C: Copilot's coordinator file stays canonical, and every other host's digest is self-sufficient (#2489). Option B stays an opt-in spike (#2488). Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
1 parent 7cd97e8 commit 6ce4e1b

1 file changed

Lines changed: 22 additions & 6 deletions

File tree

‎docs/specification/adr-003-host-neutral-canonical-coordinator.md‎

Lines changed: 22 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,14 +1,14 @@
11
# ADR 003: Host-Neutral Canonical Coordinator in the Workspace
22

3-
**Status:** Proposed
3+
**Status:** Accepted (option C), 2026-11-13
44

55
**Tracking:** [#2438](https://github.com/github/squad/issues/2438) (Phase 7)
66

77
**Affects:** `squad-client-harness-adapters/v0.2` §4–§5 (projection contract
88
and canonical paths) and §13 (upgrade and rollback)
99

10-
This ADR records a decision to be made. It does not change any code. Merging it
11-
with status Proposed does not approve it.
10+
The maintainers chose option C. Option B stays an opt-in experiment
11+
([#2488](https://github.com/github/squad/issues/2488)) and is not part of 2.0.
1212

1313
## Context
1414

@@ -185,12 +185,28 @@ coordinator behaves correctly, so C must be shown with behavioral scenarios run
185185
with the Copilot file absent. C is tracked in
186186
[#2487](https://github.com/github/squad/issues/2487) and the B spike in
187187
[#2488](https://github.com/github/squad/issues/2488). This records the
188-
discussion; it does not accept this ADR.
188+
discussion; the decision is recorded below.
189189

190190
## Decision
191191

192-
Not yet made. Implementation, if approved, is a separate PR with its own
193-
projection version bump and CHANGELOG entry.
192+
**Option C**, agreed by the maintainers on 2026-11-13.
193+
194+
- `.github/agents/squad.agent.md` stays the canonical coordinator, and it is
195+
defined only for Copilot. Copilot's output doesn't change.
196+
- Every other host's digest is complete on its own and never points at
197+
Copilot's file. The digest parity tests keep the hosts in step. This shipped
198+
in [#2489](https://github.com/github/squad/pull/2489).
199+
- Behavioral scenarios ran live on Claude Code with Copilot's file deleted, and
200+
passed: routing, human sign-off, reviewer rejection, restart continuity,
201+
customization precedence, monorepo subfolder, backend outage and the
202+
satellite repository. Azure DevOps is deferred. The evidence is in
203+
[#2487](https://github.com/github/squad/issues/2487) and the host feature
204+
matrix.
205+
- Option B (a host-neutral canonical file that Copilot's is generated from) is
206+
not adopted. It stays a bounded, opt-in spike in
207+
[#2488](https://github.com/github/squad/issues/2488). Revisit it if Copilot's
208+
file needs host-specific content, or if remote teams need the coordinator
209+
served through `squad_state`.
194210

195211
## Related artifacts
196212

0 commit comments

Comments
 (0)