ADR Template

Copy this file to ADR-NNN.md and fill in all sections.

---

ADR-NNN: [Short Title]

Status: Proposed | Accepted | Deprecated | Superseded by ADR-XXX
Date: YYYY-MM-DD
Decision Class: ARCH | UX | SCOPE | TOOLING | PHIL

Context

What is the problem or opportunity? What constraints exist?

Decision

What are we doing? Be specific.

Consequences

What changes as a result? Positive, negative, and neutral.

Alternatives Considered

Option	Pros	Cons	Verdict
Option A	...	...	Rejected
Option B	...	...	Accepted

References

• Links to related ADRs, specs, or external docs
• GitHub issues or PRs

Revisit If

Under what conditions should this decision be revisited?