ff

2026-10-26 00:25:18 +01:00
parent 1df884da84
commit 1bc033c329
46 changed files with 2958 additions and 0 deletions
@@ -0,0 +1,28 @@
+# 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.