Commencez par une petite tâche dans votre projet. Ce guide distingue les commandes du terminal, les demandes à votre assistant IA et les étapes de mise à jour de BMAD+.
Il vous faut Node.js 20 ou plus récent et votre outil habituel de développement avec l’IA. BMAD+ fournit les instructions, les rôles et les workflows ; votre outil fournit le modèle et les autorisations d’exécution.
01
Ouvrir le dossier du projet
Ouvrez un terminal dans le dépôt sur lequel vous souhaitez travailler, puis vérifiez la version de Node.js. Conservez votre méthode habituelle de gestion de versions.
Dans le terminal du projet
node --version
La commande doit afficher v20 ou plus récent. Installez ou mettez à jour Node.js séparément si nécessaire.
02
Installer BMAD+ et choisir vos outils
Lancez l’installateur. Sélectionnez les adaptateurs de vos outils IA et les packs utiles au projet. Core contient Atlas, Forge, Sentinel et Nexus.
L’installateur crée les instructions des agents, le socle partagé et les adaptateurs sélectionnés. Certains packs facultatifs nécessitent d’autres environnements ou des accès API.
03
Démarrer une session dans ce même dossier
Ouvrez ou redémarrez votre assistant de code IA dans le projet pour qu’il charge son adaptateur et AGENTS.md. Demandez-lui les agents et workflows installés.
Dans votre assistant IA
bmad-help
Aucune commande d’initialisation BMAD+ supplémentaire n’est nécessaire. bmad-help est un message à l’assistant, pas une commande de terminal.
04
Confier une tâche précise à un rôle
Décrivez l’objectif, les contraintes et le résultat attendu. Pour une idée nouvelle, commencez avec Atlas. Pour modifier du code existant, commencez avec Forge.
Dans votre assistant IA
Atlas, aide-moi à cadrer une petite application de facturation pour indépendants. Pose des questions sur les utilisateurs, identifie le premier parcours utile et rédige un brief avec des critères d’acceptation.
Relisez le brief avant de demander à Forge d’implémenter une story. Un livrable précis facilite la vérification des progrès.
05
Vérifier le résultat et conserver le contexte
Demandez à Sentinel de contrôler le changement selon les critères d’acceptation. Demandez les résultats des tests et une courte transmission pour la prochaine session.
Dans votre assistant IA
Sentinel, relis ce changement selon les critères d’acceptation. Vérifie les principaux cas de réussite et d’échec, signale les problèmes restants et résume ce que la prochaine session doit savoir.
Relisez les changements et les résultats des tests. L’assistant suit les autorisations et les capacités de son outil hôte.
Exemples à adapter
Remplacez les détails du projet par les vôtres. Ces points de départ précisent le résultat que vous pourrez relire.
Passer d’une idée à une première version
À utiliser après avoir décrit les utilisateurs et le problème.
Dans votre assistant IA
Nexus, planifie la première version utilisable de mon application de prise de rendez-vous. Demande à Atlas de cadrer le périmètre, à Forge de proposer l’implémentation minimale et à Sentinel de définir les contrôles d’acceptation. Liste les dépendances et arrête-toi à la revue du plan avant l’implémentation.
Résultat attendu : un plan priorisé, une première story limitée et des points de revue explicites.
Corriger un bug dans un projet existant
Indiquez le comportement observé, les étapes de reproduction et les erreurs pertinentes.
Dans votre assistant IA
Forge, cherche pourquoi l’enregistrement d’une facture modifiée crée un doublon. Reproduis le problème, trouve sa cause et propose la correction minimale. Ajoute un contrôle de régression correspondant à l’échec réel, puis demande à Sentinel de revoir le parcours concerné.
Résultat attendu : un échec reproduit, une correction ciblée et la preuve que la régression est couverte.
Coordonner du travail indépendant
À utiliser si votre outil hôte gère les agents en parallèle et si les tâches n’écrivent pas dans les mêmes fichiers.
Dans votre assistant IA
Nexus, découpe le travail approuvé en tâches indépendantes. Donne à chaque rôle un périmètre, des fichiers à sa charge et une définition de terminé. Utilise des agents en parallèle uniquement si cet outil le permet ; sinon, exécute les tâches successivement. Intègre les résultats et demande à Sentinel de vérifier le parcours complet.
Résultat attendu : des missions délimitées, des dépendances explicites et une revue intégrée. L’exécution parallèle est fournie par l’outil hôte.
Reprendre sans perdre les décisions
À utiliser au début d’une nouvelle session dans le même projet.
Dans votre assistant IA
Lis AGENTS.md et la mémoire de projet disponible. Résume le dernier état vérifié, les décisions ouvertes et la prochaine tâche inachevée. Vérifie que les notes correspondent encore au code avant de continuer.
Résultat attendu : une reprise courte et fondée sur des éléments vérifiés. Les notes apportent du contexte, à confronter au travail actuel.
Vérifier et appliquer les mises à jour
Lancez ces commandes depuis le projet installé. Les contrôles ci-dessous utilisent une CLI déjà disponible. Si npx --no-install ne la trouve pas, utilisez la commande avec version explicite indiquée ensuite.
Vérifier la version publiée
Comparez la version installée avec npm. Le résultat contient installedVersion, latestVersion, status, updateAvailable et canAutoApply.
Si la CLI manque ou si l’installation est ancienne
Cette commande explicite télécharge la CLI documentée et vérifie le projet. Pour une version 0.12.2 ou antérieure, utilisez la migration du paragraphe suivant pour ajouter la détection des mises à jour.
Cette commande consulte à nouveau npm et demande confirmation de la version cible exacte. Lisez le rapport, notamment les fichiers personnalisés conservés.
Dans le terminal du projet
npx --no-install bmad-plus update --latest
Migrer depuis la version 0.12.2 ou antérieure
Utilisez une fois la CLI avec version explicite. Cette migration confirmée sauvegarde les fichiers remplacés, car les anciennes installations ne disposent pas d’empreintes complètes de propriété.
La notification est le mode par défaut. Vérifier une version n’active pas les mises à jour automatiques. Un résultat hors ligne, périmé ou indisponible signifie que la dernière version est inconnue.
Les mises à jour préservent les personnalisations identifiées. Le rapport peut signaler une application partielle lorsque des fichiers locaux sont conservés ; le numéro installé ne prouve pas que chaque fichier correspond à la version.
Après une mise à jour réussie, demandez à l’assistant de relire AGENTS.md et les compétences utiles, ou démarrez une nouvelle session.
La mise à jour du package BMAD+ et la synchronisation des sources BMAD-METHOD sont distinctes. Ces commandes mettent à jour BMAD+ ; elles ne fusionnent pas les sources amont dans votre projet.
Facultatif : autoriser une plage de mises à jour automatiques
Activez ce mode seulement si vous souhaitez appliquer les versions admissibles dans la plage semver indiquée. La CLI vérifie toujours l’environnement, la propriété des fichiers et la politique. Le mode notify rétablit les notifications.
Dans le terminal du projet
npx --no-install bmad-plus update-policy --mode auto --range "^0.13.0"
Les reçus et sauvegardes sont dans .bmad/updates/. Remplacez RECEIPT_ID par l’identifiant réel du reçu. La restauration vérifie les sauvegardes et refuse d’écraser des modifications locales ultérieures.
La dernière version publiée tient compte des changements locaux lors des mises à jour. Le guide et la commande d’installation décrivent la même version.
v0.13.0 ·
Des mises à jour qui respectent votre projet
Détectez les versions publiées, contrôlez la politique automatique et préservez les fichiers d’agents personnalisés.
Sélection de versions récentes, datées selon leur publication réelle sur npm. Les résumés décrivent les changements livrés dans chaque version. La page du package donne l’historique complet des versions.
v0.13.0 ·
Des mises à jour qui respectent votre projet
Détectez les versions publiées, contrôlez la politique automatique et préservez les fichiers d’agents personnalisés.
Les contrôles proposent une sortie JSON, un rafraîchissement et un mode hors ligne, avec notification par défaut.
Empreintes des fichiers, sauvegardes et reçus protègent les personnalisations identifiées et permettent la restauration.
L’installateur produit le socle partagé et sept adaptateurs à partir des mêmes définitions.
La désinstallation préserve la mémoire, les réglages et le contenu modifié dont la suppression sûre ne peut être établie.
L’assistant ne voit pas les agents. Que vérifier ?
Vérifiez qu’il est ouvert dans le projet installé, que son adaptateur a été choisi et que AGENTS.md et .agents/skills/ existent. Ouvrez une nouvelle session et demandez-lui de lire ces instructions. Chaque outil a ses propres règles de chargement.
Faut-il taper autopilot ou parallel dans le terminal ?
Non. bmad-help, autopilot et parallel sont des consignes de conversation pour l’assistant IA. Les commandes du terminal utilisent la CLI BMAD+, comme dans les exemples ci-dessus.
Le contrôle indique unknown ou offline. Suis-je à jour ?
Ce résultat ne permet pas de connaître la dernière version publiée. Continuez le travail puis relancez le contrôle quand le registre sera accessible. Un contrôle indisponible n’autorise pas à modifier la politique de mise à jour.