spec-review
Reviews the specification artifacts in docs/ (requirements, use case diagram, use case specifications, test cases, BPMN process models, entity model, glossary) against each other in two parts: a deterministic lint that can block a build (missing specifications, duplicate or unresolved ids, uncovered FRs, unmapped BPMN activities, weak words, glossary synonyms) and an advisory semantic review (contradicting or duplicated rules, wrong level of detail, missing alternative flows, untestable rules, ambiguity, actors, NFRs and constraints, entity model consistency), plus a traceability matrix on request. 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", or wants a specification quality gate in CI. It reports only and never edits a specification; checking code against a specification is /coverage-check.
Pinned to revision d25bf9167155, 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.