# Milestone: Finance Agent Research Sidecar Sketch

## 위치

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

## 목표

Anthropic finance agents 계열 skillset을 ALT에 즉시 도입하지 않고, 리서치 메모, 전략 가설, 백테스트 결과 해석을 돕는 sidecar 후보로 검토한다. ALT의 Go worker, protobuf contract, Flutter operator surface는 deterministic core로 유지하고, finance agent는 수치 출처와 사람 검토가 필요한 보조 산출물 생성 경계로만 다룬다.

## 상태

[스케치]

## 승격 조건

- [ ] 첫 적용 목적을 strategy hypothesis note, backtest commentary, universe idea generation, earnings review 중 하나로 좁힌다.
- [ ] 실행 위치를 개인 Claude plugin, 로컬 agent-ops skill, Claude Managed Agent/API sidecar, 또는 미도입 중 하나로 결정한다.
- [ ] 데이터/커넥터 경계를 KIS/KRX/DART/US provider, read-only MCP, 로컬 secret, cloud retention 기준으로 정리한다.
- [ ] research artifact가 instrument, watchlist, strategy, backtest run 중 무엇에 연결되는지 저장/계약 후보를 정한다.
- [ ] 수치 출처, 미출처 표시, untrusted document 처리, human sign-off, 자동 주문 금지 원칙을 완료 기준으로 승격할 수 있게 정리한다.
- [ ] 후속 구현 Milestone 후보를 artifact model, worker sidecar, operator display, US earnings workflow 중 필요한 단위로 나눈다.

## 구현 잠금

- 상태: 잠금
- 결정 필요: 아래 체크리스트
  - [ ] ALT에서 finance agent 보조층의 첫 사용 사례를 무엇으로 둘지 결정한다.
  - [ ] Claude/Cowork plugin처럼 개인 도구로만 쓸지, ALT worker/API 경계와 연결할지 결정한다.
  - [ ] 외부 MCP/data provider 구독, API key, 데이터 보존 위치를 허용할지 결정한다.
  - [ ] agent 산출물을 ALT 저장소에 남길지, 임시 operator note로만 둘지 결정한다.

## 범위

- Anthropic finance agents 발표와 marketplace skillset의 ALT 적용 후보 정리
- `market-researcher`, `earnings-reviewer`, `model-builder`, `financial-analysis` 계열 중 ALT와 맞는 subset 선별
- research artifact, strategy hypothesis, backtest commentary 후보 산출물 정의
- worker/API/client core와 분리되는 sidecar 책임 경계 정리
- compliance, source citation, human review, no-trade-execution guardrail 정리
- `[계획]` 승격 시 필요한 후속 구현 Milestone 후보 작성

## 필수 기능

### Epic: [agent-fit] Finance agent fit review

ALT의 개인 quant workspace 맥락에서 finance agent skillset의 도입 목적과 범위 적합성을 정리한다.

- [ ] [skill-subset] ALT에 맞는 skillset과 맞지 않는 skillset을 분리한다.
- [ ] [use-case] 첫 적용 후보와 보류 후보를 구분한다.
- [ ] [guardrails] 투자 조언, 자동 주문, 출처 없는 수치, untrusted document 실행을 막는 원칙을 정리한다.

### Epic: [sidecar-boundary] Research sidecar boundary

finance agent를 ALT core가 아니라 보조 분석 layer로 둘 때 필요한 런타임, 데이터, 산출물 경계를 정리한다.

- [ ] [runtime-options] 개인 plugin, 로컬 skill, Managed Agent/API sidecar 선택지를 비교한다.
- [ ] [data-boundary] 외부 data provider와 local secret, read-only connector 기준을 정리한다.
- [ ] [artifact-shape] research artifact가 instrument, strategy, backtest run과 연결되는 최소 shape를 제안한다.
- [ ] [handoff-plan] Backtest Analysis Surface, Flutter Operator Console, US Market Expansion 중 어느 후속 흐름과 연결할지 제안한다.

## 완료 기준

- [ ] finance agent 도입, 보류, 미도입을 판단할 기준이 문서화되어 있다.
- [ ] `[계획]` 승격을 위한 첫 사용 사례, runtime 위치, data boundary, review guardrail이 정리되어 있다.
- [ ] ALT core에 직접 agent runtime을 넣지 않는 범위 제외가 명확하다.
- [ ] 후속 구현 Milestone 후보가 필요 단위로 분리되어 있다.

## 완료 리뷰

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

## 범위 제외

- Claude plugin 설치 또는 Managed Agent 배포
- 외부 MCP/data provider credential 설정
- 실제 리서치 노트, Excel 모델, 투자 메모 생성
- 자동 투자 판단, 주문 제출, 실거래 execution
- `packages/contracts`, `services/api`, `services/worker`, `apps/client` 코드 변경

## 작업 컨텍스트

- 관련 경로: `agent-roadmap/phase/backtest-loop/`, `services/worker/`, `packages/contracts/`, `apps/client/`
- 표준선(선택): ALT core는 deterministic market data, backtest, operator contract를 우선하고 finance agent는 출처 검증과 사람 검토가 필요한 sidecar로 둔다.
- 표준선(선택): Anthropic finance agents의 유효성은 analyst workflow reference로만 보고, quant strategy 수익성이나 실거래 안정성의 근거로 사용하지 않는다.
- 표준선(선택): 모든 agent 산출물은 투자 조언이나 주문 지시가 아니라 검토 대기 draft로 취급한다.
- 선행 작업: Backtest Analysis Surface
- 후속 작업: Research Artifact Model, Finance Agent Worker Sidecar, Operator Research Notes, US Earnings Workflow 후보
- 확인 필요:
  - 첫 사용 사례 우선순위
  - 실행 위치와 외부 provider 허용 범위
  - 산출물 저장 여부와 human review 방식
