Espace ou pour naviguer
Guide Dirigeants — Claude Code
1 / 15
Guide Dirigeants — Claude Code × MAGIPA

Ton prochain
collaborateur
travaille 24h/24.

Tu passes des heures sur des tâches qui se répètent. Claude Code automatise tout ça — et MAGIPA te montre comment en tirer toute la valeur.

4
Phases pour maîtriser
7k+
Skills déjà créés
×10
Productivité visée
01 — Comprendre

C'est quoi Claude Code,
concrètement ?

Un agent autonome qui agit dans ton environnement de travail : il lit tes fichiers, exécute des actions, appelle tes outils, et apprend tes habitudes.

Il agit, il n'attend pas

"Génère le brief pour Dupont avec les infos du mail" — il le fait. Zéro copier-coller.

🧠

Il a de la mémoire — pour toujours

CLAUDE.md stocke tes règles une fois. Il les respecte indéfiniment, sans rappel.

🔧

Les Skills = tes recettes

Tu codifies tes process une fois — Claude les exécute parfaitement à chaque fois.

🔗

Les Hooks = tes réflexes

Auto-formater, bloquer, alerter. Configure une fois, ça tourne seul.

01 — Comprendre

L'anatomie de Claude Code

Pense à Claude Code comme un corps humain. Clique sur un organe pour découvrir sa fonction.

🧠
💪
👁
🤝

Clique sur un organe

Chaque partie du corps représente un composant clé de Claude Code.

Cerveau — CLAUDE.md = Mémoire long-terme
Muscles — Skills = Mémoire musculaire
Réflexes — Hooks = Automatismes
Les sens — MCP Servers = Perception
Équipe — Subagents = Membres autonomes
🧠 Le cerveau

CLAUDE.md

Mémoire persistante chargée à chaque session

C'est la mémoire long-terme. Comme ton cerveau stocke tes souvenirs, CLAUDE.md stocke tes règles, tes préférences, ton contexte métier. Tu écris une fois — il s'en souvient à chaque session, pour toujours.

💪 Les muscles

Skills

Workflows réutilisables invoqués à la demande

Ta mémoire musculaire. Quand tu sais faire du vélo, tu ne réfléchis plus. Les Skills c'est pareil : tu codifies tes process une fois (/brief-client), Claude les exécute parfaitement à chaque fois.

⚡ Les réflexes

Hooks

Checks automatiques qui se déclenchent seuls

Quand tu touches un truc brûlant, ta main recule avant que tu y penses. Les Hooks : auto-formater, bloquer les modifications critiques, envoyer un résumé. Configure une fois — ça reste actif pour toujours.

👁 Les sens

MCP Servers

Connexions live à tes outils externes

Les organes sensoriels : "voir" dans Notion, "entendre" Slack, "toucher" HubSpot. Sans eux, Claude est aveugle — avec eux, il accède à tout ton environnement en temps réel.

🤝 Les membres

Subagents

Workers délégués pour les tâches parallèles

Tes bras, tes jambes — chaque membre agit de façon semi-autonome. Les Subagents sont des mini-Claude spécialisés : commercial IA, analyste, assistant RH. Chacun sa mémoire, ses règles. Plus tu les utilises, meilleurs ils deviennent.

01 — Comprendre

Où tu en es — et
où tu vas aller.

Ton niveau de maturité IA avec Claude Code
Niveau 0
Prompts manuels, zéro mémoire
Niveau 1
CLAUDE.md basique + /init
Niveau 2
Skills simples + contexte
Niveau 3
Hooks + skills chaînés
Expert ← objectif
Subagents + compounding
J'ai besoin de savoir coder ?+
Non. Les Skills sont en Markdown — du texte structuré. Tu décris tes étapes comme pour un collaborateur humain.
Combien de temps pour les premiers résultats ?+
Dès la première semaine. Ta tâche de 2h/semaine peut passer à 10 minutes.
Ça marche avec Notion, HubSpot, Gmail ?+
Oui, via les MCP servers. Notion, Drive, HubSpot, Gmail, Slack et bien d'autres.
Qu'est-ce que MAGIPA fait ?+
La configuration à ta place. Tes process, tes Skills sur-mesure, tes outils connectés.
02 — Architecture

