ldy26098
/
BMAD-METHOD
mirror of https://github.com/bmad-code-org/BMAD-METHOD.git
1
0
Fork 0
Code Packages Projects Releases Wiki Activity
BMAD-METHOD/expansion-packs/bmad-wechat-mini-game-dev/tasks/validate-game-story.md

12 KiB
Raw Blame History

Validate Game Story Task

Purpose

To comprehensively validate a WeChat Mini Game development story draft before implementation begins, ensuring it contains all necessary WeChat Mini Game-specific technical context (object architecture, JavaScript language strategy, 60+ FPS performance targets), TDD requirements, and implementation details. This specialized validation prevents hallucinations, ensures WeChat Mini Game development readiness, and validates game-specific acceptance criteria and testing approaches.

SEQUENTIAL Task Execution (Do not proceed until current Task is complete)

0. Load Core Configuration and Inputs

  • Load .bmad-wechat-mini-game-dev/config.yaml from the project root
  • If the file does not exist, HALT and inform the user: "core-config.yaml not found. This file is required for story validation."
  • Extract key configurations: devStoryLocation, gdd.*, gamearchitecture.*, workflow.*
  • Identify and load the following inputs:
    • Story file: The drafted game story to validate (provided by user or discovered in devStoryLocation)
    • Parent epic: The epic containing this story's requirements from GDD
    • Architecture documents: Based on configuration (sharded or monolithic)
    • Game story template: expansion-packs/bmad-wechat-mini-game-dev/templates/game-story-tmpl.yaml for completeness validation

1. Game Story Template Completeness Validation

  • Load expansion-packs/bmad-wechat-mini-game-dev/templates/game-story-tmpl.yaml and extract all required sections
  • Missing sections check: Compare story sections against game story template sections to verify all WeChat Mini Game-specific sections are present:
    • WeChat Mini Game Technical Context
    • Object Architecture & Event Flow
    • Scene & Resource Requirements
    • Language Strategy (JavaScript)
    • Performance Requirements (60+ FPS target)
    • Platform Export Settings
    • Integration Points
    • TDD Testing Strategy
  • Placeholder validation: Ensure no template placeholders remain unfilled (e.g., {{EpicNum}}, {{StoryNum}}, {{GameMechanic}}, _TBD_)
  • Game-specific sections: Verify presence of WeChat Mini Game development specific sections
  • Structure compliance: Verify story follows game story template structure and formatting

2. WeChat Mini Game Project Structure and Resource Validation

  • WeChat Mini Game file paths clarity: Are WeChat Mini Game-specific paths clearly specified?
  • Plugin dependencies: Are required plugins or libraries identified and documented?
  • Scene structure relevance: Is relevant object hierarchy and scene tree structure included?
  • Scene organization: Are scene instancing and inheritance patterns clearly specified?
  • Resource pipeline: Are texture imports, Animation resources, and Audio assets properly planned?
  • Directory structure: Do new WeChat Mini Game resources follow project structure according to architecture docs?
  • Custom Resource requirements: Are resource classes and export presets identified?
  • Language compliance: Are JavaScript best practices enforced?

3. WeChat Mini Game Object Architecture Validation

  • Object class specifications: Are custom object classes sufficiently detailed?
  • Object dependencies: Are object relationships and event connections clearly mapped?
  • WeChat Mini Game lifecycle usage: Are lifecycle methods appropriately planned?
  • Event system integration: Are event emissions, connections, and custom events specified?
  • UI requirements: Are UI elements, anchoring, and theme system requirements defined?
  • Performance considerations: Are process modes optimized?

4. Game Mechanics and Systems Validation

  • Core loop integration: Does the story properly integrate with established game core loop?
  • Player input handling: Are input handling requirements specified?
  • Game state management: Are state transitions and save/load system requirements clear?
  • UI/UX integration: Are UI elements, anchoring, and theme system requirements defined?
  • Audio integration: Are audio nodes, bus routing, and sound pooling specified?
  • Animation systems: Are animation and transition requirements clear?
  • Physics integration: Are physics bodies, collision layers, and physics settings specified?
  • Object pooling: Are pooling strategies defined for frequently spawned entities?

5. WeChat Mini Game-Specific Acceptance Criteria Assessment

  • TDD testing: Are tests defined for all criteria?
  • Visual validation: Are visual/aesthetic acceptance criteria measurable and testable?
  • Performance criteria: Is 60+ FPS target specified with frame time <16.67ms?
  • Platform compatibility: Are export template requirements for different platforms addressed?
  • Input validation: Are input actions for touch covered?
  • Audio criteria: Are audio bus levels, stream players, and audio pooling specified?
  • Animation validation: Are animation smoothness, timing, and blend requirements defined?

6. WeChat Mini Game Testing and Validation Instructions Review

  • TDD Framework: Are TDD approaches with Red-Green-Refactor cycle specified?
  • Performance profiling: Are WeChat Mini Game Profiler usage and 60+ FPS validation steps defined?
  • Export testing: Are export template validation steps for target platforms specified?
  • Scene testing: Are scene instancing, transitions, and event flow testing approaches clear?
  • Resource validation: Are texture compression, import settings, and pooling tests defined?
  • Platform testing: Are platform-specific export settings and input methods specified?
  • Memory leak testing: Are event cleanup and object lifecycle validation steps included?

