Skip to content

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.