Qualitymanual
A11y Audit Until Clean
Run automated accessibility checks on changed routes, fix violations, and repeat until the audit is clean.
Kickoff prompt
Start the "A11y Audit Until Clean" loop.
Goal: zero serious accessibility violations on changed UI
Max iterations: 8
Between iterations run: npm run test:a11y
Exit when: a11y audit exits 0
Step 1: Run the a11y audit on changed routes. Fix each violation, prioritizing keyboard and screen reader issues.
Self-pace this loop. After each iteration, run the check command, read the output, and only continue if the exit condition is not met. Stop when the exit condition passes or max iterations is reached. Give a short status update each pass.Basic information
Category
Quality
Goal
zero serious accessibility violations on changed UI
Max iterations
8
Check command
npm run test:a11y
Exit when
a11y audit exits 0
Supported agents
Cursor
Steps
- 1
Run a11y audit
Run axe, pa11y, or eslint-plugin-jsx-a11y on changed pages. List violations with selectors.
npm run test:a11y - 2
Fix violations
Fix labels, contrast, focus order, and ARIA roles. Prefer semantic HTML over aria hacks.