MemoryCustodian

1) MemoryCustodian installieren (wählen Sie den Pfad, der zu Ihrem Agenten/Workflow passt): Wählen Sie eine Installationsmethode: - Bitten Sie Ihren Codierungsagenten, die Fähigkeit aus dem Repository zu installieren: https://github.com/waittim/MemoryCustodian - Codex (lokaler Marktplatz): Führen Sie `codex plugin marketplace add .` von einem Checkout aus, dann `codex plugin add memory-custodian@memory-custodian-dev`. - Claude Code (Plugin): Für lokale Tests führen Sie `claude --plugin-dir .` aus, oder installieren Sie es in persönliche Fähigkeiten mit `./install.sh claude`. - Gemini-ähnliche Agenten: Installieren Sie mit `./install.sh gemini` oder `gemini skills link ./skills/memory-custodian`. - CLI/Quell-Checkout: Führen Sie vom Repository aus über `scripts/memory-custodian ...` aus oder installieren Sie editierbar mit `python3 -m pip install -e .`, um den Befehl `memory-custodian` zu erhalten.

2) MemoryCustodian in einem Projekt initialisieren (einmalig pro Repository): Führen Sie die Initialisierung einmal für jedes Zielprojekt aus: - Wenn als Konsolenskript installiert: `memory-custodian init --project-root /path/to/project --agent all` - Von einem Quell-Checkout: `scripts/memory-custodian init --project-root /path/to/project --agent all` Verwenden Sie `--agent codex`, `--agent claude`, `--agent gemini` oder `--agent all`, um die schlanken Bootstrap-Dateien zu generieren, die Ihr Agent liest.

3) Verstehen, was die Initialisierung erstellt (wo der Speicher lebt): Die Initialisierung erstellt den standardmäßigen dauerhaften Speicher unter `docs/memory/`: - `manifest.md` (steuert, was geladen werden soll) - `brief.md` (aktuelle Projektform) - `decisions.md` (Schlüsselentscheidungen) - `constraints.md` (harte Anforderungen) - `do-not-use.md` (abgelehnte Pfade / Grabsteine) - `inbox.md` (Staging-Bereich) Plattform-Bootstrap-Dateien (z. B. `AGENTS.md`, `CLAUDE.md`, `GEMINI.md`) bleiben schlank und verweisen Agenten auf `docs/memory/`.

4) Den generierten Brief kuratieren, bevor man sich darauf verlässt: Nach `init` beginnt `brief.md` als Gerüst mit TODOs. Füllen Sie es aus maßgeblichen Projektquellen (README, Code, Docs), bevor Sie den Speicher als bereit betrachten. Verwenden Sie `memory-custodian status --project-root /path/to/project` (oder `scripts/memory-custodian status ...`), um zu sehen, ob der Brief noch unkuratiert ist; `status` und `check` melden einen unkuratierten Brief.

5) Den richtigen Speicher für eine Aufgabe laden (Manifest-First-Lesen): Der vorgesehene Workflow für Agenten ist: 1) `docs/memory/manifest.md` lesen. 2) `docs/memory/brief.md` lesen. 3) Nur die vom Manifest als relevant für die aktuelle Aufgabe markierten Dateien laden. Für die manuelle Inspektion generieren Sie ein Kontextpaket mit: - `memory-custodian read --project-root /path/to/project --task planning` - `memory-custodian read --project-root /path/to/project --task implementation` - `memory-custodian read --project-root /path/to/project --task artifact`

6) Dauerhaften Speicher hinzufügen, wenn etwas den aktuellen Chat überleben soll: Entscheidungen/Einschränkungen/Präferenzen/abgelehnte Ansätze über die CLI aufzeichnen: - `memory-custodian add "Wir haben das Manifest-First-Laden gewählt." --type decision` - `memory-custodian add "Persist sync retry backoff." --type decision --area sync --reason "Keep retries bounded across launches."` Halten Sie Entscheidungseinträge kurz (das Tool erzwingt eine Token-Richtlinie und lehnt überlange Schreibvorgänge ab, es sei denn, Sie erlauben explizit lange Einträge).

