ldy26098
/
BMAD-METHOD
mirror of https://github.com/bmad-code-org/BMAD-METHOD.git
1
0
Fork 0
Code Packages Projects Releases Wiki Activity
BMAD-METHOD/docs/fr/integration-ide.md

12 KiB
Raw Blame History

Guide d'Intégration IDE - BMad Method

Ce guide explique comment utiliser les agents BMad Method dans différents environnements de développement intégrés (IDEs).

🎯 IDEs Supportés

BMad Method fonctionne avec tous les principaux IDEs supportant les agents IA :

  • ✅ Claude Code (Recommandé - meilleure intégration)
  • ✅ Cursor
  • ✅ Windsurf
  • ✅ VS Code (avec extensions IA)
  • ✅ Cline
  • ✅ Autres (Roo, Auggie, iFlow, etc.)

📋 Avant de Commencer

Assurez-vous d'avoir :

  1. ✅ Installé BMad Method : npx bmad-method@alpha install
  2. ✅ Complété la configuration interactive
  3. ✅ Vérifié que le dossier .bmad existe dans votre projet

🔵 Claude Code

Vue d'ensemble

Claude Code offre la meilleure intégration avec BMad Method via les commandes slash.

Activation des Agents

Les agents BMad sont automatiquement installés en tant que commandes slash dans .claude/commands/bmad/.

Utilisation de Base

1. Taper la Commande Slash

/

Tapez / dans le chat pour voir toutes les commandes disponibles.

2. Sélectionner un Agent

/bmad:bmm:agents:dev              # Agent développeur
/bmad:bmm:agents:architect        # Agent architecte
/bmad:bmm:agents:pm               # Agent chef de produit
/bmad:bmm:agents:sm               # Agent scrum master
/bmad:bmm:agents:ux-designer      # Agent designer UX

3. Exécuter Appuyez sur Entrée pour activer l'agent. L'agent se présentera et affichera son menu.

Exécution de Workflows

Option A : Via Commande Slash

/bmad:bmm:workflows:prd           # Workflow PRD
/bmad:bmm:workflows:dev-story     # Workflow dev story
/bmad:bmm:workflows:architecture  # Workflow architecture

Option B : Via Menu de l'Agent

# 1. Charger l'agent
/bmad:bmm:agents:pm

# 2. Attendre le menu

# 3. Sélectionner un workflow
*prd                              # Raccourci
"Créons un PRD"                   # Langage naturel

Exemples Claude Code

Exemple 1 : Initialiser un Projet

# Charger l'agent analyste
/bmad:bmm:agents:analyst

# Attendre le menu, puis :
*workflow-init

Exemple 2 : Créer un PRD

# Démarrer un nouveau chat
/bmad:bmm:agents:pm

# Attendre le menu, puis :
*prd

Exemple 3 : Implémenter une Story

# Démarrer un nouveau chat
/bmad:bmm:agents:dev

# Attendre le menu, puis :
*dev-story

Conseils Claude Code

  • ✅ Nouvelles conversations - Démarrez un nouveau chat pour chaque workflow majeur
  • ✅ Autocomplétion - Les commandes s'autocomplètent quand vous tapez /
  • ✅ L'agent reste actif - Une fois chargé, l'agent reste dans la conversation
  • ✅ Navigation de menu - Utilisez des raccourcis (*prd) ou du langage naturel

🟣 Cursor

Vue d'ensemble

Cursor utilise des règles MDC (Manual type) pour charger les agents BMad.

Activation des Agents

Les agents BMad sont installés dans .cursor/rules/bmad/ en tant que règles.

Utilisation de Base

1. Référencer dans le Chat

Utilisez la syntaxe @ pour charger les agents :

@.bmad/bmm/agents/dev             # Agent développeur
@.bmad/bmm/agents/architect       # Agent architecte
@.bmad/bmm/agents/pm              # Agent chef de produit

2. Inclure un Module Entier

@.bmad/bmm                        # Tous les agents BMM
@.bmad/cis                        # Tous les agents CIS
@.bmad/core                       # Tous les agents principaux

3. Référencer l'Index

@.bmad/index                      # Tous les agents disponibles

Exécution de Workflows

Étape 1 : Charger l'Agent

@.bmad/bmm/agents/pm

Étape 2 : Demander un Workflow

