bmad-method 6.0.0-alpha.0 → 6.0.0-alpha.2

package/src/modules/bmm/workflows/1-analysis/research/instructions-deep-prompt.md

@@ -1,6 +1,6 @@
 # Deep Research Prompt Generator Instructions
 
-<critical>The workflow execution engine is governed by: {project_root}/bmad/core/tasks/workflow.md</critical>
+<critical>The workflow execution engine is governed by: {project_root}/bmad/core/tasks/workflow.xml</critical>
 <critical>You MUST have already loaded and processed: {installed_path}/workflow.yaml</critical>
 <critical>This workflow generates structured research prompts optimized for AI platforms</critical>
 <critical>Based on 2025 best practices from ChatGPT, Gemini, Grok, and Claude</critical>
@@ -195,7 +195,7 @@ Examples:
 
 <template-output>special_requirements</template-output>
 
-<elicit-required/>
+<invoke-task halt="true">{project-root}/bmad/core/tasks/adv-elicit.xml</invoke-task>
 
 </step>
 
@@ -251,35 +251,38 @@ Examples:
 - [r] Refine with additional context
 - [o] Optimize for different platform</ask>
 
-<check>If edit or refine:</check>
-<ask>What would you like to adjust?</ask>
-<goto step="7">Regenerate with modifications</goto>
+<check if="edit or refine">
+  <ask>What would you like to adjust?</ask>
+  <goto step="7">Regenerate with modifications</goto>
+</check>
 
 </step>
 
 <step n="8" goal="Generate Platform-Specific Tips">
 <action>Provide platform-specific usage tips based on target platform</action>
 
-<check>If target_platform includes ChatGPT:</check>
-**ChatGPT Deep Research Tips:**
+<check if="target_platform includes ChatGPT">
+  **ChatGPT Deep Research Tips:**
 
 - Use clear verbs: "compare," "analyze," "synthesize," "recommend"
 - Specify keywords explicitly to guide search
 - Answer clarifying questions thoroughly (requests are more expensive)
 - You have 25-250 queries/month depending on tier
 - Review the research plan before it starts searching
+  </check>
 
-<check>If target_platform includes Gemini:</check>
-**Gemini Deep Research Tips:**
+<check if="target_platform includes Gemini">
+  **Gemini Deep Research Tips:**
 
 - Keep initial prompt simple - you can adjust the research plan
 - Be specific and clear - vagueness is the enemy
 - Review and modify the multi-point research plan before it runs
 - Use follow-up questions to drill deeper or add sections
 - Available in 45+ languages globally
+  </check>
 
-<check>If target_platform includes Grok:</check>
-**Grok DeepSearch Tips:**
+<check if="target_platform includes Grok">
+  **Grok DeepSearch Tips:**
 
 - Include date windows: "from Jan-Jun 2025"
 - Specify output format: "bullet list + citations"
@@ -287,15 +290,17 @@ Examples:
 - Use follow-up commands: "Expand on [topic]" to deepen sections
 - Verify facts when obscure sources cited
 - Free tier: 5 queries/24hrs, Premium: 30/2hrs
+  </check>
 
-<check>If target_platform includes Claude:</check>
-**Claude Projects Tips:**
+<check if="target_platform includes Claude">
+  **Claude Projects Tips:**
 
 - Use Chain of Thought prompting for complex reasoning
 - Break into sub-prompts for multi-step research (prompt chaining)
 - Add relevant documents to Project for context
 - Provide explicit instructions and examples
 - Test iteratively and refine prompts
+  </check>
 
 <template-output>platform_tips</template-output>
 
@@ -359,12 +364,70 @@ The output includes:
 
 Select option (1-4):</ask>
 
-<check>If option 1:</check>
-<goto step="1">Start with different platform selection</goto>
+<check if="option 1">
+  <goto step="1">Start with different platform selection</goto>
+</check>
 
-<check>If option 2 or 3:</check>
-<goto step="1">Start new prompt with context from previous</goto>
+<check if="option 2 or 3">
+  <goto step="1">Start new prompt with context from previous</goto>
+</check>
 
 </step>
 
