bmad+
Menu
FRChoisir la langue
Démarrer
Parcourir la documentation

bmad-plus memory

Lire la santé de la mémoire du projet et du cerveau global, et exporter le cerveau global dans un seul fichier Markdown. Options, lectures et écritures, sortie, codes de sortie et erreurs.

Sur cette page
  1. Synopsis
  2. Ce qu’elle lit et écrit
  3. Codes de sortie
  4. Lire la sortie
  5. Erreurs et conduite à tenir
  6. Exemples

BMAD+ garde deux sortes de mémoire dans des fichiers Markdown simples. La mémoire du projet vit dans .agents/memory/ à l’intérieur de votre projet (décisions, leçons, motifs, contexte courant et une note de passation par session). Le cerveau global vit dans ~/.bmad-plus/brain et il est partagé par tous vos projets. bmad-plus memory répond à « ma mémoire est-elle en bon état ? » par un rapport en lecture seule, et peut copier le cerveau global dans un fichier portable. Elle s’adresse à qui a installé le pack Memory (l’agent Zecher) et veut le vérifier ou sauvegarder ce que le cerveau sait.

Synopsis

Dans le terminal de votre projet
npx bmad-plus memory [status] [-d <path>] [-l <code>]
npx bmad-plus memory export [-d <path>] [-l <code>]

Arguments et options de memory
OptionArgumentDéfautEffet
[subcommand]status ou exportstatusstatus affiche le rapport de santé ; export écrit le cerveau global dans un fichier du dossier du projet. Toute autre valeur affiche une erreur.
-d, --directory <path>chemindossier courantDossier du projet : là où .agents/memory/ est lu et où le fichier d’export est écrit.
-l, --lang <code>en, fr, es, de, pt-br, ru, zh, he, ja, itaucunAcceptée par cohérence avec les autres commandes. Le rapport lui-même est toujours affiché en anglais.

Ce qu’elle lit et écrit

Accès aux fichiers de memory
Sous-commandeLitÉcrit
status.agents/memory/decisions.md, lessons.md, patterns.md, context.md, sessions/*.md, .brain-link ; dans le cerveau global identity.yaml, decisions.md, lessons.md, patterns.md, projects/*.yaml, projects-index.md.Rien.
exportLe cerveau global : identity.yaml, decisions.md, lessons.md, patterns.md et chaque projects/*.yaml.bmad-brain-export-<YYYY-MM-DD>.md dans le dossier du projet (remplacé s’il existe déjà ce jour-là).

Deux détails comptent. D’abord, le rapport inspecte toujours le cerveau global dans ~/.bmad-plus/brain, même si votre projet est relié à un autre cerveau (un dossier _brain/ dans un répertoire parent, la variable BMAD_PLUS_BRAIN) ; le lien apparaît sur la ligne « Linked brain ». Ensuite, export ne touche pas la mémoire du projet, seulement le cerveau global. Une « entrée » dans les comptes est une ligne qui commence par ### dans le fichier Markdown.

Codes de sortie

Codes de sortie de memory
CodeSignification
0La commande est allée au bout. Cela inclut une sous-commande inconnue et un export sans cerveau global : les deux affichent une ligne d’erreur mais ne positionnent pas de code d’échec, donc n’utilisez pas memory comme porte de CI.

Lire la sortie

Le score de santé est la part de contrôles réussis sur dix au plus. Pour la mémoire du projet, les cinq contrôles sont : decisions.md, lessons.md, patterns.md et context.md existent, et sessions/ contient au moins une passation .md. Pour le cerveau global : identity.yaml, decisions.md, lessons.md, patterns.md et le dossier projects/ existent. Une partie non installée est exclue du score au lieu de compter pour zéro. Vert à partir de 80 %, jaune à partir de 50 %.

memory status (valeurs illustratives)Simulé
npx bmad-plus memory status
Project Memory (/home/ana/shop)
  decisions.md     ✓  3 entries  2026-10-12
  lessons.md       ✓  1 entries  2026-10-02
  patterns.md      ✓  0 entries  2026-09-30
  context.md       ✓  2026-10-17
  sessions/        ✓  2 handoff(s)
  Linked brain: /home/ana/.bmad-plus/brain
Global Brain (/home/ana/.bmad-plus/brain)
  identity.yaml    ✓
  decisions.md     ✓  0 entries
  lessons.md       ✓  0 entries
  patterns.md      ✓  0 entries
  projects/        ✓  1 project(s) indexed
  projects-index   ·
Health: 100% (10/10 checks)
Done!

Transcription illustrative, non capturée lors d’une exécution réelle. Source: tools/cli/commands/memory.js (branche status, modèles de messages) ; les nombres et les chemins sont inventés

memory export (chemin illustratif)Simulé
npx bmad-plus memory export
Brain exported to: /home/ana/shop/bmad-brain-export-2026-10-18.md
Done!

Transcription illustrative, non capturée lors d’une exécution réelle. Source: tools/cli/commands/memory.js (branche export, modèle de message) ; le chemin est inventé

Remarque À vérifier avant de partager l’export

L’export copie telles quelles vos décisions et leçons globales et vos fiches de projet, ainsi que identity.yaml (votre nom et votre langue). Relisez-le avant de l’envoyer à quelqu’un ou de le committer.

Erreurs et conduite à tenir

Messages affichés par memory
MessageCauseQue faire
Not installed. Run: npx bmad-plus install (select Memory pack)Il n’y a pas de dossier .agents/memory/ dans le projet.Installez le pack Memory : npx bmad-plus install --packs memory.
Not initialized. Run: npx bmad-plus install (select Memory pack)Il n’y a pas de dossier ~/.bmad-plus/brain sur cette machine.Installez le pack Memory dans un projet quelconque ; il crée le cerveau global sauf s’il trouve un autre cerveau à relier.
Global brain not found. Nothing to export.L’export ne regarde que ~/.bmad-plus/brain.Faites l’installation ci-dessus, ou utilisez scan pour commencer à remplir le cerveau.
Unknown subcommand: <name>Autre chose que status ou export.Utilisez status ou export. Pour le rappel et le journal, utilisez mem.
identity.yaml ✗ missingUn cerveau global sans son fichier d’identité (un « demi-cerveau »).Relancez l’installation du pack Memory ; elle complète les fichiers manquants sans jamais écraser les existants.

Exemples

Vérifier la santé de votre mémoire

Le pack Memory est installé et vous voulez savoir ce qui manque avant de vous y fier.

Dans votre assistant IA
Lance `bmad-plus memory status` dans ce projet et dis-moi quels fichiers de mémoire manquent ou sont vides.

Ce que vous devriez obtenir La commande affiche un bloc pour la mémoire du projet et un pour le cerveau global. Chaque fichier montre une coche ou une croix, son nombre d’entrées ### et sa date de dernière modification, sessions/ indique le nombre de passation, et la dernière ligne donne le pourcentage de santé avec le nombre de contrôles réussis. Rien n’est modifié sur le disque.

Sauvegarder le cerveau global

Vous allez réinstaller votre machine et voulez une copie lisible de ce que contient le cerveau.

Dans votre assistant IA
Exporte mon cerveau global avec `bmad-plus memory export` et dis-moi où se trouve le fichier.

Ce que vous devriez obtenir Un fichier nommé bmad-brain-export-<date>.md est écrit dans le dossier du projet. Il commence par # BMAD+ Brain Export et l’heure d’export, puis une section par fichier global (identity.yaml, decisions.md, lessons.md, patterns.md) dans un bloc de code, puis une section Projects avec une fiche YAML par projet indexé. La commande affiche le chemin complet.

Voir aussi