accae5d789
## Major Improvements
### 1. Elicitation System Modernization
- Removed legacy `<elicit-required />` tag from workflow.xml
- Replaced with direct `<invoke-task halt="true">{project-root}/bmad/core/tasks/adv-elicit.xml</invoke-task>` pattern
- More explicit, self-documenting, and eliminates indirection layer
- Added strategic elicitation points across all planning workflows:
- PRD: After success criteria, scope, functional requirements, and final review
- Create-Epics-And-Stories: After epic proposals and each epic's stories
- Architecture: After decisions, structure, patterns, implementation patterns, and final doc
- Updated audit-workflow tag scanner to remove obsolete elicit-required reference
### 2. Input Document Discovery Streamlined
- Replaced verbose 19-line "Input Document Discovery" sections with single critical tag
- New format: `<critical>Input documents specified in workflow.yaml input_file_patterns...</critical>`
- Eliminates duplication - workflow.yaml already defines patterns
- Updated across 6 workflows (PRD, create-epics-and-stories, architecture, tech-spec, UX, gate-check)
- Saved ~114 lines of repeated bloat
### 3. Scale System Migration (Levels 0-4 → 3 Tracks)
- Updated PRD workflow from "Level 0-4" to "Quick Flow / BMad Method / Enterprise Method"
- Changed `project_level` variable to `project_track`
- Removed `target_scale` variable (no longer needed)
- Updated workflow.yaml descriptions to reference tracks not levels
- Updated checklist from "Level 2" and "Level 3-4" to "BMad Method" and "Enterprise Method"
- Aligns with new scale-adaptive-system.md (3-track methodology)
### 4. Epic/Story Template Standardization
- Replaced hardcoded 8-epic template with clean repeating pattern using N/M variables
- Added BDD-style acceptance criteria (Given/When/Then/And)
- Removed instructional bloat from templates (moved to instructions.md where it belongs)
- Template shows OUTPUT structure, instructions show PROCESS
- Applied to both create-epics-and-stories and tech-spec workflows
- Templates now use HTML comments to indicate repeating sections
### 5. Workflow.yaml Pattern Consistency
- Standardized input_file_patterns across all workflows
- Separated `recommended_inputs` (semantic WHAT) from `input_file_patterns` (file discovery WHERE)
- Removed duplication between recommended_inputs file paths and input_file_patterns
- Create-epics-and-stories now uses proper whole/sharded pattern like architecture workflow
- Solutioning-gate-check cleaned up to use semantic descriptions not file paths
## Files Changed (18)
- Core: workflow.xml (removed elicit-required tag and references)
- Audit workflow: Updated tag pattern scanner
- PRD workflow: Elicitation points, track migration, input discovery
- Create-epics-and-stories: Template rebuild, BDD format, elicitation, input patterns
- Tech-spec: Template rebuild, BDD format, input discovery
- UX Design: Input discovery streamlined
- Architecture: Elicitation at 5 key decision points, input discovery
- Gate-check: Input pattern cleanup, input discovery
## Impact
- More consistent elicitation across workflows
- Cleaner, more maintainable templates
- Better separation of concerns (templates vs instructions)
- Aligned with v6 3-track scale system
- Reduced bloat and duplication significantly
|
||
|---|---|---|
| .. | ||
| agents | ||
| workflows | ||
| README.md | ||
| config.yaml | ||
README.md
BMB - BMad Builder Module
Specialized tools and workflows for creating, customizing, and extending BMad components including agents, workflows, and complete modules.
Table of Contents
Module Structure
🤖 Agents
BMad Builder - Master builder agent orchestrating all creation workflows with deep knowledge of BMad architecture and conventions.
📋 Workflows
Comprehensive suite for building and maintaining BMad components.
Core Workflows
Creation Workflows
create-agent - Build BMad agents
- Interactive persona development
- Command structure design
- YAML source compilation to .md
create-workflow - Design workflows
- Structured multi-step processes
- Configuration validation
- Web bundle support
create-module - Build complete modules
- Full module infrastructure
- Agent and workflow integration
- Installation automation
module-brief - Strategic planning
- Module blueprint creation
- Vision and architecture
- Comprehensive analysis
Editing Workflows
edit-agent - Modify existing agents
- Persona refinement
- Command updates
- Best practice compliance
edit-workflow - Update workflows
- Structure maintenance
- Configuration updates
- Documentation sync
edit-module - Module enhancement
- Component modifications
- Dependency management
- Version control
Maintenance Workflows
convert-legacy - Migration tool
- v4 to v6 conversion
- Structure compliance
- Convention updates
audit-workflow - Quality validation
- Structure verification
- Config standards check
- Bloat detection
- Web bundle completeness
redoc - Auto-documentation
- Reverse-tree approach
- Technical writer quality
- Convention compliance
Agent Types
BMB creates three agent architectures:
Full Module Agent
- Complete persona and role definition
- Command structure with fuzzy matching
- Workflow integration
- Module-specific capabilities
Hybrid Agent
- Shared core capabilities
- Module-specific extensions
- Cross-module compatibility
Standalone Agent
- Independent operation
- Minimal dependencies
- Specialized single purpose
Quick Start
- Load BMad Builder agent in your IDE
- Choose creation type:
*create-agent # New agent *create-workflow # New workflow *create-module # Complete module - Follow interactive prompts
Example: Creating an Agent
User: I need a code review agent
Builder: *create-agent
[Interactive session begins]
- Brainstorming phase (optional)
- Persona development
- Command structure
- Integration points
Use Cases
Custom Development Teams
Build specialized agents for:
- Domain expertise (legal, medical, finance)
- Company processes
- Tool integrations
- Automation tasks
Workflow Extensions
Create workflows for:
- Compliance requirements
- Quality gates
- Deployment pipelines
- Custom methodologies
Complete Solutions
Package modules for:
- Industry verticals
- Technology stacks
- Business processes
- Educational frameworks
Best Practices
- Study existing patterns - Review BMM/CIS implementations
- Follow conventions - Use established structures
- Document thoroughly - Clear instructions essential
- Test iteratively - Validate during creation
- Consider reusability - Build modular components
Integration
BMB components integrate with:
- BMad Core - Framework foundation
- BMM - Extend development capabilities
- CIS - Leverage creative workflows
- Custom Modules - Your domain solutions
Related Documentation
- Agent Creation Guide - Detailed instructions
- Module Structure - Architecture patterns
- BMM Module - Reference implementation
- Core Framework - Foundation concepts
BMB empowers you to extend BMad Method for your specific needs while maintaining framework consistency and power.