feat(docs): add security-hardening navigation + onboarding matrix

README.md: - Added security-hardening.md to Core Documentation table - Added to "Not Sure Where to Start?" section - Added to Power User learning path machine-readable/reference.yaml: - Added onboarding_matrix for personalized learning paths - Added onboarding_questions structure for interactive profiling tools/onboarding-prompt.md: - Restructured for goal-based profiling (2 questions → tailored content) - Simplified from assessment-heavy to action-oriented flow Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-15 08:20:50 +01:00 · 2026-01-15 08:20:50 +01:00 · 81a5caa5db
commit 81a5caa5db
parent 5575ae69a8
3 changed files with 291 additions and 169 deletions
--- a/README.md
+++ b/README.md
@ -16,12 +16,35 @@

 ---

-**Start here:**
- [Cheat Sheet](./guide/cheatsheet.md) — print this, start coding
- [15-min Quick Start](./guide/ultimate-guide.md#1-quick-start-day-1) — first workflow
- [Audit your setup](./examples/scripts/audit-scan.sh) — quick scan
+## Get Started in 60 Seconds

-**Go deeper** (optional): [Learning paths by role](#-by-role-tailored-learning-paths) | [Full guide](./guide/ultimate-guide.md)
+```bash
+# Interactive onboarding - adapts to your level and goals
+claude -p "$(curl -sL https://raw.githubusercontent.com/FlorianBruniaux/claude-code-ultimate-guide/main/tools/onboarding-prompt.md)"
+```
+
+**Or browse directly:** [Cheat Sheet](./guide/cheatsheet.md) | [Quick Start](./guide/ultimate-guide.md#1-quick-start-day-1) | [Full Guide](./guide/ultimate-guide.md)
+
+---
+
+## 5 Rules to Remember
+
+1. **Review diffs** before accepting changes
+2. **`/compact` at 70%** context usage (check with `/status`)
+3. **Be specific**: WHAT + WHERE + HOW + VERIFY
+4. **Plan Mode first** for risky/complex tasks (Shift+Tab×2)
+5. **Create CLAUDE.md** for every project
+
+---
+
+## Choose Your Path
+
+| I want to... | Go here |
+|--------------|---------|
+| Learn step by step | Run the onboarding command above |
+| Find something specific | [Guide Navigation](#-guide-navigation) |
+| Test my knowledge | [Quiz](./quiz/) |
+| Fix a problem | [Troubleshooting](./guide/ultimate-guide.md#troubleshooting) |

 ---

@ -53,32 +76,6 @@

 ---

-## Choose Your Path
-
-### 🧭 Not Sure Where to Start?
-
-| If you... | Start here | Depth |
-|-----------|------------|-------|
-| Just installed Claude Code | [Quick Start](./guide/ultimate-guide.md#1-quick-start-day-1) | Essentials |
-| Want to understand core concepts | [Junior Path](#-by-role-tailored-learning-paths) | Foundation |
-| Already use AI coding tools | [Senior Path](#-by-role-tailored-learning-paths) | Intermediate |
-| Need to configure a team setup | [Power User Path](#-by-role-tailored-learning-paths) | Comprehensive |
-| Need to evaluate/approve adoption | [PM Path](#-by-role-tailored-learning-paths) | Overview |
-| Want TDD/BDD with Claude | [Workflows](./guide/workflows/) | Practical |
-| Need a dev methodology reference | [Methodologies](./guide/methodologies.md) | Reference |
-| Want to understand internals | [Architecture](./guide/architecture.md) | Deep dive |
-| Need data privacy guidance | [Data Privacy](./guide/data-privacy.md) | Quick read |
-| Need security hardening | [Security Hardening](./guide/security-hardening.md) | Essential |
-| Want to track costs & sessions | [Observability](./guide/observability.md) | Monitoring |
-| Choosing turnkey vs. autonomous approach | [Adoption Guide](./guide/adoption-approaches.md) | Quick read |
-| Want to check your current setup | [Audit Your Setup](#-audit-your-setup) | Quick scan |
-| Want AI assistants to know Claude Code | [LLM Reference](#-llm-reference) | Reference |
-| Want personalized recommendations | [Deep Audit](#-deep-audit-personalized-recommendations) | Quick scan |
-| Want to test your knowledge | [Knowledge Quiz](#-knowledge-quiz) | Interactive |
-| Want a guided tour | [Personalized Onboarding](./tools/onboarding-prompt.md) | Interactive |
-| Having issues with Claude Code | [/diagnose command](./examples/commands/diagnose.md) | Quick fix |
-| Want mobile access to Claude Code | [Mobile Access Setup](./tools/mobile-access.md) | WIP |
-
 ### ⚡ Audit Your Setup

 Already have Claude Code installed? Quickly scan your configuration:
@ -249,11 +246,8 @@ Weak Areas (< 75%):

 ### 🎯 By Role (Tailored Learning Paths)

-<table>
-<tr>
-<td width="50%">
-
-**Junior Developer** (Foundation path)
+<details>
+<summary><strong>Junior Developer</strong> — Foundation path (6 steps)</summary>

 1. [Quick Start](./guide/ultimate-guide.md#1-quick-start-day-1) — Install & first workflow
 2. [Essential Commands](./guide/ultimate-guide.md#13-essential-commands) — The 7 commands
@ -262,10 +256,10 @@ Weak Areas (< 75%):
 5. [TDD Workflow](./guide/workflows/tdd-with-claude.md) — Test-first development
 6. [Cheat Sheet](./guide/cheatsheet.md) — Print this

-</td>
-<td width="50%">
+</details>

-**Senior Developer** (Intermediate path)
+<details>
+<summary><strong>Senior Developer</strong> — Intermediate path (6 steps)</summary>

 1. [Core Concepts](./guide/ultimate-guide.md#2-core-concepts) — Mental model
 2. [Plan Mode](./guide/ultimate-guide.md#23-plan-mode) — Safe exploration
@ -274,12 +268,10 @@ Weak Areas (< 75%):
 5. [Hooks](./guide/ultimate-guide.md#7-hooks) — Event automation
 6. [CI/CD Integration](./guide/ultimate-guide.md#93-cicd-integration) — Pipelines

-</td>
-</tr>
-<tr>
-<td width="50%">
+</details>

-**Power User** (Comprehensive path)
+<details>
+<summary><strong>Power User</strong> — Comprehensive path (7 steps)</summary>

 1. [Complete Guide](./guide/ultimate-guide.md) — End-to-end
 2. [Architecture](./guide/architecture.md) — How Claude Code works
@ -289,10 +281,10 @@ Weak Areas (< 75%):
 6. [Observability](./guide/observability.md) — Monitor costs & sessions
 7. [Examples](./examples/) — Production templates

-</td>
-<td width="50%">
+</details>

-**Product Manager** (Overview path)
+<details>
+<summary><strong>Product Manager</strong> — Overview path (5 steps)</summary>

 1. [What's Inside](#-complete-toolkit) — Scope
 2. [Golden Rules](#-golden-rules) — Key principles
@ -300,9 +292,7 @@ Weak Areas (< 75%):
 4. [Adoption Approaches](./guide/adoption-approaches.md) — Team strategies
 5. [Context Management](./guide/ultimate-guide.md#22-context-management) — Why it matters

-</td>
-</tr>
-</table>
+</details>

 ---

--- 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.5.0"
+version: "3.6.0"
 updated: "2026-01"

 # ════════════════════════════════════════════════════════════════
@ -314,3 +314,82 @@ rules:
  4: "Plan Mode first for complex/risky"
  5: "Create CLAUDE.md for every project"
  6: "Commit frequently after each task"
+
+# ════════════════════════════════════════════════════════════════
+# ONBOARDING MATRIX - Maps user profile → content sections
+# Used by tools/onboarding-prompt.md for personalized learning paths
+# ════════════════════════════════════════════════════════════════
+onboarding_matrix:
+  # Format: goal.level_time → list of deep_dive keys to cover
+
+  get_started:
+    beginner_5min: [rules, commands, shortcuts]
+    beginner_15min: [rules, workflow, essential_commands, context.zones]
+    beginner_30min: [rules, workflow, essential_commands, context_management, permission_modes]
+
+  optimize:
+    intermediate_15min: [context_management, context_triage, plan_mode]
+    intermediate_30min: [context_management, plan_mode, memory_files, cost_optimization]
+    power_30min: [context_triage, trinity_pattern, batch_operations]
+
+  build_agents:
+    intermediate_30min: [agents, agent_template, agent_examples]
+    power_30min: [agents, agent_template, skills, skill_template, commands]
+    power_60min: [agents, skills, commands, hooks, agent_validation_checklist]
+
+  fix_problem:
+    any_any: [troubleshooting, fix, context.symptoms]
+
+  learn_everything:
+    beginner_60min: [workflow, essential_commands, context_management, memory_files, plan_mode]
+    intermediate_120min: [plan_mode, agents, skills, hooks, mcp_servers]
+    power_120min: [architecture, mcp_servers, hooks, trinity_pattern, cicd]
+
+# ════════════════════════════════════════════════════════════════
+# ONBOARDING QUESTIONS - Structure for interactive profiling
+# ════════════════════════════════════════════════════════════════
+onboarding_questions:
+  mandatory:
+    goal:
+      ask: "What's your goal right now?"
+      options:
+        get_started: "🚀 Get started quickly"
+        optimize: "📈 Optimize my workflow"
+        build_agents: "🏗️ Build custom agents/skills"
+        fix_problem: "🐛 Fix a problem"
+        learn_everything: "📚 Learn everything"
+
+    level:
+      ask: "Experience with Claude Code?"
+      options:
+        beginner: "🟢 Beginner (never used / just installed)"
+        intermediate: "🟡 Intermediate (daily use)"
+        power: "🔴 Power User (know basics, want advanced)"
+
+  optional:
+    time:
+      ask: "How much time do you have?"
+      options:
+        5min: "⚡ 5-10 min"
+        15min: "⏱️ 15-30 min"
+        30min: "🎯 30-60 min"
+        60min: "📚 1+ hour"
+        120min: "📖 2+ hours"
+      default: "30min"
+
+    style:
+      ask: "How do you prefer to learn?"
+      options:
+        explain: "📖 Explanations (tell me why)"
+        examples: "💻 Examples (show me code)"
+        reference: "🎯 Quick reference (just the facts)"
+        handson: "🏋️ Hands-on (let me try)"
+      trigger: "Only ask if time >= 30min"
+
+  # Logic for progressive questioning
+  question_flow:
+    fix_problem: "goal only → skip to troubleshooting"
+    get_started: "goal → level"
+    optimize: "goal → level → time"
+    build_agents: "goal → level → time"
+    learn_everything: "goal → level → time → style"
--- a/tools/onboarding-prompt.md
+++ b/tools/onboarding-prompt.md
@ -12,54 +12,45 @@

 This prompt instructs Claude to become your personal onboarding coach by:

-1. **Assessing** your current Claude Code knowledge level through interactive questions
-2. **Reading** the comprehensive guide documentation
-3. **Presenting** a structured learning path tailored to your level
-4. **Guiding** you progressively with the option to dive deeper on any topic
-5. **Adapting** to your preferred language (English, French, or any other)
+1. **Profiling** you with 2 quick questions (goal + level)
+2. **Loading** the reference index for smart navigation
+3. **Routing** you to the right content based on your profile
+4. **Guiding** you progressively with depth control (yes/next/skip)
+5. **Adapting** to your preferred language

-**Experience**: Interactive Q&A format - you control the pace and depth.
+**Experience**: 2 questions → tailored content → interactive exploration.

-**Important**: Claude will ask questions to understand your needs before presenting information.
+**Time**: 5-60 minutes depending on your goal and available time.

 ---

 ## 2. Who This Is For

-| Level | What You'll Experience |
-|-------|------------------------|
-| **Beginner** | Full guided tour from installation to first workflows |
-| **Intermediate** | Focus on Plan Mode, context management, cost optimization |
-| **Power User** | Deep dive into Agents, Skills, Hooks, MCPs, and advanced patterns |
+| Goal | What You'll Get |
+|------|-----------------|
+| **Get started** | Golden Rules + essential commands + first workflow |
+| **Optimize** | Context management + Plan Mode + cost optimization |
+| **Build agents** | Agent/Skill/Command templates + hooks |
+| **Fix a problem** | Direct jump to troubleshooting |
+| **Learn everything** | Complete guided tour |

-**Prerequisites**:
- Claude Code installed (or wanting to learn about it)
- ~15-30 minutes for the initial assessment and overview
- Curiosity about maximizing your Claude Code productivity
-
-**Time**: Self-paced (typically 15-60 minutes depending on depth)
+**Prerequisites**: Claude Code installed (or wanting to learn about it)

 ---

 ## 3. How to Use It

-### Step 1: Copy the Prompt
-
-Copy everything inside the code block in [Section 4](#4-the-prompt) below.
-
-### Step 2: Run Claude Code
+### Option A: One-liner (recommended)

 ```bash
-claude
+claude -p "$(curl -sL https://raw.githubusercontent.com/FlorianBruniaux/claude-code-ultimate-guide/main/tools/onboarding-prompt.md)"
 ```

-### Step 3: Paste and Interact
+### Option B: Manual

-Paste the prompt and press Enter. Claude will begin by asking about your preferred language and experience level.
-
-### Step 4: Explore at Your Pace
-
-Answer Claude's questions and request deeper dives on topics that interest you.
+1. Copy the prompt from [Section 4](#4-the-prompt) below
+2. Run `claude`
+3. Paste and press Enter

 ---

@ -70,145 +61,207 @@ Answer Claude's questions and request deeper dives on topics that interest you.

 ## Your Role

-You are an expert Claude Code instructor. Your mission is to onboard me to Claude Code using "The Ultimate Claude Code Guide" as your reference material.
+You are an expert Claude Code instructor. Your mission is to onboard me using the reference index as your navigation map.

 ## Instructions

-### Phase 0: Language & Level Assessment
+### Phase 0: Quick Profile (2 mandatory questions)

-**First, ask me these questions ONE AT A TIME:**
+**Ask ONE AT A TIME:**

-1. **Language**: "What language would you prefer for this onboarding? (e.g., English, French, Spanish, German...)"
+1. **Language**: "What language would you prefer? (English, French, Spanish...)"

-2. **Experience Level**: After I answer, ask:
-   "What's your current experience with Claude Code?
-   - 🟢 **Beginner**: Never used it or just installed it
-   - 🟡 **Intermediate**: Use it daily but want to optimize
-   - 🔴 **Power User**: Know the basics, want advanced features"
+2. **Goal**: After I answer, ask:
+   "What's your goal right now?
+   - 🚀 **Get started** - Learn the basics quickly
+   - 📈 **Optimize** - Improve my existing workflow
+   - 🏗️ **Build agents** - Create custom agents/skills/commands
+   - 🐛 **Fix a problem** - Troubleshoot an issue
+   - 📚 **Learn everything** - Complete guided tour"

-3. **Focus Areas** (optional): Based on my level, you may ask what specific topics interest me most.
+### Phase 1: Load Knowledge Index

-### Phase 0.5: Privacy Awareness (CRITICAL)
+**Fetch the navigation index:**

-**After level assessment, inform the user about data privacy:**
+```
+https://raw.githubusercontent.com/FlorianBruniaux/claude-code-ultimate-guide/main/machine-readable/reference.yaml
+```

-⚠️ **Important Privacy Notice** (always show this):
- Everything you share with Claude Code is sent to Anthropic servers
- Default retention: **5 years** (training enabled)
- Opt-out retention: **30 days** (disable training)
+**This file contains:**
+- `onboarding_matrix`: Maps goal+level+time → content sections
+- `onboarding_questions`: Questions structure and flow logic
+- `deep_dive`: Line numbers for each topic in the guide
+- `rules`: Golden Rules (always show first)
+- `decide`: Decision tree for common situations
+- `commands`, `shortcuts`, `context`: Quick reference sections

-**Action required**: [Disable training](https://claude.ai/settings/data-privacy-controls) to reduce retention from 5 years to 30 days.
+### Phase 1.5: Refine Profile (progressive - based on goal)

-**Ask**: "Have you configured your privacy settings? Should I explain more about data protection?"
+Based on the goal from Phase 0, ask ONLY the necessary additional questions:

-If they want more details, mention:
- Add `.env*` to excludePatterns
- Never connect production databases to MCP
- See [Data Privacy Guide](../guide/data-privacy.md) for full details
+| Goal | Additional Questions |
+|------|---------------------|
+| `fix_problem` | None → Skip directly to troubleshooting |
+| `get_started` | Level only (beginner/intermediate/power) |
+| `optimize` | Level + Time available |
+| `build_agents` | Level + Time available |
+| `learn_everything` | Level + Time + Learning style preference |

-### Phase 1: Read the Guide
+**Level question** (from `onboarding_questions.mandatory.level`):
+"Experience with Claude Code?
+- 🟢 **Beginner** - Never used / just installed
+- 🟡 **Intermediate** - Daily use, want to optimize
+- 🔴 **Power User** - Know basics, want advanced"

-**After understanding my preferences, read the guide:**
+**Time question** (from `onboarding_questions.optional.time`):
+"How much time do you have?
+- ⚡ 5-10 min
+- ⏱️ 15-30 min
+- 🎯 30-60 min
+- 📚 1+ hour"

-Fetch and read the complete guide from:
-https://raw.githubusercontent.com/FlorianBruniaux/claude-code-ultimate-guide/main/guide/ultimate-guide.md
+**Style question** (only if time >= 30min, from `onboarding_questions.optional.style`):
+"How do you prefer to learn?
+- 📖 Explanations (tell me why)
+- 💻 Examples (show me code)
+- 🎯 Quick reference (just the facts)
+- 🏋️ Hands-on (let me try)"

-**Alternative**: If the URL is not accessible, use WebSearch to find the guide content or ask me to provide it.
+### Phase 2: Route and Present

-### Phase 2: Present Structured Overview
+1. **Build matrix key**: `{goal}.{level}_{time}`
+   - Example: `optimize.intermediate_30min`
+   - For `fix_problem`: use `fix_problem.any_any`

-**Create a learning roadmap based on my level:**
+2. **Lookup in `onboarding_matrix`** → Get list of `deep_dive` keys

-For **Beginners** (🟢), focus on:
- Installation & first run
- The 5 essential commands
- Permission modes (suggest, auto-edit, full-auto)
- Basic context management
- Cost awareness
+3. **Always show FIRST (before any content):**

-For **Intermediate** (🟡), focus on:
- Plan Mode and when to use it
- Context window optimization
- OpusPlan pattern (Opus plans, Sonnet executes)
- Session management
- CLAUDE.md best practices
+   **Golden Rules** (from `rules` section):
+   1. Always review diffs before accepting
+   2. Use `/compact` before >70% context
+   3. Be specific: WHAT + WHERE + HOW + VERIFY
+   4. Plan Mode first for complex/risky tasks
+   5. Create CLAUDE.md for every project

-For **Power Users** (🔴), focus on:
- Commands vs Skills vs Agents distinction
- Custom agents creation
- Hooks system
- MCP servers configuration
- Ultrathink + Sequential Thinking
- Advanced patterns (XML prompting, split roles)
+4. **Then present the content roadmap:**
+   - List the topics from the matrix lookup
+   - Ask: "Which topic first? Or type 'all' for sequential walkthrough."

 ### Phase 3: Interactive Exploration

-**After presenting the overview:**
+**For each topic in the roadmap:**

-1. Present a table of contents for my level
-2. Ask: "Which topic would you like to explore first? Or type 'all' for a complete walkthrough."
-3. For each topic:
-   - Give a concise summary (2-3 key points)
-   - Ask: "Want to go deeper on this? (yes/next/skip)"
-   - If "yes": provide detailed explanation with examples
-   - If "next": move to next topic with brief summary
-   - If "skip": skip entirely
+1. **Locate content**: Use `deep_dive[key]` to find the line number in `guide/ultimate-guide.md`

-### Phase 4: Practical Exercises (Optional)
+2. **Fetch and summarize**: Get the relevant section (typically 50-100 lines from the line number)

-**If I want hands-on practice, suggest:**
+3. **Present summary**: 2-3 key points adapted to user's style preference:
+   - `explain` → Focus on WHY and concepts
+   - `examples` → Lead with code samples
+   - `reference` → Bullet points, no prose
+   - `handson` → Give them something to try immediately

- For Beginners: "Try running `claude` and ask it to explain a file in your project"
- For Intermediate: "Use Plan Mode (Shift+Tab x2) on your next feature"
- For Power Users: "Create a custom agent for your most common task"
+4. **Depth control**: Ask "Want to go deeper? (yes/next/skip)"
+   - `yes` → Provide detailed explanation with examples
+   - `next` → Brief summary, move to next topic
+   - `skip` → Skip entirely
+
+5. **Handle questions**: If user asks something specific, use `deep_dive` to find relevant section
+
+### Phase 4: Wrap-up
+
+Based on time spent and topics covered:
+
+1. **Recap**: Summarize what was covered (3-5 bullet points)
+
+2. **Quick wins**: Suggest 1-2 immediate actions based on their goal:
+   - `get_started` → "Try running `claude` and ask it to explain a file"
+   - `optimize` → "Use `/status` to check your context usage"
+   - `build_agents` → "Create a simple agent using the template shown"
+   - `fix_problem` → "Run `claude doctor` if issues persist"
+
+3. **Next steps**: Point to relevant resources:
+   - Quiz for self-assessment: `quiz/`
+   - Cheat sheet to print: `guide/cheatsheet.md`
+   - Full guide for deep dive: `guide/ultimate-guide.md`
+
+### Privacy Notice (show once, after Phase 2)
+
+⚠️ **Data Privacy Reminder**:
+- Everything shared with Claude Code is sent to Anthropic servers
+- Default retention: **5 years** (training enabled)
+- Action: [Disable training](https://claude.ai/settings/data-privacy-controls) → reduces to 30 days
+- See `guide/data-privacy.md` for full details

 ## Output Format

 - Use tables for structured information
 - Use code blocks for commands and examples
- Keep explanations concise unless I ask for details
+- Keep explanations concise unless user asks for details
 - Always end sections with a question to keep it interactive
- Adapt your vocabulary and examples to my stated language
+- Respond in user's preferred language throughout

 ## Key Principles

-1. **Interactive**: Always ask before dumping information
-2. **Progressive**: Build complexity gradually
-3. **Practical**: Focus on actionable knowledge
-4. **Respectful of time**: Let me control the pace
-5. **Multilingual**: Respond in my preferred language throughout
+1. **Fast**: 2 questions max before delivering value
+2. **Targeted**: Content matches goal, not generic overview
+3. **Interactive**: User controls pace and depth
+4. **Practical**: Focus on actionable knowledge
+5. **Multilingual**: Full conversation in preferred language

 ## Start Now

-Begin by asking me about my preferred language.
+Begin by asking about preferred language.
 ```

 ---

 ## 5. Example Interaction

-Here's how a typical onboarding session might go:
-
 **Claude**: What language would you prefer for this onboarding?

 **You**: French

-**Claude**: Parfait ! Quel est ton niveau actuel avec Claude Code ?
+**Claude**: Parfait ! Quel est ton objectif maintenant ?
+- 🚀 **Démarrer** - Apprendre les bases rapidement
+- 📈 **Optimiser** - Améliorer mon workflow existant
+- 🏗️ **Créer des agents** - Construire des agents/skills personnalisés
+- 🐛 **Résoudre un problème** - Dépanner un souci
+- 📚 **Tout apprendre** - Tour guidé complet
+
+**You**: Optimiser
+
+**Claude**: Quel est ton niveau avec Claude Code ?
 - 🟢 Débutant
 - 🟡 Intermédiaire
 - 🔴 Power User

 **You**: Intermédiaire

-**Claude**: *[Presents tailored overview in French with focus on Plan Mode, context optimization, etc.]*
+**Claude**: Combien de temps as-tu ?
+- ⚡ 5-10 min
+- ⏱️ 15-30 min
+- 🎯 30-60 min

-Quel sujet veux-tu explorer en premier ?
+**You**: 15-30 min

-**You**: Plan Mode
+**Claude**:
+*[Loads reference.yaml, looks up `optimize.intermediate_15min`]*

-**Claude**: *[Explains Plan Mode with examples]*
+**5 Règles d'Or** (à retenir) :
+1. Toujours relire les diffs avant d'accepter
+2. `/compact` dès 70% de contexte
+3. Être précis : QUOI + OÙ + COMMENT + VÉRIFIER
+4. Plan Mode d'abord pour les tâches complexes
+5. Créer un CLAUDE.md pour chaque projet

-Tu veux approfondir ou passer au sujet suivant ?
+**Ton parcours** (3 topics, ~15 min) :
+1. Gestion du contexte
+2. Triage du contexte
+3. Plan Mode
+
+Par quel sujet veux-tu commencer ?

 ---

@ -216,20 +269,20 @@ Tu veux approfondir ou passer au sujet suivant ?

 | Tip | Why It Helps |
 |-----|--------------|
-| **Be honest about your level** | Gets you the right content, not too basic or advanced |
-| **Say "deeper" when curious** | Claude will provide more examples and edge cases |
-| **Say "skip" freely** | No need to cover what you already know |
-| **Ask for examples** | Practical examples solidify understanding |
-| **Request your language** | Works in any language Claude supports |
+| **Be honest about your goal** | Gets you targeted content, not generic tour |
+| **Say "deeper" when curious** | Claude will provide more examples |
+| **Say "skip" freely** | No need to cover what you know |
+| **Ask questions anytime** | Claude will find the relevant section |

 ---

 ## 7. Related Resources

- [The Ultimate Claude Code Guide](https://github.com/FlorianBruniaux/claude-code-ultimate-guide/blob/main/guide/ultimate-guide.md) - Full reference
- [Architecture & Internals](https://github.com/FlorianBruniaux/claude-code-ultimate-guide/blob/main/guide/architecture.md) - How Claude Code works
- [Claude Code Setup Audit](./audit-prompt.md) - Analyze your configuration
- [Quick Reference Cheatsheet](../guide/cheatsheet.md) - Commands at a glance
+- [Reference Index](../machine-readable/reference.yaml) - The navigation map Claude uses
+- [Ultimate Guide](../guide/ultimate-guide.md) - Full documentation
+- [Cheat Sheet](../guide/cheatsheet.md) - Print this, start coding
+- [Setup Audit](./audit-prompt.md) - Analyze your configuration
+- [Quiz](../quiz/) - Test your knowledge

 ---

@ -238,4 +291,4 @@ Tu veux approfondir ou passer au sujet suivant ?
 Found this helpful? Have suggestions?
 - Star the repo: [claude-code-ultimate-guide](https://github.com/FlorianBruniaux/claude-code-ultimate-guide)
 - Open an issue for improvements
- Share with others learning Claude Code
+- Share with others learning Claude Code