---
name: 🎭 Agent Improvement
about: Suggest improvements to specific BMAD Claude agents
title: '[AGENT] [Agent Name] - '
labels: ['agent-improvement', 'enhancement']
assignees: ''
---

# 🎭 Agent Improvement

## 📊 Target Agent
<!-- Select the agent(s) this improvement targets -->
- [ ] 📊 **Analyst (Mary)** - Market research, competitive analysis, project briefing
- [ ] 🏗️ **Architect (Winston)** - System design, technical architecture
- [ ] 👨‍💻 **Dev (James)** - Implementation, coding, technical development
- [ ] 📋 **PM (John)** - Project management, planning, coordination
- [ ] 🔍 **QA (Quinn)** - Quality assurance, testing, validation
- [ ] 🎯 **Scrum Master (Bob)** - Agile process management, team facilitation
- [ ] 🔄 **Cross-Agent** - Multi-agent workflows and collaboration

## 🎯 Improvement Type
<!-- Check the type of improvement -->
- [ ] 🧠 **Persona Enhancement** - Improve agent character/personality
- [ ] 📝 **Prompt Optimization** - Better system prompts and instructions  
- [ ] 🛠️ **New Capabilities** - Add new commands or skills
- [ ] 📚 **BMAD Integration** - Better methodology adherence
- [ ] 🤝 **Collaboration** - Improve cross-agent workflows
- [ ] 💾 **Memory/Context** - Better context management
- [ ] 📊 **Output Quality** - Improve response quality
- [ ] 🎨 **User Experience** - Better interaction patterns

## 📋 Current Behavior
<!-- Describe how the agent currently behaves -->
**What does the agent do now?**

### Current Strengths
<!-- What works well currently? -->

### Current Limitations
<!-- What could be improved? -->

### Example Current Response
```
<!-- Paste an example of current agent behavior -->
```

## ✨ Proposed Improvement
<!-- Describe the specific improvement -->
**What should the agent do differently?**

### Detailed Description
<!-- Explain the improvement in detail -->

### Expected Benefits
<!-- How would this make the agent better? -->

### Example Improved Response
```
<!-- Show what the improved response would look like -->
```

## 🧪 Testing Scenario
<!-- How would you test this improvement? -->

### Test Prompt
```
<!-- Provide a specific prompt to test the improvement -->
```

### Success Criteria
<!-- How would you know the improvement worked? -->
- [ ] Criterion 1
- [ ] Criterion 2
- [ ] Criterion 3

### Evaluation Method
- [ ] Manual testing in Claude Code
- [ ] Comparison with previous responses
- [ ] User feedback collection
- [ ] Automated scoring (if applicable)

## 🎭 BMAD Methodology Alignment
<!-- How does this align with BMAD principles? -->

### BMAD Integration
- [ ] Enhances existing BMAD workflow adherence
- [ ] Adds new BMAD artifact usage
- [ ] Improves BMAD template integration
- [ ] Better cross-agent BMAD coordination
- [ ] Maintains BMAD methodology integrity

### Agent Role Consistency
<!-- Does this maintain the agent's core BMAD role? -->
- [ ] Stays true to agent's primary BMAD function
- [ ] Enhances domain expertise appropriately
- [ ] Maintains professional persona
- [ ] Supports BMAD workflow patterns

## 📈 Impact Assessment

### User Experience Impact
- [ ] 🟢 Significantly improves user experience
- [ ] 🟡 Moderately improves user experience  
- [ ] 🟠 Minor improvement
- [ ] 🔴 Minimal impact

### Agent Performance Impact
- [ ] 🟢 Major improvement in agent capability
- [ ] 🟡 Moderate improvement
- [ ] 🟠 Small improvement
- [ ] 🔴 Minimal improvement

### Implementation Complexity
- [ ] 🟢 Simple - Prompt/template changes only
- [ ] 🟡 Medium - Some code changes required
- [ ] 🟠 Complex - Significant changes needed
- [ ] 🔴 Major - Architectural changes required

## 🔧 Implementation Details

### Prompt Changes Required
<!-- What specific prompt modifications are needed? -->

### New Dependencies
<!-- Any new templates, tasks, or data files needed? -->
- [ ] New task files in bmad-core/tasks/
- [ ] New templates in bmad-core/templates/
- [ ] New data files in bmad-core/data/
- [ ] Agent template modifications
- [ ] Build system changes

### Tool/Command Changes
- [ ] New BMAD commands needed
- [ ] Existing command modifications
- [ ] New tool permissions required
- [ ] Memory/persistence changes

## 📊 Comparison Analysis
<!-- How does this compare to other agents or systems? -->

### Similar Functionality
<!-- Do other agents have similar capabilities? -->

### Best Practices
<!-- What best practices does this follow? -->

### Differentiation
<!-- How does this make the agent unique/better? -->

## 🔗 Related Work
<!-- Link to related issues, discussions, or examples -->
- Related to #(issue number)
- Inspired by #(issue number)
- Builds on #(issue number)

### External References
<!-- Relevant external resources -->
- BMAD methodology documentation
- Claude Code best practices
- Agent prompt engineering guides

## 📋 Additional Context

### User Feedback
<!-- Any user feedback that inspired this improvement? -->

### Research/Evidence
<!-- Any research supporting this improvement? -->

### Examples from Other Domains
<!-- Similar improvements in other AI systems? -->

## 🤝 Implementation Plan
<!-- How could this be implemented? -->

### Phase 1: Planning
- [ ] Finalize improvement specification
- [ ] Design prompt modifications
- [ ] Plan testing approach

### Phase 2: Implementation  
- [ ] Modify agent templates/prompts
- [ ] Add any new dependencies
- [ ] Update build system if needed

### Phase 3: Testing
- [ ] Test with sample scenarios
- [ ] Validate BMAD integration
- [ ] Collect feedback

### Phase 4: Refinement
- [ ] Iterate based on testing
- [ ] Document changes
- [ ] Update examples

## 🤝 Contribution
<!-- How can you help with this improvement? -->
- [ ] I can implement the prompt changes
- [ ] I can help with testing and validation
- [ ] I can provide additional use cases
- [ ] I can help with documentation
- [ ] I need guidance but want to contribute

---

**Please ensure you've:**
- [ ] Clearly identified the target agent(s)
- [ ] Provided specific examples of current vs. improved behavior
- [ ] Considered BMAD methodology alignment
- [ ] Thought through implementation complexity
- [ ] Included testing criteria