Étude de cas : vérifier ce que les agents disent avoir terminé

Si un agent IA vous a déjà dit « terminé » alors que ce n’était pas vrai, cette page est pour vous. Elle montre ce qui s’est passé quand 39 agents ont refait la landing, la documentation, les exemples et les vidéos de ce site en moins de douze heures, entre le soir du 2026-10-18 et le matin du 2026-10-19 : une relecture a jugé 11 affirmations fausses, les relecteurs se sont trompés deux fois, et une personne a décidé de ce qu’on garde. Vous verrez les cinq étapes, les chiffres avec leurs sources, les erreurs, et les commandes à rejouer sur votre propre projet. Si vous voulez seulement l’exécuter, passez à À rejouer chez vous.

Ce que ça a demandé, en chiffres#

Cinq étapes à copier#

1. 01

   Écrivez d’abord les règles

   Écrivez le but en une phrase et les règles qui ne plient jamais. Ici, le but était un site qui couvre toutes les possibilités de BMAD+ en quatre langues, avec des vidéos. Les règles : tout écrit de zéro, des faits tirés uniquement du dépôt, tout ce qui est simulé le dit, et rien ne tourne sur l’ordinateur du propriétaire (les builds et les tests ont tourné sur un serveur de test, dans des conteneurs).

2. 02

   Laissez-le demander avant d’agir

   Avant qu’un agent démarre, le travail a été listé : ce qui existait et ce qui manquait (les nouvelles commandes n’avaient ni exemple ni page de référence). Le propriétaire a ensuite élargi le périmètre. Dans BMAD+, cette étape est l’intake : il note ce qui est répondu, pris par défaut ou inconnu, et pose six questions au plus par message.

   Dans le terminal du projet

   npx bmad-plus intake plan --intake .agents/skills/pack-design/intake.yaml --answers _bmad-output/design/intake.json

3. 03

   Donnez à chaque agent sa page et sa copie

   Un agent a d’abord inventorié tout le produit. Puis la landing, la documentation, les enregistrements d’écran et les vidéos ont été construits en parallèle, chaque agent dans son propre worktree git et sa propre copie du projet sur le serveur de test, avec des périmètres qui ne se recouvrent pas pour que les branches puissent être fusionnées. Dans BMAD+, la même forme est une définition d’essaim avec une unité par page et des périmètres disjoints.

   Dans le terminal du projet

   npx bmad-plus swarm init --definition swarm/page-fanout.json --units swarm/units.json

4. 04

   Faites-le attaquer par quelqu’un d’autre

   Cinq relecteurs qui n’avaient rien écrit ont lu le résultat à un commit figé : l’un a vérifié les faits des pages packs, agents et concepts, un autre la référence, les guides, la sécurité, la FAQ et la landing, un troisième a rejoué les exemples, un quatrième a lu le français, l’espagnol et l’allemand, un cinquième a piloté un navigateur pour l’accessibilité. Ils ont rejoué les commandes sur un serveur propre au lieu de croire le texte. Dans BMAD+, la couche de preuve est review : elle scelle le périmètre et refuse un verdict tant que chaque fichier n’est pas pris en compte.

   Dans le terminal du projet

   npx bmad-plus review scope site --workspace --base HEAD
   npx bmad-plus review gate site

5. 05

   Corrigez, puis prouvez

   Sept groupes de correction et quatre passes ont corrigé ce que les relectures avaient trouvé (19 commits de correction sur quatre branches). Un intégrateur a fusionné 14 branches et relancé tous les contrôles : 79 tests du site, 1 879 tests, 91 986 contrôles de recherche, 2 539 contrôles de release et une exécution navigateur de 976 cas de fenêtre et 300 exécutions d’accessibilité sans aucune violation. Rien n’a été déployé avant l’accord du propriétaire.

Ce que les relecteurs ont repéré, et là où ils se sont trompés#

Vous vous attendez peut-être à ce que des agents qui ont lu le code disent des choses exactes. Ce n’était pas toujours le cas. Ces sept affirmations n’ont pas survécu au rejeu de la commande ou à la lecture du code, et chacune a été corrigée.

Là où une personne a décidé#

• De lancer, avec des essaims en parallèle, et d’élargir le périmètre à toutes les possibilités du produit et à des vidéos de présentation avec voix off.
• La voix de narration : la première a été refusée, une voix ElevenLabs (Celine) a été approuvée après écoute.
• De lancer la documentation, les exemples et la référence CLI en parallèle plutôt que l’un après l’autre.
• Qui est crédité pour quoi dans le README et la description npm.
• Une sauvegarde complète du site en ligne avant de le remplacer.
• La formulation de deux affirmations publiques : Dev Studio est décrit comme original, et la carte du pack SEO s’intitule « SEO / GEO ».
• Une pause pendant l’absence du propriétaire, et la reprise la même nuit.
• Que rien ne soit déployé avant que le propriétaire le dise.

À rejouer chez vous#

Cinq commandes portent la méthode : install, intake plan, swarm init, review scope et review gate. Les blocs ci-dessous les exécutent, avec les quelques commandes autour qui les font fonctionner. Vous pouvez vous arrêter après n’importe quel bloc.