7) Optionale Speichermodule nur aktivieren, wenn sie relevant werden: Optionale Module (z. B. Regeln, Profile, Bereiche) sind Opt-in und werden nur geladen, wenn sie aktiviert und vom Manifest geroutet werden. Aktivieren Sie sie bei Bedarf: - `memory-custodian enable preferences` - `memory-custodian enable rules/output` - `memory-custodian enable profile/git` - `memory-custodian enable area/frontend` Das Aktivieren überschreibt niemals eine vorhandene Moduldatei.

8) 'do-not-use' verwenden, um abgelehnte Ansätze zu bewahren und Regressionen zu vermeiden: Wenn Sie einen Ansatz absichtlich ablehnen (z. B. ein Speicher-Backend oder eine Architektur), zeichnen Sie ihn in `docs/memory/do-not-use.md` auf (durch Bearbeitungen oder den entsprechenden Add/Forget-Workflow), damit zukünftige Sitzungen ihn nicht erneut vorschlagen.

9) Regelmäßig die Integrität und Protokollkompatibilität überprüfen: Führen Sie eine deterministische Validierung durch, um sicherzustellen, dass Struktur, Budgets und Protokollmetadaten korrekt sind: - `memory-custodian check --project-root /path/to/project` Verwenden Sie `memory-custodian status` für einen schnellen Überblick und um einen unkuratierten Brief zu erkennen.

10) Speicher komprimieren und warten (Preview-First, sichere Mutationen): Verwenden Sie Wartungsbefehle, um den Speicher klein und aktuell zu halten: - `memory-custodian compact --project-root /path/to/project` Die Komprimierung ist geschützt und Preview-First; wenden Sie Änderungen erst nach Überprüfung des Plans an. Die Inbox-Komprimierung ist konservativ (z. B. exakte Duplikat-Entfernung von Top-Level-Bullet-Units und Tombstone-Filterung) und erwartet, dass ein Agent/Mensch die semantische Promotion in Entscheidungen/Einschränkungen vornimmt.

11) Veraltete Informationen sicher vergessen (Preview-First): Entfernen oder redigieren Sie veraltete Themen mit Preview-First-Vergessen: - Vorschau: `memory-custodian forget "alte Bereitstellungsnotiz" --mode soft --project-root /path/to/project` - Nach Überprüfung anwenden: `memory-custodian forget "alte Bereitstellungsnotiz" --mode soft --apply --project-root /path/to/project` Breite Übereinstimmungen erfordern eine explizite Bestätigung (z. B. `--allow-broad-match`). Einige Fälle erfordern eine manuelle Umschreibung; das Tool wird unsichere pauschale Löschungen ablehnen.

12) Eine bestehende Einrichtung bei Bedarf reparieren oder ersetzen: Wenn Dateien fehlen oder Metadaten aktualisiert werden müssen, ohne kuratierten Inhalt zu überschreiben: - Reparieren: `memory-custodian init --project-root /path/to/project --repair` Wenn Sie absichtlich einen vollständigen Ersatz wünschen, verwenden Sie den Preview-First-Ersatz und wenden Sie ihn nur an, wenn er korrekt ist: - `memory-custodian init --project-root /path/to/project --replace-existing` - dann fügen Sie `--apply` nur hinzu, wenn die aufgelisteten Dateien ersetzt werden sollen.

13) Protokoll-/Projekt-Speicherversionen migrieren, wenn das Tool aktualisiert wird: Wenn `check` alte oder fehlende Protokollmetadaten meldet, migrieren Sie das Projektmanifest offline: - Vorschau: `memory-custodian migrate --project-root /path/to/project` - Nach Überprüfung anwenden: `memory-custodian migrate --apply --project-root /path/to/project`

14) Die richtige Aufrufmethode unter Windows vs. Quell-Checkout verwenden: Unter Windows installieren Sie den Konsolenbefehl und verwenden `memory-custodian ...`. Von einem Repository-Checkout auf jeder Plattform können Sie `scripts/memory-custodian ...` als Wrapper ausführen.