88 lines
3.6 KiB
Markdown
88 lines
3.6 KiB
Markdown
# Milestone: IOP Agent Shell Bridge Sketch
|
|
|
|
## 위치
|
|
|
|
- Roadmap: [ROADMAP.md](../../../ROADMAP.md)
|
|
- Phase: [PHASE.md](../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
|