bmad-method 6.0.0-alpha.3 → 6.0.0-alpha.5

package/bmad/bmm/workflows/2-plan-workflows/create-ux-design/ux-design-template.md

@@ -0,0 +1,145 @@
+# {{project_name}} UX Design Specification
+
+_Created on {{date}} by {{user_name}}_
+_Generated using BMad Method - Create UX Design Workflow v1.0_
+
+---
+
+## Executive Summary
+
+{{project_vision}}
+
+---
+
+## 1. Design System Foundation
+
+### 1.1 Design System Choice
+
+{{design_system_decision}}
+
+---
+
+## 2. Core User Experience
+
+### 2.1 Defining Experience
+
+{{core_experience}}
+
+### 2.2 Novel UX Patterns
+
+{{novel_ux_patterns}}
+
+---
+
+## 3. Visual Foundation
+
+### 3.1 Color System
+
+{{visual_foundation}}
+
+**Interactive Visualizations:**
+
+- Color Theme Explorer: [ux-color-themes.html](./ux-color-themes.html)
+
+---
+
+## 4. Design Direction
+
+### 4.1 Chosen Design Approach
+
+{{design_direction_decision}}
+
+**Interactive Mockups:**
+
+- Design Direction Showcase: [ux-design-directions.html](./ux-design-directions.html)
+
+---
+
+## 5. User Journey Flows
+
+### 5.1 Critical User Paths
+
+{{user_journey_flows}}
+
+---
+
+## 6. Component Library
+
+### 6.1 Component Strategy
+
+{{component_library_strategy}}
+
+---
+
+## 7. UX Pattern Decisions
+
+### 7.1 Consistency Rules
+
+{{ux_pattern_decisions}}
+
+---
+
+## 8. Responsive Design & Accessibility
+
+### 8.1 Responsive Strategy
+
+{{responsive_accessibility_strategy}}
+
+---
+
+## 9. Implementation Guidance
+
+### 9.1 Completion Summary
+
+{{completion_summary}}
+
+---
+
+## Appendix
+
+### Related Documents
+
+- Product Requirements: `{{prd_file}}`
+- Product Brief: `{{brief_file}}`
+- Brainstorming: `{{brainstorm_file}}`
+
+### Core Interactive Deliverables
+
+This UX Design Specification was created through visual collaboration:
+
+- **Color Theme Visualizer**: {{color_themes_html}}
+  - Interactive HTML showing all color theme options explored
+  - Live UI component examples in each theme
+  - Side-by-side comparison and semantic color usage
+
+- **Design Direction Mockups**: {{design_directions_html}}
+  - Interactive HTML with 6-8 complete design approaches
+  - Full-screen mockups of key screens
+  - Design philosophy and rationale for each direction
+
+### Optional Enhancement Deliverables
+
+_This section will be populated if additional UX artifacts are generated through follow-up workflows._
+
+<!-- Additional deliverables added here by other workflows -->
+
+### Next Steps & Follow-Up Workflows
+
+This UX Design Specification can serve as input to:
+
+- **Wireframe Generation Workflow** - Create detailed wireframes from user flows
+- **Figma Design Workflow** - Generate Figma files via MCP integration
+- **Interactive Prototype Workflow** - Build clickable HTML prototypes
+- **Component Showcase Workflow** - Create interactive component library
+- **AI Frontend Prompt Workflow** - Generate prompts for v0, Lovable, Bolt, etc.
+- **Solution Architecture Workflow** - Define technical architecture with UX context
+
+### Version History
+
+| Date     | Version | Changes                         | Author        |
+| -------- | ------- | ------------------------------- | ------------- |
+| {{date}} | 1.0     | Initial UX Design Specification | {{user_name}} |
+
+---
+
+_This UX Design Specification was created through collaborative design facilitation, not template generation. All decisions were made with user input and are documented with rationale._

package/bmad/bmm/workflows/2-plan-workflows/create-ux-design/workflow.yaml

@@ -0,0 +1,64 @@
+# Create UX Design Workflow Configuration
+name: create-ux-design
+description: "Collaborative UX design facilitation workflow that creates exceptional user experiences through visual exploration and informed decision-making. Unlike template-driven approaches, this workflow facilitates discovery, generates visual options, and collaboratively designs the UX with the user at every step."
+author: "BMad"
+
+# Critical variables from config
+config_source: "{project-root}/bmad/bmm/config.yaml"
+output_folder: "{config_source}:output_folder"
+user_name: "{config_source}:user_name"
+communication_language: "{config_source}:communication_language"
+document_output_language: "{config_source}:document_output_language"
+user_skill_level: "{config_source}:user_skill_level"
+date: system-generated
+
+# Input requirements - We work from PRD, Brief, or Brainstorming docs
+recommended_inputs:
+  - prd: "Product Requirements Document with features and user journeys"
+  - product_brief: "Product brief with vision and target users"
+  - brainstorming: "Brainstorming documents with ideas and concepts"
+
+# Input file references (fuzzy matched from output folder)
+prd_file: "{output_folder}/bmm-PRD.md or PRD.md or product-requirements.md"
+brief_file: "{output_folder}/product-brief.md or brief.md or project-brief.md"
+brainstorm_file: "{output_folder}/brainstorming.md or brainstorm.md or ideation.md"
+
+# Smart input file references - handles both whole docs and sharded docs
+# Priority: Whole document first, then sharded version
+input_file_patterns:
+  prd:
+    whole: "{output_folder}/*prd*.md"
+    sharded: "{output_folder}/*prd*/index.md"
+
+  product_brief:
+    whole: "{output_folder}/*brief*.md"
+    sharded: "{output_folder}/*brief*/index.md"
+
+  epics:
+    whole: "{output_folder}/*epic*.md"
+    sharded: "{output_folder}/*epic*/index.md"
+
+  brainstorming:
+    whole: "{output_folder}/*brainstorm*.md"
+    sharded: "{output_folder}/*brainstorm*/index.md"
+
+  document_project:
+    sharded: "{output_folder}/docs/index.md"
+
+# Module path and component files
+installed_path: "{project-root}/bmad/bmm/workflows/2-plan-workflows/create-ux-design"
+instructions: "{installed_path}/instructions.md"
+validation: "{installed_path}/checklist.md"
+template: "{installed_path}/ux-design-template.md"
+
+# Knowledge bases for intelligent UX decisions
+ux_pattern_catalog: "{installed_path}/ux-pattern-catalog.yaml"
+color_psychology: "{installed_path}/color-psychology.yaml"
+layout_patterns: "{installed_path}/layout-patterns.yaml"
+
+# Output configuration - Progressive saves throughout workflow
+default_output_file: "{output_folder}/ux-design-specification.md"
+color_themes_html: "{output_folder}/ux-color-themes.html"
+design_directions_html: "{output_folder}/ux-design-directions.html"
+
+standalone: true

