all workflows aware

2025-12-29 16:14:59 +00:00 · 2025-10-12 22:19:28 -05:00
parent 88989d5403
commit 36bf506241
18 changed files with 1488 additions and 68 deletions
--- a/src/modules/bmm/workflows/1-analysis/brainstorm-game/instructions.md
+++ b/src/modules/bmm/workflows/1-analysis/brainstorm-game/instructions.md
@@ -4,7 +4,35 @@

 <workflow>

-  <step n="1" goal="Load game brainstorming context and techniques">
+  <step n="1" goal="Check and load workflow status file">
+    <action>Search {output_folder}/ for files matching pattern: project-workflow-status*.md</action>
+    <action>Find the most recent file (by date in filename: project-workflow-status-YYYY-MM-DD.md)</action>
+
+    <check if="exists">
+      <action>Load the status file</action>
+      <action>Set status_file_found = true</action>
+      <action>Store status_file_path for later updates</action>
+    </check>
+
+    <check if="not exists">
+      <ask>**No workflow status file found.**
+
+This workflow generates brainstorming ideas for game ideation (optional Phase 1 workflow).
+
+Options:
+
+1. Run workflow-status first to create the status file (recommended for progress tracking)
+2. Continue in standalone mode (no progress tracking)
+3. Exit
+
+What would you like to do?</ask>
+<action>If user chooses option 1 → HALT with message: "Please run workflow-status first, then return to brainstorm-game"</action>
+<action>If user chooses option 2 → Set standalone_mode = true and continue</action>
+<action>If user chooses option 3 → HALT</action>
+</check>
+</step>
+
+  <step n="2" goal="Load game brainstorming context and techniques">
    <action>Read the game context document from: {game_context}</action>
    <action>This context provides game-specific guidance including:
      - Focus areas for game ideation (mechanics, narrative, experience, etc.)
@@ -22,7 +50,7 @@
    </action>
  </step>

-  <step n="2" goal="Invoke CIS brainstorming with game context">
+  <step n="3" goal="Invoke CIS brainstorming with game context">
    <action>Execute the CIS brainstorming workflow with game context and additional techniques</action>
    <invoke-workflow path="{core_brainstorming}" data="{game_context}" techniques="{game_brain_methods}">
      The CIS brainstorming workflow will:
@@ -34,10 +62,68 @@
    </invoke-workflow>
  </step>

-  <step n="3" goal="Completion">
-    <action>Confirm brainstorming session completed successfully</action>
-    <action>Brainstorming results saved by CIS workflow</action>
-    <action>Report workflow completion</action>
-  </step>
+  <step n="4" goal="Update status file on completion">
+    <action>Search {output_folder}/ for files matching pattern: project-workflow-status*.md</action>
+    <action>Find the most recent file (by date in filename)</action>
+
+    <check if="status file exists">
+      <action>Load the status file</action>
+
+      <template-output file="{{status_file_path}}">current_step</template-output>
+      <action>Set to: "brainstorm-game"</action>
+
+      <template-output file="{{status_file_path}}">current_workflow</template-output>
+      <action>Set to: "brainstorm-game - Complete"</action>
+
+      <template-output file="{{status_file_path}}">progress_percentage</template-output>
+      <action>Increment by: 5% (optional Phase 1 workflow)</action>
+
+      <template-output file="{{status_file_path}}">decisions_log</template-output>
+      <action>Add entry:</action>
+      ```
+      - **{{date}}**: Completed brainstorm-game workflow. Generated game brainstorming session results saved to {output_folder}/brainstorming-session-results-{{date}}.md. Next: Review game ideas and consider running research or game-brief workflows.
+      ```
+
+      <output>**✅ Game Brainstorming Session Complete**
+
+**Session Results:**
+
+- Game brainstorming results saved to: {output_folder}/brainstorming-session-results-{{date}}.md
+
+**Status file updated:**
+
+- Current step: brainstorm-game ✓
+- Progress: {{new_progress_percentage}}%
+
+**Next Steps:**
+
+1. Review game brainstorming results
+2. Consider running:
+   - `research` workflow for market/game research
+   - `game-brief` workflow to formalize game vision
+   - Or proceed directly to `plan-project` if ready
+
+Check status anytime with: `workflow-status`
+</output>
+</check>
+
+    <check if="status file not found">
+      <output>**✅ Game Brainstorming Session Complete**
+
+**Session Results:**
+
+- Game brainstorming results saved to: {output_folder}/brainstorming-session-results-{{date}}.md
+
+Note: Running in standalone mode (no status file).
+
+To track progress across workflows, run `workflow-status` first.
+
+**Next Steps:**
+
+1. Review game brainstorming results
+2. Run research or game-brief workflows
+   </output>
+   </check>
+   </step>

 </workflow>
