bmad-method 6.0.0-alpha.0 → 6.0.0-alpha.2

package/src/modules/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/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/workflow.yaml

@@ -0,0 +1,42 @@
+# 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"
+
+# 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/src/modules/bmm/workflows/{2-plan → 2-plan-workflows}/gdd/README.md

@@ -20,12 +20,12 @@ The GDD workflow creates a comprehensive Game Design Document that captures:
 `gdd-template.md` contains sections common to ALL game types:
 
 - Executive Summary
-- Goals & Context
+- Goals and Context
 - Core Gameplay
 - Win/Loss Conditions
-- Progression & Balance
+- Progression and Balance
 - Level Design Framework
-- Art & Audio Direction
+- Art and Audio Direction
 - Technical Specs
 - Development Epics
 - Success Metrics
@@ -53,15 +53,15 @@ Located in `game-types/` folder, these markdown files contain sections specific
 - Movement System (jump mechanics, air control, special moves)
 - Combat System (attack types, combos, enemy AI)
 - Level Design Patterns (platforming challenges, combat arenas)
-- Player Abilities & Unlocks
+- Player Abilities and Unlocks
 
 **rpg.md**:
 
 - Character System (stats, classes, leveling)
-- Inventory & Equipment
+- Inventory and Equipment
 - Quest System
-- World & Exploration
-- NPC & Dialogue
+- World and Exploration
+- NPC and Dialogue
 - Combat System
 
 **puzzle.md**:
@@ -76,8 +76,8 @@ Located in `game-types/` folder, these markdown files contain sections specific
 
 - Run Structure
 - Procedural Generation
-- Permadeath & Progression
-- Item & Upgrade System
+- Permadeath and Progression
+- Item and Upgrade System
 - Character Selection
 - Difficulty Modifiers
 
@@ -98,15 +98,15 @@ Located in `game-types/` folder, these markdown files contain sections specific
    - Stores `game_type` for injection
 
 3. **Universal GDD Sections** (Steps 2-5, 7-13):
-   - Platform & target audience
-   - Goals & context
+   - Platform and target audience
+   - Goals and context
    - Core gameplay (pillars, loop, win/loss)
-   - Mechanics & controls
-   - Progression & balance
+   - Mechanics and controls
+   - Progression and balance
    - Level design
-   - Art & audio
+   - Art and audio
    - Technical specs
-   - Epics & metrics
+   - Epics and metrics
 
 4. **Game-Type Injection** (Step 6):
    - Loads fragment from `game-types/{game_type}.md`
@@ -198,7 +198,7 @@ When a game project completes the GDD and moves to solutioning:
 2. Loads GDD.md instead of PRD.md
 3. Matches game platforms to solutioning `registry.csv` game-\* entries
 4. Provides engine-specific guidance (Unity, Godot, Phaser, etc.)
-5. Generates solution-architecture.md with platform decisions
+5. Generates architecture.md with platform decisions
 6. Creates per-epic tech specs
 
 Example solutioning registry entries:

package/src/modules/bmm/workflows/2-plan-workflows/gdd/checklist.md

