Esempio rapido

Questo esempio è volutamente piccolo. L’obiettivo è mostrare come iniziare a usare TCAF velocemente.

Immagina di avere una piccola applicazione web in ./demo-web e di voler aggiungere una sola pagina About senza modificare altro.

1. Adotta il progetto

tcaf adopt --target ./demo-web

TCAF ispeziona il repository, usa il materiale esistente come source evidence e deriva solo lo stato di progetto necessario. Revisiona il risultato prima di continuare.

2. Richiedi una modifica delimitata

tcaf task --target ./demo-web --request "Aggiungi una pagina About collegata dalla navigazione esistente. Riusa layout e stile attuali. Non aggiungere dipendenze e non modificare pagine non correlate. Verifica il risultato con i controlli esistenti pertinenti del progetto."

Per una modifica piccola come questa non serve usare prima plan. Usa tcaf plan quando il risultato richiesto è abbastanza ampio da richiedere più task o una decomposizione consapevole delle dipendenze.

3. Revisiona il Task Contract

Prima dell’implementazione, controlla che il contratto renda espliciti i confini importanti:

Obiettivo
- Aggiungere una sola pagina About.

Superficie di modifica autorizzata
- Routing e navigazione esistenti.
- Nuova pagina About secondo i pattern del progetto.

Preservare
- Route e comportamenti esistenti.
- Styling e dipendenze correnti.

Accettazione
- La pagina About è raggiungibile.
- Le pagine esistenti continuano a funzionare.
- I controlli pertinenti passano.

Condizioni di arresto
- Fermarsi se la modifica richiede una nuova dipendenza o un refactoring più ampio.

Se il contratto è troppo ampio o sbagliato, correggilo prima dell’approvazione.

4. Approva, esegui e verifica

Una volta approvato, l’AI può eseguire il lavoro dentro quel confine.

Alla fine controlla tre cose:

1. cosa è cambiato;
2. quali controlli sono stati realmente eseguiti;
3. se resta qualcosa in sospeso o fuori dallo scope approvato.

Review e accettazione finali restano al developer.

5. Se il progetto cambia fuori dal run

Se modifichi manualmente il repository, aggiungi nuovo materiale di progetto o un altro tool cambia lo stato del progetto, usa:

tcaf sync --target ./demo-web

sync rilegge le evidenze correnti e propone la riconciliazione minima prima di qualsiasi scrittura approvata.

Fai commit solo dopo aver accettato il risultato.

Parti da zero?

Usa bootstrap per stabilire lo stato minimo utile del progetto partendo dalla tua idea o da note già esistenti. Non implementa il codice dell’applicazione.

tcaf bootstrap --target ./demo-web --request "Definisci MVP, vincoli e architettura proposta per la review del developer. Non implementare codice applicativo."

Consulta Avvia un nuovo progetto oppure torna all’Avvio rapido.