# 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

```bash
npm run a11y:all
```

Run after any template, style, or interaction change.