feat: Refine WeChat mini-game workflows and documentation

This commit refines the development workflows in the `bmad-wechat-mini-game-dev` expansion pack to align with user feedback and the newly established agent roles.

The following changes have been made:

1.  **Updated Greenfield Workflow:**
    - The `game-dev-greenfield.yaml` workflow has been updated to a new, more structured planning sequence: `game-analyst` -> `game-pm` -> `game-designer` -> `game-orchestrator` -> `game-po`.
    - The corresponding Mermaid diagram has been updated to visually represent this new process.

2.  **Streamlined Prototype Workflow:**
    - The `game-prototype.yaml` workflow has been simplified to better support rapid, iterative prototyping.
    - The Mermaid diagram for the prototype workflow has also been updated.

These changes make the workflows more specific, structured, and better aligned with the specialized agent roles in the team, fulfilling the user's request for a more optimized development process.
This commit is contained in:
google-labs-jules[bot] 2025-08-20 10:26:25 +00:00
parent 7d66ac29db
commit f9da9eb35f
2 changed files with 60 additions and 108 deletions

View File

@ -12,74 +12,52 @@ workflow:
- prototype-game
- game-jam
full_game_sequence:
- agent: game-designer
- agent: game-analyst
creates: game-brief.md
optional_steps:
- brainstorming_session
- game_research_prompt
- player_research
notes: "Start with brainstorming game concepts, then create comprehensive game brief. SAVE OUTPUT: Copy final game-brief.md to your project's docs/design/ folder."
- market_research
notes: "The Analyst creates the initial Game Brief, defining the core concept and market opportunity."
- agent: game-pm
creates: prd.md
requires: game-brief.md
notes: "The Project Manager expands the brief into a full Product Requirements Document (PRD), defining features, epics, and user stories."
- agent: game-designer
creates: game-design-doc.md
requires: game-brief.md
optional_steps:
- competitive_analysis
- technical_research
notes: "Create detailed Game Design Document using game-design-doc-tmpl. Defines all gameplay mechanics, progression, and technical requirements. SAVE OUTPUT: Copy final game-design-doc.md to your project's docs/design/ folder."
- agent: game-qa
validates: gdd_testability
requires: game-design-doc.md
optional_steps:
- risk_assessment
notes: "(Optional but Recommended) The QA agent reviews the GDD for testability, clarity, and potential performance risks."
requires: prd.md
notes: "The Game Designer uses the PRD to create a detailed Game Design Document (GDD), focusing on mechanics, game feel, and player experience."
- agent: game-orchestrator
creates: game-architecture.md
requires: game-design-doc.md
optional_steps:
- technical_research_prompt
- performance_analysis
- platform_research
notes: "Create comprehensive technical architecture using game-architecture-tmpl. Defines WeChat Mini-Game systems, performance optimization, and code structure. SAVE OUTPUT: Copy final game-architecture.md to your project's docs/architecture/ folder."
- agent: game-pm
creates: project-plan.md
requires:
- prd.md
- game-design-doc.md
- game-architecture.md
notes: "The PM creates a high-level project plan, including timelines, milestones, and epics, based on the GDD and architecture."
notes: "The Orchestrator creates the technical architecture to support the GDD and PRD."
- agent: game-po
validates: all_documents
action: shard_documents
requires:
- game-brief.md
- prd.md
- game-design-doc.md
- game-architecture.md
- project-plan.md
uses: game-design-checklist
notes: The Product Owner validates all planning documents for consistency, completeness, and alignment with the project's goals.
- agent: various
updates: flagged_design_documents
condition: validation_issues
notes: If validation finds issues, return to the relevant agent to fix and re-export the updated documents to the docs/ folder.
notes: "The Product Owner shards the final documents into epics and stories for the development team."
project_setup_guidance:
action: guide_game_project_structure
notes: Set up the game project structure following the game architecture document. Create pages/, components/, js/, and images/ directories. Initialize WeChat Mini-Game configuration.
workflow_end:
action: move_to_story_development
notes: All planning artifacts are complete. Begin the story-driven development phase. Use the Game Scrum Master to create implementation stories from the design documents.
notes: All planning artifacts are complete and sharded. Begin the story-driven development phase.
prototype_sequence:
- step: prototype_scope
action: assess_prototype_complexity
notes: First, assess if this needs a full game design (use full_game_sequence) or can be a rapid prototype.
- agent: game-designer
creates: game-brief.md
optional_steps:
- quick_brainstorming
- concept_validation
notes: "Create a focused game brief for the prototype. Emphasize core mechanics and immediate playability. SAVE OUTPUT: Copy final game-brief.md to your project's docs/ folder."
agent: game-analyst
action: assess_prototype_scope
notes: "The Analyst quickly defines the core concept and scope for a prototype."
- agent: game-designer
creates: prototype-design.md
uses: create-doc prototype-design OR create-game-story
requires: game-brief.md
notes: Create a minimal design document or jump directly to implementation stories for rapid prototyping. Choose based on the prototype's complexity.
requires: concept-summary.md
notes: "The Designer creates a minimal design spec for the core mechanic."
- agent: game-developer
action: implement_prototype
requires: prototype-design.md
notes: "The Developer rapidly implements the core mechanic for playtesting."
prototype_workflow_end:
action: move_to_rapid_implementation
notes: The prototype is defined. Begin immediate implementation with the Game Developer. Focus on core mechanics first, then iterate based on playtesting.
@ -87,35 +65,29 @@ workflow:
```mermaid
graph TD
A[Start: WeChat Game Development Project] --> B{Project Scope?}
B -->|Full Game/Production| C[game-designer: game-brief.md]
B -->|Prototype/Game Jam| D[game-designer: focused game-brief.md]
B -->|Full Game/Production| C[game-analyst: game-brief.md]
B -->|Prototype/Game Jam| D[game-analyst: prototype-scope.md]
C --> E[game-designer: game-design-doc.md]
E --> F{QA Review? (Optional)}
F -->|Yes| G[game-qa: GDD Testability Review]
F -->|No| H[game-orchestrator: game-architecture.md]
G --> H
H --> I[game-pm: project-plan.md]
I --> J[game-po: Validate All Documents]
J --> K{Validation Issues?}
K -->|Yes| L[Return to relevant agent for fixes]
K -->|No| M[Set up game project structure]
L --> J
M --> N[Move to Story Development Phase]
C --> E[game-pm: prd.md]
E --> F[game-designer: game-design-doc.md]
F --> G[game-orchestrator: game-architecture.md]
G --> H[game-po: Shard Documents]
H --> I[Move to Story Development Phase]
D --> O[game-designer: prototype-design.md]
O --> P[Move to Rapid Implementation]
D --> J[game-designer: prototype-design.md]
J --> K[game-developer: Implement Prototype]
K --> L[Prototype Evaluation & Iteration]
style N fill:#90EE90
style P fill:#90EE90
style I fill:#90EE90
style L fill:#90EE90
style C fill:#FFE4B5
style E fill:#FFE4B5
style E fill:#ADD8E6
style F fill:#E6E6FA
style G fill:#FFDAB9
style H fill:#E6E6FA
style I fill:#ADD8E6
style J fill:#FFB6C1
style H fill:#FFB6C1
style D fill:#FFB6C1
style O fill:#FFB6C1
style J fill:#FFB6C1
style K fill:#FFB6C1
```
decision_guidance:
use_full_sequence_when:

