feat: add Claude Code releases tracking

Add condensed release history for Claude Code product (v2.0.24 → v2.1.12) New files: - machine-readable/claude-code-releases.yaml: Source of truth (YAML) - guide/claude-code-releases.md: Human-readable changelog - scripts/update-cc-releases.sh: Check for new releases from GitHub Modified: - reference.yaml: Add deep_dive entries for releases - check-landing-sync.sh: Add CC version check (#5) - README.md, guide/README.md: Add navigation links - CLAUDE.md: Document update workflow Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-18 11:33:21 +01:00 · 2026-01-18 11:33:21 +01:00 · 0348f08288
commit 0348f08288
parent 741acd0fa3
8 changed files with 801 additions and 3 deletions
--- a/CLAUDE.md
+++ b/CLAUDE.md
@ -168,10 +168,58 @@ All synced!
 - Je te fournirai les résultats avec les sources
 - Utile pour: nouvelles features Claude Code, best practices communauté, comparaisons d'outils, documentation officielle mise à jour

+## Claude Code Releases Tracking
+
+Ce repo maintient un historique condensé des releases officielles de Claude Code.
+
+### Fichiers
+
+| Fichier | Rôle |
+|---------|------|
+| `machine-readable/claude-code-releases.yaml` | Source de vérité (YAML) |
+| `guide/claude-code-releases.md` | Version lisible (Markdown) |
+| `scripts/update-cc-releases.sh` | Script de vérification des nouvelles versions |
+
+### Vérifier les nouvelles versions
+
+```bash
+./scripts/update-cc-releases.sh
+```
+
+Le script:
+1. Fetch le CHANGELOG officiel depuis GitHub
+2. Compare avec notre version trackée
+3. Affiche les nouvelles releases à condenser
+
+### Workflow de mise à jour
+
+1. **Vérifier**: `./scripts/update-cc-releases.sh`
+2. **MAJ YAML**: Ajouter nouvelle entrée dans `claude-code-releases.yaml`
+   - Mettre à jour `latest` et `updated`
+   - Ajouter l'entrée dans `releases` (condensée: 2-4 highlights max)
+   - Ajouter aux `breaking_summary` si applicable
+   - Ajouter aux `milestones` si feature majeure
+3. **MAJ Markdown**: Mettre à jour `claude-code-releases.md` en cohérence
+4. **Landing sync**: `./scripts/check-landing-sync.sh`
+5. **Commit**: `docs: update Claude Code releases (vX.Y.Z)`
+
+### Format des entrées YAML
+
+```yaml
+- version: "2.1.13"
+  date: "2026-01-20"
+  highlights:
+    - "Feature principale"
+    - "Autre feature notable"
+  breaking:
+    - "Description du breaking change (si applicable)"
+```
+
 ## Quick Lookups

 For answering questions about Claude Code:
 1. Search `machine-readable/reference.yaml` first (has line numbers to full guide)
 2. Use those line numbers to read relevant sections from `guide/ultimate-guide.md`
 3. Check `examples/` for ready-to-use templates
-4. Si info manquante ou incertaine → demander une recherche Perplexity
+4. Check `guide/claude-code-releases.md` for recent features/changes
+5. Si info manquante ou incertaine → demander une recherche Perplexity
--- a/README.md
+++ b/README.md
@ -240,7 +240,7 @@ Based on ALL this context, provide:
 - Domain-aware suggestions (e.g., EdTech → session planning agents, E-commerce → inventory commands)
 - Non-duplicate suggestions: Only recommends agents/commands you don't already have

-**Want maximum depth?** Use [tools/audit-prompt.md](./tools/audit-prompt.md) with `claude --ultrathink`
+**Want maximum depth?** Use [tools/audit-prompt.md](./tools/audit-prompt.md) (thinking is enabled by default with Opus 4.5)

 ### 🧠 Knowledge Quiz

@ -389,6 +389,7 @@ Weak Areas (< 75%):
 | File | Purpose | Time Investment |
 |------|---------|-----------------|
 | **[Ultimate Guide](./guide/ultimate-guide.md)** | Complete reference, 10 sections | ~3 hours (or by section) |
+| **[Claude Code Releases](./guide/claude-code-releases.md)** | Official release history (condensed) | 10 minutes |
 | **[Cheat Sheet](./guide/cheatsheet.md)** | 1-page printable reference | 5 minutes |
 | **[Architecture & Internals](./guide/architecture.md)** | How Claude Code works under the hood | ~25 minutes |
 | **[Methodologies](./guide/methodologies.md)** | 15 development methodologies reference | ~20 minutes |
@ -505,6 +506,7 @@ Copy-paste templates from [`examples/`](./examples/) for immediate use:
 |--------|---------|-------------|
 | [session-search.sh](./examples/scripts/session-search.sh) | Fast session search & resume | 15ms list, 400ms search |
 | [audit-scan.sh](./examples/scripts/audit-scan.sh) | Setup audit scanner | ~2s |
+| [update-cc-releases.sh](./scripts/update-cc-releases.sh) | Check for new Claude Code releases | ~1s |

 ### Security & Automation Hooks

--- a/guide/README.md
+++ b/guide/README.md
@ -7,6 +7,7 @@ Core documentation for mastering Claude Code.
 | File | Description | Time |
 |------|-------------|------|
 | [ultimate-guide.md](./ultimate-guide.md) | Complete reference covering all Claude Code features | ~3 hours |
+| [claude-code-releases.md](./claude-code-releases.md) | Official release history (condensed) | 10 min |
 | [cheatsheet.md](./cheatsheet.md) | 1-page printable quick reference | 5 min |
 | [architecture.md](./architecture.md) | How Claude Code works internally (master loop, tools, context) | 25 min |
 | [learning-with-ai.md](./learning-with-ai.md) | Guide for juniors on using AI without losing skills | 15 min |
--- a/guide/claude-code-releases.md
+++ b/guide/claude-code-releases.md
@ -0,0 +1,258 @@
+# Claude Code Release History
+
+> Condensed changelog of Claude Code official releases.
+> **Full details**: [github.com/anthropics/claude-code/CHANGELOG.md](https://github.com/anthropics/claude-code/blob/main/CHANGELOG.md)
+> **Machine-readable**: [claude-code-releases.yaml](../machine-readable/claude-code-releases.yaml)
+
+**Latest**: v2.1.12 | **Updated**: 2026-01-18
+
+---
+
+## Quick Jump
+
+- [2.1.x Series (January 2026)](#21x-series-january-2026) — Skill hot-reload, Vim motions, /plan command
+- [2.0.x Series (Nov 2025 - Jan 2026)](#20x-series-november-2025---january-2026) — Opus 4.5, Claude in Chrome, Background agents
+- [Breaking Changes Summary](#breaking-changes-summary)
+- [Milestone Features](#milestone-features)
+
+---
+
+## 2.1.x Series (January 2026)
+
+### v2.1.12 (2026-01-18)
+
+- Bug fix: Message rendering
+
+### v2.1.11 (2026-01-17)
+
+- Fix: Excessive MCP connection requests for HTTP/SSE transports
+
+### v2.1.10 (2026-01-17)
+
+- New `Setup` hook event (--init, --init-only, --maintenance flags)
+- Keyboard shortcut 'c' to copy OAuth URL
+- File suggestions show as removable attachments
+- [VSCode] Plugin install count + trust warnings
+
+### v2.1.9 (2026-01-16)
+
+- `auto:N` syntax for MCP tool search threshold configuration
+- `plansDirectory` setting for custom plan file locations
+- Session URL attribution to commits/PRs from web sessions
+- PreToolUse hooks can return `additionalContext`
+- `${CLAUDE_SESSION_ID}` string substitution for skills
+
+### v2.1.7 (2026-01-15)
+
+- `showTurnDuration` setting to hide turn duration messages
+- MCP tool search auto mode enabled by default
+- Inline display of agent final response in task notifications
+
+**⚠️ Breaking**:
+- OAuth/API Console URLs changed: `console.anthropic.com` → `platform.claude.com`
+- Security fix: Wildcard permission rules could match compound commands
+
+### v2.1.6 (2026-01-14)
+
+- Search functionality in `/config` command
+- Date range filtering in `/stats` (press `r` to cycle)
+- Auto-discovery of skills from nested `.claude/skills` directories
+- Updates section in `/doctor` showing auto-update channel
+
+**⚠️ Security Fix**: Permission bypass via shell line continuation
+
+### v2.1.5 (2026-01-13)
+
+- `CLAUDE_CODE_TMPDIR` environment variable for custom temp directory
+
+### v2.1.4 (2026-01-12)
+
+- `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` environment variable
+
+### v2.1.3 (2026-01-11)
+
+- Merged slash commands and skills (simplified mental model)
+- Release channel toggle (stable/latest) in `/config`
+- `/doctor` warnings for unreachable permission rules
+
+### v2.1.2 (2026-01-10)
+
+- Windows Package Manager (winget) support
+- Clickable hyperlinks for file paths (OSC 8 terminals)
+- Shift+Tab shortcut in plan mode for auto-accept edits
+- Large bash outputs saved to disk instead of truncated
+
+**⚠️ Breaking**:
+- Security fix: Command injection in bash command processing
+- Deprecated: `C:\ProgramData\ClaudeCode` managed settings path
+
+### v2.1.0 (2026-01-08) ⭐ MAJOR
+
+**Highlights**:
+- ⭐ **Automatic skill hot-reload** — Skills modified in `~/.claude/skills` or `.claude/skills` immediately available
+- ⭐ **Shift+Enter works OOTB** in iTerm2, WezTerm, Ghostty, Kitty
+- ⭐ **New Vim motions**: `;` `,` `y` `yy` `Y` `p` `P` text objects (`iw` `aw` `i"` etc.) `>>` `<<` `J`
+- **Unified Ctrl+B** for backgrounding all running tasks
+- `/plan` command shortcut to enable plan mode
+- Slash command autocomplete anywhere in input
+- `language` setting for response language (e.g., `language: "japanese"`)
+- Skills `context: fork` support for forked sub-agent context
+- Hooks support in agent/skill/command frontmatter
+- MCP `list_changed` notifications support
+- `/teleport` and `/remote-env` commands for web sessions
+- Disable specific agents with `Task(AgentName)` syntax
+- `--tools` flag in interactive mode
+- YAML-style lists in frontmatter `allowed-tools`
+
+**⚠️ Breaking**:
+- OAuth URLs: `console.anthropic.com` → `platform.claude.com`
+- Removed permission prompt for entering plan mode
+- [SDK] Minimum zod peer dependency: `^4.0.0`
+
+---
+
+## 2.0.x Series (November 2025 - January 2026)
+
+### v2.0.76 (2026-01-05)
+
+- Fix: macOS code-sign warning with Claude in Chrome
+
+### v2.0.74 (2026-01-04) ⭐
+
+- ⭐ **LSP (Language Server Protocol) tool** for code intelligence (go-to-definition, find references, hover)
+- `/terminal-setup` for Kitty, Alacritty, Zed, Warp
+- Ctrl+T in `/theme` to toggle syntax highlighting
+- Grouped skills/agents by source in `/context`
+
+### v2.0.72 (2026-01-02) ⭐
+
+- ⭐ **Claude in Chrome (Beta)** — Control browser directly from Claude Code
+- Reduced terminal flickering
+- QR code for mobile app download
+- Thinking toggle changed: Tab → Alt+T
+
+### v2.0.70 (2025-12-30)
+
+- Enter key accepts/submits prompt suggestions immediately
+- Wildcard syntax `mcp__server__*` for MCP tool permissions
+- Auto-update toggle for plugin marketplaces
+- 3x memory usage improvement for large conversations
+
+**⚠️ Breaking**: Removed `#` shortcut for quick memory entry
+
+### v2.0.67 (2025-12-26) ⭐
+
+- ⭐ **Thinking mode enabled by default for Opus 4.5**
+- Thinking config moved to `/config`
+- Search in `/permissions` with `/` shortcut
+
+### v2.0.64 (2025-12-22) ⭐
+
+- ⭐ **Instant auto-compacting**
+- ⭐ **Async agents and bash commands** with wake-up messages
+- `/stats` with usage graphs, streaks, favorite model
+- Named sessions: `/rename`, `/resume <name>`
+- Support for `.claude/rules/` directory
+- Image dimension metadata for coordinate mappings
+
+### v2.0.60 (2025-12-18) ⭐
+
+- ⭐ **Background agents** — Agents run while you work
+- `--disable-slash-commands` CLI flag
+- Model name in Co-Authored-By commits
+- `/mcp enable|disable [server-name]`
+
+### v2.0.51 (2025-12-10) ⭐ MAJOR
+
+- ⭐ **Opus 4.5 released**
+- ⭐ **Claude Code for Desktop**
+- Updated usage limits for Opus 4.5
+- Plan Mode builds more precise plans
+
+### v2.0.45 (2025-12-05) ⭐
+
+- ⭐ **Microsoft Foundry support**
+- `PermissionRequest` hook for auto-approve/deny
+- `&` prefix for background tasks to web
+
+### v2.0.28 (2025-11-18) ⭐
+
+- ⭐ **Plan mode: introduced Plan subagent**
+- Subagents: resume capability
+- Subagents: dynamic model selection
+- `--max-budget-usd` flag (SDK)
+- Git-based plugins branch/tag support (`#branch`)
+
+### v2.0.24 (2025-11-10)
+
+- Claude Code Web: Web → CLI teleport
+- Sandbox mode for BashTool (Linux & Mac)
+- Bedrock: `awsAuthRefresh` output display
+
+---
+
+## Breaking Changes Summary
+
+### URLs
+
+| Version | Change |
+|---------|--------|
+| v2.1.0, v2.1.7 | OAuth/API Console: `console.anthropic.com` → `platform.claude.com` |
+
+### Windows
+
+| Version | Change |
+|---------|--------|
+| v2.0.58 | Managed settings prefer `C:\Program Files\ClaudeCode` |
+| v2.1.2 | Deprecated `C:\ProgramData\ClaudeCode` path |
+
+### SDK
+
+| Version | Change |
+|---------|--------|
+| v2.0.25 | Removed legacy SDK entrypoint → `@anthropic-ai/claude-agent-sdk` |
+| v2.1.0 | Minimum zod peer dependency: `^4.0.0` |
+
+### Shortcuts
+
+| Version | Change |
+|---------|--------|
+| v2.0.70 | Removed `#` shortcut for quick memory entry |
+
+### Security Fixes
+
+| Version | Issue |
+|---------|-------|
+| v2.1.2 | Command injection in bash command processing |
+| v2.1.6 | Shell line continuation permission bypass |
+| v2.1.7 | Wildcard permission rules compound commands |
+
+---
+
+## Milestone Features
+
+| Version | Key Features |
+|---------|--------------|
+| **v2.1.0** | Skill hot-reload, Shift+Enter OOTB, Vim motions, /plan command |
+| **v2.0.74** | LSP tool for code intelligence |
+| **v2.0.72** | Claude in Chrome (browser control) |
+| **v2.0.67** | Thinking mode default for Opus 4.5 |
+| **v2.0.64** | Instant auto-compact, async agents, named sessions |
+| **v2.0.60** | Background agents |
+| **v2.0.51** | Opus 4.5, Claude Code for Desktop |
+| **v2.0.45** | Microsoft Foundry, PermissionRequest hook |
+| **v2.0.28** | Plan subagent, subagent resume/model selection |
+| **v2.0.24** | Web teleport, Sandbox mode |
+
+---
+
+## Updating This Document
+
+1. **Watch**: [github.com/anthropics/claude-code/releases](https://github.com/anthropics/claude-code/releases)
+2. **Update**: `machine-readable/claude-code-releases.yaml` (source of truth)
+3. **Regenerate**: Update this markdown accordingly
+4. **Sync landing**: Run `./scripts/check-landing-sync.sh`
+
+---
+
+*Last updated: 2026-01-18 | [Back to main guide](./ultimate-guide.md)*
--- a/machine-readable/claude-code-releases.yaml
+++ b/machine-readable/claude-code-releases.yaml
@ -0,0 +1,382 @@
+# Claude Code Official Releases (condensed)
+# Source: github.com/anthropics/claude-code/CHANGELOG.md
+# Purpose: Track Claude Code product releases for documentation sync
+# Maintained: Manual updates when new releases are announced
+
+latest: "2.1.12"
+updated: "2026-01-18"
+
+# ════════════════════════════════════════════════════════════════
+# RELEASES (newest first, condensed highlights only)
+# ════════════════════════════════════════════════════════════════
+releases:
+
+  # ─────────────────────────────────────────────────────────────
+  # 2.1.x Series (January 2026)
+  # ─────────────────────────────────────────────────────────────
+
+  - version: "2.1.12"
+    date: "2026-01-18"
+    highlights:
+      - "Bug fix: Message rendering"
+    breaking: []
+
+  - version: "2.1.11"
+    date: "2026-01-17"
+    highlights:
+      - "Fix: Excessive MCP connection requests for HTTP/SSE transports"
+    breaking: []
+
+  - version: "2.1.10"
+    date: "2026-01-17"
+    highlights:
+      - "New `Setup` hook event (--init, --init-only, --maintenance flags)"
+      - "Keyboard shortcut 'c' to copy OAuth URL"
+      - "File suggestions show as removable attachments"
+      - "[VSCode] Plugin install count + trust warnings"
+    breaking: []
+
+  - version: "2.1.9"
+    date: "2026-01-16"
+    highlights:
+      - "`auto:N` syntax for MCP tool search threshold"
+      - "`plansDirectory` setting for custom plan file locations"
+      - "Session URL attribution to commits/PRs from web sessions"
+      - "PreToolUse hooks can return `additionalContext`"
+      - "${CLAUDE_SESSION_ID} string substitution for skills"
+    breaking: []
+
+  - version: "2.1.7"
+    date: "2026-01-15"
+    highlights:
+      - "`showTurnDuration` setting to hide turn duration messages"
+      - "MCP tool search auto mode enabled by default"
+      - "Inline display of agent final response in task notifications"
+    breaking:
+      - "OAuth/API Console URLs: console.anthropic.com → platform.claude.com"
+      - "Security fix: Wildcard permission rules could match compound commands"
+
+  - version: "2.1.6"
+    date: "2026-01-14"
+    highlights:
+      - "Search functionality in /config command"
+      - "Date range filtering in /stats (r to cycle)"
+      - "Auto-discovery of skills from nested .claude/skills directories"
+      - "Updates section in /doctor showing auto-update channel"
+    breaking:
+      - "Security fix: Permission bypass via shell line continuation"
+
+  - version: "2.1.5"
+    date: "2026-01-13"
+    highlights:
+      - "`CLAUDE_CODE_TMPDIR` env var for custom temp directory"
+    breaking: []
+
+  - version: "2.1.4"
+    date: "2026-01-12"
+    highlights:
+      - "`CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` env var"
+    breaking: []
+
+  - version: "2.1.3"
+    date: "2026-01-11"
+    highlights:
+      - "Merged slash commands and skills (simplified mental model)"
+      - "Release channel toggle (stable/latest) in /config"
+      - "/doctor warnings for unreachable permission rules"
+    breaking: []
+
+  - version: "2.1.2"
+    date: "2026-01-10"
+    highlights:
+      - "Windows Package Manager (winget) support"
+      - "Clickable hyperlinks for file paths (OSC 8 terminals)"
+      - "Shift+Tab shortcut in plan mode for auto-accept edits"
+      - "Large bash outputs saved to disk instead of truncated"
+    breaking:
+      - "Security fix: Command injection in bash command processing"
+      - "Deprecated: C:\\ProgramData\\ClaudeCode managed settings path"
+
+  - version: "2.1.0"
+    date: "2026-01-08"
+    highlights:
+      - "⭐ MAJOR: Automatic skill hot-reload"
+      - "⭐ MAJOR: Shift+Enter works OOTB (iTerm2, WezTerm, Ghostty, Kitty)"
+      - "⭐ MAJOR: New Vim motions (;, y, p, text objects, >>, <<, J)"
+      - "Unified Ctrl+B for backgrounding all tasks"
+      - "/plan command shortcut"
+      - "Slash command autocomplete anywhere in input"
+      - "`language` setting for response language"
+      - "Skills context: fork support"
+      - "Hooks support in agent/skill frontmatter"
+      - "MCP list_changed notifications support"
+      - "/teleport and /remote-env commands"
+      - "Tab support for disabling specific agents"
+      - "--tools flag in interactive mode"
+      - "YAML-style lists in frontmatter allowed-tools"
+    breaking:
+      - "OAuth URLs: console.anthropic.com → platform.claude.com"
+      - "Removed permission prompt for entering plan mode"
+      - "[SDK] Minimum zod peer dependency: ^4.0.0"
+
+  # ─────────────────────────────────────────────────────────────
+  # 2.0.x Series (December 2025 - January 2026)
+  # ─────────────────────────────────────────────────────────────
+
+  - version: "2.0.76"
+    date: "2026-01-05"
+    highlights:
+      - "Fix: macOS code-sign warning with Claude in Chrome"
+    breaking: []
+
+  - version: "2.0.74"
+    date: "2026-01-04"
+    highlights:
+      - "⭐ LSP (Language Server Protocol) tool for code intelligence"
+      - "/terminal-setup for Kitty, Alacritty, Zed, Warp"
+      - "Ctrl+T in /theme to toggle syntax highlighting"
+      - "Grouped skills/agents by source in /context"
+    breaking: []
+
+  - version: "2.0.73"
+    date: "2026-01-03"
+    highlights:
+      - "Clickable [Image #N] links"
+      - "Alt-Y yank-pop to cycle kill ring history"
+      - "Search filtering in plugin discover screen"
+      - "[VSCode] Tab icon badges (permissions, unread)"
+    breaking: []
+
+  - version: "2.0.72"
+    date: "2026-01-02"
+    highlights:
+      - "⭐ Claude in Chrome (Beta) - browser control from Claude Code"
+      - "Reduced terminal flickering"
+      - "QR code for mobile app"
+      - "Thinking toggle: Tab → Alt+T"
+    breaking: []
+
+  - version: "2.0.71"
+    date: "2026-01-01"
+    highlights:
+      - "/config toggle for prompt suggestions"
+      - "/settings alias for /config"
+      - "New Rust-based syntax highlighting engine"
+    breaking: []
+
+  - version: "2.0.70"
+    date: "2025-12-30"
+    highlights:
+      - "Enter key accepts/submits prompt suggestions immediately"
+      - "Wildcard syntax mcp__server__* for MCP tool permissions"
+      - "Auto-update toggle for plugin marketplaces"
+      - "3x memory usage improvement for large conversations"
+    breaking:
+      - "Removed # shortcut for quick memory entry"
+
+  - version: "2.0.68"
+    date: "2025-12-28"
+    highlights:
+      - "IME support for Chinese, Japanese, Korean"
+      - "Enterprise managed settings support"
+      - "Improved plan mode exit UX"
+    breaking: []
+
+  - version: "2.0.67"
+    date: "2025-12-26"
+    highlights:
+      - "⭐ Thinking mode enabled by default for Opus 4.5"
+      - "Thinking config moved to /config"
+      - "Search in /permissions with / shortcut"
+    breaking: []
+
+  - version: "2.0.65"
+    date: "2025-12-24"
+    highlights:
+      - "Alt+P to switch models while writing prompt"
+      - "Context window info in status line"
+      - "`fileSuggestion` setting for custom @ search"
+      - "CLAUDE_CODE_SHELL env var"
+    breaking: []
+
+  - version: "2.0.64"
+    date: "2025-12-22"
+    highlights:
+      - "⭐ Instant auto-compacting"
+      - "⭐ Async agents and bash commands with wake-up messages"
+      - "/stats with usage graphs, streaks, favorite model"
+      - "Named sessions: /rename, /resume <name>"
+      - "Support for .claude/rules/ directory"
+      - "Image dimension metadata for coordinate mappings"
+    breaking:
+      - "Unshipped AgentOutputTool/BashOutputTool → TaskOutputTool"
+
+  - version: "2.0.62"
+    date: "2025-12-20"
+    highlights:
+      - "`attribution` setting for commit/PR bylines"
+      - "(Recommended) indicator in multiple-choice questions"
+    breaking:
+      - "Deprecated: includeCoAuthoredBy (use attribution)"
+
+  - version: "2.0.60"
+    date: "2025-12-18"
+    highlights:
+      - "⭐ Background agents (work while you work)"
+      - "--disable-slash-commands CLI flag"
+      - "Model name in Co-Authored-By commits"
+      - "/mcp enable|disable [server-name]"
+    breaking: []
+
+  - version: "2.0.58"
+    date: "2025-12-16"
+    highlights:
+      - "⭐ Opus 4.5 available for Pro users"
+    breaking:
+      - "[Windows] Managed settings prefer C:\\Program Files\\ClaudeCode"
+
+  - version: "2.0.57"
+    date: "2025-12-15"
+    highlights:
+      - "Feedback input when rejecting plans"
+      - "[VSCode] Streaming message support"
+    breaking: []
+
+  - version: "2.0.55"
+    date: "2025-12-13"
+    highlights:
+      - "Improved AskUserQuestion auto-submit"
+      - "Better fuzzy matching for @ file suggestions"
+    breaking:
+      - "Proxy DNS opt-in: CLAUDE_CODE_PROXY_RESOLVES_HOSTS=true"
+
+  - version: "2.0.51"
+    date: "2025-12-10"
+    highlights:
+      - "⭐ MAJOR: Opus 4.5 released"
+      - "⭐ MAJOR: Claude Code for Desktop"
+      - "Updated usage limits for Opus 4.5"
+      - "Plan Mode builds more precise plans"
+    breaking: []
+
+  - version: "2.0.45"
+    date: "2025-12-05"
+    highlights:
+      - "⭐ Microsoft Foundry support"
+      - "PermissionRequest hook for auto-approve/deny"
+      - "& prefix for background tasks to web"
+    breaking: []
+
+  - version: "2.0.43"
+    date: "2025-12-03"
+    highlights:
+      - "`permissionMode` field for custom agents"
+      - "`skills` frontmatter for auto-loading subagent skills"
+      - "SubagentStart hook event"
+    breaking: []
+
+  - version: "2.0.41"
+    date: "2025-12-01"
+    highlights:
+      - "Model parameter for prompt-based stop hooks"
+      - "Plugins: sharing and installing output styles"
+      - "Allow more safe git commands without approval"
+      - "Teleporting from web auto-sets upstream branch"
+    breaking: []
+
+  - version: "2.0.37"
+    date: "2025-11-28"
+    highlights:
+      - "Matcher values for Notification hook events"
+      - "Output Styles: keep-coding-instructions option"
+    breaking: []
+
+  - version: "2.0.35"
+    date: "2025-11-26"
+    highlights:
+      - "Improved fuzzy search for commands"
+      - "CLAUDE_CODE_EXIT_AFTER_STOP_DELAY env var"
+    breaking:
+      - "Migrated ignorePatterns to deny permissions"
+
+  - version: "2.0.32"
+    date: "2025-11-23"
+    highlights:
+      - "Output styles un-deprecated (community feedback)"
+      - "`companyAnnouncements` setting"
+    breaking: []
+
+  - version: "2.0.30"
+    date: "2025-11-20"
+    highlights:
+      - "`allowUnsandboxedCommands` sandbox setting"
+      - "`disallowedTools` for custom agent definitions"
+      - "Prompt-based stop hooks"
+      - "SSE MCP servers on native build"
+    breaking:
+      - "Deprecated: Output styles (later un-deprecated in 2.0.32)"
+      - "Removed: Custom ripgrep configuration"
+
+  - version: "2.0.28"
+    date: "2025-11-18"
+    highlights:
+      - "⭐ Plan mode: introduced Plan subagent"
+      - "Subagents: resume capability"
+      - "Subagents: dynamic model selection"
+      - "--max-budget-usd flag (SDK)"
+      - "Git-based plugins branch/tag support (#branch)"
+    breaking: []
+
+  - version: "2.0.27"
+    date: "2025-11-15"
+    highlights:
+      - "New UI for permission prompts"
+      - "Branch filtering and search in session resume"
+    breaking: []
+
+  - version: "2.0.25"
+    date: "2025-11-12"
+    highlights: []
+    breaking:
+      - "Removed legacy SDK entrypoint → @anthropic-ai/claude-agent-sdk"
+
+  - version: "2.0.24"
+    date: "2025-11-10"
+    highlights:
+      - "Claude Code Web: Web → CLI teleport"
+      - "Sandbox mode for BashTool (Linux & Mac)"
+      - "Bedrock: awsAuthRefresh output display"
+    breaking: []
+
+# ════════════════════════════════════════════════════════════════
+# SUMMARY - Key Breaking Changes by Area
+# ════════════════════════════════════════════════════════════════
+breaking_summary:
+  urls:
+    - "OAuth/API Console: console.anthropic.com → platform.claude.com (v2.1.0, v2.1.7)"
+  windows:
+    - "Managed settings: C:\\ProgramData\\ClaudeCode → C:\\Program Files\\ClaudeCode (v2.0.58, deprecated v2.1.2)"
+  sdk:
+    - "Removed legacy SDK entrypoint → @anthropic-ai/claude-agent-sdk (v2.0.25)"
+    - "Minimum zod peer dependency: ^4.0.0 (v2.1.0)"
+  shortcuts:
+    - "Removed # shortcut for quick memory (v2.0.70)"
+  security:
+    - "Command injection fix in bash processing (v2.1.2)"
+    - "Wildcard permission rules compound commands fix (v2.1.7)"
+    - "Shell line continuation permission bypass fix (v2.1.6)"
+
+# ════════════════════════════════════════════════════════════════
+# MILESTONE FEATURES (quick reference)
+# ════════════════════════════════════════════════════════════════
+milestones:
+  "2.1.0": "Skill hot-reload, Shift+Enter OOTB, Vim motions, /plan command"
+  "2.0.74": "LSP tool for code intelligence"
+  "2.0.72": "Claude in Chrome (browser control)"
+  "2.0.67": "Thinking mode default for Opus 4.5"
+  "2.0.64": "Instant auto-compact, async agents, named sessions"
+  "2.0.60": "Background agents"
+  "2.0.51": "Opus 4.5, Claude Code for Desktop"
+  "2.0.45": "Microsoft Foundry, PermissionRequest hook"
+  "2.0.28": "Plan subagent, subagent resume/model selection"
+  "2.0.24": "Web teleport, Sandbox mode"
--- a/machine-readable/reference.yaml
+++ b/machine-readable/reference.yaml
@ -12,6 +12,9 @@ updated: "2026-01"
 # For architecture internals, see guide/architecture.md
 # ════════════════════════════════════════════════════════════════
 deep_dive:
+  # Claude Code Releases
+  claude_code_releases: "guide/claude-code-releases.md"
+  claude_code_releases_yaml: "machine-readable/claude-code-releases.yaml"
  # Session management
  session_search: "guide/observability.md:29"
  session_search_script: "examples/scripts/session-search.sh"
@ -96,7 +99,7 @@ decide:
  context_high: "/compact (>70%) or /clear (>90%)"
  repeating: "create agent or command"
  need_docs: "Context7 MCP"
-  deep_debug: "use extended thinking in prompts"
+  deep_debug: "use Opus (thinking enabled by default) - Alt+T to toggle"

 # ════════════════════════════════════════════════════════════════
 # PROMPTING FORMULA (see deep_dive.xml_prompting for details)
--- a/scripts/check-landing-sync.sh
+++ b/scripts/check-landing-sync.sh
@ -130,6 +130,26 @@ else
 fi
 echo ""

+# ===================
+# 5. CLAUDE CODE VERSION
+# ===================
+CC_VERSION=$(grep "^latest:" "$GUIDE_DIR/machine-readable/claude-code-releases.yaml" | cut -d'"' -f2)
+# Landing may show this in a badge or section - check if exists
+LANDING_CC_VERSION=$(grep -oE 'Claude Code v[0-9]+\.[0-9]+\.[0-9]+' "$LANDING_DIR/index.html" 2>/dev/null | head -1 | sed 's/Claude Code v//' || echo "N/A")
+
+echo -e "${BLUE}5. Claude Code Version${NC}"
+echo "   Releases YAML: $CC_VERSION"
+echo "   Landing:       ${LANDING_CC_VERSION:-Not displayed}"
+if [ "$LANDING_CC_VERSION" = "N/A" ] || [ -z "$LANDING_CC_VERSION" ]; then
+    echo -e "   ${YELLOW}INFO${NC}: Landing doesn't display CC version (optional)"
+elif [ "$CC_VERSION" != "$LANDING_CC_VERSION" ]; then
+    echo -e "   ${YELLOW}MISMATCH${NC} → Update index.html CC version badge"
+    # Not counting as hard error since it's optional
+else
+    echo -e "   ${GREEN}OK${NC}"
+fi
+echo ""
+
 # ===================
 # SUMMARY
 # ===================
--- a/scripts/update-cc-releases.sh
+++ b/scripts/update-cc-releases.sh
@ -0,0 +1,84 @@
+#!/bin/bash
+# Fetch latest Claude Code releases and show diff
+# Usage: ./scripts/update-cc-releases.sh
+#
+# This script fetches the official CHANGELOG and shows new versions
+# You then manually add the condensed entries to claude-code-releases.yaml
+
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+REPO_DIR="$(dirname "$SCRIPT_DIR")"
+RELEASES_FILE="$REPO_DIR/machine-readable/claude-code-releases.yaml"
+CHANGELOG_URL="https://raw.githubusercontent.com/anthropics/claude-code/main/CHANGELOG.md"
+TMP_FILE="/tmp/claude-code-changelog.md"
+
+# Colors
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m'
+
+echo "=== Claude Code Releases Update ==="
+echo ""
+
+# Get current version from our YAML
+CURRENT_VERSION=$(grep "^latest:" "$RELEASES_FILE" | cut -d'"' -f2)
+echo -e "${BLUE}Current tracked version:${NC} $CURRENT_VERSION"
+
+# Fetch latest CHANGELOG
+echo -e "${BLUE}Fetching official CHANGELOG...${NC}"
+curl -sL "$CHANGELOG_URL" -o "$TMP_FILE"
+
+if [ ! -s "$TMP_FILE" ]; then
+    echo "ERROR: Failed to fetch CHANGELOG"
+    exit 1
+fi
+
+# Extract latest version from CHANGELOG (format: "## X.Y.Z")
+LATEST_VERSION=$(grep -oE "^## [0-9]+\.[0-9]+\.[0-9]+" "$TMP_FILE" | head -1 | sed 's/## //')
+echo -e "${BLUE}Latest official version:${NC} $LATEST_VERSION"
+echo ""
+
+# Compare versions
+if [ "$CURRENT_VERSION" = "$LATEST_VERSION" ]; then
+    echo -e "${GREEN}✓ Already up to date!${NC}"
+    rm -f "$TMP_FILE"
+    exit 0
+fi
+
+echo -e "${YELLOW}⚠ New versions available!${NC}"
+echo ""
+
+# Show new versions (between current and latest)
+echo -e "${BLUE}New releases since $CURRENT_VERSION:${NC}"
+echo "────────────────────────────────────────"
+
+# Extract versions newer than current
+awk -v current="$CURRENT_VERSION" '
+    /^## [0-9]+\.[0-9]+\.[0-9]+/ {
+        match($0, /[0-9]+\.[0-9]+\.[0-9]+/)
+        ver = substr($0, RSTART, RLENGTH)
+        if (ver == current) exit
+        in_version = 1
+        print ""
+        print $0
+        next
+    }
+    in_version { print }
+' "$TMP_FILE" | head -100
+
+echo ""
+echo "────────────────────────────────────────"
+echo ""
+echo -e "${BLUE}Next steps:${NC}"
+echo "1. Review the changes above"
+echo "2. Add condensed entries to: machine-readable/claude-code-releases.yaml"
+echo "3. Update guide/claude-code-releases.md"
+echo "4. Update 'latest' and 'updated' fields"
+echo "5. Run: ./scripts/check-landing-sync.sh"
+echo ""
+echo -e "${BLUE}Full CHANGELOG saved to:${NC} $TMP_FILE"
+echo ""
+echo "Tip: Use Claude to help condense the entries:"
+echo "  claude -p \"Condense these release notes for claude-code-releases.yaml: \$(cat $TMP_FILE | head -200)\""