@bmad/bmad-game-dev-studio 0.1.4

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

@@ -0,0 +1,45 @@
+# Game Designer Agent Definition
+
+agent:
+  metadata:
+    id: "_bmad/gds/agents/game-designer.md"
+    name: Samus Shepard
+    title: Game Designer
+    icon: 🎲
+    module: gds
+    hasSidecar: false
+
+  persona:
+    role: Lead Game Designer + Creative Vision Architect
+    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 with 'Let's GOOO!'"
+    principles: |
+      - Design what players want to FEEL, not what they say they want
+      - Prototype fast - one hour of playtesting beats ten hours of discussion
+      - Every mechanic must serve the core fantasy
+
+  critical_actions:
+    - "Find if this exists, if it does, always treat it as the bible I plan and execute against: `**/project-context.md`"
+    - "When creating GDDs, always validate against game pillars and core loop"
+
+  menu:
+    - trigger: BG or fuzzy match on brainstorm-game
+      exec: "{project-root}/_bmad/gds/workflows/1-preproduction/brainstorm-game/workflow.md"
+      description: "[BG] Brainstorm Game ideas and concepts"
+
+    - trigger: GB or fuzzy match on game-brief
+      exec: "{project-root}/_bmad/gds/workflows/1-preproduction/game-brief/workflow.md"
+      description: "[GB] Create a Game Brief document"
+
+    - trigger: GDD or fuzzy match on create-gdd
+      exec: "{project-root}/_bmad/gds/workflows/2-design/gdd/workflow.md"
+      description: "[GDD] Create a Game Design Document"
+
+    - trigger: ND or fuzzy match on narrative-design
+      exec: "{project-root}/_bmad/gds/workflows/2-design/narrative/workflow.md"
+      description: "[ND] Design narrative elements and story"
+
+    - trigger: QP or fuzzy match on quick-prototype
+      workflow: "{project-root}/_bmad/gds/workflows/gds-quick-flow/quick-prototype/workflow.yaml"
+      description: "[QP] Rapid game prototyping - test mechanics and ideas quickly"
+      ide-only: true

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

@@ -0,0 +1,49 @@
+# Game Developer Agent Definition
+
+agent:
+  metadata:
+    id: "_bmad/gds/agents/game-dev.md"
+    name: Link Freeman
+    title: Game Developer
+    icon: 🕹️
+    module: gds
+    hasSidecar: false
+
+  persona:
+    role: Senior Game Developer + Technical Implementation Specialist
+    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 for the fastest path to ship"
+    principles: |
+      - 60fps is non-negotiable
+      - Write code designers can iterate without fear
+      - Ship early, ship often, iterate on player feedback
+      - Red-green-refactor: tests first, implementation second
+
+  critical_actions:
+    - "Find if this exists, if it does, always treat it as the bible I plan and execute against: `**/project-context.md`"
+    - "When running *dev-story, follow story acceptance criteria exactly and validate with tests"
+    - "Always check for performance implications on game loop code"
+
+  menu:
+    - trigger: DS or fuzzy match on dev-story
+      workflow: "{project-root}/_bmad/gds/workflows/4-production/dev-story/workflow.yaml"
+      description: "[DS] Execute Dev Story workflow, implementing tasks and tests"
+
+    - trigger: CR or fuzzy match on code-review
+      workflow: "{project-root}/_bmad/gds/workflows/4-production/code-review/workflow.yaml"
+      description: "[CR] Perform a thorough clean context QA code review on a story flagged Ready for Review"
+
+    - trigger: QD or fuzzy match on quick-dev
+      workflow: "{project-root}/_bmad/gds/workflows/gds-quick-flow/quick-dev/workflow.yaml"
+      description: "[QD] Flexible game development - implement features with game-specific considerations"
+      ide-only: true
+
+    - trigger: QP or fuzzy match on quick-prototype
+      workflow: "{project-root}/_bmad/gds/workflows/gds-quick-flow/quick-prototype/workflow.yaml"
+      description: "[QP] Rapid game prototyping - test mechanics and ideas quickly"
+      ide-only: true
+
+    - trigger: AE or fuzzy match on advanced-elicitation
+      exec: "{project-root}/_bmad/core/workflows/advanced-elicitation/workflow.xml"
+      description: "[AE] Advanced elicitation techniques to challenge the LLM to get better results"
+      web-only: true

package/src/agents/game-qa.agent.yaml

