Files
dss/dss-claude-plugin/commands/dss-init.md
DSS 08ce228df1
Some checks failed
DSS Project Analysis / dss-context-update (push) Has been cancelled
feat: Add DSS infrastructure, remove legacy admin-ui code
- Remove legacy admin-ui/js/ vanilla JS components
- Add .dss/ directory with core tokens, skins, themes
- Add Storybook configuration and generated stories
- Add DSS management scripts (dss-services, dss-init, dss-setup, dss-reset)
- Add MCP command definitions for DSS plugin
- Add Figma sync architecture and scripts
- Update pre-commit hooks with documentation validation
- Fix JSON trailing commas in skin files

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-12-10 22:15:11 -03:00

1.8 KiB

name, description, arguments
name description arguments
dss-init Full DSS workflow - reset, structure, analyze, sync, build CSS
name description required
flags Optional flags (--reset, --skip-analysis) false

DSS Init Command - Full Workflow Pipeline

Complete DSS initialization and build pipeline for admin-ui and storybook targets.

Usage

/dss-init [--reset] [--skip-analysis]

Full Workflow

  1. Reset (with --reset flag)

    • Clears all DSS data, tokens, themes
    • Resets skins to empty state
    • Removes generated CSS/stories
  2. Validate Environment

    • Python3, Node.js, style-dictionary
    • FIGMA_TOKEN availability
  3. Create Structure

    • .dss/data/_system/themes/ - CSS output
    • .dss/data/_system/tokens/ - Token JSON
    • Database initialization
  4. Analyze Targets

    • admin-ui: web app consumer
    • storybook: documentation
  5. Figma Sync (MCP required)

    • Uses dss_sync_figma tool
    • Populates tokens from Figma
  6. Build CSS

    • Runs style-dictionary
    • Generates tokens.css, _tokens.scss, tokens.json

Instructions for Claude

When the user runs this command:

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

  2. If status shows "AWAITING FIGMA SYNC":

    • Run dss_sync_figma MCP tool to populate tokens
    • Re-run scripts/dss-init.sh to build CSS
  3. If status shows "READY":

    • admin-ui can import from .dss/data/_system/themes/

Flags

  • --reset: Clear everything first (fresh start)
  • --skip-analysis: Skip code analysis step

Typical Workflow

# Fresh start
scripts/dss-init.sh --reset

# Populate tokens (MCP tool)
dss_sync_figma

# Build CSS
scripts/dss-init.sh

# admin-ui imports from .dss/data/_system/themes/
  • /dss-figma - Sync tokens from Figma
  • /dss-analyze - Analyze specific project