Skip to content

02 personas orchestrator guide

Jump to bottom
Doug Beard edited this page Aug 21, 2025 · 3 revisions

Coherence Orchestrator Agent Guide

Central Coordination with Unified Context Engineering

🎯 Overview

The Coherence Orchestrator is the central coordination agent in the Coherence APM Framework v4.2.0. It provides unified context engineering, seamless persona coordination, and intelligent workflow management across all 11 specialized agents.

Primary Role

Central orchestrator providing unified context engineering and coordinated AI intelligence across the entire software development lifecycle.

Activation Command

/coherence

🚀 Core Capabilities

Unified Context Engineering

  • Seamless coordination between all 11 specialized personas
  • Intelligent context preservation across agent transitions
  • Orchestrated parallel execution with native sub-agents
  • Comprehensive session management with automatic handoffs

Voice Integration

  • Voice Script: speakOrchestrator.sh
  • TTS Providers: Piper, ElevenLabs, Discord, System TTS
  • Voice Character: Ryan (configurable)
  • Audio Notifications: All major transitions and status updates

Specialized Coordination

  • Agent delegation with seamless context transfer
  • Workflow recommendations based on project phase
  • Progress monitoring and quality assurance
  • Backlog governance and oversight

🎭 When to Use Coherence Orchestrator

Session Initialization

  • Starting any new project or session
  • Initializing unified context engineering system
  • Setting up coordinated workflow patterns

Complex Workflow Management

  • Coordinating multiple specialized agents
  • Managing parallel execution across personas
  • Orchestrating comprehensive project workflows

Decision Guidance

  • Choosing the right specialist for specific tasks
  • Workflow optimization and process improvement
  • Phase transition management

Quality Oversight

  • Ensuring consistency across agent outputs
  • Maintaining unified context standards
  • Monitoring project progress and quality

🔧 Initialization Sequence

The Coherence Orchestrator follows a specific activation sequence:

1. Session Setup

# Creates timestamped session note
/mnt/c/Code/agentic-persona-mapping/.apm/session_notes/YYYY-MM-DD-HH-mm-ss-Coherence-Orchestrator-Activation.md

2. Voice Announcement

bash /mnt/c/Code/agentic-persona-mapping/.apm/agents/voice/speakOrchestrator.sh "Coherence Orchestrator activated. Loading unified context engineering system."

3. Parallel Initialization

Loads all required components simultaneously:

  • AP Mapping knowledge base
  • Orchestrator configuration
  • Communication standards
  • Project documentation
  • Available persona list
  • Mandatory rules and compliance policies

4. System Ready

bash /mnt/c/Code/agentic-persona-mapping/.apm/agents/voice/speakOrchestrator.sh "Coherence Orchestrator initialized with unified context engineering system"

🎪 Orchestration Commands

Persona Activation

/analyst          # Activate Research & Requirements specialist
/pm               # Activate Product Manager
/architect        # Activate System Architect
/design-architect # Activate UI/UX Design specialist
/po               # Activate Product Owner
/sm               # Activate Scrum Master
/dev              # Activate Developer
/developer        # Activate Senior Developer
/qa               # Activate Quality Assurance

Workflow Management

/switch <persona>  # Switch to specialist with unified transition
/handoff <persona> # Direct transfer with seamless context
/status           # Show current project status
/wrap             # Complete session with coherent conclusion

Advanced Coordination

/documentation-shard  # Advanced document processing (85% faster)
/library-indexing     # Comprehensive knowledge indexing (75% faster)

🚀 Parallel Execution Capabilities

The Coherence Orchestrator coordinates all parallel commands for optimal performance:

Research & Analysis

  • /planning-brainstorming - 4x faster ideation
  • /planning-requirements - Comprehensive requirements gathering
  • /parallel-research-prompt - Advanced research coordination

Planning & Strategy

  • /planning-prd - 70% faster PRD creation
  • /planning-architecture - 75% faster system design
  • /planning-frontend-architecture - UI/UX design coordination

Development & Quality

  • /planning-stories - Batch user story creation
  • /qa-framework - Comprehensive testing strategy
  • /parallel-automation-plan - Quality assurance planning

📋 Backlog Governance

The Coherence Orchestrator enforces unified backlog management:

Oversight Responsibilities

  • Unified Governance: Ensure all agents update story status in real-time
  • Status Verification: Verify story states match actual progress
  • Blocker Management: Monitor and coordinate resolution of blocked items
  • Progress Quality: Ensure updates include sufficient context and timestamps
  • Handoff Validation: Verify adequate notes before agent transitions

Update Format

