# DECISIONS.md — WalletPress

> Architecture Decision Records (ADRs). Read before architectural changes.

## What is an ADR?
A short document capturing an important architectural decision:
- Context (what's the problem?)
- Decision (what did we choose?)
- Consequences (what does this imply?)
- Alternatives (what else did we consider?)

## How to Write a New ADR
1. Copy `docs/adr/0000-template.md` to `docs/adr/NNNN-short-title.md`
2. Fill in: Status, Context, Decision, Consequences, Alternatives
3. Add link below in "Index"
4. Commit as part of the change that triggered the ADR

## Index
<!-- Add new ADRs here, oldest first -->

| Number | Title | Status | Date |
|--------|-------|--------|------|
| [0001](docs/adr/0001-initial-architecture.md) | Initial architecture | Accepted | 2026-07-02 |

## Fleet-wide ADRs (in standards repo)
- [ADR-0001: Tailscale mesh as the only perimeter](https://git.rugmunch.io/RugMunchMedia/standards/raw/branch/main/MCP-ARCHITECTURE.md)
- [ADR-0012: 21-day sprint, not 10-week](https://git.rugmunch.io/RugMunchMedia/standards/raw/branch/main/FLEET-PLAN.md)