Comment c'est organisé
sous le capot.

Global → projet → règles → tâches → gardes-fous. Chaque couche a son rôle.

ARCHITECTURE
Global
~/.claude/CLAUDE.md — Préférences universelles
Projet
./CLAUDE.md — Règles spécifiques client/projet
Rules
./.claude/rules/ — Fichiers thématiques (@import)
Skills
./.claude/skills/ — Workflows codifiés (/nom)
Hooks
./.claude/hooks/ — Pre/Post action scripts
⚠️ La règle des 150 instructions

CLAUDE.md doit rester sous 150 instructions. Plus c'est long, moins Claude est précis. CLAUDE.md = sommaire, rules = chapitres.

02 — Architecture

Exemple de CLAUDE.md

CLAUDE.md
# CLAUDE.md — Exemple pour un dirigeant PME @import .claude/rules/style-communication.md @import .claude/rules/process-commercial.md @import .claude/rules/outils-integres.md ## Mon activité Je dirige une PME de 12 personnes dans le BTP. Clients : collectivités et promoteurs. Territoire : Réunion. Langue : français. Ton : direct, pro, sans jargon. ## Comportements attendus - Propose toujours une version "rapide" et une "robuste" - Format : titre clair + 3 points max + next step - Ne modifie jamais un fichier client sans confirmation - En fin de tâche : résume en 2 phrases ## Definition of done - Le livrable est complet et auto-suffisant - Nommé : CLIENT_DATE_TYPE.md
03 — Roadmap
01
Semaine 1

Foundation — Poser les bases

Objectif de la semaine : un seul skill qui fonctionne à la perfection. Pas dix. Un. Testé cinq fois, affiné à chaque tour.

Jour 1–2 — Init
Lance /init et configure CLAUDE.md
C'est la commande fondatrice. Elle génère toute l'arborescence de fichiers. Ouvre ensuite CLAUDE.md et écris 5 à 10 règles qui te définissent : ton métier, ta façon de parler, tes clients. Ces règles seront respectées à chaque session sans rappel.
Jour 2–3 — Audit
Identifie tes 3 tâches les plus répétitives
Prends un carnet. Note les 3 tâches que tu fais toutes les semaines : rédiger un brief, envoyer un rapport, qualifier un prospect, répondre à un appel d'offres. Chronomètre-toi. C'est ton gisement de productivité — la première à automatiser vaut souvent 2 à 4h/semaine.
Jour 3–4 — Build
Crée ton premier skill à la main
Choisis la tâche la plus simple et la plus fréquente. Écris le skill en 3 blocs : les inputs nécessaires, les étapes à suivre, et le format de sortie attendu. Pas besoin d'être parfait — juste fonctionnel. Tu affineras ensuite.
Jour 4–5 — Refine
Teste-le 5 fois, note chaque problème
À chaque test, note ce qui a cloché : une étape manquante, un format pas respecté, un cas particulier oublié. Ajoute une règle dans le skill pour chaque erreur. Après 5 itérations, ton skill tourne de façon fiable dans 90% des cas.
💡 Astuce concrète

Le test du "stagiaire" : avant de codifier ton skill, explique-le à voix haute comme si tu formais quelqu'un de nouveau. Si tu hésites, c'est qu'il manque une étape. Si tu dis "ça dépend", c'est qu'il faut ajouter une condition. Ce test oral transforme un skill moyen en skill solide.

  • J'ai lancé /init et configuré mon CLAUDE.md avec 5+ règles personnelles
  • J'ai identifié et chronométré mes 3 tâches les plus répétitives
  • J'ai créé mon premier skill (inputs → steps → output → done)
  • J'ai testé 5 fois et corrigé à chaque itération
  • Mon skill tourne seul sur un cas réel sans intervention de ma part
03 — Roadmap
02
Semaine 2

Context Layer — Le rendre intelligent