+<step n="FINAL" goal="Update status file on completion">
+<action>Search {output_folder}/ for files matching pattern: bmm-workflow-status.md</action>
+<action>Find the most recent file (by date in filename)</action>
+
+<check if="status file exists">
+  <invoke-workflow path="{project-root}/bmad/bmm/workflows/workflow-status">
+    <param>mode: update</param>
+    <param>action: complete_workflow</param>
+    <param>workflow_name: research</param>
+  </invoke-workflow>
+
+  <check if="success == true">
+    <output>Status updated! Next: {{next_workflow}}</output>
+  </check>
+
+<output>**✅ Deep Research Prompt Generated**
+
+**Research Prompt:**
+
+- Structured research prompt generated and saved
+- Ready to execute with ChatGPT, Claude, Gemini, or Grok
+
+**Status file updated:**
+
+- Current step: research (deep-prompt) ✓
+- Progress: {{new_progress_percentage}}%
+
+**Next Steps:**
+
+- **Next required:** {{next_workflow}} ({{next_agent}} agent)
+- **Optional:** Execute the research prompt with AI platform, gather findings, or run additional research workflows
+
+Check status anytime with: `workflow-status`
+</output>
+</check>
+
+<check if="status file not found">
+  <output>**✅ Deep Research Prompt Generated**
+
+**Research Prompt:**
+
+- Structured research prompt generated and saved
+
+Note: Running in standalone mode (no status file).
+
+**Next Steps:**
+
+Since no workflow is in progress:
+
+- Execute the research prompt with AI platform and gather findings
+- Refer to the BMM workflow guide if unsure what to do next
+- Or run `workflow-init` to create a workflow path and get guided next steps
+  </output>
+  </check>
+  </step>
+
 </workflow>

package/src/modules/bmm/workflows/1-analysis/research/instructions-market.md

@@ -1,6 +1,6 @@
 # Market Research Workflow Instructions
 
-<critical>The workflow execution engine is governed by: {project_root}/bmad/core/tasks/workflow.md</critical>
+<critical>The workflow execution engine is governed by: {project_root}/bmad/core/tasks/workflow.xml</critical>
 <critical>You MUST have already loaded and processed: {installed_path}/workflow.yaml</critical>
 <critical>This is an INTERACTIVE workflow with web research capabilities. Engage the user at key decision points.</critical>
 
@@ -80,7 +80,7 @@ Search queries to execute:
 - "[market_category] market growth rate CAGR forecast"
 - "[market_category] market trends [current_year]"
 
-<elicit-required/>
+<invoke-task halt="true">{project-root}/bmad/core/tasks/adv-elicit.xml</invoke-task>
 </step>
 
 <step n="3b" title="Regulatory and Government Data">
@@ -204,8 +204,8 @@ For each major segment, research and define:
 - Purchasing frequency
 - Budget allocation
 
-<elicit-required/>
-<template-output>segment_profile_{{segment_number}}</template-output>
+<invoke-task halt="true">{project-root}/bmad/core/tasks/adv-elicit.xml</invoke-task>
+<template-output>segment*profile*{{segment_number}}</template-output>
 </step>
 
 <step n="5b" title="Jobs-to-be-Done Framework">
@@ -280,8 +280,8 @@ Gather intelligence on:
 - Team and leadership
 - Customer reviews and sentiment
 
-<elicit-required/>
-<template-output>competitor_analysis_{{competitor_number}}</template-output>
+<invoke-task halt="true">{project-root}/bmad/core/tasks/adv-elicit.xml</invoke-task>
+<template-output>competitor*analysis*{{competitor_number}}</template-output>
 </step>
 
 <step n="6c" title="Competitive Positioning Map">
@@ -404,7 +404,7 @@ For each opportunity:
 - Risk assessment
 - Success criteria
 
-<elicit-required/>
+<invoke-task halt="true">{project-root}/bmad/core/tasks/adv-elicit.xml</invoke-task>
 <template-output>market_opportunities</template-output>
 </step>
 
@@ -471,8 +471,8 @@ Provide mitigation strategies.
 
 <ask>Would you like to create a financial model with revenue projections based on the market analysis?</ask>
 
-<check>If yes:</check>
-Build 3-year projections:
+<check if="yes">
+  Build 3-year projections:
 
 - Revenue model based on SOM scenarios
 - Customer acquisition projections
@@ -481,6 +481,8 @@ Build 3-year projections:
 - Funding requirements
 
 <template-output>financial_projections</template-output>
+</check>
+
 </step>
 
 <step n="11" goal="Executive Summary Creation">
@@ -537,8 +539,8 @@ Create compelling executive summary with:
 <step n="13" goal="Appendices and Supporting Materials" optional="true">
 <ask>Would you like to include detailed appendices with calculations, full competitor profiles, or raw research data?</ask>
 
