iop/agent-ops/roadmap/ROADMAP.md

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