---
name: ❓ Question
about: Ask a question about the BMAD Claude integration
title: '[QUESTION] '
labels: ['question', 'needs-triage']
assignees: ''
---

# ❓ Question

## 📋 Question Summary
<!-- Briefly describe your question -->

## 🎯 Category
<!-- What area is your question about? -->
- [ ] 🚀 **Getting Started** - Installation, setup, first steps
- [ ] 🎭 **Agent Usage** - How to use specific agents effectively
- [ ] 🔄 **Workflows** - BMAD methodology and cross-agent processes
- [ ] 🛠️ **Technical** - Implementation details, troubleshooting
- [ ] 🧪 **Testing** - How to validate and test the integration
- [ ] 📚 **Documentation** - Where to find information
- [ ] 🤝 **Contributing** - How to help improve the project
- [ ] 🔗 **Integration** - Using with existing BMAD workflows
- [ ] 🎯 **Best Practices** - Optimal usage patterns
- [ ] 🐛 **Troubleshooting** - Solving specific issues

## 🔍 Detailed Question
<!-- Ask your question in detail -->

### Context
<!-- Provide background information that helps answer your question -->

### What I'm Trying to Do
<!-- Describe your goal or use case -->

### What I've Tried
<!-- What have you attempted so far? -->
- [ ] Read the README.md files
- [ ] Checked the documentation in docs/
- [ ] Ran `npm run test:claude`
- [ ] Searched existing issues
- [ ] Asked in Discord community
- [ ] Consulted Claude Code documentation

### Specific Examples
<!-- Include specific examples, commands, or scenarios -->
```bash
# Commands you've run
```

```
# Output or responses you've seen
```

## 🖥️ Environment (if relevant)
<!-- Include if this might be environment-specific -->
- **OS**: [e.g. macOS, Windows, Linux]
- **Node.js Version**: [e.g. v20.5.0]
- **Claude Code Version**: [run `claude --version`]
- **BMAD Integration**: [when did you last build?]

## 🎭 Agent Context (if relevant)
<!-- If your question is about specific agents -->
**Relevant agents:**
- [ ] 📊 Analyst (Mary)
- [ ] 🏗️ Architect (Winston)
- [ ] 👨‍💻 Dev (James)
- [ ] 📋 PM (John)
- [ ] 🔍 QA (Quinn)
- [ ] 🎯 Scrum Master (Bob)

**BMAD workflow context:**
<!-- What BMAD process are you working on? -->

## 📚 Additional Context
<!-- Any other information that might be helpful -->

### Related Resources
<!-- Link to any relevant documentation or issues -->

### Expected Outcome
<!-- What kind of answer are you looking for? -->
- [ ] Step-by-step instructions
- [ ] Conceptual explanation
- [ ] Code examples
- [ ] Best practice recommendations
- [ ] Troubleshooting guidance
- [ ] Resource/documentation pointers

### Urgency
- [ ] 🔥 Urgent - Blocking critical work
- [ ] 🟠 Soon - Needed within days
- [ ] 🟡 Normal - Needed within weeks
- [ ] 🟢 Low - Just curious/exploring

## 🤝 Community Help
<!-- Can you help others with similar questions? -->
- [ ] I'd be willing to help others with similar questions
- [ ] I can contribute to documentation based on the answer
- [ ] I'm interested in improving this area of the project

---

**Before posting, please:**
- [ ] Search existing issues for similar questions
- [ ] Check the Discord community for recent discussions
- [ ] Review the documentation in the repository
- [ ] Provide enough context for others to help you