{"id":44394781,"url":"https://github.com/FlorianBruniaux/claude-code-ultimate-guide","last_synced_at":"2026-02-13T19:01:07.307Z","repository":{"id":331943789,"uuid":"1131107802","full_name":"FlorianBruniaux/claude-code-ultimate-guide","owner":"FlorianBruniaux","description":"  Comprehensive Claude Code guide: 19K-line reference, 114 templates, 29 hooks. Beginner to power user.","archived":false,"fork":false,"pushed_at":"2026-02-10T12:18:59.000Z","size":26551,"stargazers_count":100,"open_issues_count":1,"forks_count":9,"subscribers_count":2,"default_branch":"main","last_synced_at":"2026-02-10T15:34:07.441Z","etag":null,"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"],"latest_commit_sha":null,"homepage":"https://florianbruniaux.github.io/claude-code-ultimate-guide-landing/","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"cc-by-sa-4.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/FlorianBruniaux.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":"CITATION.cff","codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-01-09T13:42:10.000Z","updated_at":"2026-02-10T12:19:03.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/FlorianBruniaux/claude-code-ultimate-guide","commit_stats":null,"previous_names":["florianbruniaux/claude-code-ultimate-guide"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/FlorianBruniaux/claude-code-ultimate-guide","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FlorianBruniaux%2Fclaude-code-ultimate-guide","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FlorianBruniaux%2Fclaude-code-ultimate-guide/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FlorianBruniaux%2Fclaude-code-ultimate-guide/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FlorianBruniaux%2Fclaude-code-ultimate-guide/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/FlorianBruniaux","download_url":"https://codeload.github.com/FlorianBruniaux/claude-code-ultimate-guide/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FlorianBruniaux%2Fclaude-code-ultimate-guide/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29414343,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-13T06:24:03.484Z","status":"ssl_error","status_checked_at":"2026-02-13T06:23:12.830Z","response_time":78,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["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"],"created_at":"2026-02-12T03:01:10.128Z","updated_at":"2026-02-13T19:01:07.190Z","avatar_url":"https://github.com/FlorianBruniaux.png","language":"Shell","funding_links":[],"categories":["Workflows \u0026 Knowledge Guides 🧠","🔒 Hardening and Permissions","Learning \u0026 Documentation","Code \u0026 Developer Tools"],"sub_categories":["General","Anthropic Engineering \u0026 Blog","Comprehensive Guides"],"readme":"# Claude Code Ultimate Guide\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://florianbruniaux.github.io/claude-code-ultimate-guide-landing/\"\u003e\u003cimg src=\"https://img.shields.io/badge/🌐_Interactive_Guide-Visit_Website-ff6b35?style=for-the-badge\u0026logoColor=white\" alt=\"Website\"/\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/FlorianBruniaux/claude-code-ultimate-guide/stargazers\"\u003e\u003cimg src=\"https://img.shields.io/github/stars/FlorianBruniaux/claude-code-ultimate-guide?style=for-the-badge\" alt=\"Stars\"/\u003e\u003c/a\u003e\n  \u003ca href=\"./CHANGELOG.md\"\u003e\u003cimg src=\"https://img.shields.io/badge/Updated-Feb_12,_2026_·_v3.27.0-brightgreen?style=for-the-badge\" alt=\"Last Update\"/\u003e\u003c/a\u003e\n  \u003ca href=\"./quiz/\"\u003e\u003cimg src=\"https://img.shields.io/badge/Quiz-257_questions-orange?style=for-the-badge\" alt=\"Quiz\"/\u003e\u003c/a\u003e\n  \u003ca href=\"./examples/\"\u003e\u003cimg src=\"https://img.shields.io/badge/Templates-111-green?style=for-the-badge\" alt=\"Templates\"/\u003e\u003c/a\u003e\n  \u003ca href=\"./guide/security-hardening.md\"\u003e\u003cimg src=\"https://img.shields.io/badge/🛡️_Threat_DB-22_CVEs_·_341_malicious_skills-red?style=for-the-badge\" alt=\"Threat Database\"/\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://creativecommons.org/licenses/by-sa/4.0/\"\u003e\u003cimg src=\"https://img.shields.io/badge/License-CC%20BY--SA%204.0-blue.svg\" alt=\"License: CC BY-SA 4.0\"/\u003e\u003c/a\u003e\n  \u003ca href=\"https://zread.ai/FlorianBruniaux/claude-code-ultimate-guide\"\u003e\u003cimg src=\"https://img.shields.io/badge/Ask_Zread-_.svg?style=flat\u0026color=00b0aa\u0026labelColor=000000\u0026logo=data%3Aimage%2Fsvg%2Bxml%3Bbase64%2CPHN2ZyB3aWR0aD0iMTYiIGhlaWdodD0iMTYiIHZpZXdCb3g9IjAgMCAxNiAxNiIgZmlsbD0ibm9uZSIgeG1sbnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnIj4KPHBhdGggZD0iTTQuOTYxNTYgMS42MDAxSDIuMjQxNTZDMS44ODgxIDEuNjAwMSAxLjYwMTU2IDEuODg2NjQgMS42MDE1NiAyLjI0MDFWNC45NjAxQzEuNjAxNTYgNS4zMTM1NiAxLjg4ODEgNS42MDAxIDIuMjQxNTYgNS42MDAxSDQuOTYxNTZDNS4zMTUwMiA1LjYwMDEgNS42MDE1NiA1LjMxMzU2IDUuNjAxNTYgNC45NjAxVjIuMjQwMUM1LjYwMTU2IDEuODg2NjQgNS4zMTUwMiAxLjYwMDEgNC45NjE1NiAxLjYwMDFaIiBmaWxsPSIjZmZmIi8%2BCjxwYXRoIGQ9Ik00Ljk2MTU2IDEwLjM5OTlIMi4yNDE1NkMxLjg4ODEgMTAuMzk5OSAxLjYwMTU2IDEwLjY4NjQgMS42MDE1NiAxMS4wMzk5VjEzLjc1OTlDMS42MDE1NiAxNC4xMTM0IDEuODg4MSAxNC4zOTk5IDIuMjQxNTYgMTQuMzk5OUg0Ljk2MTU2QzUuMzE1MDIgMTQuMzk5OSA1LjYwMTU2IDE0LjExMzQgNS42MDE1NiAxMy43NTk5VjExLjAzOTlDNS42MDE1NiAxMC42ODY0IDUuMzE1MDIgMTAuMzk5OSA0Ljk2MTU2IDEwLjM5OTlaIiBmaWxsPSIjZmZmIi8%2BCjxwYXRoIGQ9Ik0xMy43NTg0IDEuNjAwMUgxMS4wMzg0QzEwLjY4NSAxLjYwMDEgMTAuMzk4NCAxLjg4NjY0IDEwLjM5ODQgMi4yNDAxVjQuOTYwMUMxMC4zOTg0IDUuMzEzNTYgMTAuNjg1IDUuNjAwMSAxMS4wMzg0IDUuNjAwMUgxMy43NTg0QzE0LjExMTkgNS42MDAxIDE0LjM5ODQgNS4zMTM1NiAxNC4zOTg0IDQuOTYwMVYyLjI0MDFDMTQuMzk4NCAxLjg4NjY0IDE0LjExMTkgMS42MDAxIDEzLjc1ODQgMS42MDAxWiIgZmlsbD0iI2ZmZiIvPgo8cGF0aCBkPSJNNCAxMkwxMiA0TDQgMTJaIiBmaWxsPSIjZmZmIi8%2BCjxwYXRoIGQ9Ik00IDEyTDEyIDQiIHN0cm9rZT0iI2ZmZiIgc3Ryb2tlLXdpZHRoPSIxLjUiIHN0cm9rZS1saW5lY2FwPSJyb3VuZCIvPgo8L3N2Zz4K\u0026logoColor=ffffff\" alt=\"Ask Zread\"/\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003e **Claude Code from beginner to power user.** Exhaustive documentation, production-ready templates, agentic workflow guides, quiz, and a cheatsheet for daily use.\n\n\u003e **If this guide helps you, [give it a star ⭐](https://github.com/FlorianBruniaux/claude-code-ultimate-guide/stargazers)** — it helps others discover it too.\n\n---\n\n## ⚡ Quick Start\n\n**Quickest path**: [Cheat Sheet](./guide/cheatsheet.md) — 1 printable page with daily essentials\n\n**Interactive onboarding** (no clone needed):\n```bash\nclaude \"Fetch and follow the onboarding instructions from: https://raw.githubusercontent.com/FlorianBruniaux/claude-code-ultimate-guide/main/tools/onboarding-prompt.md\"\n```\n\n**Browse directly**: [Full Guide](./guide/ultimate-guide.md) | [Examples](./examples/) | [Quiz](./quiz/)\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003ePrerequisites \u0026 Minimal CLAUDE.md Template\u003c/strong\u003e\u003c/summary\u003e\n\n**Prerequisites**: Node.js 18+ | [Anthropic API key](https://console.anthropic.com/)\n\n```markdown\n# Project: [NAME]\n\n## Tech Stack\n- Language: [e.g., TypeScript]\n- Framework: [e.g., Next.js 14]\n- Testing: [e.g., Vitest]\n\n## Commands\n- Build: `npm run build`\n- Test: `npm test`\n- Lint: `npm run lint`\n\n## Rules\n- Run tests before marking tasks complete\n- Follow existing code patterns\n- Keep commits atomic and conventional\n```\n\nSave as `CLAUDE.md` in your project root. Claude reads it automatically.\n\n\u003c/details\u003e\n\n---\n\n## 📁 Repository Structure\n\n```mermaid\ngraph LR\n    root[📦 Repository\u003cbr/\u003eRoot]\n\n    root --\u003e guide[📖 guide/\u003cbr/\u003e19K lines]\n    root --\u003e examples[📋 examples/\u003cbr/\u003e111 templates]\n    root --\u003e quiz[🧠 quiz/\u003cbr/\u003e257 questions]\n    root --\u003e tools[🔧 tools/\u003cbr/\u003eutils]\n    root --\u003e machine[🤖 machine-readable/\u003cbr/\u003eAI index]\n    root --\u003e docs[📚 docs/\u003cbr/\u003e56 evaluations]\n\n    style root fill:#d35400,stroke:#e67e22,stroke-width:3px,color:#fff\n    style guide fill:#2980b9,stroke:#3498db,stroke-width:2px,color:#fff\n    style examples fill:#8e44ad,stroke:#9b59b6,stroke-width:2px,color:#fff\n    style quiz fill:#d68910,stroke:#f39c12,stroke-width:2px,color:#fff\n    style tools fill:#5d6d7e,stroke:#7f8c8d,stroke-width:2px,color:#fff\n    style machine fill:#138d75,stroke:#16a085,stroke-width:2px,color:#fff\n    style docs fill:#c0392b,stroke:#e74c3c,stroke-width:2px,color:#fff\n```\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eDetailed Structure (Text View)\u003c/strong\u003e\u003c/summary\u003e\n\n```\n📦 claude-code-ultimate-guide/\n│\n├─ 📖 guide/              Core Documentation (~19K lines)\n│  ├─ ultimate-guide.md   Complete reference, 10 sections\n│  ├─ cheatsheet.md       1-page printable\n│  ├─ architecture.md     How Claude Code works internal ly\n│  ├─ methodologies.md    TDD, SDD, BDD workflows\n│  ├─ third-party-tools.md  Community tools (RTK, ccusage, Entire CLI)\n│  ├─ mcp-servers-ecosystem.md  Official \u0026 community MCP servers\n│  └─ workflows/          Step-by-step guides\n│\n├─ 📋 examples/           111 Production Templates\n│  ├─ agents/             6 custom AI personas\n│  ├─ commands/           22 slash commands\n│  ├─ hooks/              18 security hooks (bash + PowerShell)\n│  ├─ skills/             1 meta-skill (Claudeception)\n│  └─ scripts/            Utility scripts (audit, search)\n│\n├─ 🧠 quiz/               257 Questions\n│  ├─ 9 categories        Setup, Agents, MCP, Trust, Advanced...\n│  ├─ 4 profiles          Junior, Senior, Power User, PM\n│  └─ Instant feedback    Doc links + score tracking\n│\n├─ 🔧 tools/              Interactive Utilities\n│  ├─ onboarding-prompt   Personalized guided tour\n│  └─ audit-prompt        Setup audit \u0026 recommendations\n│\n├─ 🤖 machine-readable/   AI-Optimized Index\n│  ├─ reference.yaml      Structured index (~2K tokens)\n│  └─ llms.txt            Standard LLM context file\n│\n└─ 📚 docs/               55 Resource Evaluations\n   └─ resource-evaluations/  5-point scoring, source attribution\n```\n\n\u003c/details\u003e\n\n---\n\n## 🎯 What Makes This Guide Unique\n\n### 🎓 Educational Depth\n\nWe explain **concepts first**, not just configs:\n- [Architecture](./guide/architecture.md) — How Claude Code works internally\n- [Trade-offs](./guide/ultimate-guide.md#when-to-use-what) — When to use agents vs skills vs commands\n- [Pitfalls](./guide/ultimate-guide.md#common-mistakes) — Common mistakes and solutions\n\n### 📝 257-Question Quiz (Unique in Ecosystem)\n\n**Only comprehensive assessment available** — test your understanding across 9 categories:\n- Setup \u0026 Configuration\n- Agents \u0026 Sub-Agents\n- MCP Servers \u0026 Integration\n- Trust \u0026 Verification\n- Advanced Patterns\n\n[Try the Quiz Online →](https://florianbruniaux.github.io/claude-code-ultimate-guide-landing/quiz/) | [Run Locally](./quiz/)\n\n### 🤖 Agent Teams Coverage (v2.1.32+)\n\n**Only comprehensive guide to Anthropic's experimental multi-agent coordination**:\n- Production metrics (Fountain 50% faster, CRED 2x speed, autonomous C compiler)\n- 5 validated workflows (multi-layer review, parallel debugging, large-scale refactoring)\n- Git-based coordination architecture (team lead + teammates)\n- Decision framework: Teams vs Multi-Instance vs Dual-Instance vs Beads\n- Setup, limitations, best practices, troubleshooting\n\n[Agent Teams Workflow →](./guide/workflows/agent-teams.md) | [Section 9.20 →](./guide/ultimate-guide.md#920-agent-teams-multi-agent-coordination)\n\n### 🔬 Methodologies (Structured Workflows)\n\nComplete guides with rationale and examples:\n- [TDD](./guide/methodologies.md#1-tdd-test-driven-development-with-claude) — Test-Driven Development\n- [SDD](./guide/methodologies.md#2-sdd-specification-driven-development) — Specification-Driven Development\n- [BDD](./guide/methodologies.md#3-bdd-behavior-driven-development) — Behavior-Driven Development\n- [GSD](./guide/methodologies.md#gsd-get-shit-done) — Get Shit Done pattern\n\n### 📚 106 Annotated Templates\n\nEducational templates with explanations:\n- Agents (6), Commands (22), Hooks (18), Skills\n- Comments explaining **why** each pattern works\n- Gradual complexity progression\n\n[Browse Catalog →](./examples/)\n\n### 🔍 55 Resource Evaluations\n\nSystematic assessment of external resources (5-point scoring):\n- Articles, videos, tools, frameworks\n- Honest assessments with source attribution\n- Integration recommendations\n\n[See Evaluations →](./docs/resource-evaluations/)\n\n---\n\n## 🎯 Learning Paths\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eJunior Developer\u003c/strong\u003e — Foundation path (7 steps)\u003c/summary\u003e\n\n1. [Quick Start](./guide/ultimate-guide.md#1-quick-start-day-1) — Install \u0026 first workflow\n2. [Essential Commands](./guide/ultimate-guide.md#13-essential-commands) — The 7 commands\n3. [Context Management](./guide/ultimate-guide.md#22-context-management) — Critical concept\n4. [Memory Files](./guide/ultimate-guide.md#31-memory-files-claudemd) — Your first CLAUDE.md\n5. [Learning with AI](./guide/learning-with-ai.md) — Use AI without becoming dependent ⭐\n6. [TDD Workflow](./guide/workflows/tdd-with-claude.md) — Test-first development\n7. [Cheat Sheet](./guide/cheatsheet.md) — Print this\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eSenior Developer\u003c/strong\u003e — Intermediate path (6 steps)\u003c/summary\u003e\n\n1. [Core Concepts](./guide/ultimate-guide.md#2-core-concepts) — Mental model\n2. [Plan Mode](./guide/ultimate-guide.md#23-plan-mode) — Safe exploration\n3. [Methodologies](./guide/methodologies.md) — TDD, SDD, BDD reference\n4. [Agents](./guide/ultimate-guide.md#4-agents) — Custom AI personas\n5. [Hooks](./guide/ultimate-guide.md#7-hooks) — Event automation\n6. [CI/CD Integration](./guide/ultimate-guide.md#93-cicd-integration) — Pipelines\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003ePower User\u003c/strong\u003e — Comprehensive path (8 steps)\u003c/summary\u003e\n\n1. [Complete Guide](./guide/ultimate-guide.md) — End-to-end\n2. [Architecture](./guide/architecture.md) — How Claude Code works\n3. [Security Hardening](./guide/security-hardening.md) — MCP vetting, injection defense\n4. [MCP Servers](./guide/ultimate-guide.md#8-mcp-servers) — Extended capabilities\n5. [Trinity Pattern](./guide/ultimate-guide.md#91-the-trinity) — Advanced workflows\n6. [Observability](./guide/observability.md) — Monitor costs \u0026 sessions\n7. [Agent Teams](./guide/workflows/agent-teams.md) — Multi-agent coordination (Opus 4.6 experimental)\n8. [Examples](./examples/) — Production templates\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eProduct Manager / DevOps / Designer\u003c/strong\u003e\u003c/summary\u003e\n\n**Product Manager** (5 steps):\n1. [What's Inside](#-whats-inside) — Scope overview\n2. [Golden Rules](#-golden-rules) — Key principles\n3. [Data Privacy](./guide/data-privacy.md) — Retention \u0026 compliance\n4. [Adoption Approaches](./guide/adoption-approaches.md) — Team strategies\n5. [PM FAQ](./guide/ultimate-guide.md#can-product-managers-use-claude-code) — Code-adjacent vs non-coding PMs\n\n**Note**: Non-coding PMs should consider [Claude Cowork Guide](https://github.com/FlorianBruniaux/claude-cowork-guide) instead.\n\n**DevOps / SRE** (5 steps):\n1. [DevOps \u0026 SRE Guide](./guide/devops-sre.md) — FIRE framework\n2. [K8s Troubleshooting](./guide/devops-sre.md#kubernetes-troubleshooting) — Symptom-based prompts\n3. [Incident Response](./guide/devops-sre.md#pattern-incident-response) — Workflows\n4. [IaC Patterns](./guide/devops-sre.md#pattern-infrastructure-as-code) — Terraform, Ansible\n5. [Guardrails](./guide/devops-sre.md#guardrails--adoption) — Security boundaries\n\n**Product Designer** (5 steps):\n1. [Working with Images](./guide/ultimate-guide.md#24-working-with-images) — Image analysis\n2. [Wireframing Tools](./guide/ultimate-guide.md#wireframing-tools) — ASCII/Excalidraw\n3. [Figma MCP](./guide/ultimate-guide.md#figma-mcp) — Design file access\n4. [Design-to-Code Workflow](./guide/workflows/design-to-code.md) — Figma → Claude\n5. [Cheat Sheet](./guide/cheatsheet.md) — Print this\n\n\u003c/details\u003e\n\n### Progressive Journey\n\n- **Week 1**: Foundations (install, CLAUDE.md, first agent)\n- **Week 2**: Core Features (skills, hooks, trust calibration)\n- **Week 3**: Advanced (MCP servers, methodologies)\n- **Month 2+**: Production mastery (CI/CD, observability)\n\n---\n\n## 🔧 Rate Limits \u0026 Cost Savings\n\n**cc-copilot-bridge** routes Claude Code through GitHub Copilot Pro+ for flat-rate access ($10/month instead of per-token billing).\n\n```bash\n# Install\ngit clone https://github.com/FlorianBruniaux/cc-copilot-bridge.git \u0026\u0026 cd cc-copilot-bridge \u0026\u0026 ./install.sh\n\n# Use\nccc   # Copilot mode (flat $10/month)\nccd   # Direct Anthropic mode (per-token)\ncco   # Offline mode (Ollama, 100% local)\n```\n\n**Benefits**: Multi-provider switching, rate limit bypass, 99%+ cost savings on heavy usage.\n\n→ **[cc-copilot-bridge](https://github.com/FlorianBruniaux/cc-copilot-bridge)**\n\n---\n\n## 🔑 Golden Rules\n\n1. **Start small** — First project: 10-15 lines CLAUDE.md max\n2. **Read before edit** — Always Read → Understand → Edit (never blind Write)\n3. **Test-first** — Write test → Watch fail → Implement → Pass\n4. **Use `/compact`** before context hits 70% — prevention beats recovery\n5. **Review everything** — AI code has 1.75× more logic errors ([source](https://dl.acm.org/doi/10.1145/3716848))\n6. **Context = Gold** — Clear CLAUDE.md \u003e clever prompts\n\n\u003e Context management is critical. See the [Cheat Sheet](./guide/cheatsheet.md#context-management-critical) for thresholds and actions.\n\n---\n\n## 🤖 For AI Assistants\n\n| Resource | Purpose | Tokens |\n|----------|---------|--------|\n| **[llms.txt](./machine-readable/llms.txt)** | Standard context file | ~1K |\n| **[reference.yaml](./machine-readable/reference.yaml)** | Structured index with line numbers | ~2K |\n\n**Quick load**: `curl -sL https://raw.githubusercontent.com/FlorianBruniaux/claude-code-ultimate-guide/main/machine-readable/reference.yaml`\n\n---\n\n## 🌍 Ecosystem\n\n### Positioning: Complementary, Not Competitive\n\n**Claude Code has two major community resources:**\n\n| Resource | Focus | Best For |\n|----------|-------|----------|\n| **This Guide** | 🎓 Educational depth, methodologies | Deep understanding, learning WHY |\n| [everything-claude-code](https://github.com/affaan-m/everything-claude-code) | ⚙️ Production configs, plugin install | Quick setup, battle-tested patterns |\n\n**Recommended workflow**: Learn concepts here → Leverage production configs there → Return for deep dives\n\nBoth resources serve different needs. Use what fits your learning style and project requirements.\n\n### Claude Cowork (Non-Developers)\n\n**Claude Cowork** is the companion guide for non-technical users (knowledge workers, assistants, managers).\n\nSame agentic capabilities as Claude Code, but through a visual interface with no coding required.\n\n→ **[Claude Cowork Guide](https://github.com/FlorianBruniaux/claude-cowork-guide)** — File organization, document generation, automated workflows\n\n**Status**: Research preview (Pro $20/mo or Max $100-200/mo, macOS only, **VPN incompatible**)\n\n### Complementary Resources\n\n| Project | Focus | Best For |\n|---------|-------|----------|\n| [claude-code-templates](https://github.com/davila7/claude-code-templates) | Distribution (200+ templates) | CLI installation (17k⭐) |\n| [anthropics/skills](https://github.com/anthropics/skills) | Official Anthropic skills (60K+⭐) | Documents, design, dev templates |\n| [anthropics/claude-plugins-official](https://skills.sh/anthropics/claude-plugins-official) | Plugin dev tools (3.1K installs) | CLAUDE.md audit, automation discovery |\n| [skills.sh](https://skills.sh/) | Skills marketplace | One-command install (Vercel Labs) |\n| [awesome-claude-code](https://github.com/hesreallyhim/awesome-claude-code) | Curation | Resource discovery |\n| [awesome-claude-skills](https://github.com/BehiSecc/awesome-claude-skills) | Skills taxonomy | 62 skills across 12 categories |\n| [awesome-claude-md](https://github.com/josix/awesome-claude-md) | CLAUDE.md examples (31★) | Annotated configs with scoring |\n| [AI Coding Agents Matrix](https://coding-agents-matrix.dev) | Technical comparison | Comparing 23+ alternatives |\n\n**Community**: 🇫🇷 [Dev With AI](https://www.devw.ai/) — 1500+ devs on Slack, meetups in Paris, Bordeaux, Lyon\n\n→ **[AI Ecosystem Guide](./guide/ai-ecosystem.md)** — Complete integration patterns with complementary AI tools\n\n---\n\n## 🛡️ Security\n\n**Comprehensive MCP security coverage** — the only guide with a threat intelligence database and production hardening workflows.\n\n### Official Security Tools\n\n| Tool | Purpose | Maintained By |\n|------|---------|---------------|\n| [claude-code-security-review](https://github.com/anthropics/claude-code-security-review) | GitHub Action for automated security scanning | Anthropic (official) |\n| This Guide's Threat DB | Intelligence layer (22 CVEs, 341 malicious skills) | Community |\n\n**Workflow**: Use GitHub Action for automation → Consult Threat DB for threat intelligence.\n\n### Threat Database\n\n**22 CVE-mapped vulnerabilities** and **341 malicious skills** tracked in [`machine-readable/threat-db.yaml`](./machine-readable/threat-db.yaml):\n\n| Threat Category | Count | Examples |\n|----------------|-------|----------|\n| **Prompt Injection** | 14 CVEs | Indirect injection (CVE-2024-1546), context poisoning |\n| **Data Exfiltration** | 5 CVEs | Training data extraction (CVE-2024-0241), secret leakage |\n| **Code Injection** | 3 CVEs | Tool manipulation, workflow abuse |\n| **Malicious Skills** | 341 patterns | Unicode injection, hidden instructions, auto-execute |\n\n**Taxonomies**: 10 attack surfaces × 11 threat types × 8 impact levels\n\n### Hardening Resources\n\n| Resource | Purpose | Time |\n|----------|---------|------|\n| **[Security Hardening Guide](./guide/security-hardening.md)** | MCP vetting, injection defense, audit workflow | 25 min |\n| **[Data Privacy Guide](./guide/data-privacy.md)** | Retention policies (5yr → 30d → 0), GDPR compliance | 10 min |\n| **[Sandbox Isolation](./guide/sandbox-isolation.md)** | Docker sandboxes for untrusted MCP servers | 10 min |\n| **[Production Safety](./guide/production-safety.md)** | Infrastructure locks, port stability, DB safety | 20 min |\n\n### Security Commands\n\n```bash\n/security-check      # Quick scan config vs known threats (~30s)\n/security-audit      # Full 6-phase audit with score /100 (2-5min)\n/update-threat-db    # Research \u0026 update threat intelligence\n/audit-agents-skills # Quality audit with security checks\n```\n\n### Security Hooks\n\n**18 production hooks** (bash + PowerShell) in [`examples/hooks/`](./examples/hooks/):\n\n| Hook | Purpose |\n|------|---------|\n| [dangerous-actions-blocker](./examples/hooks/bash/dangerous-actions-blocker.sh) | Block `rm -rf`, force-push, production ops |\n| [prompt-injection-detector](./examples/hooks/bash/prompt-injection-detector.sh) | Detect injection patterns in CLAUDE.md/prompts |\n| [unicode-injection-scanner](./examples/hooks/bash/unicode-injection-scanner.sh) | Detect hidden Unicode (zero-width, RTL override) |\n| [output-secrets-scanner](./examples/hooks/bash/output-secrets-scanner.sh) | Prevent API keys/tokens in Claude responses |\n\n**[Browse All Security Hooks →](./examples/hooks/)**\n\n### MCP Vetting Workflow\n\n**Systematic evaluation before trusting MCP servers:**\n\n1. **Provenance**: GitHub verified, 100+ stars, active maintenance\n2. **Code Review**: Minimal privileges, no obfuscation, open-source\n3. **Permissions**: Whitelist-only filesystem access, network restrictions\n4. **Testing**: Isolated Docker sandbox first, monitor tool calls\n5. **Monitoring**: Session logs, error tracking, regular re-audits\n\n**[Full MCP Security Workflow →](./guide/security-hardening.md#vetting-mcp-servers)**\n\n---\n\n## 📖 About\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eOrigins \u0026 Philosophy\u003c/strong\u003e\u003c/summary\u003e\n\nThis 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.\n\n**Philosophy**: Learning journey over reference manual. Understanding **why** before **how**. Progressive complexity — start simple, master advanced at your pace.\n\n**Created with Claude Code**. Community-validated through contributions and feedback.\n\n**Key Inspirations**:\n- [Claudelog.com](https://claudelog.com/) — Excellent patterns \u0026 tutorials\n- [zebbern/claude-code-guide](https://github.com/zebbern/claude-code-guide) — Comprehensive reference with security focus\n- [ykdojo/claude-code-tips](https://github.com/ykdojo/claude-code-tips) — Practical productivity techniques\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003ePrivacy \u0026 Data\u003c/strong\u003e\u003c/summary\u003e\n\nClaude Code sends your prompts, file contents, and MCP results to Anthropic servers.\n- **Default**: 5 years retention (training enabled) | **Opt-out**: 30 days | **Enterprise**: 0\n- **Action**: [Disable training](https://claude.ai/settings/data-privacy-controls) | [Full privacy guide](./guide/data-privacy.md)\n\n\u003c/details\u003e\n\n---\n\n## 📚 What's Inside\n\n### Core Documentation\n\n| File | Purpose | Time |\n|------|---------|------|\n| **[Ultimate Guide](./guide/ultimate-guide.md)** | Complete reference (~19K lines), 10 sections | 30-40h (full) • Most consult sections |\n| **[Cheat Sheet](./guide/cheatsheet.md)** | 1-page printable reference | 5 min |\n| **[Visual Reference](./guide/visual-reference.md)** | 20 ASCII diagrams for key concepts | 5 min |\n| **[Architecture](./guide/architecture.md)** | How Claude Code works internally | 25 min |\n| **[Methodologies](./guide/methodologies.md)** | TDD, SDD, BDD reference | 20 min |\n| **[Workflows](./guide/workflows/)** | Practical guides (TDD, Plan-Driven, Task Management) | 30 min |\n| **[Data Privacy](./guide/data-privacy.md)** | Retention \u0026 compliance | 10 min |\n| **[Security Hardening](./guide/security-hardening.md)** | MCP vetting, injection defense | 25 min |\n| **[Sandbox Isolation](./guide/sandbox-isolation.md)** | Docker Sandboxes, cloud alternatives, safe autonomy | 10 min |\n| **[Production Safety](./guide/production-safety.md)** | Port stability, DB safety, infrastructure lock | 20 min |\n| **[DevOps \u0026 SRE](./guide/devops-sre.md)** | FIRE framework, K8s troubleshooting, incident response | 30 min |\n| **[AI Ecosystem](./guide/ai-ecosystem.md)** | Complementary AI tools \u0026 integration patterns | 20 min |\n| **[AI Traceability](./guide/ai-traceability.md)** | Code attribution \u0026 provenance tracking | 15 min |\n| **[Search Tools Cheatsheet](./guide/search-tools-cheatsheet.md)** | Grep, Serena, ast-grep, grepai comparison | 5 min |\n| **[Learning with AI](./guide/learning-with-ai.md)** | Use AI without becoming dependent | 15 min |\n| **[Claude Code Releases](./guide/claude-code-releases.md)** | Official release history | 10 min |\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eExamples Library\u003c/strong\u003e (111 templates)\u003c/summary\u003e\n\n**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) ⭐\n\n**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)...\n\n**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)...\n\n**Skills** (1): [Claudeception](https://github.com/blader/Claudeception) — Meta-skill that auto-generates skills from session discoveries ⭐\n\n**Plugins** (1): [SE-CoVe](./examples/plugins/se-cove.md) — Chain-of-Verification for independent code review (Meta AI, ACL 2024)\n\n**Utility Scripts**: [session-search.sh](./examples/scripts/session-search.sh), [audit-scan.sh](./examples/scripts/audit-scan.sh)\n\n**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)\n\n**Integrations** (1): [Agent Vibes TTS](./examples/integrations/agent-vibes/) - Text-to-speech narration for Claude Code responses\n\n**[Browse Complete Catalog](./examples/README.md)** | **[Interactive Catalog](./examples/index.html)**\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eKnowledge Quiz\u003c/strong\u003e (257 questions)\u003c/summary\u003e\n\nTest your Claude Code knowledge with an interactive CLI quiz covering all guide sections.\n\n```bash\ncd quiz \u0026\u0026 npm install \u0026\u0026 npm start\n```\n\n**Features**: 4 profiles (Junior/Senior/Power User/PM), 10 topic categories, immediate feedback with doc links, score tracking with weak area identification.\n\n**[Quiz Documentation](./quiz/README.md)** | **[Contribute Questions](./quiz/templates/question-template.yaml)**\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eResource Evaluations\u003c/strong\u003e (55 assessments)\u003c/summary\u003e\n\nSystematic evaluation of external resources (tools, methodologies, articles) before integration into the guide.\n\n**Methodology**: 5-point scoring system (Critical → Low) with technical review and challenge phase for objectivity.\n\n**Evaluations**: GSD methodology, Worktrunk, Boris Cowork video, AST-grep, ClawdBot analysis, and more.\n\n**[Browse Evaluations](./docs/resource-evaluations/)** | **[Evaluation Methodology](./docs/resource-evaluations/README.md)**\n\n\u003c/details\u003e\n\n---\n\n## 🤝 Contributing\n\nWe welcome:\n- ✅ Corrections and clarifications\n- ✅ New quiz questions\n- ✅ Methodologies and workflows\n- ✅ Resource evaluations (see [process](./docs/resource-evaluations/README.md))\n- ✅ Educational content improvements\n\nSee [CONTRIBUTING.md](./CONTRIBUTING.md) for guidelines.\n\n**Ways to Help**: Star the repo • Report issues • Submit PRs • Share workflows in [Discussions](../../discussions)\n\n---\n\n## 📄 License \u0026 Support\n\n**Guide**: [CC BY-SA 4.0](https://creativecommons.org/licenses/by-sa/4.0/) — Educational content is open for reuse with attribution.\n\n**Templates**: [CC0 1.0](https://creativecommons.org/publicdomain/zero/1.0/) — Copy-paste freely, no attribution needed.\n\n**Author**: [Florian BRUNIAUX](https://github.com/FlorianBruniaux) | Founding Engineer [@Méthode Aristote](https://methode-aristote.fr)\n\n**Stay Updated**: [Watch releases](../../releases) | [Discussions](../../discussions) | [Connect on LinkedIn](https://www.linkedin.com/in/florian-bruniaux-43408b83/)\n\n---\n\n## 📚 Further Reading\n\n### This Guide\n- **[CHANGELOG](./CHANGELOG.md)** — Guide version history (what's new in each release)\n- [Claude Code Releases](./guide/claude-code-releases.md) — Official Claude Code release tracking\n\n### Official Resources\n- [Claude Code CLI](https://code.claude.com) — Official website\n- [Documentation](https://code.claude.com/docs) — Official docs\n- [Anthropic CHANGELOG](https://github.com/anthropics/claude-code/blob/main/CHANGELOG.md) — Official Claude Code changelog\n- [GitHub Issues](https://github.com/anthropics/claude-code/issues) — Bug reports \u0026 feature requests\n\n### Research \u0026 Industry Reports\n\n- **[2026 Agentic Coding Trends Report](https://resources.anthropic.com/hubfs/2026%20Agentic%20Coding%20Trends%20Report.pdf)** (Anthropic, Feb 2026)\n  - 8 trends prospectifs (foundation/capability/impact)\n  - Case studies: Fountain (50% faster), Rakuten (7h autonomous), CRED (2x speed), TELUS (500K hours saved)\n  - Research data: 60% AI usage, 0-20% full delegation, 67% more PRs merged/day\n  - **Evaluation**: [`docs/resource-evaluations/anthropic-2026-agentic-coding-trends.md`](docs/resource-evaluations/anthropic-2026-agentic-coding-trends.md) (score 4/5)\n  - **Integration**: Diffused across sections 9.17 (Multi-Instance ROI), 9.20 (Agent Teams adoption), 9.11 (Enterprise Anti-Patterns), Section 9 intro\n\n### Community Resources\n- [everything-claude-code](https://github.com/affaan-m/everything-claude-code) — Production configs (31.9k⭐)\n- [awesome-claude-code](https://github.com/hesreallyhim/awesome-claude-code) — Curated links\n- [SuperClaude Framework](https://github.com/SuperClaude-Org/SuperClaude_Framework) — Behavioral modes\n\n### Tools\n- [Ask Zread](https://zread.ai/FlorianBruniaux/claude-code-ultimate-guide) — Ask questions about this guide\n- [Interactive Quiz](./quiz/) — 257 questions\n- [Landing Site](https://florianbruniaux.github.io/claude-code-ultimate-guide-landing/) — Visual navigation\n\n---\n\n*Version 3.27.0 | Updated daily · Feb 12, 2026 | Crafted with Claude*\n\n\u003c!-- SEO Keywords --\u003e\n\u003c!-- claude code, claude code tutorial, anthropic cli, ai coding assistant, claude code mcp,\nclaude code agents, claude code hooks, claude code skills, agentic coding, ai pair programming,\ntdd ai, test driven development ai, sdd spec driven development, bdd claude, development methodologies,\nclaude code architecture, data privacy anthropic, claude code workflows, ai coding workflows --\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FFlorianBruniaux%2Fclaude-code-ultimate-guide","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FFlorianBruniaux%2Fclaude-code-ultimate-guide","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FFlorianBruniaux%2Fclaude-code-ultimate-guide/lists"}