Communitygithub.com

Tree Ring Memory

Camada de memória com ciclo de vida, agnóstica a frameworks e priorizando o local, para agentes de IA: CLI em Rust, SQLite/FTS para recall, esquecimento, auditoria, consolidação, adaptadores DOX/Revolve e TUI.

O que é Tree Ring Memory?

Tree Ring Memory é uma camada de memória inteligente para agentes de IA, projetada para preservar aprendizados significativos de forma estruturada, como anéis em uma árvore. Ela vai além de simples logs de transcrição: trabalho recente permanece detalhado, aprendizados antigos são comprimidos em anéis estáveis, avisos importantes ficam visíveis como cicatrizes, verdades duráveis se tornam cerne, ideias futuras especulativas são mantidas como sementes e dados sensíveis são bloqueados ou redigidos por padrão. A ferramenta oferece uma interface de linha de comando em Rust, usa SQLite com busca de texto completo (FTS) para recall eficiente e inclui funcionalidades de esquecimento, auditoria e consolidação. É compatível com múltiplos frameworks de agentes (como Claude Code, Cursor, Codex) através de adaptadores DOX (para sincronização com arquivos AGENTS.md) e Revolve (para avaliações e experimentos), além de uma interface TUI. O agente é responsável por decidir quando armazenar ou esquecer informações, garantindo que a memória permaneça concisa, acionável e privada, seguindo regras claras sobre o que não armazenar (como segredos, credenciais ou informações pessoais sem permissão explícita).

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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

O que Tree Ring Memory faz?

Use o Tree Ring Memory como uma camada de memória consciente do ciclo de vida, não como um depósito de transcrições.

O Tree Ring Memory preserva o aprendizado significativo de agentes como anéis de árvore:

  • trabalho recente permanece detalhado
  • aprendizado antigo é comprimido em anéis estáveis
  • avisos importantes permanecem visíveis como cicatrizes
  • verdades duráveis tornam-se cerne
  • trabalho especulativo futuro permanece como sementes
  • dados sensíveis são bloqueados, redigidos ou mantidos fora por padrão

Quando Recuperar

Recupere a memória antes de:

  • iniciar ou retomar um projeto
  • alterar arquitetura, armazenamento, segurança, privacidade ou comportamento de lançamento
  • repetir um fluxo de trabalho onde falhas anteriores possam ser relevantes
  • responder a uma correção do usuário
  • tomar uma decisão que dependa de preferências ou restrições anteriores
  • editar arquivos em um repositório que tenha um contrato Tree Ring Memory ou AGENTS.md
  • finalizar um trabalho significativo e decidir o que deve ser lembrado

Use consultas estreitas com escopo de projeto quando possível. Prefira resultados vinculados à fonte, de alta confiança e não substituídos.

Quando Lembrar

Armazene uma memória quando a informação provavelmente ajudar trabalhos futuros:

  • o usuário declara uma preferência duradoura
  • o usuário corrige o agente
  • uma decisão é tomada e deve sobreviver à sessão atual
  • uma lição de implementação é validada por testes ou comportamento em produção
  • uma abordagem falha não deve ser repetida
  • um aviso de segurança, privacidade, lançamento ou perda de dados aparece
  • uma convenção útil de projeto é descoberta
  • uma ideia futura deve ser revisitada depois

Mantenha a memória concisa. Armazene a lição, decisão ou aviso, não a conversa completa.

Use tree-ring evidence em vez de remember simples quando a lição vier de uma avaliação, checkpoint, experimento, branch, incidente ou artefato de execução revisado.

Use adaptadores de fonte quando artefatos de projeto já contêm orientação estruturada ou resultados avaliados:

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

Execute comandos de adaptador com --dry-run primeiro. Sincronize apenas resumos concisos e vinculados à fonte; nunca trate memória importada como mais autoritativa que a fonte AGENTS.md, registro Revolve, avaliação, PR, issue ou artefato de teste.

Use os comandos CLI exatos expostos pela instalação local:

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

Se o projeto foi inicializado com um binário local ao projeto, prefira a referência .tree-ring/CLI.md gerada e inclua --root .tree-ring quando necessário.

Se esta skill foi carregada por meio de um arquivo bridge nativo do harness, trate esse bridge apenas como um ponteiro. Leia o .tree-ring/SKILL.md e o .tree-ring/CLI.md locais do projeto quando presentes, para que os comandos correspondam à raiz do projeto instalado. Não presuma que uma configuração Tree Ring global se aplica ao repositório atual, a menos que o usuário a tenha configurado explicitamente.

