From 2ac47dbe2e88de700d800abc6f45e1af1042bf04 Mon Sep 17 00:00:00 2001 From: Variet-Worker Date: Tue, 7 Apr 2026 20:58:12 +0900 Subject: [PATCH] docs: create milestone v1.1 roadmap (3 phases) --- .planning/REQUIREMENTS.md | 18 +++++----- .planning/ROADMAP.md | 71 +++++++++++++++++++++++++++++++++++++++ .planning/STATE.md | 6 ++-- 3 files changed, 83 insertions(+), 12 deletions(-) create mode 100644 .planning/ROADMAP.md diff --git a/.planning/REQUIREMENTS.md b/.planning/REQUIREMENTS.md index e7fb051..e7f15dc 100644 --- a/.planning/REQUIREMENTS.md +++ b/.planning/REQUIREMENTS.md @@ -33,12 +33,12 @@ | REQ-ID | Phase | Status | |--------|-------|--------| -| CONN-01 | — | Pending | -| CONN-02 | — | Pending | -| ROUTE-01 | — | Pending | -| ROUTE-02 | — | Pending | -| AGENT-01 | — | Pending | -| AGENT-02 | — | Pending | -| BUILD-01 | — | Pending | -| BUILD-02 | — | Pending | -| BUILD-03 | — | Pending | +| CONN-01 | 03 | Pending | +| CONN-02 | 03 | Pending | +| ROUTE-01 | 04 | Pending | +| ROUTE-02 | 04 | Pending | +| AGENT-01 | 04 | Pending | +| AGENT-02 | 04 | Pending | +| BUILD-01 | 03 | Pending | +| BUILD-02 | 05 | Pending | +| BUILD-03 | 05 | Pending | diff --git a/.planning/ROADMAP.md b/.planning/ROADMAP.md new file mode 100644 index 0000000..d8cdd51 --- /dev/null +++ b/.planning/ROADMAP.md @@ -0,0 +1,71 @@ +# 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://: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 + +--- + +## 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 설정 구성 | diff --git a/.planning/STATE.md b/.planning/STATE.md index 8086e15..f3e7bdc 100644 --- a/.planning/STATE.md +++ b/.planning/STATE.md @@ -4,10 +4,10 @@ A high-performance, locally-hosted AI assistant system built on two RTX 3060 12GB GPUs. It uses a "2+0" architecture where Machine A acts as a dedicated inference server running large language models, while Machine B handles the user interface (VS Code, Discord) and tool execution. ## Current Position -Phase: Not started (defining requirements) +Phase: 03-cli-build-provider (Next) Plan: — -Status: Defining requirements -Last activity: 2026-04-07 — Milestone v1.1 started +Status: Roadmap defined, ready to plan Phase 03 +Last activity: 2026-04-07 — Milestone v1.1 roadmap created (3 phases) ## Progress [████████████████████] 100% (Phase 01: LLM Tuning)