--- a/src/modules/bmm/workflows/1-analysis/brainstorm-project/instructions.md
+++ b/src/modules/bmm/workflows/1-analysis/brainstorm-project/instructions.md
@@ -1,13 +1,40 @@
 # Brainstorm Project - Workflow Instructions

-```xml
+````xml
 <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 meta-workflow that orchestrates the CIS brainstorming workflow with project-specific context</critical>

 <workflow>

-  <step n="1" goal="Load project brainstorming context">
+  <step n="1" goal="Check and load workflow status file">
+    <action>Search {output_folder}/ for files matching pattern: project-workflow-status*.md</action>
+    <action>Find the most recent file (by date in filename: project-workflow-status-YYYY-MM-DD.md)</action>
+
+    <check if="exists">
+      <action>Load the status file</action>
+      <action>Set status_file_found = true</action>
+      <action>Store status_file_path for later updates</action>
+    </check>
+
+    <check if="not exists">
+      <ask>**No workflow status file found.**
+
+This workflow generates brainstorming ideas for project ideation (optional Phase 1 workflow).
+
+Options:
+1. Run workflow-status first to create the status file (recommended for progress tracking)
+2. Continue in standalone mode (no progress tracking)
+3. Exit
+
+What would you like to do?</ask>
+      <action>If user chooses option 1 → HALT with message: "Please run workflow-status first, then return to brainstorm-project"</action>
+      <action>If user chooses option 2 → Set standalone_mode = true and continue</action>
+      <action>If user chooses option 3 → HALT</action>
+    </check>
+  </step>
+
+  <step n="2" goal="Load project brainstorming context">
    <action>Read the project context document from: {project_context}</action>
    <action>This context provides project-specific guidance including:
      - Focus areas for project ideation
@@ -17,7 +44,7 @@
    </action>
  </step>

-  <step n="2" goal="Invoke core brainstorming with project context">
+  <step n="3" goal="Invoke core brainstorming with project context">
    <action>Execute the CIS brainstorming workflow with project context</action>
    <invoke-workflow path="{core_brainstorming}" data="{project_context}">
      The CIS brainstorming workflow will:
@@ -28,11 +55,64 @@
    </invoke-workflow>
  </step>

-  <step n="3" goal="Completion">
-    <action>Confirm brainstorming session completed successfully</action>
-    <action>Brainstorming results saved by CIS workflow</action>
-    <action>Report workflow completion</action>
+  <step n="4" goal="Update status file on completion">
+    <action>Search {output_folder}/ for files matching pattern: project-workflow-status*.md</action>
+    <action>Find the most recent file (by date in filename)</action>
+
+    <check if="status file exists">
+      <action>Load the status file</action>
+
+      <template-output file="{{status_file_path}}">current_step</template-output>
+      <action>Set to: "brainstorm-project"</action>
+
+      <template-output file="{{status_file_path}}">current_workflow</template-output>
+      <action>Set to: "brainstorm-project - Complete"</action>
+
+      <template-output file="{{status_file_path}}">progress_percentage</template-output>
+      <action>Increment by: 5% (optional Phase 1 workflow)</action>
+
+      <template-output file="{{status_file_path}}">decisions_log</template-output>
+      <action>Add entry:</action>
+      ```
+      - **{{date}}**: Completed brainstorm-project workflow. Generated brainstorming session results saved to {output_folder}/brainstorming-session-results-{{date}}.md. Next: Review ideas and consider running research or product-brief workflows.
+      ```
+
+      <output>**✅ Brainstorming Session Complete**
+
+**Session Results:**
+- Brainstorming results saved to: {output_folder}/brainstorming-session-results-{{date}}.md
+
+**Status file updated:**
+- Current step: brainstorm-project ✓
+- Progress: {{new_progress_percentage}}%
+
+**Next Steps:**
+1. Review brainstorming results
+2. Consider running:
+   - `research` workflow for market/technical research
+   - `product-brief` workflow to formalize product vision
+   - Or proceed directly to `plan-project` if ready
+
+Check status anytime with: `workflow-status`
+      </output>
+    </check>
+
+    <check if="status file not found">
+      <output>**✅ Brainstorming Session Complete**
+
+**Session Results:**
+- Brainstorming results saved to: {output_folder}/brainstorming-session-results-{{date}}.md
+
+Note: Running in standalone mode (no status file).
+
+To track progress across workflows, run `workflow-status` first.
+
+**Next Steps:**
+1. Review brainstorming results
+2. Run research or product-brief workflows
+      </output>
+    </check>
  </step>

 </workflow>
-```
+````
--- a/src/modules/bmm/workflows/1-analysis/document-project/instructions.md
+++ b/src/modules/bmm/workflows/1-analysis/document-project/instructions.md
@@ -6,7 +6,91 @@
 <critical>You MUST have already loaded and processed: {project-root}/bmad/bmm/workflows/document-project/workflow.yaml</critical>
 <critical>This router determines workflow mode and delegates to specialized sub-workflows</critical>

