Skip to content
TCAFTask-Contract AI Development Framework
TCAF 0.3.3

Riconcilia lo stato del progetto

Allinea documenti canonici, backlog e stato corrente del progetto dopo il lavoro accettato.

Contenuto: completeWorkflow: verified

La riconciliazione aggiorna le evidenze di progetto dopo che l’implementazione è stata revisionata e accettata. Impedisce a documentazione, backlog e repository di divergere nel tempo.

Parti da evidenze accettate

Usa:

  • Task Contract approvato;
  • diff implementativo finale;
  • controlli realmente eseguiti;
  • limitazioni e verifiche ancora necessarie;
  • accettazione del developer;
  • eventuali modifiche manuali eseguite prima della riconciliazione.

Non riconciliare partendo dal piano iniziale dell’agente o da un risultato non revisionato.

Aggiornamenti tipici

  • segnare come completato il lavoro backlog accettato;
  • registrare separatamente il lavoro rimanente;
  • aggiornare descrizioni di capacità o architettura quando il comportamento è realmente cambiato;
  • aggiungere decisioni ed evidenze di validazione;
  • correggere riepiloghi di stato;
  • preservare elementi storici e decisioni superate.

Perimetro separato

Il Task Contract di riconciliazione dovrebbe autorizzare normalmente soltanto documenti canonici, record del backlog e file di stato. Il codice applicativo resta fuori perimetro.

Se la riconciliazione mostra che l’implementazione è incompleta o errata, fermati e torna a un task di sviluppo invece di modificare codice dentro il passaggio documentale.

Valida e revisiona

Esegui:

tcaf validate --target <progetto>

Revisiona poi il diff documentale rispetto al risultato accettato. Una validazione positiva conferma le regole di coerenza, non la verità di dichiarazioni prive di evidenza.

Completamento

La riconciliazione è completa quando i documenti correnti descrivono accuratamente lo stato accettato del repository e il lavoro rimanente è ancora visibile. Il commit resta un’operazione autorizzata separata.