External/BMAD-METHOD
1
0
Fork 0
mirror of https://github.com/bmadcode/BMAD-METHOD.git synced 2025-12-29 16:14:59 +00:00
Code Issues Packages Projects Releases Wiki Activity

refactor: Major workflow enhancements - time estimates prohibition, progressive epic creation, and workflow simplification

Browse Source 
## Key Changes

### 1. Time Estimate Prohibition (All Modules)
- Added critical warnings against providing ANY time estimates (hours/days/weeks/months)
- Acknowledges AI has fundamentally changed development speed
- Applied to 33 workflow instruction files across BMB, BMGD, BMM, and CIS modules
- Updated workflow creation guide with prohibition guidelines

### 2. Enhanced Epic Creation Workflow
- Added intelligent UPDATE vs CREATE mode detection
- Detects available context (UX, Architecture, Domain brief, Product brief)
- Progressive enhancement: creates basic epics, then enriches with UX/Architecture
- Living document approach with continuous updates
- Added 305 lines of sophisticated workflow logic

### 3. Workflow Status Initialization Refactoring
- Simplified from 893 to 318 lines (65% reduction)
- Streamlined state detection: CLEAN, PLANNING, ACTIVE, LEGACY, UNCLEAR
- Cleaner path selection and initialization logic
- Removed redundant complexity while maintaining functionality

### 4. Workflow Path Updates
- Updated all 4 workflow paths (enterprise/method × brownfield/greenfield)
- Added multiple optional epic creation steps at different phases:
  - After PRD (basic structure)
  - After UX Design (with interaction context)
  - After Architecture (final with full context)
- Changed PRD output description from "with epics and stories" to "with FRs and NFRs"

### 5. Architecture & Innovation Updates
- Made epics input optional in architecture workflow (falls back to PRD FRs)
- Updated innovation strategy phases to remove time-based language
- Phases now: Immediate Impact → Foundation Building → Scale & Optimization

### Files Changed
- 33 instruction files updated with time estimate prohibition
- 2 workflow.yaml files updated (create-epics-and-stories, architecture)
- 4 workflow path YAML files updated
- 1 workflow creation guide enhanced

This refactor significantly improves workflow intelligence, removes harmful time-based planning assumptions, and creates more adaptive, context-aware workflows that better leverage AI capabilities.
This commit is contained in:
Brian Madison
2025-11-14 23:54:29 -06:00
parent 3223975fd0
commit f14014f0c7
33 changed files with 839 additions and 888 deletions
Download Patch File Download Diff File Expand all files Collapse all files

979
src/modules/bmm/workflows/workflow-status/init/instructions.md
View File

File diff suppressed because it is too large Load Diff

1
src/modules/bmm/workflows/workflow-status/instructions.md
View File

@@ -4,6 +4,7 @@
<critical>You MUST have already loaded and processed: {project-root}/{bmad_folder}/bmm/workflows/workflow-status/workflow.yaml</critical>
<critical>This workflow operates in multiple modes: interactive (default), validate, data, init-check, update</critical>
<critical>Other workflows can call this as a service to avoid duplicating status logic</critical>
<critical>⚠️ ABSOLUTELY NO TIME ESTIMATES - NEVER mention hours, days, weeks, months, or ANY time-based predictions. AI has fundamentally changed development speed - what once took teams weeks/months can now be done by one person in hours. DO NOT give ANY time estimates whatsoever.</critical>
<workflow>

20
src/modules/bmm/workflows/workflow-status/paths/enterprise-brownfield.yaml
View File

@@ -60,12 +60,24 @@ phases:
agent: "pm"
command: "validate-prd"
- id: "create-epics-and-stories"
optional: true
agent: "pm"
command: "create-epics-and-stories"
note: "Optional: Create epic breakdown early (basic structure only)"
- id: "create-design"
recommended: true
agent: "ux-designer"
command: "create-design"
note: "Recommended - must integrate with existing UX patterns"
- id: "create-epics-and-stories-after-ux"
optional: true
agent: "pm"
command: "create-epics-and-stories"
note: "Optional: Create epic breakdown with UX context"
- phase: 2
name: "Solutioning"
required: true
@@ -103,11 +115,17 @@ phases:
agent: "architect"
command: "validate-architecture"
- id: "create-epics-and-stories-final"
required: true
agent: "pm"
command: "create-epics-and-stories"
note: "Required: Create final epic breakdown with full context (PRD + UX + Architecture)"
- id: "solutioning-gate-check"
required: true
agent: "architect"
command: "solutioning-gate-check"
note: "Critical gate - validates all planning before touching production system"
note: "Critical gate - validates all planning + Epics before touching production system"
- phase: 3
name: "Implementation"

44
src/modules/bmm/workflows/workflow-status/paths/enterprise-greenfield.yaml
View File

