Decisions

Architectural Decision Records (ADRs). Append-only — decisions don't get rewritten when reversed; a new ADR supersedes an old one.

Format

Files are numbered: NNN-kebab-case-title.md. Each ADR captures: context, decision, consequences. See adr/SKILL for the template.

Index

Use file listing for the canonical index. Recent decisions:

• 001-test-db-local-postgres-fallback.md — local Postgres for tests instead of Docker Supabase
• 006-permission-system-redesign.md — see features/permission-redesign/plan.md
• 008-payment-record-architecture.md — see features/payment-record-architecture/spec.md
• 017-platform-v2-substrate-only.md — land deps + ESM, defer framework, cancel Phases 2–6

(Add to the bottom when shipping a new ADR.)