Skip to content

Add accessibility-expert agentic workflow - #79

Merged
pelikhan merged 1 commit into
mainfrom
copilot/create-agentic-workflow
Aug 28, 2026
Merged

Add accessibility-expert agentic workflow#79
pelikhan merged 1 commit into
mainfrom
copilot/create-agentic-workflow

Conversation

Copilot AI commented Aug 28, 2026

Copy link
Copy Markdown
Contributor

Adds a scheduled agentic workflow that audits this repository's only web interface — the Astro docs site — for WCAG 2.2 A/AA accessibility barriers and files a single superseding issue with findings.

Workflow — .github/workflows/accessibility-expert.md

  • engine: pi, weekly schedule + workflow_dispatch (optional pages input), read-only permissions, timeout-minutes: 30, max-ai-credits: 400.
  • Playwright CLI (mode: cli) with a no-sandbox chromium config; network.allowed scoped to node/chrome/playwright/local.
  • safe-outputs limited to create-issue ([accessibility] prefix, close-older-key: accessibility-expert, max: 1), so repeat runs replace rather than accumulate reports.

Repository tailoring

  • Pre-agent steps build the docs site and vendor axe-core@4.13.0 via npm pack into .a11y/axe.min.js, so the agent fetches nothing at runtime behind the egress firewall.
  • The prompt derives the preview command and base path from package.json and astro.config.mjs instead of hard-coding a port — the docs site sets a non-root base.
  • Beyond axe-core, the agent covers checks automation can't: keyboard traversal and focus traps, focus visibility, heading/landmark structure, accessible names, contrast, 320px reflow, and prefers-reduced-motion; each page is visited in both light and dark schemes. Infrastructure blockers are reported separately from accessibility findings so a build failure doesn't masquerade as a clean audit.

Supporting changes

  • .github/workflows/accessibility-expert.lock.yml committed, plus the matching .gitignore negation required for workflows that actually run in this repo.
  • tests/unit/workflow-contract.test.mjs: added the lock to the clean-room expected list and a contract test pinning trigger, engine, Playwright CLI mode, axe-core pinning, WCAG scope, light/dark coverage, and the absence of any write safe output other than create-issue.

Note for reviewers

Frontmatter declares issues: read. That is deliberate — gh-aw grants issues: write to the generated safe_outputs job (lock lines 1101, 1915) while the agent job stays read-only.

Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>
Copilot AI requested a review from pelikhan August 28, 2026 11:02
@pelikhan
pelikhan marked this pull request as ready for review August 28, 2026 11:03
@pelikhan
pelikhan merged commit 7ecbbdc into main Aug 28, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants