@zeyue0329/xiaoma-cli 1.0.7 → 1.0.10

package/expansion-packs/bmad-2d-phaser-game-dev/templates/game-brief-tmpl.yaml

@@ -0,0 +1,357 @@
+# <!-- Powered by BMAD™ Core -->
+template:
+  id: game-brief-template-v2
+  name: Game Brief
+  version: 2.0
+  output:
+    format: markdown
+    filename: "docs/{{game_name}}-game-brief.md"
+    title: "{{game_title}} Game Brief"
+
+workflow:
+  mode: interactive
+
+sections:
+  - id: initial-setup
+    instruction: |
+      This template creates a comprehensive game brief that serves as the foundation for all subsequent game development work. The brief should capture the essential vision, scope, and requirements needed to create a detailed Game Design Document.
+
+      This brief is typically created early in the ideation process, often after brainstorming sessions, to crystallize the game concept before moving into detailed design.
+
+  - id: game-vision
+    title: Game Vision
+    instruction: Establish the core vision and identity of the game. Present each subsection and gather user feedback before proceeding.
+    sections:
+      - id: core-concept
+        title: Core Concept
+        instruction: 2-3 sentences that clearly capture what the game is and why it will be compelling to players
+      - id: elevator-pitch
+        title: Elevator Pitch
+        instruction: Single sentence that captures the essence of the game in a memorable way
+        template: |
+          **"{{game_description_in_one_sentence}}"**
+      - id: vision-statement
+        title: Vision Statement
+        instruction: Inspirational statement about what the game will achieve for players and why it matters
+
+  - id: target-market
+    title: Target Market
+    instruction: Define the audience and market context. Apply `tasks#advanced-elicitation` after presenting this section.
+    sections:
+      - id: primary-audience
+        title: Primary Audience
+        template: |
+          **Demographics:** {{age_range}}, {{platform_preference}}, {{gaming_experience}}
+          **Psychographics:** {{interests}}, {{motivations}}, {{play_patterns}}
+          **Gaming Preferences:** {{preferred_genres}}, {{session_length}}, {{difficulty_preference}}
+      - id: secondary-audiences
+        title: Secondary Audiences
+        template: |
+          **Audience 2:** {{description}}
+          **Audience 3:** {{description}}
+      - id: market-context
+        title: Market Context
+        template: |
+          **Genre:** {{primary_genre}} / {{secondary_genre}}
+          **Platform Strategy:** {{platform_focus}}
+          **Competitive Positioning:** {{differentiation_statement}}
+
+  - id: game-fundamentals
+    title: Game Fundamentals
+    instruction: Define the core gameplay elements. Each subsection should be specific enough to guide detailed design work.
+    sections:
+      - id: core-gameplay-pillars
+        title: Core Gameplay Pillars
+        instruction: 3-5 fundamental principles that guide all design decisions
+        type: numbered-list
+        template: |
+          **{{pillar_name}}** - {{description_and_rationale}}
+      - id: primary-mechanics
+        title: Primary Mechanics
+        instruction: List the 3-5 most important gameplay mechanics that define the player experience
+        repeatable: true
+        template: |
+          **Core Mechanic: {{mechanic_name}}**
+
+          - **Description:** {{how_it_works}}
+          - **Player Value:** {{why_its_fun}}
+          - **Implementation Scope:** {{complexity_estimate}}
+      - id: player-experience-goals
+        title: Player Experience Goals
+        instruction: Define what emotions and experiences the game should create for players
+        template: |
+          **Primary Experience:** {{main_emotional_goal}}
+          **Secondary Experiences:** {{supporting_emotional_goals}}
+          **Engagement Pattern:** {{how_player_engagement_evolves}}
+
+  - id: scope-constraints
+    title: Scope and Constraints
+    instruction: Define the boundaries and limitations that will shape development. Apply `tasks#advanced-elicitation` to clarify any constraints.
+    sections:
+      - id: project-scope
+        title: Project Scope
+        template: |
+          **Game Length:** {{estimated_content_hours}}
+          **Content Volume:** {{levels_areas_content_amount}}
+          **Feature Complexity:** {{simple|moderate|complex}}
+          **Scope Comparison:** "Similar to {{reference_game}} but with {{key_differences}}"
+      - id: technical-constraints
+        title: Technical Constraints
+        template: |
+          **Platform Requirements:**
+
+          - Primary: {{platform_1}} - {{requirements}}
+          - Secondary: {{platform_2}} - {{requirements}}
+
+          **Technical Specifications:**
+
+          - Engine: Phaser 3 + TypeScript
+          - Performance Target: {{fps_target}} FPS on {{target_device}}
+          - Memory Budget: <{{memory_limit}}MB
+          - Load Time Goal: <{{load_time_seconds}}s
+      - id: resource-constraints
+        title: Resource Constraints
+        template: |
+          **Team Size:** {{team_composition}}
+          **Timeline:** {{development_duration}}
+          **Budget Considerations:** {{budget_constraints_or_targets}}
+          **Asset Requirements:** {{art_audio_content_needs}}
+      - id: business-constraints
+        title: Business Constraints
+        condition: has_business_goals
+        template: |
+          **Monetization Model:** {{free|premium|freemium|subscription}}
+          **Revenue Goals:** {{revenue_targets_if_applicable}}
+          **Platform Requirements:** {{store_certification_needs}}
+          **Launch Timeline:** {{target_launch_window}}
+
+  - id: reference-framework
+    title: Reference Framework
+    instruction: Provide context through references and competitive analysis
+    sections:
+      - id: inspiration-games
+        title: Inspiration Games
+        sections:
+          - id: primary-references
+            title: Primary References
+            type: numbered-list
+            repeatable: true
+            template: |
+              **{{reference_game}}** - {{what_we_learn_from_it}}
+      - id: competitive-analysis
+        title: Competitive Analysis
+        template: |
+          **Direct Competitors:**
+
+          - {{competitor_1}}: {{strengths_and_weaknesses}}
+          - {{competitor_2}}: {{strengths_and_weaknesses}}
+
+          **Differentiation Strategy:**
+          {{how_we_differ_and_why_thats_valuable}}
+      - id: market-opportunity
+        title: Market Opportunity
+        template: |
+          **Market Gap:** {{underserved_need_or_opportunity}}
+          **Timing Factors:** {{why_now_is_the_right_time}}
+          **Success Metrics:** {{how_well_measure_success}}
+
+  - id: content-framework
+    title: Content Framework
+    instruction: Outline the content structure and progression without full design detail
+    sections:
+      - id: game-structure
+        title: Game Structure
+        template: |
+          **Overall Flow:** {{linear|hub_world|open_world|procedural}}
+          **Progression Model:** {{how_players_advance}}
+          **Session Structure:** {{typical_play_session_flow}}
+      - id: content-categories
+        title: Content Categories
+        template: |
+          **Core Content:**
+
+          - {{content_type_1}}: {{quantity_and_description}}
+          - {{content_type_2}}: {{quantity_and_description}}
+
+          **Optional Content:**
+
+          - {{optional_content_type}}: {{quantity_and_description}}
+
+          **Replay Elements:**
+
+          - {{replayability_features}}
+      - id: difficulty-accessibility
+        title: Difficulty and Accessibility
+        template: |
+          **Difficulty Approach:** {{how_challenge_is_structured}}
+          **Accessibility Features:** {{planned_accessibility_support}}
+          **Skill Requirements:** {{what_skills_players_need}}
+
+  - id: art-audio-direction
+    title: Art and Audio Direction
+    instruction: Establish the aesthetic vision that will guide asset creation
+    sections:
+      - id: visual-style
+        title: Visual Style
+        template: |
+          **Art Direction:** {{style_description}}
+          **Reference Materials:** {{visual_inspiration_sources}}
+          **Technical Approach:** {{2d_style_pixel_vector_etc}}
+          **Color Strategy:** {{color_palette_mood}}
+      - id: audio-direction
+        title: Audio Direction
+        template: |
+          **Music Style:** {{genre_and_mood}}
+          **Sound Design:** {{audio_personality}}
+          **Implementation Needs:** {{technical_audio_requirements}}
+      - id: ui-ux-approach
+        title: UI/UX Approach
+        template: |
+          **Interface Style:** {{ui_aesthetic}}
+          **User Experience Goals:** {{ux_priorities}}
+          **Platform Adaptations:** {{cross_platform_considerations}}
+
+  - id: risk-assessment
+    title: Risk Assessment
+    instruction: Identify potential challenges and mitigation strategies
+    sections:
+      - id: technical-risks
+        title: Technical Risks
+        type: table
+        template: |
+          | Risk | Probability | Impact | Mitigation Strategy |
+          | ---- | ----------- | ------ | ------------------- |
+          | {{technical_risk}} | {{high|med|low}} | {{high|med|low}} | {{mitigation_approach}} |
+      - id: design-risks
+        title: Design Risks
+        type: table
+        template: |
+          | Risk | Probability | Impact | Mitigation Strategy |
+          | ---- | ----------- | ------ | ------------------- |
+          | {{design_risk}} | {{high|med|low}} | {{high|med|low}} | {{mitigation_approach}} |
+      - id: market-risks
+        title: Market Risks
+        type: table
+        template: |
+          | Risk | Probability | Impact | Mitigation Strategy |
+          | ---- | ----------- | ------ | ------------------- |
+          | {{market_risk}} | {{high|med|low}} | {{high|med|low}} | {{mitigation_approach}} |
+
+  - id: success-criteria
+    title: Success Criteria
+    instruction: Define measurable goals for the project
+    sections:
+      - id: player-experience-metrics
+        title: Player Experience Metrics
+        template: |
+          **Engagement Goals:**
+
+          - Tutorial completion rate: >{{percentage}}%
+          - Average session length: {{duration}} minutes
+          - Player retention: D1 {{d1}}%, D7 {{d7}}%, D30 {{d30}}%
+
+          **Quality Benchmarks:**
+
+          - Player satisfaction: >{{rating}}/10
+          - Completion rate: >{{percentage}}%
+          - Technical performance: {{fps_target}} FPS consistent
+      - id: development-metrics
+        title: Development Metrics
+        template: |
+          **Technical Targets:**
+
+          - Zero critical bugs at launch
+          - Performance targets met on all platforms
+          - Load times under {{seconds}}s
+
+          **Process Goals:**
+
+          - Development timeline adherence
+          - Feature scope completion
+          - Quality assurance standards
+      - id: business-metrics
+        title: Business Metrics
+        condition: has_business_goals
+        template: |
+          **Commercial Goals:**
+
+          - {{revenue_target}} in first {{time_period}}
+          - {{user_acquisition_target}} players in first {{time_period}}
+          - {{retention_target}} monthly active users
+
+  - id: next-steps
+    title: Next Steps
+    instruction: Define immediate actions following the brief completion
+    sections:
+      - id: immediate-actions
+        title: Immediate Actions
+        type: numbered-list
+        template: |
+          **{{action_item}}** - {{details_and_timeline}}
+      - id: development-roadmap
+        title: Development Roadmap
+        sections:
+          - id: phase-1-preproduction
+            title: "Phase 1: Pre-Production ({{duration}})"
+            type: bullet-list
+            template: |
+              - Detailed Game Design Document creation
+              - Technical architecture planning
+              - Art style exploration and pipeline setup
+          - id: phase-2-prototype
+            title: "Phase 2: Prototype ({{duration}})"
+            type: bullet-list
+            template: |
+              - Core mechanic implementation
+              - Technical proof of concept
+              - Initial playtesting and iteration
+          - id: phase-3-production
+            title: "Phase 3: Production ({{duration}})"
+            type: bullet-list
+            template: |
+              - Full feature development
+              - Content creation and integration
+              - Comprehensive testing and optimization
+      - id: documentation-pipeline
+        title: Documentation Pipeline
+        sections:
+          - id: required-documents
+            title: Required Documents
+            type: numbered-list
+            template: |
+              Game Design Document (GDD) - {{target_completion}}
+              Technical Architecture Document - {{target_completion}}
+              Art Style Guide - {{target_completion}}
+              Production Plan - {{target_completion}}
+      - id: validation-plan
+        title: Validation Plan
+        template: |
+          **Concept Testing:**
+
+          - {{validation_method_1}} - {{timeline}}
+          - {{validation_method_2}} - {{timeline}}
+
+          **Prototype Testing:**
+
+          - {{testing_approach}} - {{timeline}}
+          - {{feedback_collection_method}} - {{timeline}}
+
+  - id: appendices
+    title: Appendices
+    sections:
+      - id: research-materials
+        title: Research Materials
+        instruction: Include any supporting research, competitive analysis, or market data that informed the brief
+      - id: brainstorming-notes
+        title: Brainstorming Session Notes
+        instruction: Reference any brainstorming sessions that led to this brief
+      - id: stakeholder-input
+        title: Stakeholder Input
+        instruction: Include key input from stakeholders that shaped the vision
+      - id: change-log
+        title: Change Log
+        instruction: Track document versions and changes
+        type: table
+        template: |
+          | Date | Version | Description | Author |
+          | :--- | :------ | :---------- | :----- |

