Writing ADRs ADRs live in and use sequential numbering: , , etc. Create the directory lazily — only when the first ADR is needed. Template That's it. An ADR can be a single paragraph. The value is in recording that a decision was made and why — not in filling out sections. Written and checked with the skill if available, surface . Hard limit: precision and understandability must not suffer. Optional sections Only include these when they add genuine value. Most ADRs won't need them. - Status frontmatter ( ) — useful when decisions are revisited - Considered Options — only when the rejected alt…