GitHub + Slack + Jira integration
a11y-github-app
A GitHub App webhook service for WCAG 2.2 AA PR reviews, issue audits, Slack-triggered scans, Jira ticket creation, and AI-assisted accessibility fix workflows.
Github App
a11y-github-app is the integration layer of the a11y-engine ecosystem. It listens to GitHub pull request, issue, and issue comment events, verifies webhooks, parses commands, creates Check Runs, and dispatches GitHub Actions workflows to a dedicated runner repository.
The runner performs DOM audits with axe, CDP, and pa11y, runs source-pattern analysis, caches findings by head SHA, and posts signed callbacks. The app then updates PR or issue comments with severity-sorted findings, WCAG metadata, selectors, source-pattern issues, and quick-fix commands.
For remediation, users can trigger `/a11y-fix` from GitHub or Slack. The fix workflow restores cached findings, asks Claude to generate scoped patches from engine guidance, uses git checkpointing per finding, verifies DOM fixes by re-running targeted audits, commits passing changes to a new branch, and opens a fix PR.
What it does
- Posts GitHub PR and issue comments with available `/a11y-audit` and `/a11y-fix` commands.
- Creates and updates GitHub Check Runs for audit and fix status visibility.
- Dispatches DOM audit, source-only audit, and automated fix workflows to a runner repository.
- Runs axe, CDP, pa11y, and source-pattern scans through a11y-engine-backed workflows.
- Supports Slack slash commands, progress updates, Fix All actions, and result messages.
- Creates Jira tickets from Slack audit findings when Jira Cloud credentials are configured.
- Uses git checkpointing and targeted re-audits so one failed AI patch does not discard earlier successful fixes.