bmad初始化
This commit is contained in:
180
bmad/bmm/workflows/1-analysis/product-brief/README.md
Normal file
180
bmad/bmm/workflows/1-analysis/product-brief/README.md
Normal file
@@ -0,0 +1,180 @@
|
||||
# Product Brief Workflow
|
||||
|
||||
## Overview
|
||||
|
||||
Interactive product brief creation workflow that guides users through defining their product vision with multiple input sources and conversational collaboration. Supports both structured interactive mode and rapid "YOLO" mode for quick draft generation.
|
||||
|
||||
## Key Features
|
||||
|
||||
- **Dual Mode Operation** - Interactive step-by-step or rapid draft generation
|
||||
- **Multi-Input Support** - Integrates market research, competitive analysis, and brainstorming results
|
||||
- **Conversational Design** - Guides users through strategic thinking with probing questions
|
||||
- **Executive Summary Generation** - Creates compelling summaries for stakeholder communication
|
||||
- **Comprehensive Coverage** - Addresses all critical product planning dimensions
|
||||
- **Stakeholder Ready** - Generates professional briefs suitable for PM handoff
|
||||
|
||||
## Usage
|
||||
|
||||
### Basic Invocation
|
||||
|
||||
```bash
|
||||
workflow product-brief
|
||||
```
|
||||
|
||||
### With Input Documents
|
||||
|
||||
```bash
|
||||
# With market research
|
||||
workflow product-brief --input market-research.md
|
||||
|
||||
# With multiple inputs
|
||||
workflow product-brief --input market-research.md --input competitive-analysis.md
|
||||
```
|
||||
|
||||
### Configuration
|
||||
|
||||
- **brief_format**: "comprehensive" (full detail) or "executive" (3-page limit)
|
||||
- **autonomous**: false (requires user collaboration)
|
||||
- **output_folder**: Location for generated brief
|
||||
|
||||
## Workflow Structure
|
||||
|
||||
### Files Included
|
||||
|
||||
```
|
||||
product-brief/
|
||||
├── workflow.yaml # Configuration and metadata
|
||||
├── instructions.md # Interactive workflow steps
|
||||
├── template.md # Product brief document structure
|
||||
├── checklist.md # Validation criteria
|
||||
└── README.md # This file
|
||||
```
|
||||
|
||||
## Workflow Process
|
||||
|
||||
### Phase 1: Initialization and Context (Steps 0-2)
|
||||
|
||||
- **Project Setup**: Captures project name and basic context
|
||||
- **Input Gathering**: Collects and analyzes available documents
|
||||
- **Mode Selection**: Chooses interactive or YOLO collaboration approach
|
||||
- **Context Extraction**: Identifies core problems and opportunities
|
||||
|
||||
### Phase 2: Interactive Development (Steps 3-12) - Interactive Mode
|
||||
|
||||
- **Problem Definition**: Deep dive into user pain points and market gaps
|
||||
- **Solution Articulation**: Develops clear value proposition and approach
|
||||
- **User Segmentation**: Defines primary and secondary target audiences
|
||||
- **Success Metrics**: Establishes measurable goals and KPIs
|
||||
- **MVP Scoping**: Ruthlessly defines minimum viable features
|
||||
- **Financial Planning**: Assesses ROI and strategic alignment
|
||||
- **Technical Context**: Captures platform and technology considerations
|
||||
- **Risk Assessment**: Identifies constraints, assumptions, and unknowns
|
||||
|
||||
### Phase 3: Rapid Generation (Steps 3-4) - YOLO Mode
|
||||
|
||||
- **Complete Draft**: Generates full brief based on initial context
|
||||
- **Iterative Refinement**: User-guided section improvements
|
||||
- **Quality Validation**: Ensures completeness and consistency
|
||||
|
||||
### Phase 4: Finalization (Steps 13-15)
|
||||
|
||||
- **Executive Summary**: Creates compelling overview for stakeholders
|
||||
- **Supporting Materials**: Compiles research summaries and references
|
||||
- **Final Review**: Quality check and handoff preparation
|
||||
|
||||
## Output
|
||||
|
||||
### Generated Files
|
||||
|
||||
- **Primary output**: product-brief-{project_name}-{date}.md
|
||||
- **Supporting files**: Research summaries and stakeholder input documentation
|
||||
|
||||
### Output Structure
|
||||
|
||||
1. **Executive Summary** - High-level product concept and value proposition
|
||||
2. **Problem Statement** - Detailed problem analysis with evidence
|
||||
3. **Proposed Solution** - Core approach and key differentiators
|
||||
4. **Target Users** - Primary and secondary user segments with personas
|
||||
5. **Goals and Success Metrics** - Business objectives and measurable KPIs
|
||||
6. **MVP Scope** - Must-have features and out-of-scope items
|
||||
7. **Post-MVP Vision** - Phase 2 features and long-term roadmap
|
||||
8. **Financial Impact** - Investment requirements and ROI projections
|
||||
9. **Strategic Alignment** - Connection to company OKRs and initiatives
|
||||
10. **Technical Considerations** - Platform requirements and preferences
|
||||
11. **Constraints and Assumptions** - Resource limits and key assumptions
|
||||
12. **Risks and Open Questions** - Risk assessment and research needs
|
||||
13. **Supporting Materials** - Research summaries and references
|
||||
|
||||
## Requirements
|
||||
|
||||
No special requirements - designed to work with or without existing documentation.
|
||||
|
||||
## Best Practices
|
||||
|
||||
### Before Starting
|
||||
|
||||
1. **Gather Available Research**: Collect any market research, competitive analysis, or user feedback
|
||||
2. **Define Stakeholder Audience**: Know who will use this brief for decision-making
|
||||
3. **Set Time Boundaries**: Interactive mode requires 60-90 minutes for quality results
|
||||
|
||||
### During Execution
|
||||
|
||||
1. **Be Specific**: Avoid generic statements - provide concrete examples and data
|
||||
2. **Think Strategically**: Focus on "why" and "what" rather than "how"
|
||||
3. **Challenge Assumptions**: Use the conversation to test and refine your thinking
|
||||
4. **Scope Ruthlessly**: Resist feature creep in MVP definition
|
||||
|
||||
### After Completion
|
||||
|
||||
1. **Validate with Checklist**: Use included criteria to ensure completeness
|
||||
2. **Stakeholder Review**: Share executive summary first, then full brief
|
||||
3. **Iterate Based on Feedback**: Product briefs should evolve with new insights
|
||||
|
||||
## Troubleshooting
|
||||
|
||||
### Common Issues
|
||||
|
||||
**Issue**: Brief lacks specificity or contains vague statements
|
||||
|
||||
- **Solution**: Restart problem definition with concrete examples and measurable impacts
|
||||
- **Check**: Ensure each section answers "so what?" and provides actionable insights
|
||||
|
||||
**Issue**: MVP scope is too large or undefined
|
||||
|
||||
- **Solution**: Use the "what's the minimum to validate core hypothesis?" filter
|
||||
- **Check**: Verify that each MVP feature is truly essential for initial value delivery
|
||||
|
||||
**Issue**: Missing strategic context or business justification
|
||||
|
||||
- **Solution**: Return to financial impact and strategic alignment sections
|
||||
- **Check**: Ensure connection to company goals and clear ROI potential
|
||||
|
||||
## Customization
|
||||
|
||||
To customize this workflow:
|
||||
|
||||
1. **Modify Questions**: Update instructions.md to add industry-specific or company-specific prompts
|
||||
2. **Adjust Template**: Customize template.md sections for organizational brief standards
|
||||
3. **Add Validation**: Extend checklist.md with company-specific quality criteria
|
||||
4. **Configure Modes**: Adjust brief_format settings for different output styles
|
||||
|
||||
## Version History
|
||||
|
||||
- **v6.0.0** - Interactive conversational design with dual modes
|
||||
- Interactive and YOLO mode support
|
||||
- Multi-input document integration
|
||||
- Executive summary generation
|
||||
- Strategic alignment focus
|
||||
|
||||
## Support
|
||||
|
||||
For issues or questions:
|
||||
|
||||
- Review the workflow creation guide at `/bmad/bmb/workflows/create-workflow/workflow-creation-guide.md`
|
||||
- Validate output using `checklist.md`
|
||||
- Consider running market research workflow first if lacking business context
|
||||
- Consult BMAD documentation for product planning methodology
|
||||
|
||||
---
|
||||
|
||||
_Part of the BMad Method v6 - BMM (Method) Module_
|
||||
115
bmad/bmm/workflows/1-analysis/product-brief/checklist.md
Normal file
115
bmad/bmm/workflows/1-analysis/product-brief/checklist.md
Normal file
@@ -0,0 +1,115 @@
|
||||
# Product Brief Validation Checklist
|
||||
|
||||
## Document Structure
|
||||
|
||||
- [ ] All required sections are present (Executive Summary through Appendices)
|
||||
- [ ] No placeholder text remains (e.g., [TODO], [NEEDS CONFIRMATION], {{variable}})
|
||||
- [ ] Document follows the standard brief template format
|
||||
- [ ] Sections are properly numbered and formatted with headers
|
||||
- [ ] Cross-references between sections are accurate
|
||||
|
||||
## Executive Summary Quality
|
||||
|
||||
- [ ] Product concept is explained in 1-2 clear sentences
|
||||
- [ ] Primary problem is clearly identified
|
||||
- [ ] Target market is specifically named (not generic)
|
||||
- [ ] Value proposition is compelling and differentiated
|
||||
- [ ] Summary accurately reflects the full document content
|
||||
|
||||
## Problem Statement
|
||||
|
||||
- [ ] Current state pain points are specific and measurable
|
||||
- [ ] Impact is quantified where possible (time, money, opportunities)
|
||||
- [ ] Explanation of why existing solutions fall short is provided
|
||||
- [ ] Urgency for solving the problem now is justified
|
||||
- [ ] Problem is validated with evidence or data points
|
||||
|
||||
## Solution Definition
|
||||
|
||||
- [ ] Core approach is clearly explained without implementation details
|
||||
- [ ] Key differentiators from existing solutions are identified
|
||||
- [ ] Explanation of why this will succeed is compelling
|
||||
- [ ] Solution aligns directly with stated problems
|
||||
- [ ] Vision paints a clear picture of the user experience
|
||||
|
||||
## Target Users
|
||||
|
||||
- [ ] Primary user segment has specific demographic/firmographic profile
|
||||
- [ ] User behaviors and current workflows are documented
|
||||
- [ ] Specific pain points are tied to user segments
|
||||
- [ ] User goals are clearly articulated
|
||||
- [ ] Secondary segment (if applicable) is equally detailed
|
||||
- [ ] Avoids generic personas like "busy professionals"
|
||||
|
||||
## Goals and Metrics
|
||||
|
||||
- [ ] Business objectives include measurable outcomes with targets
|
||||
- [ ] User success metrics focus on behaviors, not features
|
||||
- [ ] 3-5 KPIs are defined with clear definitions
|
||||
- [ ] All goals follow SMART criteria (Specific, Measurable, Achievable, Relevant, Time-bound)
|
||||
- [ ] Success metrics align with problem statement
|
||||
|
||||
## MVP Scope
|
||||
|
||||
- [ ] Core features list contains only true must-haves
|
||||
- [ ] Each core feature includes rationale for why it's essential
|
||||
- [ ] Out of scope section explicitly lists deferred features
|
||||
- [ ] MVP success criteria are specific and measurable
|
||||
- [ ] Scope is genuinely minimal and viable
|
||||
- [ ] No feature creep evident in "must-have" list
|
||||
|
||||
## Technical Considerations
|
||||
|
||||
- [ ] Target platforms are specified (web/mobile/desktop)
|
||||
- [ ] Browser/OS support requirements are documented
|
||||
- [ ] Performance requirements are defined if applicable
|
||||
- [ ] Accessibility requirements are noted
|
||||
- [ ] Technology preferences are marked as preferences, not decisions
|
||||
- [ ] Integration requirements with existing systems are identified
|
||||
|
||||
## Constraints and Assumptions
|
||||
|
||||
- [ ] Budget constraints are documented if known
|
||||
- [ ] Timeline or deadline pressures are specified
|
||||
- [ ] Team/resource limitations are acknowledged
|
||||
- [ ] Technical constraints are clearly stated
|
||||
- [ ] Key assumptions are listed and testable
|
||||
- [ ] Assumptions will be validated during development
|
||||
|
||||
## Risk Assessment (if included)
|
||||
|
||||
- [ ] Key risks include potential impact descriptions
|
||||
- [ ] Open questions are specific and answerable
|
||||
- [ ] Research areas are identified with clear objectives
|
||||
- [ ] Risk mitigation strategies are suggested where applicable
|
||||
|
||||
## Overall Quality
|
||||
|
||||
- [ ] Language is clear and free of jargon
|
||||
- [ ] Terminology is used consistently throughout
|
||||
- [ ] Document is ready for handoff to Product Manager
|
||||
- [ ] All [PM-TODO] items are clearly marked if present
|
||||
- [ ] References and source documents are properly cited
|
||||
|
||||
## Completeness Check
|
||||
|
||||
- [ ] Document provides sufficient detail for PRD creation
|
||||
- [ ] All user inputs have been incorporated
|
||||
- [ ] Market research findings are reflected if provided
|
||||
- [ ] Competitive analysis insights are included if available
|
||||
- [ ] Brief aligns with overall product strategy
|
||||
|
||||
## Final Validation
|
||||
|
||||
### Critical Issues Found:
|
||||
|
||||
- [ ] None identified
|
||||
|
||||
### Minor Issues to Address:
|
||||
|
||||
- [ ] List any minor issues here
|
||||
|
||||
### Ready for PM Handoff:
|
||||
|
||||
- [ ] Yes, brief is complete and validated
|
||||
- [ ] No, requires additional work (specify above)
|
||||
332
bmad/bmm/workflows/1-analysis/product-brief/instructions.md
Normal file
332
bmad/bmm/workflows/1-analysis/product-brief/instructions.md
Normal file
@@ -0,0 +1,332 @@
|
||||
# Product Brief - Interactive Workflow Instructions
|
||||
|
||||
<critical>The workflow execution engine is governed by: {project-root}/bmad/core/tasks/workflow.xml</critical>
|
||||
<critical>You MUST have already loaded and processed: {installed_path}/workflow.yaml</critical>
|
||||
<critical>Communicate all responses in {communication_language} and language MUST be tailored to {user_skill_level}</critical>
|
||||
<critical>Generate all documents in {document_output_language}</critical>
|
||||
|
||||
<critical>DOCUMENT OUTPUT: Concise, professional, strategically focused. Use tables/lists over prose. User skill level ({user_skill_level}) affects conversation style ONLY, not document content.</critical>
|
||||
|
||||
<workflow>
|
||||
|
||||
<step n="0" goal="Validate workflow readiness" tag="workflow-status">
|
||||
<action>Check if {output_folder}/bmm-workflow-status.yaml exists</action>
|
||||
|
||||
<check if="status file not found">
|
||||
<output>No workflow status file found. Product Brief is optional - you can continue without status tracking.</output>
|
||||
<action>Set standalone_mode = true</action>
|
||||
</check>
|
||||
|
||||
<check if="status file found">
|
||||
<action>Load the FULL file: {output_folder}/bmm-workflow-status.yaml</action>
|
||||
<action>Parse workflow_status section</action>
|
||||
<action>Check status of "product-brief" workflow</action>
|
||||
<action>Get project_level from YAML metadata</action>
|
||||
<action>Find first non-completed workflow (next expected workflow)</action>
|
||||
|
||||
<check if="project_level < 2">
|
||||
<output>Note: Product Brief is most valuable for Level 2+ projects. Your project is Level {{project_level}}.</output>
|
||||
<output>You may want to skip directly to technical planning instead.</output>
|
||||
</check>
|
||||
|
||||
<check if="product-brief status is file path (already completed)">
|
||||
<output>⚠️ Product Brief already completed: {{product-brief status}}</output>
|
||||
<ask>Re-running will overwrite the existing brief. Continue? (y/n)</ask>
|
||||
<check if="n">
|
||||
<output>Exiting. Use workflow-status to see your next step.</output>
|
||||
<action>Exit workflow</action>
|
||||
</check>
|
||||
</check>
|
||||
|
||||
<check if="product-brief is not the next expected workflow (latter items are completed already in the list)">
|
||||
<output>⚠️ Next expected workflow: {{next_workflow}}. Product Brief is out of sequence.</output>
|
||||
<ask>Continue with Product Brief anyway? (y/n)</ask>
|
||||
<check if="n">
|
||||
<output>Exiting. Run {{next_workflow}} instead.</output>
|
||||
<action>Exit workflow</action>
|
||||
</check>
|
||||
</check>
|
||||
|
||||
<action>Set standalone_mode = false</action>
|
||||
</check>
|
||||
</step>
|
||||
|
||||
<step n="1" goal="Initialize product brief session">
|
||||
<action>Welcome the user in {communication_language} to the Product Brief creation process</action>
|
||||
<action>Explain this is a collaborative process to define their product vision and strategic foundation</action>
|
||||
<action>Ask the user to provide the project name for this product brief</action>
|
||||
<template-output>project_name</template-output>
|
||||
</step>
|
||||
|
||||
<step n="1" goal="Gather available inputs and context">
|
||||
<action>Explore what existing materials the user has available to inform the brief</action>
|
||||
<action>Offer options for input sources: market research, brainstorming results, competitive analysis, initial ideas, or starting fresh</action>
|
||||
<action>If documents are provided, load and analyze them to extract key insights, themes, and patterns</action>
|
||||
<action>Engage the user about their core vision: what problem they're solving, who experiences it most acutely, and what sparked this product idea</action>
|
||||
<action>Build initial understanding through conversational exploration rather than rigid questioning</action>
|
||||
|
||||
<template-output>initial_context</template-output>
|
||||
</step>
|
||||
|
||||
<step n="2" goal="Choose collaboration mode">
|
||||
<ask>How would you like to work through the brief?
|
||||
|
||||
**1. Interactive Mode** - We'll work through each section together, discussing and refining as we go
|
||||
|
||||
**2. YOLO Mode** - I'll generate a complete draft based on our conversation so far, then we'll refine it together
|
||||
|
||||
Which approach works best for you?</ask>
|
||||
|
||||
<action>Store the user's preference for mode</action>
|
||||
<template-output>collaboration_mode</template-output>
|
||||
</step>
|
||||
|
||||
<step n="3" goal="Define the problem statement" if="collaboration_mode == 'interactive'">
|
||||
<action>Guide deep exploration of the problem: current state frustrations, quantifiable impact (time/money/opportunities), why existing solutions fall short, urgency of solving now</action>
|
||||
<action>Challenge vague statements and push for specificity with probing questions</action>
|
||||
<action>Help the user articulate measurable pain points with evidence</action>
|
||||
<action>Craft a compelling, evidence-based problem statement</action>
|
||||
|
||||
<template-output>problem_statement</template-output>
|
||||
</step>
|
||||
|
||||
<step n="4" goal="Develop the proposed solution" if="collaboration_mode == 'interactive'">
|
||||
<action>Shape the solution vision by exploring: core approach to solving the problem, key differentiators from existing solutions, why this will succeed, ideal user experience</action>
|
||||
<action>Focus on the "what" and "why", not implementation details - keep it strategic</action>
|
||||
<action>Help articulate compelling differentiators that make this solution unique</action>
|
||||
<action>Craft a clear, inspiring solution vision</action>
|
||||
|
||||
<template-output>proposed_solution</template-output>
|
||||
</step>
|
||||
|
||||
<step n="5" goal="Identify target users" if="collaboration_mode == 'interactive'">
|
||||
<action>Guide detailed definition of primary users: demographic/professional profile, current problem-solving methods, specific pain points, goals they're trying to achieve</action>
|
||||
<action>Explore secondary user segments if applicable and define how their needs differ</action>
|
||||
<action>Push beyond generic personas like "busy professionals" - demand specificity and actionable details</action>
|
||||
<action>Create specific, actionable user profiles that inform product decisions</action>
|
||||
|
||||
<template-output>primary_user_segment</template-output>
|
||||
<template-output>secondary_user_segment</template-output>
|
||||
</step>
|
||||
|
||||
<step n="6" goal="Establish goals and success metrics" if="collaboration_mode == 'interactive'">
|
||||
<action>Guide establishment of SMART goals across business objectives and user success metrics</action>
|
||||
<action>Explore measurable business outcomes (user acquisition targets, cost reductions, revenue goals)</action>
|
||||
<action>Define user success metrics focused on behaviors and outcomes, not features (task completion time, return frequency)</action>
|
||||
<action>Help formulate specific, measurable goals that distinguish between business and user success</action>
|
||||
<action>Identify top 3-5 Key Performance Indicators that will track product success</action>
|
||||
|
||||
<template-output>business_objectives</template-output>
|
||||
<template-output>user_success_metrics</template-output>
|
||||
<template-output>key_performance_indicators</template-output>
|
||||
</step>
|
||||
|
||||
<step n="7" goal="Define MVP scope" if="collaboration_mode == 'interactive'">
|
||||
<action>Be ruthless about MVP scope - identify absolute MUST-HAVE features for launch that validate the core hypothesis</action>
|
||||
<action>For each proposed feature, probe why it's essential vs nice-to-have</action>
|
||||
<action>Identify tempting features that need to wait for v2 - what adds complexity without core value</action>
|
||||
<action>Define what constitutes a successful MVP launch with clear criteria</action>
|
||||
<action>Challenge scope creep aggressively and push for true minimum viability</action>
|
||||
<action>Clearly separate must-haves from nice-to-haves</action>
|
||||
|
||||
<template-output>core_features</template-output>
|
||||
<template-output>out_of_scope</template-output>
|
||||
<template-output>mvp_success_criteria</template-output>
|
||||
</step>
|
||||
|
||||
<step n="8" goal="Assess financial impact and ROI" if="collaboration_mode == 'interactive'">
|
||||
<action>Explore financial considerations: development investment, revenue potential, cost savings opportunities, break-even timing, budget alignment</action>
|
||||
<action>Investigate strategic alignment: company OKRs, strategic objectives, key initiatives supported, opportunity cost of NOT doing this</action>
|
||||
<action>Help quantify financial impact where possible - both tangible and intangible value</action>
|
||||
<action>Connect this product to broader company strategy and demonstrate strategic value</action>
|
||||
|
||||
<template-output>financial_impact</template-output>
|
||||
<template-output>company_objectives_alignment</template-output>
|
||||
<template-output>strategic_initiatives</template-output>
|
||||
</step>
|
||||
|
||||
<step n="9" goal="Explore post-MVP vision" optional="true" if="collaboration_mode == 'interactive'">
|
||||
<action>Guide exploration of post-MVP future: Phase 2 features, expansion opportunities, long-term vision (1-2 years)</action>
|
||||
<action>Ensure MVP decisions align with future direction while staying focused on immediate goals</action>
|
||||
|
||||
<template-output>phase_2_features</template-output>
|
||||
<template-output>long_term_vision</template-output>
|
||||
<template-output>expansion_opportunities</template-output>
|
||||
</step>
|
||||
|
||||
<step n="10" goal="Document technical considerations" if="collaboration_mode == 'interactive'">
|
||||
<action>Capture technical context as preferences, not final decisions</action>
|
||||
<action>Explore platform requirements: web/mobile/desktop, browser/OS support, performance needs, accessibility standards</action>
|
||||
<action>Investigate technology preferences or constraints: frontend/backend frameworks, database needs, infrastructure requirements</action>
|
||||
<action>Identify existing systems requiring integration</action>
|
||||
<action>Check for technical-preferences.yaml file if available</action>
|
||||
<action>Note these are initial thoughts for PM and architect to consider during planning</action>
|
||||
|
||||
<template-output>platform_requirements</template-output>
|
||||
<template-output>technology_preferences</template-output>
|
||||
<template-output>architecture_considerations</template-output>
|
||||
</step>
|
||||
|
||||
<step n="11" goal="Identify constraints and assumptions" if="collaboration_mode == 'interactive'">
|
||||
<action>Guide realistic expectations setting around constraints: budget/resource limits, timeline pressures, team size/expertise, technical limitations</action>
|
||||
<action>Explore assumptions being made about: user behavior, market conditions, technical feasibility</action>
|
||||
<action>Document constraints clearly and list assumptions that need validation during development</action>
|
||||
|
||||
<template-output>constraints</template-output>
|
||||
<template-output>key_assumptions</template-output>
|
||||
</step>
|
||||
|
||||
<step n="12" goal="Assess risks and open questions" optional="true" if="collaboration_mode == 'interactive'">
|
||||
<action>Facilitate honest risk assessment: what could derail the project, impact if risks materialize</action>
|
||||
<action>Document open questions: what still needs figuring out, what needs more research</action>
|
||||
<action>Help prioritize risks by impact and likelihood</action>
|
||||
<action>Frame unknowns as opportunities to prepare, not just worries</action>
|
||||
|
||||
<template-output>key_risks</template-output>
|
||||
<template-output>open_questions</template-output>
|
||||
<template-output>research_areas</template-output>
|
||||
</step>
|
||||
|
||||
<!-- YOLO Mode - Generate everything then refine -->
|
||||
<step n="3" goal="Generate complete brief draft" if="collaboration_mode == 'yolo'">
|
||||
<action>Based on initial context and any provided documents, generate a complete product brief covering all sections</action>
|
||||
<action>Make reasonable assumptions where information is missing</action>
|
||||
<action>Flag areas that need user validation with [NEEDS CONFIRMATION] tags</action>
|
||||
|
||||
<template-output>problem_statement</template-output>
|
||||
<template-output>proposed_solution</template-output>
|
||||
<template-output>primary_user_segment</template-output>
|
||||
<template-output>secondary_user_segment</template-output>
|
||||
<template-output>business_objectives</template-output>
|
||||
<template-output>user_success_metrics</template-output>
|
||||
<template-output>key_performance_indicators</template-output>
|
||||
<template-output>core_features</template-output>
|
||||
<template-output>out_of_scope</template-output>
|
||||
<template-output>mvp_success_criteria</template-output>
|
||||
<template-output>phase_2_features</template-output>
|
||||
<template-output>long_term_vision</template-output>
|
||||
<template-output>expansion_opportunities</template-output>
|
||||
<template-output>financial_impact</template-output>
|
||||
<template-output>company_objectives_alignment</template-output>
|
||||
<template-output>strategic_initiatives</template-output>
|
||||
<template-output>platform_requirements</template-output>
|
||||
<template-output>technology_preferences</template-output>
|
||||
<template-output>architecture_considerations</template-output>
|
||||
<template-output>constraints</template-output>
|
||||
<template-output>key_assumptions</template-output>
|
||||
<template-output>key_risks</template-output>
|
||||
<template-output>open_questions</template-output>
|
||||
<template-output>research_areas</template-output>
|
||||
|
||||
<action>Present the complete draft to the user</action>
|
||||
<ask>Here's the complete brief draft. What would you like to adjust or refine?</ask>
|
||||
</step>
|
||||
|
||||
<step n="4" goal="Refine brief sections" repeat="until-approved" if="collaboration_mode == 'yolo'">
|
||||
<ask>Which section would you like to refine?
|
||||
1. Problem Statement
|
||||
2. Proposed Solution
|
||||
3. Target Users
|
||||
4. Goals and Metrics
|
||||
5. MVP Scope
|
||||
6. Post-MVP Vision
|
||||
7. Financial Impact and Strategic Alignment
|
||||
8. Technical Considerations
|
||||
9. Constraints and Assumptions
|
||||
10. Risks and Questions
|
||||
11. Save and continue</ask>
|
||||
|
||||
<action>Work with user to refine selected section</action>
|
||||
<action>Update relevant template outputs</action>
|
||||
</step>
|
||||
|
||||
<!-- Final steps for both modes -->
|
||||
<step n="13" goal="Create executive summary">
|
||||
<action>Synthesize all sections into a compelling executive summary</action>
|
||||
<action>Include:
|
||||
- Product concept in 1-2 sentences
|
||||
- Primary problem being solved
|
||||
- Target market identification
|
||||
- Key value proposition</action>
|
||||
|
||||
<template-output>executive_summary</template-output>
|
||||
</step>
|
||||
|
||||
<step n="14" goal="Compile supporting materials">
|
||||
<action>If research documents were provided, create a summary of key findings</action>
|
||||
<action>Document any stakeholder input received during the process</action>
|
||||
<action>Compile list of reference documents and resources</action>
|
||||
|
||||
<template-output>research_summary</template-output>
|
||||
<template-output>stakeholder_input</template-output>
|
||||
<template-output>references</template-output>
|
||||
</step>
|
||||
|
||||
<step n="15" goal="Final review and handoff">
|
||||
<action>Generate the complete product brief document</action>
|
||||
<action>Review all sections for completeness and consistency</action>
|
||||
<action>Flag any areas that need PM attention with [PM-TODO] tags</action>
|
||||
|
||||
<ask>The product brief is complete! Would you like to:
|
||||
|
||||
1. Review the entire document
|
||||
2. Make final adjustments
|
||||
3. Generate an executive summary version (3-page limit)
|
||||
4. Save and prepare for handoff to PM
|
||||
|
||||
This brief will serve as the primary input for creating the Product Requirements Document (PRD).</ask>
|
||||
|
||||
<check if="user chooses option 3 (executive summary)">
|
||||
<action>Create condensed 3-page executive brief focusing on: problem statement, proposed solution, target users, MVP scope, financial impact, and strategic alignment</action>
|
||||
<action>Save as: {output_folder}/product-brief-executive-{{project_name}}-{{date}}.md</action>
|
||||
</check>
|
||||
|
||||
<template-output>final_brief</template-output>
|
||||
<template-output>executive_brief</template-output>
|
||||
</step>
|
||||
|
||||
<step n="16" goal="Update status file on completion" tag="workflow-status">
|
||||
<check if="standalone_mode != true">
|
||||
<action>Load the FULL file: {output_folder}/bmm-workflow-status.yaml</action>
|
||||
<action>Find workflow_status key "product-brief"</action>
|
||||
<critical>ONLY write the file path as the status value - no other text, notes, or metadata</critical>
|
||||
<action>Update workflow_status["product-brief"] = "{output_folder}/bmm-product-brief-{{project_name}}-{{date}}.md"</action>
|
||||
<action>Save file, preserving ALL comments and structure including STATUS DEFINITIONS</action>
|
||||
|
||||
<action>Find first non-completed workflow in workflow_status (next workflow to do)</action>
|
||||
<action>Determine next agent from path file based on next workflow</action>
|
||||
</check>
|
||||
|
||||
<output>**✅ Product Brief Complete, {user_name}!**
|
||||
|
||||
**Brief Document:**
|
||||
|
||||
- Product brief saved to {output_folder}/bmm-product-brief-{{project_name}}-{{date}}.md
|
||||
|
||||
{{#if standalone_mode != true}}
|
||||
**Status Updated:**
|
||||
|
||||
- Progress tracking updated: product-brief marked complete
|
||||
- Next workflow: {{next_workflow}}
|
||||
{{else}}
|
||||
**Note:** Running in standalone mode (no progress tracking)
|
||||
{{/if}}
|
||||
|
||||
**Next Steps:**
|
||||
|
||||
{{#if standalone_mode != true}}
|
||||
|
||||
- **Next workflow:** {{next_workflow}} ({{next_agent}} agent)
|
||||
- **Optional:** Gather additional stakeholder input or run research workflows before proceeding
|
||||
|
||||
Check status anytime with: `workflow-status`
|
||||
{{else}}
|
||||
Since no workflow is in progress:
|
||||
|
||||
- Refer to the BMM workflow guide if unsure what to do next
|
||||
- Or run `workflow-init` to create a workflow path and get guided next steps
|
||||
{{/if}}
|
||||
</output>
|
||||
</step>
|
||||
|
||||
</workflow>
|
||||
165
bmad/bmm/workflows/1-analysis/product-brief/template.md
Normal file
165
bmad/bmm/workflows/1-analysis/product-brief/template.md
Normal file
@@ -0,0 +1,165 @@
|
||||
# Product Brief: {{project_name}}
|
||||
|
||||
**Date:** {{date}}
|
||||
**Author:** {{user_name}}
|
||||
**Status:** Draft for PM Review
|
||||
|
||||
---
|
||||
|
||||
## Executive Summary
|
||||
|
||||
{{executive_summary}}
|
||||
|
||||
---
|
||||
|
||||
## Problem Statement
|
||||
|
||||
{{problem_statement}}
|
||||
|
||||
---
|
||||
|
||||
## Proposed Solution
|
||||
|
||||
{{proposed_solution}}
|
||||
|
||||
---
|
||||
|
||||
## Target Users
|
||||
|
||||
### Primary User Segment
|
||||
|
||||
{{primary_user_segment}}
|
||||
|
||||
### Secondary User Segment
|
||||
|
||||
{{secondary_user_segment}}
|
||||
|
||||
---
|
||||
|
||||
## Goals and Success Metrics
|
||||
|
||||
### Business Objectives
|
||||
|
||||
{{business_objectives}}
|
||||
|
||||
### User Success Metrics
|
||||
|
||||
{{user_success_metrics}}
|
||||
|
||||
### Key Performance Indicators (KPIs)
|
||||
|
||||
{{key_performance_indicators}}
|
||||
|
||||
---
|
||||
|
||||
## Strategic Alignment and Financial Impact
|
||||
|
||||
### Financial Impact
|
||||
|
||||
{{financial_impact}}
|
||||
|
||||
### Company Objectives Alignment
|
||||
|
||||
{{company_objectives_alignment}}
|
||||
|
||||
### Strategic Initiatives
|
||||
|
||||
{{strategic_initiatives}}
|
||||
|
||||
---
|
||||
|
||||
## MVP Scope
|
||||
|
||||
### Core Features (Must Have)
|
||||
|
||||
{{core_features}}
|
||||
|
||||
### Out of Scope for MVP
|
||||
|
||||
{{out_of_scope}}
|
||||
|
||||
### MVP Success Criteria
|
||||
|
||||
{{mvp_success_criteria}}
|
||||
|
||||
---
|
||||
|
||||
## Post-MVP Vision
|
||||
|
||||
### Phase 2 Features
|
||||
|
||||
{{phase_2_features}}
|
||||
|
||||
### Long-term Vision
|
||||
|
||||
{{long_term_vision}}
|
||||
|
||||
### Expansion Opportunities
|
||||
|
||||
{{expansion_opportunities}}
|
||||
|
||||
---
|
||||
|
||||
## Technical Considerations
|
||||
|
||||
### Platform Requirements
|
||||
|
||||
{{platform_requirements}}
|
||||
|
||||
### Technology Preferences
|
||||
|
||||
{{technology_preferences}}
|
||||
|
||||
### Architecture Considerations
|
||||
|
||||
{{architecture_considerations}}
|
||||
|
||||
---
|
||||
|
||||
## Constraints and Assumptions
|
||||
|
||||
### Constraints
|
||||
|
||||
{{constraints}}
|
||||
|
||||
### Key Assumptions
|
||||
|
||||
{{key_assumptions}}
|
||||
|
||||
---
|
||||
|
||||
## Risks and Open Questions
|
||||
|
||||
### Key Risks
|
||||
|
||||
{{key_risks}}
|
||||
|
||||
### Open Questions
|
||||
|
||||
{{open_questions}}
|
||||
|
||||
### Areas Needing Further Research
|
||||
|
||||
{{research_areas}}
|
||||
|
||||
---
|
||||
|
||||
## Appendices
|
||||
|
||||
### A. Research Summary
|
||||
|
||||
{{research_summary}}
|
||||
|
||||
### B. Stakeholder Input
|
||||
|
||||
{{stakeholder_input}}
|
||||
|
||||
### C. References
|
||||
|
||||
{{references}}
|
||||
|
||||
---
|
||||
|
||||
_This Product Brief serves as the foundational input for Product Requirements Document (PRD) creation._
|
||||
|
||||
_Next Steps: Handoff to Product Manager for PRD development using the `workflow prd` command._
|
||||
31
bmad/bmm/workflows/1-analysis/product-brief/workflow.yaml
Normal file
31
bmad/bmm/workflows/1-analysis/product-brief/workflow.yaml
Normal file
@@ -0,0 +1,31 @@
|
||||
# Product Brief - Interactive Workflow Configuration
|
||||
name: product-brief
|
||||
description: "Interactive product brief creation workflow that guides users through defining their product vision with multiple input sources and conversational collaboration"
|
||||
author: "BMad"
|
||||
|
||||
# Critical variables from config
|
||||
config_source: "{project-root}/bmad/bmm/config.yaml"
|
||||
output_folder: "{config_source}:output_folder"
|
||||
user_name: "{config_source}:user_name"
|
||||
communication_language: "{config_source}:communication_language"
|
||||
document_output_language: "{config_source}:document_output_language"
|
||||
user_skill_level: "{config_source}:user_skill_level"
|
||||
date: system-generated
|
||||
|
||||
# Optional input documents
|
||||
recommended_inputs:
|
||||
- market_research: "Market research document (optional)"
|
||||
- brainstorming_results: "Brainstorming session outputs (optional)"
|
||||
- competitive_analysis: "Competitive analysis (optional)"
|
||||
- initial_ideas: "Initial product ideas or notes (optional)"
|
||||
|
||||
# Module path and component files
|
||||
installed_path: "{project-root}/bmad/bmm/workflows/1-analysis/product-brief"
|
||||
template: "{installed_path}/template.md"
|
||||
instructions: "{installed_path}/instructions.md"
|
||||
validation: "{installed_path}/checklist.md"
|
||||
|
||||
# Output configuration
|
||||
default_output_file: "{output_folder}/product-brief-{{project_name}}-{{date}}.md"
|
||||
|
||||
standalone: true
|
||||
Reference in New Issue
Block a user