73 lines
2.4 KiB
XML
73 lines
2.4 KiB
XML
|
<decision_guidance>
|
||
|
|
# Accessibility Auditor Decision Guidance
|
||
|
|
|
||
|
|
## When to Use Each Skill
|
||
|
|
|
||
|
|
### wcag-compliance-checker
|
||
|
|
- **Use when:** Auditing any content for accessibility compliance
|
||
|
|
- **Use when:** Preparing content for publication
|
||
|
|
- **Skip when:** Content has already been audited and remediated
|
||
|
|
|
||
|
|
### screen-reader-simulator
|
||
|
|
- **Use when:** Testing interactive content
|
||
|
|
- **Use when:** Verifying navigation and reading order
|
||
|
|
- **Skip when:** Content is purely static text with proper semantic markup
|
||
|
|
|
||
|
|
### color-contrast-analyzer
|
||
|
|
- **Use when:** Reviewing visual design elements
|
||
|
|
- **Use when:** Checking text and background color combinations
|
||
|
|
- **Skip when:** Content has already passed contrast checks
|
||
|
|
|
||
|
|
### cognitive-accessibility-checker
|
||
|
|
- **Use when:** Reviewing content clarity and comprehension
|
||
|
|
- **Use when:** Evaluating navigation complexity
|
||
|
|
- **Skip when:** Content is already optimized for cognitive accessibility
|
||
|
|
|
||
|
|
### remediation-advisor
|
||
|
|
- **Use when:** After identifying accessibility issues
|
||
|
|
- **Use when:** Creating remediation plans
|
||
|
|
- **Skip when:** No issues have been identified yet
|
||
|
|
|
||
|
|
## Severity Classification
|
||
|
|
|
||
|
|
### Critical (Must Fix)
|
||
|
|
- Blocks access to content or functionality
|
||
|
|
- Affects core WCAG A/AA success criteria
|
||
|
|
- Examples: Missing alt text on informative images, keyboard traps, no form labels
|
||
|
|
|
||
|
|
### Major (Should Fix)
|
||
|
|
- Significantly impairs access but not a complete block
|
||
|
|
- Affects WCAG AA success criteria
|
||
|
|
- Examples: Poor contrast, missing headings, confusing focus order
|
||
|
|
|
||
|
|
### Minor (Nice to Fix)
|
||
|
|
- Minor inconvenience to users with disabilities
|
||
|
|
- Affects WCAG AAA or best practices
|
||
|
|
- Examples: Suboptimal alt text, minor color contrast issues
|
||
|
|
|
||
|
|
## Compliance Level Decisions
|
||
|
|
|
||
|
|
### Level A (Minimum)
|
||
|
|
- Essential accessibility features
|
||
|
|
- Required for basic access
|
||
|
|
- Target for all content
|
||
|
|
|
||
|
|
### Level AA (Standard)
|
||
|
|
- Comprehensive accessibility
|
||
|
|
- Required by most regulations
|
||
|
|
- Target for most educational content
|
||
|
|
|
||
|
|
### Level AAA (Enhanced)
|
||
|
|
- Highest level of accessibility
|
||
|
|
- Not always achievable for all content
|
||
|
|
- Target for content serving diverse disability populations
|
||
|
|
|
||
|
|
## Trade-offs to Consider
|
||
|
|
|
||
|
|
| Decision | Benefit | Cost |
|
||
|
|
|----------|---------|------|
|
||
|
|
| Stricter compliance | Better access for more users | More development effort |
|
||
|
|
| Automated-only testing | Faster audit | Misses ~70% of issues |
|
||
|
|
| Manual testing | Comprehensive results | Time-intensive |
|
||
|
|
| Progressive remediation | Prioritized fixes | May leave some users behind |
|
||
|
|
</decision_guidance>
|