claude-insane-guide— agent skill

<div align="center">

╔═════════════════════════════════════════════════════════════════════════════════╗
║                                                                                 ║
║           ★  ✨  ⭐  ✨  ★  ✨  ⭐  ✨  ★  ✨  ⭐  ✨  ★                        ║
║                                                                                 ║
║      ██████╗██╗      █████╗ ██╗   ██╗██████╗ ███████╗                         ║
║     ██╔════╝██║     ██╔══██╗██║   ██║██╔══██╗██╔════╝                         ║
║     ██║     ██║     ███████║██║   ██║██║  ██║█████╗                           ║
║     ██║     ██║     ██╔══██║██║   ██║██║  ██║██╔══╝                           ║
║     ╚██████╗███████╗██║  ██║╚██████╔╝██████╔╝███████╗                         ║
║      ╚═════╝╚══════╝╚═╝  ╚═╝ ╚═════╝ ╚═════╝ ╚══════╝                         ║
║                                                                                 ║
║                 ██╗███╗   ██╗███████╗ █████╗ ███╗   ██╗███████╗               ║
║                 ██║████╗  ██║██╔════╝██╔══██╗████╗  ██║██╔════╝               ║
║                 ██║██╔██╗ ██║███████╗███████║██╔██╗ ██║█████╗                 ║
║                 ██║██║╚██╗██║╚════██║██╔══██║██║╚██╗██║██╔══╝                 ║
║                 ██║██║ ╚████║███████║██║  ██║██║ ╚████║███████╗               ║
║                 ╚═╝╚═╝  ╚═══╝╚══════╝╚═╝  ╚═╝╚═╝  ╚═══╝╚══════╝               ║
║                                                                                 ║
║                        🎯 GUIDE COMPLET & MAÎTRISE 🎯                          ║
║                                                                                 ║
║           ★  ✨  ⭐  ✨  ★  ✨  ⭐  ✨  ★  ✨  ⭐  ✨  ★                        ║
║                                                                                 ║
╚═════════════════════════════════════════════════════════════════════════════════╝

<h1>📚 Guide Claude Code - Formation Complète</h1>

<p> <strong>Formation progressive pour maîtriser Claude Code</strong><br> De débutant à expert • 100% Français • Production-Ready </p>

<!-- Badges --> <p> <img src="https://img.shields.io/badge/langue-français-blue?style=for-the-badge" alt="Langue"> <img src="https://img.shields.io/badge/niveau-débutant_→_expert-green?style=for-the-badge" alt="Niveau"> <img src="https://img.shields.io/badge/durée-20--28h-orange?style=for-the-badge" alt="Durée"> <img src="https://img.shields.io/badge/license-MIT-purple?style=for-the-badge" alt="License"> </p>

<p> <img src="https://img.shields.io/badge/themes-9_core-brightgreen?style=flat-square" alt="Themes"> <img src="https://img.shields.io/badge/workflows-5_production-blue?style=flat-square" alt="Workflows"> <img src="https://img.shields.io/badge/docs-~450KB-yellow?style=flat-square" alt="Documentation"> <img src="https://img.shields.io/badge/ressources-60+-red?style=flat-square" alt="Ressources"> </p>

<!-- Quick Navigation --> <p> <a href="#-commencez-ici"><strong>🚀 Quick Start</strong></a> • <a href="#-parcours-dapprentissage"><strong>🗺️ Parcours</strong></a> • <a href="#-navigation"><strong>📖 Navigation</strong></a> • <a href="#-quel-outil-utiliser-"><strong>🧭 Decision Framework</strong></a> • <a href="#-ressources-complémentaires"><strong>📚 Ressources</strong></a> </p>

<!-- Status --> <p> <img src="https://img.shields.io/badge/status-✅_actif-success?style=flat-square" alt="Status"> <img src="https://img.shields.io/badge/dernière_maj-2025-informational?style=flat-square" alt="Update"> <img src="https://img.shields.io/badge/claude_sonnet-4.5-blueviolet?style=flat-square" alt="Claude Version"> </p>

