From fb9689fed3bfd5a1e544439c9dae8e2fdd0adac9 Mon Sep 17 00:00:00 2001
From: Florian BRUNIAUX <florian@bruniaux.com>
Date: Sat, 17 Jan 2026 15:50:22 +0100
Subject: [PATCH] docs: sync stats (57 templates, 9800+ lines)

- Update CLAUDE.md with current values
- Update README.md badges and line counts
- Add Fresh Context Pattern reference in methodologies.md

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
---
 CLAUDE.md              | 14 +++++++-------
 README.md              |  8 ++++----
 guide/methodologies.md |  3 +++
 3 files changed, 14 insertions(+), 11 deletions(-)

diff --git a/CLAUDE.md b/CLAUDE.md
index e5652f2..f067473 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -10,7 +10,7 @@ This repository is the **comprehensive documentation for Claude Code** (Anthropi
 
 ```
 guide/                    # Core documentation
-├── ultimate-guide.md     # Main guide (~9500 lines, the reference)
+├── ultimate-guide.md     # Main guide (~9900 lines, the reference)
 ├── cheatsheet.md         # 1-page printable summary
 ├── architecture.md       # How Claude Code works internally
 ├── methodologies.md      # TDD, SDD, BDD workflows
@@ -38,7 +38,7 @@ tools/                    # Interactive utilities
 
 | File | Purpose |
 |------|---------|
-| `VERSION` | Single source of truth for version (currently 3.8.1) |
+| `VERSION` | Single source of truth for version (currently 3.8.2) |
 | `guide/ultimate-guide.md` | The main reference (search here first) |
 | `guide/cheatsheet.md` | Quick reference for daily use |
 | `machine-readable/reference.yaml` | LLM-optimized index with line numbers |
@@ -136,9 +136,9 @@ Après ces modifications, **rappeler** de mettre à jour le landing:
    OK
 
 2. Templates Count
-   Guide:         49 files
-   index.html:    49
-   examples.html: 49
+   Guide:         57 files
+   index.html:    57
+   examples.html: 57
    OK
 
 3. Quiz Questions
@@ -148,8 +148,8 @@ Après ces modifications, **rappeler** de mettre à jour le landing:
    OK
 
 4. Guide Lines
-   Actual:  9637
-   Landing: 9600+ (approximate)
+   Actual:  9881
+   Landing: 9800+ (approximate)
    OK (within tolerance)
 
 === Summary ===
diff --git a/README.md b/README.md
index 527d2fe..45b0f43 100644
--- a/README.md
+++ b/README.md
@@ -2,8 +2,8 @@
 
 <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="#"><img src="https://img.shields.io/badge/Lines-9,600+-blueviolet?style=for-the-badge" alt="Lines"/></a>
-  <a href="./examples/"><img src="https://img.shields.io/badge/Templates-49-green?style=for-the-badge" alt="Templates"/></a>
+  <a href="#"><img src="https://img.shields.io/badge/Lines-9,800+-blueviolet?style=for-the-badge" alt="Lines"/></a>
+  <a href="./examples/"><img src="https://img.shields.io/badge/Templates-57-green?style=for-the-badge" alt="Templates"/></a>
   <a href="./quiz/"><img src="https://img.shields.io/badge/Quiz-159_questions-orange?style=for-the-badge" alt="Quiz"/></a>
 </p>
 
@@ -129,7 +129,7 @@ Claude asks 2-4 questions then guides you through personalized content based on
 - You read official docs → dense, no progression
 - You search tutorials → scattered, outdated in weeks
 
-**This guide:** Structured learning path with 49 copy-paste templates. Your mileage may vary—but this saves you the exploration time.
+**This guide:** Structured learning path with 57 copy-paste templates. Your mileage may vary—but this saves you the exploration time.
 
 | Traditional Docs | This Guide |
 |------------------|------------|
@@ -426,7 +426,7 @@ Weak Areas (< 75%):
 ```
 claude-code-ultimate-guide/
 ├── guide/                    # 📖 Core documentation
-│   ├── ultimate-guide.md     # Complete reference (~9600 lines)
+│   ├── ultimate-guide.md     # Complete reference (~9800 lines)
 │   ├── cheatsheet.md         # 1-page printable reference
 │   ├── architecture.md       # How Claude Code works internally
 │   ├── adoption-approaches.md # Team implementation strategies
diff --git a/guide/methodologies.md b/guide/methodologies.md
index c772952..491b16f 100644
--- a/guide/methodologies.md
+++ b/guide/methodologies.md
@@ -163,6 +163,7 @@ Meta-Agent (Orchestrator)
 | Name | What | Best For | Claude Fit |
 |------|------|----------|------------|
 | **Iterative Loops** | Autonomous refinement | Optimization | ⭐⭐⭐ Core |
+| **Fresh Context** | Reset per task, state in files | Long autonomous sessions | ⭐⭐⭐ Power users |
 | **Prompt Engineering** | Technique foundation | Everything | ⭐⭐⭐ Prerequisite |
 
 **Iterative Refinement Loops** — Autonomous convergence:
@@ -176,6 +177,8 @@ Meta-Agent (Orchestrator)
 - Structured Prompts: XML tags for organization
 - Position Matters: For long docs, place question at end
 
+**Fresh Context Pattern (Ralph Loop)** — Solves context rot by spawning fresh agent instances per task. State persists in git + progress files, not chat history. Ideal for long autonomous sessions (migrations, overnight runs). See [Ultimate Guide - Fresh Context Pattern](./ultimate-guide.md#fresh-context-pattern-ralph-loop) for implementation.
+
 ---
 
 ## SDD Tools Reference