172 lines
7.4 KiB
Markdown
172 lines
7.4 KiB
Markdown
# BMAD Method Improvements
|
|
|
|
## MPC (Machine-Powered Capabilities) Integration
|
|
|
|
The BMAD Method now supports integration with external tools and services through a structured MPC framework:
|
|
|
|
### 1. MPC Configuration System
|
|
- **Centralized Configuration**: All available MPCs are defined in a central YAML file
|
|
- **Role-Based Access**: MPCs are assigned to specific agent roles
|
|
- **Use Case Documentation**: Each MPC includes documentation on ideal use cases
|
|
- **Command Interface**: Standardized commands for invoking external capabilities
|
|
|
|
### 2. Available MPCs
|
|
- **Search Tools**: Perplexity for web research and summarization
|
|
- **Code Search**: GitHub for finding implementation examples and documentation
|
|
- **Data Analysis**: Firecrawl for advanced data mining and pattern recognition
|
|
- **Image Generation**: DALL-E for UI mockups and concept visualization
|
|
|
|
### 3. Integration Features
|
|
- **Task-Specific Usage**: Agents suggest appropriate MPCs for specific tasks
|
|
- **Workflow Integration**: MPC usage is seamlessly integrated into agent workflows
|
|
- **Knowledge Base Updates**: MPC outputs can be incorporated into project knowledge
|
|
- **Command System**: Simple asterisk-prefixed commands (e.g., *perplexity, *github)
|
|
|
|
### 4. User Benefits
|
|
- **Enhanced Research**: Better information gathering during early project phases
|
|
- **Implementation Guidance**: Code examples and documentation for development
|
|
- **Visual Prototyping**: Rapid generation of visual concepts
|
|
- **Data-Driven Decisions**: Improved analysis capabilities for business insights
|
|
|
|
## New Knowledge Enrichment System
|
|
|
|
The BMAD Method now includes a powerful agent knowledge enrichment system that allows agents to accumulate and share project-specific knowledge throughout the development lifecycle:
|
|
|
|
### 1. Knowledge Update Task
|
|
- **Purpose**: Automatically extract project information and update agent knowledge
|
|
- **Implementation**:
|
|
- New task file (`agent-knowledge-update-task.md`)
|
|
- JavaScript implementation (`create-knowledge-files.js`)
|
|
- Knowledge file templates in the templates directory
|
|
- **Benefits**:
|
|
- Agents become more effective with project-specific context
|
|
- Reduces repetition of information across agent interactions
|
|
- Creates a consistent knowledge base for all agents
|
|
|
|
### 2. Knowledge File Structure
|
|
- `.ai/project-context.md` - General project information and terminology
|
|
- `.ai/tech-stack.md` - Technical stack and implementation details
|
|
- `.ai/data-models.md` - Data structures and analytics approach
|
|
- `.ai/deployment-info.md` - Infrastructure and deployment information
|
|
|
|
### 3. Agent Customization
|
|
- Developer agents receive tech stack-specific customization
|
|
- QA agents receive testing approach customization
|
|
- DevOps agents receive deployment and infrastructure customization
|
|
- Data Science agents receive data and model customization
|
|
|
|
### 4. Integration Points
|
|
- After Analyst creates Project Brief
|
|
- After PM creates PRD
|
|
- After Architect creates system architecture
|
|
- Can be triggered manually at any point with the *update-agents command
|
|
|
|
## Advanced Knowledge Management Features
|
|
|
|
The BMAD Method now includes sophisticated knowledge management capabilities:
|
|
|
|
### 1. Knowledge Visualization
|
|
- **Knowledge Map Generation**: Creates visual representations of project components and relationships
|
|
- **Mermaid Diagrams**: Automatically generated architecture, data flow, and team responsibility diagrams
|
|
- **Gap Identification**: Visually highlights areas where knowledge is incomplete
|
|
|
|
### 2. Knowledge Request System
|
|
- **Structured Process**: Formal system for agents to request missing information
|
|
- **Knowledge Request Log**: Central repository of all information requests
|
|
- **Prioritization**: Requests are categorized by impact and urgency
|
|
- **Resolution Tracking**: Complete lifecycle tracking from request to resolution
|
|
|
|
### 3. Knowledge Versioning
|
|
- **Version History**: Tracks all changes to the knowledge base over time
|
|
- **Impact Analysis**: Documents how knowledge changes affect different project aspects
|
|
- **Changelog**: Detailed records of what information was added, changed, or removed
|
|
- **Cross-Project Learning**: Enables review of how project understanding evolved
|
|
|
|
### 4. Knowledge Validation
|
|
- **Consistency Checking**: Ensures information is consistent across all knowledge files
|
|
- **Completeness Verification**: Identifies missing required information
|
|
- **External Validation**: Compares knowledge against authoritative project documents
|
|
- **Knowledge Health Reporting**: Provides a comprehensive assessment of knowledge quality
|
|
|
|
## New Specialized Personas
|
|
|
|
The BMAD Method has been enhanced with three new specialized personas to provide more comprehensive project coverage:
|
|
|
|
### 1. QA Tester (Quinn)
|
|
- **Focus**: Comprehensive testing, quality assurance, and defect prevention
|
|
- **Key Tasks**:
|
|
- Creating detailed test plans
|
|
- Performing test execution and validation
|
|
- Generating quality reports
|
|
- Running QA-specific checklists
|
|
- **Benefits**:
|
|
- Earlier detection of defects
|
|
- Improved product quality
|
|
- More thorough validation of requirements
|
|
- Better regression prevention
|
|
|
|
### 2. DevOps Engineer (Derek)
|
|
- **Focus**: Deployment automation, infrastructure management, and operational excellence
|
|
- **Key Tasks**:
|
|
- Creating deployment plans
|
|
- Implementing infrastructure as code
|
|
- Managing CI/CD pipelines
|
|
- Ensuring security and compliance
|
|
- **Benefits**:
|
|
- Streamlined deployment process
|
|
- Improved system reliability
|
|
- Better monitoring and observability
|
|
- Enhanced security posture
|
|
|
|
### 3. Data Scientist (Diana)
|
|
- **Focus**: Data analysis, machine learning, and actionable insights
|
|
- **Key Tasks**:
|
|
- Creating data analysis plans
|
|
- Developing ML models
|
|
- Designing data pipelines
|
|
- Generating business intelligence
|
|
- **Benefits**:
|
|
- Data-driven decision making
|
|
- Enhanced product capabilities through ML/AI
|
|
- Better understanding of user behavior
|
|
- Predictive analytics for business planning
|
|
|
|
## Workflow Integration
|
|
|
|
These new personas are fully integrated into both the web-based and IDE-based BMAD workflows:
|
|
|
|
1. **Configuration Updates**:
|
|
- Added to both web and IDE orchestrator configurations
|
|
- Configured with appropriate tasks and checklists
|
|
- Interaction modes (Interactive/YOLO) supported
|
|
|
|
2. **Task Creation**:
|
|
- Specialized tasks created for each new persona
|
|
- Tasks follow standard BMAD Method format
|
|
- Tasks integrate with existing project artifacts
|
|
|
|
3. **Checklist Integration**:
|
|
- Specialized checklists created for quality validation
|
|
- Checklist mappings updated for new document types
|
|
- Integrated with checklist runner task
|
|
|
|
## Recommended Usage
|
|
|
|
For optimal results with the enhanced BMAD Method:
|
|
|
|
1. **Development Phase Integration**:
|
|
- QA Tester should be engaged early in story development
|
|
- DevOps Engineer should be involved in architecture planning
|
|
- Data Scientist should participate in requirements gathering when data needs exist
|
|
|
|
2. **Workflow Optimization**:
|
|
- Use web agents for high-level planning and design
|
|
- Use IDE agents for implementation phases
|
|
- Consider dedicated instances for frequently used personas
|
|
|
|
3. **Configuration Customization**:
|
|
- Update persona specializations based on project tech stack
|
|
- Adjust task priorities based on project requirements
|
|
- Customize checklists to match organizational standards
|
|
|
|
The enhanced BMAD Method now provides more comprehensive coverage across the entire software development lifecycle, from planning through implementation, quality assurance, and deployment. |