Skip to content
/

Claude Code Ultimate Guide

claude-code-ultimate-guide · FlorianBruniaux/claude-code-ultimate-guide · ★ 4.5k · last commit 2026-05-25

Primitive shape 30 total
Commands 9 Skills 1 Subagents 1 Hooks 7 MCP tools 12
00

Summary

Claude Code Ultimate Guide — Summary

Claude Code Ultimate Guide by Florian Bruniaux is a comprehensive single-author reference book for Claude Code, currently at v3.41.0, with 4,500 stars and ~20,000 lines of documentation. Unlike the "copy-paste configs first" approach of other community resources, this guide explicitly teaches the "WHY" behind patterns — architecture, mental models, trade-off decisions — with 48 Mermaid diagrams, a 271-question quiz, 181 production-ready templates, and the only publicly available database of 28 documented CVEs + 655 malicious Claude Code skills. The guide ships a companion MCP server (claude-code-ultimate-guide-mcp, npx-installable) with 12 MCP tools for searching and navigating the guide content from inside Claude Code. The .claude/ directory contains 5 slash commands (ccguide namespace: daily, diff-docs, init-docs, refresh-docs, search-docs), a guide-reviewer agent, and 2 hook-triggered scripts (auto-format.sh, version-consistency-check.sh), plus an activity-logger.sh hook for audit logging.

Differs from seeds: Closest to spec-kit (Archetype 2 — mirror commands + skills) in having a command surface backed by MCP tools, but the guide's primary value is educational depth rather than workflow automation. The MCP server is content-navigation, not agent orchestration. Unlike taskmaster-ai or openspec, the guide doesn't ship a reusable workflow — it teaches you to design your own. The CVE/threat database and quiz are unique across the entire corpus.

01

Overview

Claude Code Ultimate Guide — Overview

Origin

Written by Florian BRUNIAUX, Founding Engineer at Méthode Aristote. Co-written with Claude (Anthropic). Updated continuously since initial release; at v3.41.0 as of May 24, 2026. License: CC BY-SA 4.0.

Mission statement (verbatim)

"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." "This guide is not official Anthropic documentation. It's a community resource based on my exploration of Claude Code over several months." "What you'll find: Patterns that have worked for me. Observations that may not generalize to your workflow." "Use critically. Experiment. Share what works for you."

Audience segmentation (unique)

The guide explicitly segments readers:

Audience Section
Tech Lead / Engineering Manager docs/for-tech-leads.md
CTO / Decision Maker docs/for-cto.md
CIO / CEO docs/for-cio-ceo.md
Product Manager / Designer docs/for-product-managers.md
Developer (all levels) Main guide
Career pivot / new AI role guide/roles/ai-roles.md

Comparison vs everything-cc (own positioning)

Goal This Guide everything-claude-code
Understand why Deep explanations + architecture Config-focused
Security hardening Only threat database (28 CVEs) Basic patterns only
Test understanding 271-question quiz Not available
Methodologies (TDD/SDD/BDD) Full workflow guides Not covered
Copy-paste ready templates 181 templates 200+ templates

Unique assets

  • 28 documented CVE-like vulnerabilities in Claude Code threat database
  • 655 malicious skills database — catalogue of known bad actor skill patterns
  • 271-question quiz in quiz/ directory
  • 48 Mermaid diagrams across the guide
  • PDF and EPUB exports available from GitHub Releases
  • SkillHub listing at skills.palebluedot.live (9 skills)
02

Architecture

Claude Code Ultimate Guide — Architecture

Distribution

  • Primary: GitHub repo (methodology-doc + claude-plugin + MCP server)
  • MCP server: npm install -g claude-code-ultimate-guide-mcp or npx -y claude-code-ultimate-guide-mcp
  • License: CC BY-SA 4.0

Install MCP server

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

Directory tree

