Skip to content

ADR-001 - Werken volgens het ADR principe

Datum: 7-7-2023

Status

Geaccepteerd

Besluit

Voor het PNH Architectuur raamwerk gebruiken we ADR's.

Context

Het ADR 'mechanisme' is een manier om architectuur besluiten in een Agile omgeving vast te leggen. Omdat niet alles van te voren al vaststaat en er gedurende een project nieuwe inzichten ontstaan is het van groot belang de historie vast te leggen. Op deze wijze krijgen nieuwe teamleden een betere context mee van welke besluiten er genomen zijn en waarom.

Zie ook: https://cognitect.com/blog/2011/11/15/documenting-architecture-decisions

Alternatieven

  • Helemaal geen beslissingen vastleggen: dit is de situatie die we middels de Architectuur functie achter ons willen laten. We willen juist beslissingen bewust nemen, zoveel als mogelijk in samenhang en passend bij de principes.
  • Elke beslissing langs de Architectuurboard laten lopen. Dit heeft als voordeel dat overal onder Architectuur gewerkt wordt. En dat lijkt een goede aanpak, echter Architectuur dreigt dan een bottleneck te worden in de verandersnelheid van de organisatie.

Consequenties

Door elk team ADRs te laten opstellen komt het Architectuur-denken ook op de operationele laag in de organisatie, waardoor PNH beter in staat gesteld wordt veranderingen in samenhang door te voeren.

In de teams moet er Architectuur-capaciteit zijn, of er moet een mogelijkheid zijn een Architect te laten meehelpen.

Het vastleggen van de ADR's voor de architectuurprincipes gebeurt in de architectuurboard github repo. Deze repo beschouwen we als de basis van ons principe raamwerk.

ADRs dienen door de Architectuurboard gevalideerd te worden, of tenminste toegankelijk en inzichtelijk te zijn.