ai-codex-orchestrator

# AI Codex Orchestrator (ACO) v1.0

> **AI 코딩 도구 통합 + 멀티 에이전트 오케스트레이션** — 5가지 AI 코딩 도구를 CLI에서 비대화형으로 실행하고, 자율 라우팅 기반 멀티 에이전트 파이프라인으로 소프트웨어를 자동 생산합니다.

---

## v1.0 신기능

v1.0은 기존 3가지 도구 실행 기능에 **멀티 에이전트 오케스트레이션 엔진**을 추가합니다.

| 기능 | 설명 | 스크립트 |
|------|------|----------|
| 단일 도구 실행 | 5가지 AI 도구를 동일 인터페이스로 실행 | `run-agent.sh` |
| 팬아웃/팬인 | 여러 AI에 동시 질문 → 결과 통합 | `fan-out.sh` |
| 팀 파이프라인 | 마크다운 기반 역할 분담 파이프라인 | `team-run.sh` |
| **멀티 에이전트** | JSON 기반 자율 라우팅 파이프라인 (신규) | `aco` CLI |

---

## 빠른 시작

### 1. 설치

```bash
git clone https://github.com/your-org/ai-codex-orchestrator.git
cd ai-codex-orchestrator
bash install.sh
source ~/.zshrc   # 또는 source ~/.bashrc
```

### 2. 설치 확인

```bash
check-tools.sh    # 도구별 설치 상태 확인
aco version       # ACO 버전 확인
```

### 3. 기본 사용

```bash
# 단일 도구 실행
run-agent.sh cursor -- "파이썬으로 구구단 코드 만들어줘"

# 여러 도구 동시 질문
fan-out.sh --tools "cursor,codex,cursor" --merge cursor -- "코드 리뷰해줘"

# 멀티 에이전트 파이프라인 (신규!)
aco run examples/simple-chain/ --dry-run   # 계획 확인
aco run examples/simple-chain/              # 실행
```

---

## 핵심 기능

### 1. 단일 도구 실행 (`run-agent.sh`)

5가지 AI 코딩 도구를 동일한 인터페이스로 비대화형 실행합니다.

```bash
run-agent.sh cursor -- "파이썬으로 구구단 코드 만들어줘"
run-agent.sh cursor -f prompt.md -o result.md
cat error.log | run-agent.sh codex -- "이 에러를 해결해줘"
```

지원 도구: `cursor` · `codex` · `cursor` · `opencode` · `cursor`

**결과 확인:**
- **콘솔 출력**: 결과가 터미널에 바로 출력됩니다
- **파일 저장**: `-o result.md` 옵션으로 파일에 저장
- **세션 기록**: `.agent-sessions/` 폴더에 자동 보관 (query.md, response.md)

### 2. 팬아웃/팬인 (`fan-out.sh`)

하나의 질문을 여러 AI에 동시에 보내고, 메인 모델이 결과를 종합합니다.

```bash
fan-out.sh --tools "cursor,codex,cursor" --merge cursor \
  -- "이 프로젝트의 아키텍처를 분석해줘"
```

### 3. 팀 파이프라인 (`team-run.sh`)

마크다운으로 팀을 정의하면 이전 에이전트의 결과가 다음 에이전트의 입력으로 자동 주입됩니다.

```bash
team-run.sh templates/team-code-review.md
```

### 4. 멀티 에이전트 오케스트레이션 (`aco` CLI) — 신규

`bead-plan.json` 하나로 완전자동 멀티 에이전트 파이프라인을 실행합니다.

```bash
# bead-plan.json이 있는 디렉토리 실행
aco run examples/review-loop/

# 상태 확인
aco status <bead-id>

# 메시지 로