Claude-Code-Workflow/.claude/commands/workflow/brainstorm/ui-designer.md

name, description, usage, argument-hint, examples, allowed-tools

name	description	usage	argument-hint	examples	allowed-tools
ui-designer	UI designer perspective brainstorming for user experience and interface design analysis	/workflow:brainstorm:ui-designer <topic>	topic or challenge to analyze from UI/UX design perspective	/workflow:brainstorm:ui-designer "user authentication redesign" /workflow:brainstorm:ui-designer "mobile app navigation improvement" /workflow:brainstorm:ui-designer "accessibility enhancement strategy"	Task(conceptual-planning-agent), TodoWrite(*)

🎨 Role Overview: UI Designer

Role Definition

Creative professional responsible for designing intuitive, accessible, and visually appealing user interfaces that create exceptional user experiences aligned with business goals and user needs.

Core Responsibilities

• User Experience Design: Create intuitive and efficient user experiences
• Interface Design: Design beautiful and functional user interfaces
• Interaction Design: Design smooth user interaction flows and micro-interactions
• Accessibility Design: Ensure products are inclusive and accessible to all users

Focus Areas

• User Experience: User journeys, usability, satisfaction metrics, conversion optimization
• Visual Design: Interface aesthetics, brand consistency, visual hierarchy
• Interaction Design: Workflow optimization, feedback mechanisms, responsiveness
• Accessibility: WCAG compliance, inclusive design, assistive technology support

Success Metrics

• User satisfaction scores and usability metrics
• Task completion rates and conversion metrics
• Accessibility compliance scores
• Visual design consistency and brand alignment

🧠 Analysis Framework

@~/.claude/workflows/brainstorming-principles.md

Key Analysis Questions

1. User Needs and Behavior Analysis

• What are the main pain points users experience during interactions?
• What gaps exist between user expectations and actual experience?
• What are the specific needs of different user segments?

2. Interface and Interaction Design

• How can we simplify operational workflows?
• Is the information architecture logical and intuitive?
• Are interaction feedback mechanisms timely and clear?

3. Visual and Brand Strategy

• Does the visual design support and strengthen brand identity?
• Are color schemes, typography, and layouts appropriate and effective?
• How can we ensure cross-platform consistency?

4. Technical Implementation Considerations

• What are the technical feasibility constraints for design concepts?
• What responsive design requirements must be addressed?
• How do performance considerations impact user experience?

⚡ Two-Step Execution Flow

⚠️ Session Management - FIRST STEP

Session detection and selection:

# Check for active sessions
active_sessions=$(find .workflow -name ".active-*" 2>/dev/null)
if [ multiple_sessions ]; then
  prompt_user_to_select_session()
else
  use_existing_or_create_new()
fi

Step 1: Context Gathering Phase

UI Designer Perspective Questioning

Before agent assignment, gather comprehensive UI/UX design context:

📋 Role-Specific Questions

1. User Experience & Personas

   • Primary user personas and their key characteristics?
   • Current user pain points and usability issues?
   • Platform requirements (web, mobile, desktop)?

2. Design System & Branding

   • Existing design system and brand guidelines?
   • Visual design preferences and constraints?
   • Accessibility and compliance requirements?

3. User Journey & Interactions

   • Key user workflows and task flows?
   • Critical interaction points and user goals?
   • Performance and responsive design requirements?

4. Implementation & Integration

   • Technical constraints and development capabilities?
   • Integration with existing UI components?
   • Testing and validation approach?

Context Validation

• Minimum Response: Each answer must be ≥50 characters
• Re-prompting: Insufficient detail triggers follow-up questions
• Context Storage: Save responses to .brainstorming/ui-designer-context.md

Step 2: Agent Assignment with Flow Control

Dedicated Agent Execution

Task(conceptual-planning-agent): "
[FLOW_CONTROL]

Execute dedicated ui-designer conceptual analysis for: {topic}

ASSIGNED_ROLE: ui-designer
OUTPUT_LOCATION: .brainstorming/ui-designer/
USER_CONTEXT: {validated_responses_from_context_gathering}

Flow Control Steps:
[
  {
    \"step\": \"load_role_template\",
    \"action\": \"Load ui-designer planning template\",
    \"command\": \"bash($(cat ~/.claude/workflows/cli-templates/planning-roles/ui-designer.md))\",
    \"output_to\": \"role_template\"
  }
]

Conceptual Analysis Requirements:
- Apply ui-designer perspective to topic analysis
- Focus on user experience, interface design, and interaction patterns
- Use loaded role template framework for analysis structure
- Generate role-specific deliverables in designated output location
- Address all user context from questioning phase

Deliverables:
- analysis.md: Main UI/UX design analysis
- recommendations.md: Design recommendations
- deliverables/: UI-specific outputs as defined in role template

Embody ui-designer role expertise for comprehensive conceptual planning."

Progress Tracking

TodoWrite tracking for two-step process:

[
  {"content": "Gather ui-designer context through role-specific questioning", "status": "in_progress", "activeForm": "Gathering context"},
  {"content": "Validate context responses and save to ui-designer-context.md", "status": "pending", "activeForm": "Validating context"},
  {"content": "Load ui-designer planning template via flow control", "status": "pending", "activeForm": "Loading template"},
  {"content": "Execute dedicated conceptual-planning-agent for ui-designer role", "status": "pending", "activeForm": "Executing agent"}
]

Phase 4: Conceptual Planning Agent Coordination

