bmad-gds - BMAD Game Development Studio

When to use this skill

• Starting a new game project and need a structured concept → production workflow
• Creating a Game Design Document (GDD), narrative design, or technical architecture
• Managing sprints and dev stories for a game team
• Setting up test frameworks for Unity, Unreal Engine, or Godot projects
• Quick prototyping or rapid feature work without full planning overhead
• Reviewing code or running retrospectives after development epics

---

Installation

npx skills add https://github.com/akillness/oh-my-skills --skill bmad-gds

---

Supported Engines

Unity · Unreal Engine · Godot · Custom/Other

---

BMAD-GDS Workflow Commands

Phase 1 — Pre-production

Command	Description
bmad-gds-brainstorm-game	Facilitate a game brainstorming session with game-specific ideation techniques
bmad-gds-game-brief	Create an interactive game brief defining concept and core mechanics

Phase 2 — Design

Command	Description
bmad-gds-gdd	Generate a Game Design Document: mechanics, systems, progression, implementation guidance
bmad-gds-narrative	Create narrative documentation: story structure, character arcs, world-building

Phase 3 — Technical

Command	Description
bmad-gds-project-context	Generate project-context.md for consistent AI agent coordination
bmad-gds-game-architecture	Produce scale-adaptive game architecture: engine, systems, networking, technical design
bmad-gds-test-framework	Initialize test framework architecture for Unity, Unreal, or Godot
bmad-gds-test-design	Create comprehensive test scenarios covering gameplay, progression, and quality

Phase 4 — Production

Command	Description
bmad-gds-sprint-planning	Generate or update sprint-status.yaml from epic files
bmad-gds-sprint-status	View sprint progress, surface risks, get next action recommendation
bmad-gds-create-story	Create a dev-ready implementation story
bmad-gds-dev-story	Execute a dev story: implement tasks and tests
bmad-gds-code-review	QA code review for stories flagged Ready for Review
bmad-gds-correct-course	Navigate major in-sprint course corrections
bmad-gds-retrospective	Facilitate retrospective after epic completion

Game Testing

Command	Description
bmad-gds-test-automate	Generate automated game tests for gameplay systems
bmad-gds-e2e-scaffold	Scaffold end-to-end testing infrastructure
bmad-gds-playtest-plan	Create a structured playtesting plan for user testing sessions
bmad-gds-performance-test	Design a performance testing strategy for profiling and optimization
bmad-gds-test-review	Review test quality and coverage gaps

Quick / Anytime

Command	Description
bmad-gds-quick-prototype	Rapid prototyping to validate mechanics without full planning overhead
bmad-gds-quick-spec	Quick tech spec for simple, well-defined features or tasks
bmad-gds-quick-dev	Flexible rapid implementation for game features
bmad-gds-document-project	Analyze and document an existing game project

---

Specialized Agents

Agent	Role
game-designer	Game concept, mechanics, GDD, narrative design, brainstorming
game-architect	Technical architecture, system design, project context
game-dev	Implementation, dev stories, code review
game-scrum-master	Sprint planning, story management, course corrections, retrospectives
game-qa	Test framework, test design, automation, E2E, playtest, performance
game-solo-dev	Full-scope solo mode: quick prototype, quick spec, quick dev

---

Typical Workflow

1. Run bmad-gds-brainstorm-game → ideate game concept
2. Run bmad-gds-game-brief → lock in concept and core mechanics
3. Run bmad-gds-gdd → produce full Game Design Document
4. Run bmad-gds-game-architecture → define technical architecture
5. Run bmad-gds-sprint-planning → break work into sprints and stories
6. Run bmad-gds-dev-story per story → implement features
7. Run bmad-gds-code-review → quality gate before merge
8. Run bmad-gds-retrospective → continuous improvement after each epic

---

Quick Reference

Action	Command
Brainstorm game concept	bmad-gds-brainstorm-game
Create game brief	bmad-gds-game-brief
Generate GDD	bmad-gds-gdd
Define architecture	bmad-gds-game-architecture
Plan sprint	bmad-gds-sprint-planning
Check sprint status	bmad-gds-sprint-status
Create story	bmad-gds-create-story
Develop story	bmad-gds-dev-story
Quick prototype	bmad-gds-quick-prototype