Riconcilia lo stato del progetto
Allinea documenti canonici, backlog e stato corrente del progetto dopo il lavoro accettato.
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.