.
├── .claude/
│   ├── commands/
│   │   ├── ccguide/
│   │   │   ├── daily.md
│   │   │   ├── diff-docs.md
│   │   │   ├── init-docs.md
│   │   │   ├── refresh-docs.md
│   │   │   └── search-docs.md
│   │   ├── changelog.md
│   │   ├── sync.md
│   │   ├── update-infos-release.md
│   │   └── version.md
│   ├── skills/
│   │   └── self-assessment/
│   ├── agents/
│   │   └── guide-reviewer.md (unknown)
│   ├── hooks/
│   │   ├── validate-template-metadata.sh
│   │   └── version-consistency-check.sh
│   └── settings.json
├── guide/
│   ├── ultimate-guide.md         (main guide, ~30-40h reading)
│   ├── ultimate-guide.fr.md      (French translation)
│   ├── core/
│   ├── security/
│   │   └── security-hardening.md (CVE database)
│   ├── workflows/
│   ├── diagrams/
│   └── ...
├── examples/                      (181 templates)
├── quiz/                          (271 questions)
├── mcp-server/                    (TypeScript MCP server)
│   └── src/
│       ├── tools/                 (12 tool files)
│       └── server.ts
├── claudedocs/                    (pedagogy + audit reviews)
├── cheatsheet.pdf
├── docs/                          (audience-specific docs)
└── scripts/

Runtime requirements

  • Node.js (for MCP server)
  • Claude Code (for plugin commands, hooks)
03

Components

Claude Code Ultimate Guide — Components

Slash Commands (9, in .claude/commands/)

Name Purpose
/ccguide:daily Daily update check — official Anthropic docs diff + guide/CC releases digest
/ccguide:diff-docs Show diff between baseline and current official Anthropic docs snapshot
/ccguide:init-docs Fetch + cache official Anthropic docs as baseline (~1.2MB, ~5s)
/ccguide:refresh-docs Re-fetch current Anthropic docs and update current snapshot
/ccguide:search-docs Search official Anthropic docs by keyword via MCP search_official_docs tool
/changelog View recent CHANGELOG.md entries with optional count argument
/sync (purpose unknown — not fetched)
/update-infos-release (purpose unknown — not fetched)
/version Display current guide version

Skills (1 directory in .claude/skills/)

Name Purpose
self-assessment/ (self-assessment skill for guide understanding — not fetched)

Agents (1)

Name Purpose
guide-reviewer.md Reviews guide content quality (details not fetched — 404 earlier)

Hooks (5 events in .claude/settings.json)

Event Matcher Script Purpose
SessionStart (all) ~/.claude/hooks/rtk-baseline.sh User-global session startup
PreToolUse `Bash Edit Write`
PostToolUse `Edit Write` .claude/hooks/auto-format.sh
PostToolUse `Edit Write` .claude/hooks/version-consistency-check.sh
PostToolUse .* .claude/hooks/activity-logger.sh Audit log of all tool use
Notification (all) .claude/hooks/notification.sh Desktop notifications
UserPromptSubmit (all) .claude/hooks/smart-suggest.sh Prompt-time suggestion injection

MCP Server (12 tools)

Tool Signature Description
search_guide (query, limit?) Full-text search across 882 indexed guide entries
read_section (path, offset?, limit?) Read guide section with pagination
list_topics () Browse 25 topic categories
get_example (name) Fetch production-ready template by name
search_examples (query) Search templates
list_examples () List all templates
get_changelog () View guide changelog
get_cheatsheet () Get cheatsheet
compare_versions (v1, v2) Compare guide versions
get_threats (query?) Search CVE/threat database
get_releases () Get CC release notes
get_official_docs (query) Search official Anthropic docs

Scripts (bash, in .claude/hooks/)

  • dangerous-actions-blocker.sh
  • auto-format.sh
  • version-consistency-check.sh
  • activity-logger.sh
  • notification.sh
  • smart-suggest.sh

Templates (181, in examples/)

Production-ready agent, command, hook, skill configurations.

Security assets

  • guide/security/security-hardening.md — 28 CVE-like vulnerabilities
  • Malicious skills database — 655 entries

Quiz

  • quiz/ — 271 questions for self-assessment
05

Prompts

Claude Code Ultimate Guide — Prompts

Prompt 1: /ccguide:daily slash command

Source: .claude/commands/ccguide/daily.md

Technique: Sequential MCP tool orchestration + consolidated report format

---
description: Daily update check — official Anthropic docs diff + guide/CC releases digest
---

Run this sequence in order. Present results as one consolidated report.

## Step 1 — Refresh official docs
Call `refresh_official_docs` MCP tool to fetch the latest Anthropic docs and update the current snapshot.
If it fails (no baseline), tell the user to run /ccguide:init-docs once first, then stop.