-<check>If yes:</check>
-Create appendices with:
+<check if="yes">
+  Create appendices with:
 
 - Detailed TAM/SAM/SOM calculations
 - Full competitor profiles
@@ -548,6 +550,64 @@ Create appendices with:
 - Glossary of terms
 
 <template-output>appendices</template-output>
+</check>
+
 </step>
 
+<step n="14" goal="Update status file on completion">
+<action>Search {output_folder}/ for files matching pattern: bmm-workflow-status.md</action>
+<action>Find the most recent file (by date in filename)</action>
+
+<check if="status file exists">
+  <invoke-workflow path="{project-root}/bmad/bmm/workflows/workflow-status">
+    <param>mode: update</param>
+    <param>action: complete_workflow</param>
+    <param>workflow_name: research</param>
+  </invoke-workflow>
+
+  <check if="success == true">
+    <output>Status updated! Next: {{next_workflow}}</output>
+  </check>
+</check>
+
+<output>**✅ Research Complete ({{research_mode}} mode)**
+
+**Research Report:**
+
+- Research report generated and saved
+
+**Status file updated:**
+
+- Current step: research ({{research_mode}}) ✓
+- Progress: {{new_progress_percentage}}%
+
+**Next Steps:**
+
+- **Next required:** {{next_workflow}} ({{next_agent}} agent)
+- **Optional:** Review findings with stakeholders, or run additional analysis workflows (product-brief, game-brief, etc.)
+
+Check status anytime with: `workflow-status`
+</output>
+</check>
+
+<check if="status file not found">
+  <output>**✅ Research Complete ({{research_mode}} mode)**
+
+**Research Report:**
+
+- Research report generated and saved
+
+Note: Running in standalone mode (no status file).
+
+**Next Steps:**
+
+Since no workflow is in progress:
+
+- Review research findings
+- Refer to the BMM workflow guide if unsure what to do next
+- Or run `workflow-init` to create a workflow path and get guided next steps
+  </output>
+  </check>
+  </step>
+
 </workflow>

package/src/modules/bmm/workflows/1-analysis/research/instructions-router.md

@@ -1,14 +1,39 @@
 # Research Workflow Router Instructions
 
-<critical>The workflow execution engine is governed by: {project_root}/bmad/core/tasks/workflow.md</critical>
+<critical>The workflow execution engine is governed by: {project_root}/bmad/core/tasks/workflow.xml</critical>
 <critical>You MUST have already loaded and processed: {installed_path}/workflow.yaml</critical>
-<critical>This is a ROUTER that directs to specialized research instruction sets</critical>
+<critical>Communicate all responses in {communication_language}</critical>
 
 <!-- IDE-INJECT-POINT: research-subagents -->
 
 <workflow>
 
-<step n="1" goal="Welcome and Research Type Selection">
+<critical>This is a ROUTER that directs to specialized research instruction sets</critical>
+
+<step n="1" goal="Validate workflow readiness">
+<invoke-workflow path="{project-root}/bmad/bmm/workflows/workflow-status">
+  <param>mode: validate</param>
+  <param>calling_workflow: research</param>
+</invoke-workflow>
+
+<check if="status_exists == false">
+  <output>{{suggestion}}</output>
+  <output>Note: Research is optional. Continuing without progress tracking.</output>
+  <action>Set standalone_mode = true</action>
+</check>
+
+<check if="status_exists == true">
+  <action>Store {{status_file_path}} for status updates in sub-workflows</action>
+  <action>Pass status_file_path to loaded instruction set</action>
+
+  <check if="warning != ''">
+    <output>{{warning}}</output>
+    <output>Note: Research can provide valuable insights at any project stage.</output>
+  </check>
+</check>
+</step>
+
+<step n="2" goal="Welcome and Research Type Selection">
 <action>Welcome the user to the Research Workflow</action>
 
 **The Research Workflow supports multiple research types:**
@@ -47,44 +72,53 @@ Present the user with research type options:
 
 </step>
 
-<step n="2" goal="Route to Appropriate Research Instructions">
+<step n="3" goal="Route to Appropriate Research Instructions">
 
 <critical>Based on user selection, load the appropriate instruction set</critical>
 
