Memória de Anel de Árvore

Visão Geral

Memória de Anel de Árvore é uma camada de ciclo de vida de memória local e independente de framework para agentes de IA. Use esta habilidade quando um agente precisar recordar, preservar, auditar ou esquecer memória durável de projeto sem tratar transcrições de conversas brutas como memória.

O runtime público é um CLI/TUI em Rust com armazenamento local SQLite/FTS, recall com escopo, registros de evidências, auditoria, consolidação determinística, manutenção, adaptadores de origem DOX/Revolve, descoberta de framework, redação e esquecimento explícito.

Quando Usar Esta Habilidade

• Use antes de retomar um projeto onde decisões anteriores, avisos, preferências ou abordagens falhas possam importar.
• Use antes de alterar arquitetura, armazenamento, segurança, privacidade, lançamento ou comportamento de memória do agente.
• Use quando o usuário pedir para lembrar, recordar, auditar, redigir, esquecer ou consolidar a memória do agente.
• Use após testes, revisões, incidentes ou comportamento de produção validarem uma lição que agentes futuros devam preservar.
• Use quando um projeto contiver .tree-ring/SKILL.md, .tree-ring/CLI.md ou outros arquivos de ponte Tree Ring.

Como Funciona

Etapa 1: Descobrir Orientação Local

Verifique se o projeto atual já possui orientação Tree Ring:

test -f .tree-ring/SKILL.md && sed -n '1,220p' .tree-ring/SKILL.md
test -f .tree-ring/CLI.md && sed -n '1,220p' .tree-ring/CLI.md

Trate arquivos .tree-ring locais do projeto como mais autoritativos do que exemplos genéricos nesta habilidade. Se o CLI estiver instalado, inspecione a superfície de comando atual antes de assumir flags:

tree-ring --help
tree-ring recall --help
tree-ring remember --help
tree-ring evidence --help
tree-ring audit --help
tree-ring forget --help

Se o Tree Ring não estiver instalado, resolva a raiz real do projeto e explique o download exato local do projeto antes de obter aprovação explícita para buscá-lo. Baixe o oficial, com versão fixada v0.15.0/install.sh para um arquivo temporário, verifique seu SHA-256 que é ef0d5eb8f09cbe2e4c3abe80ee9a98a56759c89ad4ddd103d6c68314cd653ade, inspecione-o e então execute-o. A origem fixada é https://raw.githubusercontent.com/TerminallyLazy/Tree-Ring-Memory/v0.15.0/install.sh.

cd <project-root>
sh <verified-installer-path> --project --init --release v0.15.0 --no-animation

Não canalize uma resposta de rede diretamente para um shell. Após a verificação e inspeção, mostre o comando exato do instalador e obtenha aprovação explícita novamente antes de executá-lo. Para um CLI global instalado, inicialize a partir da raiz do projeto com tree-ring --root .tree-ring init; para um CLI local do projeto, use .tree-ring/bin/tree-ring --root .tree-ring init.

Verifique se há uma versão mais recente sem alterar arquivos usando tree-ring update --check. Execute tree-ring update apenas com autorização do usuário, então execute novamente init em cada raiz de projeto para atualizar a orientação gerenciada enquanto preserva o conteúdo personalizado.

Etapa 2: Recordar Antes de Trabalho Arriscado

Use recall estreito e com escopo de projeto primeiro:

tree-ring recall "release behavior" --project example-service
tree-ring recall "sqlite migration" --project example-service
tree-ring recall "user preference"

Use a memória recordada como contexto, não como autoridade. Verifique-a contra arquivos de origem atuais, testes, documentação, issues, pull requests, logs e estado de runtime antes de fazer alterações.

Etapa 3: Escrever Apenas Memória Durável

Escreva memória concisa apenas quando for provável que ajude agentes futuros:

tree-ring remember "Run project-scoped recall before release changes." --event-type lesson --scope project

Prefira tipos de evento específicos quando suportados localmente:

• decision
• lesson
• warning
• correction
• user_preference
• tool_result
• summary
• hypothesis

Armazene a lição, decisão, aviso ou acompanhamento durável. Não armazene a conversa completa.

Etapa 4: Registrar Evidências para Resultados Avaliados

Use registros de evidências para execuções de teste, incidentes, alterações revisadas ou outros resultados avaliados:

tree-ring evidence \
  "Installer smoke test passed in an isolated HOME." \
  --outcome observed \
  --evidence-ref "ci/install-smoke/2026-07-08"

Orientação de resultado:

• promoted: verdade durável apoiada por forte evidência
• rejected: abordagem falha ou revertida que vale a pena manter visível
• deferred: ideia não resolvida ou opção futura
• observed: resultado avaliado normal

Não promova alegações fracas, desatualizadas ou não revisadas para verdade durável.

Etapa 5: Usar Adaptadores de Origem com Cuidado

Quando um repositório tiver registros de origem estruturados, execute primeiro simulações (dry runs):

…