design-tool-picker

Design Tool Picker

When users ask "which design tool should I use?" or seem unsure about design tooling, guide them with this decision tree.

Quick Reference

Decision Flow

Question 1: Do you have code written, or are you starting fresh?

Starting fresh → Choose based on what you need:

• Need design system from scratch: /majestic:ux-brief
• Just need design guidance while coding: frontend-design skill (auto-loads)

Have code → Continue to Question 2

Question 2: Is the issue visual (layout, colors, spacing) or code quality (a11y, patterns)?

Visual issues → Continue to Question 3

Code quality → ui-code-auditor agent

• Reviews source code for accessibility violations
• Detects missing alt text, aria-labels, form labels
• Finds animation anti-patterns, touch target issues
• Returns findings with file:line references

Question 3: Can you run the UI and take screenshots?

Yes → Continue to Question 4

No → frontend-design skill

• Provides design patterns for typography, color, motion
• Reference while coding without needing running UI

Question 4: Do you want to iterate on the design or verify it's correct?

Iterate → ui-ux-designer agent

• Takes screenshots, analyzes, implements changes
• Multiple iteration cycles (default 10)
• Progressive refinement through visual feedback

Verify → visual-validator agent

• Checks if changes achieved intended goals
• Validates accessibility, design system compliance
• Returns structured pass/fail verdict

Tool Comparison

Screenshot-Based Tools (Visual)

Both require browser tools and running UI.

Code-Based Tools (Static)

Work on source code without running UI.

Creation Tools

Common Workflows

New Feature with UI

1. /majestic:ux-brief if no design system exists
2. frontend-design skill while implementing
3. ui-code-auditor before PR to catch a11y issues
4. visual-validator to verify visuals match intent

Fix Visual Bug

1. ui-ux-designer if iterating to find the right fix
2. visual-validator to confirm fix worked

Accessibility Audit

1. ui-code-auditor for code-level violations
2. visual-validator for visual accessibility (contrast, focus states)

Design System Update

1. /majestic:ux-brief to update design system docs
2. visual-validator to verify components match spec