FlorianBruniaux/claude-code-ultimate-guide

The most comprehensive Claude Code guide: agentic workflows, hooks, skills, MCP servers, quizzes, and production-ready templates. 430K+ lines.

Claude Code Ultimate Guide – What It Is

A deep, self‑contained learning resource for anyone who wants to use Claude Code (Anthropic’s AI‑assisted coding platform) beyond simple copy‑paste configurations. The repository ships a ~700‑page, 24 K‑line documentation set, interactive quizzes, security threat database, and a tiny MCP server that lets you query the guide from within a Claude Code session.

Who It’s For

Role	What the guide offers
Tech Lead / Engineering Manager	Deployment‑level guidance, team‑wide rollout considerations
CTO / Decision‑Maker	ROI, security posture, budget‑talk talking points
CIO / CEO	High‑level risk and ask‑list for tech teams
Product Manager / Designer	How to work with AI‑assisted dev teams ("vibe coding")
Writer / Ops / Manager	Links to a separate Claude Cowork guide
Developer (any level)	Core learning path, templates, quizzes
Career‑pivot / New AI role	Overview of AI roles and career paths

Core Content

Section	Highlights
Learning Path (7 modules)	8‑11 h structured curriculum, printable cheat‑sheet, 48 Mermaid diagrams
Guide (24 K+ lines)	Architecture, tool reference (40 built‑in tools), trade‑off matrix (agents vs skills vs commands), methodology workflows (TDD/SDD/BDD/GSD)
Security Threat DB	28 CVE‑mapped vulnerabilities + 655 catalogued malicious skills with hardening workflows
Quiz	473 questions across 9 categories, instant feedback, profile‑based difficulty
Templates	275 production‑ready examples (agents, skills, hooks, scripts) with explanatory comments
MCP Server	Small `npx`‑based server exposing 17 guide‑related tools (search, read_section, get_example, get_threat, etc.) that can be called from any Claude Code session
Machine‑readable index	YAML/JSON files (~43 K tokens) powering the landing‑site search

How to Use It

Start with the 7‑module learning path (guide/learning-path/README.md).

Run the one‑liner onboarding prompt from a Claude session:

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

Add the MCP server to ~/.claude.json (see the README in mcp-server/) to ask the guide questions directly, e.g. search_guide "agent teams".
Practice with the quiz (quiz/) or the printable cheat‑sheet.
Copy and adapt templates from examples/ for real projects, using the accompanying explanations to understand why each pattern works.

What Makes This Guide Different

Unique Aspect	Why It Matters
Security‑first focus	First guide to map CVEs and 655 malicious skills, plus hardening workflows – essential for production AI‑assisted codebases
Methodology deep‑dive	TDD/SDD/BDD guides show how to keep code quality when AI writes code
Large‑scale visualisation	48 Mermaid diagrams give instant mental models of Claude Code’s master loop, memory hierarchy, and multi‑agent topologies
Comprehensive assessment	473‑question quiz with instant doc links – rare for AI tooling docs
MCP integration	Tiny server lets you query the guide from any Claude session, turning the docs into an interactive knowledge base

Quick Links

Interactive landing site: https://florianbruniaux.github.io/claude-code-ultimate-guide-landing/
Full offline guide (PDF/EPUB, EN & FR) – see the badges at the top of the README
MCP server docs: ./mcp-server/README.md
Quiz: ./quiz/ (or online via the landing site)
Templates index: ./examples/CATALOG.md

Bottom Line

If you already use Claude Code and want to move from “run the sample config” to designing, securing, and scaling your own AI‑driven development workflows, this repository is the most exhaustive, security‑aware, and pedagogically structured resource available today.