From 67e7f3ea8052ccbf491a6c45e40e1baca0c80aff Mon Sep 17 00:00:00 2001 From: Rafael Richards Date: Mon, 11 May 2026 09:03:29 -0400 Subject: [PATCH] chore: bump docs URLs after .github AI-discoverability move MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Track 5 of the AI-discoverability docs reorg (.github PR #29/91c2d00). Five URL refs across this repo pointed at https://github.com/m-dev-tools/.github/blob/main/docs/phase4-plan.md; that file now lives at /docs/ai-discoverability/phase4-plan.md after the meta-repo consolidated all of its design / plan / evidence prose into a single subdirectory. Files touched: * AGENTS.md — 3 refs (table footnote on verify(), §3 vendoring rationale link, Claude-guidelines `defer to phase4-plan.md` link) * README.md — 1 ref (Status section pointer to the broader plan) * examples/claude-code/session.md — 1 ref (Track-C context line) GitHub does surface a "this file was moved" hint for the old URLs, so the prior versions weren't broken — just one click away. This pulls them back to a direct fetch. Bare-name refs in docstrings/comments (phase4-plan.md without a URL prefix — in src/m_dev_tools_mcp/server.py, _discovery.py, scripts/, and tests/) deliberately stay. They're textual file-name references, not navigable links; the filename itself didn't change. dist/mcp-tools.json regen is a no-op (server.py docstrings unchanged) but ran to keep the drift gate honest. Verified locally: * make check — ruff + mypy + 41/41 pytest + check-manifest + check-agents all green --- AGENTS.md | 6 +++--- README.md | 2 +- examples/claude-code/session.md | 2 +- 3 files changed, 5 insertions(+), 5 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index 0fe33ec..b6b646e 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -51,7 +51,7 @@ as a first-class protocol surface. Three MCP tools are registered: |---|---| | `route_intent(query)` | Plain-English intent → typed IDs. Example: `"parse JSON in M"` → `["module:m-stdlib#STDJSON"]`. | | `describe(typed_id)` | Typed ID → pointer-blob with `manifest_url`, `agent_instructions`, `verification_commands`. Does **not** inline payloads — keeps the catalog's "pointers, not facts" invariant. | -| `verify(repo)` | Return the `verification_commands` declared in a repo's `dist/repo.meta.json`. **Does not execute them** — that is a client decision (see Track B §3 B5 rationale in [phase4-plan.md](https://github.com/m-dev-tools/.github/blob/main/docs/phase4-plan.md)). | +| `verify(repo)` | Return the `verification_commands` declared in a repo's `dist/repo.meta.json`. **Does not execute them** — that is a client decision (see Track B §3 B5 rationale in [phase4-plan.md](https://github.com/m-dev-tools/.github/blob/main/docs/ai-discoverability/phase4-plan.md)). | Distribution is GitHub-Release wheels, not PyPI (`phase4-plan.md` §0). Install via `uvx --from git+https://github.com/m-dev-tools/m-dev-tools-mcp@v m-dev-tools-mcp`. @@ -161,7 +161,7 @@ Importable from `m_dev_tools_mcp.server`: Track B vendors a subset of Phase 3's discovery helpers from `.github`'s `profile/build/test-discovery-protocol.py` — see Track B -§3 in [phase4-plan.md](https://github.com/m-dev-tools/.github/blob/main/docs/phase4-plan.md) +§3 in [phase4-plan.md](https://github.com/m-dev-tools/.github/blob/main/docs/ai-discoverability/phase4-plan.md) for the vendoring rationale. ## Git conventions @@ -178,7 +178,7 @@ When acting in this repo, Claude should: 1. Read this AGENTS.md once per fresh session. 2. Treat `make check` as the contract — don't claim a stage complete without it green. -3. Defer to [phase4-plan.md](https://github.com/m-dev-tools/.github/blob/main/docs/phase4-plan.md) +3. Defer to [phase4-plan.md](https://github.com/m-dev-tools/.github/blob/main/docs/ai-discoverability/phase4-plan.md) for stage shape and verification commands; it is the load-bearing plan document for this repo's whole lifecycle. 4. Follow TDD strictly: tests first, confirm RED, implement, confirm diff --git a/README.md b/README.md index 88beca6..2db305e 100644 --- a/README.md +++ b/README.md @@ -6,7 +6,7 @@ MCP server for the [m-dev-tools](https://github.com/m-dev-tools) org catalog. Ex - **`describe(typed_id)`** — typed ID → pointer-blob (manifest URL, AGENTS.md URL, verification commands, …) - **`verify(repo)`** — list a repo's declared verification commands (does not execute them) -The server reads the catalog at over the network at call time; it is a thin wrapper, not a cache. See [`AGENTS.md`](AGENTS.md) for the contract and [phase4-plan.md](https://github.com/m-dev-tools/.github/blob/main/docs/phase4-plan.md) for the broader plan. +The server reads the catalog at over the network at call time; it is a thin wrapper, not a cache. See [`AGENTS.md`](AGENTS.md) for the contract and [phase4-plan.md](https://github.com/m-dev-tools/.github/blob/main/docs/ai-discoverability/phase4-plan.md) for the broader plan. ## Status diff --git a/examples/claude-code/session.md b/examples/claude-code/session.md index 8ae4904..e3b8f9e 100644 --- a/examples/claude-code/session.md +++ b/examples/claude-code/session.md @@ -2,7 +2,7 @@ > **Status: TEMPLATE — needs to be filled in once with a real session.** > -> Phase 4 Track C (per [phase4-plan.md §4 C3](https://github.com/m-dev-tools/.github/blob/main/docs/phase4-plan.md)) +> Phase 4 Track C (per [phase4-plan.md §4 C3](https://github.com/m-dev-tools/.github/blob/main/docs/ai-discoverability/phase4-plan.md)) > calls for a recorded session that proves Claude Code routes the > canonical question through this MCP server's `route_intent` tool — > not by guessing from training data. The session can't be auto-