-<step n="0" goal="Check for resumability and determine workflow mode">
+<step n="1" goal="Check and load workflow status file">
+
+<action>Search {output_folder}/ for files matching pattern: project-workflow-status\*.md</action>
+<action>Find the most recent file (by date in filename: project-workflow-status-YYYY-MM-DD.md)</action>
+
+<check if="exists">
+  <action>Load the status file</action>
+  <action>Extract key information:</action>
+
+- current_step: From "Current Step:" field
+- next_step: From "Next Step:" field
+- planned_workflow: From "Planned Workflow Journey" table
+- progress_percentage: From "Overall Progress:" field
+- current_phase: From "Current Phase:" field
+- field_type: From "Greenfield/Brownfield:" field
+
+<action>Validate this workflow is in the planned workflow</action>
+<action>Set status_file_path = file path</action>
+<action>Set status_file_found = true</action>
+
+  <check if='next_step != "document-project"'>
+    <ask>**⚠️ Workflow Sequence Note**
+
+According to your status file, your next planned step is: **{{next_step}}**
+
+But you're running: **document-project**
+
+This is expected if plan-project invoked this workflow automatically for brownfield documentation.
+
+Options:
+
+1. **Continue** - Run document-project (status will be updated)
+2. **Exit** - I'll follow the planned sequence instead
+
+Your choice (1-2):</ask>
+
+    <check if='choice == "2"'>
+      <output>**Recommended Next Step:**
+
+Run: {{next_step}}
+
+You can return to document-project later if needed.
+</output>
+<action>Exit workflow</action>
+</check>
+</check>
+</check>
+
+<check if="not exists">
+  <ask>**ℹ️ No Workflow Status File Found**
+
+This workflow works best with a workflow status file for progress tracking.
+
+Options:
+
+1. **Run workflow-status first** - Create status file and plan workflow (recommended)
+2. **Continue anyway** - Run document-project standalone
+3. **Exit** - I'll set up the workflow first
+
+Your choice (1-3):</ask>
+
+  <check if='choice == "1"'>
+    <output>**To create status file:**
+
+Load any agent and run: `workflow-status`
+
+After planning your workflow, you can return here or follow the planned sequence.
+</output>
+<action>Exit workflow</action>
+</check>
+
+  <check if='choice == "2"'>
+    <action>Set status_file_found = false</action>
+    <action>Set standalone_mode = true</action>
+    <action>Continue without status file integration</action>
+  </check>
+
+  <check if='choice == "3"'>
+    <action>Exit workflow</action>
+  </check>
+</check>
+
+</step>
+
+<step n="2" goal="Check for resumability and determine workflow mode">
 <critical>SMART LOADING STRATEGY: Check state file FIRST before loading any CSV files</critical>

 <action>Check for existing state file at: {output_folder}/project-scan-report.json</action>
@@ -80,7 +164,7 @@ Your choice [1/2/3]:

 </step>

