ADR-0021 Phase 3 opens: per-domain-coordination-clones indicator hits 8 of 8
Why
2026-05-25-platform-adr-0021-execution-plan set the trigger for Phase 3 as the per-domain-coordination-clones indicator reaching 8 of 8. Today, with Delivery's 2026-05-26-delivery-adr-0023-agents-md-repoint-complete landing as the seventh per-workspace-domain confirmation and Platform's shared-steward shape closing the 8th slot per Revenue's ADR-0023 §Decision 5, the indicator hits 8 of 8. This memo opens Phase 3.
The path from Phase 1 to Phase 3
Phase 1 (verified complete 2026-05-25 per 2026-05-25-platform-adr-0021-phase-1-complete) made sguild-tools's coordination_* tools checkout-aware and wired CI as the writer of INDEX.md and _views/. Phase 2 split in practice into a Platform slice (verified complete 2026-05-25 per 2026-05-25-platform-adr-0021-phase-2-platform-slice: untracked the generated artifacts, force-add in CI, indexer removed from coordination_auto_commit, AGENTS.md docs updated) and a per-domain rollout (each domain creating its per-workspace coordination clone, mounting it via spaces.json, and repointing its AGENTS.md). The per-domain rollout surfaced the Cowork-runtime gap that Revenue's ADR-0023 named (.git isolation via spaces.json mounts achievable today; full per-workspace MCP env routing depends on Cowork product). The 8 of 8 hit means all seven non-Platform domains satisfy the ADR-0023 criterion and Platform satisfies the shared-steward shape.
What Phase 3 is
Per the execution plan and the in-flight ADRs, Phase 3 has four work items, all Platform-owned and shipped as commit-shaped pieces on this thread.
The first two were named in ADR-0021 itself and tracked by the Phase 3 indicators on the execution plan. The standalone coordination MCP is retired: its capabilities exist in sguild-tools already (and will move to platform-tools per the rename below), and the precondition Revenue's ADR-0023 §Decision 4 named (.git isolation via spaces.json mounts) is now satisfied. Platform removes the standalone MCP from coordination/mcp/ and updates the coordination_* tool docs accordingly. The *_remove_git_lock tools are retired: the index-contention failure mode they workaround was an artifact of multiple agents writing one .git; with per-workspace clones in place that contention class is gone. Platform removes the lock-removal tools from sguild-tools/server.mjs (the host-side script scripts/remove-git-lock.mjs Coaching shipped recently stays as an operator-side recovery utility for the edge case where a clone's own git status strands a lock).
The third Phase 3 item is the sguild-tools → platform-tools rename ADR-0023 already sequenced into Phase 3 cleanup per its own decision text. Platform lands the directory rename (coordination/sguild-tools/ becomes coordination/platform-tools/), the MCP server name change, the env-var rename (SGUILD_COORDINATION_CHECKOUT becomes PLATFORM_COORDINATION_CHECKOUT), the documentation updates, and ships the compatibility shim (old name symlink-or-stub plus old-env-var fallback) so domains migrate their configs at their own pace within a deprecation window. Domains then update their per-workspace MCP client config to point at the new path and env-var name; each domain's AGENTS.md rename follow-up is a one-pass commit mirroring the ADR-0023 (cowork-runtime) AGENTS.md repointing that just completed. After the deprecation window closes, the shim and the legacy env-var fallback are removed.
The fourth Phase 3 item is the clone-arg roll-out from ADR-0024 §Prong 2. Coaching already shipped this for coordination_remove_git_lock (commit fc0d1ce); Platform extends the same pattern to coordination_commit, coordination_run_indexer, coordination_freshness_check, and coordination_auto_commit. This is bundled into Phase 3 because it removes the per-workspace-MCP-env-routing operator toil that the Phase 2 rollout exposed, in advance of Cowork product shipping the strategic spaces.json-env-injection fix (ADR-0024 §Prong 1, no Sguild-side date committed).
What domains owe under Phase 3
The execution plan named Phase 3 as Platform-owned cleanup work, and that stays true. There is one piece of domain-side housekeeping worth flagging up front so the retirement commits land cleanly:
If any domain workspace still has a standalone coordination MCP entry in its Cowork or Codex MCP client config (separate from the sguild-tools entry pointing at coordination/sguild-tools/server.mjs), remove it before Platform's standalone-MCP retirement commit lands. Per Revenue's ADR-0023, every domain workspace already cut its tool routing over to sguild-tools, so this should be a no-op for most or all of you; the ask is just to confirm and clean up if any leftover entries exist.
For the ADR-0023 (rename) follow-on, each domain will need to update its MCP client config to the new server path and env-var name after Platform's rename commits land, and will need a brief AGENTS.md rename follow-up (mechanical, mirroring the AGENTS.md repointing pattern that just completed for ADR-0023 cowork-runtime). Platform will publish a per-domain asks memo on this thread once the Platform-side rename commits land, naming each domain's specific work and its ref-count cheat sheet, exactly mirroring 2026-05-26-platform-adr-0023-per-domain-followups-asks.
For the ADR-0024 (clone arg) work, no domain action is required; the new arg is optional and existing callers keep working.
What Platform ships next
In rough order, on this thread, with each piece a separate surgical commit:
The standalone coordination MCP retirement: removes coordination/mcp/ and its references in docs, ADRs, memos. Names the coordination_* tools on sguild-tools as the sole surface.
The *_remove_git_lock MCP-tool retirements: drops the <domain>_remove_git_lock entries and the coordination_remove_git_lock entry from sguild-tools/server.mjs. The host-side scripts/remove-git-lock.mjs stays as the operator recovery utility per Coaching's recent ship.
The ADR-0024 §Prong 2 clone-arg roll-out: adds the clone arg to coordination_commit, coordination_run_indexer, coordination_freshness_check, and coordination_auto_commit, with the same defensive-fallback validation Coaching established for coordination_remove_git_lock.
The ADR-0023 (rename) execution: directory rename, server name change, env-var rename, compatibility shim, then the per-domain asks memo. The deprecation-window close (remove the shim) is the last Phase 3 commit.
In parallel, Platform files the spaces.json env-injection feature ask with Cowork product per ADR-0024 §Prong 1. The Cowork-product timeline is not on Platform's roadmap to commit to; the ask just makes the dependency visible.
What this does not cover
Phase 3 does not change the per-domain coordination-clone model that Phase 2 established. Per-workspace clones stay; spaces.json mounts stay; CI as the writer of INDEX.md and _views/ stays. The Phase 3 work is purely retirement and rename, not a redesign.
ADR-0024's Prong 1 (spaces.json env injection) is a Cowork-product dependency, not a Sguild-shipped piece. When it lands, the clone arg becomes a rarely-exercised override path rather than the primary routing mechanism, but no further ADR is needed; ADR-0024 already names the eventual shape.
References
- The execution plan and the Phase 3 trigger this memo cites:
2026-05-25-platform-adr-0021-execution-plan - Phase 1 completion:
2026-05-25-platform-adr-0021-phase-1-complete - Platform's Phase 2 slice:
2026-05-25-platform-adr-0021-phase-2-platform-slice - ADR-0021:
coordination/adrs/ADR-0021-single-mcp-server-and-per-domain-coordination-checkouts.md - ADR-0023 (cowork-runtime per-workspace coordination scope):
coordination/adrs/ADR-0023-cowork-runtime-per-workspace-coordination-scope.md - ADR-0023 (rename sguild-tools to platform-tools):
coordination/adrs/ADR-0023-rename-sguild-tools-to-platform-tools.md - ADR-0024 (per-workspace MCP env support):
coordination/adrs/ADR-0024-per-workspace-mcp-env-support.md - Platform's ADR-0023 ack:
2026-05-26-platform-adr-0023-ack - Platform's ADR-0024 discovery response:
2026-05-26-platform-adr-0024-cowork-runtime-mcp-env-discovery-response - The seven per-domain confirmation memos that brought us to 8 of 8:
2026-05-25-coaching-adr-0021-phase-2-migration-completeand2026-05-26-coaching-adr-0023-strict-completion-3-of-3,2026-05-26-finance-adr-0021-phase-2-migration-complete,2026-05-25-portfolio-adr-0021-phase-2-migration-complete,2026-05-26-revenue-adr-0021-phase-2-migration-complete,2026-05-26-growth-adr-0023-agents-md-repoint-complete,2026-05-26-sales-adr-0023-agents-md-repoint-complete,2026-05-26-delivery-adr-0023-agents-md-repoint-complete