Scegli il percorso

Scegli partendo dallo stato corrente del progetto, non dallo strumento AI che vuoi usare. Gli adapter trasportano il workflow; non lo decidono.

Nuovo progetto → bootstrap

Usa bootstrap quando stai avviando un progetto e vuoi organizzare il materiale che possiedi già nello stato minimo utile.

tcaf bootstrap --target <percorso-progetto> --request "<richiesta iniziale>"
tcaf bootstrap --target <percorso-progetto> --input <materiale-esistente>

Normali specifiche, note, piani e materiale architetturale restano source evidence. Non richiedono preprocessing specifico TCAF.

Continua con Avvia un nuovo progetto.

Progetto esistente → adopt

Usa adopt quando esiste già software funzionante ma TCAF non lo ha ancora ispezionato.

tcaf adopt --target <percorso-progetto>

L’adozione è inspection-first. Preserva codice applicativo, storia e documentazione esistente, stabilendo soltanto le evidenze di progetto realmente necessarie.

Continua con Adotta un progetto esistente.

Feature o risultato ampio → plan

Usa plan quando il lavoro richiesto è troppo ampio per essere eseguito in sicurezza come un singolo task.

tcaf plan --target <percorso-progetto> --request "<feature o risultato>"

La pianificazione propone dipendenze, confini dei task, decisioni aperte e prossimo lavoro eseguibile. Non implementa codice, non scrive Task Contract e non cambia lo stato del progetto.

Continua con Pianifica una feature o modifica.

Una modifica chiara → task

Usa task quando la prossima unità di lavoro è già nota.

tcaf task --target <percorso-progetto> --request "<richiesta delimitata>"

TCAF ispeziona le evidenze pertinenti, prepara un Task Contract e attende l’approvazione del developer prima dell’implementazione sostanziale.

Continua con Esegui un task di sviluppo.

Il progetto è cambiato fuori dall’esecuzione corrente → sync

Usa sync dopo modifiche manuali del developer, una nuova specifica, un cambiamento esterno o qualsiasi modifica del repository avvenuta fuori dall’esecuzione che può influenzare stato documentato o lavoro pianificato.

tcaf sync --target <percorso-progetto>

Sync prima ispeziona e propone. Non sovrascrive automaticamente il lavoro del developer e non implementa feature.

Continua con Sincronizza lo stato del progetto.

È cambiato il task attivo

Non ampliare silenziosamente il Task Contract corrente. Un chiarimento può restare dentro il task; una modifica sostanziale dello scope richiede un amendment o un task separato.

Il developer può inoltre modificare direttamente il codice in qualsiasi momento. Prima di continuare, l’AI deve rileggere e preservare il nuovo stato del repository.

Lavoro accettato → il commit resta separato

Un’implementazione riuscita non autorizza automaticamente staging, commit, tag, push o modifiche a tracker remoti. Restano azioni separate autorizzate dal developer.

Continua con Commit del lavoro accettato.

Quando non sei sicuro

Preferisci l’operazione più piccola che risponde alla domanda corrente:

• ispeziona prima di scrivere;
• usa plan prima di forzare una feature ampia in un solo task;
• usa task prima dell’implementazione;
• usa sync prima di fidarti di uno stato di progetto non aggiornato;
• fermati per la review del developer invece di trasformare l’incertezza in nuovo scope.