| name | mockups |
| description | Generate HTML interface mockups for user stories. Use when user wants to create UI mockups, prototypes, or mentions /mockups command. |
Generate Interface Mockups
Create production-quality HTML mockups for a user story with mandatory desktop/mobile parity.
Usage
/mockups "Story name"
/mockups 5 # By MVP story number
/mockups # Interactive selection
Phase 1: Context Gathering
Read these files before generating anything:
- Conventions:
ProductSpecification/ui/ui-conventions.md (the single authority for all design rules)
- Templates:
ProductSpecification/ui/templates/ (browse what's available)
ProductSpecification/BriefProductDescription.txt
ProductSpecification/stories.md (story number lookup)
- Story spec:
ProductSpecification/stories/NN-story-name/NN_StoryName.md
- Landing page:
Landing/index.html (brand reference)
- If exists:
ProductSpecification/stories/NN-story-name/interview.md
Phase 2: Story Selection
Parse user input (by name, by number, or interactive).
Phase 3: Screen Plan (MANDATORY GATE)
You MUST complete this phase fully before writing any HTML file.
- Extract all screen states from the story spec's "Screen States" section. MUST include every state (never skip, merge, or combine).
- Map states to filenames for BOTH desktop AND mobile. Every desktop file MUST have a mobile counterpart.
- Parity check — desktop files = N, mobile files = N. Fix if counts differ.
NEVER proceed to Phase 4 until the Screen Plan table is complete with equal counts.
Phase 4: Generate Mockups
Load .claude/templates/ui/mockup-generation-rules.md for all generation rules, output location, template usage, format, and completion check.
Phase 5: Screenshots
Run /screenshot for both desktop and mobile directories.
Phase 6: Summary
Report: Screen Plan table, total files, screenshot locations, design decisions, whether conventions were updated.
Pre-flight Checklist
Templates
.claude/templates/ui/mockup-generation-rules.md — generation rules, format, templates, completion check
.claude/templates/ui/icon-reference.md — icon name lookup