---
layout: page
---

# Architecture Decision Records

Architecture Decision Records document important architectural decisions made in the project. 

They capture:

- The context that led to the decision
- The decision itself
- The consequences (positive, negative, and neutral)
- Alternatives that were considered

## Records

{% assign adrs = site.pages | where_exp: "p", "p.path contains 'adrs/'" | where_exp: "p", "p.name != 'index.md'" | sort: "path" %}
{% for adr in adrs %}- **ADR-{{ adr.name | slice: 0, 4 }}** — [{{ adr.title }}]({{ adr.url | relative_url }})
{% endfor %}

## Format

ADRs follow the format described at [adr.github.io](https://adr.github.io/), with the following structure:

1. **Status** - Proposed, Accepted, Deprecated, or Superseded
2. **Context** - The situation and problem that led to this decision
3. **Decision** - The architectural decision and its rationale
4. **Consequences** - Positive, negative, and neutral outcomes
5. **Alternatives Considered** - Other options that were evaluated

## When to Create an ADR

Create an ADR when:

- Making a significant architectural decision that affects the public API
- Choosing between multiple viable approaches
- The decision will impact future development or maintenance
- The decision needs to be communicated to stakeholders

Don't create an ADR for:

- Routine implementation details
- Temporary workarounds
- Decisions that are clearly the only viable option