Update all bootstrap prompts to use the correct GitHub MCP format:
owner: YOUR-ORG
repo: YOUR-REPO
path: src/modules/bmm/agents/po.agent.yaml
Instead of URLs like github.com/YOUR-ORG/YOUR-REPO which don't
work with MCP tools.
Also added:
- GitHub Enterprise note for enterprise hosts
- Reference to auto-generated bootstrap file
- MCP tools reference section
Enable BMAD usage directly in Claude Desktop without local installation:
- docs/how-to/installation/claude-desktop-github.md: Full setup guide
- resources/prompts/claude-desktop-po-bootstrap.md: Copy-paste bootstrap prompts
The key insight: with GitHub MCP, Claude Desktop can fetch agent
definitions directly from the repo and embody them dynamically.
Also enhanced PO agent setup-github prompt to cover both
Claude Desktop and Claude Code workflows.
Integrates the bmad-guide skill into BMAD installation process to help
Claude stay on track with BMAD methodology.
Features:
- Phase navigation and workflow selection guidance
- Project level detection (0-4) for routing to correct workflows
- Common mistakes prevention (skipping phases, manual coding)
- Emergency recovery procedures when off track
- Quick reference tables and troubleshooting
Implementation:
- Created resources/skills/ directory with bmad-guide.md (428 lines)
- Added installBmadGuideSkill() to ClaudeCodeSetup class
- Skill auto-installs to ~/.claude/skills/ during setup
- Available globally across all BMAD projects
- Updated installation documentation
Usage:
- Automatic: Skill is installed when running npx bmad-method install
- Manual access: /bmad-guide command in any project
- Optional: Add BMAD Method config to ~/.claude/CLAUDE.md for automatic invocation
Benefits:
- Prevents Claude from jumping straight to coding without workflows
- Ensures proper phase progression
- Guides workflow selection based on project level
- Self-corrects when going off track
Jonah Schulte