Files
BMAD-METHOD/expansion-packs/bmad-2d-unity-game-dev/tasks/create-game-story.md
PinkyD 5d81c75f4d Feature/expansionpack 2d unity game dev (#332)
* Added 1.0 files

* Converted agents, and templates to new format. Updated filenames to include extensions like in unity-2d-game-team.yaml, Updated some wordage in workflow, config, and increased minor version number

* Forgot to remove unused startup section in game-sm since it's moved to activation-instructions, now fixed.

* Updated verbosity for development workflow in development-guidenlines.md

* built the web-dist files for the expansion pack

* Synched with main repo and rebuilt dist

* Added enforcement of game-design-checklist to designer persona

* Updated with new changes to phaser epack that seem relevant to discussion we had on discord for summarizing documentation updates

* updated dist build for our epack
2025-07-18 19:14:12 -05:00

5.6 KiB

Create Game Development Story Task

Purpose

Create detailed, actionable game development stories that enable AI developers to implement specific game features in Unity without requiring additional design decisions.

When to Use

  • Breaking down game epics into implementable stories
  • Converting GDD features into development tasks
  • Preparing work for game developers
  • Ensuring clear handoffs from design to development

Prerequisites

Before creating stories, ensure you have:

  • Completed Game Design Document (GDD)
  • Game Architecture Document
  • Epic definition this story belongs to
  • Clear understanding of the specific game feature

Process

1. Story Identification

Review Epic Context:

  • Understand the epic's overall goal
  • Identify specific features that need implementation
  • Review any existing stories in the epic
  • Ensure no duplicate work

Feature Analysis:

  • Reference specific GDD sections
  • Understand player experience goals
  • Identify technical complexity
  • Estimate implementation scope

2. Story Scoping

Single Responsibility:

  • Focus on one specific game feature
  • Ensure story is completable in 1-3 days
  • Break down complex features into multiple stories
  • Maintain clear boundaries with other stories

Implementation Clarity:

  • Define exactly what needs to be built
  • Specify all technical requirements
  • Include all necessary integration points
  • Provide clear success criteria

3. Template Execution

Load Template: Use templates#game-story-tmpl following all embedded LLM instructions

Key Focus Areas:

  • Clear, actionable description
  • Specific acceptance criteria
  • Detailed technical specifications
  • Complete implementation task list
  • Comprehensive testing requirements

4. Story Validation

Technical Review:

  • Verify all technical specifications are complete
  • Ensure integration points are clearly defined
  • Confirm file paths match architecture
  • Validate C# interfaces and classes
  • Check for proper use of prefabs and scenes

Game Design Alignment:

  • Confirm story implements GDD requirements
  • Verify player experience goals are met
  • Check balance parameters are included
  • Ensure game mechanics are correctly interpreted

Implementation Readiness:

  • All dependencies identified
  • Assets requirements specified
  • Testing criteria defined
  • Definition of Done complete

5. Quality Assurance

Apply Checklist: Execute checklists#game-story-dod-checklist against completed story

Story Criteria:

  • Story is immediately actionable
  • No design decisions left to developer
  • Technical requirements are complete
  • Testing requirements are comprehensive
  • Performance requirements are specified

6. Story Refinement

Developer Perspective:

  • Can a developer start implementation immediately?
  • Are all technical questions answered?
  • Is the scope appropriate for the estimated points?
  • Are all dependencies clearly identified?

Iterative Improvement:

  • Address any gaps or ambiguities
  • Clarify complex technical requirements
  • Ensure story fits within epic scope
  • Verify story points estimation

Story Elements Checklist

Required Sections

  • Clear, specific description
  • Complete acceptance criteria (functional, technical, game design)
  • Detailed technical specifications
  • File creation/modification list
  • C# interfaces and classes
  • Integration point specifications
  • Ordered implementation tasks
  • Comprehensive testing requirements
  • Performance criteria
  • Dependencies clearly identified
  • Definition of Done checklist

Game-Specific Requirements

  • GDD section references
  • Game mechanic implementation details
  • Player experience goals
  • Balance parameters
  • Unity-specific requirements (components, prefabs, scenes)
  • Performance targets (stable frame rate)
  • Cross-platform considerations

Technical Quality

  • C# best practices compliance
  • Architecture document alignment
  • Code organization follows standards
  • Error handling requirements
  • Memory management considerations
  • Testing strategy defined

Common Pitfalls

Scope Issues:

  • Story too large (break into multiple stories)
  • Story too vague (add specific requirements)
  • Missing dependencies (identify all prerequisites)
  • Unclear boundaries (define what's in/out of scope)

Technical Issues:

  • Missing integration details
  • Incomplete technical specifications
  • Undefined interfaces or classes
  • Missing performance requirements

Game Design Issues:

  • Not referencing GDD properly
  • Missing player experience context
  • Unclear game mechanic implementation
  • Missing balance parameters

Success Criteria

Story Readiness:

  • Developer can start implementation immediately
  • No additional design decisions required
  • All technical questions answered
  • Testing strategy is complete
  • Performance requirements are clear
  • Story fits within epic scope

Quality Validation:

  • Game story DOD checklist passes
  • Architecture alignment confirmed
  • GDD requirements covered
  • Implementation tasks are ordered and specific
  • Dependencies are complete and accurate

Handoff Protocol

To Game Developer:

  1. Provide story document
  2. Confirm GDD and architecture access
  3. Verify all dependencies are met
  4. Answer any clarification questions
  5. Establish check-in schedule

Story Status Updates:

  • Draft → Ready for Development
  • In Development → Code Review
  • Code Review → Testing
  • Testing → Done

This task ensures game development stories are immediately actionable and enable efficient AI-driven development of game features in Unity.