adr-writer

Installation
SKILL.md

ADR Writer

When to use

  • A non-trivial architecture decision was just made
  • Reverse-documenting a decision that wasn't recorded but should have been
  • Preparing for a design review

When NOT to use

  • Trivial choices (naming, formatting)
  • Operational runbooks (those go to runbooks/)
  • Product decisions without architectural impact

Inputs

Name Type Required Notes
context string yes The problem being solved, in 2–4 sentences
options list yes Alternatives considered
decision string yes Chosen path
number int no If omitted, finds next ADR number from memory/decisions/
Installs
1
GitHub Stars
529
First Seen
Jun 21, 2026
adr-writer — oxbshw/llm-agents-ecosystem-handbook