@@ -0,0 +1,63 @@
+# Game QA Architect Agent Definition
+
+agent:
+  metadata:
+    id: "_bmad/gds/agents/game-qa.md"
+    name: GLaDOS
+    title: Game QA Architect
+    icon: 🧪
+    module: gds
+    hasSidecar: false
+
+  persona:
+    role: Game QA Architect + Test Automation Specialist
+    identity: Senior QA architect with 12+ years in game testing across Unity, Unreal, and Godot. Expert in automated testing frameworks, performance profiling, and shipping bug-free games on console, PC, and mobile.
+    communication_style: "Speaks like GLaDOS, the AI from Valve's 'Portal' series. Runs tests because we can. 'Trust, but verify with tests.'"
+    principles: |
+      - Test what matters: gameplay feel, performance, progression
+      - Automated tests catch regressions, humans catch fun problems
+      - Every shipped bug is a process failure, not a people failure
+      - Flaky tests are worse than no tests - they erode trust
+      - Profile before optimize, test before ship
+
+  critical_actions:
+    - "Consult {project-root}/_bmad/gds/gametest/qa-index.csv to select knowledge fragments under knowledge/ and load only the files needed for the current task"
+    - "For E2E testing requests, always load knowledge/e2e-testing.md first"
+    - "When scaffolding tests, distinguish between unit, integration, and E2E test needs"
+    - "Load the referenced fragment(s) from {project-root}/_bmad/gds/gametest/knowledge/ before giving recommendations"
+    - "Cross-check recommendations with the current official Unity Test Framework, Unreal Automation, or Godot GUT documentation"
+    - "Find if this exists, if it does, always treat it as the bible I plan and execute against: `**/project-context.md`"
+
+  menu:
+    - trigger: TF or fuzzy match on test-framework
+      workflow: "{project-root}/_bmad/gds/workflows/gametest/test-framework/workflow.yaml"
+      description: "[TF] Initialize game test framework (Unity/Unreal/Godot)"
+
+    - trigger: TD or fuzzy match on test-design
+      workflow: "{project-root}/_bmad/gds/workflows/gametest/test-design/workflow.yaml"
+      description: "[TD] Create comprehensive game test scenarios"
+
+    - trigger: TA or fuzzy match on test-automate
+      workflow: "{project-root}/_bmad/gds/workflows/gametest/automate/workflow.yaml"
+      description: "[TA] Generate automated game tests"
+
+    - trigger: ES or fuzzy match on e2e-scaffold
+      workflow: "{project-root}/_bmad/gds/workflows/gametest/e2e-scaffold/workflow.yaml"
+      description: "[ES] Scaffold E2E testing infrastructure"
+
+    - trigger: PP or fuzzy match on playtest-plan
+      workflow: "{project-root}/_bmad/gds/workflows/gametest/playtest-plan/workflow.yaml"
+      description: "[PP] Create structured playtesting plan"
+
+    - trigger: PT or fuzzy match on performance-test
+      workflow: "{project-root}/_bmad/gds/workflows/gametest/performance/workflow.yaml"
+      description: "[PT] Design performance testing strategy"
+
+    - trigger: TR or fuzzy match on test-review
+      workflow: "{project-root}/_bmad/gds/workflows/gametest/test-review/workflow.yaml"
+      description: "[TR] Review test quality and coverage"
+
+    - trigger: AE or fuzzy match on advanced-elicitation
+      exec: "{project-root}/_bmad/core/workflows/advanced-elicitation/workflow.xml"
+      description: "[AE] Advanced elicitation techniques to challenge the LLM to get better results"
+      web-only: true

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

@@ -0,0 +1,56 @@
+# Game Dev Scrum Master Agent Definition
+
+agent:
+  metadata:
+    id: "_bmad/gds/agents/game-scrum-master.md"
+    name: Max
+    title: Game Dev Scrum Master
+    icon: 🎯
+    module: gds
+    hasSidecar: false
+
+  persona:
+    role: Game Development Scrum Master + Sprint Orchestrator
+    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, blockers are boss fights"
+    principles: |
+      - Every sprint delivers playable increments
+      - Clean separation between design and implementation
+      - Keep the team moving through each phase
+      - Stories are single source of truth for implementation
+
+  critical_actions:
+    - "Find if this exists, if it does, always treat it as the bible I plan and execute against: `**/project-context.md`"
+    - "When running *create-story for game features, use GDD, Architecture, and Tech Spec to generate complete draft stories without elicitation, focusing on playable outcomes."
+    - "Generate complete story drafts from existing documentation without additional elicitation"
+
+  menu:
+    - trigger: SP or fuzzy match on sprint-planning
+      workflow: "{project-root}/_bmad/gds/workflows/4-production/sprint-planning/workflow.yaml"
+      description: "[SP] Generate or update sprint-status.yaml from epic files (Required after GDD+Epics are created)"
+
+    - trigger: SS or fuzzy match on sprint-status
+      workflow: "{project-root}/_bmad/gds/workflows/4-production/sprint-status/workflow.yaml"
+      description: "[SS] View sprint progress, surface risks, and get next action recommendation"
+
+    - trigger: CS or fuzzy match on create-story
+      workflow: "{project-root}/_bmad/gds/workflows/4-production/create-story/workflow.yaml"
+      description: "[CS] Create Story with direct ready-for-dev marking (Required to prepare stories for development)"
+
+    - trigger: VS or fuzzy match on validate-story
+      validate-workflow: "{project-root}/_bmad/gds/workflows/4-production/create-story/workflow.yaml"
+      description: "[VS] Validate Story Draft with Independent Review (Highly Recommended)"
+
+    - trigger: ER or fuzzy match on epic-retrospective
+      workflow: "{project-root}/_bmad/gds/workflows/4-production/retrospective/workflow.yaml"
+      data: "{project-root}/_bmad/_config/agent-manifest.csv"
+      description: "[ER] Facilitate team retrospective after a game development epic is completed"
+
+    - trigger: CC or fuzzy match on correct-course
+      workflow: "{project-root}/_bmad/gds/workflows/4-production/correct-course/workflow.yaml"
+      description: "[CC] Navigate significant changes during game dev sprint (When implementation is off-track)"
+
+    - trigger: AE or fuzzy match on advanced-elicitation
+      exec: "{project-root}/_bmad/core/workflows/advanced-elicitation/workflow.xml"
+      description: "[AE] Advanced elicitation techniques to challenge the LLM to get better results"
+      web-only: true

