Architecture Decision Records

This directory records architecture decisions that have meaningful alternatives or lasting effects. An ADR explains why a decision exists. Architecture documents describe the resulting system.

File names follow this pattern:

adr-NNN-short-title.md

ADR numbers are permanent and never reused. Supported statuses are Proposed, Accepted, Superseded, and Rejected. An accepted ADR is not rewritten to change its decision. Create a new ADR and link both records when a decision changes.

Use this compact structure:

# ADR-NNN: Title
 
**Date:** YYYY-MM-DD
 
**Status:** Proposed
 
## Context
 
## Decision
 
## Consequences
 
## Alternatives considered
 
## References

Keep ADRs concise. Link the relevant specification, architecture, milestone, epic, and PBI instead of copying them.