Il vous faut Node.js 20 ou plus et un projet Git avec au moins un commit. Les blocs ci-dessous sont de la sortie réelle du paquet publié 0.23.0. Là où des sous-agents écriraient leurs réponses, la partie essaim écrit à la main trois petits fichiers de réponse : aucun modèle ne tourne, donc le décompte compte des réponses de substitution et ne dit rien de vraies pages. La définition, le gabarit de brief et le fichier d’unités sont affichés sur la page de l’essaim.

$ npx bmad-plus install --yes --lang en --packs core,design,memory --tools claude-code
# Sortie réduite à sa dernière ligne.
BMAD+ is ready! Talk to Atlas to get started 🚀

$ npx bmad-plus intake record --intake .agents/skills/pack-design/intake.yaml --answers _bmad-output/design/intake.json --set surface_kind=landing --set "audience=Urban professionals who buy coffee most days" --set "job=Get a first-time visitor to open a loyalty card"
Recorded surface_kind, audience, job in _bmad-output/design/intake.json.
$ npx bmad-plus intake plan --intake .agents/skills/pack-design/intake.yaml --answers _bmad-output/design/intake.json
design-read (design): ready — 3 answered, 0 defaulted, 0 unknown, 10 not asked yet.
Ask next (at most 6 per message):
  - brand_assets [choice] Which brand assets exist already? None, a partial set (a logo and a colour or two), or a full kit (logo, palette, type, voice)? (choices: none, partial, full)
# Cinq autres questions suivent dans la sortie réelle.

$ npx bmad-plus swarm init --definition swarm/page-fanout.json --units swarm/units.json
site-pages-20261019-kgoi: fanout of 3 units, budget 26, approval not-needed.
Units listed, no seed.
Next: bmad-plus swarm briefs site-pages-20261019-kgoi
$ npx bmad-plus swarm briefs site-pages-20261019-kgoi
site-pages-20261019-kgoi: 3 of 3 units need a sub-agent, in waves of 10.
Wave 1:
  about  /work/app/.bmad-plus/swarm/runs/site-pages-20261019-kgoi/briefs/about.md
  pricing  /work/app/.bmad-plus/swarm/runs/site-pages-20261019-kgoi/briefs/pricing.md
  contact  /work/app/.bmad-plus/swarm/runs/site-pages-20261019-kgoi/briefs/contact.md
Each sub-agent: Read the brief and follow it exactly; it is your whole instruction.
Disclosure: Each page was written by a separate sub-agent from the same brief; read them together before publishing.
# Ici, les trois fichiers de réponse ont été écrits à la main, là où chaque sous-agent écrirait le sien.
$ npx bmad-plus swarm check site-pages-20261019-kgoi
site-pages-20261019-kgoi: 3 of 3 valid answers.
$ npx bmad-plus swarm tally site-pages-20261019-kgoi
/work/app/.bmad-plus/swarm/runs/site-pages-20261019-kgoi/tally.md
3 of 3 units counted; 0 skipped.
Disclosure: Each page was written by a separate sub-agent from the same brief; read them together before publishing.

$ npx bmad-plus review scope site --workspace --base HEAD
/work/app/_bmad-output/review/site/scope.json
1 file(s) to review, 1 changed lines, 1 unit(s) — scope 1ef2d235ea25
checklist: /work/app/_bmad-output/review/site/checklist.md
plan: medium effort, 2 pass(es), refutation pass
Every selected file must end in coverage.json as completed, failed or waived (with a reason).
$ npx bmad-plus review gate site
site: incomplete — coverage 0/1 completed (0 waived), 0 open finding(s), 0 refuted
  - no coverage.json: which files were reviewed is not established
  - no findings.json: write it even when there is nothing to report
  - 1 selected file(s) never accounted for: site/contact/index.md
# Code de sortie 2 : le verdict reste incomplet tant que le relecteur n’a pas écrit sa couverture et ses constats.

Lance l’essaim site-pages depuis swarm/page-fanout.json et swarm/units.json : un sous-agent par page, chacun limité à son propre dossier, une vague à la fois. Quand les réponses sont là, lance swarm check et swarm tally et rapporte d’abord la mention de transparence. Puis, avec un autre sous-agent qui n’a écrit aucune des pages, lance review scope sur l’arbre de travail contre HEAD, lis chaque fichier modifié et rejoue chaque commande que montrent les pages. N’accepte pas une page dont une commande échoue, et dis-moi quelle affirmation le relecteur n’a pas pu vérifier.

Ce que cela ne prouve pas, pour que vous jugiez#

• Un projet et une exécution : cela montre que la méthode peut attraper des erreurs, pas à quelle fréquence.
• Les relecteurs sont aussi des modèles. Un constat est une piste à vérifier, et deux d’entre eux étaient faux.
• Les décomptes montrés à l’écran et dans les exemples sont des démonstrations, et ils sont signalés comme tels.
• Personne n’a mesuré si le site est plus facile à comprendre. Les contrôles portent sur les faits, les règles d’accessibilité et la structure, pas sur la compréhension.
• Les textes français, espagnol et allemand ont été relus par un agent face à l’anglais et à un glossaire commun, pas par un correcteur natif.
• Les vidéos ont été vérifiées par des scripts et par un agent qui regarde des images. Leur son et leur rendu restent un jugement humain.