diff --git a/plugins/viz-platform/commands/design-review.md b/plugins/viz-platform/commands/design-review.md new file mode 100644 index 0000000..69a7775 --- /dev/null +++ b/plugins/viz-platform/commands/design-review.md @@ -0,0 +1,70 @@ +--- +description: Audit codebase for design system compliance +arguments: + - name: path + description: File or directory to audit + required: true +--- + +# /design-review + +Scans target path for Dash Mantine Components usage and validates against design system standards. + +## Usage + +``` +/design-review +``` + +**Examples:** +``` +/design-review ./app/pages/ +/design-review ./app/components/dashboard.py +/design-review . +``` + +## What It Does + +1. **Activates** the `design-reviewer` agent in review mode +2. **Loads** the `skills/design-system-audit.md` skill +3. **Scans** target path for: + - Python files with DMC imports + - Component instantiations and their props + - Style dictionaries and color values + - Accessibility attributes +4. **Validates** against: + - DMC component registry (valid components and props) + - Theme token usage (no hardcoded colors/sizes) + - Accessibility standards (contrast, ARIA labels) +5. **Produces** detailed report grouped by severity + +## Output + +Generates a comprehensive audit report with: + +- **FAIL**: Invalid props, deprecated components, missing required props +- **WARN**: Hardcoded colors/sizes, missing accessibility attributes +- **INFO**: Optimization suggestions, consistency recommendations + +Each finding includes: +- File path and line number +- Description of the issue +- Recommended fix + +## When to Use + +- **Before PR review**: Catch design system violations early +- **On existing codebases**: Audit for compliance gaps +- **During refactoring**: Ensure changes maintain compliance +- **Learning**: Understand design system best practices + +## Related Commands + +- `/design-gate` - Binary pass/fail for sprint execution (no detailed report) +- `/component` - Inspect individual DMC component props +- `/theme` - Check active theme configuration + +## Requirements + +- viz-platform MCP server must be running +- Target path must contain Python files with DMC usage