Architecture Decision Records¶
This directory contains Architecture Decision Records (ADRs) for significant technical decisions in Reggie.
Index¶
| ADR | Status | Date | Summary |
|---|---|---|---|
| 001 | Accepted | 2026-03-06 | Use Clerk for authentication (replacing Supabase Auth) |
| 002 | Accepted | 2026-02-02 | Use LightGBM as primary ML model for plate valuation |
| 003 | Accepted | 2026-03-04 | Use SST v4 for AWS infrastructure-as-code |
Template¶
New ADRs should follow the Nygard format:
# ADR-NNN: Title in Present Tense
## Status
Proposed | Accepted | Deprecated | Superseded by ADR-NNN
## Context
What forces are at play? What is the situation?
## Decision
What is the change we are proposing or accepting?
## Consequences
What becomes easier? What becomes harder? What are the trade-offs?
Naming: NNN-lowercase-hyphenated-title.md (e.g., 004-add-redis-caching.md)
Principle: ADRs are immutable once accepted. To reverse a decision, create a new ADR that supersedes the old one.