BMAD + Claude Code : la méthode pour structurer votre développement assisté par IA

Pourquoi la méthode BMAD pour Claude Code existe-t-elle ? Bon, soyons honnêtes deux secondes. On a tous vécu ce moment de gloire où on ouvre Claude Code, on tape en deux lignes ce qu’on veut faire, et on laisse l’agent IA balancer du code pendant qu’on se ressert un café. Résultat ? Un truc qui « marche » sur les screenshots mais qui part en vrille dès qu’on essaie de l’intégrer dans un vrai projet. La base de données ? Pas pensée. L’architecture logicielle ? Bof. Les tests ? Quels tests ?

Voilà exactement pourquoi la méthode BMAD existe. Et franchement, une fois qu’on y a goûté, on ne revient plus en arrière. Dans cet article, on vous explique ce qu’est BMAD, comment l’utiliser concrètement dans Claude Code, et pourquoi ce framework de développement assisté par IA change radicalement la façon de mener un projet.

C’est quoi la méthode BMAD au juste ?

BMAD (Breakthrough Method for Agile Development ou Build More Architect Dreams) c’est un framework de développement piloté par des agents IA, créé par Nick Baumann. L’idée centrale est aussi simple que redoutablement efficace : avant d’écrire une seule ligne de code, vous faites bosser des agents IA spécialisés pour structurer votre projet de A à Z.

La méthode BMAD est un framework de développement piloté par l’IA qui couvre l’intégralité du cycle projet, de l’idée au code livré. Agents spécialisés, workflows guidés, planification intelligente : BMAD s’adapte à votre projet, qu’il s’agisse d’un bug fix ou d’une plateforme enterprise. 
– Read-me du repo Github

On n’est plus dans le « hey Claude, fais-moi une app de gestion de tâches ». On est dans une vraie démarche d’ingénierie logicielle assistée par l’IA, avec des rôles bien définis, des livrables précis, et une progression logique.

En gros, BMAD permet de cadrer le projet comme on devrait le faire même sans IA, sauf qu’avec l’IA, c’est dix fois plus rapide.

Les agents BMAD : rôles et livrables

BMAD s’articule autour de plusieurs agents (ou « personas ») que vous allez invoquer dans Claude Code, chacun avec sa spécialité. Voici les principaux acteurs de la pièce.

🧠 The Analyst : « Raconte-moi ton problème »

Premier sur scène, l’Analyst a une mission : comprendre ce que vous voulez vraiment construire. Il vous interviewe, creuse vos besoins, identifie les risques, et produit un Project Brief, c’est-à-dire un document qui pose les bases du projet de façon claire et non-ambiguë.

Sans lui, vous vous lancez dans le brouillard. Avec lui, tout le monde (humains et IA) parle le même langage.

📋 The PM : « On structure tout ça »

Le Product Manager prend le Project Brief et le transforme en PRD (Product Requirements Document). C’est lui qui découpe le projet en features, définit les user stories, et établit les priorités. Il pense « valeur utilisateur », pas « technologie ».

C’est souvent l’étape qu’on zappe dans le vrai boulot et qu’on regrette pendant des semaines. Ne faites pas cette erreur.

🏗️ The Architect : « On va pas tout reconstruire dans 3 mois »

L’Architect lit le PRD et conçoit la solution technique : stack, structure de données, découpage en services, design patterns, architecture logicielle… Il produit un document d’architecture qui servira de boussole à tous les agents qui vont coder après lui.

Si votre Architect dit « on part sur une architecture monolithique modulaire avec PostgreSQL », tout le monde suit. Pas de surprise à la livraison.

💻 The Dev Agent : « Let’s ship »

Et enfin, seulement quand tout ce qui précède est en place, le Dev Agent entre en scène. Il prend une story du backlog, lit l’archi, et code. Story par story, test par test, commit par commit.

