Para mis agentes, recordar es una rutina a la hora de escribir

Lo que te llevas de aquí: Verás cómo cuatro capas de memoria transforman un contexto de sesión volátil en una memoria seleccionada, y por qué los vacíos visibles son mejores que una continuidad inventada.

Un agente no recuerda algo simplemente porque un producto ofrezca una función de memoria. Recuerda aquello que se almacena de forma fiable, se encuentra al siguiente inicio y se clasifica correctamente.

Por eso, en mi «Agents Brain», la memoria es una rutina de escritura. Consta de cuatro capas: Memoria de trabajo, Registros diarios, conocimientos a largo plazo seleccionados y organizados y Lecciones.

Cada nivel tiene un tiempo de semidesintegración diferente. Quien lo mezcle todo en un mismo saco se encontrará o bien con una sesión informativa inicial sobrecargada, o bien con una «caja negra» cuya selección ya nadie puede entender.

Capa A: Memoria de trabajo

La memoria de trabajo es el contexto de la sesión en curso. En ella se encuentran la tarea actual, los resultados provisionales, los datos generados por las herramientas y la conversación que se está manteniendo en ese momento.

Esta capa es útil y efímera. A simple vista, no se convierte automáticamente en una verdad a largo plazo.

El historial completo de una sesión incluye repeticiones, callejones sin salida y, posiblemente, información que no debe almacenarse de forma permanente. Verterlo sin filtrar en el «Brain» equivaldría a un simple almacenamiento de datos, en lugar de un cuidado consciente de la memoria.

Por eso, al final de la sesión hay que decidir: ¿qué parte de todo esto es relevante para mañana?

Turno B: Registros diarios

El registro diario recoge el suceso. Por cada agente y cada día hay un archivo en el que se anotan las decisiones importantes, las acciones realizadas, las conclusiones y los asuntos pendientes.

La entrada está más relacionada con el trabajo que la memoria a largo plazo. Puede ser lo suficientemente cronológica y sucinta como para poder comprender más adelante lo que ha sucedido. Sin embargo, no es una copia de un chat.

Una buena entrada en el diario responde a:

• ¿Cuál era la tarea?
• ¿Qué se hizo realmente?
• ¿Qué decisión se tomó?
• ¿Qué quedó pendiente?
• ¿Qué aportación ha realizado otro agente o herramienta?

De este modo se crea un nivel de episodios sólido. Si una afirmación posterior ya no encaja con el recuerdo, puedo volver a la prueba del día.

En este sentido, distingo entre observación e interpretación. Lo que un agente ha visto directamente o lo que se le ha dicho expresamente puede quedar como un dato. Una conclusión obtiene su fundamento concreto directamente a partir de ello. Una regla generalizada requiere al menos dos sucesos independientes y un nivel de confianza especificado. De este modo, una interpretación plausible no se convierte tácitamente en un recuerdo.

Capa C: Conocimiento a largo plazo seleccionado

El archivo MEMORY es la esencia condensada. Está organizado por temas, en lugar de por orden cronológico, y debe ser lo suficientemente conciso como para que se pueda leer en su totalidad cada vez que se abre.

Allí no hay veinte variantes inconexas de la misma decisión. Se mantiene la norma vigente en la actualidad, pero no debe desaparecer el proceso que ha llevado a ella. Si un nuevo hallazgo contradice el historial anterior, el «Daily Log» registra el conflicto junto con la documentación y su resolución. A continuación, la norma actualizada muestra de forma visible hasta cuándo era válida la versión anterior, desde cuándo rige la nueva y por qué se modificó.

Esta corrección forma un todo: el comprobante diario y la regla a largo plazo actualizada se tratan como un único registro de cambios revisable. Además, se conserva el historial de Git, aunque este no sustituye a la explicación legible que figura en la memoria.

La curación de contenidos tiene varios significados a la vez:

• Combinar repeticiones,
• actualizar de forma comprensible los datos contradictorios u obsoletos,
• actualizar los proyectos en curso,
• mantener patrones de trabajo estables,
• omitir deliberadamente los detalles delicados o innecesarios.

Eso es trabajo editorial. Un resumen automático puede ser de ayuda, pero no debe sobrescribir el archivo canónico sin que se note.

La indicación de la fecha también tiene dos funciones. Una entrada revisada indica cuándo tuvo lugar realmente el suceso o la afirmación en cuestión. Git documenta, por separado, cuándo se incorporó la modificación al repositorio. Una confirmación posterior no debe «rejuvenecer» artificialmente un suceso anterior.

Los registros diarios no se eliminan con este mantenimiento. Si se actualiza un archivo independiente de memoria o de lección, se le asigna en su lugar un estado de sustitución visible que incluye la fecha, el motivo y el sucesor disponible. La memoria a largo plazo activa no se sustituye de forma silenciosa; las afirmaciones individuales se siguen desarrollando en ella según el procedimiento descrito.

Nivel D: Lecciones

Las «Lessons» recogen patrones de corrección. No se centra la atención en el error concreto, sino en la regla que se deriva de él para el futuro.

Un ejemplo real del trabajo de Sol: un titular en alemán sonaba como una traducción literal de un modelo en inglés. La corrección no se limitó al artículo. A raíz de ello se elaboró una lección que incluía una prueba telefónica y una simulación con una redactora. Desde entonces, un titular debe sonar tal y como Saskia se lo diría realmente a una compañera.

