Files
sar/.agents/skills/wds-7-design-system/workflow-create.md
julian 17c08e6392 chore: initial monorepo scaffold + WDS Phase 1+2 artifacts
- Nx 22.7 monorepo (pnpm 11.1, TypeScript 5.9, Node 24)
- apps/api: NestJS 11 (CJS conforme CODING-RULES.md PGD-DB-004)
- apps/web: React 19 + Vite 8 (ESM)
- libs/shared/api-interface: Zod contract base
- Docker Compose dev: Postgres 18, Valkey 8, MinIO, Mailpit
- WDS artifacts:
  - design-artifacts/A-Product-Brief/ (5 docs canônicos + 16 dialogs)
  - design-artifacts/B-Trigger-Map/ (hub + 4 personas + feature impact)
- Stack canon: STACK.md v2.2 + CODING-RULES.md v2.0 + brand.md
- AGENTS.md + README.md como entrada para devs/agentes

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-27 14:34:20 +00: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