Adotta un progetto esistente
Ispeziona un repository esistente, preserva codice e storia e stabilisci soltanto le evidenze di progetto necessarie a TCAF.
Usa adopt quando il software esiste già ma TCAF non ha ancora ispezionato il progetto.
L’adozione osserva il progetto. Non lo modernizza, rifattorizza o riscrive.
Esegui adoption
tcaf adopt --target <progetto-esistente>
Quando utile puoi fornire anche materiale esistente pertinente tramite --request o --input.
Cosa legge TCAF
Soltanto le evidenze necessarie a comprendere il progetto, per esempio:
- struttura del repository e confini applicativi;
- manifest di dipendenze e build;
- comandi esistenti di test, lint e validazione;
- architettura e pattern implementativi;
- evidenze di CI o deployment;
- documentazione, backlog e fonti dei task esistenti;
- limitazioni note.
Codice, storia e documentazione esistenti vengono preservati. I documenti esistenti restano source evidence invece di essere riscritti soltanto per adattarsi a un template TCAF.
Cosa può derivare adoption
Quando utile, TCAF può proporre uno stato canonico separato del progetto che mappa le evidenze necessarie alle operazioni successive. Deve creare soltanto ciò che manca o è realmente utile.
Anche l’assenza è un’evidenza: TCAF non deve inventare test suite, architetture, database o capacità di delivery non dimostrate dal repository.
Adoption non autorizza l’implementazione
Senza un task separato aperto dal developer, adoption non deve modificare codice applicativo, dipendenze, storia, completamento del backlog o sistemi remoti.
Revisiona lo stato proposto e valida il target quando appropriato:
tcaf validate --target <progetto-esistente>
La validazione strutturale controlla la coerenza; non dimostra che ogni dichiarazione sia semanticamente vera.
Dopo adoption
Usa tcaf plan se la prossima feature necessita di scomposizione, oppure tcaf task quando la prossima modifica delimitata è già nota.