Fichier de configuration

_bmad/config.yaml est le fichier où un projet dit à BMAD+ comment se comporter : quelle langue employer, si les agents travaillent un par un ou sous l’orchestrateur Nexus, où ils doivent s’arrêter et vous attendre, comment les recettes d’acceptation humaine sont traitées et combien de sous-agents un essaim peut utiliser. bmad-plus install le crée ; vous pouvez le modifier à la main. Cette page liste toutes les clés qu’il écrit.

Ce que install écrit#

# BMAD+ Project Configuration
# Generated by bmad-plus install

user_name: 'Developer'
communication_language: 'Français'
document_output_language: 'Français'
output_folder: '_bmad-output'
project_name: 'demo-app'
execution_mode: 'manual'
auto_role_activation: true
parallel_execution: true
checkpoints:
  discovery: 'require_approval'
  architecture: 'require_approval'
  story: 'require_approval'
  delivery: 'require_approval'
uat:
  mode: 'advisory'
  granularity: 'delivery'
  environment:
    name: ''
    url: ''
  page_budget:
    max_steps: 15
    max_minutes: 30
  dir: '_bmad-output/uat'
swarm:
  budget: 26
  wave: 10
  media_credits: 'ask'

Les valeurs de user_name, communication_language et project_name viennent de l’assistant ou du dossier ; le reste correspond aux valeurs par défaut affichées. uat.environment contient name: "TEST" et l’adresse si vous avez saisi l’URL d’un environnement de test dans l’assistant.

Chaque clé#

Points de contrôle et modes d’exécution#

Un point de contrôle est un endroit du pipeline autopilot où l’orchestrateur s’arrête, vous prévient puis continue, ou continue simplement. Chacune des quatre clés prend l’une de trois valeurs.

Dans _bmad/config.yaml, passe execution_mode à autopilot, mets les points de contrôle discovery, architecture et story sur notify_only et garde delivery sur require_approval. Montre-moi ensuite le bloc modifié.

Le bloc swarm#

Le bloc swarm est la seule partie que la CLI applique. Un bloc absent, ou une clé absente, vaut les valeurs par défaut : 26 sous-agents par exécution, 10 par vague. Quand bmad-plus swarm init reçoit plus d’unités que swarm.budget sans --approved, il n’écrit rien et sort avec le code 2 : un humain décide. La génération de médias payante est hors de tout budget.

Dans _bmad/config.yaml, mets swarm.budget à 50 et laisse wave et media_credits tels quels. Relance ensuite le même swarm init sans --approved.

Comment install traite un fichier existant#

• Les clés existantes l’emportent : relancer install n’écrase jamais une valeur que vous avez changée.
• Les clés manquantes sont ajoutées avec leur valeur par défaut, y compris les clés manquantes à l’intérieur d’un bloc comme uat ou swarm. C’est ainsi qu’un projet installé avec une ancienne version gagne les blocs plus récents.
• Les réponses que vous donnez explicitement remplacent la valeur stockée : les champs de l’assistant (nom, langue de communication, mode d’exécution), --mode et l’URL d’un environnement de test.
• Dès que quelque chose change, le fichier est réécrit par un écrivain YAML sous l’en-tête « BMAD+ Project Configuration ». Les commentaires ajoutés à la main ne sont pas conservés dans ce cas.
• Si le fichier n’est pas un mapping YAML, install le laisse intact et avertit : « _bmad/config.yaml could not be parsed; it was left unchanged. »
• uninstall conserve ce fichier, car il contient vos réglages.

Erreurs possibles#