chore: release v1.1.0 - add Support Team Guide and User Guide, update all docs to v1.1.0
This commit is contained in:
73
modes/accessibility-auditor/rules/4_decision_guidance.xml
Normal file
73
modes/accessibility-auditor/rules/4_decision_guidance.xml
Normal file
@@ -0,0 +1,73 @@
|
||||
<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>
|
||||
Reference in New Issue
Block a user