Imagine un promoteur qui débarque sur le terrain le premier matin et lance à son équipe : "Construisez quelque chose de sympa." Les ouvriers se regardent. L'un commence un mur au nord, l'autre creuse une cave au sud. Trois jours plus tard, il y a des briques partout, rien ne s'aligne, et personne ne sait où ça va. C'est exactement ce qui se passe quand on utilise l'IA sans méthode. Ça commence bien, ça impressionne les premières heures — et ça s'effondre dès qu'on veut vraiment construire quelque chose.
Dans cette fiche, tu comprends la différence entre "demander un truc à Claude" et "construire un projet avec Claude". Tu installes BMAD et tu rencontres ton équipe.
Tu peux demander à Claude de créer une app entière en une commande. Il va le faire. Et pendant vingt minutes, tu vas être blufé.
Puis tu demandes une modification. Claude casse ce qu'il avait fait avant. Tu en demandes une autre. Elle entre en conflit avec la première. Au bout de deux jours, tu as des fichiers partout, du code que personne ne comprend, et Claude qui contredit ses propres décisions d'hier.
Voilà ce que ça donne en pratique :Toi : "Crée-moi une app de gestion de tâches avec authentification, base de données, Kanban, mode sombre et notifications push."
Claude : (génère 47 fichiers en 90 secondes)
Toi : "Maintenant ajoute un système de tags."
Claude : (modifie les fichiers, casse l'authentification)
Toi : "Tu viens de casser la connexion."
Claude : "Je vais corriger ça." (écrase les fichiers de base de données)
Phase 1 : Tu clarifies ce que tu veux construire exactement, avec Claude qui pose les bonnes questions. Résultat : un brief clair.
Phase 2 : Tu listes les fonctionnalités, tu dessines les plans techniques. Résultat : une architecture solide.
Phase 3 : Tu construis une fonctionnalité à la fois, tu valides chaque étape. Résultat : une app qui tient debout.
La différence n'est pas dans la puissance de l'IA. Elle est dans la façon dont tu organises le travail.
Il existe un framework qui structure exactement cette façon de travailler : BMAD. Quatre phases dans un ordre précis — on ne pose pas les briques avant d'avoir les plans.
Tu n'as pas besoin de tout retenir maintenant. Ce qui compte : installer l'outil, initialiser le projet, et avancer.
Lance Claude Code si ce n'est pas déjà fait (claude dans le terminal), puis tape :
L'installateur va te poser quelques questions. Accepte les options par défaut en appuyant sur Entrée.
Une fois terminé, un dossier _bmad/ apparaît dans ton projet. C'est là que vivent les règles du jeu.
C'est le framework. Si tu modifies son contenu, tes agents risquent de se comporter de façon imprévisible.
Dans Claude Code, tape :
Claude va te poser quelques questions pour configurer ton projet : nom, description, type d'application. Réponds naturellement, en français.
Une structure de dossiers apparaît dans ton projet. C'est le squelette de ton chantier : les emplacements où chaque document ira vivre au fur et à mesure.
Dans Claude Code, tu vas utiliser deux familles de commandes. C'est utile de les distinguer dès maintenant :
| Type | Syntaxe | Exemples | Toujours disponible ? |
|---|---|---|---|
| Commandes natives | /commande | /clear, /rewind, /compact | Oui — intégrées dans Claude Code |
| Skills BMAD | /workflow-xxx | /workflow-init, /workflow-status, /create-product-brief | Après installation de BMAD |
Les commandes natives sont là de base, comme les phares et le klaxon de ton atelier. Les skills BMAD sont des outils spécialisés que tu viens d'installer dans le coffre.
Vérifie que le dossier _bmad/ existe dans ton projet. Si non, relance npx bmad-method@alpha install.
Claude Code est un collaborateur polyvalent. Mais selon la casquette qu'il met, il adopte un rôle différent. BMAD organise ça en agents — chacun a son domaine d'expertise.
Tu les rencontreras un par un quand tu en auras besoin. Voici la vue d'ensemble :
| Agent | Métaphore | Ce qu'il fait |
|---|---|---|
| Analyst | Le géomètre | Étudie le terrain, clarifie ton idée |
| PM | Le chef de projet | Traduit ta vision en fonctionnalités concrètes |
| UX Designer | Le décorateur | Conçoit l'expérience utilisateur |
| Architect | L'architecte | Dessine les plans techniques |
| SM | Le chef de chantier | Organise le travail en sprints |
| Dev | L'ouvrier qualifié | Écrit le code, fonctionnalité par fonctionnalité |
Et toi ? Tu es le maître d'ouvrage. Tu as la vision, tu valides le travail, tu prends les décisions. Tu ne dis jamais à un agent comment faire — tu lui dis ce que tu veux.
À tout moment, si tu ne sais plus où tu en es dans le processus, tape :
Cette commande t'affiche l'état du projet : quelle phase est en cours, quels documents ont été produits, ce qu'il reste à faire. Quand tu es perdu, elle te remet sur le chemin.
| Symptôme | Cause probable | Solution |
|---|---|---|
| npx: command not found | Node.js n'est pas installé | Installe Node.js depuis nodejs.org, redémarre Cursor |
| npm ERR! network | Pas de connexion internet | Vérifie ta connexion et réessaie |
| Le dossier _bmad/ n'apparaît pas | Installation échouée silencieusement | Relance la commande et lis les messages d'erreur |
| permission denied | Droits insuffisants | Sur Mac : ajoute sudo devant la commande |
| /workflow-init n'est pas reconnu | BMAD n'est pas installé | Relance npx bmad-method@alpha install |
| Claude ne reconnaît pas la commande | Claude Code n'est pas actif | Vérifie que tu vois le prompt > — si non, tape claude d'abord |
| Erreur pendant l'initialisation | Conflit avec des fichiers existants | Essaie dans un dossier vide ou tape /rewind pour annuler |
Le cadre est là, l'équipe est prête. Mais avant de leur confier le premier vrai travail, il y a quelque chose que tu dois maîtriser : comment parler à Claude pour obtenir ce que tu veux, sans te retrouver dans une conversation qui tourne en rond.
-> Fiche suivante : Travailler avec Claude