- Adds Phase 10: Automatic Next Steps Presentation
- Presents 4 grade-based option sets (A/B/C/D-F) with specific recommendations
- Eliminates user confusion about 'what's next' after audit results
- Provides immediate next commands based on reality score and issues
- Includes effort estimates and specific action items for each option
- Enhances user experience by removing need to ask 'what are my options'
- Covers all scenarios from excellent quality to significant issues
- Replace bash grep loops with Grep tool usage for pattern detection
- Eliminates need for multiple command approvals during QA audit
- Maintains all simulation pattern detection capabilities
- Improves user experience by reducing workflow interruptions
- Updated task instructions to guide agents to use Grep tool
- Preserves comprehensive scoring and reporting functionality
- Enhanced dev agent with mandatory dual-track updates (story file + TodoWrite)
- Added validation gates to halt progression if story file not updated
- Prevents completed stories showing unchecked tasks
- Updated documentation with dual-track progress feature
Fixes: Story completion without incremental checkbox updates
- Added develop-story to commands list in dev agent
- Enables systematic workflow execution with automatic progress tracking
- Tasks now properly marked [x] as agent progresses through story implementation
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.
James (Claude Code)
DevForgeAI
Brian Madison