Create UX
Quick Start
- Read user request to identify which workflow applies
- Load detailed process from references/workflows.md
- Use templates: references/spec-template.md | references/prototype-template.html
- Follow the C/R/A protocol after every generated section
Workflows
[1] New Design Project
Full guided journey — 7 sequential sections:
- Project Vision — goals, users, platform, constraints
- Design Decisions Workshop — resolve 4-6 key choices before building
- Component Inventory — list reusable UI building blocks (8-15 components)
- Key Screen Wireframes — ASCII wireframes for 2-3 critical screens
- Prototype Specification — scope, design tokens, interactions
- HTML/CSS Prototype — complete standalone HTML file
- Completion — summary and save instructions
[2] Brainstorm Decisions
Focused workshop on specific design choices. Present 2-4 options per decision with pros/cons and recommendation. No full project required.
[3] Create HTML Prototype
Quick prototype with lighter upfront questions. Minimum input: what it is, who uses it, key screens/interactions, style preferences.
[4] Review & Refine
Iterate on existing spec or prototype. Identify 3-5 improvement areas, work through one at a time.
See references/workflows.md for the detailed step-by-step process for each workflow.
Collaboration Protocol (C/R/A)
After every generated section, present:
What would you like to do?
[C] Continue — Accept and move to next section
[R] Refine — Give feedback, I'll rework it
[A] Alternative — Show a completely different approach
- C → finalize section, advance to next
- R → ask what to change, rework, re-present C/R/A
- A → generate significantly different version, re-present C/R/A
- Never advance without explicit C
HTML Prototype Rules
- Single self-contained
.html file — no external dependencies
- Semantic HTML5 (
<header>, <nav>, <main>, <section>, <footer>)
- CSS custom properties at
:root for design tokens
- Responsive with
@media breakpoints (desktop 1200px, tablet 768px, mobile 375px)
- Flexbox/Grid layout — no floats
- ARIA labels on interactive elements
- Vanilla JS only — no frameworks, comment every function
- Realistic placeholder content — no "Lorem ipsum" for UI labels
-- Use references/prototype-template.html as the structural base
UX Specification Format
Output as Markdown using references/spec-template.md. Include:
- YAML frontmatter (project, date, sections_completed, status)
## heading per section
- Tables for decisions log, component inventory, prototype spec
- ASCII wireframes for key screens
Hard Rules
- Never generate output without asking questions first — at minimum confirm what you're building
- Never auto-advance past a section without explicit [C]
- Never generate a prototype without knowing: what, who, which screens
- Always present C/R/A after generated content
- One section at a time — no jumping ahead
- Functional HTML — every prototype must render correctly in a browser without errors
- Questions first, output second — understand before generating
1---2name: create-ux-prototype3description: Facilitate UX design sessions with structured brainstorming, design decision workshops, UX specification writing, and standalone HTML/CSS prototyping. Use when user asks to design a UI, create a UX prototype, brainstorm design decisions, review a design, build an HTML mockup, create a wireframe, or mentions "UX", "prototype", "wireframe", "design decisions", "UI design", "mockup".4---56# Create UX78## Quick Start9101. Read user request to identify which workflow applies112. Load detailed process from [references/workflows.md](references/workflows.md)123. Use templates: [references/spec-template.md](references/spec-template.md) | [references/prototype-template.html](references/prototype-template.html)134. Follow the C/R/A protocol after every generated section1415## Workflows1617### [1] New Design Project1819Full guided journey — 7 sequential sections:20211. **Project Vision** — goals, users, platform, constraints222. **Design Decisions Workshop** — resolve 4-6 key choices before building233. **Component Inventory** — list reusable UI building blocks (8-15 components)244. **Key Screen Wireframes** — ASCII wireframes for 2-3 critical screens255. **Prototype Specification** — scope, design tokens, interactions266. **HTML/CSS Prototype** — complete standalone HTML file277. **Completion** — summary and save instructions2829### [2] Brainstorm Decisions3031Focused workshop on specific design choices. Present 2-4 options per decision with pros/cons and recommendation. No full project required.3233### [3] Create HTML Prototype3435Quick prototype with lighter upfront questions. Minimum input: what it is, who uses it, key screens/interactions, style preferences.3637### [4] Review & Refine3839Iterate on existing spec or prototype. Identify 3-5 improvement areas, work through one at a time.4041See [references/workflows.md](references/workflows.md) for the detailed step-by-step process for each workflow.4243## Collaboration Protocol (C/R/A)4445After **every** generated section, present:4647```48What would you like to do?49[C] Continue — Accept and move to next section50[R] Refine — Give feedback, I'll rework it51[A] Alternative — Show a completely different approach52```5354- **C** → finalize section, advance to next55- **R** → ask what to change, rework, re-present C/R/A56- **A** → generate significantly different version, re-present C/R/A57- Never advance without explicit **C**5859## HTML Prototype Rules6061- Single self-contained `.html` file — no external dependencies62- Semantic HTML5 (`<header>`, `<nav>`, `<main>`, `<section>`, `<footer>`)63- CSS custom properties at `:root` for design tokens64- Responsive with `@media` breakpoints (desktop 1200px, tablet 768px, mobile 375px)65- Flexbox/Grid layout — no floats66- ARIA labels on interactive elements67- Vanilla JS only — no frameworks, comment every function68- Realistic placeholder content — no "Lorem ipsum" for UI labels69-- Use [references/prototype-template.html](references/prototype-template.html) as the structural base7071## UX Specification Format7273Output as Markdown using [references/spec-template.md](references/spec-template.md). Include:7475- YAML frontmatter (project, date, sections_completed, status)76- `##` heading per section77- Tables for decisions log, component inventory, prototype spec78- ASCII wireframes for key screens7980## Hard Rules81821. **Never generate output without asking questions first** — at minimum confirm what you're building832. **Never auto-advance** past a section without explicit [C]843. **Never generate a prototype** without knowing: what, who, which screens854. **Always present C/R/A** after generated content865. **One section at a time** — no jumping ahead876. **Functional HTML** — every prototype must render correctly in a browser without errors887. **Questions first, output second** — understand before generating