IOP 로드맵

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

전체 목표

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

현재 위치

활성 단계: Phase 1. Edge-Node 실행 기반
기본 마일스톤: M01 Edge-Node 실행 스켈레톤
기본 마일스톤 문서: agent-ops/roadmap/milestones/M01-edge-node-execution-skeleton.md
활성 마일스톤:
- M01 Edge-Node 실행 스켈레톤: agent-ops/roadmap/milestones/M01-edge-node-execution-skeleton.md
- M02 Edge 입력 표면: agent-ops/roadmap/milestones/M02-edge-input-surfaces.md

로딩 정책

일반 기능 추가, 구조 변경, 스킬 추가/수정, 문서 구조 변경 작업에서는 agent-ops/roadmap/current.md를 먼저 읽는다.
요청이 기본 마일스톤 범위에 맞으면 기본 마일스톤 문서를 같은 세션에서 1회 읽는다.
요청이 기본 마일스톤과 맞지 않으면 current.md의 활성 마일스톤 목록에서 가장 관련 있는 마일스톤 문서를 같은 세션에서 1회 읽는다.
활성 마일스톤에도 맞지 않으면 agent-ops/roadmap/ROADMAP.md의 마일스톤 인덱스를 확인하고 사용자에게 진행/전환 여부를 확인한다.
agent-ops/roadmap/ROADMAP.md는 로드맵 생성/갱신, Phase 전환, 마일스톤 추가/수정 요청이 있을 때만 읽는다.
작업 요청이 선택된 마일스톤의 목표 또는 제외 범위와 충돌하면 구현 전에 사용자에게 알리고 방향을 확인한다.

상태 의미

Planned: 아직 본격 작업 기준으로 삼지 않는 예정 마일스톤이다.
Active: 구현, 안정화, 문서 정리, 검증이 진행 중인 마일스톤이다. 여러 마일스톤이 동시에 Active일 수 있다.
Done: 성공 기준이 충족되어 완료된 마일스톤이다.
Paused: 일시 중단된 마일스톤이다.
Dropped: 현재 제품 방향에서 제외된 마일스톤이다.

current.md의 기본 마일스톤은 여러 Active 마일스톤 중 현재 세션의 기본 작업 초점이다.

단계 개요

Phase 1. Edge-Node 실행 기반

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

마일스톤	상태	문서
M01 Edge-Node 실행 스켈레톤	Active	`milestones/M01-edge-node-execution-skeleton.md`
M02 Edge 입력 표면	Active	`milestones/M02-edge-input-surfaces.md`

Phase 2. Automation Runtime과 Bridge 확장

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

마일스톤	상태	문서
M03 CLI Automation Runtime 안정화	Planned	`milestones/M03-cli-automation-runtime-stabilization.md`
M04 원격 터미널 브리지 POC	Planned	`milestones/M04-remote-terminal-bridge-poc.md`
M05 Agent Bootstrap과 OTO 등록	Planned	`milestones/M05-agent-bootstrap-oto-enrollment.md`

Phase 3. Control Plane과 Portal 운영

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

마일스톤	상태	문서
M06 Control Plane과 Portal	Planned	`milestones/M06-control-plane-portal.md`
M07 정책, 이력, 감사	Planned	`milestones/M07-policy-history-audit.md`
M08 Multi-Edge 운영	Planned	`milestones/M08-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와 요청에 맞는 기본/활성 마일스톤 문서
아키텍처 불변 원칙: docs/architecture.md
dev/field 배포 절차: docs/deploy-dev.md
앱별 현재 구현과 사용법: apps/*/README.md

5.2 KiB Raw Blame History