dss/dss-claude-plugin/commands/dss-init.md

name, description, arguments

name	description	arguments
dss-init	Complete DSS setup - MCP, dependencies, Figma sync, CSS build, servers	name description required flags Optional flags (--reset, --skip-analysis, --skip-servers, --servers-only) 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

# 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