---
applyTo:
  - "mediawiki/skins/**/*.mustache"
  - "mediawiki/skins/**/*.css"
  - "mediawiki/skins/**/*.less"
  - "mediawiki/extensions/**/*.php"
  - "mediawiki/extensions/**/*.js"
---

# Accessibility Rules For This Repository

Treat WCAG 2.1 AA as required and AAA as best effort.

## Required checks in code changes
- Use semantic elements for page landmarks and structure.
- Ensure all controls are keyboard operable.
- Keep visible focus indicators.
- Provide labels for form controls and clear error messages.
- Keep meaningful alt text on informative images.
- Avoid color-only communication.
- Maintain AA contrast ratios for text and UI components.

## Review behavior
- Call out WCAG failures with exact remediation.
- Prefer MediaWiki/Codex conventions over custom inaccessible patterns.
- Recommend tests for any UI change that can regress accessibility.