gito/agent-roadmap/phase/agent-shell-iop-execution/PHASE.md
toki 7abd0f7de2 docs(agent-roadmap): IOP Agent Run Bridge를 검토중 상태로 승격하고 완료 리뷰를 기록한다
- Phase 상태와 Milestone 상태를 [진행중]에서 [검토중]으로 변경한다
- revision-event 기능 Task를 완료([x])로 마킹한다
- 완료 리뷰 섹션에 요청일, 완료 근거, 리뷰 코멘트를 기록한다
- 완료 근거에 revision-event 검증 테스트와 complete.log PASS 포함한다
2026-06-17 08:12:17 +09:00

35 lines
2.2 KiB
Markdown

# Phase: Agent Shell IOP Execution
## 상태
[진행중]
## 목표
workspace 상위 sibling 프로젝트 `../agent-shell`을 제품 비종속 Flutter agent UI/package로 사용하고, 그 UI를 구동하는 backend/runtime은 `../iop` 프로젝트가 맡도록 경계를 정리한다. Gito는 agent backend를 직접 구현하지 않고, repo/workspace/operation/event control plane과 Git 결과 수렴 계약을 제공한다.
## Milestone 흐름
완료된 Milestone은 archive 경로를 가리키고, 검토중, 진행중, 계획, 스케치 또는 보류 Milestone은 이 Phase 하위 `milestones/` 경로를 가리킨다.
완료, 검토중, 진행중, 계획, 스케치 순서로 두어 아래로 갈수록 미래 작업에 가까워지게 정렬한다.
스케치 Milestone은 아직 구현 가능한 계획이 아니므로 계획 Milestone보다 아래에 둔다.
- [완료] Agent Shell Package and IOP Backend Boundary
- 경로: `agent-roadmap/archive/phase/agent-shell-iop-execution/milestones/agent-shell-package-iop-backend-boundary.md`
- 요약: `../agent-shell`은 Flutter agent UI/package로 사용하고, backend/runtime owner는 `../iop` 프로젝트로 지정한다.
- [검토중] IOP Agent Run Bridge
- 경로: `agent-roadmap/phase/agent-shell-iop-execution/milestones/iop-agent-run-bridge.md`
- 요약: IOP backend가 수행한 agent run 결과를 Gito의 Git operation과 event 원장으로 수렴시키는 계약을 만든다.
- [계획] Command Policy and Cancellation
- 경로: `agent-roadmap/phase/agent-shell-iop-execution/milestones/command-policy-and-cancellation.md`
- 요약: IOP backend가 소유하는 command policy/cancel/log redaction 결과를 Gito operation state와 event로 반영하는 경계를 정한다.
## Phase 경계
- `../agent-shell`은 UI/package이며 local workspace command 실행 backend가 아니다.
- agent execution backend/runtime은 `../iop` 프로젝트가 소유한다.
- IOP 내부 모델 라우팅, RAG, output validation은 Gito의 소유 범위가 아니다.
- control plane은 arbitrary shell command를 직접 실행하지 않고 IOP backend/runtime 결과를 Git control plane 계약으로 수렴한다.
- provider-specific PR/MR 작업은 ChangeRequest adapter Phase에서 처리한다.