auto-backup: 2025-12-12 10:20:33 (21 files: +0 ~20 -0)
Generated by DSS Git Backup Hook
This commit is contained in:
@@ -1,49 +1,39 @@
|
||||
---
|
||||
name: dss-init
|
||||
description: Full DSS workflow - reset, structure, analyze, sync, build CSS
|
||||
description: Complete DSS setup - MCP, dependencies, Figma sync, CSS build, servers
|
||||
arguments:
|
||||
- name: flags
|
||||
description: Optional flags (--reset, --skip-analysis)
|
||||
description: Optional flags (--reset, --skip-analysis, --skip-servers, --servers-only)
|
||||
required: false
|
||||
---
|
||||
|
||||
# DSS Init Command - Full Workflow Pipeline
|
||||
# DSS Init Command - Complete Setup & Build Pipeline
|
||||
|
||||
Complete DSS initialization and build pipeline for admin-ui and storybook targets.
|
||||
Single entry point for all DSS initialization. Handles MCP config, dependencies, Figma sync, CSS generation, and dev servers.
|
||||
|
||||
## Usage
|
||||
|
||||
```
|
||||
/dss-init [--reset] [--skip-analysis]
|
||||
/dss-init [--reset] [--skip-analysis] [--skip-servers] [--servers-only]
|
||||
```
|
||||
|
||||
## Full Workflow
|
||||
## Full Workflow (15 steps)
|
||||
|
||||
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
|
||||
1. **Reset** (with --reset) - Clear all DSS data
|
||||
2. **MCP Config** - Generate `.mcp.json`
|
||||
3. **Dependencies** - Python venv, Node modules, admin-ui build
|
||||
4. **Environment** - Validate Python, Node, Figma token
|
||||
5. **Directory Structure** - Create `.dss/` folders
|
||||
6. **Database** - Initialize SQLite
|
||||
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
|
||||
|
||||
@@ -51,34 +41,49 @@ 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/`
|
||||
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
|
||||
|
||||
- `--reset`: Clear everything first (fresh start)
|
||||
- `--skip-analysis`: Skip code analysis step
|
||||
| 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) |
|
||||
|
||||
## Typical Workflow
|
||||
## Services
|
||||
|
||||
| Service | Port | URL |
|
||||
|---------|------|-----|
|
||||
| admin-ui | 3456 | http://localhost:3456 |
|
||||
| Storybook | 6006 | http://localhost:6006 |
|
||||
|
||||
## Common Workflows
|
||||
|
||||
```bash
|
||||
# Fresh start
|
||||
scripts/dss-init.sh --reset
|
||||
# Fresh start (reset + full init + servers)
|
||||
/dss-init --reset
|
||||
|
||||
# Populate tokens (MCP tool)
|
||||
dss_sync_figma
|
||||
# Incremental update (no reset, keeps data)
|
||||
/dss-init
|
||||
|
||||
# Build CSS
|
||||
scripts/dss-init.sh
|
||||
# CI/CD mode (no servers)
|
||||
/dss-init --skip-servers
|
||||
|
||||
# admin-ui imports from .dss/data/_system/themes/
|
||||
# Just start servers
|
||||
/dss-init --servers-only
|
||||
```
|
||||
|
||||
## Logs
|
||||
|
||||
- `/tmp/dss-admin-ui.log`
|
||||
- `/tmp/dss-storybook.log`
|
||||
|
||||
## Related Commands
|
||||
|
||||
- `/dss-figma` - Sync tokens from Figma
|
||||
- `/dss-reset` - Reset to clean state only (no init)
|
||||
- `/dss-figma` - Sync tokens from Figma only
|
||||
- `/dss-analyze` - Analyze specific project
|
||||
|
||||
@@ -1,70 +1,38 @@
|
||||
---
|
||||
name: dss-setup
|
||||
description: Complete DSS setup - MCP config, init, and start servers
|
||||
description: DEPRECATED - Use /dss-init instead
|
||||
arguments:
|
||||
- name: flags
|
||||
description: Optional flags (--reset, --skip-servers)
|
||||
required: false
|
||||
---
|
||||
|
||||
# DSS Setup Command
|
||||
# DSS Setup Command (DEPRECATED)
|
||||
|
||||
Complete DSS environment setup including MCP configuration, initialization, and development servers.
|
||||
**This command is deprecated. Use `/dss-init` instead.**
|
||||
|
||||
## Usage
|
||||
The `/dss-init` command now handles everything that `/dss-setup` did:
|
||||
- MCP configuration
|
||||
- Dependencies (Python venv, Node modules)
|
||||
- DSS initialization
|
||||
- Development servers
|
||||
|
||||
```
|
||||
/dss-setup [--reset] [--skip-servers]
|
||||
```
|
||||
## Migration
|
||||
|
||||
## What This Does
|
||||
|
||||
1. **Generate MCP Config**
|
||||
- Creates `.mcp.json` with absolute paths
|
||||
- Configures DSS MCP server connection
|
||||
|
||||
2. **Check Dependencies**
|
||||
- Python venv setup
|
||||
- Node modules installation
|
||||
|
||||
3. **Initialize DSS** (calls dss-init.sh)
|
||||
- Directory structure
|
||||
- Database initialization
|
||||
- Target analysis (admin-ui, storybook)
|
||||
- Token structure
|
||||
- Hash manifest
|
||||
|
||||
4. **Start Servers**
|
||||
- admin-ui on port 3456
|
||||
- Storybook on port 6006
|
||||
| Old Command | New Command |
|
||||
|-------------|-------------|
|
||||
| `/dss-setup` | `/dss-init` |
|
||||
| `/dss-setup --reset` | `/dss-init --reset` |
|
||||
| `/dss-setup --skip-servers` | `/dss-init --skip-servers` |
|
||||
|
||||
## Instructions for Claude
|
||||
|
||||
When the user runs this command:
|
||||
|
||||
1. Execute: `scripts/dss-setup.sh [flags]`
|
||||
1. Inform them that `/dss-setup` is deprecated
|
||||
2. Run `/dss-init` with the same flags instead
|
||||
|
||||
2. After completion, remind user to restart Claude Code to load MCP server
|
||||
|
||||
## Flags
|
||||
|
||||
- `--reset`: Clear all DSS data first (fresh start)
|
||||
- `--skip-servers`: Don't start development servers
|
||||
|
||||
## Services
|
||||
|
||||
| Service | Port | URL |
|
||||
|---------|------|-----|
|
||||
| admin-ui | 3456 | http://localhost:3456 |
|
||||
| Storybook | 6006 | http://localhost:6006 |
|
||||
|
||||
## Logs
|
||||
|
||||
- `/tmp/dss-admin-ui.log`
|
||||
- `/tmp/dss-storybook.log`
|
||||
|
||||
## Related Commands
|
||||
|
||||
- `/dss-init` - Initialize DSS structure only
|
||||
- `/dss-reset` - Reset to clean state
|
||||
- `/dss-figma` - Sync tokens from Figma
|
||||
```bash
|
||||
# Just run dss-init.sh directly
|
||||
scripts/dss-init.sh [flags]
|
||||
```
|
||||
|
||||
Reference in New Issue
Block a user