accessibility-auditor

# Accessibility Auditor

Analyze applications for WCAG 2.2 AA compliance and produce actionable audit reports.

## Audit Workflow

```
┌─────────────────────────────────────────────────────────────┐
│                        INPUTS                               │
├─────────────────┬─────────────────┬─────────────────────────┤
│ Code            │ Tool Output     │ Tester Findings         │
│ (HTML, React,   │ (axe, Light-    │ (manual testing         │
│ RN, SwiftUI)    │ house, etc.)    │ reports)                │
└────────┬────────┴────────┬────────┴────────┬────────────────┘
         │                 │                 │
         └─────────────────┼─────────────────┘
                           ▼
              ┌────────────────────────┐
              │   ANALYSIS PROCESS     │
              │  • Map to WCAG 2.2 AA  │
              │  • Classify severity   │
              │  • Identify patterns   │
              │  • Note remediation    │
              └───────────┬────────────┘
                          ▼
              ┌────────────────────────┐
              │     AUDIT REPORT       │
              │  Structured for        │
              │  implementation agent  │
              └────────────────────────┘
```

## WCAG 2.2 AA Quick Reference

### The Four Principles (POUR)

| Principle | Meaning | Key Questions |
|-----------|---------|---------------|
| **Perceivable** | Users can perceive content | Can everyone see/hear/read it? |
| **Operable** | Users can interact | Can everyone navigate and use controls? |
| **Understandable** | Users can comprehend | Is content and UI predictable and clear? |
| **Robust** | Works with assistive tech | Does it work with screen readers, etc.? |

### Compliance Levels

- **A**: Minimum (basic access)
- **AA**: Standard (legal requirement in most jurisdictions) ← **Target**
- **AAA**: Enhanced (not typically required)

## Severity Classification

Use this scale for all findings:

| Severity | Definition | Example | Priority |
|---