ros/BMAD-METHOD
1
0
Fork 0
mirror of https://github.com/bmad-code-org/BMAD-METHOD.git synced 2026-01-30 04:32:02 +00:00
Code Issues Packages Projects Releases Wiki Activity
Files
efbe839a0a9752a3ac6ffa8b4785b290119be2d2
BMAD-METHOD/docs/how-to/workflows/create-ux-design.md
forcetrainer e535f94325 docs: comprehensive style guide update with reference and glossary standards 
Style Guide Additions:
- Add Reference Structure section with 6 document types (Index, Catalog,
  Deep-Dive, Configuration, Glossary, Comprehensive)
- Add Glossary Structure section with table-based format leveraging
  Starlight's right-nav for navigation
- Include checklists for both new document types

Reference Docs Updated:
- agents/index.md: Catalog format, universal commands tip admonition
- configuration/core-tasks.md: Configuration format with admonitions
- configuration/global-config.md: Table-based config reference
- workflows/index.md: Minimal index format
- workflows/core-workflows.md: Catalog format
- workflows/document-project.md: Deep-dive with Quick Facts admonition
- workflows/bmgd-workflows.md: Comprehensive format, removed ~30 hr rules

Glossary Rewritten:
- Converted from 373 lines with ### headers to 123 lines with tables
- Right nav now shows 9 categories instead of 50+ terms
- Added italic context markers (*BMGD.*, *Brownfield.*, etc.)
- Alphabetized terms within categories
- Removed redundant inline TOC

All Docs:
- Remove horizontal rules (---) per style guide
- Remove "Related" sections (sidebar handles navigation)
- Standardize admonition usage
- Archive deleted workflow customization docs

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-12 00:23:05 -05:00

2.3 KiB
Raw Blame History

title, description
title description
How to Create a UX Design How to create UX specifications using the BMad Method

Use the create-ux-design workflow to create UX specifications for projects where user experience is a primary differentiator.

When to Use This

  • UX is primary competitive advantage
  • Complex user workflows needing design thinking
  • Innovative interaction patterns
  • Design system creation
  • Accessibility-critical experiences

When to Skip This

  • Simple CRUD interfaces
  • Internal tools with standard patterns
  • Changes to existing screens you're happy with
  • Quick Flow projects

:::note[Prerequisites]

  • BMad Method installed
  • UX Designer agent available
  • PRD completed :::

Steps

1. Load the UX Designer Agent

Start a fresh chat and load the UX Designer agent.

2. Run the UX Design Workflow

*create-ux-design

3. Provide Context

Point the agent to your PRD and describe:

  • Key user journeys
  • UX priorities
  • Any existing design patterns

4. Collaborate on Design

The workflow uses a collaborative approach:

  1. Visual exploration — Generate multiple options
  2. Informed decisions — Evaluate with user needs
  3. Collaborative design — Refine iteratively
  4. Living documentation — Evolves with project

5. Review the UX Spec

The agent produces comprehensive UX documentation.

What You Get

The ux-spec.md document includes:

  • User journeys
  • Wireframes and mockups
  • Interaction specifications
  • Design system (components, patterns, tokens)
  • Epic breakdown (UX stories)

Example

Dashboard redesign produces:

  • Card-based layout with split-pane toggle
  • 5 card components
  • 12 color tokens
  • Responsive grid
  • 3 epics (Layout, Visualization, Accessibility)

Integration

The UX spec feeds into:

  • PRD updates
  • Epic and story creation
  • Architecture decisions (Phase 3)

Tips

  • Focus on user problems first — Solutions come second
  • Generate multiple options — Don't settle on the first idea
  • Consider accessibility from the start — Not an afterthought
  • Document component reusability — Build a system, not just screens

Next Steps

After UX design:

  1. Update PRD — Incorporate UX findings
  2. Create Architecture — Technical design informed by UX
  3. Create Epics and Stories — Include UX-specific stories