release: v3.27.4 - template count update + worktree docs

- Templates 113 → 116 (review-plan, git-worktree-status/remove/clean, rules) - Commands 23 → 26 (worktree lifecycle suite) - Git worktree section expanded with lifecycle commands table - Version sync across all docs Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-17 11:15:32 +01:00 · 2026-02-17 11:15:32 +01:00 · 1f720f7d74
commit 1f720f7d74
parent 0d6a0c656e
7 changed files with 69 additions and 47 deletions
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@ -4,7 +4,7 @@ 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.27.4] - 2026-02-17

 ### Added

@ -39,6 +39,8 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
  - v2.1.44: Auth refresh error fix
  - v2.1.43: AWS auth refresh timeout (3min), structured-outputs beta header fix on Vertex/Bedrock, non-agent markdown warnings fix
 - **`reference.yaml`**: Added 12 new entries (review-plan, rules templates, git-worktree suite, security kill switch), updated resource evaluations count 67 → 74
+- **Template count**: 113 → 116 (review-plan command, git-worktree-status/remove/clean commands, rules templates) — updated across README, CLAUDE.md, reference badges
+- **Commands count**: 23 → 26 (git-worktree-status, git-worktree-remove, git-worktree-clean)

 ## [3.27.3] - 2026-02-16

--- a/CLAUDE.md
+++ b/CLAUDE.md
@ -269,7 +269,7 @@ Ce guide fait partie d'un écosystème de 4 repositories interconnectés, sépar
 |--------|---------|
 | **GitHub** | https://github.com/FlorianBruniaux/claude-code-ultimate-guide |
 | **Local** | `/Users/florianbruniaux/Sites/perso/claude-code-ultimate-guide/` |
-| **Contenu** | Guide ~19K lignes, 113 templates, workflows, architecture |
+| **Contenu** | Guide ~19K lignes, 116 templates, workflows, architecture |
 | **Audience** | Développeurs, DevOps, tech leads |

 ### 2. Claude Cowork Guide (repo dédié)
@ -292,7 +292,7 @@ Ce guide fait partie d'un écosystème de 4 repositories interconnectés, sépar
 | Aspect | Détails |
 |--------|---------|
 | **Local** | `/Users/florianbruniaux/Sites/perso/claude-code-ultimate-guide-landing/` |
-| **Contenu** | Page marketing, badges, FAQ, quiz (264 questions) |
+| **Contenu** | Page marketing, badges, FAQ, quiz (274 questions) |
 | **Sync avec** | Guide principal (version, templates, guide lines) |

 ### 4. Cowork Landing Site
--- a/README.md
+++ b/README.md
@ -6,9 +6,9 @@

 <p align="center">
  <a href="https://github.com/FlorianBruniaux/claude-code-ultimate-guide/stargazers"><img src="https://img.shields.io/github/stars/FlorianBruniaux/claude-code-ultimate-guide?style=for-the-badge" alt="Stars"/></a>
-  <a href="./CHANGELOG.md"><img src="https://img.shields.io/badge/Updated-Feb_16,_2026_·_v3.27.3-brightgreen?style=for-the-badge" alt="Last Update"/></a>
-  <a href="./quiz/"><img src="https://img.shields.io/badge/Quiz-264_questions-orange?style=for-the-badge" alt="Quiz"/></a>
-  <a href="./examples/"><img src="https://img.shields.io/badge/Templates-113-green?style=for-the-badge" alt="Templates"/></a>
+  <a href="./CHANGELOG.md"><img src="https://img.shields.io/badge/Updated-Feb_17,_2026_·_v3.27.4-brightgreen?style=for-the-badge" alt="Last Update"/></a>
+  <a href="./quiz/"><img src="https://img.shields.io/badge/Quiz-274_questions-orange?style=for-the-badge" alt="Quiz"/></a>
+  <a href="./examples/"><img src="https://img.shields.io/badge/Templates-116-green?style=for-the-badge" alt="Templates"/></a>
  <a href="./guide/security-hardening.md"><img src="https://img.shields.io/badge/🛡️_Threat_DB-18_CVEs_·_341_malicious_skills-red?style=for-the-badge" alt="Threat Database"/></a>
 </p>

