alt/agent-roadmap/phase/agent-tooling/milestones/iop-agent-shell-bridge-sketch.md

Milestone: IOP Agent Shell Bridge Sketch

위치

• Roadmap: ROADMAP.md
• Phase: 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