package/bmad/bmm/workflows/2-plan-workflows/narrative/checklist.md

@@ -0,0 +1,139 @@
+# Narrative Design Workflow Validation Checklist
+
+**Purpose**: Validate narrative design outputs are complete, cohesive, and ready for implementation.
+
+**Scope**: Story-driven games and applications (follows GDD workflow)
+
+**Expected Output**: narrative-design.md
+
+---
+
+## 1. Output File Exists
+
+- [ ] narrative-design.md created in output folder
+- [ ] GDD.md exists (narrative workflow requires GDD first)
+- [ ] No unfilled {{template_variables}}
+
+---
+
+## 2. Story Foundation
+
+### Core Elements
+
+- [ ] **Narrative premise** clearly stated (elevator pitch, 2-3 sentences)
+- [ ] **Core themes** identified (2-4 meaningful themes)
+- [ ] **Tone and atmosphere** established
+- [ ] Premise is compelling and fits game type
+
+### Story Structure
+
+- [ ] **Story structure chosen** (3-act, hero's journey, branching, etc.)
+- [ ] **Acts/sections broken down** with clear progression
+- [ ] **Major story beats** documented (key moments that drive narrative)
+- [ ] Structure fits narrative complexity level
+
+---
+
+## 3. Characters
+
+### Protagonist(s)
+
+- [ ] Background and motivation explained
+- [ ] Character arc defined (how they change)
+- [ ] Internal and external conflicts identified
+
+### Antagonist(s)
+
+- [ ] Motivation clear (why they oppose protagonist)
+- [ ] Goals and methods explained
+- [ ] Not one-dimensional
+
+### Supporting Cast
+
+- [ ] Major supporting characters documented
+- [ ] Each has distinct role in story
+- [ ] Character relationships mapped
+
+### Character Arcs
+
+- [ ] Major characters have starting → transformation → ending states
+- [ ] Arc progression makes sense
+
+---
+
+## 4. World and Lore
+
+- [ ] **World setting** defined (time, place, world type)
+- [ ] **World rules** explained (magic, technology, society)
+- [ ] **History and backstory** documented
+- [ ] Key locations described with narrative significance
+
+---
+
+## 5. Dialogue and Delivery
+
+### Dialogue Framework
+
+- [ ] Dialogue style established
+- [ ] Key conversations identified
+- [ ] Branching dialogue system described (if applicable)
+
+### Narrative Delivery
+
+- [ ] Cutscenes/cinematics approach defined
+- [ ] In-game storytelling methods explained
+- [ ] Optional vs. required content distinguished
+- [ ] Multiple endings documented (if applicable)
+
+---
+
+## 6. Gameplay Integration
+
+- [ ] **Narrative-gameplay harmony** addressed (how story and mechanics connect)
+- [ ] **Story gates** explained (how narrative controls progression)
+- [ ] **Player agency** level defined (can player affect story?)
+- [ ] Integration doesn't fight game design
+
+---
+
+## 7. Production Scope
+
+- [ ] **Writing scope** estimated (word count, scene count, dialogue lines)
+- [ ] Scope realistic for project level
+- [ ] Localization considerations noted (if applicable)
+- [ ] Voice acting plans documented (if applicable)
+
+---
+
+## 8. Consistency with GDD
+
+- [ ] Narrative aligns with GDD game design
+- [ ] Tone matches GDD art/audio direction
+- [ ] Story supports game mechanics (doesn't contradict)
+- [ ] No conflicts between narrative and gameplay
+
+---
+
+## 9. Critical Failures (Auto-Fail)
+
+- [ ] ❌ **No GDD** (narrative workflow requires GDD first)
+- [ ] ❌ **No character arcs** (protagonist has no development)
+- [ ] ❌ **No story beats** (major moments not identified)
+- [ ] ❌ **Contradicts GDD** (narrative fights game design)
+
+---
+
+## Validation Notes
+
+**Document any findings:**
+
+- Narrative strength: [Compelling / Interesting / Adequate / Weak]
+- Strengths:
+- Issues to address:
+- Recommended actions:
+
+**Ready for solutioning?** [Yes / No - explain]
+
+---
+
+_Adapt based on narrative complexity level (Critical/Heavy/Moderate/Light)._