website-sync

# Website Sync Skill

Keep generated websites synchronized with codebase changes.

## Capabilities

- **Change Detection** - Detect API, component, documentation, and model changes
- **Smart Mapping** - Map codebase changes to website updates
- **Sync Strategies** - Auto, semi-auto, and manual sync modes per website type
- **Bridge Integration** - Work with bridge-analyzer to detect gaps

## Sync Modes

### Auto
Changes are automatically applied to the website without manual review.

**Best for:**
- API documentation updates
- Type definition changes
- Routine documentation syncs

**Used by:**
- Documentation sites (API docs, type refs)
- Admin dashboards (model changes)

### Semi-Auto
Changes are detected and presented for review before applying.

**Best for:**
- New feature integration
- Dashboard updates from API changes
- Component showcase updates

**Used by:**
- Admin dashboards (new APIs)
- Portfolio sites (new projects)

### Manual
Changes require explicit approval before any action.

**Best for:**
- Content changes
- Breaking changes
- Major updates

**Used by:**
- Marketing sites (most changes)
- Portfolio sites (content updates)

## Website Type Strategies

### Documentation Sites

**Default Mode:** Auto

**Sync Rules:**
- API changes → Auto-update API docs
- Type changes → Auto-update type references
- Documentation changes → Auto-update content
- Component changes → Auto-update component docs
- Breaking changes → Manual review required

**Example:**
```typescript
// Codebase change: Updated User interface
interface User {
  id: string;
  name: string;
  email: string;
  role: "admin" | "user"; // Added
}

// Auto-synced to:
// docs/reference/user.mdx - Updated type docs
```

### Admin Dashboards

**Default Mode:** Semi-Auto

**Sync Rules:**
- Model changes → Auto-update forms and tables
- API changes → Review required for dashboard updates
- New endpoints → Review and possibly add widgets
- Breaking changes → Manual review required

**Example:**
```type