x-validate-docs

To validate documentation changes against code in a PR, this Skill auto-detects targets and maps changed files to dimensions like readme, adr, and system-architecture. It emits a structured report and exits with status 0 or 1.

Documentation drift occurs when docs fall out of sync with code. This Skill prevents drift by validating documentation updates across six dimensions for PRs and branches, generating a report, and exiting with 1 on failure for CI integration.

Yes, you can limit documentation validation to specific paths using scope-limiting. The Skill also supports story-id and PR-number filtering to restrict validation to relevant changes.

The documentation dimensions checked are readme, api, adr, skill-docs, system-architecture, and governance references. It maps changed files to these predefined dimensions to validate documentation updates.

To generate a validation report, run the detector on a PR or branch. It produces a structured report at a user-specified path or stdout, exiting with status 0 on pass and 1 on failure.

No dependencies are required to check documentation sync. The Skill applies project configuration to auto-detect targets and validates changed files against documentation dimensions independently.