diff --git a/README.md b/README.md
index 8a2933f..526bdb8 100644
--- a/README.md
+++ b/README.md
@@ -7,7 +7,7 @@
-
+
@@ -33,7 +33,7 @@
- โ
**Visualize concepts** โ 40 Mermaid diagrams covering model selection, master loop, memory hierarchy, multi-agent patterns, security threats
- โ
**Master methodologies** โ TDD, SDD, BDD with AI collaboration (not just templates)
- โ
**Security mindset** โ Threat modeling for AI systems (only guide with 24 CVEs + 655 malicious skills database)
-- โ
**Test your knowledge** โ 271-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.
@@ -49,7 +49,7 @@ 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 (24 CVEs) | Basic patterns only |
-| **Test understanding** | 271-question quiz | Not available |
+| **Test understanding** | 274-question quiz | Not available |
| **Methodologies** (TDD/SDD/BDD) | Full workflow guides | Not covered |
| **Copy-paste ready** templates | 175 templates | 200+ templates |
@@ -60,7 +60,7 @@ Both guides serve different needs. Choose based on your priority.
โฒ
โ
โ โ
This Guide
- โ Security + Methodologies + 19K lines
+ โ Security + Methodologies + 20K lines
โ
โ [Everything-You-Need-to-Know]
โ SDLC/BMAD beginner
@@ -77,8 +77,8 @@ Both guides serve different needs. Choose based on your priority.
**4 unique gaps no competitor covers:**
1. **Security-First** โ 24 CVEs + 655 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** โ 271-question quiz, beginner โ expert path
+3. **Comprehensive Reference** โ 20K lines across 16 specialized guides (24ร more reference material than everything-cc)
+4. **Educational Progression** โ 274-question quiz, beginner โ expert path
**Recommended workflow:**
1. Learn concepts here (mental models, trade-offs, security)
@@ -136,9 +136,9 @@ Save as `CLAUDE.md` in your project root. Claude reads it automatically.
graph LR
root[๐ฆ Repository
Root]
- root --> guide[๐ guide/
19K lines]
+ root --> guide[๐ guide/
20K lines]
root --> examples[๐ examples/
175 templates]
- root --> quiz[๐ง quiz/
271 questions]
+ root --> quiz[๐ง quiz/
274 questions]
root --> tools[๐ง tools/
utils]
root --> machine[๐ค machine-readable/
AI index]
root --> docs[๐ docs/
83 evaluations]
@@ -158,7 +158,7 @@ graph LR
```
๐ฆ claude-code-ultimate-guide/
โ
-โโ ๐ guide/ Core Documentation (~20K lines)
+โโ ๐ guide/ Core Documentation (20K+ lines)
โ โโ ultimate-guide.md Complete reference, 10 sections
โ โโ cheatsheet.md 1-page printable
โ โโ architecture.md How Claude Code works internally
@@ -175,7 +175,7 @@ graph LR
โ โโ skills/ 14 skills (9 on SkillHub)
โ โโ scripts/ Utility scripts (audit, search)
โ
-โโ ๐ง quiz/ 271 Questions
+โโ ๐ง quiz/ 274 Questions
โ โโ 9 categories Setup, Agents, MCP, Trust, Advanced...
โ โโ 4 profiles Junior, Senior, Power User, PM
โ โโ Instant feedback Doc links + score tracking
@@ -226,7 +226,7 @@ graph LR
[Browse all 40 diagrams โ](./guide/diagrams/)
-**What this means for you**: Understand the master loop before reading 19K lines, see multi-agent topologies at a glance, share visual security threat models with your team.
+**What this means for you**: Understand the master loop before reading 20K lines, see multi-agent topologies at a glance, share visual security threat models with your team.
---
@@ -245,7 +245,7 @@ graph LR
---
-### ๐ 271-Question Knowledge Validation (Unique in Ecosystem)
+### ๐ 274-Question Knowledge Validation (Unique in Ecosystem)
**Outcome**: Verify your understanding + identify knowledge gaps.
@@ -289,7 +289,7 @@ Complete guides with rationale and examples:
---
-### ๐ 164 Annotated Templates
+### ๐ 175 Annotated Templates
**Outcome**: Learn patterns, not just configs.
@@ -703,7 +703,7 @@ Use this guide critically. Experiment. Share what works for you.
| File | Purpose | Time |
|------|---------|------|
-| **[Ultimate Guide](./guide/ultimate-guide.md)** | Complete reference (~19K lines), 10 sections | 30-40h (full) โข Most consult sections |
+| **[Ultimate Guide](./guide/ultimate-guide.md)** | Complete reference (20K+ lines), 10 sections | 30-40h (full) โข Most consult sections |
| **[Cheat Sheet](./guide/cheatsheet.md)** | 1-page printable reference | 5 min |
| **[Visual Reference](./guide/visual-reference.md)** | 20 ASCII diagrams for key concepts | 5 min |
| **[Architecture](./guide/architecture.md)** | How Claude Code works internally | 25 min |
@@ -721,7 +721,7 @@ Use this guide critically. Experiment. Share what works for you.
| **[Claude Code Releases](./guide/claude-code-releases.md)** | Official release history | 10 min |
-Examples Library (164 templates)
+Examples Library (175 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) โญ
@@ -744,7 +744,7 @@ Use this guide critically. Experiment. Share what works for you.
-Knowledge Quiz (271 questions)
+Knowledge Quiz (274 questions)
Test your Claude Code knowledge with an interactive CLI quiz covering all guide sections.
@@ -834,7 +834,7 @@ 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/) โ 271 questions
+- [Interactive Quiz](./quiz/) โ 274 questions
- [Landing Site](https://florianbruniaux.github.io/claude-code-ultimate-guide-landing/) โ Visual navigation
---