Hoe leg ik een architectuurbesluit vast?

De kern van een ADR

Samenvatting van AWS Prescriptive Guidance: een ADR beschrijft een betekenisvolle architectuurkeuze, de context en de gevolgen. Besluiten hebben een levenscyclus. Als nieuwe inzichten een andere keuze noodzakelijk maken, wordt een nieuw besluit vastgelegd dat het eerdere vervangt. De besluitgeschiedenis blijft zo beschikbaar.

EAW-werktemplate: maak de afweging navolgbaar

Beschrijf eerst het concrete besluit dat nodig is. Noteer de doelstellingen en beperkingen die werkelijk bepalend zijn. Vergelijk de haalbare alternatieven op dezelfde criteria. Neem doorgaan met de huidige situatie mee wanneer dat een reële optie is.

Scheid eisen van voorkeuren. Een verplichte beschikbaarheidseis is iets anders dan een voorkeur voor een bekend product. Noteer bij ieder criterium de bron, de verantwoordelijke en onzekerheden. Gebruik alleen gewichten of scores wanneer de betrokkenen de schaal en betekenis hebben afgesproken.

Fictief voorbeeld

Een team moet kiezen tussen statusgegevens rechtstreeks opvragen en een aparte leesvoorziening opbouwen. Het besluit kan afhangen van de vereiste actualiteit, belasting van de bron, beschikbaarheid en beheerlast. Zonder die informatie is geen van beide opties vanzelfsprekend de juiste.

Besluiten en heroverwegen

Leg de bevoegde beslisser, datum en status vast. Benoem negatieve gevolgen net zo expliciet als voordelen. Geef aan welke teams vervolgwerk krijgen en welke voorwaarden nog ingevuld moeten worden.

Een heroverwegingssignaal kan bijvoorbeeld een gewijzigde informatiebehoefte of een andere beschikbaarheidseis zijn. Verwijs bij vervanging naar zowel het nieuwe als het oude besluit. Een document met alleen een oplossingsbeschrijving maakt de keuze nog niet navolgbaar.