bmad-method 6.0.0-alpha.4 → 6.0.0-alpha.5

package/src/modules/bmm/workflows/workflow-status/init/instructions.md

@@ -3,182 +3,289 @@
 <critical>The workflow execution engine is governed by: {project-root}/bmad/core/tasks/workflow.xml</critical>
 <critical>You MUST have already loaded and processed: workflow-init/workflow.yaml</critical>
 <critical>Communicate in {communication_language} with {user_name}</critical>
+<critical>This workflow handles BOTH new projects AND legacy projects being migrated to BMad Method</critical>
 
 <workflow>
 
-<step n="1" goal="Quick scan and ask user about THEIR work">
+<step n="1" goal="Comprehensive scan for existing work and project state">
 <output>Welcome to BMad Method, {user_name}!</output>
 
-<action>Quick scan for context (do NOT analyze in depth yet):</action>
+<action>Perform comprehensive scan for ALL existing work (not just quick scan):
 
-- Check for codebase: src/, lib/, package.json, .git, etc.
-- Check for BMM artifacts: PRD, epics, stories, tech-spec, architecture docs
-- Store what was found but do NOT infer project details yet
+**Check for BMM planning artifacts:**
+
+- PRD files: {output*folder}/\_prd*.md or {output*folder}/\_prd*/index.md
+- Tech-spec files: {output*folder}/\_tech-spec*.md or {output*folder}/\_spec*.md
+- Epic files: {output*folder}/\_epic*.md or {output*folder}/\_epic*/index.md
+- Architecture: {output*folder}/\_architecture*.md or {output*folder}/\_arch*.md
+- UX Design: {output*folder}/\_ux*.md or {output*folder}/\_design*.md
+- Product Brief: {output*folder}/\_brief*.md
+- Research docs: {output*folder}/\_research*.md
+- Brainstorm docs: {output*folder}/\_brainstorm*.md
+
+**Check for implementation artifacts:**
+
+- Story files: {output_folder}/stories/\*.md
+- Sprint status: {output*folder}/\_sprint*.yaml or {output_folder}/sprint-status.yaml
+- Existing workflow status: {output_folder}/bmm-workflow-status.yaml
+
+**Check for codebase:**
+
+- Source code directories: src/, lib/, app/, components/, etc.
+- Package files: package.json, requirements.txt, Cargo.toml, go.mod, pom.xml, etc.
+- Git repository: .git/
+- Framework indicators: next.config.js, vite.config.js, etc.
+  </action>
+
+<action>Analyze findings and categorize project state:
+
+- **STATE 1:** Clean slate (no artifacts, no code or scaffold only)
+- **STATE 2:** Planning in progress (has PRD or tech-spec, no stories/implementation yet)
+- **STATE 3:** Implementation in progress (has stories or sprint status)
+- **STATE 4:** Legacy codebase (has code but no BMM artifacts)
+- **STATE 5:** Partial/unclear (some artifacts, state unclear)
+  </action>
 
 <ask>What's your project called? {{#if project_name}}(Config shows: {{project_name}}){{/if}}</ask>
-<action>Set project_name</action>
+<action>Store project_name</action>
 <template-output>project_name</template-output>
+</step>
 
-<check if="found artifacts OR found codebase">
-<output>I found some existing work here. Let me understand what you're working on:</output>
+<step n="2" goal="Validate project state with user">
 
