Communitygithub.com

Tree Ring Memory

Framework-unabhängige, lokale Speicherverwaltung für KI-Agenten: Rust CLI, SQLite/FTS Abruf, Vergessen, Prüfung, Konsolidierung, DOX/Revolve-Adapter und TUI.

Was ist Tree Ring Memory?

Tree Ring Memory ist ein bewusstseinsfähiger Speicher-Lebenszyklus für KI-Agenten, der Informationen in konzentrischen Ringen organisiert – ähnlich wie Baumringe. Aktuelle und detaillierte Arbeit bleibt im äußeren Ring (Cambium), während älteres Wissen zu stabilen inneren Ringen verdichtet wird. Wichtige Warnungen bleiben als „Narben“ sichtbar, bestätigte Wahrheiten wandern ins Kernholz, und zukünftige Ideen werden als Samen gespeichert. Das System bietet eine dezentrale, private und geprüfte Speicherlösung mit CLI-Befehlen für Recall, Remember, Forget und Evidence-Management. Es unterstützt Adapter für DOX (Projekt-Dokumentation) und Revolve (Evaluationsergebnisse) und kann mit SQLite/FTS durchsucht werden. Die TUI (Terminal-Benutzeroberfläche) bietet eine visuelle Ansicht des Speicherstatus. Plattformen: Claude Code, Cursor, Codex, oder andere agentenbasierte Entwicklungsumgebungen.

Funktioniert mit✓Claude Code~Codex CLI~Cursor
npx skills add TerminallyLazy/Tree-Ring-Memory

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Tree Ring Memory (Baumring-Gedächtnis)

Nutze Tree Ring Memory als lebenszyklusbewusste Gedächtnisschicht, nicht als Transkript-Depot.

Tree Ring Memory bewahrt bedeutungsvolles Agentenlernen wie Baumringe:

  • frische Arbeit bleibt detailliert
  • älteres Lernen verdichtet sich zu stabilen Ringen
  • wichtige Warnungen bleiben als Narben sichtbar
  • dauerhafte Wahrheiten werden zum Kernholz
  • spekulative zukünftige Arbeit bleibt als Samen erhalten
  • sensible Daten werden standardmäßig blockiert, geschwärzt oder ferngehalten

Wann abrufen

Rufe Erinnerungen ab, bevor:

  • ein Projekt gestartet oder wieder aufgenommen wird
  • die Architektur, Speicherung, Sicherheit, Privatsphäre oder das Release-Verhalten geändert wird
  • ein Arbeitsablauf wiederholt wird, bei dem frühere Fehler von Bedeutung sein könnten
  • auf eine Benutzerkorrektur reagiert wird
  • eine Entscheidung getroffen wird, die von früheren Präferenzen oder Einschränkungen abhängt
  • Dateien in einem Repository bearbeitet werden, das einen Tree Ring Memory- oder AGENTS.md-Vertrag enthält
  • sinnvolle Arbeit abgeschlossen wird und entschieden werden muss, woran erinnert werden soll

Verwende nach Möglichkeit enge Abfragen mit Projektumfang. Bevorzuge quellverknüpfte, vertrauenswürdige, nicht ersetzte Ergebnisse.

Wann erinnern

Speichere eine Erinnerung, wenn die Informationen wahrscheinlich für zukünftige Arbeiten nützlich sind:

  • der Benutzer eine dauerhafte Präferenz angibt
  • der Benutzer den Agenten korrigiert
  • eine Entscheidung getroffen wird und die aktuelle Sitzung überdauern soll
  • eine Implementierungserfahrung durch Tests oder Produktionsverhalten validiert wurde
  • ein fehlgeschlagener Ansatz nicht wiederholt werden sollte
  • eine Sicherheits-, Datenschutz-, Release- oder Datenverlustwarnung auftritt
  • eine nützliche Projektkonvention entdeckt wird
  • eine zukünftige Idee später wieder aufgegriffen werden sollte

