# Milestone v1.1: OpenClaude CLI Integration — Roadmap

## Overview
| Metric | Value |
|--------|-------|
| Milestone | v1.1 |
| Phases | 3 (Phase 03–05) |
| Requirements | 9 |
| Coverage | 100% |

---

## Phase 03: CLI Build & Provider Connection
**Goal:** OpenClaude CLI를 Machine B에서 빌드하고 Variet Engine에 연결한다.

**Requirements:** BUILD-01, CONN-01, CONN-02

**Success Criteria:**
1. `bun install && bun run build`가 에러 없이 완료된다.
2. `node dist/cli.mjs`로 OpenClaude가 실행되고 프롬프트가 표시된다.
3. Variet Engine(`http://<Machine-A>:8000/v1`)에 프로바이더로 연결되어 `/health` 응답을 받는다.
4. 프로바이더 프로필이 `.openclaude-profile.json`에 저장되어 재실행 시 자동 로드된다.

**Dependencies:** Phase 02 (Variet Engine must be running on Machine A)

---

## Phase 04: Model Routing & Agent Loop
**Goal:** 5-Tier 모델 라우팅을 설정하고 전체 에이전트 루프(프롬프트 → 도구 → 코드)를 검증한다.

**Requirements:** ROUTE-01, ROUTE-02, AGENT-01, AGENT-02

**Success Criteria:**
1. `agentRouting` 설정으로 Explore/Plan/general-purpose 에이전트가 각각 다른 모델 tier를 사용한다.
2. 모델 핫스왑(`/engine/switch/{role}`)이 OpenClaude 세션 도중 트리거 가능하다.
3. 프롬프트 → LLM 응답 → bash/file/grep 도구 호출 → 코드 변경의 전체 에이전트 루프가 동작한다.
4. 스트리밍 응답이 실시간으로 터미널에 출력된다.
5. 5개 모델 tier 각각에서 최소 1회 성공적인 도구 호출이 완료된다.

**Dependencies:** Phase 03

---

## Phase 05: VS Code Extension Packaging
**Goal:** OpenClaude VS Code Extension을 빌드하고 Machine B에 설치하여 CLI를 래핑한 통합 개발 환경을 완성한다.

**Requirements:** BUILD-02, BUILD-03

**Success Criteria:**
1. `npx @vscode/vsce package`로 `.vsix` 파일이 생성된다.
2. Machine B의 VS Code에 Extension이 설치되고 Activity Bar에 OpenClaude 아이콘이 표시된다.
3. "OpenClaude: Launch in Terminal" 명령이 Variet Engine용 환경변수와 함께 터미널을 열고 CLI를 실행한다.
4. Control Center Webview에서 현재 프로바이더 상태가 표시된다.

**Dependencies:** Phase 04

### Phase 6: Install and evaluate Hermes Agent

**Goal:** [To be planned]
**Requirements**: TBD
**Depends on:** Phase 5
**Plans:** 0 plans

Plans:
- [ ] TBD (run /gsd-plan-phase 6 to break down)

---

## Requirement Traceability

| REQ-ID | Phase | Description |
|--------|-------|-------------|
| BUILD-01 | 03 | CLI 빌드 및 실행 |
| CONN-01 | 03 | Variet Engine 프로바이더 연결 |
| CONN-02 | 03 | 프로바이더 프로필 저장 |
| ROUTE-01 | 04 | 5-Tier agentRouting 설정 |
| ROUTE-02 | 04 | 모델 핫스왑 트리거 |
| AGENT-01 | 04 | 전체 에이전트 루프 검증 |
| AGENT-02 | 04 | 스트리밍 응답 출력 |
| BUILD-02 | 05 | Extension .vsix 패키징 |
| BUILD-03 | 05 | Extension 설정 구성 |
