04Ce que BMAD apporte à Claude

Claude connaît tous les langages et frameworks dont le produit a besoin. Il ne sait pas quoi construire, ni quand s'arrêter. BMAD fournit la méthode autour de lui. Ce qu'un dispositif médical exige en plus, j'ai dû l'ajouter.

Claude peut écrire chaque couche d'un produit à partir d'instructions claires, si bien qu'un agent peut mener le travail du document de cadrage du produit jusqu'à la story testée. Livré à lui-même, il décide aussi de ce que personne ne lui a demandé de décider, et il décide mal, sans le dire (prologue). Cela demande une méthode : une méthode qui laisse à l'équipe ce que le produit doit faire, les contraintes qu'il respecte et les choix sur lesquels repose son architecture, et qui donne à l'IA tout le reste.

Que devait apporter la méthode ?

J'ai fixé quatre besoins avant d'en choisir une :

  • un chemin de la définition du produit aux capacités, d'une intention soutenue par un business case jusqu'aux exigences, à une architecture et à des éléments de travail assez petits pour être construits et testés, sans rien perdre en chemin, avec la discipline qu'apporte Scrum ;
  • un système qualité appliqué à chaque étape, puisqu'un dispositif médical en a besoin et que chaque étape qui produit quelque chose doit y être tenue ;
  • des tests reproductibles, relancés de la même façon à chaque modification ;
  • de la place pour l'architecture, pour consigner les décisions d'architecture tout en me les laissant.

J'ai regardé GSD, Kiro, Spec Kit, BMAD et quelques autres, et j'ai lu leur documentation sans les tester toutes. La documentation de BMAD était la plus convaincante, et je l'ai essayée sur le vrai projet. Ce n'est pas une comparaison en règle, mais le coût d'une erreur était faible : BMAD est open source et fonctionne au-dessus de Claude, si bien que changer de méthode aurait voulu dire changer des instructions et des modèles, et le code du produit serait resté tel quel. Au vu des outils tels qu'ils étaient à la mi-2026, BMAD couvrait tout le cycle de vie dès le premier document de cadrage, pouvait être étendue, ce qui a rendu possible le plugin SMQ, gardait tout ce qu'elle produisait sous forme de fichiers texte en gestion de versions, et n'était liée à aucun éditeur ni à aucun fournisseur.

Un agent dès le premier jour ?

Pour le produit, je suis passé du chat à Claude Code, qui travaille sur mon poste : il construit le code, démarre et arrête les serveurs de base de données, d'applications et d'identité, et enregistre son travail. BMAD fonctionne à l'intérieur. Un lecteur de L'IA générative au-delà du battage pourrait voir ici une contradiction. J'y décris quatre étapes pour adopter l'IA générative, Ramper, Marcher, Courir et Voler, et je mets en garde contre le fait de commencer par Voler : confier du vrai travail à des agents autonomes avant que l'organisation ait appris à les superviser. Un développeur IA qui lit le code, écrit des fichiers, lance les tests et enregistre ses modifications est exactement un tel agent. Ai-je commencé par Voler ?

Non, pour deux raisons. Je n'ai rien entrepris de conséquent avant d'avoir franchi les jalons précédents : de 2024 au début de 2026, une position éclairée sur l'IA générative, les expériences du prologue, avec un outil passé en usage réel qui aide les CTO et DSI d'une communauté dont je suis membre à évaluer les CV des candidats, puis BMAD. C'est seulement ensuite que l'agent a reçu du vrai travail. Et le développement logiciel avant mise en service remplit les conditions que je fixais pour Voler dans ce même article : des actions réversibles, des erreurs au coût borné, et des résultats peu coûteux à vérifier. Chaque modification que fait l'agent est enregistrée dans la gestion de versions et peut être annulée. Rien de ce qu'il écrit n'atteint un patient : rien n'a été mis en service dans un hôpital, et les modifications passent par la revue, les tests et, quand la story la consigne, une vérification en direct par moi ; les lacunes sont comptées plus bas. Et chaque vérification coûte bien moins cher que de produire le travail qu'elle vérifie.

Ce que voit l'agent est borné aussi. Il lit et écrit le code source, qui part donc chez un fournisseur externe, par décision délibérée. Il n'a jamais vu un vrai dossier patient : toutes les données de développement et de test sont générées pour l'occasion.