-<check>If research_type == "1" OR "market" OR "market research":</check>
-<action>Set research_mode = "market"</action>
-<action>LOAD: {installed_path}/instructions-market.md</action>
-<action>Continue with market research workflow</action>
-
-<check>If research_type == "2" OR "prompt" OR "deep research prompt":</check>
-<action>Set research_mode = "deep-prompt"</action>
-<action>LOAD: {installed_path}/instructions-deep-prompt.md</action>
-<action>Continue with deep research prompt generation</action>
-
-<check>If research_type == "3" OR "technical" OR "architecture":</check>
-<action>Set research_mode = "technical"</action>
-<action>LOAD: {installed_path}/instructions-technical.md</action>
-<action>Continue with technical research workflow</action>
-
-<check>If research_type == "4" OR "competitive":</check>
-<action>Set research_mode = "competitive"</action>
-<action>This will use market research workflow with competitive focus</action>
-<action>LOAD: {installed_path}/instructions-market.md</action>
-<action>Pass mode="competitive" to focus on competitive intelligence</action>
-
-<check>If research_type == "5" OR "user":</check>
-<action>Set research_mode = "user"</action>
-<action>This will use market research workflow with user research focus</action>
-<action>LOAD: {installed_path}/instructions-market.md</action>
-<action>Pass mode="user" to focus on customer insights</action>
-
-<check>If research_type == "6" OR "domain" OR "industry":</check>
-<action>Set research_mode = "domain"</action>
-<action>This will use market research workflow with domain focus</action>
-<action>LOAD: {installed_path}/instructions-market.md</action>
-<action>Pass mode="domain" to focus on industry/domain analysis</action>
-
-<critical>The loaded instruction set will continue from here with full context</critical>
+<check if="research_type == 1 OR fuzzy match market research">
+  <action>Set research_mode = "market"</action>
+  <action>LOAD: {installed_path}/instructions-market.md</action>
+  <action>Continue with market research workflow</action>
+</check>
+
+<check if="research_type == 2 or prompt or fuzzy match deep research prompt">
+  <action>Set research_mode = "deep-prompt"</action>
+  <action>LOAD: {installed_path}/instructions-deep-prompt.md</action>
+  <action>Continue with deep research prompt generation</action>
+</check>
+
+<check if="research_type == 3 technical or architecture or fuzzy match indicates technical type of research">
+  <action>Set research_mode = "technical"</action>
+  <action>LOAD: {installed_path}/instructions-technical.md</action>
+  <action>Continue with technical research workflow</action>
+
+</check>
+
+<check if="research_type == 4 or fuzzy match competitive">
+  <action>Set research_mode = "competitive"</action>
+  <action>This will use market research workflow with competitive focus</action>
+  <action>LOAD: {installed_path}/instructions-market.md</action>
+  <action>Pass mode="competitive" to focus on competitive intelligence</action>
+
+</check>
+
+<check if="research_type == 5 or fuzzy match user research">
+  <action>Set research_mode = "user"</action>
+  <action>This will use market research workflow with user research focus</action>
+  <action>LOAD: {installed_path}/instructions-market.md</action>
+  <action>Pass mode="user" to focus on customer insights</action>
+
+</check>
+
+<check if="research_type == 6 or fuzzy match domain or industry or category">
+  <action>Set research_mode = "domain"</action>
+  <action>This will use market research workflow with domain focus</action>
+  <action>LOAD: {installed_path}/instructions-market.md</action>
+  <action>Pass mode="domain" to focus on industry/domain analysis</action>
+</check>
+
+<critical>The loaded instruction set will continue from here with full context of the {research_type}</critical>
 
 </step>
 

package/src/modules/bmm/workflows/1-analysis/research/instructions-technical.md

@@ -1,6 +1,6 @@
 # Technical/Architecture Research Instructions
 
-<critical>The workflow execution engine is governed by: {project_root}/bmad/core/tasks/workflow.md</critical>
+<critical>The workflow execution engine is governed by: {project_root}/bmad/core/tasks/workflow.xml</critical>
 <critical>You MUST have already loaded and processed: {installed_path}/workflow.yaml</critical>
 <critical>This workflow conducts technical research for architecture and technology decisions</critical>
 
@@ -89,12 +89,11 @@ Consider:
 
 If you have specific options, list them. Otherwise, I'll research current leading solutions based on your requirements.</ask>
 
-<check>If user provides options:</check>
-<template-output>user_provided_options</template-output>
+<template-output if="user provides options">user_provided_options</template-output>
 
