initial commit

_bmad/wds/workflows/7-design-system/workflow-import.md

@@ -0,0 +1,79 @@
+---
+name: import-design-system
+description: Import an existing design system into the WDS format
+---
+
+# Import Design System
+
+**Goal:** Bring an existing design system into WDS — from a URL, file export, or Figma project.
+
+---
+
+## INITIALIZATION
+
+### Design Log
+Read `{output_folder}/_progress/00-design-log.md`. Check Current and Backlog for context.
+
+
+## Steps
+
+### Step 1: Identify Source
+
+Ask the user for the design system source:
+
+- **URL** — Public design system documentation (e.g., Material UI, Chakra, custom)
+- **File** — Exported tokens file (JSON, CSS custom properties, SCSS variables)
+- **Figma** — Figma design system file (via Figma MCP or export)
+- **Code** — Existing codebase with component library
+
+### Step 2: Extract Tokens
+
+Read the source and extract design tokens:
+
+1. **Colors** — Primary, secondary, semantic, neutrals
+2. **Typography** — Font families, sizes, weights, line heights
+3. **Spacing** — Scale values, named spacing tokens
+4. **Shadows** — Elevation levels
+5. **Borders** — Radius values, border styles
+6. **Breakpoints** — Responsive breakpoints
+7. **Motion** — Transition durations, easing curves
+
+Present extracted tokens to user for review. Mark any ambiguous mappings.
+
+### Step 3: Extract Components
+
+Identify reusable components from the source:
+
+1. List all components found
+2. For each: name, props/variants, token dependencies
+3. Map to WDS component template format
+4. Flag components that don't map cleanly
+
+Present component list for user approval.
+
+### Step 4: Generate Design System Files
+
+Create the WDS design system structure:
+
+1. `design-tokens.md` — All extracted tokens in WDS format
+2. `components/*.md` — One file per component
+3. `component-library-config.md` — Configuration and metadata
+
+### Step 5: Validate Import
+
+Run validation:
+
+- All tokens referenced by components exist
+- No orphaned tokens (defined but never used)
+- Naming conventions consistent
+- Component variants complete
+
+Present validation report. Fix issues interactively.
+
+---
+
+## AFTER COMPLETION
+
+1. Update design log
+1. Suggest running [B] Browse Design System to explore the import
+2. Return to Phase 7 Activity Menu