Files
calctext/_bmad/wds/workflows/7-design-system/workflow-create.md
2026-03-16 19:54:53 -04:00

2.2 KiB

name, description
name description
create-design-system Build a new design system or add components from specifications

Create Design System

Goal: Build a design system from scratch or add new components with automatic duplicate detection.


INITIALIZATION

Design Log

Read {output_folder}/_progress/00-design-log.md. Check Current and Backlog for context.

ENTRY ROUTING

Check design system status:

  • No design system exists → Start at Step 1 (Initialize)
  • Design system exists, adding component → Start at Step 2 (Assessment)
  • Known operation → Jump directly to Step 3

Steps

Step 1: Initialize Design System

Execute ./steps-c/step-08a-initialize-design-system.md

Sets up the design system structure: token categories, component organization, naming conventions.

→ After initialization, proceed to Step 3 for first component.

Step 2: Duplicate Detection (Assessment)

When adding a new component, run assessment before creation:

Step File Purpose
2a step-01-scan-existing.md Scan for similar existing components
2b step-02-compare-attributes.md Systematic attribute comparison
2c step-03-calculate-similarity.md Calculate similarity score
2d step-04-identify-opportunities.md Identify reuse opportunities
2e step-05-identify-risks.md Identify integration risks
2f step-06-present-decision.md Present decision to user
2g step-07-execute-decision.md Execute chosen path

Assessment determines which operation to perform next.

Step 3: Component Operations

Based on assessment result or direct selection:

Operation File When
Create new step-08b-create-new-component.md No similar component exists
Update existing step-08c-update-component.md Extending an existing component
Add variant step-08d-add-variant.md Adding a variant to existing component
Generate catalog step-08e-generate-catalog.md After changes, regenerate catalog

AFTER COMPLETION

  1. Update design log
  2. Run catalog generation (step-08e) to update component catalog
  3. Return to Phase 7 Activity Menu