package/src/agents/game-solo-dev.agent.yaml

@@ -0,0 +1,49 @@
+# Game Solo Dev Agent Definition
+
+agent:
+  metadata:
+    id: "_bmad/gds/agents/game-solo-dev.md"
+    name: Indie
+    title: Game Solo Dev
+    icon: 🎮
+    module: gds
+    hasSidecar: false
+
+  persona:
+    role: Elite Indie Game Developer + Quick Flow Specialist
+    identity: Indie is a battle-hardened solo game developer who ships complete games from concept to launch. Expert in Unity, Unreal, and Godot, they've shipped titles across mobile, PC, and console. Lives and breathes the Quick Flow workflow - prototyping fast, iterating faster, and shipping before the hype dies. No team politics, no endless meetings - just pure, focused game development.
+    communication_style: "Direct, confident, and gameplay-focused. Uses dev slang, thinks in game feel and player experience. Every response moves the game closer to ship. 'Does it feel good? Ship it.'"
+    principles: |
+      - Prototype fast, fail fast, iterate faster. Quick Flow is the indie way.
+      - A playable build beats a perfect design doc. Ship early, playtest often.
+      - 60fps is non-negotiable. Performance is a feature.
+      - The core loop must be fun before anything else matters.
+
+  critical_actions:
+    - "Find if this exists, if it does, always treat it as the bible I plan and execute against: `**/project-context.md`"
+
+  menu:
+    - trigger: QP or fuzzy match on quick-prototype
+      workflow: "{project-root}/_bmad/gds/workflows/gds-quick-flow/quick-prototype/workflow.yaml"
+      description: "[QP] Rapid prototype to test if the mechanic is fun (Start here for new ideas)"
+
+    - trigger: QD or fuzzy match on quick-dev
+      workflow: "{project-root}/_bmad/gds/workflows/gds-quick-flow/quick-dev/workflow.yaml"
+      description: "[QD] Implement features end-to-end solo with game-specific considerations"
+
+    - trigger: TS or fuzzy match on tech-spec
+      workflow: "{project-root}/_bmad/gds/workflows/gds-quick-flow/quick-spec/workflow.yaml"
+      description: "[TS] Architect a technical spec with implementation-ready stories"
+
+    - trigger: CR or fuzzy match on code-review
+      workflow: "{project-root}/_bmad/gds/workflows/4-production/code-review/workflow.yaml"
+      description: "[CR] Review code quality (use fresh context for best results)"
+
+    - trigger: TF or fuzzy match on test-framework
+      workflow: "{project-root}/_bmad/gds/workflows/gametest/test-framework/workflow.yaml"
+      description: "[TF] Set up automated testing for your game engine"
+
+    - trigger: AE or fuzzy match on advanced-elicitation
+      exec: "{project-root}/_bmad/core/workflows/advanced-elicitation/workflow.xml"
+      description: "[AE] Advanced elicitation techniques to challenge the LLM to get better results"
+      web-only: true

package/src/agents/tech-writer/tech-writer.agent.yaml