## Step 2 — Diff official docs
Call `diff_official_docs` MCP tool to compare baseline vs refreshed current.

## Step 3 — Guide + CC releases digest
Call `get_digest` MCP tool with period: "day"

## Output format
Present everything as a single daily briefing:
# Daily Claude Code Update — {today's date}
## Official Anthropic Docs

Key design: The command chains 3 MCP tool calls in sequence and specifies the exact output format, making it a prompt-chaining pattern (one stage's output feeds the next's context).


Prompt 2: /ccguide:search-docs slash command

Source: .claude/commands/ccguide/search-docs.md

Technique: Thin MCP tool wrapper with argument pass-through

---
description: Search official Anthropic Claude Code docs by keyword
---

Use the `search_official_docs` MCP tool with query: $ARGUMENTS

If no query is given, ask the user what they want to search for.

Default limit: 5 results.

Present each result with:
- Section title
- Source URL (reproduce verbatim)
- Excerpt showing the relevant content

If no snapshot exists, tell the user to run /ccguide:init-docs first.

Key design: $ARGUMENTS pass-through from slash command invocation; fallback path to init-docs if cache missing; verbatim URL preservation ensures source attribution. This is the "mirror commands → MCP tools" pattern from Archetype 2/3.

09

Uniqueness

Claude Code Ultimate Guide — Uniqueness

Differs from seeds

Shares structural DNA with both Archetype 2 (spec-kit — slash commands + skills + hooks) and Archetype 3 (taskmaster-ai — MCP-anchored toolserver), but is neither: the MCP server serves content navigation, not task management; the hooks enforce content quality on the guide itself, not on user projects. The closest analog is a living textbook with its own tooling. No other seed or batch-06 framework ships a 28-CVE threat database or 271-question quiz. The activity logger + dangerous-actions-blocker combination is the most sophisticated security posture in this batch. The official-docs drift detection system (init-docsrefresh-docsdiff-docs) is unique across the entire corpus — no other framework tracks its own accuracy against upstream documentation.

Positioning

The definitive community reference for Claude Code at time of analysis (v3.41.0, 4,500 stars, CC BY-SA 4.0). Target audience is developers who want to understand Claude Code deeply before configuring it, not developers who want ready-made workflows to install. The guide explicitly avoids making unverified claims ("Use critically. Experiment.").

Observable failure modes

  1. Author dependency: 10 contributors but Florian is the primary author; bus factor for quality.
  2. Scope creep: At v3.41.0, a 30–40h reading time guide risks becoming overwhelming rather than reference material.
  3. French translation: guide/ultimate-guide.fr.md creates maintenance burden — every update needs two languages.
  4. MCP server cache staleness: 24h TTL means day-old docs could be returned; the /ccguide:daily workflow mitigates but doesn't eliminate this.
  5. Platform-specific env paths: settings.json has hardcoded ALLOWED_PATHS pointing to the author's local filesystem — students who copy this config will see path errors.
04

Workflow

Claude Code Ultimate Guide — Workflow

Primary workflow: documentation maintenance

The framework is primarily a maintained reference resource; the workflow is content-authoring and release management.

Phase Artifact
Write guide content guide/ultimate-guide.md + section files
Auto-format on save auto-format.sh (PostToolUse:Edit hook)
Version check version-consistency-check.sh (PostToolUse:Edit hook)
Activity log activity-logger.sh (PostToolUse:.* hook)
Daily docs drift check /ccguide:dailyinit_official_docs + diff_official_docs MCP tools
Release cut /update-infos-release + /version commands
CHANGELOG update /changelog command

Approval gates

None automated. Human author review before commits.

Template validation

validate-template-metadata.sh hook validates template metadata.

Official docs tracking

The guide actively tracks changes to official Anthropic Claude Code documentation:

  1. /ccguide:init-docs — creates baseline snapshot (~1.2MB, cached in ~/.cache/claude-code-guide/)
  2. /ccguide:refresh-docs — fetches current docs
  3. /ccguide:diff-docs — shows what changed between baseline and current

This is the only framework in the batch with explicit drift detection between its content and official docs.

06

Memory Context

Claude Code Ultimate Guide — Memory & Context

MCP server cache

  • Official Anthropic docs snapshot: ~/.cache/claude-code-guide/ (24h TTL)
  • Guide content index: ~130KB compressed, bundled in the npm package
  • File content: fetched from GitHub on demand, 24h local cache

