https://adr.github.io/An Architectural Decision (AD) is a justified design choice that addresses a functional or non-functional requirement that is architecturally significant. An Architecturally Significant Requirement (ASR) is a requirement that has a measurable effect on the architecture and quality of a software and/or hardware system. An Architectural Decision Record (ADR) captures a single AD and its rationale; the collection of ADRs created and maintained in a project constitute its decision log. All these are within the topic of Architectural Knowledge Management (AKM), but ADR usage can be extended to design and other decisions (“any decision record”). 2026-06-15T18:16:18+02:00 adr.github.io https://adr.github.io/ Jekyll © 2026 adr.github.io /assets/img/favicons/favicon.ico /assets/img/favicons/favicon-96x96.png 2024-10-28T00:00:00+01:00 2026-06-15T18:15:29+02:00 https://adr.github.io/adr-tooling/ adr.github.io

The following lists are rather inclusive and sorted alphabetically. Please find out about the status and the maturity of the list entries for yourself by following the links. Tooling to create and maintain decision files Any template ADG (Architectural Decision Guidance), a command-line tool written in Go for modeling, managing, and reusing architectural decisions in a lightweight and st...

2024-10-27T00:00:00+02:00 2026-05-11T09:40:47+02:00 https://adr.github.io/ad-practices/ adr.github.io

The lists on this page point at ADR capturing practices and related advice but do not necessarily endorse all of them. Timing Architectural Decisions, a presentation given at the annual Swedish IT architect conference ITARC features many of the practices collected on this page. AD Making The Design Practice Repository (DPR) on GitHub and the DPR e-Book on LeanPub feature AD making and captu...

2024-10-25T00:00:00+02:00 2026-05-11T10:53:22+02:00 https://adr.github.io/adr-templates/ adr.github.io

The following UML class diagram shows that many templates for ADR capturing exist, including (but not limited to) MADR, Nygardian ADRs, and Y-Statements: --- config: class: hideEmptyMembersBox: true --- classDiagram direction TB class ADR { <<abstract>> } ADR <|-- MADR ADR <|-- NygardADR ADR <|-- Y-Statement ADR <|-- OtherADRTemplate Mark...