7. WeChat Mini Game Performance and Optimization Validation

  • Frame rate targets: Is 60+ FPS minimum clearly specified for all platforms?
  • Memory budgets: Are scene memory, resource memory, and pooling limits defined?
  • Draw call optimization: Are rendering batches and viewport optimization approaches specified?
  • Mobile performance: Are mobile export settings and touch optimization addressed?
  • Resource optimization: Are import settings, compression, and preloading strategies clear?
  • Language optimization: Are JavaScript best practices specified?
  • Loading time targets: Are scene transitions <3 seconds and resource streaming defined?

8. WeChat Mini Game Platform and Export Considerations

  • Export templates: Are platform-specific export templates and settings documented?
  • Platform features: Are platform-specific WeChat Mini Game features properly configured?
  • Data persistence: Are storage usage and save system requirements specified?
  • Input handling: Are input configurations for each platform defined?
  • Performance targets: Are platform-specific 60+ FPS optimizations addressed?
  • Export security: Are release vs debug export settings properly configured?

9. WeChat Mini Game Development Task Sequence Validation

  • TDD workflow order: Do tasks follow TDD cycle (write tests first, then implement, then refactor)?
  • Object hierarchy dependencies: Are parent objects created before child objects?
  • Resource dependencies: Are resources created before scenes that use them?
  • Event connections: Are event emitters created before receivers?
  • Testing integration: Are test creation tasks before implementation?
  • Export integration: Are export preset configurations properly sequenced?
  • Performance validation: Are profiling checkpoints placed throughout development?

10. WeChat Mini Game Anti-Hallucination Verification

  • WeChat Mini Game API accuracy: Every WeChat Mini Game API reference must be verified against current WeChat Mini Game documentation
  • Plugin verification: All plugin references must be valid
  • Object architecture alignment: Object relationships must match architecture specifications
  • Performance claims verification: 60+ FPS targets must be realistic for target platforms
  • Resource pipeline accuracy: All import settings and resource configurations must be valid

11. WeChat Mini Game Development Agent Implementation Readiness

  • WeChat Mini Game context completeness: Can the story be implemented without consulting external WeChat Mini Game documentation?
  • Language specification clarity: Are JavaScript choices and patterns unambiguous?
  • Resource requirements clarity: Are all resources, scenes, and import settings defined?
  • Object relationship clarity: Are all object interactions and event flows explicitly defined?
  • TDD approach completeness: Are TDD approaches fully specified?
  • Performance validation readiness: Are 60+ FPS validation approaches clearly defined?

12. Generate WeChat Mini Game Story Validation Report

Provide a structured validation report including:

Game Story Template Compliance Issues

  • Missing WeChat Mini Game-specific sections from game story template
  • Unfilled placeholders or template variables specific to game development
  • Missing object specifications or resource requirements
  • Missing TDD test specifications
  • Language strategy gaps

Critical WeChat Mini Game Issues (Must Fix - Story Blocked)

  • Missing essential WeChat Mini Game technical information for implementation
  • No TDD test specifications
  • Performance targets not meeting 60+ FPS requirement
  • Incomplete object architecture or event flow
  • Missing object pooling for spawned entities

WeChat Mini Game-Specific Should-Fix Issues (Important Quality Improvements)

  • Unclear object hierarchy or event connection patterns
  • Incomplete resource pipeline or import settings
  • Task sequencing not following TDD cycle
  • Missing platform export template specifications
  • Inadequate performance profiling checkpoints

Game Development Nice-to-Have Improvements (Optional Enhancements)

  • Additional WeChat Mini Game performance optimization context
  • Enhanced resource creation guidance and best practices
  • Clarifications for WeChat Mini Game-specific patterns (events, groups)
  • Additional platform export considerations
  • Enhanced profiler usage guidance

WeChat Mini Game Anti-Hallucination Findings

  • Unverifiable WeChat Mini Game API claims or outdated references
  • Inconsistencies with WeChat Mini Game project architecture documents
  • Invented objects, events, or development patterns
  • Performance claims not achieving 60+ FPS

WeChat Mini Game Platform and Performance Validation

  • Performance Assessment: 60+ FPS validation, frame time <16.67ms
  • Platform Compatibility Check: Export templates, Input, platform features
  • Resource Pipeline Validation: Import settings, compression, pooling strategies
  • WeChat Mini Game Version Compliance: Compatibility with latest version
  • Language Performance: JavaScript best practices enforcement

Final WeChat Mini Game Development Assessment

  • GO: Story ready for WeChat Mini Game implementation with TDD and 60+ FPS targets
  • NO-GO: Story requires WeChat Mini Game-specific fixes before implementation
  • TDD Readiness Score: 1-10 scale based on test coverage planning
  • Performance Readiness: Can maintain 60+ FPS? Yes/No/Unknown
  • Platform Export Readiness: Assessment of export template preparedness

Recommended Next Steps

Based on validation results, provide specific recommendations for:

  • WeChat Mini Game technical documentation improvements needed
  • TDD test specifications to add
  • Performance profiling setup for 60+ FPS validation
  • Platform export template configuration needs
  • Object pooling implementation requirements