ADR-NNNN: (short decision title)

Copy this file to docs/adr/NNNN-kebab-title.md, increment the number, fill in. An ADR is frozen once accepted. It records what we decided and the context at that moment. Don't edit accepted ADRs to reflect new reality — write a new ADR that supersedes the old one.

• Status: Proposed | Accepted | Superseded by ADR-XXXX | Deprecated
• Date: YYYY-MM-DD
• Deciders: names
• Related: ClickUp #, ADR-XXXX

Context

What forces are at play? What problem/constraint requires a decision now? Keep it to the facts that actually drove the choice — performance, team size, deadline, platform, cost. No solution yet.

Decision

The decision, stated in active voice: "We will …". One decision per ADR.

Consequences

What becomes easier, and what becomes harder. Include the costs you're accepting and what you're betting on. Honest trade-offs here are the whole point — a consequences section that lists only upsides is a red flag.

Alternatives considered

Briefly: what else was on the table and why it lost. This is what stops the next engineer from relitigating the decision in six months.