@@ -48,12 +48,24 @@ phases:
agent: "pm"
command: "validate-prd"
- id: "create-epics-and-stories"
optional: true
agent: "pm"
command: "create-epics-and-stories"
note: "Optional: Create epic breakdown early (basic structure only)"
- id: "create-design"
recommended: true
agent: "ux-designer"
command: "create-design"
note: "Highly recommended for enterprise - design system and patterns"
- id: "create-epics-and-stories-after-ux"
optional: true
agent: "pm"
command: "create-epics-and-stories"
note: "Optional: Create epic breakdown with UX context"
- phase: 2
name: "Solutioning"
required: true
@@ -72,30 +84,36 @@ phases:
output: "System-level testability review"
note: "Enterprise requires testability validation - auto-detects system-level mode"
- id: "create-security-architecture"
optional: true
agent: "architect"
command: "create-security-architecture"
output: "Security architecture and threat model"
note: "Future workflow - optional extended enterprise workflow for security design, auth, compliance"
# - id: "create-security-architecture"
# optional: true
# agent: "architect"
# command: "create-security-architecture"
# output: "Security architecture and threat model"
# note: "Future workflow - optional extended enterprise workflow for security design, auth, compliance"
- id: "create-devops-strategy"
optional: true
agent: "architect"
command: "create-devops-strategy"
output: "DevOps pipeline and infrastructure plan"
note: "Future workflow - optional extended enterprise workflow for CI/CD, deployment, monitoring"
# - id: "create-devops-strategy"
# optional: true
# agent: "architect"
# command: "create-devops-strategy"
# output: "DevOps pipeline and infrastructure plan"
# note: "Future workflow - optional extended enterprise workflow for CI/CD, deployment, monitoring"
- id: "validate-architecture"
recommended: true
agent: "architect"
command: "validate-architecture"
- id: "create-epics-and-stories-final"
required: true
agent: "pm"
command: "create-epics-and-stories"
note: "Required: Create final epic breakdown with full context (PRD + UX + Architecture)"
- id: "solutioning-gate-check"
required: true
agent: "architect"
command: "solutioning-gate-check"
note: "Validates all planning artifacts + testability align before implementation"
note: "Validates all planning artifacts + Epics + testability align before implementation"
- phase: 3
name: "Implementation"

20
src/modules/bmm/workflows/workflow-status/paths/method-brownfield.yaml
View File

@@ -59,11 +59,23 @@ phases:
agent: "pm"
command: "validate-prd"
- id: "create-epics-and-stories"
optional: true
agent: "pm"
command: "create-epics-and-stories"
note: "Optional: Create epic breakdown early (basic structure only)"
- id: "create-design"
conditional: "if_has_ui"
agent: "ux-designer"
command: "create-design"
- id: "create-epics-and-stories-after-ux"
optional: true
agent: "pm"
command: "create-epics-and-stories"
note: "Optional: Create epic breakdown with UX context"
- phase: 2
name: "Solutioning"
required: true
@@ -75,6 +87,12 @@ phases:
output: "Integration architecture - solution design for THIS project"
note: "HIGHLY RECOMMENDED: Distills massive brownfield context into focused solution design. Prevents agent confusion."
- id: "create-epics-and-stories-final"
required: true
agent: "pm"
command: "create-epics-and-stories"
note: "Required: Create final epic breakdown with full context (PRD + UX + Architecture)"
- id: "test-design"
recommended: true
agent: "tea"
@@ -91,7 +109,7 @@ phases:
required: true
agent: "architect"
command: "solutioning-gate-check"
note: "Validates PRD + UX + Architecture (if created) cohesion"
note: "Validates PRD + UX + Architecture + Epics (if created) cohesion"
- phase: 3
name: "Implementation"

22
src/modules/bmm/workflows/workflow-status/paths/method-greenfield.yaml
View File

@@ -40,7 +40,7 @@ phases:
required: true
agent: "pm"
command: "prd"
output: "Product Requirements Document with epics and stories"
output: "Product Requirements Document with FRs and NFRs"
- id: "validate-prd"
optional: true
@@ -48,12 +48,24 @@ phases:
command: "validate-prd"
note: "Quality check for PRD completeness"
- id: "create-epics-and-stories"
optional: true
agent: "pm"
command: "create-epics-and-stories"
note: "Optional: Create epic breakdown early (basic structure only)"
- id: "create-design"
conditional: "if_has_ui"
agent: "ux-designer"
command: "create-design"
note: "Determined after PRD - user/agent decides if needed"
- id: "create-epics-and-stories-after-ux"
optional: true
agent: "pm"
command: "create-epics-and-stories"
note: "Optional: Create epic breakdown with UX context"
- phase: 2
name: "Solutioning"
required: true
@@ -65,6 +77,12 @@ phases:
output: "System architecture document"
note: "Complete system design for greenfield projects"
- id: "create-epics-and-stories-final"
required: true
agent: "pm"
command: "create-epics-and-stories"
note: "Required: Create final epic breakdown with full context (PRD + UX + Architecture)"
- id: "test-design"
recommended: true
agent: "tea"
@@ -82,7 +100,7 @@ phases:
required: true
agent: "architect"
command: "solutioning-gate-check"
note: "Validates PRD + UX + Architecture + Testability cohesion before implementation"
note: "Validates PRD + UX + Architecture + Epics + Testability cohesion before implementation"
- phase: 3
name: "Implementation"