Add example story for User Email Validation TDD workflow:
- Complete story with acceptance criteria in Gherkin format
- Technical requirements and test plan with test IDs
- TDD phase progress tracking (currently red)
- Implementation tasks for Dev agent
- Directory structure for JS and Python demo implementations
This demo story provides teams with a practical example to reproduce
the red-green-refactor TDD cycle using BMAD framework and methodology.
- Update QA agent (qa.md) with TDD Red phase commands:
- *tdd-start: Initialize TDD for story
- *write-failing-tests: Generate failing tests (Red phase)
- *tdd-refactor: Participate in refactor with safety checks
- Add TDD methodology and test isolation principles
- Update Dev agent (dev.md) with TDD Green/Refactor phase commands:
- *tdd-implement: Implement minimal code to pass tests (Green phase)
- *make-tests-pass: Iterative test-driven implementation
- *tdd-refactor: Collaborate on safe refactoring
- Add TDD discipline and test-first validation rules
- Enhance test-design.md with TDD-first support:
- Add TDD mode for Red phase test design
- Mocking strategy selection matrix (mock/fake/stub)
- Smallest-next-test principle
- Deterministic test data strategies
- Create TDD quality gates template (tdd-quality-gates.md):
- Phase-specific gate criteria (Red/Green/Refactor)
- Pass/Fail/Concerns criteria per phase
- Recovery procedures for gate failures
- Integration with existing BMAD quality gates
All agents now support both traditional and TDD workflows.
TDD features are conditionally available when tdd.enabled=true.
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.
* 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>
vforvaick
Brian Madison
manjaroblack
Murat K Ozcan
titocr
Brian