Files
italiadatacenter/add-on/AgentPlatform/sts-spec-driven/references/chiusura-ciclo.md
T
2026-10-26 00:25:18 +01:00

49 lines
2.7 KiB
Markdown

# 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.
<sub>STS Lab Srl · Spec-Driven Reader</sub>