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

Sincronizza lo stato del progetto

Rileggi le evidenze correnti del repository dopo modifiche fuori dall’esecuzione e riconcilia soltanto il più piccolo aggiornamento approvato dello stato.

Usa sync quando la realtà del progetto può essere cambiata fuori dall’esecuzione AI corrente.

Trigger tipici:

  • modifiche manuali del developer;
  • una specifica nuova o aggiornata;
  • cambiamenti esterni;
  • implementazione accettata che ha cambiato capability documentate;
  • qualsiasi modifica del repository fuori dall’esecuzione che può influenzare lavoro pianificato o stato del progetto.

Esegui sync

tcaf sync --target <percorso-progetto>
tcaf sync --target <percorso-progetto> --request "<nuova informazione>"
tcaf sync --target <percorso-progetto> --input <nuova-specifica-o-materiale>

Una richiesta o un input è evidenza da ispezionare, non verità di progetto automaticamente approvata.

Primo passaggio: ispeziona e proponi

Sync rilegge il repository corrente e le evidenze di progetto pertinenti. Identifica:

  • drift sostanziale;
  • task pianificati che possono essere coinvolti;
  • conflitti o informazioni non risolte;
  • la più piccola riconciliazione utile.

Il primo passaggio è read-only. Preserva modifiche del developer, storia completata e conflitti non risolti.

Applica soltanto un aggiornamento approvato

Se la riconciliazione è appropriata, approva un insieme di aggiornamenti sufficientemente identificato e delimitato. Senza un’approvazione corrente, sync non deve scrivere o sovrascrivere il lavoro del developer.

Gli aggiornamenti approvati possono riguardare stato di progetto, record delle capability, stato del backlog o altre evidenze canoniche. L’implementazione applicativa è un’operazione differente.

Sync non implementa feature

Quando sync individua nuovo lavoro implementativo, invialo a tcaf plan o a un tcaf task separato, in base al caso.

Dopo un task accettato, sync può anche riconciliare documentazione e lavoro pianificato con lo stato del repository accettato. È un caso d’uso di sync, non l’unico.

Quando appropriato valida i documenti di progetto aggiornati e revisiona il diff reale prima dell’accettazione.