mirror of
https://github.com/bmadcode/BMAD-METHOD.git
synced 2025-12-29 16:14:59 +00:00
refactor: Major v6 epic creation improvements and documentation overhaul
## Key Changes ### 1. Epic Creation Workflow Enhancements - Added user-value focused epic structure principles (NO technical layer breakdown) - Implemented multi-mode detection: CONTINUE, REPLACE, or UPDATE existing epics - Added comprehensive anti-pattern examples showing wrong vs right epic breakdown - Epics now created AFTER architecture for technically-informed story breakdown - Added checkpoint protocol for interactive workflow progression ### 2. Removed Deprecated Solutioning Gate Check - Deleted entire solutioning-gate-check workflow (682 lines) - Replaced by new implementation-readiness workflow - Cleaner separation of concerns in solutioning phase ### 3. PRD Template Simplification - Removed hardcoded "Implementation Planning", "References", and "Next Steps" sections - PRD now focuses purely on requirements, not workflow orchestration - Epics/stories created as separate step after architecture ### 4. Documentation Overhaul (15+ docs updated) - Updated quick-start guide with v6 workflow sequence - Clarified that epics are created AFTER architecture, not during PRD - Updated solutioning docs to reflect implementation-readiness pattern - Improved agents-guide, brownfield-guide, enterprise docs - Enhanced glossary, FAQ, and workflow reference documentation ### 5. Workflow Path Adjustments - All 4 paths updated (enterprise/method × brownfield/greenfield) - Version bumps across BMGD, BMM, and CIS workflow YAMLs - Minor instruction file updates for consistency ### Files Changed - 65 files total: 468 insertions, 978 deletions (net reduction of 510 lines) - 4 files deleted (entire solutioning-gate-check workflow) - 1 new directory added (implementation-readiness placeholder)
This commit is contained in:
@@ -122,7 +122,7 @@ For v4 users or those who prefer to skip workflow-status guidance:
|
||||
|
||||
- **Analyst** → Brainstorming, Product Brief
|
||||
- **PM** → PRD (BMad Method/Enterprise tracks) OR tech-spec (Quick Flow track)
|
||||
- **UX-Designer** → UX Design Document (if UI-heavy)
|
||||
- **UX-Designer** → UX Design Document (if UI part of the project)
|
||||
- **Architect** → Architecture (BMad Method/Enterprise tracks)
|
||||
|
||||
#### Phase 2: Planning - Creating the PRD
|
||||
@@ -133,7 +133,6 @@ For v4 users or those who prefer to skip workflow-status guidance:
|
||||
2. Tell it to run the PRD workflow
|
||||
3. Once complete, you'll have:
|
||||
- **PRD.md** - Your Product Requirements Document
|
||||
- Epic breakdown
|
||||
|
||||
**For Quick Flow track:**
|
||||
|
||||
@@ -145,7 +144,7 @@ If your project has a user interface:
|
||||
|
||||
1. Load the **UX-Designer agent** in a new chat
|
||||
2. Tell it to run the UX design workflow
|
||||
3. After completion, run validations to ensure the Epics file stays updated
|
||||
3. After completion, you'll have your UX specification document
|
||||
|
||||
#### Phase 3: Architecture
|
||||
|
||||
@@ -153,14 +152,25 @@ If your project has a user interface:
|
||||
|
||||
1. Load the **Architect agent** in a new chat
|
||||
2. Tell it to run the create-architecture workflow
|
||||
3. After completion, run validations to ensure the Epics file stays updated
|
||||
3. After completion, you'll have your architecture document with technical decisions
|
||||
|
||||
#### Phase 3: Solutioning Gate Check (Highly Recommended)
|
||||
#### Phase 3: Create Epics and Stories (REQUIRED after Architecture)
|
||||
|
||||
Once architecture is complete:
|
||||
**V6 Improvement:** Epics and stories are now created AFTER architecture for better quality!
|
||||
|
||||
1. Load the **PM agent** in a new chat
|
||||
2. Tell it to run "create-epics-and-stories"
|
||||
3. This breaks down your PRD's FRs/NFRs into implementable epics and stories
|
||||
4. The workflow uses both PRD and Architecture to create technically-informed stories
|
||||
|
||||
**Why after architecture?** Architecture decisions (database, API patterns, tech stack) directly affect how stories should be broken down and sequenced.
|
||||
|
||||
#### Phase 3: Implementation Readiness Check (Highly Recommended)
|
||||
|
||||
Once epics and stories are created:
|
||||
|
||||
1. Load the **Architect agent** in a new chat
|
||||
2. Tell it to run "solutioning-gate-check"
|
||||
2. Tell it to run "implementation-readiness"
|
||||
3. This validates cohesion across all your planning documents (PRD, UX, Architecture, Epics)
|
||||
4. This was called the "PO Master Checklist" in v4
|
||||
|
||||
|
||||
Reference in New Issue
Block a user