[IMPORTANT] Use

TaskCreate

to break ALL work into small tasks BEFORE starting — including tasks for each file read. This prevents context loss from long files. For simple tasks, AI MUST ATTENTION ask user whether to skip.

Critical Thinking Mindset — Apply critical thinking, sequential thinking. Every claim needs traced proof, confidence >80% to act. Anti-hallucination: Never present guess as fact — cite sources for every claim, admit uncertainty freely, self-check output for errors, cross-reference independently, stay skeptical of own confidence — certainty without evidence root of all hallucination.

AI Mistake Prevention — Failure modes to avoid on every task:

• Check downstream references before deleting. Deleting components causes documentation and code staleness cascades. Map all referencing files before removal.
• Verify AI-generated content against actual code. AI hallucinates APIs, class names, and method signatures. Always grep to confirm existence before documenting or referencing.
• Trace full dependency chain after edits. Changing a definition misses downstream variables and consumers derived from it. Always trace the full chain.
• Trace ALL code paths when verifying correctness. Confirming code exists is not confirming it executes. Always trace early exits, error branches, and conditional skips — not just happy path.
• When debugging, ask "whose responsibility?" before fixing. Trace whether bug is in caller (wrong data) or callee (wrong handling). Fix at responsible layer — never patch symptom site.
• Assume existing values are intentional — ask WHY before changing. Before changing any constant, limit, flag, or pattern: read comments, check git blame, examine surrounding code.
• Verify ALL affected outputs, not just the first. Changes touching multiple stacks require verifying EVERY output. One green check is not all green checks.
• Holistic-first debugging — resist nearest-attention trap. When investigating any failure, list EVERY precondition first (config, env vars, DB names, endpoints, DI registrations, data preconditions), then verify each against evidence before forming any code-layer hypothesis.
• Surgical changes — apply the diff test. Bug fix: every changed line must trace directly to the bug. Don't restyle or improve adjacent code. Enhancement task: implement improvements AND announce them explicitly.
• Surface ambiguity before coding — don't pick silently. If request has multiple interpretations, present each with effort estimate and ask. Never assume all-records, file-based, or more complex path.

Quick Summary

Goal: Review UI code for WCAG 2.2 accessibility, Core Web Vitals performance, and modern web design best practices.

Workflow:

1. Identify Target — Use provided file/pattern or ask user which components to review
2. Scan Files — Read and Grep target files for violation patterns
3. Check Categories — Accessibility, keyboard nav, forms, animation, performance, touch/mobile, content, dark mode/i18n
4. Report Findings — Group by file, use

   file:line

   format, terse findings, prioritized summary

Key Rules:

• Review-only skill: finds issues, does NOT fix them
• Check categories in priority order (accessibility first)
• Also reference

  docs/project-reference/scss-styling-guide.md

  if available (content auto-injected by hook — check for [Injected: ...] header before reading)

Be skeptical. Apply critical thinking, sequential thinking. Every claim needs traced proof, confidence percentages (Idea should be more than 80%).

Web Design Guidelines Review

Review UI code for compliance with WCAG 2.2, Core Web Vitals, and modern web design best practices. This is a review-only skill -- it finds issues, not fixes them.

When to Use

• Reviewing UI code for accessibility compliance before release
• Auditing a component or page for WCAG 2.2 violations
• Checking Core Web Vitals performance patterns in code
• Validating responsive design and mobile-friendly patterns
• Pre-PR UI quality gate check

When NOT to Use

• Building UI -- use

  frontend-design

• Creating design specs -- use

  design-spec

• Full UX design process -- use

  ux-designer

• Project SCSS review -- also check

  docs/project-reference/scss-styling-guide.md

Prerequisites

• Full guidelines reference:

  references/guidelines.md

• Project SCSS:

  docs/project-reference/scss-styling-guide.md

  (if available)

Workflow

1. Identify target files

   • IF file/pattern argument provided → use it
   • IF not → ask user which files or components to review

2. Scan files using Read and Grep tools

3. Check against categories (in priority order):

   • Accessibility -- semantic HTML, ARIA, labels, alt text, color contrast, focus indicators
   • Keyboard navigation -- tab order, focus trap in modals, escape key handling
   • Forms -- labels, validation, error display, autocomplete, paste not blocked
   • Animation --

     prefers-reduced-motion

     respected, no

     transition: all

     , GPU-safe properties only
   • Performance -- image dimensions set, lazy loading, no layout thrashing, virtualization for large lists
   • Touch/Mobile -- touch targets >= 44px,

     touch-action: manipulation

     , safe areas
   • Content -- text overflow handled, empty states, responsive breakpoints
   • Dark mode / i18n --

     color-scheme

     , logical CSS properties,

     Intl.*

     formatters

4. Report findings in output format below

Output Format

Group by file. Use

file:line

## src/components/Button.tsx

src/components/Button.tsx:42 - icon button missing aria-label
src/components/Button.tsx:55 - animation missing prefers-reduced-motion check
src/components/Button.tsx:67 - transition: all -> list specific properties
src/components/Button.tsx:89 - div with onClick -> use <button>

## src/components/Modal.tsx

src/components/Modal.tsx:12 - missing overscroll-behavior: contain
src/components/Modal.tsx:78 - no focus trap for modal dialog

## src/components/Card.tsx

[check] No issues found

## Summary

- 4 accessibility issues
- 2 performance issues
- 1 UX issue
- Priority: Fix accessibility issues first (WCAG compliance)

Examples

Example 1: Accessibility review

Input: "Review the user profile component for accessibility"

Action: Read component file, check for semantic HTML, ARIA attributes, label associations, color contrast patterns, keyboard navigation, focus indicators. Report each violation with file:line.

Example 2: Visual polish review

Input: "Check the dashboard page for design best practices"

Action: Scan for animation performance (no

transition: all

Related Skills

frontend-design

design-spec

ux-designer

Closing Reminders

• IMPORTANT MUST ATTENTION break work into small todo tasks using

  TaskCreate

  BEFORE starting
• IMPORTANT MUST ATTENTION search codebase for 3+ similar patterns before creating new code
• IMPORTANT MUST ATTENTION cite

  file:line

  evidence for every claim (confidence >80% to act)
• IMPORTANT MUST ATTENTION add a final review todo task to verify work quality <!-- SYNC:critical-thinking-mindset:reminder -->
• MUST ATTENTION apply critical thinking — every claim needs traced proof, confidence >80% to act. Anti-hallucination: never present guess as fact. <!-- /SYNC:critical-thinking-mindset:reminder --> <!-- SYNC:ai-mistake-prevention:reminder -->
• MUST ATTENTION apply AI mistake prevention — holistic-first debugging, fix at responsible layer, surface ambiguity before coding, re-read files after compaction. <!-- /SYNC:ai-mistake-prevention:reminder -->