@appfire-ux/audit-agent
v0.20260709.0
Published
Claude Code audit agents for Appfire apps — ux-auditor (/ux-audit), ui-auditor (/ui-audit), a11y-auditor (/a11y-audit), /full-audit parallel orchestration. VPAT/ACR drafting: install @appfire-ux/vpat-agent separately.
Maintainers
Readme
@appfire-ux/audit-agent
One-command install of three Claude Code audit agents for Appfire repos. Every audit run refreshes both npm packages to @latest (Phase 0):
@appfire-ux/audit-agent— agent/command definitions in.claude/@appfire-ux/guidelines— rules, skills, andguidelines/kit
Agents:
- ux-auditor (
/ux-audit) — guideline-compliance UX audit: design tokens, spacing/typography, accessibility, UX writing, messaging patterns, persona fit. - ui-auditor (
/ui-audit) — UI & usability audit from a UI Designer's perspective: cross-screen consistency, layout & visual hierarchy, information architecture, navigation, interaction design, forms, data-dense views, responsiveness. Screenshot-driven (browser MCP or bundled Playwright fallback). - a11y-auditor (
/a11y-audit) — deep accessibility audit: WCAG 2.2 A/AA, axe-core scans, static four-principles code audit, JSON datapoints for VPAT. Strict no-over-claiming language.
VPAT/ACR drafting is a separate package: @appfire-ux/vpat-agent — install for /vpat-audit (full VPAT pipeline with mandatory UI URL).
Install
npm install -D @appfire-ux/audit-agentFor VPAT/ACR in the same repo:
npm install -D @appfire-ux/vpat-agent @appfire-ux/guidelines
npx @appfire-ux/vpat-agentOpen Claude Code:
/full-audit # UX + UI + A11Y in parallel; VPAT post-sequence via @appfire-ux/vpat-agent (default)
/vpat-audit --url https://localhost:5173 # VPAT-only (requires @appfire-ux/vpat-agent)What gets installed
| File | Purpose |
|------|---------|
| .claude/agents/ux-auditor.md | Guideline-compliance audit |
| .claude/commands/ux-audit.md | /ux-audit |
| .claude/agents/ui-auditor.md | UI & usability audit |
| .claude/commands/ui-audit.md | /ui-audit |
| .claude/agents/a11y-auditor.md | Accessibility audit → JSON for VPAT |
| .claude/commands/a11y-audit.md | /a11y-audit |
| .claude/commands/full-audit.md | /full-audit parallel orchestration |
| scripts/ux-audit-capture.mjs | Playwright screenshot fallback |
| scripts/a11y-audit-scan.mjs | Playwright + axe-core scanner |
| scripts/build-html-reports.mjs | MD → Confluence-ready HTML |
VPAT agents, CRUX template, and /vpat-audit live in @appfire-ux/vpat-agent.
Publishing (maintainers)
Pushes to main touching appfire-ux-audit-agent/** or canonical UX/UI/A11Y files run .github/workflows/publish-audit-agent.yml.
VPAT package: .github/workflows/publish-vpat-agent.yml.
