Que fait Tree Ring Memory ?
Utilisez Tree Ring Memory comme une couche mémoire lifecycle-aware, et non comme un dépotoir de transcriptions.
Tree Ring Memory préserve les apprentissages significatifs de l'agent comme les cernes d'un arbre :
- le travail récent reste détaillé
- les connaissances plus anciennes se compressent en cernes stables
- les avertissements importants restent visibles comme des cicatrices
- les vérités durables deviennent le cœur
- le travail futur spéculatif reste sous forme de graines
- les données sensibles sont bloquées, caviardées ou exclues par défaut
Quand rappeler
Rappelez la mémoire avant de :
- démarrer ou reprendre un projet
- changer l'architecture, le stockage, la sécurité, la confidentialité ou le comportement de publication
- répéter un flux de travail où des échecs antérieurs peuvent importer
- répondre à une correction de l'utilisateur
- prendre une décision qui dépend de préférences ou contraintes antérieures
- modifier des fichiers dans un dépôt qui a un contrat Tree Ring Memory ou
AGENTS.md - clôturer un travail significatif et décider ce qui doit être retenu
Utilisez des requêtes étroites avec un périmètre de projet lorsque c'est possible. Privilégiez les résultats liés à la source, à haute confiance et non remplacés.
Quand mémoriser
Stockez une mémoire lorsque l'information est susceptible d'aider les travaux futurs :
- l'utilisateur énonce une préférence durable
- l'utilisateur corrige l'agent
- une décision est prise et doit survivre à la session en cours
- une leçon de mise en œuvre est validée par des tests ou un comportement en production
- une approche ayant échoué ne doit pas être répétée
- un avertissement de sécurité, de confidentialité, de publication ou de perte de données apparaît
- une convention de projet utile est découverte
- une idée future doit être revisitée plus tard
Gardez la mémoire concise. Stockez la leçon, la décision ou l'avertissement, pas la conversation entière.
Utilisez tree-ring evidence au lieu de remember simple lorsque la leçon provient d'une évaluation, d'un point de contrôle, d'une expérience, d'une branche, d'un incident ou d'un artefact d'exécution examiné.
Utilisez des adaptateurs de source lorsque les artefacts du projet contiennent déjà des directives structurées ou des résultats évalués :
tree-ring dox sync --source-root . --dry-run
tree-ring revolve sync --source-root revolve --dry-run
tree-ring integrations scan --source-root .
Exécutez les commandes d'adaptateur avec --dry-run d'abord. Ne synchronisez que des résumés concis et liés à la source ; ne considérez jamais la mémoire importée comme plus autoritaire que la source AGENTS.md, l'enregistrement Revolve, l'évaluation, la PR, le problème ou l'artefact de test.
Utilisez les commandes CLI exactes exposées par l'installation locale :
tree-ring --help
tree-ring dox sync --help
tree-ring revolve sync --help
tree-ring evidence --help
Si le projet a été initialisé avec un binaire local au projet, privilégiez la référence générée .tree-ring/CLI.md et incluez --root .tree-ring si nécessaire.
Si cette compétence a été chargée via un fichier de pont natif du harnais, traitez ce pont comme un pointeur uniquement. Lisez le fichier .tree-ring/SKILL.md et .tree-ring/CLI.md locaux au projet lorsqu'ils sont présents, afin que les commandes correspondent à la racine du projet installé. Ne supposez pas qu'une configuration Tree Ring globale s'applique au dépôt actuel, sauf si l'utilisateur l'a explicitement configurée.
Correspondance des résultats d'évidence :
promoted: cœur durable provenant d'une évidence validéerejected: cicatrice pour les approches ayant échoué ou ayant été annulées, réutilisabledeferred: graine pour les options prometteuses non résoluesobserved: résultat d'évaluation de l'anneau externe
Sélection des cernes
Utilisez ces cernes :
cambium: contexte de tâche actif ou récentouter: décisions récentes et leçons de tâcheinner: connaissances de projet plus anciennes compresséesheartwood: vérités durables et préférences utilisateur à haute confiancescar: mémoire négative importante, échecs, régressions, approches rejetées et avertissementsseed: idées non résolues, hypothèses, suivis et travaux futurs
Ne passez pas à heartwood à partir d'une évidence faible. Préférez outer ou seed sauf si l'utilisateur confirme la durabilité ou si l'évidence est forte.
Types d'événements
Préférez les types d'événements spécifiques :
user_preferencedecisionlessonwarningcorrectionfile_changetool_resultsummaryhypothesis
Si une intégration hôte a des noms de types d'événements plus stricts, utilisez l'équivalent local le plus proche.
Ce qu'il ne faut pas stocker
Ne stockez pas :
- secrets
- identifiants
- jetons
- clés privées
- chaîne de pensée brute
- notes de brouillon temporaires
- affirmations non vérifiées comme vérité durable
- détails privés de santé, financiers, juridiques ou d'identification personnelle sans instruction explicite de l'utilisateur
- texte source protégé par le droit d'auteur au-delà de courts extraits autorisés
Si une mémoire utile contient du matériel sensible, stockez un résumé caviardé avec suffisamment de contexte pour être utile.
Source et périmètre
Définissez le projet et le périmètre délibérément :
- utilisez le périmètre du projet pour les règles, décisions, avertissements et leçons spécifiques au dépôt
- utilisez le périmètre de l'agent pour le comportement du profil de l'agent
- utilisez le périmètre global uniquement pour les préférences durables de l'utilisateur ou les directives transversales
- incluez des références de source telles que des chemins de fichiers, des identifiants d'issues, des identifiants de PR, des identifiants d'exécution ou des chemins de documentation
- utilisez
tree-ring evidence ... --evidence-ref <ref>pour les résultats évalués - utilisez
tree-ring dox syncpour des résumés concis d'AGENTS.md - utilisez
tree-ring revolve syncpour les enregistrements d'évaluation promus, rejetés, différés ou observés - utilisez
tree-ring integrations scanavant de configurer un nouveau harnais d'agent
La mémoire ne remplace pas les documents sources. Si un dépôt contient AGENTS.md, des documents de projet, des tests, des enregistrements architecturaux ou des fichiers d'instructions spécifiques à l'hôte, lisez ces sources directement et traitez-les comme faisant autorité.
Lorsque les enregistrements sources DOX ou Revolve changent, réexécutez l'adaptateur de synchronisation correspondant avec --dry-run, inspectez les mémoires générées, puis exécutez la commande d'écriture uniquement lorsque les résumés sont utiles et liés à la source.
Mises à jour médiatisées par l'agent
Tree Ring Memory ne scrappe pas les chats de manière autonome ni n'écrit de mémoire durable en arrière-plan. L'agent actif est responsable de décider quand une commande Tree Ring est justifiée, puis d'appeler délibérément la CLI.
Utilisez les fichiers de pont uniquement pour découvrir Tree Ring et sa référence de commande :
- les ponts au niveau du projet doivent pointer vers
.tree-ring/SKILL.mdet.tree-ring/CLI.md - les ponts globaux doivent être traités comme une configuration utilisateur opt-in
- les impulsions de flux d'événements TUI sont des signaux d'affichage, pas des mémoires durables
Avant d'écrire une mémoire, vérifiez que la leçon est durable, utile, respectueuse de la vie privée et fondée sur une instruction utilisateur ou une évidence source.
Oubli et correction
Si une mémoire est erronée, privée, obsolète ou remplacée :
- caviardez-la lorsque la forme durable est utile mais que les détails sont dangereux
- supprimez-la lorsqu'elle ne doit pas être conservée
- remplacez-la lorsqu'une décision plus récente la remplace
- préférez des raisons explicites pour chaque opération d'oubli
Ne conservez jamais une mémoire sciemment erronée simplement parce qu'elle a été rappelée précédemment.
Habitude de clôture
À la fin d'un travail significatif, demandez :
- Qu'avons-nous décidé ?
- Qu'avons-nous appris ?
- Que doivent éviter de répéter les futurs agents ?
- L'utilisateur a-t-il énoncé une préférence durable ?
- Y a-t-il une graine future qui mérite d'être revisitée ?
- Une mémoire est-elle sensible et vaut-il mieux ne pas la stocker ?
Ne retenez que les réponses qui amélioreront matériellement les travaux futurs.