Skip to content

elchris/APM

Β 
Β 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

🎭 Coherence - Agentic Persona Mapping

Unified Context Engineering

Version License Performance

Transform complexity into coherence with orchestrated AI persona intelligence.

Coherence is the AI context engineering platform that brings order to complexity, transforming multiple AI personas into a unified, harmonious system. Like a conductor leading an orchestra, Coherence ensures every persona plays its part perfectly.

⚑ Why Coherence?

  • 🎭 Unity from Multiplicity - Multiple personas, coherent output
  • 🎼 Orchestrated Intelligence - Not just AI, but coordinated AI
  • βš™οΈ Precision Context Control - Engineering-grade persona management
  • πŸ”„ Seamless Integration - Different voices, smooth transitions
  • πŸš€ 4-8x Faster Development - Native parallel execution across all agents
  • 🎯 Zero Setup Time - Working unified system in under 5 minutes
  • ✨ Automatic Claude Code Integration - Coherence Orchestrator auto-activates
  • πŸ’Ό Production Ready - Used by teams shipping real products

🎯 Quick Start

Install (30 seconds)

# Quick install with defaults (non-interactive)
curl -fsSL https://raw.githubusercontent.com/omayhemo/APM/master/install.sh | bash -s -- --defaults

# Or interactive installation
curl -fsSL https://raw.githubusercontent.com/omayhemo/APM/master/install.sh | bash

# Install specific version
curl -fsSL https://raw.githubusercontent.com/omayhemo/APM/master/install.sh | bash -s -- --version 4.1.4

# With TTS voice notifications
curl -fsSL https://raw.githubusercontent.com/omayhemo/APM/master/install.sh | bash -s -- --with-tts --defaults

Your First Command

# APM Orchestrator automatically activates after installation!
# Just start Claude Code and the enhanced output style is ready

# Activate the orchestrator manually
/ap

# Or jump straight to a specialist
/analyst        # Research and requirements
/architect      # System design  
/dev           # Code implementation
/qa            # Testing and quality

πŸ€– Meet Your AI Team

Agent Command Specialty
πŸ” Analyst /analyst Research, requirements, market analysis
πŸ“Š Product Manager /pm PRDs, product strategy, roadmaps
πŸ—οΈ Architect /architect System design, technical architecture
🎨 Design Architect /design-architect UI/UX, frontend architecture
πŸ“‹ Product Owner /po Backlog management, story grooming
πŸƒ Scrum Master /sm Sprint planning, story creation
πŸ’» Developer /dev Code implementation, optimization
πŸ” QA Engineer /qa Testing, quality assurance, automation
🎯 Orchestrator /ap Coordination, delegation, workflow

⚑ Power Features

Automatic Claude Code Integration

APM seamlessly integrates with Claude Code:

# APM Orchestrator output style automatically activated
# Enhanced structured communication patterns
# Evidence-based decision making protocols
# Parallel agent coordination built-in

Parallel Execution

Run multiple agents simultaneously for maximum speed:

/parallel-sprint    # 4 developers working in parallel
/parallel-qa        # Complete test suite execution
/parallel-prd       # 70% faster document creation

Smart Handoffs

Seamlessly transition between agents:

/analyst            # Gather requirements
/handoff architect  # Pass context to architect
/handoff dev        # Move to implementation

Release Automation

Complete release management in minutes:

/version 2.0.0      # Update all version references
/release 2.0.0      # Build, tag, and publish

πŸ“š Documentation

After installation, comprehensive documentation is available at:

  • .apm/README.md - Complete documentation index
  • .apm/documentation/ - All guides and references

πŸš€ Real Results

  • 70% faster PRD creation
  • 4.6x faster sprint completion
  • 92% accuracy in test predictions
  • 34+ hours/week saved per team

πŸ› οΈ Requirements

  • Claude Desktop (Claude Code)
  • Linux, macOS, or WSL
  • 2GB free space
  • Git (optional, for version control)

