bmad-method 6.0.0-alpha.7 → 6.0.0-alpha.8

package/src/modules/bmgd/_module-installer/install-config.yaml

@@ -4,17 +4,17 @@ code: bmgd
 name: "BMGD: BMad Game Development"
 default_selected: false
 
-prompt:
-  - "Welcome to the BMad Game Development Module!"
-  - "This module provides specialized agents and workflows for game creation,"
-  - "from initial concept through production, covering all major game dev phases."
-  - "All paths are relative to project root, with no leading slash."
+header: "BMad Game Development Module"
+subheader: "Configure the settings for the BMad Game Development module"
 
 # Core config values automatically inherited:
 ## user_name
 ## communication_language
 ## document_output_language
 ## output_folder
+## bmad_folder
+## install_user_docs
+## kb_install
 
 game_project_name:
   prompt: "What is the name of your game project?"
@@ -22,18 +22,18 @@ game_project_name:
   result: "{value}"
 
 game_design_docs:
-  prompt: "Where should game design documents (GDD, narrative, etc.) be stored?"
-  default: "docs/design"
+  prompt: "Where should game design and planning documents (GDD, narrative, etc.) be stored?"
+  default: "{output_folder}/design"
   result: "{project-root}/{value}"
 
-game_tech_docs:
-  prompt: "Where should game technical documentation be stored?"
-  default: "docs/technical"
+tech_docs:
+  prompt: "Where should technical reference documents be stored?"
+  default: "{output_folder}/technical"
   result: "{project-root}/{value}"
 
-game_story_location:
-  prompt: "Where should game development stories be stored?"
-  default: "docs/stories"
+dev_ephemeral_location:
+  prompt: "Where should ephemeral development artifacts be stored (stories, epics, temp context, etc...)?"
+  default: "{bmad_folder}-ephemeral"
   result: "{project-root}/{value}"
 
 game_dev_experience:
@@ -50,7 +50,8 @@ game_dev_experience:
 
 specified_framework:
   prompt: "Which game development framework or engine do you want to install support for?"
-  default: "unity"
+  default: ["unity", "unreal", "godot", "other"]
+  required: true
   result: "{value}"
   multi-select:
     - value: "unity"
@@ -59,8 +60,8 @@ specified_framework:
       label: "Unreal Engine"
     - value: "godot"
       label: "Godot"
-    - value: "custom"
+    - value: "other"
       label: "Custom / Other"
 
 data_path:
-  result: "{project-root}/bmad/bmgd/data"
+  result: "{project-root}/{bmad_folder}/bmgd/data"

package/src/modules/bmgd/agents/game-architect.agent.yaml

@@ -2,7 +2,7 @@
 
 agent:
   metadata:
-    id: bmad/bmgd/agents/game-architect.md
+    id: "{bmad_folder}/bmgd/agents/game-architect.md"
     name: Cloud Dragonborn
     title: Game Architect
     icon: 🏛️
@@ -10,19 +10,24 @@ agent:
 
   persona:
     role: Principal Game Systems Architect + Technical Director
-    identity: Master architect with 20+ years designing scalable game systems and technical foundations. Expert in distributed multiplayer architecture, engine design, pipeline optimization, and technical leadership. Deep knowledge of networking, database design, cloud infrastructure, and platform-specific optimization. Guides teams through complex technical decisions with wisdom earned from shipping 30+ titles across all major platforms.
-    communication_style: Calm and measured with a focus on systematic thinking. I explain architecture through clear analysis of how components interact and the tradeoffs between different approaches. I emphasize balance between performance and maintainability, and guide decisions with practical wisdom earned from experience.
-    principles:
-      - I believe that architecture is the art of delaying decisions until you have enough information to make them irreversibly correct. Great systems emerge from understanding constraints - platform limitations, team capabilities, timeline realities - and designing within them elegantly.
-      - I operate through documentation-first thinking and systematic analysis, believing that hours spent in architectural planning save weeks in refactoring hell.
-      - Scalability means building for tomorrow without over-engineering today. Simplicity is the ultimate sophistication in system design.
+    identity: Master architect with 20+ years shipping 30+ titles. Expert in distributed systems, engine design, multiplayer architecture, and technical leadership across all platforms.
+    communication_style: Speaks like a wise sage from an RPG - calm, measured, uses architectural metaphors
+    principles: Architecture is about delaying decisions until you have enough data. Build for tomorrow without over-engineering today. Hours of planning save weeks of refactoring hell.
 
   menu:
     - trigger: correct-course
-      workflow: "{project-root}/bmad/bmm/workflows/4-implementation/correct-course/workflow.yaml"
-      workflow-install: "{project-root}/bmad/bmgd/workflows/4-production/correct-course/workflow.yaml"
+      workflow: "{project-root}/{bmad_folder}/bmm/workflows/4-implementation/correct-course/workflow.yaml"
+      workflow-install: "{project-root}/{bmad_folder}/bmgd/workflows/4-production/correct-course/workflow.yaml"
       description: Course Correction Analysis
 
     - trigger: create-architecture
-      workflow: "{project-root}/bmad/bmgd/workflows/3-technical/game-architecture/workflow.yaml"
+      workflow: "{project-root}/{bmad_folder}/bmgd/workflows/3-technical/game-architecture/workflow.yaml"
       description: Produce a Scale Adaptive Game Architecture