View File

@ -13,44 +13,28 @@ workflow:
- rapid-iteration
prototype_sequence:
- step: concept_definition
agent: game-designer
agent: game-analyst
duration: 15-30 minutes
creates: concept-summary.md
notes: Quickly define core game concept, primary mechanic, and target experience. Focus on what makes this game unique and fun.
notes: "The Analyst quickly defines the core concept, target experience, and success criteria for the prototype."
- step: rapid_design
agent: game-designer
duration: 30-60 minutes
creates: prototype-spec.md
requires: concept-summary.md
optional_steps:
- quick_brainstorming
- reference_research
notes: Create minimal but complete design specification. Focus on core mechanics, basic controls, and success/failure conditions.
- step: technical_planning
agent: game-developer
duration: 15-30 minutes
creates: prototype-architecture.md
requires: prototype-spec.md
notes: Define a minimal technical implementation plan. Identify the core WeChat Mini-Game systems needed and any performance constraints.
- step: implementation_stories
agent: game-sm
duration: 30-45 minutes
creates: prototype-stories/
requires:
- prototype-spec.md
- prototype-architecture.md
notes: Create 3-5 focused implementation stories for the core prototype features. Each story should be completable in 2-4 hours.
- step: iterative_development
notes: "The Designer creates a minimal design spec, focusing on the core mechanic and controls."
- step: implementation
agent: game-developer
duration: varies
implements: prototype-stories/
notes: Implement stories in priority order. Test frequently and adjust the design based on what feels fun. Document discoveries.
creates: working-prototype
requires: prototype-spec.md
notes: "The Developer directly implements the core mechanic for rapid playtesting and iteration. No formal stories are created."
- step: qa_check
agent: game-qa
duration: 15-30 minutes
optional: true
requires: working-prototype
notes: "(Optional) Perform a quick QA check to ensure the prototype is stable enough for effective playtesting and feedback."
notes: "(Optional) Perform a quick stability check to ensure the prototype is usable for feedback sessions."
workflow_end:
action: prototype_evaluation
notes: "Prototype complete. Evaluate the core mechanics, gather feedback, and decide on the next steps: iterate, expand, or archive."
@ -73,31 +57,27 @@ workflow:
```mermaid
graph TD
A[Start: Prototype Project] --> B{Development Context?}
B -->|Standard Prototype| C[game-designer: concept-summary.md]
B -->|Standard Prototype| C[game-analyst: concept-summary.md]
B -->|Game Jam| D[game-designer: jam-concept.md]
C --> E[game-designer: prototype-spec.md]
E --> F[game-developer: prototype-architecture.md]
F --> G[game-sm: create prototype stories]
G --> H[game-developer: iterative implementation]
H --> I{QA Check? (Optional)}
I -->|Yes| J[game-qa: Stability Check]
I -->|No| K[Prototype Evaluation]
J --> K
E --> F[game-developer: implementation]
F --> G{QA Check? (Optional)}
G -->|Yes| H[game-qa: Stability Check]
G -->|No| I[Prototype Evaluation]
H --> I
D --> L[game-developer: direct implementation]
L --> M[Game Jam Submission]
D --> J[game-developer: direct implementation]
J --> K[Game Jam Submission]
style I fill:#90EE90
style K fill:#90EE90
style M fill:#90EE90
style C fill:#FFE4B5
style E fill:#FFE4B5
style F fill:#FFE4B5
style G fill:#FFE4B5
style H fill:#FFE4B5
style J fill:#FFDAB9
style H fill:#FFDAB9
style D fill:#FFB6C1
style L fill:#FFB6C1
style J fill:#FFB6C1
```
decision_guidance:
use_prototype_sequence_when: