Validation

Check that all blueprints are valid:

# Validate everything
node scripts/validate.js

# Validate one blueprint
node scripts/validate.js blueprints/auth/login.blueprint.yaml

# Watch mode (re-validates on file changes)
npm run validate:watch

The validator checks:

  • Blueprint structure matches the schema
  • All required sections are present
  • Naming conventions are followed
  • Related features point to blueprints that exist
  • Outcomes have the correct structure (given/then/result)
  • Expression syntax in when: clauses is valid