Los agentes no necesitan memoria, necesitan documentación
Agents don't need memory, they need documentation

Los plugins de memoria para agentes de IA basados en RAG fallan porque recuperan fragmentos por similitud, sin contexto ni verificabilidad. El autor propone un cambio de paradigma: en lugar de almacenar recuerdos en bases vectoriales, los agentes deben consultar y actualizar un cerebro de documentación en Markdown. Así, el bucle prompt → construir → olvidar se transforma en prompt → consultar → construir → actualizar. Presenta Operator Memory, una solución de código abierto que implementa este enfoque.
Los agentes no necesitan memoria. Necesitan documentación.
- Garlef
Creo que aún más necesitan retroalimentación determinista:
Probé un enfoque basado en la siguiente idea hace poco y es increíble: reglas de Lint donde los mensajes de error contienen una explicación sobre cómo lidiar con el problema.
Por ejemplo, lo estoy usando para fomentar el IOSP (principio de segregación de operaciones de integración).
- spike021
Creo que, sin importar cuál se use, tiene que haber una forma de hacer cumplir lo que está escrito.
Si digo "usa jq en lugar de escribir un script de python para parsear json", nunca debería escribir scripts de python ad hoc para parsear json. Sin embargo, eso me sigue pasando constantemente.
- gregwebs
De acuerdo, y esto parece mejor.
Sin embargo, mi pensamiento siempre ha sido que no quiero que exista documentación designada solo para agentes.
Uso mattpocock/skills y eso genera ADRs (Registros de Decisiones de Arquitectura). Eso solo usa skills, incluyendo un skill de configuración que escribirá algunos punteros en AGENTS.md. Siempre tengo un CONTRIBUTING.md para documentar el flujo de desarrollo y un CODING_STANDARDS.md. Entre esos y el README.md, la documentación de arquitectura y los mensajes de commit, los agentes parecen poder encontrar y usar los docs y mantenerlos actualizados. También estamos escribiendo muchas especificaciones y poniéndolas en issues de Github.
- atworkc
Me he decantado por una simple carpeta llamada `workbench`; por alguna razón los nuevos modelos saben exactamente qué pasa con ella. Ignorada por Git.
El único "prompt" está en AGENTS.md diciendo que esta cosa existe y que hay un map.md <- que es una referencia de una línea a lo que sea que el agente guarde ahí.
Y normalmente, abordo una nueva funcionalidad y en algún momento le digo que guarde notas en workbench si me siento cómodo con ello (y si necesita guardarse en memoria).
Esto hace fácil simplemente generar otros agentes y demás desde un buen punto, solo les indico que las cosas están en workbench.
El costo en tokens parece decente y siempre puedo simplemente borrar cosas de ahí, ya que su propósito es efímero.
- b-karl
Usamos Claude Code en nuestra empresa y también estoy de acuerdo en que las memorias se vuelven obsoletas y contaminan el contexto con el tiempo, especialmente cuando el estado cambia externamente. Por ejemplo, alguien hace un refactor o introduce un patrón y yo no participé en su desarrollo, así que mis memorias locales no se alinearon.
Mi ejemplo más reciente fueron algunos repos deprecados y archivados que seguían agregándose a los planes para parchar problemas.
Usamos un marketplace privado de plugins de Claude para plugins y skills internos, e intento podar mi memoria regularmente, migrando lo relevante a un lugar apropiado (skills en el marketplace, docs en repos o Notion, etc.) y podando la información desactualizada.
- isaachinman
Escribí esto, después de muchas iteraciones consultando para varias empresas. La documentación es consultable en milisegundos de un solo dígito, log de solo anexado, etc. Ha funcionado excepcionalmente bien para mis proyectos.
- bushido
Algo que empecé a hacer recientemente fue escribir principios en lugar de memorias.
Esencialmente, patrones en los que los agentes deben pensar siempre. También implementé un sistema de versionado para los principios que deben citarse en cualquier comentario que esté en el código. De esa forma, cuando mis principios evolucionan, también lo hace el código.
Lo empaqueté de una forma que puedo compartirlo con amigos [0]. El sistema sigue evolucionando, pero los últimos dos meses aproximadamente que lo he usado me ha servido realmente, realmente bien. Y ha sido aún mejor con los últimos modelos.
He tenido una adherencia sorprendentemente buena por parte de los agentes con esta técnica.
- alienbaby
Diré que, habiendo construido algo similar para rastrear 'memoria' y objetos en casa, puede consumir tus tokens rápidamente al lidiar tanto con la lectura como con la actualización, manteniendo relevante la información obsoleta, etc., cuando la cantidad de datos empieza a crecer. Las tareas más pequeñas pueden inflarse en su costo de tokens a medida que los documentos se leen, actualizan, cotejan, refrescan, etc.
Sin embargo, he descubierto que mantener una buena y sólida referencia de mi infraestructura doméstica, servicios, configuración de ci/cd, hosts, almacenamiento, redes, etc., realmente hace maravillas como un conjunto de 'memorias' para compartir entre proyectos que espero que se prueben / desplieguen / prueben de aceptación, etc., usando las piezas de la infraestructura doméstica.