alt/agent-ops/roadmap/ROADMAP.md

5.7 KiB

로드맵

전체 목표

ALT는 개인용 quant system workspace로, 한국장 일봉 MVP에서 시작해 시장 데이터 수집, 정규화, 백테스트, 결과 분석, Flutter 운영 클라이언트, 페이퍼 트레이딩, 미국장 확장, 실거래 경계까지 단계적으로 확장한다. Go 서비스는 뒤집지 않는 운영 코어를 담당하고, Flutter client는 web/mobile/desktop 단일 UI 표면을 담당하며, proto-socket과 ALT protobuf contracts가 런타임 사이의 통신 기준이 된다.

Phase 흐름

  • 기반 정렬: agent-first monorepo, Go workspace, contracts, proto-socket session loop, PostgreSQL/Redis worker backbone을 안정화한다.
  • 데이터 기반: 한국장 일봉을 대상으로 provider-neutral market data import, normalization, persistence를 만든다.
  • 백테스트 루프: 일봉 기반 strategy execution, backtest lifecycle, result persistence, repeatable verification을 만든다.
  • 운영 표면: Flutter client에서 백테스트와 market data 상태를 조회하고 실행할 수 있는 operator console을 만든다.
  • 거래 확장: paper trading, 미국장 확장, 주문/리스크/포트폴리오, 실거래 adapter 경계를 MVP 이후 단계로 연다.

Milestone 목록

기반 정렬

  • Workspace Baseline - 상태: 완료; 목표: agent-ops와 scaffold가 있는 AI-first monorepo 기준선을 마련한다.
  • Contract and Codegen Baseline - 상태: 계획; 목표: ALT application protobuf 계약과 Go/Dart 생성 흐름을 반복 가능하게 만든다.
  • Socket Session Loop - 상태: 계획; 목표: proto-socket 기반 API와 Flutter client 사이의 최소 handshake/request-response loop를 닫는다.
  • Persistence and Worker Backbone - 상태: 계획; 목표: PostgreSQL/Redis 기반의 durable storage와 비동기 worker 실행 기준을 마련한다.

데이터 기반

  • Korea Daily Data Foundation - 상태: 계획; 목표: 한국장 일봉 데이터를 provider-neutral 모델로 수집, 정규화, 저장하는 첫 파이프라인을 만든다.

백테스트 루프

  • Backtest Engine Baseline - 상태: 계획; 목표: 일봉 데이터를 기준으로 재현 가능한 backtest execution loop와 결과 저장을 만든다.
  • Backtest Analysis Surface - 상태: 계획; 목표: backtest 결과를 operator가 비교하고 해석할 수 있는 기본 분석 표면을 만든다.

운영 표면

  • Flutter Operator Console - 상태: 계획; 목표: Flutter client에서 market data, backtest run, result를 조회하고 실행 요청할 수 있는 운영 화면을 만든다.

거래 확장

  • Paper Trading Readiness - 상태: 계획; 목표: 실거래 전에 전략 실행, 가상 주문, 포지션, 리스크 흐름을 paper trading 경계로 검증한다.
  • US Market Expansion - 상태: 계획; 목표: 한국장 MVP 구조 위에 미국장 데이터를 추가한다.
  • Live Trading Boundary - 상태: 보류; 목표: 실거래 adapter, 주문, 리스크, 포트폴리오 경계를 paper trading 안정화 이후에 연다.

아카이브 Milestone 요약

  • 없음

로딩 정책

  • 일반 작업에서는 agent-ops/roadmap/ROADMAP.md를 매번 읽지 않는다.
  • 기능 추가, 구조 변경, 스킬 추가/수정, 문서 구조 변경 작업을 수행할 때는 agent-ops/roadmap/current.md를 먼저 읽는다.
  • current.md는 현재 작업 위치가 아니라 활성 Milestone 후보 목록이다.
  • current.md에는 개인별 현재 작업 위치나 완료 상태를 기록하지 않는다.
  • current.md의 활성 Milestone은 agent-ops/roadmap/milestones/ 하위 문서만 가리키며, agent-ops/roadmap/archive/**는 포함하지 않는다.
  • 요청 내용, 현재 브랜치, 변경 파일, 관련 코드 경로를 보고 가장 관련 있는 활성 Milestone 문서를 같은 세션에서 1회 읽는다.
  • 활성 Milestone 밖의 작업이면 이 문서의 Milestone 목록을 확인하고 사용자에게 진행 또는 전환 여부를 확인한다.
  • 이 문서는 로드맵 생성/갱신, Phase 전환, Milestone 추가/수정 요청이 있을 때만 읽는다.
  • 상세 작업과 완료 기준은 각 Milestone 문서의 체크리스트로 관리한다.
  • 완료 또는 폐기되어 아카이브된 Milestone은 이 문서의 아카이브 Milestone 요약에 당시 요약만 남기고, 아카이브 문서 링크나 상세 경로는 남기지 않는다.
  • 상세 문서가 있는 agent-ops/roadmap/archive/**는 사용자가 명시적으로 요청한 경우에만 읽는다.
  • 아카이브된 Milestone 문서는 최신 템플릿이나 스킬 규약에 맞춰 재포맷하지 않는다.
  • 선택된 Milestone의 구현 잠금 섹션이 없거나 상태가 잠금이면 코드 구현, agent-task 구현 계획 생성, 세부 API/파일 구조 확정을 시작하기 전에 현재 요청에 직접 영향을 주는 결정 필요 항목만 확인한다.
  • 현재 요청과 직접 관련 없는 미정 항목은 잠금 상태로 남겨도 되며, 기존 구조/도메인 rule/플랫폼 관례로 정할 수 있는 작업은 표준선으로 기록하고 진행할 수 있다.
  • Milestone 전체에서 사용자만 결정할 항목이 더 이상 없고 에이전트가 표준선에 따라 실행하면 되는 상태라면 구현 잠금 상태를 해제로 둔다.