Estado y memoria

Cómo hacer que una tarea larga sobreviva al final de una sesión: guardar el progreso fuera del modelo, en archivos y en Git, y distinguir el estado de la tarea de la memoria a largo plazo.

Antes de empezar

  • Diseño del contexto para agentesTécnica

    Qué información recibe el agente en cada momento, por qué más no siempre es mejor y cómo darle lo justo: lo esencial desde el principio y el resto cuando lo necesite.

    Publicado

La idea clave: el modelo no recuerda nada entre sesiones. Si quieres continuidad, el harness tiene que guardar el progreso fuera del modelo —en archivos y en Git— para que cada sesión nueva pueda leerlo y seguir.

El problema

Imagina un proyecto que necesita varias horas de trabajo: implementar diez funcionalidades. Ninguna ventana de contexto aguanta todo eso. Tarde o temprano pasa una de estas cosas:

  • La sesión termina y la siguiente empieza de cero.
  • El contexto se compacta: el cliente resume los mensajes antiguos para hacer sitio, y en el resumen se pierden detalles.

Si el único registro del progreso es la conversación, la sesión nueva no sabe qué está hecho, qué falló ni qué se decidió. Puede rehacer trabajo, romper algo que funcionaba o dar por terminado un proyecto a medias.

Piensa en un equipo que trabaja por turnos: quien entra no recuerda lo que hizo el turno anterior, así que lee las notas de traspaso. El agente necesita lo mismo.

Cómo funciona

Conviene separar tres cosas que a menudo se mezclan:

Capa Qué guarda Cuánto dura
Conversación Los mensajes y las llamadas a herramientas de esta sesión Hasta que la sesión acaba o se compacta
Estado de la tarea En qué punto está el trabajo: progreso, pendientes, commits Lo que dure la tarea
Memoria Lo que conviene recordar: convenciones, preferencias Entre tareas

La idea práctica es que el estado de la tarea vive en archivos, no en la cabeza del modelo. Anthropic describe así un harness para agentes que trabajan durante muchas sesiones:

  1. Una lista de funcionalidades, todas marcadas al principio como pendientes.
  2. Un archivo de progreso donde cada sesión anota qué hizo y qué queda.
  3. Commits de Git frecuentes, que sirven de historial y permiten volver atrás.
  4. Cada sesión nueva empieza leyendo el progreso y el git log, elige una sola funcionalidad, la termina y la verifica antes de marcarla como hecha.

La compactación es otra pieza, pero no es memoria: es una forma de resumir la conversación para que siga cabiendo en la ventana. Ayuda a continuar una sesión larga, pero un resumen puede perder una restricción o un detalle. Lo que no te puedes permitir perder, escríbelo en un archivo.

Ejemplo práctico

Un archivo de progreso sencillo, PROGRESS.md, que el agente actualiza al final de cada sesión:

# Progreso

## Hecho

- [x] summarizeReading con pruebas (commit a1b2c3d)
- [x] countWords ignora espacios repetidos (commit d4e5f6a)

## Pendiente

- [ ] Exportar las funciones desde index.js
- [ ] Documentar la API en el README

## Notas para la siguiente sesión

- Las pruebas se ejecutan con `node --test`.
- Pregunta abierta: ¿firstSentence debe incluir el signo final? Sin decidir.

Y unas líneas en AGENTS.md para que el ciclo ocurra en cada sesión:

## Tareas largas

- Al empezar, lee PROGRESS.md y las últimas entradas de `git log`.
- Trabaja en una sola tarea pendiente cada vez.
- Al terminarla, verifícala, haz commit y actualiza PROGRESS.md.

Fíjate en la pregunta abierta: se anota como pregunta, no como decisión. Un resumen descuidado podría convertirla en un hecho.

Errores comunes

  • Confiar en que el agente “se acordará”. No lo hará. Lo que no está escrito en un archivo se pierde con la sesión.
  • Confundir compactación con memoria. El resumen sirve para continuar; no decide qué merece guardarse a largo plazo.
  • Guardarlo todo como memoria. Las notas obsoletas o equivocadas se cargan en cada sesión y confunden más de lo que ayudan. Guarda solo lo confirmado y revísalo de vez en cuando.
  • Guardar secretos. Un archivo de progreso o de memoria no es lugar para tokens, contraseñas ni datos personales.
  • Marcar como hecho sin verificar. El archivo de progreso solo sirve si dice la verdad. Verifica cada tarea antes de marcarla.

Cuándo usarlo

Cuando una tarea no cabe en una sola sesión, cuando vas a retomarla otro día o cuando varios agentes trabajan sobre el mismo proyecto. Para una tarea corta que empieza y termina en una conversación, no hace falta nada de esto.

Siguiente paso

Ya sabes qué pedir, qué información dar y cómo conservar el progreso. El siguiente bloque trata del contexto que se repite en todas las tareas: AGENTS.md, el archivo donde tu proyecto se presenta al agente.

Fuentes

Consultadas el 2026-10-05.

  • AGENTS.md: instrucciones persistentes para un proyectoTécnica

    Un archivo Markdown en la raíz del repositorio que explica al agente cómo funciona tu proyecto: comandos, convenciones y cómo comprobar los cambios. Es una guía, no un mecanismo de control.

    Publicado
  • Verificación y evaluaciónTécnica

    Cómo comprobar que el agente hizo bien el trabajo sin fiarte de su palabra: darle formas de verificarse a sí mismo, revisar el resultado y el proceso, y comparar configuraciones con honestidad.

    Publicado