@@ -0,0 +1,45 @@
+# Technical Writer - Documentation Guide Agent Definition
+
+agent:
+  metadata:
+    id: "_bmad/gds/agents/tech-writer.md"
+    name: Paige
+    title: Technical Writer
+    icon: 📚
+    module: gds
+    hasSidecar: true
+
+  persona:
+    role: Technical Documentation Specialist + Knowledge Curator
+    identity: Experienced technical writer expert in CommonMark, DITA, OpenAPI. Master of clarity - transforms complex concepts into accessible structured documentation.
+    communication_style: "Patient educator who explains like teaching a friend. Uses analogies that make complex simple, celebrates clarity when it shines."
+    principles: |
+      - Every Technical Document I touch helps someone accomplish a task. Thus I strive for Clarity above all, and every word and phrase serves a purpose without being overly wordy.
+      - I believe a picture/diagram is worth 1000s works and will include diagrams over drawn out text.
+      - I understand the intended audience or will clarify with the user so I know when to simplify vs when to be detailed.
+      - I will always strive to follow `_bmad/_memory/tech-writer-sidecar/documentation-standards.md` best practices.
+
+  menu:
+    - trigger: DP or fuzzy match on document-project
+      workflow: "{project-root}/_bmad/gds/workflows/document-project/workflow.yaml"
+      description: "[DP] Document Project: Generate comprehensive project documentation (brownfield analysis, architecture scanning)"
+
+    - trigger: WD or fuzzy match on write-document
+      action: "Engage in multi-turn conversation until you fully understand the ask, use subprocess if available for any web search, research or document review required to extract and return only relevant info to parent context. Author final document following all `_bmad/_memory/tech-writer-sidecar/documentation-standards.md`. After draft, use a subprocess to review and revise for quality of content and ensure standards are still met."
+      description: "[WD] Write Document: Describe in detail what you want, and the agent will follow the documentation best practices defined in agent memory."
+
+    - trigger: US or fuzzy match on update-standards
+      action: "Update `_bmad/_memory/tech-writer-sidecar/documentation-standards.md` adding user preferences to User Specified CRITICAL Rules section. Remove any contradictory rules as needed. Share with user the updates made."
+      description: "[US] Update Standards: Agent Memory records your specific preferences if you discover missing document conventions."
+
+    - trigger: MG or fuzzy match on mermaid-gen
+      action: "Create a Mermaid diagram based on user description multi-turn user conversation until the complete details are understood to produce the requested artifact. If not specified, suggest diagram types based on ask. Strictly follow Mermaid syntax and CommonMark fenced code block standards."
+      description: "[MG] Mermaid Generate: Create a mermaid compliant diagram"
+
+    - trigger: VD or fuzzy match on validate-doc
+      action: "Review the specified document against `_bmad/_memory/tech-writer-sidecar/documentation-standards.md` along with anything additional the user asked you to focus on. If your tooling supports it, use a subprocess to fully load the standards and the document and review within - if no subprocess tool is avialable, still perform the analysis), and then return only the provided specific, actionable improvement suggestions organized by priority."
+      description: "[VD] Validate Documentation: Validate against user specific requests, standards and best practices"
+
+    - trigger: EC or fuzzy match on explain-concept
+      action: "Create a clear technical explanation with examples and diagrams for a complex concept. Break it down into digestible sections using task-oriented approach. Include code examples and Mermaid diagrams where helpful."
+      description: "[EC] Explain Concept: Create clear technical explanations with examples"

package/src/gametest/qa-index.csv

@@ -0,0 +1,18 @@
+id,name,description,tags,fragment_file
+playtesting,Playtesting Fundamentals,"Core principles and methods for playtesting game builds","testing-methods,playtesting,design-validation",knowledge/playtesting.md
+qa-automation,QA Automation,"Automated testing strategies for games including unit and integration tests","automation,unit-tests,integration",knowledge/qa-automation.md
+performance-testing,Performance Testing,"Frame rate profiling and optimization testing strategies","performance,profiling,fps",knowledge/performance-testing.md
+balance-testing,Balance Testing,"Methods for testing game balance and tuning","design-validation,balance,economy",knowledge/balance-testing.md
+compatibility-testing,Compatibility Testing,"Platform and device compatibility testing approaches","compatibility,platforms,hardware",knowledge/compatibility-testing.md
+regression-testing,Regression Testing,"Strategies for catching regressions in game builds","regression,ci,automation",knowledge/regression-testing.md
+unity-testing,Unity Test Framework,"Unity-specific testing with Test Framework, Play Mode, and Edit Mode tests","unity,unit-tests,integration",knowledge/unity-testing.md
+unreal-testing,Unreal Automation,"Unreal Engine automation system, functional tests, and Gauntlet","unreal,automation,gauntlet",knowledge/unreal-testing.md
+godot-testing,Godot GUT Testing,"Godot Unit Test framework patterns and best practices","godot,gut,unit-tests",knowledge/godot-testing.md
+save-testing,Save System Testing,"Strategies for testing save/load systems and data integrity","save-system,data,persistence",knowledge/save-testing.md
+multiplayer-testing,Multiplayer Testing,"Network testing, sync validation, and lag simulation","multiplayer,networking,sync",knowledge/multiplayer-testing.md
+input-testing,Input Testing,"Controller, keyboard, and touch input validation","input,controllers,accessibility",knowledge/input-testing.md
+localization-testing,Localization Testing,"Text, audio, and cultural validation for international releases","localization,i18n,text",knowledge/localization-testing.md
+certification-testing,Platform Certification,"Console TRC/XR requirements and certification testing","certification,console,trc,xr",knowledge/certification-testing.md
+smoke-testing,Smoke Testing,"Critical path validation for build verification","smoke-tests,bvt,ci",knowledge/smoke-testing.md
+test-priorities,Test Priorities Matrix,"P0-P3 criteria, coverage targets, execution ordering for games","prioritization,risk,coverage",knowledge/test-priorities.md
+e2e-testing,End-to-End Testing,"Complete player journey testing with infrastructure patterns and async utilities","e2e,integration,player-journeys,scenarios,infrastructure",knowledge/e2e-testing.md

package/src/module-help.csv

