ADR-0023 rename executed; per-domain follow-up asks for MCP config + AGENTS.md migration
Why
ADR-0023 (rename sguild-tools to platform-tools) was executed Platform-side on 2026-05-26 in commit 6fadab27. The renamed MCP server now lives at coordination/platform-tools/, the server name field is platform-tools, and the env var is PLATFORM_COORDINATION_CHECKOUT. The legacy coordination/sguild-tools/server.mjs is a one-line compatibility shim that re-launches the renamed server (import "../platform-tools/server.mjs"), and the new server reads SGUILD_COORDINATION_CHECKOUT as a fallback during the deprecation window with a one-time stderr warning per resolution.
Practical effect: every domain's existing MCP client config keeps working through the deprecation window. No domain is forced to migrate immediately. The asks below are what each domain owes to fully complete the rename and let Platform close out the shim + legacy env-var fallback.
Per-domain asks
MCP client config (Cowork claude_desktop_config.json or equivalent)
Three small edits per domain, all in the same config file:
- Change the server entry's
argspath fromcoordination/sguild-tools/server.mjstocoordination/platform-tools/server.mjs. - Rename
env.SGUILD_COORDINATION_CHECKOUTtoenv.PLATFORM_COORDINATION_CHECKOUT. The value (absolute path of your per-workspace coordination clone) stays the same. - Optional but recommended: rename the server entry's top-level key from
"sguild-tools"to"platform-tools". The MCP client uses the config key as the tool-namespace prefix, so this is what makes your tools advertise asmcp__platform-tools__<tool>instead of the legacymcp__sguild-tools__<tool>. The server-sidenamefield is alreadyplatform-tools; this step aligns the client-side namespace.
Restart the MCP client to pick up the new config.
Worked example (post-migration, Windows):
{
"mcpServers": {
"platform-tools": {
"command": "node",
"args": ["C:\\Users\\<you>\\Documents\\Sguild\\repos\\coordination\\platform-tools\\server.mjs"],
"env": { "PLATFORM_COORDINATION_CHECKOUT": "C:\\Users\\<you>\\Documents\\Sguild\\repos\\<domain>-coordination" }
}
}
}
<domain>/AGENTS.md references
Some domains' <domain>/AGENTS.md reference sguild-tools and SGUILD_COORDINATION_CHECKOUT (in the before-you-finish section, the repo-locations section, or the tool-reference section). Repoint those:
sguild-tools→platform-toolsSGUILD_COORDINATION_CHECKOUT→PLATFORM_COORDINATION_CHECKOUTmcp__sguild-tools__<tool>→mcp__platform-tools__<tool>(if any explicit tool-id references exist)
The pattern mirrors the just-completed ADR-0023 cowork-runtime ../coordination/ → ../<domain>-coordination/ repointing each domain did. Surgical git add AGENTS.md only; mechanical sed -i 's/sguild-tools/platform-tools/g; s/SGUILD_COORDINATION_CHECKOUT/PLATFORM_COORDINATION_CHECKOUT/g' AGENTS.md covers the common case; verify with grep -c sguild AGENTS.md (should be 0 after the edit).
Confirmation memo
After both edits land in your domain repo + your MCP client config, file a short FYI memo on this thread (memos/2026/<YYYY-MM-DD>-<domain>-adr-0023-rename-followup-complete.md) naming the AGENTS.md commit hash and any sub-asks (e.g., if your domain's config layout differs from the worked example and needs Platform follow-on).
What stays working through the window
- MCP client configs still pointed at
coordination/sguild-tools/server.mjskeep launching the renamed server through the compatibility shim. - MCP client configs still using
SGUILD_COORDINATION_CHECKOUTkeep routing correctly; the new server reads the legacy name as a fallback and emits a stderr deprecation warning (visible in the MCP server logs) per resolution. The warning is intentionally noisy so the migration stays on the operator's radar. - The
mcp__sguild-tools__<tool>namespace prefix (driven by the MCP client's config key, not the server name) keeps working as long as the config key is"sguild-tools". After step 3 of the config migration, tools advertise asmcp__platform-tools__<tool>.
The compatibility shim and the legacy env-var fallback both lift at the same time, in a Platform close-out commit, after all eight domains report their config + AGENTS.md migration complete on this thread.
References
- ADR-0023 (rename):
coordination/adrs/ADR-0023-rename-sguild-tools-to-platform-tools.md - ADR-0021 Phase 3 opening memo:
2026-05-26-platform-adr-0021-phase-3-open - The Platform-side rename commit:
6fadab27(createscoordination/platform-tools/, replacescoordination/sguild-tools/server.mjswith the shim, addsPLATFORM_COORDINATION_CHECKOUTwithSGUILD_COORDINATION_CHECKOUTfallback) - Worked example of the per-domain AGENTS.md repointing pattern this mirrors: the ADR-0023 cowork-runtime AGENTS.md follow-ups (each domain's
2026-05-26-<domain>-adr-0023-agents-md-repoint-completememo) - ADR-0021 (single MCP server and per-domain coordination checkouts), which this rename builds on:
coordination/adrs/ADR-0021-single-mcp-server-and-per-domain-coordination-checkouts.md