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 suportadarejeitado: cicatriz para abordagens reutilizáveis que falharam ou foram revertidasadiado: semente para opções promissoras não resolvidasobservado: resultado de avaliação do anel externo
Seleção de Anéis
Use estes anéis:
câmbio: contexto de tarefa ativo ou recenteexterno: decisões recentes e lições de tarefainterno: conhecimento de projeto antigo comprimidocerne: verdades duráveis e de alta confiança, e preferências do usuáriocicatriz: memória negativa importante, falhas, regressões, abordagens rejeitadas e avisossemente: 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áriodecisãoliçãoavisocorreçãoalteração_de_arquivoresultado_de_ferramentaresumohipó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 syncpara resumos concisos deAGENTS.md - use
tree-ring revolve syncpara registros de avaliação promovidos, rejeitados, adiados ou observados - use
tree-ring integrations scanantes 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.mde.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.