Files
BMAD-METHOD/expansion-packs/bmad-2d-unity-game-dev/tasks/correct-course-game.md
Murat K Ozcan 0b61175d98 feat: transform QA agent into Test Architect with advanced quality ca… (#433)
* feat: transform QA agent into Test Architect with advanced quality capabilities

  - Add 6 specialized quality assessment commands
  - Implement risk-based testing with scoring
  - Create quality gate system with deterministic decisions
  - Add comprehensive test design and NFR validation
  - Update documentation with stage-based workflow integration

* feat: transform QA agent into Test Architect with advanced quality capabilities

  - Add 6 specialized quality assessment commands
  - Implement risk-based testing with scoring
  - Create quality gate system with deterministic decisions
  - Add comprehensive test design and NFR validation
  - Update documentation with stage-based workflow integration

* docs: refined the docs for test architect

* fix: addressed review comments from manjaroblack, round 1

* fix: addressed review comments from manjaroblack, round 1

---------

Co-authored-by: Murat Ozcan <murat@mac.lan>
Co-authored-by: Brian <bmadcode@gmail.com>
2025-08-15 21:02:37 -05:00

6.1 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