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

Avvio rapido

Installa TCAF ed esegui il primo workflow della v0.4.0 in pochi minuti senza leggere tutta la reference.

Non devi leggere tutta la reference di TCAF prima di provarlo.

Il percorso minimo utile è:

installa → verifica → bootstrap o adopt → plan solo se serve → task → verifica → sync quando cambia lo stato del progetto.

TCAF vincola l’esecuzione dell’AI, non il developer. Puoi continuare a ispezionare, progettare, scrivere e modificare direttamente il software in qualsiasi momento.

1. Installa TCAF una sola volta

git clone https://github.com/VegGyver/task-contract-ai-development-framework.git
cd task-contract-ai-development-framework
python install.py --adapter auto
tcaf doctor

Un’installazione corretta deve riportare PASS e indicare runtime e adapter attivi.

Consulta Installa TCAF per i dettagli su piattaforme e gestione delle versioni.

2. Parti dal progetto che hai davvero

Nuovo progetto:

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

Progetto esistente:

tcaf adopt --target <percorso-progetto>

Puoi usare anche --input quando possiedi già specifiche, note, piani o altro materiale di progetto. TCAF tratta il normale materiale come source evidence: non devi prima convertirlo in un template TCAF.

3. Pianifica soltanto quando il lavoro è più ampio di un task

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

plan propone dipendenze e confini dei task per la review. Non implementa codice e non crea Task Contract.

Se la modifica è già piccola e chiara, salta questo passaggio.

4. Esegui un singolo task delimitato

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

TCAF prepara un Task Contract che rende visibile il confine importante:

  • obiettivo;
  • superficie di modifica autorizzata;
  • comportamento da preservare;
  • criteri di accettazione;
  • controlli pertinenti;
  • condizioni di arresto.

Revisiona e approva il contratto. L’AI può quindi eseguire il lavoro approvato dentro quel confine.

5. Verifica, accetta e sincronizza quando serve

Il risultato deve separare chiaramente ciò che è stato modificato da ciò che è stato realmente verificato. Il developer decide se accettare il lavoro.

Se repository o evidenze di progetto cambiano successivamente fuori dall’esecuzione corrente, usa:

tcaf sync --target <percorso-progetto>

Sync rilegge le evidenze correnti e propone la riconciliazione minima. Il primo passaggio è read-only; gli aggiornamenti richiedono un’approvazione delimitata.

Nota sugli adapter

TCAF 0.4.0 resta model-agnostic, ma la copertura di validazione degli host non è identica:

  • Codex — percorso nativo verificato;
  • Cline — percorso manual-envelope verificato con limitazioni documentate;
  • invocazione nativa Cline e combinazioni più ampie con host generici non vengono dichiarate equivalenti ai percorsi verificati.

Consulta Copertura di validazione per il perimetro preciso.

Prossimo passo

Prova l’Esempio rapido oppure apri Scegli il percorso per una guida comando per comando.