Tes skills deviennent contextuels. Claude sait qui sont tes clients, tes standards, tes outils — sans que tu redonnes le briefing à chaque session.

Jour 1–2 — Hiérarchie mémoire
Organise préférences globales et par projet
CLAUDE.md racine = tes préférences universelles (ton, langue, habitudes). Dans chaque dossier client, un CLAUDE.md local avec les spécificités de ce projet : stack technique, interlocuteurs, contraintes. Claude charge automatiquement le bon contexte selon où tu travailles.
Jour 2–3 — Modularité
Un fichier = un sujet
Crée .claude/rules/style-communication.md, process-commercial.md, clients-actifs.md. Commence par un seul. Cette modularité rend le système maintenable : tu modifies le style de communication sans toucher aux process commerciaux. Chaque fichier est réutilisable d'un projet à l'autre.
Jour 3–4 — @imports
CLAUDE.md court = Claude précis
Utilise @import pour lier tes fichiers de règles au CLAUDE.md principal. Le fichier reste court (le sommaire), les détails vivent dans les fichiers importés. Résultat : moins de tokens consommés = Claude plus rapide, plus précis, moins cher par session.
Jour 4–5 — Connecte ton premier MCP
Notion, Drive, HubSpot ou Gmail
Choisis l'outil que tu utilises le plus. Un MCP connecté signifie que Claude peut lire et écrire directement dedans. "Crée la fiche client Dupont dans HubSpot" fonctionne en une commande. Plus de copier-coller entre tes outils.
💡 Astuce concrète

Le test du "nouveau projet" : crée un nouveau dossier client, lance Claude dessus, et vérifie qu'il charge automatiquement le bon contexte. S'il te demande "quelle est ton activité ?", c'est que ta hiérarchie n'est pas bien configurée. Le but : zéro briefing à chaque démarrage de session.

  • CLAUDE.md racine configuré avec mes préférences universelles
  • Au moins 1 fichier de rules thématique créé (.claude/rules/)
  • @imports fonctionnels dans mon CLAUDE.md principal
  • Un MCP connecté et testé (Notion, Drive, ou HubSpot)
  • Mon skill de semaine 1 fonctionne avec le contexte enrichi
03 — Roadmap
03
Semaine 3

Quality Gates — Sécuriser et chaîner

Tu mets des filets de sécurité et tu chaînes tes premiers workflows. C'est la semaine où tu commences à vraiment déléguer à la machine.

Jour 1–2 — Post-hooks
Automatise l'après-action
Après chaque génération de document, Claude auto-formate selon tes standards (nommage, structure, ton) et envoie un résumé dans Notion ou un canal Slack. Tu ne vérifies plus le formatage — chaque livrable sort conforme automatiquement. Un gain invisible mais massif sur la durée.
Jour 2–3 — Pre-hooks
Installe tes gardes-fous de sécurité
Claude ne peut pas : supprimer un fichier client, modifier des données financières, toucher à la prod sans ta validation explicite. Avec disable-model-invocation, tu contrôles quels skills Claude peut lancer seul et lesquels nécessitent ton feu vert. Tu dors tranquille.
Jour 3–4 — Chaîne 2 skills
Crée ton premier mini-workflow
Exemple : /qualifier-prospect → récupère les infos mail → crée la fiche CRM → génère le brief → planifie le call. Du premier contact au démarrage projet en une seule commande. Ce qui prenait 3h se fait en 5 minutes — et sans oubli.
Jour 4–5 — Adapte un skill existant
Profite des 7 000+ skills communautaires
Va sur skillhub.club : 7 000+ skills créés par d'autres dirigeants et développeurs. Trouve un pattern proche de ton besoin, copie-le, adapte-le à tes spécificités. Tu économises des heures de tâtonnement en partant d'un skill déjà éprouvé par la communauté.
💡 Astuce concrète

