Workflow
- Extract Claims - Parse file paths, symbols, imports, library claims from specs
- Verify Files - Glob/Read to confirm paths and line ranges
- Verify Symbols - Semantic search + Grep for functions/classes
- Verify Libraries - Context7/Exa for third-party feature claims
- Check Patterns - Compare proposed implementation against referenced patterns
Severity Levels
| Level | Meaning | Behavior |
|---|---|---|
| P0 | Critical | Blocks (exit 1) |
| P1 | High | Warn (exit 0) |
| P2 | Medium | Advisory |
Example Finding
{
"severity": "P0",
"category": "file_missing",
"claim": "Modify hooks/lib/auth_handler.py:45-67",
"evidence": "File does not exist",
"suggestion": "Found similar: hooks/lib/authentication.py"
}
Output
═══════════════════════════════════════════════════════════════
{✓|✗} SPEC VALIDATION: {project} (P0:{n} P1:{n} P2:{n})
═══════════════════════════════════════════════════════════════
Status: {BLOCKED if P0 > 0 else PASSED}
Next:
BLOCKED → Fix P0 findings, re-validate
PASSED → Proceed with /epic-decompose {project}
═══════════════════════════════════════════════════════════════
References
references/validation-steps.md- Detailed workflowreferences/output-format.md- JSON structurereferences/tool-requirements.md- Tool selection, error handling
Converted and distributed by TomeVault — claim your Tome and manage your conversions.