# 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.