validate-spec

name	validate-spec
description	Check a spec.md and .feature file for completeness, consistency, and adherence to SDD principles. Use before approving a spec or marking it Implemented.
triggers	["validate spec","check spec","review spec","is this spec complete"]

validate-spec

Check a spec for completeness, internal consistency, and adherence to SDD principles.

When to use

• Before changing a spec's status from Draft → Approved
• Before changing a spec's status from Approved → Implemented
• When asked to review a spec

Checklist

Run each check and report findings. Fix issues inline if possible; flag for human review if not.

Required sections

• Status field present and valid (Draft / Approved / Implemented / Deprecated)
• What section present and non-empty
• Why section present and non-empty — "Why" is never optional
• Command surface / API section present (or explicitly noted as N/A with justification)
• Link to .feature file present
• .feature file exists at the linked path

Content quality

• describes observable behavior, not implementation internals