| name | Spec Linter |
| description | Validates specs have required frontmatter, links, and compliance. Use before commits or during code review. |
Spec Linter Skill
Purpose
Validate:
- Frontmatter completeness
- Test-to-spec traceability
- ADR requirements for architectural changes
- PR template compliance
Validation Rules
- Frontmatter required fields by type
- Test IDs (TC-XXX) present near Swift test methods
- ADR required when key components/frameworks change
- Acceptance criteria present for new features
- PR template sections completed
Usage
- Pre-commit:
python3 scripts/lint-specs.py - CI: see
.github/workflows/spec-lint.yml