Ce que BMAD apporte

BMAD organise le travail comme une suite de rôles, chacun tenu par Claude avec ses propres instructions : analyste, chef de produit, architecte, développeur, designer UX, et d'autres. Chaque rôle exécute des workflows, environ quarante-cinq dans la version que j'utilise, et chaque workflow produit un artefact écrit dont part le suivant, du document de cadrage du produit jusqu'à la Definition of Done de chaque story.

La chaîne de BMAD en regard de ScrumSept étapes BMAD, du document de cadrage à la Definition of Done, chacune au-dessus de l'élément Scrum auquel elle correspond. L'architecture n'a pas d'artefact Scrum. BMAD ne fournit pas l'horizon long : une feuille de route et une prévision.BMAD · JOUÉE PAR CLAUDE, DÉCIDÉE PAR MOISCRUM · CE À QUOI ELLE CORRESPONDCadragele problèmeet le pariProduct GoalExigencesfonctionnellesou nonProductBacklogArchitecturedécisions,chacune revuePas d'artefactScrumVérificationde préparationles troisconcordentAffinagedu backlogEpics etstoriescritèresd'acceptationÉlémentsdu backlogBouclepar storypréparer, coder,revue × 3SprintSprint BacklogDefinitionof Doneatteinte, oupas finiDefinitionof DoneIncrementAbsent de BMAD : l'horizon long, une feuille de route et une prévision de ce quisera fait, et quand. Le chapitre 10 porte sur les deux.
Figure 4. Du document de cadrage à la Definition of Done : la chaîne de BMAD, en regard des événements et artefacts Scrum auxquels elle correspond.

C'est ce qu'on appelle désormais le développement piloté par les spécifications, ou SDD (spec-driven development) : la spécification est ce que l'on écrit et maintient, et le code en est produit. Encore un nom qui finit en DD, et il ne mériterait pas un paragraphe s'il n'était qu'un nom. Pour moi, ce fut le moyen au service du but dont traite cet article. J'ai consacré mon temps à ce que le produit doit être, aux contraintes qu'il respecte et à la façon de le vérifier ; Claude a trouvé comment le construire, story par story, à partir de spécifications assez précises pour cela. Une spécification ne s'applique pas toute seule, pourtant. Ma règle contre un framework de persistance était écrite dans l'architecture, et elle est revenue trois fois (chapitre 07) ; c'est pourquoi le système qualité et les contrôles de build se tiennent derrière les spécifications. La façon dont le SDD, le Domain-Driven Design et Scrum s'articulent quand une IA écrit le code fait l'objet du prochain article de ce site, Scrum, DDD, Claude et BMAD ensemble.

Deux éléments de cette chaîne ont fait le plus de différence.

La story porte son propre contexte

Avant l'implémentation, un workflow dédié réécrit chaque story avec tout ce dont le développeur a besoin : les exigences concernées, les décisions d'architecture qui s'appliquent, les contraintes, ce qu'ont fait les stories précédentes. Le développeur commence chaque story avec un dossier neuf et complet, et rien ne dépend de ce dont une longue conversation se souvient encore.

La revue est contradictoire, et infatigable

Le code de chaque story doit être revu par trois relecteurs travaillant en parallèle ; 23 stories ne consignent aucune revue (chapitre 01). Ils trouvent les cas normaux, limites et d'échec, et les corrections et les tests découlent de leurs constats.

Les trois relecteurs, et ce que sont devenus leurs constatsChaque story est relue par trois relecteurs en parallèle : un lecteur à l'aveugle, un chasseur de cas limites et un auditeur d'acceptation. Sur l'ensemble du projet, près de 900 constats sont consignés : environ 485 corrigés dans la même story, environ 245 reportés avec une raison, environ 90 écartés avec une raison, et 23 soumis à ma décision ; une cinquantaine d'autres ont été clos sans suite ou comme notes.Lecteur à l'aveugledit ce que fait vraimentla modificationChasseur de cas limitescherche les cas quepersonne n'a spécifiésAuditeur d'acceptationconfronte la modificationaux critères de la story≈ 890 constatssur l'ensemble du projet≈ 50 clos sans suite, ou comme notes≈ 485corrigés dans la même story≈ 245reportés, avec une raison≈ 90écartés,avec une raison23soumis àma décision
Figure 5. Les trois relecteurs, et ce que sont devenus les près de 900 constats consignés sur l'ensemble du projet.
Ce qui est parvenu à une personne

