Libro Mayor del Proyecto: Sistema de Memoria con Intervención Humana para Agentes de Codificación de IA

Un proyecto de GitHub llamado project-ledger proporciona un sistema con intervención humana para gestionar lo que los agentes de IA de codificación recuerdan sobre tu base de código. El problema central que aborda: los agentes no pueden juzgar lo que importa—tratan los errores de implementación igual que los fallos arquitectónicos y registran lo que cambiaron en lugar de lo que es importante.

Cómo Funciona

El sistema tiene tres componentes principales:

• Un registro YAML con entradas estructuradas que contienen resúmenes, niveles de confianza, etiquetas y referencias cruzadas
• Una habilidad /ledger que publica entradas y genera automáticamente un auditor Haiku para revisarlas en frío
• Un enlace UserPromptSubmit que ejecuta una búsqueda TF-IDF en cada solicitud e inyecta automáticamente las entradas coincidentes antes de que el agente comience a pensar

El enlace es crítico—sin él, solo estás escribiendo YAML en el vacío. Como se señala en la fuente: "Los agentes nunca leen documentos de referencia sin que se les pida—el enlace se ejecuta en cada solicitud, busca en el registro e inyecta entradas relevantes antes de que el agente comience a pensar."

Ejemplo Práctico

El creador describe un caso de uso real: semanas después de corregir un problema de representación de color en un proyecto integrado, le preguntaron a un agente "¿recuerdas lo que hicimos cuando arreglamos esto antes?" El enlace mostró la entrada exacta sobre la cuantización de 8 bits que afectaba la fidelidad del color en valores bajos, incluyendo la causa raíz, umbrales y componentes afectados.

Comparación y Enfoque

En comparación con OpenViking, este sistema requiere trabajo manual pero tiene una arquitectura más simple: solo un archivo YAML más un enlace de shell sin backend. La filosofía es que para proyectos donde las ideas se ganan con esfuerzo, los humanos deben decidir qué se lleva adelante.

El sistema está diseñado para prevenir la acumulación de deuda técnica mientras los agentes de IA operan en bases de código—cada cambio se vuelve más difícil de realizar correctamente sin el contexto adecuado sobre lo que importa.