ado

# ADO - Agentic Development Orchestrator

<p align="center">
  <strong>Unified AI coding agent orchestration with subscription-first routing</strong>
</p>

<p align="center">
  <a href="#features">Features</a> •
  <a href="#installation">Installation</a> •
  <a href="#quick-start">Quick Start</a> •
  <a href="#configuration">Configuration</a> •
  <a href="#commands">Commands</a> •
  <a href="#deployment">Deployment</a> •
  <a href="#architecture">Architecture</a>
</p>

---

## Overview

ADO (Agentic Development Orchestrator) is a TypeScript CLI tool that orchestrates multiple AI coding agents (Claude Code, Cursor CLI, Cursor CLI, GitHub Copilot, Codex) behind a unified interface with advanced autonomous workflow capabilities.

**Key Innovation:** Subscription-first routing prioritizes subscription-based access (Cursor MAX, Cursor Pro, etc.) over API billing to maximize value from existing subscriptions.

## Features

### Core Capabilities
- 🎯 **Unified Interface** - Single CLI for multiple AI coding agents
- 💰 **Subscription-First** - Maximize subscription value before API fallback
- 🔄 **Automatic Failover** - Seamless switching when rate limits hit
- 📊 **Usage Tracking** - Monitor costs and usage across providers
- 💾 **State Persistence** - Resume sessions, track history
- 🎨 **Beautiful CLI** - Interactive prompts and colorful output

### Autonomous Workflow (M8)
- 🧠 **Task Decomposition** - Breaks complex tasks into subtasks with checkpoints
- 📝 **Specification Generation** - Doc-first workflow (/specify → /plan → /tasks → /implement)
- ✅ **Quality Validation** - Multi-language build, test, lint validation (≥80% coverage)
- 🔧 **Auto-Fix Engine** - Automatic error fixing with stuck detection
- 🤝 **HITL Checkpoints** - Human-in-the-loop at critical points (5 iterations / 30 min thresholds)
- 🔄 **Recovery System** - Automatic retry, rollback, and restore

### Distributed Execution (M7)
- 🌐 **Remote Workers** - Distributed task execution via K8s
- 📡 **tRP