</div>

🚀 COMMENCEZ ICI

<div align="center">

👋 Nouveau sur Claude Code?

Lisez ceci en PREMIER (5 minutes) :

📄 [QUICK START : Claude Code en 5 Minutes](QUICK-START.md) ⭐

</div>

✅ 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](themes/8-advanced/core-4-fundamentals.md) (30 min)

• Framework Dan complet (THE REFERENCE)
• Comprendre POURQUOI avant COMMENT

🎯 [Decision Trees](themes/8-advanced/decision-trees.md) (20 min)

• Choisir la bonne feature pour chaque situation

🎯 À Propos

<table> <tr> <td width="50%">

📖 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.

</td> <td width="50%">

🆕 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

</td> </tr> </table>

📖 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

<details> <summary><strong>📂 Cliquez pour voir l'arborescence complète</strong></summary>

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

</details>

🚀 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.

<table> <tr> <td>📚 <strong>Guide complet</strong></td> <td>Théorie + exemples concrets</td> </tr> <tr> <td>⚡ <strong>Cheatsheet</strong></td> <td>Référence rapide pour usage quotidien</td> </tr> </table>

🗺️ Navigation

🎯 Themes Core (Features Essentielles - 1 à 9)

Ordre pédagogique optimal :

<div align="center">

🎓 Parcours débutant : Maîtrise 1-7 (~8-10 heures) 🎓 Parcours expert : Thèmes 8-9 (~4-6 heures)

</div>

🚀 Orchestration Avancée

#### Workflow-Pattern-Orchestration Coordination intelligente de Memory + Commands + Hooks + Skills + Agents + Plugins

<table> <tr> <td width="33%">

📋 Workflows

• EPCT
• Parallel
• Sequential
• Conditional
• Hybrid

</td> <td width="33%">

🏗️ Patterns

• Command coordination
• Hook automation
• Agent orchestration
• State management

</td> <td width="33%">

⚡ Best Practices

• Performance
• Cost optimization
• Resilience
• Team collaboration

</td> </tr> </table>

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)

<div align="center">

✅ Validation : Rapport de validation complet (100% conforme docs Anthropic)

🎓 Parcours intermédiaire → expert (~6-8 heures)

</div>

🎓 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

<div align="center">

"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 ⭐

</div>

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 ?

<details> <summary><strong>📊 Arbre de décision complet</strong></summary>

#### 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

</details>

⚡ Quick Reference: Par Use Case

🎯 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

📊 Statistiques Documentation

<div align="center">

</div>

📚 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

• 🔗 Weston Hobson Commands
• 🔗 Edmund Yong Setup
• 🔗 Awesome Sub-Agents

🎓 Philosophie du Projet

<table> <tr> <td width="50%">

Principes d'Apprentissage

1. 📖 Progressivité : Du débutant à l'expert, pas de raccourcis
2. 💡 Pratique : Exemples concrets, pas que théorie
3. 🎨 Visuel : Schémas ASCII, emojis, clarté maximale
4. 🇫🇷 Accessibilité : Français clair, exemples du quotidien
5. 📚 Complétude : Tous les aspects de Claude Code couverts
6. 🔄 Maintenu : À jour avec dernières versions

</td> <td width="50%">

Quote Inspirante

"D.R.Y. (Don't Repeat Yourself) - Let Claude remember your preferences"

>

— Edmund Yong (800h Claude Code)

</td> </tr> </table>

🤝 Contribution

Ce projet est personnel mais open source pour la communauté francophone.

Suggestions ? Ouvrez une issue ou PR !

📝 License

<div align="center">

MIT License - Libre d'utilisation et modification

</div>

<div align="center">

🚀 Bonne formation !

Commencez par themes/1-memory/guide.md 🎓

_{Made with ❤️ by <a href="https://github.com/ThibautMelen">@ThibautMelen</a> • <a href="https://github.com/SuperNovae-studio">SuperNovae Studio</a>}

</div>