Le "garde-fou du vendredi" : chaque vendredi, revois les 5 dernières actions que Claude a exécutées dans la semaine. Demande-toi : "Y en a-t-il une qui aurait pu causer un problème si elle avait mal tourné ?". Si oui, ajoute un pre-hook de sécurité. Cette habitude hebdomadaire rend ton système bullet-proof en quelques semaines.

  • Un post-hook fonctionnel (auto-format + notification)
  • Au moins 1 pre-hook de sécurité configuré (blocage fichiers critiques)
  • Deux skills chaînés en un mini-workflow fonctionnel
  • Un skill adapté depuis skillhub.club ou la communauté
  • disable-model-invocation activé sur les skills sensibles
03 — Roadmap
04
Semaine 4

Compounding — Le système s'améliore seul

Tout devient exponentiel. Le système apprend de son propre travail. Tu travailles moins qu'en semaine 1 — et tu produis davantage.

Jour 1–2 — Skill /learn
Claude fait son propre retour d'expérience
Après chaque tâche terminée, Claude se pose 3 questions automatiquement : qu'est-ce qui a marché ? Qu'est-ce qui a raté ? Quelles nouvelles règles ajouter ? Il génère max 5 points d'amélioration et les ajoute à la mémoire. Le système grandit sans que tu interviennes.
Jour 2–3 — /review systématique
Zéro livrable non vérifié
Avant chaque envoi client : Claude vérifie l'exactitude des faits, la complétude du livrable, le respect du ton, le formatage. Tu gardes le contrôle qualité sans vérifier chaque ligne. Tu valides le résultat — tu n'exécutes plus le contrôle.
Jour 3–4 — Scale everywhere
Duplique et adapte en 5 minutes
Le skill commercial qui marche ? Adapte-le pour le recrutement en changeant juste les inputs et le template de sortie. Le workflow prospect → brief ? Duplique-le pour l'onboarding ou les rapports mensuels. Chaque nouvelle itération te coûte 10× moins d'effort que la première.
Jour 4–5 — Premier subagent
Ton "bras droit" IA spécialisé
Un agent avec sa propre mémoire et ses propres skills : ton commercial IA, ton analyste IA, ton assistant admin. Chacun a son contexte dédié, ses règles, ses accès MCP. Plus tu l'utilises, mieux il te connaît. Après un mois, il connaît tes patterns mieux qu'un nouveau collaborateur.
💡 Astuce concrète

Le "journal de bord IA" : crée un fichier .claude/learnings.md que Claude met à jour automatiquement. Chaque semaine, relis les 5 derniers apprentissages. Tu verras le système devenir plus intelligent semaine après semaine — et tu découvriras des patterns que tu n'aurais jamais vus toi-même.

  • Skill /learn configuré et fonctionnel après chaque tâche
  • /review actif avant chaque livraison client
  • Au moins 2 skills existants dupliqués et adaptés à d'autres contextes
  • Un subagent spécialisé configuré avec sa propre mémoire
  • Mon fichier learnings.md contient au moins 10 apprentissages
04 — Skills

Comment créer un skill
de A à Z.

Un skill, c'est un workflow formalisé par écrit. Si tu peux l'expliquer en étapes claires à quelqu'un, tu peux en faire un skill. Voici la méthode complète.

Étape 1 — Le frontmatter (les paramètres de contrôle)

Chaque skill commence par un bloc entre ---. C'est le panneau de commande : sans lui, ton skill est une recette sans casserole.

frontmatter
--- name: brief-client # Ce que tu tapes : /brief-client description: Génère un brief projet complet. # CRUCIAL : Claude lit ça pour savoir QUAND l'invoquer allowed-tools: Read, Write, mcp__notion__create_page # Whitelist stricte = sécurité model: claude-sonnet-4-5 # Sonnet=standard, Opus=analyses lourdes ---

Étape 2 — La structure du skill (5 blocs)

Les 5 blocs obligatoires

  • Inputs — Ce que Claude doit collecter AVANT de démarrer. S'il manque une info, il la demande — il ne devine pas.
  • Steps — Les étapes numérotées. Actions précises et vérifiables. Jamais "faire quelque chose" — toujours "Reformuler l'objectif en une phrase".
  • Output — Le format exact du livrable : structure, longueur, ton, style.
  • Self-check — Les 3 à 5 critères que Claude vérifie LUI-MÊME avant de te livrer.
  • Definition of done — Les conditions pour que la tâche soit 100% terminée.

