Zecher conserve décisions, leçons et passations de session dans des fichiers simples, entre sessions et projets. Installation, détection du cerveau, huit exemples, sorties, commandes CLI, limites.
Un assistant IA commence chaque session sans rien savoir d’hier. Le pack Memory y remédie avec de simples fichiers Markdown : ce qui a été décidé et pourquoi, ce qui a mal tourné, quels motifs ont fonctionné, où en est le projet, et une note de passation à la fin de chaque session. Zecher est l’agent qui entretient ces fichiers : il les consolide, parcourt votre machine à la recherche de projets, reconstruit le contexte d’une session à froid et contrôle la santé de la mémoire. Il existe deux niveaux de mémoire, l’un par projet et l’autre partagé entre projets (un cerveau global).
Le pack est empaqueté dans .agents/skills/pack-memory/ : l’orchestrateur memory-orchestrator.md, l’agent zecher-agent.md, deux documents partagés (shared/memory-protocol.md et shared/karpathy-guardrails.md) et des modèles pour decisions.md, lessons.md, patterns.md, context.md, session-handoff.md et identity.yaml. À l’installation, il crée aussi la mémoire de votre projet et la relie à un cerveau ; si aucun cerveau n’est trouvé, un nouveau cerveau global est créé dans ~/.bmad-plus/brain/, hors du projet. Si cette étape échoue, l’installation se poursuit.
identity.yaml, décisions, leçons et motifs communs aux projets, stack-preferences.md, projects/<hash>.yaml et projects-index.md
Cerveau de portefeuille
_brain/ dans le projet ou un dossier parent
Votre propre organisation de notes ; il prime sur le cerveau global et garde ses conventions
La règle d’or : ce qui concerne un seul projet va dans la mémoire du projet ; ce qui concerne deux projets ou plus est candidat au cerveau global, et seulement avec votre accord.
La variable d’environnement BMAD_PLUS_BRAIN, si elle désigne un dossier, l’emporte sur tout.
Un dossier _brain/ dans le projet ou dans un dossier parent (un cerveau de portefeuille).
Le cerveau global ~/.bmad-plus/brain/, seulement s’il existe déjà (les fichiers manquants sont complétés, rien n’est écrasé).
Le dossier de mémoire propre de Claude ~/.claude/memory/, seulement s’il n’est pas vide ; il est lié, pas copié.
Rien de trouvé : un nouveau cerveau global est créé dans ~/.bmad-plus/brain/ (avec identity.yaml, les trois fichiers de notes partagés et projects/) puis lié.
.agents/memory/.brain-link consigne le cerveau qui a été lié
brain_type vaut portfolio (un _brain/ d’espace de travail ou la variable d’environnement), bmad-global (~/.bmad-plus/brain) ou claude-memory (~/.claude/memory). Un cerveau de portefeuille garde sa propre organisation : les agents lisent d’abord son point d’entrée et n’y créent pas identity.yaml ni projects/ sans y avoir été invités.
Core est ajouté automatiquement. Seul Node.js 20 est nécessaire : la mémoire, ce sont des fichiers, sans base de données ni service vectoriel.
Dans le terminal du projet
npx bmad-plus install --packs memory
02
Laisser Zecher indexer vos projets une fois
Zecher parcourt un dossier, détecte la stack et le statut de chaque projet et vous demande de confirmer, modifier ou ignorer chaque entrée avant de l’écrire.
Dans le terminal du projet
Zecher, scanne les projets dans ~/dev
03
Commencer chaque session suivante par un rappel
Demandez l’état du projet avant de demander du travail.
À lancer une fois après l’installation, puis à nouveau quand vous ajoutez des projets.
Dans votre assistant IA
Zecher, scanne les projets dans ~/dev
Ce que vous devriez obtenir Zecher trouve les racines de projets grâce aux fichiers marqueurs (package.json, Cargo.toml, go.mod, .git et d’autres), en ignorant node_modules, vendor, dist et similaires, puis affiche un tableau : projet, stack, statut (actif sous 30 jours, en pause de 30 à 180, archivé au-delà), présence de BMAD+ et dernière modification. Pour chaque ligne vous choisissez confirmer, modifier, ignorer ou installer BMAD+ ; seuls les projets confirmés sont écrits dans ~/.bmad-plus/brain/projects/<hash>.yaml et dans le lisible projects-index.md.
À utiliser au début d’une session, dans un projet auquel vous n’avez pas touché depuis un moment.
Dans votre assistant IA
Zecher, où en étions-nous ?
Ce que vous devriez obtenir Zecher lit .agents/memory/context.md, la dernière passation dans .agents/memory/sessions/, l’entrée du projet dans le cerveau global, les dix derniers commits git et AGENTS.md ou CLAUDE.md, puis donne un bref « état du projet » : ce qu’il est, sa stack, le dernier sujet traité, les questions ouvertes de la session précédente, les problèmes connus et les leçons.
À utiliser avant de vous arrêter. « Passation » ne fait pas partie des formules fixes de Zecher : décrivez ce que vous voulez consigner et demandez vous-même la distinction entre fait et prévu.
Dans votre assistant IA
Zecher, mets à jour la mémoire de ce projet à partir des changements et des vérifications réellement effectués. Distingue ce qui est développé, testé, publié et encore en attente. Consigne les décisions et les preuves utiles, archive les notes remplacées sans les supprimer et écris une courte consigne pour la prochaine session. Garde la mémoire dans ce projet et exclus les secrets.
Ce que vous devriez obtenir Zecher met à jour context.md, écrit un fichier de passation daté .agents/memory/sessions/YYYY-MM-DD-<topic>.md et une consigne de reprise. Le modèle de passation (session-handoff.md) a les rubriques What changed, Decisions made, Open questions, Next steps et Files modified ; la distinction entre développé, testé, publié et en attente, et la consigne de reprise qui nomme la prochaine tâche inachevée, viennent de votre demande, pas du modèle. Aucune entrée n’est détruite : les entrées remplacées sont archivées.
À utiliser quand les notes ont pu s’éloigner du code.
Dans votre assistant IA
Zecher, contrôle de santé
Ce que vous devriez obtenir Un rapport : si les fichiers de mémoire existent et sont bien formés, les décisions encore marquées actives après plus de 90 jours (à revoir), les leçons qui reviennent (donc non apprises) et des statistiques comme les entrées par fichier et les dates de dernière mise à jour.
Rien n’est modifié avant que vous approuviez chaque proposition.
Dans votre assistant IA
Zecher, consolide la mémoire
Ce que vous devriez obtenir Trois phases. Audit : Zecher lit chaque fichier de mémoire et chaque note de session. Proposition : il indique combien de doublons, d’entrées périmées et de candidats à la remontée vers le cerveau global il a trouvés et vous demande d’approuver chaque changement. Exécution : les fusions approuvées gardent la version la plus riche, les entrées périmées sont déplacées en bas avec le préfixe [ARCHIVED], et les entrées approuvées remontent vers le cerveau global.
À utiliser avant de redécider quelque chose : il recoupe décisions, leçons, motifs et notes de session.
Dans votre assistant IA
Zecher, qu’avons-nous décidé pour la stratégie d’authentification, et qu’est-ce qui s’est mal passé la dernière fois ?
Ce que vous devriez obtenir Une réponse tirée des fichiers de mémoire en recoupant décisions, leçons, motifs et notes de session. Les règles de Zecher demandent des dates ISO et des liens entre une leçon et la décision qu’elle mentionne. Vérifiez les entrées citées : si les notes ne disent rien du sujet, un assistant peut tout de même combler le vide, alors demandez-lui de nommer sa source.
À utiliser quand une leçon s’est confirmée dans un second projet. Zecher demande toujours avant de déplacer quoi que ce soit.
Dans votre assistant IA
Zecher, remonte la leçon « ne jamais lancer les migrations au démarrage » de ce projet vers le cerveau global.
Ce que vous devriez obtenir Zecher montre l’entrée et le fichier cible puis attend votre accord, avant de la déplacer dans le lessons.md global. Si votre cerveau est un cerveau de portefeuille, le déplacement suit sa propre gouvernance et ses conventions plutôt que l’organisation globale.
Avancé : seulement après qu’une tâche Nexus a été vérifiée de façon indépendante et acceptée. Cela consigne la provenance ; cela ne prouve pas que la note a causé le succès.
Dans votre assistant IA
Zecher, consigne que la leçon sous « Cache invalidation » dans .agents/memory/lessons.md s’est appliquée à la tâche Nexus acceptée cache-fix de l’exécution small-change. Écris le fichier d’observation, lance bmad-plus mem observe dessus, puis montre bmad-plus mem outcomes.
Ce que vous devriez obtenir Le JSON d’observation nomme l’exécution, la tâche, une section de mémoire (fichier et titre), ses chemins de portée et votre interprétation. mem observe écrit un reçu dans .bmad/memory/outcomes.ndjson (pas dans le journal d’événements) ; mem outcomes liste les reçus encore éligibles, en excluant les périmés, remplacés ou contredits. Un mem recall --ranking evidence ultérieur donne un avantage borné aux preuves éligibles ; le rappel lexical par défaut ne change pas.
Dans le projet : .agents/memory/ (les quatre fichiers Markdown, sessions/, .brain-link) et, pour le journal de la CLI, .bmad/memory/journal.ndjson et .bmad/memory/pattern-scores.json, plus .bmad/memory/outcomes.ndjson pour les reçus de résultat.
Dans votre dossier personnel, seulement si le cerveau global est utilisé : ~/.bmad-plus/brain/ avec identity.yaml, les notes partagées et l’index des projets.
Réinstaller ou mettre à jour n’écrase jamais decisions.md, lessons.md ni patterns.md et ne supprime jamais sessions/.
Node.js 20 seulement. La mémoire est faite de fichiers locaux : le pack n’ouvre aucune connexion réseau et n’a aucun flux hors machine propre. Un service de rappel vectoriel ou RAG est un ajout facultatif, local et déployé séparément, qui ne fait pas partie du paquet npm, et --provision-python ne l’installe pas ; la mémoire Markdown et le scanner fonctionnent sans lui. Ce que votre assistant lit dans la mémoire part vers son modèle comme n’importe quel contexte : gardez les secrets hors des notes.
Le pack fournit des instructions et des fichiers que votre assistant doit suivre. Aucun crochet n’est installé au début ni à la fin d’une session : une session qui s’arrête sans tour d’agent n’a pas de passation garantie. Demandez la passation avant de vous arrêter.
Remarque· Profondeur du scan
La commande bmad-plus scan descend de 4 niveaux par défaut (--depth <n> le change). Quand vous demandez un scan à Zecher dans la conversation, précisez la profondeur voulue pour obtenir le même résultat.
Remarque· La mémoire n’est pas une preuve
Les notes sont un contexte à confronter au code actuel, pas des faits. Les enregistrements de résultat relient une note à une tâche acceptée ; ils ne montrent pas que la note a amélioré les résultats de l’assistant, et la seule persistance non plus.
Remarque· Provenance
L’architecture de la mémoire s’inspire de la méthode de notes de portefeuille de l’auteur. Les quatre garde-fous de comportement (réfléchir avant de coder, simplicité d’abord, changements chirurgicaux, exécution guidée par l’objectif) sont adaptés d’un projet communautaire de conseils inspirés de Karpathy ; voir THIRD-PARTY-LICENSES.md.