| name | bmad-gds |
| description | AI-driven Game Development Studio using BMAD methodology. Covers the Execute and Assess phases of the BMAD TEA (Think→Execute→Assess) loop — the core Specification-Driven Development (SDD) cycle. Routes game projects through Pre-production, Design, Architecture, Production, and Game Testing phases with 6 specialized agents. Supports Unity, Unreal Engine, Godot, and custom engines. |
| allowed-tools | Read Write Bash Grep Glob |
| metadata | {"tags":"bmad, gds, game-development, game-design, gdd, unity, unreal, godot, multi-agent, workflow, sdd, tea, specification-driven","platforms":"Claude, Gemini, Codex, OpenCode","keyword":"bmad-gds","version":"0.2.0","source":"user-installed skill"} |
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
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
- Run
bmad-gds-brainstorm-game → ideate game concept
- Run
bmad-gds-game-brief → lock in concept and core mechanics
- Run
bmad-gds-gdd → produce full Game Design Document
- Run
bmad-gds-game-architecture → define technical architecture
- Run
bmad-gds-sprint-planning → break work into sprints and stories
- Run
bmad-gds-dev-story per story → implement features
- Run
bmad-gds-code-review → quality gate before merge
- 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 |
