Communitygithub.com

Tree Ring Memory (Memoria de Anillos de Árbol)

Ciclo de vida de memoria para agentes de IA, local primero y sin dependencia de frameworks: CLI en Rust, recuperación con SQLite/FTS, olvido, auditoría, consolidación, adaptadores DOX/Revolve y TUI.

¿Qué es Tree Ring Memory (Memoria de Anillos de Árbol)?

Tree Ring Memory es un sistema de gestión del ciclo de vida de la memoria para agentes de IA, diseñado para ser independiente del framework y priorizar el almacenamiento local. Su objetivo no es almacenar transcripciones completas, sino preservar el aprendizaje significativo del agente de manera estructurada, similar a los anillos de un árbol: el trabajo reciente se mantiene detallado, el aprendizaje más antiguo se comprime en anillos estables, las advertencias importantes permanecen visibles como cicatrices, las verdades duraderas se convierten en duramen, el trabajo especulativo futuro se guarda como semillas, y los datos sensibles se bloquean, redactan o excluyen por defecto. Es útil porque permite a los agentes recordar decisiones, lecciones, preferencias del usuario y advertencias entre sesiones, mejorando la continuidad y la calidad del trabajo. Soporta integraciones con DOX (para sincronizar desde `AGENTS.md`) y Revolve (para registros de evaluación), y proporciona una interfaz de línea de comandos (CLI) en Rust y una interfaz de usuario textual (TUI). Funciona mediante comandos CLI específicos (`tree-ring remember`, `tree-ring evidence`, `tree-ring dox sync`, `tree-ring revolve sync`, `tree-ring forget`) que el agente invoca explícitamente en los momentos adecuados, y utiliza anillos (cambium, outer, inner, heartwood, scar, seed) para clasificar la memoria según su relevancia y durabilidad. También incluye un sistema de olvido y corrección para gestionar información errónea, privada o desactualizada.

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

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

¿Qué hace Tree Ring Memory (Memoria de Anillos de Árbol)?

Usa Tree Ring Memory como una capa de memoria consciente del ciclo de vida, no como un volcado de transcripciones.

Tree Ring Memory preserva el aprendizaje significativo del agente como los anillos de un árbol:

  • el trabajo reciente se mantiene detallado
  • el aprendizaje más antiguo se comprime en anillos estables
  • las advertencias importantes permanecen visibles como cicatrices
  • las verdades duraderas se convierten en duramen
  • el trabajo especulativo futuro se guarda como semillas
  • los datos sensibles se bloquean, redactan o excluyen por defecto

Cuándo Recordar

Recupera la memoria antes de:

  • iniciar o reanudar un proyecto
  • cambiar arquitectura, almacenamiento, seguridad, privacidad o comportamiento de lanzamiento
  • repetir un flujo de trabajo donde fallos anteriores puedan ser relevantes
  • responder a una corrección del usuario
  • tomar una decisión que dependa de preferencias o restricciones previas
  • editar archivos en un repositorio que tenga un contrato Tree Ring Memory o AGENTS.md
  • cerrar un trabajo significativo y decidir qué debe ser recordado

Usa consultas específicas con ámbito de proyecto cuando sea posible. Prefiere resultados vinculados a la fuente, de alta confianza y no superados.

Cuándo Recordar (Almacenar)

Almacena una memoria cuando la información probablemente ayude en trabajos futuros:

  • el usuario establece una preferencia duradera
  • el usuario corrige al agente
  • se toma una decisión que debe sobrevivir a la sesión actual
  • una lección de implementación es validada por pruebas o comportamiento en producción
  • un enfoque fallido no debe repetirse
  • aparece una advertencia de seguridad, privacidad, lanzamiento o pérdida de datos
  • se descubre una convención útil del proyecto
  • una idea futura debe ser revisitada más adelante

Mantén la memoria concisa. Almacena la lección, decisión o advertencia, no la conversación completa.

Usa tree-ring evidence en lugar de remember simple cuando la lección provenga de una evaluación, punto de control, experimento, rama, incidente o artefacto de ejecución revisado.

Usa adaptadores de origen cuando los artefactos del proyecto ya contengan orientación estructurada o resultados evaluados:

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

Ejecuta los comandos del adaptador con --dry-run primero. Sincroniza solo resúmenes concisos y vinculados a la fuente; nunca trates la memoria importada como más autoritativa que el AGENTS.md fuente, el registro de Revolve, la evaluación, el PR, el issue o el artefacto de prueba.

Usa los comandos CLI exactos expuestos por la instalación local:

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

Si el proyecto fue inicializado con un binario local del proyecto, prefiere la referencia .tree-ring/CLI.md generada e incluye --root .tree-ring cuando sea necesario.

Si esta habilidad se cargó a través de un archivo puente nativo del arnés, trata ese puente solo como un puntero. Lee el .tree-ring/SKILL.md y .tree-ring/CLI.md local del proyecto cuando estén presentes para que los comandos coincidan con la raíz del proyecto instalado. No asumas que una configuración Tree Ring global se aplica al repositorio actual a menos que el usuario la haya configurado explícitamente.

