iop/agent-roadmap/phase/automation-runtime-bridge/milestones/agent-workflow-loop-orchestration-mvp.md

Milestone: 에이전트 작업 루프 오케스트레이션 MVP

위치

• Roadmap: ROADMAP.md
• Phase: PHASE.md

목표

사용자는 일반적인 바이브코딩처럼 한 번 요청하고, IOP는 요청을 direct, Plan, Milestone 단위로 분류해 필요한 작업 파일 생성, 실행 모델 라우팅, 상위 모델 리뷰, 후속 작업 연결을 자동으로 반복하는 방향을 스케치한다. MVP는 사용자 로컬 workspace를 작업 상태의 원본으로 유지하고, 지원 대상을 좁힌 agent-family protocol과 event-aware passthrough를 이용해 한 사이클이 완료될 때까지 이어지는 구조를 검증한다.

상태

[스케치]

승격 조건

• direct, Plan, Milestone 분류부터 완료 알림까지 한 사이클의 상태와 종료 조건을 확정한다.
• 최초 지원할 agent family와 각 family의 stream, tool call, tool result, continuation capability 경계를 정한다.
• 로컬 workspace 파일 상태와 IOP가 보유할 최소 in-flight 상태의 책임 경계를 확정한다.
• terminal event 대체와 합성 tool call을 포함한 event-aware passthrough의 protocol별 동작과 실패 경계를 정한다.
• Plan/Milestone 작업의 실행 모델 라우팅, 상위 모델 리뷰, 보완 반복의 횟수·비용·중단 기준을 정한다.
• MVP 한 사이클과 후속 재개/복구 Milestone의 범위를 분리한다.
• API/stream/tool/lifecycle 계약 구현으로 승격할 때 SDD와 후속 구현 Milestone 구성을 확정한다.

구현 잠금

• 상태: 잠금
• SDD: 불필요
• SDD 문서: 없음
• SDD 사유: 현재 Milestone은 작업 루프의 제품·런타임 방향을 정리하는 스케치이며, API/stream/tool/lifecycle 계약을 구현 가능한 계획으로 승격할 때 SDD를 작성한다.
• 잠금 해제 조건: 아래 체크리스트
  • 승격 조건의 미정 항목이 사용자 검토로 해소되어 있다.
  • 구현 가능한 MVP 범위와 후속 Milestone이 분리되어 있다.
• 결정 필요: 아래 체크리스트
  • MVP에서 우선 지원할 agent family 조합과 protocol capability 기준을 결정한다.
  • 사용자에게 그대로 노출할 중간 stream과 IOP가 교체할 terminal tail의 경계를 결정한다.
  • 자동 리뷰·보완 반복의 최대 횟수, 비용 예산, 사용자 중단 조건을 결정한다.
  • 완료 알림과 실패·부분 완료 상태를 사용자에게 표현하는 최소 UX를 결정한다.

범위

• 성능이 좋은 cloud 모델이 최초 요청을 direct, Plan, Milestone으로 분류하고, 동시에 local/cloud lane과 G0X grade를 판정하는 진입 라우팅
• 작은 direct 작업은 Milestone/Plan 생성 없이 즉시 상위 모델로 전달하는 fast path
• Plan/Milestone 작업은 IOP가 사용자 로컬 경로를 포함한 지시를 주입하고, 모델 stream과 write/edit tool call을 로컬 agent에 전달해 작업 파일을 로컬 workspace에 생성하는 경로
• 확정된 선행 stream은 지연 없이 전달하고 판정이 필요한 bounded tail만 보류한 뒤, 정상 terminal event를 억제하고 로컬 파일 read tool call로 대체할 수 있는 event-aware passthrough
• tool result가 새 HTTP 요청으로 돌아오더라도 같은 logical workflow/session으로 이어지는 continuation 경계
• agent-task/m-*, 순번 task directory, PLAN-{lane}-GNN.md, archive 이동을 이용한 filesystem-backed 작업 상태 판독
• IOP가 보유하는 session/call id 매핑과 active provider call 같은 최소 in-flight 상태
• Plan에 기록된 lane/grade에 따른 하이브리드 실행 라우팅과 상위 모델의 독립 리뷰, 보완 작업 재라우팅
• 모든 task가 닫히면 Milestone 완료와 사용자 complete/알림으로 끝나는 단일 작업 사이클
• Claude, Codex, Pi, OpenCode 같은 대중적 agent 후보를 제품명이 아니라 stream/tool/continuation capability family별 codec으로 지원하는 방향

기능

Epic: [entry-route] 요청 분류와 Fast Path

