Phase 3: Mockup & UI/UX Design
Design screens and user flows before building components.
Purpose
Phase 3 creates visual blueprints for the application. Mockups prevent expensive redesigns during development and align stakeholders on the user experience.
Actions
| Action |
Description |
Example |
start |
Begin Phase 3 |
$phase-3-mockup start |
screens |
List all screens needed |
$phase-3-mockup screens |
flow |
Create user flow diagram |
$phase-3-mockup flow |
Deliverables
- Screen Inventory - List of all screens/pages
- Wireframes - Low-fidelity layout for each screen
- User Flow Diagram - Navigation paths between screens
- Responsive Breakpoints - Mobile/tablet/desktop layouts
- Mockup Document -
docs/02-design/mockup.md
Process
Step 1: Screen Inventory
List every screen the application needs:
### Public Pages
- [ ] Landing Page - Hero, features, CTA
- [ ] Login - Email/password form
- [ ] Register - Signup form
- [ ] Password Reset - Recovery flow
### Authenticated Pages
- [ ] Dashboard - Overview, stats, recent activity
- [ ] Profile - User info, settings
- [ ] Item List - CRUD list with filters
- [ ] Item Detail - Single item view/edit
Step 2: Wireframe Each Screen
Use ASCII for text-based wireframes:
+-----------------------------------+
| [Logo] [Nav] [Login] |
+-----------------------------------+
| |
| Welcome to AppName |
| Subtitle description |
| |
| [Get Started Button] |
| |
+-----------------------------------+
| Feature 1 | Feature 2 | F3 |
| Icon+Text | Icon+Text | |
+-----------------------------------+
| Footer Links |
+-----------------------------------+
Step 3: User Flow
Landing -> Login -> Dashboard
-> Register -> Email Verify -> Dashboard
Dashboard -> Item List -> Item Detail -> Edit Item
-> Profile -> Settings
-> Logout -> Landing
Step 4: Responsive Design
| Breakpoint |
Width |
Layout Changes |
| Mobile |
< 640px |
Single column, hamburger menu |
| Tablet |
640-1024px |
Two columns, condensed nav |
| Desktop |
> 1024px |
Full layout, sidebar visible |
Step 5: Component Identification
Identify reusable components from wireframes:
- Header (logo, nav, user menu)
- Footer (links, copyright)
- Card (image, title, description, actions)
- Form (input, select, checkbox, submit)
- Table (sortable, filterable, paginated)
- Modal (confirm, form, info)
- Toast/Alert (success, error, warning, info)
Mockup Patterns
See references/mockup-patterns.md for common layout, form, and list patterns.
Output Location
docs/02-design/
├── mockup.md # Screen wireframes
├── user-flow.md # Navigation flow diagram
└── screen-list.md # Screen inventory
Next Phase
When mockups are complete, proceed to $phase-4-api for API design.
Common Mistakes
| Mistake |
Solution |
| Skipping mobile layout |
Design mobile-first, then scale up |
| Too detailed too early |
Start with low-fi wireframes |
| Missing error states |
Design empty, loading, and error states |
| No user flow |
Map the full journey before screen details |
| Forgetting edge cases |
Include 0 items, max items, long text states |
1---2name: phase-3-mockup-33description: Phase 3: UI/UX Mockups and Wireframe Design. Create wireframes, screen flows, and user journey maps. Next: $phase-4-api. Triggers: mockup, wireframe, UI design, UX, screen design, prototype, 목업, 와이어프레임, 화면 설계, UI 디자인, モックアップ, ワイヤーフレーム, 原型设计, 线框图, maqueta, wireframe, maquette, Wireframe, Mockup Do NOT use for: coding conventions (use $phase-2-convention), components (use $phase-5-design-system).4---56# Phase 3: Mockup & UI/UX Design78> Design screens and user flows before building components.910## Purpose1112Phase 3 creates visual blueprints for the application. Mockups prevent expensive redesigns during development and align stakeholders on the user experience.1314## Actions1516| Action | Description | Example |17|--------|-------------|---------|18| `start` | Begin Phase 3 | `$phase-3-mockup start` |19| `screens` | List all screens needed | `$phase-3-mockup screens` |20| `flow` | Create user flow diagram | `$phase-3-mockup flow` |2122## Deliverables23241. **Screen Inventory** - List of all screens/pages252. **Wireframes** - Low-fidelity layout for each screen263. **User Flow Diagram** - Navigation paths between screens274. **Responsive Breakpoints** - Mobile/tablet/desktop layouts285. **Mockup Document** - `docs/02-design/mockup.md`2930## Process3132### Step 1: Screen Inventory3334List every screen the application needs:3536```markdown37### Public Pages38- [ ] Landing Page - Hero, features, CTA39- [ ] Login - Email/password form40- [ ] Register - Signup form41- [ ] Password Reset - Recovery flow4243### Authenticated Pages44- [ ] Dashboard - Overview, stats, recent activity45- [ ] Profile - User info, settings46- [ ] Item List - CRUD list with filters47- [ ] Item Detail - Single item view/edit48```4950### Step 2: Wireframe Each Screen5152Use ASCII for text-based wireframes:5354```55+-----------------------------------+56| [Logo] [Nav] [Login] |57+-----------------------------------+58| |59| Welcome to AppName |60| Subtitle description |61| |62| [Get Started Button] |63| |64+-----------------------------------+65| Feature 1 | Feature 2 | F3 |66| Icon+Text | Icon+Text | |67+-----------------------------------+68| Footer Links |69+-----------------------------------+70```7172### Step 3: User Flow7374```75Landing -> Login -> Dashboard76 -> Register -> Email Verify -> Dashboard7778Dashboard -> Item List -> Item Detail -> Edit Item79 -> Profile -> Settings80 -> Logout -> Landing81```8283### Step 4: Responsive Design8485| Breakpoint | Width | Layout Changes |86|-----------|-------|----------------|87| Mobile | < 640px | Single column, hamburger menu |88| Tablet | 640-1024px | Two columns, condensed nav |89| Desktop | > 1024px | Full layout, sidebar visible |9091### Step 5: Component Identification9293Identify reusable components from wireframes:94- Header (logo, nav, user menu)95- Footer (links, copyright)96- Card (image, title, description, actions)97- Form (input, select, checkbox, submit)98- Table (sortable, filterable, paginated)99- Modal (confirm, form, info)100- Toast/Alert (success, error, warning, info)101102## Mockup Patterns103104See `references/mockup-patterns.md` for common layout, form, and list patterns.105106## Output Location107108```109docs/02-design/110├── mockup.md # Screen wireframes111├── user-flow.md # Navigation flow diagram112└── screen-list.md # Screen inventory113```114115## Next Phase116117When mockups are complete, proceed to **$phase-4-api** for API design.118119## Common Mistakes120121| Mistake | Solution |122|---------|----------|123| Skipping mobile layout | Design mobile-first, then scale up |124| Too detailed too early | Start with low-fi wireframes |125| Missing error states | Design empty, loading, and error states |126| No user flow | Map the full journey before screen details |127| Forgetting edge cases | Include 0 items, max items, long text states |