Exécute le workflow PRD

Exemples Cursor

Exemple 1 : Workflow PRD

@.bmad/bmm/agents/pm

Salut ! Créons un nouveau PRD pour mon projet.

Exemple 2 : Architecture Design

@.bmad/bmm/agents/architect

Aide-moi à créer un document d'architecture.

Exemple 3 : Agents Multiples

@.bmad/bmm/agents/dev @.bmad/bmm/agents/architect

J'ai besoin de conseils sur l'architecture et l'implémentation.

Conseils Cursor

  • ✅ Type Manuel - Les règles sont de type Manuel (chargées uniquement quand référencées)
  • ✅ Pas de pollution de contexte - Pas de contexte automatique chargé
  • ✅ Combiner les agents - Vous pouvez référencer plusieurs agents
  • ✅ Nouvelle conversation - Démarrez une nouvelle conversation pour chaque workflow majeur

🟢 Windsurf

Vue d'ensemble

Windsurf utilise un système similaire à Cursor avec des règles et références @.

Activation des Agents

Configuration similaire à Cursor. Les agents sont chargés via des références @.

Utilisation de Base

@.bmad/bmm/agents/dev             # Agent développeur
@.bmad/bmm/agents/pm              # Agent chef de produit
@.bmad/bmm/agents/architect       # Agent architecte

Exemples Windsurf

Même syntaxe que Cursor :

@.bmad/bmm/agents/pm

Créons un PRD pour mon application SaaS.

Conseils Windsurf

  • Utilise le même système de règles que Cursor
  • Supporte les références @ multiples
  • Fonctionne mieux avec des conversations fraîches

🔷 VS Code (avec Extensions IA)

Vue d'ensemble

VS Code nécessite des extensions IA (GitHub Copilot, Codeium, etc.) pour utiliser les agents BMad.

Configuration

Option A : Via Copilot Chat

# Utiliser dans Copilot Chat
Charge l'agent de {project-root}/.bmad/bmm/agents/dev.md

Option B : Via Extensions Personnalisées

Voir docs/ide-info/ pour les instructions spécifiques à l'extension.

🎨 Cline (VS Code Extension)

Vue d'ensemble

Cline est une extension VS Code populaire pour les agents IA.

Utilisation de Base

# Charger l'agent
Charge et agis en tant qu'agent de .bmad/bmm/agents/dev.md

# Exécuter le workflow
Exécute le workflow dev-story

📝 Flux de Travail Recommandé

Règle d'Or : Nouvelles Conversations

⚠️ IMPORTANT : Utilisez toujours des conversations fraîches pour les workflows majeurs.

Pourquoi ?

  • Évite les hallucinations de contexte
  • Assure une capacité de contexte maximale
  • Améliore la qualité des résultats

Workflow Typique de Projet

Phase 1 : Analyse (Optionnel)

Chat 1 : Initialisation

# Claude Code
/bmad:bmm:agents:analyst
*workflow-init

# Cursor/Windsurf
@.bmad/bmm/agents/analyst
Exécute workflow-init

Chat 2 : Brainstorming

# Nouveau chat
/bmad:bmm:agents:analyst
*brainstorm-project

Phase 2 : Planification (Requis)

Chat 3 : PRD

# Nouveau chat
/bmad:bmm:agents:pm
*prd

Chat 4 : UX Design (si UI)

# Nouveau chat
/bmad:bmm:agents:ux-designer
*create-ux-design

Phase 3 : Solution (Piste Method/Enterprise)

Chat 5 : Architecture

# Nouveau chat
/bmad:bmm:agents:architect
*architecture

Chat 6 : Epics et Stories

# Nouveau chat
/bmad:bmm:agents:pm
*create-epics-and-stories

Phase 4 : Implémentation (Requis)

Chat 7 : Planification Sprint

# Nouveau chat
/bmad:bmm:agents:sm
*sprint-planning

Chat 8 : Créer Story

# Nouveau chat
/bmad:bmm:agents:sm
*create-story

Chat 9 : Implémenter Story

# Nouveau chat
/bmad:bmm:agents:dev
*dev-story

Chat 10 : Revue de Code

# Nouveau chat
/bmad:bmm:agents:dev
*code-review

Répéter pour chaque story...

🎯 Référence Rapide des Agents

Agents de Développement