-<step n="0.5" goal="Check for existing documentation and determine workflow mode" if="resume_mode == false">
+<step n="3" goal="Check for existing documentation and determine workflow mode" if="resume_mode == false">
 <action>Check if {output_folder}/index.md exists</action>

 <check if="index.md exists">
@@ -102,6 +186,7 @@ Your choice [1/2/3]:
    <action>Set workflow_mode = "full_rescan"</action>
    <action>Display: "Starting full project rescan..."</action>
    <action>Load and execute: {installed_path}/workflows/full-scan-instructions.md</action>
+    <action>After sub-workflow completes, continue to Step 4</action>
  </check>

  <check if="user selects 2">
@@ -109,6 +194,7 @@ Your choice [1/2/3]:
    <action>Set scan_level = "exhaustive"</action>
    <action>Display: "Starting deep-dive documentation mode..."</action>
    <action>Load and execute: {installed_path}/workflows/deep-dive-instructions.md</action>
+    <action>After sub-workflow completes, continue to Step 4</action>
  </check>

  <check if="user selects 3">
@@ -121,6 +207,74 @@ Your choice [1/2/3]:
  <action>Set workflow_mode = "initial_scan"</action>
  <action>Display: "No existing documentation found. Starting initial project scan..."</action>
  <action>Load and execute: {installed_path}/workflows/full-scan-instructions.md</action>
+  <action>After sub-workflow completes, continue to Step 4</action>
+</check>
+
+</step>
+
+<step n="4" goal="Update status file on completion">
+
+<check if="status_file_found == true">
+  <action>Load the status file from {{status_file_path}}</action>
+
+<template-output file="{{status_file_path}}">planned_workflow</template-output>
+<action>Find "document-project" in the planned_workflow table</action>
+<action>Update Status field from "Planned" or "In Progress" to "Complete"</action>
+
+<template-output file="{{status_file_path}}">current_step</template-output>
+<action>Set to: "document-project"</action>
+
+<template-output file="{{status_file_path}}">next_step</template-output>
+<action>Find next item with Status != "Complete" in planned_workflow table</action>
+<action>Set to: "{{next_workflow_step}} ({{next_workflow_agent}} agent)"</action>
+
+<template-output file="{{status_file_path}}">progress_percentage</template-output>
+<action>Increment by: 10%</action>
+
+<template-output file="{{status_file_path}}">current_workflow</template-output>
+<action>Set to: "document-project - Complete"</action>
+
+<template-output file="{{status_file_path}}">decisions_log</template-output>
+<action>Add entry:</action>
+
+```
+- **{{date}}**: Completed document-project workflow ({{workflow_mode}} mode, {{scan_level}} scan). Generated brownfield documentation in {output_folder}/. Next: {{next_step}}.
+```
+
+<output>**✅ Document Project Workflow Complete**
+
+**Documentation Generated:**
+
+- Mode: {{workflow_mode}}
+- Scan Level: {{scan_level}}
+- Output: {output_folder}/index.md and related files
+
+**Status file updated:**
+
+- Current step: document-project ✓
+- Next step: {{next_step}}
+- Progress: {{new_progress_percentage}}%
+
+**To proceed:**
+Load {{next_agent}} and run: `{{next_command}}`
+
+Or check status anytime with: `workflow-status`
+</output>
+</check>
+
+<check if="standalone_mode == true">
+  <output>**✅ Document Project Workflow Complete**
+
+**Documentation Generated:**
+
+- Mode: {{workflow_mode}}
+- Scan Level: {{scan_level}}
+- Output: {output_folder}/index.md and related files
+
+Note: Running in standalone mode (no status file).
+
+To track progress across workflows, run `workflow-status` first next time.
+</output>
 </check>

 </step>
--- a/src/modules/bmm/workflows/1-analysis/game-brief/instructions.md
+++ b/src/modules/bmm/workflows/1-analysis/game-brief/instructions.md
@@ -5,7 +5,35 @@

 <workflow>

