Files
BMAD-METHOD/expansion-packs/bmad-2d-unity-game-dev/tasks/correct-course-game.md
PinkyD a7038d43d1 feat: Overhaul and Enhance 2D Unity Game Dev Expansion Pack (#350)
* Updated game-sm agent to match the new core framework patterns

* feat:Created more comprehensive game story matching new format system as well

* feat:Added Game specific course correct task

* feat:Updated dod-checklist to match new DoD format

* feat:Added new Architect agent for appropriate architecture doc creation and design

* feat:Overhaul of game-architecture-tmpl template

* feat:Updated rest of templates besides level which doesnt really need it

* feat: Finished extended architecture documentation needed for new game story tasks

* feat: Updated game Developer to new format

* feat: Updated last agent to new format and updated bmad-kb. bmad-kb I did my best with but im not sure of it's valid usage in the expansion pack, the AI generated more of the file then myself. I made sure to include it due to the new core-config file

* feat: Finished updating designer agent to new format and cleaned up template linting errors

* Built dist for web bundle

* Increased expansion pack minor verison number

* Updated architecht and design for sharding built-in

* chore: bump bmad-2d-unity-game-dev version (minor)

* updated config.yaml for game-specific pieces to supplement core-config.yaml

* Updated game-core-config and epic processing for game story and game design. Initial implementation was far too generic

* chore: bump bmad-2d-unity-game-dev version (patch)

* feat: Fixed issue with multi-configs being needed. chore: bump bmad-2d-unity-game-dev version (patch)

* Chore: Built web-bundle

* feat: Added the ability to specify the unity editor install location.\nchore: bump bmad-2d-unity-game-dev version (patch)

* feat: core-config must be in two places to support inherited tasks at this time so added instructions to copy and create one in expansion pack folder as well. chore: bump bmad-2d-unity-game-dev version (patch)
2025-07-23 07:14:06 -05:00

6.2 KiB

Correct Course Task - Game Development

Purpose

  • Guide a structured response to game development change triggers using the {root}/checklists/game-change-checklist.
  • Analyze the impacts of changes on game features, technical systems, and milestone deliverables.
  • Explore game-specific solutions (e.g., performance optimizations, feature scaling, platform adjustments).
  • Draft specific, actionable proposed updates to affected game artifacts (e.g., GDD sections, technical specs, Unity configurations).
  • Produce a consolidated "Game Development Change Proposal" document for review and approval.
  • Ensure clear handoff path for changes requiring fundamental redesign or technical architecture updates.

Instructions

1. Initial Setup & Mode Selection

  • Acknowledge Task & Inputs:

    • Confirm with the user that the "Game Development Correct Course Task" is being initiated.
    • Verify the change trigger (e.g., performance issue, platform constraint, gameplay feedback, technical blocker).
    • Confirm access to relevant game artifacts:
      • Game Design Document (GDD)
      • Technical Design Documents
      • Unity Architecture specifications
      • Performance budgets and platform requirements
      • Current sprint's game stories and epics
      • Asset specifications and pipelines
    • Confirm access to {root}/checklists/game-change-checklist.
  • Establish Interaction Mode:

    • Ask the user their preferred interaction mode:
      • "Incrementally (Default & Recommended): Work through the game-change-checklist section by section, discussing findings and drafting changes collaboratively. Best for complex technical or gameplay changes."
      • "YOLO Mode (Batch Processing): Conduct batched analysis and present consolidated findings. Suitable for straightforward performance optimizations or minor adjustments."
    • Confirm the selected mode and inform: "We will now use the game-change-checklist to analyze the change and draft proposed updates specific to our Unity game development context."

2. Execute Game Development Checklist Analysis

  • Systematically work through the game-change-checklist sections:

    1. Change Context & Game Impact
    2. Feature/System Impact Analysis
    3. Technical Artifact Conflict Resolution
    4. Performance & Platform Evaluation
    5. Path Forward Recommendation
  • For each checklist section:

    • Present game-specific prompts and considerations
    • Analyze impacts on:
      • Unity scenes and prefabs
      • Component dependencies
      • Performance metrics (FPS, memory, build size)
      • Platform-specific code paths
      • Asset loading and management
      • Third-party plugins/SDKs
    • Discuss findings with clear technical context
    • Record status: [x] Addressed, [N/A], [!] Further Action Needed
    • Document Unity-specific decisions and constraints

3. Draft Game-Specific Proposed Changes

Based on the analysis and agreed path forward:

  • Identify affected game artifacts requiring updates:

    • GDD sections (mechanics, systems, progression)
    • Technical specifications (architecture, performance targets)
    • Unity-specific configurations (build settings, quality settings)
    • Game story modifications (scope, acceptance criteria)
    • Asset pipeline adjustments
    • Platform-specific adaptations
  • Draft explicit changes for each artifact:

    • Game Stories: Revise story text, Unity-specific acceptance criteria, technical constraints
    • Technical Specs: Update architecture diagrams, component hierarchies, performance budgets
    • Unity Configurations: Propose settings changes, optimization strategies, platform variants
    • GDD Updates: Modify feature descriptions, balance parameters, progression systems
    • Asset Specifications: Adjust texture sizes, model complexity, audio compression
    • Performance Targets: Update FPS goals, memory limits, load time requirements
  • Include Unity-specific details:

    • Prefab structure changes
    • Scene organization updates
    • Component refactoring needs
    • Shader/material optimizations
    • Build pipeline modifications

4. Generate "Game Development Change Proposal"

  • Create a comprehensive proposal document containing:

    A. Change Summary:

    • Original issue (performance, gameplay, technical constraint)
    • Game systems affected
    • Platform/performance implications
    • Chosen solution approach

    B. Technical Impact Analysis:

    • Unity architecture changes needed
    • Performance implications (with metrics)
    • Platform compatibility effects
    • Asset pipeline modifications
    • Third-party dependency impacts

    C. Specific Proposed Edits:

    • For each game story: "Change Story GS-X.Y from: [old] To: [new]"
    • For technical specs: "Update Unity Architecture Section X: [changes]"
    • For GDD: "Modify [Feature] in Section Y: [updates]"
    • For configurations: "Change [Setting] from [old_value] to [new_value]"

    D. Implementation Considerations:

    • Required Unity version updates
    • Asset reimport needs
    • Shader recompilation requirements
    • Platform-specific testing needs

5. Finalize & Determine Next Steps

  • Obtain explicit approval for the "Game Development Change Proposal"

  • Provide the finalized document to the user

  • Based on change scope:

    • Minor adjustments (can be handled in current sprint):
      • Confirm task completion
      • Suggest handoff to game-dev agent for implementation
      • Note any required playtesting validation
    • Major changes (require replanning):
      • Clearly state need for deeper technical review
      • Recommend engaging Game Architect or Technical Lead
      • Provide proposal as input for architecture revision
      • Flag any milestone/deadline impacts

Output Deliverables

  • Primary: "Game Development Change Proposal" document containing:

    • Game-specific change analysis
    • Technical impact assessment with Unity context
    • Platform and performance considerations
    • Clearly drafted updates for all affected game artifacts
    • Implementation guidance and constraints
  • Secondary: Annotated game-change-checklist showing:

    • Technical decisions made
    • Performance trade-offs considered
    • Platform-specific accommodations
    • Unity-specific implementation notes