package/expansion-packs/bmad-2d-phaser-game-dev/templates/game-design-doc-tmpl.yaml

@@ -0,0 +1,344 @@
+# <!-- Powered by BMAD™ Core -->
+template:
+  id: game-design-doc-template-v2
+  name: Game Design Document (GDD)
+  version: 2.0
+  output:
+    format: markdown
+    filename: "docs/{{game_name}}-game-design-document.md"
+    title: "{{game_title}} Game Design Document (GDD)"
+
+workflow:
+  mode: interactive
+
+sections:
+  - id: initial-setup
+    instruction: |
+      This template creates a comprehensive Game Design Document that will serve as the foundation for all game development work. The GDD should be detailed enough that developers can create user stories and epics from it. Focus on gameplay systems, mechanics, and technical requirements that can be broken down into implementable features.
+
+      If available, review any provided documents or ask if any are optionally available: Project Brief, Market Research, Competitive Analysis
+
+  - id: executive-summary
+    title: Executive Summary
+    instruction: Create a compelling overview that captures the essence of the game. Present this section first and get user feedback before proceeding.
+    sections:
+      - id: core-concept
+        title: Core Concept
+        instruction: 2-3 sentences that clearly describe what the game is and why players will love it
+      - id: target-audience
+        title: Target Audience
+        instruction: Define the primary and secondary audience with demographics and gaming preferences
+        template: |
+          **Primary:** {{age_range}}, {{player_type}}, {{platform_preference}}
+          **Secondary:** {{secondary_audience}}
+      - id: platform-technical
+        title: Platform & Technical Requirements
+        instruction: Based on the technical preferences or user input, define the target platforms
+        template: |
+          **Primary Platform:** {{platform}}
+          **Engine:** Phaser 3 + TypeScript
+          **Performance Target:** 60 FPS on {{minimum_device}}
+          **Screen Support:** {{resolution_range}}
+      - id: unique-selling-points
+        title: Unique Selling Points
+        instruction: List 3-5 key features that differentiate this game from competitors
+        type: numbered-list
+        template: "{{usp}}"
+
+  - id: core-gameplay
+    title: Core Gameplay
+    instruction: This section defines the fundamental game mechanics. After presenting each subsection, apply `tasks#advanced-elicitation` protocol to ensure completeness.
+    sections:
+      - id: game-pillars
+        title: Game Pillars
+        instruction: Define 3-5 core pillars that guide all design decisions. These should be specific and actionable.
+        type: numbered-list
+        template: |
+          **{{pillar_name}}** - {{description}}
+      - id: core-gameplay-loop
+        title: Core Gameplay Loop
+        instruction: Define the 30-60 second loop that players will repeat. Be specific about timing and player actions.
+        template: |
+          **Primary Loop ({{duration}} seconds):**
+
+          1. {{action_1}} ({{time_1}}s)
+          2. {{action_2}} ({{time_2}}s)
+          3. {{action_3}} ({{time_3}}s)
+          4. {{reward_feedback}} ({{time_4}}s)
+      - id: win-loss-conditions
+        title: Win/Loss Conditions
+        instruction: Clearly define success and failure states
+        template: |
+          **Victory Conditions:**
+
+          - {{win_condition_1}}
+          - {{win_condition_2}}
+
+          **Failure States:**
+
+          - {{loss_condition_1}}
+          - {{loss_condition_2}}
+
+  - id: game-mechanics
+    title: Game Mechanics
+    instruction: Detail each major mechanic that will need to be implemented. Each mechanic should be specific enough for developers to create implementation stories.
+    sections:
+      - id: primary-mechanics
+        title: Primary Mechanics
+        repeatable: true
+        sections:
+          - id: mechanic
+            title: "{{mechanic_name}}"
+            template: |
+              **Description:** {{detailed_description}}
+
+              **Player Input:** {{input_method}}
+
+              **System Response:** {{game_response}}
+
+              **Implementation Notes:**
+
+              - {{tech_requirement_1}}
+              - {{tech_requirement_2}}
+              - {{performance_consideration}}
+
+              **Dependencies:** {{other_mechanics_needed}}
+      - id: controls
+        title: Controls
+        instruction: Define all input methods for different platforms
+        type: table
+        template: |
+          | Action | Desktop | Mobile | Gamepad |
+          | ------ | ------- | ------ | ------- |
+          | {{action}} | {{key}} | {{gesture}} | {{button}} |
+
+  - id: progression-balance
+    title: Progression & Balance
+    instruction: Define how players advance and how difficulty scales. This section should provide clear parameters for implementation.
+    sections:
+      - id: player-progression
+        title: Player Progression
+        template: |
+          **Progression Type:** {{linear|branching|metroidvania}}
+
+          **Key Milestones:**
+
+          1. **{{milestone_1}}** - {{unlock_description}}
+          2. **{{milestone_2}}** - {{unlock_description}}
+          3. **{{milestone_3}}** - {{unlock_description}}
+      - id: difficulty-curve
+        title: Difficulty Curve
+        instruction: Provide specific parameters for balancing
+        template: |
+          **Tutorial Phase:** {{duration}} - {{difficulty_description}}
+          **Early Game:** {{duration}} - {{difficulty_description}}
+          **Mid Game:** {{duration}} - {{difficulty_description}}
+          **Late Game:** {{duration}} - {{difficulty_description}}
+      - id: economy-resources
+        title: Economy & Resources
+        condition: has_economy
+        instruction: Define any in-game currencies, resources, or collectibles
+        type: table
+        template: |
+          | Resource | Earn Rate | Spend Rate | Purpose | Cap |
+          | -------- | --------- | ---------- | ------- | --- |
+          | {{resource}} | {{rate}} | {{rate}} | {{use}} | {{max}} |
+
+  - id: level-design-framework
+    title: Level Design Framework
+    instruction: Provide guidelines for level creation that developers can use to create level implementation stories
+    sections:
+      - id: level-types
+        title: Level Types
+        repeatable: true
+        sections:
+          - id: level-type
+            title: "{{level_type_name}}"
+            template: |
+              **Purpose:** {{gameplay_purpose}}
+              **Duration:** {{target_time}}
+              **Key Elements:** {{required_mechanics}}
+              **Difficulty:** {{relative_difficulty}}
+
+              **Structure Template:**
+
+              - Introduction: {{intro_description}}
+              - Challenge: {{main_challenge}}
+              - Resolution: {{completion_requirement}}
+      - id: level-progression
+        title: Level Progression
+        template: |
+          **World Structure:** {{linear|hub|open}}
+          **Total Levels:** {{number}}
+          **Unlock Pattern:** {{progression_method}}
+
+  - id: technical-specifications
+    title: Technical Specifications
+    instruction: Define technical requirements that will guide architecture and implementation decisions. Review any existing technical preferences.
+    sections:
+      - id: performance-requirements
+        title: Performance Requirements
+        template: |
+          **Frame Rate:** 60 FPS (minimum 30 FPS on low-end devices)
+          **Memory Usage:** <{{memory_limit}}MB
+          **Load Times:** <{{load_time}}s initial, <{{level_load}}s between levels
+          **Battery Usage:** Optimized for mobile devices
+      - id: platform-specific
+        title: Platform Specific
+        template: |
+          **Desktop:**
+
+          - Resolution: {{min_resolution}} - {{max_resolution}}
+          - Input: Keyboard, Mouse, Gamepad
+          - Browser: Chrome 80+, Firefox 75+, Safari 13+
+
+          **Mobile:**
+
+          - Resolution: {{mobile_min}} - {{mobile_max}}
+          - Input: Touch, Tilt (optional)
+          - OS: iOS 13+, Android 8+
+      - id: asset-requirements
+        title: Asset Requirements
+        instruction: Define asset specifications for the art and audio teams
+        template: |
+          **Visual Assets:**
+
+          - Art Style: {{style_description}}
+          - Color Palette: {{color_specification}}
+          - Animation: {{animation_requirements}}
+          - UI Resolution: {{ui_specs}}
+
+          **Audio Assets:**
+
+          - Music Style: {{music_genre}}
+          - Sound Effects: {{sfx_requirements}}
+          - Voice Acting: {{voice_needs}}
+
+  - id: technical-architecture-requirements
+    title: Technical Architecture Requirements
+    instruction: Define high-level technical requirements that the game architecture must support
+    sections:
+      - id: engine-configuration
+        title: Engine Configuration
+        template: |
+          **Phaser 3 Setup:**
+
+          - TypeScript: Strict mode enabled
+          - Physics: {{physics_system}} (Arcade/Matter)
+          - Renderer: WebGL with Canvas fallback
+          - Scale Mode: {{scale_mode}}
+      - id: code-architecture
+        title: Code Architecture
+        template: |
+          **Required Systems:**
+
+          - Scene Management
+          - State Management
+          - Asset Loading
+          - Save/Load System
+          - Input Management
+          - Audio System
+          - Performance Monitoring
+      - id: data-management
+        title: Data Management
+        template: |
+          **Save Data:**
+
+          - Progress tracking
+          - Settings persistence
+          - Statistics collection
+          - {{additional_data}}
+
+  - id: development-phases
+    title: Development Phases
+    instruction: Break down the development into phases that can be converted to epics
+    sections:
+      - id: phase-1-core-systems
+        title: "Phase 1: Core Systems ({{duration}})"
+        sections:
+          - id: foundation-epic
+            title: "Epic: Foundation"
+            type: bullet-list
+            template: |
+              - Engine setup and configuration
+              - Basic scene management
+              - Core input handling
+              - Asset loading pipeline
+          - id: core-mechanics-epic
+            title: "Epic: Core Mechanics"
+            type: bullet-list
+            template: |
+              - {{primary_mechanic}} implementation
+              - Basic physics and collision
+              - Player controller
+      - id: phase-2-gameplay-features
+        title: "Phase 2: Gameplay Features ({{duration}})"
+        sections:
+          - id: game-systems-epic
+            title: "Epic: Game Systems"
+            type: bullet-list
+            template: |
+              - {{mechanic_2}} implementation
+              - {{mechanic_3}} implementation
+              - Game state management
+          - id: content-creation-epic
+            title: "Epic: Content Creation"
+            type: bullet-list
+            template: |
+              - Level loading system
+              - First playable levels
+              - Basic UI implementation
+      - id: phase-3-polish-optimization
+        title: "Phase 3: Polish & Optimization ({{duration}})"
+        sections:
+          - id: performance-epic
+            title: "Epic: Performance"
+            type: bullet-list
+            template: |
+              - Optimization and profiling
+              - Mobile platform testing
+              - Memory management
+          - id: user-experience-epic
+            title: "Epic: User Experience"
+            type: bullet-list
+            template: |
+              - Audio implementation
+              - Visual effects and polish
+              - Final UI/UX refinement
+
+  - id: success-metrics
+    title: Success Metrics
+    instruction: Define measurable goals for the game
+    sections:
+      - id: technical-metrics
+        title: Technical Metrics
+        type: bullet-list
+        template: |
+          - Frame rate: {{fps_target}}
+          - Load time: {{load_target}}
+          - Crash rate: <{{crash_threshold}}%
+          - Memory usage: <{{memory_target}}MB
+      - id: gameplay-metrics
+        title: Gameplay Metrics
+        type: bullet-list
+        template: |
+          - Tutorial completion: {{completion_rate}}%
+          - Average session: {{session_length}} minutes
+          - Level completion: {{level_completion}}%
+          - Player retention: D1 {{d1}}%, D7 {{d7}}%
+
+  - id: appendices
+    title: Appendices
+    sections:
+      - id: change-log
+        title: Change Log
+        instruction: Track document versions and changes
+        type: table
+        template: |
+          | Date | Version | Description | Author |
+          | :--- | :------ | :---------- | :----- |
+      - id: references
+        title: References
+        instruction: List any competitive analysis, inspiration, or research sources
+        type: bullet-list
+        template: "{{reference}}"