-<step n="0" goal="Initialize game brief session">
+<step n="0" goal="Check and load workflow status file">
+<action>Search {output_folder}/ for files matching pattern: project-workflow-status*.md</action>
+<action>Find the most recent file (by date in filename: project-workflow-status-YYYY-MM-DD.md)</action>
+
+<check if="exists">
+  <action>Load the status file</action>
+  <action>Set status_file_found = true</action>
+  <action>Store status_file_path for later updates</action>
+</check>
+
+<check if="not exists">
+  <ask>**No workflow status file found.**
+
+This workflow creates a Game Brief document (optional Phase 1 workflow).
+
+Options:
+
+1. Run workflow-status first to create the status file (recommended for progress tracking)
+2. Continue in standalone mode (no progress tracking)
+3. Exit
+
+What would you like to do?</ask>
+<action>If user chooses option 1 → HALT with message: "Please run workflow-status first, then return to game-brief"</action>
+<action>If user chooses option 2 → Set standalone_mode = true and continue</action>
+<action>If user chooses option 3 → HALT</action>
+</check>
+</step>
+
+<step n="1" goal="Initialize game brief session">
 <action>Welcome the user to the Game Brief creation process</action>
 <action>Explain this is a collaborative process to define their game vision</action>
 <ask>What is the working title for your game?</ask>
@@ -514,4 +542,68 @@ This brief will serve as the primary input for creating the Game Design Document
 <template-output>final_brief</template-output>
 </step>

+<step n="16" goal="Update status file on completion">
+<action>Search {output_folder}/ for files matching pattern: project-workflow-status*.md</action>
+<action>Find the most recent file (by date in filename)</action>
+
+<check if="status file exists">
+  <action>Load the status file</action>
+
+<template-output file="{{status_file_path}}">current_step</template-output>
+<action>Set to: "game-brief"</action>
+
+<template-output file="{{status_file_path}}">current_workflow</template-output>
+<action>Set to: "game-brief - Complete"</action>
+
+<template-output file="{{status_file_path}}">progress_percentage</template-output>
+<action>Increment by: 10% (optional Phase 1 workflow)</action>
+
+<template-output file="{{status_file_path}}">decisions_log</template-output>
+<action>Add entry:</action>
+
+```
+- **{{date}}**: Completed game-brief workflow. Game brief document generated and saved. Next: Proceed to plan-project workflow to create Game Design Document (GDD).
+```
+
+<output>**✅ Game Brief Complete**
+
+**Brief Document:**
+
+- Game brief saved and ready for GDD creation
+
+**Status file updated:**
+
+- Current step: game-brief ✓
+- Progress: {{new_progress_percentage}}%
+
+**Next Steps:**
+
+1. Review the game brief document
+2. Consider creating a prototype of core mechanic
+3. Run `plan-project` workflow to create GDD from this brief
+4. Validate assumptions with target players
+
+Check status anytime with: `workflow-status`
+</output>
+</check>
+
+<check if="status file not found">
+  <output>**✅ Game Brief Complete**
+
+**Brief Document:**
+
+- Game brief saved and ready for GDD creation
+
+Note: Running in standalone mode (no status file).
+
+To track progress across workflows, run `workflow-status` first.
+
+**Next Steps:**
+
+1. Review the game brief document
+2. Run `plan-project` workflow to create GDD
+   </output>
+   </check>
+   </step>
+
 </workflow>
--- a/src/modules/bmm/workflows/1-analysis/product-brief/instructions.md
+++ b/src/modules/bmm/workflows/1-analysis/product-brief/instructions.md
@@ -5,7 +5,35 @@

 <workflow>

-<step n="0" goal="Initialize product brief session">
+<step n="0" goal="Check and load workflow status file">
+<action>Search {output_folder}/ for files matching pattern: project-workflow-status*.md</action>
+<action>Find the most recent file (by date in filename: project-workflow-status-YYYY-MM-DD.md)</action>
+
+<check if="exists">
+  <action>Load the status file</action>
+  <action>Set status_file_found = true</action>
+  <action>Store status_file_path for later updates</action>
+</check>
+
+<check if="not exists">
+  <ask>**No workflow status file found.**
+
+This workflow creates a Product Brief document (optional Phase 1 workflow).
+
+Options:
+
+1. Run workflow-status first to create the status file (recommended for progress tracking)
+2. Continue in standalone mode (no progress tracking)
+3. Exit
+
+What would you like to do?</ask>
+<action>If user chooses option 1 → HALT with message: "Please run workflow-status first, then return to product-brief"</action>
+<action>If user chooses option 2 → Set standalone_mode = true and continue</action>
+<action>If user chooses option 3 → HALT</action>
+</check>
+</step>
+
+<step n="1" goal="Initialize product brief session">
 <action>Welcome the user to the Product Brief creation process</action>
 <action>Explain this is a collaborative process to define their product vision</action>
 <ask>Ask the user to provide the project name for this product brief</ask>
