retro-schema-validator

Validate .retro/*.json files against canonical schema v1.0. Catches schema drift and type mismatches.

SKILL.md

GitHub

Retro Schema Validator

Validate retro JSON files against canonical schema v1.0.

Trigger

/skill retro-schema-validator [path] [options]

Input Schema

interface Input {
  filePath?: string;           // path to .retro/*.json (default: auto-detect)
  all?: boolean;               // validate all .retro/*.json (default: false)
  verbose?: boolean;           // default: false
  failOnWarning?: boolean;     // default: false
}

Output Schema

interface Output {
  status: "success" | "error";
  verdict: "RED" | "YELLOW" | "GREEN";
  filesValidated: number;
  violations: Array<{
    file: string;
    field: string;
    level: "error" | "warning";
    message: string;
  }>;
  timestamp: string;
}

Exit Codes

  • 0: GREEN (schema compliant)
  • 1: YELLOW (warnings, can proceed)
  • 2: RED (schema violations, do not commit)

Full reference: See Skill Operator Guide.

For schema definition and examples: See docs/USAGE.md.