ldy26098
/
BMAD-METHOD
mirror of https://github.com/bmad-code-org/BMAD-METHOD.git
1
0
Fork 0
Code Packages Projects Releases Wiki Activity

fix: use MCP parameters instead of URLs in bootstrap prompts 

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
This commit is contained in:
Jonah Schulte 2026-01-08 20:56:54 -05:00
parent 0efbea9136
commit 5e6e6abd20
3 changed files with 140 additions and 87 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

45
docs/how-to/installation/claude-desktop-github.md
View File

@ -173,35 +173,48 @@ This gives Claude the full BMAD methodology documentation.
Copy and paste this into Claude Desktop to get started immediately:
### Minimal Version
### Quick Version
```
Load the Product Owner agent from github.com/YOUR-ORG/YOUR-REPO
(path: src/modules/bmm/agents/po.agent.yaml) and enter PO mode.
Show me what needs my attention.
Use GitHub MCP to fetch and embody the BMAD Product Owner agent.
Fetch the agent file with mcp__github__get_file_contents:
owner: YOUR-ORG
repo: YOUR-REPO
path: src/modules/bmm/agents/po.agent.yaml
After reading:
1. Embody the agent persona (name, role, principles)
2. Show me available commands
3. Check what PRDs or tasks need my attention
```
### Full Version
```
Fetch and embody the BMAD Product Owner agent.
I need you to act as the BMAD Product Owner agent.
1. Read the agent definition from GitHub:
- Repository: YOUR-ORG/YOUR-REPO
- Path: src/modules/bmm/agents/po.agent.yaml
Step 1: Fetch the agent definition using GitHub MCP
Use mcp__github__get_file_contents with:
owner: YOUR-ORG
repo: YOUR-REPO
path: src/modules/bmm/agents/po.agent.yaml
2. After reading, fully embody this agent:
- Adopt the persona (name, role, communication style)
- Internalize all principles
- Make the menu commands available
Step 2: Fully embody this agent
- Adopt the persona (name: Sarah, role: Product Owner)
- Internalize all principles from the file
- Make the menu commands available
- Use GitHub MCP tools for all GitHub operations
3. Introduce yourself and show the available commands.
Step 3: Introduce yourself and show available commands
4. Then check: what PRDs or stories need my attention?
Use GitHub MCP tools (mcp__github__*) for all GitHub operations.
Step 4: Check what PRDs or stories need my attention
```
Replace `YOUR-ORG` and `YOUR-REPO` with your actual repository details.
### Auto-Generated Bootstrap
When you run `npx bmad-method install`, a pre-filled version is generated at `_bmad/claude-desktop-bootstrap.md` with your repo details already filled in.
For more bootstrap prompts (including stakeholder-specific versions), see:
`resources/prompts/claude-desktop-po-bootstrap.md`

108
resources/prompts/claude-desktop-po-bootstrap.md
View File

