From 314f872f1fcfd254ea7a38d19aed84b9693923ab Mon Sep 17 00:00:00 2001
From: Florian BRUNIAUX <florian@bruniaux.com>
Date: Sat, 28 Feb 2026 21:32:43 +0100
Subject: [PATCH] docs: update reference.yaml + CHANGELOG for mcp v1.0.3
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- reference.yaml: add 4 missing tools to mcp_server.tools list
  (compare_versions, search_examples, get_threat, list_threats)
  + correct bundle_size 123KB→132KB
- CHANGELOG [Unreleased] Fixed: document content path bug fix (1.0.3)

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---
 CHANGELOG.md                    |  5 +++++
 machine-readable/reference.yaml | 32 +++++++++++++++++++++++++++++++-
 2 files changed, 36 insertions(+), 1 deletion(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index a32acf6..abc2689 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -36,6 +36,11 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
 
 ### Fixed
 
+- **MCP Server v1.0.3 — content path bug** (`mcp-server/src/lib/content.ts`)
+  - ENOENT au démarrage en production : `CONTENT_DIR` résolvait `../../content` depuis `dist/` (2 niveaux), atterrissant dans `node_modules/` au lieu de la racine du package
+  - Fix : `../content` (1 niveau) — tsup bundle tout à plat dans `dist/`, donc 1 seul niveau suffit
+  - Publié sur npm : `claude-code-ultimate-guide-mcp@1.0.3`
+
 - **Bug ligne 5646 `guide/ultimate-guide.md`** — champs frontmatter agents `skills`, `background`, `isolation`, `memory` étaient incorrectement étiquetés "community patterns / not official spec". Remplacés par table officielle complète vérifiée contre `code.claude.com/docs/en/sub-agents`. Champs concernés : `model`, `tools`, `disallowedTools`, `permissionMode`, `maxTurns`, `skills`, `mcpServers`, `hooks`, `memory`, `background`, `isolation`, `color` — tous officiels.
 
 ### Changed
diff --git a/machine-readable/reference.yaml b/machine-readable/reference.yaml
index 18d2225..f43402b 100644
--- a/machine-readable/reference.yaml
+++ b/machine-readable/reference.yaml
@@ -1277,7 +1277,37 @@ rules:
 ecosystem:
   this_guide:
     focus: "Education - Learn & master"
-    unique: ["architecture docs", "TDD/SDD methodologies", "264-question quiz", "YAML index"]
+    unique: ["architecture docs", "TDD/SDD methodologies", "264-question quiz", "YAML index", "MCP server"]
+  mcp_server:
+    npm: "claude-code-ultimate-guide-mcp"
+    install: "npx -y claude-code-ultimate-guide-mcp"
+    guide_section: "guide/ultimate-guide.md:10602"
+    readme: "mcp-server/README.md"
+    tools:
+      - "search_guide(query, limit?) — search 882 indexed entries"
+      - "read_section(path, offset?, limit?) — read any guide file paginated"
+      - "list_topics() — browse 25 topic categories"
+      - "get_example(name) — fetch production templates"
+      - "list_examples(category?) — agents/commands/hooks/skills/scripts"
+      - "search_examples(query, limit?) — semantic search across all templates by intent"
+      - "get_changelog(count?) — last N guide CHANGELOG entries"
+      - "get_digest(period) — day/week/month combined digest"
+      - "get_release(version?) — Claude Code CLI releases"
+      - "compare_versions(from, to?) — diff two CC versions: aggregated highlights + breaking changes"
+      - "get_cheatsheet(section?) — cheatsheet full or filtered"
+      - "get_threat(id) — look up CVE or attack technique from threat database"
+      - "list_threats(category?) — browse threat-db: global summary or section list"
+    resources:
+      - "claude-code-guide://reference — 94KB YAML index (~900 entries)"
+      - "claude-code-guide://releases — CC releases history"
+      - "claude-code-guide://llms — llms.txt"
+    prompt: "claude-code-expert — activates expert mode with optimal search workflow"
+    slash_commands:
+      location: "~/.claude/commands/ccguide/"
+      commands: ["/ccguide:search", "/ccguide:cheatsheet", "/ccguide:digest", "/ccguide:example", "/ccguide:examples", "/ccguide:release", "/ccguide:changelog", "/ccguide:topics"]
+    agent: ".claude/agents/claude-code-guide.md — Haiku, read-only, searches before answering"
+    bundle_size: "132KB compressed (YAML indexes bundled, markdown lazy-fetched)"
+    cache: "~/.cache/claude-code-guide/{version}/ — 24h TTL"
   complementary:
     claude_code_templates:
       url: "github.com/davila7/claude-code-templates"