4.5 KiB
4.5 KiB
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