Mémoire : décisions, leçons et cerveau

Une nouvelle session d’un assistant IA démarre de zéro : il ne se souvient pas pourquoi vous avez choisi une bibliothèque la semaine dernière ni de ce qui a mal tourné mardi. Le pack Memory y remédie avec de simples fichiers Markdown dans votre projet, un protocole qui dit à chaque agent quand les lire et les écrire, et un agent, Zecher, qui les tient en ordre. Cette page explique où vit la mémoire, comment un cerveau existant est détecté et relié, quelles commandes y touchent, et ce qui n’est jamais écrasé. Elle s’adresse à qui travaille sur le même projet sur plusieurs sessions, ou sur plusieurs projets qui devraient partager ce qu’ils apprennent.

Deux niveaux : mémoire de projet et cerveau#

La règle d’or : une information qui concerne un projet va dans la mémoire du projet ; une information qui concerne deux projets ou plus est candidate au cerveau. La remontée de l’un vers l’autre n’est jamais automatique. Zecher propose, vous approuvez.

Comment un cerveau existant est détecté#

Quand le pack Memory est installé, BMAD+ cherche un cerveau avant de rien créer. La première correspondance l’emporte.

Le résultat est écrit dans .agents/memory/.brain-link pour que chaque agent et chaque commande retrouve le même cerveau. Un cerveau trouvé est relié, jamais copié ni réécrit : ni duplication, ni écrasement. Un cerveau de portefeuille ou claude-memory garde ses propres conventions ; BMAD+ n’y crée ni identity.yaml ni projects/, et n’ajoute une entrée d’index du projet que lorsque le cerveau relié est le cerveau global de BMAD+. Les agents ont pour consigne de lire d’abord le point d’entrée propre d’un cerveau de portefeuille (README.md, AGENTS.md ou HOT.md) et d’en suivre l’organisation.

{
  "linked_brain": "/work/demo/home/.bmad-plus/brain",
  "brain_type": "bmad-global",
  "linked_at": "2026-10-19T02:13:36.733Z"
}

Les fichiers, et quand les agents y touchent#

### YYYY-MM-DD — <short title>
- **Context**: why the decision was needed
- **Decision**: what was chosen
- **Rationale**: why
- **Consequences**: what this unlocks / forecloses
- **Status**: active / superseded / rolled-back

Le protocole de lecture et d’écriture#

1. Début de session (lecture) : identity.yaml du cerveau, puis context.md, decisions.md et lessons.md du projet, et la dernière passation de sessions/ en cas de reprise. Un fichier absent est ignoré en silence : la mémoire est toujours facultative.
2. En cours de session (écriture sur déclencheur) : décisions, leçons, patterns et contexte comme dans le tableau ci-dessus.
3. Fin de session (persistance) : une passation dans sessions/, un context.md mis à jour, un coup d’œil aux leçons en attente, et un contrôle transversal qui ne fait que proposer des remontées vers le cerveau global.

Les quatre garde-fous#

Les instructions générées de chaque agent portent quatre règles de conduite, adaptées d’un projet communautaire inspiré des conseils d’Andrej Karpathy (voir la page de confiance pour le crédit). Elles relient les fichiers de mémoire au comportement quotidien.

Zecher, l’agent de mémoire#

Zecher (le nom signifie « souvenir » en hébreu) est un agent utilitaire : vous ou un autre agent l’appelez quand la mémoire demande de l’attention. Ce n’est pas un orchestrateur. Ses règles : ne jamais supprimer de mémoire (archiver, consolider, jamais détruire), toujours demander avant toute remontée vers le cerveau, des dates ISO 8601 (YYYY-MM-DD, jamais « la semaine dernière »), des entrées concises lisibles en dix secondes, et des renvois entre une leçon et la décision qu’elle concerne.

Les commandes : memory, scan et mem#

