Qué guardar para continuar un trabajo con agentes sin empezar de nuevo

Un trabajo largo con agentes rara vez termina en una sola sesión. La conversación se corta, cambias de día o entra otro agente. El historial tiene las pistas, pero reconstruir qué sigue vigente lleva tiempo y abre la puerta a errores: retomar una idea descartada, repetir una prueba o dar por hecho algo que nunca se comprobó.

Una nota breve de estado evita ese arranque en frío: dice qué se busca ahora, qué se decidió, qué está comprobado y qué sigue.

Un caso para seguir

Imagina que llevas dos días trabajando con un agente en la página de un producto. Empezó como un formulario de contacto. A mitad de camino decidiste que la página debía servir para reservar una demostración. Mañana otra sesión tiene que terminarla.

Esa sesión encontrará los dos pedidos en el historial. Sin una nota, tendrá que adivinar cuál vale.

Escribe primero el objetivo vigente

La nota empieza por lo que se busca hoy: «Que el visitante reserve una demostración desde la página del producto». Debajo van las condiciones que lo acompañan, como conservar la identidad visual y usar la disponibilidad que ya existe.

El historial explica el camino. La nota dice desde dónde seguir.

Guarda cada decisión con su motivo

«Usar un único formulario» ayuda poco si nadie sabe por qué. Supongamos que el motivo es que la persona pueda cambiar de servicio sin volver a escribir sus datos. Con ese motivo a la vista, la siguiente sesión puede juzgar si una propuesta nueva mejora el recorrido o lo vuelve a romper.

Para cada decisión importante bastan tres datos: qué se eligió, qué necesidad lo explica y qué cambio justificaría revisarla. Así no reabres lo mismo en cada sesión ni tratas una elección vieja como una regla eterna.

Si descartaste una alternativa por una razón que sigue en pie, anótala en una línea. No hace falta un acta.

Describe el estado con evidencia

«Listo» puede significar un diseño, código escrito o una prueba completa. Escribe el estado de forma que se sepa qué existe y qué se verificó:

«El formulario funciona en el entorno de pruebas. Se completó una reserva con datos ficticios y la confirmación muestra la fecha elegida. Falta probarlo en el sitio público.»

Con eso, quien retoma no confunde algo que funciona en pruebas con algo disponible para los usuarios. Enlaza junto al estado las capturas, registros o archivos que lo respaldan.

Deja pendientes que se puedan ejecutar

Un pendiente útil tiene una acción y una forma de saber que terminó. «Revisar reservas» es demasiado amplio. «Cambiar la hora elegida y comprobar que la confirmación muestre la nueva» se puede hacer y cerrar.

Si falta una decisión humana, guarda la pregunta y las opciones que se plantearon. Una opción sugerida no es una respuesta aceptada. Mientras tanto, el agente puede avanzar en lo que no depende de ella.

Si hay más de un agente trabajando, anota quién tiene cada parte. Así nadie toca archivos o decisiones que tienen otro responsable.

Conserva el alcance del encargo

La nota también lleva los permisos y sus límites. Preparar la página para revisión no es lo mismo que publicarla, y cambiar de sesión no debería borrar esa diferencia.

Escribe qué acciones están autorizadas y qué límites siguen vigentes. Lo que ya está dentro del encargo puede continuar. Una decisión nueva con consecuencias importantes se consulta, con el contexto necesario para responderla.

Enlaza el material extenso

Imagina también que existe una grabación de la demostración con comentarios sobre la página. No hace falta que cada sesión la lea entera. La nota guarda dónde está y en qué minuto se apoya cada decisión.

La transcripción ayuda a encontrar ese momento, pero no siempre alcanza. Una frase como «mira lo que pasa aquí» solo se entiende con las imágenes de antes y de después. La referencia tiene que llevar a esa evidencia, para que nadie dependa de una interpretación.

Tampoco copies la misma regla en varios lugares. Cada decisión necesita una sola fuente vigente; los informes pueden guardar la historia y enlazarla.

Una nota que cabe en una pantalla

Para la página de demostraciones, la nota podría quedar así:

• Objetivo: reservar una demostración desde la página del producto.
• Decisión: un único formulario, para cambiar de servicio sin repetir datos.
• Estado: reserva completa en pruebas con datos ficticios; falta el sitio público.
• Pendiente: cambiar la hora y comprobar que la confirmación muestre la nueva.
• Alcance: preparar para revisión; publicar requiere aprobación.
• Evidencia: captura de la confirmación y minuto de la grabación con los comentarios.

Al cerrar cada tramo, actualízala con lo que de verdad cambió. Si una decisión se reemplazó, deja la nueva y su motivo.

Comprueba que la nota funciona

Abre una sesión nueva, dale solo la nota y pregúntale cuál es el siguiente paso. Si lo identifica, respeta las decisiones y encuentra los archivos, la nota cumple. Lo que no pueda reconstruir te dice qué falta escribir.

Anthropic describe una práctica parecida para agentes que trabajan a lo largo de muchas sesiones: cada sesión empieza leyendo el historial de cambios y un archivo de progreso. Está en Effective harnesses for long-running agents. El caso y la nota de este artículo son una propuesta propia.