Skip to content
TCAFTask-Contract AI Development Framework
TCAF 0.3.3

Riconcilia un backlog esistente

Allinea lo stato del backlog alle evidenze accettate del repository senza riscrivere la storia dei task.

Contenuto: completeWorkflow: verified

La riconciliazione del backlog allinea lo stato registrato del progetto alle evidenze implementative accettate. Non è un secondo task di sviluppo e non deve modificare codice applicativo.

Quando riconciliare

Usa questo workflow dopo che uno o più task sono stati revisionati e accettati, oppure quando l’adozione mostra che il backlog non corrisponde più al repository.

Correzioni tipiche:

  • segnare come completato il lavoro accettato;
  • mantenere aperti i criteri di accettazione non soddisfatti;
  • aggiungere collegamenti a evidenze, decisioni o commit;
  • registrare task superati o suddivisi senza cancellarne la storia;
  • correggere divergenze tra documenti e repository;
  • aggiungere lavoro emerso come elemento proposto separato.

Evidenze richieste

Prima di modificare uno stato, ispeziona:

  • Task Contract accettato;
  • esito di implementazione e review;
  • controlli realmente eseguiti;
  • accettazione del developer;
  • formulazione e dipendenze correnti del backlog;
  • eventuali modifiche manuali successive al risultato dell’agente.

Non dedurre il completamento da un diff plausibile o dalla sola dichiarazione dell’agente.

Mantieni stretto il perimetro

Il task di riconciliazione dovrebbe autorizzare soltanto backlog e documenti di stato collegati. Codice applicativo, dipendenze e documentazione non pertinente restano fuori perimetro.

Preserva la storia

Non eliminare task completati, non riscrivere vecchie stime come se fossero sempre state corrette e non fondere elementi indipendenti per presentazione. Quando lo stato corrente differisce dal piano originale, registra esplicitamente la transizione.

Valida e revisiona

Dopo la riconciliazione esegui:

tcaf validate --target <progetto>

Revisiona poi il diff documentale separatamente dal diff implementativo. Registra lo stato riconciliato con un commit soltanto dopo accettazione esplicita.