212 lines
6.1 KiB
Markdown
212 lines
6.1 KiB
Markdown
---
|
|
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
|