UI Design Iteration
Transform functional-but-flat interfaces into scannable, actionable, accessible designs.
Core Principles
1. Align labels with user intent
- Page titles and nav labels should reflect the user's job, not internal terminology
- Group navigation by intent (Create, Review, Analyze, Manage)
- Ensure naming consistency across title, nav, tabs, and empty states
2. Make primary actions unmistakable
- One primary CTA per screen with consistent placement
- Provide contextual "next step" affordances near where attention already is
- Secondary actions visible but subordinate; tertiary actions in overflow menus
3. Improve scannability through hierarchy
- Strengthen typographic hierarchy: title → section headers → row primary → metadata
- Consistent row heights, spacing, and alignment
- Use whitespace and dividers to encode structure, not decoration
4. Make state explicit everywhere
- Represent modes with tabs/segmented controls
- Selection needs multiple cues: indicator + weight + background (not color alone)
- Summarize active automation/filters where relevant
5. Systematize the visual design
- Standardize spacing, typography, and color via tokens
- Use accent color for priority and state, not decoration
- Build reusable components rather than one-off styles
Iteration Playbook
A. Reframe the page
Define the job statement: "User comes here to ____."
- Update page title and nav selection to reflect that job
- Remove ambiguous or overlapping labels
B. Establish action hierarchy
Identify primary (most common), secondary (common but not main path), and tertiary (rare, collapse to overflow) actions.
- Only one primary button style per screen
- Place contextual next-step affordance near the data surface
C. Chunk dense controls
Replace walls of toggles/fields with:
- Group headers + short descriptions
- Progressive disclosure for advanced settings
- Aligned labels and descriptions for quick scanning
D. Increase scan speed for data surfaces
- Consistent columns and alignment
- Primary value bold, metadata muted
- Row actions right-aligned with overflow
- Truncation that preserves meaning (with tooltip/detail access)
E. Clarify modes and location
- Top-level modes via tabs/segmented control
- Active filters shown as chips with clear remove affordance
- Context line under headers showing scope when needed
Quick References
Accessibility requirements: See CHECKLIST.md
Reusable component patterns: See COMPONENTS.md
Output Format
When completing an iteration, produce:
- Design intent — 1-2 sentences on what job is supported and what changed
- Key UX changes — Bulleted, mapped to the principles above
- Component updates — What was created or standardized
- A11y verification — Contrast, focus, labels, targets, truncation
- Known risks — Only if materially impacting usability
Converted and distributed by TomeVault — claim your Tome and manage your conversions.
1---2name: ui-design-iteration3description: Iterates on data-intensive UI designs to improve scannability, hierarchy, accessibility, and systematization. Use when improving an existing UI, reviewing a design for UX issues, or transforming a functional-but-flat interface into a polished product. Use when this capability is needed.4---56# UI Design Iteration78Transform functional-but-flat interfaces into scannable, actionable, accessible designs.910## Core Principles1112### 1. Align labels with user intent13- Page titles and nav labels should reflect the user's job, not internal terminology14- Group navigation by intent (Create, Review, Analyze, Manage)15- Ensure naming consistency across title, nav, tabs, and empty states1617### 2. Make primary actions unmistakable18- One primary CTA per screen with consistent placement19- Provide contextual "next step" affordances near where attention already is20- Secondary actions visible but subordinate; tertiary actions in overflow menus2122### 3. Improve scannability through hierarchy23- Strengthen typographic hierarchy: title → section headers → row primary → metadata24- Consistent row heights, spacing, and alignment25- Use whitespace and dividers to encode structure, not decoration2627### 4. Make state explicit everywhere28- Represent modes with tabs/segmented controls29- Selection needs multiple cues: indicator + weight + background (not color alone)30- Summarize active automation/filters where relevant3132### 5. Systematize the visual design33- Standardize spacing, typography, and color via tokens34- Use accent color for priority and state, not decoration35- Build reusable components rather than one-off styles3637## Iteration Playbook3839### A. Reframe the page40Define the job statement: "User comes here to ____."41- Update page title and nav selection to reflect that job42- Remove ambiguous or overlapping labels4344### B. Establish action hierarchy45Identify primary (most common), secondary (common but not main path), and tertiary (rare, collapse to overflow) actions.46- Only one primary button style per screen47- Place contextual next-step affordance near the data surface4849### C. Chunk dense controls50Replace walls of toggles/fields with:51- Group headers + short descriptions52- Progressive disclosure for advanced settings53- Aligned labels and descriptions for quick scanning5455### D. Increase scan speed for data surfaces56- Consistent columns and alignment57- Primary value bold, metadata muted58- Row actions right-aligned with overflow59- Truncation that preserves meaning (with tooltip/detail access)6061### E. Clarify modes and location62- Top-level modes via tabs/segmented control63- Active filters shown as chips with clear remove affordance64- Context line under headers showing scope when needed6566## Quick References6768**Accessibility requirements**: See [CHECKLIST.md](CHECKLIST.md)69**Reusable component patterns**: See [COMPONENTS.md](COMPONENTS.md)7071## Output Format7273When completing an iteration, produce:74751. **Design intent** — 1-2 sentences on what job is supported and what changed762. **Key UX changes** — Bulleted, mapped to the principles above773. **Component updates** — What was created or standardized784. **A11y verification** — Contrast, focus, labels, targets, truncation795. **Known risks** — Only if materially impacting usability8081---82> Converted and distributed by [TomeVault](https://tomevault.io/claim/ozten) — claim your Tome and manage your conversions.83<!-- tomevault:4.0:skill_md:2026-04-13 -->