Skip to content

command reference APM COMMAND DOCUMENTATION MASTER

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

Coherence Command Documentation Master Index

Version 4.2.0 - Coherence Framework with Enhanced TTS Audio Experience

This master documentation provides comprehensive details for all Coherence APM (Agentic Persona Mapping) framework commands. All slash commands leverage the Coherence framework with unified context engineering for enhanced coordination and reliability.


πŸ“š Documentation Structure

Core Documentation Files

  1. Command Categories Overview - High-level categorization
  2. Core Orchestrator Commands - Central control and coordination
  3. Persona Activation Commands - Agent activation and switching
  4. Parallel Execution Commands - Enhanced parallel execution capabilities
  5. QA Framework Commands - Testing and quality assurance
  6. Project Management Commands - Planning and tracking
  7. Development Commands - Implementation and coding
  8. Documentation Commands - Document management
  9. Utility Commands - Helper and maintenance commands
  10. Quick Reference Guide - At-a-glance command summary

🎯 Command Categories

1. Core Orchestrator Commands (7 commands)

Central control, session management, and agent coordination

  • /coherence - Launch Coherence Orchestrator
  • /coherence - Legacy orchestrator access (redirects to /coherence)
  • /coherence - Legacy orchestrator access (redirects to /coherence)
  • /handoff - Direct agent transition
  • /switch - Agent switching with context
  • /session-note-setup - Initialize session management
  • /personas - List available personas
  • /version - Show Coherence version information

2. Persona Activation Commands (12 commands)

Direct activation of specialized agent personas

  • /analyst - Research and requirements specialist
  • /pm - Product Manager for PRDs and roadmaps
  • /architect - System architecture and design
  • /design-architect - UI/UX and frontend architecture
  • /po - Product Owner for backlog management
  • /sm - Scrum Master for agile processes
  • /dev - Code implementation specialist
  • /developer - Alternative developer activation
  • /qa - Quality assurance and testing
  • /subtask - Subtask management specialist
  • /ai-prompt - AI integration specialist
  • /research-prompt - Research documentation specialist

3. Parallel Execution Commands (6 commands)

Enhanced parallel processing capabilities

  • /planning-next-story - Parallel story processing
  • /planning-checklist - Parallel checklist creation
  • /planning-stories - Parallel story planning
  • /qa-acceptance-criteria - Parallel acceptance criteria
  • /qa-framework - Parallel QA execution
  • /qa-regression-suite - Parallel regression testing
  • Project Management (5): PRD, epic, stories, acceptance criteria, validation
  • Quality & Testing (6): test strategy, test plan, automation, quality review, regression, QA framework
  • Development (2): sprint coordination, parallel execution
  • Course Correction (2): checklist, course correction
  • Documentation (2): doc sharding, library indexing

4. QA Framework Commands (11 commands)

Comprehensive testing and quality assurance

  • /qa-framework - Complete QA system access
  • /qa-predict - ML-powered failure prediction
  • /qa-optimize - Test execution optimization
  • /qa-anomaly - Quality anomaly detection
  • /qa-insights - AI-powered insights
  • /run-tests - Execute test suites
  • /monitor-tests - Real-time test monitoring
  • /show-test-status - Test status dashboard
  • /test-dashboard - Comprehensive test view
  • /test-metrics - Quality metrics analysis
  • /test-plan - Test planning

5. Project Management Commands (15 commands)

Planning, tracking, and coordination

  • /project-brief - Project initialization
  • /prd - Product Requirements Document
  • /epic - Epic creation and management
  • /stories - User story generation
  • /groom - Backlog grooming
  • /prioritization - Feature prioritization
  • /acceptance-criteria - AC definition
  • /validation - Story validation
  • /next-story - Story progression
  • /checklist - Task checklists
  • /course-correction - Agile adjustments
  • /requirements - Requirements gathering
  • /stakeholder-review - Stakeholder feedback
  • /ux-spec - UX specifications
  • /release - Release management

6. Development Commands (8 commands)

