feat: enhance QA agent as senior developer with code review capabilities and major brownfield improvements
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.
This commit is contained in:
@@ -77,39 +77,6 @@ See [Expansion Packs Guide](../docs/expansion-packs.md) for detailed examples an
|
||||
5. NEVER display template markup or LLM instructions to users
|
||||
6. Focus on clean output - all processing instructions stay internal
|
||||
|
||||
## Examples
|
||||
|
||||
### Good Dev Agent
|
||||
|
||||
```yaml
|
||||
name: API Developer
|
||||
role: Creates REST APIs
|
||||
dependencies:
|
||||
templates:
|
||||
- api-endpoint-tmpl
|
||||
tasks:
|
||||
- implement-endpoint
|
||||
```
|
||||
|
||||
### Good Planning Agent (Web)
|
||||
|
||||
```yaml
|
||||
name: PRD Writer
|
||||
role: Creates comprehensive PRDs
|
||||
dependencies:
|
||||
templates:
|
||||
- prd-tmpl
|
||||
- epic-tmpl
|
||||
- story-tmpl
|
||||
tasks:
|
||||
- elicit-requirements
|
||||
- analyze-market
|
||||
- define-features
|
||||
data:
|
||||
- prd-best-practices
|
||||
- market-analysis-guide
|
||||
```
|
||||
|
||||
## Remember
|
||||
|
||||
- The power is in natural language orchestration, not code
|
||||
|
||||
Reference in New Issue
Block a user