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 Evidenzrejected: Narbe für wiederverwendbare fehlgeschlagene oder zurückgerollte Ansätzedeferred: Samen für vielversprechende ungelöste Optionenobserved: äußerer Ring der Evaluierungsergebnisse
Ringauswahl
Verwende diese Ringe:
cambium: aktiver oder aktueller Aufgabenkontextouter: kürzliche Entscheidungen und Aufgabenlektioneninner: älteres, komprimiertes Projektwissenheartwood: dauerhafte, vertrauenswürdige Wahrheiten und Benutzerpräferenzenscar: wichtige negative Erinnerungen, Fehler, Regressionen, abgelehnte Ansätze und Warnungenseed: 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_preferencedecisionlessonwarningcorrectionfile_changetool_resultsummaryhypothesis
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 syncfür prägnanteAGENTS.md-Zusammenfassungen - verwende
tree-ring revolve syncfür promotions, abgelehnte, zurückgestellte oder beobachtete Evaluierungsaufzeichnungen - verwende
tree-ring integrations scanvor 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.mdund.tree-ring/CLI.mdverweisen - 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.