spec-review
Reviews the specification artifacts in docs/ (requirements, use case diagram, use cases, test cases, BPMN models, entity model, glossary, ADRs) against each other: a deterministic lint that can block a build (missing specifications, duplicate or unresolved ids, uncovered FRs, unmapped BPMN activities, actor mismatches, weak words, glossary synonyms, blocking questions, unlinked ADRs) and an advisory semantic review (contradicting or duplicated rules, wrong level of detail, missing alternative flows, untestable rules, ambiguity), plus a traceability matrix, requirement coverage, an HTML report, and a change impact analysis of what a changed requirement, rule, or use case affects. Use when the user asks to "review the specs", "lint the use cases", "find contradictions", "is this use case ready", "show the traceability matrix", "which use cases realize FR-014", "are all requirements covered", "HTML report", "what does FR-014 affect", "impact analysis", or wants a CI spec gate. It never edits a specification.
Pinned to revision 323ec5f5c1c4, so it is the text this page describes rather than whatever the author pushed since.
Files
- skills/spec-review/SKILL.md
- skills/spec-review/references/lint-codes.md
- skills/spec-review/references/review-checklist.md
- skills/spec-review/scripts/spec_lint.py
Every link opens the file at its source, pinned to the revision this page describes.