Halte Erinnerungen prägnant. Speichere die Lektion, Entscheidung oder Warnung, nicht das gesamte Gespräch.

Verwende tree-ring evidence anstelle von einfachem remember, wenn die Lektion aus einer Evaluierung, einem Checkpoint, Experiment, Branch, Vorfall oder einem überprüften Lauf-Artefakt stammt.

Verwende Quelladapter, wenn Projektartefakte bereits strukturierte Anleitungen oder bewertete Ergebnisse enthalten:

tree-ring dox sync --source-root . --dry-run
tree-ring revolve sync --source-root revolve --dry-run
tree-ring integrations scan --source-root .

Führe Adapter-Befehle zuerst mit --dry-run aus. Synchronisiere nur prägnante, quellverknüpfte Zusammenfassungen; behandle importierte Erinnerungen niemals als autoritativer als die Quelle AGENTS.md, Revolve-Eintrag, Evaluierung, PR, Issue oder Test-Artefakt.

Verwende die genauen CLI-Befehle, die von der lokalen Installation bereitgestellt werden:

tree-ring --help
tree-ring dox sync --help
tree-ring revolve sync --help
tree-ring evidence --help

Wenn das Projekt mit einem projektlokalen Binary initialisiert wurde, bevorzuge die generierte .tree-ring/CLI.md-Referenz und füge bei Bedarf --root .tree-ring hinzu.

Wenn dieses Skill über eine Harness-native Brückendatei geladen wurde, behandle diese Brücke nur als Verweis. Lies die projektlokalen .tree-ring/SKILL.md und .tree-ring/CLI.md, wenn vorhanden, damit die Befehle mit dem installierten Projektstamm übereinstimmen. Gehe nicht davon aus, dass eine globale Tree-Ring-Einrichtung für das aktuelle Repository gilt, es sei denn, der Benutzer hat dies explizit konfiguriert.

Zuordnung von Evidenz-Ergebnissen:

  • promoted: dauerhaftes Kernholz aus unterstützter Evidenz
  • rejected: Narbe für wiederverwendbare fehlgeschlagene oder zurückgerollte Ansätze
  • deferred: Samen für vielversprechende ungelöste Optionen
  • observed: äußerer Ring der Evaluierungsergebnisse

Ringauswahl

Verwende diese Ringe:

  • cambium: aktiver oder aktueller Aufgabenkontext
  • outer: kürzliche Entscheidungen und Aufgabenlektionen
  • inner: älteres, komprimiertes Projektwissen
  • heartwood: dauerhafte, vertrauenswürdige Wahrheiten und Benutzerpräferenzen
  • scar: wichtige negative Erinnerungen, Fehler, Regressionen, abgelehnte Ansätze und Warnungen
  • seed: ungelöste Ideen, Hypothesen, Folgemaßnahmen und zukünftige Arbeiten

Verschiebe nicht zu heartwood aus schwacher Evidenz. Bevorzuge outer oder seed, es sei denn, der Benutzer bestätigt die Dauerhaftigkeit oder die Evidenz ist stark.

Ereignistypen

Bevorzuge spezifische Ereignistypen:

  • user_preference
  • decision
  • lesson
  • warning
  • correction
  • file_change
  • tool_result
  • summary
  • hypothesis

Wenn eine Host-Integration strengere Ereignistypnamen hat, verwende die nächstgelegene lokale Entsprechung.

Was nicht gespeichert werden soll

Speichere nicht:

  • Geheimnisse
  • Anmeldedaten
  • Tokens
  • private Schlüssel
  • rohe Denkkette
  • temporäre Notizen
  • unbestätigte Behauptungen als dauerhafte Wahrheit
  • private Gesundheits-, Finanz-, Rechts- oder persönliche Identifikatordetails ohne ausdrückliche Benutzeranweisung
  • urheberrechtlich geschützten Quelltext über kurze erlaubte Ausschnitte hinaus

