261 lines
7.3 KiB
Markdown
261 lines
7.3 KiB
Markdown
# Product Manager (John) - Integration Guide
|
|
|
|
## Overview
|
|
|
|
This guide provides detailed instructions for integrating the Product Manager (John) persona into your development workflow, covering both web and IDE environments.
|
|
|
|
## Web Environment Integration
|
|
|
|
### v0 Chat Integration
|
|
|
|
#### Setup Instructions
|
|
1. **Access v0 Chat Interface**
|
|
- Navigate to v0.dev
|
|
- Start a new chat session
|
|
- Load the BMAD Method workspace
|
|
|
|
2. **Activate PM Persona**
|
|
```
|
|
Transform into John the Product Manager and help me with [specific task]
|
|
```
|
|
|
|
3. **Context Loading**
|
|
- Upload relevant business documents
|
|
- Provide stakeholder requirements
|
|
- Share market research data
|
|
|
|
#### Usage Patterns
|
|
- **Requirements Analysis**: "John, analyze these business requirements and create a PRD"
|
|
- **Stakeholder Communication**: "John, draft a stakeholder update for this feature"
|
|
- **Prioritization**: "John, help prioritize these features using RICE framework"
|
|
|
|
### Web-Based Tools Integration
|
|
|
|
#### Documentation Platforms
|
|
- **Confluence Integration**: Use PM templates for consistent documentation
|
|
- **Notion Integration**: Leverage PM databases and templates
|
|
- **SharePoint Integration**: Corporate documentation workflows
|
|
|
|
#### Project Management Tools
|
|
- **Jira Integration**: Automated user story creation from PRDs
|
|
- **Azure DevOps Integration**: Requirements traceability
|
|
- **Asana Integration**: Stakeholder task management
|
|
|
|
## IDE Environment Integration
|
|
|
|
### Methodology Integration in IDEs
|
|
|
|
The BMAD Method integrates into IDE environments through **documentation loading** and **prompt structuring**, not through software installation.
|
|
|
|
#### Setup Process
|
|
1. **Load BMAD Documentation**
|
|
- Copy relevant persona files to your project directory
|
|
- Reference BMAD templates and checklists in your AI assistant context
|
|
- Use BMAD methodology patterns in your prompts
|
|
|
|
2. **Configure AI Assistant Context**
|
|
```
|
|
Load the Product Manager persona from: bmad-agent/personas/pm.md
|
|
Reference task templates from: bmad-agent/tasks/
|
|
Use quality checklists from: bmad-agent/checklists/pm-checklist.md
|
|
```
|
|
|
|
#### Usage Patterns
|
|
- **Activate PM Persona**: Load pm.md into your AI assistant context
|
|
- **Use PM Tasks**: Reference specific tasks from the task library
|
|
- **Apply Templates**: Use PRD and user story templates as guidance
|
|
- **Follow Checklists**: Validate work against PM quality standards
|
|
|
|
## Workflow Integration
|
|
|
|
### BMAD Method Workflow
|
|
|
|
#### Phase Transitions
|
|
1. **From Business Analyst**
|
|
- Receive business requirements document
|
|
- Review market research findings
|
|
- Validate stakeholder needs
|
|
|
|
2. **PM Processing Phase**
|
|
- Analyze requirements for completeness
|
|
- Create detailed PRD
|
|
- Define user stories with acceptance criteria
|
|
- Conduct stakeholder reviews
|
|
|
|
3. **To UX/UI Architect**
|
|
- Hand off validated PRD
|
|
- Provide user journey documentation
|
|
- Share design constraints and requirements
|
|
|
|
#### Collaboration Points
|
|
- **With BA**: Requirements validation and clarification
|
|
- **With Architect**: Technical feasibility discussions
|
|
- **With PO**: Sprint planning and backlog management
|
|
- **With Stakeholders**: Regular updates and feedback sessions
|
|
|
|
### Agile Integration
|
|
|
|
#### Scrum Framework
|
|
- **Product Backlog Management**: Maintain and prioritize product backlog
|
|
- **Sprint Planning**: Collaborate with PO on sprint goals
|
|
- **Sprint Reviews**: Present completed features to stakeholders
|
|
- **Retrospectives**: Gather feedback on PM processes
|
|
|
|
#### Kanban Integration
|
|
- **Continuous Flow**: Manage requirements through Kanban board
|
|
- **WIP Limits**: Set limits on requirements in progress
|
|
- **Metrics**: Track cycle time for requirements processing
|
|
|
|
## Template Integration
|
|
|
|
### PRD Templates
|
|
|
|
#### Standard PRD Structure
|
|
```markdown
|
|
# Product Requirements Document
|
|
|
|
## Executive Summary
|
|
- Problem statement
|
|
- Solution overview
|
|
- Success metrics
|
|
|
|
## Market Analysis
|
|
- Target audience
|
|
- Competitive landscape
|
|
- Market opportunity
|
|
|
|
## Product Requirements
|
|
- Functional requirements
|
|
- Non-functional requirements
|
|
- Constraints and assumptions
|
|
|
|
## User Stories
|
|
- Epic breakdown
|
|
- Detailed user stories
|
|
- Acceptance criteria
|
|
|
|
## Success Metrics
|
|
- KPIs and success criteria
|
|
- Measurement plan
|
|
- Timeline and milestones
|
|
```
|
|
|
|
#### Template Customization
|
|
- Industry-specific templates
|
|
- Company-specific requirements
|
|
- Regulatory compliance templates
|
|
|
|
### User Story Templates
|
|
|
|
#### Standard Format
|
|
```markdown
|
|
## User Story: [Title]
|
|
|
|
**As a** [user type]
|
|
**I want** [functionality]
|
|
**So that** [benefit/value]
|
|
|
|
### Acceptance Criteria
|
|
- [ ] Criterion 1
|
|
- [ ] Criterion 2
|
|
- [ ] Criterion 3
|
|
|
|
### Definition of Done
|
|
- [ ] Code complete
|
|
- [ ] Tests passing
|
|
- [ ] Documentation updated
|
|
- [ ] Stakeholder approval
|
|
```
|
|
|
|
## Third-Party Integrations
|
|
|
|
### CRM Integration
|
|
- **Salesforce**: Customer feedback integration
|
|
- **HubSpot**: Lead and customer data
|
|
- **Pipedrive**: Sales pipeline insights
|
|
|
|
### Analytics Integration
|
|
- **Google Analytics**: User behavior data
|
|
- **Mixpanel**: Product usage analytics
|
|
- **Amplitude**: User journey analysis
|
|
|
|
### Communication Tools
|
|
- **Slack Integration**: Automated stakeholder updates
|
|
- **Teams Integration**: Meeting scheduling and notes
|
|
- **Discord Integration**: Community feedback collection
|
|
|
|
## Methodology Integration Patterns
|
|
|
|
### Prompt Structuring
|
|
```
|
|
"Acting as John the Product Manager from the BMAD Method, help me create a PRD for [project].
|
|
Use the PRD template structure and follow the PM quality checklist to ensure completeness."
|
|
```
|
|
|
|
### Context Loading
|
|
```
|
|
"Load the BMAD PM persona and task library. I need help with stakeholder elicitation for a new feature.
|
|
Follow the stakeholder elicitation task process and use the communication templates."
|
|
```
|
|
|
|
### Template Application
|
|
```
|
|
"Using the BMAD PRD template, create a product requirements document that includes:
|
|
- Executive summary following the template structure
|
|
- Market analysis using the provided framework
|
|
- User stories in the standard BMAD format"
|
|
```
|
|
|
|
## Quality Assurance Integration
|
|
|
|
### Automated Checks
|
|
- **Requirements Completeness**: Automated PRD validation
|
|
- **Acceptance Criteria Quality**: Story completeness checks
|
|
- **Stakeholder Sign-off**: Approval workflow automation
|
|
|
|
### Review Processes
|
|
- **Peer Review**: PM peer review workflows
|
|
- **Stakeholder Review**: Structured feedback collection
|
|
- **Technical Review**: Early architect involvement
|
|
|
|
## Troubleshooting Integration Issues
|
|
|
|
### Common Problems
|
|
1. **Template Loading Issues**
|
|
- Check file permissions
|
|
- Verify template paths
|
|
- Validate JSON/YAML syntax
|
|
|
|
2. **API Connection Problems**
|
|
- Verify API keys
|
|
- Check network connectivity
|
|
- Review rate limiting
|
|
|
|
3. **Workflow Synchronization**
|
|
- Check webhook configurations
|
|
- Verify event handlers
|
|
- Review integration logs
|
|
|
|
### Support Resources
|
|
- **Documentation**: Comprehensive integration docs
|
|
- **Community**: BMAD Method community forums
|
|
- **Support**: Technical support channels
|
|
|
|
## Best Practices
|
|
|
|
### Integration Maintenance
|
|
- Regular template updates
|
|
- API version management
|
|
- Integration testing procedures
|
|
- Performance monitoring
|
|
|
|
### Security Considerations
|
|
- API key management
|
|
- Data privacy compliance
|
|
- Access control implementation
|
|
- Audit trail maintenance
|
|
|
|
---
|
|
|
|
*This integration guide ensures seamless incorporation of the PM persona into your existing development workflow. For specific implementation questions, consult the troubleshooting section or contact support.*
|