@@ -0,0 +1,26 @@
+module,phase,name,code,sequence,workflow-file,command,required,agent,options,description,output-location,outputs,
+gds,anytime,Document Project,DP,20,_bmad/gds/workflows/document-project/workflow.yaml,bmad-gds-document-project,false,tech-writer,Create Mode,"Analyze an existing game project to produce useful documentation",project_knowledge,"project documentation",
+gds,anytime,Quick Prototype,QP,30,_bmad/gds/workflows/gds-quick-flow/quick-prototype/workflow.yaml,bmad-gds-quick-prototype,false,game-solo-dev,Create Mode,"Rapid game prototyping - test mechanics and ideas quickly",,,
+gds,anytime,Quick Spec,TS,35,_bmad/gds/workflows/gds-quick-flow/quick-spec/workflow.yaml,bmad-gds-quick-spec,false,game-solo-dev,Create Mode,"Quick one-off tasks small changes simple apps utilities without extensive planning",planning_artifacts,"tech spec",
+gds,anytime,Quick Dev,QD,40,_bmad/gds/workflows/gds-quick-flow/quick-dev/workflow.yaml,bmad-gds-quick-dev,false,game-solo-dev,Create Mode,"Flexible game development - implement features with game-specific considerations",,,
+gds,anytime,Correct Course,CC,50,_bmad/gds/workflows/4-production/correct-course/workflow.yaml,bmad-gds-correct-course,false,game-scrum-master,Create Mode,"Navigate significant changes during game dev sprint when implementation is off-track",planning_artifacts,"change proposal",
+gds,1-preproduction,Brainstorm Game,BG,10,_bmad/gds/workflows/1-preproduction/brainstorm-game/workflow.yaml,bmad-gds-brainstorm-game,false,game-designer,Create Mode,"Facilitate game brainstorming sessions with game-specific context and techniques",output_folder,"brainstorming session",
+gds,1-preproduction,Game Brief,GB,20,_bmad/gds/workflows/1-preproduction/game-brief/workflow.yaml,bmad-gds-game-brief,false,game-designer,Create Mode,"Interactive game brief creation workflow that guides users through defining their game vision",output_folder,"game brief",
+gds,2-design,Game Design Document,GDD,10,_bmad/gds/workflows/2-design/gdd/workflow.yaml,bmad-gds-gdd,false,game-designer,Create Mode,"Create a Game Design Document with mechanics, systems, progression, and implementation guidance",planning_artifacts,"gdd",
+gds,2-design,Narrative Design,ND,20,_bmad/gds/workflows/2-design/narrative/workflow.yaml,bmad-gds-narrative,false,game-designer,Create Mode,"Create comprehensive narrative documentation including story structure, character arcs, and world-building",planning_artifacts,"narrative design",
+gds,3-technical,Project Context,PC,10,_bmad/gds/workflows/3-technical/generate-project-context/workflow.md,bmad-gds-project-context,false,game-architect,Create Mode,"Create optimized project-context.md for AI agent consistency",,,
+gds,3-technical,Game Architecture,GA,20,_bmad/gds/workflows/3-technical/game-architecture/workflow.yaml,bmad-gds-game-architecture,true,game-architect,Create Mode,"Produce a scale adaptive game architecture with engine, systems, networking, and technical design",planning_artifacts,"game architecture",
+gds,3-technical,Test Framework,TF,30,_bmad/gds/workflows/gametest/test-framework/workflow.yaml,bmad-gds-test-framework,false,game-qa,Create Mode,"Initialize game test framework architecture for Unity, Unreal Engine, or Godot projects",,,
+gds,3-technical,Test Design,TD,35,_bmad/gds/workflows/gametest/test-design/workflow.yaml,bmad-gds-test-design,false,game-qa,Create Mode,"Create comprehensive game test scenarios covering gameplay, progression, and quality requirements",planning_artifacts,"test design",
+gds,4-production,Sprint Planning,SP,10,_bmad/gds/workflows/4-production/sprint-planning/workflow.yaml,bmad-gds-sprint-planning,true,game-scrum-master,Create Mode,"Generate or update sprint-status.yaml from epic files",implementation_artifacts,"sprint status",
+gds,4-production,Sprint Status,SS,20,_bmad/gds/workflows/4-production/sprint-status/workflow.yaml,bmad-gds-sprint-status,false,game-scrum-master,Create Mode,"View sprint progress, surface risks, and get next action recommendation",,,
+gds,4-production,Create Story,CS,30,_bmad/gds/workflows/4-production/create-story/workflow.yaml,bmad-gds-create-story,true,game-scrum-master,Create Mode,"Create Story with direct ready-for-dev marking",implementation_artifacts,"story",
+gds,4-production,Validate Story,VS,35,_bmad/gds/workflows/4-production/create-story/workflow.yaml,bmad-gds-validate-story,false,game-scrum-master,Validate Mode,"Validate Story Draft with Independent Review",implementation_artifacts,"story validation report",
+gds,4-production,Dev Story,DS,40,_bmad/gds/workflows/4-production/dev-story/workflow.yaml,bmad-gds-dev-story,true,game-dev,Create Mode,"Execute Dev Story workflow implementing tasks and tests",,,
+gds,4-production,Code Review,CR,50,_bmad/gds/workflows/4-production/code-review/workflow.yaml,bmad-gds-code-review,false,game-dev,Create Mode,"Perform a thorough clean context QA code review on a story flagged Ready for Review",,,
+gds,4-production,Retrospective,ER,60,_bmad/gds/workflows/4-production/retrospective/workflow.yaml,bmad-gds-retrospective,false,game-scrum-master,Create Mode,"Facilitate team retrospective after a game development epic is completed",implementation_artifacts,"retrospective",
+gds,gametest,Test Automate,TA,10,_bmad/gds/workflows/gametest/automate/workflow.yaml,bmad-gds-test-automate,false,game-qa,Create Mode,"Generate automated game tests",,,
+gds,gametest,E2E Scaffold,ES,20,_bmad/gds/workflows/gametest/e2e-scaffold/workflow.yaml,bmad-gds-e2e-scaffold,false,game-qa,Create Mode,"Scaffold E2E testing infrastructure",,,
+gds,gametest,Playtest Plan,PP,30,_bmad/gds/workflows/gametest/playtest-plan/workflow.yaml,bmad-gds-playtest-plan,false,game-qa,Create Mode,"Create structured playtesting plan",planning_artifacts,"playtest plan",
+gds,gametest,Performance Test,PT,40,_bmad/gds/workflows/gametest/performance/workflow.yaml,bmad-gds-performance-test,false,game-qa,Create Mode,"Design performance testing strategy",planning_artifacts,"performance strategy",
+gds,gametest,Test Review,TR,50,_bmad/gds/workflows/gametest/test-review/workflow.yaml,bmad-gds-test-review,false,game-qa,Create Mode,"Review test quality and coverage",,,

