Tareas y marcadores
Las tareas llevan el trabajo; los marcadores, las preguntas abiertas.
El documento tasks se indexa línea a línea. Una línea de tarea tiene una casilla, un ID como T13, una marca opcional [P] para tareas que pueden ir en paralelo, los requisitos que cubre entre paréntesis, una descripción y una comprobación Done when. La fase es el encabezado ## que está encima de la línea.
Escribe (FR: —) cuando una tarea no cubre ningún requisito. Las líneas que parecen tareas pero no siguen esta forma se indican aparte como mal formadas. list_tasks devuelve las tareas analizadas con la reserva activa de cada tarea pendiente, y pending_only oculta las terminadas.
Reservar y terminar
Un agente llama a claim_task antes de empezar, para que ningún otro agente tome la misma tarea. La reserva dura un plazo (diez minutos por defecto) que se amplía con cada petición del agente al proyecto, y termina con release_task, cuando la tarea se marca como hecha o cuando el plazo vence. Una tarea en manos de otra persona se rechaza con claimed, indicando quién la tiene.
mark_task_done marca la tarea y añade · commit: con los 7 a 40 caracteres hexadecimales en minúscula del commit que la completó, como una revisión nueva.
Marcadores
Las preguntas abiertas se escriben en línea como [NEEDS CLARIFICATION: …] o [NEEDS RESEARCH: …].
list_markers los lista en los documentos de una spec, y la aplicación los muestra en la pestaña Marcadores de la spec, para que no se olvide ninguno. Una spec no puede aprobarse mientras tenga marcadores abiertos: la aprobación se rechaza por MCP, por la API y en la aplicación, con el número de marcadores que hay que responder antes.