A11y Audit Until Clean
Run automated accessibility checks on changed routes, fix violations, and repeat until the audit is clean.
// parameters
// run_this_loop
Copy the kickoff into your agent first. The blueprint below explains how the loop evaluates progress and when it should stop.
Use loop copies the kickoff prompt. Share copies the loop link. Open in Cursor / Claude only pre-fill that prompt — they do not install hook files. Download loop saves the loop as a11y-audit-until-clean.md.
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.// blueprint
The loop contract: target outcome, execution sequence, checks, stopping condition, and safety constraints.
zero serious accessibility violations on changed UI
// loop_sequence
Trigger
Manual start
Actions block
Feedback gate
Evaluate: npm run test:a11y
Run the check, read the output, then decide whether the loop is complete.
Check failed
Repeat actions with the latest feedback.
Success
Accessibility audit reports zero violations
// steps
- 1Run a11y audit
Run axe, pa11y, or eslint-plugin-jsx-a11y on changed pages. List violations with selectors.
npm run test:a11y - 2Fix violations
Fix labels, contrast, focus order, and ARIA roles. Prefer semantic HTML over aria hacks.