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:

  1. name at least one option that actually lost, and
  2. name the specific thing that killed it here - a mechanism, a measured number, a pinned version, a verbatim error, an upstream issue, an incident.
Installs
2
GitHub Stars
19
First Seen
Oct 16, 2026