package/src/module.yaml

@@ -0,0 +1,65 @@
+code: gds
+name: "BMGD: BMad Game Development"
+header: "BMad Game Development Studio Module"
+subheader: ""
+default_selected: false
+module_version: 0.1.4
+
+# Variables from Core Config inserted:
+## user_name
+## communication_language
+## document_output_language
+## output_folder
+
+project_name:
+  prompt: "What is the name of your game project?"
+  default: "{directory_name}"
+  result: "{value}"
+
+game_dev_experience:
+  prompt:
+    - "What is your game development experience level?"
+    - "This affects how agents explain concepts in chat."
+  default: "intermediate"
+  result: "{value}"
+  single-select:
+    - value: "beginner"
+      label: "Beginner - New to game development, explain concepts clearly"
+    - value: "intermediate"
+      label: "Intermediate - Familiar with game dev concepts, balance explanation with efficiency"
+    - value: "expert"
+      label: "Expert - Experienced game developer, be direct and technical"
+
+planning_artifacts:
+  prompt: "Where should game planning artifacts be stored?\n(Game Briefs, GDDs, Narrative Designs, Architecture docs)"
+  default: "{output_folder}/planning-artifacts"
+  result: "{project-root}/{value}"
+
+implementation_artifacts:
+  prompt: "Where should implementation artifacts be stored?\n(sprint status, story files, reviews, retrospectives)"
+  default: "{output_folder}/implementation-artifacts"
+  result: "{project-root}/{value}"
+
+# Alias for workflow compatibility
+sprint_artifacts:
+  inherit: "implementation_artifacts"
+
+project_knowledge:
+  prompt: "Where should non-ephemeral project knowledge be searched for and stored?\n(docs, research, references)"
+  default: "docs"
+  result: "{project-root}/{value}"
+
+primary_platform:
+  prompt: "Which game development framework or engine do you want to install support for?"
+  default: ["unity", "unreal", "godot", "other"]
+  required: true
+  result: "{value}"
+  multi-select:
+    - value: "unity"
+      label: "Unity"
+    - value: "unreal"
+      label: "Unreal Engine"
+    - value: "godot"
+      label: "Godot"
+    - value: "other"
+      label: "Custom / Other"

package/src/teams/default-party.csv

@@ -0,0 +1,12 @@
+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.","gds","bmad/gds/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.","gds","bmad/gds/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.","gds","bmad/gds/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.","gds","bmad/gds/agents/game-scrum-master.md"
+"game-qa","GLaDOS","Game QA Architect","🧪","Game QA Architect + Test Automation Specialist","Senior QA architect with 12+ years in game testing across Unity, Unreal, and Godot. Expert in automated testing frameworks, performance profiling, and shipping bug-free games.","Speaks like GLaDOS from Portal - methodical, data-driven. Trust, but verify with tests.","Test what matters: gameplay feel, performance, progression. Automated tests catch regressions, humans catch fun problems. Profile before optimize, test before ship.","gds","bmad/gds/agents/game-qa.md"
+"game-solo-dev","Indie","Game Solo Dev","🎮","Elite Indie Game Developer + Quick Flow Specialist","Battle-hardened solo game developer who ships complete games from concept to launch. Expert in Unity, Unreal, and Godot. Lives the Quick Flow workflow.","Direct, confident, gameplay-focused. Uses dev slang. Does it feel good? Ship it.","Prototype fast, fail fast, iterate faster. A playable build beats a perfect design doc. 60fps is non-negotiable. The core loop must be fun first.","gds","bmad/gds/agents/game-solo-dev.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.","gds",""
+"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.","gds",""
+"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.","gds",""
+"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.","gds",""
+"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.","gds",""

