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 un framework de travail 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 bluffé.
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 :
| Sans méthode | Avec méthode |
|---|---|
| Toi : "Crée-moi une app de gestion de tâches avec auth, Kanban, mode sombre et notifications." | Phase 1 : Tu clarifies ce que tu veux construire exactement, avec Claude qui pose les bonnes questions. Résultat : un brief clair. |
| Claude : (génère 47 fichiers en 90 secondes) | Phase 2 : Tu listes les fonctionnalités, tu dessines les plans techniques. Résultat : une architecture solide. |
| Toi : "Ajoute un système de tags." | Phase 3 : Tu construis une fonctionnalité à la fois, tu valides chaque étape. Résultat : une app qui tient debout. |
| Claude : (modifie les fichiers, casse l'authentification) | |
| Toi : "Tu viens de casser la connexion." | |
| Claude : "Je vais corriger ça." (écrase la base de données) |
La différence n'est pas dans la puissance de l'IA. Elle est dans la façon dont tu organises le travail.
Personne ne construit un immeuble en commençant par poser les meubles. Dans n'importe quel projet sérieux — qu'il soit numérique ou en dur — on suit un enchaînement logique.
Analyser d'abord. Comprendre ce qu'on veut, pour qui, pourquoi. Poser les bonnes questions avant de se lancer. Planifier ensuite. Quelles fonctionnalités ? Dans quel ordre ? Avec quelle technologie ? On dessine les plans avant de couler les fondations. Construire enfin. Pas tout d'un coup — une pièce à la fois, en vérifiant la solidité à chaque étape. Publier quand c'est prêt. Mettre en ligne, montrer au monde.C'est du bon sens de chef de projet. Rien de révolutionnaire. Sauf que quand on débute, on a tendance à sauter directement à "construire" parce que l'IA rend ça tentant. La méthode, c'est simplement respecter l'ordre.
Pour suivre cet enchaînement de façon structurée, il existe des frameworks qui guident le travail étape par étape. Pour cette formation, on a choisi BMAD (Build Modular Agent-Driven). Il en existe d'autres — GSD, RALphLOOP, et bien d'autres encore. BMAD est très complet, bien adapté aux débutants, et c'est celui qu'on va utiliser pour le reste de la formation.
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, /compact | Oui — intégrées dans Claude Code |
| Skills BMAD | /workflow-xxx | /workflow-init, /workflow-status, /create-product-brief | Après installation de BMAD |
Pense à ta radio de chantier. Les commandes natives, ce sont les boutons de base : volume, marche/arrêt, réglages. Ils sont là dès que tu allumes la radio. Les skills BMAD, ce sont les canaux spécialisés que tu viens d'installer — chacun connecte à un expert différent sur le terrain.
Vérifie que le dossier _bmad/ existe dans ton projet. Si non, relance npx bmad-method 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 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 |
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