1. Record Architecture Decisions

🔙

Date: 2025-01-21

• Status
• Context
• Decision
• Consequences

Status

Accepted

Context

It’s necessary to record architecturally significant project decisions, including all options that were considered.

Decision

Use ADR (Architecture Decision Records) format described in the article. Decision statuses:

• Proposed
• Accepted
• Deprecated - the situation has changed over time, need to think about another solution
• Superseded - another solution has taken effect, replacing this one

The records are stored in files named like DecisionNumber-DecisionName.md, where DecisionNumber has the form 0001, 0002, etc. This many digits and leading zeros are needed to sort the files by name. Each number (without leading zeros) is the unique decision ID.

Consequences

Architecture decisions are documented and justified.