Guia Insano Claude - Formação Completa em IA
ThibautMelen/claude-insane-guide
Formação progressiva de dev IA: do iniciante ao expert, 100% francês
Ver no GitHubRepositório educacional abrangente em francês para dominar Claude Code, cobrindo Memory, Commands, MCP servers, Plugins e Sub-Agents. Estruturado em trilha progressiva de 20-28 horas, com 9 temas core, 5 workflows de produção e 60+ recursos práticos. Inclui documentação (~450KB), cheatsheets e exemplos reais.
Instalação
npx convez-ai ThibautMelen/claude-insane-guide1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Aprender Claude Code estruturadamente
- Dominar MCP servers e Plugins
- Implementar workflows de produção com IA
- Referência para sub-agents e automação
Veredito

Excelente repositório didático com cobertura profunda do ecossistema Claude, mas assume conhecimento prévio e é voltado para público francófono. Ideal como referência estruturada para desenvolvedores buscando dominar ferramentas de IA.
README
A tradução para o português deste README ainda está na fila.
╔═════════════════════════════════════════════════════════════════════════════════╗
║ ║
║ ★ ✨ ⭐ ✨ ★ ✨ ⭐ ✨ ★ ✨ ⭐ ✨ ★ ║
║ ║
║ ██████╗██╗ █████╗ ██╗ ██╗██████╗ ███████╗ ║
║ ██╔════╝██║ ██╔══██╗██║ ██║██╔══██╗██╔════╝ ║
║ ██║ ██║ ███████║██║ ██║██║ ██║█████╗ ║
║ ██║ ██║ ██╔══██║██║ ██║██║ ██║██╔══╝ ║
║ ╚██████╗███████╗██║ ██║╚██████╔╝██████╔╝███████╗ ║
║ ╚═════╝╚══════╝╚═╝ ╚═╝ ╚═════╝ ╚═════╝ ╚══════╝ ║
║ ║
║ ██╗███╗ ██╗███████╗ █████╗ ███╗ ██╗███████╗ ║
║ ██║████╗ ██║██╔════╝██╔══██╗████╗ ██║██╔════╝ ║
║ ██║██╔██╗ ██║███████╗███████║██╔██╗ ██║█████╗ ║
║ ██║██║╚██╗██║╚════██║██╔══██║██║╚██╗██║██╔══╝ ║
║ ██║██║ ╚████║███████║██║ ██║██║ ╚████║███████╗ ║
║ ╚═╝╚═╝ ╚═══╝╚══════╝╚═╝ ╚═╝╚═╝ ╚═══╝╚══════╝ ║
║ ║
║ 🎯 GUIDE COMPLET & MAÎTRISE 🎯 ║
║ ║
║ ★ ✨ ⭐ ✨ ★ ✨ ⭐ ✨ ★ ✨ ⭐ ✨ ★ ║
║ ║
╚═════════════════════════════════════════════════════════════════════════════════╝
🚀 COMMENCEZ ICI
👋 Nouveau sur Claude Code?
Lisez ceci en PREMIER (5 minutes) :
📄 QUICK START : Claude Code en 5 Minutes ⭐
✅ Comprendre les 3 concepts clés (Commands, Skills, Agents)
✅ Decision tree visuel simple
✅ Créer votre premier workflow
✅ Savoir où aller ensuite
Puis continuez avec :
📚 Core 4 & Fundamentals (30 min)
- Framework Dan complet (THE REFERENCE)
- Comprendre POURQUOI avant COMMENT
🎯 Decision Trees (20 min)
- Choisir la bonne feature pour chaque situation
🎯 À Propos
📖 Qu'est-ce que c'est ?
Guide d'apprentissage complet sur Claude Code et l'écosystème Anthropic, organisé par ordre pédagogique pour une progression optimale.
Public : Développeurs francophones souhaitant maîtriser Claude Code.
🆕 Nouveautés 2025
- ✨ Thème 8 : Advanced (Interactive UI, Multi-dialog, Enterprise, AI Orchestration)
- 🔧 Thème 9 : Add-ons (VS Code Extension, Statusline)
- 🚀 Workflow-Pattern-Orchestration réorganisé
- 🤖 Updates Claude Sonnet 4.5
📖 Format d'Apprentissage
Chaque thème suit une structure identique :
📁 themes/X-nom-theme/
├── 📄 guide.md → 📚 Théorie complète + use cases
└── 📄 cheatsheet.md → ⚡ Référence rapide
🗺️ Parcours d'Apprentissage
📚 Ordre Pédagogique Recommandé
Suivez cet ordre pour une progression optimale :
🎯 PARCOURS DÉBUTANT (8-10 heures)
1️⃣ MEMORY
↓ Base - Persistance des instructions
2️⃣ COMMANDS
↓ Automatisation - Prompts réutilisables
3️⃣ HOOKS
↓ Événements - Automatisation lifecycle
4️⃣ SKILLS
↓ Capacités - Connaissances spécialisées
5️⃣ MCP
↓ Intégration - Protocol externe
6️⃣ AGENTS
↓ Orchestration - Délégation tâches isolées
7️⃣ PLUGINS
└─> Empaquetage - Extensions modulaires
🚀 PARCOURS INTERMÉDIAIRE → EXPERT (6-8 heures)
WORKFLOW-PATTERN-ORCHESTRATION
├─> Workflows (EPCT, Parallel, Sequential, Hybrid)
├─> Patterns (Command coordination, Hooks automation)
└─> Best Practices (Performance, Cost, Resilience)
💪 PARCOURS EXPERT (4-6 heures)
8️⃣ ADVANCED (Thème 8)
├─> Multi-dialog patterns
├─> Interactive UI (AskUserQuestion)
├─> Enterprise patterns
├─> AI orchestration
└─> Decision trees
🔧 OPTIONNEL
9️⃣ ADD-ONS (Thème 9)
├─> VS Code Extension
└─> Statusline Dashboard
📁 Structure du Projet
claude-anthropic-comprhension/
┃
┣━━ 📁 themes/ 🎯 FEATURES CORE (1-9)
┃ ┃
┃ ┣━━ 📁 1-memory/
┃ ┃ ├── 📄 guide.md → Persistance instructions (.claude/CLAUDE.md)
┃ ┃ └── 📄 cheatsheet.md → Référence rapide
┃ ┃
┃ ┣━━ 📁 2-commands/
┃ ┃ ├── 📄 guide.md → Slash commands réutilisables
┃ ┃ └── 📄 cheatsheet.md → Templates courants
┃ ┃
┃ ┣━━ 📁 3-hooks/
┃ ┃ ├── 📄 guide.md → Gestionnaires d'événements système
┃ ┃ └── 📄 cheatsheet.md → Hooks bloquants & patterns
┃ ┃
┃ ┣━━ 📁 4-skills/
┃ ┃ ├── 📄 guide.md → Capacités spécialisées
┃ ┃ └── 📄 cheatsheet.md → Structure skills
┃ ┃
┃ ┣━━ 📁 5-mcp/
┃ ┃ ├── 📄 guide.md → Model Context Protocol
┃ ┃ └── 📄 cheatsheet.md → Serveurs populaires
┃ ┃
┃ ┣━━ 📁 6-agents/
┃ ┃ ├── 📄 guide.md → Sub-agents & orchestration
┃ ┃ └── 📄 cheatsheet.md → Agents built-in
┃ ┃
┃ ┣━━ 📁 7-plugins/
┃ ┃ ├── 📄 guide.md → Système d'extensibilité modulaire
┃ ┃ └── 📄 cheatsheet.md → Marketplaces & distribution
┃ ┃
┃ ┣━━ 📁 8-advanced/ 💪 GUIDES EXPERT
┃ ┃ ├── 📄 multi-dialog-patterns.md → Sequential, Conditional, Parallel
┃ ┃ ├── 📄 interactive-ui.md → AskUserQuestion workflows complexes
┃ ┃ ├── 📄 enterprise-patterns.md → Governance, RBAC, Compliance
┃ ┃ ├── 📄 ai-orchestration.md → Multi-LLM routing (70-85% cost)
┃ ┃ ├── 📄 decision-trees.md → Framework sélection features
┃ ┃ └── 📄 README.md → Navigation advanced
┃ ┃
┃ ┗━━ 📁 9-add-ons/ 🔧 EXTENSIONS OPTIONNELLES
┃ ┣━━ 📁 vs-code-extension/
┃ ┃ └── 📄 guide.md → Extension VS Code
┃ ┣━━ 📁 statusline/
┃ ┃ ├── 📄 guide.md → Dashboard temps réel
┃ ┃ └── 📄 cheatsheet.md → Templates & config
┃ └── 📄 README.md → Navigation add-ons
┃
┣━━ 📁 workflow-pattern-orchestration/ 🚀 ORCHESTRATION AVANCÉE
┃ ┣━━ 📁 workflows/ → EPCT, Parallel, Sequential, Hybrid
┃ ┣━━ 📁 patterns/ → Coordination, automation, orchestration
┃ ┣━━ 📁 best-practices/ → Performance, Cost, Resilience
┃ └── 📄 README.md → Navigation orchestration
┃
┣━━ 📁 ressources/ 📹📄 Vidéos & articles
┃ ┣━━ 📁 videos/
┃ ┃ ├── terminal-ai-workflow.md
┃ ┃ ├── skills-vs-mcp-vs-subagents.md
┃ ┃ └── 800h-claude-code-edmund-yong.md
┃ └── 📁 articles/
┃
┣━━ 📁 .claude/ ⚙️ Configuration projet
┃ ├── 📄 CLAUDE.md → Memory & règles projet
┃ └── 📁 commands/
┃
┗━━ 📄 README.md 📚 Ce fichier
🚀 Quick Start
1️⃣ Commencer Par Memory
Le foundation de tout projet Claude Code :
# Lire le guide
cat themes/1-memory/guide.md
# Référence rapide
cat themes/1-memory/cheatsheet.md
# Premier guide
cat themes/1-memory/guide.md
Pourquoi commencer ici ? Memory (.claude/CLAUDE.md) est la base pour persister vos préférences et instructions.
2️⃣ Suivre le Parcours Pédagogique
Progressez thème par thème dans l'ordre numéroté :
1-memory → 2-commands → 3-hooks → ... → 9-best-practices
Chaque thème s'appuie sur les précédents.
3️⃣ Pratiquer
Lisez les guides pour comprendre les concepts, puis utilisez les cheatsheets comme référence rapide.
🗺️ Navigation
🎯 Themes Core (Features Essentielles - 1 à 9)
Ordre pédagogique optimal :
| # | Thème | Description | Durée |
|---|---|---|---|
| 1️⃣ | Memory | Mémoire persistante (.claude/CLAUDE.md) | 1h |
| 2️⃣ | Commands | Commandes slash automatisées | 1.5h |
| 3️⃣ | Hooks | Automation lifecycle events | 1h |
| 4️⃣ | Skills | Capacités spécialisées auto-activées | 2h |
| 5️⃣ | MCP | Model Context Protocol integration | 1.5h |
| 6️⃣ | Agents | Sub-agents pour travail isolé | 1.5h |
| 7️⃣ | Plugins | Extensions modulaires combinées | 1h |
| 8️⃣ | Advanced | Guides expert (Multi-dialog, Interactive UI, Enterprise, AI Orchestration) | 4-6h |
| 9️⃣ | Add-ons | Extensions optionnelles (VS Code, Statusline) | 2h |
🎓 Parcours débutant : Maîtrise 1-7 (~8-10 heures) 🎓 Parcours expert : Thèmes 8-9 (~4-6 heures)
🚀 Orchestration Avancée
Workflow-Pattern-Orchestration
Coordination intelligente de Memory + Commands + Hooks + Skills + Agents + Plugins
📋 Workflows
- EPCT
- Parallel
- Sequential
- Conditional
- Hybrid
🏗️ Patterns
- Command coordination
- Hook automation
- Agent orchestration
- State management
⚡ Best Practices
- Performance
- Cost optimization
- Resilience
- Team collaboration
Exemples production :
- 🚀 200 locales generation (8.3x speedup)
- 👥 PR review automation (4 parallel agents)
- 📚 Documentation generator (Skills + MCP)
- 🏗️ Monorepo setup wizard (20+ decision branches)
🆕 Workflows Startup (Production-Ready) :
- 📝 Blog Automation - Pipeline complet création/publication (96% time reduction)
- 🌍 Multi-Language Content - 13-15 langues simultanées (99% time reduction)
- 📱 Social Media Automation - 5 plateformes multi-posts (86% time reduction)
- 👥 Community Management - Monitoring + auto-réponse (76% time reduction)
- ♻️ Content Repurposing - 1 contenu → 10+ formats (92% time reduction)
✅ Validation : Rapport de validation complet (100% conforme docs Anthropic)
🎓 Parcours intermédiaire → expert (~6-8 heures)
🎓 Thème 8 : Advanced (Expert)
Advanced - Guides Expert-Level
Guides niveau expert pour use cases complexes
- 🔀 Multi-Dialog Patterns - Sequential, Conditional, Parallel, Validation
- 💬 Interactive UI - AskUserQuestion workflows complexes
- 🏢 Enterprise Patterns - Governance, RBAC, Compliance (GDPR/SOC2)
- 🤖 AI Orchestration - Multi-LLM routing (70-85% cost savings)
- 🌳 Decision Trees - Framework complet de sélection features
🎓 Parcours expert (~4-6 heures)
🔧 Thème 9 : Add-ons (Optionnel)
Add-ons - Extensions Optionnelles
- 💻 VS Code Extension - Intégration IDE
- 📊 Statusline - Dashboard temps réel
🧭 Quel Outil Utiliser ?
🎯 Comprendre les Fondamentaux D'ABORD
"The prompt is the fundamental unit. Everything else is a wrapper." — Dan, Skills vs Commands vs Sub-Agents vs MCP
Commencez ICI : Core 4 & Fundamentals ⭐
Ce guide explique :
- ✅ The Core 4 : Context + Model + Prompt + Tools
- ✅ Pourquoi le prompt (command) est LA primitive
- ✅ Composition Hierarchy : Skills > MCP > Agents > Commands
- ✅ Agent-First vs Manual : LA distinction clé
Sans ça, vous serez perdu. Lisez d'abord, choisissez ensuite.
🔑 Decision Framework: Quelle Feature Utiliser ?
Question 1: Est-ce un workflow RÉPÉTITIF ?
├─ NON → Use /command (one-off task)
└─ OUI → Continue à Q2
Question 2: Voulez-vous un trigger AUTOMATIQUE ?
├─ NON → Use /command (YOU decide when)
└─ OUI → Use Skill (AGENT decides when)
Question 3: Besoin de données EXTERNES ?
└─ OUI → Skill + MCP
⚡ Quick Reference: Par Use Case
| Use Case | Feature | Trigger | Raison |
|---|---|---|---|
| One-off task | /command | 👤 Manual | Simple & explicit control |
| Repeat workflow (manual) | /command | 👤 Manual | You decide WHEN |
| Repeat workflow (auto) | Skill | 🤖 Auto | Agent decides WHEN |
| Domain knowledge | Skill | 🤖 Auto | Knowledge base + auto-invoke |
| External data | MCP | 🔀 Both | Live integrations |
| Parallel tasks | Sub-Agent | 🔀 Both | Isolated contexts |
| Compose commands | Skill | 🤖 Auto | Orchestration layer |
| Lifecycle automation | Hooks | ⚙️ Auto | Deterministic events |
| Package & share | Plugins | 📦 N/A | Distribution toolkit |
🎯 Golden Rule (Dan)
1. Start with /command (simple prompt)
2. Test & Validate
3. If repeat workflow → Compose to Skill
4. NEVER skip steps 1 & 2
📚 Pour Approfondir
- ⭐ Core 4 & Fundamentals - START HERE
- 📊 Decision Trees - Framework complet
- 🏗️ Patterns - Orchestration patterns
- 🚀 Workflows - Production-ready workflows
🗺️ Par Feature
| Feature | Description | Lien |
|---|---|---|
| Context permanent | Memory persistante | Memory |
| Prompt = Primitive | Base de tout | Commands ⭐ |
| Auto-invoked knowledge | Skills auto-activées | Skills |
| Lifecycle automation | Événements système | Hooks |
| External integration | Protocole MCP | MCP |
| Isolated context | Sub-agents | Agents |
| Package & distribute | Extensions modulaires | Plugins |
📊 Statistiques Documentation
| Métrique | Valeur |
|---|---|
| 📚 Themes | 9 (7 core + 1 advanced + 1 add-ons) |
| 🚀 Workflows | 5 production-ready startup |
| 🎓 Guides Advanced | 5 expert-level |
| 🏗️ Patterns | Orchestration complète |
| 📝 Documentation | ~450 KB |
| 🔗 Ressources | 60+ externes |
| 💾 Contenu | ~25,000 lignes pédagogiques |
| ⏱️ Temps total | 20-28 heures (débutant → expert) |
📚 Ressources Complémentaires
📄 Documentation Officielle
- 📄 Claude Code Docs
- 📄 Memory
- 📄 Commands
- 📄 Hooks
- 📄 MCP Protocol
- 📄 Plugins
🎥 Vidéos Analysées
Voir ressources/videos/ pour fiches complètes.
- 🎥 NetworkChuck - Terminal AI Workflow (33 min)
- 🎥 Solo Swift Crafter - Skills vs MCP vs Subagents (9 min)
- 🎥 Edmund Yong - 800h Claude Code (27 oct 2025)
📄 Articles Techniques 🆕
Voir ressources/articles/ pour fiches complètes.
- À venir - Documentation officielle
- À venir - Best practices communauté
- À venir - Guides techniques avancés
🔗 Repos Communautaires
🎓 Philosophie du Projet
Principes d'Apprentissage
- 📖 Progressivité : Du débutant à l'expert, pas de raccourcis
- 💡 Pratique : Exemples concrets, pas que théorie
- 🎨 Visuel : Schémas ASCII, emojis, clarté maximale
- 🇫🇷 Accessibilité : Français clair, exemples du quotidien
- 📚 Complétude : Tous les aspects de Claude Code couverts
- 🔄 Maintenu : À jour avec dernières versions
Quote Inspirante
"D.R.Y. (Don't Repeat Yourself) - Let Claude remember your preferences"
— Edmund Yong (800h Claude Code)
🤝 Contribution
Ce projet est personnel mais open source pour la communauté francophone.
Suggestions ? Ouvrez une issue ou PR !
📝 License
MIT License - Libre d'utilisation et modification
🚀 Bonne formation !
Commencez par themes/1-memory/guide.md 🎓
Made with ❤️ by @ThibautMelen • SuperNovae Studio