MemoryCustodian

MemoryCustodian speichert das gesamte Projektgedächtnis als reines Markdown unter docs/memory/. Damit ist es prüfbar, vergleichbar, versionierbar und rollback-sicher, genau wie Ihr Quellcode, was genau der Punkt ist, wenn das Gedächtnis echte Engineering-Entscheidungen festhält. Nichts steckt in einer proprietären Datenbank fest, und Teammitglieder prüfen Gedächtnisänderungen in denselben Pull Requests wie den Code.

Statt die ganze Historie in jeden Prompt zu stopfen, liest das Tool zuerst manifest.md, dann brief.md und danach nur die Dateien, die das Manifest für Ihre Aufgabe nennt. Das Routing nutzt ausdrückliche Aufgaben- und Bereichseingaben, ohne semantisches Raten oder LLM-Ranking. Das Kontext-Routing des Agenten bleibt deterministisch und vorhersehbar. Sie erhalten ein begrenztes Kontextpaket, das zur anstehenden Arbeit passt.

Die CLI bringt einen festen Satz von Aufgabenkategorien mit: general, planning, implementation, artifact, preferences, history und maintenance. Der Aufruf read --task implementation zieht das fürs Codelesen relevante Gedächtnis, während andere Aufgaben je nach übergebenem Bereich einen anderen Ausschnitt laden. Ein --strict-routing-Flag schlägt bei unvollständigem oder mehrdeutigem Bereich geschlossen fehl, statt zu raten.

Das aktive Gedächtnis ist belegbar. Einträge erhalten stabile IDs wie MC-DEC-... und MC-SUBJ-..., und jeder Schreibvorgang braucht eine Nutzerbestätigung oder eine Projektquelle, um als echt zu gelten. Unbestätigte Beobachtungen des Agenten bleiben als Kandidaten in inbox.md, bis ein Mensch sie bestätigt. Das hält Phantomregeln aus Ihrem Arbeitsgedächtnis und von Ihrem Code fern.

Das Vergessen läuft vorgabenbasiert mit Vorschau und Bereich: memory-custodian forget gibt eine Plan ID aus, die Sie bestätigen müssen, bevor etwas gelöscht wird. Dieser Vorschauschritt zählt, weil Gedächtnisdateien geteilt werden, ein schlechtes Löschen also den Agenten aller zugleich treffen kann. Wartungsbefehle wie compact halten die Dateien im Budget und archivieren die ältesten Einträge auf Wunsch. Getrennte Prüfungen decken Routing, Aktualität, Datenschutz, Sicherheit und Konflikte ab, einschließlich einer Git-Merge-bewussten Prüfung gegen einen Basisbranch.

Das ganze Tool läuft auf der Python-Standardbibliothek. Keine Drittanbieter-Laufzeitabhängigkeiten. Es arbeitet offline und braucht keine RAG-Pipeline und keine Vektor-Datenbank, was Embedding-Latenz und halluzinierte Abrufe vermeidet. Die Installation ist ein einziges editierbares pip install oder ein mitgelieferter Skript-Wrapper.