πŸ“¦ Installation Options

The universal installer v2.0 supports flexible command-line options for various installation scenarios:

Available Options

Option Short Description
--defaults -y Non-interactive installation with default settings
--version VERSION -v Install specific version (e.g., --version 4.1.4)
--path PATH -p Custom installation directory
--with-tts -t Enable TTS voice notifications
--quiet -q Minimal output (silent mode)
--verbose -V Detailed debug output
--help -h Show all available options

Installation Examples

# πŸš€ Quick install with defaults (recommended for automation)
curl -fsSL https://raw.githubusercontent.com/omayhemo/APM/master/install.sh | bash -s -- --defaults

# πŸ“ Install to specific directory
curl -fsSL https://raw.githubusercontent.com/omayhemo/APM/master/install.sh | bash -s -- --path /opt/apm --defaults

# 🎯 Install specific version
curl -fsSL https://raw.githubusercontent.com/omayhemo/APM/master/install.sh | bash -s -- --version 3.5.0 --defaults

# πŸ”Š Install with TTS voice notifications
curl -fsSL https://raw.githubusercontent.com/omayhemo/APM/master/install.sh | bash -s -- --with-tts --defaults

# 🀫 Silent installation (CI/CD friendly)
curl -fsSL https://raw.githubusercontent.com/omayhemo/APM/master/install.sh | bash -s -- --defaults --quiet

# πŸ” Debug installation issues
curl -fsSL https://raw.githubusercontent.com/omayhemo/APM/master/install.sh | bash -s -- --defaults --verbose

# πŸŽͺ Full-featured installation
curl -fsSL https://raw.githubusercontent.com/omayhemo/APM/master/install.sh | bash -s -- --path /opt/apm --with-tts --quiet --version 4.1.4

# ❓ Show help and all options
curl -fsSL https://raw.githubusercontent.com/omayhemo/APM/master/install.sh | bash -s -- --help

Interactive vs Non-Interactive

  • Interactive Mode (default): Prompts for configuration options

    # βœ… NOW WORKS! Fixed in v2.0 - accepts user input even when piped
    curl -fsSL https://raw.githubusercontent.com/omayhemo/APM/master/install.sh | bash

    You'll be prompted for:

    • Project name
    • Plopdock MCP Server setup
    • TTS provider selection
    • Notification preferences
    • Python support
  • Non-Interactive Mode: Perfect for automation and scripts

    curl -fsSL https://raw.githubusercontent.com/omayhemo/APM/master/install.sh | bash -s -- --defaults

    Uses defaults for all options - no prompts

πŸ“¦ Latest Release

v4.1.4 - Critical Fixes & Coherence Branding

  • πŸ”§ Critical bug fix - Eliminates "Wait: command not found" installation errors
  • Enhanced validation system - Automatically detects and corrects bash command typos
  • Auto-correction capability - Uses sed commands to fix capitalized "Wait" commands
  • Transparent operation - Clear feedback about validation results and fixes applied
  • Prevention framework - Blocks future similar bash command case sensitivity issues
  • Zero user impact - Validation runs seamlessly during installation process
  • Critical installation fixes - Resolves persistent "Wait: command not found" errors
  • Complete Coherence branding - Updated TTS messaging and consistent brand experience
  • Missing command integration - Added coherence command template processing

View all releases

🀝 Contributing

APM is actively developed and welcomes contributions. Check our contribution guidelines to get started.

πŸ“„ License

MIT License - see LICENSE for details.

πŸ”— Links


Ready to revolutionize your development workflow? Install APM and experience the power of parallel AI agents working as your team.

# Get started in 30 seconds (non-interactive)
curl -fsSL https://raw.githubusercontent.com/omayhemo/APM/master/install.sh | bash -s -- --defaults

Built for developers who ship.

About

The Release Repository for the Official - Agentic Persona Mapping

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Shell 100.0%