178 lines
4.8 KiB
Markdown
178 lines
4.8 KiB
Markdown
# Workflow Management
|
|
|
|
This utility enables the BMAD orchestrator to manage and execute team workflows.
|
|
|
|
## Workflow Commands
|
|
|
|
### /workflows
|
|
Lists all available workflows for the current team.
|
|
|
|
Example response:
|
|
```
|
|
Available workflows:
|
|
1. greenfield-mvp - Complete workflow for building a new MVP from scratch
|
|
2. fullstack-app - Comprehensive workflow for production-ready applications
|
|
3. api-only - API-first development workflow
|
|
4. brownfield-enhancement - Enhance existing applications
|
|
5. frontend-only - Frontend application development
|
|
|
|
Use /workflow-start {number or id} to begin a workflow.
|
|
```
|
|
|
|
### /workflow-start {workflow-id}
|
|
Starts a specific workflow and transitions to the first agent.
|
|
|
|
Example: `/workflow-start greenfield-mvp`
|
|
|
|
### /workflow-status
|
|
Shows current workflow progress, completed artifacts, and next steps.
|
|
|
|
Example response:
|
|
```
|
|
Current Workflow: Greenfield MVP Development
|
|
Stage: Product Planning (2 of 6)
|
|
Completed:
|
|
✓ Discovery & Requirements
|
|
- project-brief (completed by Mary)
|
|
|
|
In Progress:
|
|
⚡ Product Planning
|
|
- Create PRD (John) - awaiting input
|
|
|
|
Next: Technical Architecture
|
|
```
|
|
|
|
### /workflow-resume
|
|
Resumes a workflow from where it left off, useful when starting a new chat.
|
|
|
|
User can provide completed artifacts:
|
|
```
|
|
User: /workflow-resume greenfield-mvp
|
|
I have completed: project-brief, PRD
|
|
BMad: I see you've completed Discovery and part of Product Planning.
|
|
Based on the greenfield-mvp workflow, the next step is:
|
|
- UX Strategy with Sally (ux-expert)
|
|
|
|
Would you like me to load Sally to continue?
|
|
```
|
|
|
|
### /workflow-next
|
|
Shows the next recommended agent and action in the current workflow.
|
|
|
|
## Workflow Execution Flow
|
|
|
|
### 1. Starting a Workflow
|
|
|
|
When a workflow is started:
|
|
1. Load the workflow definition
|
|
2. Identify the first stage and step
|
|
3. Transition to the required agent
|
|
4. Provide context about expected inputs/outputs
|
|
5. Guide artifact creation
|
|
|
|
### 2. Stage Transitions
|
|
|
|
After each artifact is completed:
|
|
1. Mark the step as complete
|
|
2. Check transition conditions
|
|
3. If stage is complete, move to next stage
|
|
4. Load the appropriate agent
|
|
5. Pass relevant artifacts as context
|
|
|
|
### 3. Artifact Tracking
|
|
|
|
Track all created artifacts:
|
|
```yaml
|
|
workflow_state:
|
|
current_workflow: greenfield-mvp
|
|
current_stage: planning
|
|
current_step: 2
|
|
artifacts:
|
|
project-brief:
|
|
status: completed
|
|
created_by: analyst
|
|
timestamp: 2024-01-15T10:30:00Z
|
|
prd:
|
|
status: in-progress
|
|
created_by: pm
|
|
started: 2024-01-15T11:00:00Z
|
|
```
|
|
|
|
### 4. Workflow Interruption Handling
|
|
|
|
When user returns after interruption:
|
|
1. Ask if continuing previous workflow
|
|
2. Request any completed artifacts
|
|
3. Analyze provided artifacts
|
|
4. Determine workflow position
|
|
5. Suggest next appropriate step
|
|
|
|
Example:
|
|
```
|
|
User: I'm working on a new app. Here's my PRD and architecture doc.
|
|
BMad: I see you have a PRD and architecture document. Based on these artifacts,
|
|
it looks like you're following the greenfield-mvp workflow and have completed
|
|
stages 1-3. The next recommended step would be:
|
|
|
|
Stage 4: Validation & Refinement
|
|
- Load Sarah (Product Owner) to validate all artifacts
|
|
|
|
Would you like to continue with this workflow?
|
|
```
|
|
|
|
## Workflow Context Passing
|
|
|
|
When transitioning between agents, pass:
|
|
1. Previous artifacts created
|
|
2. Current workflow stage
|
|
3. Expected outputs
|
|
4. Any decisions or constraints identified
|
|
|
|
Example transition:
|
|
```
|
|
BMad: Great! John has completed the PRD. According to the greenfield-mvp workflow,
|
|
the next step is UX Strategy with Sally.
|
|
|
|
/ux-expert
|
|
|
|
Sally: I see we're in the Product Planning stage of the greenfield-mvp workflow.
|
|
I have access to:
|
|
- Project Brief from Mary
|
|
- PRD from John
|
|
|
|
Let's create the UX strategy and UI specifications. First, let me review
|
|
the PRD to understand the features we're designing for...
|
|
```
|
|
|
|
## Multi-Path Workflows
|
|
|
|
Some workflows may have multiple paths:
|
|
```yaml
|
|
conditional_paths:
|
|
- condition: "project_type == 'mobile'"
|
|
next_stage: mobile-specific-design
|
|
- condition: "project_type == 'web'"
|
|
next_stage: web-architecture
|
|
- default: fullstack-architecture
|
|
```
|
|
|
|
Handle these by asking clarifying questions when needed.
|
|
|
|
## Workflow Best Practices
|
|
|
|
1. **Always show progress** - Users should know where they are
|
|
2. **Explain transitions** - Why moving to next agent
|
|
3. **Preserve context** - Pass relevant information forward
|
|
4. **Allow flexibility** - Users can skip or modify steps
|
|
5. **Track everything** - Maintain complete workflow state
|
|
|
|
## Integration with Agents
|
|
|
|
Each agent should be workflow-aware:
|
|
- Know which workflow is active
|
|
- Understand their role in the workflow
|
|
- Access previous artifacts
|
|
- Know expected outputs
|
|
- Guide toward workflow goals
|
|
|
|
This creates a seamless experience where the entire team works together toward the workflow's objectives. |