review-spec

Installation
SKILL.md

review-spec - find overlap and conflicts before they ship

A spec or ADR is most useful when it's the only document making its claims. Two specs that cover the same feature area drift; two ADRs that contradict each other create silent ambiguity; a spec that ignores a relevant ADR ships behaviour that breaks an earlier decision.

review-spec reads a target spec or ADR (the one being reviewed) and audits the existing corpus around it. It surfaces:

  • Duplicates - scenarios already covered in another .feature file.
  • Overlaps - the new doc and an existing doc cover related ground in ways that will drift over time.
  • Conflicts - the new doc contradicts an existing ADR or another spec.
  • Missing cross-links - relevant ADRs not referenced; relevant specs not referenced.
  • Orphan decisions - the new doc relies on assumptions that should themselves be ADRs.
Installs
2
First Seen
10 days ago
review-spec — 0xdeafcafe/skills