La différence avec l’approche « cowboy » ? Votre agent développeur a un contexte complet et structuré. Il sait ce qu’il fait et pourquoi.

En clair, avec BMAD, on ne demande pas simplement à une IA de coder, on met en place une équipe structurée où chaque agent prépare le terrain pour le suivant, comme on le ferait dans la gestion d’un projet logiciel avec une équipe au sein d’une entreprise.

Comment utiliser BMAD dans Claude Code : le guide pas à pas

Claude Code, c’est l’interface CLI d’Anthropic qui vous permet d’avoir des conversations longues avec Claude tout en lui donnant accès à votre système de fichiers, vos terminaux, vos outils. C’est l’environnement parfait pour faire tourner la méthode BMAD.

Voilà le flow en pratique.

Étape 1 : Initialisation du projet avec l’Analyst

Vous commencez par installer les fichiers de configuration BMAD dans votre projet (les personas sont définis dans des fichiers markdown que vous glissez dans votre repo). Claude Code peut les lire et adopter le rôle correspondant.

# Dans votre terminal
claude

Puis dans Claude Code :

/bmad-agent-bmm-analyst Je veux construire une application
de suivi de freelances pour ma boîte. Démarre l'interview.

L’Analyst prend le relais et vous pose des questions. Pas des questions génériques, mais de vraies questions qui font mal : « Qui sont les utilisateurs finaux ? Quels sont les critères de succès ? Quelles intégrations sont attendues ? »

Étape 2 : Du brief au PRD avec le PM

Une fois le Project Brief validé, vous passez la main :

/bmad-agent-bmm-pm Voici le Project Brief validé.
Génère le PRD.

Le PM produit un document structuré avec features, user stories, critères d’acceptation. Vous le relisez, vous corrigez, vous validez. C’est votre vision du produit, pas celle de l’IA. Elle vous aide à la formaliser, pas à la remplacer.

Étape 3 : L’architecture avant le code

/bmad-agent-bmm-architecht Voici le PRD.
Propose une architecture technique adaptée.

L’Architect génère un document d’architecture. Vous pouvez débattre avec lui (« pourquoi pas du serverless ici ? »), affiner les choix, puis valider. Ce document atterrit dans votre repo et fera partie du contexte de chaque future session de dev.

Étape 4 : La génération du product backlog

Une fois le PRD et l’architecture validés, le PM peut générer l’ensemble du product backlog :

/bmad-bmm-create-epics-and-stories Génère le backlog
à partir du PRD et de l'architecture validée.

Vous vous retrouvez avec des stories bien rédigées, dans le bon ordre, prêtes à être attaquées.

Étape 5 : On code, enfin

/bmad-agent-bmm-dev Implémente la story US-001 :
authentification utilisateur

Le Dev Agent code. Il a accès à l’archi, au PRD, aux stories. Il écrit les tests, respecte les conventions définies, et vous produit quelque chose qui s’intègre dans l’ensemble du projet — pas un bout de code orphelin.

Exemple concret : un projet de A à Z avec BMAD

Imaginons que vous voulez construire un tableau de bord de suivi de projets freelances. Sans BMAD, vous demandez à Claude Code de « faire une app avec un dashboard, une liste de clients et des factures ». Trois heures plus tard, vous avez du code qui affiche quelque chose mais sans authentification pensée, sans modèle de données cohérent, sans logique métier derrière les statuts de factures.

Avec BMAD, voilà ce que ça donne :

L’Analyst vous pose 12 questions précises. Vous réalisez que vous avez deux types d’utilisateurs (admin et freelance), que les devises multiples sont une vraie contrainte, et que l’export PDF des factures est non-négociable dès la V1.

Le PM structure tout ça en 4 epics, 17 user stories priorisées. Vous savez exactement ce que la V1 doit couvrir et ce qu’elle ne couvrira pas.

L’Architect choisit Next.js + Supabase, explique pourquoi (auth intégrée, storage, RLS), et documente la structure des tables. Vous validez en connaissance de cause.

