Skip to content

Commit f39b2ec

Browse files
committed
docs: add accessibility audit guidance
1 parent 15a6626 commit f39b2ec

1 file changed

Lines changed: 22 additions & 0 deletions

File tree

skills/agent-device/references/exploration.md

Lines changed: 22 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -120,6 +120,28 @@ agent-device screenshot /tmp/qa-proof.png
120120
agent-device close
121121
```
122122

123+
## Accessibility audit
124+
125+
Use this pattern when you need to find UI that is visible to a user but missing from the accessibility tree.
126+
127+
Audit loop:
128+
129+
1. Capture a `screenshot` to see what is visually rendered.
130+
2. Capture a `snapshot` or `snapshot -i` to see what the accessibility tree exposes.
131+
3. Compare the two:
132+
- visible in screenshot and present in snapshot: exposed to accessibility
133+
- visible in screenshot and missing from snapshot: likely accessibility gap
134+
4. If you suspect the node exists in AX but is filtered from interactive output, retry with `snapshot --raw`.
135+
136+
Example:
137+
138+
```bash
139+
agent-device screenshot /tmp/accessibility-screen.png
140+
agent-device snapshot -i
141+
```
142+
143+
Use `screenshot` as the visual source of truth and `snapshot` as the accessibility source of truth for this audit.
144+
123145
## Batch only when the sequence is already known
124146

125147
Use `batch` when a short command sequence is already planned and belongs to one logical screen flow.

0 commit comments

Comments
 (0)