@@ -350,4 +378,67 @@ This brief will serve as the primary input for creating the Product Requirements
 <template-output>final_brief</template-output>
 </step>

+<step n="16" goal="Update status file on completion">
+<action>Search {output_folder}/ for files matching pattern: project-workflow-status*.md</action>
+<action>Find the most recent file (by date in filename)</action>
+
+<check if="status file exists">
+  <action>Load the status file</action>
+
+<template-output file="{{status_file_path}}">current_step</template-output>
+<action>Set to: "product-brief"</action>
+
+<template-output file="{{status_file_path}}">current_workflow</template-output>
+<action>Set to: "product-brief - Complete"</action>
+
+<template-output file="{{status_file_path}}">progress_percentage</template-output>
+<action>Increment by: 10% (optional Phase 1 workflow)</action>
+
+<template-output file="{{status_file_path}}">decisions_log</template-output>
+<action>Add entry:</action>
+
+```
+- **{{date}}**: Completed product-brief workflow. Product brief document generated and saved. Next: Proceed to plan-project workflow to create Product Requirements Document (PRD).
+```
+
+<output>**✅ Product Brief Complete**
+
+**Brief Document:**
+
+- Product brief saved and ready for handoff
+
+**Status file updated:**
+
+- Current step: product-brief ✓
+- Progress: {{new_progress_percentage}}%
+
+**Next Steps:**
+
+1. Review the product brief document
+2. Gather any additional stakeholder input
+3. Run `plan-project` workflow to create PRD from this brief
+
+Check status anytime with: `workflow-status`
+</output>
+</check>
+
+<check if="status file not found">
+  <output>**✅ Product Brief Complete**
+
+**Brief Document:**
+
+- Product brief saved and ready for handoff
+
+Note: Running in standalone mode (no status file).
+
+To track progress across workflows, run `workflow-status` first.
+
+**Next Steps:**
+
+1. Review the product brief document
+2. Run `plan-project` workflow to create PRD
+   </output>
+   </check>
+   </step>
+
 </workflow>
--- a/src/modules/bmm/workflows/1-analysis/research/instructions-deep-prompt.md
+++ b/src/modules/bmm/workflows/1-analysis/research/instructions-deep-prompt.md
@@ -374,4 +374,66 @@ Select option (1-4):</ask>

 </step>

+<step n="FINAL" goal="Update status file on completion">
+<action>Search {output_folder}/ for files matching pattern: project-workflow-status*.md</action>
+<action>Find the most recent file (by date in filename)</action>
+
+<check if="status file exists">
+  <action>Load the status file</action>
+
+<template-output file="{{status_file_path}}">current_step</template-output>
+<action>Set to: "research (deep-prompt)"</action>
+
+<template-output file="{{status_file_path}}">current_workflow</template-output>
+<action>Set to: "research (deep-prompt) - Complete"</action>
+
+<template-output file="{{status_file_path}}">progress_percentage</template-output>
+<action>Increment by: 5% (optional Phase 1 workflow)</action>
+
+<template-output file="{{status_file_path}}">decisions_log</template-output>
+<action>Add entry:</action>
+
+```
+- **{{date}}**: Completed research workflow (deep-prompt mode). Research prompt generated and saved. Next: Execute prompt with AI platform or continue with plan-project workflow.
+```
+
+<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:**
+
+1. Execute the research prompt with your chosen AI platform
+2. Gather and analyze findings
+3. Run `plan-project` to incorporate findings
+
+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:**
+
+1. Execute the research prompt with AI platform
+2. Run plan-project workflow
+   </output>
+   </check>
+   </step>
+
 </workflow>
--- a/src/modules/bmm/workflows/1-analysis/research/instructions-market.md
+++ b/src/modules/bmm/workflows/1-analysis/research/instructions-market.md
@@ -554,4 +554,69 @@ Create compelling executive summary with:

 </step>

