Post

Decision Capturing Tools

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. We are happy to include more candidate assets here.

Tooling to create and maintain decision files

Any template

  • dotnet-adr - A cross platform .NET Global Tool for creating and managing Architectural Decision Records (ADR).

MADR template

NameMADR VersionComment
adr-log2.1.2CLI to keep an index.md file updated with all ADRs
ADR Manager2.1.2Web-based UI connecting to GitHub to directly edit ADRs in a form-based way
ADR Manager VS Code Extension2.1.2Visual Studio Code (VS Code) extension
Backstage ADR plugin2.1.2 and 3.xplugin to explore and search ADRs within a backstage based developer portal. Search at scale across mutliple orgs/repos
Hugo Markdown ADR Tools2.1.2.CLI to create and update ADRs
Log4brains2.1.2 without numbers in the filenameSupports both nice rendering of ADRs and creation of ADRs in a command line.
pyadr2.1.2CLI to help with an ADR process lifecycle (proposal/acceptance/rejection/deprecation/superseding)

Nygard template

Tooling close to the code

  • ArchUnit: unit tests for architecture
  • docToolchain: docToolchain is an implementation of the docs-as-code approach for software architecture plus some additional automation.
  • Structurizr: Structurizr is a collection of tooling to help you visualise, document and explore your software architecture using the C4 model.

Interesting, but unmaintained tooling

  • adr-log: Generates an architectural decision log out of MADRs.
  • ADMentor Architectural Decision Modeling Add-In for Sparx Enterprise Architect
  • eadlsync: Synchronizes embedded architectural decision records with a repository of architectural decisions.
  • SE Repo: Software Engineering Repository. A repository for versioning software engineering artifacts, which can be architectural decisions, patterns, and others.
This post is licensed under CC BY 4.0 by the author.