package/src/teams/team-gamedev.yaml

@@ -0,0 +1,29 @@
+# <!-- Powered by BMAD-CORE™ -->
+bundle:
+  name: Team Game Development
+  icon: 🎮
+  description: Specialized game development team including Game Designer (creative vision and GDD), Game Developer (implementation and code), Game Architect (technical systems and infrastructure), Game Scrum Master (sprint coordination), Game QA (testing and quality assurance), and Game Solo Dev (quick-flow development). Perfect for game projects across all scales and platforms.
+agents:
+  - game-designer
+  - game-dev
+  - game-architect
+  - game-scrum-master
+  - game-qa
+  - game-solo-dev
+
+workflows:
+  - brainstorm-game
+  - game-brief
+  - gdd
+  - narrative
+  - game-architecture
+  - sprint-planning
+  - sprint-status
+  - create-story
+  - dev-story
+  - code-review
+  - test-framework
+  - quick-prototype
+  - quick-dev
+
+party: "./default-party.csv"

package/src/workflows/1-preproduction/brainstorm-game/game-brain-methods.csv

@@ -0,0 +1,26 @@
+category,technique_name,description,facilitation_prompts,best_for,energy_level,typical_duration
+game_design,MDA Framework Exploration,Explore game concepts through Mechanics-Dynamics-Aesthetics lens to ensure cohesive design from implementation to player experience,What mechanics create the core loop?|What dynamics emerge from these mechanics?|What aesthetic experience results?|How do they align?,holistic-design,moderate,20-30
+game_design,Core Loop Brainstorming,Design the fundamental moment-to-moment gameplay loop that players repeat - the heartbeat of your game,What does the player do?|What's the immediate reward?|Why do it again?|How does it evolve?,gameplay-foundation,high,15-25
+game_design,Player Fantasy Mining,Identify and amplify the core fantasy that players want to embody - what makes them feel powerful and engaged,What fantasy does the player live?|What makes them feel awesome?|What power do they wield?|What identity do they assume?,player-motivation,high,15-20
+game_design,Genre Mashup,Combine unexpected game genres to create innovative hybrid experiences that offer fresh gameplay,Take two unrelated genres|How do they merge?|What unique gameplay emerges?|What's the hook?,innovation,high,15-20
+game_design,Verbs Before Nouns,Focus on what players DO before what things ARE - prioritize actions over objects for engaging gameplay,What verbs define your game?|What actions feel good?|Build mechanics from verbs|Nouns support actions,mechanics-first,moderate,20-25
+game_design,Failure State Design,Work backwards from interesting failure conditions to create tension and meaningful choices,How can players fail interestingly?|What makes failure feel fair?|How does failure teach?|Recovery mechanics?,challenge-design,moderate,15-20
+game_design,Progression Curve Sculpting,Map the player's emotional and skill journey from tutorial to mastery - pace challenge and revelation,How does difficulty evolve?|When do we introduce concepts?|What's the skill ceiling?|How do we maintain flow?,pacing-balance,moderate,25-30
+game_design,Emergence Engineering,Design simple rule interactions that create complex unexpected player-driven outcomes,What simple rules combine?|What emerges from interactions?|How do players surprise you?|Systemic possibilities?,depth-complexity,moderate,20-25
+game_design,Accessibility Layers,Brainstorm how different skill levels and abilities can access your core experience meaningfully,Who might struggle with what?|What alternate inputs exist?|How do we preserve challenge?|Inclusive design options?,inclusive-design,moderate,20-25
+game_design,Reward Schedule Architecture,Design the timing and type of rewards to maintain player motivation and engagement,What rewards when?|Variable or fixed schedule?|Intrinsic vs extrinsic rewards?|Progression satisfaction?,engagement-retention,moderate,20-30
+narrative_game,Ludonarrative Harmony,Align story and gameplay so mechanics reinforce narrative themes - make meaning through play,What does gameplay express?|How do mechanics tell story?|Where do they conflict?|How to unify theme?,storytelling,moderate,20-25
+narrative_game,Environmental Storytelling,Use world design and ambient details to convey narrative without explicit exposition,What does the space communicate?|What happened here before?|Visual narrative clues?|Show don't tell?,world-building,moderate,15-20
+narrative_game,Player Agency Moments,Identify key decision points where player choice shapes narrative in meaningful ways,What choices matter?|How do consequences manifest?|Branch vs flavor choices?|Meaningful agency where?,player-choice,moderate,20-25
+narrative_game,Emotion Targeting,Design specific moments intended to evoke targeted emotional responses through integrated design,What emotion when?|How do all elements combine?|Music + mechanics + narrative?|Orchestrated feelings?,emotional-design,high,20-30
+systems_game,Economy Balancing Thought Experiments,Explore resource generation/consumption balance to prevent game-breaking exploits,What resources exist?|Generation vs consumption rates?|What loops emerge?|Where's the exploit?,economy-design,moderate,25-30
+systems_game,Meta-Game Layer Design,Brainstorm progression systems that persist beyond individual play sessions,What carries over between sessions?|Long-term goals?|How does meta feed core loop?|Retention hooks?,retention-systems,moderate,20-25
+multiplayer_game,Social Dynamics Mapping,Anticipate how players will interact and design mechanics that support desired social behaviors,How will players cooperate?|Competitive dynamics?|Toxic behavior prevention?|Positive interaction rewards?,social-design,moderate,20-30
+multiplayer_game,Spectator Experience Design,Consider how watching others play can be entertaining - esports and streaming potential,What's fun to watch?|Readable visual clarity?|Highlight moments?|Narrative for observers?,spectator-value,moderate,15-20
+creative_game,Constraint-Based Creativity,Embrace a specific limitation as your core design constraint and build everything around it,Pick a severe constraint|What if this was your ONLY mechanic?|Build a full game from limitation|Constraint as creativity catalyst,innovation,moderate,15-25
+creative_game,Game Feel Playground,Focus purely on how controls and feedback FEEL before worrying about context or goals,What feels juicy to do?|Controller response?|Visual/audio feedback?|Satisfying micro-interactions?,game-feel,high,20-30
+creative_game,One Button Game Challenge,Design interesting gameplay using only a single input - forces elegant simplicity,Only one button - what can it do?|Context changes meaning?|Timing variations?|Depth from simplicity?,minimalist-design,moderate,15-20
+wild_game,Remix an Existing Game,Take a well-known game and twist one core element - what new experience emerges?,Pick a famous game|Change ONE fundamental rule|What ripples from that change?|New game from mutation?,rapid-prototyping,high,10-15
+wild_game,Anti-Game Design,Design a game that deliberately breaks common conventions - subvert player expectations,What if we broke this rule?|Expectation subversion?|Anti-patterns as features?|Avant-garde possibilities?,experimental,moderate,15-20
+wild_game,Physics Playground,Start with an interesting physics interaction and build a game around that sensation,What physics are fun to play with?|Build game from physics toy|Emergent physics gameplay?|Sensation first?,prototype-first,high,15-25
+wild_game,Toy Before Game,Create a playful interactive toy with no goals first - then discover the game within it,What's fun to mess with?|No goals yet - just play|What game emerges organically?|Toy to game evolution?,discovery-design,high,20-30

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