@ -32,7 +32,7 @@
 - ✅ **Build mental models** — How Claude Code works internally (architecture, context flow, tool orchestration)
 - ✅ **Master methodologies** — TDD, SDD, BDD with AI collaboration (not just templates)
 - ✅ **Security mindset** — Threat modeling for AI systems (only guide with 18 CVEs + 341 malicious skills database)
- ✅ **Test your knowledge** — 264-question quiz to validate understanding (no other resource offers this)
+- ✅ **Test your knowledge** — 274-question quiz to validate understanding (no other resource offers this)

 **Outcome**: Go from copy-pasting configs to designing your own agentic workflows with confidence.

@ -48,9 +48,9 @@ Both guides serve different needs. Choose based on your priority.
 | **Quick setup** for projects | Available but not the priority | Battle-tested production configs |
 | **Learn trade-offs** (agents vs skills) | Decision frameworks + comparisons | Lists patterns, no trade-off analysis |
 | **Security hardening** | Only threat database (18 CVEs) | Basic patterns only |
-| **Test understanding** | 264-question quiz | Not available |
+| **Test understanding** | 274-question quiz | Not available |
 | **Methodologies** (TDD/SDD/BDD) | Full workflow guides | Not covered |
-| **Copy-paste ready** templates | 113 templates | 200+ templates |
+| **Copy-paste ready** templates | 116 templates | 200+ templates |

 ### Ecosystem Positioning

@ -77,7 +77,7 @@ Both guides serve different needs. Choose based on your priority.
 1. **Security-First** — 18 CVEs + 341 malicious skills tracked (no competitor has this depth)
 2. **Methodology Workflows** — TDD/SDD/BDD comparison + step-by-step guides
 3. **Comprehensive Reference** — 19K lines across 16 specialized guides (24× more reference material than everything-cc)
-4. **Educational Progression** — 264-question quiz, beginner → expert path
+4. **Educational Progression** — 274-question quiz, beginner → expert path

 **Recommended workflow:**
 1. Learn concepts here (mental models, trade-offs, security)
@ -136,8 +136,8 @@ graph LR
    root[📦 Repository<br/>Root]

    root --> guide[📖 guide/<br/>19K lines]
-    root --> examples[📋 examples/<br/>113 templates]
-    root --> quiz[🧠 quiz/<br/>264 questions]
+    root --> examples[📋 examples/<br/>116 templates]
+    root --> quiz[🧠 quiz/<br/>274 questions]
    root --> tools[🔧 tools/<br/>utils]
    root --> machine[🤖 machine-readable/<br/>AI index]
    root --> docs[📚 docs/<br/>67 evaluations]
@ -166,9 +166,9 @@ graph LR
 │  ├─ mcp-servers-ecosystem.md  Official & community MCP servers
 │  └─ workflows/          Step-by-step guides
 │
-├─ 📋 examples/           113 Production Templates
+├─ 📋 examples/           116 Production Templates
 │  ├─ agents/             6 custom AI personas
-│  ├─ commands/           23 slash commands
+│  ├─ commands/           26 slash commands
 │  ├─ hooks/              31 hooks (bash + PowerShell)
 │  ├─ skills/             13 skills (9 on SkillHub)
 │  └─ scripts/            Utility scripts (audit, search)
@ -268,12 +268,12 @@ Complete guides with rationale and examples:

 ---

-### 📚 113 Annotated Templates
+### 📚 116 Annotated Templates

 **Outcome**: Learn patterns, not just configs.

 Educational templates with explanations:
- Agents (6), Commands (23), Hooks (31), Skills
+- Agents (6), Commands (26), Hooks (31), Skills
 - Comments explaining **why** each pattern works (not just what it does)
 - Gradual complexity progression (simple → advanced)