Activity log

activity-logger.sh is triggered on every PostToolUse event → writes to an audit log file (location unspecified in reviewed code, but hook is deployed).

CLAUDE.md

Project-level CLAUDE.md contains permissions denying access to .env, credentials, PEM keys, and secrets — security-first memory configuration.

Settings.json env vars

"env": {
  "ALLOWED_PATHS": "/Users/florianbruniaux/Sites/perso/claude-code-plugins:/Users/florianbruniaux/Sites/perso/ctxharness"
}

Path-scoped execution context.

Cross-session handoff

The MCP server's cached guide index and docs snapshots persist across sessions, enabling consistent behavior without re-fetching on each run.

07

Orchestration

Claude Code Ultimate Guide — Orchestration

Multi-agent

No multi-agent orchestration. The guide-reviewer agent is the only subagent, used for internal content quality review.

Orchestration pattern

sequential — the /ccguide:daily command chains MCP tool calls in sequence; otherwise, all commands are independent one-shots.

MCP-anchored pattern

The slash commands are thin wrappers over MCP tools — this is Archetype 3 (MCP-anchored toolserver), but in content-navigation form rather than task-management form.

Isolation mechanism

none for the guide itself. Permissions in settings.json restrict file access paths via ALLOWED_PATHS env var.

Multi-model

No explicit model routing. Guide content teaches model selection (Sonnet vs Opus) but doesn't configure it.

Execution mode

one-shot (commands) + event-driven (hooks fire on lifecycle events).

Auto-validators (from hooks)

  • auto-format.sh — PostToolUse:Edit|Write
  • version-consistency-check.sh — PostToolUse:Edit|Write
  • dangerous-actions-blocker.sh — PreToolUse:Bash|Edit|Write
  • validate-template-metadata.sh — (trigger not confirmed)

Prompt chaining

Yes — /ccguide:daily chains 3 MCP tool calls where step 2 depends on step 1's baseline.

08

Ui Cli Surface

Claude Code Ultimate Guide — UI & CLI Surface

Dedicated CLI binary

None — the MCP server is distributed via npx/npm, not as a named binary.

MCP server (installable)

  • Name: claude-code-ultimate-guide-mcp
  • Install: npm install -g claude-code-ultimate-guide-mcp or npx -y claude-code-ultimate-guide-mcp
  • Protocol: stdio
  • Tools: 12 tools for guide search, template retrieval, threat lookup, changelog, docs diff

Interactive web guide

PDF/EPUB exports

  • PDF download from GitHub Releases
  • EPUB download from GitHub Releases
  • Full guide at guide/ultimate-guide.md (~30–40h reading time)

Slash commands (9 in .claude/commands/)

All prefixed with /ccguide: for the MCP-backed commands; the other 4 are project maintenance commands.

IDE integration

Claude Code plugin surface via .claude/ directory.

Observability

  • activity-logger.sh — audit log of all PostToolUse events (async hook)
  • notification.sh — desktop notification on Notification events
  • smart-suggest.sh — injects suggestions at UserPromptSubmit time

Security UI

  • guide/security/security-hardening.md — 28 documented vulnerabilities
  • tools/ directory — unknown (not fetched)
  • .claude/settings.jsonpermissions.deny list for sensitive file patterns

Related frameworks

same archetype · same primary tool · same memory type

Context-Engineering Handbook ★ 9.0k

Provides a first-principles, research-grounded vocabulary and learning path for context engineering — the discipline of designing…

walkinglabs/learn-harness-engineering ★ 6.6k

Teach harness engineering from first principles (12 lectures + 6 projects) and provide a scaffolding skill (harness-creator) that…

Awesome Harness Engineering (walkinglabs) ★ 2.7k

Curate the authoritative reference list of articles, benchmarks, and tools for harness engineering — the practice of shaping the…

cline-memory-bank (nickbaumann98) ★ 581

Custom instructions + 6-file hierarchical Markdown memory bank so Cline maintains full project context across sessions, with a…

FPF (First Principles Framework) ★ 372

Provides a formal pattern language for making reasoning explicit, traceable, and publishable in mixed human/AI engineering work —…

nexu-io/harness-engineering-guide ★ 134

Provide a practical, code-first reference guide to harness engineering — from first principles to production patterns —…