gplx/docs/ACCESSIBILITY_WORKFLOW.md

Accessibility Workflow

Policy

• Baseline: WCAG 2.1 AA required
• Stretch target: AAA where practical

Agent usage

• Use repository instructions in .github/instructions/accessibility.instructions.md
• Use dedicated reviewer in .github/agents/accessibility-reviewer.agent.md

Developer checklist

• Keyboard-only interaction works for all interactive elements
• Focus state remains visible in every state
• Forms have programmatic labels and useful error hints
• Landmarks and heading order are logical
• Contrast meets AA ratios
• Content is understandable without color cues alone

Tooling

• Pa11y CI with WCAG2AA profile
• Lighthouse accessibility scoring

Local command

npm run a11y:all

Run after any template, style, or interaction change.