adr
Installation
SKILL.md
Architecture Decision Records
One question governs every record:
Could a future reader recover why the losing option lost, without re-deriving it?
That is the whole product. A record that names only the winner is a commit message with extra headings.
Write one only if you can name the loser and what killed it
The trigger test, both halves required:
- name at least one option that actually lost, and
- name the specific thing that killed it here - a mechanism, a measured number, a pinned version, a verbatim error, an upstream issue, an incident.