# design-system-scanner

> Read-only audit agent that finds design token violations without modifying files.

- Author: dependabot[bot]
- Repository: tanujsutaria/VitalArc
- Version: 20260202104834
- Stars: 1
- Forks: 0
- Last Updated: 2026-02-06
- Source: https://github.com/tanujsutaria/VitalArc
- Web: https://mule.run/skillshub/@@tanujsutaria/VitalArc~design-system-scanner:20260202104834

---

---
name: design-system-scanner
description: Audit VitalArc views for design system compliance. Read-only scanning - finds violations but does NOT fix them. Works on both cloud and workstation. For fixes, use design-system-fixer.
context: fork
agent: Explore
allowed-tools: Read, Glob, Grep
argument-hint: [--path=specific/path] [--verbose]
---

# Design System Scanner

Read-only audit agent that finds design token violations without modifying files.

**Execution**: Runs in forked context with Explore agent for read-only analysis.

## Responsibility Split

| Agent | Platform | Capability | Purpose |
|-------|----------|------------|---------|
| **design-system-scanner** | Both | Read-only | Find violations |
| **design-system-fixer** | Workstation only | Read-write | Fix violations |

## What It Scans

### Colors
```swift
// Violations
Color.red
Color(.systemBlue)
Color(red: 0.5, green: 0.5, blue: 0.5)
UIColor.red

// Correct
Color.vitalPrimary
Color.vitalDanger
Color.vitalAdaptiveTextPrimary
```

### Spacing
```swift
// Violations
.padding(16)
.padding(.horizontal, 20)
.frame(width: 48)
.cornerRadius(12)

// Correct
.padding(Spacing.md)
.padding(.horizontal, Spacing.screenPadding)
.frame(width: Spacing.iconHuge)
.cornerRadius(Spacing.radiusMedium)
```

### Typography
```swift
// Violations
.font(.system(size: 14))
.font(.title)
.font(.headline)

// Correct
.font(.vitalBody)
.font(.vitalH1)
.font(.vitalLabel)
```

### Icon Sizes
```swift
// Violations
.font(.system(size: 24, weight: .bold))
Image(systemName: "star").font(.system(size: 20))

// Correct
.font(.system(size: Spacing.iconLarge, weight: .bold))
Image(systemName: "star").font(.system(size: Spacing.iconMedium))
```

## Scan Patterns

### Color Patterns (Grep)
```bash
# Direct Color references
grep -rn "Color\.\(red\|blue\|green\|yellow\|orange\|purple\|pink\|gray\|white\|black\)" VitalArc/Presentation/

# System colors
grep -rn "Color(\.system" VitalArc/Presentation/

# RGB colors
grep -rn "Color(red:" VitalArc/Presentation/

# UIColor
grep -rn "UIColor\." VitalArc/Presentation/
```

### Spacing Patterns (Grep)
```bash
# Hardcoded padding
grep -rn "\.padding([0-9]" VitalArc/Presentation/

# Hardcoded frame dimensions
grep -rn "\.frame(width: [0-9]" VitalArc/Presentation/
grep -rn "\.frame(height: [0-9]" VitalArc/Presentation/

# Hardcoded corner radius
grep -rn "\.cornerRadius([0-9]" VitalArc/Presentation/

# Hardcoded spacing in stacks
grep -rn "spacing: [0-9]" VitalArc/Presentation/
```

### Typography Patterns (Grep)
```bash
# System fonts with size
grep -rn "\.font(\.system(size: [0-9]" VitalArc/Presentation/

# Standard fonts
grep -rn "\.font(\.title)" VitalArc/Presentation/
grep -rn "\.font(\.headline)" VitalArc/Presentation/
grep -rn "\.font(\.body)" VitalArc/Presentation/
grep -rn "\.font(\.caption)" VitalArc/Presentation/
```

## Exclusions

Do NOT flag:
- Preview code (`#Preview { }`)
- Test files (`*Tests.swift`)
- Design system definition files (`Spacing.swift`, `Typography.swift`, `Colors.swift`)
- Comments
- Commented-out code

## Output Format

### Summary Report

```markdown
## Design System Scan Results

### Summary
| Category | Violations | Files |
|----------|------------|-------|
| Colors | 5 | 3 |
| Spacing | 12 | 7 |
| Typography | 8 | 4 |
| **Total** | **25** | **10** |

### Violations by File

#### ProfileView.swift (7 violations)
| Line | Category | Violation | Suggested Fix |
|------|----------|-----------|---------------|
| 45 | Color | `Color.red` | `Color.vitalDanger` |
| 78 | Spacing | `.padding(16)` | `.padding(Spacing.md)` |
| 92 | Typography | `.font(.system(size: 14))` | `.font(.vitalBody)` |

#### WorkoutView.swift (4 violations)
| Line | Category | Violation | Suggested Fix |
|------|----------|-----------|---------------|
| 23 | Spacing | `.cornerRadius(12)` | `.cornerRadius(Spacing.radiusMedium)` |
...

### Next Steps
Run `design-system-fixer` to auto-fix these violations (workstation only).
```

### Verbose Output

With `--verbose`, include code context:

```markdown
#### ProfileView.swift:45
```swift
// Line 43-47
ZStack {
    Circle()
        .fill(Color.red)  // Use Color.vitalDanger
        .frame(width: 48, height: 48)
}
```
**Suggested**: `.fill(Color.vitalDanger)`
```

## Token Reference

### Colors
| Token | Usage |
|-------|-------|
| `Color.vitalPrimary` | Primary actions (indigo) |
| `Color.vitalDanger` | Errors, destructive (red) |
| `Color.vitalSuccess` | Success states (green) |
| `Color.vitalWarning` | Warnings (amber) |
| `Color.vitalInfo` | Information (blue) |
| `Color.vitalAdaptiveBackground` | Screen backgrounds |
| `Color.vitalAdaptiveSurface` | Card surfaces |
| `Color.vitalAdaptiveTextPrimary` | Primary text |
| `Color.vitalAdaptiveTextSecondary` | Secondary text |

### Spacing
| Token | Value | Usage |
|-------|-------|-------|
| `Spacing.xs` | 4 | Tiny gaps |
| `Spacing.sm` | 8 | Small gaps |
| `Spacing.md` | 16 | Standard padding |
| `Spacing.lg` | 24 | Section spacing |
| `Spacing.screenPadding` | 20 | Screen edges |
| `Spacing.radiusSmall` | 8 | Small corners |
| `Spacing.radiusMedium` | 12 | Card corners |
| `Spacing.iconSmall` | 16 | Small icons |
| `Spacing.iconMedium` | 20 | Standard icons |
| `Spacing.iconLarge` | 24 | Large icons |

### Typography
| Token | Size | Usage |
|-------|------|-------|
| `.vitalDisplayLarge` | 34pt | Hero text |
| `.vitalH1` | 22pt | Page titles |
| `.vitalH2` | 20pt | Section headers |
| `.vitalH3` | 17pt | Card headers |
| `.vitalBody` | 14pt | Body text |
| `.vitalCaption` | 12pt | Secondary text |
| `.vitalLabel` | 14pt semibold | Labels |

## Error Handling

### No Violations Found

```markdown
## Design System Scan Results

No violations found!

Scanned 70 files in VitalArc/Presentation/
All views comply with design system tokens.
```

### Scan Errors

```markdown
## Scan Incomplete

Some files could not be scanned:
- VitalArc/Presentation/SomeView.swift: Permission denied

Results below are partial.
```