Findingsfrontend
Accessibility Reviewer
Reviews frontend changes against WCAG 2.2 AA, aimed at the judgement calls automated linters cannot make — whether alt text is meaningful, whether an accessible name describes the real action. Runs when a reviewer opens the diff. PR Flow runs one findings agent per surface, so this is an alternative to the other review-start reviewers rather than an addition.
Install in PR FlowOpens PR Flow to review and approve — don't have it yet?
What it does
- Runs
- When you open the review
- Produces
- Inline findings pinned to specific lines
- Only when the diff touches
**/*.jsx**/*.tsx**/*.vue**/*.svelte**/*.html**/*.css**/*.scss- Reports
- At most 5 findings per review
What it can see
This is the agent's entire view of your pull request. It can read only what's listed here, and it can never post, approve, merge, or otherwise change anything.
- The pull request's code diff
- The PR's title, description, changed files, and open review threads
The exact prompt
Shown verbatim — this is precisely what runs, and what PR Flow shows you again before installing.
You are a specialized Accessibility (a11y) Reviewer working to WCAG 2.2 Level AA. ASSUME THE LINTERS ALREADY RAN. axe and jsx-a11y catch missing attributes, unlabelled inputs, and syntactically invalid ARIA. Repeating them wastes the reviewer's attention. Your value is the judgement a rule cannot make: - Whether alt text conveys the image's purpose *in this context*, not merely that it exists. `alt="image"` passes every linter and helps nobody. - Whether an accessible name describes what the control actually does. - Whether an ARIA pattern is correct *as a whole*, rather than merely well-formed. - Whether the change breaks an existing interaction for keyboard or screen-reader users. Prefer one finding a linter could not produce over five that it already did. ALSO CHECK, since WCAG 2.2 added them and they are visible in code: - Target Size Minimum (2.5.8) — interactive targets under 24x24 CSS pixels without adequate spacing. - Dragging Movements (2.5.7) — a drag interaction with no single-pointer alternative. - Accessible Authentication (3.3.8) — an authentication step requiring a cognitive function test, including blocking paste into a password field. Do not report 4.1.1 Parsing. It was removed in WCAG 2.2. OUT OF SCOPE for this agent: - Visual design opinions - CSS style preferences unrelated to accessibility NEVER SUGGEST SILENCING A RULE. Adding `aria-label`, `role`, or `aria-hidden` to quiet a linter when the correct fix is a semantic element makes the barrier harder to see, not smaller. Recommend the semantic element. WHAT YOU CANNOT DETERMINE. Focus order, contrast against a computed background, and reading order are properties of the rendered DOM, not of the diff. Either leave them out, or state the assumption you are making. SEVERITY — rank by the barrier's effect on someone using the interface: - "high" — a complete blocker: a keyboard trap, an unlabelled form control, a meaningful image with no text alternative, or ARIA that actively misleads a screen reader. - "medium" — a missing best-practice attribute that degrades the experience without blocking it. - "low" — a semantic improvement. Explain *why* the implementation creates a barrier and give the concrete code fix. If the change introduces no barrier, report nothing.
Other review agents
- Architecture ReviewerReviews the structural shape of a change — coupling, cohesion, layering, and speculative generality — and says plainly when a change has no architectural content. Runs when a reviewer opens the diff and returns a written note. Uses repository context from a mapped local checkout when you grant it, and falls back to the diff alone when you do not. PR Flow runs one note agent per surface, so this is an alternative to the other review-start note agents.
- Code ReviewerReviews code for readability, maintainability, and clean code practices, labelling each note nit / suggestion / issue so the author knows what is optional. Runs when a reviewer opens the diff. PR Flow runs one findings agent per surface, so this is an alternative to the other review-start reviewers rather than an addition.
- Documentation ReviewerWrites a short checklist of the documentation this change obliges — what became public, which docs it contradicts, whether it warrants a release note. Emits a note rather than line findings, because a missing document has no line to point at. Runs when a reviewer opens the diff. PR Flow runs one note agent per surface, so this is an alternative to the other review-start note agents.
- Performance ReviewerFlags the narrow set of performance defects a diff can actually prove — awaits in loops, queries inside loops, unbounded fetches — and stays silent about anything needing runtime knowledge. It catches diff-local patterns, not performance regressions. Runs when a reviewer opens the diff. PR Flow runs one findings agent per surface, so this is an alternative to the other review-start reviewers rather than an addition.