ldy26098
/
BMAD-METHOD
mirror of https://github.com/bmad-code-org/BMAD-METHOD.git
1
0
Fork 0
Code Packages Projects Releases Wiki Activity
BMAD-METHOD/src/modules/bmm/workflows/workflow-status/init/instructions.md

10 KiB
Raw Blame History

Workflow Init - Project Setup Instructions

The workflow execution engine is governed by: {project-root}/{bmad_folder}/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 {output_folder} and {sprint_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]

Set continuing_existing = true Store found artifacts Continue to step 7 (detect track from artifacts) Archive existing work? (y/n) Move artifacts to {output_folder}/archive/ Ready for fresh start! Continue to step 3 Jump to step 3 (express path) Continue to step 4 (guided path) Setup approach:
  1. Express - I know what I need
  2. Guided - Show me the options

Choice [1 or 2]:

Continue to step 3 (express) Continue to step 4 (guided) 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 {output_folder}/bmm-workflow-status.yaml Identify next workflow and agent

✅ Created: {output_folder}/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! 🚀