Files
BMAD-METHOD/bmad/bmm/workflows/2-plan/instructions-router.md
2025-10-12 01:39:24 -05:00

7.4 KiB

PRD Workflow Router Instructions

This is the INITIAL ASSESSMENT phase - determines which instruction set to load ALWAYS check for existing project-workflow-analysis.md first The workflow execution engine is governed by: {project_root}/bmad/core/tasks/workflow.xml

Check if {output_folder}/project-workflow-analysis.md exists

Load the analysis file Check for existing workflow outputs based on level in analysis:
  • Level 0: Check for tech-spec.md
  • Level 1-2: Check for PRD.md, epic-stories.md, tech-spec.md
  • Level 3-4: Check for PRD.md, epics.md

Previous analysis found (Level {{project_level}}).

Existing documents detected: {{list_existing_docs}}

Options:

  1. Continue where left off with existing documents
  2. Start fresh assessment (will archive existing work)
  3. Review and modify previous analysis
Proceed to assessment

What type of planning do you need?

Quick Selection:

  1. Full project planning (PRD, Tech Spec, etc.)
  2. UX/UI specification only
  3. Tech spec only (for small changes)
  4. Generate AI Frontend Prompt from existing specs

Select an option or describe your needs:

Capture user selection as {{planning_type}}

{installed_path}/ux/workflow.yaml Pass mode="standalone" to UX workflow Exit router workflow (skip remaining steps) Check for existing UX spec or PRD {project-root}/bmad/bmm/tasks/ai-fe-prompt.md Exit router workflow after prompt generation

Continue to step 3 for project assessment

Let's understand your project needs:

1. Project Type:

  1. Game
  2. Web application
  3. Mobile application
  4. Desktop application
  5. Backend service/API
  6. Library/package
  7. Other - Please specify

2. Project Context:

a. New project (greenfield) b. Adding to existing clean codebase c. Working with messy/legacy code (needs refactoring)

3. What are you building? (brief description)

Detect if project_type == "game"

Set workflow_type = "gdd" Skip level classification (GDD workflow handles all game project levels) Jump to step 5 for GDD-specific assessment

Else, based on their description, analyze and suggest scope level:

Examples:

  • "Fix login bug" → Suggests Level 0 (single atomic change)
  • "Add OAuth to existing app" → Suggests Level 1 (coherent feature)
  • "Build internal admin dashboard" → Suggests Level 2 (small system)
  • "Create customer portal with payments" → Suggests Level 3 (full product)
  • "Multi-tenant SaaS platform" → Suggests Level 4 (platform)

Based on your description, this appears to be a {{suggested_level}} project.

3. Quick Scope Guide - Please confirm or adjust:

  1. Single atomic change → Bug fix, add endpoint, single file change (Level 0)
  2. Coherent feature → Add search, implement SSO, new component (Level 1)
  3. Small complete system → Admin tool, team app, prototype (Level 2)
  4. Full product → Customer portal, SaaS MVP (Level 3)
  5. Platform/ecosystem → Enterprise suite, multi-tenant system (Level 4)

4. Do you have existing documentation?

  1. Product Brief
  2. Market Research
  3. Technical docs/Architecture
  4. None

Based on responses, determine:

Level Classification:

  • Level 0: Single atomic change → tech-spec only
  • Level 1: Single feature, 1-10 stories → minimal PRD + tech-spec
  • Level 2: Small system, 5-15 stories → focused PRD + tech-spec
  • Level 3: Full product, 12-40 stories → full PRD + architect handoff
  • Level 4: Platform, 40+ stories → enterprise PRD + architect handoff

For brownfield without docs:

  • Levels 0-2: Can proceed with context gathering
  • Levels 3-4: MUST run architect assessment first

Initialize analysis using analysis_template from workflow.yaml

Capture any technical preferences mentioned during assessment

Generate comprehensive analysis with all assessment data.

project_type project_level instruction_set scope_description story_count epic_count timeline field_type existing_docs team_size deployment_intent expected_outputs workflow_steps next_steps special_notes technical_preferences

Based on project type and level, load ONLY the needed instructions:

{installed_path}/gdd/workflow.yaml GDD workflow handles all game project levels internally {installed_path}/tech-spec/workflow.yaml {installed_path}/prd/workflow.yaml Pass level context to PRD workflow (loads instructions-med.md) {installed_path}/prd/workflow.yaml Pass level context to PRD workflow (loads instructions-lg.md)

Pass continuation context to invoked workflow:

  • continuation_mode: true/false
  • last_completed_step: {{step_number}}
  • existing_documents: {{document_list}}
  • project_level: {{level}}

The invoked workflow's instruction set should check continuation_mode and adjust accordingly