Brian
aa6dece05d
* feat(bmad-spec): add Spec kernel distiller skill
New 2-plan-workflows skill that distills any intent input (brain dump,
PRD, transcript, brief) into a spec.md carrying the five-field kernel:
Problem, Capabilities, Constraints, Non-goals, Success signal. Headless
callers receive JSON; interactive runs close conversationally with the
spec path and gap-coverage invitations.
Includes:
- SKILL.md with activation contract and conventions
- customize.toml exposing template path, output path, run-folder pattern
- assets/spec-template.md (five-field skeleton)
- assets/headless-schemas.md (JSON IO contracts)
* remove brain-dump fallback config from bmad-spec customize.toml
* refactor(bmad-spec): companions+sources model, routing tilt, flat output path
- Collapse `related:` into `companions:`; companion paths may point inside the spec folder (spec-authored) or outside it (adopted from an upstream skill), distinguished implicitly by path
- `sources:` reserved for fully-absorbed inputs; downstream does NOT read these
- Soften mutation contract: bmad-spec owns SPEC.md and spec-authored companions; adopted companions belong to their originating skill
- Add "when to spawn a companion" tilt: multi-item catalogs, tables, diagrams (always), editorial voice rules; sub-bullets in a kernel field signal it has outgrown the kernel
- Fix Spec Law rule 7 and Pass 2: load-bearing content lands in SPEC.md or a companion, not the decision log (the log records wrapper-drops only)
- Flatten output path to `{planning_artifacts}/specs/spec-{slug}-{date}/`, mirroring `prds/` and `ux-designs/`; drop `spec_folder_name` (no longer used)
- Extract Load-bearing definition into its own section above Spec Law
* chore(core): retire bmad-distillator, promote bmad-spec to core
- Delete bmad-distillator/ and all registry + doc references (superseded by bmad-spec; no skill or workflow in any BMad module invoked it)
- Add bmad-distillator to removals.txt so installer cleans it from existing IDE skill directories on update
- Move bmad-spec from bmm-skills/2-plan-workflows/ to core-skills/ (universal scope: game design, research hypotheses, editorial briefs, policy, business plans, not just software)
- Register bmad-spec in core module-help.csv and bmad-pro-skills marketplace plugin
- Drop bmad-distillator section from core-tools.md (en, vi-vn, cs, fr, zh-cn) and vi-vn dev guide; renumber subsequent sections
* refactor(bmad-spec): add lean-prose discipline + generalize help text
- Add Spec Law rule 8: lean prose. Every sentence carries load-bearing content; cut decoration, hedges, backstory, throat-clearing. Applies to SPEC.md, companions, and decision log.
- Update Self-Validate Pass 1 to enforce rules 1-6 and 8 (rule 7 stays in Pass 2)
- Prime the operation up-front: write lean from the first pass, every sentence must earn its place
- Note in Companions section that companions follow the same lean discipline
- Generalize core module-help.csv entry: domain-agnostic framing (software, game design, research, editorial, policy, business, anything intent-bearing); call out succinct, no-fluff and "locks the WHAT before the HOW" as the value props
* fix(bmad-spec): address PR review findings (CodeRabbit + Augment)
- headless-schemas.md: rewrite spec_path examples to point at the spec folder (not a file), rename source_artifact to sources[] array, add companions[] array, update verdict from "six rules" to "eight rules", disambiguate reason requirement (only when status=blocked)
- SKILL.md activation: fix config path from {project-root}/_bmad/config.yaml to {project-root}/_bmad/core/config.yaml (matches other BMM skills)
- customize.toml + SKILL.md Workspace: drop {date} from default run_folder_pattern (spec-{slug}); same slug = same folder = trivial in-place update, no glob-and-pick-most-recent needed. Override available for users who want dated history.
- spec-template.md: rename "## Success signals" (plural) to "## Success signal" (singular) to match SKILL.md kernel naming
- SKILL.md Frontmatter conventions: fix adopted-companion example path from _bmad-output/ux-designs/foo-ux/DESIGN.md to ../../ux-designs/ux-foo-bar-2026-05-23/DESIGN.md (matches actual flat-output convention)
- SKILL.md Spec Law: fix double-period typo in rule 2 ((stack, conventions)..)
- SKILL.md Overview: fix awkward "bloat with expansive line item details the kernel" phrasing; drop software-flavored downstream consumer list since bmad-spec is now a core skill serving any domain
* fix(bmad-spec): drop {planning_artifacts} dependency; output to {output_folder}/specs
bmad-spec is a core skill but its default path used {planning_artifacts}, a bmm-module variable. Core-only installs (no bmm) would fail at activation when the resolver tried to expand the path.
Land specs directly under {output_folder}/specs/spec-{slug}/ instead. Works in any install regardless of installed modules, and aligns with the long-term BMad direction of grouping artifacts as siblings under {output_folder}/<type>/ rather than nested under planning vs implementation parents.
In bmm installs, adopted-companion paths from spec to UX/PRD pick up one extra .. (e.g., ../planning-artifacts/ux-designs/<run>/DESIGN.md) since the spec folder is now one level up from planning-artifacts. Examples in SKILL.md and headless-schemas.md updated. module-help.csv output-location updated and stale -{date} fragment removed.
* docs(bmad-spec): add reference docs, trim headless schema, tighten defaults
- Add full bmad-spec entry to docs/reference/core-tools.md and table-row
stubs to cs/fr/vi-vn/zh-cn (full translation pending).
- Strip headless-schemas.md to a minimal {status, files} success response
and {status, error_code, reason} blocked response. Drop spec_path,
capabilities, verdict, decision_log_path — all derivable from the files
themselves.
- Narrow customize.toml persistent_facts default from recursive glob to
single {project-root}/project-context.md; document override path.
- Drop unused {doc_workspace} convention line from SKILL.md.
- Clarify Self-Validate verdict handling for interactive vs headless.
- Document missing_slug error code in SKILL.md + headless schema.
15 KiB
title, description, sidebar
| title | description | sidebar | ||
|---|---|---|---|---|
| Outils Principaux | Référence pour toutes les tâches et tous les workflows intégrés disponibles dans chaque installation BMad sans modules supplémentaires. |
|
Chaque installation BMad comprend un ensemble de compétences principales qui peuvent être utilisées conjointement avec tout ce que vous faites — des tâches et des workflows autonomes qui fonctionnent dans tous les projets, tous les modules et toutes les phases. Ceux-ci sont toujours disponibles, quels que soient les modules optionnels que vous installez.
:::tip[Raccourci Rapide]
Exécutez n'importe quel outil principal en tapant son nom de compétence (par ex., bmad-help) dans votre IDE. Aucune session d'agent requise.
:::
Vue d'ensemble
| Outil | Type | Objectif |
|---|---|---|
bmad-help |
Tâche | Obtenir des conseils contextuels sur la prochaine étape |
bmad-brainstorming |
Workflow | Faciliter des sessions de brainstorming interactives |
bmad-party-mode |
Workflow | Orchestrer des discussions de groupe multi-agents |
bmad-spec |
Workflow | Distill any intent input into a SPEC kernel and companions (translation pending) |
bmad-advanced-elicitation |
Tâche | Pousser la sortie LLM à travers des méthodes de raffinement itératives |
bmad-review-adversarial-general |
Tâche | Revue cynique qui trouve ce qui manque et ce qui ne va pas |
bmad-review-edge-case-hunter |
Tâche | Analyse exhaustive des chemins de branchement pour les cas limites non gérés |
bmad-editorial-review-prose |
Tâche | Révision de copie clinique pour la clarté de communication |
bmad-editorial-review-structure |
Tâche | Édition structurelle — coupes, fusions et réorganisation |
bmad-shard-doc |
Tâche | Diviser les fichiers markdown volumineux en sections organisées |
bmad-index-docs |
Tâche | Générer ou mettre à jour un index de tous les documents dans un dossier |
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.
Utilisez-le quand :
- Vous avez terminé un workflow et voulez savoir ce qui suit
- 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 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-brainstorming
Génère des idées diverses à travers des techniques créatives interactives. — Une session de brainstorming facilitée qui charge des méthodes d'idéation éprouvées depuis une bibliothèque de techniques et vous guide vers plus de 100 idées avant organisation.
Utilisez-le 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 depuis une bibliothèque de méthodes
- Vous guide à travers technique après technique, générant des idées
- Applique un protocole anti-biais — change de domaine créatif toutes les 10 idées pour éviter le regroupement
- Produit un document de session en mode ajout uniquement avec toutes les idées organisées par technique
Entrée : Sujet de brainstorming ou énoncé de problème, fichier de contexte optionnel
Sortie : brainstorming-session-{date}.md avec toutes les idées générées
:::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-party-mode
Orchestre des discussions de groupe multi-agents. — Charge tous les agents BMad installés et facilite une conversation naturelle où chaque agent contribue depuis son expertise et personnalité uniques.
Utilisez-le 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 prennent des tours pour contribuer, avec des échanges naturels et des désaccords
- Fait rouler la participation des agents pour assurer des perspectives diverses au fil du temps
- 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 avec des personnalités d'agents maintenues
bmad-advanced-elicitation
Passer la sortie du LLM à travers des méthodes de raffinement itératives. — Sélectionne depuis une bibliothèque de techniques d'élicitation pour améliorer systématiquement le contenu à travers multiples passages.
Utilisez-le quand :
- La sortie du LLM semble superficielle ou générique
- Vous voulez explorer un sujet depuis de multiples angles analytiques
- Vous raffinez un document critique et voulez une réflexion plus approfondie
Fonctionnement :
- Charge le registre de méthodes avec plus de 5 techniques d'élicitation
- Sélectionne les 5 méthodes les mieux adaptées selon le type de contenu et la complexité
- Présente un menu interactif — choisissez une méthode, remélangez, ou listez tout
- Applique la méthode sélectionnée pour améliorer le contenu
- Re-présente les options pour l'amélioration itérative jusqu'à ce que vous sélectionniez "Procéder"
Entrée : Section de contenu à améliorer
Sortie : Version améliorée du contenu avec les améliorations appliquées
bmad-review-adversarial-general
Revue contradictoire qui suppose que des problèmes existent et les recherche. — Adopte une perspective de réviseur sceptique et blasé avec zéro tolérance pour le travail bâclé. Cherche ce qui manque, pas seulement ce qui ne va pas.
Utilisez-le quand :
- Vous avez besoin d'assurance qualité avant de finaliser un livrable
- Vous voulez tester en conditions réelles une spécification, story ou document
- Vous voulez trouver des lacunes de couverture que les revues optimistes manquent
Fonctionnement :
- Lit le contenu avec une perspective contradictoire et critique
- Identifie les problèmes à travers l'exhaustivité, la justesse et la qualité
- Recherche spécifiquement ce qui manque — pas seulement ce qui est présent et faux
- Doit trouver un minimum de 10 problèmes ou réanalyse plus profondément
Entrée :
content(requis) — Diff, spécification, story, document ou tout artefactalso_consider(optionnel) — Domaines supplémentaires à garder à l'esprit
Sortie : Liste markdown de plus de 10 constatations avec descriptions
bmad-review-edge-case-hunter
Parcours tous les chemins de branchement et les conditions limites, ne rapporte que les cas non gérés. — Méthodologie pure de traçage de chemin1 qui dérive mécaniquement les classes de cas limites. Orthogonale à la revue contradictoire — centrée sur la méthode, pas sur l'attitude.
À utiliser quand :
- Vous souhaitez une couverture exhaustive des cas limites pour le code ou la logique
- Vous avez besoin d'un complément à la revue contradictoire (méthodologie différente, résultats différents)
- Vous révisez un diff ou une fonction pour des conditions limites
Fonctionnement :
- Énumère tous les chemins de branchement dans le contenu
- Dérive mécaniquement les classes de cas limites : else/default manquants, entrées non vérifiées, décalage d’unité, overflow arithmétique, coercition implicite des types, conditions de concurrence, écarts de timeout
- Teste chaque chemin contre les protections existantes
- Ne rapporte que les chemins non gérés — ignore silencieusement les chemins gérés
Entrée :
content(obligatoire) — Diff, fichier complet ou fonctionalso_consider(facultatif) — Zones supplémentaires à garder à l’esprit
Sortie : Tableau JSON des résultats, chacun avec location, trigger_condition, guard_snippet et potential_consequence
:::note[Revue Complémentaire]
Exécutez à la fois bmad-review-adversarial-general et bmad-review-edge-case-hunter pour une couverture orthogonale. La revue contradictoire détecte les problèmes de qualité et de complétude ; le chasseur de cas limites détecte les chemins non gérés.
:::
bmad-editorial-review-prose
Relecture éditoriale clinique centrée sur la clarté de communication. — Analyse le texte pour détecter les problèmes qui nuisent à la compréhension. Applique le Microsoft Writing Style Guide baseline. Préserve la voix de l’auteur.
À utiliser quand :
- Vous avez rédigé un document et souhaitez polir le style
- Vous devez assurer la clarté pour un public spécifique
- Vous voulez des corrections de communication sans modifier les choix stylistiques
Fonctionnement :
- Lit le contenu en ignorant les blocs de code et le frontmatter
- Identifie les problèmes de communication (pas les préférences de style)
- Déduit les doublons du même problème à différents emplacements
- Produit un tableau de corrections en trois colonnes
Entrée :
content(obligatoire) — Markdown, texte brut ou XMLstyle_guide(facultatif) — Guide de style spécifique au projetreader_type(facultatif) —humans(par défaut) pour clarté/fluide, oullmpour précision/consistance
Sortie : Tableau Markdown en trois colonnes : Texte original | Texte révisé | Modifications
bmad-editorial-review-structure
Édition structurelle — propose des coupes, fusions, déplacements et condensations. — Révise l'organisation du document et propose des changements substantiels pour améliorer la clarté et le flux avant la révision de copie.
Utilisez-le quand :
- Un document a été produit depuis de multiples sous-processus et a besoin de cohérence structurelle
- Vous voulez réduire la longueur du document tout en préservant la compréhension
- Vous devez identifier les violations de portée ou les informations critiques enfouies
Fonctionnement :
- Analyse le document contre 5 modèles de structure (Tutoriel, Référence, Explication, Prompt, Stratégique)
- Identifie les redondances, violations de portée et informations enfouies
- Produit des recommandations priorisées : COUPER, FUSIONNER, DÉPLACER, CONDENSER, QUESTIONNER, PRÉSERVER
- Estime la réduction totale en mots et pourcentage
Entrée :
content(requis) — Document à réviserpurpose(optionnel) — Objectif prévu (par ex., "tutoriel de démarrage rapide")target_audience(optionnel) — Qui lit cecireader_type(optionnel) —humansoullmlength_target(optionnel) — Réduction cible (par ex., "30% plus court")
Sortie : Résumé du document, liste de recommandations priorisées et réduction estimée
bmad-shard-doc
Diviser les fichiers markdown volumineux en fichiers de sections organisés. — Utilise les en-têtes de niveau 2 comme points de division pour créer un dossier de fichiers de sections autonomes avec un index.
Utilisez-le quand :
- Un document markdown est devenu trop volumineux pour être géré efficacement (plus de 500 lignes)
- Vous voulez diviser un document monolithique en sections navigables
- Vous avez besoin de fichiers séparés pour l'édition parallèle ou la gestion de contexte LLM
Fonctionnement :
- Valide que le fichier source existe et est markdown
- Divise sur les en-têtes de niveau 2 (
##) en fichiers de sections numérotées - Crée un
index.mdavec manifeste de sections et liens - Vous invite à supprimer, archiver ou conserver l'original
Entrée : Chemin du fichier markdown source, dossier de destination optionnel
Sortie : Dossier avec index.md et 01-{section}.md, 02-{section}.md, etc.
bmad-index-docs
Générer ou mettre à jour un index de tous les documents dans un dossier. — Analyse un répertoire, lit chaque fichier pour comprendre son objectif et produit un index.md organisé avec liens et descriptions.
Utilisez-le quand :
- Vous avez besoin d'un index léger pour un scan LLM rapide des documents disponibles
- Un dossier de documentation a grandi et a besoin d'une table des matières organisée
- Vous voulez un aperçu auto-généré qui reste à jour
Fonctionnement :
- Analyse le répertoire cible pour tous les fichiers non cachés
- Lit chaque fichier pour comprendre son objectif réel
- Groupe les fichiers par type, objectif ou sous-répertoire
- Génère des descriptions concises (3–10 mots chacune)
Entrée : Chemin du dossier cible
Sortie : index.md avec listes de fichiers organisées, liens relatifs et brèves descriptions
Glossaire
-
Path-tracing : méthode d'analyse qui suit systématiquement tous les chemins d'exécution possibles dans un programme pour identifier les cas non gérés. ↩︎