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

11 KiB
Raw Blame History

Business Analyst (Analyst) - Integration Guide

Environment Setup

Web Environment (v0.dev)

The Business Analyst persona is optimized for web-based collaboration and research activities.

Initial Setup

  1. Access the BMAD Method workspace

    Navigate to your v0.dev workspace
Load the BMAD Method configuration
Select "Analyst" persona from the persona menu

  2. Verify persona activation

    Confirm persona displays: "Business Analyst - Insightful Analyst & Strategic Ideation Partner"
Check that core principles are loaded and active
Validate access to brainstorming, research, and briefing modes

  3. Configure working environment

    Set up document templates and frameworks
Configure research source bookmarks
Prepare collaboration tools and shared workspaces

IDE Environment Setup

For teams using IDE-based workflows, the Business Analyst persona can be integrated into development environments.

Configuration Steps

  1. Load persona configuration

    Copy bmad-agent/personas/analyst.md to your IDE agent configuration
Ensure all core principles and operating instructions are loaded
Verify access to task templates and frameworks

  2. Set up working directories

    /research - For research documentation and findings
/briefs - For project briefs and specifications
/templates - For reusable frameworks and templates
/collaboration - For stakeholder communication and feedback

  3. Configure integration points

    Link to Product Manager workflows
Connect to UX/UI research processes
Establish handoff procedures to technical teams

BMAD Method Workflow Integration

Phase 1: Initial Engagement

The Business Analyst typically enters the workflow at the beginning of projects or when research and analysis are needed.

Entry Points

  • New Project Initiation: When business requirements need clarification
  • Market Research Requests: When competitive or market analysis is required
  • Problem Definition: When challenges need structured analysis
  • Strategic Planning: When long-term planning requires research support

Handoff Procedures

# From Stakeholders/Business Users
- Receive initial problem statements or opportunities
- Gather high-level business objectives and constraints
- Understand stakeholder expectations and success criteria
- Document initial scope and timeline requirements

# To Business Analyst
- Clarify analysis objectives and desired outcomes
- Define research scope and methodology
- Establish communication protocols and review cycles
- Set up collaborative workspaces and documentation systems

Phase 2: Analysis and Research Execution

Working Modes Integration

Brainstorming Mode Integration

# Typical Workflow
1. Stakeholder presents challenge or opportunity
2. Analyst facilitates ideation sessions
3. Ideas are captured and organized
4. Key insights are synthesized and prioritized
5. Recommendations are developed for next steps

# Integration Points
- With Product Managers: Validate market assumptions
- With UX/UI Teams: Explore user experience implications
- With Technical Teams: Assess feasibility of concepts

Research Mode Integration

# Typical Workflow
1. Research objectives are defined collaboratively
2. Comprehensive research prompt is developed
3. Research is executed (by Analyst or dedicated research team)
4. Findings are analyzed and synthesized
5. Insights are documented and communicated

# Integration Points
- With Product Managers: Market and competitive intelligence
- With System Architects: Technical feasibility research
- With Product Owners: Detailed requirement specifications

Project Briefing Mode Integration

# Typical Workflow
1. Analysis and research findings are compiled
2. Project brief is developed using standard template
3. Stakeholders review and provide feedback
4. Brief is finalized and approved
5. Handoff to development team is executed

# Integration Points
- With Product Managers: Strategic alignment validation
- With Product Owners: Requirement specification handoff
- With Development Teams: Project scope and success criteria communication

Phase 3: Handoff and Transition

Downstream Integrations

To Product Manager (John)

# Handoff Package
- Market research findings and competitive analysis
- User research insights and persona definitions
- Strategic recommendations and opportunity assessment
- Risk analysis and mitigation strategies

# Success Criteria
- Market assumptions are validated or flagged for further research
- Competitive landscape is clearly understood
- User needs and pain points are documented
- Strategic direction is supported by evidence

To System Architect (Fred)

# Handoff Package
- Technical feasibility research and analysis
- Solution option evaluation and recommendations
- Integration requirements and constraints
- Performance and scalability considerations

# Success Criteria
- Technical approach is informed by research
- Architecture decisions are supported by analysis
- Integration challenges are identified and addressed
- Performance requirements are clearly defined

To Product Owner (Sarah)

# Handoff Package
- Detailed project brief with clear scope and objectives
- User stories and acceptance criteria templates
- Priority matrix and feature roadmap recommendations
- Success metrics and measurement framework