+<step n="14" goal="Update status file on completion">
+<action>Search {output_folder}/ for files matching pattern: project-workflow-status*.md</action>
+<action>Find the most recent file (by date in filename)</action>
+
+<check if="status file exists">
+  <action>Load the status file</action>
+
+<template-output file="{{status_file_path}}">current_step</template-output>
+<action>Set to: "research ({{research_mode}})"</action>
+
+<template-output file="{{status_file_path}}">current_workflow</template-output>
+<action>Set to: "research ({{research_mode}}) - Complete"</action>
+
+<template-output file="{{status_file_path}}">progress_percentage</template-output>
+<action>Increment by: 5% (optional Phase 1 workflow)</action>
+
+<template-output file="{{status_file_path}}">decisions_log</template-output>
+<action>Add entry:</action>
+
+```
+- **{{date}}**: Completed research workflow ({{research_mode}} mode). Research report generated and saved. Next: Review findings and consider product-brief or plan-project workflows.
+```
+
+<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:**
+
+1. Review research findings
+2. Share with stakeholders
+3. Consider running:
+   - `product-brief` or `game-brief` to formalize vision
+   - `plan-project` if ready to create PRD/GDD
+
+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).
+
+To track progress across workflows, run `workflow-status` first.
+
+**Next Steps:**
+
+1. Review research findings
+2. Run product-brief or plan-project workflows
+   </output>
+   </check>
+   </step>
+
 </workflow>
--- a/src/modules/bmm/workflows/1-analysis/research/instructions-router.md
+++ b/src/modules/bmm/workflows/1-analysis/research/instructions-router.md
@@ -8,7 +8,35 @@

 <workflow>

-<step n="1" goal="Welcome and Research Type Selection">
+<step n="1" goal="Check and load workflow status file">
+<action>Search {output_folder}/ for files matching pattern: project-workflow-status*.md</action>
+<action>Find the most recent file (by date in filename: project-workflow-status-YYYY-MM-DD.md)</action>
+
+<check if="exists">
+  <action>Load the status file</action>
+  <action>Set status_file_found = true</action>
+  <action>Store status_file_path for later updates</action>
+</check>
+
+<check if="not exists">
+  <ask>**No workflow status file found.**
+
+This workflow conducts research (optional Phase 1 workflow).
+
+Options:
+
+1. Run workflow-status first to create the status file (recommended for progress tracking)
+2. Continue in standalone mode (no progress tracking)
+3. Exit
+
+What would you like to do?</ask>
+<action>If user chooses option 1 → HALT with message: "Please run workflow-status first, then return to research"</action>
+<action>If user chooses option 2 → Set standalone_mode = true and continue</action>
+<action>If user chooses option 3 → HALT</action>
+</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,7 +75,7 @@ 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>

--- a/src/modules/bmm/workflows/1-analysis/research/instructions-technical.md
+++ b/src/modules/bmm/workflows/1-analysis/research/instructions-technical.md
@@ -442,4 +442,65 @@ Select option (1-5):</ask>

 </step>

+<step n="FINAL" goal="Update status file on completion">
+<action>Search {output_folder}/ for files matching pattern: project-workflow-status*.md</action>
+<action>Find the most recent file (by date in filename)</action>
+
+<check if="status file exists">
+  <action>Load the status file</action>
+
+<template-output file="{{status_file_path}}">current_step</template-output>
+<action>Set to: "research (technical)"</action>
+
+<template-output file="{{status_file_path}}">current_workflow</template-output>
+<action>Set to: "research (technical) - Complete"</action>
+
+<template-output file="{{status_file_path}}">progress_percentage</template-output>
+<action>Increment by: 5% (optional Phase 1 workflow)</action>
+
+<template-output file="{{status_file_path}}">decisions_log</template-output>
+<action>Add entry:</action>
+
+```
+- **{{date}}**: Completed research workflow (technical mode). Technical research report generated and saved. Next: Review findings and consider plan-project workflow.
+```
+
+<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:**
+
+1. Review technical research findings
+2. Share with architecture team
+3. Run `plan-project` to incorporate findings into PRD
+
+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:**
+
+1. Review technical research findings
+2. Run plan-project workflow
+   </output>
+   </check>
+   </step>
+
 </workflow>