mirror of
https://github.com/bmadcode/BMAD-METHOD.git
synced 2025-12-29 16:14:59 +00:00
feat(workflows): Implement intelligent file discovery protocol and Phase 4 BMGD workflows
## Core Workflow Engine Enhancements
### discover_inputs Protocol (MAJOR)
- Added reusable `discover_inputs` protocol to workflow.xml for intelligent file loading
- Supports three loading strategies:
- FULL_LOAD: Load all shards for PRD, Architecture, UX (changed pattern from /index.md to /*/*.md)
- SELECTIVE_LOAD: Load specific shard via template variable (e.g., epic-{{epic_num}}.md)
- INDEX_GUIDED: Load index, analyze TOC, intelligently load relevant docs (with "DO NOT BE LAZY" mandate)
- Auto-discovers whole vs sharded documents with proper fallback
- Provides transparent reporting of loaded content with file counts
- Invoked via <invoke-protocol name="discover_inputs" /> tag in workflow instructions
### Advanced Elicitation Improvements
- Renamed adv-elicit.xml to advanced-elicitation.xml for clarity
- Updated all references across agents and commands
### Shard Document Tool Enhancement
- Added Step 6: Handle Original Document with three options:
- [d] Delete - Remove original (recommended, prevents confusion)
- [m] Move to archive - Backup original to archive folder
- [k] Keep - Warning about defeating sharding purpose
- Prevents issue where both whole and sharded versions exist, confusing discover_inputs protocol
## BMM Module - Input File Pattern Standardization
### Phase 1 - Analysis (1 workflow)
- product-brief: Added load_strategy (FULL_LOAD for research/brainstorming, INDEX_GUIDED for document_project)
- Updated instructions.md to use invoke-protocol, replaced manual fuzzy matching
### Phase 2 - Planning (4 workflows)
- prd: Added load_strategy, updated instructions to reference {product_brief_content}, {research_content}
- create-ux-design: Added load_strategy, removed fuzzy matching from instructions
- tech-spec: Added load_strategy for brownfield context discovery
- All epics patterns updated to support SELECTIVE_LOAD for specific epic shards
### Phase 3 - Solutioning (2 workflows)
- architecture: Added load_strategy, updated instructions to use pre-loaded {prd_content}, {epics_content}, {ux_design_content}
- solutioning-gate-check: Added load_strategy, replaced manual discovery with protocol invocation
### Phase 4 - Implementation (8 workflows)
- code-review: Added load_strategy, fixed sharded patterns to /*/*.md, added step 1.5 for protocol
- correct-course: Added complete input_file_patterns section (was missing), added step 0.5
- create-story: Added load_strategy, updated to SELECTIVE_LOAD for epics, added step 1.5
- dev-story: Added complete input_file_patterns section (was missing), added step 0.5
- epic-tech-context: Added load_strategy, updated PRD extraction to use {prd_content}, added step 1.5
- retrospective: Added load_strategy for architecture/prd (FULL_LOAD), epics (SELECTIVE_LOAD), added step 0.5
- sprint-planning: Fixed sharded pattern to load ALL epics (/*/*.md), added step 0.5
- story-context: Added load_strategy, updated doc collection to reference pre-loaded content, added step 1.5
### Sprint Artifacts Path Corrections
- story-done: Added missing sprint_artifacts variable, fixed sprint_status path from {context_dir} to {sprint_artifacts}
- story-ready: Added missing sprint_artifacts variable
- story-context: Fixed undefined {context_dir} -> {sprint_artifacts}
- correct-course: Added sprint_artifacts and sprint_status variables
## BMGD Module - Phase 4 Production Workflows (NEW)
Added complete Phase 4 implementation workflows for game development:
- code-review: Senior developer review for completed game features
- correct-course: Sprint change management for game projects
- create-story: Story generation for game mechanics/features
- dev-story: Feature implementation workflow
- epic-tech-context: Technical spec generation per game epic
- retrospective: Epic completion review and lessons learned
- sprint-planning: Game development sprint status tracking
- story-context: Dynamic context assembly for game stories
- story-done: Story completion workflow
- story-ready: Story readiness workflow
All BMGD workflows follow BMM patterns with game-specific adaptations.
## Agent Updates
### BMM Agents
- Updated all 7 BMM agents (analyst, architect, dev, pm, sm, tea, tech-writer, ux-designer)
- Standardized web bundle configurations
### BMGD Agents
- Updated 4 game development agents (game-architect, game-designer, game-dev, game-scrum-master)
- Aligned with BMM agent structure
### CIS Agents
- Updated 5 creative intelligence agents for consistency
## Documentation & Configuration
- Updated CHANGELOG.md with Phase 4 workflow additions
- Updated files-manifest.csv and task-manifest.csv
- Updated .claude commands for all agents
- Fixed formatting issues from previous commits
## Breaking Changes
NONE - All changes are backward compatible. Workflows without input_file_patterns continue to work.
Workflows with input_file_patterns now benefit from intelligent auto-loading.
## Migration Notes
Existing workflows can gradually adopt discover_inputs protocol by:
1. Adding load_strategy to existing input_file_patterns in workflow.yaml
2. Adding <invoke-protocol name="discover_inputs" /> step in instructions.md
3. Replacing manual file loading with references to {pattern_name_content} variables
This commit is contained in:
Brian Madison
279
CHANGELOG.md
279
CHANGELOG.md
@@ -2,6 +2,283 @@
|
||||
|
||||
## [Unreleased]
|
||||
|
||||
## [6.0.0-alpha.8]
|
||||
|
||||
**Release: November 9, 2025**
|
||||
|
||||
This alpha release focuses on installation flexibility, artifact organization, and comprehensive web bundle enhancements for better multi-agent collaboration.
|
||||
|
||||
### 🎯 Installation Path Enhancements
|
||||
|
||||
**Configurable Installation Directory:**
|
||||
|
||||
- Users can now specify custom installation directories during setup
|
||||
- Changed default installation to `.bmad` (hidden directory) for cleaner project organization
|
||||
- Reduces visual clutter in project root by hiding BMAD infrastructure files
|
||||
- VS Code settings updated to work with new `.bmad` directory structure
|
||||
|
||||
**Ephemeral File Handling:**
|
||||
|
||||
- Updated phase 4 implementation workflows to use ephemeral file locations
|
||||
- Better separation between documentation and implementation artifacts
|
||||
- Phase 4 items (stories, code review, sprint plan, context files) can now be stored outside docs folder
|
||||
- Installer includes questions for artifact path selection
|
||||
|
||||
### 🚀 CLI & Agent Loading Improvements
|
||||
|
||||
**Optimized Agent Loading:**
|
||||
|
||||
- CLI commands now load from installed agent files instead of maintaining duplicates
|
||||
- Eliminates duplication between source and installed agent definitions
|
||||
- Reduces maintenance burden and ensures consistency
|
||||
|
||||
**Installer UX Enhancements:**
|
||||
|
||||
- Enhanced installer interface with version display
|
||||
- Better visual feedback during installation process
|
||||
|
||||
### 🌐 Web Bundle Enhancements
|
||||
|
||||
**Party Mode Support:**
|
||||
|
||||
- All web bundles (single agent and team) now include party mode for multi-agent collaboration
|
||||
- Users can invoke multi-agent discussions from any bundled agent
|
||||
- Added default-party.csv files to bmm, bmgd, and cis modules with customizable party configurations
|
||||
|
||||
**Advanced Elicitation Integration:**
|
||||
|
||||
- Integrated advanced elicitation capabilities into standalone agents
|
||||
- All 39 elicitation methods now available in web bundles
|
||||
|
||||
**Expanded Agent Bundles:**
|
||||
|
||||
- New web bundle outputs for all agents: analyst, architect, dev, pm, sm, tea, tech-writer, ux-designer
|
||||
- Game development agents: game-designer, game-dev, game-architect, game-scrum-master
|
||||
- Creative Intelligence Suite agents fully bundled
|
||||
|
||||
**Team Customization:**
|
||||
|
||||
- Customizable party configurations per module
|
||||
- Users can define which agents participate in party mode discussions
|
||||
|
||||
### 🔧 Phase 4 Workflow Updates
|
||||
|
||||
**Artifact Separation (In Progress):**
|
||||
|
||||
- Initiated separation of phase 4 implementation artifacts from documentation
|
||||
- Dedicated artifact path for stories, code review, sprint plan, context files
|
||||
- Updated workflow.yaml files for:
|
||||
- code-review workflow
|
||||
- sprint-planning workflow
|
||||
- story-context workflow
|
||||
- epic-tech-context workflow
|
||||
- retrospective workflow
|
||||
- Configuration support added for artifact path selection during installation
|
||||
|
||||
### 🛠️ IDE Integration
|
||||
|
||||
**Gemini TOML:**
|
||||
|
||||
- Improved with clear loading instructions using @ commands
|
||||
- Better documentation for Gemini CLI users
|
||||
|
||||
**Agent Launcher Templates:**
|
||||
|
||||
- Agent launcher markdown files now use centralized critical indication templates
|
||||
- Improved consistency across IDE configurations
|
||||
|
||||
**GitHub Copilot:**
|
||||
|
||||
- Updated tool names to match official VS Code documentation (November 2025)
|
||||
- Better integration with latest Copilot features
|
||||
|
||||
### 🐛 Bug Fixes
|
||||
|
||||
- Fixed duplicate manifest entries by deduplicating module lists using Set
|
||||
- Cleaned up legacy `bmad/`, `bmd/`, and `web-bundles/` directories on installation
|
||||
- Various improvements to phase 4 workflow artifact handling
|
||||
- Better error handling in web bundler
|
||||
|
||||
### 📦 Infrastructure Changes
|
||||
|
||||
- New agent and action command header models for standardization
|
||||
- Enhanced web-bundle-activation-steps fragment
|
||||
- Updated web-bundler.js to support new structure
|
||||
- Improved party mode instructions and workflow orchestration
|
||||
|
||||
### 📊 Impact Summary
|
||||
|
||||
This release brings significant improvements to installation flexibility and multi-agent collaboration:
|
||||
|
||||
- **Flexibility:** Configurable installation paths for different project preferences
|
||||
- **Organization:** Cleaner project structure with hidden `.bmad` directory
|
||||
- **Collaboration:** Comprehensive party mode support in all web bundles
|
||||
- **Consistency:** Optimized agent loading eliminates duplication
|
||||
- **Artifact Management:** Better separation of documentation vs implementation artifacts
|
||||
|
||||
---
|
||||
|
||||
## [6.0.0-alpha.7]
|
||||
|
||||
**Release: November 7, 2025**
|
||||
|
||||
This alpha release focuses on web bundle improvements, module extraction, and enhanced workflow vendoring capabilities.
|
||||
|
||||
### 🌐 Web Bundler Improvements
|
||||
|
||||
**Workflow Vendoring:**
|
||||
|
||||
- Web bundler now performs workflow vendoring before bundling agents
|
||||
- Workflows referenced via `workflow-install` attributes are automatically copied from source to destination
|
||||
- Similar to module installer behavior, ensuring consistency
|
||||
- Config_source is updated in vendored workflows to reference target module
|
||||
- Fixes missing dependency warnings for cross-module workflow references
|
||||
|
||||
**Enhanced Dependency Resolution:**
|
||||
|
||||
- Improved workflow dependency detection and bundling
|
||||
- Better handling of workflows with `web_bundle: false` flag
|
||||
- Menu items for non-web workflows are now properly excluded from bundles
|
||||
- Shows positive "✓ No missing dependencies" message when all dependencies resolved
|
||||
|
||||
**Advanced Elicitation Fix:**
|
||||
|
||||
- Added missing `adv-elicit-methods.csv` to workflow bundles
|
||||
- Includes CSV in all workflows using `adv-elicit.xml`:
|
||||
- architecture workflow
|
||||
- prd workflow
|
||||
- tech-spec workflow
|
||||
- Fixes runtime failures when advanced elicitation is invoked in bundled workflows
|
||||
|
||||
### 🎮 BMGD Module Extraction
|
||||
|
||||
**Game Development Module:**
|
||||
|
||||
- Extracted game development functionality from BMM into standalone BMGD module
|
||||
- Moved agents: game-designer, game-dev, game-architect from BMM to BMGD
|
||||
- Moved team config: team-gamedev
|
||||
- Created new Game Dev Scrum Master agent using workflow vendoring pattern
|
||||
|
||||
**Reorganized Game Dev Workflows:**
|
||||
|
||||
Industry-standard game development phases:
|
||||
|
||||
- **Phase 1 (Preproduction):** brainstorm-game, game-brief
|
||||
- **Phase 2 (Design):** gdd (Game Design Document), narrative
|
||||
- **Phase 3 (Technical):** game-architecture
|
||||
- **Phase 4 (Production):** Vendors BMM workflows (dev-story, code-review, sprint-planning, etc.)
|
||||
|
||||
**Workflow Vendoring Implementation:**
|
||||
|
||||
- Game Dev SM agent uses `workflow-install` to vendor BMM phase 4 workflows
|
||||
- Enables module independence while sharing proven workflows
|
||||
- Sets pattern for future module extractions and specializations
|
||||
|
||||
### 🔧 IDE Installation Improvements
|
||||
|
||||
**Claude Code Fix:**
|
||||
|
||||
- Fixed regression preventing README file slash commands from installing
|
||||
- Cleaned up bmad folders in tools directory on installation
|
||||
- Better handling of IDE-specific configuration files
|
||||
|
||||
### 📚 Documentation Updates
|
||||
|
||||
**TEA Agent Documentation:**
|
||||
|
||||
- Updated Test Architect documentation to align with BMad 4-phase methodology
|
||||
- Better integration with overall workflow structure
|
||||
- Clearer role definitions and responsibilities
|
||||
|
||||
**Diagram Improvements:**
|
||||
|
||||
- More visual documentation updates
|
||||
- Enhanced Mermaid diagram drafts
|
||||
- Better workflow visualization
|
||||
|
||||
### 🐛 Bug Fixes
|
||||
|
||||
- Fixed missing `adv-elicit-methods.csv` in workflow bundles
|
||||
- Removed menu items for workflows with `web_bundle: false`
|
||||
- Fixed IDE installation regression for Claude Code README commands
|
||||
- Improved workflow vendoring dependency resolution
|
||||
|
||||
### 🔄 Breaking Changes
|
||||
|
||||
**Module Structure:**
|
||||
|
||||
- Game development functionality moved from BMM to BMGD module
|
||||
- Existing projects using game dev agents should reinstall to get new module structure
|
||||
- No functional changes - agents work the same way in new location
|
||||
|
||||
### 📊 Impact Summary
|
||||
|
||||
This release establishes better module organization and cross-module workflow sharing:
|
||||
|
||||
- **Modularity:** BMGD extraction demonstrates clean module separation pattern
|
||||
- **Reusability:** Workflow vendoring enables sharing proven workflows across modules
|
||||
- **Reliability:** Advanced elicitation now works correctly in all web bundles
|
||||
- **Flexibility:** Modules can be specialized while leveraging core workflows
|
||||
|
||||
---
|
||||
|
||||
## [6.0.0-alpha.6]
|
||||
|
||||
**Release: November 4, 2025**
|
||||
|
||||
This alpha release focuses on installation flexibility, improved UX, and bug fixes for the installer system.
|
||||
|
||||
### 🐛 Bug Fixes
|
||||
|
||||
**Installer Fixes:**
|
||||
|
||||
- Fixed manifestPath error in ide-config-manager causing installation failures
|
||||
- Fixed installer option display to show full labels instead of just values for single/multi-select
|
||||
- Better error handling during installation process
|
||||
|
||||
**Documentation Installation:**
|
||||
|
||||
- Add conditional documentation installation feature
|
||||
- Users can now opt out of installing docs to reduce installation footprint
|
||||
- New `install_user_docs` configuration option (defaults to true)
|
||||
- Useful for production environments or users who prefer online documentation
|
||||
|
||||
### 🎨 User Experience Improvements
|
||||
|
||||
**Installer UX:**
|
||||
|
||||
- Improved config question display with descriptive labels
|
||||
- Better formatting for single and multi-select options
|
||||
- Clearer feedback during installation process
|
||||
- More intuitive option selection
|
||||
|
||||
### 📖 Documentation Updates
|
||||
|
||||
**Contributing Guidelines:**
|
||||
|
||||
- Updated CONTRIBUTING.md to remove references to non-existent 'next' branch
|
||||
- Clearer contribution workflow instructions
|
||||
- Better alignment with actual repository structure
|
||||
|
||||
### 🧹 Maintenance
|
||||
|
||||
**Issue Tracker Cleanup:**
|
||||
|
||||
- Closed 54 legacy v4 issues (older than 1 month)
|
||||
- Maintains clean issue tracker focused on v6 development
|
||||
- Improved issue management and prioritization
|
||||
|
||||
### 📊 Impact Summary
|
||||
|
||||
This release improves installation reliability and user experience:
|
||||
|
||||
- **Reliability:** Fixed critical installer bugs preventing successful installations
|
||||
- **Flexibility:** Optional documentation installation for different use cases
|
||||
- **Clarity:** Better UX with descriptive labels and clearer feedback
|
||||
- **Maintenance:** Clean issue tracker focused on current development
|
||||
|
||||
---
|
||||
|
||||
## [6.0.0-alpha.5]
|
||||
|
||||
**Release: November 4, 2025**
|
||||
@@ -43,7 +320,7 @@ Users now choose development approach based on **project needs and team preferen
|
||||
**1. Elicitation System Modernization:**
|
||||
|
||||
- Removed legacy `<elicit-required />` XML tag from core workflow.xml
|
||||
- Replaced with explicit `<invoke-task halt="true">adv-elicit.xml</invoke-task>` pattern
|
||||
- Replaced with explicit `<invoke-task halt="true">advanced-elicitation.xml</invoke-task>` pattern
|
||||
- More self-documenting and eliminates confusing indirection layer
|
||||
- Added strategic elicitation points across all planning workflows:
|
||||
- **PRD:** After success criteria, scope, functional requirements, and final review
|
||||
|
||||
Reference in New Issue
Block a user