Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 3 additions & 3 deletions AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -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`.
Expand Down Expand Up @@ -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
Expand All @@ -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
Expand Down
2 changes: 1 addition & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand Down
2 changes: 1 addition & 1 deletion examples/claude-code/session.md
Original file line number Diff line number Diff line change
Expand Up @@ -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-
Expand Down
Loading