90 lines
2.4 KiB
Markdown
90 lines
2.4 KiB
Markdown
---
|
|
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
|