Workflow Overview#

Goal: Create a custom workflow command for BMAD agents

Phase: Builder Module

Agent: Builder

Inputs: Workflow purpose, steps, agent, inputs/outputs

Output: Custom command .md file ready for installation

Duration: 15-30 minutes

Pre-Flight#

1. Load context per helpers.md#Combined-Config-Load
2. Explain: "I'll help you create a custom workflow command following BMAD patterns."

Workflow Creation Process#

Use TodoWrite to track: Define Purpose → Design Steps → Specify Inputs/Outputs → Generate Command → Test → Install

Part 1: Define Workflow#

Ask:

1. Command name: /your-command-name
2. Purpose: What does this workflow achieve?
3. Agent: Which agent executes this? (or create new)
4. Inputs: What does it need?
5. Outputs: What does it produce?
6. Duration: How long does it take?

Part 2: Break Into Steps#

Ask: "What are the 3-10 steps in this workflow?"

Format: Part 1: Step name, Part 2: Step name, etc.

Part 3: Generate Command File#

Template:

You are the  { { Agent } } , executing the ** { { Workflow Name } } ** workflow.

## Workflow Overview

**Goal:**  { { goal } } 
 **Phase:**  { { phase } } 
 **Agent:**  { { agent } } 
 **Inputs:**  { { inputs } } 
 **Output:**  { { output } } 
 **Duration:**  { { duration } } 

 ---

## Pre-Flight

1. Load context per helpers.md
2.  { { workflow-specific-setup } } 

 ---

##  { { Workflow Name } }   Process

Use TodoWrite to track:  { { steps-list } } 

 ---

 { { for each step } } 
 ### Part  { { N } } :  { { Step Name } } 

 { { step-instructions } } 

 ---
 { { end for } } 

 ## Generate Output

 { { output-generation-instructions } } 

 ---

## Update Status

Per helpers.md#Update-Workflow-Status

---

## Recommend Next Steps

 { { next-steps } } 

 ---

## Helper References

- Load config: helpers.md#Combined-Config-Load
- Update status: helpers.md#Update-Workflow-Status
- Save document: helpers.md#Save-Output-Document

---

## Notes for LLMs

- Use TodoWrite to track steps
- Reference helpers.md
-  { { domain-specific-guidance } }

Part 4: Save and Install#

Save to: ./custom-workflows/{{command-name}}.md

Installation:

✓ Workflow Created!

Command: / { { command-name } } 
 File: ./custom-workflows/ { { command-name } } .md

## Install:

cp ./custom-workflows/{{command-name}}.md ~/.claude/config/bmad/commands/ # install to user config

 Restart Claude Code to load the command.

Notes for LLMs#

• Follow BMAD workflow template
• Use helpers.md references
• Include TodoWrite tracking
• Keep token-optimized

Remember: Custom workflows extend BMAD capabilities while maintaining patterns.