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/bundles-web.md

21 KiB
Raw Blame History

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

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 :

# 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
  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)
  1. Téléchargez UN fichier XML (ex : pm.xml) - joignez comme fichier ou collez le contenu
  2. 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
  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)
  1. Sous ce texte, collez l'intégralité du contenu d'UN fichier XML (ex : pm.xml)
  2. Activez "Canvas" dans les paramètres ChatGPT pour une meilleure sortie de documents
  3. 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) - 8 Agents

  • 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 - Chef 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

Agent BMad Builder (BMB) - 1 Agent

  • bmad-builder.xml - Créez des agents, workflows et modules personnalisés

Agents BMad Game Development (BMGD) - 4 Agents

  • game-designer.xml - Conception de jeu et GDD (Game Design Document)
  • game-dev.xml - Développement de jeu (Unity, Unreal Engine)
  • game-architect.xml - Architecture technique de jeu
  • game-scrum-master.xml - Scrum master spécialisé jeux

Agents Creative Intelligence Suite (CIS) - 5 Agents

  • brainstorming-coach.xml - Facilitation de brainstorming créatif (Carson)
  • design-thinking-coach.xml - Résolution de problèmes centrée sur l'humain (Maya)
  • innovation-strategist.xml - Innovation et stratégie (Victor)
  • creative-problem-solver.xml - Résolution de problèmes révolutionnaire (Dr. Quinn)
  • storyteller.xml - Narration et storytelling (Sophia)

Agents Content Creator - 8 Agents

  • content-writer.xml - Rédaction de contenu principal (Casey)
  • content-analyzer.xml - Analyse de qualité et SEO (Alex)
  • research-aggregator.xml - Recherche et tendances (Riley)
  • voice-matcher.xml - Correspondance de voix et style (Vicki)
  • linkedin-repurposer.xml - Repurposing pour LinkedIn (Lauren)
  • newsletter-repurposer.xml - Repurposing pour newsletter (Nina)
  • conversational-repurposer.xml - Repurposing social media (Charlie)
  • seo-optimizer.xml - Optimisation SEO (Sam)

Agents Marketing Operations - 4 Agents

  • brand-marketer.xml - Stratège marketing de marque (Sofia)
  • media-buyer.xml - Spécialiste marketing de performance (Marcus)
  • marketing-analyst.xml - Analyste de données marketing (Elena)
  • marketing-designer.xml - Designer marketing créatif (Maya)

Agents Career Coach - 3 Agents

  • career-coach.xml - Coach carrière stratégique (Michael)
  • resume-writer.xml - Rédacteur de CV professionnel (Will)
  • interview-coach.xml - Coach entretien d'embauche (Jennifer)

Agent UX Writer - 1 Agent

  • ux-writer.xml - Spécialiste rédaction UX et microcopy (Alex)

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 :

  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

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

  2. 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

Plateformes

Prêt à économiser sur les coûts tout en construisant mieux ? Téléchargez vos bundles et commencez avec Gemini Gems ! 🚀