34 lines
778 B
Markdown
34 lines
778 B
Markdown
# 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.
|