Memory-Pack: Zecher und das persistente Gedächtnis
Zecher bewahrt Entscheidungen, Erkenntnisse und Sitzungsübergaben in einfachen Dateien über Sitzungen und Projekte hinweg auf. Installation, Brain-Erkennung, acht Prompts, Ausgaben, CLI, Grenzen.
Ein KI-Assistent beginnt jede Sitzung ohne Wissen von gestern. Das Memory-Pack behebt das mit einfachen Markdown-Dateien: was entschieden wurde und warum, was schiefging, welche Muster funktionierten, wo das Projekt steht und eine Übergabenotiz am Ende jeder Sitzung. Zecher ist der Agent, der diese Dateien pflegt: Er konsolidiert sie, durchsucht deinen Rechner nach Projekten, baut den Kontext einer kalten Sitzung wieder auf und prüft die Gesundheit des Gedächtnisses. Es gibt zwei Ebenen, eine je Projekt und eine über Projekte hinweg geteilte (ein globales Brain).
Das Pack liegt gepackt in .agents/skills/pack-memory/: der Orchestrator memory-orchestrator.md, der Agent zecher-agent.md, zwei gemeinsame Dokumente (shared/memory-protocol.md und shared/karpathy-guardrails.md) und Vorlagen für decisions.md, lessons.md, patterns.md, context.md, session-handoff.md und identity.yaml. Bei der Installation legt es außerdem das Gedächtnis deines Projekts an und verknüpft es mit einem Brain; wird keines gefunden, entsteht ein neues globales Brain in ~/.bmad-plus/brain/, außerhalb des Projekts. Scheitert dieser Schritt, läuft die Installation weiter.
identity.yaml, projektübergreifende Entscheidungen, Erkenntnisse und Muster, stack-preferences.md, projects/<hash>.yaml und projects-index.md
Portfolio-Brain
_brain/ im Projekt oder in einem übergeordneten Ordner
Deine eigene Notizstruktur; sie hat Vorrang vor dem globalen Brain und behält ihre Konventionen
Die goldene Regel: Was nur ein Projekt betrifft, gehört ins Projektgedächtnis; was zwei oder mehr Projekte betrifft, ist Kandidat für das globale Brain, und nur mit deiner Zustimmung.
Die Umgebungsvariable BMAD_PLUS_BRAIN überstimmt alles, wenn sie auf einen Ordner zeigt.
Ein Ordner _brain/ im Projekt oder in einem übergeordneten Ordner (ein Portfolio-Brain).
Das globale Brain ~/.bmad-plus/brain/, nur wenn es schon existiert (fehlende Dateien werden ergänzt, nichts wird überschrieben).
Claudes eigener Gedächtnisordner ~/.claude/memory/, nur wenn er nicht leer ist; er wird verknüpft, nicht kopiert.
Nichts gefunden: Ein neues globales Brain wird in ~/.bmad-plus/brain/ angelegt (mit identity.yaml, den drei gemeinsamen Notizdateien und projects/) und verknüpft.
.agents/memory/.brain-link hält fest, welches Brain verknüpft wurde
brain_type ist portfolio (ein _brain/ des Arbeitsbereichs oder die Umgebungsvariable), bmad-global (~/.bmad-plus/brain) oder claude-memory (~/.claude/memory). Ein Portfolio-Brain behält seine eigene Struktur: Agenten lesen zuerst seinen Einstiegspunkt und legen darin ungefragt weder identity.yaml noch projects/ an.
Core wird automatisch ergänzt. Nötig ist nur Node.js 20: Das Gedächtnis besteht aus Dateien, ohne Datenbank und ohne Vektordienst.
Im Terminal deines Projekts
npx bmad-plus install --packs memory
02
Zecher deine Projekte einmal indexieren lassen
Zecher durchsucht einen Ordner, erkennt Stack und Status jedes Projekts und bittet dich, jeden Eintrag zu bestätigen, zu ändern oder zu überspringen, bevor er ihn schreibt.
Im Terminal deines Projekts
Zecher, scanne die Projekte in ~/dev
03
Jede spätere Sitzung mit einem Rückblick beginnen
Frag nach dem Stand des Projekts, bevor du nach Arbeit fragst.
Führe es einmal nach der Installation aus und wieder, wenn du Projekte hinzufügst.
In deinem KI-Assistenten
Zecher, scanne die Projekte in ~/dev
Das solltest du erhalten Zecher findet Projektwurzeln über Markerdateien (package.json, Cargo.toml, go.mod, .git und andere), überspringt node_modules, vendor, dist und Ähnliches und zeigt eine Tabelle aus Projekt, Stack, Status (aktiv unter 30 Tagen, pausiert 30 bis 180, darüber archiviert), BMAD+-Vorhandensein und letzter Änderung. Für jede Zeile wählst du bestätigen, ändern, überspringen oder BMAD+ installieren; nur bestätigte Projekte landen in ~/.bmad-plus/brain/projects/<hash>.yaml und in der lesbaren projects-index.md.
Den Kontext einer kalten Sitzung wiederherstellen#
Nutze es zu Beginn einer Sitzung in einem Projekt, das du länger nicht angefasst hast.
In deinem KI-Assistenten
Zecher, wo waren wir stehen geblieben?
Das solltest du erhalten Zecher liest .agents/memory/context.md, die letzte Übergabe in .agents/memory/sessions/, den Eintrag des Projekts im globalen Brain, die letzten zehn Git-Commits und AGENTS.md oder CLAUDE.md und gibt dann einen kurzen „Projektstand“: was es ist, der Stack, woran zuletzt gearbeitet wurde, offene Fragen der vorigen Sitzung, bekannte Probleme und Erkenntnisse.
Nutze es, bevor du aufhörst. „Übergabe“ gehört nicht zu Zechers festen Formulierungen, beschreibe also, was festgehalten werden soll, und verlange die Trennung von Erledigtem und Geplantem selbst.
In deinem KI-Assistenten
Zecher, aktualisiere das Gedächtnis dieses Projekts anhand der tatsächlich erledigten Änderungen und Prüfungen. Trenne Umgesetztes, Getestetes, Veröffentlichtes und noch Offenes. Halte Entscheidungen und nützliche Nachweise fest, archiviere ersetzte Notizen, ohne sie zu löschen, und schreibe einen kurzen Prompt für die nächste Sitzung. Halte das Gedächtnis im Projekt und lass Geheimnisse weg.
Das solltest du erhalten Zecher aktualisiert context.md, schreibt eine datierte Übergabedatei .agents/memory/sessions/YYYY-MM-DD-<topic>.md und einen Neustart-Prompt. Die Übergabevorlage (session-handoff.md) hat die Abschnitte What changed, Decisions made, Open questions, Next steps und Files modified; die Trennung in umgesetzt, getestet, veröffentlicht und offen sowie der Neustart-Prompt, der die nächste unfertige Aufgabe nennt, stammen aus deiner Anfrage, nicht aus der Vorlage. Einträge werden nie zerstört: Ersetzte werden archiviert.
Nutze es, wenn sich die Notizen vom Code entfernt haben könnten.
In deinem KI-Assistenten
Zecher, Gesundheitscheck
Das solltest du erhalten Ein Bericht: ob die Gedächtnisdateien vorhanden und wohlgeformt sind, Entscheidungen, die nach mehr als 90 Tagen noch als aktiv gelten (zu prüfen), Erkenntnisse, die sich wiederholen (also nicht gelernt wurden), und Statistiken wie Einträge je Datei und Daten der letzten Änderung.
Nichts wird geändert, bevor du jeden Vorschlag freigibst.
In deinem KI-Assistenten
Zecher, konsolidiere das Gedächtnis
Das solltest du erhalten Drei Phasen. Audit: Zecher liest jede Gedächtnisdatei und Sitzungsnotiz. Vorschlag: Er meldet, wie viele Duplikate, veraltete Einträge und Übernahmekandidaten für das globale Brain er fand, und bittet dich, jede Änderung freizugeben. Ausführung: Freigegebene Zusammenführungen behalten die reichhaltigste Fassung, veraltete Einträge wandern mit dem Präfix [ARCHIVED] nach unten, und freigegebene Übernahmen gehen ins globale Brain.
Nutze es, bevor du etwas neu entscheidest: Es gleicht Entscheidungen, Erkenntnisse, Muster und Sitzungsnotizen ab.
In deinem KI-Assistenten
Zecher, was haben wir zur Authentifizierungsstrategie entschieden, und was ging beim letzten Mal schief?
Das solltest du erhalten Eine aus den Gedächtnisdateien gezogene Antwort, die Entscheidungen, Erkenntnisse, Muster und Sitzungsnotizen abgleicht. Zechers Regeln verlangen ISO-Daten und Verknüpfungen zwischen einer Erkenntnis und der Entscheidung, auf die sie sich bezieht. Prüfe die genannten Einträge: Enthalten die Notizen nichts zum Thema, kann ein Assistent die Lücke trotzdem füllen, lass dir also seine Quelle nennen.
Nutze es, wenn sich eine Erkenntnis in einem zweiten Projekt bestätigt hat. Zecher fragt immer, bevor er etwas verschiebt.
In deinem KI-Assistenten
Zecher, übernimm die Erkenntnis „Migrationen nie beim Start ausführen“ aus diesem Projekt ins globale Brain.
Das solltest du erhalten Zecher zeigt den Eintrag und die Zieldatei und wartet auf deine Freigabe, bevor er ihn in die globale lessons.md verschiebt. Ist dein Brain ein Portfolio-Brain, folgt die Verschiebung dessen eigener Governance und Konventionen statt der globalen Struktur.
Fortgeschritten: erst nachdem eine Nexus-Aufgabe unabhängig verifiziert und akzeptiert wurde. Es hält die Herkunft fest; es beweist nicht, dass die Notiz den Erfolg verursacht hat.
In deinem KI-Assistenten
Zecher, halte fest, dass die Erkenntnis unter „Cache invalidation“ in .agents/memory/lessons.md auf die akzeptierte Nexus-Aufgabe cache-fix des Laufs small-change zutraf. Schreibe die Beobachtungsdatei, führe bmad-plus mem observe damit aus und zeige dann bmad-plus mem outcomes.
Das solltest du erhalten Das Beobachtungs-JSON nennt den Lauf, die Aufgabe, einen Gedächtnisabschnitt (Datei und Überschrift), seine Geltungspfade und deine Deutung. mem observe schreibt einen Beleg nach .bmad/memory/outcomes.ndjson (nicht ins Ereignisjournal); mem outcomes listet, welche Belege noch zulässig sind, ohne veraltete, ersetzte oder widersprochene. Ein späteres mem recall --ranking evidence gibt zulässigen Belegen einen begrenzten Schub; der Standard-Lexikalabruf bleibt unverändert.
Im Projekt: .agents/memory/ (die vier Markdown-Dateien, sessions/, .brain-link) und für das CLI-Journal .bmad/memory/journal.ndjson und .bmad/memory/pattern-scores.json, dazu .bmad/memory/outcomes.ndjson für Ergebnisbelege.
In deinem Home-Ordner, nur wenn das globale Brain genutzt wird: ~/.bmad-plus/brain/ mit identity.yaml, geteilten Notizen und dem Projektindex.
Neuinstallation oder Update überschreiben nie decisions.md, lessons.md oder patterns.md und löschen nie sessions/.
Nur Node.js 20. Das Gedächtnis besteht aus lokalen Dateien: Das Pack öffnet keine Netzwerkverbindung und hat keinen eigenen Datenfluss nach außen. Ein Vektor- oder RAG-Abrufdienst ist eine optionale, lokale, separat bereitgestellte Ergänzung, die nicht zum npm-Paket gehört, und --provision-python installiert sie nicht; Markdown-Gedächtnis und Scanner funktionieren ohne sie. Was dein Assistent aus dem Gedächtnis liest, geht wie jeder Kontext an sein Modell, halte also Geheimnisse aus den Notizen heraus.
Das Pack liefert Anweisungen und Dateien, denen dein Assistent folgen muss. Weder am Anfang noch am Ende einer Sitzung wird ein Hook installiert; eine Sitzung, die ohne Agentenzug endet, hat keine garantierte Übergabe. Bitte um die Übergabe, bevor du aufhörst.
Hinweis· Scan-Tiefe
Der Befehl bmad-plus scan geht standardmäßig 4 Ebenen tief (--depth <n> ändert das). Wenn du Zecher im Chat um einen Scan bittest, nenne die gewünschte Tiefe, damit beide dasselbe Ergebnis liefern.
Hinweis· Gedächtnis ist kein Beweis
Notizen sind Kontext, der gegen den aktuellen Code zu prüfen ist, keine Fakten. Ergebnisprotokolle binden eine Notiz an eine akzeptierte Aufgabe; sie zeigen nicht, dass die Notiz die Ergebnisse des Assistenten verbessert hat, und bloße Persistenz ebenso wenig.
Hinweis· Herkunft
Die Gedächtnisarchitektur ist von der Portfolio-Notizmethode des Autors inspiriert. Die vier Verhaltensleitplanken (vor dem Programmieren denken, Einfachheit zuerst, chirurgische Änderungen, zielgetriebene Ausführung) sind aus einem Community-Projekt mit von Karpathy inspirierten Leitlinien adaptiert; siehe THIRD-PARTY-LICENSES.md.