From ace62f2f8407be18190f66891f73905bd0f97589 Mon Sep 17 00:00:00 2001 From: Florian BRUNIAUX Date: Thu, 22 Jan 2026 21:56:20 +0100 Subject: [PATCH] docs: add MCP Tool Search documentation (v3.11.2) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Add comprehensive documentation for MCP Tool Search (lazy loading): - New section in guide/architecture.md with ASCII flow diagram - Documents 85% token reduction and accuracy improvements - Configuration guide for ENABLE_TOOL_SEARCH=auto:N syntax - Simon Willison quote on context pollution resolution Enriched release notes: - v2.1.7: Added stats and Anthropic blog link - v2.1.9: Added auto:N examples and cross-reference Fixed template count: 83 → 82 (actual count) Sources: Anthropic Engineering blog, Scott Spence, Perplexity verification Co-Authored-By: Claude --- CHANGELOG.md | 29 ++++++++++----- README.md | 10 ++--- VERSION | 2 +- guide/architecture.md | 65 +++++++++++++++++++++++++++++++++ guide/cheatsheet.md | 4 +- guide/claude-code-releases.md | 4 +- guide/ultimate-guide.md | 4 +- machine-readable/reference.yaml | 7 +++- 8 files changed, 102 insertions(+), 23 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 81e5f0d..1097bb7 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -4,18 +4,29 @@ All notable changes to this project will be documented in this file. The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/). -## [Unreleased] +## [3.11.2] - 2026-01-22 ### Added -- **Claudeception documentation** — Meta-skill for automatic skill generation - - **Repository**: [blader/Claudeception](https://github.com/blader/Claudeception) by Siqi Chen (@blader) - - **What it does**: Monitors Claude Code sessions and auto-extracts discoveries into reusable skills - - **Validated use case**: `pre-merge-code-review` skill auto-generated from debugging workflow - - **Documentation added**: - - `guide/ultimate-guide.md` Section 5.5: "Automatic Skill Generation: Claudeception" (~45 lines) - - `machine-readable/reference.yaml`: `claudeception` + `claudeception_guide` entries - - **Source**: Community contribution via Laurent Dosdat +- **MCP Tool Search documentation** (`guide/architecture.md`) + - New section "MCP Tool Search (Lazy Loading)" with complete technical details + - Explains how Claude Code uses Anthropic's Advanced Tool Use API feature (v2.1.7+) + - Includes ASCII diagram of Tool Search flow + - Documents 85% token reduction benchmark and accuracy improvements + - Configuration guide for `ENABLE_TOOL_SEARCH=auto:N` syntax + - Simon Willison quote on context pollution resolution + - **Sources**: Anthropic Engineering blog, Scott Spence documentation, Perplexity verification + - **machine-readable/reference.yaml**: Added `tool_search`, `tool_search_config`, `tool_search_deep_dive` entries + +### Changed + +- **Release notes enrichment** (`guide/claude-code-releases.md`) + - v2.1.7: Added 85% token reduction stats, accuracy improvements, Anthropic blog link + - v2.1.9: Added `auto:N` configuration examples and cross-reference to architecture.md + +### Fixed + +- **Template count**: Corrected from 83 to 82 (actual count in examples/) --- diff --git a/README.md b/README.md index d9f0ebf..1805216 100644 --- a/README.md +++ b/README.md @@ -6,7 +6,7 @@

Stars - Templates + Templates Quiz

@@ -64,7 +64,7 @@ Save as `CLAUDE.md` in your project root. Claude reads it automatically. **The problem**: Awesome-lists give links, not learning paths. Official docs are dense. Tutorials get outdated in weeks. -**This guide**: Structured learning path with 83 copy-paste templates, from first install to advanced workflows. +**This guide**: Structured learning path with 82 copy-paste templates, from first install to advanced workflows. **Reading time**: Quick Start ~15 min. Full guide ~3 hours (most read by section). @@ -225,7 +225,7 @@ claude-code-ultimate-guide/
-Examples Library (83 templates) +Examples Library (82 templates) **Agents** (6): [code-reviewer](./examples/agents/code-reviewer.md), [test-writer](./examples/agents/test-writer.md), [security-auditor](./examples/agents/security-auditor.md), [refactoring-specialist](./examples/agents/refactoring-specialist.md), [output-evaluator](./examples/agents/output-evaluator.md), [devops-sre](./examples/agents/devops-sre.md) ⭐ @@ -372,7 +372,7 @@ Claude Code sends your prompts, file contents, and MCP results to Anthropic serv | Repository | Purpose | Audience | |------------|---------|----------| -| **[Claude Code Guide](https://github.com/FlorianBruniaux/claude-code-ultimate-guide)** *(this repo)* | Comprehensive documentation (13K lines, 83 templates) | Developers | +| **[Claude Code Guide](https://github.com/FlorianBruniaux/claude-code-ultimate-guide)** *(this repo)* | Comprehensive documentation (13K lines, 82 templates) | Developers | | **[Claude Cowork Guide](https://github.com/FlorianBruniaux/claude-cowork-guide)** | Non-technical usage (67 prompts, 5 workflows) | Knowledge workers | | **Code Landing** *(to be deployed)* | Marketing site for Claude Code guide | Discovery | | **Cowork Landing** *(to be deployed)* | Marketing site for Cowork guide | Discovery | @@ -430,7 +430,7 @@ Licensed under [CC BY-SA 4.0](https://creativecommons.org/licenses/by-sa/4.0/). --- -*Version 3.11.1 | January 2026 | Crafted with Claude* +*Version 3.11.2 | January 2026 | Crafted with Claude*