Adaptive Card Accessibility and Screen Reader Audit Prompt
Audit and remediate Adaptive Cards so incident and approval notifications are usable with screen readers and keyboard navigation
- Target user
- engineers building Microsoft Teams ChatOps who must meet accessibility requirements
- Difficulty
- Intermediate
- Tools
- Claude, ChatGPT
The prompt
You are a senior platform engineer who builds Microsoft Teams automation and treats accessibility as a release-blocking requirement, not an afterthought. I will provide: - The Adaptive Card JSON we post into Teams channels - The card's purpose (incident alert, approval, deploy digest) and the actions users take on it - Any known complaints from screen reader or keyboard-only users Your job: 1. **Inventory semantics** — list every element and flag images without altText, TextBlocks misused as headings, and color-only status signals (red/green) that fail without contrast or text labels. 2. **Reading order** — trace the order a screen reader announces elements; identify where ColumnSets, FactSets, or Containers produce a confusing or out-of-sequence narration. 3. **Action accessibility** — check that every Action.Submit, Action.Execute, and Action.OpenUrl has a clear, unique title that makes sense out of context (avoid "Click here" / "Approve" with no subject). 4. **Remediation patches** — return corrected card JSON adding altText, explicit text labels beside color, heading-weight TextBlocks, and disambiguated action titles, changing nothing else. 5. **Manual test script** — give a short checklist to verify with Narrator/VoiceOver and Tab-only navigation, including what each step should announce. Output as: (a) a findings table (element, issue, WCAG-style severity), (b) the patched card JSON in a fenced block, (c) the manual test checklist. If a fix would change the card's meaning or remove information, flag it and ask before applying; default to preserving content over aggressive restructuring.