Comment personnaliser BMad

Utilisez les fichiers .customize.yaml pour adapter le comportement, les personas¹ et les menus des agents tout en préservant vos modifications lors des mises à jour.

Quand utiliser cette fonctionnalité

Vous souhaitez modifier le nom, la personnalité ou le style de communication d’un agent
Vous avez besoin que les agents se souviennent du contexte spécifique au projet
Vous souhaitez ajouter des éléments de menu personnalisés qui déclenchent vos propres workflows ou prompts
Vous voulez que les agents effectuent des actions spécifiques à chaque démarrage

Étapes

1. Localiser les fichiers de personnalisation

Après l’installation, vous trouverez un fichier .customize.yaml par agent dans :

_bmad/_config/agents/
├── bmm-analyst.customize.yaml
├── bmm-architect.customize.yaml
└── ... (un fichier par agent installé)

2. Modifier le fichier de personnalisation

Ouvrez le fichier .customize.yaml de l’agent que vous souhaitez modifier. Chaque section est facultative — personnalisez uniquement ce dont vous avez besoin.

Section	Comportement	Objectif
`agent.metadata`	Remplace	Remplacer le nom d’affichage de l’agent
`persona`	Remplace	Définir le rôle, l’identité, le style et les principes
`memories`	Ajoute	Ajouter un contexte persistant que l’agent se rappelle toujours
`menu`	Ajoute	Ajouter des éléments de menu personnalisés pour les workflows ou prompts
`critical_actions`	Ajoute	Définir les instructions de démarrage de l’agent
`prompts`	Ajoute	Créer des prompts réutilisables pour les actions du menu

Les sections marquées Remplace écrasent entièrement les valeurs par défaut de l’agent. Les sections marquées Ajoute s’ajoutent à la configuration existante.

Nom de l’agent

Modifier la façon dont l’agent se présente :

agent:
  metadata:
    name: 'Bob l’éponge' # Par défaut : "Mary"

Persona

Remplacer la personnalité, le rôle et le style de communication de l’agent :

persona:
  role: 'Ingénieur Full-Stack Senior'
  identity: 'Habite dans un ananas (au fond de la mer)'
  communication_style: 'Style agaçant de Bob l’Éponge'
  principles:
    - 'Jamais de nidification, les devs Bob l’Éponge détestent plus de 2 niveaux d’imbrication'
    - 'Privilégier la composition à l’héritage'

La section persona¹ remplace entièrement le persona par défaut, donc incluez les quatre champs si vous la définissez.

Souvenirs

Ajouter un contexte persistant que l’agent gardera toujours en mémoire :

memories:
  - 'Travaille au Krusty Krab'
  - 'Célébrité préférée : David Hasselhoff'
  - 'Appris dans l’Epic 1 que ce n’est pas cool de faire semblant que les tests ont passé'

Éléments de menu

Ajouter des entrées personnalisées au menu d’affichage de l’agent. Chaque élément nécessite un trigger, une cible (chemin workflow ou référence action), et une description :

menu:
  - trigger: my-workflow
    workflow: 'my-custom/workflows/my-workflow.yaml'
    description: Mon workflow personnalisé
  - trigger: deploy
    action: '#deploy-prompt'
    description: Déployer en production

Actions critiques

Définir des instructions qui s’exécutent au démarrage de l’agent :

critical_actions:
  - 'Vérifier les pipelines CI avec le Skill XYZ et alerter l’utilisateur au réveil si quelque chose nécessite une attention urgente'

Prompts personnalisés

Créer des prompts réutilisables que les éléments de menu peuvent référencer avec action="#id" :

prompts:
  - id: deploy-prompt
    content: |
      Déployer la branche actuelle en production :
      1. Exécuter tous les tests
      2. Build le projet
      3. Exécuter le script de déploiement

3. Appliquer vos modifications

Après modification, réinstallez pour appliquer les changements :

npx bmad-method install

L’installateur détecte l’installation existante et propose ces options :

Option	Ce qu’elle fait
Quick Update	Met à jour tous les modules vers la dernière version et applique les personnalisations
Modify BMad Installation	Flux d’installation complet pour ajouter ou supprimer des modules

Pour des modifications de personnalisation uniquement, Quick Update est l’option la plus rapide.

Résolution des problèmes

Les modifications n’apparaissent pas ?

Exécutez npx bmad-method install et sélectionnez Quick Update pour appliquer les modifications
Vérifiez que votre syntaxe YAML est valide (l’indentation compte)
Assurez-vous d’avoir modifié le bon fichier .customize.yaml pour l’agent

L’agent ne se charge pas ?

Vérifiez les erreurs de syntaxe YAML à l’aide d’un validateur YAML en ligne
Assurez-vous de ne pas avoir laissé de champs vides après les avoir décommentés
Essayez de revenir au modèle d’origine et de reconstruire

Besoin de réinitialiser un agent ?

Effacez ou supprimez le fichier .customize.yaml de l’agent
Exécutez npx bmad-method install et sélectionnez Quick Update pour restaurer les valeurs par défaut

Personnalisation des workflows

La personnalisation des workflows et skills existants de la méthode BMad arrive bientôt.

Personnalisation des modules

Les conseils sur la création de modules d’extension et la personnalisation des modules existants arrivent bientôt.

Glossaire

Persona : définition de la personnalité, du rôle et du style de communication d’un agent IA. Permet d’adapter le comportement et les réponses de l’agent selon les besoins du projet. ↩ ↩²