# 20231026 Record Architecture Decisions

Date: 2023-10-26

# Status


# 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.