Sur près de 900 constats, 23 ont été soumis à ma décision, et ma réponse est écrite dans chaque story. J'ai aussi lu les constats reportés avec une raison ; cette lecture n'est pas consignée. Pour 121 des 172 stories, la story consigne une vérification en direct ou une confirmation de ma part. Les 62 journaux de vérification consignent ce qui a été vérifié sur quel build : 38 une vérification en direct, 27 une comparaison du build déployé avec celui qui a été testé, et certains journaux consignent les deux. Les vérifications en direct ont trouvé ce que les tests et les relecteurs avaient manqué : l'anomalie du 17 septembre, et une restriction passée inaperçue à travers la revue, l'approbation et le déploiement. Pour les 51 autres stories, rien ne consigne une vérification par une personne, et je ne peux pas dire ce qu'elle a été : elles comptent donc comme non vérifiées. Les registres ne disent pas si j'ai lu le code lui-même. Qu'une vérification par une personne ne soit pas consignée pour chaque story est une lacune, consignée avec les revues manquantes comme point ouvert OPEN-114 dans le registre du système qualité.

Qu'est-ce que BMAD a laissé à l'équipe ?

Au regard des quatre besoins, BMAD a bien couvert le premier, et en partie le troisième et le quatrième. Il n'avait rien pour le deuxième.

Besoin Ce que BMAD a apporté Ce que j'ai ajouté
De la définition du produit aux capacités Cadrage, exigences, architecture, vérification de préparation, epics, stories, propositions de changement Le business case, comme hypothèse à éprouver
Un système qualité appliqué à chaque étape Rien d'intégré Le SMQ, le plugin qui le branche sur les workflows, la Definition of Done (chapitres 06 et 07)
Des tests reproductibles Une revue contradictoire qui guide les tests Des contrôles de build : une couverture qui ne peut pas baisser, une couverture plus stricte pour le code lié à la sécurité, chaque test relié à une exigence
Architecture et bonnes pratiques Un rôle d'architecte, des workflows d'architecture, des cycles de revue Les décisions elles-mêmes : pas de framework de persistance, une base de données unique dans le dispositif, la frontière du dispositif

Comme le montre la figure 4, la chaîne est celle que demande Scrum, et elle a aussi les manques de Scrum. Scrum est incomplet à dessein : les livrables réglementaires et l'horizon plus long font partie des pièces qu'une organisation doit ajouter délibérément, ou voir ajouter dans l'ombre (Scrum en apparence seulement). BMAD laisse les deux mêmes : le système qualité, sujet des chapitres 06 et 07, et la feuille de route et la prévision, sujet du chapitre 10.

Les rôles demandent aussi à être surveillés. En travaillant sur la recherche de patients, le développeur a constaté que l'outil de configuration ne permettait pas de créer une nouvelle page. Il y a vu une fonctionnalité manquante et a rédigé une nouvelle exigence, une epic et une story pour en construire une. Les pages sont fixées au moment du développement, à dessein ; seul leur contenu est configurable. J'ai corrigé la prémisse, et la planification a été annulée avant qu'une ligne de code existe. Chaque rôle fait son travail consciencieusement, et cela inclut d'élargir le périmètre quand personne ne lui dit où il s'arrête. Lui dire où elles se trouvent est le travail de l'équipe.

Pour votre propre projet

  • Écrivez ce que la méthode doit apporter avant d'en choisir une, et ajoutez délibérément ce qu'elle ne couvre pas, comme vous le feriez pour Scrum : pour moi, un système qualité et une feuille de route ; pour vous, peut-être des règles de sécurité, une norme sectorielle ou l'audit d'un client.
  • Ne confiez du vrai travail à un agent IA que là où ses actions peuvent être annulées, où ses erreurs sont bornées et où ses résultats sont peu coûteux à vérifier, et décidez de ce qu'il peut voir.
  • Dites à chaque rôle où s'arrête le périmètre. Un agent consciencieux l'élargira sinon.