BMAD-METHOD/bmad-agent/tasks/cross-project-learning-task.md

245 lines
8.9 KiB
Markdown

# Cross-Project Learning Task
## Purpose
Enable BMAD methodology to learn from experiences across multiple projects, building a comprehensive knowledge base that improves effectiveness for all future projects.
## When to Execute
- After completing any project using BMAD methodology
- During periodic knowledge consolidation sessions
- When starting new projects to leverage historical learnings
- Before major methodology updates to incorporate cross-project insights
## Learning Framework
### 1. Project Knowledge Extraction
**Project Profile Creation:**
```
Project ID: [Unique identifier]
Project Type: [Web App/API/Mobile/Infrastructure/Other]
Domain: [E-commerce/Healthcare/Finance/Education/Other]
Team Size: [Number of participants]
Timeline: [Actual vs. planned duration]
Complexity Level: [Simple/Moderate/Complex/Very Complex]
Technology Stack: [Primary technologies used]
Success Rating: [1-10 overall project success]
```
**Success Factors Documentation:**
- Which personas performed exceptionally well?
- What workflow sequences were most effective?
- Which techniques or approaches delivered the best results?
- What project characteristics contributed to success?
- Which handoffs and communications worked smoothly?
**Challenge and Solution Mapping:**
- What obstacles were encountered during the project?
- How were challenges overcome or mitigated?
- Which approaches proved ineffective and why?
- What would be done differently in retrospect?
- Which persona interactions required the most iteration?
### 2. Cross-Project Pattern Analysis
**Similarity Matching:**
- Identify projects with similar characteristics (domain, size, complexity)
- Find projects that used similar technology stacks or approaches
- Locate projects with comparable timelines or team structures
- Match projects by success patterns or challenge types
**Comparative Success Analysis:**
```
Project Comparison Framework:
Similar Projects: [List of comparable projects]
Success Differential: [Why some succeeded more than others]
Key Differentiators: [Critical factors that impacted outcomes]
Replicable Patterns: [What can be applied to future projects]
Context Dependencies: [What factors are situation-specific]
```
**Evolution Tracking:**
- How has methodology effectiveness changed over time?
- Which improvements have had the most significant impact?
- What patterns have emerged as the framework matured?
- Which early assumptions have been validated or disproven?
### 3. Knowledge Base Development
**Best Practice Repository:**
```
Best Practice: [Title]
Context: [When/where this applies]
Description: [Detailed explanation]
Evidence: [Projects where this was successful]
Prerequisites: [Conditions needed for success]
Implementation: [How to apply this practice]
Expected Benefits: [Quantified improvements]
Variations: [Adaptations for different contexts]
```
**Anti-Pattern Database:**
```
Anti-Pattern: [Title]
Problem: [What goes wrong]
Context: [Where this typically occurs]
Warning Signs: [How to detect early]
Root Causes: [Why this happens]
Consequences: [Impact on project success]
Prevention: [How to avoid this pattern]
Recovery: [How to fix if it occurs]
```
**Technique Library:**
- Proven approaches for common scenarios
- Persona-specific methods that consistently work
- Communication patterns that reduce friction
- Problem-solving frameworks for typical challenges
- Quality assurance techniques that prevent issues
### 4. Contextual Learning System
**Project Categorization:**
- **Simple Projects**: Clear requirements, established technology, small scope
- **Moderate Projects**: Some complexity, standard approaches, medium scope
- **Complex Projects**: Multiple stakeholders, new technology, large scope
- **Innovation Projects**: Experimental approaches, high uncertainty, research-heavy
**Domain-Specific Learning:**
- **E-commerce**: Shopping flows, payment systems, inventory management
- **Healthcare**: Compliance requirements, data privacy, patient workflows
- **Finance**: Security considerations, regulatory compliance, transaction processing
- **Education**: User engagement, content management, assessment systems
**Technology-Specific Insights:**
- **Frontend**: React/Vue/Angular patterns, responsive design, performance optimization
- **Backend**: API design, database architecture, scalability patterns
- **Mobile**: Platform considerations, user experience, performance constraints
- **Infrastructure**: Cloud architecture, deployment strategies, monitoring systems
### 5. Predictive Learning Engine
**Success Prediction Model:**
```
Input Variables:
- Project characteristics (type, size, complexity)
- Team composition and experience
- Technology choices and constraints
- Timeline and resource availability
- Domain and industry context
Prediction Outputs:
- Likely success factors and challenges
- Recommended persona sequences and approaches
- Suggested techniques and best practices
- Risk areas requiring special attention
- Quality checkpoints and validation strategies
```
**Recommendation System:**
- Suggest optimal workflow based on project profile
- Recommend personas most effective for specific contexts
- Identify techniques with highest success probability
- Highlight potential challenges based on similar projects
- Propose quality measures and success criteria
### 6. Learning Integration Process
**Project Onboarding:**
```
New Project Learning Integration:
1. Extract relevant learnings from similar past projects
2. Identify applicable best practices and anti-patterns
3. Recommend optimal methodology configuration
4. Highlight specific risks and mitigation strategies
5. Set success criteria based on comparable projects
```
**Continuous Learning:**
- Regular updates to knowledge base from ongoing projects
- Real-time pattern recognition during project execution
- Adaptive recommendations based on project progress
- Dynamic adjustment of approaches based on emerging patterns
**Knowledge Validation:**
- Test cross-project learnings in new contexts
- Validate recommendations against actual outcomes
- Refine prediction models based on results
- Update knowledge base with new evidence
### 7. Learning Data Management
**Data Collection Framework:**
```
Project Completion Data:
- Quantitative metrics (time, quality, satisfaction scores)
- Qualitative assessments (what worked, what didn't)
- Process documentation (workflows, decisions, changes)
- Outcome analysis (success factors, failure modes)
- Lessons learned (insights, recommendations)
```
**Knowledge Organization:**
- Hierarchical categorization by project type and domain
- Tag-based system for cross-cutting concerns
- Version control for evolving insights and patterns
- Search and retrieval system for rapid access
- Analytics dashboard for learning trend analysis
**Privacy and Anonymization:**
- Protect sensitive project information while preserving learning value
- Anonymize client and business-specific details
- Focus on methodology patterns rather than proprietary information
- Ensure compliance with confidentiality requirements
### 8. Cross-Project Collaboration
**Learning Communities:**
- Share anonymized insights across teams using BMAD
- Collaborative pattern validation and improvement
- Best practice sharing and discussion forums
- Collective knowledge building and curation
**Methodology Evolution:**
- Aggregate learnings to identify framework improvements
- Validate changes across multiple project contexts
- Build consensus on methodology updates and enhancements
- Coordinate evolution while maintaining stability
## Implementation Strategy
### Phase 1: Historical Data Mining
- Analyze existing projects for extractable patterns
- Create initial knowledge base with available data
- Establish learning framework and categorization system
### Phase 2: Active Learning Integration
- Implement learning data collection in current projects
- Begin building cross-project pattern database
- Start generating recommendations for new projects
### Phase 3: Predictive Intelligence
- Deploy prediction models for project success factors
- Implement real-time learning and adaptation
- Enable automatic knowledge base updates and improvements
## Success Metrics
**Learning Effectiveness:**
- Increased project success rates over time
- Reduced time-to-value for new projects
- Higher consistency in deliverable quality
- Improved prediction accuracy for project outcomes
**Knowledge Base Quality:**
- Breadth and depth of accumulated insights
- Accuracy of recommendations and predictions
- User satisfaction with learning-based guidance
- Validation rate of cross-project patterns
**Methodology Evolution:**
- Rate of evidence-based improvements
- Speed of knowledge integration into framework
- Effectiveness of predictive optimizations
- Long-term methodology performance trends
This cross-project learning capability transforms BMAD from a methodology that improves project by project into one that accumulates wisdom across all projects, creating an ever-more-intelligent development framework.