79 lines
4.5 KiB
Markdown
79 lines
4.5 KiB
Markdown
# IOP Roadmap
|
|
|
|
이 문서는 IOP 제품 방향과 Phase/Milestone의 canonical source of truth다.
|
|
README와 `docs/**`는 제품 소개, 아키텍처 원칙, 운영 절차를 설명하고, 미래 계획과 우선순위는 이 문서와 각 Milestone 문서에서 관리한다.
|
|
|
|
## Overall Goal
|
|
|
|
IOP(Inference Operations Platform)는 Control Plane - Edge - Node 계층 구조를 기반으로 모델 서빙과 CLI Agent/Automation 실행을 함께 운영하는 실행 오케스트레이션 플랫폼을 만든다.
|
|
내부 실행 모델은 `adapter + target`을 기준으로 하며, Edge가 로컬 실행 그룹의 상태와 라우팅을 소유하고 Control Plane은 Edge를 통해 시스템을 관찰하고 제어한다.
|
|
|
|
## Current Position
|
|
|
|
- Active Phase: Phase 1. Edge-Node Execution Foundation
|
|
- Active Milestone: M01 Edge-Node Execution Skeleton
|
|
- Active Milestone File: `agent-ops/roadmap/milestones/M01-edge-node-execution-skeleton.md`
|
|
|
|
## Loading Policy
|
|
|
|
- 일반 기능 추가, 구조 변경, 스킬 추가/수정, 문서 구조 변경 작업에서는 `agent-ops/roadmap/current.md`를 먼저 읽고, 그 안의 Active Milestone 문서를 같은 세션에서 1회 읽는다.
|
|
- `agent-ops/roadmap/ROADMAP.md`는 로드맵 생성/갱신, Phase 전환, Milestone 추가/수정 요청이 있을 때만 읽는다.
|
|
- Active Milestone의 Goal 또는 Non-Goals와 작업 요청이 충돌하면 구현 전에 사용자에게 알리고 방향을 확인한다.
|
|
|
|
## Status Semantics
|
|
|
|
- `Planned`: 아직 본격 작업 기준으로 삼지 않는 예정 Milestone이다.
|
|
- `Active`: 구현, 안정화, 문서 정리, 검증이 진행 중인 Milestone이다. 여러 Milestone이 동시에 `Active`일 수 있다.
|
|
- `Done`: Success Criteria가 충족되어 완료된 Milestone이다.
|
|
- `Paused`: 일시 중단된 Milestone이다.
|
|
- `Dropped`: 현재 제품 방향에서 제외된 Milestone이다.
|
|
|
|
`current.md`가 가리키는 Active Milestone은 여러 `Active` Milestone 중 현재 세션의 기본 작업 초점이다.
|
|
|
|
## Phase Overview
|
|
|
|
### Phase 1. Edge-Node Execution Foundation
|
|
|
|
Goal: Edge-Node 소켓 실행 경로, Node adapter execution, CLI session, 최소 외부 입력 표면을 안정화한다.
|
|
|
|
| Milestone | Status | File |
|
|
|---|---|---|
|
|
| M01 Edge-Node Execution Skeleton | Active | `milestones/M01-edge-node-execution-skeleton.md` |
|
|
| M02 Edge Input Surfaces | Active | `milestones/M02-edge-input-surfaces.md` |
|
|
|
|
### Phase 2. Automation Runtime and Bridge Expansion
|
|
|
|
Goal: Runtime과 Automation 실행 흐름을 공통화하고, agent 설치형/비설치형 대상 제어 경로를 분리해 확장한다.
|
|
|
|
| Milestone | Status | File |
|
|
|---|---|---|
|
|
| M03 CLI Automation Runtime Stabilization | Planned | `milestones/M03-cli-automation-runtime-stabilization.md` |
|
|
| M04 Remote Terminal Bridge POC | Planned | `milestones/M04-remote-terminal-bridge-poc.md` |
|
|
| M05 Agent Bootstrap and OTO Enrollment | Planned | `milestones/M05-agent-bootstrap-oto-enrollment.md` |
|
|
|
|
### Phase 3. Control Plane and Portal Operations
|
|
|
|
Goal: 여러 Edge를 관찰하고 운영하는 중앙 제어면과 Portal을 구축한다.
|
|
|
|
| Milestone | Status | File |
|
|
|---|---|---|
|
|
| M06 Control Plane and Portal | Planned | `milestones/M06-control-plane-portal.md` |
|
|
| M07 Policy History Audit | Planned | `milestones/M07-policy-history-audit.md` |
|
|
| M08 Multi-Edge Operations | Planned | `milestones/M08-multi-edge-operations.md` |
|
|
|
|
## Cross-Cutting Principles
|
|
|
|
- 내부 실행 용어는 `adapter`, `target`, `execution`을 우선한다. `model`은 OpenAI-compatible 경계나 legacy compatibility에서만 사용한다.
|
|
- Control Plane은 Node를 직접 연결하거나 직접 스케줄링하지 않는다. Edge가 로컬 Node registry와 런타임 상태의 원본을 가진다.
|
|
- Edge-Node, Control Plane-Edge 장기 통신 기준은 TCP/protobuf 기반 IOP Wire Protocol이다.
|
|
- gRPC, WebSocket 기본 transport 전환, actor/FSM/plugin framework 도입은 현재 기본 방향이 아니다.
|
|
- OpenAI-compatible API는 모델/chat completion 호환 입력 표면이고, A2A API는 외부 agent 작업 위임 입력 표면이다.
|
|
- IOP native protocol은 Edge/Node 운영 제어, logical session, background run, command, lifecycle event, remote terminal session 같은 IOP 고유 기능을 다룬다.
|
|
|
|
## Roadmap Ownership
|
|
|
|
- 제품 방향, Phase, Milestone, 우선순위: `agent-ops/roadmap/ROADMAP.md`
|
|
- 현재 작업 기준: `agent-ops/roadmap/current.md`와 Active Milestone 문서
|
|
- 아키텍처 불변 원칙: `docs/architecture.md`
|
|
- dev/field 배포 절차: `docs/deploy-dev.md`
|
|
- 앱별 현재 구현과 사용법: `apps/*/README.md`
|