iop/agent-ops/roadmap/ROADMAP.md

4.5 KiB

IOP 로드맵

전체 목표

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

로드맵 전반에서 OpenAI-compatible API는 모델/chat completion 호환 입력 표면으로, A2A API는 외부 agent 작업 위임 표면으로, IOP native protocol은 운영 제어, logical session, background run, command, lifecycle event, remote terminal session 같은 IOP 고유 기능의 기준으로 둔다. Edge-Node와 Control Plane-Edge 장기 통신은 TCP/protobuf 기반 IOP Wire Protocol을 우선하며, gRPC, WebSocket 기본 transport 전환, actor/FSM/plugin framework 도입은 현재 기본 방향이 아니다.

Phase 흐름

  • Edge-Node 실행 기반: Edge-Node 소켓 실행 경로, Node adapter execution, CLI session, 최소 외부 입력 표면을 안정화한다.
  • Automation Runtime과 Bridge 확장: Runtime과 Automation 실행 흐름을 공통화하고, agent 설치형/비설치형 대상 제어 경로를 분리해 확장한다.
  • Control Plane과 Portal 운영: 여러 Edge를 관찰하고 운영하는 중앙 제어면과 Portal을 구축한다.

Milestone 목록

상태 값은 계획, 진행 중, 완료, 보류, 폐기 중 하나만 사용한다. 진행 순서는 아래 목록의 위에서 아래 흐름으로 해석한다.

Edge-Node 실행 기반

  • Edge-Node 실행 스켈레톤 - 상태: 완료; 목표: Node 등록, 설정 전달, adapter execution, run event streaming, command request/response, field smoke 기준을 한 흐름으로 검증한다.
  • Edge 입력 표면 - 상태: 완료; 목표: OpenAI-compatible API와 A2A JSON-RPC API를 내부 adapter + target 실행 경로로 수렴시킨다.

Automation Runtime과 Bridge 확장

  • CLI Automation Runtime 안정화 - 상태: 완료; 목표: one-shot, persistent terminal, opencode SSE, codex exec 같은 CLI 실행 모드를 같은 adapter execution 모델 안에서 안정화한다.
  • 원격 터미널 브리지 POC - 상태: 계획; 목표: Agent를 설치하기 어려운 host/device를 위해 Edge broker와 Node terminal transport 기반 원격 터미널 브리지 POC를 만든다.
  • Agent Bootstrap과 OTO 등록 - 상태: 계획; 목표: specialized domain agent의 bootstrap command 발급, 설치, 등록, 장기 credential 흐름을 설계한다.

Control Plane과 Portal 운영

  • Control Plane과 Portal - 상태: 계획; 목표: 여러 Edge를 연결하고 관찰하며 Edge 설정 변경, 명령 전달, 이벤트 수신을 담당하는 중앙 제어면과 Web Portal 운영면을 구축한다.
  • 정책, 이력, 감사 - 상태: 계획; 목표: 권한, 정책, 실행 이력, 감사 로그를 제품 운영에 필요한 수준으로 확장한다.
  • Multi-Edge 운영 - 상태: 계획; 목표: 여러 Edge group을 관찰하고 운영하는 fleet-level 기능을 구축한다.

로딩 정책

  • 일반 작업에서는 agent-ops/roadmap/ROADMAP.md를 매번 읽지 않는다.
  • 기능 추가, 구조 변경, 스킬 추가/수정, 문서 구조 변경 작업을 수행할 때는 agent-ops/roadmap/current.md를 먼저 읽는다.
  • current.md는 현재 작업 위치가 아니라 활성 Milestone 후보 목록이다.
  • current.md에는 개인별 현재 작업 위치나 완료 상태를 기록하지 않는다.
  • 요청 내용, 현재 브랜치, 변경 파일, 관련 코드 경로를 보고 가장 관련 있는 활성 Milestone 문서를 같은 세션에서 1회 읽는다.
  • 활성 Milestone 둘 이상에 걸치면 필요한 Milestone 문서를 모두 읽고 작업 범위를 좁힌다.
  • 활성 Milestone 밖의 작업이면 이 문서의 Milestone 목록을 확인하고 사용자에게 진행 또는 전환 여부를 확인한다.
  • 이 문서는 로드맵 생성/갱신, Phase 전환, Milestone 추가/수정 요청이 있을 때만 읽는다.
  • 상세 작업과 완료 기준은 각 Milestone 문서의 체크리스트로 관리한다.