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.

tasks.md
## Phase 2: Refunds - [ ] T13 [P] (FR-18) Migrate the refunds table — Done when: the migration test passes on a copy of production - [x] T12 (FR-17, FR-19) Add the refund endpoint — Done when: the endpoint test passes · commit: 4f2a9c1

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: …].

spec.md
[NEEDS CLARIFICATION: should refunds above 500 EUR need a second approval?]

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.