Decisions (ADRs)¶
Every material decision lives here. One ADR per decision. Append-only — never edit accepted decisions; supersede them with a new ADR.
Why ADRs¶
git log+ file history = audit trail. Anyone (human or LLM) can answer "why did we decide X?"- New team members read the ADR list to get up to speed on context, not just current state
- Forces explicit articulation of alternatives considered
How to write one¶
- Copy
0000-template.md→NNNN-short-title.md(next number, kebab-case) - Fill out all sections
- Status starts as
proposed, flips toacceptedwhen ratified - If later replaced, update frontmatter
status: superseded-by-NNNN— do NOT delete content
Current decisions¶
| # | Title | Status | Date |
|---|---|---|---|
| 0001 | Distribution-led GTM | accepted | 2026-04-19 |
| 0002 | Self-host n8n on Zeabur | accepted | 2026-04-18 |
| 0003 | Cloudflare Pages migration | accepted | 2026-04-18 |
Template¶
See 0000-template.md.