yaml-schema

YAML schema validation ensures your fix-report documents have required fields and correct enum values. The schema.yaml file defines the structure that categorizes and validates frontmatter metadata automatically when you generate documented solutions.

Fix-report documents require YAML frontmatter with categorized metadata fields defined by schema.yaml. This frontmatter guides file placement under docs/solutions by problem_type and enforces consistent field naming and allowed values across all fix documentation.

Yes. The schema enables deterministic file organization by mapping problem categories to docs/solutions directories. Applying the schema after confirming solutions across modules ensures consistent categorization and fast lookup of previously solved non-trivial issues.

Schema validation catches missing required fields and invalid enum values before documentation is generated. This prevents malformed fix-report files and ensures all categorized solutions meet the metadata structure needed for reliable lookup and consistency.

Apply this schema after confirming a solution for non-trivial issues that required multiple investigation attempts or non-obvious fixes. The schema ensures these valuable solutions are consistently categorized and stored for future reference across your project.

The schema maps problem types to storage locations and enforces uniform metadata fields, making fixes discoverable and reproducible. Deterministic filenames and category placement under docs/solutions enable fast lookup when the same problems recur.