Files
Daniel Avila 41ac74eaf7 improve: enhance accessibility-tester agent based on automated review (#741)
* improve: enhance accessibility-tester agent based on automated review

- Fix broken automated-scan command: npx axe-core-cli -> npx @axe-core/cli --exit (with WCAG tag flag guidance)
- Correct inaccurate legal-compliance framing; map each framework to its actual referenced WCAG version (Section 508 -> 2.0 AA, ADA Title II/III -> 2.1 AA, EAA/EN 301 549 -> approx 2.1 AA)
- Add Track 1b: scripted keyboard/focus/ARIA-state testing via @axe-core/playwright
- Qualify the automated-coverage statistic (30-40% industry-wide, axe-core ~57%) instead of an unqualified 40%
- Note WCAG 3.0 is still a W3C Working Draft, not expected before ~2029

Automated review cycle | Co-Authored-By: Claude Code <noreply@anthropic.com>

* address review feedback: fix missing AxeBuilder import, stale frontmatter examples

- Add missing `import { AxeBuilder } from '@axe-core/playwright'` to the
  Track 1b code snippet so it's copy-pasteable
- Update the frontmatter description's second example to drop a now-past
  "EAA June 2025 deadline" reference and match the per-framework WCAG
  version mapping already used in the body

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01LsDjHUg19zLAPpSYuQxH5A

* fix: add missing assertion to Track 1b Playwright example

The snippet collected axe results but never asserted on them, so a
copied test would exit 0 regardless of violations found.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01LsDjHUg19zLAPpSYuQxH5A

* fix: expand Track 1b withTags to full WCAG 2.0/2.1/2.2 scope

withTags(['wcag22aa']) only activated the 9 new WCAG 2.2 criteria,
silently skipping the WCAG 2.0/2.1 rules that Track 1 already covers
via --tags wcag2a,wcag2aa,wcag21aa,wcag22aa. Align the two tracks.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01LsDjHUg19zLAPpSYuQxH5A

* fix: add missing wcag21a tag to accessibility scan commands

The --tags/withTags lists omitted wcag21a (WCAG 2.1 Level A), causing
axe-core to skip rules like Character Key Shortcuts, Pointer Gestures,
Pointer Cancellation, Label in Name, and Motion Actuation. Applied to
both Track 1 (@axe-core/cli) and Track 1b (@axe-core/playwright).

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01LsDjHUg19zLAPpSYuQxH5A

---------

Co-authored-by: Claude <noreply@anthropic.com>
2026-07-20 10:07:33 -04:00
..