/design-audit: Full Project Design Audit
Run a comprehensive design audit on the current project or a specified path.
Usage
/design-audit # Audit current project
/design-audit /path/to/project # Audit specific project
Flow
- Load knowledge base - Read the knowledge index and all 21 knowledge files:
- Use
uiux_knowledge_query with listFiles: true to get the full inventory
- Every agent reads its assigned knowledge files (see
knowledge/INDEX.md for the mapping)
- The evidence base, principles, anti-patterns, and trends files are required reading for ALL agents
- Scan project - Use
uiux_scan_project to detect framework, styling, component library, theme system
- Display profile - Show the user what was detected, ask for confirmation
- Dispatch agents - Launch all relevant specialist agents in parallel (each reads its knowledge files first):
color-analyst - Color system diagnosistypography-analyst - Typography system diagnosislayout-analyst - Layout, spacing, grid analysiscomponent-reviewer - Component quality and consistencyaccessibility-auditor - WCAG compliance checkinteraction-analyst - Motion, transitions, feedbackpsychology-analyst - Cognitive load, hierarchy, trustvisual-style-advisor - Style direction evaluationplatform-advisor - Platform convention adherenceux-flow-analyst - Navigation and user flowsperformance-ux-analyst - Loading and perceived speed
- Aggregate scores - Use
uiux_score_overall to calculate weighted total
- Generate report - Full markdown report with:
- Project design profile
- Score card (12 dimensions)
- Top 20 findings ranked by impact
- Detailed per-dimension reports
- Prioritized action plan (quick wins / medium / major)
Agent dispatch strategy
Launch agents in parallel waves:
Wave 1 (always): color-analyst, typography-analyst, layout-analyst, accessibility-auditor, component-reviewer
Wave 2 (always): interaction-analyst, psychology-analyst, visual-style-advisor
Wave 3 (if applicable): platform-advisor (if mobile/cross-platform), ux-flow-analyst (if has routing), performance-ux-analyst (if has data fetching/images)
Output
Full audit report saved to design-audit-report.md in the project root.
Score card displayed inline for quick overview.
Each finding may cite one or more UX laws inline (for example, [!] psychology: 12-item nav menu - violates Hick's Law, Choice Overload). When any finding carries laws, the report ends with a ## Laws of UX Coverage markdown table summarizing violation counts and worst offenders per law. Agents look up law display names and primary-source citations from knowledge/laws-of-ux.md and the uiux_laws_query MCP tool.
1---2name: design-audit3description: Full project design audit that orchestrates all agents, scores across 12 dimensions, and generates a prioritized action plan. Use when the user asks to audit their design, run a design review or UX audit, review their UI, or asks how their design looks.4---56# /design-audit: Full Project Design Audit78Run a comprehensive design audit on the current project or a specified path.910## Usage11```12/design-audit # Audit current project13/design-audit /path/to/project # Audit specific project14```1516## Flow17181. **Load knowledge base** - Read the knowledge index and all 21 knowledge files:19 - Use `uiux_knowledge_query` with `listFiles: true` to get the full inventory20 - Every agent reads its assigned knowledge files (see `knowledge/INDEX.md` for the mapping)21 - The evidence base, principles, anti-patterns, and trends files are required reading for ALL agents222. **Scan project** - Use `uiux_scan_project` to detect framework, styling, component library, theme system233. **Display profile** - Show the user what was detected, ask for confirmation244. **Dispatch agents** - Launch all relevant specialist agents in parallel (each reads its knowledge files first):25 - `color-analyst` - Color system diagnosis26 - `typography-analyst` - Typography system diagnosis27 - `layout-analyst` - Layout, spacing, grid analysis28 - `component-reviewer` - Component quality and consistency29 - `accessibility-auditor` - WCAG compliance check30 - `interaction-analyst` - Motion, transitions, feedback31 - `psychology-analyst` - Cognitive load, hierarchy, trust32 - `visual-style-advisor` - Style direction evaluation33 - `platform-advisor` - Platform convention adherence34 - `ux-flow-analyst` - Navigation and user flows35 - `performance-ux-analyst` - Loading and perceived speed364. **Aggregate scores** - Use `uiux_score_overall` to calculate weighted total375. **Generate report** - Full markdown report with:38 - Project design profile39 - Score card (12 dimensions)40 - Top 20 findings ranked by impact41 - Detailed per-dimension reports42 - Prioritized action plan (quick wins / medium / major)4344## Agent dispatch strategy4546Launch agents in parallel waves:4748**Wave 1** (always): color-analyst, typography-analyst, layout-analyst, accessibility-auditor, component-reviewer49**Wave 2** (always): interaction-analyst, psychology-analyst, visual-style-advisor50**Wave 3** (if applicable): platform-advisor (if mobile/cross-platform), ux-flow-analyst (if has routing), performance-ux-analyst (if has data fetching/images)5152## Output5354Full audit report saved to `design-audit-report.md` in the project root.55Score card displayed inline for quick overview.5657Each finding may cite one or more UX laws inline (for example, `[!] psychology: 12-item nav menu - violates Hick's Law, Choice Overload`). When any finding carries laws, the report ends with a `## Laws of UX Coverage` markdown table summarizing violation counts and worst offenders per law. Agents look up law display names and primary-source citations from `knowledge/laws-of-ux.md` and the `uiux_laws_query` MCP tool.
aboudjem