BMAD-METHOD/bmad-agent/orchestrator/persona-registry.md

BMAD Persona Registry System

Overview

The BMAD Persona Registry is a comprehensive system for managing, discovering, and coordinating all available personas within the BMAD Method ecosystem. It provides intelligent persona selection, lifecycle management, and workflow optimization.

Persona Registry Structure

Core Personas (Foundation Layer)

```yaml core_personas: analyst: name: "Mary" specialization: ["brainstorming", "research", "project_briefing"] complexity_level: "intermediate" dependencies: []

product_manager: name: "John" specialization: ["prd_creation", "requirements", "user_advocacy"] complexity_level: "advanced" dependencies: ["analyst"]

architect: name: "Fred" specialization: ["system_design", "technical_architecture", "scalability"] complexity_level: "expert" dependencies: ["product_manager"]

design_architect: name: "Jane" specialization: ["ui_ux", "frontend_architecture", "design_systems"] complexity_level: "expert" dependencies: ["architect"]

v0_ux_ui_architect: name: "Veronica" specialization: ["rapid_prototyping", "component_generation", "visual_design"] complexity_level: "expert" dependencies: ["design_architect"]

product_owner: name: "Sarah" specialization: ["backlog_management", "story_validation", "stakeholder_coordination"] complexity_level: "advanced" dependencies: ["product_manager"]

scrum_master: name: "Bob" specialization: ["agile_process", "team_coordination", "story_preparation"] complexity_level: "intermediate" dependencies: ["product_owner"]

### Documentation Specialists (Enhancement Layer)
\```yaml
documentation_specialists:
  technical_documentation_architect:
    name: "Marcus"
    specialization: ["api_documentation", "technical_writing", "developer_experience"]
    complexity_level: "expert"
    dependencies: ["architect"]
    
  devops_documentation_specialist:
    name: "Diana"
    specialization: ["deployment_guides", "infrastructure_docs", "operational_procedures"]
    complexity_level: "expert"
    dependencies: ["architect", "platform_engineer"]

Integration Experts (Connectivity Layer)

```yaml integration_experts: cross_platform_integration_specialist: name: "Carlos" specialization: ["api_design", "microservices", "system_interoperability"] complexity_level: "expert" dependencies: ["architect"]

polyglot_code_review_specialist: name: "Patricia" specialization: ["code_quality", "security_review", "best_practices"] complexity_level: "expert" dependencies: ["architect", "security_integration_specialist"]

### Advanced Specialists (Optimization Layer)
\```yaml
advanced_specialists:
  performance_optimization_specialist:
    name: "Oliver"
    specialization: ["performance_analysis", "optimization", "monitoring"]
    complexity_level: "expert"
    dependencies: ["architect"]
    
  security_integration_specialist:
    name: "Sophia"
    specialization: ["security_architecture", "threat_modeling", "compliance"]
    complexity_level: "expert"
    dependencies: ["architect"]
    
  enterprise_architecture_consultant:
    name: "Edward"
    specialization: ["enterprise_strategy", "technology_roadmap", "transformation"]
    complexity_level: "master"
    dependencies: ["architect", "product_manager"]
    
  advanced_troubleshooting_specialist:
    name: "Thomas"
    specialization: ["root_cause_analysis", "complex_debugging", "system_optimization"]
    complexity_level: "expert"
    dependencies: ["architect", "performance_optimization_specialist"]

Intelligent Persona Selection

Request Analysis Engine

```markdown The orchestrator analyzes user requests using:

1. Keyword Matching: Identifies domain-specific terms and technical concepts
2. Intent Recognition: Understands the type of work being requested
3. Complexity Assessment: Evaluates the sophistication level required
4. Context Awareness: Considers current project phase and existing artifacts