Mapeamento de resultados de evidência:

  • promovido: cerne durável de evidência suportada
  • rejeitado: cicatriz para abordagens reutilizáveis que falharam ou foram revertidas
  • adiado: semente para opções promissoras não resolvidas
  • observado: resultado de avaliação do anel externo

Seleção de Anéis

Use estes anéis:

  • câmbio: contexto de tarefa ativo ou recente
  • externo: decisões recentes e lições de tarefa
  • interno: conhecimento de projeto antigo comprimido
  • cerne: verdades duráveis e de alta confiança, e preferências do usuário
  • cicatriz: memória negativa importante, falhas, regressões, abordagens rejeitadas e avisos
  • semente: ideias não resolvidas, hipóteses, acompanhamentos e trabalhos futuros

Não promova para cerne a partir de evidências fracas. Prefira externo ou semente a menos que o usuário confirme durabilidade ou a evidência seja forte.

Tipos de Evento

Prefira tipos de evento específicos:

  • preferência_do_usuário
  • decisão
  • lição
  • aviso
  • correção
  • alteração_de_arquivo
  • resultado_de_ferramenta
  • resumo
  • hipótese

Se uma integração de host tiver nomes de tipo de evento mais restritivos, use o equivalente local mais próximo.

O Que Não Armazenar

Não armazene:

  • segredos
  • credenciais
  • tokens
  • chaves privadas
  • cadeia de pensamento bruta
  • notas temporárias de rascunho
  • alegações não verificadas como verdade durável
  • detalhes privados de saúde, financeiros, legais ou identificadores pessoais sem instrução explícita do usuário
  • texto fonte protegido por direitos autorais além de pequenos trechos permitidos

Se uma memória útil contiver material sensível, armazene um resumo redigido com contexto suficiente para ser útil.

Fonte e Escopo

Defina projeto e escopo deliberadamente:

  • use escopo de projeto para regras, decisões, avisos e lições específicas do repositório
  • use escopo de agente para comportamento de perfil do agente
  • use escopo global apenas para preferências duráveis do usuário ou orientação entre projetos
  • inclua referências de fonte, como caminhos de arquivo, IDs de issue, IDs de PR, IDs de execução ou caminhos de documentação
  • use tree-ring evidence ... --evidence-ref <ref> para resultados avaliados
  • use tree-ring dox sync para resumos concisos de AGENTS.md
  • use tree-ring revolve sync para registros de avaliação promovidos, rejeitados, adiados ou observados
  • use tree-ring integrations scan antes de configurar um novo harness de agente

A memória não substitui documentos fonte. Se um repositório tiver AGENTS.md, documentação do projeto, testes, registros arquiteturais ou arquivos de instrução específicos do host, leia essas fontes diretamente e trate-as como autoritativas.

Quando registros fonte DOX ou Revolve mudarem, execute novamente o adaptador de sincronização correspondente com --dry-run, inspecione as memórias geradas e, em seguida, execute o comando de gravação apenas quando os resumos forem úteis e vinculados à fonte.

Atualizações Mediadas pelo Agente

O Tree Ring Memory não faz scraping autônomo de chats nem grava memória durável em segundo plano. O agente ativo é responsável por decidir quando um comando Tree Ring é justificado e, em seguida, chamar a CLI deliberadamente.

Use arquivos bridge apenas para descobrir o Tree Ring e sua referência de comando:

  • bridges de nível de projeto devem apontar para .tree-ring/SKILL.md e .tree-ring/CLI.md
  • bridges globais devem ser tratadas como configuração opcional do usuário
  • pulsos de fluxo de eventos da TUI são sinais de exibição, não memórias duráveis

Antes de gravar memória, verifique se a lição é durável, útil, segura quanto à privacidade e fundamentada em instrução do usuário ou evidência de fonte.

Esquecimento e Correção

Se a memória estiver errada, privada, desatualizada ou substituída:

  • redija-a quando a forma durável for útil, mas os detalhes forem inseguros
  • exclua-a quando não deva ser retida
  • substitua-a quando uma decisão mais nova a substituir
  • prefira razões explícitas para cada operação de esquecimento

Nunca mantenha memória sabidamente errada apenas porque foi recuperada anteriormente.

Hábito de Encerramento

Ao final de um trabalho significativo, pergunte:

  • O que decidimos?
  • O que aprendemos?
  • O que agentes futuros devem evitar repetir?
  • O usuário declarou uma preferência duradoura?
  • Há uma semente futura que vale a pena revisitar?
  • Alguma memória é sensível e melhor não ser armazenada?

Lembre-se apenas das respostas que melhorarão materialmente o trabalho futuro.

Habilidades Relacionadas