Claude Code Ultimate Guide

6 months of daily practice distilled into a guide that teaches you the WHY, not just the what. From core concepts to production security, you learn to design your own agentic workflows instead of copy-pasting configs.

If this guide helps you, give it a star ⭐ — it helps others discover it too.

StarMapper

<img alt="StarMapper — see who stars this repo on a world map" src="https://starmapper.bruniaux.com/api/map-image/FlorianBruniaux/claude-code-ultimate-guide" />

Choose Your Path

🎯 What You'll Learn

This guide teaches you to think differently about AI-assisted development: - ✅ Understand trade-offs — When to use agents vs skills vs commands (not just how to configure them) - ✅ Build mental models — How Claude Code works internally (architecture, context flow, tool orchestration) - ✅ Visualize concepts — 41 Mermaid diagrams covering model selection, master loop, memory hierarchy, multi-agent patterns, security threats, AI fluency paths - ✅ 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)

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

📊 When to Use This Guide vs Everything-CC

Both guides serve different needs. Choose based on your priority.

Ecosystem Positioning

                    EDUCATIONAL DEPTH
                           ▲
                           │
                           │  ★ This Guide
                           │  Security + Methodologies + 24K+ lines
                           │
                           │  [Everything-You-Need-to-Know]
                           │  SDLC/BMAD beginner
  ─────────────────────────┼─────────────────────────► READY-TO-USE
  [awesome-claude-code]    │            [everything-claude-code]
  (discovery, curation)    │            (plugin, 1-cmd install)
                           │
                           │  [claude-code-studio]
                           │  Context management
                           │
                      SPECIALIZED

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 — 24K+ lines across 16 specialized guides (24× more reference material than everything-cc) 4. Educational Progression — 271-question quiz, beginner → expert path

Recommended workflow: 1. Learn concepts here (mental models, trade-offs, security) 2. Use battle-tested configs there (quick project setup) 3. Return here for deep dives (when something doesn't work or to design custom workflows)

Both resources are complementary, not competitive. Use what fits your current need.

⚡ Quick Start

Quickest path: Cheat Sheet — 1 printable page with daily essentials

Interactive onboarding (no setup needed):

claude "Fetch and follow the onboarding instructions from: https://raw.githubusercontent.com/FlorianBruniaux/claude-code-ultimate-guide/main/tools/onboarding-prompt.md"

Browse directly: Full Guide | Visual Diagrams | Examples | Quiz

🔌 MCP Server — Use the guide from any Claude Code session

No cloning needed. Add to ~/.claude.json and ask questions directly from any session:

{
  "mcpServers": {
    "claude-code-guide": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "claude-code-ultimate-guide-mcp"]
    }
  }
}

17 tools: search_guide, read_section, get_cheatsheet, get_digest, get_example, list_examples, search_examples, get_release, get_changelog, compare_versions, list_topics, get_threat, list_threats, plus init_official_docs, refresh_official_docs, diff_official_docs, search_official_docs (v1.1.0 — official Anthropic docs tracker) — plus 13 slash commands /ccguide:* and a Haiku agent.

Onboarding one-liner (once MCP is configured):

claude "Use the claude-code-guide MCP server. Activate the claude-code-expert prompt, then run a personalized onboarding: ask me 3 questions about my goal, experience level, and preferred tone — then build a custom learning path using search_guide and read_section to navigate the guide with live source links."

→ MCP Server README

📁 Repository Structure

graph LR
    root[📦 Repository

Root]

    root --> guide[📖 guide/

24K+ lines]
    root --> examples[📋 examples/

228 templates]
    root --> quiz[🧠 quiz/

271 questions]
    root --> tools[🔧 tools/

utils]
    root --> machine[🤖 machine-readable/

AI index]
    root --> docs[📚 docs/

115 evaluations]

    style root fill:#d35400,stroke:#e67e22,stroke-width:3px,color:#fff
    style guide fill:#2980b9,stroke:#3498db,stroke-width:2px,color:#fff
    style examples fill:#8e44ad,stroke:#9b59b6,stroke-width:2px,color:#fff
    style quiz fill:#d68910,stroke:#f39c12,stroke-width:2px,color:#fff
    style tools fill:#5d6d7e,stroke:#7f8c8d,stroke-width:2px,color:#fff
    style machine fill:#138d75,stroke:#16a085,stroke-width:2px,color:#fff
    style docs fill:#c0392b,stroke:#e74c3c,stroke-width:2px,color:#fff

Detailed Structure (Text View)

📦 claude-code-ultimate-guide/
│
├─ 📖 guide/              Core Documentation (24K+ lines)
│  ├─ ultimate-guide.md   Complete reference, 10 sections
│  ├─ cheatsheet.md       1-page printable
│  ├─ architecture.md     How Claude Code works internally
│  ├─ methodologies.md    TDD, SDD, BDD workflows
│  ├─ diagrams/           41 Mermaid diagrams (10 thematic files)
│  ├─ third-party-tools.md  Community tools (RTK, ccusage, Entire CLI)
│  ├─ mcp-servers-ecosystem.md  Official & community MCP servers
│  └─ workflows/          Step-by-step guides
│
├─ 📋 examples/           228 Production Templates
│  ├─ agents/             9 custom AI personas
│  ├─ commands/           26 slash commands
│  ├─ hooks/              31 hooks (bash + PowerShell)
│  ├─ skills/             14 skills (9 on SkillHub)
│  └─ scripts/            Utility scripts (audit, search)
│
├─ 🧠 quiz/               271 Questions
│  ├─ 9 categories        Setup, Agents, MCP, Trust, Advanced...
│  ├─ 4 profiles          Junior, Senior, Power User, PM
│  └─ Instant feedback    Doc links + score tracking
│
├─ 🔧 tools/              Interactive Utilities
│  ├─ onboarding-prompt   Personalized guided tour
│  └─ audit-prompt        Setup audit & recommendations
│
├─ 🤖 machine-readable/   AI-Optimized Index
│  ├─ reference.yaml      Structured index (~2K tokens) — powers landing site CMD+K search
│  ├─ claude-code-releases.yaml  Structured releases changelog
│  └─ llms.txt            Standard LLM context file
│
└─ 📚 docs/               115 Resource Evaluations
   └─ resource-evaluations/  5-point scoring, source attribution

🎯 What Makes This Guide Unique

🎓 Deep Understanding Over Configuration

Outcome: Design your own workflows instead of copy-pasting blindly.

We teach how Claude Code works and why patterns matter: - Architecture — Internal mechanics (context flow, tool orchestration, memory management) - Trade-offs — Decision frameworks for agents vs skills vs commands - Configuration Decision Guide — Unified "which mechanism for what?" map across all 7 config layers - Pitfalls — Common failure modes + prevention strategies

What this means for you: Troubleshoot issues independently, optimize for your specific use case, know when to deviate from patterns.

🖼️ Visual Diagrams Series (41 Mermaid Diagrams)

Outcome: Grasp complex concepts instantly through visual mental models.

41 interactive diagrams across 10 thematic files — GitHub-native Mermaid rendering + ASCII fallback for every diagram: - Foundations — 4-layer context model, 9-step pipeline, permission modes - Architecture — Master loop, tool categories, system prompt assembly - [Multi-Agent](./guide/diagrams/07-multi