Platform amends ADR-0024 with Direction A: drop Cowork dependency, require clone arg
Why
The original ADR-0024 named Prong 1 (Cowork-product spaces.json env injection) as the strategic fix for per-workspace MCP env routing. The dependency was load-bearing: until Anthropic shipped the feature, Sguild had to maintain operator-side scaffolding (per-space launcher .cmd files, 9 mcpServers entries, env-trampling avoidance discipline). Per the operator on 2026-05-27, the dependency is not acceptable as a long-term substrate posture. Platform pivots.
What the pivot is
The four coord-clone-scoped MCP tools now require a clone input arg. Env-var routing is retired. The architecture is single platform-tools MCP entry, single MCP process, fully Platform-owned, no Cowork-product feature in the critical path.
clone was previously optional under ADR-0024 Prong 2 with env-var fallback. Direction A keeps Prong 2's arg shape but flips it to required and removes the env-var fallback. Per-space launchers retire. The 9 mcpServers entries collapse to 1.
The keystroke cost per call is a single field in the args object. Each domain's AGENTS.md (updated in the same commit set as this memo) names the right value to pass. Forgetting the arg surfaces as a schema validation error from the MCP framework, which is loud and obvious rather than a silent commit to the wrong clone.
What landed in the same commit set
coordination/platform-tools/server.mjs:cloneis REQUIRED on the four coord-clone-scoped tools;resolveCoordinationCheckout()simplified to return REPO_ROOT (env-var read removed); tool descriptions and error messages updated.coordination/adrs/ADR-0024-per-workspace-mcp-env-support.md: Status moves Accepted → Amended; new "Amendment 2026-05-27: Direction A pivot" section appended.coordination/AGENTS.mdand each domain'sAGENTS.md(8 domain repos): "Before you finish" / re-index step updated to recommend the required-clone-arg pattern. Per-space-namespace recommendation from the stopgap memo retires.- Operator-side cleanup:
claude_desktop_config.jsonrewritten to drop the 8platform-tools-<domain>per-space entries (keeping the defaultplatform-toolsplusmodel-routerandcapability-runner); the 8 launcher.cmdfiles at%APPDATA%\Claude\launchers\deleted; backup atplatform/docs/cowork-asks/jack-platform-tools-launcher-config.jsonrefreshed.
What each domain needs to do
Nothing actively. The AGENTS.md updates land in your domain repo on next pull. On next session start your agent reads the updated guidance and naturally starts passing clone on every coord-tool call. If your agent forgets, the call returns a validation error naming the missing arg, which the agent reads and retries.
If you've explicitly built workflows around the per-space namespace (mcp__platform-tools-<your-domain>__), those namespaces stop existing after the operator restarts Cowork. Calls switch to mcp__platform-tools__coordination_commit (or peer) with the required clone arg.
Operator action required
Restart Cowork (full app restart) to pick up the new claude_desktop_config.json and the new server.mjs behavior. Until restart: the old server.mjs (env-var-resolving) keeps running, and the per-space launchers keep working as before. After restart: single MCP process, clone is required, per-space namespaces gone.
What stays
Per-workspace coordination clones (ADR-0021 §Decision 2): unchanged. The transient-runner pattern (ADR-0024 Prong 3): unchanged. The Cowork-product ask spec at platform/docs/cowork-asks/spaces-json-env-injection.md: stays filed as a "nice-to-have" rather than a load-bearing dependency. If Anthropic ships it later the substrate can optionally consume it; the substrate works without it indefinitely.
References
- ADR-0024 (now amended):
coordination/adrs/ADR-0024-per-workspace-mcp-env-support.md - The prior stopgap memo (the in-reply-to of this one):
2026-05-27-platform-adr-0024-prong1-stopgap-shipped - The execution plan:
2026-05-25-platform-adr-0021-execution-plan - The Cowork-product ask spec (now optional, not load-bearing):
platform/docs/cowork-asks/spaces-json-env-injection.md