---
name: dss-init
description: Complete DSS setup - MCP, dependencies, Figma sync, CSS build, servers
arguments:
  - name: flags
    description: Optional flags (--reset, --skip-analysis, --skip-servers, --servers-only)
    required: false
---

# DSS Init Command - Complete Setup & Build Pipeline

Single entry point for all DSS initialization. Handles MCP config, dependencies, Figma sync, CSS generation, and dev servers.

## Usage

```
/dss-init [--reset] [--skip-analysis] [--skip-servers] [--servers-only]
```

## Full Workflow (15 steps)

1. **Reset** (with --reset) - Clear all DSS data
2. **MCP Config** - Generate `.claude/mcp.json` (local MCP server)
3. **Dependencies** - Python venv, Node modules, admin-ui build
4. **Environment** - Validate Python, Node, Figma token
5. **Directory Structure** - Create `.dss/` folders
6. **Storage** - Initialize JSON data directories
7. **Analyze Targets** - admin-ui, storybook stats
8. **Token Structure** - Create base token files
9. **3-Layer Validation** - Core, skins, themes
10. **Figma Sync** - Fetch tokens from Figma
11. **Token Cascade** - Resolve Core → Skin → Theme
12. **Build CSS** - Run style-dictionary
13. **Storybook Stories** - Generate from tokens
14. **Hash Manifest** - Update checksums
15. **Start Servers** - admin-ui + Storybook

## Instructions for Claude

When the user runs this command:

1. Execute: `scripts/dss-init.sh [flags]`

2. After completion:
   - If first time, remind user to restart Claude Code to load MCP
   - If status shows "AWAITING FIGMA SYNC", ensure FIGMA_TOKEN is configured

## Flags

| Flag | Description |
|------|-------------|
| `--reset` | Clear everything first (fresh start) |
| `--skip-analysis` | Skip target project analysis |
| `--skip-servers` | Don't start development servers |
| `--servers-only` | Only start servers (skip all init steps) |

## Services

| Service | Port | URL |
|---------|------|-----|
| admin-ui | 6221 | http://localhost:6221 |
| Storybook | 6226 | http://localhost:6226 |

## Common Workflows

```bash
# Fresh start (reset + full init + servers)
/dss-init --reset

# Incremental update (no reset, keeps data)
/dss-init

# CI/CD mode (no servers)
/dss-init --skip-servers

# Just start servers
/dss-init --servers-only
```

## Logs

- `/tmp/dss-admin-ui.log`
- `/tmp/dss-storybook.log`

## Related Commands

- `/dss-reset` - Reset to clean state only (no init)
- `/dss-figma` - Sync tokens from Figma only
- `/dss-analyze` - Analyze specific project