italiadatacenter/add-on/AgentPlatform/sts-spec-driven/references/chiusura-ciclo.md

Chiusura del ciclo — STS Lab Srl

Checklist da seguire a lavoro finito, nella stessa modifica del codice. Ogni voce è condizionale: aggiorna solo ciò che il lavoro ha davvero toccato.

1. Verifica prima di scrivere «fatto»

• I test dei criteri di accettazione del task esistono e sono stati eseguiti.
• Annotato il conteggio reale della suite (es. «backend 614 (+3), tutti passanti»).
• Se una verifica è stata fatta solo con test e non contro il sistema reale, scriverlo.
• Se qualcosa non è verificabile ora (cluster, casella reale, fornitore esterno), aprire un task T-xxx per la verifica mancante invece di dichiarare ✅.

2. Documenti di tracciamento

• TODO — stato del task; nuovi task con l'ID successivo libero, la spec e lo stato. Data «Ultimo aggiornamento» (e «precedente», se il file la usa).
• TRACEABILITY — righe REQ interessate: criteri coperti e stato. ✅ solo con test passanti. Aggiornare anche la riga di copertura dell'area.
• Spec — se la regola è cambiata o estesa: nuova sezione §n.bis, nuovi criteri (lettera della spec + numero successivo), nuovi task nella tabella Task.
• REQUIREMENTS — nuovo REQ-<AREA>-<nn> se nasce un comportamento nuovo; tipo N con la D-xxx d'origine; nuovo DIF-nn se è emerso un difetto.

3. Decisioni e memoria

• DECISIONS — una D-xxx nuova per ogni scelta strutturale, deviazione da una spec o cambio di un requisito di parità. Formato: Contesto → Decisione → Alternative valutate → Conseguenze. Aggiungerla anche alla tabella indice. Se sostituisce una decisione, marcare la vecchia «Superata da D-xxx» senza cancellarne il testo.
• DEVELOPMENT_LOG — voce in testa (ordine cronologico inverso): ## AAAA-MM-GG (n) · titolo. Cosa si è scoperto, cosa è stato tentato e respinto e perché, misure reali.
• PROJECT_MEMORY — solo se è emerso un vincolo che, dimenticato, farebbe ripetere un errore.

4. Comunicazione

• CHANGELOG — sezione [Non rilasciato]; linguaggio per l'utente del prodotto (Aggiunto / Modificato / Corretto), non dettagli interni.
• 00-INDEX — riquadro in testa > **Titolo (AAAA-MM-GG):** … con gli ID coinvolti (REQ-…, D-…, T-…) e il conteggio dei test; aggiornare la data dell'indice e la riga della spec nella mappa se ne cambia lo stato o il numero di criteri.

5. Coerenza finale

• Rieseguire spec_index.py overview <docs>: nessun nuovo ID «citato ma mai definito».
• Nessun segreto, password o chiave nei documenti aggiornati.

_{STS Lab Srl · Spec-Driven Reader}