Skip to content
TCAFTask-Contract AI Development Framework
TCAF 0.4.0 · anteprima pubblica

Esegui un task di sviluppo

Esegui una modifica software delimitata dalla fonte del task fino alle evidenze e all’accettazione del developer.

Un task TCAF è una singola unità delimitata di lavoro ingegneristico. Se il risultato richiesto è più ampio di un task coerente, usa prima tcaf plan.

Avvia il task

tcaf task --target <progetto> --request "<modifica richiesta>"

Oppure usa una fonte di task esistente:

tcaf task --target <progetto> --input <fonte-task>

Sequenza richiesta

  1. Identifica la fonte autorevole del task.
  2. Ispeziona soltanto evidenze e implementazione pertinenti.
  3. Risolvi le ambiguità sostanziali prima dell’implementazione.
  4. Produci un Task Contract con obiettivo, superficie di modifica, aree da preservare, criteri di accettazione, controlli e condizioni di arresto.
  5. Ottieni review e approvazione del developer.
  6. L’AI può eseguire il lavoro approvato dentro quel confine, usando la più piccola modifica coerente e preservation-first.
  7. Esegui o riporta i controlli minimi pertinenti.
  8. Presenta diff, evidenze, limitazioni ed esito.
  9. Attendi l’accettazione del developer prima di aggiornamenti di stato o commit.

Il developer mantiene il controllo

Il developer può modificare direttamente il codice, sostituire un approccio, chiarire la richiesta, fermare l’AI o svolgere manualmente parte del lavoro. Queste modifiche diventano stato corrente del repository e devono essere rilette prima che l’AI continui.

Disciplina dello scope

Un task non autorizza refactoring opportunistici, cambi di dipendenza estranei, formattazione estesa, aggiornamenti silenziosi del backlog o operazioni Git.

Quando emerge nuovo lavoro, classificalo come chiarimento, correzione, amendment, task separato o blocker invece di assorbirlo silenziosamente.

Verifica

Solo le evidenze realmente eseguite supportano una dichiarazione verificata. Controlli pending o DEVELOPER_RUN devono restare visibili.

Se repository o stato del progetto cambiano successivamente fuori dall’esecuzione corrente, usa tcaf sync prima di affidarti a uno stato non aggiornato.