Les pièges à éviter

  • Trop vague → "Rédige un bon rapport" ne suffit pas. Précise : structure, ton, longueur, destinataire.
  • Trop long → Un skill > 150 lignes perd Claude. Découpe en sous-skills si besoin.
  • Pas de self-check → Sans vérification auto, tu deviens le contrôle qualité. C'est ça que tu veux éviter.
  • Description floue → La description du frontmatter détermine QUAND Claude propose le skill. Plus c'est précis, mieux il choisit.
  • Jamais testé → Un skill non testé est un skill qui va te décevoir au pire moment.

Étape 3 — Par où commencer ? (les 4 skills à créer en premier)

Pour un dirigeant de TPE ou PME, le ROI immédiat se trouve dans ces 4 catégories :

Skill #1
/brief-projet
Génère un brief structuré à partir d'un premier échange client. Regroupe objectifs, contraintes, livrables, planning. Évite les allers-retours et les oublis.
Skill #2
/rapport-mensuel
Automatise tes reportings récurrents. Claude consolide les données, produit le rapport au bon format, et te l'envoie. Ce qui prenait 3h se fait en 10 min.
Skill #3
/qualifier-lead
Analyse un prospect avant le premier appel. Évalue le potentiel, prépare les questions à poser, identifie les signaux d'alerte. Tu décroches le téléphone préparé.
Skill #4
/propale
Génère une proposition commerciale personnalisée à partir du brief. Respecte ta structure, ton ton, tes tarifs. Le client reçoit un document pro en une fraction du temps habituel.
✅ Ta checklist "skill prêt à lancer"

Avant de considérer un skill comme terminé, vérifie ces 5 points :

  • Le frontmatter est complet (name, description, allowed-tools, model)
  • Chaque étape est numérotée et sans ambiguïté
  • Le skill a un self-check avec au moins 3 critères
  • Tu l'as testé 5 fois sur des cas réels différents
  • Un collègue non-technique comprend le skill en le lisant
04 — Skills

Exemple complet : /brief-projet

.claude/skills/brief-projet.md
--- name: brief-projet description: Génère un brief projet complet et actionnable. À invoquer après un premier échange client. allowed-tools: Read, Write, mcp__notion__create_page model: claude-sonnet-4-5 --- ## Inputs requis Avant de démarrer, demande si tu n'as pas déjà : - Nom du client + secteur d'activité - Objectif principal du projet (1 phrase, sans jargon) - Budget approximatif et deadline - Contraintes connues (techniques, légales, humaines) ## Steps 1. Reformuler l'objectif : "Tu veux X pour atteindre Y d'ici Z" — valider 2. Identifier les 3 risques principaux — ni plus, ni moins 3. Proposer 2 approches avec trade-offs (rapide vs robuste) 4. Générer le brief : contexte → enjeux → livrables → jalons 5. Self-check : le client peut-il valider sans appel supplémentaire ? ## Definition of done - [ ] Objectif reformulé et sans ambiguïté - [ ] Livrables listés avec dates et responsables - [ ] Budget réparti par phase - [ ] Prochain step avec date et responsable nommé - [ ] Fichier créé dans Notion : CLIENT_DATE_brief.md
💡

Le workflow qui change tout

Chaîne /brief-projet → /propale → /planifier-kick-off. Une seule commande : du premier échange au démarrage projet. Ce qui prenait une demi-journée se fait en 15 minutes, sans oubli, sans erreur de format.

05 — Anti-patterns

Les 10 erreurs qui font
perdre des heures.

Ces erreurs, tout le monde les fait. Si tu les évites, tu gagnes 2 à 3 semaines de tâtonnement.