Mapeo de resultados de evidencia:

  • promoted (promovido): duramen duradero de evidencia respaldada
  • rejected (rechazado): cicatriz para enfoques fallidos o revertidos reutilizables
  • deferred (diferido): semilla para opciones no resueltas prometedoras
  • observed (observado): resultado de evaluación del anillo externo

Selección de Anillos

Usa estos anillos:

  • cambium (cambium): contexto de tarea activa o reciente
  • outer (externo): decisiones y lecciones de tareas recientes
  • inner (interno): conocimiento del proyecto comprimido más antiguo
  • heartwood (duramen): verdades duraderas de alta confianza y preferencias del usuario
  • scar (cicatriz): memoria negativa importante, fallos, regresiones, enfoques rechazados y advertencias
  • seed (semilla): ideas no resueltas, hipótesis, seguimientos y trabajo futuro

No promuevas a heartwood desde evidencia débil. Prefiere outer o seed a menos que el usuario confirme durabilidad o la evidencia sea sólida.

Tipos de Evento

Prefiere tipos de evento específicos:

  • user_preference (preferencia de usuario)
  • decision (decisión)
  • lesson (lección)
  • warning (advertencia)
  • correction (corrección)
  • file_change (cambio de archivo)
  • tool_result (resultado de herramienta)
  • summary (resumen)
  • hypothesis (hipótesis)

Si una integración anfitriona tiene nombres de tipo de evento más estrictos, usa el equivalente local más cercano.

Qué No Almacenar

No almacenes:

  • secretos
  • credenciales
  • tokens
  • claves privadas
  • cadena de pensamiento en bruto
  • notas de bloc de notas temporales
  • afirmaciones no verificadas como verdad duradera
  • detalles privados de salud, financieros, legales o identificadores personales sin instrucción explícita del usuario
  • texto fuente protegido por derechos de autor más allá de fragmentos cortos permitidos

Si una memoria útil contiene material sensible, almacena un resumen redactado con suficiente contexto para ser útil.

Fuente y Ámbito

Establece proyecto y ámbito deliberadamente:

  • usa ámbito de proyecto para reglas, decisiones, advertencias y lecciones específicas del repositorio
  • usa ámbito de agente para el comportamiento del perfil del agente
  • usa ámbito global solo para preferencias duraderas del usuario o guía entre proyectos
  • incluye referencias a la fuente como rutas de archivo, IDs de issue, IDs de PR, IDs de ejecución o rutas de documentos
  • usa tree-ring evidence ... --evidence-ref <ref> para resultados evaluados
  • usa tree-ring dox sync para resúmenes concisos de AGENTS.md
  • usa tree-ring revolve sync para registros de evaluación promovidos, rechazados, diferidos u observados
  • usa tree-ring integrations scan antes de configurar un nuevo arnés de agente

La memoria no reemplaza los documentos fuente. Si un repositorio tiene AGENTS.md, documentos del proyecto, pruebas, registros arquitectónicos o archivos de instrucción específicos del anfitrión, lee esas fuentes directamente y trátalas como autoritativas.

Cuando los registros fuente de DOX o Revolve cambien, vuelve a ejecutar el adaptador de sincronización correspondiente con --dry-run, inspecciona las memorias generadas, luego ejecuta el comando de escritura solo cuando los resúmenes sean útiles y estén vinculados a la fuente.

Actualizaciones Mediadas por el Agente

Tree Ring Memory no extrae chats de forma autónoma ni escribe memoria duradera en segundo plano. El agente activo es responsable de decidir cuándo un comando Tree Ring está justificado y luego llamar al CLI deliberadamente.

Usa archivos puente solo para descubrir Tree Ring y su referencia de comandos:

  • los puentes a nivel de proyecto deben apuntar a .tree-ring/SKILL.md y .tree-ring/CLI.md
  • los puentes globales deben tratarse como configuración de usuario opt-in
  • los pulsos del flujo de eventos TUI son señales de visualización, no memorias duraderas

Antes de escribir memoria, verifica que la lección sea duradera, útil, segura para la privacidad y basada en instrucciones del usuario o evidencia de la fuente.

Olvido y Corrección

Si la memoria es incorrecta, privada, desactualizada o superada:

  • redáctala cuando la forma duradera sea útil pero los detalles sean inseguros
  • elimínala cuando no deba conservarse
  • supérala cuando una decisión más nueva la reemplace
  • prefiere razones explícitas para cada operación de olvido

Nunca mantengas memoria conocida como incorrecta solo porque fue recordada anteriormente.

Hábito de Cierre

Al final de un trabajo significativo, pregúntate:

  • ¿Qué decidimos?
  • ¿Qué aprendimos?
  • ¿Qué deberían evitar repetir los agentes futuros?
  • ¿Dijo el usuario una preferencia duradera?
  • ¿Hay una semilla futura que valga la pena revisitar?
  • ¿Hay alguna memoria sensible que sea mejor no almacenar?

Solo recuerda las respuestas que mejorarán materialmente el trabajo futuro.

Skills relacionados