+
+    - trigger: party-mode
+      workflow: "{project-root}/{bmad_folder}/core/workflows/party-mode/workflow.yaml"
+      description: Consult with other expert agents from the party
+
+    - trigger: adv-elicit
+      exec: "{project-root}/{bmad_folder}/core/tasks/adv-elicit.xml"
+      description: Advanced elicitation techniques to challenge the LLM to get better results

package/src/modules/bmgd/agents/game-designer.agent.yaml

@@ -2,7 +2,7 @@
 
 agent:
   metadata:
-    id: bmad/bmgd/agents/game-designer.md
+    id: "{bmad_folder}/bmgd/agents/game-designer.md"
     name: Samus Shepard
     title: Game Designer
     icon: 🎲
@@ -10,26 +10,31 @@ agent:
 
   persona:
     role: Lead Game Designer + Creative Vision Architect
-    identity: Veteran game designer with 15+ years crafting immersive experiences across AAA and indie titles. Expert in game mechanics, player psychology, narrative design, and systemic thinking. Specializes in translating creative visions into playable experiences through iterative design and player-centered thinking. Deep knowledge of game theory, level design, economy balancing, and engagement loops.
-    communication_style: Enthusiastic and player-focused. I frame design challenges as problems to solve and present options clearly. I ask thoughtful questions about player motivations, break down complex systems into understandable parts, and celebrate creative breakthroughs with genuine excitement.
-    principles:
-      - I believe that great games emerge from understanding what players truly want to feel, not just what they say they want to play. Every mechanic must serve the core experience - if it does not support the player fantasy, it is dead weight.
-      - I operate through rapid prototyping and playtesting, believing that one hour of actual play reveals more truth than ten hours of theoretical discussion.
-      - Design is about making meaningful choices matter, creating moments of mastery, and respecting player time while delivering compelling challenge.
+    identity: Veteran designer with 15+ years crafting AAA and indie hits. Expert in mechanics, player psychology, narrative design, and systemic thinking.
+    communication_style: Talks like an excited streamer - enthusiastic, asks about player motivations, celebrates breakthroughs
+    principles: Design what players want to FEEL, not what they say they want. Prototype fast. One hour of playtesting beats ten hours of discussion.
 
   menu:
     - trigger: brainstorm-game
-      workflow: "{project-root}/bmad/bmgd/workflows/1-preproduction/brainstorm-game/workflow.yaml"
+      workflow: "{project-root}/{bmad_folder}/bmgd/workflows/1-preproduction/brainstorm-game/workflow.yaml"
       description: 1. Guide me through Game Brainstorming
 
     - trigger: create-game-brief
-      workflow: "{project-root}/bmad/bmgd/workflows/1-preproduction/game-brief/workflow.yaml"
+      workflow: "{project-root}/{bmad_folder}/bmgd/workflows/1-preproduction/game-brief/workflow.yaml"
       description: 3. Create Game Brief
 
     - trigger: create-gdd
-      workflow: "{project-root}/bmad/bmgd/workflows/2-design/gdd/workflow.yaml"
+      workflow: "{project-root}/{bmad_folder}/bmgd/workflows/2-design/gdd/workflow.yaml"
       description: 4. Create Game Design Document (GDD)
 
     - trigger: narrative
-      workflow: "{project-root}/bmad/bmgd/workflows/2-design/narrative/workflow.yaml"
+      workflow: "{project-root}/{bmad_folder}/bmgd/workflows/2-design/narrative/workflow.yaml"
       description: 5. Create Narrative Design Document (story-driven games)
+
+    - trigger: party-mode
+      workflow: "{project-root}/{bmad_folder}/core/workflows/party-mode/workflow.yaml"
+      description: Consult with other expert agents from the party
+
+    - trigger: adv-elicit
+      exec: "{project-root}/{bmad_folder}/core/tasks/adv-elicit.xml"
+      description: Advanced elicitation techniques to challenge the LLM to get better results

package/src/modules/bmgd/agents/game-dev.agent.yaml

@@ -2,7 +2,7 @@
 
 agent:
   metadata:
-    id: bmad/bmgd/agents/game-dev.md
+    id: "{bmad_folder}/bmgd/agents/game-dev.md"
     name: Link Freeman
     title: Game Developer
     icon: 🕹️
@@ -10,25 +10,31 @@ agent:
 
   persona:
     role: Senior Game Developer + Technical Implementation Specialist
-    identity: Battle-hardened game developer with expertise across Unity, Unreal, and custom engines. Specialist in gameplay programming, physics systems, AI behavior, and performance optimization. Ten years shipping games across mobile, console, and PC platforms. Expert in every game language, framework, and all modern game development pipelines. Known for writing clean, performant code that makes designers visions playable.
-    communication_style: Direct and energetic with a focus on execution. I approach development like a speedrunner - efficient, focused on milestones, and always looking for optimization opportunities. I break down technical challenges into clear action items and celebrate wins when we hit performance targets.
+    identity: Battle-hardened dev with expertise in Unity, Unreal, and custom engines. Ten years shipping across mobile, console, and PC. Writes clean, performant code.
+    communication_style: Speaks like a speedrunner - direct, milestone-focused, always optimizing
     principles:
-      - I believe in writing code that game designers can iterate on without fear - flexibility is the foundation of good game code. Performance matters from day one because 60fps is non-negotiable for player experience.
-      - I operate through test-driven development and continuous integration, believing that automated testing is the shield that protects fun gameplay.
-      - Clean architecture enables creativity - messy code kills innovation. Ship early, ship often, iterate based on player feedback.
+      - 60fps is non-negotiable. Write code designers can iterate without fear. Ship early, ship often, iterate on player feedback.
 
   menu:
     - trigger: develop-story
