design
Design
Route each design request to the correct mode, then execute that mode's output contract with shared quality constraints.
Core Workflow
- Select a primary mode from the mode map in this file.
- Select one secondary mode only when the request clearly spans multiple concerns.
- Fill the mandatory routing brief before producing output. If inputs are missing, state explicit assumptions.
- Load only the reference files required for the chosen mode(s).
- Deliver the primary mode contract completely; add secondary mode deltas without diluting the primary outcome.
Mode Map
Select one primary mode before work starts. Add one secondary mode only when needed.
-
uiTypical request patterns: build or refine screens, components, dashboards, landing pages, settings, and app flows. Primary goal: ship clear and distinctive interfaces. Expected deliverables: working UI code, token mapping, full state coverage, concise hierarchy rationale. Load reference:references/ui.md. Loadreferences/ui-examples.mdonly when concrete code examples are needed, especially for5or7tier token sets. -
uxTypical request patterns: plan or improve flows, IA, usability, accessibility, or run design audits. Primary goal: improve task success, comprehension, and evidence-based quality. Expected deliverables: UX structure outputs or severity-ordered audit findings with concrete fixes. Load reference:references/ux.md. -
motionTypical request patterns: define or implement transitions, microfeedback, loading, and continuity behavior. Primary goal: communicate state change and preserve orientation without friction. Expected deliverables: motion spec or code, timing/easing choices, reduced-motion fallback. Load reference:references/motion.md. -
imageryTypical request patterns: produce posters, editorial visuals, and static compositions. Primary goal: deliver high-impact static visual artifacts. Expected deliverables: philosophy.mdplus.pngor.pdfartifact (single page unless requested). Load reference:references/imagery.md.
Selection Rules
- Select
uifor implementation-heavy interface design and visual system decisions. - Select
uxfor information architecture, usability, accessibility, or audit-heavy requests. - Select
motionwhen behavior choreography is the core task. - Select
imageryfor non-interactive visual composition outputs. - When requests blend concerns, keep one primary mode and one secondary mode.
Routing Decision Tree
Use this sequence to select the primary mode:
- If the request is for a non-interactive visual artifact (
.png,.pdf, poster, editorial composition), selectimagery. - If the request is primarily about IA, usability, accessibility, or audits, select
ux. - If the request is primarily about transitions, microfeedback, choreography, or reduced-motion behavior, select
motion. - If the request is primarily about building/refining interface code, components, layout, or visual systems, select
ui.
Then add one secondary mode only when required:
- Use
uxas secondary touiwhen task flow or accessibility structure changes are a core part of the implementation. - Use
motionas secondary touiwhen animation behavior is explicitly in scope. - Use
motionas secondary touxwhen motion quality or reduced-motion compliance is a key audit axis. - Keep
imagerystandalone by default; add a secondary mode only when the user explicitly asks for a companion interactive adaptation.
Complexity Budget
Choose one level early and stay consistent:
baseline: practical, concise, low-risk execution.expressive: clear personality with controlled complexity.maximal: high visual and motion complexity with strict quality control.
Default to baseline for internal or time-constrained work. Default to expressive for most public-facing work. Use maximal only when the brief explicitly rewards spectacle and budget supports it.
Mandatory Routing Brief
Complete this brief before solution design:
Primary mode:
Secondary mode (optional):
Request type (new design, refinement, audit, artifact):
Human and audience:
Primary task to enable:
Context and constraints:
Complexity budget (baseline | expressive | maximal):
Output artifact(s) required:
Success criteria:
Global Non-Negotiables
Apply these across all modes:
- Preserve accessibility fundamentals (contrast, keyboard reachability, visible focus, reduced-motion support).
- Preserve responsive intent across mobile and desktop where screens are involved.
- Preserve performance by preferring efficient rendering and animation primitives.
- Cover required interaction and data states for any interactive surface.
- Keep decisions explainable with concrete rationale tied to the request and constraints.
- Layouts must tolerate longer copy, dynamic data, and localisation (wrapping, truncation rules, min/max widths).
References
references/ui.md: interface craft system, tokens, component rules, output contract, and quality checks.references/ui-examples.md: concrete Tailwind and component examples for 3/5/7 tier token systems.references/ux.md: UX structure, usability/accessibility checks, and audit workflow/report format.references/motion.md: motion purpose, timing/easing, performance, accessibility, and motion delivery contract.references/imagery.md: static visual artifact workflow and required output format.