MADR ADRs

This skill creates (and keeps tidy) Architectural Decision Records (ADRs) using MADR (Markdown Architectural Decision Records) v4.0.0.

A helpful bar for what "counts" as an architectural decision is Martin Fowler's: "a decision you wish you could get right early." ("Who needs an architect?", IEEE Software, 2003)

Primary reference: Markdown Architectural Decision Records

Repository layout and naming

All ADRs live in:

• docs/decisions/NNNN-title-with-dashes.md

Where:

• NNNN is a zero-padded 4-digit sequence number (0001, 0002, …)
• title-with-dashes is a lowercase slug (letters/digits/hyphens)