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