# 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.
Canonical: https://bmad-plus.rochetta.fr/de/docs/packs/memory-pack/
Language: de
BMAD+ version: 0.23.1
Documentation reviewed: 2026-10-19
Author: Laurent Rochetta
License: MIT
BMAD+ Dokumentation › [Packs](https://bmad-plus.rochetta.fr/de/docs/packs/) › Memory-Pack: Zecher und das persistente Gedächtnis
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).
## Wann du es brauchst
- Du arbeitest über viele Sitzungen am selben Projekt und erklärst die bereits getroffenen Entscheidungen immer wieder.
- Du jonglierst mit mehreren Projekten und willst einen einzigen Index mit Stack, Status und letzter Aktivität.
- Du führst bereits einen Notizordner (`_brain/` oder `~/.claude/memory/`): Das Pack verknüpft ihn, statt einen zweiten anzulegen.
## Was installiert wird
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.
**Die zwei Ebenen des Gedächtnisses**
| Ebene | Ort | Enthält |
| --- | --- | --- |
| Projektgedächtnis | `.agents/memory/` | `decisions.md`, `lessons.md`, `patterns.md`, `context.md`, `sessions/YYYY-MM-DD-.md` |
| Globales Brain | `~/.bmad-plus/brain/` | `identity.yaml`, projektübergreifende Entscheidungen, Erkenntnisse und Muster, `stack-preferences.md`, `projects/.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.
### Wie ein Brain gefunden wird
1. Die Umgebungsvariable `BMAD_PLUS_BRAIN` überstimmt alles, wenn sie auf einen Ordner zeigt.
2. Ein Ordner `_brain/` im Projekt oder in einem übergeordneten Ordner (ein Portfolio-Brain).
3. Das globale Brain `~/.bmad-plus/brain/`, nur wenn es schon existiert (fehlende Dateien werden ergänzt, nichts wird überschrieben).
4. Claudes eigener Gedächtnisordner `~/.claude/memory/`, nur wenn er nicht leer ist; er wird verknüpft, nicht kopiert.
5. 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**
```json
{ "linked_brain": "D:\\workspace\\_brain", "brain_type": "portfolio", "linked_at": "2026-05-17T09:00:00Z" }
```
`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.
## Schnellstart
1. **Das Pack installieren** Core wird automatisch ergänzt. Nötig ist nur Node.js 20: Das Gedächtnis besteht aus Dateien, ohne Datenbank und ohne Vektordienst.
```sh
npx bmad-plus install --packs memory
```
2. **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.
```sh
Zecher, scanne die Projekte in ~/dev
```
3. **Jede spätere Sitzung mit einem Rückblick beginnen** Frag nach dem Stand des Projekts, bevor du nach Arbeit fragst.
```sh
Zecher, wo waren wir stehen geblieben?
```
## Beispiele zum Kopieren
### Deine Projekte indexieren
Führe es einmal nach der Installation aus und wieder, wenn du Projekte hinzufügst.
**In deinem KI-Assistenten**
```text
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/.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**
```text
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.
### Eine Sitzung mit einer Übergabe beenden
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**
```text
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-.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.
### Die Gesundheit des Gedächtnisses prüfen
Nutze es, wenn sich die Notizen vom Code entfernt haben könnten.
**In deinem KI-Assistenten**
```text
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.
### Duplikate und veraltete Einträge konsolidieren
Nichts wird geändert, bevor du jeden Vorschlag freigibst.
**In deinem KI-Assistenten**
```text
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.
### Fragen, was die Notizen zu einem Thema sagen
Nutze es, bevor du etwas neu entscheidest: Es gleicht Entscheidungen, Erkenntnisse, Muster und Sitzungsnotizen ab.
**In deinem KI-Assistenten**
```text
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.
### Eine Erkenntnis ins globale Brain übernehmen
Nutze es, wenn sich eine Erkenntnis in einem zweiten Projekt bestätigt hat. Zecher fragt immer, bevor er etwas verschiebt.
**In deinem KI-Assistenten**
```text
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.
### Eine Notiz an ein verifiziertes Ergebnis binden
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**
```text
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.
## Zugehörige Kommandozeilenbefehle
**Befehle, die das Gedächtnis lesen oder schreiben**
| Befehl | Was er tut |
| --- | --- |
| `bmad-plus memory status` | Gesundheit des Projektgedächtnisses und des globalen Brains |
| `bmad-plus memory export` | Schreibt `bmad-brain-export-.md` in den Projektordner |
| `bmad-plus scan ` | Der Projekt-Scanner auf der Kommandozeile; Standardtiefe 4, aktiv unter 30 Tagen, pausiert unter 180 |
| `bmad-plus mem recall`, `write`, `reinforce`, `observe`, `outcomes` | Das Projektjournal abfragen und ergänzen; evidenzbasierte Rangfolge ist mit `--ranking evidence` optional |
## Was es schreibt und wo
- 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/`.
## Datenflüsse und Voraussetzungen
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.
## Grenzen und Stolpersteine
> **Warnung · Nichts läuft von allein** 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 ` ä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.
**Siehe auch**
- [Alle zehn Packs im Vergleich](https://bmad-plus.rochetta.fr/de/docs/packs/packs-overview/)
- [Gedächtnis, wie es funktioniert](https://bmad-plus.rochetta.fr/de/docs/concepts/how-memory-works/)
- [Referenz des Befehls memory](https://bmad-plus.rochetta.fr/de/docs/reference/cli-memory/)
- [Referenz des Befehls mem](https://bmad-plus.rochetta.fr/de/docs/reference/cli-mem/)
- [Referenz des Befehls scan](https://bmad-plus.rochetta.fr/de/docs/reference/cli-scan/)
[BMAD+ Dokumentation](https://bmad-plus.rochetta.fr/de/docs/) · [Packs](https://bmad-plus.rochetta.fr/de/docs/packs/)
[Quellcode auf GitHub](https://github.com/lrochetta/BMAD-PLUS)