Otra lección surgió de la propia serie «agents-brain»: la eliminación de OpenClaw se narra de forma activa, porque fue una decisión consciente que tomé para mejorar mi productividad. El lenguaje pasivo, que transmite impotencia o pérdida, distorsiona el proceso.

Las lecciones permiten reutilizar los comentarios. La siguiente sesión no empieza desde cero, siempre que se cargue la lección correspondiente.

Leer forma parte de la rutina tanto como escribir

Memory solo funciona si el agente carga las capas correctas en el momento adecuado.

Por lo tanto, el inicio de la sesión sigue un orden fijo:

1. Leer una breve descripción,
2. descargar el reglamento laboral completo,
3. Comprobar las competencias y los controles de aprobación,
4. Leer «Conocimientos a largo plazo»,
5. analizar el contexto diario actual y el más reciente,
6. Descargar las lecciones pertinentes y las normas comunes.

Al final, el proceso va en la dirección contraria: completar el diario, extraer lecciones de las correcciones y conservar los conocimientos significativos en la memoria a largo plazo.

Por lo tanto, la memoria no es un único lugar de almacenamiento, sino un proceso de transferencia entre distintos horizontes temporales.

La brecha forma parte del sistema

Se sabe que en el antiguo Nox-Workspace hubo una semana sin documentar: la semana 12 de marzo de 2026. Esta laguna no se puede subsanar de forma fiable a posteriori.

Podría reconstruir lo que probablemente ocurrió a partir de los registros adyacentes. Entonces tendría una historia coherente, pero una memoria poco fiable.

En cambio, el hueco sigue marcado.

Esta es una característica importante del sistema: Lo desconocido debe seguir siendo visible como tal. Un agente no debe crear un recuerdo a partir de patrones plausibles y, a continuación, tratarlo como si fuera una prueba.

Los archivos solo conservan lo que alguien registra. Su utilidad radica en establecer límites claros.

La privacidad empieza antes de escribir

Un registro diario no debe convertirse en un almacén secreto oculto. Por eso se aplica un filtro antes incluso de guardarlo.

Los datos de acceso nunca deben figurar en archivos de memoria. La información confidencial de los clientes permanece en el contexto del proyecto correspondiente. Para el «cerebro» central solo se extraen los datos seguros y necesarios.

En el repositorio, un «Privacy-Gate» automático comprueba además los contenidos rastreados y etiquetados en busca de patrones típicos de información secreta y de reflejos no permitidos de datos confidenciales de los agentes. Esto no sustituye a la responsabilidad editorial, pero detecta los errores antes de que pasen a formar parte del historial.

Mantenimiento de la memoria en lugar de crecimiento de la memoria

La memoria no mejora por el simple hecho de aumentar su capacidad. Si en cada sesión se añaden nuevos párrafos al archivo de memoria a largo plazo, llegará un momento en que ya no se podrá cargar por completo, y las reglas importantes se perderán entre tanto volumen.

Por eso, el sistema necesita un mantenimiento periódico de la memoria:

• Revisar los registros diarios,
• extraer conclusiones sólidas,
• Comprobar las contradicciones y su resolución,
• Separar claramente la fecha del suceso y la fecha de registro,
• sustituir de forma clara los archivos independientes obsoletos,
• fusionar reglas duplicadas,
• Mover los hilos sueltos al sistema de trabajo adecuado.

El criterio no es „¿Cuánto hemos almacenado?“, sino „¿Encontrará el agente la regla correcta y actualizada la próxima vez que se inicie?“.“

El momento en que debe realizarse este mantenimiento depende del estado del Vault: a más tardar 14 días naturales después de la última ejecución de mantenimiento o tras la aparición de diez nuevos archivos diarios, un verificador común indica que la curación está pendiente. Este aviso hace que la ejecución pase a mi puerta de revisión existente.

Una vez aprobada una curación, se puede reconstruir el índice semántico en el equipo en el que se ejecuta OpenViking. Este índice sigue siendo un derivado desechable. Los archivos Markdown siguen funcionando perfectamente incluso sin él.

Mi conclusión práctica

Un motor de memoria puede realizar búsquedas semánticas, generar resúmenes y clasificar previamente el contexto. Esto resulta útil. No obstante, la responsabilidad de la memoria canónica sigue recayendo en una rutina de escritura visible.

Para mí, esta rutina consiste en un movimiento sencillo:

Disfrutar de la sesión, redactar el informe diario, recopilar conocimientos a largo plazo y conservar las correcciones como lecciones.

Así es como el contexto se vuelve fácil de mantener. Y así también queda claro lo que el sistema no sabe.

En la siguiente parte, la perspectiva pasa de la memoria a la herramienta: cómo la misma identidad de agente llega a diferentes „harnesses“ (también conocidos como «cuerpos») a través de adaptadores ligeros, sin que se pierdan por el camino sus «approval-gates».

Fuentes

• Fuente del proyecto: Especificaciones de agents-brain, convención de mantenimiento de la memoria y registros diarios de Nox/Sol, a fecha de 29 de julio de 2026 (fuentes primarias privadas)
• CommonMark: especificación abierta de Markdown

Serie Agents Brain

← Parte 3: Para mí, un agente consta de cuatro archivos
Parte 5: El mismo agente, cuatro herramientas diferentes →