From d7f045b11ed5a951d65b369e38eabf9bb9160e7c Mon Sep 17 00:00:00 2001 From: Dicky Moore Date: Thu, 20 Nov 2025 02:40:07 +0000 Subject: [PATCH] Align UX design workflow references (#935) Co-authored-by: Brian --- src/modules/bmm/docs/agents-guide.md | 4 ++-- .../bmm/docs/enterprise-agentic-development.md | 2 +- src/modules/bmm/docs/test-architecture.md | 2 +- .../create-ux-design/instructions.md | 12 ++++++------ .../workflows/2-plan-workflows/prd/instructions.md | 6 +++--- .../workflow-status/paths/enterprise-brownfield.yaml | 4 ++-- .../workflow-status/paths/enterprise-greenfield.yaml | 4 ++-- .../workflow-status/paths/method-brownfield.yaml | 4 ++-- .../workflow-status/paths/method-greenfield.yaml | 4 ++-- 9 files changed, 21 insertions(+), 21 deletions(-) diff --git a/src/modules/bmm/docs/agents-guide.md b/src/modules/bmm/docs/agents-guide.md index 52d20775..f6886ede 100644 --- a/src/modules/bmm/docs/agents-guide.md +++ b/src/modules/bmm/docs/agents-guide.md @@ -321,7 +321,7 @@ The BMad Method Module (BMM) provides a comprehensive team of specialized AI age **Workflows:** - `workflow-status` - Check what to do next -- `create-design` - Conduct design thinking workshop to define UX specification with: +- `create-ux-design` - Conduct design thinking workshop to define UX specification with: - Visual exploration and generation - Collaborative decision-making - AI-assisted design tools (v0, Lovable) @@ -944,7 +944,7 @@ Quick reference for agent selection: | ----------------------- | ---- | ------------------ | --------------------------------------------- | ------------------------------------- | | **Analyst** | 📊 | 1 (Analysis) | brainstorm, brief, research, document-project | Discovery, requirements, brownfield | | **PM** | 📋 | 2 (Planning) | prd, tech-spec, epics-stories | Planning, requirements docs | -| **UX Designer** | 🎨 | 2 (Planning) | create-design, validate-design | UX-heavy projects, design | +| **UX Designer** | 🎨 | 2 (Planning) | create-ux-design, validate-design | UX-heavy projects, design | | **Architect** | 🏗️ | 3 (Solutioning) | architecture, implementation-readiness | Technical design, architecture | | **SM** | 🏃 | 4 (Implementation) | sprint-planning, create-story, story-context | Story management, sprint coordination | | **DEV** | 💻 | 4 (Implementation) | develop-story, code-review, story-done | Implementation, coding | diff --git a/src/modules/bmm/docs/enterprise-agentic-development.md b/src/modules/bmm/docs/enterprise-agentic-development.md index fd4c22f5..00738bcc 100644 --- a/src/modules/bmm/docs/enterprise-agentic-development.md +++ b/src/modules/bmm/docs/enterprise-agentic-development.md @@ -240,7 +240,7 @@ Continuous deployment to production **UX Designer Workflow:** ```bash -bmad ux *create-design +bmad ux *create-ux-design ``` **BMad produces:** diff --git a/src/modules/bmm/docs/test-architecture.md b/src/modules/bmm/docs/test-architecture.md index 694f3bb1..1e985a05 100644 --- a/src/modules/bmm/docs/test-architecture.md +++ b/src/modules/bmm/docs/test-architecture.md @@ -295,7 +295,7 @@ These cheat sheets map TEA workflows to the **BMad Method and Enterprise tracks* | Workflow Stage | Test Architect | Dev / Team | Outputs | | -------------------------- | ------------------------------------------------------------------------ | ----------------------------------------------------------------------------------- | ------------------------------------------------------------------ | | **Phase 1**: Discovery | - | Analyst ➕ `*research`, `*product-brief` | Domain research, compliance analysis, product brief | -| **Phase 2**: Planning | Run ➕ `*nfr-assess` | PM `*prd` (creates PRD with FRs/NFRs), UX `*create-design` | Enterprise PRD with FRs/NFRs, UX design, ➕ NFR documentation | +| **Phase 2**: Planning | Run ➕ `*nfr-assess` | PM `*prd` (creates PRD with FRs/NFRs), UX `*create-ux-design` | Enterprise PRD with FRs/NFRs, UX design, ➕ NFR documentation | | **Phase 3**: Solutioning | Run `*framework`, `*ci` AFTER architecture and epic creation | Architect `*architecture`, `*create-epics-and-stories`, `*implementation-readiness` | Architecture, epics/stories, test framework, CI pipeline | | **Phase 4**: Sprint Start | - | SM `*sprint-planning` | Sprint plan with all epics | | **Phase 4**: Epic Planning | Run `*test-design` for THIS epic 🔄 (compliance focus) | Review epic scope and compliance requirements | `test-design-epic-N.md` with security/performance/compliance focus | diff --git a/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/instructions.md b/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/instructions.md index fc5d6458..cc0e2f07 100644 --- a/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/instructions.md +++ b/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/instructions.md @@ -26,12 +26,12 @@ Load the FULL file: {output_folder}/bmm-workflow-status.yaml Parse workflow_status section - Check status of "create-design" workflow + Check status of "create-ux-design" workflow Get project_level from YAML metadata Find first non-completed workflow (next expected workflow) - - ⚠️ UX Design already completed: {{create-design status}} + + ⚠️ UX Design already completed: {{create-ux-design status}} Re-running will overwrite the existing UX design. Continue? (y/n) Exiting. Use workflow-status to see your next step. @@ -39,7 +39,7 @@ - + ⚠️ Next expected workflow: {{next_workflow}}. UX Design is out of sequence. Continue with UX Design anyway? (y/n) @@ -1139,9 +1139,9 @@ Based on your deployment intent: {{recommendation}} Load the FULL file: {output_folder}/bmm-workflow-status.yaml - Find workflow_status key "create-design" + Find workflow_status key "create-ux-design" ONLY write the file path as the status value - no other text, notes, or metadata - Update workflow_status["create-design"] = "{default_output_file}" + Update workflow_status["create-ux-design"] = "{default_output_file}" Save file, preserving ALL comments and structure including STATUS DEFINITIONS Find first non-completed workflow in workflow_status (next workflow to do) diff --git a/src/modules/bmm/workflows/2-plan-workflows/prd/instructions.md b/src/modules/bmm/workflows/2-plan-workflows/prd/instructions.md index 92e6934e..50041275 100644 --- a/src/modules/bmm/workflows/2-plan-workflows/prd/instructions.md +++ b/src/modules/bmm/workflows/2-plan-workflows/prd/instructions.md @@ -652,7 +652,7 @@ Your PRD is complete!" Check workflow path to determine next expected workflows: - Look for "create-epics-and-stories" as optional after PRD -- Look for "create-design" as conditional (if_has_ui) +- Look for "create-ux-design" as conditional (if_has_ui) - Look for "create-epics-and-stories-after-ux" as optional - Identify the required next phase workflow @@ -675,7 +675,7 @@ Based on your {{project_track}} workflow path, you can: **Option B: UX Design First** (Recommended if UI) - `workflow create-design` + `workflow create-ux-design` - Design user experience and interactions - Epic breakdown can incorporate UX details later @@ -691,7 +691,7 @@ Based on your {{project_track}} workflow path, you can: **Typical next workflows:** -1. `workflow create-design` - UX Design (if UI exists) +1. `workflow create-ux-design` - UX Design (if UI exists) 2. `workflow create-architecture` - Technical architecture 3. `workflow create-epics-and-stories` - Epic breakdown diff --git a/src/modules/bmm/workflows/workflow-status/paths/enterprise-brownfield.yaml b/src/modules/bmm/workflows/workflow-status/paths/enterprise-brownfield.yaml index 525c79a7..e95c69d8 100644 --- a/src/modules/bmm/workflows/workflow-status/paths/enterprise-brownfield.yaml +++ b/src/modules/bmm/workflows/workflow-status/paths/enterprise-brownfield.yaml @@ -60,10 +60,10 @@ phases: agent: "pm" command: "validate-prd" - - id: "create-design" + - id: "create-ux-design" recommended: true agent: "ux-designer" - command: "create-design" + command: "create-ux-design" note: "Recommended - must integrate with existing UX patterns" - phase: 2 diff --git a/src/modules/bmm/workflows/workflow-status/paths/enterprise-greenfield.yaml b/src/modules/bmm/workflows/workflow-status/paths/enterprise-greenfield.yaml index 82b1e721..cc475f4b 100644 --- a/src/modules/bmm/workflows/workflow-status/paths/enterprise-greenfield.yaml +++ b/src/modules/bmm/workflows/workflow-status/paths/enterprise-greenfield.yaml @@ -48,10 +48,10 @@ phases: agent: "pm" command: "validate-prd" - - id: "create-design" + - id: "create-ux-design" recommended: true agent: "ux-designer" - command: "create-design" + command: "create-ux-design" note: "Highly recommended for enterprise - design system and patterns" - phase: 2 diff --git a/src/modules/bmm/workflows/workflow-status/paths/method-brownfield.yaml b/src/modules/bmm/workflows/workflow-status/paths/method-brownfield.yaml index f207f52f..c8d25ba0 100644 --- a/src/modules/bmm/workflows/workflow-status/paths/method-brownfield.yaml +++ b/src/modules/bmm/workflows/workflow-status/paths/method-brownfield.yaml @@ -59,10 +59,10 @@ phases: agent: "pm" command: "validate-prd" - - id: "create-design" + - id: "create-ux-design" conditional: "if_has_ui" agent: "ux-designer" - command: "create-design" + command: "create-ux-design" - phase: 2 name: "Solutioning" diff --git a/src/modules/bmm/workflows/workflow-status/paths/method-greenfield.yaml b/src/modules/bmm/workflows/workflow-status/paths/method-greenfield.yaml index 1d1ced9b..bbad70d9 100644 --- a/src/modules/bmm/workflows/workflow-status/paths/method-greenfield.yaml +++ b/src/modules/bmm/workflows/workflow-status/paths/method-greenfield.yaml @@ -48,10 +48,10 @@ phases: command: "validate-prd" note: "Quality check for PRD completeness" - - id: "create-design" + - id: "create-ux-design" conditional: "if_has_ui" agent: "ux-designer" - command: "create-design" + command: "create-ux-design" note: "Determined after PRD - user/agent decides if needed" - phase: 2