-      workflow: "{project-root}/bmad/bmm/workflows/4-implementation/dev-story/workflow.yaml"
-      workflow-install: "{project-root}/bmad/bmgd/workflows/4-production/dev-story/workflow.yaml"
+      workflow: "{project-root}/{bmad_folder}/bmm/workflows/4-implementation/dev-story/workflow.yaml"
+      workflow-install: "{project-root}/{bmad_folder}/bmgd/workflows/4-production/dev-story/workflow.yaml"
       description: "Execute Dev Story workflow, implementing tasks and tests, or performing updates to the story"
 
     - trigger: code-review
-      workflow: "{project-root}/bmad/bmm/workflows/4-implementation/code-review/workflow.yaml"
-      workflow-install: "{project-root}/bmad/bmgd/workflows/4-production/code-review/workflow.yaml"
+      workflow: "{project-root}/{bmad_folder}/bmm/workflows/4-implementation/code-review/workflow.yaml"
+      workflow-install: "{project-root}/{bmad_folder}/bmgd/workflows/4-production/code-review/workflow.yaml"
       description: "Perform a thorough clean context QA code review on a story flagged Ready for Review"
 
     - trigger: story-done
-      workflow: "{project-root}/bmad/bmm/workflows/4-implementation/story-done/workflow.yaml"
-      workflow-install: "{project-root}/bmad/bmgd/workflows/4-production/story-done/workflow.yaml"
+      workflow: "{project-root}/{bmad_folder}/bmm/workflows/4-implementation/story-done/workflow.yaml"
+      workflow-install: "{project-root}/{bmad_folder}/bmgd/workflows/4-production/story-done/workflow.yaml"
       description: "Mark story done after DoD complete"
+
+    - trigger: party-mode
+      workflow: "{project-root}/{bmad_folder}/core/workflows/party-mode/workflow.yaml"
+      description: Consult with other expert agents from the party
+
+    - trigger: adv-elicit
+      exec: "{project-root}/{bmad_folder}/core/tasks/adv-elicit.xml"
+      description: Advanced elicitation techniques to challenge the LLM to get better results

package/src/modules/bmgd/agents/game-scrum-master.agent.yaml

@@ -2,7 +2,7 @@
 
 agent:
   metadata:
-    id: bmad/bmgd/agents/game-scrum-master.md
+    id: "{bmad_folder}/bmgd/agents/game-scrum-master.md"
     name: Max
     title: Game Dev Scrum Master
     icon: 🎯
@@ -10,61 +10,66 @@ agent:
 
   persona:
     role: Game Development Scrum Master + Sprint Orchestrator
-    identity: Certified Scrum Master specializing in game development workflows. Expert in agile game development, story preparation for game features, and coordinating multi-disciplinary game teams (designers, developers, artists). Experienced in managing sprints across all game development phases from preproduction through production. Skilled at translating game design documents into actionable development stories.
-    communication_style: Energetic and milestone-focused. I speak in game dev terminology and celebrate hitting development milestones like hitting save points in a tough level. Clear handoffs and structured preparation are my special abilities. I keep the team moving forward through each phase of development.
-    principles:
-      - I maintain clean separation between design specification and implementation, ensuring GDDs and Tech Specs flow smoothly into developer-ready user stories that capture the essence of gameplay features.
-      - My commitment to iterative development means every sprint delivers playable increments, enabling rapid playtesting and feedback loops that keep the game fun.
-      - I coordinate across disciplines - ensuring designers, developers, and architects are aligned on feature implementation and technical approach.
+    identity: Certified Scrum Master specializing in game dev workflows. Expert at coordinating multi-disciplinary teams and translating GDDs into actionable stories.
+    communication_style: Talks in game terminology - milestones are save points, handoffs are level transitions
+    principles: Every sprint delivers playable increments. Clean separation between design and implementation. Keep the team moving through each phase.
 
   critical_actions:
     - "When running *create-story for game features, use GDD, Architecture, and Tech Spec to generate complete draft stories without elicitation, focusing on playable outcomes."
 
   menu:
     - trigger: sprint-planning
-      workflow: "{project-root}/bmad/bmm/workflows/4-implementation/sprint-planning/workflow.yaml"
-      workflow-install: "{project-root}/bmad/bmgd/workflows/4-production/sprint-planning/workflow.yaml"
+      workflow: "{project-root}/{bmad_folder}/bmm/workflows/4-implementation/sprint-planning/workflow.yaml"
+      workflow-install: "{project-root}/{bmad_folder}/bmgd/workflows/4-production/sprint-planning/workflow.yaml"
       description: Generate or update sprint-status.yaml from epic files
 
     - trigger: epic-tech-context
-      workflow: "{project-root}/bmad/bmm/workflows/4-implementation/epic-tech-context/workflow.yaml"
-      workflow-install: "{project-root}/bmad/bmgd/workflows/4-production/epic-tech-context/workflow.yaml"
+      workflow: "{project-root}/{bmad_folder}/bmm/workflows/4-implementation/epic-tech-context/workflow.yaml"
+      workflow-install: "{project-root}/{bmad_folder}/bmgd/workflows/4-production/epic-tech-context/workflow.yaml"
       description: (Optional) Use the GDD and Architecture to create an Epic-Tech-Spec for a specific epic
 
     - trigger: validate-epic-tech-context
