alt/agent-roadmap/phase/agent-tooling/milestones/agent-usage-definition-sketch.md

Milestone: Agent Usage Definition Sketch

위치

• Roadmap: ROADMAP.md
• Phase: 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 접근 경계