### Capability Matching Matrix
\```yaml
capability_mapping:
  "create api documentation":
    primary: "technical_documentation_architect"
    secondary: ["architect", "cross_platform_integration_specialist"]
    
  "performance optimization":
    primary: "performance_optimization_specialist"
    secondary: ["architect", "advanced_troubleshooting_specialist"]
    
  "security review":
    primary: "security_integration_specialist"
    secondary: ["polyglot_code_review_specialist", "architect"]
    
  "enterprise strategy":
    primary: "enterprise_architecture_consultant"
    secondary: ["product_manager", "architect"]
    
  "troubleshoot complex issue":
    primary: "advanced_troubleshooting_specialist"
    secondary: ["performance_optimization_specialist", "architect"]

Persona Lifecycle Management

Loading and Initialization

```markdown

1. Persona Discovery: Scan AgentConfig for available personas
2. Capability Registration: Register persona specializations and dependencies
3. Health Validation: Verify persona configuration integrity
4. Resource Allocation: Prepare persona-specific resources and templates
5. Ready State: Mark persona as available for activation

### Context Management
\```markdown
1. **Context Preservation:** Maintain conversation context during persona switches
2. **State Transfer:** Pass relevant information between related personas
3. **Workflow Continuity:** Ensure seamless transitions in multi-persona workflows
4. **Memory Management:** Optimize context storage and retrieval

Performance Monitoring

```yaml performance_metrics: persona_loading_time: "< 1 second" context_transfer_time: "< 500ms" memory_usage_per_persona: "< 50MB" concurrent_persona_limit: 3 health_check_interval: "30 seconds"

## Workflow Optimization

### Recommended Persona Sequences
\```yaml
workflow_patterns:
  project_initiation:
    sequence: ["analyst", "product_manager", "architect", "design_architect"]
    parallel_options: ["technical_documentation_architect", "security_integration_specialist"]
    
  feature_development:
    sequence: ["product_owner", "scrum_master", "v0_ux_ui_architect"]
    validation: ["polyglot_code_review_specialist", "performance_optimization_specialist"]
    
  system_integration:
    sequence: ["cross_platform_integration_specialist", "architect"]
    support: ["devops_documentation_specialist", "security_integration_specialist"]
    
  enterprise_transformation:
    sequence: ["enterprise_architecture_consultant", "product_manager", "architect"]
    specialists: ["performance_optimization_specialist", "security_integration_specialist"]
    
  issue_resolution:
    sequence: ["advanced_troubleshooting_specialist"]
    escalation: ["performance_optimization_specialist", "security_integration_specialist", "architect"]

Error Handling and Recovery

Persona Health Monitoring

```markdown

1. Configuration Validation: Verify persona files and dependencies
2. Resource Availability: Check template and checklist accessibility
3. Performance Monitoring: Track response times and resource usage
4. Error Detection: Identify and log persona-specific issues
5. Automatic Recovery: Attempt persona restart or fallback options

### Fallback Strategies
\```yaml
fallback_options:
  persona_unavailable:
    action: "suggest_alternative_persona"
    alternatives: ["similar_capability_personas", "core_persona_fallback"]
    
  configuration_error:
    action: "reload_persona_config"
    retry_attempts: 3
    fallback: "base_orchestrator_mode"
    
  performance_degradation:
    action: "optimize_resource_allocation"
    options: ["reduce_concurrent_personas", "clear_context_cache"]
    
  dependency_failure:
    action: "resolve_dependencies"
    strategy: ["load_required_personas", "suggest_workflow_modification"]

Integration Points

Cross-Persona Collaboration

```markdown The registry facilitates collaboration between personas through:

1. Shared Context: Common understanding of project artifacts and goals
2. Handoff Protocols: Standardized information transfer between personas
3. Collaborative Workflows: Multi-persona task execution and coordination
4. Quality Validation: Cross-persona review and validation processes

### External System Integration
\```yaml
integration_capabilities:
  ide_environments:
    - "cursor_ai"
    - "claude_code"
    - "cline"
    - "roocode"
    
  web_platforms:
    - "v0_integration"
    - "github_copilot"
    - "custom_web_interfaces"
    
  documentation_systems:
    - "markdown_processors"
    - "api_documentation_generators"
    - "confluence_integration"