validate is the primary command. Run it before every component edit and in CI. It checks a spec directory against all 14 rules and tells you, rule by rule, what passes and what does not.
Usage
Options
Output examples
Passing spec
Spec with warnings
AI-Ready promotion — a component with active warnings cannot have all checks: set to true.
Failing spec
JSON output (for CI)
--json whenever another tool needs to consume the results programmatically.
Exit codes
CI integration
Addvalidate as a step in your CI workflow. Use --json and parse the output if you want fine-grained reporting, or rely on the exit code for a simple pass/fail gate:
main.
The 14 rules
validate checks four categories of rules. See the contract rules reference for the full list and fix instructions.