Los agentes de código necesitan memoria durable, no solo contexto

Luis Torres Posted on May 30 • Originally published at github.com Los agentes de código necesitan memoria durable, no solo contexto # ai # architecture # opensource # software Este texto nace de una práctica concreta usando agentes de código en repos reales. El problema no fue que faltara contexto, sino que algunas decisiones importantes quedaban en lugares donde el repositorio no podía recordarlas. Cuando trabajamos con agentes de código, es normal pensar primero en contexto: archivos relevantes, instrucciones del proyecto, historial de la conversación, errores recientes, logs, planes y pruebas. Todo eso ayuda al agente a resolver la tarea actual. Pero hay un problema distinto que aparece rápido en repos reales: algunas decisiones técnicas no deberían vivir solo en el chat. Si una decisión cambia una frontera de servicio, define qué sistema es fuente de verdad, fija un contrato de API, decide un runtime productivo o establece una política técnica como "no usar fallbacks silenciosos", esa decisión afecta el trabajo futuro. No basta con que el agente actual la entienda. El repositorio también debe recordarla. Ahí entra la idea de memoria durable del repo. El problema Un agente puede recordar contexto durante una sesión. Incluso puede tener memoria privada entre sesiones, dependiendo de la herramienta. Pero esa memoria no siempre es: visible para el equipo; revisable en pull requests; versionada junto al código; portable entre herramientas; explícita sobre qué decisiones están aceptadas y cuáles siguen en evaluación. Eso importa porque muchas decisiones técnicas condicionan cambios futuros. Por ejemplo: "Este servicio es la fuente de verdad del workflow". "Esta API es la única frontera válida para herramientas de agentes". "Si falta configuración obligatoria, el sistema debe fallar claro". "El entorno local debe activarse con un perfil explícito". "Esta integración es candidata, pero todavía no está aceptada". Si esas reglas quedan solo en una conversación, el pr