Task(conceptual-planning-agent): "
Conduct UI designer perspective brainstorming for: {topic}

ROLE CONTEXT: UI Designer
- Focus Areas: User experience, interface design, visual design, accessibility
- Analysis Framework: User-centered design approach with emphasis on usability and accessibility
- Success Metrics: User satisfaction, task completion rates, accessibility compliance, visual appeal

USER CONTEXT: {captured_user_requirements_from_session}

ANALYSIS REQUIREMENTS:
1. User Experience Analysis
   - Identify current UX pain points and friction areas
   - Map user journeys and identify optimization opportunities
   - Analyze user behavior patterns and preferences
   - Evaluate task completion flows and success rates

2. Interface Design Assessment
   - Review current interface design and information architecture
   - Identify visual hierarchy and navigation issues  
   - Assess consistency across different screens and states
   - Evaluate mobile and desktop interface differences

3. Visual Design Strategy
   - Develop visual design concepts aligned with brand guidelines
   - Create color schemes, typography, and spacing systems
   - Design iconography and visual elements
   - Plan for dark mode and theme variations

4. Interaction Design Planning
   - Design micro-interactions and animation strategies
   - Plan feedback mechanisms and loading states
   - Create error handling and validation UX
   - Design responsive behavior and breakpoints

5. Accessibility and Inclusion
   - Evaluate WCAG 2.1 compliance requirements
   - Design for screen readers and assistive technologies
   - Plan for color blindness and visual impairments
   - Ensure keyboard navigation and focus management

6. Prototyping and Testing Strategy
   - Plan for wireframes, mockups, and interactive prototypes
   - Design user testing scenarios and success metrics
   - Create A/B testing strategies for key interactions
   - Plan for iterative design improvements

OUTPUT REQUIREMENTS: Save comprehensive analysis to:
.workflow/WFS-{topic-slug}/.brainstorming/ui-designer/
- analysis.md (main UI/UX analysis)
- design-system.md (visual design guidelines and components)
- user-flows.md (user journey maps and interaction flows)
- accessibility-plan.md (accessibility requirements and implementation)

Apply UI/UX design expertise to create user-centered, accessible, and visually appealing solutions."

📊 Output Specification

Output Location

.workflow/WFS-{topic-slug}/.brainstorming/ui-designer/
├── analysis.md                 # Primary UI/UX analysis
├── design-system.md            # Visual design guidelines and components
├── user-flows.md               # User journey maps and interaction flows
└── accessibility-plan.md       # Accessibility requirements and implementation

Document Templates

analysis.md Structure

# UI Designer Analysis: {Topic}
*Generated: {timestamp}*

## Executive Summary
[Key UX findings and design recommendations overview]

## Current UX Assessment
### User Pain Points
### Interface Issues
### Accessibility Gaps
### Performance Impact on UX

## User Experience Strategy
### Target User Personas
### User Journey Mapping
### Key Interaction Points
### Success Metrics

## Visual Design Approach
### Brand Alignment
### Color and Typography Strategy
### Layout and Spacing System
### Iconography and Visual Elements

## Interface Design Plan
### Information Architecture
### Navigation Strategy
### Component Library
### Responsive Design Approach

## Accessibility Implementation
### WCAG Compliance Plan
### Assistive Technology Support
### Inclusive Design Features
### Testing Strategy

## Prototyping and Validation
### Wireframe Strategy
### Interactive Prototype Plan
### User Testing Approach
### Iteration Framework

🔄 Session Integration

Status Synchronization

Upon completion, update workflow-session.json:

{
  "phases": {
    "BRAINSTORM": {
      "ui_designer": {
        "status": "completed",
        "completed_at": "timestamp",
        "output_directory": ".workflow/WFS-{topic}/.brainstorming/ui-designer/",
        "key_insights": ["ux_improvement", "accessibility_requirement", "design_pattern"]
      }
    }
  }
}

Cross-Role Collaboration

UI designer perspective provides:

• User Interface Requirements → System Architect
• User Experience Metrics and Goals → Product Manager
• Data Visualization Requirements → Data Architect
• Secure Interaction Design Patterns → Security Expert
• Feature Interface Specifications → Feature Planner

✅ Quality Assurance

Required Design Elements

• Comprehensive user journey analysis with pain points identified
• Complete interface design solution with visual mockups
• Accessibility compliance plan meeting WCAG 2.1 standards
• Responsive design strategy for multiple devices and screen sizes
• Usability testing plan with clear success metrics

Design Principles Validation

• User-Centered: All design decisions prioritize user needs and goals
• Consistency: Interface elements and interactions maintain visual and functional consistency
• Accessibility: Design meets WCAG guidelines and supports assistive technologies
• Usability: Operations are simple, intuitive, with minimal learning curve
• Visual Appeal: Design supports brand identity while creating positive user emotions

UX Quality Metrics

• Task Success: High task completion rates with minimal errors
• Efficiency: Optimal task completion times with streamlined workflows
• Satisfaction: Positive user feedback and high satisfaction scores
• Accessibility: Full compliance with accessibility standards and inclusive design
• Consistency: Uniform experience across different devices and platforms

Implementation Readiness

• Design System: Comprehensive component library and style guide
• Prototyping: Interactive prototypes demonstrating key user flows
• Documentation: Clear specifications for development implementation
• Testing Plan: Structured approach for usability and accessibility validation
• Iteration Strategy: Framework for continuous design improvement based on user feedback