bmad-gds - BMAD Game Development Studio

BMAD TEA Framework

BMAD TEA = Think → Execute → Assess — the core loop of Specification-Driven Development (SDD).

Think (bmad-idea)  ──►  Execute (bmad-gds)  ──►  Assess (bmad-gds)
  Ideation               Phases 1–4                Game Testing + Retro
  Creative brief         Spec → Architecture        Quality gates
  GDD draft seed         Story → Code               Feedback → next Think
       ↑                                                   ↓
       └──────────────── Feedback Loop ───────────────────┘

bmad-gds covers Execute + Assess. For the Think phase, use bmad-idea.

SDD Principles (Specification-Driven Development)

#	Principle	How bmad-gds Enforces It
1	Spec before code	GDD and architecture exist before Phase 4 begins
2	Acceptance criteria upfront	Test design (Phase 3) is written before Production (Phase 4)
3	Story-driven execution	Every code change traces to a reviewed, approved dev story
4	Quality gate on merge	bmad-gds-code-review blocks merge until standards pass
5	Retrospective feedback	Phase output feeds back into spec refinement for the next Think cycle

---

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/supercent-io/skills-template --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

---

Quick Start

Scenario: New Unity3D game — from concept to first sprint

# Step 0: Confirm unity-mcp is running before starting
npx unity-mcp status

Step 1 — bmad-gds-brainstorm-game
  → "mobile endless runner on Unity3D with procedural obstacles"

Step 2 — bmad-gds-game-brief
  → Lock in core loop: run, dodge, score

Step 3 — bmad-gds-gdd
  → Full GDD: mechanics, progression, power-up systems

Step 4 — bmad-gds-game-architecture
  → Unity3D architecture: ScriptableObject data layer, pooling, input

Step 5 — bmad-gds-test-framework
  → Initialize Unity Test Runner + EditMode/PlayMode scaffolding

Step 6 — bmad-gds-sprint-planning
  → Break epics into Unity3D dev stories

Step 7 — bmad-gds-dev-story
  → Implement story: "Player controller with physics-based movement"

Step 8 — bmad-gds-code-review
  → QA gate before merging to main

---

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