Numbered ADR-style decision records (Nygard format, ThoughtWorks Tech Radar staple). The full Nygard prose lives in the source contribution; the synthesis page in this folder is a thin wrapper that links to the contribution and tracks status over time. This index is a regenerated register table.
How decisions are filed
- Source of truth —
contributions/YYYY-MM-DD-<slug>.mdwithtype: decision. Body holds Context / Decision / Consequences / Alternatives. Immutable. - Synthesis page —
pages/decisions/NNNN-<slug>.md. Frontmatter (decision_id,status,event_date,sources,affects, optionalsupersedes) plus a brief synthesis paragraph that links to the contribution. - This register — regenerated by
corza:kb-lintfrom synthesis-page frontmatter.
Numbering is stable: assigned at first filing, never reused. Superseding files a
new contribution + new synthesis page with supersedes: NNNN; the old page’s
status flips to superseded; both pages stay; both appear in the register.
Register
| ID | Title | Status | Date | Affects |
|---|
No decisions filed yet
Starter ADRs flagged in the bootstrap structure doc — headless Hydrogen, Pack Digital over Sanity, iframed Laravel portal, API-driven account creation, GoldTalk middleware — should be filed as
type: decisioncontributions and synthesized into pages here.