Initial commit
This commit is contained in:
Zhongwei Li
270
commands/bmad-brief.md
Normal file
270
commands/bmad-brief.md
Normal file
@@ -0,0 +1,270 @@
|
||||
---
|
||||
description: Generate BMAD product brief from project idea
|
||||
---
|
||||
|
||||
# BMAD Brief - Generate Product Brief
|
||||
|
||||
Use the product-manager subagent to create a comprehensive Product Brief following BMAD methodology. The brief captures the high-level vision and goals.
|
||||
|
||||
## Task Delegation
|
||||
|
||||
First gather the project idea, then launch the product-manager subagent to handle the complete brief generation workflow.
|
||||
|
||||
## Process
|
||||
|
||||
### Step 1: Gather Project Idea
|
||||
|
||||
**If user provided description**:
|
||||
- Store their description
|
||||
|
||||
**If user said just `/bmad:brief`**:
|
||||
- Ask: "What's your project idea at a high level?"
|
||||
- Wait for response
|
||||
- Ask follow-up if needed: "What problem does it solve? Who is it for?"
|
||||
|
||||
### Step 2: Launch Product-Manager Subagent
|
||||
|
||||
Use the Task tool to launch the product-manager subagent in its own context window:
|
||||
|
||||
```
|
||||
Task(
|
||||
description: "Generate BMAD product brief",
|
||||
prompt: "Create comprehensive product brief following BMAD methodology.
|
||||
|
||||
User's Project Idea:
|
||||
{{user_idea}}
|
||||
|
||||
Your workflow:
|
||||
|
||||
1. **Generate product brief** using the MCP tool:
|
||||
```
|
||||
mcp__plugin_titanium-toolkit_tt__bmad_generator(
|
||||
doc_type: \"brief\",
|
||||
input_path: \"{{user_idea}}\",
|
||||
project_path: \"$(pwd)\"
|
||||
)
|
||||
```
|
||||
|
||||
2. **Review generated brief** - Read bmad-backlog/product-brief.md and present key sections to user
|
||||
|
||||
3. **Validate the brief** using:
|
||||
```
|
||||
mcp__plugin_titanium-toolkit_tt__bmad_validator(
|
||||
doc_type: \"brief\",
|
||||
document_path: \"bmad-backlog/product-brief.md\"
|
||||
)
|
||||
```
|
||||
|
||||
4. **Run vibe-check** to validate the brief quality
|
||||
|
||||
5. **Store in Pieces** for future reference
|
||||
|
||||
6. **Present summary** to user with next steps
|
||||
|
||||
**IMPORTANT**: Keep your summary response BRIEF (under 300 tokens). Just return:
|
||||
- Confirmation brief is complete
|
||||
- 1-2 sentence project description
|
||||
- Primary user segment
|
||||
- MVP feature count
|
||||
|
||||
DO NOT include the full brief content in your response - it's already saved to the file.
|
||||
|
||||
Follow your complete brief workflow from the bmad-methodology skill.
|
||||
|
||||
Project path: $(pwd)",
|
||||
subagent_type: "product-manager"
|
||||
)
|
||||
```
|
||||
|
||||
The product-manager subagent will handle:
|
||||
- Generating product brief
|
||||
- Reviewing and presenting key sections
|
||||
- Validation (structural and vibe-check)
|
||||
- Pieces storage
|
||||
- Summary presentation
|
||||
|
||||
### Step 3: Return Results
|
||||
|
||||
The product-manager will return a summary when complete. Present this to the user.
|
||||
|
||||
## What the Product-Manager Creates
|
||||
|
||||
The product-manager subagent generates `bmad-backlog/product-brief.md` containing:
|
||||
|
||||
- **Executive Summary**: Project concept, problem, target market, value proposition
|
||||
- **Problem Statement**: Current state, pain points, urgency
|
||||
- **Proposed Solution**: Core concept, differentiators
|
||||
- **Target Users**: Primary and secondary user segments with detailed profiles
|
||||
- **Goals & Success Metrics**: Business objectives, user success metrics, KPIs
|
||||
- **MVP Scope**: Core features and what's out of scope
|
||||
- **Technical Considerations**: Platform requirements, tech preferences
|
||||
- **Constraints & Assumptions**: Budget, timeline, resources
|
||||
- **Risks & Open Questions**: Key risks and areas needing research
|
||||
- **Next Steps**: Immediate actions and PM handoff
|
||||
|
||||
## Integration with Research
|
||||
|
||||
The product-manager may identify research needs during brief generation and suggest running `/bmad:research` for topics like:
|
||||
- Data vendors or APIs
|
||||
- Technology comparisons
|
||||
- Market research
|
||||
|
||||
## Voice Feedback
|
||||
|
||||
Voice hooks announce:
|
||||
- "Generating product brief" (when starting)
|
||||
- "Product brief complete" (when finished)
|
||||
|
||||
## Cost
|
||||
|
||||
Typical cost: ~$0.01 per brief generation (Claude Haiku 4.5 API usage in bmad_generator tool)
|
||||
|
||||
### Step 4: Present Summary and Next Steps
|
||||
|
||||
```
|
||||
✅ Product Brief Complete!
|
||||
|
||||
📄 Location: bmad-backlog/product-brief.md
|
||||
|
||||
📊 Summary:
|
||||
- Problem: {{one-line problem}}
|
||||
- Solution: {{one-line solution}}
|
||||
- Users: {{primary user segment}}
|
||||
- MVP Features: {{count}} core features
|
||||
|
||||
💡 Next Steps:
|
||||
|
||||
Option 1: Generate PRD next
|
||||
Run: /bmad:prd
|
||||
|
||||
Option 2: Generate complete backlog
|
||||
Run: /bmad:start
|
||||
(This will use the brief to generate PRD, Architecture, and all Epics)
|
||||
|
||||
What would you like to do?
|
||||
```
|
||||
|
||||
## Error Handling
|
||||
|
||||
### If ANTHROPIC_API_KEY Missing
|
||||
|
||||
```
|
||||
❌ Error: ANTHROPIC_API_KEY not found
|
||||
|
||||
The brief generation needs Anthropic Claude to create comprehensive content.
|
||||
|
||||
Please add your API key to ~/.env:
|
||||
echo 'ANTHROPIC_API_KEY=sk-ant-your-key-here' >> ~/.env
|
||||
chmod 600 ~/.env
|
||||
|
||||
Get your key from: https://console.anthropic.com/settings/keys
|
||||
|
||||
Then restart Claude Code and try again.
|
||||
```
|
||||
|
||||
### If Generation Fails
|
||||
|
||||
```
|
||||
❌ Brief generation failed
|
||||
|
||||
This could be due to:
|
||||
- API rate limits
|
||||
- Network issues
|
||||
- Invalid project description
|
||||
|
||||
Let me try again with a simplified approach.
|
||||
|
||||
[Retry with more basic prompt]
|
||||
```
|
||||
|
||||
### If User Wants to Skip Brief
|
||||
|
||||
```
|
||||
Note: Product brief is optional but recommended.
|
||||
|
||||
You can skip directly to PRD with:
|
||||
/bmad:prd
|
||||
|
||||
However, the brief helps organize your thoughts and produces better PRDs.
|
||||
|
||||
Skip brief and go to PRD? (yes/no)
|
||||
```
|
||||
|
||||
## Voice Feedback
|
||||
|
||||
Voice hooks will announce:
|
||||
- "Generating product brief" (when utility starts)
|
||||
- "Product brief complete" (when done)
|
||||
|
||||
## Example Usage
|
||||
|
||||
**Example 1: Simple Idea**
|
||||
```
|
||||
User: /bmad:brief "Social network for developers"
|
||||
|
||||
Claude: "What problem does it solve?"
|
||||
User: "Developers want to show off projects, not just resumes"
|
||||
|
||||
Claude: "Who are the primary users?"
|
||||
User: "Junior developers looking for jobs"
|
||||
|
||||
[Generates brief]
|
||||
|
||||
Claude: "Brief complete! Would you like to generate the PRD next?"
|
||||
```
|
||||
|
||||
**Example 2: Detailed Idea**
|
||||
```
|
||||
User: /bmad:brief "AI-powered precious metals research platform with real-time pricing, company fundamentals, smart screening, and AI-generated trade ideas for retail investors"
|
||||
|
||||
[Generates comprehensive brief from detailed description]
|
||||
|
||||
Claude: "Comprehensive brief generated! Next: /bmad:prd"
|
||||
```
|
||||
|
||||
**Example 3: Interactive Mode**
|
||||
```
|
||||
User: /bmad:brief
|
||||
|
||||
Claude: "What's your project idea?"
|
||||
User: "Todo app"
|
||||
|
||||
Claude: "What makes it different from existing todo apps?"
|
||||
User: "Uses voice input and AI scheduling"
|
||||
|
||||
Claude: "Who is it for?"
|
||||
User: "Busy professionals"
|
||||
|
||||
[Generates brief with full context]
|
||||
```
|
||||
|
||||
## Important Guidelines
|
||||
|
||||
**Always**:
|
||||
- ✅ Use `bmad_generator` MCP tool (don't generate manually)
|
||||
- ✅ Validate with vibe-check
|
||||
- ✅ Store in Pieces
|
||||
- ✅ Present clear summary
|
||||
- ✅ Suggest next steps
|
||||
|
||||
**Never**:
|
||||
- ❌ Generate brief content manually (use the tool)
|
||||
- ❌ Skip vibe-check validation
|
||||
- ❌ Forget to store in Pieces
|
||||
- ❌ Leave user uncertain about next steps
|
||||
|
||||
## Integration
|
||||
|
||||
**After `/bmad:brief`**:
|
||||
- Suggest `/bmad:prd` to continue
|
||||
- Or suggest `/bmad:start` to generate complete backlog
|
||||
- Brief is referenced by PRD generation
|
||||
|
||||
**Part of `/bmad:start`**:
|
||||
- Guided workflow calls brief generation
|
||||
- Uses brief for PRD generation
|
||||
- Seamless flow
|
||||
|
||||
---
|
||||
|
||||
**This command creates the foundation for your entire project backlog!**
|
||||
Reference in New Issue
Block a user