Aggiorna documentazione o stato
Modifica la documentazione canonica del progetto senza mescolarla all’implementazione applicativa.
Gli aggiornamenti di documentazione e stato sono lavoro reale di progetto, ma devono restare distinguibili dall’implementazione applicativa.
Usa un Task Contract solo documentale
Definisci:
- quali documenti canonici possono cambiare;
- le evidenze implementative che supportano l’aggiornamento;
- stati o decisioni da riconciliare;
- informazioni storiche da preservare;
- comandi di validazione;
- esclusione esplicita del codice applicativo salvo autorizzazione separata.
Utilizzi comuni
- aggiornare lo stato del progetto dopo lavoro accettato;
- registrare una decisione architetturale;
- riconciliare il completamento del backlog;
- correggere percorsi o descrizioni delle capacità dopo la review dell’adozione;
- documentare una limitazione verificata;
- aggiungere evidenze da verifica manuale.
Preserva evidenze e storia
Non riscrivere vecchie decisioni per rendere il progetto apparentemente più ordinato. Aggiungi esplicitamente la decisione corrente, la sostituzione o la correzione. Distingui fatti osservati nel repository da piani e proposte.
Valida
Esegui:
tcaf validate --target <progetto>Revisiona anche il diff documentale per individuare ampliamenti accidentali del perimetro, storia rimossa e dichiarazioni non supportate.
Mantieni separate le operazioni Git
Un aggiornamento documentale non autorizza automaticamente commit o push. Presenta il risultato per la review e attendi un’accettazione esplicita.