1.3 KiB
1.3 KiB
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:
- Opzioni:
- Scelta:
- Motivazione:
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.