orc

# ORC - Multi-Agent Orchestration System

## Overview

ORC (Orchestrator) is an autonomous multi-agent orchestration system for software development. It transforms high-level goals into complete, tested implementations through a structured phased approach.

## Priority Order

**Quality > Capability > Developer Experience > Speed > Cost**

## Core Workflow

```
User Goal → Analyze Phase → Plan Phase → User Approval → Execute Phase → Review Phase → Learn Phase
```

## Commands

### Analysis Commands

| Command | Description |
|---------|-------------|
| `/orc:analyze` | Analyze codebase conventions and patterns |
| `/orc:analyze --force` | Force re-analysis (ignore cache) |
| `/orc:analyze --focus <areas>` | Analyze specific areas only |

### Planning Commands

| Command | Description |
|---------|-------------|
| `/orc:plan <goal>` | Create or append epic to plan |
| `/orc:show` | Display plan summary |
| `/orc:show <epic-id>` | Display epic details |
| `/orc:show deviations` | Show all deviations for review |
| `/orc:approve` | Approve all pending epics |
| `/orc:approve <epic-id>` | Approve specific epic |

### Execution Commands

| Command | Description |
|---------|-------------|
| `/orc:run` | Execute all approved epics |
| `/orc:run <epic-id>` | Execute specific epic |
| `/orc:next` | Execute next priority epic only |
| `/orc:stop` | Stop execution gracefully |
| `/orc:resume` | Resume from last checkpoint |
| `/orc:retry <story-id>` | Retry a blocked story |

### Learning & Utility Commands

| Command | Description |
|---------|-------------|
| `/orc:patterns` | Show learned patterns |
| `/orc:learn` | Force pattern extraction now |
| `/orc:status` | Show current state summary |
| `/orc:clear` | Clear plan and state |

## Command Routing

When the user invokes `/orc`, parse the subcommand and route accordingly:

1. **analyze** - Load `commands/analyze.md` and invoke Analyzer agent
2. **plan** - Load `commands/plan.md` and invoke Planner agent (auto-runs analyz