This commit introduces major enhancements to the BMAD framework, focusing on
continuous context management, architectural decision recording, and agile
sprint execution.
## Major Additions
### Memory Bank Pattern Integration
- Added session-kickoff task for consistent agent initialization
- Updated all agents to include Memory Bank awareness
- Created session-kickoff-checklist.md for validation
- Enhanced all templates with Memory Bank cross-references
- Integrated Memory Bank updates into workflow handoffs
### Architectural Decision Records (ADRs)
- Added ADR triggers and patterns to data files
- Updated architect agent with ADR creation responsibilities
- Enhanced templates to reference ADR documentation
- Created ADR-aware checklists for architectural reviews
### Sprint Ceremonies & Reviews
- Added conduct-sprint-review task
- Created sprint-review-checklist.md
- Added sprint-planning-tmpl.yaml and sprint-review-tmpl.yaml
- Updated PM and SM agents with sprint review capabilities
- Added sprint-review-triggers.md for automation
### Development Journals
- Enhanced dev journal template with sprint cross-references
- Updated create-dev-journal task with Memory Bank integration
- Added sprint-end journal documentation requirements
### Technical Principles & Standards
- Added twelve-factor-principles.md
- Added microservice-patterns.md
- Added coding-standards.md
- Created project-scaffolding-preference.md from generic rules
- Updated technical-preferences.md with cloud-native patterns
### New Workflows
- sprint-execution.yaml - End-to-end sprint workflow
- documentation-update.yaml - Documentation maintenance
- technical-debt.yaml - Debt reduction workflow
- performance-optimization.yaml - Performance improvement
- system-migration.yaml - Legacy system migration
- quick-fix.yaml - Rapid issue resolution
## Framework-Wide Updates
### Agent Enhancements
- All agents updated with new checklist dependencies
- Added data file dependencies for technical standards
- Enhanced startup instructions with context awareness
- Improved handoff protocols between agents
### Template Improvements
- All templates updated with Memory Bank sections
- Added LLM instructions for AI-specific guidance
- Enhanced YAML templates with new validation rules
- Improved cross-referencing between documents
### Checklist Updates
- Updated all existing checklists with new sections
- Added Memory Bank verification steps
- Enhanced validation criteria
- Added sprint-specific checkpoints
### Data Files
- Reorganized and enhanced all data files
- Added new reference documents for standards
- Updated bmad-kb.md with comprehensive documentation
- Added elicitation method improvements
### Expansion Pack Updates
- Updated all expansion pack templates
- Added Memory Bank awareness to game dev packs
- Enhanced infrastructure DevOps templates
## Technical Improvements
### Tools & Build System
- Updated all tool files with latest patterns
- Enhanced web builder for new file types
- Improved dependency resolution
- Updated IDE configurations
### Cleanup
- Removed tmp/ directory with obsolete rules
- Consolidated rules into framework data files
- Added megalinter-reports/ to .gitignore
## Breaking Changes
None - all changes are backward compatible
## Testing
- All file modifications validated
- Dependencies verified across framework
- Installation process tested
This represents a major evolution of the BMAD framework, providing
comprehensive support for continuous context management, architectural
decision tracking, and agile sprint execution while maintaining full
backward compatibility.
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
Converted dev-journal-tmpl.md to dev-journal-tmpl.yaml for consistency with
BMAD framework template standards and improved functionality.
YAML Template Features:
- Guided workflow with structured prompting system
- Comprehensive sections for session documentation
- Template variables for dynamic content generation
- Validation rules for required fields
- Output configuration for docs/devJournal/ directory
- Consistent with other YAML templates in framework
Updated References:
- dev.md agent updated to use dev-journal-tmpl.yaml
- create-dev-journal.md task updated to reference YAML template
This completes the conversion of all framework templates to YAML format,
ensuring consistency and leveraging the full BMAD template system capabilities.
Consolidated duplicate project brief templates into a unified solution that supports
multiple workflow modes, and moved all Memory Bank templates to base templates folder.
Template Consolidation:
- Merged project-brief-tmpl.yaml and projectbrief-tmpl.yaml into unified template
- Created mode-based template supporting 3 workflows:
* Comprehensive Mode: Full product development brief with elicitation
* Memory Bank Mode: Foundation document for Memory Bank system
* Rapid Mode: Quick project documentation with structured prompts
- Maintains backward compatibility while eliminating duplication
Template Organization:
- Moved all Memory Bank templates from memory-bank/ to base templates/ folder
- Updated all agents to include Memory Bank templates in dependencies
- Simplified template structure and references across framework
Updated Components:
- architect.md: Added all Memory Bank templates to dependencies
- dev.md: Added activeContext and progress templates
- po.md: Added relevant Memory Bank templates for requirements management
- initialize-memory-bank.md: Updated template references and added usage notes
Benefits:
- Single source of truth for project brief creation
- Flexible workflow support for different use cases
- Simplified template management and discovery
- Consistent framework organization
- Better integration between standalone and Memory Bank workflows
Converted all Memory Bank templates and ADR template from Markdown to YAML format
for consistency with BMAD framework template standards.
Template Conversions:
- projectbrief-tmpl.md → projectbrief-tmpl.yaml
- productContext-tmpl.md → productContext-tmpl.yaml
- systemPatterns-tmpl.md → systemPatterns-tmpl.yaml
- techContext-tmpl.md → techContext-tmpl.yaml
- activeContext-tmpl.md → activeContext-tmpl.yaml
- progress-tmpl.md → progress-tmpl.yaml
- adr-tmpl.md → adr-tmpl.yaml
YAML Template Features:
- Structured workflow definitions with guided/interactive modes
- Comprehensive prompting system for elicitation
- Section-based organization with clear instructions
- Output format configuration (markdown files in docs/memory-bank/)
- Validation rules for required fields
- Template variable system with Handlebars-style syntax
Updated References:
- initialize-memory-bank.md task updated to reference YAML templates
- create-adr.md task updated to reference YAML ADR template
- architect.md agent updated to use adr-tmpl.yaml
This maintains the same output structure while providing the structured,
interactive template experience consistent with other BMAD framework templates.
Implemented Cline-inspired Memory Bank pattern for AI context persistence across sessions.
This ensures continuity and deep understanding of projects even when AI memory resets.
Core Memory Bank Components:
- Created 6 core memory bank templates following hierarchical structure
- projectbrief.md: Foundation document with project scope and goals
- productContext.md: The 'why' behind the project
- systemPatterns.md: Technical architecture and decisions
- techContext.md: Technology stack and environment
- activeContext.md: Current work focus and priorities
- progress.md: Project state tracking and evolution
Tasks and Workflows:
- initialize-memory-bank.md: Creates initial Memory Bank structure
- update-memory-bank.md: Updates based on dev journals, ADRs, and changes
- memory-bank-triggers.md: Reference guide for when to update
Agent Integrations:
- Enhanced architect agent with Memory Bank awareness and commands
- Enhanced dev agent to update activeContext and progress
- Enhanced po agent for requirements alignment with Memory Bank
- All agents now read Memory Bank at session start
Pervasive Integration Strategy:
- ADR creation triggers systemPatterns updates
- Dev journal entries trigger activeContext updates
- Story completion triggers progress updates
- Comprehensive commits/PRs trigger relevant updates
- Document-project task integrates with Memory Bank initialization
This provides AI agents with persistent context across sessions, preventing
loss of project knowledge and ensuring consistent understanding.
- Created create-comprehensive-commit.md task with anti-tunnel vision mechanisms
- Multi-stream aware commit message generation
- Systematic evidence gathering from multiple sources
- Comprehensive context analysis and rationale documentation
- Quality checklist to prevent tunnel vision
- Created create-comprehensive-pr.md task for detailed PR descriptions
- Work stream identification and documentation
- Per-stream testing instructions
- Visual evidence requirements
- Review focus areas and deployment notes
- Integrated workflows into dev and architect agents
- Added *comprehensive-commit command
- Added *comprehensive-pr command
- Made workflows available to agents who create commits/PRs
These workflows ensure high-quality git documentation with comprehensive
coverage of all changes, preventing the tunnel vision that often results
in incomplete commit messages or PR descriptions.
- Removed unnecessary folders from BMAD-METHOD repo (docs/adr, docs/devJournal)
- Updated tasks to create folders in destination projects when needed
- Removed standalone adr-specialist agent (functionality integrated into architect)
- Added create-adr task with folder setup instructions
- Both ADR and Dev Journal features now properly create their structures in target projects
The agents will now create and maintain docs/adr and docs/devJournal folders
in the projects where BMAD is installed, not in the BMAD-METHOD repo itself.
This release introduces significant enhancements across multiple areas:
QA Agent Transformation:
- Transform QA agent into senior developer role with active code refactoring abilities
- Add review-story task enabling QA to review, refactor, and improve code directly
- Integrate QA review step into standard development workflow (SM → Dev → QA)
- QA can fix small issues directly and leave checklist for remaining items
- Updated dev agent to maintain File List for QA review focus
Knowledge Base Improvements:
- Add extensive brownfield development documentation and best practices
- Clarify Web UI vs IDE usage with cost optimization strategies
- Document PRD-first approach for large codebases/monorepos
- Add comprehensive expansion packs explanation
- Update IDE workflow to include QA review step
- Clarify agent usage (bmad-master vs specialized agents)
Brownfield Enhancements:
- Create comprehensive Working in the Brownfield guide
- Add document-project task to analyst agent capabilities
- Implement PRD-first workflow option for focused documentation
- Transform document-project to create practical brownfield architecture docs
- Document technical debt, workarounds, and real-world constraints
- Reference actual files instead of duplicating content
- Add impact analysis when PRD is provided
Documentation Task Improvements:
- Simplify to always create ONE unified architecture document
- Add deep codebase analysis phase with targeted questions
- Focus on documenting reality including technical debt
- Include Quick Reference section with key file paths
- Add practical sections: useful commands, debugging tips, known issues
Workflow Updates:
- Update all 6 workflow files with detailed IDE transition instructions
- Add clear SM → Dev → QA → Dev cycle explanation
- Emphasize Gemini Web for brownfield analysis (1M+ context advantage)
- Support both PRD-first and document-first approaches
This release significantly improves the brownfield development experience and introduces a powerful shift-left QA approach with senior developer mentoring.
- Add markdownExploder setting to core-config.yml
- Update shard-doc task to use md-tree command when enabled
- Implement proper fallback handling when tool is unavailable
- Update core-config structure to remove nested wrapper
- Fix field naming to use camelCase throughout
* feat: add expansion pack installation system with game dev and infrastructure expansion packs
- Added expansion pack discovery and installation to BMAD installer
- Supports interactive and CLI installation of expansion packs
- Expansion pack files install to destination root (.bmad-core)
- Added game development expansion pack (.bmad-2d-phaser-game-dev)
- Game designer, developer, and scrum master agents
- Game-specific templates, tasks, workflows, and guidelines
- Specialized for Phaser 3 + TypeScript development
- Added infrastructure devops expansion pack (.bmad-infrastructure-devops)
- Platform engineering agent and infrastructure templates
- Expansion pack agents automatically integrate with IDE rules
- Added list:expansions command and --expansion-packs CLI option
🤖 Generated with Claude Code
Co-Authored-By: Claude <noreply@anthropic.com>
* alpha expansion packs and installer update to support installing expansion packs optionally
* node20
---------
Co-authored-by: Brian Madison <brianmadison@Brians-MacBook-Pro.local>
Co-authored-by: Claude <noreply@anthropic.com>
This commit represents a significant milestone in the BMAD-METHOD v4 framework restructuring effort, focusing on cleaning up legacy v3 content and enhancing IDE agent configurations.
Key Changes:
1. Legacy Content Cleanup:
- Removed entire _old/ directory containing v3 framework content (55 files, ~6900 lines)
- Deleted deprecated checklists, personas, tasks, and templates from v3
- Cleaned up obsolete web orchestrator configurations
2. IDE Agent Enhancements:
- Added new IDE agent configurations for all major roles:
* analyst.ide.md - Business Analyst agent
* architect.ide.md - Architecture specialist agent
* pm.ide.md - Product Manager agent
* po.ide.md - Product Owner agent
* devops.ide.md - DevOps/Platform Engineer agent (replacing devops-pe.ide.md)
- Updated dev.ide.md with improved structure and commands
- Enhanced sm.ide.md with proper persona naming (Bob)
3. New Persona Definitions:
- Added missing persona files: dev.md, devops.md, qa.md
- Standardized persona format across all roles
4. QA Agent Addition:
- Added qa.yml configuration for Quality Assurance agent
5. IDE Integration Improvements:
- Added .claude/commands/ directory for Claude Code command definitions
- Added .cursor/rules/ for Cursor IDE integration
- Created agent-switcher.ide.md utility for seamless agent switching
6. Command Updates:
- Renamed /exit command to /exit-agent for clarity and consistency
7. Build System Updates:
- Minor fixes to web-builder.js for improved bundle generation
This restructuring aligns with the v4 architecture goals of modularity, reusability, and improved developer experience across different IDE environments.
Authored-By: BMad
Lucas C
Brian Madison
titocr
Brian