schema

YAML schema validation enforces required fields, enums, and rules defined in schema.yaml. This Skill automatically validates fix-report outputs against your schema to ensure all metadata meets compliance requirements before documentation is generated.

Required fields include module, date, and problem_type, enforced by schema validation. The Skill rejects incomplete reports and ensures every documented solution carries consistent, queryable metadata across your docs repository.

The schema maps problem reports to category directories and generates sanitized filenames (symptom-module-YYYYMMDD.md) with YAML frontmatter. This creates a structured, indexed documentation library where each solution is stored under docs/solutions/[category]/ for fast lookup.

Yes, enum validation within the schema restricts each field to allowed values. This prevents inconsistent problem classifications and ensures downstream tools can reliably parse and categorize your documented fixes.

Schema validation rejects non-compliant reports before they generate documentation files. The Skill only documents confirmed, non-trivial resolutions that pass all required-field and enum checks, maintaining documentation quality.