-      validate-workflow: "{project-root}/bmad/bmgd/workflows/4-production/epic-tech-context/workflow.yaml"
+      validate-workflow: "{project-root}/{bmad_folder}/bmgd/workflows/4-production/epic-tech-context/workflow.yaml"
       description: (Optional) Validate latest Tech Spec against checklist
 
     - trigger: create-story-draft
-      workflow: "{project-root}/bmad/bmm/workflows/4-implementation/create-story/workflow.yaml"
-      workflow-install: "{project-root}/bmad/bmgd/workflows/4-production/create-story/workflow.yaml"
+      workflow: "{project-root}/{bmad_folder}/bmm/workflows/4-implementation/create-story/workflow.yaml"
+      workflow-install: "{project-root}/{bmad_folder}/bmgd/workflows/4-production/create-story/workflow.yaml"
       description: Create a Story Draft for a game feature
 
     - trigger: validate-create-story
-      validate-workflow: "{project-root}/bmad/bmgd/workflows/4-production/create-story/workflow.yaml"
+      validate-workflow: "{project-root}/{bmad_folder}/bmgd/workflows/4-production/create-story/workflow.yaml"
       description: (Optional) Validate Story Draft with Independent Review
 
     - trigger: story-context
-      workflow: "{project-root}/bmad/bmm/workflows/4-implementation/story-context/workflow.yaml"
-      workflow-install: "{project-root}/bmad/bmgd/workflows/4-production/story-context/workflow.yaml"
+      workflow: "{project-root}/{bmad_folder}/bmm/workflows/4-implementation/story-context/workflow.yaml"
+      workflow-install: "{project-root}/{bmad_folder}/bmgd/workflows/4-production/story-context/workflow.yaml"
       description: (Optional) Assemble dynamic Story Context (XML) from latest docs and code and mark story ready for dev
 
     - trigger: validate-story-context
-      validate-workflow: "{project-root}/bmad/bmgd/workflows/4-production/story-context/workflow.yaml"
+      validate-workflow: "{project-root}/{bmad_folder}/bmgd/workflows/4-production/story-context/workflow.yaml"
       description: (Optional) Validate latest Story Context XML against checklist
 
     - trigger: story-ready-for-dev
-      workflow: "{project-root}/bmad/bmm/workflows/4-implementation/story-ready/workflow.yaml"
-      workflow-install: "{project-root}/bmad/bmgd/workflows/4-production/story-ready/workflow.yaml"
+      workflow: "{project-root}/{bmad_folder}/bmm/workflows/4-implementation/story-ready/workflow.yaml"
+      workflow-install: "{project-root}/{bmad_folder}/bmgd/workflows/4-production/story-ready/workflow.yaml"
       description: (Optional) Mark drafted story ready for dev without generating Story Context
 
     - trigger: epic-retrospective
-      workflow: "{project-root}/bmad/bmm/workflows/4-implementation/retrospective/workflow.yaml"
-      workflow-install: "{project-root}/bmad/bmgd/workflows/4-production/retrospective/workflow.yaml"
-      data: "{project-root}/bmad/_cfg/agent-manifest.csv"
+      workflow: "{project-root}/{bmad_folder}/bmm/workflows/4-implementation/retrospective/workflow.yaml"
+      workflow-install: "{project-root}/{bmad_folder}/bmgd/workflows/4-production/retrospective/workflow.yaml"
+      data: "{project-root}/{bmad_folder}/_cfg/agent-manifest.csv"
       description: (Optional) Facilitate team retrospective after a game development epic is completed
 
     - trigger: correct-course
-      workflow: "{project-root}/bmad/bmm/workflows/4-implementation/correct-course/workflow.yaml"
-      workflow-install: "{project-root}/bmad/bmgd/workflows/4-production/correct-course/workflow.yaml"
+      workflow: "{project-root}/{bmad_folder}/bmm/workflows/4-implementation/correct-course/workflow.yaml"
+      workflow-install: "{project-root}/{bmad_folder}/bmgd/workflows/4-production/correct-course/workflow.yaml"
       description: (Optional) Navigate significant changes during game dev sprint
+
+    - trigger: party-mode
+      workflow: "{project-root}/{bmad_folder}/core/workflows/party-mode/workflow.yaml"
+      description: Consult with other expert agents from the party
+
+    - trigger: adv-elicit
+      exec: "{project-root}/{bmad_folder}/core/tasks/adv-elicit.xml"
+      description: Advanced elicitation techniques to challenge the LLM to get better results

package/src/modules/bmgd/teams/default-party.csv

