Qué necesita un agente de IA para retomar un proyecto entre sesiones

MarQ · 2026-11-08

Cada sesión nueva de un agente de IA empieza sin memoria. Para retomar bien un proyecto necesita estado estructurado que pueda leer en pocas llamadas: qué hay, en qué punto está cada tarea, qué cambió desde la última vez, qué decisiones se tomaron y qué tiene reservado todavía. Un resumen escrito en un chat es justo lo contrario: se queda viejo, omite lo que el autor no creyó importante y obliga al agente a fiarse de él sin poder comprobarlo.

El problema de los resúmenes

Cuando una sesión termina, es tentador pedir "resúmelo para la próxima vez" y pegar el texto al empezar la siguiente. Funciona al principio y falla por tres razones:

  • Es una foto vieja. Si entre sesiones cambió algo (otra persona, otro agente), el resumen miente sin saberlo.
  • Pierde lo que no cupo. Un resumen decide qué importa en el momento de escribirlo. La decisión que se tomó hace tres sesiones, o el riesgo que alguien anotó, suele quedar fuera.
  • No se puede verificar. El agente tiene que creer el texto. Con estado estructurado, puede preguntar al sistema.

La alternativa es que la fuente de verdad no sea el chat sino el tablero, y que el agente lo consulte al empezar.

Orientarse sin gastar contexto

Leer todo el proyecto al empezar es caro: llena la ventana de contexto con tareas que no importan hoy. MarQ ofrece lecturas pensadas para ir de menos a más:

  1. pm_get_project_tree: un resumen compacto del proyecto. Metadatos, recuento de tareas por estado y por prioridad, resumen de requisitos, etiquetas y una primera página de tareas en formato compacto (sin notas ni historial). Con limit: 0 devuelve solo el resumen.
  2. pm_list_tasks: el detalle por filtros, con paginación. Se puede filtrar por estado, prioridad, persona asignada, etiquetas, requisitos o texto, y ordenar por prioridad o por última modificación.
  3. pm_get_task: el detalle de una sola tarea, para las que realmente están en juego.

El orden importa: primero el resumen, después los filtros, y el detalle solo de lo que se va a tocar. Es la regla que sigue la skill de MarQ cuando le pides marq status.

Qué cambió desde la última vez

La pregunta más útil al retomar no es "¿qué hay?" sino "¿qué ha cambiado desde que me fui?". pm_list_tasks admite updatedSince con una fecha ISO y sort: updated, así que el agente puede pedir solo las tareas modificadas desde su última sesión, las más recientes primero. Para saber por qué cambió algo, pm_get_task_timeline devuelve el historial de la tarea con el autor de cada cambio, el valor anterior y el nuevo, y cuánto tiempo pasó en cada estado.

Dónde dejar escrito lo que importa

Lo que no se escribe en el tablero se pierde al cerrar la sesión. Estas son las piezas donde conviene dejar rastro:

  • Notas por categoría en cada tarea: risk (riesgo), architecture (decisión de diseño), prerequisite (algo que debe estar antes) y future_idea o general. Se añaden con pm_add_future_note y se leen con pm_get_future_notes. Una decisión de arquitectura anotada hoy evita que otra sesión la reabra dentro de un mes.
  • Bloqueos con causa: pm_report_blocker marca la tarea como bloqueada y registra el motivo.
  • Cambios de estado con comentario: pm_update_task_status acepta un comentario. "Movida a revisión: falta probar el caso sin conexión" vale más que un cambio mudo.
  • Tiempo dedicado: pm_log_time_spent, para que las métricas reflejen el esfuerzo real.

Y una regla de higiene que la skill impone: MarQ debe reflejar la realidad, no las intenciones. Una tarea no pasa a hecha sin una evidencia (un commit, una prueba que pasa, una confirmación de la persona).

Retomar lo que dejaste a medias

Si trabajas con reservas entre agentes, una sesión interrumpida puede dejar tareas reservadas. Al empezar, pm_list_my_task_locks lista las reservas que el agente tiene abiertas. Puede renovarlas si va a seguir con ellas o liberarlas si no, en lugar de dejarlas caducar y bloquear a los demás durante el plazo.

Una secuencia de inicio

Un guion razonable para el primer minuto de una sesión:

  1. pm_get_project_tree para orientarse.
  2. pm_list_my_task_locks para ver qué quedó reservado.
  3. pm_list_tasks con updatedSince para ver qué cambió.
  4. pm_list_tasks con available: true para ver qué se puede reservar ahora (sin reserva activa, ni hecha ni bloqueada, con las dependencias cumplidas).
  5. pm_get_task y, si hace falta, pm_get_task_timeline solo de la tarea elegida.

No necesita pegar nada del chat anterior. Si quieres ver cómo luce este estado, abre la demo de solo lectura; para conectar tu agente, sigue la guía de instalación.

Blog