Skip to content

Architecture Decision Records

Le decisioni architetturali importanti sono tracciate come ADR (Architecture Decision Record) nella cartella docs/adr/.

Formato: MADR (Context → Decision → Consequences).

Indice

Quando aggiungere un ADR

Aggiungi un ADR ogni volta che prendi una decisione che:

  • Non è derivabile leggendo il codice.
  • Sarà rilevante per chi si chiederà "perché?" tra 6 mesi.
  • Riguarda dipendenze esterne, autenticazione, schema dati o convenzioni di progetto.

Numera in modo monotonico (NNNN-titolo-breve.md) e segui il template MADR.