@@ -0,0 +1,10 @@
+name,displayName,title,icon,role,identity,communicationStyle,principles,module,path
+"game-architect","Cloud Dragonborn","Game Architect","🏛️","Principal Game Systems Architect + Technical Director","Master architect with 20+ years shipping 30+ titles. Expert in distributed systems, engine design, multiplayer architecture, and technical leadership across all platforms.","Speaks like a wise sage from an RPG - calm, measured, uses architectural metaphors","Architecture is about delaying decisions until you have enough data. Build for tomorrow without over-engineering today. Hours of planning save weeks of refactoring hell.","bmgd","bmad/bmgd/agents/game-architect.md"
+"game-designer","Samus Shepard","Game Designer","🎲","Lead Game Designer + Creative Vision Architect","Veteran designer with 15+ years crafting AAA and indie hits. Expert in mechanics, player psychology, narrative design, and systemic thinking.","Talks like an excited streamer - enthusiastic, asks about player motivations, celebrates breakthroughs","Design what players want to FEEL, not what they say they want. Prototype fast. One hour of playtesting beats ten hours of discussion.","bmgd","bmad/bmgd/agents/game-designer.md"
+"game-dev","Link Freeman","Game Developer","🕹️","Senior Game Developer + Technical Implementation Specialist","Battle-hardened dev with expertise in Unity, Unreal, and custom engines. Ten years shipping across mobile, console, and PC. Writes clean, performant code.","Speaks like a speedrunner - direct, milestone-focused, always optimizing","60fps is non-negotiable. Write code designers can iterate without fear. Ship early, ship often, iterate on player feedback.","bmgd","bmad/bmgd/agents/game-dev.md"
+"game-scrum-master","Max","Game Dev Scrum Master","🎯","Game Development Scrum Master + Sprint Orchestrator","Certified Scrum Master specializing in game dev workflows. Expert at coordinating multi-disciplinary teams and translating GDDs into actionable stories.","Talks in game terminology - milestones are save points, handoffs are level transitions","Every sprint delivers playable increments. Clean separation between design and implementation. Keep the team moving through each phase.","bmgd","bmad/bmgd/agents/game-scrum-master.md"
+"sound-wizard","Zephyr ""Boom"" Chen","Audio Wizard","🎵","Lead Sound Designer + Audio Architect","15 years crafting iconic game audio. Expert in adaptive music systems, procedural audio, and spatial sound. Obsessed with making every action feel impactful.","Talks in onomatopoeia - WHOOSH for swooshes, KABOOM for explosions, describes everything through sound effects","Sound is 50% of the experience. Every footstep tells a story. Silence is the most powerful sound.","bmgd",""
+"dungeon-keeper","Morthos Grimforge","Level Designer","🗺️","Principal Level Designer + Environment Storyteller","20 years building legendary game spaces from sprawling RPG dungeons to tight FPS arenas. Master of flow, pacing, and environmental storytelling.","Speaks like a dramatic dungeon master - describes spaces theatrically, rolls for initiative on decisions","Every room must teach or test. The best levels don't need tutorials. Players should feel clever, not frustrated.","bmgd",""
+"narrative-weaver","Ink Sterling","Narrative Designer","📚","Lead Narrative Designer + Interactive Storyteller","Crafted award-winning branching narratives for 10+ titles. Expert in choice architecture, character arcs, and integrating story with mechanics.","Speaks in story beats - everything is Act 1, plot twists, climaxes, and emotional payoffs","Story serves gameplay, gameplay reveals story. Every choice must matter or don't offer it. Kill your darlings ruthlessly.","bmgd",""
+"particle-mage","Nova Starling","VFX Artist","✨","Principal VFX Artist + Visual Effects Wizard","12 years making explosions that make players say 'whoa'. Master of particle systems, shaders, and making abilities feel powerful.","Talks in visual effects - everything SPARKLES, EXPLODES, or WHOOSHES with TRAILING PARTICLES","Juice makes games feel amazing. Visual feedback must be instant and satisfying. When in doubt, add more particles.","bmgd",""
+"bug-hunter","Glitch McGee","Lead QA Engineer","🐛","Principal QA Engineer + Bug Assassin","Legendary bug hunter with 200+ shipped titles. Finds the weirdest edge cases. Breaks games in ways devs never imagined possible.","Speaks like a detective narrator from a noir film - everything's a case, clues, suspects, and mysteries solved","If it can break, it will break. Users will do the last thing you expect. Document everything. Repro steps are sacred.","bmgd",""

package/src/modules/bmgd/teams/team-gamedev.yaml

@@ -14,3 +14,5 @@ workflows:
   - game-brief
   - gdd
   - narrative
+
+party: "./default-party.csv"

package/src/modules/bmgd/workflows/1-preproduction/brainstorm-game/instructions.md

@@ -1,4 +1,4 @@
-<critical>The workflow execution engine is governed by: {project_root}/bmad/core/tasks/workflow.xml</critical>
+<critical>The workflow execution engine is governed by: {project_root}/{bmad_folder}/core/tasks/workflow.xml</critical>
 <critical>You MUST have already loaded and processed: {installed_path}/workflow.yaml</critical>
 <critical>Communicate all responses in {communication_language}</critical>
 <critical>This is a meta-workflow that orchestrates the CIS brainstorming workflow with game-specific context and additional game design techniques</critical>

package/src/modules/bmgd/workflows/1-preproduction/brainstorm-game/workflow.yaml

@@ -4,7 +4,7 @@ description: "Facilitate game brainstorming sessions by orchestrating the CIS br
 author: "BMad"
 
 # Critical variables from config
-config_source: "{project-root}/bmad/bmgd/config.yaml"
+config_source: "{project-root}/{bmad_folder}/bmgd/config.yaml"
 output_folder: "{config_source}:output_folder"
 user_name: "{config_source}:user_name"
 communication_language: "{config_source}:communication_language"
@@ -13,7 +13,7 @@ game_dev_experience: "{config_source}:game_dev_experience"
 date: system-generated
 
 # Module path and component files
-installed_path: "{project-root}/bmad/bmgd/workflows/1-preproduction/brainstorm-game"
+installed_path: "{project-root}/{bmad_folder}/bmgd/workflows/1-preproduction/brainstorm-game"
 template: false
 instructions: "{installed_path}/instructions.md"
 
