# IOP 로드맵

이 문서는 IOP 제품 방향과 단계/마일스톤의 단일 기준 문서다.
README와 `docs/**`는 제품 소개, 아키텍처 원칙, 운영 절차를 설명하고, 미래 계획과 우선순위는 이 문서와 각 마일스톤 문서에서 관리한다.

## 전체 목표

IOP(Inference Operations Platform)는 Control Plane - Edge - Node 계층 구조를 기반으로 모델 서빙과 CLI Agent/Automation 실행을 함께 운영하는 실행 오케스트레이션 플랫폼을 만든다.
내부 실행 모델은 `adapter + target`을 기준으로 하며, Edge가 로컬 실행 그룹의 상태와 라우팅을 소유하고 Control Plane은 Edge를 통해 시스템을 관찰하고 제어한다.

## 현재 위치

- 현재 활성 Milestone 후보는 `agent-ops/roadmap/current.md`에서 관리한다.
- 현재 활성 Milestone:
  - Edge-Node 실행 스켈레톤: `agent-ops/roadmap/milestones/edge-node-execution-skeleton.md`
  - Edge 입력 표면: `agent-ops/roadmap/milestones/edge-input-surfaces.md`

## 로딩 정책

- 일반 기능 추가, 구조 변경, 스킬 추가/수정, 문서 구조 변경 작업에서는 `agent-ops/roadmap/current.md`를 먼저 읽는다.
- `current.md`는 현재 작업 위치가 아니라 활성 Milestone 후보 목록이다.
- 요청 내용, 현재 브랜치, 변경 파일, 관련 코드 경로를 보고 가장 관련 있는 활성 Milestone 문서를 같은 세션에서 1회 읽는다.
- 요청이 활성 Milestone 둘 이상에 걸치면 필요한 Milestone 문서를 모두 읽고 작업 범위를 좁힌다.
- 활성 Milestone 밖의 작업이면 `agent-ops/roadmap/ROADMAP.md`의 Milestone 목록을 확인하고 사용자에게 진행 또는 전환 여부를 확인한다.
- `agent-ops/roadmap/ROADMAP.md`는 로드맵 생성/갱신, Phase 전환, 마일스톤 추가/수정 요청이 있을 때만 읽는다.
- 작업 요청이 선택된 Milestone의 목표 또는 범위 제외 항목과 충돌하면 구현 전에 사용자에게 알리고 방향을 확인한다.

## 상태 의미

- `계획`: 아직 본격 작업 기준으로 삼지 않는 예정 Milestone이다.
- `진행 중`: 구현, 안정화, 문서 정리, 검증이 진행 중인 Milestone이다. 여러 Milestone이 동시에 `진행 중`일 수 있다.
- `완료`: 완료 기준이 충족된 Milestone이다.
- `보류`: 일시 중단된 Milestone이다.
- `폐기`: 현재 제품 방향에서 제외된 Milestone이다.

`current.md`는 현재 열어둘 활성 Milestone 후보 목록이며, 개인별 작업 위치나 완료 상태의 진실이 아니다.

## 단계 개요

### Edge-Node 실행 기반

목표: Edge-Node 소켓 실행 경로, Node adapter execution, CLI session, 최소 외부 입력 표면을 안정화한다.

| Milestone | 상태 | 문서 |
|---|---|---|
| Edge-Node 실행 스켈레톤 | 진행 중 | `milestones/edge-node-execution-skeleton.md` |
| Edge 입력 표면 | 진행 중 | `milestones/edge-input-surfaces.md` |

### Automation Runtime과 Bridge 확장

목표: Runtime과 Automation 실행 흐름을 공통화하고, agent 설치형/비설치형 대상 제어 경로를 분리해 확장한다.

| Milestone | 상태 | 문서 |
|---|---|---|
| CLI Automation Runtime 안정화 | 계획 | `milestones/cli-automation-runtime-stabilization.md` |
| 원격 터미널 브리지 POC | 계획 | `milestones/remote-terminal-bridge-poc.md` |
| Agent Bootstrap과 OTO 등록 | 계획 | `milestones/agent-bootstrap-oto-enrollment.md` |

### Control Plane과 Portal 운영

목표: 여러 Edge를 관찰하고 운영하는 중앙 제어면과 Portal을 구축한다.

| Milestone | 상태 | 문서 |
|---|---|---|
| Control Plane과 Portal | 계획 | `milestones/control-plane-portal.md` |
| 정책, 이력, 감사 | 계획 | `milestones/policy-history-audit.md` |
| Multi-Edge 운영 | 계획 | `milestones/multi-edge-operations.md` |

## 공통 원칙

- 내부 실행 용어는 `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 고유 기능을 다룬다.

## 로드맵 소유권

- 제품 방향, 단계, 마일스톤, 우선순위: `agent-ops/roadmap/ROADMAP.md`
- 현재 작업 후보: `agent-ops/roadmap/current.md`와 요청에 맞는 활성 Milestone 문서
- 아키텍처 불변 원칙: `docs/architecture.md`
- dev/field 배포 절차: `docs/deploy-dev.md`
- 앱별 현재 구현과 사용법: `apps/*/README.md`