사용자가 orchestration 지식을 몰라도 요청 규모와 실행 경로를 자동으로 선택하는 진입 capability를 묶는다.

• [request-triage] 상위 모델이 요청을 direct, Plan, Milestone으로 분류하고 lane과 grade를 함께 판정하는 구조가 정리되어 있다.
• [direct-fastpath] 작은 작업은 Milestone/Plan 생성 비용 없이 즉시 상위 모델 실행으로 이어지는 경로가 정리되어 있다.
• [work-decompose] Plan과 Milestone 요청은 로컬 작업 파일을 기준으로 task를 순차 실행할 수 있게 분해되는 구조가 정리되어 있다.

Epic: [agent-bridge] Agent Bridge와 Stream Hook

로컬 agent가 파일과 tool 실행 주체로 남으면서 IOP가 다음 작업을 연결할 수 있는 통신 경계를 묶는다.

• [family-codec] 지원 agent를 stream terminal, tool call/result, continuation capability family로 묶고 공통 workflow와 분리하는 경계가 정리되어 있다.
• [terminal-hook] 선행 stream은 그대로 전달하고 bounded tail에서 terminal event만 억제·대체해 로컬 파일 read tool call로 전환하는 구조가 정리되어 있다.
• [workspace-state] 로컬 workspace 파일이 durable source of truth가 되고 IOP는 최소 in-flight 상태만 보유하는 책임 경계가 정리되어 있다.

Epic: [review-loop] 라우팅·리뷰·완료 루프

작은 모델과 로컬 모델의 실행 비용 이점을 유지하면서 상위 모델 리뷰로 품질을 닫는 capability를 묶는다.

• [task-route] Plan의 lane/grade와 agent capability에 따라 cloud/local 실행 후보로 task를 라우팅하는 구조가 정리되어 있다.
• [frontier-review] 구현 agent의 자가 검증이 아니라 독립된 상위 모델 리뷰가 통과·보완·중단을 판정하는 구조가 정리되어 있다.
• [cycle-complete] 한 사이클에서 모든 task와 Milestone 종료를 판정하고 사용자에게 complete와 알림을 보내는 구조가 정리되어 있다.

완료 리뷰

• 상태: 없음
• 요청일: 없음
• 완료 근거: 방향성 스케치이며 승격 조건과 기능 경계가 아직 확정되지 않았다.
• 검토 항목: 없음
• agent-ui 상태 반영: 해당 없음
• 리뷰 코멘트: 없음

범위 제외

• 중단 후 자동 재개, filesystem 정합성 복구, local model 기반 continuation point 판정
• 동시에 같은 작업을 실행하는 사용자 요청의 중복 방지, distributed lock, lease, idempotent replay
• 모든 agent와 모든 provider protocol을 MVP에서 한 번에 지원하는 작업
• Milestone/Plan/Review 파일 원문과 전체 stream history를 IOP 중앙 저장소에 영구 캐시하는 구조
• 장기 기억, RAG, 자동 policy self-mutation, 학습 기반 route threshold 자동 승격
• 세부 API field, event schema, 파일 위치, 패키지 구조의 구현 확정

작업 컨텍스트

• 관련 경로: apps/edge/internal/openai, apps/edge/internal/service, apps/node/internal/runtime, apps/node/internal/adapters/cli, agent-task
• 표준선(선택): workflow 의미와 다음 단계 선택 및 replacement 생성은 orchestration 계층이 소유하고, stream 모듈은 chunk parsing, bounded tail, terminal/tool event 판정과 상위 orchestration 계층이 전달한 replacement 적용만 담당한다. 외부 API caller는 replacement를 지정하지 않는다.
• 표준선(선택): durable workflow 상태는 사용자 로컬 workspace 파일에 두고, IOP는 재구성 가능한 내용을 별도 workflow DB나 파일 캐시로 복제하지 않는다.
• 표준선(선택): SSE 연결 하나를 양방향 세션으로 가정하지 않는다. tool result는 새 HTTP 요청으로 돌아올 수 있으며 logical workflow/session identity로 연결한다.
• 큐 배치: CLI Agent Group Grade Routing 뒤, CLI Agent 사용량 알림과 자동 이어받기 MVP 앞
• 선행 작업: CLI Agent Group Grade Routing, OpenAI-compatible 하이브리드 라우팅과 컨텍스트 최적화, OpenAI-compatible 출력 검증 필터
• 후속 작업: 중단 후 재개와 filesystem 정합성 복구, agent family 확대, 운영 관측과 비용 예산 정책
• 확인 필요: 구현 잠금 > 결정 필요와 승격 조건