Speichersystem
Die Persistenzeebene dieses Skills für projektspezifisches Gedächtnis befindet sich unter <project_root>/memories/ und wird über scripts/memory <cmd> gesteuert (gestützt durch references/memory_tool, die deterministische Quelle der Wahrheit für diese Ebene — ändern Sie nie deren Ausgabe und implementieren Sie sie nicht neu). Es wird nicht angenommen, dass der Host keinen anderen Speichermechanismus besitzt; falls einer existiert, behandeln Sie diesen als zusätzliche, dateibasierte Schicht daneben. Stdout ist JSON; führen Sie ein erneutes read aus, um den Zustand auf der Festplatte zu bestätigen.
Seit 1.1.0 erstellt init auch ein verstecktes <project_root>/.memsys-db (SQLite + FTS5, journal_mode=DELETE, eine Datei, kein -wal/-shm) — die regenerierbare Index- und Suchebene. Markdown bleibt die Quelle der Wahrheit.
Beginnen Sie hier, in dieser Reihenfolge:
- references/protocol.md — der vollständige Workflow von Erfassen → Abrufen → Schlussfolgern → Reflektieren → Ausführen → Verpacken, einschließlich Befehle und Schnellstart-Aufrufe.
- references/layout.md — Speicherlayout und was für eine bestimmte Abfrage geladen werden soll.
- references/when-to-save.md — Klassifizierung: Skill vs. Index vs. Thema vs. Ablehnen, sowie Routing von Skills vs. Speicher.
- references/constitution.md — harte Regeln (niemals Secret-Scan überspringen, niemals 200 Zeilen überschreiten, niemals außerhalb von
memories/schreiben, niemals via bash aufzählen, niemals WAL für das Journal verwenden). - references/memsys-db.md — der
.memsys-db-Journalvertrag: Schema,search/reindex/forgetund warum die Datenbank nie über Markdown gestellt wird. - references/examples.md — ausgearbeitete Beispiele: Happy Path, Secret-Ablehnung, Wiederherstellung nach Überschreiben.
Überprüfen Sie die Installation mit scripts/memory selftest vor der ersten Nutzung.