Agent Commande Claude Code Référence Cursor/Windsurf Utiliser Pour
Developer /bmad:bmm:agents:dev @.bmad/bmm/agents/dev Implémentation de code
Architect /bmad:bmm:agents:architect @.bmad/bmm/agents/architect Conception d'architecture
Test Architect /bmad:bmm:agents:tea @.bmad/bmm/agents/tea Stratégie de test

Agents Produit

Agent Commande Claude Code Référence Cursor/Windsurf Utiliser Pour
PM /bmad:bmm:agents:pm @.bmad/bmm/agents/pm PRD, epics, stories
Analyst /bmad:bmm:agents:analyst @.bmad/bmm/agents/analyst Recherche, analyse
UX Designer /bmad:bmm:agents:ux-designer @.bmad/bmm/agents/ux-designer Conception UX

Agents Leadership

Agent Commande Claude Code Référence Cursor/Windsurf Utiliser Pour
Scrum Master /bmad:bmm:agents:sm @.bmad/bmm/agents/sm Gestion sprint
BMad Master /bmad:bmm:agents:bmad-master @.bmad/bmm/agents/bmad-master Guide du processus

Agents Créatifs

Agent Commande Claude Code Référence Cursor/Windsurf Utiliser Pour
Brainstorming Coach /bmad:cis:agents:brainstorming-coach @.bmad/cis/agents/brainstorming-coach Brainstorming
Storyteller /bmad:cis:agents:storyteller @.bmad/cis/agents/storyteller Narration

💡 Conseils et Astuces

Maximiser les Performances

1. Modèles de Contexte 200k+

  • Utilisez Claude Sonnet 4.5, GPT-4, ou équivalent
  • Meilleur pour les workflows complexes
  • Gère de grands documents (PRD, architecture)

2. Conversations Fraîches

  • Démarrez un nouveau chat pour chaque workflow
  • Évite la fatigue du contexte
  • Améliore la qualité

3. Copier/Coller de Documents

  • Partagez le contexte entre les conversations
  • Copiez PRD → chat Architecture
  • Copiez Architecture → chat Dev Story

Gestion du Contexte

Workflows à Contexte Élevé

  • PRD
  • Architecture
  • UX Design
  • Recherche

→ Utilisez toujours de nouvelles conversations

Workflows à Contexte Faible

  • Vérification du statut
  • Questions simples
  • Aide sur les menus

→ Peut réutiliser les conversations

Correspondance de Menu Floue

Les agents BMad v6 sont excellents pour correspondre aux intentions :

# Toutes ces options fonctionnent :
*prd
"créons un prd"
"j'ai besoin d'un document de spécifications produit"
"aide-moi à créer des exigences"

🔧 Résolution des Problèmes

L'agent ne se charge pas

Problème : La commande slash / référence @ ne fonctionne pas

Solutions :

  1. Vérifier que l'installation BMad s'est terminée
  2. Vérifier que le dossier .bmad existe
  3. Redémarrer l'IDE
  4. Vérifier la configuration spécifique à l'IDE

L'agent ne parle pas la bonne langue

Problème : L'agent communique en anglais au lieu du français

Solutions :

  1. Vérifier .bmad/core/config.yaml : 
    communication_language: "Français"
  2. Démarrer une nouvelle conversation
  3. Charger à nouveau l'agent

Menu de workflow manquant

Problème : L'agent se charge mais ne montre pas le menu

Solutions :

  1. Attendre quelques secondes (le menu se génère)
  2. Taper *help pour forcer l'affichage du menu
  3. Demander : "montre-moi tes workflows disponibles"

Erreur "Fichier non trouvé"

Problème : Error: Cannot find agent file

Solutions :

# Vérifier que les agents existent
ls .bmad/bmm/agents/

# Réinstaller si nécessaire
npx bmad-method@alpha install

Hallucinations de l'Agent

Problème : L'agent invente des faits ou donne de mauvaises réponses

Solutions :

  1. ✅ Démarrer une nouvelle conversation (cause #1)
  2. Fournir plus de contexte
  3. Utiliser des modèles de contexte plus grands
  4. Diviser les workflows complexes

📚 Ressources

Documentation

Guides Spécifiques à l'IDE

Support Communautaire

Prêt à commencer ? Chargez votre premier agent et exécutez *workflow-init ! 🚀