From 7957dda29c525f5e777ed3838fcf8a9d8f2b617c Mon Sep 17 00:00:00 2001 From: Florian BRUNIAUX Date: Tue, 27 Jan 2026 18:30:18 +0100 Subject: [PATCH] release: version 3.17.1 - README V3 with Repository Structure diagram ### Added - Repository Structure diagram (Mermaid + ASCII collapsible) - 4 missing guides in Core Documentation table - Quiz online link (landing site) ### Changed - README V3: merged best of both versions (WHY/HOW positioning + complete sections) - Ecosystem positioning: complementary instead of competitive - Core Documentation: added AI Ecosystem, AI Traceability, Search Tools, Learning with AI ### Removed - README-new.md (merged into README.md) Co-Authored-By: Claude Sonnet 4.5 --- CHANGELOG.md | 35 ++ README.md | 543 ++++++++++++++++---------------- VERSION | 2 +- guide/cheatsheet.md | 4 +- guide/ultimate-guide.md | 4 +- machine-readable/reference.yaml | 4 +- 6 files changed, 322 insertions(+), 270 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 942cb6b..dcb8c1f 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -6,6 +6,41 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/). ## [Unreleased] +## [3.17.1] - 2026-01-27 + +### Added + +- **Repository Structure diagram** in README.md + - Interactive Mermaid diagram (graph LR layout) with 6 main directories + - High-contrast colors (dark backgrounds + white text) for readability + - ASCII art fallback in collapsible section for detailed structure + - Shows key metrics: 15K lines guide, 86 templates, 227 questions, 22 evaluations + +### Changed + +- **README V3** — Merged best elements from two versions (README.md + README-new.md) + - Kept "WHY vs HOW" positioning and quiz prominence from new version + - Restored cc-copilot-bridge, Learning Paths by role, AI Assistants section from old version + - Removed excessive competitor references (8 mentions → 2-3 in Ecosystem only) + - Complementary positioning instead of "graduate to everything-claude-code" + - Final size: 491 lines (vs 474 original) + +- **Quiz links** — Now points to online version first + - Primary: https://florianbruniaux.github.io/claude-code-ultimate-guide-landing/quiz/ + - Secondary: Local ./quiz/ for offline use + +- **Core Documentation table** — Added 4 missing guides + - AI Ecosystem (Complementary AI tools & integration patterns) + - AI Traceability (Code attribution & provenance tracking) + - Search Tools Cheatsheet (Grep, Serena, ast-grep, grepai comparison) + - Learning with AI (Use AI without becoming dependent) + +- **Ecosystem section** — Added direct link to AI Ecosystem Guide for integration patterns + +### Removed + +- **README-new.md** — No longer needed after V3 merge + ## [3.17.0] - 2026-01-27 ### Added diff --git a/README.md b/README.md index e48af75..23bf823 100644 --- a/README.md +++ b/README.md @@ -1,4 +1,4 @@ -# Claude Code Guide +# Claude Code Ultimate Guide

Website @@ -6,16 +6,16 @@

Stars - Templates Quiz + Templates

License: CC BY-SA 4.0 - Ask Zread + Ask Zread

