Files
Brian 8b4da79161 refactor(core): group v6 shims and merge editorial review into bmad-review as lenses (#2608)
* refactor: group v6 deprecation shims into v6-shims folders

Move the nine backward-compatibility forwarders into dedicated v6-shims/
folders so the deprecation set is visible in one place and can later be
made an install-time include/exclude option before removal at the v7 cut.

core-skills/v6-shims/: the five review and editorial husks
bmm-skills/v6-shims/: the four PRD and architecture husks

Grouping only — no content changes. The installer discovers skills by a
recursive walk and installs each under its own name, so installed paths
and skill IDs are unchanged. Verified by diffing a full headless install
against main: identical .claude/skills listing and file content, and an
identical _bmad tree. The only delta is the path column in
skill-manifest.csv, which now records the new source location.

External module repos (gds, loop, tea, bmb, os-utils) and enterprise
users still invoke these IDs, so they continue to ship by default.

* refactor(core): merge editorial review into bmad-review as lenses

All reviews are reviews. bmad-editorial-review's two passes become two
more bmad-review lenses, leaving one lens runtime instead of two skills
with overlapping trigger descriptions — "review this document" matched
both before, so which one ran was close to arbitrary.

Lenses now declare what they apply to. applies_to is "code", "docs", or
"any", and is the first filter on a default review; `when` still refines
it in prose. adversarial stays "any" — it is a stance, not a subject-
matter method, and is the lens a code/doc skill split could not have
placed. edge-case-hunter's `when` was "always", which is why it would
have fired on prose; it now gates on having a behavioral surface.

A lens may also declare `after`, naming a lens it builds on: prose runs
on top of the structure findings, as it always has. The runner announces
the plan, runs the independent lenses (in parallel via subagents when
available), then the dependent ones on their results.

Lens wording is unchanged. The three code lens files are byte-identical;
the editorial passes moved verbatim into references/lens-structure.md,
references/lens-prose.md, and references/editorial-common.md, which
carries what both share — the content-sacrosanct rule, style guide
handling, reader calibration, and the findings table. That material used
to load unconditionally; as lenses it loads just-in-time, so a code
review no longer pays for it.

bmad-editorial-review becomes the sixth v6 shim, forwarding with the
structure and prose lenses named. It keeps its customize.toml so existing
team and user overrides still resolve, and forwards them as pre-resolved
values. The four other husks now name bmad-review and their lens
explicitly. Each still pins its own legacy output contract.

bmm's four document skills point doc_standards at the merged skill with
named lenses. Docs updated across all five locales.

Core is 7 skills. A headless install produces the same 47-skill set as
main, with all six shims resolving.

* fix(core): honor forwarded customization and de-hardcode the lens set

Follow-up to the editorial/review merge, from review of #2608.

Contract fixes:
- bmad-review gains a Forwarded activation clause matching bmad-prd and
  bmad-architecture, so the bmad-editorial-review shim's pre-resolved fields
  are honored instead of being silently overwritten by the skill's own
  customize.toml. Existing bmad-editorial-review overrides resolve again.
- The announce step is skipped when a caller pinned an exact output contract,
  and a forwarder's contract now governs everything emitted rather than the
  findings block alone. The edge-case (raw JSON) and verification-gap (one
  exact line) forwarders no longer get a prose line prepended.

Lens set is no longer hardcoded:
- The description and body intro present the shipped lenses as examples and
  point at whatever {workflow.lenses} resolves to. Docs carry a matching note
  in all five locales.

Also:
- Document the `lenses=` directive form in Inputs and in the four bmm
  doc_standards comments that use it.
- module-help.csv review row rewritten to the house "Use to..." convention,
  naming the reviewable content types and the situations that should trigger
  a suggestion.
- Shim customize.toml trimmed to a lean legacy-key surface with empty
  defaults, so unset keys fall through to bmad-review and project-context.md
  is no longer loaded twice.
- Redundant `when` clauses dropped where applies_to already encodes the rule.
- Core skill count corrected to seven/four and the edge-case applies_to cell
  fixed to match its actual value, across all five locales.
2026-07-19 18:40:47 -05:00

15 KiB
Raw Permalink Blame History

title, description, sidebar
title description sidebar
Outils Principaux Référence des compétences intégrées du module principal.
order
3

Chaque installation BMad comprend le module principal — un petit ensemble de compétences qui fonctionnent dans tous les projets, tous les modules et toutes les phases. Cette page couvre ces sept compétences principales : les quatre outils du noyau plus les trois compétences de réflexion (brainstorming, forge idea, party mode).

:::tip[Raccourci Rapide] Exécutez nimporte quel outil en tapant son nom de compétence (par ex., bmad-help) dans votre IDE. Aucune session dagent requise. :::

Vue densemble

Module principal (toujours installé) :

Outil Objectif
bmad-help Obtenir des conseils contextuels sur la prochaine étape
bmad-advanced-elicitation Soumettre la sortie LLM à des méthodes de raffinement itératives
bmad-review Revue multi-perspectives — contradictoire, cas limites et lacunes de vérification pour le code ; structure et prose pour les documents
bmad-customize Créer et vérifier des personnalisations BMad

Compétences de réflexion :

Outil Objectif
bmad-brainstorming Faciliter des sessions de brainstorming interactives
bmad-forge-idea Éprouver une idée jusquà ce quelle se consolide, se confirme ou meure à moindre coût
bmad-party-mode Orchestrer des discussions de groupe multi-agents

:::note[Déplacés et supprimés] bmad-spec fait désormais partie du module BMM comme workflow de planification de Phase 2 — voir la Carte des Workflows. Les utilitaires bmad-shard-doc et bmad-index-docs ont été supprimés. Les anciennes compétences bmad-editorial-review, bmad-editorial-review-prose, bmad-editorial-review-structure, bmad-review-adversarial-general, bmad-review-edge-case-hunter et bmad-review-verification-gap sont toutes fusionnées dans bmad-review, dont les perspectives éditoriales remplacent la compétence éditoriale séparée ; les anciens identifiants restent résolus via des redirections pour la compatibilité. :::

bmad-help

Votre guide intelligent pour la suite. — Inspecte létat de votre projet, détecte ce qui a été fait et recommande la prochaine étape requise ou facultative.

À utiliser quand :

  • Vous avez terminé un workflow et voulez savoir quoi faire ensuite
  • Vous êtes nouveau sur BMad et avez besoin dorientation
  • Vous êtes bloqué et voulez des conseils contextuels
  • Vous avez installé de nouveaux modules et voulez voir ce qui est disponible

Fonctionnement :

  1. Analyse votre projet pour détecter les artefacts existants (PRD, architecture, stories, etc.)
  2. Détecte quels modules sont installés et leurs workflows disponibles
  3. Recommande les prochaines étapes par ordre de priorité — étapes requises dabord, puis facultatives
  4. Présente chaque recommandation avec la commande de compétence et une brève description

Entrée : Requête optionnelle en langage naturel (par ex., bmad-help J'ai une idée de SaaS, par où commencer ?)

Sortie : Liste priorisée des prochaines étapes recommandées avec les commandes de compétence

bmad-advanced-elicitation

Pousse le LLM à reconsidérer, raffiner et améliorer sa sortie récente. — Le point de contrôle de raffinement partagé de BMad : dautres compétences linvoquent aux pauses naturelles, et vous pouvez lappeler directement sur tout contenu récent de la conversation.

À utiliser quand :

  • La sortie du LLM semble superficielle ou générique
  • Vous voulez explorer un sujet sous plusieurs angles analytiques
  • Vous raffinez un document critique et souhaitez une réflexion plus approfondie
  • Vous voulez une méthode connue par son nom — socratique, premiers principes, pré-mortem, red team

Fonctionnement :

  1. Cible la sortie la plus récente de la conversation, sauf si vous la pointez ailleurs
  2. Propose un court menu de méthodes délicitation adaptées au contenu
  3. Applique les méthodes choisies sur la cible
  4. Restitue la version améliorée pour que le flux appelant reprenne où il sétait arrêté

Entrée : La sortie récente à raffiner (par défaut), ou tout contenu que vous désignez ; éventuellement une méthode nommée

Sortie : Version améliorée du contenu avec les améliorations appliquées

bmad-review

Revue multi-perspectives sur tout diff, document ou artefact. — Exécute des perspectives de revue — chacune avec sa méthode et sa posture propres — et rapporte chaque constatation dans un format canonique unique. Zéro constatation est un résultat valide ; il ne remplit jamais pour paraître exhaustif. Chaque perspective déclare ce à quoi elle sapplique : un diff appelle les perspectives de code, un document les perspectives éditoriales.

Les perspectives livrées :

Perspective Sapplique à Méthode
Contradictoire Tout contenu Revue sceptique qui part du principe que des problèmes existent — traque ce qui manque, pas seulement ce qui ne va pas
Cas limites Tout contenu Parcourt chaque chemin de branchement et condition aux limites dun contenu qui définit un comportement
Lacunes de vérification Code Trouve les comportements modifiés qui pourraient régresser sans quune vérification fiable ne le détecte
Structure Documents Propose coupes, fusions, déplacements et condensations — la forme du document sert-elle son objectif ?
Prose Documents Corrige les problèmes de communication qui nuisent à la compréhension

Les deux perspectives éditoriales tiennent le contenu pour sacro-saint : elles ne remettent jamais en cause vos idées, seulement leur organisation et leur expression, et elles proposent sans exécuter. La perspective prose sexécute sur les constatations de la perspective structure lorsque les deux sont sélectionnées.

Lensemble nest pas figé : une surcharge dans customize.toml peut ajouter des perspectives ou remplacer celles fournies, et une revue exécute celles qui sont effectivement résolues.

À utiliser quand :

  • Vous avez besoin dassurance qualité avant de finaliser un livrable
  • Vous voulez une couverture exhaustive des cas limites dun code ou dune logique
  • Vous voulez savoir si un changement est correctement vérifié
  • Vous avez rédigé un document et voulez le resserrer et le polir
  • Vous voulez réduire la longueur en préservant la compréhension

Fonctionnement :

  1. Charge le contenu, identifie son type — diff, fichier, fonction ou document — et sil sagit de code ou de documentation
  2. Sélectionne les perspectives : celles que vous nommez, ou toutes les perspectives activées dont lapplicabilité et les conditions correspondent au contenu
  3. Annonce le plan — quelles perspectives vont sexécuter, et lesquelles sappuient sur les constatations dune autre
  4. Exécute les perspectives indépendantes — en parallèle via des sous-agents lorsque la plateforme le permet — puis celles qui en dépendent
  5. Assemble une liste unique de constatations ; le chevauchement entre perspectives est un signal, pas une duplication

Entrée :

  • content (requis) — Diff, branche, changements non commités, fichier, spécification, story ou tout document
  • lenses (optionnel) — un ou plusieurs codes ou noms de perspectives ; par défaut, revue complète
  • also_consider (optionnel) — Domaines supplémentaires à garder à lesprit
  • style_guide / reader_type (optionnel, perspectives éditoriales) — un guide de style projet, et humans (défaut) ou llm

Sortie : Liste de constatations JSON (chaque constatation porte lens, location, trigger_condition, guard_snippet, potential_consequence) et/ou rapport markdown groupé par perspective

:::note[Utilisé par dautres workflows] Les workflows de Code Review dautres modules exécutent les perspectives de code automatiquement, et les workflows documentaires (PRD, UX, architecture, brief produit) exécutent les perspectives éditoriales à létape de finalisation. Des perspectives personnalisées peuvent être ajoutées — et celles livrées ajustées ou désactivées — via le customize.toml de la compétence. :::

bmad-customize

Créer et vérifier des personnalisations. — Vous aide à modifier le comportement dun agent ou dun workflow BMad installé sans avoir à écrire de TOML manuellement.

À utiliser quand :

  • Vous souhaitez modifier le comportement dun agent ou dun workflow
  • Vous devez ajouter des faits persistants, des hooks dactivation ou des éléments de menu personnalisés
  • Vous voulez que le bon périmètre de surcharge soit sélectionné et vérifié automatiquement

Fonctionnement :

  1. Analyse les skills BMad installés pour identifier les surfaces personnalisables
  2. Sélectionne le bon périmètre pour le changement demandé
  3. Écrit les fichiers de surcharge sous _bmad/custom/
  4. Vérifie la configuration fusionnée

Entrée : Description en langage naturel de la personnalisation souhaitée

Sortie : Fichiers de surcharge TOML sous _bmad/custom/

Pour un guide détaillé sur la personnalisation de BMad, consultez Comment personnaliser BMad.

Compétences de Réflexion

Les trois compétences ci-dessous complètent le module principal — des outils de réflexion généralistes sur lesquels toute phase ou tout module peut sappuyer.

bmad-brainstorming

Génère des idées variées grâce à des techniques créatives interactives. — Une session de brainstorming facilitée qui charge des méthodes didéation éprouvées à partir dune bibliothèque de techniques et vous guide vers plus de 100 idées avant de les organiser.

À utiliser quand :

  • Vous commencez un nouveau projet et devez explorer lespace problème
  • Vous êtes bloqué dans la génération didées et avez besoin de créativité structurée
  • Vous voulez utiliser des cadres didéation éprouvés (SCAMPER, brainstorming inversé, etc.)

Fonctionnement :

  1. Configure une session de brainstorming avec votre sujet
  2. Charge les techniques créatives à partir dune bibliothèque de méthodes
  3. Vous guide de technique en technique, en générant des idées
  4. Applique un protocole anti-biais — bascule de domaine créatif toutes les 10 idées pour éviter les biais de regroupement

Entrée : Sujet de brainstorming ou énoncé de problème, fichier de contexte optionnel

Sortie : un brainstorm.html autonome comme souvenir de la session, un brainstorm-intent.md optionnel pour les compétences en aval, et un enregistrement de session .memlog.md

:::note[Cible de Quantité] La magie se produit dans les idées 50100. Le workflow encourage la génération de plus de 100 idées avant organisation. :::

bmad-forge-idea

Éprouve une idée jusquà ce quelle se consolide, se confirme ou meure à moindre coût. — Un interrogateur contradictoire fait avancer une idée à moitié formée une question à la fois, en amenant deux personnages à chaque embranchement, jusquà ce que ce qui survit soit quelque chose sur quoi vous pouvez agir avec conviction.

À utiliser quand :

  • Vous tenez une idée et voulez la mettre à lépreuve avant dy investir
  • Vous voulez un avis honnête sur lopportunité de labandonner
  • Vous avez besoin dun partenaire de réflexion qui résiste au lieu dacquiescer

Fonctionnement :

  1. Établit lobjectif dès le départ et oriente le questionnement en conséquence
  2. Travaille une question à la fois, dans lordre des dépendances, en posant une réponse recommandée à contester
  3. Amène deux voix à chaque embranchement — une de votre effectif installé, une évoquée par le sujet
  4. Conteste les termes flous et confronte les affirmations au matériau dun projet existant
  5. Aboutit à Consolidée, Abandonnée ou Clarifiée, avec un rapport autonome que vous pouvez conserver

Entrée : Lidée, dans nimporte quel domaine — une fonctionnalité, un modèle économique, une hypothèse de recherche, une décision de vie

Sortie : Un distillat forged-idea.md quand une idée se consolide (optionnel), plus un souvenir forge-report.html à chaque exécution

bmad-party-mode

Orchestre des discussions de groupe multi-agents. — Charge tous les agents BMad installés et facilite une conversation naturelle où chaque agent apporte son expertise et sa personnalité uniques.

À utiliser quand :

  • Vous avez besoin de multiples perspectives dexperts sur une décision
  • Vous voulez que les agents remettent en question les hypothèses des autres
  • Vous explorez un sujet complexe qui couvre plusieurs domaines

Fonctionnement :

  1. Charge le manifeste dagents avec toutes les personnalités dagents installées
  2. Analyse votre sujet pour sélectionner les 23 agents les plus pertinents
  3. Les agents contribuent à tour de rôle, avec des échanges spontanés et des désaccords
  4. Alterne la participation des agents pour garantir des perspectives variées
  5. Quittez avec goodbye, end party ou quit

Entrée : Sujet de discussion ou question, ainsi que la spécification des personas que vous souhaitez faire participer (optionnel)

Sortie : Conversation multi-agents en temps réel conservant la personnalité de chaque agent