BMAD-METHOD/docs/fr/how-to/customize-bmad.md

title	description	sidebar
Comment personnaliser BMad	Personnalisez les agents, les workflows et les modules tout en préservant la compatibilité avec les mises à jour	order 7

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

:::note[Prérequis]

• BMad installé dans votre projet (voir Comment installer BMad)
• Un éditeur de texte pour les fichiers YAML :::

:::caution[Protégez vos personnalisations] Utilisez toujours les fichiers .customize.yaml décrits ici plutôt que de modifier directement les fichiers d'agents. L'installateur écrase les fichiers d'agents lors des mises à jour, mais préserve vos modifications dans les fichiers .customize.yaml. :::

É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 Hasslehoff'
  - '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, recompilez l'agent 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 recompile tous les agents
Recompile Agents	Applique uniquement les personnalisations, sans mettre à jour les fichiers de modules
Modify BMad Installation	Flux d'installation complet pour ajouter ou supprimer des modules

Pour des modifications de personnalisation uniquement, Recompile Agents 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 Recompile Agents 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 Recompile Agents 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

---

1. 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. ↩︎