Repository navigation
RELEASE 5.3.0
Accessibility Agents 5.3 focuses on reliability hardening in CI and release operations for markdown accessibility workflows.
This release improves regression gating, schema validation visibility, release consistency enforcement, and documentation coverage for the new controls.
markdown-a11y-lint.mjs now supports regression mode in CI and CLI:
--regression--baseline-ref <git-ref>
When enabled, only markdown files changed since the baseline ref are scanned for gate decisions. If git diff is unavailable, the scanner safely falls back to full scan behavior.
.a11y-markdown-config.json is now validated at load time.
Validation warnings are emitted for unknown keys and invalid field types, while keeping scans non-blocking.
A dedicated schema is now included:
.github/schemas/markdown-config.schema.json
This documents valid config structure and supports editor validation/intellisense.
a11y-check.yml now includes markdown SARIF upload to GitHub Code Scanning and supports reliable execution for clean/no-output scenarios.
The markdown lint job also supports:
- dispatch-time mode controls
- repository variable controls
- regression mode controls
New workflow:
.github/workflows/release-consistency-guard.yml
It enforces:
- version alignment across release manifests
- required
CHANGELOG.mdentry for the current version
Missing CHANGELOG coverage now fails the workflow.
Added and integrated:
-
scripts/test-markdown-scanner.mjs(expanded coverage) scripts/test-orchestrator-validator.mjs
CI now runs these suites in validate-orchestrator-contracts.yml to catch regressions earlier.
Updated docs for 5.3 controls and behavior:
docs/USER_GUIDE.mddocs/getting-started.mdprd.mdENHANCEMENTS.md
VS Code config now includes JSON schema mappings for markdown, office, and PDF scan config files.
No migration is required for existing users.
Recommended follow-up:
- Set repository variables for markdown gating defaults:
A11Y_MARKDOWN_FAIL_ONA11Y_MARKDOWN_FORMATA11Y_REGRESSION_MODE
- Add or refresh
.a11y-markdown-config.jsonfromtemplates/markdown-config-moderate.json - Verify
release-consistency-guard.ymlpasses before tagging releases
See CHANGELOG.md for full details of 5.3.0 changes.
- Agents Overview
- Accessibility Lead
- Web Accessibility Wizard
- Document Accessibility Wizard
- Markdown Assistant
- Developer Hub
- GitHub Hub