La memoria de pez

El artesano que olvida todo cada mañana

Imagina un albañil que cada mañana se despierta sin recordar nada de ayer. Llega a la obra y se pregunta: ¿qué pared estaba a medias? ¿Por qué elegimos ladrillo rojo y no azul? ¿Dónde acaban las tuberías? Peor aún: puede arrancar una ventana recién instalada solo porque no sabe que ya estaba hecha.

Un agente que trabaja en una tarea larga vive justo así. Le pides una función grande, trabaja 30 minutos, el contexto se llena y abres una sesión nueva. La nueva sesión no sabe qué se decidió, qué archivos se tocaron ni qué pruebas fallan. Gasta un cuarto de hora redescubriéndolo y puede contradecir lo anterior.

Por qué una ventana más grande no lo arregla

Las ventanas de contexto son finitas y las tareas complejas siempre acaban llenándolas: el agente lee código, anota decisiones y recibe salidas de herramientas, y todo eso crece más rápido que la ventana. Hay además un problema más sutil. Lo que se pierde al resumir no es el código (el «qué»), sino las razones (el «por qué»). La sesión siguiente ve el código pero no sabe por qué está así, y puede «mejorar» una decisión que era deliberada.

Hay también un efecto curioso que describe Anthropic, la ansiedad de contexto: cuando el agente nota que se le acaba el espacio, tiende a acabar deprisa, saltarse comprobaciones o elegir la solución fácil. Es como el examen en el que quedan cinco minutos y rellenas a ojo las preguntas tipo test.

Compactar o reiniciar

Hay dos maneras de seguir cuando el contexto se acaba:

Según la lección, en algunos modelos la ansiedad de contexto es tan marcada que compactar no basta y el reinicio pasa a ser pieza del diseño; en otros se nota mucho menos. Moraleja: el harness se diseña pensando en el modelo concreto que usas, no con una plantilla universal.

La solución: dejar el estado escrito

Trata al agente como un ingeniero brillante con amnesia. Antes de «acabar el turno» debe escribir lo necesario para que el siguiente pueda seguir. Cuatro piezas bastan:

1. Un archivo de progreso (qué está hecho, qué está en curso, qué sigue).
2. Un registro de decisiones (qué se decidió y por qué).
3. Commits de git como puntos de control del estado exacto del repo.
4. Rutinas de entrada y salida escritas en AGENTS.md.

Ejemplo mínimo de esas rutinas:

## Al empezar la sesión
1. Lee PROGRESS.md y DECISIONS.md
2. Ejecuta la comprobación del repo para confirmar que está sano
3. Continúa por «Siguientes pasos»

## Antes de terminar
1. Actualiza PROGRESS.md
2. Ejecuta la comprobación otra vez
3. Haz commit de lo completado

La medida que importa es el coste de reconstrucción: cuánto tarda una sesión nueva en volver a estar operativa. Con buenos archivos son minutos; sin ellos, es adivinar.

No todo necesita un reinicio

Las tareas cortas caben en una sola sesión y no necesitan papeleo. Las que cruzan sesiones sí. Una regla práctica de la lección: si la tarea va a ocupar más del 60 % de la ventana, empieza ya a preparar el traspaso.

Siguiente paso: cómo es exactamente ese archivo de progreso, en el diario progress.md.