$ npx bmad-plus mem write --agent atelier --cli claude-code --task "Design read for the Orbit landing page: one job, the loyalty card sign-up" --outcome success --ci pass
mem write: event 912e91734848 appended (2026-10-19T02:13:48.840Z)
  agent=atelier cli=claude-code model=- outcome=success
  task: Design read for the Orbit landing page: one job, the loyalty card sign-up
$ npx bmad-plus mem recall "loyalty card sign-up"
mem recall: 2 match(es) for "loyalty card sign-up" (scope: project)
  1. [0.707] event journal.ndjson#912e91734848
     atelier claude-code Design read for the Orbit landing page: one job, the loyalty card sign-up success {"ci":"pass"}
  2. [0.522] note decisions.md § 2026-10-18 — The landing page has one job, the loyalty card sign-up
     2026-10-18 — The landing page has one job, the loyalty card sign-up - **Context**: design read for the Orbit landing pa…
$ npx bmad-plus mem outcomes
mem outcomes: no observations.
$ npx bmad-plus memory export
◆  📦 Brain exported to: /work/demo/app/bmad-brain-export-2026-10-19.md
# Avant le rappel, une entrée de décision au format ci-dessus a été ajoutée à la main à decisions.md. Sans tâche Nexus acceptée, il n’y a pas d’observation : le classement par preuves n’ajoute donc rien au classement simple.

Ce qui n’est jamais écrasé#

• Installer et mettre à jour n’écrasent jamais decisions.md, lessons.md ni patterns.md, ne suppriment jamais sessions/, et gardent vos modifications de context.md et identity.yaml. Les fichiers manquants sont créés depuis des gabarits ; les existants sont laissés tels quels.
• Un cerveau détecté est relié, pas copié ni réécrit. Les fichiers du cerveau global ne sont créés que s’ils manquent ; une ancienne installation interrompue pouvait laisser un « demi-cerveau », et le code actuel le complète de façon idempotente sans toucher à l’existant.
• La désinstallation retire les fichiers dont BMAD+ est propriétaire et garde .agents/memory/, _bmad/config.yaml et tout ce qui est à vous ou modifié (voir le bloc suivant).
• Un échec d’initialisation de la mémoire n’est pas fatal : si le dossier personnel est en lecture seule (conteneur, CI), l’installation continue et avertit.
• Les écrivains partagés utilisent .bmad/memory/writer.lock. Après une interruption, inspectez le propriétaire et les fichiers avant toute reprise manuelle ; ne retirez pas le verrou d’un écrivain vivant, et des preuves de résultats corrompues ne sont jamais réinitialisées automatiquement.

$ npx bmad-plus uninstall --yes
●  BMAD+ v0.23.0 (installed 2026-10-19)
●  Selected packs: core, memory
◇  ✅ BMAD+ removed (60 items)
└  Project memory, settings, and unknown or modified files have been preserved.
$ find . -path ./.git -prune -o -print | sort
./.agents/memory/.brain-link
./.agents/memory/context.md
./.agents/memory/decisions.md
./.agents/memory/lessons.md
./.agents/memory/patterns.md
./.agents/memory/sessions
./.bmad/memory/journal.ndjson
./_bmad/config.yaml
./bmad-brain-export-2026-10-19.md
# Les dossiers qui ne contenaient que des répertoires vides et les fichiers propres au projet (README.md, docs) sont omis de cet extrait. Le cerveau global du dossier personnel n’a pas été touché.

Zecher, où en étions-nous ? Reconstruis l’état de ce projet à partir de context.md, de la dernière passation de session, de l’entrée du cerveau et des derniers commits. Dis-moi ce qui a été décidé, ce qui est inachevé et quelles leçons s’appliquent à la prochaine tâche. Dis clairement ce que tu n’as pas trouvé, sans deviner.

Zecher, consolide la mémoire. D’abord, audite seulement : liste les doublons et les décisions actives de plus de 90 jours, et propose ce qu’il faut fusionner, archiver ou remonter vers le cerveau global. N’applique rien tant que je n’ai pas approuvé chaque changement, archive au lieu de supprimer, et écris les dates en YYYY-MM-DD.