Writing ADRs ADRs live in docs/adr/ and use sequential numbering: 0001-slug.md , 0002-slug.md , etc. Create the docs/adr/ directory lazily — only when the first ADR is needed. Template

{Short title of the decision} {1-3 sentences: what's the context, what did we decide, and why.} 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. As short as possible — caveman mode preferred ( caveman skill). Hard limit: precision and understandability must not suffer. Optional sections Show more Installs 867 Repository pandoscope/skills First Seen Jul 11, 2026 Security Audits Gen Agent Trust Hub Pass Socket Pass Snyk Pass