Wenn eine nützliche Erinnerung sensibles Material enthält, speichere eine geschwärzte Zusammenfassung mit ausreichend Kontext, um nützlich zu sein.

Quelle und Umfang

Lege Projekt und Umfang gezielt fest:

  • verwende Projektumfang für repobezogene Regeln, Entscheidungen, Warnungen und Lektionen
  • verwende Agentenumfang für agentenprofilbezogenes Verhalten
  • verwende globalen Umfang nur für dauerhafte Benutzerpräferenzen oder prozessübergreifende Anleitungen
  • füge Quellverweise wie Dateipfade, Issue-IDs, PR-IDs, Lauf-IDs oder Dokumentationspfade hinzu
  • verwende tree-ring evidence ... --evidence-ref <ref> für bewertete Ergebnisse
  • verwende tree-ring dox sync für prägnante AGENTS.md-Zusammenfassungen
  • verwende tree-ring revolve sync für promotions, abgelehnte, zurückgestellte oder beobachtete Evaluierungsaufzeichnungen
  • verwende tree-ring integrations scan vor der Konfiguration eines neuen Agenten-Harness

Erinnerungen ersetzen keine Quelldokumente. Wenn ein Repository AGENTS.md, Projektdokumentation, Tests, Architekturaufzeichnungen oder hostspezifische Anweisungsdateien enthält, lies diese Quellen direkt und behandle sie als autoritativ.

Wenn sich DOX- oder Revolve-Quellaufzeichnungen ändern, führe den passenden Synchronisationsadapter erneut mit --dry-run aus, inspiziere die generierten Erinnerungen und führe dann den Schreibbefehl nur aus, wenn die Zusammenfassungen nützlich und quellverknüpft sind.

Agentenvermittelte Aktualisierungen

Tree Ring Memory scannt nicht autonom Chats oder schreibt dauerhafte Erinnerungen im Hintergrund. Der aktive Agent ist verantwortlich dafür, zu entscheiden, wann ein Tree-Ring-Befehl gerechtfertigt ist, und ruft dann gezielt die CLI auf.

Verwende Brückendateien nur, um Tree Ring und seine Befehlsreferenz zu entdecken:

  • projektbezogene Brücken sollten auf .tree-ring/SKILL.md und .tree-ring/CLI.md verweisen
  • globale Brücken sollten als optionale Benutzerkonfiguration behandelt werden
  • TUI-Ereignisstrom-Pulse sind Anzeigesignale, keine dauerhaften Erinnerungen

Bevor du eine Erinnerung schreibst, überprüfe, ob die Lektion dauerhaft, nützlich, datenschutzsicher und in Benutzeranweisungen oder Quellnachweisen begründet ist.

Vergessen und Korrektur

Wenn eine Erinnerung falsch, privat, veraltet oder ersetzt ist:

  • schwärze sie, wenn die dauerhafte Form nützlich ist, aber die Details unsicher sind
  • lösche sie, wenn sie nicht aufbewahrt werden sollte
  • ersetze sie, wenn eine neuere Entscheidung sie ersetzt
  • bevorzuge explizite Gründe für jeden Vergessensvorgang

Behalte niemals eine bekanntermaßen falsche Erinnerung, nur weil sie zuvor abgerufen wurde.

Abschlussgewohnheit

Am Ende sinnvoller Arbeit frage:

  • Was haben wir entschieden?
  • Was haben wir gelernt?
  • Was sollten zukünftige Agenten vermeiden, zu wiederholen?
  • Hat der Benutzer eine dauerhafte Präferenz angegeben?
  • Gibt es einen zukünftigen Samen, den es wert ist, wieder aufgegriffen zu werden?
  • Ist eine Erinnerung sensibel und besser nicht gespeichert?

Merke dir nur die Antworten, die die zukünftige Arbeit materiell verbessern werden.

Verwandte Skills