@@ -0,0 +1,148 @@
+# GDD Workflow Validation Checklist
+
+**Purpose**: Validate GDD workflow outputs are complete, playable, and ready for solutioning.
+
+**Scope**: All game project levels (0-4)
+
+**Expected Outputs**: GDD.md, epics.md
+
+---
+
+## 1. Output Files Exist
+
+- [ ] GDD.md created in output folder
+- [ ] epics.md created in output folder (separate file)
+- [ ] bmm-workflow-status.md updated
+- [ ] No unfilled {{template_variables}}
+
+---
+
+## 2. Core Gameplay Definition (CRITICAL)
+
+### Game Pillars
+
+- [ ] **2-4 game pillars defined** (fundamental gameplay elements)
+- [ ] Each pillar is game-defining (not superficial)
+- [ ] Pillars are distinct (don't overlap)
+
+### Core Gameplay Loop
+
+- [ ] **Complete cycle documented** (what player does repeatedly)
+- [ ] Loop shows: player action → outcome → reward → motivation to repeat
+- [ ] Loop sounds compelling and repeatable
+
+### Win/Loss Conditions
+
+- [ ] Victory conditions clearly defined
+- [ ] Failure conditions defined (or N/A for sandbox games)
+- [ ] Conditions are testable
+
+---
+
+## 3. Game Mechanics and Systems
+
+### Mechanics
+
+- [ ] Primary mechanics described in detail
+- [ ] Mechanics support the game pillars
+- [ ] Player interaction with mechanics is clear
+
+### Progression
+
+- [ ] Player progression system defined (skill/power/unlock/narrative)
+- [ ] Difficulty curve explained
+- [ ] Progression feels rewarding
+
+### Platform and Controls
+
+- [ ] Target platforms specified
+- [ ] Control scheme appropriate for platforms
+- [ ] Input method clear (keyboard/gamepad/touch/etc.)
+
+---
+
+## 4. Story Quality (If epics.md exists)
+
+### Epic Structure
+
+- [ ] Epics represent deliverable game features
+- [ ] Epic sequence makes sense for game development
+- [ ] Stories show implementation path
+
+### Story Sequencing (If stories present)
+
+- [ ] **Vertical slices**: Each story delivers playable functionality
+- [ ] **Sequential ordering**: Stories build progressively
+- [ ] **No forward dependencies**: Each story builds on previous work only
+- [ ] Stories result in testable game features
+
+---
+
+## 5. Technical Specifications
+
+### Performance and Platform
+
+- [ ] Performance requirements specified (frame rate, resolution, etc.)
+- [ ] Platform-specific considerations noted
+- [ ] Asset requirements estimated
+
+### Production Scope
+
+- [ ] Art requirements realistic for project scale
+- [ ] Audio requirements documented
+- [ ] Scope matches project level and resources
+
+---
+
+## 6. Narrative Integration (If Applicable)
+
+**If narrative-design.md was generated:**
+
+- [ ] Narrative aligns with GDD game design
+- [ ] Story supports gameplay (not fighting it)
+- [ ] Tone consistent across GDD and narrative docs
+
+---
+
+## 7. Consistency
+
+- [ ] Epic titles match between GDD.md and epics.md
+- [ ] Game type identified and appropriate
+- [ ] Terminology consistent throughout
+- [ ] No contradictions between sections
+
+---
+
+## 8. Readiness for Solutioning
+
+- [ ] Sufficient detail for engine/platform selection
+- [ ] Game systems defined enough for technical architecture
+- [ ] Clear what needs to be built
+- [ ] Playable vision (reader can envision playing the game)
+
+---
+
+## 9. Critical Failures (Auto-Fail)
+
+- [ ] ❌ **No core gameplay loop** (can't be a game without this)
+- [ ] ❌ **No game pillars** (game-defining elements missing)
+- [ ] ❌ **No mechanics** (what does player actually DO?)
+- [ ] ❌ **No epics.md file** (implementation roadmap required)
+- [ ] ❌ **Engine/tech in GDD** (should defer to solutioning workflow)
+
+---
+
+## Validation Notes
+
+**Document any findings:**
+
+- Game concept strength: [Compelling / Interesting / Unclear / Weak]
+- Strengths:
+- Issues to address:
+- Recommended actions:
+
+**Ready for solutioning?** [Yes / No - explain]
+
+---
+
+_Adapt based on game type and narrative complexity. Core gameplay must always be solid._

package/src/modules/bmm/workflows/{2-plan → 2-plan-workflows}/gdd/game-types/action-platformer.md

@@ -33,7 +33,7 @@
 - Checkpoint placement
 - Difficulty spikes and pacing
 
-### Player Abilities & Unlocks
+### Player Abilities and Unlocks
 
 {{player_abilities}}
 

package/src/modules/bmm/workflows/{2-plan → 2-plan-workflows}/gdd/game-types/adventure.md

@@ -59,7 +59,7 @@ This game type is **narrative-heavy**. Consider running the Narrative Design wor
 - Companion mechanics (if applicable)
 - Memorable character moments
 
-### Inventory & Items
+### Inventory and Items
 
 {{inventory_items}}
 

package/src/modules/bmm/workflows/{2-plan → 2-plan-workflows}/gdd/game-types/card-game.md

@@ -1,6 +1,6 @@
 ## Card Game Specific Elements
 
-### Card Types & Effects
+### Card Types and Effects
 
 {{card_types}}
 
@@ -50,7 +50,7 @@
 - Time limits per turn
 - Match length targets
 
-### Card Collection & Progression
+### Card Collection and Progression
 
 {{collection_progression}}
 

package/src/modules/bmm/workflows/{2-plan → 2-plan-workflows}/gdd/game-types/fighting.md

@@ -12,7 +12,7 @@
 - Complexity tiers (beginner vs. expert characters)
 - Balance philosophy (everyone viable vs. tier system)
 
-### Move Lists & Frame Data
+### Move Lists and Frame Data
 
 {{moves_frame_data}}
 

package/src/modules/bmm/workflows/{2-plan → 2-plan-workflows}/gdd/game-types/horror.md

@@ -9,7 +9,7 @@ This game type is **narrative-important**. Consider running the Narrative Design
 - Tension pacing and narrative beats
 </narrative-workflow-recommended>
 
-### Atmosphere & Tension Building
+### Atmosphere and Tension Building
 
 {{atmosphere}}
 
@@ -61,7 +61,7 @@ This game type is **narrative-important**. Consider running the Narrative Design
 - Inventory constraints
 - Risk vs. reward of exploration
 
-### Safe Zones & Respite
+### Safe Zones and Respite
 
 {{safe_zones}}
 

package/src/modules/bmm/workflows/{2-plan → 2-plan-workflows}/gdd/game-types/idle-incremental.md

@@ -38,7 +38,7 @@
 - Automation tiers
 - Balance between active and idle play
 
-### Prestige & Reset Mechanics
+### Prestige and Reset Mechanics
 
 {{prestige_reset}}
 

package/src/modules/bmm/workflows/{2-plan → 2-plan-workflows}/gdd/game-types/moba.md

@@ -13,7 +13,7 @@
 - Visual and thematic diversity
 - Counter-pick dynamics
 
-### Lane Structure & Map
+### Lane Structure and Map
 
 {{lane_map}}
 
@@ -25,7 +25,7 @@
 - Spawn points and fountains
 - Vision mechanics (wards, fog of war)
 
-### Item & Build System
+### Item and Build System
 
 {{item_build}}
 
@@ -37,7 +37,7 @@
 - Situational itemization
 - Starting items vs. late-game items
 
-### Team Composition & Roles
+### Team Composition and Roles
 
 {{team_composition}}
 
@@ -61,7 +61,7 @@
 - Phase transition mechanics
 - Comeback mechanics
 
-### Objectives & Win Conditions
+### Objectives and Win Conditions
 
 {{objectives_victory}}
 

package/src/modules/bmm/workflows/{2-plan → 2-plan-workflows}/gdd/game-types/party-game.md

@@ -52,7 +52,7 @@
 - Player join/drop mechanics
 - Tutorial integration for new players
 
-### Accessibility & Skill Range
+### Accessibility and Skill Range
 
 {{accessibility}}
 

package/src/modules/bmm/workflows/{2-plan → 2-plan-workflows}/gdd/game-types/racing.md

@@ -1,6 +1,6 @@
 ## Racing Game Specific Elements
 
-### Vehicle Handling & Physics
+### Vehicle Handling and Physics
 
 {{vehicle_physics}}
 
@@ -50,7 +50,7 @@
 - Pit stops (if applicable)
 - Weather and time-of-day effects
 
-### Powerups & Boost
+### Powerups and Boost
 
 {{powerups_boost}}
 
@@ -75,7 +75,7 @@
 - Career/campaign mode
 - Online multiplayer modes
 
-### Progression & Unlocks
+### Progression and Unlocks
 
 {{progression}}
 

package/src/modules/bmm/workflows/{2-plan → 2-plan-workflows}/gdd/game-types/rhythm.md

@@ -13,7 +13,7 @@
 - Lane systems (4-key, 6-key, circular, etc.)
 - Offset calibration
 
-### Note Charts & Patterns
+### Note Charts and Patterns
 
 {{note_charts}}
 

package/src/modules/bmm/workflows/{2-plan → 2-plan-workflows}/gdd/game-types/roguelike.md

@@ -23,7 +23,7 @@
 - Biome/theme variation
 - Seed system (if deterministic)
 
-### Permadeath & Progression
+### Permadeath and Progression
 
 {{permadeath_progression}}
 
@@ -34,7 +34,7 @@
 - Meta-progression systems
 - Unlock conditions
 
-### Item & Upgrade System
+### Item and Upgrade System
 
 {{item_upgrade_system}}
 

package/src/modules/bmm/workflows/{2-plan → 2-plan-workflows}/gdd/game-types/rpg.md

@@ -11,7 +11,7 @@
 - Leveling system
 - Skill trees
 
-### Inventory & Equipment
+### Inventory and Equipment
 
 {{inventory_equipment}}
 
@@ -34,7 +34,7 @@
 - Branching questlines
 - Quest rewards
 
-### World & Exploration
+### World and Exploration
 
 {{world_exploration}}
 
@@ -46,7 +46,7 @@
 - Fast travel system
 - Points of interest
 
-### NPC & Dialogue
+### NPC and Dialogue
 
 {{npc_dialogue}}
 

package/src/modules/bmm/workflows/{2-plan → 2-plan-workflows}/gdd/game-types/sandbox.md

@@ -13,7 +13,7 @@
 - Undo/redo system
 - Import/export functionality
 
-### Physics & Building Systems
+### Physics and Building Systems
 
 {{physics_building}}
 
@@ -26,7 +26,7 @@
 - Constraint systems (joints, hinges, motors)
 - Interactive simulations
 
-### Sharing & Community
+### Sharing and Community
 
 {{sharing_community}}
 
@@ -39,7 +39,7 @@
 - Modding support
 - User-generated content moderation
 
-### Constraints & Rules
+### Constraints and Rules
 
 {{constraints_rules}}
 
@@ -52,7 +52,7 @@
 - Rulesets and game modes
 - Victory conditions (if applicable)
 
-### Tools & Editing
+### Tools and Editing
 
 {{tools_editing}}
 

package/src/modules/bmm/workflows/{2-plan → 2-plan-workflows}/gdd/game-types/shooter.md

@@ -12,7 +12,7 @@
 - Weapon feel (recoil patterns, sound design, impact feedback)
 - Balance considerations (risk/reward, situational use)
 
-### Aiming & Combat Mechanics
+### Aiming and Combat Mechanics
 
 {{aiming_combat}}
 
@@ -24,7 +24,7 @@
 - Critical hits / weak points
 - Melee integration (if applicable)
 
-### Enemy Design & AI
+### Enemy Design and AI
 
 {{enemy_ai}}
 
@@ -36,7 +36,7 @@
 - Difficulty scaling (health, damage, AI sophistication)
 - Enemy tells and telegraphing
 
-### Arena & Level Design
+### Arena and Level Design
 
 {{arena_level_design}}