iop/agent-ops/roadmap/ROADMAP.md

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