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
4f4b191e8f
research will use the web more, use system date to understand what the read current date is.
2025-11-01 00:14:41 -05:00
Brian Madison
a1be5d7292
rename deep research options for chatgpt
2025-10-31 19:43:13 -05:00
Brian Madison
1c9fcbb73b
shard doc uses npx command
2025-10-31 16:51:25 -05:00
Brian Madison
663b76a072
docs updates
2025-10-30 11:26:15 -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
6d7f42dbec
v6 greenfield quickstart guide
2025-10-29 22:39:13 -05:00
Brian Madison
fd620d0183
marked sm menu items as optional that are optional
2025-10-28 23:47:48 -05:00
Brian Madison
503a394218
party mode fix
2025-10-28 22:52:03 -05:00
Brian Madison
44bc96fadc
readme update
2025-10-28 22:27:23 -05:00
Brian Madison
7710d9941d
document-project moved out of phase 1 to right below workflows and documents updated to clarify its not a phase-0 but a prereq and also a post project tool to use.
2025-10-28 22:21:13 -05:00
Brian Madison
1c5b30f361
some v5 references lingered - change to v6
2025-10-28 20:32:08 -05:00
Brian Madison
d9c7980b1d
remove unused csv columns from cis
2025-10-28 19:17:44 -05:00
Brian Madison
ee58586f39
installer improvements
2025-10-28 12:47:45 -05:00
Brian Madison
ed3603f7b2
vast improvements to create story, review story, draft story checklist validation, sm menu items and dev agent menu items fixed
2025-10-28 10:03:19 -05:00
Brian Madison
0354d1ae45
story review was missing detailed instructions to review AC and task adherance.
2025-10-28 08:51:58 -05:00
Brian Madison
0dab278e7b
story-review renamed code-review and dev-agent performs this
2025-10-28 08:30:44 -05:00
Brian Madison
66c66f602d
all workflows can optionally run without a workflow
2025-10-27 23:51:22 -05:00
Brian Madison
7ad841964d
installer for bmm includes option to include game assets or not when adding to a project.
2025-10-27 22:38:34 -05:00
Brian Madison
f55e822338
brownfield guide draft
2025-10-27 21:18:55 -05:00
Brian Madison
334e24823a
doc updates
2025-10-26 23:25:48 -05:00
Brian Madison
b753fb293b
workflows tasks and tools can be configured wether they are able to be run standalone from agents with ide commands
2025-10-26 20:06:34 -05:00
Brian Madison
63ef5b7bc6
installer fixes
2025-10-26 19:38:38 -05:00
Brian Madison
1cb88728e8
installer fixes
2025-10-26 17:04:27 -05:00
Brian Madison
8d81edf847
install quick updates
2025-10-26 16:17:37 -05:00
Brian Madison
0067fb4880
path fixes, documentation updates, md-xplodr added to core tools
2025-10-26 15:40:43 -05:00
Cameron Pitt
8220c819e6
Add Opencode IDE installer ( #820 )
...
- Added docs/ide-info/opencode.md
- Added tool/cli/installers/lib/ide/opencode.js
- Modified tools/installers/lib/ide/core/detector.js to include
detection for opencode command dir
- Modified tools/cli/platform-codes.yaml to include opencode config
- Modified tools/cli/installers/lib/ide/workflow-command-template.md to
include frontmatter with description as opencode requires this for
commands and adding it to the template by default does not seem to
impact other IDEs
- Modified src/modules/bmm/workflows/workflow-status/workflow.yaml
description so that it properly escapes quotes when interpolated in the
teplate
2025-10-26 11:16:57 -05:00
Brian Madison
b7e6bfcde5
a few more instruction cleanup items
2025-10-25 23:57:27 -05:00
Brian Madison
bfd49faf2d
tech context improved
2025-10-25 23:29:41 -05:00
Brian Madison
52b8edb01d
phase 4 more workflow cleanup
2025-10-25 19:25:28 -05:00
Brian Madison
061b7d94c4
status normalization
2025-10-25 15:41:13 -05:00
Brian Madison
5762941321
better status loading and updating for phase 4
2025-10-25 14:26:30 -05:00
Brian Madison
994f251687
workflow phase 4 only has single sprint planning item in it now
2025-10-25 10:44:46 -05:00
Brian Madison
cf13e81dd5
sprint plan clearer comments
2025-10-25 00:30:49 -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
f37c960a4d
validation tasks added
2025-10-23 23:20:48 -05:00
Brian Madison
2d297c82da
fix create-design workflow path
2025-10-23 15:58:05 -05:00
Brian Madison
a175f46f1b
create-ux-design refactor
2025-10-23 14:20:13 -05:00
Brian Madison
44e09e4487
ux expert -> ux designer
2025-10-22 16:58:18 -05:00
Brian Madison
be5556bf42
checks checked
2025-10-22 15:40:51 -05:00
Brian Madison
be5b06f55e
check alignment
2025-10-22 12:36:39 -05:00
Brian Madison
c8776aa9ac
inline tag reference updtges
2025-10-21 23:48:35 -05:00
Brian Madison
ddaefa3284
use sprint plan for al workflow level 4 implementations
2025-10-21 23:03:46 -05:00
Brian Madison
abaa24513a
sprint status helpers, remove workflow integration from phase 4 items in prep of using sprint-planning status
2025-10-21 22:25:26 -05:00
Brian Madison
71330b6aac
updates to the paths
2025-10-21 20:37:59 -05:00
Brian Madison
949d818db8
sprint status story location relative
2025-10-21 18:41:40 -05:00
Brian Madison
1b1947d240
sprint-planning placeholder for future integration with jira linear and trello
2025-10-21 18:13:34 -05:00
Brian Madison
419043e704
sprint planning
2025-10-21 08:24:02 -05:00
Brian Madison
b8db0806ed
architecture name standardization
2025-10-20 19:01:18 -05:00
Jrakru
c2b3e797e7
fix(retrospective): align SM ownership in workflow paths and handoff ( #770 )
2025-10-20 07:19:11 -05:00
