Decision log

Because diagrams alone can't express the decisions that led to a solution, Structurizr allows you to supplement your software architecture model with a decision log, captured as a collection of lightweight Architecture Decision Records (ADRs) as described by Michael Nygard, and featured on the ThoughtWorks Technology Radar. Structurizr allows you to publish your ADRs to allow team members get an "at a glance" view of the current set of ADRs, along with facilities to make navigating them easier.

Decision log - summary
Decision log - detail

In Structurizr, each ADR has an ID, title, date and status (Proposed, Accepted, Superseded, Deprecated or Rejected), along with unstructured content written using Markdown or AsciiDoc. ADRs can either be created manually, or imported from tools like adr-tools.


To navigate through the ADRs, you can either use the dropdown control at the top of the page, the Left and Right cursor keys, or the quick navigation dialog, which is accessed by pressing the Space key.


You can use the filter text box and status dropdown, at the top of the page, to filter the ADRs that are shown.