# Milestone: Agent Usage Definition Sketch

## 위치

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

## 목표

에이전트를 특정 finance/stock 분석 기능으로 미리 도입하지 않고, ALT와 주변 프로젝트에서 어떤 용도의 도구로 사용할지 정의한다. 에이전트는 주식 분석 코어, 백테스트 코어, 데이터 수집 코어가 아니라 `../iop` backend와 `../agent-shell` frontend를 통해 사용될 수 있는 보조 도구층으로 먼저 정리한다.

## 상태

[스케치]

## 승격 조건

- [ ] 에이전트 사용 용도를 개발 보조, 운영 보조, 분석 보조, 문서/리포트 보조, 툴 orchestration 등 범주 단위로 정리한다.
- [ ] ALT 코어와 에이전트 도구층 사이의 책임 경계와 금지 경계를 정한다.
- [ ] `../iop` backend와 `../agent-shell` frontend가 맡을 역할을 ALT 관점에서 정리한다.
- [ ] 에이전트가 ALT 데이터/도구에 접근할 때의 read/write, persistence, review 기준 후보를 정한다.
- [ ] 후속 구현 Milestone을 iop-agent-shell bridge, ALT tool gateway, agent artifact policy 중 필요한 단위로 나눈다.

## 구현 잠금

- 상태: 잠금
- 결정 필요: 아래 체크리스트
  - [ ] 에이전트를 우선 어떤 용도 범주부터 사용할지 결정한다.
  - [ ] 에이전트가 ALT에 직접 연결될지, `../iop`를 통해서만 연결될지 결정한다.
  - [ ] 에이전트 산출물을 임시 세션 산출물로 둘지, 정제된 일부만 ALT DB에 남길지 결정한다.
  - [ ] 에이전트가 사용할 수 있는 ALT tool/API/CLI의 read/write 경계를 결정한다.

## 범위

- 에이전트 용도 범주와 비목표 정의
- ALT 코어와 agent tooling 사이의 책임 경계 정리
- `../iop` backend, `../agent-shell` frontend 사용 전제 기록
- 에이전트 산출물의 임시/영구 보존 후보와 human review 기준 정리
- 후속 구현 Milestone 후보 분리

## 기능

### Epic: [purpose] Agent purpose map

에이전트를 특정 주식 분석 기능으로 고정하지 않고, 여러 프로젝트에서 사용할 수 있는 도구 용도 범주로 정의한다.

- [ ] [usage-taxonomy] 에이전트 사용 용도 범주와 각 범주의 비목표를 정리한다.
- [ ] [core-boundary] 주식 분석, 백테스트, 데이터 정제 코어와 에이전트 도구층의 책임을 분리한다.
- [ ] [fixed-assumptions] `../iop` backend와 `../agent-shell` frontend 사용 전제를 명시한다.

### Epic: [policy] Tooling boundary policy

에이전트가 ALT의 데이터와 도구를 사용할 때 필요한 접근, 저장, 검토 기준을 스케치한다.

- [ ] [access-policy] 에이전트의 ALT tool/API/CLI 접근 후보와 read/write 경계를 정리한다.
- [ ] [artifact-policy] 에이전트 산출물 중 DB에 남길 정제 결과와 임시 산출물을 구분하는 후보 기준을 정리한다.
- [ ] [next-milestones] iop-agent-shell bridge와 ALT tool gateway 등 후속 구현 단위를 제안한다.

## 완료 리뷰

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

## 범위 제외

- finance agent skillset 도입
- 주식 분석 로직, 전략 판단 로직, 백테스트 인프라 구현
- `../iop` 또는 `../agent-shell` 코드 변경
- ALT worker/API/client에 agent runtime 직접 삽입
- 자동 투자 판단, 주문 제출, 실거래 execution

## 작업 컨텍스트

- 관련 경로: `../iop/`, `../agent-shell/`, `services/worker/`, `apps/cli/`, `packages/contracts/`
- 표준선(선택): agent는 ALT 코어를 대체하지 않고 도구/분석/운영 보조층으로 둔다.
- 표준선(선택): 주식 분석 기능은 agent가 아니라 ALT 코어 또는 별도 분석 모듈에서 설계될 수 있다.
- 표준선(선택): 에이전트 산출물은 자동 실행 근거가 아니라 검토 가능한 보조 산출물로 취급한다.
- 선행 작업: 없음
- 후속 작업: IOP Agent Shell Bridge Sketch, ALT Tool Gateway 후보
- 확인 필요:
  - 첫 용도 범주
  - ALT 연결 방식
  - 산출물 저장 기준
  - read/write 접근 경계
