What problem does it solve?
ui-spec-linter prevents vague, incomplete, or internally inconsistent spec packages from turning into implementation defects by validating cross-file completeness, vocabulary, consistency, and state coverage before generation starts.
Core Features & Use Cases
- Spec Completeness Validation: Confirms all required spec package files and required sections (including Run Manifest requirements) are present and non-empty.
- Vocabulary & Token Integrity Checks: Flags banned vague language and ensures every referenced token exists in system.md, while also surfacing dead-weight tokens that are never used.
- Cross-File Consistency Verification: Detects contradictions between brief, blueprint, and component specs (including non-goals compliance and acceptance criteria traceability).
- Interactive State Coverage Audits: Ensures each interactive component includes required states like hover, focus, disabled, loading, error, and empty as applicable.
Quick Start
Run ui-spec-linter as the final quality gate on a complete spec package right before invoking ui-generate-code.