adr-review

Installation
SKILL.md

ADR Review

Review ADRs as architectural records that must remain useful to future maintainers. An ADR review is an audit and recommendation pass, not a rewrite pass unless the user explicitly asks for edits.

Ground Rules

  • Read docs/adr/INDEX.md first.
  • Always audit the full ADR set.
  • Read individual ADR files according to the full-audit plan; read related ADRs together when they form a decision chain.
  • Treat reviews as propose-only by default: report findings and concrete proposed edits, but do not modify ADRs, related records, or other docs unless the user asks.
  • Use current code and docs as evidence. Do not mark an ADR stale only because a newer preference exists; show the contradiction, missing supersession, or drift.
  • Do not use partial file lists to decide what to review.
  • If editing is requested, also use the adr skill's update/supersede workflow.

Full ADR Audit

Installs
1
GitHub Stars
2.8K
First Seen
Oct 15, 2026