Annexe FQue fait le plugin QMS ?
Le chapitre 06 dit qu'un plugin a mis en place le système qualité et demande à chaque workflow BMAD de le charger. Cette annexe ouvre ce plugin : à quoi il sert, comment il fonctionne, comment il en est arrivé là, et comment il est testé. Il est publié, et chacun peut le lire.
État au 3 novembre 2026
La version 1.0.1 est publiée sur github.com/jouleco-fr/bmad-samd-qms, sous licence MIT, avec ses tests. Ouvert : une vérification, dans le build du produit lui-même, que le câblage tient toujours (OPEN-105), et les améliorations classées à la fin. Les numéros de la forme OPEN-nnn sont des entrées du registre des points ouverts du projet, qui fait partie de son système qualité (chapitre 06).
À quoi sert-il ?
Un développeur IA suit les règles qu'on lui donne, quand on les lui donne. Le plugin a pour but de faire des bonnes pratiques le chemin par défaut : chaque fois qu'un workflow BMAD démarre, qu'il écrive une exigence, une story, du code ou une revue, il charge d'abord les règles du système qualité. La Definition of Done, le registre des contraintes, la règle de traçabilité et les registres des risques et des logiciels tiers sont présents à chaque étape, sans que personne ait à penser à les fournir.
Cela fait du plugin une pièce essentielle de la méthode. C'est aussi une pièce simple. Il n'a pas de modèle à lui, ne fait tourner aucun service et ne décide de rien. Il tient davantage de la calculatrice de poche que de la calculatrice scientifique : il pose une dizaine de questions, crée un dossier de documents, et écrit, pour chaque workflow, lesquels de ces documents il doit lire.
Comment fonctionne-t-il ?
| Élément | Ce qu'il fait | Taille |
|---|---|---|
Une compétence d'installation, lancée une fois avec /qms-init |
pose une dizaine de questions : le nom du dispositif, ses classes au regard des règles américaines et européennes et de l'IEC 62304, les marchés, s'il traite des données de santé | une centaine de lignes d'instructions |
| 17 modèles | deviennent le dossier qms/ : Definition of Done, registre des contraintes, registres des risques, des logiciels tiers et des points ouverts, les dossiers réglementaires |
17 fichiers Markdown |
| Quatre scripts | remplissent les modèles à partir des réponses, enregistrent le module auprès de BMAD et écrivent le câblage | 926 lignes de Python |
| Une liste de câblage | indique, pour chacun de neuf workflows, les documents qu'il charge | un court fichier |
| Une compétence de mise à jour | intègre des modèles plus récents sans toucher aux documents modifiés | une vingtaine de lignes |
Les registres qualité qu'il crée vivent sous forme de texte, à côté du code, sous gestion de versions : le chapitre 06 explique pourquoi cela compte pour une IA qui lit des fichiers. Le plugin ne fait que les mettre en place et les câbler ; leur contenu est le travail de l'équipe.
Un extrait de la liste de câblage, et le fichier qu'elle produit
# assets/wiring.toml: which QMS documents each BMAD workflow loads
[skills.bmad-dev-story]
facts = ["qms/definition-of-done.md", "qms/constraints-register.md",
"qms/soup-register.md", "qms/risk/risk-register.md"]
# _bmad/custom/bmad-dev-story.toml, written by the plugin, read by BMAD
[workflow]
persistent_facts = [
"file:{project-root}/qms/definition-of-done.md",
"file:{project-root}/qms/constraints-register.md",
"file:{project-root}/qms/soup-register.md",
"file:{project-root}/qms/risk/risk-register.md",
]Comment en est-il arrivé là ?
La première version, le 31 juillet, câblait les workflows au moyen d'instructions indiquant à Claude quels paramètres écrire, et où. Elles désignaient le mauvais fichier, et pendant dix semaines aucun workflow n'a chargé automatiquement le système qualité. Le 17 octobre, les audits menés par une personne l'ont découvert, en même temps qu'une seconde erreur : une nouvelle exécution écrasait des documents modifiés ; le chapitre 07 raconte l'une et l'autre. Les instructions ont été corrigées le jour même.
Ce qui est nouveau depuis, c'est que le câblage est devenu du code. Le 2 novembre, les instructions ont été remplacées par un script de 77 lignes qui lit la liste de câblage, écrit les fichiers, et refuse d'écraser un fichier qu'il n'a pas écrit. Sept tests exécutent désormais le plugin sur un projet jetable. Le plus important appelle le résolveur de BMAD lui-même, la pièce de BMAD qui décide de ce que charge un workflow, et vérifie que chaque workflow câblé reçoit chaque document, et que chacun de ces documents existe. Ce test aurait détecté la panne de dix semaines dès sa première exécution. Les sept passent avec BMAD 6.10.0. La version 1.0.0 a été publiée le 3 novembre, sous licence MIT, par Jouleco. La version 1.0.1 a suivi le même jour, après qu'un test de l'installation décrite a montré qu'elle ne pouvait pas fonctionner.
Comment s'en servir ?
Dans un projet où BMAD est installé :
claude plugin marketplace add jouleco-fr/bmad-samd-qms
claude plugin install bmad-samd-qms@jouleco
Puis, dans Claude Code, lancez /qms-init : il pose ses questions, crée qms/ et câble les
workflows. Pour vérifier que le câblage fonctionne avec votre propre installation de BMAD, exécutez
les tests du plugin sur celle-ci, depuis une copie du dépôt :
BMAD_PROJECT=/chemin/vers/votre/projet python3 -m unittest discover -s tests -v
Les documents qu'il crée sont un point de départ. Ils donnent sa forme au système qualité ; les remplir est le travail de l'équipe.
Que ne fait-il pas ?
Il ne rend pas un logiciel conforme. Les modèles donnent sa forme à un système qualité, et le remplir, le tenir à jour et le faire relire restent le travail de l'équipe. Il ne vérifie pas non plus que les règles sont respectées : il veille à ce qu'elles soient lues. Les vérifications que les règles tiennent se trouvent ailleurs, dans le build et dans les audits que mène une personne (chapitre 07).
Qu'est-ce que j'ai appris ?
Claude et BMAD y ont contribué de deux façons. Un petit plugin, construit avec Claude, a suffi à placer le système qualité devant chaque workflow ; rien de plus élaboré n'a été nécessaire. Et la conception de BMAD l'a rendu possible : un fichier par workflow, lu par un résolveur qu'un test peut appeler.
Sur la méthode, chaque constat montre comment le travail a été fait :
| Constat | Ce qu'il dit de la méthode |
|---|---|
| Sous forme d'instructions, il ne pouvait pas être testé | L'étape ne pouvait pas être vérifiée par un test, et ne l'a donc jamais été |
| Devenu script, il a été testé en une journée, à travers le résolveur de BMAD lui-même | Sous la forme d'un court script, la couche qui fait respecter les bonnes pratiques est devenue quelque chose qu'un test peut prouver |
| Le plugin a écrasé des documents modifiés | Un outil que j'ai construit n'était pas tenu à la Definition of Done à laquelle je tenais le produit |
Que changerais-je ?
Voici quatre propositions, la plus utile d'abord, chacune avec ce qu'une vérification ultérieure mesurerait.
| Rang | Amélioration | Pourquoi à ce rang | Mesure |
|---|---|---|---|
| 1 | Le build du produit exécute le résolveur de BMAD pour chaque workflow câblé, et échoue si un document qualité manque (OPEN-105) | Les tests du plugin prouvent le plugin ; seul le build du produit peut prouver que le câblage tient encore après une mise à jour de BMAD | Builds qui vérifient le câblage |
| 2 | Les tests du plugin s'exécutent à chaque modification, sur le dépôt public | Chacun peut les voir passer | Exécutions des tests par version |
| 3 | Toute règle qui doit tenir à chaque fois vit dans un script ou un contrôle, l'instruction servant à l'expliquer | Cela supprime la cause de la panne de dix semaines, pour chaque règle | Règles appliquées par du code, rapportées aux règles recensées |
| 4 | La compétence de mise à jour reçoit les mêmes tests que l'installation | C'est l'autre moitié du plugin, et celle qui risque le plus d'écraser quelque chose | Tests de la mise à jour |
Pour votre propre projet
- Placez les règles là où l'agent les lit, à chaque étape, quelle que soit la méthode qui l'entoure.
- Faites du câblage qui les lui transmet du code, et gardez les instructions pour ce qui peut varier.
- Testez ce câblage par le mécanisme même du framework, tel que l'agent le verra, et exécutez ce test dans votre build.
Où cela laisse-t-il le projet ?
À son jalon, le projet dispose de ceci : le plugin qui place le système qualité devant chaque workflow est publié, petit, et testé là où il avait échoué. Ce qu'il ne peut pas faire, c'est prouver que les workflows du produit le chargent encore demain. Cette vérification, faite par le build du produit lui-même, est la première de ces propositions ; elle est consignée comme point ouvert OPEN-105. Une version ultérieure de cette annexe dira lesquelles ont été retenues.