clawfort/openspec/specs/wcag-2-2-aa-accessibility/spec.md

Purpose

Canonical specification for wcag-2-2-aa-accessibility requirements synced from OpenSpec change deltas.

Requirements

Requirement: Core user flows comply with WCAG 2.2 AA baseline

The system SHALL meet WCAG 2.2 AA accessibility requirements for primary interactions and content presentation, including icon-only controls and policy-disclosure modals, and SHALL verify compliance through automated accessibility checks in CI.

Scenario: Keyboard-only interaction flow

• WHEN a keyboard-only user navigates policy modals and icon-only controls
• THEN all primary interactive elements are reachable and operable
• AND visible focus indication is present at each step

Scenario: Contrast and non-text alternatives

• WHEN users consume text and non-text UI content
• THEN color contrast meets AA thresholds for relevant text and controls
• AND icon-only controls expose meaningful accessible labels

Scenario: Accessibility CI gate

• WHEN pull request validation runs
• THEN automated accessibility checks execute against key pages and flows
• AND violations above configured severity fail the gate