Design System

Overview

Turn product facts, existing UI evidence, and explicitly scoped references into a versioned, repository-owned design system. Own creation, extraction, maintenance, task design, and design evaluation; route product-source edits to implement-frontend, runtime evidence to ops-browser or ops-client, and read-only implementation audits to audit-frontend.

Workflow

1. Read effective repository guidance and run git status --short before planning artifacts.
2. Identify product, audience, platform, primary user job, target surface, current component system, available states, data facts, and forbidden inventions.
3. Inspect the smallest useful set of current screenshots, routes, components, tokens, DTOs, and analogous surfaces. Say Not found or Not verified for missing evidence.
4. Select one primary mode: create, extract, maintain, task, or evaluate. Supporting outputs may be included only when needed by that mode.
5. Assign each reference an explicit use and ignore list plus source and rights status. Never treat a reference as authorization to copy brand, content, or functionality.
6. Create one coherent, subject-specific visual direction: named palette, typography roles, layout concept, density, material, interaction tone, and one justified signature element. Reject interchangeable AI-design defaults and preserve product truth over decoration. Load references/visual-direction.md when creating or materially reshaping that direction.
7. Treat assets/ui-package.schema.json as the package contract, then produce or update the project profile, task brief, reference registry, design tokens, component map, evaluation, and manifest from assets/templates/.
8. Separate deterministic acceptance checks from visual or experience judgment. Apply hard blockers before weighted scoring.
9. Version every input and output in the manifest. Never overwrite the last accepted revision without preserving rollback.
10. When Python and PyYAML are available, validate the package with scripts/validate_ui_artifacts.py; otherwise report artifact validation as Not verified without installing dependencies implicitly. Then hand off source work and runtime proof to their owning Skills.