Brian Madison
|
f77babcd5e
|
feat: major overhaul of BMM planning workflows with intent-driven discovery
This comprehensive update transforms the Product Brief and PRD workflows from rigid template-filling exercises into adaptive, context-aware discovery processes. Changes span workflow instructions, templates, agent configurations, and supporting infrastructure.
## Product Brief Workflow (96% audit compliance)
### Intent-Driven Facilitation
- Transform from linear Q&A to natural conversational discovery
- Adaptive questioning based on project context (hobby/startup/enterprise)
- Real-time document building instead of end-of-session generation
- Skill-level aware facilitation (expert/intermediate/beginner)
- Context detection from user responses to guide exploration depth
### Living Document Approach
- Continuous template updates throughout conversation
- Progressive refinement vs batch generation
- Template-output tags aligned with discovery flow
- Better variable mapping between instructions and template
### Enhanced Discovery Areas
- Problem exploration with context-appropriate probing
- Solution vision shaping based on user's mental model
- User understanding through storytelling vs demographics
- Success metrics tailored to project type
- Ruthless MVP scope management with feature prioritization
### Template Improvements
- Added context-aware conditional sections
- Better organization of optional vs required content
- Clearer structure for different project types
- Improved reference material handling
## PRD Workflow (improved from 65% to 85%+ compliance)
### Critical Fixes
- Add missing `date: system-generated` config variable
- Fix status file extension mismatch (.yaml not .md)
- Remove 38% bloat (unused technical_decisions variables)
- Add explicit template-output tags for runtime variables
### Scale-Adaptive Intelligence
- Project type detection (API/Web App/Mobile/SaaS/etc)
- Domain complexity mapping (14 domain types)
- Automatic requirement tailoring based on detected context
- CSV-driven project type and domain knowledge base
### Separated Epic Planning
- Move epic/story breakdown to dedicated child workflow
- Create create-epics-and-stories workflow for Phase 2
- Cleaner separation: PRD defines WHAT, epics define HOW
- Updated PM agent menu with new workflow triggers
### Enhanced Requirements Coverage
- Project-type specific requirement sections (endpoints, auth, platform)
- Domain-specific considerations (healthcare compliance, fintech security)
- UX principles with interaction patterns
- Non-functional requirements with integration needs
- Technical preferences capture
### Template Restructuring
- Separate PRD template from epic planning
- Context-aware conditional sections
- Better scale level indicators (L0-L4)
- Improved reference document handling
- Clearer success criteria sections
## Architecture Workflow Updates
### Template Enhancements
- Add domain complexity context support
- Better integration with PRD outputs
- Improved technical decision capture
- Enhanced system architecture sections
### Instruction Improvements
- Reference new domain-research workflow
- Better handling of PRD inputs
- Clearer architectural decision framework
## Agent Configuration Updates
### BMad Master Agent
- Fix workflow invocation instructions
- Better fuzzy matching guidance
- Clearer menu handler documentation
- Remove workflow invention warnings
### PM Agent
- Add create-prd trigger (renamed from 'prd')
- Add create-epics-and-stories workflow trigger
- Add validate-prd workflow trigger with checklist
- Better workflow status integration
### Game Designer Agent
- Rename triggers for consistency (create-game-brief, create-gdd)
- Align with PM agent naming conventions
## New Supporting Infrastructure
### Domain Research Workflow
- New discovery workflow for domain-specific research
- Complements product brief for complex domains
- Web research integration for domain insights
### Create Epics and Stories Workflow
- Dedicated epic/story breakdown process
- Separates planning (PRD) from decomposition
- Better Epic → Story → Task hierarchy
- Acceptance criteria generation
### Data Files
- project-types.csv: 12 project type definitions with requirements
- domain-complexity.csv: 14 domain types with complexity indicators
## Quality Improvements
### Validation & Compliance
- Product Brief: 96% BMAD v6 compliance (EXCELLENT rating)
- PRD: Improved from 65% to ~85% after critical fixes
- Zero bloat in Product Brief (0%)
- Reduced PRD bloat from 38% to ~15%
### Template Variable Mapping
- All template variables explicitly populated via template-output tags
- Runtime variables properly tracked
- Config variables consistently used
- Better separation of concerns
### Web Bundle Configuration
- Complete web_bundle sections for all workflows
- Proper child workflow references
- Data file inclusions (CSV files)
- Correct bmad/-relative paths
## Breaking Changes
### File Removals
- Delete src/modules/bmm/workflows/2-plan-workflows/prd/epics-template.md
(replaced by create-epics-and-stories child workflow)
### Workflow Trigger Changes
- PM agent: 'prd' → 'create-prd'
- PM agent: 'gdd' → 'create-gdd'
- New: 'create-epics-and-stories'
- New: 'validate-prd'
## Impact
This update significantly improves the BMM module's ability to:
- Adapt to different project types and scales
- Guide users through discovery naturally vs mechanically
- Generate higher quality planning documents
- Support complex domains with specialized knowledge
- Scale from Level 0 quick changes to Level 4 enterprise projects
The workflows now feel like collaborative discovery sessions with an expert consultant rather than form-filling exercises.
|
2025-11-01 19:37:20 -05:00 |
|
Brian Madison
|
ec111972a0
|
some output should be improved and not run together in chat windows
|
2025-10-30 08:13:18 -05:00 |
|
Brian Madison
|
66c66f602d
|
all workflows can optionally run without a workflow
|
2025-10-27 23:51:22 -05:00 |
|
Brian Madison
|
92bff333b1
|
plan-project gone, and all level 1-3 workflows are dynamic from the workflow in suggesting what is next
|
2025-10-24 23:16:08 -05:00 |
|
Brian Madison
|
b8db0806ed
|
architecture name standardization
|
2025-10-20 19:01:18 -05:00 |
|
Brian Madison
|
36231173d1
|
workflows consistent method to update status file
|
2025-10-17 23:44:43 -05:00 |
|
Brian Madison
|
b54bb9e47d
|
workflow references to moved workflow status workflow
|
2025-10-17 22:34:21 -05:00 |
|
Brian Madison
|
e92f138f3d
|
doc output lang vs com lang
|
2025-10-17 19:46:25 -05:00 |
|
Brian Madison
|
ffd354b605
|
arch alignment with workflows
|
2025-10-17 16:44:06 -05:00 |
|
Brian Madison
|
e77a1c036b
|
1-analysis workflow-state yaml streamlined
|
2025-10-16 08:26:26 -05:00 |
|
Brian Madison
|
f4b16bfacf
|
planning workflow alignment
|
2025-10-15 23:10:33 -05:00 |
|