Le Dev Agent implémente story par story. Chaque PR est cohérente avec l’ensemble. Pas de refactorisation surprise au sprint 3.

Pourquoi la méthode BMAD change la donne pour les développeurs

Le contexte, c’est tout. La grande faiblesse des agents IA sans méthode, c’est qu’ils travaillent sans vision d’ensemble. Résultat : incohérences, refactorisations, dette technique qui s’accumule dès le sprint 1. BMAD résout ça en construisant le contexte avant de coder.

La traçabilité. Chaque décision est documentée. Dans 3 mois, quand vous reprenez le projet ou quand vous onboardez quelqu’un, les documents BMAD expliquent pourquoi telle décision a été prise. Ce n’est pas juste du code, c’est de la connaissance projet.

Ce que j’aime [avec la méthode BMAD], c’est que chaque feature est découpée et bien délimitée, ça me permet facilement de garder le contrôle sur le code produit à chaque étape. Ce n’est pas pertinent pour n’importe quel projet, mais c’est cool d’avoir cette méthodo dans la boite à outils.
— @edmonddaoust

L’humain reste aux commandes. BMAD n’est pas une baguette magique qui livre votre app pendant que vous siestez. C’est un framework collaboratif : vous validez chaque étape, vous prenez les décisions, vous arbitrez les choix. L’IA vous assiste avec une puissance de feu impressionnante, mais vous gardez le volant.

La scalabilité. Vous bossez seul ? BMAD marche. Vous êtes en équipe ? Les documents BMAD deviennent des référentiels partagés. Chaque dev (humain ou IA) bosse depuis la même source de vérité.

Les pièges à éviter avec BMAD

Ne sautez pas les étapes. C’est tentant de passer directement au Dev Agent parce que vous avez l’impression de « perdre du temps » avec l’Analyst et le PM. C’est une erreur classique de débutant. Le temps passé en amont, vous le gagnez dix fois pendant le dev.

Validez vraiment les documents. Les livrables BMAD (Brief, PRD, Archi) ne sont pas des formalités à valider en diagonal. Lisez-les. Corrigez-les. Ce sont les fondations de tout ce qui vient après.

Adaptez à votre contexte. BMAD est un framework, pas une religion. Pour un side project personnel d’un weekend, vous allez peut-être alléger certaines étapes. Pour un projet d’équipe avec des enjeux business, soyez rigoureux sur chaque livrable.

Et si vous êtes totalement débutant en code, attention à ne pas tomber dans le biais de surconfiance et à saper votre apprentissage parce que « ça marche ».

Pour aller plus loin

Si vous voulez vous lancer, voilà les ressources indispensables :

• • Le repo officiel : github.com/bmadcode/BMAD-METHOD

• • La doc Claude Code : docs.claude.com

• • La communauté Discord BMAD pour échanger avec d’autres praticiens

En résumé

BMAD et Claude Code, c’est la réponse à la question qu’on se pose tous : « Comment je fais pour que l’IA m’aide vraiment à construire des projets solides plutôt que de me pondre du code spaghetti ? »

C’est en respectant les étapes de la méthode BMAD que vous pouvez vous assurer de garder le contrôle de votre projet !

La réponse : en structurant le travail et en faisant bosser les bons agents dans le bon ordre. En gardant les humains là où ils doivent être, en train de valider, décider, orienter et en laissant l’IA faire ce qu’elle fait de mieux : exécuter avec précision et rapidité sur un contexte bien défini.

Alors, et si on reprenait le contrôle de nos projets ?

—

🎓 Tu veux maîtriser ces outils dans ta pratique de développeur ? Chez O’Clock, nos formations développeur web intègrent l’usage professionnel des outils d’IA, de la conception à la mise en production. Tout ça en téléprésentiel, depuis chez toi, avec de vrais formateurs. → Découvrir les formations O’Clock