#
20231026 Record Architecture Decisions
By
Date: 2023-10-26
#
Status
Accepted
#
Context
Every project that runs longer than a couple of weeks will at some point require the team to make architectural decisions. These will often result in code, which has a habit of staying in the company longer than the dev who wrote it. This leads to code that was implemented because of a decision nobody remembers making.
We need a tool to record such decisions for the future, making them easily accessible, readable, and maintainable.
#
Decision
We will use Architecture Decision Records, as described by Michael Nygard.
#
Consequences
See Michael Nygard's article, linked above. For a lightweight ADR toolset, see Nat Pryce's adr-tools.