Skip to content

Commit 6f86dcc

Browse files
accesswatchclaude
andauthored
docs(a11y): record the agent keyboard and visual runs (#275)
Adds an Agent runs section to the core-flow checks: real key presses in a real browser on tasks 1 to 4, which found no keyboard failures, and a contrast and reflow pass, whose dark-mode contrast findings were fixed in pull request 274. Per the document's own rule these are preparation, not results; the status table waits for a person's run. Claude-Session: https://claude.ai/code/session_01PmRBrUTuhzYnQBFxUCN6Vr Co-authored-by: Claude <noreply@anthropic.com>
1 parent fb48bab commit 6f86dcc

2 files changed

Lines changed: 56 additions & 2 deletions

File tree

‎admin/ACCESSIBILITY_CORE_FLOWS.md‎

Lines changed: 29 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -113,7 +113,35 @@ Reviewed by Claude (an AI coding agent) while adopting the Open Source Accessibi
113113

114114
Add each run below, newest first, using the blocks above. Link any issue you file, labeled `accessibility`.
115115

116-
No checks have been run yet.
116+
No checks by a person have been run yet.
117+
118+
## Agent runs
119+
120+
These runs were made by Claude (an AI agent) on the live site, with real key presses in a real browser. By the rule at the top of this document they are preparation, not results: they show what a person's run should find, and they caught one real defect, which is fixed. A person's run still has to be recorded under "Records" before the status table changes.
121+
122+
### Agent run: keyboard, tasks 1 to 4, 28 October 2026
123+
124+
Environment: Chromium in the Claude desktop app's browser pane, Windows, 1280 by 900 and 320 by 720 windows. Pages: the home page, Chapter 05, Chapter 07, the search results page for "merge conflict", and REGISTER.html.
125+
126+
- Every link and control was reached with Tab, and focus went right round each page and back to the browser: 65 stops on the home page, 222 on Chapter 05, 88 on the search results page, 80 on REGISTER.html. No keyboard trap, including through the audio player and the code blocks, which take focus so they can be scrolled.
127+
- Every stop matched `:focus-visible` and drew an outline. On the Quick Jumps links it is 1.6 pixels solid, 5.19:1 in light mode and 3.49:1 in dark mode.
128+
- Focus order follows the page: skip link, header, sidebar, then the main content from the top.
129+
- The skip link is the first stop; Enter on it moves to `#main-content`, and the next Tab lands in the main content.
130+
- Task 1: the page has Previous and Next links to Chapters 04 and 06.
131+
- Task 2: typing "merge conflict" in the search box and pressing Enter opened the results page, which announces "80 results found" in a live region; the first result, "Merge Conflicts", is the sixth Tab stop, and Enter on it opened Chapter 07.
132+
- Task 3: on the focused audio player, Space played and Space paused the Chapter 05 episode; the full transcript link is present.
133+
- Task 4: the enrollment link, "Begin the Adventure (opens in new tab)", is reached by Tab.
134+
- Task 5 was not run: the form is on GitHub and needs a signed-in account.
135+
136+
Result: no keyboard failures found.
137+
138+
### Agent run: manual visual checks, tasks 1 to 4, 28 October 2026
139+
140+
Same environment. Contrast was measured for every text element against its actual background colour, in light and dark mode.
141+
142+
- At a 320 CSS pixel wide window, all five pages reflow with no horizontal scrolling (only code blocks scroll inside themselves, which is allowed).
143+
- Contrast found text under 4.5:1: in dark mode the breadcrumb, the footer and every code block (as low as 1.18:1, because the light highlight theme was used on a dark background), and in light mode three highlight colours on the code background (3.28:1 to 4.3:1). Fixed in pull request 274; a re-scan of all 223 site pages in both modes finds nothing under 4.5:1.
144+
- Not checked: Windows High Contrast (forced colors), real browser zoom at 200%, and plain language, which need a person's judgement.
117145

118146
## Authoritative Sources
119147

‎html/admin/ACCESSIBILITY_CORE_FLOWS.html‎

Lines changed: 27 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -212,6 +212,9 @@ <h2 class="onpage-title">On This Page</h2>
212212
<li class="onpage-item"><a href="#documentation-checks">Documentation checks</a></li>
213213
<li class="onpage-item onpage-sub"><a href="#review-record-28-october-2026">Review record, 28 October 2026</a></li>
214214
<li class="onpage-item"><a href="#records">Records</a></li>
215+
<li class="onpage-item"><a href="#agent-runs">Agent runs</a></li>
216+
<li class="onpage-item onpage-sub"><a href="#agent-run-keyboard-tasks-1-to-4-28-october-2026">Agent run: keyboard, tasks 1 to 4, 28 October 2026</a></li>
217+
<li class="onpage-item onpage-sub"><a href="#agent-run-manual-visual-checks-tasks-1-to-4-28-october-2026">Agent run: manual visual checks, tasks 1 to 4, 28 October 2026</a></li>
215218
<li class="onpage-item"><a href="#authoritative-sources">Authoritative Sources</a></li>
216219
<li class="onpage-item onpage-sub"><a href="#section-level-source-map">Section-Level Source Map</a></li>
217220
</ul>
@@ -343,7 +346,30 @@ <h3 id="review-record-28-october-2026">Review record, 28 October 2026</h3>
343346
</ul>
344347
<h2 id="records">Records</h2>
345348
<p>Add each run below, newest first, using the blocks above. Link any issue you file, labeled <code>accessibility</code>.</p>
346-
<p>No checks have been run yet.</p>
349+
<p>No checks by a person have been run yet.</p>
350+
<h2 id="agent-runs">Agent runs</h2>
351+
<p>These runs were made by Claude (an AI agent) on the live site, with real key presses in a real browser. By the rule at the top of this document they are preparation, not results: they show what a person&#39;s run should find, and they caught one real defect, which is fixed. A person&#39;s run still has to be recorded under &quot;Records&quot; before the status table changes.</p>
352+
<h3 id="agent-run-keyboard-tasks-1-to-4-28-october-2026">Agent run: keyboard, tasks 1 to 4, 28 October 2026</h3>
353+
<p>Environment: Chromium in the Claude desktop app&#39;s browser pane, Windows, 1280 by 900 and 320 by 720 windows. Pages: the home page, Chapter 05, Chapter 07, the search results page for &quot;merge conflict&quot;, and REGISTER.html.</p>
354+
<ul>
355+
<li>Every link and control was reached with Tab, and focus went right round each page and back to the browser: 65 stops on the home page, 222 on Chapter 05, 88 on the search results page, 80 on REGISTER.html. No keyboard trap, including through the audio player and the code blocks, which take focus so they can be scrolled.</li>
356+
<li>Every stop matched <code>:focus-visible</code> and drew an outline. On the Quick Jumps links it is 1.6 pixels solid, 5.19:1 in light mode and 3.49:1 in dark mode.</li>
357+
<li>Focus order follows the page: skip link, header, sidebar, then the main content from the top.</li>
358+
<li>The skip link is the first stop; Enter on it moves to <code>#main-content</code>, and the next Tab lands in the main content.</li>
359+
<li>Task 1: the page has Previous and Next links to Chapters 04 and 06.</li>
360+
<li>Task 2: typing &quot;merge conflict&quot; in the search box and pressing Enter opened the results page, which announces &quot;80 results found&quot; in a live region; the first result, &quot;Merge Conflicts&quot;, is the sixth Tab stop, and Enter on it opened Chapter 07.</li>
361+
<li>Task 3: on the focused audio player, Space played and Space paused the Chapter 05 episode; the full transcript link is present.</li>
362+
<li>Task 4: the enrollment link, &quot;Begin the Adventure (opens in new tab)&quot;, is reached by Tab.</li>
363+
<li>Task 5 was not run: the form is on GitHub and needs a signed-in account.</li>
364+
</ul>
365+
<p>Result: no keyboard failures found.</p>
366+
<h3 id="agent-run-manual-visual-checks-tasks-1-to-4-28-october-2026">Agent run: manual visual checks, tasks 1 to 4, 28 October 2026</h3>
367+
<p>Same environment. Contrast was measured for every text element against its actual background colour, in light and dark mode.</p>
368+
<ul>
369+
<li>At a 320 CSS pixel wide window, all five pages reflow with no horizontal scrolling (only code blocks scroll inside themselves, which is allowed).</li>
370+
<li>Contrast found text under 4.5:1: in dark mode the breadcrumb, the footer and every code block (as low as 1.18:1, because the light highlight theme was used on a dark background), and in light mode three highlight colours on the code background (3.28:1 to 4.3:1). Fixed in pull request 274; a re-scan of all 223 site pages in both modes finds nothing under 4.5:1.</li>
371+
<li>Not checked: Windows High Contrast (forced colors), real browser zoom at 200%, and plain language, which need a person&#39;s judgement.</li>
372+
</ul>
347373
<h2 id="authoritative-sources">Authoritative Sources</h2>
348374
<p>Use these official references when you need the current source of truth for facts in this document.</p>
349375
<ul>

0 commit comments

Comments
 (0)