Grafo de Habilidades Recorrible para Memoria Persistente de Agentes de IA en Bases de Código

Una Solución Práctica para Asistentes de IA sin Estado

Los asistentes de programación con IA carecen de memoria persistente entre sesiones, obligando a los desarrolladores a comenzar desde cero cada vez. El enfoque común de volcar todo en archivos de reglas grandes como .cursorrules falla debido a los límites de tokens y la dilución de las instrucciones.

La solución presentada es la divulgación progresiva a través de un gráfico de habilidades transitable que reside dentro de la base de código. La IA navega este gráfico de forma autónoma a través de las sesiones.

Arquitectura de Tres Capas

El sistema tiene tres capas distintas:

• Capa 1 (Siempre Cargada): Menos de 150 líneas (300 tokens). Contiene identidad de pila, convenciones de carpetas y elementos no negociables. Incluye un puntero saliente a HANDOVER.md.
• Capa 2 (Cargada por Sesión): HANDOVER.md sirve como un enrutador de atención, no como un documento. Le dice a la IA qué archivo de dominio cargar según la tarea actual (pagos, autenticación, base de datos, rutas-api). Cada archivo de dominio termina con instrucciones que apuntan al siguiente archivo relevante, creando un sistema autodirigido.
• Capa 3 (Cargada por Tarea): Biblioteca de prompts con 12 categorías. Cada entrada incluye secciones de contexto, construcción, verificación y depuración. La IA consulta el índice, carga la categoría y sigue el patrón.

Perspectiva Central: Instrucciones Autodirigidas

La innovación clave es que las instrucciones llevan significado, no solo referencias. Por ejemplo: "cargar security/threat-modeling.md antes de modificar manejadores de webhooks" le dice a la IA cuándo y por qué, no solo qué.

El desarrollador ha integrado esto en una plantilla SaaS que se entrega con la base de código, disponible en launchx.page para aquellos que deseen examinar la estructura completa del gráfico.