@ -639,11 +639,11 @@ Use this guide critically. Experiment. Share what works for you.
 | **[Claude Code Releases](./guide/claude-code-releases.md)** | Official release history | 10 min |

 <details>
-<summary><strong>Examples Library</strong> (113 templates)</summary>
+<summary><strong>Examples Library</strong> (116 templates)</summary>

 **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) ⭐

-**Slash Commands** (23): [/pr](./examples/commands/pr.md), [/commit](./examples/commands/commit.md), [/release-notes](./examples/commands/release-notes.md), [/diagnose](./examples/commands/diagnose.md), [/security](./examples/commands/security.md), [/security-check](./examples/commands/security-check.md) **, [/security-audit](./examples/commands/security-audit.md) **, [/update-threat-db](./examples/commands/update-threat-db.md) **, [/refactor](./examples/commands/refactor.md), [/explain](./examples/commands/explain.md), [/optimize](./examples/commands/optimize.md), [/ship](./examples/commands/ship.md)...
+**Slash Commands** (26): [/pr](./examples/commands/pr.md), [/commit](./examples/commands/commit.md), [/release-notes](./examples/commands/release-notes.md), [/diagnose](./examples/commands/diagnose.md), [/security](./examples/commands/security.md), [/security-check](./examples/commands/security-check.md) **, [/security-audit](./examples/commands/security-audit.md) **, [/update-threat-db](./examples/commands/update-threat-db.md) **, [/refactor](./examples/commands/refactor.md), [/explain](./examples/commands/explain.md), [/optimize](./examples/commands/optimize.md), [/ship](./examples/commands/ship.md)...

 **Security Hooks** (31): [dangerous-actions-blocker](./examples/hooks/bash/dangerous-actions-blocker.sh), [prompt-injection-detector](./examples/hooks/bash/prompt-injection-detector.sh), [unicode-injection-scanner](./examples/hooks/bash/unicode-injection-scanner.sh), [output-secrets-scanner](./examples/hooks/bash/output-secrets-scanner.sh)...

@ -662,7 +662,7 @@ Use this guide critically. Experiment. Share what works for you.
 </details>

 <details>
-<summary><strong>Knowledge Quiz</strong> (264 questions)</summary>
+<summary><strong>Knowledge Quiz</strong> (274 questions)</summary>

 Test your Claude Code knowledge with an interactive CLI quiz covering all guide sections.