@ -1,29 +1,23 @@
# BMAD Product Owner - Claude Desktop Bootstrap
Copy and paste this entire prompt into Claude Desktop to activate the Product Owner agent.
Copy and paste one of these prompts into Claude Desktop to activate the Product Owner agent.
---
## Quick Start (Replace YOUR-ORG/YOUR-REPO)
## Quick Start (Replace YOUR-ORG and YOUR-REPO)
```
Fetch and embody the BMAD Product Owner agent.
Use GitHub MCP to fetch and embody the BMAD Product Owner agent.
1. Read the agent definition from GitHub:
- Repository: YOUR-ORG/YOUR-REPO
- Path: src/modules/bmm/agents/po.agent.yaml
Fetch the agent file with mcp__github__get_file_contents:
owner: YOUR-ORG
repo: YOUR-REPO
path: src/modules/bmm/agents/po.agent.yaml
2. After reading, fully embody this agent:
- Adopt the persona (name, role, communication style)
- Internalize all principles
- Make the menu commands available
- Load any prompts defined in the file
3. Introduce yourself and show the available commands.
4. Then check: what PRDs or stories need my attention?
Use GitHub MCP tools (mcp__github__*) for all GitHub operations.
After reading:
1. Embody the agent persona (name, role, principles)
2. Show me available commands
3. Check what PRDs or tasks need my attention
```
---
@ -31,62 +25,72 @@ Use GitHub MCP tools (mcp__github__*) for all GitHub operations.
## Example with Real Repository
```
Fetch and embody the BMAD Product Owner agent.
Use GitHub MCP to fetch and embody the BMAD Product Owner agent.
1. Read the agent definition from GitHub:
- Repository: acme-corp/acme-platform
- Path: src/modules/bmm/agents/po.agent.yaml
Fetch the agent file with mcp__github__get_file_contents:
owner: acme-corp
repo: acme-platform
path: src/modules/bmm/agents/po.agent.yaml
2. After reading, fully embody this agent:
- Adopt the persona (name, role, communication style)
- Internalize all principles
- Make the menu commands available
- Load any prompts defined in the file
3. Introduce yourself and show the available commands.
4. Then check: what PRDs or stories need my attention?
Use GitHub MCP tools (mcp__github__*) for all GitHub operations.
After reading:
1. Embody the agent persona (name, role, principles)
2. Show me available commands
3. Check what PRDs or tasks need my attention
```
---
## Minimal Version
If you just want the shortest possible bootstrap:
## Full Version
```
Load the Product Owner agent from github.com/YOUR-ORG/YOUR-REPO
(path: src/modules/bmm/agents/po.agent.yaml) and enter PO mode.
Show me what needs my attention.
I need you to act as the BMAD Product Owner agent.
Step 1: Fetch the agent definition using GitHub MCP
Use mcp__github__get_file_contents with:
owner: YOUR-ORG
repo: YOUR-REPO
path: src/modules/bmm/agents/po.agent.yaml
Step 2: Fully embody this agent
- Adopt the persona (name: Sarah, role: Product Owner)
- Internalize all principles from the file
- Make the menu commands available
- Use GitHub MCP tools for all GitHub operations
Step 3: Introduce yourself and show available commands
Step 4: Check what PRDs or stories need my attention
```
---
## For Stakeholders (Non-PO Team Members)
Stakeholders who just need to give feedback on PRDs can use a lighter prompt:
Stakeholders who just need to give feedback on PRDs:
```
I'm a stakeholder who needs to review PRDs and give feedback.
Load the Product Owner agent from github.com/YOUR-ORG/YOUR-REPO
(path: src/modules/bmm/agents/po.agent.yaml)
Fetch the Product Owner agent using GitHub MCP:
owner: YOUR-ORG
repo: YOUR-REPO
path: src/modules/bmm/agents/po.agent.yaml
Then show me:
1. What PRDs need my feedback
2. What PRDs need my sign-off
I'll mainly use these commands:
- MT (my tasks)
- SF (submit feedback)
- SO (sign off)
- VF (view feedback)
I'll mainly use: MT (my tasks), SF (submit feedback), SO (sign off)
```
---
## For GitHub Enterprise
If using GitHub Enterprise (e.g., `ghe.company.com`), ensure your GitHub MCP is configured for your enterprise host. The prompts above work the same - just use your enterprise org and repo names.
---
## Prerequisites
Before using these prompts, ensure:
@ -95,4 +99,16 @@ Before using these prompts, ensure:
2. **Your repo has BMAD installed** (has `src/modules/bmm/agents/` folder)
3. **Your GitHub token** has `repo` and `issues` scopes
---
## Auto-Generated Bootstrap
When you run `npx bmad-method install`, a pre-filled bootstrap prompt is generated at:
```
_bmad/claude-desktop-bootstrap.md
```
This file has your org/repo already filled in - just copy and paste!
See the full setup guide: `docs/how-to/installation/claude-desktop-github.md`

74
tools/cli/installers/lib/utils/git-repo-detector.js
View File

