decisions/

Purpose

Architecture Decision Records (ADRs). The durable "why" behind non-obvious choices.

Files

• PROJECT_DECISIONS.md — Cross-cutting decisions log: tech stack, architecture principles, tenancy, multi-site, billing split, consumer-layer arch, data retention, and open/pending decisions. Start here for system-wide decisions.

What belongs here

• One file per decision, dated, in the form: Decision / Context / Why / Rejected alternatives / Guard (any choice that looks like a mistake but is deliberate).
• Decisions that span modules or set lasting precedent.

What does NOT belong here

• The current schema (the result of decisions) → database/.
• Live status → /index.

Naming

NNNN-short-title.md (zero-padded sequential), e.g. 0001-tenancy-pattern.md.

Source of truth

Live status/counts → /index.