mini-starter/_bmad/bmm/workflows/workflow-status/init/instructions.md

Workflow Init - Project Setup Instructions

The workflow execution engine is governed by: {project-root}/_bmad/core/tasks/workflow.xml You MUST have already loaded and processed: workflow-init/workflow.yaml Communicate in {communication_language} with {user_name} This workflow handles BOTH new projects AND legacy projects following the BMad Method

Welcome to BMad Method, {user_name}!

Perform comprehensive scan for existing work:

• BMM artifacts: PRD, epics, architecture, UX, brief, research, brainstorm
• Implementation: stories, sprint-status, workflow-status
• Codebase: source directories, package files, git repo
• Check both {planning_artifacts} and {implementation_artifacts} locations

Categorize into one of these states:

• CLEAN: No artifacts or code (or scaffold only)
• PLANNING: Has PRD/spec but no implementation
• ACTIVE: Has stories or sprint status
• LEGACY: Has code but no BMM artifacts
• UNCLEAR: Mixed state needs clarification

What's your project called? {{#if project_name}}(Config shows: {{project_name}}){{/if}} Store project_name project_name

Perfect! Fresh start detected. Continue to step 3

✅ You already have workflow tracking at: {{workflow_status_path}}

To check progress: Load any BMM agent and run /bmad:bmm:workflows:workflow-status

Happy building! 🚀

Exit workflow (already initialized)

Found existing work: {{summary_of_findings}}

How would you like to proceed?

1. Continue - Work with existing artifacts
2. Archive & Start Fresh - Move old work to archive
3. Express Setup - I know exactly what I need
4. Guided Setup - Walk me through options

Choice [1-4]

<action>Set continuing_existing = true</action>
<action>Store found artifacts</action>
<action>Continue to step 7 (detect track from artifacts)</action>

<ask>Archive existing work? (y/n)</ask>
<action if="y">Move artifacts to {planning_artifacts}/archive/</action>
<output>Ready for fresh start!</output>
<action>Continue to step 3</action>

<action>Jump to step 3 (express path)</action>

<action>Continue to step 4 (guided path)</action>

Setup approach:

1. Express - I know what I need
2. Guided - Show me the options

Choice [1 or 2]:

<action>Continue to step 3 (express)</action>

<action>Continue to step 4 (guided)</action>

Is this for:

1. New project (greenfield)
2. Existing codebase (brownfield)

Choice [1/2]:

Set field_type based on choice

Planning approach:

1. BMad Method - Full planning for complex projects
2. Enterprise Method - Extended planning with security/DevOps

Choice [1/2]:

Map to selected_track: method/enterprise

🚀 **For Quick Flow (minimal planning, straight to code):** Load the **quick-flow-solo-dev** agent instead - use Quick Flow agent for faster development

field_type selected_track Jump to step 6 (discovery options)

Tell me about what you're working on. What's the goal? Store user_description

Analyze for field type indicators:

• Brownfield: "existing", "current", "enhance", "modify"
• Greenfield: "new", "build", "create", "from scratch"
• If codebase exists, default to brownfield unless user indicates scaffold

I see existing code. Are you:

1. Modifying existing codebase (brownfield)
2. Starting fresh - code is just scaffold (greenfield)

Choice [1/2]:

Set field_type based on answer

Set based on codebase presence

Check for game development keywords 🎮 GAME DEVELOPMENT DETECTED

For game development, install the BMGD module:

bmad install bmgd

Continue with software workflows? (y/n)

Choice: Exit workflow

user_description field_type Continue to step 5

Based on your project, here are your BMad Method planning options:

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

1. BMad Method 🎯 {{#if recommended}}(RECOMMENDED){{/if}}

• Full planning: PRD + UX + Architecture
• Best for: Products, platforms, complex features
• Benefit: AI agents have complete context for better results

2. Enterprise Method 🏢

• Extended: Method + Security + DevOps + Testing
• Best for: Enterprise, compliance, mission-critical
• Benefit: Comprehensive planning for complex systems

🚀 For Quick Flow (minimal planning, straight to code): Load the quick-flow-solo-dev agent instead - use Quick Flow agent for faster development

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

{{#if brownfield}} 💡 Architecture creates focused solution design from your codebase, keeping AI agents on track. {{/if}}

Which BMad Method approach fits best?

1. BMad Method {{#if recommended}}(recommended){{/if}}
2. Enterprise Method
3. Help me decide
4. Switch to Quick Flow (use quick-flow-solo-dev agent)

Choice [1/2/3/4]:

🚀 Switching to Quick Flow!

Load the quick-flow-solo-dev agent instead:

• Start a new chat
• Load the quick-flow-solo-dev agent
• Use Quick Flow for minimal planning and faster development

Quick Flow is perfect for:

• Simple features and bug fixes
• Rapid prototyping
• When you want to get straight to code

Happy coding! 🚀

Exit workflow

What concerns you about choosing? Provide tailored guidance based on concerns Loop back to choice

Map choice to selected_track selected_track

Determine available discovery workflows based on:

• field_type (greenfield gets product-brief option)
• selected_track (method/enterprise options)

Optional discovery workflows can help clarify your vision: Select any you'd like to include:

1. 🧠 Brainstorm - Creative exploration and ideation
2. 🔍 Research - Technical/competitive analysis
3. 📋 Product Brief - Strategic product planning (recommended)

Enter numbers (e.g., "1,3" or "all" or "none"):

Optional discovery workflows: Include any of these?

1. 🧠 Brainstorm - Creative exploration
2. 🔍 Research - Domain analysis

Enter numbers (e.g., "1,2" or "none"):

Parse selections and set:

• brainstorm_requested
• research_requested
• product_brief_requested (if applicable)

brainstorm_requested research_requested product_brief_requested

💡 Note: For brownfield projects, run document-project workflow first to analyze your codebase.

Analyze artifacts to detect track:

• Has PRD → BMad Method
• Has Security/DevOps → Enterprise Method
• Has tech-spec only → Suggest switching to quick-flow-solo-dev agent

Detected: **{{detected_track}}** based on {{found_artifacts}} Correct? (y/n) Which BMad Method track instead? 1. BMad Method 2. Enterprise Method 3. Switch to Quick Flow (use quick-flow-solo-dev agent) Choice: Set selected_track selected_track

Load path file: {path_files}/{{selected_track}}-{{field_type}}.yaml Build workflow_items from path file Scan for existing completed work and update statuses Set generated date generated workflow_path_file workflow_items Your BMad workflow path: **Track:** {{selected_track}} **Type:** {{field_type}} **Project:** {{project_name}} {{#if brownfield}}Prerequisites: document-project{{/if}} {{#if has_discovery}}Discovery: {{list_selected_discovery}}{{/if}} {{workflow_path_summary}}

Create workflow tracking file? (y/n)

Generate YAML from template with all variables Save to {planning_artifacts}/bmm-workflow-status.yaml Identify next workflow and agent

✅ Created: {planning_artifacts}/bmm-workflow-status.yaml

Next: {{next_workflow_name}} Agent: {{next_agent}} Command: /bmad:bmm:workflows:{{next_workflow_id}}

{{#if next_agent not in [analyst, pm]}} 💡 Start new chat with {{next_agent}} agent first. {{/if}}

To check progress: /bmad:bmm:workflows:workflow-status

Happy building! 🚀