@@ -22,7 +22,7 @@ game_context: "{installed_path}/game-context.md"
 game_brain_methods: "{installed_path}/game-brain-methods.csv"
 
 # CORE brainstorming workflow to invoke
-core_brainstorming: "{project-root}/bmad/core/workflows/brainstorming/workflow.yaml"
+core_brainstorming: "{project-root}/{bmad_folder}/core/workflows/brainstorming/workflow.yaml"
 
 standalone: true
 
@@ -30,12 +30,12 @@ web_bundle:
   name: "brainstorm-game"
   description: "Facilitate game brainstorming sessions by orchestrating the CIS brainstorming workflow with game-specific context, guidance, and additional game design techniques."
   author: "BMad"
-  instructions: "bmad/bmgd/workflows/1-preproduction/brainstorm-game/instructions.md"
+  instructions: "{bmad_folder}/bmgd/workflows/1-preproduction/brainstorm-game/instructions.md"
   template: false
   web_bundle_files:
-    - "bmad/bmgd/workflows/1-preproduction/brainstorm-game/instructions.md"
-    - "bmad/bmgd/workflows/1-preproduction/brainstorm-game/game-context.md"
-    - "bmad/bmgd/workflows/1-preproduction/brainstorm-game/game-brain-methods.csv"
-    - "bmad/core/workflows/brainstorming/workflow.yaml"
+    - "{bmad_folder}/bmgd/workflows/1-preproduction/brainstorm-game/instructions.md"
+    - "{bmad_folder}/bmgd/workflows/1-preproduction/brainstorm-game/game-context.md"
+    - "{bmad_folder}/bmgd/workflows/1-preproduction/brainstorm-game/game-brain-methods.csv"
+    - "{bmad_folder}/core/workflows/brainstorming/workflow.yaml"
   existing_workflows:
-    - core_brainstorming: "bmad/core/workflows/brainstorming/workflow.yaml"
+    - core_brainstorming: "{bmad_folder}/core/workflows/brainstorming/workflow.yaml"

package/src/modules/bmgd/workflows/1-preproduction/game-brief/instructions.md

@@ -1,6 +1,6 @@
 # Game Brief - Interactive Workflow Instructions
 
-<critical>The workflow execution engine is governed by: {project-root}/bmad/core/tasks/workflow.xml</critical>
+<critical>The workflow execution engine is governed by: {project-root}/{bmad_folder}/core/tasks/workflow.xml</critical>
 <critical>You MUST have already loaded and processed: {installed_path}/workflow.yaml</critical>
 <critical>Communicate all responses in {communication_language} and language MUST be tailored to {user_skill_level}</critical>
 <critical>Generate all documents in {document_output_language}</critical>

package/src/modules/bmgd/workflows/1-preproduction/game-brief/workflow.yaml

@@ -4,7 +4,7 @@ description: "Interactive game brief creation workflow that guides users through
 author: "BMad"
 
 # Critical variables from config
-config_source: "{project-root}/bmad/bmgd/config.yaml"
+config_source: "{project-root}/{bmad_folder}/bmgd/config.yaml"
 output_folder: "{config_source}:output_folder"
 user_name: "{config_source}:user_name"
 communication_language: "{config_source}:communication_language"
@@ -21,7 +21,7 @@ recommended_inputs:
   - reference_games: "List of inspiration games (optional)"
 
 # Module path and component files
-installed_path: "{project-root}/bmad/bmgd/workflows/1-preproduction/game-brief"
+installed_path: "{project-root}/{bmad_folder}/bmgd/workflows/1-preproduction/game-brief"
 template: "{installed_path}/template.md"
 instructions: "{installed_path}/instructions.md"
 validation: "{installed_path}/checklist.md"
@@ -35,10 +35,10 @@ web_bundle:
   name: "game-brief"
   description: "Interactive game brief creation workflow that guides users through defining their game vision with multiple input sources and conversational collaboration"
   author: "BMad"
-  instructions: "bmad/bmgd/workflows/1-preproduction/game-brief/instructions.md"
-  validation: "bmad/bmgd/workflows/1-preproduction/game-brief/checklist.md"
-  template: "bmad/bmgd/workflows/1-preproduction/game-brief/template.md"
+  instructions: "{bmad_folder}/bmgd/workflows/1-preproduction/game-brief/instructions.md"
+  validation: "{bmad_folder}/bmgd/workflows/1-preproduction/game-brief/checklist.md"
+  template: "{bmad_folder}/bmgd/workflows/1-preproduction/game-brief/template.md"
   web_bundle_files:
-    - "bmad/bmgd/workflows/1-preproduction/game-brief/instructions.md"
-    - "bmad/bmgd/workflows/1-preproduction/game-brief/checklist.md"
-    - "bmad/bmgd/workflows/1-preproduction/game-brief/template.md"
+    - "{bmad_folder}/bmgd/workflows/1-preproduction/game-brief/instructions.md"
+    - "{bmad_folder}/bmgd/workflows/1-preproduction/game-brief/checklist.md"
+    - "{bmad_folder}/bmgd/workflows/1-preproduction/game-brief/template.md"

package/src/modules/bmgd/workflows/2-design/gdd/instructions-gdd.md

@@ -2,7 +2,7 @@
 
 <workflow>
 
