BMAD-METHOD/.github/ISSUE_TEMPLATE/bug_report.md

3.5 KiB

name about title labels assignees
🐛 Bug Report Report a bug in the BMAD Claude integration [BUG]
bug
needs-triage

🐛 Bug Report

📋 Summary

🎭 Affected Component

  • 📊 Analyst Agent (Mary)
  • 🏗️ Architect Agent (Winston)
  • 👨‍💻 Dev Agent (James)
  • 📋 PM Agent (John)
  • 🔍 QA Agent (Quinn)
  • 🎯 Scrum Master Agent (Bob)
  • 🛠️ Build System (npm run build:claude)
  • 🧪 Testing Framework
  • 📚 Documentation
  • 🔄 Cross-agent workflows
  • 💾 Memory/persistence
  • 📁 BMAD integration

🔄 Steps to Reproduce

  1. Run npm run build:claude
  2. Start Claude Code with claude
  3. Execute command: '...'
  4. See error

Expected Behavior

Actual Behavior

📸 Screenshots/Output

<!-- Paste error output or logs here -->

🖥️ Environment

System Information

  • OS: [e.g. macOS 14.6, Windows 11, Ubuntu 22.04]
  • Node.js Version: [e.g. v20.5.0]
  • npm Version: [e.g. 9.8.0]
  • Claude Code Version: [run claude --version]

BMAD Integration Version

  • BMAD Method Version: [check package.json version]
  • Integration Build: [when did you last run npm run build:claude?]
  • Git Commit: [run git rev-parse HEAD]

File State

  • .claude/agents/ directory exists
  • All 6 agent files present (analyst, architect, dev, pm, qa, sm)
  • npm run validate passes in integration/claude

🔧 Configuration

Agent Configuration

  • Custom modifications: [Yes/No - describe any changes made]
  • Tool permissions: [any custom tool configurations]
  • Memory settings: [any custom memory configurations]

Build Configuration

  • Custom templates: [any modifications to agent.mustache]
  • Custom BMAD data: [any additions to bmad-core/data/]
  • Environment variables: [any relevant env vars]

🧪 Attempted Solutions

  • Rebuilt agents with npm run build:claude
  • Cleared .claude directory and rebuilt
  • Restarted Claude Code
  • Checked for Claude Code updates
  • Verified Node.js version compatibility
  • Reviewed error logs

📋 Additional Context

Error Frequency

  • Happens every time
  • Happens sometimes
  • Happened once
  • Only in specific scenarios

Impact Level

  • 🔥 Critical - Blocks all functionality
  • 🟠 High - Blocks major functionality
  • 🟡 Medium - Workaround available
  • 🟢 Low - Minor inconvenience

Workarounds

🤝 Contribution

  • I'd like to work on fixing this issue
  • I can provide additional testing
  • I have ideas for the solution
  • I need guidance on how to help

Please ensure you've:

  • Searched existing issues to avoid duplicates
  • Provided all requested information
  • Used a descriptive title
  • Included steps to reproduce the issue