bmad-method 4.27.6 → 5.0.0

package/.bmad-core/templates/brownfield-prd-tmpl.md

@@ -0,0 +1,240 @@
+# {{Project Name}} Brownfield Enhancement PRD
+
+[[LLM: IMPORTANT - SCOPE ASSESSMENT REQUIRED:
+
+This PRD is for SIGNIFICANT enhancements to existing projects that require comprehensive planning and multiple stories. Before proceeding:
+
+1. **Assess Enhancement Complexity**: If this is a simple feature addition or bug fix that could be completed in 1-2 focused development sessions, STOP and recommend: "For simpler changes, consider using the brownfield-create-epic or brownfield-create-story task with the Product Owner instead. This full PRD process is designed for substantial enhancements that require architectural planning and multiple coordinated stories."
+
+2. **Project Context**: Determine if we're working in an IDE with the project already loaded or if the user needs to provide project information. If project files are available, analyze existing documentation in the docs folder. If insufficient documentation exists, recommend running the document-project task first.
+
+3. **Deep Assessment Requirement**: You MUST thoroughly analyze the existing project structure, patterns, and constraints before making ANY suggestions. Every recommendation must be grounded in actual project analysis, not assumptions.]]
+
+## Intro Project Analysis and Context
+
+[[LLM: Gather comprehensive information about the existing project. This section must be completed before proceeding with requirements.
+
+CRITICAL: Throughout this analysis, explicitly confirm your understanding with the user. For every assumption you make about the existing project, ask: "Based on my analysis, I understand that [assumption]. Is this correct?"
+
+Do not proceed with any recommendations until the user has validated your understanding of the existing system.]]
+
+### Existing Project Overview
+
+[[LLM: If working in IDE with project loaded, analyze the project structure and existing documentation. If working in web interface, request project upload or detailed project information from user.]]
+
+**Project Location**: [[LLM: Note if this is IDE-based analysis or user-provided information]]
+
+**Current Project State**: [[LLM: Brief description of what the project currently does and its primary purpose]]
+
+### Available Documentation Analysis
+
+[[LLM: Check for existing documentation in docs folder or provided by user. List what documentation is available and assess its completeness. Required documents include:
+
+- Tech stack documentation
+- Source tree/architecture overview
+- Coding standards
+- API documentation or OpenAPI specs
+- External API integrations
+- UX/UI guidelines or existing patterns]]
+
+**Available Documentation**:
+
+- [ ] Tech Stack Documentation
+- [ ] Source Tree/Architecture
+- [ ] Coding Standards
+- [ ] API Documentation
+- [ ] External API Documentation
+- [ ] UX/UI Guidelines
+- [ ] Other: \***\*\_\_\_\*\***
+
+[[LLM: If critical documentation is missing, STOP and recommend: "I recommend running the document-project task first to generate baseline documentation including tech-stack, source-tree, coding-standards, APIs, external-APIs, and UX/UI information. This will provide the foundation needed for a comprehensive brownfield PRD."]]
+
+### Enhancement Scope Definition
+
+[[LLM: Work with user to clearly define what type of enhancement this is. This is critical for scoping and approach.]]
+
+**Enhancement Type**: [[LLM: Determine with user which applies]]
+
+- [ ] New Feature Addition
+- [ ] Major Feature Modification
+- [ ] Integration with New Systems
+- [ ] Performance/Scalability Improvements
+- [ ] UI/UX Overhaul
+- [ ] Technology Stack Upgrade
+- [ ] Bug Fix and Stability Improvements
+- [ ] Other: \***\*\_\_\_\*\***
+
+**Enhancement Description**: [[LLM: 2-3 sentences describing what the user wants to add or change]]
+
+**Impact Assessment**: [[LLM: Assess the scope of impact on existing codebase]]
+
+- [ ] Minimal Impact (isolated additions)
+- [ ] Moderate Impact (some existing code changes)
+- [ ] Significant Impact (substantial existing code changes)
+- [ ] Major Impact (architectural changes required)
+
+### Goals and Background Context
+
+#### Goals
+
+[[LLM: Bullet list of 1-line desired outcomes this enhancement will deliver if successful]]
+
+#### Background Context
+
+[[LLM: 1-2 short paragraphs explaining why this enhancement is needed, what problem it solves, and how it fits with the existing project]]
+
+### Change Log
+
+| Change | Date | Version | Description | Author |
+| ------ | ---- | ------- | ----------- | ------ |
+
+## Requirements
+
+[[LLM: Draft functional and non-functional requirements based on your validated understanding of the existing project. Before presenting requirements, confirm: "These requirements are based on my understanding of your existing system. Please review carefully and confirm they align with your project's reality." Then immediately execute tasks#advanced-elicitation display]]
+
+### Functional
+
+[[LLM: Each Requirement will be a bullet markdown with identifier starting with FR]]
+@{example: - FR1: The existing Todo List will integrate with the new AI duplicate detection service without breaking current functionality.}
+
+### Non Functional
+
+[[LLM: Each Requirement will be a bullet markdown with identifier starting with NFR. Include constraints from existing system]]
+@{example: - NFR1: Enhancement must maintain existing performance characteristics and not exceed current memory usage by more than 20%.}
+
+### Compatibility Requirements
+
+[[LLM: Critical for brownfield - what must remain compatible]]
+
+- CR1: [[LLM: Existing API compatibility requirements]]
+- CR2: [[LLM: Database schema compatibility requirements]]
+- CR3: [[LLM: UI/UX consistency requirements]]
+- CR4: [[LLM: Integration compatibility requirements]]
+
+^^CONDITION: has_ui^^
+
+## User Interface Enhancement Goals
+
+[[LLM: For UI changes, capture how they will integrate with existing UI patterns and design systems]]
+
+### Integration with Existing UI
+
+[[LLM: Describe how new UI elements will fit with existing design patterns, style guides, and component libraries]]
+
+### Modified/New Screens and Views
+
+[[LLM: List only the screens/views that will be modified or added]]
+
+### UI Consistency Requirements
+
+[[LLM: Specific requirements for maintaining visual and interaction consistency with existing application]]
+
+^^/CONDITION: has_ui^^
+
+## Technical Constraints and Integration Requirements
+
+[[LLM: This section replaces separate architecture documentation. Gather detailed technical constraints from existing project analysis.]]
+
+### Existing Technology Stack
+
+[[LLM: Document the current technology stack that must be maintained or integrated with]]
+
+**Languages**: [[LLM: Current programming languages in use]]
+**Frameworks**: [[LLM: Current frameworks and their versions]]
+**Database**: [[LLM: Current database technology and schema considerations]]
+**Infrastructure**: [[LLM: Current deployment and hosting infrastructure]]
+**External Dependencies**: [[LLM: Current third-party services and APIs]]
+
+### Integration Approach
+
+[[LLM: Define how the enhancement will integrate with existing architecture]]
+
+**Database Integration Strategy**: [[LLM: How new features will interact with existing database]]
+**API Integration Strategy**: [[LLM: How new APIs will integrate with existing API structure]]
+**Frontend Integration Strategy**: [[LLM: How new UI components will integrate with existing frontend]]
+**Testing Integration Strategy**: [[LLM: How new tests will integrate with existing test suite]]
+
+### Code Organization and Standards
+
+[[LLM: Based on existing project analysis, define how new code will fit existing patterns]]
+
+**File Structure Approach**: [[LLM: How new files will fit existing project structure]]
+**Naming Conventions**: [[LLM: Existing naming conventions that must be followed]]
+**Coding Standards**: [[LLM: Existing coding standards and linting rules]]
+**Documentation Standards**: [[LLM: How new code documentation will match existing patterns]]
+
+### Deployment and Operations
+
+[[LLM: How the enhancement fits existing deployment pipeline]]
+
+**Build Process Integration**: [[LLM: How enhancement builds with existing process]]
+**Deployment Strategy**: [[LLM: How enhancement will be deployed alongside existing features]]
+**Monitoring and Logging**: [[LLM: How enhancement will integrate with existing monitoring]]
+**Configuration Management**: [[LLM: How new configuration will integrate with existing config]]
+
+### Risk Assessment and Mitigation
+
+[[LLM: Identify risks specific to working with existing codebase]]
+
+**Technical Risks**: [[LLM: Risks related to modifying existing code]]
+**Integration Risks**: [[LLM: Risks in integrating with existing systems]]
+**Deployment Risks**: [[LLM: Risks in deploying alongside existing features]]
+**Mitigation Strategies**: [[LLM: Specific strategies to address identified risks]]
+
+## Epic and Story Structure
+
+[[LLM: For brownfield projects, favor a single comprehensive epic unless the user is clearly requesting multiple unrelated enhancements. Before presenting the epic structure, confirm: "Based on my analysis of your existing project, I believe this enhancement should be structured as [single epic/multiple epics] because [rationale based on actual project analysis]. Does this align with your understanding of the work required?" Then present the epic structure and immediately execute tasks#advanced-elicitation display.]]
+
+### Epic Approach
+
+[[LLM: Explain the rationale for epic structure - typically single epic for brownfield unless multiple unrelated features]]
+
+**Epic Structure Decision**: [[LLM: Single Epic or Multiple Epics with rationale]]
+
+## Epic 1: {{enhancement_title}}
+
+[[LLM: Comprehensive epic that delivers the brownfield enhancement while maintaining existing functionality]]
+
+**Epic Goal**: [[LLM: 2-3 sentences describing the complete enhancement objective and value]]
+
+**Integration Requirements**: [[LLM: Key integration points with existing system]]
+
+[[LLM: CRITICAL STORY SEQUENCING FOR BROWNFIELD:
+
+- Stories must ensure existing functionality remains intact
+- Each story should include verification that existing features still work
+- Stories should be sequenced to minimize risk to existing system
+- Include rollback considerations for each story
+- Focus on incremental integration rather than big-bang changes
+- Size stories for AI agent execution in existing codebase context
+- MANDATORY: Present the complete story sequence and ask: "This story sequence is designed to minimize risk to your existing system. Does this order make sense given your project's architecture and constraints?"
+- Stories must be logically sequential with clear dependencies identified
+- Each story must deliver value while maintaining system integrity]]
+
+<<REPEAT: story>>
+
+### Story 1.{{story_number}} {{story_title}}
+
+As a {{user_type}},
+I want {{action}},
+so that {{benefit}}.
+
+#### Acceptance Criteria
+
+[[LLM: Define criteria that include both new functionality and existing system integrity]]
+
+<<REPEAT: criteria>>
+
+- {{criterion number}}: {{criteria}}
+
+<</REPEAT>>
+
+#### Integration Verification
+
+[[LLM: Specific verification steps to ensure existing functionality remains intact]]
+
+- IV1: [[LLM: Existing functionality verification requirement]]
+- IV2: [[LLM: Integration point verification requirement]]
+- IV3: [[LLM: Performance impact verification requirement]]
+
+<</REPEAT>>

package/.bmad-core/templates/competitor-analysis-tmpl.md

@@ -0,0 +1,289 @@
+# Competitive Analysis Report: {{Project/Product Name}}
+
+[[LLM: This template guides comprehensive competitor analysis. Start by understanding the user's competitive intelligence needs and strategic objectives. Help them identify and prioritize competitors before diving into detailed analysis.]]
+
+## Executive Summary
+
+{{Provide high-level competitive insights, main threats and opportunities, and recommended strategic actions. Write this section LAST after completing all analysis.}}
+
+## Analysis Scope & Methodology
+
+### Analysis Purpose
+
+{{Define the primary purpose:
+
+- New market entry assessment
+- Product positioning strategy
+- Feature gap analysis
+- Pricing strategy development
+- Partnership/acquisition targets
+- Competitive threat assessment}}
+
+### Competitor Categories Analyzed
+
+{{List categories included:
+
+- Direct Competitors: Same product/service, same target market
+- Indirect Competitors: Different product, same need/problem
+- Potential Competitors: Could enter market easily
+- Substitute Products: Alternative solutions
+- Aspirational Competitors: Best-in-class examples}}
+
+### Research Methodology
+
+{{Describe approach:
+
+- Information sources used
+- Analysis timeframe
+- Confidence levels
+- Limitations}}
+
+## Competitive Landscape Overview
+
+### Market Structure
+
+{{Describe the competitive environment:
+
+- Number of active competitors
+- Market concentration (fragmented/consolidated)
+- Competitive dynamics
+- Recent market entries/exits}}
+
+### Competitor Prioritization Matrix
+
+[[LLM: Help categorize competitors by market share and strategic threat level]]
+
+{{Create a 2x2 matrix:
+
+- Priority 1 (Core Competitors): High Market Share + High Threat
+- Priority 2 (Emerging Threats): Low Market Share + High Threat
+- Priority 3 (Established Players): High Market Share + Low Threat
+- Priority 4 (Monitor Only): Low Market Share + Low Threat}}
+
+## Individual Competitor Profiles
+
+[[LLM: Create detailed profiles for each Priority 1 and Priority 2 competitor. For Priority 3 and 4, create condensed profiles.]]
+
+### {{Competitor Name}} - Priority {{1/2/3/4}}
+
+#### Company Overview
+
+- **Founded:** {{Year, founders}}
+- **Headquarters:** {{Location}}
+- **Company Size:** {{Employees, revenue if known}}
+- **Funding:** {{Total raised, key investors}}
+- **Leadership:** {{Key executives}}
+
+#### Business Model & Strategy
+
+- **Revenue Model:** {{How they make money}}
+- **Target Market:** {{Primary customer segments}}
+- **Value Proposition:** {{Core value promise}}
+- **Go-to-Market Strategy:** {{Sales and marketing approach}}
+- **Strategic Focus:** {{Current priorities}}
+
+#### Product/Service Analysis
+
+- **Core Offerings:** {{Main products/services}}
+- **Key Features:** {{Standout capabilities}}
+- **User Experience:** {{UX strengths/weaknesses}}
+- **Technology Stack:** {{If relevant/known}}
+- **Pricing:** {{Model and price points}}
+
+#### Strengths & Weaknesses
+
+**Strengths:**
+
+- {{Strength 1}}
+- {{Strength 2}}
+- {{Strength 3}}
+
+**Weaknesses:**
+
+- {{Weakness 1}}
+- {{Weakness 2}}
+- {{Weakness 3}}
+
+#### Market Position & Performance
+
+- **Market Share:** {{Estimate if available}}
+- **Customer Base:** {{Size, notable clients}}
+- **Growth Trajectory:** {{Trending up/down/stable}}
+- **Recent Developments:** {{Key news, releases}}
+
+<<REPEAT for each priority competitor>>
+
+## Comparative Analysis
+
+### Feature Comparison Matrix
+
+[[LLM: Create a detailed comparison table of key features across competitors]]
+
+| Feature Category            | {{Your Company}}    | {{Competitor 1}}    | {{Competitor 2}}    | {{Competitor 3}}    |
+| --------------------------- | ------------------- | ------------------- | ------------------- | ------------------- |
+| **Core Functionality**      |
+| Feature A                   | {{✓/✗/Partial}}     | {{✓/✗/Partial}}     | {{✓/✗/Partial}}     | {{✓/✗/Partial}}     |
+| Feature B                   | {{✓/✗/Partial}}     | {{✓/✗/Partial}}     | {{✓/✗/Partial}}     | {{✓/✗/Partial}}     |
+| **User Experience**         |
+| Mobile App                  | {{Rating/Status}}   | {{Rating/Status}}   | {{Rating/Status}}   | {{Rating/Status}}   |
+| Onboarding Time             | {{Time}}            | {{Time}}            | {{Time}}            | {{Time}}            |
+| **Integration & Ecosystem** |
+| API Availability            | {{Yes/No/Limited}}  | {{Yes/No/Limited}}  | {{Yes/No/Limited}}  | {{Yes/No/Limited}}  |
+| Third-party Integrations    | {{Number/Key ones}} | {{Number/Key ones}} | {{Number/Key ones}} | {{Number/Key ones}} |
+| **Pricing & Plans**         |
+| Starting Price              | {{$X}}              | {{$X}}              | {{$X}}              | {{$X}}              |
+| Free Tier                   | {{Yes/No}}          | {{Yes/No}}          | {{Yes/No}}          | {{Yes/No}}          |
+
+### SWOT Comparison
+
+[[LLM: Create SWOT analysis for your solution vs. top competitors]]
+
+#### Your Solution
+
+- **Strengths:** {{List key strengths}}
+- **Weaknesses:** {{List key weaknesses}}
+- **Opportunities:** {{List opportunities}}
+- **Threats:** {{List threats}}
+
+#### vs. {{Main Competitor}}
+
+- **Competitive Advantages:** {{Where you're stronger}}
+- **Competitive Disadvantages:** {{Where they're stronger}}
+- **Differentiation Opportunities:** {{How to stand out}}
+
+### Positioning Map
+
+[[LLM: Describe competitor positions on key dimensions]]
+
+{{Create a positioning description using 2 key dimensions relevant to the market, such as:
+
+- Price vs. Features
+- Ease of Use vs. Power
+- Specialization vs. Breadth
+- Self-Serve vs. High-Touch}}
+
+## Strategic Analysis
+
+### Competitive Advantages Assessment
+
+#### Sustainable Advantages
+
+{{Identify moats and defensible positions:
+
+- Network effects
+- Switching costs
+- Brand strength
+- Technology barriers
+- Regulatory advantages}}
+
+#### Vulnerable Points
+
+{{Where competitors could be challenged:
+
+- Weak customer segments
+- Missing features
+- Poor user experience
+- High prices
+- Limited geographic presence}}
+
+### Blue Ocean Opportunities
+
+[[LLM: Identify uncontested market spaces]]
+
+{{List opportunities to create new market space:
+
+- Underserved segments
+- Unaddressed use cases
+- New business models
+- Geographic expansion
+- Different value propositions}}
+
+## Strategic Recommendations
+
+### Differentiation Strategy
+
+{{How to position against competitors:
+
+- Unique value propositions to emphasize
+- Features to prioritize
+- Segments to target
+- Messaging and positioning}}
+
+### Competitive Response Planning
+
+#### Offensive Strategies
+
+{{How to gain market share:
+
+- Target competitor weaknesses
+- Win competitive deals
+- Capture their customers}}
+
+#### Defensive Strategies
+
+{{How to protect your position:
+
+- Strengthen vulnerable areas
+- Build switching costs
+- Deepen customer relationships}}
+
+### Partnership & Ecosystem Strategy
+
+{{Potential collaboration opportunities:
+
+- Complementary players
+- Channel partners
+- Technology integrations
+- Strategic alliances}}
+
+## Monitoring & Intelligence Plan
+
+### Key Competitors to Track
+
+{{Priority list with rationale}}
+
+### Monitoring Metrics
+
+{{What to track:
+
+- Product updates
+- Pricing changes
+- Customer wins/losses
+- Funding/M&A activity
+- Market messaging}}
+
+### Intelligence Sources
+
+{{Where to gather ongoing intelligence:
+
+- Company websites/blogs
+- Customer reviews
+- Industry reports
+- Social media
+- Patent filings}}
+
+### Update Cadence
+
+{{Recommended review schedule:
+
+- Weekly: {{What to check}}
+- Monthly: {{What to review}}
+- Quarterly: {{Deep analysis}}}}
+
+---
+
+[[LLM: After completing the document, offer advanced elicitation with these custom options for competitive analysis:
+
+**Competitive Analysis Elicitation Actions** 0. Deep dive on a specific competitor's strategy
+
+1. Analyze competitive dynamics in a specific segment
+2. War game competitive responses to your moves
+3. Explore partnership vs. competition scenarios
+4. Stress test differentiation claims
+5. Analyze disruption potential (yours or theirs)
+6. Compare to competition in adjacent markets
+7. Generate win/loss analysis insights
+8. If only we had known about [competitor X's plan]...
+9. Proceed to next section
+
+These replace the standard elicitation options when working on competitive analysis documents.]]

package/.bmad-core/templates/expansion-pack-plan-tmpl.md

@@ -0,0 +1,91 @@
+# {Pack Name} Expansion Pack Plan
+
+## Overview
+
+- **Pack Name**: {pack-identifier}
+- **Display Name**: {Full Expansion Pack Name}
+- **Description**: {Brief description of what this pack does}
+- **Target Domain**: {Industry/domain this serves}
+- **Author**: {Your name/organization}
+
+## Problem Statement
+
+{What specific challenges does this expansion pack solve?}
+
+## Target Users
+
+{Who will benefit from this expansion pack?}
+
+## Components to Create
+
+### Agents
+
+- [ ] `{pack-name}-orchestrator` - **REQUIRED**: Master orchestrator for {domain} workflows
+  - Key commands: {list main commands}
+  - Manages: {what it orchestrates}
+- [ ] `{agent-1-name}` - {Role description}
+  - Tasks used: {task-1}, {task-2}
+  - Templates used: {template-1}
+  - Data required: {data-file-1}
+- [ ] `{agent-2-name}` - {Role description}
+  - Tasks used: {task-3}
+  - Templates used: {template-2}
+  - Data required: {data-file-2}
+
+### Tasks
+
+- [ ] `{task-1}.md` - {Purpose} (used by: {agent})
+- [ ] `{task-2}.md` - {Purpose} (used by: {agent})
+- [ ] `{task-3}.md` - {Purpose} (used by: {agent})
+
+### Templates
+
+- [ ] `{template-1}-tmpl.md` - {Document type} (used by: {agent/task})
+- [ ] `{template-2}-tmpl.md` - {Document type} (used by: {agent/task})
+
+### Checklists
+
+- [ ] `{checklist-1}-checklist.md` - {What it validates}
+- [ ] `{checklist-2}-checklist.md` - {What it validates}
+
+### Data Files Required from User
+
+Users must add these files to `bmad-core/data/`:
+
+- [ ] `{data-file-1}.{ext}` - {Description of required content}
+  - Format: {file format}
+  - Purpose: {why needed}
+  - Example: {brief example}
+- [ ] `{data-file-2}.{ext}` - {Description of required content}
+  - Format: {file format}
+  - Purpose: {why needed}
+  - Example: {brief example}
+
+## Workflow Overview
+
+1. {Step 1 - typically starts with orchestrator}
+2. {Step 2}
+3. {Step 3}
+4. {Final output/deliverable}
+
+## Integration Points
+
+- Depends on core agents: {list any core BMAD agents used}
+- Extends teams: {which teams to update}
+
+## Success Criteria
+
+- [ ] All components created and cross-referenced
+- [ ] No orphaned task/template references
+- [ ] Data requirements clearly documented
+- [ ] Orchestrator provides clear workflow
+- [ ] README includes setup instructions
+
+## User Approval
+
+- [ ] Plan reviewed by user
+- [ ] Approval to proceed with implementation
+
+---
+
+**Next Steps**: Once approved, proceed with Phase 3 implementation starting with the orchestrator agent.