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.