Tarefas e marcadores

As tarefas acompanham o trabalho; os marcadores, as perguntas em aberto.

O documento tasks é indexado linha a linha. Uma linha de tarefa tem uma caixa, um ID como T13, um indicador opcional [P] para tarefas que podem correr em paralelo, os requisitos que cobre entre parênteses, uma descrição e uma verificação Done when. A fase é o título ## acima da linha.

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

Escreva (FR: —) quando uma tarefa não cobre nenhum requisito. As linhas que parecem tarefas mas não seguem esta forma são indicadas à parte como mal formadas. O list_tasks devolve as tarefas analisadas com a reserva ativa de cada tarefa pendente, e pending_only oculta as concluídas.

Reservar e concluir

Um agente chama claim_task antes de começar, para que nenhum outro agente pegue na mesma tarefa. A reserva dura um prazo (dez minutos por omissão) que cada pedido do agente ao projeto prolonga, e termina com release_task, quando a tarefa é marcada como concluída ou quando o prazo expira. Uma tarefa na posse de outra pessoa é recusada com claimed, indicando quem a tem.

O mark_task_done assinala a tarefa e acrescenta · commit: com os 7 a 40 carateres hexadecimais em minúsculas do commit que a concluiu, como nova revisão.

Marcadores

As perguntas em aberto escrevem-se na própria linha como [NEEDS CLARIFICATION: …] ou [NEEDS RESEARCH: …].

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

O list_markers lista-os nos documentos de uma spec, e a aplicação mostra-os no separador Marcadores da spec, para que nenhum se perca. Uma spec não pode ser aprovada enquanto tiver marcadores abertos: a aprovação é recusada por MCP, pela API e na aplicação, com o número de marcadores a que é preciso responder primeiro.