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

## 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

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"