-<check if="found artifacts">
-<output>
-**Planning Documents Found:**
-{{#each artifacts}}
-- {{artifact_name}} ({{artifact_type}}, {{story_count}} stories, modified {{date}})
-{{/each}}
-</output>
+<check if="STATE 1: Clean slate">
+  <output>Perfect! This looks like a fresh start.</output>
+  <action>Set new_project = true</action>
+  <action>Continue to Step 3 (ask about their work)</action>
 </check>
 
-<check if="found codebase">
-<output>
-**Codebase Found:**
-- Source code in: {{source_dirs}}
-- Tech stack: {{detected_tech_stack}}
-{{#if git_history}}
-- Git history: {{commit_count}} commits, last commit {{last_commit_date}}
+<check if="STATE 2: Planning artifacts found">
+  <output>I found existing planning documents:
+
+{{#if found_prd}}
+📋 **PRD:** {{prd_path}}
+{{#if epic_count}}- {{epic_count}} epics, {{story_count}} stories{{/if}}
+
+- Last modified: {{prd_modified}}
+  {{/if}}
+
+{{#if found_tech_spec}}
+📋 **Tech-Spec:** {{spec_path}}
+{{#if story_count}}- {{story_count}} stories{{/if}}
+
+- Last modified: {{spec_modified}}
+  {{/if}}
+
+{{#if found_architecture}}
+🏗️ **Architecture:** {{arch_path}}
+
+- Last modified: {{arch_modified}}
+  {{/if}}
+
+{{#if found_ux}}
+🎨 **UX Design:** {{ux_path}}
+
+- Last modified: {{ux_modified}}
+  {{/if}}
+
+{{#if found_brief}}
+📄 **Product Brief:** {{brief_path}}
+
+- Last modified: {{brief_modified}}
+  {{/if}}
+
+{{#if found_research}}
+🔍 **Research:** {{research_paths}}
+{{/if}}
+
+{{#if found_brainstorm}}
+🧠 **Brainstorm:** {{brainstorm_paths}}
 {{/if}}
 </output>
-</check>
 
-<ask>Looking at what I found, are these:
+<ask>What's your situation with these documents?
 
-a) **Works in progress you're finishing** - continuing the work described in these documents
-b) **Documents from a previous effort** - you're starting something NEW and different now
-c) **The proposed work you're about to start** - these describe what you want to do
-d) **None of these** - let me explain what I'm actually working on
+a) **Continue this work** - These docs describe what I'm building now
+b) **Override/replace** - These are old, I'm starting something NEW
+c) **Already done** - This work is complete, I'm starting a NEW project
+d) **Not sure** - Let me explain my situation
 
 Your choice [a/b/c/d]:</ask>
 
-<check if="choice == a">
-  <action>User is continuing old work - analyze artifacts to get details</action>
-  <action>Set continuing_old_work = true</action>
-  <action>Go to Step 2 (Analyze artifacts for details)</action>
-</check>
+  <check if="choice == a (Continue)">
+    <output>Got it! I'll create workflow tracking for your existing planning.</output>
+    <action>Set continuing_existing_planning = true</action>
+    <action>Store found artifacts for auto-completion in workflow status</action>
+    <action>Continue to Step 5 (detect track from artifacts)</action>
+  </check>
 
-<check if="choice == b">
-  <action>User is doing NEW work - old artifacts are just context</action>
-  <action>Set continuing_old_work = false</action>
-  <action>Go to Step 3 (Ask about NEW work)</action>
-</check>
+  <check if="choice == b (Override)">
+    <ask>Should I archive these old documents before we start fresh?
 
-<check if="choice == c">
-  <action>Artifacts describe proposed work</action>
-  <action>Set continuing_old_work = true</action>
-  <action>Go to Step 2 (Analyze artifacts for details)</action>
-</check>
+I can move them to {output_folder}/archive/ so they're not in the way.
 
-<check if="choice == d">
-  <action>User will explain their situation</action>
-  <action>Go to Step 3 (Ask about their work)</action>
-</check>
-</check>
+Archive old docs? (y/n)</ask>
+
+    <action if="answer == y">Create archive folder if needed</action>
+    <action if="answer == y">Move all found planning artifacts to {output_folder}/archive/</action>
+    <output>{{#if archived}}✅ Old documents archived to {output_folder}/archive/{{else}}Starting fresh - old docs will be ignored{{/if}}</output>
+    <action>Set new_project = true</action>
+    <action>Continue to Step 3 (ask about their work)</action>
+
+  </check>
+
+  <check if="choice == c (Already done)">
+    <ask>Should I archive the completed work before starting your new project? (y/n)</ask>
+    <action if="answer == y">Archive old planning docs</action>
+    <output>{{#if archived}}✅ Completed work archived{{else}}Ready for your new project!{{/if}}</output>
+    <action>Set new_project = true</action>
+    <action>Continue to Step 3 (ask about their work)</action>
+  </check>
 
-<check if="NOT found artifacts AND NOT found codebase">
-  <output>I don't see any existing code or planning documents. Looks like we're starting fresh!</output>
-  <action>Go to Step 3 (Ask about their work)</action>
+  <check if="choice == d (Not sure)">
+    <ask>Tell me what you're trying to accomplish:</ask>
+    <action>Analyze response and guide to appropriate choice (a, b, or c)</action>
+    <action>Loop back to present choices again with guidance</action>
+  </check>
 </check>
-</step>
 
-<step n="2" goal="Analyze artifacts for continuing work" if="continuing_old_work == true">
-<action>Analyze found artifacts in detail:</action>
-<action>Extract project type from content (game vs software)</action>
-<action>Count stories/epics to estimate level:
-  - Level 0: 1 story
-  - Level 1: 1-10 stories
-  - Level 2: 5-15 stories
-  - Level 3: 12-40 stories
-  - Level 4: 40+ stories
-</action>
-<action>Detect field type from codebase presence (greenfield vs brownfield)</action>
+<check if="STATE 3: Implementation in progress">
+  <output>🚨 **I found active implementation work:**
 
-<output>Based on the artifacts you're continuing, I'm suggesting **Level {{project_level}}** because I found {{story_count}} stories across {{epic_count}} epics.
+{{#if found_stories}}
+📝 **Story files:** {{story_count}} stories in {output_folder}/stories/
+{{#if story_examples}}- Examples: {{story_examples}}{{/if}}
+{{/if}}
 
-Here's the complexity scale for reference:
+{{#if found_sprint_status}}
+📊 **Sprint tracking:** {{sprint_status_path}}
 
-**{{field_type}} Project Levels:**
+- {{completed_stories}} completed
+- {{in_progress_stories}} in progress
+- {{pending_stories}} pending
+  {{/if}}
 
-- **Level 0** - Single atomic change (1 story) - bug fixes, typos, minor updates
-- **Level 1** - Small feature (1-10 stories) - simple additions, isolated features
-- **Level 2** - Medium feature set (5-15 stories) - dashboards, multiple related features
-- **Level 3** - Complex integration (12-40 stories) - platform features, major integrations
-- **Level 4** - Enterprise expansion (40+ stories) - multi-tenant, ecosystem changes
+{{#if found_workflow_status}}
+📋 **Workflow status:** {{workflow_status_path}}
 
-**My suggestion:** Level {{project_level}} {{field_type}} {{project_type}} project
+- Generated: {{workflow_status_date}}
+  {{/if}}
+
+{{#if found_planning_docs}}
+📚 **Planning docs:** {{found_planning_summary}}
+{{/if}}
 </output>
 
-<ask>Does this match what you're working on? (y/n or tell me what's different)</ask>
+<ask>What's happening here?
+
+a) **Continue implementation** - I'm still working on these stories
+b) **Completed** - This work is done, starting something NEW
+c) **Abandoned** - Stopping this, starting over
+d) **Not sure** - Let me explain
+
+Your choice [a/b/c/d]:</ask>
+
+  <check if="choice == a (Continue)">
+    <action>Check if bmm-workflow-status.yaml exists</action>
 
-<check if="user confirms">
-  <action>Use analyzed values</action>
-  <action>Go to Step 4 (Load workflow path)</action>
+    <check if="workflow_status_exists">
+      <output>✅ **You already have workflow tracking set up!**
+
+Your current status file: {{workflow_status_path}}
+
+You don't need workflow-init - you're already using the workflow system.
+
+**To check your progress:**
+
+- Load your current agent (PM, SM, Architect, etc.)
+- Run: **/bmad:bmm:workflows:workflow-status**
+
+This will show you what to do next.
+
+Happy building! 🚀</output>
+<action>Exit workflow gracefully (workflow already initialized)</action>
 </check>
 
-<check if="user corrects">
-  <action>Update values based on user corrections</action>
-  <ask>Updated to: Level {{project_level}} {{field_type}} {{project_type}}. Correct? (y/n)</ask>
-  <action>Go to Step 4 (Load workflow path)</action>
+    <check if="no_workflow_status">
+      <output>You have work in progress but no workflow tracking.
+
+I'll create workflow tracking that recognizes your existing work.</output>
+<action>Set migrating_legacy_project = true</action>
+<action>Store found artifacts for workflow status generation</action>
+<action>Continue to Step 5 (detect track from artifacts)</action>
+</check>
 </check>
 
-<template-output>project_name</template-output>
-<template-output>project_type</template-output>
-<template-output>project_level</template-output>
-<template-output>field_type</template-output>
-</step>
+  <check if="choice in [b (Completed), c (Abandoned)]">
+    <ask>Archive the old work before starting fresh? (y/n)</ask>
+    <action if="answer == y">Create archive folder</action>
+    <action if="answer == y">Move stories, sprint status, and planning docs to archive</action>
+    <output>{{#if archived}}✅ Old work archived{{else}}Clean slate! Ready for your new project.{{/if}}</output>
+    <action>Set new_project = true</action>
+    <action>Continue to Step 3 (ask about their work)</action>
+  </check>
 
-<step n="3" goal="Ask user about THEIR work">
-<ask>Tell me about what you're working on. What's the goal?</ask>
+  <check if="choice == d (Not sure)">
+    <ask>Tell me more about your situation:</ask>
+    <action>Analyze and guide to appropriate choice</action>
+  </check>
+</check>
 
-<action>Analyze user's description using keyword detection:
+<check if="STATE 4: Legacy codebase (no BMM artifacts)">
+  <output>I see you have an existing codebase:
 
-- Level 0 keywords: "fix", "bug", "typo", "small change", "update", "patch", "one file"
-- Level 1 keywords: "simple", "basic", "small feature", "add", "minor", "single feature"
-- Level 2 keywords: "dashboard", "several features", "admin panel", "medium", "feature set"
-- Level 3 keywords: "platform", "integration", "complex", "system", "architecture"
-- Level 4 keywords: "enterprise", "multi-tenant", "multiple products", "ecosystem", "phased"
-  </action>
+{{codebase_summary}}
 
-<action>Make initial determination:
+No BMM artifacts found - this project hasn't used BMad Method yet.</output>
 
-- project_type (game or software)
-- project_level (0-4) - tentative based on keywords
-- field_type (greenfield or brownfield)
-- confidence (high/medium/low) - based on clarity of description
-  </action>
+<action>Set field_type = "brownfield"</action>
+<action>Set new_project = true</action>
+<action>Note: Will need document-project before planning</action>
+<output>
 
-<check if="confidence == low OR description is ambiguous">
-  <output>Thanks! Let me ask a few clarifying questions to make sure I route you correctly:</output>
+💡 **Note for brownfield projects:**
+You'll need to run **document-project** workflow before planning.
+This analyzes your codebase and creates documentation that AI agents can use.
 
-<ask>1. Roughly how many distinct features or changes do you think this involves?
+I'll include this as a prerequisite in your workflow path.</output>
+<action>Continue to Step 3 (ask about their work)</action>
+</check>
 
-- Just one thing (e.g., fix a bug, add one button, update one API)
-- A small feature (2-5 related changes)
-- Several features (5-15 related things)
-- A major addition (15-40 things to do)
-- A large initiative (40+ changes across many areas)
-  </ask>
+<check if="STATE 5: Partial/unclear">
+  <output>I found some artifacts but the project state is unclear:
 
-<action>Adjust project_level based on response</action>
+{{list_found_artifacts}}
 
-<ask>2. How much of the existing codebase will this touch?
+Let me understand your situation.</output>
 
-- Single file or small area
-- One module or component
-- Multiple modules (2-4 areas)
-- Many modules with integration needs
-- System-wide changes
-  </ask>
+<ask>What are you trying to do?
 
-<action>Validate and adjust project_level based on scope</action>
+a) Continue working on an existing project
+b) Start something completely NEW
+c) Fix/enhance the existing code
+d) Let me explain my situation
 
-  <check if="project_type unclear">
-    <ask>3. Is this a game or a software application?</ask>
-    <action>Set project_type based on response</action>
-  </check>
+Your choice:</ask>
+
+<action>Analyze response carefully</action>
+<action>Guide to appropriate state (Continue existing = Step 5, New = Step 3)</action>
 </check>
 
-<check if="found codebase BUT field_type still unclear">
+</step>
+
+<step n="3" goal="Ask user about their work (new projects only)">
+<ask>Tell me about what you're working on. What's the goal?</ask>
+
+<action>Store user_description</action>
+
+<action>Analyze description for field type:
+
+- Brownfield indicators: "existing", "current", "add to", "modify", "enhance", "refactor"
+- Greenfield indicators: "new", "build", "create", "from scratch", "start"
+- Codebase presence overrides: If found codebase = brownfield unless user says "scaffold"
+  </action>
+
+<check if="found codebase AND field_type still unclear">
   <ask>I see you have existing code here. Are you:
 
 1. **Adding to or modifying** the existing codebase (brownfield)
@@ -202,189 +309,463 @@ Your choice [1/2/3]:</ask>
   </check>
 </check>
 
-<action>Build reasoning for suggestion</action>
-<action>Store detected_indicators (keywords, scope indicators, complexity signals)</action>
+<action if="field_type not yet set">Set field_type based on codebase presence (codebase = brownfield, none = greenfield)</action>
 
-<output>Based on what you've described, I'm suggesting **Level {{project_level}}** because:
+<action>Detect project_type (game vs software):
 
-{{reasoning}} (detected: {{detected_indicators}})
+- Game keywords: "game", "player", "level", "gameplay", "rpg", "fps", "puzzle game"
+- Default to "software" if not clearly a game
+  </action>
 
-Here's the complexity scale for reference:
+<template-output>user_description</template-output>
+<template-output>field_type</template-output>
+<template-output>project_type</template-output>
+</step>
 
-**{{field_type}} Project Levels:**
+<step n="4" goal="Offer optional discovery workflows">
+<output>Before we determine your planning approach, I want to offer some optional
+workflows that can help you think through your project more deeply:</output>
 
-- **Level 0** - Single atomic change (1 story) - bug fixes, typos, minor updates, single file changes
-- **Level 1** - Small feature (1-10 stories) - simple additions, isolated features, one module
-- **Level 2** - Medium feature set (5-15 stories) - dashboards, multiple related features, several modules
-- **Level 3** - Complex integration (12-40 stories) - platform features, major integrations, architectural changes
-- **Level 4** - Enterprise expansion (40+ stories) - multi-tenant, ecosystem changes, system-wide initiatives
+<ask>Would you like to:
 
-**My suggestion:** Level {{project_level}} {{field_type}} {{project_type}} project
-</output>
+- 🧠 **Brainstorm** your project? (Creative exploration and idea generation)
+- 🔍 **Research** your domain? (Technical research, competitive analysis, deep-dives)
+
+These are completely OPTIONAL but can help clarify your vision before planning.
+
+Your choice:
+a) Yes, brainstorm first
+b) Yes, research first
+c) Yes, both
+d) No, I'm ready to plan
+
+Your choice [a/b/c/d]:</ask>
+
+<check if="choice == a">
+  <action>Set brainstorm_requested = true</action>
+  <action>Set research_requested = false</action>
+</check>
 
-<ask>Does this match what you're working on? (y/n or tell me what's different)</ask>
+<check if="choice == b">
+  <action>Set brainstorm_requested = false</action>
+  <action>Set research_requested = true</action>
+</check>
 
-<check if="user confirms">
-  <action>Use determined values</action>
-  <action>Go to Step 4 (Load workflow path)</action>
+<check if="choice == c">
+  <action>Set brainstorm_requested = true</action>
+  <action>Set research_requested = true</action>
 </check>
 
-<check if="user corrects">
-  <action>Update values based on corrections</action>
-  <output>Updated to: Level {{project_level}} {{field_type}} {{project_type}}</output>
-  <ask>Does that look right now? (y/n)</ask>
-  <action>If yes, go to Step 4. If no, ask what needs adjustment and repeat.</action>
+<check if="choice == d">
+  <action>Set brainstorm_requested = false</action>
+  <action>Set research_requested = false</action>
 </check>
 
-<template-output>project_name</template-output>
-<template-output>project_type</template-output>
-<template-output>project_level</template-output>
-<template-output>field_type</template-output>
+<template-output>brainstorm_requested</template-output>
+<template-output>research_requested</template-output>
 </step>
 
-<step n="4" goal="Load appropriate workflow path">
-<action>Determine path file based on selections:</action>
+<step n="5" goal="Track selection with education (or detect from artifacts)">
+
+<check if="continuing_existing_planning OR migrating_legacy_project">
+  <action>Detect track from existing artifacts:
+
+**Track Detection Logic:**
+
+- Has PRD + Architecture → BMad Method
+- Has PRD only → BMad Method (architecture was optional/skipped)
+- Has tech-spec only → BMad Quick Flow
+- Has Security/DevOps docs → BMad Enterprise Method
+  </action>
 
-<check if="project_type == game">
-  <action>Load {path_files}/game-design.yaml</action>
-  <action>Set workflow_path_file = "game-design.yaml"</action>
+  <output>Based on your existing planning documents, I've detected you're using:
+
+**{{detected_track_name}}**
+
+{{#if found_artifacts_list}}
+Found completed workflows:
+{{#each found_artifacts_list}}
+
+- {{workflow_name}}: {{file_path}}
+  {{/each}}
+  {{/if}}
+
+I'll create workflow tracking that matches your existing approach and
+automatically marks these completed workflows as done.
+
+Does this look right? (y/n)</output>
+
+<ask if="answer == n">Which track should I use instead?
+
+1. BMad Quick Flow
+2. BMad Method
+3. BMad Enterprise Method
+
+Your choice:</ask>
+
+<action if="user_corrects">Update selected_track based on choice</action>
+<action>Store selected_track</action>
+<template-output>selected_track</template-output>
+
+<action>Continue to Step 6 (product brief question if applicable)</action>
 </check>
 
-<check if="project_type == software">
-  <!-- field_type will be "greenfield" or "brownfield", project_level will be 0-4 -->
-  <action>Build filename: {field_type}-level-{project_level}.yaml</action>
-  <action>Load {path_files}/{field_type}-level-{project_level}.yaml</action>
-  <action>Set workflow_path_file = constructed filename</action>
+<check if="new_project">
+  <output>Now, let me explain your planning options.
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+🚀 **BMad Quick Flow** - Fast Implementation Path
+
+⏱️ **Time:** Hours to 1 day of planning
+📝 **Approach:** Tech-spec focused - just enough detail to start coding
+✅ **Best for:** Simple features, bug fixes, scope is crystal clear
+⚠️ **Trade-off:** Less upfront planning = higher risk of rework if complexity emerges
+🤖 **Agent Support:** Basic - AI will have minimal context
+
+**Example:** "Fix login bug" or "Add export button"
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+🎯 **BMad Method** - Full Product Planning (RECOMMENDED)
+
+⏱️ **Time:** 1-3 days of planning
+📝 **Approach:** PRD + UX + Architecture - complete product and system design
+✅ **Best for:**
+
+- **GREENFIELD:** Products, platforms, multi-feature initiatives
+- **BROWNFIELD:** Complex additions (new UIs + APIs, major refactors, new modules)
+
+✅ **Benefits:**
+
+- AI agents have COMPLETE context for better code generation
+- Architecture distills massive codebases into focused solution design
+- Prevents architectural drift and ensures consistency
+- Fewer surprises and less rework during implementation
+- Faster overall delivery (planning investment pays off!)
+- Better code quality and maintainability
+
+🤖 **Agent Support:** Exceptional - AI becomes a true coding partner with full context
+
+{{#if brownfield}}
+💡 **Why Architecture for Brownfield?**
+Your brownfield documentation might be huge (thousands of lines). The Architecture
+workflow takes all that context and creates a SUCCINCT solution design specific to
+YOUR project. This keeps AI agents focused on YOUR changes without getting lost
+in the existing codebase details.
+{{/if}}
+
+**Example:** "User dashboard with analytics" or "Payment integration system"
+or "Add real-time collaboration to existing editor"
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+🏢 **BMad Enterprise Method** - Extended Enterprise Planning
+
+⏱️ **Time:** 3-7 days of planning
+📝 **Approach:** BMad Method + Security Architecture + DevOps + Test Strategy
+✅ **Best for:** Enterprise requirements, compliance, multi-tenant, mission-critical
+✅ **Benefits:** All of BMad Method PLUS specialized planning for:
+
+- Security architecture and threat modeling
+- DevOps pipeline and infrastructure planning
+- Comprehensive test strategy
+- Compliance and audit requirements
+
+🤖 **Agent Support:** Elite - comprehensive planning for complex enterprise systems
+
+**Example:** "Multi-tenant SaaS platform" or "HIPAA-compliant patient portal"
+or "Add SOC2-compliant audit logging to enterprise app"
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━</output>
+
+<action>Generate recommendation based on user_description and field_type:
+
+**Recommendation Logic:**
+
+- Complexity keywords (dashboard, platform, system, integration, multiple features) → Recommend BMad Method
+- Simple keywords (fix, bug, add button, simple) → Mention Quick Flow as option
+- Enterprise keywords (multi-tenant, compliance, security, audit) → Recommend Enterprise
+- Brownfield + complex → Strongly recommend Method (explain architecture benefit)
+- Greenfield + complex → Recommend Method
+  </action>
+
+  <output>
+
+💡 **My Honest Recommendation:**
+
+{{recommendation_with_reasoning}}
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━</output>
+
+<ask>Which approach fits your situation?
+
+1. **BMad Quick Flow** - Fast, minimal planning (I accept rework risk)
+2. **BMad Method** - Full planning for better AI results (RECOMMENDED)
+3. **BMad Enterprise Method** - Extended planning for enterprise needs
+4. **I'm not sure** - Help me decide
+
+Your choice [1/2/3/4]:</ask>
+
+  <check if="choice == 4 (Not sure)">
+    <ask>Tell me more about your concerns or uncertainties:</ask>
+    <action>Provide tailored guidance based on their specific concerns</action>
+    <action>Present choices again with more specific recommendation</action>
+  </check>
+
+<action>Map choice to track name:
+
+- 1 → "quick-flow"
+- 2 → "method"
+- 3 → "enterprise"
+  </action>
+
+<action>Store selected_track</action>
+<template-output>selected_track</template-output>
 </check>
 
-<action>Parse workflow path file to extract phases and workflows</action>
-<template-output>workflow_path_file</template-output>
 </step>
 
-<step n="5" goal="Build workflow status YAML structure">
-<action>Parse the loaded workflow path file and extract all workflows</action>
+<step n="6" goal="Product brief question (greenfield Method/Enterprise only)">
 
-<action>For each phase in the path file:
+<check if="field_type == brownfield OR selected_track == quick-flow">
+  <action>Skip this step - product brief not applicable for brownfield or quick flow</action>
+  <action>Set product_brief_requested = false</action>
+  <action>Continue to Step 7 (generate workflow path)</action>
+</check>
 
-- Extract phase number and name
-- Extract all workflows in that phase
-- For each workflow, determine its status type:
-  - required: true → status = "required"
-  - recommended: true → status = "recommended"
-  - conditional: "if_has_ui" → status = "conditional"
-  - optional: true → status = "optional"
-  - Default if not specified → status = "required"
-    </action>
+<check if="field_type == greenfield AND selected_track in [method, enterprise]">
+  <output>One more optional workflow for greenfield projects:
 
-<action>Build the workflow_items list in this format:
+📋 **Product Brief** - Strategic product planning document
 
-For each phase:
+This is OPTIONAL but recommended for greenfield BMad Method projects.
+It helps you articulate:
 
-1. Add comment header: `  # Phase {n}: {Phase Name}`
-2. For each workflow in phase:
-   - Add entry: `  {workflow-id}: {status}`
-3. Add blank line between phases
+- Product vision and unique value proposition
+- Target users and their needs
+- Success criteria and goals
+- Market positioning and strategy
 
-Example structure:
+This comes BEFORE your PRD and helps inform it with strategic thinking.
 
-```
-  # Phase 1: Analysis
-  brainstorm-project: optional
-  research: optional
-  product-brief: recommended
+Would you like to include Product Brief in your workflow?</output>
 
-  # Phase 2: Planning
-  prd: required
-  validate-prd: optional
-  create-design: conditional
-```
+<ask>a) Yes, include Product Brief
+b) No, skip to PRD
 
-</action>
+Your choice [a/b]:</ask>
+
+  <check if="choice == a">
+    <action>Set product_brief_requested = true</action>
+  </check>
 
-<action>Scan for existing workflow output files to auto-detect completion:
+  <check if="choice == b">
+    <action>Set product_brief_requested = false</action>
+  </check>
 
-For each workflow in the list, check common output locations:
+<template-output>product_brief_requested</template-output>
+</check>
+
+</step>
 
-- {output_folder}/brainstorm-\*.md for brainstorm-project
-- {output_folder}/research-\*.md for research
-- {output_folder}/product-brief.md for product-brief
-- {output_folder}/prd.md for prd
-- {output_folder}/ux-design.md for create-design
-- {output_folder}/architecture.md for create-architecture
-- {output_folder}/tech-spec.md for tech-spec
-- {output_folder}/sprint-status.yaml for sprint-planning
+<step n="7" goal="Load workflow path and build status structure">
+
+<action>Determine path file based on selected track and field type:
+
+**Path File Mapping:**
+
+- quick-flow + greenfield → "quick-flow-greenfield.yaml"
+- quick-flow + brownfield → "quick-flow-brownfield.yaml"
+- method + greenfield → "method-greenfield.yaml"
+- method + brownfield → "method-brownfield.yaml"
+- enterprise + greenfield → "enterprise-greenfield.yaml"
+- enterprise + brownfield → "enterprise-brownfield.yaml"
+- game → "game-design.yaml"
+  </action>
+
+<action>Load {path_files}/{determined_path_file}</action>
+<action>Parse workflow path file to extract phases and workflows</action>
 
-CRITICAL: If file exists, replace status with ONLY the file path - nothing else.
-Example: product-brief: docs/product-brief.md
-NOT: product-brief: "completed - docs/product-brief.md" or any other text.
+<action>Build workflow_items list:
+
+For each phase in path file:
+
+1. Check if phase should be included based on:
+   - User choices (brainstorm_requested, research_requested, product_brief_requested)
+   - Phase conditions (prerequisite phases, optional phases)
+2. Add comment header: `  # Phase {n}: {Phase Name}`
+3. For each workflow in phase:
+   - Check if workflow should be included based on user choices
+   - Add entry: `  {workflow-id}: {default_status}`
+   - Default status from path file (required/optional/recommended/conditional)
+4. Add blank line between phases
+   </action>
+
+<action>Scan for existing completed workflows and update workflow_items:
+
+**Scan locations:**
+
+- Brainstorm: {output_folder}/brainstorm\*.md
+- Research: {output_folder}/research\*.md
+- Product Brief: {output*folder}/\_brief*.md
+- PRD: {output*folder}/\_prd*.md or {output*folder}/\_prd*/index.md
+- Tech-spec: {output*folder}/\_tech-spec*.md or {output*folder}/\_spec*.md
+- Epics: {output*folder}/\_epic*.md or {output*folder}/\_epic*/index.md
+- UX Design: {output*folder}/\_ux*.md or {output*folder}/\_design*.md
+- Architecture: {output*folder}/\_architecture*.md or {output*folder}/\_arch*.md
+- Sprint Planning: {output*folder}/\_sprint*.yaml
+
+**CRITICAL:** If file exists, replace workflow status with ONLY the file path.
+Example: `prd: docs/prd.md` (NOT "completed - docs/prd.md")
 </action>
 
+<template-output>workflow_path_file</template-output>
 <template-output>workflow_items</template-output>
+
 </step>
 
-<step n="6" goal="Create workflow status file">
+<step n="8" goal="Present workflow path and create status file">
+
 <action>Set generated date to current date</action>
 <template-output>generated</template-output>
 
-<action>Prepare all template variables for workflow-status-template.yaml:
+<output>Perfect! Here's your personalized BMad workflow path:
 
-- generated: {current_date}
-- project_name: {project_name}
-- project_type: {project_type}
-- project_level: {project_level}
-- field_type: {field_type}
-- workflow_path_file: {workflow_path_file}
-- workflow_items: {workflow_items from step 5}
-  </action>
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
-<action>Display a preview of what will be created:
+**Track:** {{selected_track_display_name}}
+**Field Type:** {{field_type}}
+**Project:** {{project_name}}
 
-Show the first workflow in each phase and total count:
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
-"Ready to create workflow status tracking:
+{{#if brownfield AND needs_documentation}}
+🔧 **Prerequisites:**
+✅ document-project - Create comprehensive codebase documentation
+(Required before planning workflows)
+{{/if}}
 
-- Phase 1 ({phase_1_workflow_count} workflows): Starting with {first_workflow_phase_1}
-- Phase 2 ({phase_2_workflow_count} workflows): Starting with {first_workflow_phase_2}
-- Phase 3 ({phase_3_workflow_count} workflows): Starting with {first_workflow_phase_3}
-- Phase 4 (Implementation tracked separately in sprint-status.yaml)
+{{#if has_discovery_phase}}
+🧠 **Phase 0: Discovery** (Optional - based on your choices)
+{{#if brainstorm_requested}}
+✅ Brainstorm - Creative exploration session
+{{/if}}
+{{#if research_requested}}
+✅ Research - Domain and technical research
+{{/if}}
+{{#if product_brief_requested}}
+✅ Product Brief - Strategic product planning
+{{/if}}
+{{/if}}
 
-{{#if detected_completed_workflows}}
-Found existing work:
-{{#each detected_files}}
+{{#if selected_track == quick-flow}}
+📝 **Phase 1: Planning**
+✅ Tech-Spec - Implementation-focused specification
+(Auto-detects epic structure if 2+ stories)
 
-- {{workflow_name}}: {{file_path}}
-  {{/each}}
-  {{/if}}"
-  </action>
+🚀 **Phase 2: Implementation**
+✅ Sprint Planning - Create sprint tracking
+✅ Story Development - Implement story-by-story
+{{/if}}
 
-<ask>Ready to create your workflow status file? (y/n)</ask>
+{{#if selected_track in [method, enterprise]}}
+📋 **Phase 1: Planning**
+✅ PRD - Product Requirements Document
+✅ Validate PRD (optional quality check)
+✅ UX Design (if UI components - determined after PRD)
+
+🏗️ **Phase 2: Solutioning**
+{{#if brownfield}}
+✅ Architecture - Integration design (RECOMMENDED for brownfield)
+Creates focused solution design from your existing codebase context
+{{else}}
+✅ Architecture - System design document
+{{/if}}
+✅ Validate Architecture (optional quality check)
+✅ Solutioning Gate Check - Validate all planning aligns before coding
+
+🚀 **Phase 3: Implementation**
+✅ Sprint Planning - Create sprint tracking
+✅ Story Development - Implement story-by-story with epic-tech-specs
+{{/if}}
+
+{{#if selected_track == enterprise}}
+
+🏢 **Additional Enterprise Planning:**
+✅ Security Architecture - Threat modeling and security design
+✅ DevOps Strategy - Pipeline and infrastructure planning
+✅ Test Strategy - Comprehensive testing approach
+{{/if}}
+
+{{#if found_existing_artifacts}}
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+📁 **Existing Work Detected:**
+
+I found these completed workflows and will mark them as done:
+{{#each completed_workflows}}
+✅ {{workflow_name}}: {{file_path}}
+{{/each}}
+
+Your workflow tracking will start from where you left off!
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+{{/if}}</output>
+
+<ask>Ready to create your workflow tracking file? (y/n)</ask>
 
 <check if="answer == y">
-  <action>Generate YAML from workflow-status-template.yaml with all variables</action>
-  <action>Save status file to {output_folder}/bmm-workflow-status.yaml</action>
+  <action>Prepare all template variables for workflow-status-template.yaml:
+  - generated: {current_date}
+  - project_name: {project_name}
+  - project_type: {project_type}
+  - selected_track: {selected_track}
+  - field_type: {field_type}
+  - workflow_path_file: {workflow_path_file}
+  - workflow_items: {workflow_items from step 7}
+  </action>
+
+<action>Generate YAML from workflow-status-template.yaml with all variables</action>
+<action>Save status file to {output_folder}/bmm-workflow-status.yaml</action>
 
-<action>Identify the first non-completed workflow in the list</action>
-<action>Look up that workflow's agent and command from the path file</action>
+<action>Identify the first non-completed workflow in workflow_items</action>
+<action>Look up that workflow's agent and command from the loaded path file</action>
 
-<output>✅ Workflow status file created at {output_folder}/bmm-workflow-status.yaml
+<output>✅ **Workflow tracking created:** {output_folder}/bmm-workflow-status.yaml
 
-**Next Steps:**
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
-{{#if detected_completed_workflows}}
-You have {{detected_count}} workflow(s) already completed. Great progress!
+{{#if completed_workflows_found}}
+🎉 Great news! I found {{completed_count}} workflow(s) already completed.
 {{/if}}
 
 **Next Workflow:** {{next_workflow_name}}
-
 **Agent:** {{next_agent}}
-
 **Command:** /bmad:bmm:workflows:{{next_workflow_id}}
 
-{{#if next_agent !== 'pm'}}
-It is recommended to start a new chat and load the {{next_agent}} agent before running the next workflow.
+{{#if next_agent != 'analyst' AND next_agent != 'pm'}}
+💡 **Tip:** Start a new chat and load the **{{next_agent}}** agent before running this workflow.
 {{/if}}
-</output>
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+Happy building with BMad Method! 🚀
+
+**To check your progress anytime:**
+
+- Load any BMM agent
+- Run: /bmad:bmm:workflows:workflow-status
+  </output>
+  </check>
+
+<check if="answer == n">
+  <output>No problem! You can run workflow-init again anytime you're ready.
+
+To get started later, just load the Analyst agent and run:
+**/bmad:bmm:workflows:workflow-init**</output>
 </check>
+
 </step>
 
 </workflow>