mirror of
https://github.com/bmadcode/BMAD-METHOD.git
synced 2025-12-29 16:14:59 +00:00
update local install
This commit is contained in:
Brian Madison
@@ -1,260 +0,0 @@
|
||||
# Workflow Status System
|
||||
|
||||
The universal entry point for BMM workflows - answers "what should I do now?" for any agent.
|
||||
|
||||
## Overview
|
||||
|
||||
The workflow status system provides:
|
||||
|
||||
- **Smart project initialization** - Detects existing work and infers project details
|
||||
- **Simple status tracking** - Key-value pairs for instant parsing
|
||||
- **Intelligent routing** - Suggests next actions based on current state
|
||||
- **Modular workflow paths** - Each project type/level has its own clean definition
|
||||
|
||||
## Architecture
|
||||
|
||||
### Core Components
|
||||
|
||||
```
|
||||
workflow-status/
|
||||
├── workflow.yaml # Main configuration
|
||||
├── instructions.md # Status checker (99 lines)
|
||||
├── workflow-status-template.yaml # Clean YAML status template
|
||||
├── project-levels.yaml # Source of truth for scale definitions
|
||||
└── paths/ # Modular workflow definitions
|
||||
├── greenfield-level-0.yaml through level-4.yaml
|
||||
├── brownfield-level-0.yaml through level-4.yaml
|
||||
└── game-design.yaml
|
||||
```
|
||||
|
||||
### Related Workflow
|
||||
|
||||
```
|
||||
workflow-init/
|
||||
├── workflow.yaml # Initialization configuration
|
||||
└── instructions.md # Smart setup (182 lines)
|
||||
```
|
||||
|
||||
## How It Works
|
||||
|
||||
### For New Projects
|
||||
|
||||
1. User runs `workflow-status`
|
||||
2. System finds no status file
|
||||
3. Directs to `workflow-init`
|
||||
4. Init workflow:
|
||||
- Scans for existing work (PRDs, code, etc.)
|
||||
- Infers project details from what it finds
|
||||
- Asks minimal questions (name + description)
|
||||
- Confirms understanding in one step
|
||||
- Creates status file with workflow path
|
||||
|
||||
### For Existing Projects
|
||||
|
||||
1. User runs `workflow-status`
|
||||
2. System reads status file
|
||||
3. Shows current state and options:
|
||||
- Continue in-progress work
|
||||
- Next required step
|
||||
- Available optional workflows
|
||||
4. User picks action
|
||||
|
||||
## Status File Format
|
||||
|
||||
Clean YAML format with all workflows listed up front:
|
||||
|
||||
```yaml
|
||||
# generated: 2025-10-29
|
||||
# project: MyProject
|
||||
# project_type: software
|
||||
# project_level: 2
|
||||
# field_type: greenfield
|
||||
# workflow_path: greenfield-level-2.yaml
|
||||
|
||||
workflow_status:
|
||||
# Phase 1: Analysis
|
||||
brainstorm-project: optional
|
||||
research: optional
|
||||
product-brief: recommended
|
||||
|
||||
# Phase 2: Planning
|
||||
prd: docs/prd.md
|
||||
validate-prd: optional
|
||||
create-design: conditional
|
||||
|
||||
# Phase 3: Solutioning
|
||||
create-architecture: required
|
||||
validate-architecture: optional
|
||||
solutioning-gate-check: required
|
||||
```
|
||||
|
||||
**Status Values:**
|
||||
|
||||
- `required` / `optional` / `recommended` / `conditional` - Not yet started
|
||||
- `{file-path}` - Completed (e.g., `docs/prd.md`)
|
||||
- `skipped` - Optional workflow that was skipped
|
||||
|
||||
Any agent can instantly parse what they need:
|
||||
|
||||
- Read YAML to see all workflows and their status
|
||||
- Check which workflows are completed vs pending
|
||||
- Auto-detect existing work by scanning for output files
|
||||
|
||||
## Project Levels
|
||||
|
||||
Source of truth: `/src/modules/bmm/README.md` lines 77-85
|
||||
|
||||
- **Level 0**: Single atomic change (1 story)
|
||||
- **Level 1**: Small feature (1-10 stories)
|
||||
- **Level 2**: Medium project (5-15 stories)
|
||||
- **Level 3**: Complex system (12-40 stories)
|
||||
- **Level 4**: Enterprise scale (40+ stories)
|
||||
|
||||
## Workflow Paths
|
||||
|
||||
Each combination has its own file:
|
||||
|
||||
- `greenfield-level-X.yaml` - New projects at each level
|
||||
- `brownfield-level-X.yaml` - Existing codebases at each level
|
||||
- `game-design.yaml` - Game projects (all levels)
|
||||
|
||||
Benefits:
|
||||
|
||||
- Load only what's needed (60 lines vs 750+)
|
||||
- Easy to maintain individual paths
|
||||
- Clear separation of concerns
|
||||
|
||||
## Smart Detection
|
||||
|
||||
The init workflow intelligently detects:
|
||||
|
||||
**Project Type:**
|
||||
|
||||
- Finds GDD → game
|
||||
- Otherwise → software
|
||||
|
||||
**Project Level:**
|
||||
|
||||
- Reads PRD epic/story counts
|
||||
- Analyzes scope descriptions
|
||||
- Makes educated guess
|
||||
|
||||
**Field Type:**
|
||||
|
||||
- Finds source code → brownfield
|
||||
- Only planning docs → greenfield
|
||||
- Checks git history age
|
||||
|
||||
**Documentation Status:**
|
||||
|
||||
- Finds index.md → was undocumented
|
||||
- Good README → documented
|
||||
- Missing docs → needs documentation
|
||||
|
||||
## Usage Examples
|
||||
|
||||
### Any Agent Checking Status
|
||||
|
||||
```
|
||||
Agent: workflow-status
|
||||
Result: "Current: Phase 2 - Planning, Next: prd (pm agent)"
|
||||
```
|
||||
|
||||
### New Project Setup
|
||||
|
||||
```
|
||||
Agent: workflow-status
|
||||
System: "No status found. Run workflow-init"
|
||||
Agent: workflow-init
|
||||
System: "Tell me about your project"
|
||||
User: "Building a dashboard with user management"
|
||||
System: "Level 2 greenfield software project. Correct?"
|
||||
User: "Yes"
|
||||
System: "Status created! Next: pm agent, run prd"
|
||||
```
|
||||
|
||||
### Smart Inference
|
||||
|
||||
```
|
||||
System finds: prd-dashboard.md with 3 epics
|
||||
System finds: package.json, src/ directory
|
||||
System infers: Level 2 brownfield software
|
||||
User confirms or corrects
|
||||
```
|
||||
|
||||
## Philosophy
|
||||
|
||||
**Less Structure, More Intelligence**
|
||||
|
||||
Instead of complex if/else logic:
|
||||
|
||||
- Trust the LLM to analyze and infer
|
||||
- Use natural language for corrections
|
||||
- Keep menus simple and contextual
|
||||
- Let intelligence emerge from the model
|
||||
|
||||
**Result:** A workflow system that feels like talking to a smart assistant, not filling out a form.
|
||||
|
||||
## Implementation Details
|
||||
|
||||
### workflow-init (6 Steps)
|
||||
|
||||
1. **Scan for existing work** - Check for docs, code, git history
|
||||
2. **Confirm findings** - Show what was detected (if anything)
|
||||
3. **Gather info** - Name, description, confirm type/level/field
|
||||
4. **Load path file** - Select appropriate workflow definition
|
||||
5. **Generate workflow** - Build from path file
|
||||
6. **Create status file** - Save and show next step
|
||||
|
||||
### workflow-status (4 Steps)
|
||||
|
||||
1. **Check for status file** - Direct to init if missing
|
||||
2. **Parse status** - Extract key-value pairs
|
||||
3. **Display options** - Show current, required, optional
|
||||
4. **Handle selection** - Execute user's choice
|
||||
|
||||
## Best Practices
|
||||
|
||||
1. **Let the AI guess** - It's usually right, user corrects if needed
|
||||
2. **One conversation** - Get all info in Step 3 of init
|
||||
3. **Simple parsing** - Key-value pairs, not complex structures
|
||||
4. **Modular paths** - Each scenario in its own file
|
||||
5. **Trust intelligence** - LLM understands context better than rules
|
||||
|
||||
## Integration
|
||||
|
||||
Other workflows read the status to coordinate:
|
||||
|
||||
- Any workflow can check CURRENT_PHASE
|
||||
- Workflows can verify prerequisites are complete
|
||||
- All agents can ask "what should I do?"
|
||||
|
||||
**Phase 4 (Implementation):**
|
||||
|
||||
- workflow-status only tracks sprint-planning completion
|
||||
- After sprint-planning, all story/epic tracking happens in sprint-status.yaml
|
||||
- Phase 4 workflows do NOT read/write workflow-status (except sprint-planning for prerequisite verification)
|
||||
|
||||
The workflow-status.yaml file is the single source of truth for Phases 1-3, and sprint-status.yaml takes over for Phase 4 implementation tracking.
|
||||
|
||||
## Benefits
|
||||
|
||||
✅ **Smart Detection** - Infers from existing work instead of asking everything
|
||||
✅ **Minimal Questions** - Just name and description in most cases
|
||||
✅ **Clean Status** - Simple key-value pairs for instant parsing
|
||||
✅ **Modular Paths** - 60-line files instead of 750+ line monolith
|
||||
✅ **Natural Language** - "Tell me about your project" not "Pick 1-12"
|
||||
✅ **Intelligent Menus** - Shows only relevant options
|
||||
✅ **Fast Parsing** - Grep instead of complex logic
|
||||
✅ **Easy Maintenance** - Change one level without affecting others
|
||||
|
||||
## Future Enhancements
|
||||
|
||||
- Visual progress indicators
|
||||
- Time tracking and estimates
|
||||
- Multi-project support
|
||||
- Team synchronization
|
||||
|
||||
---
|
||||
|
||||
**This workflow is the front door to BMad Method. Start here to know what to do next.**
|
||||
File diff suppressed because it is too large
Load Diff
27
bmad/bmm/workflows/workflow-status/init/workflow.yaml.bak
Normal file
27
bmad/bmm/workflows/workflow-status/init/workflow.yaml.bak
Normal file
@@ -0,0 +1,27 @@
|
||||
# Workflow Init - Initial Project Setup
|
||||
name: workflow-init
|
||||
description: "Initialize a new BMM project by determining level, type, and creating workflow path"
|
||||
author: "BMad"
|
||||
|
||||
# Critical variables from config
|
||||
config_source: "{project-root}/bmad/bmm/config.yaml"
|
||||
output_folder: "{config_source}:output_folder"
|
||||
user_name: "{config_source}:user_name"
|
||||
project_name: "{config_source}:project_name"
|
||||
communication_language: "{config_source}:communication_language"
|
||||
document_output_language: "{config_source}:document_output_language"
|
||||
user_skill_level: "{config_source}:user_skill_level"
|
||||
date: system-generated
|
||||
|
||||
# Workflow components
|
||||
installed_path: "{project-root}/bmad/bmm/workflows/workflow-status/init"
|
||||
instructions: "{installed_path}/instructions.md"
|
||||
template: "{project-root}/bmad/bmm/workflows/workflow-status/workflow-status-template.yaml"
|
||||
|
||||
# Path data files
|
||||
path_files: "{project-root}/bmad/bmm/workflows/workflow-status/paths/"
|
||||
|
||||
# Output configuration
|
||||
default_output_file: "{output_folder}/bmm-workflow-status.yaml"
|
||||
|
||||
standalone: true
|
||||
@@ -1,54 +0,0 @@
|
||||
# Brownfield Level 0 - Single Atomic Change in Existing Codebase
|
||||
# One change to existing system
|
||||
|
||||
project_type: "software"
|
||||
level: 0
|
||||
field_type: "brownfield"
|
||||
description: "Single atomic change to existing codebase"
|
||||
|
||||
phases:
|
||||
- prerequisite: true
|
||||
name: "Documentation"
|
||||
conditional: "if_undocumented"
|
||||
note: "NOT a phase - prerequisite for brownfield without docs OR post-completion cleanup"
|
||||
workflows:
|
||||
- id: "document-project"
|
||||
required: true
|
||||
agent: "analyst"
|
||||
command: "document-project"
|
||||
output: "Comprehensive project documentation"
|
||||
purpose: "Understand existing codebase before planning OR create superior final docs after Phase 4"
|
||||
|
||||
- phase: 1
|
||||
name: "Analysis"
|
||||
optional: true
|
||||
workflows:
|
||||
- id: "brainstorm-project"
|
||||
optional: true
|
||||
agent: "analyst"
|
||||
command: "brainstorm-project"
|
||||
|
||||
- phase: 2
|
||||
name: "Planning"
|
||||
required: true
|
||||
workflows:
|
||||
- id: "tech-spec"
|
||||
required: true
|
||||
agent: "architect"
|
||||
command: "tech-spec"
|
||||
output: "Creates single story file"
|
||||
note: "Must understand existing patterns"
|
||||
|
||||
- phase: 3
|
||||
name: "Solutioning"
|
||||
skip: true
|
||||
|
||||
- phase: 4
|
||||
name: "Implementation"
|
||||
required: true
|
||||
workflows:
|
||||
- id: "sprint-planning"
|
||||
required: true
|
||||
agent: "sm"
|
||||
command: "sprint-planning"
|
||||
note: "Creates sprint plan with all stories - subsequent work tracked in sprint plan output, not workflow-status"
|
||||
@@ -1,76 +0,0 @@
|
||||
# Brownfield Level 2 - Medium Project in Existing Codebase
|
||||
# 5-15 stories, multiple features added to existing system
|
||||
|
||||
project_type: "software"
|
||||
level: 2
|
||||
field_type: "brownfield"
|
||||
description: "Medium project adding multiple features to existing codebase"
|
||||
|
||||
phases:
|
||||
- prerequisite: true
|
||||
name: "Documentation"
|
||||
conditional: "if_undocumented"
|
||||
note: "NOT a phase - prerequisite for brownfield without docs OR post-completion cleanup"
|
||||
workflows:
|
||||
- id: "document-project"
|
||||
required: true
|
||||
agent: "analyst"
|
||||
command: "document-project"
|
||||
output: "Comprehensive project documentation"
|
||||
purpose: "Understand existing codebase before planning OR create superior final docs after Phase 4"
|
||||
|
||||
- phase: 1
|
||||
name: "Analysis"
|
||||
optional: true
|
||||
workflows:
|
||||
- id: "brainstorm-project"
|
||||
optional: true
|
||||
agent: "analyst"
|
||||
command: "brainstorm-project"
|
||||
- id: "research"
|
||||
optional: true
|
||||
agent: "analyst"
|
||||
command: "research"
|
||||
- id: "product-brief"
|
||||
optional: true
|
||||
agent: "analyst"
|
||||
command: "product-brief"
|
||||
|
||||
- phase: 2
|
||||
name: "Planning"
|
||||
required: true
|
||||
workflows:
|
||||
- id: "prd"
|
||||
recommended: true
|
||||
agent: "pm"
|
||||
command: "prd"
|
||||
output: "Focused PRD for new features"
|
||||
note: "Must consider existing system constraints"
|
||||
- id: "validate-prd"
|
||||
optional: true
|
||||
agent: "pm"
|
||||
command: "validate-prd"
|
||||
- id: "tech-spec"
|
||||
required: true
|
||||
agent: "pm"
|
||||
command: "tech-spec"
|
||||
output: "Creates spec with multiple story files"
|
||||
note: "Integrate with existing patterns"
|
||||
- id: "create-design"
|
||||
conditional: "if_has_ui"
|
||||
agent: "ux-designer"
|
||||
command: "create-design"
|
||||
|
||||
- phase: 3
|
||||
name: "Solutioning"
|
||||
skip: true
|
||||
|
||||
- phase: 4
|
||||
name: "Implementation"
|
||||
required: true
|
||||
workflows:
|
||||
- id: "sprint-planning"
|
||||
required: true
|
||||
agent: "sm"
|
||||
command: "sprint-planning"
|
||||
note: "Creates sprint plan with all stories - subsequent work tracked in sprint plan output, not workflow-status"
|
||||
@@ -1,88 +0,0 @@
|
||||
# Brownfield Level 4 - Enterprise Scale Changes to Existing System
|
||||
# 40+ stories, major expansion of existing enterprise system
|
||||
|
||||
project_type: "software"
|
||||
level: 4
|
||||
field_type: "brownfield"
|
||||
description: "Enterprise scale expansion of existing system"
|
||||
|
||||
phases:
|
||||
- prerequisite: true
|
||||
name: "Documentation"
|
||||
conditional: "if_undocumented"
|
||||
note: "NOT a phase - prerequisite for brownfield without docs OR post-completion cleanup. Critical for enterprise-scale changes"
|
||||
workflows:
|
||||
- id: "document-project"
|
||||
required: true
|
||||
agent: "analyst"
|
||||
command: "document-project"
|
||||
output: "Comprehensive project documentation"
|
||||
purpose: "Understand existing codebase before planning OR create superior final docs after Phase 4"
|
||||
|
||||
- phase: 1
|
||||
name: "Analysis"
|
||||
required: true
|
||||
workflows:
|
||||
- id: "brainstorm-project"
|
||||
recommended: true
|
||||
agent: "analyst"
|
||||
command: "brainstorm-project"
|
||||
- id: "research"
|
||||
required: true
|
||||
agent: "analyst"
|
||||
command: "research"
|
||||
note: "Research existing system architecture deeply"
|
||||
- id: "product-brief"
|
||||
required: true
|
||||
agent: "analyst"
|
||||
command: "product-brief"
|
||||
note: "Strategic brief for major expansion"
|
||||
|
||||
- phase: 2
|
||||
name: "Planning"
|
||||
required: true
|
||||
workflows:
|
||||
- id: "prd"
|
||||
required: true
|
||||
agent: "pm"
|
||||
command: "prd"
|
||||
output: "Comprehensive PRD considering existing system"
|
||||
- id: "validate-prd"
|
||||
optional: true
|
||||
agent: "pm"
|
||||
command: "validate-prd"
|
||||
- id: "create-design"
|
||||
required: true
|
||||
agent: "ux-designer"
|
||||
command: "create-design"
|
||||
note: "Multiple UI/UX specifications"
|
||||
|
||||
- phase: 3
|
||||
name: "Solutioning"
|
||||
required: true
|
||||
workflows:
|
||||
- id: "create-architecture"
|
||||
required: true
|
||||
agent: "architect"
|
||||
command: "create-architecture"
|
||||
output: "Architecture for system expansion"
|
||||
note: "Must maintain backward compatibility"
|
||||
- id: "validate-architecture"
|
||||
optional: true
|
||||
agent: "architect"
|
||||
command: "validate-architecture"
|
||||
- id: "solutioning-gate-check"
|
||||
required: true
|
||||
agent: "architect"
|
||||
command: "solutioning-gate-check"
|
||||
note: "Critical validation before major changes"
|
||||
|
||||
- phase: 4
|
||||
name: "Implementation"
|
||||
required: true
|
||||
workflows:
|
||||
- id: "sprint-planning"
|
||||
required: true
|
||||
agent: "sm"
|
||||
command: "sprint-planning"
|
||||
note: "Creates sprint plan with all stories - subsequent work tracked in sprint plan output, not workflow-status"
|
||||
@@ -0,0 +1,120 @@
|
||||
# BMad Enterprise Method - Brownfield
|
||||
# Extended enterprise planning for complex brownfield with security/devops/test (30+ stories typically)
|
||||
|
||||
method_name: "BMad Enterprise Method"
|
||||
track: "enterprise"
|
||||
field_type: "brownfield"
|
||||
description: "Enterprise-grade planning for complex brownfield additions with extended requirements"
|
||||
|
||||
phases:
|
||||
- prerequisite: true
|
||||
name: "Documentation"
|
||||
conditional: "if_undocumented"
|
||||
note: "NOT a phase - prerequisite for brownfield without docs (nearly mandatory for enterprise)"
|
||||
workflows:
|
||||
- id: "document-project"
|
||||
required: true
|
||||
agent: "analyst"
|
||||
command: "document-project"
|
||||
output: "Comprehensive project documentation"
|
||||
purpose: "Understand existing codebase - critical for enterprise brownfield"
|
||||
|
||||
- phase: 0
|
||||
name: "Discovery (Required)"
|
||||
required: true
|
||||
note: "Analysis phase required for enterprise projects"
|
||||
workflows:
|
||||
- id: "brainstorm-project"
|
||||
optional: true
|
||||
agent: "analyst"
|
||||
command: "brainstorm-project"
|
||||
included_by: "user_choice"
|
||||
|
||||
- id: "research"
|
||||
recommended: true
|
||||
agent: "analyst"
|
||||
command: "research"
|
||||
included_by: "user_choice"
|
||||
note: "Highly recommended - compliance, integration, risk research"
|
||||
|
||||
- id: "product-brief"
|
||||
optional: true
|
||||
agent: "analyst"
|
||||
command: "product-brief"
|
||||
included_by: "user_choice"
|
||||
note: "Optional for brownfield enterprise"
|
||||
|
||||
- phase: 1
|
||||
name: "Planning"
|
||||
required: true
|
||||
workflows:
|
||||
- id: "prd"
|
||||
required: true
|
||||
agent: "pm"
|
||||
command: "prd"
|
||||
output: "Enterprise PRD with compliance requirements"
|
||||
note: "Must address existing system constraints and migration strategy"
|
||||
|
||||
- id: "validate-prd"
|
||||
recommended: true
|
||||
agent: "pm"
|
||||
command: "validate-prd"
|
||||
|
||||
- id: "create-design"
|
||||
recommended: true
|
||||
agent: "ux-designer"
|
||||
command: "create-design"
|
||||
note: "Recommended - must integrate with existing UX patterns"
|
||||
|
||||
- phase: 2
|
||||
name: "Solutioning"
|
||||
required: true
|
||||
workflows:
|
||||
- id: "create-architecture"
|
||||
required: true
|
||||
agent: "architect"
|
||||
command: "create-architecture"
|
||||
output: "Integration architecture with enterprise considerations"
|
||||
note: "Distills brownfield context + adds security/scalability/compliance design"
|
||||
|
||||
- id: "create-security-architecture"
|
||||
required: true
|
||||
agent: "architect"
|
||||
command: "create-security-architecture"
|
||||
output: "Security architecture for brownfield integration"
|
||||
note: "Future workflow - threat model, auth integration, audit requirements"
|
||||
|
||||
- id: "create-devops-strategy"
|
||||
required: true
|
||||
agent: "architect"
|
||||
command: "create-devops-strategy"
|
||||
output: "DevOps strategy for brownfield deployment"
|
||||
note: "Future workflow - CI/CD integration, deployment strategy, monitoring"
|
||||
|
||||
- id: "create-test-strategy"
|
||||
required: true
|
||||
agent: "tea"
|
||||
command: "create-test-strategy"
|
||||
output: "Test strategy including regression testing"
|
||||
note: "Future workflow - critical for brownfield to prevent breaking existing functionality"
|
||||
|
||||
- id: "validate-architecture"
|
||||
optional: true
|
||||
agent: "architect"
|
||||
command: "validate-architecture"
|
||||
|
||||
- id: "solutioning-gate-check"
|
||||
required: true
|
||||
agent: "architect"
|
||||
command: "solutioning-gate-check"
|
||||
note: "Critical gate - validates all planning before touching production system"
|
||||
|
||||
- phase: 3
|
||||
name: "Implementation"
|
||||
required: true
|
||||
workflows:
|
||||
- id: "sprint-planning"
|
||||
required: true
|
||||
agent: "sm"
|
||||
command: "sprint-planning"
|
||||
note: "Enterprise brownfield requires careful phasing and feature flags"
|
||||
@@ -0,0 +1,108 @@
|
||||
# BMad Enterprise Method - Greenfield
|
||||
# Extended enterprise planning with security/devops/test for greenfield (30+ stories typically)
|
||||
|
||||
method_name: "BMad Enterprise Method"
|
||||
track: "enterprise"
|
||||
field_type: "greenfield"
|
||||
description: "Complete enterprise-grade planning with security, devops, and test strategy"
|
||||
|
||||
phases:
|
||||
- phase: 0
|
||||
name: "Discovery (Required)"
|
||||
required: true
|
||||
note: "Analysis phase required for enterprise projects"
|
||||
workflows:
|
||||
- id: "brainstorm-project"
|
||||
optional: true
|
||||
agent: "analyst"
|
||||
command: "brainstorm-project"
|
||||
included_by: "user_choice"
|
||||
|
||||
- id: "research"
|
||||
recommended: true
|
||||
agent: "analyst"
|
||||
command: "research"
|
||||
included_by: "user_choice"
|
||||
note: "Highly recommended for enterprise - domain and compliance research"
|
||||
|
||||
- id: "product-brief"
|
||||
recommended: true
|
||||
agent: "analyst"
|
||||
command: "product-brief"
|
||||
included_by: "user_choice"
|
||||
note: "Recommended for strategic alignment"
|
||||
|
||||
- phase: 1
|
||||
name: "Planning"
|
||||
required: true
|
||||
workflows:
|
||||
- id: "prd"
|
||||
required: true
|
||||
agent: "pm"
|
||||
command: "prd"
|
||||
output: "Comprehensive Product Requirements Document"
|
||||
note: "Enterprise-level requirements with compliance considerations"
|
||||
|
||||
- id: "validate-prd"
|
||||
recommended: true
|
||||
agent: "pm"
|
||||
command: "validate-prd"
|
||||
|
||||
- id: "create-design"
|
||||
recommended: true
|
||||
agent: "ux-designer"
|
||||
command: "create-design"
|
||||
note: "Highly recommended for enterprise - design system and patterns"
|
||||
|
||||
- phase: 2
|
||||
name: "Solutioning"
|
||||
required: true
|
||||
workflows:
|
||||
- id: "create-architecture"
|
||||
required: true
|
||||
agent: "architect"
|
||||
command: "create-architecture"
|
||||
output: "Enterprise-grade system architecture"
|
||||
note: "Includes scalability, multi-tenancy, integration architecture"
|
||||
|
||||
- id: "create-security-architecture"
|
||||
required: true
|
||||
agent: "architect"
|
||||
command: "create-security-architecture"
|
||||
output: "Security architecture and threat model"
|
||||
note: "Future workflow - security design, auth, compliance"
|
||||
|
||||
- id: "create-devops-strategy"
|
||||
required: true
|
||||
agent: "architect"
|
||||
command: "create-devops-strategy"
|
||||
output: "DevOps pipeline and infrastructure plan"
|
||||
note: "Future workflow - CI/CD, deployment, monitoring"
|
||||
|
||||
- id: "create-test-strategy"
|
||||
required: true
|
||||
agent: "tea"
|
||||
command: "create-test-strategy"
|
||||
output: "Comprehensive test strategy"
|
||||
note: "Future workflow - test approach, automation, quality gates"
|
||||
|
||||
- id: "validate-architecture"
|
||||
optional: true
|
||||
agent: "architect"
|
||||
command: "validate-architecture"
|
||||
|
||||
- id: "solutioning-gate-check"
|
||||
required: true
|
||||
agent: "architect"
|
||||
command: "solutioning-gate-check"
|
||||
note: "Validates all planning artifacts align before implementation"
|
||||
|
||||
- phase: 3
|
||||
name: "Implementation"
|
||||
required: true
|
||||
workflows:
|
||||
- id: "sprint-planning"
|
||||
required: true
|
||||
agent: "sm"
|
||||
command: "sprint-planning"
|
||||
note: "Creates sprint plan - enterprise projects may require phased rollout"
|
||||
@@ -1,45 +0,0 @@
|
||||
# Greenfield Level 0 - Single Atomic Change
|
||||
# The simplest possible workflow - one change, one story
|
||||
|
||||
project_type: "software"
|
||||
level: 0
|
||||
field_type: "greenfield"
|
||||
description: "Single atomic change - bug fix, tiny feature, one story"
|
||||
|
||||
phases:
|
||||
- phase: 1
|
||||
name: "Analysis"
|
||||
optional: true
|
||||
workflows:
|
||||
- id: "brainstorm-project"
|
||||
optional: true
|
||||
agent: "analyst"
|
||||
command: "brainstorm-project"
|
||||
- id: "product-brief"
|
||||
optional: true
|
||||
agent: "analyst"
|
||||
command: "product-brief"
|
||||
|
||||
- phase: 2
|
||||
name: "Planning"
|
||||
required: true
|
||||
workflows:
|
||||
- id: "tech-spec"
|
||||
required: true
|
||||
agent: "pm"
|
||||
command: "tech-spec"
|
||||
output: "Creates Technical Specification with single story file"
|
||||
|
||||
- phase: 3
|
||||
name: "Solutioning"
|
||||
skip: true
|
||||
|
||||
- phase: 4
|
||||
name: "Implementation"
|
||||
required: true
|
||||
workflows:
|
||||
- id: "sprint-planning"
|
||||
required: true
|
||||
agent: "sm"
|
||||
command: "sprint-planning"
|
||||
note: "Creates sprint plan with all stories - subsequent work tracked in sprint plan output, not workflow-status"
|
||||
@@ -1,73 +0,0 @@
|
||||
# Greenfield Level 3 - Complex System
|
||||
# Subsystems, integrations, architectural decisions required
|
||||
|
||||
project_type: "software"
|
||||
level: 3
|
||||
field_type: "greenfield"
|
||||
description: "Complex system - subsystems, integrations, architectural decisions"
|
||||
|
||||
phases:
|
||||
- phase: 1
|
||||
name: "Analysis"
|
||||
optional: true
|
||||
workflows:
|
||||
- id: "brainstorm-project"
|
||||
optional: true
|
||||
agent: "analyst"
|
||||
command: "brainstorm-project"
|
||||
- id: "research"
|
||||
optional: true
|
||||
agent: "analyst"
|
||||
command: "research"
|
||||
note: "Multiple research areas likely"
|
||||
- id: "product-brief"
|
||||
recommended: true
|
||||
agent: "analyst"
|
||||
command: "product-brief"
|
||||
|
||||
- phase: 2
|
||||
name: "Planning"
|
||||
required: true
|
||||
workflows:
|
||||
- id: "prd"
|
||||
required: true
|
||||
agent: "pm"
|
||||
command: "prd"
|
||||
output: "High-level requirements and epic definitions"
|
||||
- id: "validate-prd"
|
||||
optional: true
|
||||
agent: "pm"
|
||||
command: "validate-prd"
|
||||
- id: "create-design"
|
||||
conditional: "if_has_ui"
|
||||
agent: "ux-designer"
|
||||
command: "create-design"
|
||||
|
||||
- phase: 3
|
||||
name: "Solutioning"
|
||||
required: true
|
||||
workflows:
|
||||
- id: "create-architecture"
|
||||
required: true
|
||||
agent: "architect"
|
||||
command: "create-architecture"
|
||||
output: "System-wide architecture document"
|
||||
- id: "validate-architecture"
|
||||
optional: true
|
||||
agent: "architect"
|
||||
command: "validate-architecture"
|
||||
- id: "solutioning-gate-check"
|
||||
recommended: true
|
||||
agent: "architect"
|
||||
command: "solutioning-gate-check"
|
||||
note: "Validate PRD + UX + architecture cohesion before implementation"
|
||||
|
||||
- phase: 4
|
||||
name: "Implementation"
|
||||
required: true
|
||||
workflows:
|
||||
- id: "sprint-planning"
|
||||
required: true
|
||||
agent: "sm"
|
||||
command: "sprint-planning"
|
||||
note: "Creates sprint plan with all stories - subsequent work tracked in sprint plan output, not workflow-status"
|
||||
@@ -1,75 +0,0 @@
|
||||
# Greenfield Level 4 - Enterprise Scale
|
||||
# Multiple products, enterprise architecture, 40+ stories
|
||||
|
||||
project_type: "software"
|
||||
level: 4
|
||||
field_type: "greenfield"
|
||||
description: "Enterprise scale - multiple products, enterprise architecture"
|
||||
|
||||
phases:
|
||||
- phase: 1
|
||||
name: "Analysis"
|
||||
required: true
|
||||
workflows:
|
||||
- id: "brainstorm-project"
|
||||
recommended: true
|
||||
agent: "analyst"
|
||||
command: "brainstorm-project"
|
||||
- id: "research"
|
||||
required: false
|
||||
agent: "analyst"
|
||||
command: "research"
|
||||
note: "Extensive research across multiple domains"
|
||||
- id: "product-brief"
|
||||
required: true
|
||||
agent: "analyst"
|
||||
command: "product-brief"
|
||||
note: "Strategic brief for enterprise scope"
|
||||
|
||||
- phase: 2
|
||||
name: "Planning"
|
||||
required: true
|
||||
workflows:
|
||||
- id: "prd"
|
||||
required: true
|
||||
agent: "pm"
|
||||
command: "prd"
|
||||
output: "Comprehensive product requirements document"
|
||||
- id: "validate-prd"
|
||||
optional: true
|
||||
agent: "pm"
|
||||
command: "validate-prd"
|
||||
- id: "create-design"
|
||||
required: true
|
||||
agent: "ux-designer"
|
||||
command: "create-design"
|
||||
note: "Multiple UI/UX specifications needed"
|
||||
|
||||
- phase: 3
|
||||
name: "Solutioning"
|
||||
required: true
|
||||
workflows:
|
||||
- id: "create-architecture"
|
||||
required: true
|
||||
agent: "architect"
|
||||
command: "create-architecture"
|
||||
output: "Enterprise architecture documentation"
|
||||
- id: "validate-architecture"
|
||||
optional: true
|
||||
agent: "architect"
|
||||
command: "validate-architecture"
|
||||
- id: "solutioning-gate-check"
|
||||
required: true
|
||||
agent: "architect"
|
||||
command: "solutioning-gate-check"
|
||||
note: "Validate PRD + UX + architecture cohesion before implementation"
|
||||
|
||||
- phase: 4
|
||||
name: "Implementation"
|
||||
required: true
|
||||
workflows:
|
||||
- id: "sprint-planning"
|
||||
required: true
|
||||
agent: "sm"
|
||||
command: "sprint-planning"
|
||||
note: "Creates sprint plan with all stories - subsequent work tracked in sprint plan output, not workflow-status"
|
||||
@@ -1,43 +1,49 @@
|
||||
# Brownfield Level 3 - Complex Integration with Existing System
|
||||
# Major feature addition requiring architectural integration
|
||||
# BMad Method - Brownfield
|
||||
# Full product + architecture planning for complex brownfield additions (10-50+ stories typically)
|
||||
|
||||
project_type: "software"
|
||||
level: 3
|
||||
method_name: "BMad Method"
|
||||
track: "method"
|
||||
field_type: "brownfield"
|
||||
description: "Complex integration with existing system architecture"
|
||||
description: "Complete product and system design for complex brownfield work"
|
||||
|
||||
phases:
|
||||
- prerequisite: true
|
||||
name: "Documentation"
|
||||
conditional: "if_undocumented"
|
||||
note: "NOT a phase - prerequisite for brownfield without docs OR post-completion cleanup"
|
||||
note: "NOT a phase - prerequisite for brownfield without docs"
|
||||
workflows:
|
||||
- id: "document-project"
|
||||
required: true
|
||||
agent: "analyst"
|
||||
command: "document-project"
|
||||
output: "Comprehensive project documentation"
|
||||
purpose: "Understand existing codebase before planning OR create superior final docs after Phase 4"
|
||||
purpose: "Understand existing codebase before planning"
|
||||
|
||||
- phase: 1
|
||||
name: "Analysis"
|
||||
recommended: true
|
||||
- phase: 0
|
||||
name: "Discovery (Optional)"
|
||||
optional: true
|
||||
note: "User-selected during workflow-init"
|
||||
workflows:
|
||||
- id: "brainstorm-project"
|
||||
optional: true
|
||||
agent: "analyst"
|
||||
command: "brainstorm-project"
|
||||
included_by: "user_choice"
|
||||
|
||||
- id: "research"
|
||||
recommended: true
|
||||
optional: true
|
||||
agent: "analyst"
|
||||
command: "research"
|
||||
note: "Research existing architecture patterns"
|
||||
included_by: "user_choice"
|
||||
|
||||
- id: "product-brief"
|
||||
recommended: true
|
||||
optional: true
|
||||
agent: "analyst"
|
||||
command: "product-brief"
|
||||
included_by: "user_choice"
|
||||
note: "Optional for brownfield, less common than greenfield"
|
||||
|
||||
- phase: 2
|
||||
- phase: 1
|
||||
name: "Planning"
|
||||
required: true
|
||||
workflows:
|
||||
@@ -45,46 +51,42 @@ phases:
|
||||
required: true
|
||||
agent: "pm"
|
||||
command: "prd"
|
||||
output: "Requirements with integration points"
|
||||
output: "PRD focused on new features/changes"
|
||||
note: "Must consider existing system constraints"
|
||||
|
||||
- id: "validate-prd"
|
||||
optional: true
|
||||
agent: "pm"
|
||||
command: "validate-prd"
|
||||
|
||||
- id: "create-design"
|
||||
conditional: "if_has_ui"
|
||||
agent: "ux-designer"
|
||||
command: "create-design"
|
||||
note: "Must align with existing UI patterns"
|
||||
|
||||
- phase: 3
|
||||
- phase: 2
|
||||
name: "Solutioning"
|
||||
required: true
|
||||
workflows:
|
||||
- id: "architecture-review"
|
||||
required: true
|
||||
agent: "architect"
|
||||
command: "architecture-review"
|
||||
note: "Review existing architecture first"
|
||||
- id: "integration-planning"
|
||||
required: true
|
||||
agent: "architect"
|
||||
command: "integration-planning"
|
||||
output: "Integration strategy document"
|
||||
- id: "create-architecture"
|
||||
required: true
|
||||
recommended: true
|
||||
agent: "architect"
|
||||
command: "create-architecture"
|
||||
note: "Extension of existing architecture"
|
||||
output: "Integration architecture - solution design for THIS project"
|
||||
note: "HIGHLY RECOMMENDED: Distills massive brownfield context into focused solution design. Prevents agent confusion."
|
||||
|
||||
- id: "validate-architecture"
|
||||
optional: true
|
||||
agent: "architect"
|
||||
command: "validate-architecture"
|
||||
|
||||
- id: "solutioning-gate-check"
|
||||
required: true
|
||||
agent: "architect"
|
||||
command: "solutioning-gate-check"
|
||||
note: "Validates PRD + UX + Architecture (if created) cohesion"
|
||||
|
||||
- phase: 4
|
||||
- phase: 3
|
||||
name: "Implementation"
|
||||
required: true
|
||||
workflows:
|
||||
@@ -92,4 +94,4 @@ phases:
|
||||
required: true
|
||||
agent: "sm"
|
||||
command: "sprint-planning"
|
||||
note: "Creates sprint plan with all stories - subsequent work tracked in sprint plan output, not workflow-status"
|
||||
note: "Creates sprint plan with stories"
|
||||
@@ -1,31 +1,38 @@
|
||||
# Greenfield Level 2 - Medium Project
|
||||
# Multiple epics with 10+ stories total
|
||||
# BMad Method - Greenfield
|
||||
# Full product + architecture planning for greenfield projects (10-50+ stories typically)
|
||||
|
||||
project_type: "software"
|
||||
level: 2
|
||||
method_name: "BMad Method"
|
||||
track: "method"
|
||||
field_type: "greenfield"
|
||||
description: "Medium project - multiple epics, 10+ stories"
|
||||
description: "Complete product and system design methodology for greenfield projects"
|
||||
|
||||
phases:
|
||||
- phase: 1
|
||||
name: "Analysis"
|
||||
- phase: 0
|
||||
name: "Discovery (Optional)"
|
||||
optional: true
|
||||
note: "User-selected during workflow-init"
|
||||
workflows:
|
||||
- id: "brainstorm-project"
|
||||
optional: true
|
||||
agent: "analyst"
|
||||
command: "brainstorm-project"
|
||||
included_by: "user_choice"
|
||||
|
||||
- id: "research"
|
||||
optional: true
|
||||
agent: "analyst"
|
||||
command: "research"
|
||||
note: "Can have multiple research docs"
|
||||
included_by: "user_choice"
|
||||
note: "Can have multiple research workflows"
|
||||
|
||||
- id: "product-brief"
|
||||
recommended: true
|
||||
optional: true
|
||||
agent: "analyst"
|
||||
command: "product-brief"
|
||||
included_by: "user_choice"
|
||||
note: "Recommended for greenfield Method projects"
|
||||
|
||||
- phase: 2
|
||||
- phase: 1
|
||||
name: "Planning"
|
||||
required: true
|
||||
workflows:
|
||||
@@ -33,22 +40,21 @@ phases:
|
||||
required: true
|
||||
agent: "pm"
|
||||
command: "prd"
|
||||
output: "Creates PRD with epics.md and story list"
|
||||
output: "Product Requirements Document with epics and stories"
|
||||
|
||||
- id: "validate-prd"
|
||||
optional: true
|
||||
agent: "pm"
|
||||
command: "validate-prd"
|
||||
note: "Quality check for PRD completeness"
|
||||
|
||||
- id: "create-design"
|
||||
conditional: "if_has_ui"
|
||||
agent: "ux-designer"
|
||||
command: "create-design"
|
||||
- id: "tech-spec"
|
||||
optional: true
|
||||
agent: "pm"
|
||||
command: "tech-spec"
|
||||
note: "Lightweight Technical Specification planning"
|
||||
note: "Determined after PRD - user/agent decides if needed"
|
||||
|
||||
- phase: 3
|
||||
- phase: 2
|
||||
name: "Solutioning"
|
||||
required: true
|
||||
workflows:
|
||||
@@ -56,18 +62,22 @@ phases:
|
||||
required: true
|
||||
agent: "architect"
|
||||
command: "create-architecture"
|
||||
output: "System-wide architecture document"
|
||||
output: "System architecture document"
|
||||
note: "Complete system design for greenfield projects"
|
||||
|
||||
- id: "validate-architecture"
|
||||
optional: true
|
||||
agent: "architect"
|
||||
command: "validate-architecture"
|
||||
note: "Quality check for architecture completeness"
|
||||
|
||||
- id: "solutioning-gate-check"
|
||||
required: true
|
||||
agent: "architect"
|
||||
command: "solutioning-gate-check"
|
||||
note: "Validate PRD + UX + architecture cohesion before implementation"
|
||||
note: "Validates PRD + UX + Architecture cohesion before implementation"
|
||||
|
||||
- phase: 4
|
||||
- phase: 3
|
||||
name: "Implementation"
|
||||
required: true
|
||||
workflows:
|
||||
@@ -75,4 +85,4 @@ phases:
|
||||
required: true
|
||||
agent: "sm"
|
||||
command: "sprint-planning"
|
||||
note: "Creates sprint plan with all stories - subsequent work tracked in sprint plan output, not workflow-status"
|
||||
note: "Creates sprint plan - subsequent work tracked there"
|
||||
@@ -1,38 +1,42 @@
|
||||
# Brownfield Level 1 - Small Feature in Existing Codebase
|
||||
# 1-10 stories adding to existing system
|
||||
# BMad Quick Flow - Brownfield
|
||||
# Fast implementation path for existing codebases (1-15 stories typically)
|
||||
|
||||
project_type: "software"
|
||||
level: 1
|
||||
method_name: "BMad Quick Flow"
|
||||
track: "quick-flow"
|
||||
field_type: "brownfield"
|
||||
description: "Small feature addition to existing codebase"
|
||||
description: "Fast tech-spec based implementation for brownfield projects"
|
||||
|
||||
phases:
|
||||
- prerequisite: true
|
||||
name: "Documentation"
|
||||
conditional: "if_undocumented"
|
||||
note: "NOT a phase - prerequisite for brownfield without docs OR post-completion cleanup"
|
||||
note: "NOT a phase - prerequisite for brownfield without docs"
|
||||
workflows:
|
||||
- id: "document-project"
|
||||
required: true
|
||||
agent: "analyst"
|
||||
command: "document-project"
|
||||
output: "Comprehensive project documentation"
|
||||
purpose: "Understand existing codebase before planning OR create superior final docs after Phase 4"
|
||||
purpose: "Understand existing codebase before planning"
|
||||
|
||||
- phase: 1
|
||||
name: "Analysis"
|
||||
- phase: 0
|
||||
name: "Discovery (Optional)"
|
||||
optional: true
|
||||
note: "User-selected during workflow-init"
|
||||
workflows:
|
||||
- id: "brainstorm-project"
|
||||
optional: true
|
||||
agent: "analyst"
|
||||
command: "brainstorm-project"
|
||||
included_by: "user_choice"
|
||||
|
||||
- id: "research"
|
||||
optional: true
|
||||
agent: "analyst"
|
||||
command: "research"
|
||||
included_by: "user_choice"
|
||||
|
||||
- phase: 2
|
||||
- phase: 1
|
||||
name: "Planning"
|
||||
required: true
|
||||
workflows:
|
||||
@@ -40,14 +44,10 @@ phases:
|
||||
required: true
|
||||
agent: "pm"
|
||||
command: "tech-spec"
|
||||
output: "Creates story files for feature"
|
||||
note: "Must integrate with existing architecture"
|
||||
output: "Technical Specification with stories (auto-detects epic if 2+ stories)"
|
||||
note: "Integrates with existing codebase patterns from document-project"
|
||||
|
||||
- phase: 3
|
||||
name: "Solutioning"
|
||||
skip: true
|
||||
|
||||
- phase: 4
|
||||
- phase: 2
|
||||
name: "Implementation"
|
||||
required: true
|
||||
workflows:
|
||||
@@ -55,4 +55,4 @@ phases:
|
||||
required: true
|
||||
agent: "sm"
|
||||
command: "sprint-planning"
|
||||
note: "Creates sprint plan with all stories - subsequent work tracked in sprint plan output, not workflow-status"
|
||||
note: "Creates sprint plan with all stories"
|
||||
@@ -1,30 +1,31 @@
|
||||
# Greenfield Level 1 - Small Feature
|
||||
# Coherent feature with 2-3 stories in a single epic
|
||||
# BMad Quick Flow - Greenfield
|
||||
# Fast implementation path with tech-spec planning (1-15 stories typically)
|
||||
|
||||
project_type: "software"
|
||||
level: 1
|
||||
method_name: "BMad Quick Flow"
|
||||
track: "quick-flow"
|
||||
field_type: "greenfield"
|
||||
description: "Small coherent feature - 2-3 stories, single epic"
|
||||
description: "Fast tech-spec based implementation for greenfield projects"
|
||||
|
||||
phases:
|
||||
- phase: 1
|
||||
name: "Analysis"
|
||||
- phase: 0
|
||||
name: "Discovery (Optional)"
|
||||
optional: true
|
||||
note: "User-selected during workflow-init"
|
||||
workflows:
|
||||
- id: "brainstorm-project"
|
||||
optional: true
|
||||
agent: "analyst"
|
||||
command: "brainstorm-project"
|
||||
included_by: "user_choice"
|
||||
|
||||
- id: "research"
|
||||
optional: true
|
||||
agent: "analyst"
|
||||
command: "research"
|
||||
- id: "product-brief"
|
||||
optional: true
|
||||
agent: "analyst"
|
||||
command: "product-brief"
|
||||
included_by: "user_choice"
|
||||
note: "Can have multiple research workflows"
|
||||
|
||||
- phase: 2
|
||||
- phase: 1
|
||||
name: "Planning"
|
||||
required: true
|
||||
workflows:
|
||||
@@ -32,13 +33,10 @@ phases:
|
||||
required: true
|
||||
agent: "pm"
|
||||
command: "tech-spec"
|
||||
output: "Creates Technical Specification with an epic and 2-3 story files"
|
||||
output: "Technical Specification with stories (auto-detects epic if 2+ stories)"
|
||||
note: "Quick Spec Flow - implementation-focused planning"
|
||||
|
||||
- phase: 3
|
||||
name: "Solutioning"
|
||||
skip: true
|
||||
|
||||
- phase: 4
|
||||
- phase: 2
|
||||
name: "Implementation"
|
||||
required: true
|
||||
workflows:
|
||||
@@ -1,11 +1,11 @@
|
||||
# Workflow Status Template
|
||||
# This tracks progress through phases 1-3 of the BMM methodology
|
||||
# Phase 4 (Implementation) is tracked separately in sprint-status.yaml
|
||||
# This tracks progress through BMM methodology phases
|
||||
# Phase 3/4 (Implementation) is tracked separately in sprint-status.yaml
|
||||
|
||||
# generated: {{generated}}
|
||||
# project: {{project_name}}
|
||||
# project_type: {{project_type}}
|
||||
# project_level: {{project_level}}
|
||||
# selected_track: {{selected_track}}
|
||||
# field_type: {{field_type}}
|
||||
# workflow_path: {{workflow_path_file}}
|
||||
|
||||
@@ -24,7 +24,7 @@
|
||||
generated: "{{generated}}"
|
||||
project: "{{project_name}}"
|
||||
project_type: "{{project_type}}"
|
||||
project_level: "{{project_level}}"
|
||||
selected_track: "{{selected_track}}"
|
||||
field_type: "{{field_type}}"
|
||||
workflow_path: "{{workflow_path_file}}"
|
||||
|
||||
|
||||
Reference in New Issue
Block a user