L'erreurComment l'éviter
1. Tout mettre dans CLAUDE.md
Ex : un fichier de 400 lignes → Claude hallucine, oublie des règles en fin de contexte, réponses incohérentes.
@imports + .claude/rules/. CLAUDE.md = sommaire. Sous 150 instructions, règle absolue.
2. Automatiser avant de faire soi-même
Ex : tu crées un skill de propale sans jamais avoir fait une propale complète toi-même → le skill automatise tes erreurs et oublis.
Fais la tâche 3× à la main. Note les étapes, les exceptions, les cas tordus. Ensuite seulement, codifie.
3. Ignorer les 7 000 skills existants
Ex : tu passes 4h à créer un skill de reporting alors qu'un modèle testé existe déjà sur skillhub.club.
10 min sur skillhub.club avant chaque création. Copie, adapte, gagne du temps.
4. Pas de garde-fous
Ex : Claude supprime par erreur un dossier client parce que rien ne l'en empêchait. Pas de filet = risque réel.
Pre-hooks de sécurité + disable-model-invocation sur toute action sensible.
5. Pas de context fork
Ex : après un long output, Claude "oublie" tes règles de formatage → le livrable suivant est hors standard.
Fork le contexte pour les outputs longs. Nouveau contexte = Claude repart frais.
6. Règles critiques seulement dans CLAUDE.md
Ex : "toujours formater en markdown" écrit dans CLAUDE.md mais pas dans un hook → oublié 1 fois sur 3.
Ce qui doit arriver à CHAQUE fois → ça va dans les Hooks. Pas de dépendance à la mémoire.
7. Ne pas tester ses skills suffisamment
Ex : tu crées un skill, tu le testes 1 fois, ça marche, tu passes à autre chose → il échoue sur un cas client réel et tu perds ta crédibilité.
5 tests minimum sur des cas variés. Note chaque problème, corrige, re-teste. Pas de raccourci.
8. Créer des skills et ne jamais les utiliser
Ex : tu crées 8 skills en 2 semaines, tu en utilises 2, les 6 autres sont oubliés. Temps perdu, aucun ROI, frustration.
Crée 1 skill à la fois. Utilise-le 10 fois avant d'en créer un autre. Force le réflexe : affiche un post-it "Pense à /brief-projet".
9. Hyper-systématiser sans agir
Ex : tu passes 3 jours à organiser parfaitement ton architecture .claude/ alors qu'aucun skill ne tourne encore. Procrastination productive.
Règle 80/20 : un skill imparfait qui tourne vaut mieux qu'une architecture parfaite sans aucun usage. Agis d'abord, organise ensuite.
10. Ne pas adapter les skills après les premières utilisations
Ex : ton skill /rapport-mensuel tourne depuis 6 semaines sans modification → il ne reflète plus ta façon de travailler, les livrables dérivent.
Kaizen IA : chaque vendredi, ouvre ton skill le plus utilisé et demande-toi "qu'est-ce qui pourrait être mieux ?". 5 min/semaine = amélioration continue.
06 — Ressources

Tout ce dont tu as besoin.

Documentation officielle
📌 GitHub — Les repos essentiels

awesome-claude-codeawesome-agent-skills (200+) — second-brain-skillsanthropics/skills (officiel). Pour les équipes : les Plugins bundlent skills, hooks, agents et configs MCP en un seul paquet distribuable.

Prochaine étape

Tu veux aller plus vite ?
Tu veux aller plus loin ?

Deux façons de passer à l'action — choisis celle qui correspond à ton rythme.

🎁 Gratuit — PDF complet
Télécharge le Playbook "4 Semaines"

Roadmap complète avec checklists détaillées, 4 templates de skills prêts à copier-coller, astuces concrètes, et les 10 anti-patterns à éviter. Change tes opérations en 4 semaines.

📥 Télécharger le playbook gratuitement
🤝 Accompagnement sur-mesure
Une équipe d'experts s'en charge pour toi

Coaching personnalisé. On analyse tes process, on construit tes Skills sur-mesure, on connecte tes outils. Tu te concentres sur ton business — on gère l'IA.

Martin Girard
Martin Girard Fondateur & CEO — MAGIPA Consulting
Transformation digitale & IA pour TPE/PME
🇫🇷 France — 📍 La Réunion — 2026