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.mdfirst. - 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
adrskill's update/supersede workflow.