references/accessibility.md

# Accessibility verification

Use official W3C WCAG 2.2 guidance: https://www.w3.org/TR/WCAG22/ and https://www.w3.org/WAI/WCAG22/Understanding/ . Do not claim compliance solely from an axe or Lighthouse result.

Audit meaningful keyboard access and focus management (including dialogs), semantic role/name/value/state, headings, forms/validation instructions/errors, dynamic announcements, contrast, text resizing/reflow, reduced motion and supported assistive-tech workflows. Record applicability, test browser/AT and steps.

Some issues require manual observation: focus order and restoration, practical screen-reader announcements, logical reading order and complete tasks. Tag automated vs manual outcomes. Accessibility blockers should reflect actual impact on core journeys.