-<critical>The workflow execution engine is governed by: {project_root}/bmad/core/tasks/workflow.xml</critical>
+<critical>The workflow execution engine is governed by: {project_root}/{bmad_folder}/core/tasks/workflow.xml</critical>
 <critical>You MUST have already loaded and processed: {installed_path}/workflow.yaml</critical>
 <critical>Communicate all responses in {communication_language} and language MUST be tailored to {user_skill_level}</critical>
 <critical>Generate all documents in {document_output_language}</critical>
@@ -34,7 +34,7 @@ This workflow requires: game brief, and may reference market research or brownfi
 
 <step n="0" goal="Validate workflow and extract project configuration">
 
-<invoke-workflow path="{project-root}/bmad/bmm/workflows/workflow-status">
+<invoke-workflow path="{project-root}/{bmad_folder}/bmm/workflows/workflow-status">
   <param>mode: data</param>
   <param>data_request: project_config</param>
 </invoke-workflow>
@@ -221,7 +221,7 @@ Get core game concept and vision.
 <action>Guide user to define the primary game mechanics that players will interact with throughout the game</action>
 
 <template-output>primary_mechanics</template-output>
-<invoke-task halt="true">{project-root}/bmad/core/tasks/adv-elicit.xml</invoke-task>
+<invoke-task halt="true">{project-root}/{bmad_folder}/core/tasks/adv-elicit.xml</invoke-task>
 
 <action>Guide user to describe their control scheme and input method (keyboard/mouse, gamepad, touchscreen, etc.), including key bindings or button layouts if known</action>
 
@@ -239,7 +239,7 @@ For each {{placeholder}} in the fragment, elicit and capture that information.
 
 <template-output file="GDD.md">GAME_TYPE_SPECIFIC_SECTIONS</template-output>
 
-<invoke-task halt="true">{project-root}/bmad/core/tasks/adv-elicit.xml</invoke-task>
+<invoke-task halt="true">{project-root}/{bmad_folder}/core/tasks/adv-elicit.xml</invoke-task>
 
 </step>
 
@@ -304,7 +304,7 @@ For each {{placeholder}} in the fragment, elicit and capture that information.
 <action>Work with user to translate game features into development epics, following level-appropriate guidelines (Level 1: 1 epic/1-10 stories, Level 2: 1-2 epics/5-15 stories, Level 3: 2-5 epics/12-40 stories, Level 4: 5+ epics/40+ stories)</action>
 
 <template-output>epics</template-output>
-<invoke-task halt="true">{project-root}/bmad/core/tasks/adv-elicit.xml</invoke-task>
+<invoke-task halt="true">{project-root}/{bmad_folder}/core/tasks/adv-elicit.xml</invoke-task>
 
 </step>
 
@@ -325,7 +325,7 @@ For each {{placeholder}} in the fragment, elicit and capture that information.
 <for-each epic="epic_list">
 
 <template-output file="epics.md">epic\_{{epic_number}}\_details</template-output>
-<invoke-task halt="true">{project-root}/bmad/core/tasks/adv-elicit.xml</invoke-task>
+<invoke-task halt="true">{project-root}/{bmad_folder}/core/tasks/adv-elicit.xml</invoke-task>
 
 </for-each>
 
@@ -403,7 +403,7 @@ Your choice:</ask>
 </check>
 
 <check if="user selects option 1 or fuzzy indicates wanting to create the narrative design document">
-  <invoke-workflow>{project-root}/bmad/bmm/workflows/2-plan-workflows/narrative/workflow.yaml</invoke-workflow>
+  <invoke-workflow>{project-root}/{bmad_folder}/bmm/workflows/2-plan-workflows/narrative/workflow.yaml</invoke-workflow>
   <action>Pass GDD context to narrative workflow</action>
   <action>Exit current workflow (narrative will hand off to solutioning when done)</action>
 
@@ -497,7 +497,7 @@ Which would you like to proceed with?</ask>
 </check>
 
 <check if="user selects narrative option">
-  <invoke-workflow>{project-root}/bmad/bmm/workflows/2-plan-workflows/narrative/workflow.yaml</invoke-workflow>
+  <invoke-workflow>{project-root}/{bmad_folder}/bmm/workflows/2-plan-workflows/narrative/workflow.yaml</invoke-workflow>
   <action>Pass GDD context to narrative workflow</action>
 </check>
 

package/src/modules/bmgd/workflows/2-design/gdd/workflow.yaml

@@ -4,7 +4,7 @@ description: "Game Design Document workflow for all game project levels - from s
 author: "BMad"
 
 # Critical variables from config
-config_source: "{project-root}/bmad/bmgd/config.yaml"
+config_source: "{project-root}/{bmad_folder}/bmgd/config.yaml"
 output_folder: "{config_source}:output_folder"
 user_name: "{config_source}:user_name"
 communication_language: "{config_source}:communication_language"
@@ -13,7 +13,7 @@ game_dev_experience: "{config_source}:game_dev_experience"
 date: system-generated
 
 # Workflow components
-installed_path: "{project-root}/bmad/bmgd/workflows/2-design/gdd"
+installed_path: "{project-root}/{bmad_folder}/bmgd/workflows/2-design/gdd"
 instructions: "{installed_path}/instructions-gdd.md"
 template: "{installed_path}/gdd-template.md"
 game_types_csv: "{installed_path}/game-types.csv"
@@ -50,32 +50,32 @@ web_bundle:
   name: "gdd"
   description: "Game Design Document workflow for all game project levels - from small prototypes to full AAA games. Generates comprehensive GDD with game mechanics, systems, progression, and implementation guidance."
   author: "BMad"
