UX-010: WCAG 2.2 Level AA conformance¶
Statement¶
Every public surface of the platform shall conform to WCAG 2.2 Level AA. Conformance shall be verified by automated tooling on every pull request and by a manual audit before any release that introduces a new surface or significantly changes an existing one. Failures shall block release until remediated or explicitly waived with documented rationale.
Rationale¶
No accessibility pass has ever been done on this codebase. WCAG 2.2 AA is the standard baseline for accessible web applications, and treating it as table stakes for an OSS project that wants any kind of public adoption is the floor, anything less excludes users with disabilities and creates legal exposure for adopters.
Traceability¶
- IMPLEMENTS → CODE_FILE
shifter/shifter_platform/frontend/e2e/a11y/axe.spec.ts(per-PR automated WCAG 2.2 A/AA verification of registered surfaces) - IMPLEMENTS → CODE_FILE
scripts/adr_guard/_guard/checks/accessibility_baseline.py(exact-finding baseline ratchet with exact-fingerprint waivers) - IMPLEMENTS → CI
.github/workflows/deploy.yml(Accessibility PR Gate job) - IMPLEMENTS → GITHUB_ISSUE
Brad-Edwards/bigrae#1526(browser accessibility PR-tier gate) - TESTS → TEST
shifter/shifter_platform/frontend/src/test/a11y-surface-reconcile.test.ts(fail-closed surface reconciliation) - DOCUMENTS → GITHUB_ISSUE
Brad-Edwards/bigrae#2117(remaining ADR-055 tail: nightly matrix, deployed scans, WCAG-EM manual audit, and the release-evidence gate) - DOCUMENTS → ADR
docs/adr/index.yaml(ADR-055 continuous accessibility enforcement contract) - DOCUMENTS → DOCUMENTATION
docs/architecture/continuous-accessibility-enforcement-preflight-713.md(WCAG scope, manual-audit cadence, release evidence, triage, and waiver design) - DOCUMENTS → GITHUB_ISSUE
713(Architecture decision for continuous accessibility enforcement)