Communitygithub.com

Tree Ring Memory

Couche mémoire lifecycle-aware, locale et indépendante du framework pour agents IA : CLI Rust, rappel/FTS SQLite, oubli, audit, consolidation, adaptateurs DOX/Revolve et TUI.

Qu'est-ce que Tree Ring Memory ?

Tree Ring Memory est une couche mémoire lifecycle-aware conçue pour les agents IA, offrant une approche structurée de la mémorisation et du rappel d'informations pertinentes. Au lieu de stocker l'intégralité des conversations, elle préserve les apprentissages significatifs comme les cernes d'un arbre : le travail récent reste détaillé, les connaissances plus anciennes se compressent, les avertissements importants deviennent des cicatrices, les vérités durables forment le cœur, et les idées futures restent des graines. Le système repose sur une CLI Rust avec une base de données SQLite/FTS pour la recherche plein texte, et s'intègre à des frameworks comme DOX et Revolve via des adaptateurs synchronisés. Tree Ring Memory est conçu pour être utilisé localement, sans dépendance à un fournisseur de cloud, et supporte les agents de code comme Claude Code, Cursor, Codex, etc. Il permet de rappeler des mémoires avant de démarrer ou reprendre un projet, après une correction utilisateur, ou lors de changements d'architecture, et de stocker des préférences durables, des décisions, des leçons et des avertissements. Le système offre des fonctionnalités d'oubli, de correction et de consolidation, et encourage l'utilisation de types d'événements spécifiques (user_preference, decision, lesson, warning, etc.) et de sources liées (fichiers, issues, PRs) pour une traçabilité maximale.

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

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ée
  • rejected : cicatrice pour les approches ayant échoué ou ayant été annulées, réutilisable
  • deferred : graine pour les options prometteuses non résolues
  • observed : résultat d'évaluation de l'anneau externe

Sélection des cernes

Utilisez ces cernes :

  • cambium : contexte de tâche actif ou récent
  • outer : décisions récentes et leçons de tâche
  • inner : connaissances de projet plus anciennes compressées
  • heartwood : vérités durables et préférences utilisateur à haute confiance
  • scar : mémoire négative importante, échecs, régressions, approches rejetées et avertissements
  • seed : 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_preference
  • decision
  • lesson
  • warning
  • correction
  • file_change
  • tool_result
  • summary
  • hypothesis

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 sync pour des résumés concis d'AGENTS.md
  • utilisez tree-ring revolve sync pour les enregistrements d'évaluation promus, rejetés, différés ou observés
  • utilisez tree-ring integrations scan avant 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.md et .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.

Skills associés