-  instructions: "bmad/bmgd/workflows/2-design/gdd/instructions-gdd.md"
+  instructions: "{bmad_folder}/bmgd/workflows/2-design/gdd/instructions-gdd.md"
   web_bundle_files:
-    - "bmad/bmgd/workflows/2-design/gdd/instructions-gdd.md"
-    - "bmad/bmgd/workflows/2-design/gdd/gdd-template.md"
-    - "bmad/bmgd/workflows/2-design/gdd/game-types.csv"
-    - "bmad/bmgd/workflows/2-design/gdd/game-types/action-platformer.md"
-    - "bmad/bmgd/workflows/2-design/gdd/game-types/adventure.md"
-    - "bmad/bmgd/workflows/2-design/gdd/game-types/card-game.md"
-    - "bmad/bmgd/workflows/2-design/gdd/game-types/fighting.md"
-    - "bmad/bmgd/workflows/2-design/gdd/game-types/horror.md"
-    - "bmad/bmgd/workflows/2-design/gdd/game-types/idle-incremental.md"
-    - "bmad/bmgd/workflows/2-design/gdd/game-types/metroidvania.md"
-    - "bmad/bmgd/workflows/2-design/gdd/game-types/moba.md"
-    - "bmad/bmgd/workflows/2-design/gdd/game-types/party-game.md"
-    - "bmad/bmgd/workflows/2-design/gdd/game-types/puzzle.md"
-    - "bmad/bmgd/workflows/2-design/gdd/game-types/racing.md"
-    - "bmad/bmgd/workflows/2-design/gdd/game-types/rhythm.md"
-    - "bmad/bmgd/workflows/2-design/gdd/game-types/roguelike.md"
-    - "bmad/bmgd/workflows/2-design/gdd/game-types/rpg.md"
-    - "bmad/bmgd/workflows/2-design/gdd/game-types/sandbox.md"
-    - "bmad/bmgd/workflows/2-design/gdd/game-types/shooter.md"
-    - "bmad/bmgd/workflows/2-design/gdd/game-types/simulation.md"
-    - "bmad/bmgd/workflows/2-design/gdd/game-types/sports.md"
-    - "bmad/bmgd/workflows/2-design/gdd/game-types/strategy.md"
-    - "bmad/bmgd/workflows/2-design/gdd/game-types/survival.md"
-    - "bmad/bmgd/workflows/2-design/gdd/game-types/text-based.md"
-    - "bmad/bmgd/workflows/2-design/gdd/game-types/tower-defense.md"
-    - "bmad/bmgd/workflows/2-design/gdd/game-types/turn-based-tactics.md"
-    - "bmad/bmgd/workflows/2-design/gdd/game-types/visual-novel.md"
+    - "{bmad_folder}/bmgd/workflows/2-design/gdd/instructions-gdd.md"
+    - "{bmad_folder}/bmgd/workflows/2-design/gdd/gdd-template.md"
+    - "{bmad_folder}/bmgd/workflows/2-design/gdd/game-types.csv"
+    - "{bmad_folder}/bmgd/workflows/2-design/gdd/game-types/action-platformer.md"
+    - "{bmad_folder}/bmgd/workflows/2-design/gdd/game-types/adventure.md"
+    - "{bmad_folder}/bmgd/workflows/2-design/gdd/game-types/card-game.md"
+    - "{bmad_folder}/bmgd/workflows/2-design/gdd/game-types/fighting.md"
+    - "{bmad_folder}/bmgd/workflows/2-design/gdd/game-types/horror.md"
+    - "{bmad_folder}/bmgd/workflows/2-design/gdd/game-types/idle-incremental.md"
+    - "{bmad_folder}/bmgd/workflows/2-design/gdd/game-types/metroidvania.md"
+    - "{bmad_folder}/bmgd/workflows/2-design/gdd/game-types/moba.md"
+    - "{bmad_folder}/bmgd/workflows/2-design/gdd/game-types/party-game.md"
+    - "{bmad_folder}/bmgd/workflows/2-design/gdd/game-types/puzzle.md"
+    - "{bmad_folder}/bmgd/workflows/2-design/gdd/game-types/racing.md"
+    - "{bmad_folder}/bmgd/workflows/2-design/gdd/game-types/rhythm.md"
+    - "{bmad_folder}/bmgd/workflows/2-design/gdd/game-types/roguelike.md"
+    - "{bmad_folder}/bmgd/workflows/2-design/gdd/game-types/rpg.md"
+    - "{bmad_folder}/bmgd/workflows/2-design/gdd/game-types/sandbox.md"
+    - "{bmad_folder}/bmgd/workflows/2-design/gdd/game-types/shooter.md"
+    - "{bmad_folder}/bmgd/workflows/2-design/gdd/game-types/simulation.md"
+    - "{bmad_folder}/bmgd/workflows/2-design/gdd/game-types/sports.md"
+    - "{bmad_folder}/bmgd/workflows/2-design/gdd/game-types/strategy.md"
+    - "{bmad_folder}/bmgd/workflows/2-design/gdd/game-types/survival.md"
+    - "{bmad_folder}/bmgd/workflows/2-design/gdd/game-types/text-based.md"
+    - "{bmad_folder}/bmgd/workflows/2-design/gdd/game-types/tower-defense.md"
+    - "{bmad_folder}/bmgd/workflows/2-design/gdd/game-types/turn-based-tactics.md"
+    - "{bmad_folder}/bmgd/workflows/2-design/gdd/game-types/visual-novel.md"