Documentation
Agent-readiness rules.
Every check the audit runs, documented: what it tests, why it matters, and the exact markup that fixes it.
Critical — blocks agents from completing a task
Content must render without JavaScript
The page must expose meaningful text even when scripts do not run or hydration is slow.
Checks: Read content without JavaScript
Label every form field
Fields need an accessible name so agents know what to enter — and so autofill works.
Checks: Identify form fields
Every page needs a <title>
A descriptive document title is how agents confirm they landed on the right page.
Checks: Find the page topic
Warning — slows or confuses automation
Name every button
Buttons need visible text or an aria-label so agents know what action they trigger.
Checks: Understand every button
Describe every image
Alt text carries the meaning of an image into the agent’s text-only view of the page.
Checks: Describe every image
No pointer-only interactions
Anything revealed on hover must also be reachable by keyboard and visible to agents.
Checks: Act without hover
One main landmark, one h1
A single <main> and a single h1 give agents a clean entry point for reading the page.
Checks: Parse page structure
Real, readable link destinations
Links need text that says where they go — and hrefs that are real, not placeholders.
Checks: Follow link destinations
Optimization — polish that raises trust
Curious which rules your site trips?
Run the real thing. Each rule on this page links to the code and markup that fixes it.