Migrated from design-system-swarm with fresh git history.
Old project history preserved in /home/overbits/apps/design-system-swarm
Core components:
- MCP Server (Python FastAPI with mcp 1.23.1)
- Claude Plugin (agents, commands, skills, strategies, hooks, core)
- DSS Backend (dss-mvp1 - token translation, Figma sync)
- Admin UI (Node.js/React)
- Server (Node.js/Express)
- Storybook integration (dss-mvp1/.storybook)
Self-contained configuration:
- All paths relative or use DSS_BASE_PATH=/home/overbits/dss
- PYTHONPATH configured for dss-mvp1 and dss-claude-plugin
- .env file with all configuration
- Claude plugin uses ${CLAUDE_PLUGIN_ROOT} for portability
Migration completed: $(date)
🤖 Clean migration with full functionality preserved
1.9 KiB
1.9 KiB
name, description, arguments
| name | description | arguments | |||||||
|---|---|---|---|---|---|---|---|---|---|
| dss-analyze | Analyze a project for design system patterns and opportunities |
|
DSS Analyze Command
Analyze a project directory for design system patterns, component usage, and tokenization opportunities.
Usage
/dss-analyze [path]
If no path is provided, analyzes the current working directory.
What This Does
-
Scans Project Structure
- Identifies all style files (CSS, SCSS, Tailwind)
- Locates component files (React, Vue)
- Maps project dependencies
-
Analyzes Styles
- Extracts color values and patterns
- Identifies typography usage
- Finds spacing patterns
- Detects shadows and borders
-
Analyzes Components
- Maps React/Vue components
- Identifies repeated patterns
- Finds hardcoded values
-
Generates Report
- Summary statistics
- Pattern identification
- Recommendations for improvement
Instructions for Claude
When the user runs this command:
- Use the
dss_analyze_projecttool with the provided path (or current directory if not specified) - Wait for analysis results
- Present findings in a clear, organized format:
- Summary section with key metrics
- Style patterns found
- Component analysis
- Top recommendations
- Offer to drill deeper into specific areas
- Suggest next steps (token extraction, component audit, etc.)
Example Output
Design System Analysis: /path/to/project
SUMMARY
- Files scanned: 127
- Style files: 34
- Components: 23
- Unique colors: 156
- Typography variations: 12
TOP FINDINGS
1. Color inconsistency: 156 colors could be 12 tokens
2. Spacing: 8 different scales in use
3. 3 button variants that could consolidate
RECOMMENDATIONS
1. Create color token system
2. Standardize spacing scale
3. Audit button components
Next: Run /dss-extract to create tokens from these patterns