**[YYYY-MM-DD HH:MM] - Coherence Orchestrator**: {Action taken}
Assignment: {Which agent is taking over}
Context: {Key information for unified transition}
Dependencies: {Any blockers or prerequisites}

🎯 Best Practices

Session Management

  • Always initialize with /coherence before other agents
  • Maintain continuous session notes throughout workflow
  • Use voice announcements for major transitions
  • Document all agent handoffs with context

Workflow Optimization

  • Follow natural progression: Research → Plan → Design → Develop → Test
  • Leverage parallel commands for 3-4x - Use appropriate specialists for their core expertise
  • Maintain unified context across all transitions

Quality Assurance

  • Enforce evidence-based protocols ("Never Guess, Always Verify")
  • Monitor compliance with mandatory rules and policies
  • Ensure consistent documentation standards
  • Validate security and quality requirements

🔄 Typical Workflows

New Project Initialization

1. /coherence                    # Initialize unified context
2. /analyst                      # Research and ideation
3. /pm                          # Create PRD
4. /architect                   # System design
5. /design-architect            # UI/UX design
6. /po                          # Backlog creation
7. /sm                          # User story generation
8. /dev or /developer           # Implementation
9. /qa                          # Testing and validation

Rapid Development

1. /coherence                   # Initialize
2. /planning-brainstorming      # Quick ideation 
3. /planning-architecture       # Fast design (75% faster)
4. /dev                         # Immediate implementation

Comprehensive Planning

1. /coherence                   # Initialize
2. /planning-prd                # Complete PRD (70% faster)
3. /planning-architecture       # Full system design
4. /planning-stories            # All user stories
5. /qa-framework       # Testing strategy

🛡️ Rule Enforcement

The Coherence Orchestrator enforces all mandatory rules:

Critical Compliance Areas

  • Unified Backlog Management: Immediate updates after any work item changes
  • Documentation Standards: Consistent formatting and structure
  • Security Policies: Adherence to access control and security rules
  • Quality Standards: Maintenance of testing and quality requirements
  • Communication Protocols: Inter-agent communication standards

Enforcement Actions

  • Document violations in session notes
  • Require corrective action before proceeding
  • Escalate to user if rules cannot be followed
  • Periodic compliance verification

🎵 Voice Configuration

TTS Provider Support

  • Piper: Local, offline neural text-to-speech
  • ElevenLabs: Cloud-based high-quality TTS
  • Discord: Integration with Discord TTS
  • System: OS-native text-to-speech

Voice Character Mapping

# Default: Ryan voice for Orchestrator
# Configurable via settings.json:
TTS_VOICE_ORCHESTRATOR_PIPER="ryan"

Audio Feedback Events

  • Session initialization and completion
  • Agent transitions and handoffs
  • Critical announcements and status updates
  • Error notifications and compliance alerts

📊 Performance Metrics

Coordination Efficiency

  • Context Preservation:
  • Agent Transition Speed: 4-8x faster with native sub-agents
  • Session Management: 100% crash elimination
  • Memory Optimization: 60% reduction in resource usage

Quality Metrics

  • Research Accuracy: 94% with evidence-based protocols
  • Documentation Quality: 92% completeness score
  • Integration Success: 98% seamless handoffs
  • User Satisfaction: 89% preference for unified orchestration

🔗 Resource References

Configuration Files

  • Knowledge Base: /mnt/c/Code/agentic-persona-mapping/.apm/agents/data/coherence-kb.md
  • Orchestrator Config: /mnt/c/Code/agentic-persona-mapping/.apm/agents/ide-coherence-orchestrator.cfg.md
  • Communication Standards: /mnt/c/Code/agentic-persona-mapping/.apm/agents/personas/communication_standards.md

Session Management

  • Session Notes: /mnt/c/Code/agentic-persona-mapping/.apm/session_notes/
  • Rules Directory: /mnt/c/Code/agentic-persona-mapping/.apm/agents/rules/
  • Project Documentation: /mnt/c/Code/agentic-persona-mapping/project_docs/

🆘 Troubleshooting

Common Issues

  • Voice not working: Check TTS provider configuration
  • Context loss: Verify session note creation and updates
  • Agent transitions failing: Ensure proper handoff documentation
  • Performance issues: Consider using parallel commands

Support Resources

  • Command Reference: See individual persona guides
  • Workflow Patterns: Check workflow documentation
  • Examples: Browse practical usage examples
  • Troubleshooting: Comprehensive issue resolution guide

The Coherence Orchestrator is your unified context engineering command center. Use it to orchestrate seamless coordination across all 11 specialized personas with intelligent workflow management and evidence-based protocols.

Clone this wiki locally