---
name: dss-quick-wins
description: Find quick win opportunities for design system adoption
arguments:
  - name: path
    description: Path to project directory
    required: false
---

# DSS Quick Wins Command

Find low-effort, high-impact opportunities for design system adoption.

## Usage

```
/dss-quick-wins [path]
```

Examples:
```
/dss-quick-wins
/dss-quick-wins ./src
```

## What This Does

1. **Analyzes Codebase**
   - Scans styles and components
   - Identifies patterns
   - Measures usage frequency

2. **Finds Opportunities**
   - Color consolidation
   - Spacing standardization
   - Typography cleanup
   - Border radius normalization
   - Shadow standardization

3. **Scores by Impact/Effort**
   - Calculates potential impact
   - Estimates implementation effort
   - Ranks by ROI

4. **Generates Recommendations**
   - Prioritized list
   - Specific actions
   - Expected outcomes

## Instructions for Claude

When the user runs this command:

1. Use `dss_find_quick_wins` tool with path
2. Present quick wins in priority order
3. For each quick win, show:
   - Category (colors, spacing, etc.)
   - Impact level (high/medium/low)
   - Effort level (high/medium/low)
   - Specific values to consolidate
   - Files affected
4. Provide total time estimate
5. Offer to implement top quick wins

## Example Output

```
Quick Win Analysis: /path/to/project

TOP QUICK WINS

1. COLOR CONSOLIDATION
   Impact: HIGH | Effort: LOW

   Found 47 color values reducible to 8 tokens
   Files affected: 23

   Consolidate:
   #0066cc, #0067cd, #0065cb -> primary
   #6c757d, #6b747c, #6d767e -> secondary

   Estimated time: 2 hours

2. SPACING STANDARDIZATION
   Impact: HIGH | Effort: LOW

   Found 34 spacing values reducible to 6 tokens
   Files affected: 31

   Consolidate to 4px grid:
   4px, 8px, 16px, 24px, 32px, 48px

   Estimated time: 3 hours

3. BORDER RADIUS NORMALIZATION
   Impact: MEDIUM | Effort: LOW

   Found 12 radius values reducible to 4 tokens
   Files affected: 15

   Consolidate:
   2px (sm), 4px (md), 8px (lg), 16px (xl)

   Estimated time: 1 hour

4. SHADOW CLEANUP
   Impact: MEDIUM | Effort: LOW

   Found 8 shadow definitions reducible to 3 tokens
   Files affected: 12

   Consolidate:
   sm: 0 1px 2px rgba(0,0,0,0.05)
   md: 0 4px 6px rgba(0,0,0,0.1)
   lg: 0 10px 15px rgba(0,0,0,0.1)

   Estimated time: 1 hour

5. FONT SIZE SCALE
   Impact: HIGH | Effort: MEDIUM

   Found 15 font sizes reducible to 7 tokens
   Files affected: 28

   Consolidate to type scale:
   12px, 14px, 16px, 18px, 24px, 32px, 48px

   Estimated time: 3 hours

SUMMARY

Total quick wins: 5
Total estimated time: 10 hours
Expected impact: 60% reduction in style inconsistency

RECOMMENDED ORDER

1. Colors (biggest impact)
2. Spacing (most widespread)
3. Border radius (quick win)
4. Shadows (contained scope)
5. Font sizes (needs coordination)

Ready to implement? I can create tokens for any of these.
```
