https://github.com/FlorianBruniaux/claude-code-ultimate-guide
Comprehensive Claude Code guide: 19K-line reference, 114 templates, 29 hooks. Beginner to power user.
https://github.com/FlorianBruniaux/claude-code-ultimate-guide
agentic-coding ai-assistant ai-coding ai-pair-programming ai-security anthropic best-practices claude claude-code claude-code-guide claude-code-tutorial cli-tool coding-assistant cursor-alternative developer-tools llm mcp-servers prompt-engineering tutorial vibe-coding
Last synced: 5 months ago
JSON representation
Comprehensive Claude Code guide: 19K-line reference, 114 templates, 29 hooks. Beginner to power user.
- Host: GitHub
- URL: https://github.com/FlorianBruniaux/claude-code-ultimate-guide
- Owner: FlorianBruniaux
- License: cc-by-sa-4.0
- Created: 2026-01-09T13:42:10.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2026-02-10T12:18:59.000Z (5 months ago)
- Last Synced: 2026-02-10T15:34:07.441Z (5 months ago)
- Topics: agentic-coding, ai-assistant, ai-coding, ai-pair-programming, ai-security, anthropic, best-practices, claude, claude-code, claude-code-guide, claude-code-tutorial, cli-tool, coding-assistant, cursor-alternative, developer-tools, llm, mcp-servers, prompt-engineering, tutorial, vibe-coding
- Language: Shell
- Homepage: https://florianbruniaux.github.io/claude-code-ultimate-guide-landing/
- Size: 25.3 MB
- Stars: 100
- Watchers: 2
- Forks: 9
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Citation: CITATION.cff
Awesome Lists containing this project
- awesome-claude-code-security - Claude Code Ultimate Guide - Comprehensive documentation with production-ready templates including security hardening configs. (๐ Hardening and Permissions / Anthropic Engineering & Blog)
- awesome-claude-code-and-skills - FlorianBruniaux/claude-code-ultimate-guide - code-ultimate-guide?style=flat-square) (Learning & Documentation / Comprehensive Guides)
- awesome-claude-code - Claude Code Ultimate Guide - bruniaux-43408b83/) - A tremendous feat of documentation, this guide covers Claude Code from beginner to power user, with production-ready templates for Claude Code features, guides on agentic workflows, and a lot of great learning materials, including quizzes and a handy "cheatsheet". Whether it's the "ultimate" guide to Claude Code will be up to the reader, but a valuable resource nonetheless (as with all documentation sites, make sure it's up to date before you bet the farm). (Workflows & Knowledge Guides ๐ง / General)
- awesome-openclaw-skills - Claude Code Ultimate Guide - A tremendous feat of documentation, this guide covers Claude Code from beginne... | - | (Code & Developer Tools)
- awesome-claude-code-cn - Claude Code Ultimate Guide - bruniaux-43408b83/) - ไธ้กนไปคไบบๅฐ่ฑกๆทฑๅป็ๆๆกฃๅทฅไฝ๏ผๆฌๆๅๆถต็ไบไปๅๅญฆ่ ๅฐ้ซ็บง็จๆท็ Claude Code๏ผๅ ทๆ Claude Code ๅ่ฝ็็ไบงๅฐฑ็ปชๆจกๆฟใไปฃ็ๅทฅไฝๆต็จๆๅไปฅๅๅคง้ไผ็ง็ๅญฆไน ๆๆ๏ผๅ ๆฌๆต้ชๅๆนไพฟ็"ๅคๅฟๅ"ใๅฎๆฏๅฆๆฏ Claude Code ็"็ปๆ"ๆๅๅฐ็ฑ่ฏป่ ๅณๅฎ๏ผไฝๆ ่ฎบๅฆไฝ้ฝๆฏๆไปทๅผ็่ตๆบ๏ผไธๆๆๆๆกฃ็ซ็นไธๆ ท๏ผๅจๅ จๅไปฅ่ตดไนๅ่ฏท็กฎไฟๅฎๆฏๆๆฐ็๏ผใ (ๅทฅไฝๆต็จไธ็ฅ่ฏๆๅ ๐ง / ้็จ)
README
# Claude Code Ultimate Guide
> **Claude Code from beginner to power user.** Exhaustive documentation, production-ready templates, agentic workflow guides, quiz, and a cheatsheet for daily use.
> **If this guide helps you, [give it a star โญ](https://github.com/FlorianBruniaux/claude-code-ultimate-guide/stargazers)** โ it helps others discover it too.
---
## โก Quick Start
**Quickest path**: [Cheat Sheet](./guide/cheatsheet.md) โ 1 printable page with daily essentials
**Interactive onboarding** (no clone needed):
```bash
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](./guide/ultimate-guide.md) | [Examples](./examples/) | [Quiz](./quiz/)
Prerequisites & Minimal CLAUDE.md Template
**Prerequisites**: Node.js 18+ | [Anthropic API key](https://console.anthropic.com/)
```markdown
# 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.
---
## ๐ Repository Structure
```mermaid
graph LR
root[๐ฆ Repository
Root]
root --> guide[๐ guide/
19K lines]
root --> examples[๐ examples/
111 templates]
root --> quiz[๐ง quiz/
257 questions]
root --> tools[๐ง tools/
utils]
root --> machine[๐ค machine-readable/
AI index]
root --> docs[๐ docs/
56 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 (~19K lines)
โ โโ ultimate-guide.md Complete reference, 10 sections
โ โโ cheatsheet.md 1-page printable
โ โโ architecture.md How Claude Code works internal ly
โ โโ methodologies.md TDD, SDD, BDD workflows
โ โโ third-party-tools.md Community tools (RTK, ccusage, Entire CLI)
โ โโ mcp-servers-ecosystem.md Official & community MCP servers
โ โโ workflows/ Step-by-step guides
โ
โโ ๐ examples/ 111 Production Templates
โ โโ agents/ 6 custom AI personas
โ โโ commands/ 22 slash commands
โ โโ hooks/ 18 security hooks (bash + PowerShell)
โ โโ skills/ 1 meta-skill (Claudeception)
โ โโ scripts/ Utility scripts (audit, search)
โ
โโ ๐ง quiz/ 257 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)
โ โโ llms.txt Standard LLM context file
โ
โโ ๐ docs/ 55 Resource Evaluations
โโ resource-evaluations/ 5-point scoring, source attribution
```
---
## ๐ฏ What Makes This Guide Unique
### ๐ Educational Depth
We explain **concepts first**, not just configs:
- [Architecture](./guide/architecture.md) โ How Claude Code works internally
- [Trade-offs](./guide/ultimate-guide.md#when-to-use-what) โ When to use agents vs skills vs commands
- [Pitfalls](./guide/ultimate-guide.md#common-mistakes) โ Common mistakes and solutions
### ๐ 257-Question Quiz (Unique in Ecosystem)
**Only comprehensive assessment available** โ test your understanding across 9 categories:
- Setup & Configuration
- Agents & Sub-Agents
- MCP Servers & Integration
- Trust & Verification
- Advanced Patterns
[Try the Quiz Online โ](https://florianbruniaux.github.io/claude-code-ultimate-guide-landing/quiz/) | [Run Locally](./quiz/)
### ๐ค Agent Teams Coverage (v2.1.32+)
**Only comprehensive guide to Anthropic's experimental multi-agent coordination**:
- Production metrics (Fountain 50% faster, CRED 2x speed, autonomous C compiler)
- 5 validated workflows (multi-layer review, parallel debugging, large-scale refactoring)
- Git-based coordination architecture (team lead + teammates)
- Decision framework: Teams vs Multi-Instance vs Dual-Instance vs Beads
- Setup, limitations, best practices, troubleshooting
[Agent Teams Workflow โ](./guide/workflows/agent-teams.md) | [Section 9.20 โ](./guide/ultimate-guide.md#920-agent-teams-multi-agent-coordination)
### ๐ฌ Methodologies (Structured Workflows)
Complete guides with rationale and examples:
- [TDD](./guide/methodologies.md#1-tdd-test-driven-development-with-claude) โ Test-Driven Development
- [SDD](./guide/methodologies.md#2-sdd-specification-driven-development) โ Specification-Driven Development
- [BDD](./guide/methodologies.md#3-bdd-behavior-driven-development) โ Behavior-Driven Development
- [GSD](./guide/methodologies.md#gsd-get-shit-done) โ Get Shit Done pattern
### ๐ 106 Annotated Templates
Educational templates with explanations:
- Agents (6), Commands (22), Hooks (18), Skills
- Comments explaining **why** each pattern works
- Gradual complexity progression
[Browse Catalog โ](./examples/)
### ๐ 55 Resource Evaluations
Systematic assessment of external resources (5-point scoring):
- Articles, videos, tools, frameworks
- Honest assessments with source attribution
- Integration recommendations
[See Evaluations โ](./docs/resource-evaluations/)
---
## ๐ฏ Learning Paths
Junior Developer โ Foundation path (7 steps)
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
3. [Context Management](./guide/ultimate-guide.md#22-context-management) โ Critical concept
4. [Memory Files](./guide/ultimate-guide.md#31-memory-files-claudemd) โ Your first CLAUDE.md
5. [Learning with AI](./guide/learning-with-ai.md) โ Use AI without becoming dependent โญ
6. [TDD Workflow](./guide/workflows/tdd-with-claude.md) โ Test-first development
7. [Cheat Sheet](./guide/cheatsheet.md) โ Print this
Senior Developer โ Intermediate path (6 steps)
1. [Core Concepts](./guide/ultimate-guide.md#2-core-concepts) โ Mental model
2. [Plan Mode](./guide/ultimate-guide.md#23-plan-mode) โ Safe exploration
3. [Methodologies](./guide/methodologies.md) โ TDD, SDD, BDD reference
4. [Agents](./guide/ultimate-guide.md#4-agents) โ Custom AI personas
5. [Hooks](./guide/ultimate-guide.md#7-hooks) โ Event automation
6. [CI/CD Integration](./guide/ultimate-guide.md#93-cicd-integration) โ Pipelines
Power User โ Comprehensive path (8 steps)
1. [Complete Guide](./guide/ultimate-guide.md) โ End-to-end
2. [Architecture](./guide/architecture.md) โ How Claude Code works
3. [Security Hardening](./guide/security-hardening.md) โ MCP vetting, injection defense
4. [MCP Servers](./guide/ultimate-guide.md#8-mcp-servers) โ Extended capabilities
5. [Trinity Pattern](./guide/ultimate-guide.md#91-the-trinity) โ Advanced workflows
6. [Observability](./guide/observability.md) โ Monitor costs & sessions
7. [Agent Teams](./guide/workflows/agent-teams.md) โ Multi-agent coordination (Opus 4.6 experimental)
8. [Examples](./examples/) โ Production templates
Product Manager / DevOps / Designer
**Product Manager** (5 steps):
1. [What's Inside](#-whats-inside) โ Scope overview
2. [Golden Rules](#-golden-rules) โ Key principles
3. [Data Privacy](./guide/data-privacy.md) โ Retention & compliance
4. [Adoption Approaches](./guide/adoption-approaches.md) โ Team strategies
5. [PM FAQ](./guide/ultimate-guide.md#can-product-managers-use-claude-code) โ Code-adjacent vs non-coding PMs
**Note**: Non-coding PMs should consider [Claude Cowork Guide](https://github.com/FlorianBruniaux/claude-cowork-guide) instead.
**DevOps / SRE** (5 steps):
1. [DevOps & SRE Guide](./guide/devops-sre.md) โ FIRE framework
2. [K8s Troubleshooting](./guide/devops-sre.md#kubernetes-troubleshooting) โ Symptom-based prompts
3. [Incident Response](./guide/devops-sre.md#pattern-incident-response) โ Workflows
4. [IaC Patterns](./guide/devops-sre.md#pattern-infrastructure-as-code) โ Terraform, Ansible
5. [Guardrails](./guide/devops-sre.md#guardrails--adoption) โ Security boundaries
**Product Designer** (5 steps):
1. [Working with Images](./guide/ultimate-guide.md#24-working-with-images) โ Image analysis
2. [Wireframing Tools](./guide/ultimate-guide.md#wireframing-tools) โ ASCII/Excalidraw
3. [Figma MCP](./guide/ultimate-guide.md#figma-mcp) โ Design file access
4. [Design-to-Code Workflow](./guide/workflows/design-to-code.md) โ Figma โ Claude
5. [Cheat Sheet](./guide/cheatsheet.md) โ Print this
### Progressive Journey
- **Week 1**: Foundations (install, CLAUDE.md, first agent)
- **Week 2**: Core Features (skills, hooks, trust calibration)
- **Week 3**: Advanced (MCP servers, methodologies)
- **Month 2+**: Production mastery (CI/CD, observability)
---
## ๐ง Rate Limits & Cost Savings
**cc-copilot-bridge** routes Claude Code through GitHub Copilot Pro+ for flat-rate access ($10/month instead of per-token billing).
```bash
# Install
git clone https://github.com/FlorianBruniaux/cc-copilot-bridge.git && cd cc-copilot-bridge && ./install.sh
# Use
ccc # Copilot mode (flat $10/month)
ccd # Direct Anthropic mode (per-token)
cco # Offline mode (Ollama, 100% local)
```
**Benefits**: Multi-provider switching, rate limit bypass, 99%+ cost savings on heavy usage.
โ **[cc-copilot-bridge](https://github.com/FlorianBruniaux/cc-copilot-bridge)**
---
## ๐ Golden Rules
1. **Start small** โ First project: 10-15 lines CLAUDE.md max
2. **Read before edit** โ Always Read โ Understand โ Edit (never blind Write)
3. **Test-first** โ Write test โ Watch fail โ Implement โ Pass
4. **Use `/compact`** before context hits 70% โ prevention beats recovery
5. **Review everything** โ AI code has 1.75ร more logic errors ([source](https://dl.acm.org/doi/10.1145/3716848))
6. **Context = Gold** โ Clear CLAUDE.md > clever prompts
> Context management is critical. See the [Cheat Sheet](./guide/cheatsheet.md#context-management-critical) for thresholds and actions.
---
## ๐ค For AI Assistants
| Resource | Purpose | Tokens |
|----------|---------|--------|
| **[llms.txt](./machine-readable/llms.txt)** | Standard context file | ~1K |
| **[reference.yaml](./machine-readable/reference.yaml)** | Structured index with line numbers | ~2K |
**Quick load**: `curl -sL https://raw.githubusercontent.com/FlorianBruniaux/claude-code-ultimate-guide/main/machine-readable/reference.yaml`
---
## ๐ Ecosystem
### Positioning: Complementary, Not Competitive
**Claude Code has two major community resources:**
| Resource | Focus | Best For |
|----------|-------|----------|
| **This Guide** | ๐ Educational depth, methodologies | Deep understanding, learning WHY |
| [everything-claude-code](https://github.com/affaan-m/everything-claude-code) | โ๏ธ Production configs, plugin install | Quick setup, battle-tested patterns |
**Recommended workflow**: Learn concepts here โ Leverage production configs there โ Return for deep dives
Both resources serve different needs. Use what fits your learning style and project requirements.
### Claude Cowork (Non-Developers)
**Claude Cowork** is the companion guide for non-technical users (knowledge workers, assistants, managers).
Same agentic capabilities as Claude Code, but through a visual interface with no coding required.
โ **[Claude Cowork Guide](https://github.com/FlorianBruniaux/claude-cowork-guide)** โ File organization, document generation, automated workflows
**Status**: Research preview (Pro $20/mo or Max $100-200/mo, macOS only, **VPN incompatible**)
### Complementary Resources
| Project | Focus | Best For |
|---------|-------|----------|
| [claude-code-templates](https://github.com/davila7/claude-code-templates) | Distribution (200+ templates) | CLI installation (17kโญ) |
| [anthropics/skills](https://github.com/anthropics/skills) | Official Anthropic skills (60K+โญ) | Documents, design, dev templates |
| [anthropics/claude-plugins-official](https://skills.sh/anthropics/claude-plugins-official) | Plugin dev tools (3.1K installs) | CLAUDE.md audit, automation discovery |
| [skills.sh](https://skills.sh/) | Skills marketplace | One-command install (Vercel Labs) |
| [awesome-claude-code](https://github.com/hesreallyhim/awesome-claude-code) | Curation | Resource discovery |
| [awesome-claude-skills](https://github.com/BehiSecc/awesome-claude-skills) | Skills taxonomy | 62 skills across 12 categories |
| [awesome-claude-md](https://github.com/josix/awesome-claude-md) | CLAUDE.md examples (31โ
) | Annotated configs with scoring |
| [AI Coding Agents Matrix](https://coding-agents-matrix.dev) | Technical comparison | Comparing 23+ alternatives |
**Community**: ๐ซ๐ท [Dev With AI](https://www.devw.ai/) โ 1500+ devs on Slack, meetups in Paris, Bordeaux, Lyon
โ **[AI Ecosystem Guide](./guide/ai-ecosystem.md)** โ Complete integration patterns with complementary AI tools
---
## ๐ก๏ธ Security
**Comprehensive MCP security coverage** โ the only guide with a threat intelligence database and production hardening workflows.
### Official Security Tools
| Tool | Purpose | Maintained By |
|------|---------|---------------|
| [claude-code-security-review](https://github.com/anthropics/claude-code-security-review) | GitHub Action for automated security scanning | Anthropic (official) |
| This Guide's Threat DB | Intelligence layer (22 CVEs, 341 malicious skills) | Community |
**Workflow**: Use GitHub Action for automation โ Consult Threat DB for threat intelligence.
### Threat Database
**22 CVE-mapped vulnerabilities** and **341 malicious skills** tracked in [`machine-readable/threat-db.yaml`](./machine-readable/threat-db.yaml):
| Threat Category | Count | Examples |
|----------------|-------|----------|
| **Prompt Injection** | 14 CVEs | Indirect injection (CVE-2024-1546), context poisoning |
| **Data Exfiltration** | 5 CVEs | Training data extraction (CVE-2024-0241), secret leakage |
| **Code Injection** | 3 CVEs | Tool manipulation, workflow abuse |
| **Malicious Skills** | 341 patterns | Unicode injection, hidden instructions, auto-execute |
**Taxonomies**: 10 attack surfaces ร 11 threat types ร 8 impact levels
### Hardening Resources
| Resource | Purpose | Time |
|----------|---------|------|
| **[Security Hardening Guide](./guide/security-hardening.md)** | MCP vetting, injection defense, audit workflow | 25 min |
| **[Data Privacy Guide](./guide/data-privacy.md)** | Retention policies (5yr โ 30d โ 0), GDPR compliance | 10 min |
| **[Sandbox Isolation](./guide/sandbox-isolation.md)** | Docker sandboxes for untrusted MCP servers | 10 min |
| **[Production Safety](./guide/production-safety.md)** | Infrastructure locks, port stability, DB safety | 20 min |
### Security Commands
```bash
/security-check # Quick scan config vs known threats (~30s)
/security-audit # Full 6-phase audit with score /100 (2-5min)
/update-threat-db # Research & update threat intelligence
/audit-agents-skills # Quality audit with security checks
```
### Security Hooks
**18 production hooks** (bash + PowerShell) in [`examples/hooks/`](./examples/hooks/):
| Hook | Purpose |
|------|---------|
| [dangerous-actions-blocker](./examples/hooks/bash/dangerous-actions-blocker.sh) | Block `rm -rf`, force-push, production ops |
| [prompt-injection-detector](./examples/hooks/bash/prompt-injection-detector.sh) | Detect injection patterns in CLAUDE.md/prompts |
| [unicode-injection-scanner](./examples/hooks/bash/unicode-injection-scanner.sh) | Detect hidden Unicode (zero-width, RTL override) |
| [output-secrets-scanner](./examples/hooks/bash/output-secrets-scanner.sh) | Prevent API keys/tokens in Claude responses |
**[Browse All Security Hooks โ](./examples/hooks/)**
### MCP Vetting Workflow
**Systematic evaluation before trusting MCP servers:**
1. **Provenance**: GitHub verified, 100+ stars, active maintenance
2. **Code Review**: Minimal privileges, no obfuscation, open-source
3. **Permissions**: Whitelist-only filesystem access, network restrictions
4. **Testing**: Isolated Docker sandbox first, monitor tool calls
5. **Monitoring**: Session logs, error tracking, regular re-audits
**[Full MCP Security Workflow โ](./guide/security-hardening.md#vetting-mcp-servers)**
---
## ๐ About
Origins & Philosophy
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](https://claudelog.com/) โ Excellent patterns & tutorials
- [zebbern/claude-code-guide](https://github.com/zebbern/claude-code-guide) โ Comprehensive reference with security focus
- [ykdojo/claude-code-tips](https://github.com/ykdojo/claude-code-tips) โ Practical productivity techniques
Privacy & Data
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](https://claude.ai/settings/data-privacy-controls) | [Full privacy guide](./guide/data-privacy.md)
---
## ๐ What's Inside
### Core Documentation
| File | Purpose | Time |
|------|---------|------|
| **[Ultimate Guide](./guide/ultimate-guide.md)** | Complete reference (~19K lines), 10 sections | 30-40h (full) โข Most consult sections |
| **[Cheat Sheet](./guide/cheatsheet.md)** | 1-page printable reference | 5 min |
| **[Visual Reference](./guide/visual-reference.md)** | 20 ASCII diagrams for key concepts | 5 min |
| **[Architecture](./guide/architecture.md)** | How Claude Code works internally | 25 min |
| **[Methodologies](./guide/methodologies.md)** | TDD, SDD, BDD reference | 20 min |
| **[Workflows](./guide/workflows/)** | Practical guides (TDD, Plan-Driven, Task Management) | 30 min |
| **[Data Privacy](./guide/data-privacy.md)** | Retention & compliance | 10 min |
| **[Security Hardening](./guide/security-hardening.md)** | MCP vetting, injection defense | 25 min |
| **[Sandbox Isolation](./guide/sandbox-isolation.md)** | Docker Sandboxes, cloud alternatives, safe autonomy | 10 min |
| **[Production Safety](./guide/production-safety.md)** | Port stability, DB safety, infrastructure lock | 20 min |
| **[DevOps & SRE](./guide/devops-sre.md)** | FIRE framework, K8s troubleshooting, incident response | 30 min |
| **[AI Ecosystem](./guide/ai-ecosystem.md)** | Complementary AI tools & integration patterns | 20 min |
| **[AI Traceability](./guide/ai-traceability.md)** | Code attribution & provenance tracking | 15 min |
| **[Search Tools Cheatsheet](./guide/search-tools-cheatsheet.md)** | Grep, Serena, ast-grep, grepai comparison | 5 min |
| **[Learning with AI](./guide/learning-with-ai.md)** | Use AI without becoming dependent | 15 min |
| **[Claude Code Releases](./guide/claude-code-releases.md)** | Official release history | 10 min |
Examples Library (111 templates)
**Agents** (6): [code-reviewer](./examples/agents/code-reviewer.md), [test-writer](./examples/agents/test-writer.md), [security-auditor](./examples/agents/security-auditor.md), [refactoring-specialist](./examples/agents/refactoring-specialist.md), [output-evaluator](./examples/agents/output-evaluator.md), [devops-sre](./examples/agents/devops-sre.md) โญ
**Slash Commands** (22): [/pr](./examples/commands/pr.md), [/commit](./examples/commands/commit.md), [/release-notes](./examples/commands/release-notes.md), [/diagnose](./examples/commands/diagnose.md), [/security](./examples/commands/security.md), [/security-check](./examples/commands/security-check.md) **, [/security-audit](./examples/commands/security-audit.md) **, [/update-threat-db](./examples/commands/update-threat-db.md) **, [/refactor](./examples/commands/refactor.md), [/explain](./examples/commands/explain.md), [/optimize](./examples/commands/optimize.md), [/ship](./examples/commands/ship.md)...
**Security Hooks** (18): [dangerous-actions-blocker](./examples/hooks/bash/dangerous-actions-blocker.sh), [prompt-injection-detector](./examples/hooks/bash/prompt-injection-detector.sh), [unicode-injection-scanner](./examples/hooks/bash/unicode-injection-scanner.sh), [output-secrets-scanner](./examples/hooks/bash/output-secrets-scanner.sh)...
**Skills** (1): [Claudeception](https://github.com/blader/Claudeception) โ Meta-skill that auto-generates skills from session discoveries โญ
**Plugins** (1): [SE-CoVe](./examples/plugins/se-cove.md) โ Chain-of-Verification for independent code review (Meta AI, ACL 2024)
**Utility Scripts**: [session-search.sh](./examples/scripts/session-search.sh), [audit-scan.sh](./examples/scripts/audit-scan.sh)
**GitHub Actions**: [claude-pr-auto-review.yml](./examples/github-actions/claude-pr-auto-review.yml), [claude-security-review.yml](./examples/github-actions/claude-security-review.yml), [claude-issue-triage.yml](./examples/github-actions/claude-issue-triage.yml)
**Integrations** (1): [Agent Vibes TTS](./examples/integrations/agent-vibes/) - Text-to-speech narration for Claude Code responses
**[Browse Complete Catalog](./examples/README.md)** | **[Interactive Catalog](./examples/index.html)**
Knowledge Quiz (257 questions)
Test your Claude Code knowledge with an interactive CLI quiz covering all guide sections.
```bash
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](./quiz/README.md)** | **[Contribute Questions](./quiz/templates/question-template.yaml)**
Resource Evaluations (55 assessments)
Systematic evaluation of external resources (tools, methodologies, articles) before integration into the guide.
**Methodology**: 5-point scoring system (Critical โ Low) with technical review and challenge phase for objectivity.
**Evaluations**: GSD methodology, Worktrunk, Boris Cowork video, AST-grep, ClawdBot analysis, and more.
**[Browse Evaluations](./docs/resource-evaluations/)** | **[Evaluation Methodology](./docs/resource-evaluations/README.md)**
---
## ๐ค Contributing
We welcome:
- โ
Corrections and clarifications
- โ
New quiz questions
- โ
Methodologies and workflows
- โ
Resource evaluations (see [process](./docs/resource-evaluations/README.md))
- โ
Educational content improvements
See [CONTRIBUTING.md](./CONTRIBUTING.md) for guidelines.
**Ways to Help**: Star the repo โข Report issues โข Submit PRs โข Share workflows in [Discussions](../../discussions)
---
## ๐ License & Support
**Guide**: [CC BY-SA 4.0](https://creativecommons.org/licenses/by-sa/4.0/) โ Educational content is open for reuse with attribution.
**Templates**: [CC0 1.0](https://creativecommons.org/publicdomain/zero/1.0/) โ Copy-paste freely, no attribution needed.
**Author**: [Florian BRUNIAUX](https://github.com/FlorianBruniaux) | Founding Engineer [@Mรฉthode Aristote](https://methode-aristote.fr)
**Stay Updated**: [Watch releases](../../releases) | [Discussions](../../discussions) | [Connect on LinkedIn](https://www.linkedin.com/in/florian-bruniaux-43408b83/)
---
## ๐ Further Reading
### This Guide
- **[CHANGELOG](./CHANGELOG.md)** โ Guide version history (what's new in each release)
- [Claude Code Releases](./guide/claude-code-releases.md) โ Official Claude Code release tracking
### Official Resources
- [Claude Code CLI](https://code.claude.com) โ Official website
- [Documentation](https://code.claude.com/docs) โ Official docs
- [Anthropic CHANGELOG](https://github.com/anthropics/claude-code/blob/main/CHANGELOG.md) โ Official Claude Code changelog
- [GitHub Issues](https://github.com/anthropics/claude-code/issues) โ Bug reports & feature requests
### Research & Industry Reports
- **[2026 Agentic Coding Trends Report](https://resources.anthropic.com/hubfs/2026%20Agentic%20Coding%20Trends%20Report.pdf)** (Anthropic, Feb 2026)
- 8 trends prospectifs (foundation/capability/impact)
- Case studies: Fountain (50% faster), Rakuten (7h autonomous), CRED (2x speed), TELUS (500K hours saved)
- Research data: 60% AI usage, 0-20% full delegation, 67% more PRs merged/day
- **Evaluation**: [`docs/resource-evaluations/anthropic-2026-agentic-coding-trends.md`](docs/resource-evaluations/anthropic-2026-agentic-coding-trends.md) (score 4/5)
- **Integration**: Diffused across sections 9.17 (Multi-Instance ROI), 9.20 (Agent Teams adoption), 9.11 (Enterprise Anti-Patterns), Section 9 intro
### Community Resources
- [everything-claude-code](https://github.com/affaan-m/everything-claude-code) โ Production configs (31.9kโญ)
- [awesome-claude-code](https://github.com/hesreallyhim/awesome-claude-code) โ Curated links
- [SuperClaude Framework](https://github.com/SuperClaude-Org/SuperClaude_Framework) โ Behavioral modes
### Tools
- [Ask Zread](https://zread.ai/FlorianBruniaux/claude-code-ultimate-guide) โ Ask questions about this guide
- [Interactive Quiz](./quiz/) โ 257 questions
- [Landing Site](https://florianbruniaux.github.io/claude-code-ultimate-guide-landing/) โ Visual navigation
---
*Version 3.27.0 | Updated daily ยท Feb 12, 2026 | Crafted with Claude*