---
description: Validate implementation against design document
allowed-tools: Read, Bash, Glob, Grep
---

# Validate Implementation

Validate: "$ARGUMENTS"

## Purpose

Check that implementations match the design document specifications exactly.

## Validation Steps

### 1. Run Implementation Validator

```bash
python3 skills/guardrail-orchestrator/scripts/workflow_manager.py validate --checklist
```

### 2. Review Errors

The validator checks:
- **Components**: Props match design, events implemented
- **APIs**: Routes exist, methods implemented, schemas match
- **Models**: Prisma fields match design

### 3. Fix Issues

For each error, check:

1. **Read the design spec:**
   ```bash
   cat .workflow/versions/v001/contexts/<entity_id>.yml
   ```

2. **Check generated types:**
   ```bash
   cat types/component-props.ts | grep -A 20 "<ComponentName>Props"
   ```

3. **Fix the implementation** to match the design

4. **Re-validate:**
   ```bash
   python3 skills/guardrail-orchestrator/scripts/workflow_manager.py validate
   ```

### 4. View Checklist

```bash
# View markdown checklist
cat .workflow/versions/v001/implementation_checklist.md

# Or use the workflow command
python3 skills/guardrail-orchestrator/scripts/workflow_manager.py checklist show
```

## Common Issues

### Props Don't Match Design

**Problem:** Component uses flat props instead of typed objects

```tsx
// ❌ Wrong
interface SongCardProps {
  id: string;
  title: string;
}

// ✅ Correct - from generated types
import type { SongCardProps } from '@/types/component-props';
// SongCardProps = { song: Song; showArtist?: boolean; }
```

### Missing Events

**Problem:** Design specifies events not implemented

```tsx
// Design specifies: onPlay, onAddToPlaylist
// Implementation only has: onPlay

// Fix: Add missing event
export function SongCard({ song, onPlay, onAddToPlaylist }: SongCardProps) {
  // Implement onAddToPlaylist handler
}
```

### API Route Missing

**Problem:** API route file doesn't exist

```
Expected: app/api/songs/[id]/route.ts
Actual: (not found)
```

Fix: Create the route file following the design spec.

## Validation Report Symbols

- ✅ **Passed** - Implementation matches design
- ⚠️ **Warning** - Minor issue (e.g., optional field missing)
- ❌ **Error** - Critical mismatch with design

## Post-Validation

After all errors are fixed:

```bash
# Verify clean validation
python3 skills/guardrail-orchestrator/scripts/workflow_manager.py validate

# If passed, transition to REVIEWING phase
python3 skills/guardrail-orchestrator/scripts/workflow_manager.py transition REVIEWING
```