bmad-method 6.0.0-alpha.16 → 6.0.0-alpha.18

package/src/modules/bmgd/workflows/workflow-status/instructions.md

@@ -0,0 +1,395 @@
+# Workflow Status Check - Multi-Mode Service (BMGD)
+
+<critical>The workflow execution engine is governed by: {project-root}/\_bmad/core/tasks/workflow.xml</critical>
+<critical>You MUST have already loaded and processed: {project-root}/\_bmad/bmgd/workflows/workflow-status/workflow.yaml</critical>
+<critical>This workflow operates in multiple modes: interactive (default), validate, data, init-check, update</critical>
+<critical>Other workflows can call this as a service to avoid duplicating status logic</critical>
+<critical>⚠️ ABSOLUTELY NO TIME ESTIMATES - NEVER mention hours, days, weeks, months, or ANY time-based predictions.</critical>
+
+<workflow>
+
+<step n="0" goal="Determine execution mode">
+  <action>Check for {{mode}} parameter passed by calling workflow</action>
+  <action>Default mode = "interactive" if not specified</action>
+
+  <check if="mode == interactive">
+    <action>Continue to Step 1 for normal status check flow</action>
+  </check>
+
+  <check if="mode == validate">
+    <action>Jump to Step 10 for workflow validation service</action>
+  </check>
+
+  <check if="mode == data">
+    <action>Jump to Step 20 for data extraction service</action>
+  </check>
+
+  <check if="mode == init-check">
+    <action>Jump to Step 30 for simple init check</action>
+  </check>
+
+  <check if="mode == update">
+    <action>Jump to Step 40 for status update service</action>
+  </check>
+</step>
+
+<step n="1" goal="Check for status file">
+<action>Search {output_folder}/ for file: bmgd-workflow-status.yaml</action>
+
+<check if="no status file found">
+  <output>No game development workflow status found.</output>
+  <ask>Would you like to run Workflow Init now? (y/n)</ask>
+
+  <check if="response == y OR response == yes">
+    <action>Launching workflow-init to set up your game project tracking...</action>
+    <invoke-workflow path="{project-root}/_bmad/bmgd/workflows/workflow-status/init/workflow.yaml"></invoke-workflow>
+    <action>Exit workflow and let workflow-init take over</action>
+  </check>
+
+  <check if="else">
+    <output>No workflow status file. Run workflow-init when ready to enable progress tracking.</output>
+    <action>Exit workflow</action>
+  </check>
+</check>
+
+<check if="status file found">
+  <action>Continue to step 2</action>
+</check>
+</step>
+
+<step n="2" goal="Read and parse status">
+<action>Read bmgd-workflow-status.yaml</action>
+<action>Parse YAML file and extract metadata from comments and fields:</action>
+
+Parse these fields from YAML comments and metadata:
+
+- project (from YAML field)
+- project_type (from YAML field)
+- project_level (from YAML field)
+- field_type (from YAML field)
+- workflow_path (from YAML field)
+
+<action>Parse workflow_status section:</action>
+
+- Extract all workflow entries with their statuses
+- Identify completed workflows (status = file path)
+- Identify pending workflows (status = required/optional/recommended/conditional)
+- Identify skipped workflows (status = skipped)
+
+<action>Determine current state:</action>
+
+- Find first workflow with status != file path and != skipped
+- This is the NEXT workflow to work on
+- Look up agent and command from workflow path file
+  </step>
+
+<step n="3" goal="Display current status and options">
+<action>Load workflow path file based on workflow_path field</action>
+<action>Identify current phase from next workflow to be done</action>
+<action>Build list of completed, pending, and optional workflows</action>
+<action>For each workflow, look up its agent from the path file</action>
+
+<output>
+## 🎮 Game Dev Status
+
+**Project:** {{project}} (Level {{project_level}} {{project_type}})
+
+**Path:** {{workflow_path}}
+
+**Progress:**
+
+{{#each phases}}
+{{phase_name}}:
+{{#each workflows_in_phase}}
+
+- {{workflow_name}} ({{agent}}): {{status_display}}
+  {{/each}}
+  {{/each}}
+
+## 🎯 Next Steps
+
+**Next Workflow:** {{next_workflow_name}}
+
+**Agent:** {{next_agent}}
+
+**Command:** /bmad:bmgd:workflows:{{next_workflow_id}}
+
+{{#if optional_workflows_available}}
+**Optional Workflows Available:**
+{{#each optional_workflows}}
+
+- {{workflow_name}} ({{agent}}) - {{status}}
+  {{/each}}
+  {{/if}}
+  </output>
+  </step>
+
+<step n="4" goal="Offer actions">
+<ask>What would you like to do?
+
+1. **Start next workflow** - {{next_workflow_name}} ({{next_agent}})
+   {{#if optional_workflows_available}}
+2. **Run optional workflow** - Choose from available options
+   {{/if}}
+3. **View full status YAML** - See complete status file
+4. **Update workflow status** - Mark a workflow as completed or skipped
+5. **Exit** - Return to agent
+
+Your choice:</ask>
+
+<action>Handle user selection based on available options</action>
+
+<check if="choice == 1">
+  <output>Ready to run {{next_workflow_name}}!
+
+**Command:** /bmad:bmgd:workflows:{{next_workflow_id}}
+
+**Agent:** Load {{next_agent}} agent first
+
+{{#if next_agent !== current_agent}}
+Tip: Start a new chat and load the {{next_agent}} agent before running this workflow.
+{{/if}}
+</output>
+</check>
+
+<check if="choice == 2 AND optional_workflows_available">
+  <ask>Which optional workflow?
+{{#each optional_workflows numbered}}
+{{number}}. {{workflow_name}} ({{agent}})
+{{/each}}
+
+Your choice:</ask>
+<action>Display selected workflow command and agent</action>
+</check>
+
+<check if="choice == 3">
+  <action>Display complete bmgd-workflow-status.yaml file contents</action>
+</check>
+
+<check if="choice == 4">
+  <ask>What would you like to update?
+
+1. Mark a workflow as **completed** (provide file path)
+2. Mark a workflow as **skipped**
+
+Your choice:</ask>
+
+  <check if="update_choice == 1">
+    <ask>Which workflow? (Enter workflow ID like 'gdd' or 'create-architecture')</ask>
+    <ask>File path created? (e.g., docs/gdd.md)</ask>
+    <critical>ONLY write the file path as the status value - no other text, notes, or metadata</critical>
+    <action>Update workflow_status in YAML file: {{workflow_id}}: {{file_path}}</action>
+    <action>Save updated YAML file preserving ALL structure and comments</action>
+    <output>✅ Updated {{workflow_id}} to completed: {{file_path}}</output>
+  </check>
+
+  <check if="update_choice == 2">
+    <ask>Which workflow to skip? (Enter workflow ID)</ask>
+    <action>Update workflow_status in YAML file: {{workflow_id}}: skipped</action>
+    <action>Save updated YAML file</action>
+    <output>✅ Marked {{workflow_id}} as skipped</output>
+  </check>
+</check>
+</step>
+
+<!-- ============================================= -->
+<!-- SERVICE MODES - Called by other workflows -->
+<!-- ============================================= -->
+
+<step n="10" goal="Validate mode - Check if calling workflow should proceed">
+<action>Read {output_folder}/bmgd-workflow-status.yaml if exists</action>
+
+<check if="status file not found">
+  <template-output>status_exists = false</template-output>
+  <template-output>should_proceed = true</template-output>
+  <template-output>warning = "No status file found. Running without progress tracking."</template-output>
+  <template-output>suggestion = "Consider running workflow-init first for progress tracking"</template-output>
+  <action>Return to calling workflow</action>
+</check>
+
+<check if="status file found">
+  <action>Parse YAML file to extract project metadata and workflow_status</action>
+  <action>Load workflow path file from workflow_path field</action>
+  <action>Find first non-completed workflow in workflow_status (next workflow)</action>
+  <action>Check if {{calling_workflow}} matches next workflow or is in the workflow list</action>
+
+<template-output>status_exists = true</template-output>
+<template-output>project_level = {{project_level}}</template-output>
+<template-output>project_type = {{project_type}}</template-output>
+<template-output>field_type = {{field_type}}</template-output>
+<template-output>next_workflow = {{next_workflow_id}}</template-output>
+
+  <check if="calling_workflow == next_workflow">
+    <template-output>should_proceed = true</template-output>
+    <template-output>warning = ""</template-output>
+    <template-output>suggestion = "Proceeding with planned next step"</template-output>
+  </check>
+
+  <check if="calling_workflow in workflow_status list">
+    <action>Check the status of calling_workflow in YAML</action>
+
+    <check if="status is file path">
+      <template-output>should_proceed = true</template-output>
+      <template-output>warning = "⚠️ Workflow already completed: {{calling_workflow}}"</template-output>
+      <template-output>suggestion = "This workflow was already completed. Re-running will overwrite: {{status}}"</template-output>
+    </check>
+
+    <check if="status is optional/recommended">
+      <template-output>should_proceed = true</template-output>
+      <template-output>warning = "Running optional workflow {{calling_workflow}}"</template-output>
+      <template-output>suggestion = "This is optional. Expected next: {{next_workflow}}"</template-output>
+    </check>
+
+    <check if="status is required but not next">
+      <template-output>should_proceed = true</template-output>
+      <template-output>warning = "⚠️ Out of sequence: Expected {{next_workflow}}, running {{calling_workflow}}"</template-output>
+      <template-output>suggestion = "Consider running {{next_workflow}} instead, or continue if intentional"</template-output>
+    </check>
+
+  </check>
+
+  <check if="calling_workflow NOT in workflow_status list">
+    <template-output>should_proceed = true</template-output>
+    <template-output>warning = "⚠️ Unknown workflow: {{calling_workflow}} not in workflow path"</template-output>
+    <template-output>suggestion = "This workflow is not part of the defined path for this project"</template-output>
+  </check>
+
+<template-output>status_file_path = {{path to bmgd-workflow-status.yaml}}</template-output>
+</check>
+
+<action>Return control to calling workflow with all template outputs</action>
+</step>
+
+<step n="20" goal="Data mode - Extract specific information">
+<action>Read {output_folder}/bmgd-workflow-status.yaml if exists</action>
+
+<check if="status file not found">
+  <template-output>status_exists = false</template-output>
+  <template-output>error = "No status file to extract data from"</template-output>
+  <action>Return to calling workflow</action>
+</check>
+
+<check if="status file found">
+  <action>Parse YAML file completely</action>
+  <template-output>status_exists = true</template-output>
+
+  <check if="data_request == project_config">
+    <template-output>project_name = {{project}}</template-output>
+    <template-output>project_type = {{project_type}}</template-output>
+    <template-output>project_level = {{project_level}}</template-output>
+    <template-output>field_type = {{field_type}}</template-output>
+    <template-output>workflow_path = {{workflow_path}}</template-output>
+  </check>
+
+  <check if="data_request == workflow_status">
+    <action>Parse workflow_status section and return all workflow: status pairs</action>
+    <template-output>workflow_status = {{workflow_status_object}}</template-output>
+    <action>Calculate completion stats:</action>
+    <template-output>total_workflows = {{count all workflows}}</template-output>
+    <template-output>completed_workflows = {{count file path statuses}}</template-output>
+    <template-output>pending_workflows = {{count required/optional/etc}}</template-output>
+    <template-output>skipped_workflows = {{count skipped}}</template-output>
+  </check>
+
+  <check if="data_request == all">
+    <action>Return all parsed fields as template outputs</action>
+    <template-output>project = {{project}}</template-output>
+    <template-output>project_type = {{project_type}}</template-output>
+    <template-output>project_level = {{project_level}}</template-output>
+    <template-output>field_type = {{field_type}}</template-output>
+    <template-output>workflow_path = {{workflow_path}}</template-output>
+    <template-output>workflow_status = {{workflow_status_object}}</template-output>
+    <template-output>generated = {{generated}}</template-output>
+  </check>
+
+<template-output>status_file_path = {{path to bmgd-workflow-status.yaml}}</template-output>
+</check>
+
+<action>Return control to calling workflow with requested data</action>
+</step>
+
+<step n="30" goal="Init-check mode - Simple existence check">
+<action>Check if {output_folder}/bmgd-workflow-status.yaml exists</action>
+
+<check if="exists">
+  <template-output>status_exists = true</template-output>
+  <template-output>suggestion = "Status file found. Ready to proceed."</template-output>
+</check>
+
+<check if="not exists">
+  <template-output>status_exists = false</template-output>
+  <template-output>suggestion = "No status file. Run workflow-init to create one (optional for progress tracking)"</template-output>
+</check>
+
+<action>Return immediately to calling workflow</action>
+</step>
+
+<step n="40" goal="Update mode - Centralized status file updates">
+<action>Read {output_folder}/bmgd-workflow-status.yaml</action>
+
+<check if="status file not found">
+  <template-output>success = false</template-output>
+  <template-output>error = "No status file found. Cannot update."</template-output>
+  <action>Return to calling workflow</action>
+</check>
+
+<check if="status file found">
+  <action>Parse YAML file completely</action>
+  <action>Load workflow path file from workflow_path field</action>
+  <action>Check {{action}} parameter to determine update type</action>
+
+  <!-- ============================================= -->
+  <!-- ACTION: complete_workflow -->
+  <!-- ============================================= -->
+  <check if="action == complete_workflow">
+    <action>Get {{workflow_id}} parameter (required)</action>
+    <action>Get {{output_file}} parameter (required - path to created file)</action>
+
+    <critical>ONLY write the file path as the status value - no other text, notes, or metadata</critical>
+    <action>Update workflow status in YAML:</action>
+    - In workflow_status section, update: {{workflow_id}}: {{output_file}}
+
+    <action>Find {{workflow_id}} in loaded path YAML</action>
+    <action>Determine next workflow from path sequence</action>
+    <action>Find first workflow in workflow_status with status != file path and != skipped</action>
+
+    <action>Save updated YAML file preserving ALL structure and comments</action>
+
+    <template-output>success = true</template-output>
+    <template-output>next_workflow = {{determined next workflow}}</template-output>
+    <template-output>next_agent = {{determined next agent from path file}}</template-output>
+    <template-output>completed_workflow = {{workflow_id}}</template-output>
+    <template-output>output_file = {{output_file}}</template-output>
+
+  </check>
+
+  <!-- ============================================= -->
+  <!-- ACTION: skip_workflow -->
+  <!-- ============================================= -->
+  <check if="action == skip_workflow">
+    <action>Get {{workflow_id}} parameter (required)</action>
+
+    <action>Update workflow status in YAML:</action>
+    - In workflow_status section, update: {{workflow_id}}: skipped
+
+    <action>Save updated YAML file</action>
+
+    <template-output>success = true</template-output>
+    <template-output>skipped_workflow = {{workflow_id}}</template-output>
+
+  </check>
+
+  <!-- ============================================= -->
+  <!-- Unknown action -->
+  <!-- ============================================= -->
+  <check if="action not recognized">
+    <template-output>success = false</template-output>
+    <template-output>error = "Unknown action: {{action}}. Valid actions: complete_workflow, skip_workflow"</template-output>
+  </check>
+
+</check>
+
+<action>Return control to calling workflow with template outputs</action>
+</step>
+
+</workflow>

package/src/modules/bmgd/workflows/workflow-status/paths/gamedev-brownfield.yaml

@@ -0,0 +1,65 @@
+# BMGD Game Development - Brownfield
+# Game development methodology for existing game projects
+
+method_name: "BMGD Game Development"
+track: "gamedev"
+field_type: "brownfield"
+description: "Game development methodology for existing codebases and projects"
+
+phases:
+  - phase: 0
+    name: "Discovery (Optional)"
+    optional: true
+    note: "User-selected during workflow-init"
+    workflows:
+      - id: "brainstorm-game"
+        optional: true
+        agent: "game-designer"
+        command: "brainstorm-game"
+        included_by: "user_choice"
+        note: "Creative exploration for new features or improvements"
+
+  - phase: 1
+    name: "Design"
+    required: true
+    workflows:
+      - id: "gdd"
+        required: true
+        agent: "game-designer"
+        command: "create-gdd"
+        output: "Game Design Document for new features/systems"
+        note: "Focus on changes and additions to existing game"
+
+      - id: "narrative"
+        conditional: "if_narrative_focused"
+        agent: "game-designer"
+        command: "narrative"
+        note: "For story-driven additions"
+
+  - phase: 2
+    name: "Technical"
+    required: true
+    workflows:
+      - id: "game-architecture"
+        required: true
+        agent: "game-architect"
+        command: "create-architecture"
+        output: "Architecture update document"
+        note: "Focus on integration with existing systems"
+
+      - id: "test-framework"
+        recommended: true
+        agent: "game-qa"
+        command: "test-framework"
+        output: "Testing framework extension"
+        note: "Extend existing tests or set up new framework"
+
+  - phase: 3
+    name: "Production"
+    required: true
+    workflows:
+      - id: "sprint-planning"
+        required: true
+        agent: "game-scrum-master"
+        command: "sprint-planning"
+        note: "Creates sprint plan - subsequent work tracked in sprint-status.yaml"

package/src/modules/bmgd/workflows/workflow-status/paths/gamedev-greenfield.yaml

@@ -0,0 +1,71 @@
+# BMGD Game Development - Greenfield
+# Full game design and development methodology for new game projects
+
+method_name: "BMGD Game Development"
+track: "gamedev"
+field_type: "greenfield"
+description: "Complete game design and development methodology for greenfield projects"
+
+phases:
+  - phase: 0
+    name: "Pre-production (Optional)"
+    optional: true
+    note: "User-selected during workflow-init"
+    workflows:
+      - id: "brainstorm-game"
+        optional: true
+        agent: "game-designer"
+        command: "brainstorm-game"
+        included_by: "user_choice"
+        note: "Creative exploration and ideation for game concepts"
+
+      - id: "game-brief"
+        optional: true
+        agent: "game-designer"
+        command: "create-game-brief"
+        included_by: "user_choice"
+        note: "Recommended for greenfield game projects"
+
+  - phase: 1
+    name: "Design"
+    required: true
+    workflows:
+      - id: "gdd"
+        required: true
+        agent: "game-designer"
+        command: "create-gdd"
+        output: "Game Design Document with mechanics, systems, and content"
+
+      - id: "narrative"
+        conditional: "if_narrative_focused"
+        agent: "game-designer"
+        command: "narrative"
+        note: "For story-driven games - determined after GDD"
+
+  - phase: 2
+    name: "Technical"
+    required: true
+    workflows:
+      - id: "game-architecture"
+        required: true
+        agent: "game-architect"
+        command: "create-architecture"
+        output: "Game architecture document with systems and patterns"
+        note: "Complete technical design for game systems"
+
+      - id: "test-framework"
+        recommended: true
+        agent: "game-qa"
+        command: "test-framework"
+        output: "Game testing framework setup"
+        note: "Set up automated testing early"
+
+  - phase: 3
+    name: "Production"
+    required: true
+    workflows:
+      - id: "sprint-planning"
+        required: true
+        agent: "game-scrum-master"
+        command: "sprint-planning"
+        note: "Creates sprint plan - subsequent work tracked in sprint-status.yaml"

package/src/modules/bmgd/workflows/workflow-status/paths/quickflow-brownfield.yaml

@@ -0,0 +1,29 @@
+# BMGD Quick Flow - Brownfield
+# Rapid game development for existing projects
+
+method_name: "BMGD Quick Flow"
+track: "quickflow"
+field_type: "brownfield"
+description: "Rapid development and iteration for existing game projects"
+
+phases:
+  - phase: 1
+    name: "Planning"
+    required: true
+    workflows:
+      - id: "create-tech-spec"
+        required: true
+        agent: "game-solo-dev"
+        command: "create-tech-spec"
+        output: "Technical specification"
+        note: "Define changes for existing codebase"
+
+  - phase: 2
+    name: "Development"
+    required: true
+    workflows:
+      - id: "quick-dev"
+        required: true
+        agent: "game-solo-dev"
+        command: "quick-dev"
+        note: "Iterative development - repeat as needed"

package/src/modules/bmgd/workflows/workflow-status/paths/quickflow-greenfield.yaml

@@ -0,0 +1,39 @@
+# BMGD Quick Flow - Greenfield
+# Rapid game prototyping and development for new projects
+
+method_name: "BMGD Quick Flow"
+track: "quickflow"
+field_type: "greenfield"
+description: "Rapid prototyping and development for new game projects"
+
+phases:
+  - phase: 0
+    name: "Concept (Optional)"
+    optional: true
+    workflows:
+      - id: "brainstorm-game"
+        optional: true
+        agent: "game-solo-dev"
+        command: "brainstorm-game"
+        included_by: "user_choice"
+
+  - phase: 1
+    name: "Prototype"
+    required: true
+    workflows:
+      - id: "quick-prototype"
+        required: true
+        agent: "game-solo-dev"
+        command: "quick-prototype"
+        output: "Playable prototype"
+        note: "Test core mechanic quickly"
+
+  - phase: 2
+    name: "Development"
+    required: true
+    workflows:
+      - id: "quick-dev"
+        required: true
+        agent: "game-solo-dev"
+        command: "quick-dev"
+        note: "Iterative development - repeat as needed"

package/src/modules/bmgd/workflows/workflow-status/project-levels.yaml

@@ -0,0 +1,63 @@
+# BMGD Game Project Scale Levels - Source of Truth
+
+levels:
+  0:
+    name: "Level 0"
+    title: "Game Jam / Prototype"
+    stories: "1-5 stories"
+    description: "48-72 hour game jam, mechanic prototype, proof of concept"
+    documentation: "Minimal - quick GDD notes only"
+    architecture: false
+
+  1:
+    name: "Level 1"
+    title: "Mini Game"
+    stories: "5-15 stories"
+    description: "Small complete game, single mechanic focus, mobile hypercasual"
+    documentation: "Game Brief + Light GDD"
+    architecture: false
+
+  2:
+    name: "Level 2"
+    title: "Indie Game"
+    stories: "15-40 stories"
+    description: "Full indie title, multiple systems, polished experience"
+    documentation: "Game Brief + GDD + Architecture"
+    architecture: true
+
+  3:
+    name: "Level 3"
+    title: "AA Game"
+    stories: "40-100 stories"
+    description: "Mid-size production, team coordination, multiple platforms"
+    documentation: "Full GDD + Architecture + Narrative Design"
+    architecture: true
+
+  4:
+    name: "Level 4"
+    title: "AAA Game"
+    stories: "100+ stories"
+    description: "Large-scale production, multiple teams, live service potential"
+    documentation: "Full documentation suite + production pipelines"
+    architecture: true
+
+# Quick detection hints for workflow-init
+detection_hints:
+  keywords:
+    level_0: ["jam", "prototype", "poc", "test", "experiment", "48 hour", "weekend"]
+    level_1: ["simple", "mini", "casual", "hypercasual", "mobile", "small game"]
+    level_2: ["indie", "steam", "itch", "complete game", "full game"]
+    level_3: ["aa", "mid-size", "production", "team", "publisher"]
+    level_4: ["aaa", "large", "enterprise", "live service", "multiple teams"]
+
+  story_counts:
+    level_0: [1, 5]
+    level_1: [5, 15]
+    level_2: [15, 40]
+    level_3: [40, 100]
+    level_4: [100, 999]
+
+# Game-specific indicators
+game_indicators:
+  engine_keywords: ["unity", "unreal", "godot", "gamemaker", "construct", "rpgmaker"]
+  genre_keywords: ["platformer", "rpg", "roguelike", "shooter", "puzzle", "adventure", "strategy", "simulation"]