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
.featurefile. - 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.