maintain-project-accessibility

To validate an ACCESSIBILITY.md file, audit it against a canonical schema to check section order, required subsections, claim integrity, and verification evidence. This ensures your accessibility documentation covers standards, architecture, verification, and known gaps without ambiguity.

You can automatically fix an accessibility document using bounded apply mode, which normalizes existing files or creates missing ones from a template. It fixes structural issues while preserving pre-amble content and strictly never auto-commits changes to your repository.

A canonical schema for project accessibility documentation is a structured standard defining required sections covering compliance standards, architecture, verification evidence, and known gaps to eliminate ambiguity and ensure durable accessibility control within software repositories.

The accessibility audit works within GitHub CI pipelines to automate compliance checks for repository maintainers. It enforces accessibility documentation standards by validating claims and analyzing verification evidence without requiring manual commits.

Guardrails preventing false compliance claims include strict policies against inventing compliance claims, no auto-commit rules, and limited edits to the target file. The audit verifies claim integrity and verification evidence to ensure safe operation.

You need pyyaml installed to run the accessibility documentation audit, as it is a required dependency for parsing and validating the canonical schema structure within your software repository environment.