-<check>If discovering options:</check>
-<action>Conduct web research to identify current leading solutions</action>
-<action>Search for:
+<check if="discovering options">
+  <action>Conduct web research to identify current leading solutions</action>
+  <action>Search for:
 
 - "[technical_category] best tools 2025"
 - "[technical_category] comparison [use_case]"
@@ -102,11 +101,13 @@ If you have specific options, list them. Otherwise, I'll research current leadin
 - "State of [technical_category] 2025"
   </action>
 
-<elicit-required/>
+  <invoke-task halt="true">{project-root}/bmad/core/tasks/adv-elicit.xml</invoke-task>
 
 <action>Present discovered options (typically 3-5 main candidates)</action>
 <template-output>technology_options</template-output>
 
+</check>
+
 </step>
 
 <step n="4" goal="Deep Dive Research on Each Option">
@@ -172,8 +173,8 @@ Research and document:
 - Training costs
 - Total cost of ownership estimate
 
-<elicit-required/>
-<template-output>tech_profile_{{option_number}}</template-output>
+<invoke-task halt="true">{project-root}/bmad/core/tasks/adv-elicit.xml</invoke-task>
+<template-output>tech*profile*{{option_number}}</template-output>
 
 </step>
 
@@ -283,7 +284,7 @@ For top 2-3 candidates:
 
 <ask>Are you researching architecture patterns (microservices, event-driven, etc.)?</ask>
 
-<check>If yes:</check>
+<check if="yes">
 
 Research and document:
 
@@ -308,6 +309,7 @@ Research and document:
 - Operational overhead
 
 <template-output>architecture_pattern_analysis</template-output>
+</check>
 
 </step>
 
@@ -342,7 +344,7 @@ Research and document:
 - Contingency options if primary choice doesn't work
 - Exit strategy considerations
 
-<elicit-required/>
+<invoke-task halt="true">{project-root}/bmad/core/tasks/adv-elicit.xml</invoke-task>
 
 <template-output>recommendations</template-output>
 
@@ -433,10 +435,67 @@ Create ADR format documentation:
 
 Select option (1-5):</ask>
 
-<check>If option 4:</check>
-<action>LOAD: {installed_path}/instructions-deep-prompt.md</action>
-<action>Pre-populate with technical research context</action>
+<check if="option 4">
+  <action>LOAD: {installed_path}/instructions-deep-prompt.md</action>
+  <action>Pre-populate with technical research context</action>
+</check>
 
 </step>
 
+<step n="FINAL" goal="Update status file on completion">
+<action>Search {output_folder}/ for files matching pattern: bmm-workflow-status.md</action>
+<action>Find the most recent file (by date in filename)</action>
+
+<check if="status file exists">
+  <invoke-workflow path="{project-root}/bmad/bmm/workflows/workflow-status">
+    <param>mode: update</param>
+    <param>action: complete_workflow</param>
+    <param>workflow_name: research</param>
+  </invoke-workflow>
+
+  <check if="success == true">
+    <output>Status updated! Next: {{next_workflow}}</output>
+  </check>
+</check>
+
+<output>**✅ Technical Research Complete**
+
+**Research Report:**
+
+- Technical research report generated and saved
+
+**Status file updated:**
+
+- Current step: research (technical) ✓
+- Progress: {{new_progress_percentage}}%
+
+**Next Steps:**
+
+- **Next required:** {{next_workflow}} ({{next_agent}} agent)
+- **Optional:** Review findings with architecture team, or run additional analysis workflows
+
+Check status anytime with: `workflow-status`
+</output>
+</check>
+
+<check if="status file not found">
+  <output>**✅ Technical Research Complete**
+
+**Research Report:**
+
+- Technical research report generated and saved
+
+Note: Running in standalone mode (no status file).
+
+**Next Steps:**
+
+Since no workflow is in progress:
+
+- Review technical research findings
+- Refer to the BMM workflow guide if unsure what to do next
+- Or run `workflow-init` to create a workflow path and get guided next steps
+  </output>
+  </check>
+  </step>
+
 </workflow>

package/src/modules/bmm/workflows/1-analysis/research/template-deep-prompt.md

@@ -62,7 +62,7 @@
 
 ---
 
-## Complete Research Prompt (Copy & Paste)
+## Complete Research Prompt (Copy and Paste)
 
 ```
 {{deep_research_prompt}}

package/src/modules/bmm/workflows/1-analysis/research/template-market.md

@@ -22,7 +22,7 @@
 
 ---
 
-## 1. Research Objectives & Methodology
+## 1. Research Objectives and Methodology
 
 ### Research Objectives