# Milestone: IOP Agent Shell Bridge Sketch

## 위치

- Roadmap: `agent-roadmap/ROADMAP.md`
- Phase: `agent-roadmap/phase/agent-tooling/PHASE.md`

## 목표

`../iop`를 agent backend로, `../agent-shell`을 frontend로 사용할 때 ALT와 어떻게 느슨하게 연결할지 정리한다. 이 마일스톤은 바로 구현을 확정하지 않고, 프로젝트 역할, 호출 방향, local/dev topology, 최소 계약 후보를 먼저 스케치한다.

## 상태

[스케치]

## 승격 조건

- [ ] `../iop`, `../agent-shell`, ALT 사이의 프로젝트 역할과 소유 경계를 정한다.
- [ ] 호출 방향을 `agent-shell -> iop -> ALT tool/API/CLI`, `ALT -> iop`, 또는 별도 gateway 중 하나로 좁힌다.
- [ ] local/dev 실행 topology와 secret/env 전달 경계를 정한다.
- [ ] 최소 연결 계약 후보를 CLI, proto-socket/API, MCP/tool gateway, file artifact handoff 중에서 비교한다.
- [ ] 구현 Milestone으로 나눌 경우 bridge scaffold, ALT tool gateway, artifact handoff 중 필요한 단위를 정한다.

## 구현 잠금

- 상태: 잠금
- 결정 필요: 아래 체크리스트
  - [ ] 기본 호출 방향과 소유 프로젝트를 결정한다.
  - [ ] ALT와 연결할 transport/tool boundary를 결정한다.
  - [ ] local secret/env 전달 방식을 결정한다.
  - [ ] bridge의 첫 smoke scenario를 결정한다.

## 범위

- `../iop` backend와 `../agent-shell` frontend의 ALT 연동 후보 정리
- 프로젝트 간 역할, 호출 방향, 실행 topology 스케치
- ALT tool/API/CLI 연결 방식 후보 비교
- 산출물 handoff와 review boundary 후보 정리
- 후속 구현 Milestone 후보 분리

## 기능

### Epic: [topology] Project topology

세 프로젝트가 어떤 방향으로 연결되는지, 어느 프로젝트가 어떤 책임을 갖는지 정리한다.

- [ ] [project-roles] `../iop`, `../agent-shell`, ALT의 역할과 소유 경계를 정리한다.
- [ ] [call-flow] 후보 호출 방향과 장단점을 비교한다.
- [ ] [local-dev] local/dev 실행 topology와 env/secret 전달 후보를 정리한다.

### Epic: [bridge] Bridge contract candidates

실제 연결 전에 최소 계약과 handoff 방식을 비교한다.

- [ ] [interface-options] CLI, API/proto-socket, MCP/tool gateway, file artifact handoff 후보를 비교한다.
- [ ] [review-boundary] agent 산출물이 ALT DB 또는 운영 판단으로 넘어가기 전 review boundary를 정리한다.
- [ ] [implementation-split] bridge scaffold와 ALT tool gateway 등 후속 구현 단위를 제안한다.

## 완료 리뷰

- 상태: 없음
- 요청일: 없음
- 완료 근거: 아직 스케치 상태이며 승격 조건이 충족되지 않았다.
- 리뷰 필요:
  - [ ] 사용자가 완료 결과를 확인했다
  - [ ] archive 이동을 승인했다
- 리뷰 코멘트: 없음

## 범위 제외

- `../iop`, `../agent-shell`, ALT 코드 구현
- agent skill 내용 설계
- 주식 분석/백테스트 판단 로직 설계
- production 배포, 인증, 장기 운영 모니터링 구현
- 자동 주문 또는 실거래 execution

## 작업 컨텍스트

- 관련 경로: `../iop/`, `../agent-shell/`, `apps/cli/`, `services/api/`, `services/worker/`, `packages/contracts/`
- 표준선(선택): bridge는 ALT 코어를 뒤집지 않고 외부 도구층에서 ALT의 headless/API 경계를 사용하는 방향을 우선 검토한다.
- 표준선(선택): 연결 계약은 먼저 local/dev smoke가 가능한 최소 단위로 둔다.
- 선행 작업: Agent Usage Definition Sketch
- 후속 작업: IOP Agent Shell Bridge Implementation, ALT Tool Gateway 후보
- 확인 필요:
  - 호출 방향
  - transport/tool boundary
  - secret/env 전달 방식
  - 첫 smoke scenario