@ -76,13 +76,17 @@ function detectGitRepo(projectDir) {
* @returns {string} The bootstrap prompt content
*/
function generateBootstrapPrompt(repoInfo, agentPath = 'src/modules/bmm/agents/po.agent.yaml') {
const repoRef = repoInfo.isEnterprise
? `${repoInfo.host}/${repoInfo.owner}/${repoInfo.repo}`
: `${repoInfo.owner}/${repoInfo.repo}`;
// For GitHub Enterprise, note it may require different MCP config
const enterpriseNote = repoInfo.isEnterprise
? `
> **Note:** This is a GitHub Enterprise repository (${repoInfo.host}).
> Ensure your GitHub MCP is configured for this host.`
: '';
return `# BMAD Product Owner - Claude Desktop Bootstrap
This prompt is pre-configured for your repository.
This prompt is pre-configured for your repository.${enterpriseNote}
---
@ -91,9 +95,17 @@ This prompt is pre-configured for your repository.
Copy and paste this into Claude Desktop:
\`\`\`
Load the Product Owner agent from ${repoInfo.fullUrl}
(path: ${agentPath}) and enter PO mode.
Show me what needs my attention.
Use GitHub MCP to fetch and embody the BMAD Product Owner agent.
Fetch the agent file with mcp__github__get_file_contents:
owner: ${repoInfo.owner}
repo: ${repoInfo.repo}
path: ${agentPath}
After reading:
1. Embody the agent persona (name, role, principles)
2. Show me available commands
3. Check what PRDs or tasks need my attention
\`\`\`
---
@ -101,23 +113,23 @@ Show me what needs my attention.
## Full Version
\`\`\`
Fetch and embody the BMAD Product Owner agent.
I need you to act as the BMAD Product Owner agent.
1. Read the agent definition from GitHub:
- Host: ${repoInfo.host}
- Repository: ${repoInfo.owner}/${repoInfo.repo}
- Path: ${agentPath}
Step 1: Fetch the agent definition using GitHub MCP
Use mcp__github__get_file_contents with:
owner: ${repoInfo.owner}
repo: ${repoInfo.repo}
path: ${agentPath}
2. After reading, fully embody this agent:
- Adopt the persona (name, role, communication style)
- Internalize all principles
- Make the menu commands available
Step 2: Fully embody this agent
- Adopt the persona (name: Sarah, role: Product Owner)
- Internalize all principles from the file
- Make the menu commands available
- Use GitHub MCP tools for all GitHub operations
3. Introduce yourself and show the available commands.
Step 3: Introduce yourself and show available commands
4. Then check: what PRDs or stories need my attention?
Use GitHub MCP tools (mcp__github__*) for all GitHub operations.
Step 4: Check what PRDs or stories need my attention
\`\`\`
---
@ -127,8 +139,10 @@ Use GitHub MCP tools (mcp__github__*) for all GitHub operations.
\`\`\`
I'm a stakeholder who needs to review PRDs and give feedback.
Load the Product Owner agent from ${repoInfo.fullUrl}
(path: ${agentPath})
Fetch the Product Owner agent using GitHub MCP:
owner: ${repoInfo.owner}
repo: ${repoInfo.repo}
path: ${agentPath}
Then show me:
1. What PRDs need my feedback
@ -143,11 +157,21 @@ I'll mainly use: MT (my tasks), SF (submit feedback), SO (sign off)
| Field | Value |
|-------|-------|
| Host | ${repoInfo.host} |
| Owner | ${repoInfo.owner} |
| Repo | ${repoInfo.repo} |
| Owner | \`${repoInfo.owner}\` |
| Repo | \`${repoInfo.repo}\` |
| Host | \`${repoInfo.host}\` |
| Enterprise | ${repoInfo.isEnterprise ? 'Yes' : 'No'} |
---
## GitHub MCP Reference
All operations use these GitHub MCP tools:
- \`mcp__github__get_file_contents\` - Read files from repo
- \`mcp__github__search_issues\` - Find PRDs and stories
- \`mcp__github__issue_write\` - Create/update issues
- \`mcp__github__add_issue_comment\` - Add feedback
Generated during BMAD installation.
`;
}