Tâches et marqueurs
Les tâches suivent le travail ; les marqueurs suivent les questions ouvertes.
Le document tasks est indexé ligne par ligne. Une ligne de tâche comporte une case, un identifiant comme T13, un indicateur facultatif [P] pour les tâches pouvant s’exécuter en parallèle, les exigences couvertes entre parenthèses, une description et un contrôle Done when. La phase est le titre ## au-dessus de la ligne.
Écrivez (FR: —) quand une tâche ne couvre aucune exigence. Les lignes qui ressemblent à des tâches sans respecter cette forme sont signalées à part comme mal formées. list_tasks renvoie les tâches analysées avec la réservation active de chaque tâche en attente, et pending_only masque les terminées.
Réserver et terminer
Un agent appelle claim_task avant de commencer, pour qu’aucun autre agent ne prenne la même tâche. La réservation dure un délai (dix minutes par défaut) que chaque requête de l’agent vers le projet prolonge, et elle prend fin avec release_task, quand la tâche est marquée terminée ou quand le délai expire. Une tâche détenue par quelqu’un d’autre est refusée avec claimed, en nommant le détenteur.
mark_task_done coche la tâche et ajoute · commit: avec les 7 à 40 caractères hexadécimaux en minuscules du commit qui l’a terminée, comme une nouvelle révision.
Marqueurs
Les questions ouvertes s’écrivent en ligne sous la forme [NEEDS CLARIFICATION: …] ou [NEEDS RESEARCH: …].
list_markers les liste dans les documents d’une spec, et l’application les affiche dans l’onglet Marqueurs de la spec, pour qu’aucun ne soit oublié. Une spec ne peut pas être approuvée tant qu’elle a des marqueurs ouverts : l’approbation est refusée par MCP, par l’API et dans l’application, avec le nombre de marqueurs à traiter d’abord.