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<X.Y> 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 <https://github.com/m-dev-tools/.github> 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 <https://github.com/m-dev-tools/.github> 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-