-> Complete guide to Claude Code with 86 production-ready templates +> Master Claude Code with educational depth and practical methodologies. We teach **WHY** it works → Others provide **HOW** to configure. --- @@ -60,51 +60,114 @@ Save as `CLAUDE.md` in your project root. Claude reads it automatically. --- -## Why This Guide? +## 📁 Repository Structure -**The problem**: Awesome-lists give links, not learning paths. Official docs are dense. Tutorials get outdated in weeks. +```mermaid +graph LR + root[📦 Repository
Root] -**This guide**: Structured learning path with 86 copy-paste templates, from first install to advanced workflows. + root --> guide[📖 guide/
15K lines] + root --> examples[📋 examples/
86 templates] + root --> quiz[🧠 quiz/
227 questions] + root --> tools[🔧 tools/
utils] + root --> machine[🤖 machine-readable/
AI index] + root --> docs[📚 docs/
22 evaluations] -**Reading time**: Quick Start ~15 min. Full guide ~4 hours (most read by section). - -**By [Florian BRUNIAUX](https://github.com/FlorianBruniaux)** | Founding Engineer [@Méthode Aristote](https://methode-aristote.fr) - ---- - -## 👥 Not a Developer? - -**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 - ---- - -## ⚠️ ClawdBot vs Claude Code? - -**Seen the buzz about ClawdBot?** It's a different tool. ClawdBot = self-hosted chatbot for messaging apps (personal automation, smart home). Claude Code = CLI for developers (terminal/IDE, code generation). - -→ **[See FAQ](./guide/ultimate-guide.md#appendix-b-faq)** for detailed comparison table and decision tree - ---- - -## 🔧 Hitting Rate Limits or High Costs? - -**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) + 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 ``` -→ **[cc-copilot-bridge](https://github.com/FlorianBruniaux/cc-copilot-bridge)** — Multi-provider switching, rate limit bypass, 99%+ cost savings +
+Detailed Structure (Text View) + +``` +📦 claude-code-ultimate-guide/ +│ +├─ 📖 guide/ Core Documentation (~15K lines) +│ ├─ ultimate-guide.md Complete reference, 10 sections +│ ├─ cheatsheet.md 1-page printable +│ ├─ architecture.md How Claude Code works internally +│ ├─ methodologies.md TDD, SDD, BDD workflows +│ └─ workflows/ Step-by-step guides +│ +├─ 📋 examples/ 86 Production Templates +│ ├─ agents/ 6 custom AI personas +│ ├─ commands/ 18 slash commands +│ ├─ hooks/ 18 security hooks (bash + PowerShell) +│ ├─ skills/ 1 meta-skill (Claudeception) +│ └─ scripts/ Utility scripts (audit, search) +│ +├─ 🧠 quiz/ 227 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/ 22 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 + +### 📝 227-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/) + +### 🔬 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 + +### 📚 86 Annotated Templates + +Educational templates with explanations: +- Agents (6), Commands (18), Hooks (18), Skills +- Comments explaining **why** each pattern works +- Gradual complexity progression + +[Browse Catalog →](./examples/) + +### 🔍 22 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/) --- @@ -149,40 +212,153 @@ cco # Offline mode (Ollama, 100% local)
-Product Manager — Overview path (5 steps) +Product Manager / DevOps / Designer -1. [What's Inside](#-whats-inside) — Scope +**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 (visual interface, no CLI). +**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 -
-DevOps / SRE — Infrastructure path (5 steps) - -1. [DevOps & SRE Guide](./guide/devops-sre.md) — FIRE framework for infrastructure diagnosis -2. [K8s Troubleshooting](./guide/devops-sre.md#kubernetes-troubleshooting) — Prompts by symptom -3. [Incident Response](./guide/devops-sre.md#pattern-incident-response) — Solo & multi-agent workflows -4. [IaC Patterns](./guide/devops-sre.md#pattern-infrastructure-as-code) — Terraform, Ansible, GitOps -5. [Guardrails](./guide/devops-sre.md#guardrails--adoption) — Security boundaries & team adoption - -
- -
-Product Designer — Design-to-code path (5 steps) - -1. [Working with Images](./guide/ultimate-guide.md#24-working-with-images) — Image analysis basics -2. [Wireframing Tools](./guide/ultimate-guide.md#wireframing-tools) — ASCII/Excalidraw workflows -3. [Figma MCP](./guide/ultimate-guide.md#figma-mcp) — Design file access & tokens -4. [Design-to-Code Workflow](./guide/workflows/design-to-code.md) — Figma Make → Claude handoff ⭐ +**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⭐) | +| [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 | +| [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 + +--- + +## 📖 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 @@ -200,43 +376,12 @@ cco # Offline mode (Ollama, 100% local) | **[Security Hardening](./guide/security-hardening.md)** | MCP vetting, injection defense | 25 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 | -
-Repository Structure - -``` -claude-code-ultimate-guide/ -├── guide/ # 📖 Core documentation -│ ├── ultimate-guide.md # Complete reference (~15K lines) -│ ├── cheatsheet.md # 1-page printable reference -│ ├── architecture.md # How Claude Code works internally -│ ├── methodologies.md # 15 development methodologies -│ └── workflows/ # TDD, Task Management, 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 -│ -├── docs/ # 📚 Public documentation -│ └── resource-evaluations/ # Community resource assessments (22 files) -│ -├── 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) -``` - -
-
Examples Library (86 templates) @@ -288,170 +433,18 @@ Systematic evaluation of external resources (tools, methodologies, articles) bef
-
-Audit Tools - -**Quick scan** (~2s): -```bash -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](./tools/audit-prompt.md) - -
- -
-For AI Assistants (LLM-optimized) - -| 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` - -
- -
-Alternative Formats - -- **[DeepWiki](https://deepwiki.com/FlorianBruniaux/claude-code-ultimate-guide/1-overview)** — AI-powered Q&A -- **[NotebookLM Slides](./exports/notebooklm.pdf)** — Visual overview -- **[Kimi PDF](./exports/kimi.pdf)** — Full text export - -
- ---- - -## 🔑 Golden Rules - -1. **Always review diffs** before accepting changes — Claude suggests, you decide -2. **Use `/compact`** before context hits 70% — prevention beats recovery -3. **Be specific** in requests — Include WHAT, WHERE, HOW, VERIFY -4. **Start with Plan Mode** for risky/complex tasks — read-only exploration first -5. **Create CLAUDE.md** for every project — single source of truth - -> Context management is critical. See the [Cheat Sheet](./guide/cheatsheet.md#context-management-critical) for thresholds and actions. - ---- - -## 🌍 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 - -**External Research Tools**: -- [Petri 2.0](https://github.com/safety-research/petri) — Open-source AI behavior audit tool (Anthropic Alignment) - - 70 scenarios for collusion, ethics conflicts, info sensitivity - - Eval-awareness mitigations + benchmarks (Claude Opus 4.5, GPT-5.2, Gemini 3 Pro, Grok 4) - - [Blog](https://alignment.anthropic.com/2026/petri-v2/) - -
- -
-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) - -
- -
-Claude Cowork (for Non-Developers) - -**Cowork** is Claude's agentic desktop feature for knowledge workers — same AI, files-only interface. - -> **📦 [Complete Documentation Now Has Its Own Repository!](https://github.com/FlorianBruniaux/claude-cowork-guide)** -> -> ⭐ **Star the repo**: [FlorianBruniaux/claude-cowork-guide](https://github.com/FlorianBruniaux/claude-cowork-guide) - -**Quick Access** (34 files, v1.0.0): - -| Resource | Description | -|----------|-------------| -| **[🏠 Main Hub](https://github.com/FlorianBruniaux/claude-cowork-guide)** | Complete documentation repository | -| **[🚀 Getting Started](https://github.com/FlorianBruniaux/claude-cowork-guide/blob/main/guide/01-getting-started.md)** | Setup, first workflow, CTOC framework | -| **[⚡ Cheatsheet](https://github.com/FlorianBruniaux/claude-cowork-guide/blob/main/reference/cheatsheet.md)** | 1-page printable reference | -| **[❓ FAQ](https://github.com/FlorianBruniaux/claude-cowork-guide/blob/main/reference/faq.md)** | 20+ frequently asked questions | - -**Content**: -- 📖 **6 Core Guides**: Overview, capabilities, security, troubleshooting -- 📝 **60+ Prompts**: File ops, document creation, data extraction, research -- 🔧 **5 Workflows**: File organization, expense tracking, report synthesis, meeting prep, team handoff -- 🎓 **Interactive Onboarding**: Personalized learning path -- 🛠️ **3 Scripts**: Version sync, stats update, validation - -**Status**: Research preview (Pro $20/mo or Max $100-200/mo, macOS only, **VPN incompatible**) - -**Archive**: Historical versions available in git history (pre-v3.17.0) - -
- -
-Ecosystem & Related Resources - -**This Guide's Ecosystem** (4 interconnected repositories): - -| Repository | Purpose | Audience | -|------------|---------|----------| -| **[Claude Code Guide](https://github.com/FlorianBruniaux/claude-code-ultimate-guide)** *(this repo)* | Comprehensive documentation (13K lines, 82 templates) | Developers | -| **[Claude Cowork Guide](https://github.com/FlorianBruniaux/claude-cowork-guide)** | Non-technical usage (67 prompts, 5 workflows) | Knowledge workers | -| **Code Landing** *(to be deployed)* | Marketing site for Claude Code guide | Discovery | -| **Cowork Landing** *(to be deployed)* | Marketing site for Cowork guide | Discovery | - -💡 **Architecture**: Separate repos for clear audience separation (devs vs non-devs), bidirectional cross-links for easy navigation. - -**Complementary resources**: - -| Project | Focus | Best For | -|---------|-------|----------| -| [claude-code-templates](https://github.com/davila7/claude-code-templates) | **Distribution** - Install & use | Getting 200+ templates via CLI (17k⭐) | -| [skills.sh](https://skills.sh/) | **Skills marketplace** - Discover & install | One-command skill installation (`npx add-skill`) from Vercel Labs | -| [awesome-claude-code](https://github.com/hesreallyhim/awesome-claude-code) | **Curation** - Discover & link | Exploring community resources | -| [Claude-Code-Everything](https://github.com/wesammustafa/Claude-Code-Everything) | **Visual walkthrough** | Learning through screenshots | -| [AI Coding Agents Matrix](https://coding-agents-matrix.dev) | **Technical comparison** | Comparing Claude Code vs 22+ alternatives | - -**AI Coding Agents Matrix** (by [Packmind](https://packmind.com)): -- Interactive comparison: **23 AI coding agents** across **11 technical criteria** -- Criteria: CLI, MCP Support, Skills, Commands, Subagents, Plan Mode, AGENTS.md, and more -- Sortable/filterable matrix for precision discovery -- Open source ([Apache-2.0](https://github.com/PackmindHub/coding-agents-matrix)), community-driven -- **Use case**: Discovery (Matrix: "Which agent has X feature?") → Mastery (This Guide: "How to use Claude Code?") - -**Positioning**: Use Matrix to **discover and compare** → Choose Claude Code → Use this guide to **master it**. - -**Community**: 🇫🇷 [Dev With AI](https://www.devw.ai/) — 1500+ devs on Slack, meetups in Paris, Bordeaux, Lyon - -**Official docs**: [docs.anthropic.com/claude-code](https://docs.anthropic.com/en/docs/claude-code) - -
- -
-Windows & Translation - -**Windows Users**: Most commands work with Git Bash. Use `%USERPROFILE%\.claude\` for paths. [Report issues](../../issues) - -**Language**: Written in English for wider reach. French is my native language. Request translations via [issues](../../issues). - -
- --- ## 🤝 Contributing -Found an error? Have a suggestion? See [CONTRIBUTING.md](./CONTRIBUTING.md). +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) @@ -459,13 +452,37 @@ Found an error? Have a suggestion? See [CONTRIBUTING.md](./CONTRIBUTING.md). ## 📄 License & Support -Licensed under [CC BY-SA 4.0](https://creativecommons.org/licenses/by-sa/4.0/). Free to share and adapt with attribution. +**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/) --- -*Version 3.17.0 | January 2026 | Crafted with Claude* +## 📚 Further Reading + +### Official Resources +- [Claude Code CLI](https://code.claude.com) — Official website +- [Documentation](https://code.claude.com/docs) — Official docs +- [CHANGELOG](https://github.com/anthropics/claude-code/blob/main/CHANGELOG.md) — Official changelog +- [GitHub Issues](https://github.com/anthropics/claude-code/issues) — Bug reports & feature requests + +### 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/) — 227 questions +- [Landing Site](https://florianbruniaux.github.io/claude-code-ultimate-guide-landing/) — Visual navigation + +--- + +*Version 3.17.1 | January 2026 | Crafted with Claude*