# Success Criteria
- Project scope is clearly defined and agreed upon
- User stories are well-structured and testable
- Priorities are based on evidence and stakeholder input
- Success can be measured and validated

Third-Party Tool Integrations

Research and Analysis Tools

Market Research Platforms

# Integration Options
- **Statista**: Market data and industry reports
- **IBISWorld**: Industry analysis and forecasting
- **Gartner**: Technology and business intelligence
- **Forrester**: Research and advisory services

# Setup Process
1. Configure API access or manual data import processes
2. Establish data validation and quality assurance procedures
3. Create templates for research documentation and citation
4. Set up regular data refresh and update cycles

Survey and Feedback Tools

# Integration Options
- **SurveyMonkey**: User research and feedback collection
- **Typeform**: Interactive surveys and questionnaires
- **UserVoice**: Customer feedback and feature requests
- **Hotjar**: User behavior analysis and heatmaps

# Setup Process
1. Configure survey templates and question libraries
2. Establish data collection and analysis workflows
3. Create reporting templates and dashboard views
4. Set up automated data export and integration processes

Collaboration and Documentation Tools

Documentation Platforms

# Integration Options
- **Confluence**: Team collaboration and knowledge management
- **Notion**: All-in-one workspace for documentation and planning
- **GitBook**: Technical documentation and knowledge bases
- **Coda**: Interactive documents and databases

# Setup Process
1. Create template libraries for common document types
2. Establish version control and review processes
3. Configure access permissions and sharing protocols
4. Set up automated backup and archival procedures

Communication Tools

# Integration Options
- **Slack**: Team communication and collaboration
- **Microsoft Teams**: Enterprise communication and file sharing
- **Zoom**: Video conferencing and screen sharing
- **Miro**: Visual collaboration and brainstorming

# Setup Process
1. Configure channels and workspaces for project communication
2. Establish meeting templates and facilitation guidelines
3. Create shared workspaces for collaborative analysis
4. Set up automated notifications and status updates

Project Management Integration

Agile and Project Management Tools

# Integration Options
- **Jira**: Issue tracking and project management
- **Azure DevOps**: End-to-end development lifecycle management
- **Asana**: Team collaboration and task management
- **Monday.com**: Work operating system and project tracking

# Setup Process
1. Configure project templates and workflow processes
2. Establish requirement tracking and traceability
3. Create reporting dashboards and status views
4. Set up automated handoff and notification processes

Quality Assurance Integration

Review and Validation Processes

Peer Review Integration

# Review Process
1. **Internal Review**: Self-assessment using quality checklists
2. **Peer Review**: Cross-validation by other Business Analysts
3. **Stakeholder Review**: Validation by business stakeholders
4. **Technical Review**: Feasibility assessment by technical teams

# Quality Gates
- Research methodology is sound and appropriate
- Findings are supported by credible evidence
- Recommendations are actionable and prioritized
- Documentation meets established standards

Continuous Improvement Integration

# Improvement Process
1. **Retrospective Analysis**: Regular review of completed projects
2. **Feedback Collection**: Systematic gathering of stakeholder input
3. **Process Refinement**: Continuous improvement of methods and tools
4. **Knowledge Sharing**: Documentation and dissemination of lessons learned

# Success Metrics
- Stakeholder satisfaction with analysis quality
- Time-to-insight improvement over time
- Accuracy of predictions and recommendations
- Adoption rate of recommended solutions

Troubleshooting Integration Issues

Common Integration Challenges

Challenge: Inconsistent handoff documentation Solution: Implement standardized templates and checklists for all handoff processes

Challenge: Misaligned expectations between teams Solution: Establish clear communication protocols and regular alignment checkpoints

Challenge: Research findings not actionable Solution: Focus on specific, measurable outcomes and validate actionability with downstream teams

Challenge: Tool integration complexity Solution: Start with core integrations and gradually expand based on demonstrated value

Support and Escalation

Internal Support

  • Documentation: Comprehensive guides and templates
  • Training: Regular skill development and tool training
  • Mentoring: Peer support and knowledge sharing programs

External Support

  • Vendor Support: Direct support from tool and platform providers
  • Community Resources: Industry forums and professional networks
  • Consulting Services: Specialized expertise for complex integrations

This integration guide provides the framework for successfully incorporating the Business Analyst persona into your BMAD Method implementation. For specific setup instructions and troubleshooting, refer to the Comprehensive Guide and Quick Start Guide.