Registrare contesto, opzioni e conseguenze in un Architecture Decision Record sintetico e utile nel lavoro quotidiano.
A chi si rivolge? Team di architettura e sviluppo che vogliono comprendere in modo permanente le ragioni delle decisioni tecniche.
Casi d’uso e contesto
Un Record di Decisione di Architettura, o ADR in breve, registra una decisione rilevante e la sua giustificazione. Successivamente, spesso non è la tecnica scelta a non essere chiaro, ma il motivo per cui le alternative furono respinte e quali condizioni si applicassero all'epoca.
Un ADR dovrebbe rimanere abbastanza compatto da poter essere effettivamente letto. Integra panoramiche architettuali e specifiche di vincolamento, ma non li sostituisce. Le voci su decisioni con effetti a lungo termine, come responsabilità dei dati, modelli di integrazione o servizi della piattaforma centrale, sono particolarmente utili.
Il percorso nel dettaglio
- Formula la domanda decisionale. Descrivi il contesto, gli obiettivi e i vincoli in modo che i futuri membri del team possano comprendere.
- Confronta le opzioni seriamente valutate. Registra vantaggi, svantaggi e incertezze aperte in base ai criteri rilevanti.
- Documenta la decisione, lo stato e le conseguenze. Collega una nuova voce in caso di un cambiamento successivo invece di sovrascrivere la vecchia giustificazione in modo irriconoscibile.
I risultati attesi
- Domanda decisionale comprensibile
- Alternative documentate e compromessi
- Conseguenze riconoscibili per l'implementazione e il funzionamento
- Storia collegata delle decisioni cambiate
Preparare una decisione consapevole
Un breve modello include il titolo, lo stato, il contesto, le opzioni, la decisione, le conseguenze e i riferimenti. Nomina gli stakeholder e la data della decisione se queste informazioni sono effettivamente note.
Evita la pubblicità puramente di prodotto e affermazioni generiche come "a prova di futuro". Invece, descrivi quali requisiti vengono soddisfatti e quali svantaggi il team accetta consapevolmente.
Domande e risposte
Ogni piccolo cambiamento ha bisogno di un ADR?
No. Lo sforzo dovrebbe corrispondere all'ambito. Le decisioni locali ricorrenti possono spesso essere coperte dagli standard esistenti.
Cosa succede a un ADR rinnovato?
Viene conservata come storia e si riferisce alla decisione di sostituzione. In questo modo, i prerequisiti di quel periodo non si perdono.