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
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
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
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
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
Brian Madison
2a6eb71612
massive architecture creation overhaul
2025-10-19 23:28:38 -05:00
Brian Madison
d3402c3132
architecture reorganization in preparation of architecture solutioning rework
2025-10-19 15:28:33 -05:00
Brian Madison
0a048f2ccc
installer updates, bmd module added and moved out of src, created a plan for module installation tool for custom modules, minor flow improvements
2025-10-19 11:59:27 -05:00
Brian Madison
a1fc8da03c
workflow init added to analyst pm and game agents
2025-10-18 01:34:03 -05:00
Brian Madison
36231173d1
workflows consistent method to update status file
2025-10-17 23:44:43 -05:00
Brian Madison
5788be64d0
installer temp updates
2025-10-17 22:42:36 -05:00
Brian Madison
b54bb9e47d
workflow references to moved workflow status workflow
2025-10-17 22:34:21 -05:00
Brian Madison
af8e296e6f
all phase 4 workflows use status check workflow update
2025-10-17 20:33:38 -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
9519eae666
workflow plan realignment
2025-10-17 00:44:05 -05:00
Brian Madison
bc7d679366
workflow simplified
2025-10-17 00:19:45 -05:00
Brian Madison
54985778f2
minor fixes
2025-10-16 21:50:50 -05:00
Murat K Ozcan
84a70d8331
reafactor: test arch audit ( #758 )
...
Co-authored-by: Murat Ozcan <murat@mac.lan>
2025-10-16 19:58:37 -05:00
Murat K Ozcan
bee9c5dce7
feat: migrate test architect entirely ( #750 )
...
* feat: migrate test architect entirely to v6
* format fixed
* feat: integrated new playwright mcp
---------
Co-authored-by: Murat Ozcan <murat@mac.lan>
2025-10-16 11:09:51 -05:00
Brian Madison
7f0e57e466
bmb updates
2025-10-16 09:50:29 -05:00
Brian Madison
790c4cedf4
remaining bmm workflows bloat removed
2025-10-16 08:58:09 -05:00
Brian Madison
e77a1c036b
1-analysis workflow-state yaml streamlined
2025-10-16 08:26:26 -05:00
Brian Madison
1fe405eb64
1-analysis intentionalized
2025-10-16 08:11:22 -05:00
Brian Madison
516fa1a917
intent based workflow
2025-10-16 07:58:28 -05:00
Brian Madison
a28a350e14
workflow builder understand existing_workflows tag for web bundles, and cleanup comtinues
2025-10-16 07:24:38 -05:00
Brian Madison
73ba7afa90
update additional location audit workflow
2025-10-16 00:15:18 -05:00
Brian Madison
fb5e40319f
added audit workflow worfklow
2025-10-16 00:09:19 -05:00
Brian Madison
72b6640f4b
workflow cleanup
2025-10-15 23:50:34 -05:00
Brian Madison
f4b16bfacf
planning workflow alignment
2025-10-15 23:10:33 -05:00
Brian Madison
b9b219a13b
prd cleanup
2025-10-15 21:17:09 -05:00
Brian Madison
9b427a4e2b
planning tech spec cleanup
2025-10-14 20:20:55 -05:00
Brian Madison
0f126b7f87
consolidated prd isntruction
2025-10-14 19:58:44 -05:00
Brian Madison
4b6f34dff8
date removed from status file, status file renamed
2025-10-13 22:32:35 -05:00
Brian Madison
27586e6a40
context should use relative paths
2025-10-13 21:11:20 -05:00
Brian Madison
5eb410d622
update config re deprecated removed file
2025-10-13 19:29:19 -05:00
Brian Madison
f1965810a6
adv elicitation project updated to hopefully not be skipped as optional anymore. further workflow updates.
2025-10-13 00:33:06 -05:00
Brian Madison
36bf506241
all workflows aware
2025-10-12 22:19:28 -05:00
Brian Madison
88989d5403
master workflow integration
2025-10-12 18:10:23 -05:00
Brian Madison
c3c51945bb
docs update
2025-10-12 16:59:54 -05:00
Brian Madison
79ac3c91fe
central source of trust for workflow status, current, and next story or epic
2025-10-12 16:14:29 -05:00
Brian Madison
e61d58d480
workflow level 0 and 1 aligned with brownfield and quick dev
2025-10-12 15:53:24 -05:00
Brian Madison
ab05cdcdd2
\split analyze workflow
2025-10-12 01:39:24 -05:00
Brian Madison
2b736a8594
brownfield document project workflow added to analyst
2025-10-12 00:49:12 -05:00
Brian Madison
4f16d368ac
minor dev agent updates
2025-10-11 19:45:25 -05:00
PinkyD
d76bcb5586
chore: cleaned up bad architecture file calls, legacy doc references, and case sensitivity issues to remove ambiguity ( #718 )
2025-10-10 09:26:49 -05:00
PinkyD
b62e169bac
adjusted workflow installed_path to proper bmm workflow folders ( #688 )
2025-10-07 16:07:30 -05:00
Alex Verkhovsky
c9ffe202d5
feat(installer): default project name to directory ( #681 )
2025-10-05 22:12:37 -05:00
Brian Madison
33d893bef2
workflows added to sub items in plan project phase. updated single action checks to be ifs on the action.
2025-10-05 11:32:45 -05:00
Brian Madison
aefe72fd60
gdd updated
2025-10-04 22:52:38 -05:00
Brian Madison
c632564849
finish move of brainstorming to the core
2025-10-04 19:33:34 -05:00
Brian Madison
c7d76a3037
agent manifest generation, party mode uses it, and tea persona compression
2025-10-04 19:28:10 -05:00
Brian Madison
bbb37a7a86
brainstorming moved to core workflows part 2
2025-10-04 19:02:29 -05:00
Brian Madison
b6d8823d51
brainstorming moved to core workflows
2025-10-04 19:01:37 -05:00
Brian Madison
e60d5cc42d
removed deprecated src_impact
2025-10-04 18:43:24 -05:00
Brian Madison
3147589d0f
bomb agent updates
2025-10-04 17:35:37 -05:00
Brian Madison
9300ad1d71
subagaents updated with consistent return info and missing frontmatter where it was missing
2025-10-04 08:24:21 -05:00
Brian Madison
a747017520
docs updated and agent standalone builder working now from the main install flow
2025-10-04 01:26:38 -05:00
Brian Madison
5ee4cf535c
BoMB updates
2025-10-04 00:22:59 -05:00