structured-doc-validate

Validate YAML schema shape and reference integrity by auditing canonical structured artifacts within a repository's resolved docs root. The process applies a four-layer validation workflow to surface actionable findings with artifact paths, severities, and recommended repairs.

Checking structured YAML artifacts for evidence quality and coverage requires auditing both repo-level and scoped artifacts. This validation enforces a read-only stance on non-structured prose docs, ensuring the structured YAML remains the trustworthy source of truth for safer agent prompts.

Structured YAML validation prevents stale context in codebase review workflows by auditing canonical artifacts for correctness and granularity. It ensures artifacts are trustworthy and repairable, applying runtime schemas to output findings with IDs, severities, and evidence for remediation.

Yes, you can use this validation process for both repo-level and scoped structured docs. It operates within the repository's resolved structured docs root and audits both artifact levels to ensure schema correctness, reference integrity, and evidence quality across the entire documentation structure.

Before validating canonical structured YAML artifacts, you need a resolved structured docs root containing the YAML files. The validation operates within this specific repository directory, applying runtime schemas to audit the artifacts and enforce a four-layer validation workflow.

Structured YAML artifact validation reports reference integrity errors when canonical artifacts contain broken or misaligned references. The four-layer validation workflow detects these issues during the schema shape audit, outputting findings with artifact paths and severities to guide recommended repairs.