* 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.
15 KiB
title, description, sidebar
| title | description | sidebar | ||
|---|---|---|---|---|
| Outils Principaux | Référence des compétences intégrées du module principal. |
|
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 n’importe quel outil en tapant son nom de compétence (par ex., bmad-help) dans votre IDE. Aucune session d’agent requise.
:::
Vue d’ensemble
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 qu’elle 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 d’orientation
- Vous êtes bloqué et voulez des conseils contextuels
- Vous avez installé de nouveaux modules et voulez voir ce qui est disponible
Fonctionnement :
- Analyse votre projet pour détecter les artefacts existants (PRD, architecture, stories, etc.)
- Détecte quels modules sont installés et leurs workflows disponibles
- Recommande les prochaines étapes par ordre de priorité — étapes requises d’abord, puis facultatives
- 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 : d’autres compétences l’invoquent aux pauses naturelles, et vous pouvez l’appeler 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 :
- Cible la sortie la plus récente de la conversation, sauf si vous la pointez ailleurs
- Propose un court menu de méthodes d’élicitation adaptées au contenu
- Applique les méthodes choisies sur la cible
- 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 s’applique : un diff appelle les perspectives de code, un document les perspectives éditoriales.
Les perspectives livrées :
| Perspective | S’applique à | 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 d’un contenu qui définit un comportement |
| Lacunes de vérification | Code | Trouve les comportements modifiés qui pourraient régresser sans qu’une 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 s’exécute sur les constatations de la perspective structure lorsque les deux sont sélectionnées.
L’ensemble n’est 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 d’assurance qualité avant de finaliser un livrable
- Vous voulez une couverture exhaustive des cas limites d’un code ou d’une 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 :
- Charge le contenu, identifie son type — diff, fichier, fonction ou document — et s’il s’agit de code ou de documentation
- Sélectionne les perspectives : celles que vous nommez, ou toutes les perspectives activées dont l’applicabilité et les conditions correspondent au contenu
- Annonce le plan — quelles perspectives vont s’exécuter, et lesquelles s’appuient sur les constatations d’une autre
- Exécute les perspectives indépendantes — en parallèle via des sous-agents lorsque la plateforme le permet — puis celles qui en dépendent
- 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 documentlenses(optionnel) — un ou plusieurs codes ou noms de perspectives ; par défaut, revue complètealso_consider(optionnel) — Domaines supplémentaires à garder à l’espritstyle_guide/reader_type(optionnel, perspectives éditoriales) — un guide de style projet, ethumans(défaut) oullm
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 d’autres workflows]
Les workflows de Code Review d’autres 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 d’un agent ou d’un workflow BMad installé sans avoir à écrire de TOML manuellement.
À utiliser quand :
- Vous souhaitez modifier le comportement d’un agent ou d’un workflow
- Vous devez ajouter des faits persistants, des hooks d’activation 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 :
- Analyse les skills BMad installés pour identifier les surfaces personnalisables
- Sélectionne le bon périmètre pour le changement demandé
- Écrit les fichiers de surcharge sous
_bmad/custom/ - 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 s’appuyer.
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 d’idéation éprouvées à partir d’une 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 l’espace problème
- Vous êtes bloqué dans la génération d’idées et avez besoin de créativité structurée
- Vous voulez utiliser des cadres d’idéation éprouvés (SCAMPER, brainstorming inversé, etc.)
Fonctionnement :
- Configure une session de brainstorming avec votre sujet
- Charge les techniques créatives à partir d’une bibliothèque de méthodes
- Vous guide de technique en technique, en générant des idées
- 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 50–100. Le workflow encourage la génération de plus de 100 idées avant organisation. :::
bmad-forge-idea
Éprouve une idée jusqu’à ce qu’elle 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 d’y investir
- Vous voulez un avis honnête sur l’opportunité de l’abandonner
- Vous avez besoin d’un partenaire de réflexion qui résiste au lieu d’acquiescer
Fonctionnement :
- Établit l’objectif dès le départ et oriente le questionnement en conséquence
- Travaille une question à la fois, dans l’ordre des dépendances, en posant une réponse recommandée à contester
- Amène deux voix à chaque embranchement — une de votre effectif installé, une évoquée par le sujet
- Conteste les termes flous et confronte les affirmations au matériau d’un projet existant
- Aboutit à Consolidée, Abandonnée ou Clarifiée, avec un rapport autonome que vous pouvez conserver
Entrée : L’idée, dans n’importe 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 d’experts 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 :
- Charge le manifeste d’agents avec toutes les personnalités d’agents installées
- Analyse votre sujet pour sélectionner les 2–3 agents les plus pertinents
- Les agents contribuent à tour de rôle, avec des échanges spontanés et des désaccords
- Alterne la participation des agents pour garantir des perspectives variées
- Quittez avec
goodbye,end partyouquit
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