docs: add comprehensive French documentation
Add complete French language documentation for BMAD-METHOD including: - README.fr.md: Main French README with full feature overview - docs/fr/installation.md: Detailed installation guide with multi-language support explanation - docs/fr/integration-ide.md: IDE integration guide for Claude Code, Cursor, Windsurf, etc. - docs/fr/bundles-web.md: Complete web bundles guide for Gemini Gems and Custom GPTs - docs/fr/demarrage-rapide.md: Quick start guide for getting started with BMad Method Key features covered: - Multi-language support (communication vs document output languages) - Installation and configuration process - IDE-specific integration instructions - Web bundles for cost-effective planning - Complete workflow walkthroughs - Troubleshooting guides This documentation supports the multi-language feature by providing native French documentation for French-speaking users, demonstrating the dual-language capability where users can communicate in French while optionally generating documents in English or vice versa.
This commit is contained in:
Claude
parent
fcaf87b348
commit
011bc9d721
|
|
@ -0,0 +1,250 @@
|
|||
# BMad Method & BMad Core
|
||||
|
||||
[](https://www.npmjs.com/package/bmad-method)
|
||||
[](https://www.npmjs.com/package/bmad-method)
|
||||
[](LICENSE)
|
||||
[](https://nodejs.org)
|
||||
[](https://discord.gg/gk8jAdXWmj)
|
||||
|
||||
## Développement Agile Piloté par l'IA qui Évolue des Correctifs de Bugs aux Entreprises
|
||||
|
||||
**Construisez Plus, Architecturez vos Rêves** (BMAD) avec **38+ agents IA spécialisés** et **76+ workflows guidés** qui s'adaptent à la complexité de votre projet—des correctifs de bugs rapides aux plateformes d'entreprise en passant par la création de contenu, les opérations marketing, le développement de carrière et la rédaction UX.
|
||||
|
||||
> **🚀 v6 est une ÉNORME mise à jour par rapport à v4 !** Refonte architecturale complète, intelligence adaptative à l'échelle, workflows visuels et le puissant framework BMad Core. Utilisateurs v4 : cela change tout. [Voir les nouveautés →](#quoi-de-neuf-dans-v6)
|
||||
|
||||
> **📌 Statut Alpha v6 :** Qualité proche de la bêta avec une stabilité grandement améliorée. La documentation est en cours de finalisation. Nouvelles vidéos bientôt disponibles sur [BMadCode YouTube](https://www.youtube.com/@BMadCode).
|
||||
|
||||
## 🎯 Pourquoi BMad Method ?
|
||||
|
||||
Contrairement aux assistants de codage IA génériques, BMad Method fournit des **workflows structurés et éprouvés** alimentés par des agents spécialisés qui comprennent le développement agile. Chaque agent possède une expertise approfondie—de la gestion de produit à l'architecture en passant par les tests—travaillant ensemble de manière transparente.
|
||||
|
||||
**✨ Avantages Clés :**
|
||||
|
||||
- **Intelligence Adaptative à l'Échelle** - Ajuste automatiquement la profondeur de planification des correctifs de bugs aux systèmes d'entreprise
|
||||
- **Cycle de Vie Complet du Développement** - Analyse → Planification → Architecture → Implémentation
|
||||
- **Expertise Spécialisée** - 38+ agents avec des rôles spécifiques (PM, Architecte, Développeur, Designer UX, Créateur de Contenu, Rédacteur UX, Coach Carrière, etc.)
|
||||
- **Méthodologies Éprouvées** - Basé sur les meilleures pratiques agiles avec amplification IA
|
||||
- **Système Avancé de Voix et de Style** - Contenu IA qui correspond authentiquement à votre style d'écriture unique
|
||||
- **Intégration IDE** - Fonctionne avec Claude Code, Cursor, Windsurf, VS Code
|
||||
|
||||
## 🏗️ La Puissance de BMad Core
|
||||
|
||||
**BMad Method** est en réalité un module sophistiqué construit sur **BMad Core** (**C**ollaboration **O**ptimized **R**eflection **E**ngine). Cette architecture révolutionnaire signifie :
|
||||
|
||||
- **BMad Core** fournit le framework universel pour la collaboration humain-IA
|
||||
- **BMad Method** exploite Core pour offrir des workflows de développement agile
|
||||
- **BMad Builder** vous permet de créer des modules personnalisés aussi puissants que BMad Method lui-même
|
||||
|
||||
Avec **BMad Builder**, vous pouvez architecturer des agents simples et des modules spécifiques à un domaine extrêmement complexes (juridique, médical, finance, éducation, créatif) qui seront bientôt partageables dans une **marketplace communautaire officielle**. Imaginez construire et partager votre propre équipe IA spécialisée !
|
||||
|
||||
## 📊 Voyez-le en Action
|
||||
|
||||
<p align="center">
|
||||
<img src="./src/modules/bmm/docs/images/workflow-method-greenfield.svg" alt="Workflow BMad Method" width="100%">
|
||||
</p>
|
||||
|
||||
<p align="center">
|
||||
<em>Workflow complet BMad Method montrant toutes les phases, agents et points de décision</em>
|
||||
</p>
|
||||
|
||||
## 🚀 Démarrer en 3 Étapes
|
||||
|
||||
### 1. Installer BMad Method
|
||||
|
||||
```bash
|
||||
# Installer v6 Alpha (recommandé)
|
||||
npx bmad-method@alpha install
|
||||
|
||||
# Ou stable v4 pour la production
|
||||
npx bmad-method install
|
||||
```
|
||||
|
||||
### 2. Initialiser Votre Projet
|
||||
|
||||
Chargez n'importe quel agent dans votre IDE et exécutez :
|
||||
|
||||
```
|
||||
*workflow-init
|
||||
```
|
||||
|
||||
Cela analyse votre projet et recommande la bonne piste de workflow.
|
||||
|
||||
### 3. Choisir Votre Piste
|
||||
|
||||
BMad Method s'adapte à vos besoins avec trois pistes intelligentes :
|
||||
|
||||
| Piste | Utiliser Pour | Planification | Temps de Démarrage |
|
||||
| ------------------ | ------------------------------ | --------------------------- | ------------------ |
|
||||
| **⚡ Quick Flow** | Correctifs de bugs, petites fonctionnalités | Spécification technique uniquement | < 5 minutes |
|
||||
| **📋 BMad Method** | Produits, plateformes | PRD + Architecture + UX | < 15 minutes |
|
||||
| **🏢 Enterprise** | Conformité, échelle | Suite complète de gouvernance | < 30 minutes |
|
||||
|
||||
> **Pas sûr ?** Exécutez `*workflow-init` et laissez BMad analyser l'objectif de votre projet.
|
||||
|
||||
## 🔄 Comment Ça Marche : Méthodologie en 4 Phases
|
||||
|
||||
BMad Method vous guide à travers un cycle de vie de développement éprouvé :
|
||||
|
||||
1. **📊 Analyse** (Optionnel) - Brainstorming, recherche et exploration de solutions
|
||||
2. **📝 Planification** - Créer des PRD, spécifications techniques ou documents de conception de jeu
|
||||
3. **🏗️ Solution** - Concevoir l'architecture, l'UX et l'approche technique
|
||||
4. **⚡ Implémentation** - Développement piloté par les stories avec validation continue
|
||||
|
||||
Chaque phase dispose de workflows et d'agents spécialisés travaillant ensemble pour offrir des résultats exceptionnels.
|
||||
|
||||
## 🤖 Rencontrez Votre Équipe
|
||||
|
||||
**12 Agents Spécialisés** travaillant de concert :
|
||||
|
||||
| Développement | Architecture | Produit | Leadership |
|
||||
| ------------- | -------------- | ------------- | -------------- |
|
||||
| Développeur | Architecte | PM | Scrum Master |
|
||||
| Designer UX | Architecte Test| Analyste | BMad Master |
|
||||
| Rédacteur Technique | Architecte Jeu | Designer Jeu | Développeur Jeu |
|
||||
|
||||
Chaque agent apporte une expertise approfondie et peut être personnalisé pour correspondre au style de votre équipe.
|
||||
|
||||
## 📦 Ce Qui Est Inclus
|
||||
|
||||
### Modules Principaux
|
||||
|
||||
- **BMad Method (BMM)** - Framework complet de développement agile
|
||||
- 12 agents spécialisés
|
||||
- 34 workflows à travers 4 phases
|
||||
- Planification adaptative à l'échelle
|
||||
- [→ Hub de Documentation](./src/modules/bmm/docs/README.md)
|
||||
|
||||
- **BMad Builder (BMB)** - Créez des agents et workflows personnalisés
|
||||
- Créez n'importe quoi, des agents simples aux modules complexes
|
||||
- Créez des solutions spécifiques à un domaine (juridique, médical, finance, éducation)
|
||||
- Partagez vos créations dans la marketplace communautaire à venir
|
||||
- [→ Guide du Builder](./src/modules/bmb/README.md)
|
||||
|
||||
- **Creative Intelligence Suite (CIS)** - Innovation & résolution de problèmes
|
||||
- Brainstorming, design thinking, narration
|
||||
- 5 workflows de facilitation créative
|
||||
- [→ Workflows Créatifs](./src/modules/cis/README.md)
|
||||
|
||||
- **Content Creator** - Création de contenu avancée avec correspondance vocale
|
||||
- 8 agents spécialisés de création de contenu
|
||||
- 8 workflows incluant un système avancé de profilage vocal
|
||||
- Création de contenu multi-plateforme (Blog, LinkedIn, Newsletter, Twitter)
|
||||
- Profils vocaux et guides de style personnalisés
|
||||
- [→ Suite de Création de Contenu](./src/modules/content-creator/README.md)
|
||||
|
||||
- **Marketing Ops** - Suite complète d'opérations marketing
|
||||
- 4 agents marketing spécialisés (Marketeur de Marque, Acheteur Média, Analyste Marketing, Designer Créatif)
|
||||
- 13 workflows complets pour stratégie, campagnes, analyses et créatif
|
||||
- 20 tâches spécialisées pour recherche, optimisation et analyse
|
||||
- Livrables marketing de qualité professionnelle avec assistance IA
|
||||
- [→ Suite d'Opérations Marketing](./src/modules/marketing-ops/README.md)
|
||||
|
||||
- **Career Coach** - Suite de développement de carrière professionnel
|
||||
- 3 agents spécialisés (Coach Carrière, Rédacteur CV, Coach Entretien)
|
||||
- 3 workflows complets (Création CV, Planification Carrière, Préparation Entretien)
|
||||
- 19 tâches réutilisables pour toutes les activités de développement de carrière
|
||||
- 17 modèles professionnels pour CV, lettres de motivation et documents de carrière
|
||||
- Création de CV optimisés ATS (objectif de compatibilité 90%+)
|
||||
- Préparation d'entretiens méthode STAR avec sessions simulées
|
||||
- [→ Suite de Développement de Carrière](./src/modules/career-coach/README.md)
|
||||
|
||||
- **UX Writer** - Spécialiste de la copie d'interface et du microcopy
|
||||
- 1 agent expert (Rédacteur UX) avec 11 commandes spécialisées
|
||||
- Framework Quatre Standards de Qualité (Purposeful, Concise, Conversational, Clear)
|
||||
- 3 tâches principales pour analyser, créer et améliorer la copie d'interface
|
||||
- 5 modèles professionnels et 6 ressources de données complètes
|
||||
- Benchmarks basés sur la recherche pour tous les modèles UI
|
||||
- Notation de qualité objective (échelle 0-10 par standard)
|
||||
- Conformité d'accessibilité WCAG AA intégrée
|
||||
- [→ Suite de Rédaction UX](./src/modules/ux-writer/README.md)
|
||||
|
||||
### Fonctionnalités Clés
|
||||
|
||||
- **🎨 Agents Personnalisables** - Modifiez les personnalités, l'expertise et les styles de communication
|
||||
- **🌐 Support Multi-Langue** - Paramètres séparés pour la communication et la sortie de code
|
||||
- **📄 Fragmentation de Documents** - 90% d'économie de tokens pour les grands projets
|
||||
- **🔄 Sûr pour les Mises à Jour** - Vos personnalisations persistent à travers les mises à jour
|
||||
- **🚀 Bundles Web** - Utilisez dans ChatGPT, Claude Projects ou Gemini Gems
|
||||
|
||||
## 📚 Documentation
|
||||
|
||||
### Liens Rapides
|
||||
|
||||
- **[Guide de Démarrage Rapide](./docs/fr/demarrage-rapide.md)** - Introduction de 15 minutes
|
||||
- **[Documentation BMM Complète](./src/modules/bmm/docs/README.md)** - Tous les guides et références
|
||||
- **[Personnalisation des Agents](./docs/agent-customization-guide.md)** - Personnalisez vos agents
|
||||
- **[Toute la Documentation](./docs/index.md)** - Index complet de la documentation
|
||||
- **[Guide d'Installation](./docs/fr/installation.md)** - Instructions détaillées d'installation
|
||||
- **[Intégration IDE](./docs/fr/integration-ide.md)** - Configuration pour Claude Code, Cursor, Windsurf, etc.
|
||||
- **[Bundles Web](./docs/fr/bundles-web.md)** - Utiliser avec Gemini Gems et Custom GPTs
|
||||
|
||||
### Pour les Utilisateurs v4
|
||||
|
||||
- **[Documentation v4](https://github.com/bmad-code-org/BMAD-METHOD/tree/V4)**
|
||||
- **[Guide de Mise à Niveau v4 vers v6](./docs/v4-to-v6-upgrade.md)**
|
||||
|
||||
## 💬 Communauté & Support
|
||||
|
||||
- **[Communauté Discord](https://discord.gg/gk8jAdXWmj)** - Obtenez de l'aide, partagez des projets
|
||||
- **[GitHub Issues](https://github.com/bmad-code-org/BMAD-METHOD/issues)** - Signalez des bugs, demandez des fonctionnalités
|
||||
- **[Chaîne YouTube](https://www.youtube.com/@BMadCode)** - Tutoriels vidéo et démos
|
||||
- **[Bundles Web](https://bmad-code-org.github.io/bmad-bundles/)** - Bundles d'agents pré-construits
|
||||
|
||||
## 🛠️ Développement
|
||||
|
||||
Pour les contributeurs travaillant sur la base de code BMad :
|
||||
|
||||
```bash
|
||||
# Exécuter tous les contrôles de qualité
|
||||
npm test
|
||||
|
||||
# Commandes de développement
|
||||
npm run lint # Vérifier le style de code
|
||||
npm run format:fix # Formater automatiquement le code
|
||||
npm run bundle # Construire les bundles web
|
||||
```
|
||||
|
||||
Voir [CONTRIBUTING.md](CONTRIBUTING.md) pour les directives complètes de développement.
|
||||
|
||||
## Quoi de Neuf dans v6
|
||||
|
||||
**v6 représente une révolution architecturale complète par rapport à v4 :**
|
||||
|
||||
### 🚀 Mises à Niveau Majeures
|
||||
|
||||
- **Framework BMad Core** - Architecture modulaire permettant des solutions de domaine personnalisées
|
||||
- **Intelligence Adaptative à l'Échelle** - Ajustement automatique des correctifs de bugs à l'entreprise
|
||||
- **Workflows Visuels** - Beaux diagrammes SVG montrant la méthodologie complète
|
||||
- **Module BMad Builder** - Créez et partagez vos propres équipes d'agents IA
|
||||
- **76+ Workflows** - En hausse par rapport à 20 dans v4, couvrant chaque scénario de développement
|
||||
- **38+ Agents Spécialisés** - Améliorés avec des personnalités et une expertise personnalisables
|
||||
- **Suite de Développement Professionnel** - Modules Career Coach et UX Writer pour la croissance de carrière et la conception d'interface
|
||||
- **Personnalisation Sûre pour les Mises à Jour** - Vos configurations persistent à travers toutes les mises à jour
|
||||
- **Bundles Web** - Utilisez les agents dans ChatGPT, Claude et Gemini
|
||||
- **Support Multi-Langue** - Paramètres séparés pour la communication et le code
|
||||
- **Fragmentation de Documents** - 90% d'économie de tokens pour les grands projets
|
||||
|
||||
### 🔄 Pour les Utilisateurs v4
|
||||
|
||||
- **[Guide de Mise à Niveau Complet](./docs/v4-to-v6-upgrade.md)** - Migration étape par étape
|
||||
- **[Archive de Documentation v4](https://github.com/bmad-code-org/BMAD-METHOD/tree/V4)** - Référence héritée
|
||||
- Compatibilité ascendante lorsque possible
|
||||
- Chemin de migration fluide avec détection de l'installateur
|
||||
|
||||
## 📄 Licence
|
||||
|
||||
Licence MIT - Voir [LICENSE](LICENSE) pour les détails.
|
||||
|
||||
**Marques déposées :** BMAD™ et BMAD-METHOD™ sont des marques déposées de BMad Code, LLC.
|
||||
|
||||
---
|
||||
|
||||
<p align="center">
|
||||
<a href="https://github.com/bmad-code-org/BMAD-METHOD/graphs/contributors">
|
||||
<img src="https://contrib.rocks/image?repo=bmad-code-org/BMAD-METHOD" alt="Contributeurs">
|
||||
</a>
|
||||
</p>
|
||||
|
||||
<p align="center">
|
||||
<sub>Construit avec ❤️ pour la communauté de collaboration humain-IA</sub>
|
||||
</p>
|
||||
|
|
@ -0,0 +1,479 @@
|
|||
# Utiliser les Bundles Web BMad dans Gemini Gems et Custom GPTs
|
||||
|
||||
Les bundles web empaquettent les agents BMad en fichiers XML autonomes qui fonctionnent dans Gemini Gems et Custom GPTs. Tout ce dont l'agent a besoin - instructions, workflows, dépendances - est regroupé dans un seul fichier.
|
||||
|
||||
## 📦 Qu'est-ce que les Bundles Web ?
|
||||
|
||||
Les bundles web sont des fichiers XML autonomes contenant :
|
||||
|
||||
- Persona complète de l'agent et instructions
|
||||
- Tous les workflows et dépendances
|
||||
- Système de menu interactif
|
||||
- Mode party pour la collaboration multi-agents
|
||||
- Aucun fichier externe requis
|
||||
|
||||
**Parfait pour :** Télécharger un seul fichier vers un Gemini GEM ou Custom GPT pour utiliser BMad Method depuis le Web, généralement avec d'énormes économies de coûts, au prix de certaines qualités et commodités de l'utilisation locale.
|
||||
|
||||
## ⚠️ Règles de Configuration Critiques
|
||||
|
||||
**LISEZ CECI EN PREMIER - Suivre ces règles garantit que BMad fonctionne correctement dans Gemini/GPT :**
|
||||
|
||||
1. **UN fichier par Gem/GPT** - Téléchargez EXACTEMENT UN fichier XML par instance Gemini Gem ou Custom GPT. NE combinez PAS plusieurs fichiers d'agents.
|
||||
|
||||
2. **Utilisez les instructions de configuration** - Lors de la création de votre Gem/GPT, vous DEVEZ ajouter le prompt de configuration (montré dans Démarrage Rapide ci-dessous) pour qu'il sache comment lire le fichier XML.
|
||||
|
||||
3. **Activez Canvas/Exécution de Code** - Ceci est ESSENTIEL pour les workflows de génération de documents (PRD, Architecture, etc.). Activez ceci dans les paramètres de votre Gem/GPT.
|
||||
|
||||
4. **Gemini Gems sont fortement préférés** - Ils fonctionnent significativement mieux que les Custom GPTs pour les workflows BMad.
|
||||
|
||||
5. **Bundles d'équipe = Gemini 2.5 Pro+ uniquement** - Les bundles d'équipe (agents multiples) ont de terribles performances dans les Custom GPTs en raison des limites de contexte. Utilisez-les uniquement avec Gemini 2.5 Pro ou supérieur.
|
||||
|
||||
6. **Créez des Gems séparés pour chaque agent** - Créez un Gem PM, un Gem Architecte, un Gem Développeur, etc. N'essayez pas de les combiner (sauf via les bundles d'équipe officiels).
|
||||
|
||||
## 🚀 Démarrage Rapide
|
||||
|
||||
### 1. Obtenir les Fichiers de Bundle Web
|
||||
|
||||
**Option A : Télécharger les Fichiers Pré-Bundlés (Plus Rapide)**
|
||||
|
||||
Téléchargez des bundles prêts à l'emploi qui sont automatiquement mis à jour chaque fois que des commits sont fusionnés dans main :
|
||||
|
||||
**[→ Télécharger les Bundles Web](https://bmad-code-org.github.io/bmad-bundles/)**
|
||||
|
||||
Naviguez vers le dossier du module (bmm, bmb, cis, bmgd) → dossier agents → téléchargez le fichier `.xml` dont vous avez besoin. Ces bundles sont automatiquement régénérés et déployés à chaque commit sur la branche principale, garantissant que vous avez toujours la dernière version.
|
||||
|
||||
**Option B : Générer depuis l'Installation Locale**
|
||||
|
||||
Depuis le répertoire de votre projet BMad :
|
||||
|
||||
```bash
|
||||
# Générer tous les bundles d'agents
|
||||
npm run bundle
|
||||
|
||||
# Ou générer des bundles spécifiques
|
||||
node tools/cli/bundlers/bundle-web.js module bmm
|
||||
node tools/cli/bundlers/bundle-web.js agent bmm dev
|
||||
```
|
||||
|
||||
**Emplacement de sortie :** Répertoire `web-bundles/`
|
||||
|
||||
```
|
||||
web-bundles/
|
||||
├── bmm/
|
||||
│ ├── agents/ # Agents individuels
|
||||
│ └── teams/ # Équipes multi-agents
|
||||
├── bmb/
|
||||
├── cis/
|
||||
└── bmgd/
|
||||
```
|
||||
|
||||
### 2. Télécharger vers Gemini Gems (Recommandé)
|
||||
|
||||
**IMPORTANT : Créez UN Gem par fichier d'agent. NE téléchargez PAS plusieurs fichiers d'agents vers un seul Gem.**
|
||||
|
||||
**Créer un Gem :**
|
||||
|
||||
1. Allez sur [Google AI Studio](https://aistudio.google.com/)
|
||||
2. Cliquez sur "New Gem" ou "Create Gem"
|
||||
3. Donnez un nom à votre Gem (ex : "BMad PM Agent")
|
||||
4. **Activez "Code execution" pour de meilleurs résultats avec la génération de documents**
|
||||
5. Dans le champ **System Instructions**, ajoutez ce texte EXACT (personnalisez les valeurs de config) :
|
||||
|
||||
```
|
||||
Toutes vos instructions de fonctionnement et ressources sont contenues dans le fichier XML joint. Lisez le bloc d'agent initial et les instructions pour le comprendre. Vous ne dévierez pas du caractère et des règles décrites dans le fichier joint !
|
||||
|
||||
VALEURS CONFIG.YAML :
|
||||
- user_name: [Votre Nom]
|
||||
- communication_language: Français
|
||||
- user_skill_level: [Beginner|Intermediate|Expert]
|
||||
- document_output_language: Français
|
||||
- bmm-workflow-status: standalone (no workflow)
|
||||
```
|
||||
|
||||
6. **Téléchargez UN fichier XML** (ex : `pm.xml`) - joignez comme fichier ou collez le contenu
|
||||
7. Sauvegardez et testez votre Gem en tapant `*help` pour voir le menu
|
||||
|
||||
**Conseils pour Gemini :**
|
||||
|
||||
- **Activez Code Execution/Canvas** - Critique pour la sortie de documents (PRD, docs d'architecture, etc.)
|
||||
- **Utilisez Gemini 2.5 Pro+** pour de meilleurs résultats, surtout pour les workflows complexes
|
||||
- **Un agent par Gem** - Créez des Gems séparés pour PM, Architecte, Développeur, etc.
|
||||
- Testez l'agent en déclenchant des éléments de menu avec `*workflow-name`
|
||||
|
||||
### 3. Télécharger vers Custom GPTs
|
||||
|
||||
**IMPORTANT : Créez UN Custom GPT par fichier d'agent. NE téléchargez PAS plusieurs fichiers d'agents vers un seul GPT.**
|
||||
|
||||
**Créer un Custom GPT :**
|
||||
|
||||
1. Allez sur [ChatGPT](https://chat.openai.com/)
|
||||
2. Cliquez sur votre profil → "My GPTs" → "Create a GPT"
|
||||
3. Configurez votre GPT :
|
||||
- **Nom :** BMad PM Agent (ou votre choix)
|
||||
- **Description :** Agent de planification IA propulsé par BMad Method
|
||||
4. Dans le champ **Instructions**, ajoutez ce texte EXACT en haut (personnalisez les valeurs de config) :
|
||||
|
||||
```
|
||||
Toutes vos instructions de fonctionnement et ressources sont contenues dans le fichier XML joint. Lisez le bloc d'agent initial et les instructions pour le comprendre. Vous ne dévierez pas du caractère et des règles décrites dans le fichier joint !
|
||||
|
||||
VALEURS CONFIG.YAML :
|
||||
- user_name: [Votre Nom]
|
||||
- communication_language: Français
|
||||
- user_skill_level: [Beginner|Intermediate|Expert]
|
||||
- document_output_language: Français
|
||||
- bmm-workflow-status: standalone (no workflow)
|
||||
```
|
||||
|
||||
5. **Sous ce texte**, collez l'intégralité du contenu d'UN fichier XML (ex : `pm.xml`)
|
||||
6. **Activez "Canvas" dans les paramètres ChatGPT** pour une meilleure sortie de documents
|
||||
7. Sauvegardez et testez en tapant `*help`
|
||||
|
||||
**Conseils pour Custom GPTs :**
|
||||
|
||||
- **Activez Canvas** - Essentiel pour la génération de documents de workflow
|
||||
- **Un agent par GPT** - Créez des GPTs séparés pour chaque agent
|
||||
- Les Custom GPTs ont des fenêtres de contexte plus petites que Gemini - évitez les bundles d'équipe
|
||||
- Fonctionne mieux avec des agents ciblés (PM, Analyste, Architecte)
|
||||
|
||||
## 📋 Bundles Web Disponibles
|
||||
|
||||
Après avoir exécuté `npm run bundle`, vous aurez accès à :
|
||||
|
||||
### Agents BMad Method (BMM)
|
||||
|
||||
- **analyst.xml** - Analyse commerciale et collecte d'exigences
|
||||
- **architect.xml** - Architecture système et conception technique
|
||||
- **dev.xml** - Développement full-stack et implémentation
|
||||
- **pm.xml** - Gestion de produit et planification
|
||||
- **sm.xml** - Scrum master et facilitation agile
|
||||
- **tea.xml** - Architecture de test et assurance qualité
|
||||
- **tech-writer.xml** - Documentation technique
|
||||
- **ux-designer.xml** - Conception d'expérience utilisateur
|
||||
- **game-designer.xml** - Conception de jeu et mécaniques
|
||||
- **game-dev.xml** - Développement de jeu
|
||||
- **game-architect.xml** - Architecture de jeu
|
||||
|
||||
### Agent BMad Builder (BMB)
|
||||
|
||||
- **bmad-builder.xml** - Créez des agents, workflows et modules personnalisés
|
||||
|
||||
### Agents Creative Intelligence Suite (CIS)
|
||||
|
||||
- **brainstorming-coach.xml** - Facilitation de brainstorming créatif
|
||||
- **design-thinking-coach.xml** - Résolution de problèmes centrée sur l'humain
|
||||
- **innovation-strategist.xml** - Innovation et stratégie
|
||||
- **creative-problem-solver.xml** - Résolution de problèmes révolutionnaire
|
||||
- **storyteller.xml** - Narration et storytelling
|
||||
|
||||
### Bundles d'Équipe (Collaboration Multi-Agents)
|
||||
|
||||
**CRITIQUE : Les bundles d'équipe sont UNIQUEMENT recommandés pour Gemini 2.5 Pro+ sur le web. L'expérience est médiocre avec les Custom GPTs en raison des fenêtres de contexte limitées.**
|
||||
|
||||
- **bmm/teams/team-fullstack.xml** - Équipe complète de développement BMad Method
|
||||
- **bmgd/teams/team-gamedev.xml** - Équipe de développement de jeu
|
||||
- **cis/teams/creative-squad.xml** - Équipe Creative Intelligence
|
||||
|
||||
**Quand utiliser les bundles d'équipe :**
|
||||
|
||||
- Vous voulez plusieurs agents collaborant dans un Gem
|
||||
- Vous utilisez Gemini 2.5 Pro+ (requis)
|
||||
- Vous avez besoin de perspectives diverses sur des problèmes complexes
|
||||
|
||||
**Quand utiliser des agents individuels à la place :**
|
||||
|
||||
- Utilisation de Custom GPTs (utilisez toujours des agents individuels)
|
||||
- Vous voulez une expertise ciblée d'un seul agent
|
||||
- Besoin d'interactions plus rapides et rationalisées
|
||||
|
||||
## 💰 Workflow Recommandé : Planification Web → Implémentation Locale
|
||||
|
||||
**Économisez des coûts significatifs** en faisant les phases de planification dans les bundles web, puis en passant à l'IDE local pour l'implémentation.
|
||||
|
||||
### Stratégie d'Économie de Coûts
|
||||
|
||||
**Phase 1-3 : Faire sur le Web (Économies Majeures)**
|
||||
|
||||
Utilisez Gemini Gems ou Custom GPTs pour ces workflows :
|
||||
|
||||
1. **Phase d'Analyse** (Analyste, PM)
|
||||
- `*brainstorm-project` - Brainstormer des idées et fonctionnalités
|
||||
- `*research` - Recherche de marché et technique
|
||||
- `*product-brief` - Créer une vision produit
|
||||
|
||||
2. **Phase de Planification** (PM)
|
||||
- `*prd` - Générer un Document de Spécifications Produit complet
|
||||
- `*create-epics-and-stories` - Décomposer en stories de développement
|
||||
|
||||
3. **Phase de Solution** (Architecte, Designer UX)
|
||||
- `*architecture` - Définir l'architecture technique
|
||||
- `*create-ux-design` - Concevoir l'expérience utilisateur
|
||||
|
||||
**Exporter les Artefacts :**
|
||||
Après chaque workflow, copiez/téléchargez les documents générés (PRD, Architecture, Design UX, etc.)
|
||||
|
||||
**Phase 4 : Passer à l'IDE Local (Requis pour l'Implémentation)**
|
||||
|
||||
1. Sauvegardez les artefacts exportés dans le dossier `docs/` de votre projet
|
||||
2. Exécutez l'installation BMad locale avec `*workflow-init`
|
||||
3. BMad détectera les artefacts existants et mettra à jour le statut du workflow
|
||||
4. Procédez à l'implémentation en utilisant l'agent Développeur localement
|
||||
|
||||
**Pourquoi cela fonctionne :**
|
||||
|
||||
- **Les workflows de planification** sont lourds en tokens mais n'ont pas besoin de contexte de code
|
||||
- **Les modèles Web (Gemini/GPT)** gèrent excellemment la planification à moindre coût
|
||||
- **L'implémentation IDE locale** nécessite un accès complet à la base de code et aux outils
|
||||
- **Le meilleur des deux mondes** : Économies de coûts + capacités d'implémentation complètes
|
||||
|
||||
**Économies typiques :** Réduction de coûts de 60-80% en faisant l'analyse, la planification et l'architecture sur le web avant de passer à l'implémentation locale.
|
||||
|
||||
## 🎮 Utiliser les Bundles Web
|
||||
|
||||
### Utilisation de Base
|
||||
|
||||
**1. Charger l'Agent**
|
||||
|
||||
Téléchargez ou collez le fichier XML dans Gemini/GPT. L'agent se présentera et montrera son menu.
|
||||
|
||||
**2. Choisir un Workflow**
|
||||
|
||||
Utilisez le langage naturel ou des raccourcis :
|
||||
|
||||
```
|
||||
"Exécute le workflow PRD"
|
||||
*prd
|
||||
|
||||
"Commence le brainstorming"
|
||||
*brainstorm-project
|
||||
|
||||
"Montre-moi le menu"
|
||||
*help
|
||||
```
|
||||
|
||||
**3. Suivre le Workflow**
|
||||
|
||||
L'agent vous guide étape par étape à travers le workflow, posant des questions et créant des livrables.
|
||||
|
||||
### Fonctionnalités Avancées
|
||||
|
||||
**Mode Party**
|
||||
|
||||
Tous les bundles web incluent le mode party pour la collaboration multi-agents :
|
||||
|
||||
```
|
||||
*party
|
||||
```
|
||||
|
||||
Cela active plusieurs agents qui collaborent sur votre tâche, fournissant des perspectives diverses.
|
||||
|
||||
**Chargement de Contexte**
|
||||
|
||||
Certains workflows chargent du contexte supplémentaire :
|
||||
|
||||
```
|
||||
*workflow-init # Initialiser le workflow du projet
|
||||
*document-project # Analyser la base de code existante
|
||||
```
|
||||
|
||||
**Menus Dynamiques**
|
||||
|
||||
Les agents adaptent leurs menus en fonction de la phase du projet et des workflows disponibles.
|
||||
|
||||
## 🔄 Différences de Plateforme
|
||||
|
||||
### Gemini Gems (Fortement Recommandé)
|
||||
|
||||
**Avantages :**
|
||||
|
||||
- Meilleure analyse et gestion XML
|
||||
- Gère bien les grands bundles
|
||||
- Supporte les workflows complexes
|
||||
- Fenêtre de contexte plus grande (meilleur pour les bundles d'équipe)
|
||||
- Exécution de code pour la génération de documents
|
||||
- Fonctionne excellemment avec les workflows BMad
|
||||
|
||||
**Inconvénients :**
|
||||
|
||||
- Nécessite un compte Google
|
||||
- Peut avoir des limites de taux sur le niveau gratuit
|
||||
|
||||
**Meilleur pour :**
|
||||
|
||||
- Tous les agents individuels (PM, Architecte, Développeur, Designer UX, etc.)
|
||||
- Bundles d'équipe (nécessite Gemini 2.5 Pro+)
|
||||
- Workflows complexes en plusieurs étapes
|
||||
- Workflows lourds en documents (PRD, Architecture)
|
||||
|
||||
**Modèle Recommandé :** Gemini 2.5 Pro ou supérieur
|
||||
|
||||
### Custom GPTs
|
||||
|
||||
**Avantages :**
|
||||
|
||||
- Interface ChatGPT familière
|
||||
- Bon pour les workflows conversationnels
|
||||
- Partage facile avec l'équipe via lien
|
||||
|
||||
**Inconvénients :**
|
||||
|
||||
- Fenêtre de contexte plus petite que Gemini
|
||||
- Limite de caractères sur les instructions (les grands bundles peuvent ne pas rentrer)
|
||||
- **NON recommandé pour les bundles d'équipe**
|
||||
- Fonctionnalité Canvas moins mature que l'exécution de code de Gemini
|
||||
|
||||
**Meilleur pour :**
|
||||
|
||||
- Agents individuels ciblés (PM, Analyste, Architecte)
|
||||
- Agents créatifs (CIS)
|
||||
- Workflows plus simples (product-brief, brainstorm-project)
|
||||
- Prototypage rapide
|
||||
|
||||
**NON recommandé pour :** Bundles d'équipe, agent Développeur, workflows techniques complexes
|
||||
|
||||
## 🎨 Personnalisation
|
||||
|
||||
**Avant le Bundling :**
|
||||
|
||||
Personnalisez les agents en utilisant le [Guide de Personnalisation des Agents](../agent-customization-guide.md) :
|
||||
|
||||
1. Éditez `{bmad_folder}/_cfg/agents/<agent>.customize.yaml`
|
||||
2. Reconstruisez : `npx bmad-method build <agent-name>`
|
||||
3. Générez les bundles : `npm run bundle`
|
||||
|
||||
Vos personnalisations seront incluses dans les bundles web.
|
||||
|
||||
**Après le Bundling :**
|
||||
|
||||
Vous pouvez éditer manuellement le XML pour :
|
||||
|
||||
- Changer le nom de l'agent (recherchez `<name>`)
|
||||
- Modifier la persona (recherchez `<persona>`)
|
||||
- Ajouter des instructions personnalisées (dans les blocs `<critical>`)
|
||||
|
||||
## 🔧 Résolution des Problèmes
|
||||
|
||||
**L'agent ne répond pas correctement ?**
|
||||
|
||||
- Vérifiez que le fichier XML entier a été téléchargé
|
||||
- Vérifiez qu'aucune troncature ne s'est produite (Gemini/GPT ont des limites de caractères)
|
||||
- Essayez d'abord un agent plus simple (analyst, pm)
|
||||
|
||||
**Les éléments du menu ne fonctionnent pas ?**
|
||||
|
||||
- Utilisez le préfixe `*` pour les raccourcis : `*prd` pas `prd`
|
||||
- Ou utilisez le langage naturel : "Exécute le workflow PRD"
|
||||
- Vérifiez le menu de l'agent avec `*help`
|
||||
|
||||
**Les workflows échouent ?**
|
||||
|
||||
- Certains workflows attendent des fichiers de projet (non disponibles dans le contexte web)
|
||||
- Utilisez des workflows conçus pour la planification/analyse dans les bundles web
|
||||
- Pour les workflows d'implémentation, utilisez l'installation IDE locale
|
||||
|
||||
**Fichier trop grand pour GPT ?**
|
||||
|
||||
- Divisez en sections et utilisez plusieurs GPTs
|
||||
- Utilisez plutôt Gemini Gems (meilleur pour les gros fichiers)
|
||||
- Générez des bundles d'agent unique au lieu de bundles d'équipe
|
||||
|
||||
## ✅ Meilleures Pratiques
|
||||
|
||||
1. **Un Fichier Par Gem/GPT** - Téléchargez toujours uniquement UN fichier XML par instance Gemini Gem ou Custom GPT
|
||||
2. **Préférez Gemini à GPT** - Gemini Gems fonctionne significativement mieux avec les bundles BMad
|
||||
3. **Activez Canvas/Exécution de Code** - Essentiel pour les workflows de génération de documents (PRD, Architecture, etc.)
|
||||
4. **Créez des Gems Séparés pour Chaque Agent** - N'essayez pas de combiner les agents sauf via les bundles d'équipe
|
||||
5. **Bundles d'Équipe = Gemini 2.5 Pro+ Uniquement** - N'utilisez jamais les bundles d'équipe avec les Custom GPTs
|
||||
6. **Utilisez pour les Phases de Planification** - Les bundles web excellent dans l'analyse, la planification et l'architecture (Phases 1-3)
|
||||
7. **Passez au Local pour l'Implémentation** - Utilisez l'installation IDE locale pour le développement Phase 4
|
||||
8. **Exportez et Sauvegardez les Artefacts** - Copiez les documents générés dans le dossier `docs/` de votre projet
|
||||
9. **Exécutez workflow-init Localement** - Après avoir importé les artefacts web, initialisez le statut du workflow local
|
||||
10. **Restez à Jour** - Reconstruisez les bundles après les mises à jour BMad pour obtenir les dernières améliorations
|
||||
|
||||
## 📚 Exemples
|
||||
|
||||
### Exemple 1 : Workflow Web → Local Complet (Recommandé)
|
||||
|
||||
**Objectif :** Construire un nouveau produit SaaS avec des économies de coûts maximales
|
||||
|
||||
**Phase 1-3 : Planification Web (Gemini Gems)**
|
||||
|
||||
1. **Téléchargez les bundles :**
|
||||
- `bmm/agents/analyst.xml`
|
||||
- `bmm/agents/pm.xml`
|
||||
- `bmm/agents/architect.xml`
|
||||
- `bmm/agents/ux-designer.xml`
|
||||
|
||||
2. **Créez 4 Gemini Gems séparés** (un par agent, activez Code Execution)
|
||||
|
||||
3. **Analyse (Gem Analyste) :**
|
||||
- Exécutez : `*brainstorm-project` → Générez des idées
|
||||
- Exécutez : `*research` → Analyse de marché
|
||||
- Exportez : Sauvegardez les résultats de recherche
|
||||
|
||||
4. **Planification (Gem PM) :**
|
||||
- Partagez les résultats de recherche
|
||||
- Exécutez : `*product-brief` → Vision produit
|
||||
- Exécutez : `*prd` → Document complet de spécifications
|
||||
- Exportez : Sauvegardez le PRD vers `docs/prd.md`
|
||||
|
||||
5. **Design UX (Gem Designer UX) :**
|
||||
- Partagez le PRD
|
||||
- Exécutez : `*create-ux-design` → Spécifications UX
|
||||
- Exportez : Sauvegardez le design UX vers `docs/ux-design.md`
|
||||
|
||||
6. **Architecture (Gem Architecte) :**
|
||||
- Partagez PRD et Design UX
|
||||
- Exécutez : `*architecture` → Architecture technique
|
||||
- Exportez : Sauvegardez vers `docs/architecture.md`
|
||||
|
||||
**Phase 4 : Implémentation Locale**
|
||||
|
||||
7. **Configurez BMad local :**
|
||||
- Installez BMad localement : `npx bmad-method@alpha install`
|
||||
- Placez les docs exportés dans le dossier `docs/` du projet
|
||||
- Chargez l'agent Développeur
|
||||
- Exécutez : `*workflow-init` → BMad détecte les artefacts, suggère les prochaines étapes
|
||||
|
||||
8. **Implémentez :**
|
||||
- Exécutez : `*sprint-planning` → Configurez le sprint
|
||||
- Exécutez : `*dev-story` → Implémentez les fonctionnalités
|
||||
- Utilisez les capacités complètes de l'IDE avec accès à la base de code
|
||||
|
||||
**Économies de Coûts :** 60-80% en faisant la planification dans Gemini avant l'implémentation locale
|
||||
|
||||
### Exemple 2 : Session de Brainstorming Rapide
|
||||
|
||||
1. Téléchargez `cis/agents/brainstorming-coach.xml`
|
||||
2. Créez un Gemini Gem avec Code Execution activé
|
||||
3. Exécutez : `*brainstorming`
|
||||
4. Choisissez une technique (ex : SCAMPER, Mind Mapping)
|
||||
5. Générez et affinez les idées
|
||||
6. Exportez les résultats pour revue d'équipe
|
||||
|
||||
### Exemple 3 : Revue d'Architecture
|
||||
|
||||
1. Téléchargez `bmm/agents/architect.xml`
|
||||
2. Créez un Gemini Gem (activez Code Execution)
|
||||
3. Collez le PRD existant dans la conversation
|
||||
4. Exécutez : `*architecture`
|
||||
5. Collaborez sur les décisions techniques
|
||||
6. Exportez le document d'architecture vers `docs/architecture.md`
|
||||
|
||||
## 📖 Ressources
|
||||
|
||||
### Documentation
|
||||
|
||||
- **[Guide de Personnalisation des Agents](../agent-customization-guide.md)** - Personnalisez avant le bundling
|
||||
- **[Documentation BMM](../../src/modules/bmm/docs/README.md)** - Apprenez tous les workflows
|
||||
- **[Guide d'Installation](./installation.md)** - Configuration locale
|
||||
- **[Intégration IDE](./integration-ide.md)** - Configuration IDE
|
||||
|
||||
### Plateformes
|
||||
|
||||
- **[Google AI Studio](https://aistudio.google.com/)** - Créez des Gemini Gems
|
||||
- **[Custom GPTs](https://chat.openai.com/gpts)** - Créez des Custom GPTs
|
||||
- **[BMad Discord](https://discord.gg/gk8jAdXWmj)** - Obtenez de l'aide et partagez vos Gems/GPTs
|
||||
|
||||
---
|
||||
|
||||
**Prêt à économiser sur les coûts tout en construisant mieux ?** Téléchargez vos bundles et commencez avec Gemini Gems ! 🚀
|
||||
|
|
@ -0,0 +1,390 @@
|
|||
# Guide de Démarrage Rapide BMad Method v6
|
||||
|
||||
Commencez avec BMad Method v6 pour votre nouveau projet greenfield. Ce guide vous accompagne dans la construction de logiciels à partir de zéro en utilisant des workflows alimentés par l'IA.
|
||||
|
||||
## 🚀 TL;DR - Le Chemin Rapide
|
||||
|
||||
1. **Installer** : `npx bmad-method@alpha install`
|
||||
2. **Initialiser** : Chargez l'agent Analyste → Exécutez "workflow-init"
|
||||
3. **Planifier** : Chargez l'agent PM → Exécutez "prd" (ou "tech-spec" pour petits projets)
|
||||
4. **Architecturer** : Chargez l'agent Architecte → Exécutez "create-architecture" (10+ stories uniquement)
|
||||
5. **Construire** : Chargez l'agent SM → Exécutez les workflows pour chaque story → Chargez l'agent DEV → Implémentez
|
||||
6. **Toujours utiliser des chats frais** pour chaque workflow pour éviter les hallucinations
|
||||
|
||||
---
|
||||
|
||||
## 📖 Qu'est-ce que BMad Method ?
|
||||
|
||||
BMad Method (BMM) vous aide à construire des logiciels à travers des workflows guidés avec des agents IA spécialisés. Le processus suit quatre phases :
|
||||
|
||||
1. **Phase 1 : Analyse** (Optionnel) - Brainstorming, Recherche, Brief Produit
|
||||
2. **Phase 2 : Planification** (Requis) - Créez vos exigences (tech-spec ou PRD)
|
||||
3. **Phase 3 : Solution** (Dépend de la piste) - Concevez l'architecture pour les pistes BMad Method et Enterprise
|
||||
4. **Phase 4 : Implémentation** (Requis) - Construisez votre logiciel Epic par Epic, Story par Story
|
||||
|
||||
### Visualisation Complète du Workflow
|
||||
|
||||
|
||||
|
||||
_Organigramme visuel complet montrant toutes les phases, workflows, agents (codés par couleur) et points de décision pour la piste standard greenfield BMad Method. Chaque boîte est codée par couleur selon l'agent responsable de ce workflow._
|
||||
|
||||
## 💻 Installation
|
||||
|
||||
```bash
|
||||
# Installer v6 Alpha dans votre projet
|
||||
npx bmad-method@alpha install
|
||||
```
|
||||
|
||||
L'installateur interactif vous guidera à travers la configuration et créera un dossier `{bmad_folder}/` avec tous les agents et workflows.
|
||||
|
||||
**Configuration Langue :**
|
||||
|
||||
Lors de l'installation, vous serez invité à configurer :
|
||||
|
||||
```
|
||||
? Langue/Style de Chat Préféré ?
|
||||
> Français
|
||||
|
||||
? Langue de Sortie des Documents Préférée ?
|
||||
> Français (ou Anglais pour docs internationaux)
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🎯 Commencer
|
||||
|
||||
### Étape 1 : Initialiser Votre Workflow
|
||||
|
||||
1. **Chargez l'agent Analyste** dans votre IDE - Voir les instructions spécifiques à votre IDE dans [docs/fr/integration-ide.md](./integration-ide.md) :
|
||||
- [Claude Code](./integration-ide.md#-claude-code)
|
||||
- [Cursor](./integration-ide.md#-cursor)
|
||||
- [Windsurf](./integration-ide.md#-windsurf)
|
||||
- Autres IDEs également supportés
|
||||
|
||||
2. **Attendez le menu de l'agent** d'apparaître
|
||||
|
||||
3. **Dites à l'agent** : "Exécute workflow-init" ou tapez "\*workflow-init" ou sélectionnez le numéro de l'élément de menu
|
||||
|
||||
#### Que se passe-t-il pendant workflow-init ?
|
||||
|
||||
Les workflows sont des processus interactifs dans V6 qui ont remplacé les tâches et modèles des versions précédentes. Il existe de nombreux types de workflows, et vous pouvez même créer les vôtres avec le module BMad Builder.
|
||||
|
||||
Pendant workflow-init, vous décrirez :
|
||||
|
||||
- Votre projet et ses objectifs
|
||||
- S'il existe une base de code existante ou s'il s'agit d'un nouveau projet
|
||||
- La taille et la complexité générales (vous pouvez ajuster cela plus tard)
|
||||
|
||||
#### Pistes de Planification
|
||||
|
||||
En fonction de votre description, le workflow suggérera une piste et vous laissera choisir parmi :
|
||||
|
||||
**Trois Pistes de Planification :**
|
||||
|
||||
- **Quick Flow** - Implémentation rapide (tech-spec uniquement) - correctifs de bugs, fonctionnalités simples, portée claire (typiquement 1-15 stories)
|
||||
- **BMad Method** - Planification complète (PRD + Architecture + UX) - produits, plateformes, fonctionnalités complexes (typiquement 10-50+ stories)
|
||||
- **Enterprise Method** - Planification étendue (BMad Method + Sécurité/DevOps/Test) - exigences d'entreprise, conformité, multi-tenant (typiquement 30+ stories)
|
||||
|
||||
**Note** : Les nombres de stories sont des guides, pas des définitions. Les pistes sont choisies en fonction des besoins de planification, pas des mathématiques des stories.
|
||||
|
||||
#### Qu'est-ce qui est créé ?
|
||||
|
||||
Une fois que vous confirmez votre piste, le fichier `bmm-workflow-status.yaml` sera créé dans le dossier docs de votre projet (en supposant l'emplacement d'installation par défaut). Ce fichier suit votre progression à travers toutes les phases.
|
||||
|
||||
**Notes importantes :**
|
||||
|
||||
- Chaque piste a des chemins différents à travers les phases
|
||||
- Les nombres de stories peuvent encore changer en fonction de la complexité globale au fur et à mesure que vous travaillez
|
||||
- Pour ce guide, nous supposerons un projet de piste BMad Method
|
||||
- Ce workflow vous guidera à travers la Phase 1 (optionnel), Phase 2 (requis) et Phase 3 (requis pour les pistes BMad Method et Enterprise)
|
||||
|
||||
### Étape 2 : Travailler à Travers les Phases 1-3
|
||||
|
||||
Après la fin de workflow-init, vous travaillerez à travers les phases de planification. **Important : Utilisez des chats frais pour chaque workflow pour éviter les limitations de contexte.**
|
||||
|
||||
#### Vérifier Votre Statut
|
||||
|
||||
Si vous n'êtes pas sûr de ce qu'il faut faire ensuite :
|
||||
|
||||
1. Chargez n'importe quel agent dans un nouveau chat
|
||||
2. Demandez "workflow-status"
|
||||
3. L'agent vous indiquera le prochain workflow recommandé ou requis
|
||||
|
||||
**Exemple de réponse :**
|
||||
|
||||
```
|
||||
Phase 1 (Analyse) est entièrement optionnelle. Tous les workflows sont optionnels ou recommandés :
|
||||
- brainstorm-project - optionnel
|
||||
- research - optionnel
|
||||
- product-brief - RECOMMANDÉ (mais pas requis)
|
||||
|
||||
La prochaine étape VRAIMENT REQUISE est :
|
||||
- PRD (Product Requirements Document) en Phase 2 - Planification
|
||||
- Agent : pm
|
||||
- Commande : prd
|
||||
```
|
||||
|
||||
#### Comment Exécuter les Workflows dans les Phases 1-3
|
||||
|
||||
Quand un agent vous dit d'exécuter un workflow (comme `prd`) :
|
||||
|
||||
1. **Démarrez un nouveau chat** avec l'agent spécifié (ex : PM) - Voir [integration-ide.md](./integration-ide.md) pour les instructions spécifiques à votre IDE
|
||||
2. **Attendez le menu** d'apparaître
|
||||
3. **Dites à l'agent** de l'exécuter en utilisant l'un de ces formats :
|
||||
- Tapez le raccourci : `*prd`
|
||||
- Dites-le naturellement : "Créons un nouveau PRD"
|
||||
- Sélectionnez le numéro du menu pour "create-prd"
|
||||
|
||||
Les agents dans V6 sont très bons avec la correspondance floue de menu !
|
||||
|
||||
#### Référence Rapide : Correspondance Agent → Document
|
||||
|
||||
Pour les utilisateurs v4 ou ceux qui préfèrent sauter les conseils workflow-status :
|
||||
|
||||
- **Analyste** → Brainstorming, Brief Produit
|
||||
- **PM** → PRD (pistes BMad Method/Enterprise) OU tech-spec (piste Quick Flow)
|
||||
- **UX-Designer** → Document de Design UX (si l'UI fait partie du projet)
|
||||
- **Architecte** → Architecture (pistes BMad Method/Enterprise)
|
||||
|
||||
#### Phase 2 : Planification - Créer le PRD
|
||||
|
||||
**Pour les pistes BMad Method et Enterprise :**
|
||||
|
||||
1. Chargez l'**agent PM** dans un nouveau chat
|
||||
2. Dites-lui d'exécuter le workflow PRD
|
||||
3. Une fois terminé, vous aurez :
|
||||
- **PRD.md** - Votre Document de Spécifications Produit
|
||||
|
||||
**Pour la piste Quick Flow :**
|
||||
|
||||
- Utilisez **tech-spec** au lieu du PRD (pas d'architecture nécessaire)
|
||||
|
||||
#### Phase 2 (Optionnel) : Design UX
|
||||
|
||||
Si votre projet a une interface utilisateur :
|
||||
|
||||
1. Chargez l'**agent UX-Designer** dans un nouveau chat
|
||||
2. Dites-lui d'exécuter le workflow de design UX
|
||||
3. Après l'achèvement, vous aurez votre document de spécification UX
|
||||
|
||||
#### Phase 3 : Architecture
|
||||
|
||||
**Pour les pistes BMad Method et Enterprise :**
|
||||
|
||||
1. Chargez l'**agent Architecte** dans un nouveau chat
|
||||
2. Dites-lui d'exécuter le workflow create-architecture
|
||||
3. Après l'achèvement, vous aurez votre document d'architecture avec les décisions techniques
|
||||
|
||||
#### Phase 3 : Créer Epics et Stories (REQUIS après Architecture)
|
||||
|
||||
**Amélioration V6 :** Les epics et stories sont maintenant créées APRÈS l'architecture pour une meilleure qualité !
|
||||
|
||||
1. Chargez l'**agent PM** dans un nouveau chat
|
||||
2. Dites-lui d'exécuter "create-epics-and-stories"
|
||||
3. Cela décompose les FR/NFR de votre PRD en epics et stories implémentables
|
||||
4. Le workflow utilise à la fois le PRD et l'Architecture pour créer des stories techniquement informées
|
||||
|
||||
**Pourquoi après l'architecture ?** Les décisions d'architecture (base de données, modèles d'API, stack technique) affectent directement la façon dont les stories doivent être décomposées et séquencées.
|
||||
|
||||
#### Phase 3 : Vérification de Préparation à l'Implémentation (Hautement Recommandé)
|
||||
|
||||
Une fois les epics et stories créées :
|
||||
|
||||
1. Chargez l'**agent Architecte** dans un nouveau chat
|
||||
2. Dites-lui d'exécuter "implementation-readiness"
|
||||
3. Cela valide la cohésion à travers tous vos documents de planification (PRD, UX, Architecture, Epics)
|
||||
4. Ceci s'appelait la "PO Master Checklist" dans v4
|
||||
|
||||
**Pourquoi exécuter cela ?** Cela garantit que tous vos actifs de planification s'alignent correctement avant de commencer à construire.
|
||||
|
||||
#### Conseils de Gestion du Contexte
|
||||
|
||||
- **Utilisez des modèles de contexte 200k+** pour de meilleurs résultats (Claude Sonnet 4.5, GPT-4, etc.)
|
||||
- **Chat frais pour chaque workflow** - Brainstorming, Briefs, Recherche et génération de PRD sont tous intensifs en contexte
|
||||
- **Pas besoin de fragmentation de document** - Contrairement à v4, vous n'avez pas besoin de diviser les documents
|
||||
- **Bundles Web disponibles** - Aide à économiser les tokens LLM pour les utilisateurs avec des plans limités ([voir le guide](./bundles-web.md))
|
||||
|
||||
### Étape 3 : Commencer à Construire (Phase 4 - Implémentation)
|
||||
|
||||
Une fois la planification et l'architecture terminées, vous passerez à la Phase 4. **Important : Chaque workflow ci-dessous doit être exécuté dans un chat frais pour éviter les limitations de contexte et les hallucinations.**
|
||||
|
||||
#### 3.1 Initialiser la Planification Sprint
|
||||
|
||||
1. **Démarrez un nouveau chat** avec l'**agent SM (Scrum Master)**
|
||||
2. Attendez que le menu apparaisse
|
||||
3. Dites à l'agent : "Exécute sprint-planning"
|
||||
4. Cela crée votre fichier `sprint-status.yaml` qui suit tous les epics et stories
|
||||
|
||||
#### 3.2 Créer le Contexte Epic (Optionnel mais Recommandé)
|
||||
|
||||
1. **Démarrez un nouveau chat** avec l'**agent SM**
|
||||
2. Attendez le menu
|
||||
3. Dites à l'agent : "Exécute epic-tech-context"
|
||||
4. Cela crée un contexte technique pour l'epic actuel avant de rédiger les stories
|
||||
|
||||
#### 3.3 Rédiger Votre Première Story
|
||||
|
||||
1. **Démarrez un nouveau chat** avec l'**agent SM**
|
||||
2. Attendez le menu
|
||||
3. Dites à l'agent : "Exécute create-story"
|
||||
4. Cela rédige le fichier de story à partir de l'epic
|
||||
|
||||
#### 3.4 Ajouter le Contexte de Story (Optionnel mais Recommandé)
|
||||
|
||||
1. **Démarrez un nouveau chat** avec l'**agent SM**
|
||||
2. Attendez le menu
|
||||
3. Dites à l'agent : "Exécute story-context"
|
||||
4. Cela crée un contexte technique spécifique à l'implémentation pour la story
|
||||
|
||||
#### 3.5 Implémenter la Story
|
||||
|
||||
1. **Démarrez un nouveau chat** avec l'**agent DEV**
|
||||
2. Attendez le menu
|
||||
3. Dites à l'agent : "Exécute dev-story"
|
||||
4. L'agent DEV implémentera la story et mettra à jour le statut du sprint
|
||||
|
||||
#### 3.6 Réviser le Code (Optionnel mais Recommandé)
|
||||
|
||||
1. **Démarrez un nouveau chat** avec l'**agent DEV**
|
||||
2. Attendez le menu
|
||||
3. Dites à l'agent : "Exécute code-review"
|
||||
4. L'agent DEV effectue une validation de qualité (ceci s'appelait QA dans v4)
|
||||
|
||||
### Étape 4 : Continuer
|
||||
|
||||
Pour chaque story suivante, répétez le cycle en utilisant **des chats frais** pour chaque workflow :
|
||||
|
||||
1. **Nouveau chat** → agent SM → "Exécute create-story"
|
||||
2. **Nouveau chat** → agent SM → "Exécute story-context"
|
||||
3. **Nouveau chat** → agent DEV → "Exécute dev-story"
|
||||
4. **Nouveau chat** → agent DEV → "Exécute code-review" (optionnel mais recommandé)
|
||||
|
||||
Après avoir terminé toutes les stories dans un epic :
|
||||
|
||||
1. **Démarrez un nouveau chat** avec l'**agent SM**
|
||||
2. Dites à l'agent : "Exécute retrospective"
|
||||
|
||||
**Pourquoi des chats frais ?** Les workflows intensifs en contexte peuvent causer des hallucinations si vous continuez à émettre des commandes dans le même chat. Commencer frais garantit que l'agent a une capacité de contexte maximale pour chaque workflow.
|
||||
|
||||
---
|
||||
|
||||
## 🤖 Comprendre les Agents
|
||||
|
||||
Chaque agent est une persona IA spécialisée :
|
||||
|
||||
- **Analyste** - Initialise les workflows et suit la progression
|
||||
- **PM** - Crée des exigences et spécifications
|
||||
- **UX-Designer** - Si votre projet a un front-end - ce designer aidera à produire des artefacts, proposer des mises à jour de maquettes et concevoir un excellent look and feel avec vous pour le guider
|
||||
- **Architecte** - Conçoit l'architecture système
|
||||
- **SM (Scrum Master)** - Gère les sprints et crée les stories
|
||||
- **DEV** - Implémente le code et révise le travail
|
||||
|
||||
## 🔄 Comment Fonctionnent les Workflows
|
||||
|
||||
1. **Chargez un agent** - Ouvrez le fichier d'agent dans votre IDE pour l'activer
|
||||
2. **Attendez le menu** - L'agent présentera ses workflows disponibles
|
||||
3. **Dites à l'agent quoi exécuter** - Dites "Exécute [workflow-name]"
|
||||
4. **Suivez les invites** - L'agent vous guide à travers chaque étape
|
||||
|
||||
L'agent crée des documents, pose des questions et vous aide à prendre des décisions tout au long du processus.
|
||||
|
||||
## 📊 Fichiers de Suivi de Projet
|
||||
|
||||
BMad crée deux fichiers pour suivre votre progression :
|
||||
|
||||
**1. bmm-workflow-status.yaml**
|
||||
|
||||
- Montre dans quelle phase vous êtes et ce qui vient ensuite
|
||||
- Créé par workflow-init
|
||||
- Mis à jour automatiquement au fur et à mesure que vous progressez à travers les phases
|
||||
|
||||
**2. sprint-status.yaml** (Phase 4 uniquement)
|
||||
|
||||
- Suit tous vos epics et stories pendant l'implémentation
|
||||
- Critique pour que les agents SM et DEV sachent sur quoi travailler ensuite
|
||||
- Créé par le workflow sprint-planning
|
||||
- Mis à jour automatiquement au fur et à mesure que les stories progressent
|
||||
|
||||
**Vous n'avez pas besoin de les éditer manuellement** - les agents les mettent à jour au fur et à mesure que vous travaillez.
|
||||
|
||||
---
|
||||
|
||||
## 🌐 Support Multi-Langue
|
||||
|
||||
### Configuration Langue
|
||||
|
||||
BMad Method offre une **configuration double langue** unique :
|
||||
|
||||
**Langue de Communication** - Comment les agents vous parlent :
|
||||
```yaml
|
||||
communication_language: "Français"
|
||||
```
|
||||
|
||||
**Langue de Sortie des Documents** - Langue pour PRD, architecture, code :
|
||||
```yaml
|
||||
document_output_language: "Français" # ou "English"
|
||||
```
|
||||
|
||||
### Exemples
|
||||
|
||||
**Tout en Français :**
|
||||
```yaml
|
||||
communication_language: "Français"
|
||||
document_output_language: "Français"
|
||||
```
|
||||
|
||||
**Chat Français, Docs Anglais (Équipes Internationales) :**
|
||||
```yaml
|
||||
communication_language: "Français"
|
||||
document_output_language: "English"
|
||||
```
|
||||
|
||||
Voir le [Guide d'Installation](./installation.md#-configuration-multi-langue) pour plus de détails.
|
||||
|
||||
---
|
||||
|
||||
## ❓ Questions Courantes
|
||||
|
||||
**Q : Ai-je toujours besoin d'architecture ?**
|
||||
R : Uniquement pour les pistes BMad Method et Enterprise. Les projets Quick Flow passent directement de tech-spec à l'implémentation.
|
||||
|
||||
**Q : Puis-je changer mon plan plus tard ?**
|
||||
R : Oui ! L'agent SM a un workflow "correct-course" pour gérer les changements de portée.
|
||||
|
||||
**Q : Et si je veux brainstormer d'abord ?**
|
||||
R : Chargez l'agent Analyste et dites-lui "Exécute brainstorm-project" avant d'exécuter workflow-init.
|
||||
|
||||
**Q : Pourquoi ai-je besoin de chats frais pour chaque workflow ?**
|
||||
R : Les workflows intensifs en contexte peuvent causer des hallucinations s'ils sont exécutés en séquence. Les chats frais garantissent une capacité de contexte maximale.
|
||||
|
||||
**Q : Puis-je sauter workflow-init et workflow-status ?**
|
||||
R : Oui, une fois que vous apprenez le flux. Utilisez la Référence Rapide à l'Étape 2 pour aller directement aux workflows dont vous avez besoin.
|
||||
|
||||
## 💡 Obtenir de l'Aide
|
||||
|
||||
- **Pendant les workflows** : Les agents vous guident avec des questions et explications
|
||||
- **Communauté** : [Discord](https://discord.gg/gk8jAdXWmj) - #general-dev, #bugs-issues
|
||||
- **Guide complet** : [Documentation BMM](../../src/modules/bmm/docs/README.md)
|
||||
- **Tutoriels YouTube** : [Chaîne BMad Code](https://www.youtube.com/@BMadCode)
|
||||
|
||||
---
|
||||
|
||||
## ✅ Points Clés à Retenir
|
||||
|
||||
✅ **Utilisez toujours des chats frais** - Chargez les agents dans de nouveaux chats pour chaque workflow pour éviter les problèmes de contexte
|
||||
✅ **Laissez workflow-status vous guider** - Chargez n'importe quel agent et demandez le statut quand vous n'êtes pas sûr de ce qui vient ensuite
|
||||
✅ **La piste compte** - Quick Flow utilise tech-spec, BMad Method/Enterprise nécessite PRD et architecture
|
||||
✅ **Le suivi est automatique** - Les fichiers de statut se mettent à jour eux-mêmes, pas d'édition manuelle nécessaire
|
||||
✅ **Les agents sont flexibles** - Utilisez les numéros de menu, raccourcis (\*prd) ou langage naturel
|
||||
|
||||
**Prêt à commencer à construire ?** Installez BMad, chargez l'Analyste, exécutez workflow-init et laissez les agents vous guider !
|
||||
|
||||
---
|
||||
|
||||
## 📚 Prochaines Étapes
|
||||
|
||||
- 📖 Lire la [Documentation Complète BMM](../../src/modules/bmm/docs/README.md)
|
||||
- 🎨 Apprendre la [Personnalisation des Agents](../agent-customization-guide.md)
|
||||
- 🌐 Explorer les [Bundles Web](./bundles-web.md) pour Gemini/GPT
|
||||
- 🔧 Configurer l'[Intégration IDE](./integration-ide.md)
|
||||
- 💬 Rejoindre la [Communauté Discord](https://discord.gg/gk8jAdXWmj)
|
||||
|
|
@ -0,0 +1,380 @@
|
|||
# Guide d'Installation BMad Method
|
||||
|
||||
Ce guide vous accompagne dans l'installation et la configuration de BMad Method pour votre projet.
|
||||
|
||||
## 📋 Prérequis
|
||||
|
||||
Avant d'installer BMad Method, assurez-vous d'avoir :
|
||||
|
||||
- **Node.js** version 20.0.0 ou supérieure ([Télécharger Node.js](https://nodejs.org))
|
||||
- Un **éditeur de code** ou IDE compatible :
|
||||
- Claude Code (recommandé)
|
||||
- Cursor
|
||||
- Windsurf
|
||||
- VS Code avec extensions IA
|
||||
- Autres IDEs compatibles
|
||||
- **Git** (optionnel, mais recommandé pour le contrôle de version)
|
||||
|
||||
## 🚀 Installation Rapide
|
||||
|
||||
### Étape 1 : Installer BMad Method
|
||||
|
||||
Ouvrez votre terminal dans le répertoire de votre projet et exécutez :
|
||||
|
||||
```bash
|
||||
# Pour v6 Alpha (recommandé - fonctionnalités les plus récentes)
|
||||
npx bmad-method@alpha install
|
||||
|
||||
# OU pour v4 Stable (production)
|
||||
npx bmad-method install
|
||||
```
|
||||
|
||||
### Étape 2 : Configuration Interactive
|
||||
|
||||
L'installateur vous guidera à travers plusieurs questions de configuration :
|
||||
|
||||
#### Configuration de Base
|
||||
|
||||
**1. Nom d'utilisateur**
|
||||
```
|
||||
? Quel est votre nom ?
|
||||
> Votre Nom
|
||||
```
|
||||
Utilisé par les agents pour personnaliser la communication.
|
||||
|
||||
**2. Langue de Communication**
|
||||
```
|
||||
? Langue/Style de Chat Préféré ? (English, Mandarin, English Pirate, etc...)
|
||||
> Français
|
||||
```
|
||||
La langue dans laquelle les agents IA communiqueront avec vous pendant les workflows.
|
||||
|
||||
**3. Langue de Sortie des Documents**
|
||||
```
|
||||
? Langue de Sortie des Documents Préférée ?
|
||||
> Français
|
||||
```
|
||||
La langue utilisée pour tous les documents générés (PRD, architecture, code, etc.).
|
||||
Par défaut, elle correspond à votre langue de communication.
|
||||
|
||||
**4. Dossier BMAD**
|
||||
```
|
||||
? Nom du dossier BMAD ? (recommandé : .bmad)
|
||||
> .bmad
|
||||
```
|
||||
Où les agents, workflows et configurations seront stockés.
|
||||
|
||||
**5. Dossier de Sortie**
|
||||
```
|
||||
? Dossier de sortie pour les documents ?
|
||||
> {project-root}/docs
|
||||
```
|
||||
Où les documents de workflow (PRD, architecture, etc.) seront sauvegardés.
|
||||
|
||||
#### Configuration du Module
|
||||
|
||||
L'installateur vous demandera quels modules installer :
|
||||
|
||||
- **✅ BMad Method (BMM)** - Module de développement agile principal (recommandé)
|
||||
- **BMad Builder (BMB)** - Créez des agents et workflows personnalisés
|
||||
- **Creative Intelligence Suite (CIS)** - Workflows de brainstorming et innovation
|
||||
- **Content Creator** - Création de contenu avec correspondance vocale
|
||||
- **Marketing Ops** - Suite complète d'opérations marketing
|
||||
- **Career Coach** - Développement de carrière et rédaction de CV
|
||||
- **UX Writer** - Rédaction de copie d'interface et microcopy
|
||||
|
||||
### Étape 3 : Vérifier l'Installation
|
||||
|
||||
Après l'installation, vous devriez voir :
|
||||
|
||||
```
|
||||
docs/fr/
|
||||
└── {bmad_folder}/ # Par défaut : .bmad
|
||||
├── core/
|
||||
│ ├── config.yaml # Votre configuration
|
||||
│ └── agents/ # Agents principaux
|
||||
├── bmm/ # BMad Method (si installé)
|
||||
│ ├── config.yaml
|
||||
│ ├── agents/
|
||||
│ └── workflows/
|
||||
├── bmb/ # BMad Builder (si installé)
|
||||
├── cis/ # Creative Intelligence (si installé)
|
||||
├── content-creator/ # Content Creator (si installé)
|
||||
├── marketing-ops/ # Marketing Ops (si installé)
|
||||
├── career-coach/ # Career Coach (si installé)
|
||||
└── ux-writer/ # UX Writer (si installé)
|
||||
```
|
||||
|
||||
## 🎨 Configuration Multi-Langue
|
||||
|
||||
BMad Method offre un support unique de **double langue** :
|
||||
|
||||
### Séparation Communication vs Sortie
|
||||
|
||||
**Langue de Communication** (`communication_language`)
|
||||
- Comment les agents IA vous parlent pendant les workflows
|
||||
- Exemples : "Français", "English", "Español", "Mandarin", "English Pirate"
|
||||
- Utilisé pour les menus, questions et guidage interactif
|
||||
|
||||
**Langue de Sortie des Documents** (`document_output_language`)
|
||||
- Langue pour tous les documents générés (PRD, architecture, code, etc.)
|
||||
- Par défaut identique à la langue de communication
|
||||
- Peut être différente pour les équipes internationales
|
||||
|
||||
### Exemples de Configuration
|
||||
|
||||
**Exemple 1 : Tout en Français**
|
||||
```yaml
|
||||
communication_language: "Français"
|
||||
document_output_language: "Français"
|
||||
```
|
||||
- Les agents communiquent en français
|
||||
- Tous les documents en français
|
||||
|
||||
**Exemple 2 : Chat Français, Docs Anglais**
|
||||
```yaml
|
||||
communication_language: "Français"
|
||||
document_output_language: "English"
|
||||
```
|
||||
- Les agents vous parlent en français
|
||||
- PRD, architecture et code en anglais
|
||||
- **Parfait pour les équipes internationales !**
|
||||
|
||||
**Exemple 3 : Style Décontracté + Sortie Professionnelle**
|
||||
```yaml
|
||||
communication_language: "Français décontracté"
|
||||
document_output_language: "Français professionnel"
|
||||
```
|
||||
- Conversation décontractée avec les agents
|
||||
- Documentation formelle et professionnelle
|
||||
|
||||
### Modifier la Configuration Langue
|
||||
|
||||
**Option A : Édition Directe**
|
||||
```bash
|
||||
# Éditer le fichier de configuration principal
|
||||
nano .bmad/core/config.yaml
|
||||
```
|
||||
|
||||
Modifiez ces lignes :
|
||||
```yaml
|
||||
communication_language: "Français"
|
||||
document_output_language: "Français"
|
||||
```
|
||||
|
||||
**Option B : Réinstallation**
|
||||
```bash
|
||||
npx bmad-method@alpha install --quick
|
||||
```
|
||||
L'installateur détecte l'installation existante et vous demande uniquement les champs modifiés.
|
||||
|
||||
## 🔧 Configuration Avancée
|
||||
|
||||
### Personnaliser les Agents
|
||||
|
||||
Chaque agent peut être personnalisé via ses fichiers de configuration :
|
||||
|
||||
```bash
|
||||
# Fichier de personnalisation de l'agent
|
||||
.bmad/_cfg/agents/<agent-name>.customize.yaml
|
||||
```
|
||||
|
||||
Voir le [Guide de Personnalisation des Agents](../agent-customization-guide.md) pour plus de détails.
|
||||
|
||||
### Configuration Spécifique au Module
|
||||
|
||||
Chaque module a son propre `config.yaml` qui hérite des paramètres principaux :
|
||||
|
||||
```bash
|
||||
.bmad/bmm/config.yaml # Config BMad Method
|
||||
.bmad/cis/config.yaml # Config Creative Intelligence
|
||||
.bmad/content-creator/config.yaml # Config Content Creator
|
||||
```
|
||||
|
||||
Les valeurs principales (`communication_language`, `document_output_language`, `user_name`) sont **automatiquement héritées** de `.bmad/core/config.yaml`.
|
||||
|
||||
## 🔄 Mise à Jour de BMad Method
|
||||
|
||||
### Mise à Jour vers la Dernière Version
|
||||
|
||||
```bash
|
||||
# Mise à jour Alpha
|
||||
npx bmad-method@alpha install
|
||||
|
||||
# OU mise à jour Stable
|
||||
npx bmad-method install
|
||||
```
|
||||
|
||||
L'installateur :
|
||||
- ✅ Détecte votre installation existante
|
||||
- ✅ Préserve vos personnalisations
|
||||
- ✅ Met à jour les agents et workflows
|
||||
- ✅ Migre les configurations si nécessaire
|
||||
|
||||
### Vos Personnalisations Sont Sûres
|
||||
|
||||
BMad Method utilise un **système de personnalisation sûr pour les mises à jour** :
|
||||
|
||||
- Configurations dans `.bmad/core/config.yaml` - **Préservées**
|
||||
- Fichiers `.customize.yaml` - **Préservés**
|
||||
- Documents personnalisés dans `docs/` - **Préservés**
|
||||
- Agents et workflows principaux - **Mis à jour**
|
||||
|
||||
## 📦 Options d'Installation
|
||||
|
||||
### Installation Rapide (Skip Prompts)
|
||||
|
||||
```bash
|
||||
npx bmad-method@alpha install --quick
|
||||
```
|
||||
Utilise les valeurs par défaut et ne demande que les nouveaux paramètres.
|
||||
|
||||
### Installation Spécifique au Module
|
||||
|
||||
```bash
|
||||
# Installer uniquement BMad Method
|
||||
npx bmad-method@alpha install --module bmm
|
||||
|
||||
# Installer uniquement Creative Intelligence Suite
|
||||
npx bmad-method@alpha install --module cis
|
||||
```
|
||||
|
||||
### Installation Propre (Recommencer)
|
||||
|
||||
```bash
|
||||
# Sauvegarder d'abord vos personnalisations !
|
||||
npx bmad-method@alpha install --clean
|
||||
```
|
||||
Supprime l'installation existante et recommence.
|
||||
|
||||
## 🌐 Configuration IDE
|
||||
|
||||
Après l'installation, configurez votre IDE pour utiliser les agents BMad :
|
||||
|
||||
### Claude Code
|
||||
|
||||
Les agents sont automatiquement installés en tant que commandes slash :
|
||||
|
||||
```
|
||||
/bmad:bmm:agents:dev # Activer l'agent développeur
|
||||
/bmad:bmm:agents:architect # Activer l'agent architecte
|
||||
/bmad:bmm:workflows:prd # Exécuter le workflow PRD
|
||||
```
|
||||
|
||||
Voir le [Guide Claude Code](./integration-ide.md#claude-code) pour les détails.
|
||||
|
||||
### Cursor
|
||||
|
||||
Les agents sont installés en tant que règles MDC :
|
||||
|
||||
```
|
||||
@{bmad_folder}/bmm/agents/dev # Activer l'agent dev
|
||||
@{bmad_folder}/bmm/agents/architect # Activer l'agent architecte
|
||||
```
|
||||
|
||||
Voir le [Guide Cursor](./integration-ide.md#cursor) pour les détails.
|
||||
|
||||
### Windsurf
|
||||
|
||||
Configuration similaire à Cursor avec règles MDC.
|
||||
|
||||
Voir le [Guide Windsurf](./integration-ide.md#windsurf) pour les détails.
|
||||
|
||||
### Autres IDEs
|
||||
|
||||
Voir [docs/ide-info/](../ide-info/) pour les instructions spécifiques à votre IDE.
|
||||
|
||||
## 🎯 Premiers Pas
|
||||
|
||||
Après l'installation :
|
||||
|
||||
1. **Chargez un agent** dans votre IDE (voir [Guide d'Intégration IDE](./integration-ide.md))
|
||||
2. **Exécutez workflow-init** pour initialiser votre projet
|
||||
3. **Suivez les workflows guidés** pour construire votre logiciel
|
||||
|
||||
Voir le [Guide de Démarrage Rapide](./demarrage-rapide.md) pour un tutoriel complet.
|
||||
|
||||
## ❓ Résolution des Problèmes
|
||||
|
||||
### L'installation échoue avec une erreur Node.js
|
||||
|
||||
**Problème :** `Error: Node.js version X.X.X is not supported`
|
||||
|
||||
**Solution :**
|
||||
```bash
|
||||
# Vérifier la version de Node.js
|
||||
node --version
|
||||
|
||||
# Mettre à jour vers Node.js 20+
|
||||
# Visiter https://nodejs.org et télécharger la dernière version
|
||||
```
|
||||
|
||||
### Le dossier .bmad n'est pas créé
|
||||
|
||||
**Problème :** L'installation se termine mais pas de dossier `.bmad`
|
||||
|
||||
**Solution :**
|
||||
```bash
|
||||
# Vérifier si vous êtes dans le bon répertoire
|
||||
pwd
|
||||
|
||||
# Réexécuter avec des permissions appropriées
|
||||
npx bmad-method@alpha install
|
||||
```
|
||||
|
||||
### Les agents ne se chargent pas dans l'IDE
|
||||
|
||||
**Problème :** Les commandes slash ou règles ne fonctionnent pas
|
||||
|
||||
**Solution :**
|
||||
1. Vérifier que l'installation s'est terminée avec succès
|
||||
2. Redémarrer votre IDE
|
||||
3. Vérifier la configuration spécifique à l'IDE dans [docs/ide-info/](../ide-info/)
|
||||
|
||||
### Erreur "Module not found"
|
||||
|
||||
**Problème :** `Error: Cannot find module 'bmad-method'`
|
||||
|
||||
**Solution :**
|
||||
```bash
|
||||
# Vider le cache npm
|
||||
npm cache clean --force
|
||||
|
||||
# Réinstaller
|
||||
npx bmad-method@alpha install
|
||||
```
|
||||
|
||||
### Configuration Langue Pas Appliquée
|
||||
|
||||
**Problème :** Les agents ne parlent pas dans la langue configurée
|
||||
|
||||
**Solution :**
|
||||
1. Vérifier `.bmad/core/config.yaml` :
|
||||
```yaml
|
||||
communication_language: "Français"
|
||||
```
|
||||
2. Redémarrer une nouvelle conversation avec l'agent
|
||||
3. Les paramètres de langue prennent effet pour les nouvelles conversations
|
||||
|
||||
## 🆘 Obtenir de l'Aide
|
||||
|
||||
Si vous rencontrez des problèmes :
|
||||
|
||||
1. **Documentation** - [docs/index.md](../index.md) - Documentation complète
|
||||
2. **Discord** - [Rejoindre la Communauté](https://discord.gg/gk8jAdXWmj) - #help, #bugs-issues
|
||||
3. **GitHub Issues** - [Signaler un Bug](https://github.com/bmad-code-org/BMAD-METHOD/issues)
|
||||
4. **YouTube** - [Tutoriels BMadCode](https://www.youtube.com/@BMadCode)
|
||||
|
||||
## 📚 Prochaines Étapes
|
||||
|
||||
Après une installation réussie :
|
||||
|
||||
- 📖 Lire le [Guide de Démarrage Rapide](./demarrage-rapide.md)
|
||||
- 🎨 Apprendre la [Personnalisation des Agents](../agent-customization-guide.md)
|
||||
- 🌐 Explorer les [Bundles Web](./bundles-web.md) pour Gemini/GPT
|
||||
- 🔧 Configurer l'[Intégration IDE](./integration-ide.md)
|
||||
- 💬 Rejoindre la [Communauté Discord](https://discord.gg/gk8jAdXWmj)
|
||||
|
||||
---
|
||||
|
||||
**Besoin d'aide ?** Rejoignez notre communauté Discord ou consultez la documentation complète !
|
||||
|
|
@ -0,0 +1,530 @@
|
|||
# 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/](../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` :
|
||||
```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 :**
|
||||
```bash
|
||||
# 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
|
||||
|
||||
- **[Guide de Démarrage Rapide](./demarrage-rapide.md)** - Tutoriel de 15 minutes
|
||||
- **[Guide d'Installation](./installation.md)** - Configuration détaillée
|
||||
- **[Bundles Web](./bundles-web.md)** - Gemini Gems et Custom GPTs
|
||||
- **[Toute la Documentation](../index.md)** - Index complet
|
||||
|
||||
### Guides Spécifiques à l'IDE
|
||||
|
||||
- **[Claude Code](../ide-info/claude-code.md)** - Documentation détaillée
|
||||
- **[Cursor](../ide-info/cursor.md)** - Configuration Cursor
|
||||
- **[Windsurf](../ide-info/windsurf.md)** - Configuration Windsurf
|
||||
- **[Tous les IDEs](../ide-info/)** - Répertoire complet
|
||||
|
||||
### Support Communautaire
|
||||
|
||||
- **[Discord](https://discord.gg/gk8jAdXWmj)** - #help, #ide-setup
|
||||
- **[GitHub Issues](https://github.com/bmad-code-org/BMAD-METHOD/issues)** - Signaler des bugs
|
||||
- **[YouTube](https://www.youtube.com/@BMadCode)** - Tutoriels vidéo
|
||||
|
||||
---
|
||||
|
||||
**Prêt à commencer ?** Chargez votre premier agent et exécutez `*workflow-init` ! 🚀
|
||||
Loading…
Reference in New Issue