ADR Creation (Dual Format)

Core Principles

1. Markdown (<adr-dir>/YYYY-MM-DD_kebab-title.md) is the source of truth. Concise, technical — for AI agents. The ADR directory is docs/adr/ by default, but mirror the project's existing ADR location if it differs (e.g. wip/docs/adr/).

2. HTML (<adr-dir>/html/YYYY-MM-DD_kebab-title.html) is the human explainer. Rich, narrative, with diagrams. Lead with the problem — open with a concrete before-state so the reader feels the pain before learning the fix. The HTML destination is task-derived — do not consult htmlOutputDir settings for ADRs.