3d4ea5ffd2
feat: add universal document sharding support with dual-strategy loading
...
Implement comprehensive document sharding system across all BMM workflows enabling 90%+ token savings for large multi-epic projects through selective loading optimization.
## Document Sharding System
### Core Features
- **Universal Support**: All 12 BMM workflows (Phase 1-4) handle both whole and sharded documents
- **Dual Loading Strategy**: Full Load (Phase 1-3) vs Selective Load (Phase 4)
- **Automatic Discovery**: Workflows detect format transparently (whole → sharded priority)
- **Efficiency Optimization**: 90%+ token reduction for 10+ epic projects in Phase 4
### Implementation Details
**Phase 1-3 Workflows (7 workflows) - Full Load Strategy:**
- product-brief, prd, gdd, create-ux-design, tech-spec, architecture, solutioning-gate-check
- Load entire sharded documents when present
- Transparent to user experience
- Better organization for large projects
**Phase 4 Workflows (5 workflows) - Selective Load Strategy:**
- sprint-planning (Full Load exception - needs all epics)
- epic-tech-context, create-story, story-context, code-review (Selective Load)
- Load ONLY the specific epic needed (e.g., epic-3.md for Epic 3 stories)
- Massive efficiency: Skip loading 9 other epics in 10-epic project
### Workflow Enhancements
**Added to all workflows:**
- `input_file_patterns` in workflow.yaml with wildcard discovery
- Document Discovery section in instructions.md
- Support for sharded index + section files
- Brownfield `docs/index.md` support
**Pattern standardization:**
```yaml
input_file_patterns:
document:
whole: "{output_folder}/*doc*.md"
sharded: "{output_folder}/*doc*/index.md"
sharded_single: "{output_folder}/*doc*/section-{{id}}.md" # Selective load
```
### Retrospective Workflow Major Overhaul
Transformed retrospective into immersive, interactive team experience:
**Epic Discovery Priority (Fixed):**
- Priority 1: Check sprint-status.yaml for last completed epic
- Priority 2: Ask user directly
- Priority 3: Scan stories folder (last resort)
**New Capabilities:**
- Deep story analysis: Extract dev notes, mistakes, review feedback, lessons learned
- Previous retro integration: Track action items, verify lessons applied
- Significant change detection: Alert when discoveries require epic updates
- Intent-based facilitation: Natural conversation vs scripted phrases
- Party mode protocol: Clear speaker identification (Name (Role): dialogue)
- Team dynamics: Drama, disagreements, diverse perspectives, authentic conflict
**Structure:**
- 12 whole-number steps (no decimals)
- Highly interactive with constant user engagement
- Cross-references previous retro for accountability
- Synthesizes patterns across all stories
- Detects architectural assumption changes
## Documentation
**Created:**
- `docs/document-sharding-guide.md` - Comprehensive 300+ line guide
- What is sharding, when to use it (token thresholds)
- How sharding works (discovery system, loading strategies)
- Using shard-doc tool
- Full Load vs Selective Load patterns
- Complete examples and troubleshooting
- Custom workflow integration patterns
**Updated:**
- `README.md` - Added Document Sharding feature section
- `docs/index.md` - Added under Advanced Topics → Optimization
- `src/modules/bmm/workflows/README.md` - Added sharding section with usage
- `src/modules/bmb/workflows/create-workflow/workflow-creation-guide.md` - Added complete implementation patterns for workflow builders
**Documentation levels:**
1. Overview (README.md) - Quick feature highlight
2. User guide (BMM workflows README) - Practical usage
3. Reference (document-sharding-guide.md) - Complete details
4. Builder guide (workflow-creation-guide.md) - Implementation patterns
## Efficiency Gains
**Example: 10-Epic Project**
Before sharding:
- epic-tech-context for Epic 3: Load all 10 epics (~50k tokens)
- create-story for Epic 3: Load all 10 epics (~50k tokens)
- story-context for Epic 3: Load all 10 epics (~50k tokens)
After sharding with selective load:
- epic-tech-context for Epic 3: Load Epic 3 only (~5k tokens) = 90% reduction
- create-story for Epic 3: Load Epic 3 only (~5k tokens) = 90% reduction
- story-context for Epic 3: Load Epic 3 only (~5k tokens) = 90% reduction
## Breaking Changes
None - fully backward compatible. Workflows work with existing whole documents.
## Files Changed
**Workflows Updated (25 files):**
- 7 Phase 1-3 workflows: Added full load sharding support
- 5 Phase 4 workflows: Added selective load sharding support
- 1 retrospective workflow: Complete overhaul with sharding support
**Documentation (5 files):**
- Created: document-sharding-guide.md
- Updated: README.md, docs/index.md, BMM workflows README, BMB workflow-creation-guide
- Removed: Old conversion report (obsolete)
## Future Extensibility
- BMB workflows now aware of sharding patterns
- Custom modules can easily implement sharding support
- Standard patterns documented for consistency
- No need to explain concept in future development
2025-11-02 00:13:33 -05:00
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
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
a1be5d7292
rename deep research options for chatgpt
2025-10-31 19:43:13 -05:00
663b76a072
docs updates
2025-10-30 11:26:15 -05:00
ec111972a0
some output should be improved and not run together in chat windows
2025-10-30 08:13:18 -05:00
6d7f42dbec
v6 greenfield quickstart guide
2025-10-29 22:39:13 -05:00
fd620d0183
marked sm menu items as optional that are optional
2025-10-28 23:47:48 -05:00
44bc96fadc
readme update
2025-10-28 22:27:23 -05:00
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
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
0354d1ae45
story review was missing detailed instructions to review AC and task adherance.
2025-10-28 08:51:58 -05:00
0dab278e7b
story-review renamed code-review and dev-agent performs this
2025-10-28 08:30:44 -05:00
66c66f602d
all workflows can optionally run without a workflow
2025-10-27 23:51:22 -05:00
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
f55e822338
brownfield guide draft
2025-10-27 21:18:55 -05:00
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
1cb88728e8
installer fixes
2025-10-26 17:04:27 -05:00
8d81edf847
install quick updates
2025-10-26 16:17:37 -05:00
0067fb4880
path fixes, documentation updates, md-xplodr added to core tools
2025-10-26 15:40:43 -05:00
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
b7e6bfcde5
a few more instruction cleanup items
2025-10-25 23:57:27 -05:00
bfd49faf2d
tech context improved
2025-10-25 23:29:41 -05:00
52b8edb01d
phase 4 more workflow cleanup
2025-10-25 19:25:28 -05:00
061b7d94c4
status normalization
2025-10-25 15:41:13 -05:00
5762941321
better status loading and updating for phase 4
2025-10-25 14:26:30 -05:00
994f251687
workflow phase 4 only has single sprint planning item in it now
2025-10-25 10:44:46 -05:00
cf13e81dd5
sprint plan clearer comments
2025-10-25 00:30:49 -05:00
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
f37c960a4d
validation tasks added
2025-10-23 23:20:48 -05:00
2d297c82da
fix create-design workflow path
2025-10-23 15:58:05 -05:00
a175f46f1b
create-ux-design refactor
2025-10-23 14:20:13 -05:00
44e09e4487
ux expert -> ux designer
2025-10-22 16:58:18 -05:00
be5556bf42
checks checked
2025-10-22 15:40:51 -05:00
ddaefa3284
use sprint plan for al workflow level 4 implementations
2025-10-21 23:03:46 -05:00
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
71330b6aac
updates to the paths
2025-10-21 20:37:59 -05:00
949d818db8
sprint status story location relative
2025-10-21 18:41:40 -05:00
1b1947d240
sprint-planning placeholder for future integration with jira linear and trello
2025-10-21 18:13:34 -05:00
419043e704
sprint planning
2025-10-21 08:24:02 -05:00
b8db0806ed
architecture name standardization
2025-10-20 19:01:18 -05:00
c2b3e797e7
fix(retrospective): align SM ownership in workflow paths and handoff ( #770 )
2025-10-20 07:19:11 -05:00
2a6eb71612
massive architecture creation overhaul
2025-10-19 23:28:38 -05:00
d3402c3132
architecture reorganization in preparation of architecture solutioning rework
2025-10-19 15:28:33 -05:00
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
a1fc8da03c
workflow init added to analyst pm and game agents
2025-10-18 01:34:03 -05:00
36231173d1
workflows consistent method to update status file
2025-10-17 23:44:43 -05:00
5788be64d0
installer temp updates
2025-10-17 22:42:36 -05:00
b54bb9e47d
workflow references to moved workflow status workflow
2025-10-17 22:34:21 -05:00
af8e296e6f
all phase 4 workflows use status check workflow update
2025-10-17 20:33:38 -05:00
e92f138f3d
doc output lang vs com lang
2025-10-17 19:46:25 -05:00
ffd354b605
arch alignment with workflows
2025-10-17 16:44:06 -05:00
9519eae666
workflow plan realignment
2025-10-17 00:44:05 -05:00
bc7d679366
workflow simplified
2025-10-17 00:19:45 -05:00
54985778f2
minor fixes
2025-10-16 21:50:50 -05:00
84a70d8331
reafactor: test arch audit ( #758 )
...
Co-authored-by: Murat Ozcan <murat@mac.lan>
2025-10-16 19:58:37 -05:00
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
790c4cedf4
remaining bmm workflows bloat removed
2025-10-16 08:58:09 -05:00
e77a1c036b
1-analysis workflow-state yaml streamlined
2025-10-16 08:26:26 -05:00
1fe405eb64
1-analysis intentionalized
2025-10-16 08:11:22 -05:00
516fa1a917
intent based workflow
2025-10-16 07:58:28 -05:00
a28a350e14
workflow builder understand existing_workflows tag for web bundles, and cleanup comtinues
2025-10-16 07:24:38 -05:00
72b6640f4b
workflow cleanup
2025-10-15 23:50:34 -05:00
f4b16bfacf
planning workflow alignment
2025-10-15 23:10:33 -05:00
b9b219a13b
prd cleanup
2025-10-15 21:17:09 -05:00
9b427a4e2b
planning tech spec cleanup
2025-10-14 20:20:55 -05:00
0f126b7f87
consolidated prd isntruction
2025-10-14 19:58:44 -05:00
4b6f34dff8
date removed from status file, status file renamed
2025-10-13 22:32:35 -05:00
27586e6a40
context should use relative paths
2025-10-13 21:11:20 -05:00
5eb410d622
update config re deprecated removed file
2025-10-13 19:29:19 -05:00
f1965810a6
adv elicitation project updated to hopefully not be skipped as optional anymore. further workflow updates.
2025-10-13 00:33:06 -05:00
36bf506241
all workflows aware
2025-10-12 22:19:28 -05:00
88989d5403
master workflow integration
2025-10-12 18:10:23 -05:00
c3c51945bb
docs update
2025-10-12 16:59:54 -05:00
79ac3c91fe
central source of trust for workflow status, current, and next story or epic
2025-10-12 16:14:29 -05:00
e61d58d480
workflow level 0 and 1 aligned with brownfield and quick dev
2025-10-12 15:53:24 -05:00
ab05cdcdd2
\split analyze workflow
2025-10-12 01:39:24 -05:00
2b736a8594
brownfield document project workflow added to analyst
2025-10-12 00:49:12 -05:00
4f16d368ac
minor dev agent updates
2025-10-11 19:45:25 -05:00
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
b62e169bac
adjusted workflow installed_path to proper bmm workflow folders ( #688 )
2025-10-07 16:07:30 -05:00
c9ffe202d5
feat(installer): default project name to directory ( #681 )
2025-10-05 22:12:37 -05:00
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
aefe72fd60
gdd updated
2025-10-04 22:52:38 -05:00
c7d76a3037
agent manifest generation, party mode uses it, and tea persona compression
2025-10-04 19:28:10 -05:00
bbb37a7a86
brainstorming moved to core workflows part 2
2025-10-04 19:02:29 -05:00
b6d8823d51
brainstorming moved to core workflows
2025-10-04 19:01:37 -05:00
9300ad1d71
subagaents updated with consistent return info and missing frontmatter where it was missing
2025-10-04 08:24:21 -05:00
a747017520
docs updated and agent standalone builder working now from the main install flow
2025-10-04 01:26:38 -05:00
9e8c7f3503
bundle agents front matter optimized, along with the orchestrators activation instructions;
2025-10-03 21:46:53 -05:00
5ac18cb55c
agent teams orchesatraion prompt improved
2025-10-03 19:08:34 -05:00
3f40ef4756
agent updates
2025-10-02 21:45:59 -05:00
c6704b4b6e
web bundles for team complete
2025-10-01 22:22:40 -05:00
f077a31aa0
docs updated
2025-10-01 18:29:08 -05:00
5f0a318bdf
feature: Added detailed epics file generation that was missing ( #669 )
2025-10-01 14:01:56 -05:00
25c3d50673
SubAgents in sub folders. installer improvements. BMM Flow document added
2025-10-01 09:12:21 -05:00
56e7a61bd3
v6 flow documented and subagent organization
2025-10-01 08:50:16 -05:00
05a3b4f3f1
hash file change checking integrated
2025-09-30 21:20:13 -05:00
df0c3e4bae
Port TEA commands into workflows and preload Murat knowledge ( #660 )
...
* Port TEA commands into workflows and preload Murat knowledge
* Broke the giant knowledge dump into curated fragments under src/modules/bmm/testarch/knowledge/
* Broke the giant knowledge dump into curated fragments under src/modules/bmm/testarch/knowledge/
* updated the web bunles for tea, and spot updates for analyst and sm
* Replaced the old TEA brief with an indexed knowledge system: the agent now loads topic-specific
docs from knowledge/ via tea-index.csv, workflows reference those fragments, and risk/level/
priority guidance lives in the new fragment files
---------
Co-authored-by: Murat Ozcan <murat@mac.lan>
2025-09-30 15:19:55 -05:00
30fb0e67e1
analyst command fix
2025-09-30 01:41:09 -05:00
e1fac26156
all agent bundles working
2025-09-30 01:38:39 -05:00
688a841127
missed a workflow update
2025-09-30 00:24:27 -05:00
c26220daec
installer and bundler progress
2025-09-30 00:24:27 -05:00
ae136ceb03
web_bundle info added to workflow yamls
2025-09-30 00:24:27 -05:00
9934224230
workflows indicate web_bundle file inclusions
2025-09-30 00:24:27 -05:00
24b3a42f85
docs: improved tea wording
2025-09-29 17:01:50 -05:00
bf24530ba6
docs: spot update test architect
2025-09-29 16:58:44 -05:00
9645a8ed0d
Docs/update test architect for brian ( #655 )
...
Update Docs for TestArch
---------
Co-authored-by: Murat Ozcan <murat@mac.lan>
2025-09-29 16:43:20 -05:00
0a6a3f3015
feat: v6.0.0-alpha.0 - the future is now
2025-09-28 23:17:07 -05:00
Brian Madison
Cameron Pitt
Jrakru
Murat K Ozcan
PinkyD
Alex Verkhovsky
Murat Ozcan