Attività e marcatori

Le attività tengono traccia del lavoro; i marcatori delle domande aperte.

Il documento tasks viene indicizzato riga per riga. Una riga di attività ha una casella, un ID come T13, un indicatore facoltativo [P] per le attività eseguibili in parallelo, i requisiti coperti tra parentesi, una descrizione e un controllo Done when. La fase è l’intestazione ## sopra la riga.

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

Scrivi (FR: —) quando un’attività non copre alcun requisito. Le righe che sembrano attività ma non seguono questa forma vengono segnalate a parte come malformate. list_tasks restituisce le attività analizzate con la prenotazione attiva di ciascuna attività in sospeso, e pending_only nasconde quelle completate.

Prenotare e completare

Un agente chiama claim_task prima di iniziare, così nessun altro agente prende la stessa attività. La prenotazione dura un intervallo (dieci minuti per impostazione predefinita) che ogni richiesta dell’agente al progetto prolunga, e termina con release_task, quando l’attività viene segnata come completata o quando l’intervallo scade. Un’attività tenuta da qualcun altro viene rifiutata con claimed, indicando chi la detiene.

mark_task_done spunta l’attività e aggiunge · commit: con i 7–40 caratteri esadecimali minuscoli del commit che l’ha completata, come nuova revisione.

Marcatori

Le domande aperte si scrivono in linea come [NEEDS CLARIFICATION: …] o [NEEDS RESEARCH: …].

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

list_markers li elenca nei documenti di una spec, e l’app li mostra nella scheda Marcatori della spec, così nessuno viene dimenticato. Una spec non può essere approvata finché ha marcatori aperti: l’approvazione viene rifiutata via MCP, API e app allo stesso modo, con il numero di marcatori a cui rispondere prima.