Design System Accessibility and WCAG Remediation Audit
Conduct a technical accessibility audit on web UI design systems against WCAG standards to remediate compliance defects.
Use this template when evaluating web UI component libraries for keyboard accessibility, ARIA semantics, and screen reader compatibility. It delivers a structured engineering remediation report prioritized by severity.
Role: Principal Accessibility Engineer and Design System Architect specializing in WCAG standards, ARIA authoring practices, and assistive tech compatibility.
Context
- Design system library: {{design_system_name}}
- Component library scope: {{ui_component_scope}}
- Target screen reader & browser pairings: {{assistive_tech_targets}}
- Compliance threshold: {{wcag_conformance_target}}
- Critical keyboard navigation defects: {{known_keyboard_blockers}}
- Theme color tokens: {{color_contrast_standard}}
Task
Author a comprehensive Design System Accessibility Compliance Report for {{design_system_name}}, auditing components across {{ui_component_scope}} and detailing code-level fixes to satisfy {{wcag_conformance_target}}.
Method
- Evaluate current DOM structures in {{ui_component_scope}} against WAI-ARIA 1.2 authoring patterns.
- Trace focus management behaviors to resolve {{known_keyboard_blockers}} across modal, dropdown, and composite widgets.
- Validate semantic markup and live region announcements across {{assistive_tech_targets}}.
- Audit {{color_contrast_standard}} across all active UI states (focus visible, active, hover, disabled).
- Identify missing accessibility API bindings, incorrect role definitions, and orphaned label elements.
- Draft reusable code patches for compound components requiring focus traps or roving tabindex.
- Create regression testing recipes combining automated axe-core rules with manual assistive tooling checks.
Constraints
- MUST reference specific WCAG Success Criteria numbers (e.g., 2.1.1, 4.1.2) for every violation.
- MUST NOT recommend dropping custom components for unstyled native controls if standard ARIA patterns can resolve the defect.
- Code examples MUST include both semantic HTML markup and corresponding keyboard interaction handlers.
- Maintain full consistency with {{color_contrast_standard}} tokens.
Output format
- Compliance Status Overview (conformance level summary table)
- Component-by-Component Defect Log (Component, Failure, WCAG SC, Remediation snippet)
- Focus Management & ARIA Patterns Reference (maximum 3 comprehensive code blueprints)
- Automated & Manual QA Verification Protocol (numbered checklist under 300 words)
Self-review
- Are all {{known_keyboard_blockers}} addressed with specific focus handling patterns?
- Does every flagged defect map to a verified {{wcag_conformance_target}} clause?
- Are assistive technology behaviors verified for {{assistive_tech_targets}}?
Explicit role, a named task, and discrete steps the model can follow.
Background, inputs and variables the model needs before it starts.
Hard boundaries — what the model must and must not do.
A named, field-level shape for the response.
Ordered work items that force analysis before an answer.
Length and structure that travel across frontier models.
Signal density — instruction weight without padding.
Documented variables so the scaffold adapts to new inputs.
Quality bar, assumptions and behaviour when inputs are thin.
How much real usage the template has behind it.