Architecture Decision Records

This folder tracks architectural decisions made by the team. Each ADR captures a decision, its context, and consequences.

Conventions

• Naming: NNNN-kebab-case-title.md (e.g. 0001-use-postgresql.md)
• Numbering: sequential, zero-padded to 4 digits, never reused
• Immutability: accepted ADRs are never edited — supersede them with a new ADR instead
• Status values: Proposed | Accepted | Deprecated | Superseded by ADR-XXXX

Template

# ADR-NNNN: Title

**Status:** Proposed | Accepted | Deprecated | Superseded by ADR-XXXX
**Date:** YYYY-MM-DD
**Deciders:** names

## Context
Why this decision was needed.

## Decision
What was decided.

## Alternatives Considered
What else was evaluated and why it was ruled out.

## Consequences
Trade-offs, follow-up work, risks.