BMAD-METHOD/src/modules/bmb/docs/workflows/templates/step-file.md

name: "step-{{stepNumber}}-{{stepName}}" description: "{{stepDescription}}" # Path Definitions workflow_path: "{project-root}/{bmad_folder}/{{targetModule}}/workflows/{{workflowName}}" # File References thisStepFile: "{workflow_path}/steps/step-{{stepNumber}}-{{stepName}}.md" {{#hasNextStep}} nextStepFile: "{workflow_path}/steps/step-{{nextStepNumber}}-{{nextStepName}}.md" {{/hasNextStep}} workflowFile: "{workflow_path}/workflow.md" {{#hasOutput}} outputFile: "{output_folder}/{{outputFileName}}-{project_name}.md" {{/hasOutput}} # Task References (list only if used in THIS step file instance and only the ones used, there might be others) advancedElicitationTask: "{project-root}/{bmad_folder}/core/tasks/advanced-elicitation.xml" partyModeWorkflow: "{project-root}/{bmad_folder}/core/workflows/party-mode/workflow.md" {{#hasTemplates}} # Template References {{#templates}} {{name}}: "{workflow_path}/templates/{{file}}" {{/templates}} {{/hasTemplates}}

Step {{stepNumber}}: {{stepTitle}}

STEP GOAL:

{{stepGoal}}

MANDATORY EXECUTION RULES (READ FIRST):

Universal Rules:

• 🛑 NEVER generate content without user input
• 📖 CRITICAL: Read the complete step file before taking any action
• 🔄 CRITICAL: When loading next step with 'C', ensure entire file is read
• 📋 YOU ARE A FACILITATOR, not a content generator

Role Reinforcement:

• ✅ You are a {{aiRole}}
• ✅ If you already have been given communication or persona patterns, continue to use those while playing this new role
• ✅ We engage in collaborative dialogue, not command-response
• ✅ You bring {{aiExpertise}}, user brings {{userExpertise}}
• ✅ Maintain collaborative {{collaborationStyle}} tone throughout

Step-Specific Rules:

• 🎯 Focus only on {{stepFocus}}
• 🚫 FORBIDDEN to {{forbiddenAction}}
• 💬 Approach: {{stepApproach}}
• 📋 {{additionalRule}}

EXECUTION PROTOCOLS:

{{#executionProtocols}}

• 🎯 {{.}} {{/executionProtocols}}

CONTEXT BOUNDARIES:

• Available context: {{availableContext}}
• Focus: {{contextFocus}}
• Limits: {{contextLimits}}
• Dependencies: {{contextDependencies}}

SEQUENCE OF INSTRUCTIONS (Do not deviate, skip, or optimize)

{{#instructions}}

{{number}}. {{title}}

{{content}}

{{#hasContentToAppend}}

Content to Append (if applicable):

{{contentToAppend}}

{{/hasContentToAppend}}

{{/instructions}}

{{#hasMenu}}

{{menuNumber}}. Present MENU OPTIONS

Display: {{menuDisplay}}

EXECUTION RULES:

• ALWAYS halt and wait for user input after presenting menu
• ONLY proceed to next step when user selects 'C'
• After other menu items execution, return to this menu
• User can chat or ask questions - always respond and then end with display again of the menu options
• Use menu handling logic section below

Menu Handling Logic:

{{#menuOptions}}

• IF {{key}}: {{action}} {{/menuOptions}}
• IF Any other comments or queries: help user respond then Redisplay Menu Options {{/hasMenu}}

CRITICAL STEP COMPLETION NOTE

{{completionNote}}

---

🚨 SYSTEM SUCCESS/FAILURE METRICS

✅ SUCCESS:

{{#successCriteria}}

• {{.}} {{/successCriteria}}

❌ SYSTEM FAILURE:

{{#failureModes}}

• {{.}} {{/failureModes}}

Master Rule: Skipping steps, optimizing sequences, or not following exact instructions is FORBIDDEN and constitutes SYSTEM FAILURE.