@ -752,12 +752,12 @@ See [CONTRIBUTING.md](./CONTRIBUTING.md) for guidelines.

 ### Tools
 - [Ask Zread](https://zread.ai/FlorianBruniaux/claude-code-ultimate-guide) — Ask questions about this guide
- [Interactive Quiz](./quiz/) — 264 questions
+- [Interactive Quiz](./quiz/) — 274 questions
 - [Landing Site](https://florianbruniaux.github.io/claude-code-ultimate-guide-landing/) — Visual navigation

 ---

-*Version 3.27.3 | Updated daily · Feb 16, 2026 | Crafted with Claude*
+*Version 3.27.4 | Updated daily · Feb 17, 2026 | Crafted with Claude*

 <!-- SEO Keywords -->
 <!-- claude code, claude code tutorial, anthropic cli, ai coding assistant, claude code mcp,
--- a/2
+++ b/2
@ -1 +1 @@
-3.27.3
+3.27.4
--- a/guide/cheatsheet.md
+++ b/guide/cheatsheet.md
@ -12,7 +12,7 @@ tags: [cheatsheet, reference]

 **Written with**: Claude (Anthropic)

-**Version**: 3.27.3 | **Last Updated**: February 2026
+**Version**: 3.27.4 | **Last Updated**: February 2026

 ---

@ -544,4 +544,4 @@ where.exe claude; claude doctor; claude mcp list

 **Author**: Florian BRUNIAUX | [@Méthode Aristote](https://methode-aristote.fr) | Written with Claude

-*Last updated: February 2026 | Version 3.27.3*
+*Last updated: February 2026 | Version 3.27.4*
--- a/guide/ultimate-guide.md
+++ b/guide/ultimate-guide.md
@ -16,7 +16,7 @@ tags: [guide, reference, workflows, agents, hooks, mcp, security]

 **Last updated**: January 2026

-**Version**: 3.27.3
+**Version**: 3.27.4

 ---

@ -4292,7 +4292,7 @@ The `.claude/` folder is your project's Claude Code directory for memory, settin
 | Personal preferences | `CLAUDE.md` | ❌ Gitignore |
 | Personal permissions | `settings.local.json` | ❌ Gitignore |

-### 3.27.3 Version Control & Backup
+### 3.27.4 Version Control & Backup

 **Problem**: Without version control, losing your Claude Code configuration means hours of manual reconfiguration across agents, skills, hooks, and MCP servers.

@ -12951,7 +12951,7 @@ Changes committed and pushed? → Use git revert

 **What are worktrees?**

-Git worktrees create multiple working directories from the same repository, each checked out to a different branch.
+Git worktrees (available since Git 2.5.0, July 2015) create multiple working directories from the same repository, each checked out to a different branch.

 **Traditional workflow problem:**

@ -12998,21 +12998,37 @@ claude                    # Continue feature work
 - Disk space is limited (each worktree = full working directory)
 - Team is unfamiliar with worktrees (adds complexity)

-**Quick setup with Claude:**
+**Worktree lifecycle commands:**
+
+The full worktree lifecycle is covered by 4 companion commands:
+
+| Command | Purpose |
+|---------|---------|
+| `/git-worktree` | Create worktree with branch validation, symlinked deps, background checks |
+| `/git-worktree-status` | Check background verification tasks (type check, tests, build) |
+| `/git-worktree-remove` | Safely remove single worktree with merge checks and DB cleanup |
+| `/git-worktree-clean` | Batch cleanup of stale worktrees with disk usage report |

 ```bash
-# Use the /git-worktree command (see examples/commands/git-worktree.md)
-You: "/git-worktree feature/new-api"
+# Create with auto-prefix and symlinked node_modules
+You: "/git-worktree auth"
+# → Creates feat/auth branch, symlinks node_modules, runs checks in background

-Claude:
-# Checks for .worktrees/ or worktrees/ directory
-# Verifies .gitignore has worktree directory excluded
-# Creates worktree: git worktree add .worktrees/feature/new-api -b feature/new-api
-# Installs dependencies (npm/yarn/pnpm auto-detected)
-# Runs baseline tests
-# Reports: "Worktree ready at /path/to/.worktrees/feature/new-api"
+# Check background verification status
+You: "/git-worktree-status"
+# → Type check: PASS, Tests: PASS (142 tests)
+
+# Remove after merge
+You: "/git-worktree-remove feat/auth"
+# → Removes worktree + branch (local + remote) + DB cleanup reminder
+
+# Batch cleanup of all merged worktrees
+You: "/git-worktree-clean --dry-run"
+# → Preview: 3 merged (4.2 MB), 1 unmerged (kept)
 ```

+> **💡 Tip — Symlink node_modules**: The `/git-worktree` command symlinks `node_modules` from the main worktree by default, saving ~30s per worktree creation and significant disk space. Use `--isolated` when you need fresh dependencies (e.g., testing upgrades).
+
 **Worktree management:**

 ```bash
@ -13153,7 +13169,11 @@ git worktree remove --force .worktrees/old-feature

 **Resources:**
 - [Git Worktree Documentation](https://git-scm.com/docs/git-worktree)
- Example command: [`examples/commands/git-worktree.md`](../examples/commands/git-worktree.md)
+- Worktree lifecycle commands:
+  - [`examples/commands/git-worktree.md`](../examples/commands/git-worktree.md) — Create
+  - [`examples/commands/git-worktree-status.md`](../examples/commands/git-worktree-status.md) — Status
+  - [`examples/commands/git-worktree-remove.md`](../examples/commands/git-worktree-remove.md) — Remove
+  - [`examples/commands/git-worktree-clean.md`](../examples/commands/git-worktree-clean.md) — Clean

 ### Database Branch Isolation with Worktrees

@ -19577,4 +19597,4 @@ We'll evaluate and add it to this section if it meets quality criteria.

 **Contributions**: Issues and PRs welcome.

-**Last updated**: January 2026 | **Version**: 3.27.3
+**Last updated**: January 2026 | **Version**: 3.27.4
--- a/machine-readable/reference.yaml
+++ b/machine-readable/reference.yaml
@ -3,7 +3,7 @@
 # Source: guide/ultimate-guide.md
 # Purpose: Condensed index for LLMs to quickly answer user questions about Claude Code

-version: "3.27.3"
+version: "3.27.4"
 updated: "2026-02-17"

 # ════════════════════════════════════════════════════════════════
@ -186,7 +186,7 @@ deep_dive:
  third_party_toad: "https://github.com/batrachianai/toad"
  third_party_conductor: "https://docs.conductor.build"
  # Configuration Management & Backup (Added 2026-02-02)
-  config_management_guide: "guide/ultimate-guide.md:4085"  # Section 3.27.3
+  config_management_guide: "guide/ultimate-guide.md:4085"  # Section 3.27.4
  config_hierarchy: "guide/ultimate-guide.md:4095"  # Global → Project → Local precedence
  config_git_strategy_project: "guide/ultimate-guide.md:4110"  # What to commit in .claude/
  config_git_strategy_global: "guide/ultimate-guide.md:4133"  # Version control ~/.claude/
@ -1205,7 +1205,7 @@ ecosystem:
      - "Cross-links modified → Update all 4 repos"
    history:
      - date: "2026-01-20"
-        event: "Code Landing sync v3.27.3, 66 templates, cross-links"
+        event: "Code Landing sync v3.27.4, 66 templates, cross-links"
        commit: "5b5ce62"
      - date: "2026-01-20"
        event: "Cowork Landing fix (paths, README, UI badges)"
@ -1217,7 +1217,7 @@ ecosystem:
 onboarding_matrix_meta:
  version: "2.0.0"
  last_updated: "2026-02-05"
-  aligned_with_guide: "3.27.3"
+  aligned_with_guide: "3.27.4"
  changelog:
    - version: "2.0.0"
      date: "2026-02-05"
@ -1245,7 +1245,7 @@ onboarding_matrix:
      core: [rules, sandbox_native_guide, commands]
      time_budget: "5 min"
      topics_max: 3
-      note: "SECURITY FIRST - sandbox before commands (v3.27.3 critical fix)"
+      note: "SECURITY FIRST - sandbox before commands (v3.27.4 critical fix)"

    beginner_15min:
      core: [rules, sandbox_native_guide, workflow, essential_commands]
@ -1330,7 +1330,7 @@ onboarding_matrix:
        - default: agent_validation_checklist
      time_budget: "60 min"
      topics_max: 6
-      note: "Dual-instance pattern for quality workflows (v3.27.3)"
+      note: "Dual-instance pattern for quality workflows (v3.27.4)"

  learn_security:
    intermediate_30min:
@ -1341,7 +1341,7 @@ onboarding_matrix:
        - default: permission_modes
      time_budget: "30 min"
      topics_max: 4
-      note: "NEW goal (v3.27.3) - Security-focused learning path"
+      note: "NEW goal (v3.27.4) - Security-focused learning path"

    power_60min:
      core: [sandbox_native_guide, mcp_secrets_management, security_hardening]
@ -1366,7 +1366,7 @@ onboarding_matrix:
      core: [rules, sandbox_native_guide, workflow, essential_commands, context_management, plan_mode]
      time_budget: "60 min"
      topics_max: 6
-      note: "Security foundation + core workflow (v3.27.3 sandbox added)"
+      note: "Security foundation + core workflow (v3.27.4 sandbox added)"

    intermediate_120min:
      core: [plan_mode, agents, skills, config_hierarchy, git_mcp_guide, hooks, mcp_servers]
 @ -1 +1 @@
 .27.3
 .27.4