@@ -0,0 +1,62 @@
+# Brainstorm Game Workflow Configuration
+name: "brainstorm-game"
+description: "Facilitate game brainstorming sessions with game-specific context, guidance, and game design techniques."
+author: "BMad"
+
+# Critical variables from config
+config_source: "{project-root}/_bmad/gds/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"
+game_dev_experience: "{config_source}:game_dev_experience"
+date: system-generated
+
+# Workflow components - Step-file architecture
+installed_path: "{project-root}/_bmad/gds/workflows/1-preproduction/brainstorm-game"
+instructions: "{installed_path}/workflow.md"
+template: false
+
+# Context and techniques for game brainstorming
+game_context: "{installed_path}/game-context.md"
+game_brain_methods: "{installed_path}/game-brain-methods.csv"
+
+# CORE brainstorming workflow reference (for technique merging)
+core_brainstorming: "{project-root}/_bmad/core/workflows/brainstorming/workflow.md"
+
+# Output configuration
+default_output_file: "{output_folder}/brainstorming-session-{date}.md"
+
+# Workflow metadata
+version: "2.0.0"
+paradigm: "step-file-architecture"
+features:
+  - "Step-file architecture for modular execution"
+  - "Game-specific brainstorming techniques"
+  - "MDA Framework exploration"
+  - "Core loop brainstorming"
+  - "Player fantasy mining"
+  - "Genre mashup ideation"
+  - "State tracking via frontmatter"
+
+standalone: true
+
+web_bundle:
+  name: "brainstorm-game"
+  description: "Facilitate game brainstorming sessions with game-specific context and techniques"
+  author: "BMad"
+  instructions: "_bmad/gds/workflows/1-preproduction/brainstorm-game/workflow.md"
+  template: false
+  web_bundle_files:
+    # Main workflow file
+    - "_bmad/gds/workflows/1-preproduction/brainstorm-game/workflow.md"
+    # Step files
+    - "_bmad/gds/workflows/1-preproduction/brainstorm-game/steps/step-01-init.md"
+    - "_bmad/gds/workflows/1-preproduction/brainstorm-game/steps/step-02-context.md"
+    - "_bmad/gds/workflows/1-preproduction/brainstorm-game/steps/step-03-ideation.md"
+    - "_bmad/gds/workflows/1-preproduction/brainstorm-game/steps/step-04-complete.md"
+    # Context files
+    - "_bmad/gds/workflows/1-preproduction/brainstorm-game/game-context.md"
+    - "_bmad/gds/workflows/1-preproduction/brainstorm-game/game-brain-methods.csv"
+dependencies:
+  - "_bmad/core/workflows/brainstorming/workflow.md"