plan-mode-spec-lint
Find what a spec leaves unstated. Use when auditing an existing spec, PRD, or epic for the gaps that would cause a wrong implementation.
SKILL.mdskills/plan-mode/spec-lint/SKILL.md
GitHubSpec Lint
A spec is a contract; the failures live in what it does not say. Audit an existing spec for the gaps that would cause a wrong implementation.
- Read the spec and list every behavior it specifies. For each, note the trigger, the expected result, and the stated edge cases.
- For each specified behavior, ask what happens in the cases the spec does not name: empty input, duplicate input, concurrent input, failure of a dependency, partial completion, and recovery after interruption.
- Check for contradictions between sections, undefined terms used as if defined, and acceptance criteria that cannot be observed or tested.
- Report gaps ordered by the cost of getting them wrong, each with the specific question that would close it. Do not fix the spec.
Linting is read-only. Report the gaps; the spec's owner decides what to change.
Record this output in docs/plans/ per the doc system, delegating the write to a subagent.