Code implementation and technical work

  • /architecture - System design
  • /frontend-architecture - UI architecture
  • /automation-plan - Automation strategy
  • /ai-prompt - AI integration prompts
  • /git-commit-all - Version control
  • /buildit - Build distribution
  • /version - Version management
  • /update-all-documentation - Doc updates

7. Documentation Commands (6 commands)

Document processing and management

  • /doc-sharding - Document segmentation
  • /library-indexing - Knowledge indexing
  • /doc-compliance - Compliance checking
  • /doc-compliance-enhanced - Advanced compliance
  • /organize-docs - Document organization
  • /research-prompt - Research documentation

πŸš€ Key Features

Native Sub-Agent Architecture (v4.2.0)

  • Performance: 4-8x faster than sequential execution
  • Reliability: Zero CLI crashes with native integration
  • Scalability: 2-8 concurrent sub-agents per command
  • Intelligence: Smart dependency management and conflict resolution

Command Execution Patterns

Single Agent Commands

User: /dev
Result: Activates Developer persona for sequential work

Parallel Commands (Native Sub-Agents)

User: /implementation-sprint
Result: Launches 4 native Developer sub-agents working concurrently
Performance: 4.6x faster completion

Command Chaining

User: /analyst β†’ /pm β†’ /architect β†’ /dev β†’ /qa
Result: Complete development lifecycle workflow

πŸ“Š Performance Metrics

Parallel Command | Command Category | Sequential Time | Parallel Time | Speedup |

|-----------------|-----------------|---------------|---------| | Sprint Development | 8.5 hours | 1.8 hours | 4.6x | | PRD Creation | 3.5 hours | 1.0 hour | 3.5x | | Architecture Design | 4.0 hours | 1.0 hour | 4.0x | | Test Suite Execution | 2.0 hours | 0.5 hours | 4.0x | | Document Processing | 6.0 hours | 0.9 hours | 6.7x |


πŸŽ“ Usage Guidelines

When to Use Parallel Commands

  • Large Tasks: Any task requiring >30 minutes of work
  • Multiple Components: Tasks with independent subtasks
  • Time-Critical: When speed is essential
  • Batch Operations: Processing multiple items

When to Use Single Agent Commands

  • Simple Tasks: Quick, focused work
  • Sequential Dependencies: Tasks requiring ordered execution
  • Interactive Work: Real-time collaboration needed
  • Learning/Exploration: Understanding codebase

πŸ”§ Command Syntax

Basic Command Structure

/<command> [options] [parameters]

Examples

# Basic activation
/dev

# With parameters
/stories --count=5 --type=user

# Parallel execution
/implementation-sprint --agents=4

# Chained workflow
/analyst && /pm && /architect

πŸ“ˆ Version History

v4.2.0 (Current)

  • Complete Task tool modernization
  • 100% native sub-agent architecture
  • 25,599 lines of deprecated code removed
  • Unified persona system with JSON definitions

v3.5.0

  • Enhanced parallel commands
  • QA framework AI/ML integration
  • MCP Plopdock integration

v3.2.0

  • Initial parallel command implementation
  • Performance optimization framework

πŸ”— Related Documentation


πŸ“ Quick Start

First Time Setup

1. Install APM: ./installer/install.sh
2. Initialize: /session-note-setup
3. Launch: /coherence
4. Select persona: /dev
5. Begin work!

Common Workflows

New Project

/coherence β†’ /analyst β†’ /pm β†’ /architect β†’ /po β†’ /sm β†’ /dev β†’ /qa

Sprint Development

/implementation-sprint --stories=5 --agents=4

Document Processing

/parallel-doc-sharding --file=requirements.pdf --chunks=10

πŸ†˜ Getting Help

  • Command Help: /<command> --help
  • List Commands: /personas
  • View Status: /coherence status
  • Documentation: This guide and linked files
  • Support: Create issue in project repository

Generated by Coherence v4.2.0 - Unified Documentation & Enhanced TTS Last Updated: 2025-08-19

Clone this wiki locally