29 lines
1.3 KiB
Markdown
29 lines
1.3 KiB
Markdown
# DECISIONS — {{PROGETTO}} (Architecture Decision Records)
|
|
|
|
Ultimo aggiornamento: **{{DATA}}**
|
|
|
|
Formato: ogni decisione ha contesto, opzioni valutate, scelta e motivazione.
|
|
Stato: `accepted` · `proposed` · `superseded by D-xxx` · `rejected`.
|
|
Le decisioni non si cancellano: si superano.
|
|
|
|
---
|
|
|
|
## D-001 — Stack tecnologico
|
|
- **Stato:** proposed
|
|
- **Contesto:** <!-- DA COMPILARE -->
|
|
- **Opzioni:** <!-- (a) …; (b) … -->
|
|
- **Scelta:** <!-- DA COMPILARE -->
|
|
- **Motivazione:** <!-- DA COMPILARE -->
|
|
|
|
## D-002 — Sviluppo spec-driven
|
|
- **Stato:** accepted
|
|
- **Contesto:** le regole di business scritte solo nel codice emergono dal debugging invece che dalla specifica.
|
|
- **Opzioni:** (a) documentazione a valle del codice; (b) documento di modulo approvato prima del codice.
|
|
- **Scelta:** (b). Nessun codice senza un documento di modulo in stato *Approvato*, con regole, contratto, criteri di accettazione e task.
|
|
- **Motivazione:** le regole diventano esplicite e verificabili prima di costare un difetto.
|
|
|
|
## D-003 — La documentazione vive nel repository
|
|
- **Stato:** accepted
|
|
- **Scelta:** `docs/` nel repository del codice, aggiornata nella stessa modifica del codice che la riguarda.
|
|
- **Motivazione:** documenti e codice non divergono; la revisione del codice è anche revisione dei documenti.
|