Prerequisites: Node.js 18+ | Anthropic API key

# Project: [NAME]

## Tech Stack
- Language: [e.g., TypeScript]
- Framework: [e.g., Next.js 14]
- Testing: [e.g., Vitest]

## Commands
- Build: `npm run build`
- Test: `npm test`
- Lint: `npm run lint`

## Rules
- Run tests before marking tasks complete
- Follow existing code patterns
- Keep commits atomic and conventional

Save as CLAUDE.md in your project root. Claude reads it automatically.

1. Quick Start — Install & first workflow
2. Essential Commands — The 7 commands
3. Context Management — Critical concept
4. Memory Files — Your first CLAUDE.md
5. Learning with AI — Use AI without becoming dependent ⭐
6. TDD Workflow — Test-first development
7. Cheat Sheet — Print this

1. Core Concepts — Mental model
2. Plan Mode — Safe exploration
3. Methodologies — TDD, SDD, BDD reference
4. Agents — Custom AI personas
5. Hooks — Event automation
6. CI/CD Integration — Pipelines

1. Complete Guide — End-to-end
2. Architecture — How Claude Code works
3. Security Hardening — MCP vetting, injection defense
4. MCP Servers — Extended capabilities
5. Trinity Pattern — Advanced workflows
6. Observability — Monitor costs & sessions
7. Examples — Production templates

1. What's Inside — Scope
2. Golden Rules — Key principles
3. Data Privacy — Retention & compliance
4. Adoption Approaches — Team strategies
5. Context Management — Why it matters

claude-code-ultimate-guide/
├── guide/                    # 📖 Core documentation
│   ├── ultimate-guide.md     # Complete reference (~11100 lines)
│   ├── cheatsheet.md         # 1-page printable reference
│   ├── architecture.md       # How Claude Code works internally
│   ├── methodologies.md      # 15 development methodologies
│   └── workflows/            # TDD, SDD, Plan-Driven guides
│
├── examples/                 # 📦 Production templates
│   ├── agents/               # Custom AI personas
│   ├── commands/             # Slash commands (/pr, /commit...)
│   ├── hooks/                # Security & automation (bash + PS)
│   ├── skills/               # Knowledge modules
│   └── scripts/              # Utility scripts
│
├── tools/                    # 🔧 Interactive utilities
│   ├── audit-prompt.md       # Setup audit
│   └── onboarding-prompt.md  # Personalized guided tour
│
├── machine-readable/         # 🤖 LLM/AI consumption
│   ├── reference.yaml        # Structured index (~2K tokens)
│   └── llms.txt              # Standard LLM context file
│
└── quiz/                     # 🧠 Interactive quiz (227 questions)

Slash Commands (18): /pr, /commit, /release-notes, /diagnose, /security, /refactor, /explain, /optimize, /ship...

Security Hooks (15): dangerous-actions-blocker, prompt-injection-detector, unicode-injection-scanner, output-secrets-scanner...

Utility Scripts: session-search.sh, audit-scan.sh

GitHub Actions: claude-pr-auto-review.yml, claude-security-review.yml, claude-issue-triage.yml

Browse Complete Catalog | Interactive Catalog

Test your Claude Code knowledge with an interactive CLI quiz covering all guide sections.

cd quiz && npm install && npm start

Features: 4 profiles (Junior/Senior/Power User/PM), 10 topic categories, immediate feedback with doc links, score tracking with weak area identification.

Quiz Documentation | Contribute Questions

Quick scan (~2s):

curl -sL https://raw.githubusercontent.com/FlorianBruniaux/claude-code-ultimate-guide/main/examples/scripts/audit-scan.sh | bash

Deep audit with personalized recommendations: tools/audit-prompt.md

Quick load: curl -sL https://raw.githubusercontent.com/FlorianBruniaux/claude-code-ultimate-guide/main/machine-readable/reference.yaml

• DeepWiki — AI-powered Q&A
• NotebookLM Slides — Visual overview
• Kimi PDF — Full text export

This guide is the result of several months of daily practice with Claude Code. I don't claim expertise—I'm sharing what I've learned to help peers and evangelize AI-assisted development best practices.

Philosophy: Learning journey over reference manual. Understanding why before how. Progressive complexity — start simple, master advanced at your pace.

Created with Claude Code. Community-validated through contributions and feedback.

Key Inspirations:

• Claudelog.com — Excellent patterns & tutorials
• zebbern/claude-code-guide — Comprehensive reference with security focus
• ykdojo/claude-code-tips — Practical productivity techniques

Claude Code sends your prompts, file contents, and MCP results to Anthropic servers.

• Default: 5 years retention (training enabled) | Opt-out: 30 days | Enterprise: 0
• Action: Disable training | Full privacy guide

Complementary guides:

• claude-code-templates — Install templates via CLI (17k⭐)
• awesome-claude-code — Community tool library
• Claude-Code-Everything — Visual walkthrough

Community: 🇫🇷 Dev With AI — 1500+ devs on Slack, meetups in Paris, Bordeaux, Lyon

Official docs: docs.anthropic.com/claude-code

Windows Users: Most commands work with Git Bash. Use %USERPROFILE%\.claude\ for paths. Report issues

Language: Written in English for wider reach. French is my native language. Request translations via issues.