Skip to content
TCAFTask-Contract AI Development Framework
TCAF 0.3.3

Esegui un task di sviluppo

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

Contenuto: completeWorkflow: verified

Un task di sviluppo TCAF è un’unità delimitata di lavoro ingegneristico. Parte da una fonte selezionata dal developer e termina con evidenze, limitazioni e una decisione esplicita di accettazione.

Avvia il task

Usa una richiesta inline:

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

Oppure passa un file, directory, archivio o risorsa host supportata:

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

Il comando produce una Run Envelope. L’agente host la usa per ispezionare il target e preparare il task.

Sequenza richiesta

  1. Identificare la fonte autorevole del task.
  2. Ispezionare soltanto evidenze e implementazione pertinenti.
  3. Risolvere le ambiguità sostanziali prima dell’implementazione.
  4. Produrre un Task Contract con obiettivo, superficie di modifica, aree da preservare, criteri di accettazione, controlli e condizioni di arresto.
  5. Ottenere review e approvazione del developer.
  6. Implementare il cambiamento coerente minimo usando pattern locali e comportamento già funzionante.
  7. Eseguire o riportare i controlli minimi pertinenti.
  8. Presentare diff, evidenze, limitazioni ed etichetta dell’esito.
  9. Attendere l’accettazione del developer prima di riconciliare stato o creare commit.

Autorità del developer durante il task

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

Disciplina del perimetro

Il task non autorizza:

  • refactoring opportunistici;
  • aggiornamenti di dipendenze non richiesti dalla modifica approvata;
  • formattazione non pertinente;
  • introduzioni estese di test o infrastruttura;
  • modifiche silenziose a backlog, documentazione, storia Git o sistemi remoti.

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

Verifica ed esito

Un task normale dovrebbe usare i controlli minimi che supportano concretamente l’accettazione, spesso da uno a tre comandi mirati o procedure manuali.

Il report finale deve distinguere PASS, READY FOR CHECK, PARTIAL, BLOCKED e FAIL. Solo le evidenze realmente ottenute possono sostenere una dichiarazione verificata.