design-qa
Design QA
Structured quality gate for UI code. Run against any component, page, or feature before shipping. Every check is binary — pass or fail. Report ONLY failures. Silence = quality.
Fast Scan
bash design-qa/scripts/design-scan.sh [target-dir] --fix # Full scan with fixes
bash design-qa/scripts/design-scan.sh [target-dir] --no-ui # Skip upstream primitives
bash design-qa/scripts/design-scan.sh [target-dir] --json # JSON for CI
bash design-qa/scripts/design-scan.sh [target-dir] --critical-only
Requires: ripgrep (rg). Optional: ast-grep (sg).
After the fast scan, run the manual gates below for judgment-based checks. Read the code, run each gate in order, report failures with line numbers and fixes.
More from fasalzein/design-skills
design-craft
Universal design principles for AI agents to produce world-class UI. Typography, color, spacing, animation, layout, interaction, component patterns. Eliminates AI slop. Use when building any UI — pages, components, dashboards, forms, landing pages.
9laws-of-ux
User-psychology rules for UX decisions — cognitive load, attention, memory, mental models, motor cost, perception. Use when choosing nav structure, form length, decision flows, content ordering, error recovery, onboarding, progress indicators, or microcopy. Complements design-craft (craft) with the WHY (psychology).
9