refactor: roadmap structure reorganization - archive old milestones, create phase-based structure

agent-ops/roadmap/ROADMAP.md

@@ -6,58 +6,45 @@ ALT는 개인용 quant system workspace로, 한국장 일봉 MVP에서 시작해
 
 ## 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 이후 단계로 연다.
+위에서 아래로 진행된 순서와 예정 흐름을 나타낸다.
+완료된 Phase도 로드맵에서 제거하지 않고, archive의 Phase 문서로 연결한다.
+검토중 또는 진행중 Phase는 계획 Phase보다 위에 두어, 아래로 갈수록 미래 계획에 가까워지게 정렬한다.
 
-## Milestone 목록
-
-### 기반 정렬
-
-- [Workspace Baseline](milestones/workspace-baseline.md) - 상태: 완료; 목표: agent-ops와 scaffold가 있는 AI-first monorepo 기준선을 마련한다.
-- [Contract and Codegen Baseline](milestones/contract-codegen-baseline.md) - 상태: 계획; 목표: ALT application protobuf 계약과 Go/Dart 생성 흐름을 반복 가능하게 만든다.
-- [Socket Session Loop](milestones/socket-session-loop.md) - 상태: 계획; 목표: proto-socket 기반 API와 Flutter client 사이의 최소 handshake/request-response loop를 닫는다.
-- [Persistence and Worker Backbone](milestones/persistence-worker-backbone.md) - 상태: 계획; 목표: PostgreSQL/Redis 기반의 durable storage와 비동기 worker 실행 기준을 마련한다.
-
-### 데이터 기반
-
-- [Korea Daily Data Foundation](milestones/korea-daily-data-foundation.md) - 상태: 계획; 목표: 한국장 일봉 데이터를 provider-neutral 모델로 수집, 정규화, 저장하는 첫 파이프라인을 만든다.
-
-### 백테스트 루프
-
-- [Backtest Engine Baseline](milestones/backtest-engine-baseline.md) - 상태: 계획; 목표: 일봉 데이터를 기준으로 재현 가능한 backtest execution loop와 결과 저장을 만든다.
-- [Backtest Analysis Surface](milestones/backtest-analysis-surface.md) - 상태: 계획; 목표: backtest 결과를 operator가 비교하고 해석할 수 있는 기본 분석 표면을 만든다.
-
-### 운영 표면
-
-- [Flutter Operator Console](milestones/flutter-operator-console.md) - 상태: 계획; 목표: Flutter client에서 market data, backtest run, result를 조회하고 실행 요청할 수 있는 운영 화면을 만든다.
-
-### 거래 확장
-
-- [Paper Trading Readiness](milestones/paper-trading-readiness.md) - 상태: 계획; 목표: 실거래 전에 전략 실행, 가상 주문, 포지션, 리스크 흐름을 paper trading 경계로 검증한다.
-- [US Market Expansion](milestones/us-market-expansion.md) - 상태: 계획; 목표: 한국장 MVP 구조 위에 미국장 데이터를 추가한다.
-- [Live Trading Boundary](milestones/live-trading-boundary.md) - 상태: 보류; 목표: 실거래 adapter, 주문, 리스크, 포트폴리오 경계를 paper trading 안정화 이후에 연다.
-
-## 아카이브 Milestone 요약
-
-- 없음
+- [진행중] 기반 정렬
+  - 경로: `agent-ops/roadmap/phase/foundation-alignment/PHASE.md`
+  - 요약: agent-first monorepo, Go workspace, contracts, proto-socket session loop, PostgreSQL/Redis worker backbone을 안정화한다.
+- [계획] 데이터 기반
+  - 경로: `agent-ops/roadmap/phase/data-foundation/PHASE.md`
+  - 요약: 한국장 일봉을 대상으로 provider-neutral market data import, normalization, persistence를 만든다.
+- [계획] 백테스트 루프
+  - 경로: `agent-ops/roadmap/phase/backtest-loop/PHASE.md`
+  - 요약: 일봉 기반 strategy execution, backtest lifecycle, result persistence, repeatable verification을 만든다.
+- [계획] 운영 표면
+  - 경로: `agent-ops/roadmap/phase/operator-surface/PHASE.md`
+  - 요약: Flutter client에서 백테스트와 market data 상태를 조회하고 실행할 수 있는 operator console을 만든다.
+- [계획] 거래 확장
+  - 경로: `agent-ops/roadmap/phase/trading-expansion/PHASE.md`
+  - 요약: paper trading, 미국장 확장, 주문/리스크/포트폴리오, 실거래 adapter 경계를 MVP 이후 단계로 연다.
 
 ## 로딩 정책
 
 - 일반 작업에서는 `agent-ops/roadmap/ROADMAP.md`를 매번 읽지 않는다.
 - 기능 추가, 구조 변경, 스킬 추가/수정, 문서 구조 변경 작업을 수행할 때는 `agent-ops/roadmap/current.md`를 먼저 읽는다.
-- `current.md`는 현재 작업 위치가 아니라 활성 Milestone 후보 목록이다.
+- `current.md`는 현재 작업 위치가 아니라 활성 Phase와 활성 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 문서는 최신 템플릿이나 스킬 규약에 맞춰 재포맷하지 않는다.
+- `current.md`의 활성 Phase는 `agent-ops/roadmap/phase/<phase-slug>/PHASE.md`를 가리킨다.
+- `current.md`의 활성 Milestone은 `agent-ops/roadmap/phase/<phase-slug>/milestones/<milestone-slug>.md`를 가리킨다.
+- `current.md`는 `agent-ops/roadmap/archive/**` 경로를 활성 항목으로 포함하지 않는다.
+- 요청 내용, 현재 브랜치, 변경 파일, 관련 코드 경로를 보고 가장 관련 있는 활성 Phase와 Milestone 문서를 같은 세션에서 1회 읽는다.
+- 활성 Phase 또는 Milestone 밖의 작업이면 이 문서의 Phase 흐름을 확인하고 사용자에게 진행 또는 전환 여부를 확인한다.
+- 이 문서는 로드맵 생성/갱신, Phase 전환, Phase 추가/수정, 전체 구조 변경 요청이 있을 때만 읽는다.
+- 상세 작업과 완료 기준은 각 Milestone 문서의 `필수 기능`, `완료 기준`으로 관리한다.
+- 모든 필수 작업과 완료 기준이 충족된 Milestone은 먼저 `[검토중]`으로 두고, 사용자 완료 확인과 archive 승인을 받은 뒤 `[완료]`로 전환한다.
+- 완료된 Phase는 `agent-ops/roadmap/archive/phase/<phase-slug>/PHASE.md`로 이동하고, 하위 Milestone도 같은 archive Phase scaffold 아래에 둔다.
+- 진행중 Phase 안에서 완료된 Milestone은 활성 Phase 문서에 짧은 링크를 남기고, 상세 문서는 `agent-ops/roadmap/archive/phase/<phase-slug>/milestones/`로 이동한다.
+- archive `PHASE.md`는 Phase 자체가 완료 또는 폐기될 때만 만들며, 진행중 Phase의 완료 Milestone만 archive된 경우 archive Phase 디렉터리에 `milestones/`만 있을 수 있다.
+- `agent-ops/roadmap/archive/**`는 일반 작업에서 읽지 않는다. 과거 완료 내용, 완료 근거, 복원, 비교가 필요한 경우에만 `ROADMAP.md` 또는 `PHASE.md`의 archive 링크를 따라가서 읽는다.
+- 아카이브된 Phase/Milestone 문서는 최신 템플릿이나 스킬 규약에 맞춰 재포맷하지 않는다.
 - 선택된 Milestone의 `구현 잠금` 섹션이 없거나 상태가 `잠금`이면 코드 구현, `agent-task` 구현 계획 생성, 세부 API/파일 구조 확정을 시작하기 전에 현재 요청에 직접 영향을 주는 `결정 필요` 항목만 확인한다.
 - 현재 요청과 직접 관련 없는 미정 항목은 잠금 상태로 남겨도 되며, 기존 구조/도메인 rule/플랫폼 관례로 정할 수 있는 작업은 표준선으로 기록하고 진행할 수 있다.
 - Milestone 전체에서 사용자만 결정할 항목이 더 이상 없고 에이전트가 표준선에 따라 실행하면 되는 상태라면 `구현 잠금` 상태를 `해제`로 둔다.

agent-ops/roadmap/current.md

@@ -1,16 +1,32 @@
 # 현재 로드맵 컨텍스트
 
+## 활성 Phase
+
+- [진행중] 기반 정렬
+  - 경로: `agent-ops/roadmap/phase/foundation-alignment/PHASE.md`
+
 ## 활성 Milestone
 
-- Contract and Codegen Baseline: agent-ops/roadmap/milestones/contract-codegen-baseline.md
-- Socket Session Loop: agent-ops/roadmap/milestones/socket-session-loop.md
-- Persistence and Worker Backbone: agent-ops/roadmap/milestones/persistence-worker-backbone.md
+- [계획] Contract and Codegen Baseline
+  - Phase: `agent-ops/roadmap/phase/foundation-alignment/PHASE.md`
+  - 경로: `agent-ops/roadmap/phase/foundation-alignment/milestones/contract-codegen-baseline.md`
+- [계획] Socket Session Loop
+  - Phase: `agent-ops/roadmap/phase/foundation-alignment/PHASE.md`
+  - 경로: `agent-ops/roadmap/phase/foundation-alignment/milestones/socket-session-loop.md`
+- [계획] Persistence and Worker Backbone
+  - Phase: `agent-ops/roadmap/phase/foundation-alignment/PHASE.md`
+  - 경로: `agent-ops/roadmap/phase/foundation-alignment/milestones/persistence-worker-backbone.md`
 
 ## 선택 규칙
 
-- 이 문서는 활성 Milestone 후보 목록이며, 개인별 현재 작업 위치나 완료 상태를 기록하지 않는다.
-- 활성 Milestone은 `agent-ops/roadmap/milestones/` 하위 문서만 가리키며, `agent-ops/roadmap/archive/**`는 포함하지 않는다.
-- 요청 내용, 현재 브랜치, 변경 파일, 관련 코드 경로를 보고 가장 관련 있는 Milestone을 선택하고 같은 세션에서 1회 읽는다.
-- 활성 Milestone 둘 이상에 걸치면 필요한 Milestone 문서를 모두 읽고 작업 범위를 좁힌다.
-- 활성 Milestone 밖의 작업이면 `agent-ops/roadmap/ROADMAP.md`의 Milestone 목록을 확인하고 사용자에게 진행 또는 전환 여부를 확인한다.
+- 이 문서는 활성 Phase와 활성 Milestone 후보 목록이며, 개인별 현재 작업 위치나 완료 상태를 기록하지 않는다.
+- 활성 Phase는 `agent-ops/roadmap/phase/<phase-slug>/PHASE.md`를 가리킨다.
+- 활성 Milestone은 `agent-ops/roadmap/phase/<phase-slug>/milestones/<milestone-slug>.md`를 가리킨다.
+- 활성 항목은 아카이브 경로를 포함하지 않는다.
+- `[검토중]` 항목은 사용자 완료 확인 전까지 활성 항목으로 남길 수 있다.
+- `[완료]` 또는 `[폐기]` 항목은 archive 링크를 남긴 뒤 활성 항목에서 제거한다.
+- 요청 내용, 현재 브랜치, 변경 파일, 관련 코드 경로를 보고 가장 관련 있는 Phase와 Milestone을 선택하고 같은 세션에서 1회 읽는다.
+- 활성 Phase 또는 Milestone 둘 이상에 걸치면 필요한 문서를 모두 읽고 작업 범위를 좁힌다.
+- 활성 범위 밖의 작업이면 `agent-ops/roadmap/ROADMAP.md`의 Phase 흐름을 확인하고 사용자에게 진행 또는 전환 여부를 확인한다.
+- 완료된 과거 내용이 필요할 때만 `ROADMAP.md` 또는 `PHASE.md`에 있는 archive 링크를 따라가서 읽는다.
 - 선택된 Milestone의 `구현 잠금` 섹션이 없거나 상태가 `잠금`이면 구현이나 구현 계획을 시작하기 전에 현재 요청에 직접 영향을 주는 `결정 필요` 항목만 확인한다. 관련 결정이 없고 표준선으로 처리 가능하면 잠금을 유지한 채 진행할 수 있으며, Milestone 전체에서 사용자만 결정할 항목이 더 이상 없을 때만 `구현 잠금` 상태를 `해제`로 둔다.

agent-ops/roadmap/phase/backtest-loop/PHASE.md

@@ -0,0 +1,27 @@
+# Phase: 백테스트 루프
+
+## 상태
+
+[계획]
+
+## 목표
+
+정규화된 일봉 데이터를 기준으로 strategy execution, run lifecycle, result persistence, 기본 분석 표면을 만든다. ALT 확장의 중심축이 되는 반복 가능한 백테스트 루프를 안정화한다.
+
+## Milestone 흐름
+
+완료된 Milestone은 archive 경로를 가리키고, 검토중, 진행중, 계획 또는 보류 Milestone은 이 Phase 하위 `milestones/` 경로를 가리킨다.
+완료, 검토중, 진행중, 계획 순서로 두어 아래로 갈수록 미래 작업에 가까워지게 정렬한다.
+
+- [계획] Backtest Engine Baseline
+  - 경로: `agent-ops/roadmap/phase/backtest-loop/milestones/backtest-engine-baseline.md`
+  - 요약: 일봉 데이터를 기준으로 재현 가능한 backtest execution loop와 결과 저장을 만든다.
+- [계획] Backtest Analysis Surface
+  - 경로: `agent-ops/roadmap/phase/backtest-loop/milestones/backtest-analysis-surface.md`
+  - 요약: backtest 결과를 operator가 비교하고 해석할 수 있는 기본 분석 표면을 만든다.
+
+## Phase 경계
+
+- 이 Phase는 deterministic backtest와 기본 result analysis에 집중한다.
+- paper/live order routing, 실시간 전략 실행, 고급 리스크 모델 전체는 거래 확장 Phase에서 다룬다.
+- worker가 backtest 실행을 소유하고 API는 실행 요청과 조회 경계를 담당한다.

agent-ops/roadmap/phase/backtest-loop/milestones/backtest-analysis-surface.md

@@ -1,16 +1,17 @@
-# Backtest Analysis Surface
+# Milestone: Backtest Analysis Surface
+
+## 위치
+
+- Roadmap: `agent-ops/roadmap/ROADMAP.md`
+- Phase: `agent-ops/roadmap/phase/backtest-loop/PHASE.md`
 
 ## 목표
 
 backtest 결과를 단순 성공/실패가 아니라 operator가 비교하고 해석할 수 있는 기본 분석 표면으로 확장한다. MVP에서는 핵심 summary와 run comparison을 우선한다.
 
-## 단계
-
-백테스트 루프
-
 ## 상태
 
-계획
+[계획]
 
 ## 구현 잠금
 
@@ -27,6 +28,10 @@ backtest 결과를 단순 성공/실패가 아니라 operator가 비교하고
 
 ## 필수 기능
 
+### Epic: [analysis-surface] Backtest result analysis
+
+operator가 backtest 결과를 조회, 비교, 해석할 수 있는 최소 분석 표면을 묶는다.
+
 - [ ] [summary-metrics] ending equity 외 최소 summary metrics가 있다.
 - [ ] [equity-curve] run별 equity curve 또는 동등한 time-series result를 저장/조회한다.
 - [ ] [run-list] backtest run 목록과 상태를 조회할 수 있다.
@@ -40,6 +45,16 @@ backtest 결과를 단순 성공/실패가 아니라 operator가 비교하고
 - [ ] fixture 기반 result 조회 테스트가 통과한다.
 - [ ] `bin/test`와 `bin/lint`가 통과한다.
 
+## 완료 리뷰
+
+- 상태: 없음
+- 요청일: 없음
+- 완료 근거: 아직 필수 기능과 완료 기준이 충족되지 않았다.
+- 리뷰 필요:
+  - [ ] 사용자가 완료 결과를 확인했다
+  - [ ] archive 이동을 승인했다
+- 리뷰 코멘트: 없음
+
 ## 범위 제외
 
 - 전문 리포트 생성

agent-ops/roadmap/phase/backtest-loop/milestones/backtest-engine-baseline.md

@@ -1,16 +1,17 @@
-# Backtest Engine Baseline
+# Milestone: Backtest Engine Baseline
+
+## 위치
+
+- Roadmap: `agent-ops/roadmap/ROADMAP.md`
+- Phase: `agent-ops/roadmap/phase/backtest-loop/PHASE.md`
 
 ## 목표
 
 정규화된 일봉 데이터를 사용해 전략 실행, portfolio state, result summary가 재현 가능한 backtest loop를 만든다. 이 milestone은 백테스트 기반을 ALT 확장의 중심축으로 고정한다.
 
-## 단계
-
-백테스트 루프
-
 ## 상태
 
-계획
+[계획]
 
 ## 구현 잠금
 
@@ -27,6 +28,10 @@
 
 ## 필수 기능
 
+### Epic: [backtest-engine] Deterministic backtest engine
+
+일봉 기반 전략 실행, portfolio state, result 저장과 fixture 검증 흐름을 묶는다.
+
 - [ ] [run-lifecycle] backtest run의 pending/running/succeeded/failed/canceled lifecycle이 있다.
 - [ ] [strategy-port] strategy를 engine에 주입할 port 또는 interface가 있다.
 - [ ] [portfolio-state] cash, position, equity를 계산하는 최소 portfolio state가 있다.
@@ -40,6 +45,16 @@
 - [ ] 결과가 contracts/client에서 조회 가능한 형태로 연결될 수 있다.
 - [ ] `bin/test`와 `bin/lint`가 통과한다.
 
+## 완료 리뷰
+
+- 상태: 없음
+- 요청일: 없음
+- 완료 근거: 아직 필수 기능과 완료 기준이 충족되지 않았다.
+- 리뷰 필요:
+  - [ ] 사용자가 완료 결과를 확인했다
+  - [ ] archive 이동을 승인했다
+- 리뷰 코멘트: 없음
+
 ## 범위 제외
 
 - 실시간 전략 실행

agent-ops/roadmap/phase/data-foundation/PHASE.md

@@ -0,0 +1,24 @@
+# Phase: 데이터 기반
+
+## 상태
+
+[계획]
+
+## 목표
+
+한국장 일봉 MVP를 대상으로 provider-neutral market data import, normalization, persistence 흐름을 만든다. 시장별 확장 가능성을 남기되 첫 검증 단위는 KRX/Korea daily bar에 집중한다.
+
+## Milestone 흐름
+
+완료된 Milestone은 archive 경로를 가리키고, 검토중, 진행중, 계획 또는 보류 Milestone은 이 Phase 하위 `milestones/` 경로를 가리킨다.
+완료, 검토중, 진행중, 계획 순서로 두어 아래로 갈수록 미래 작업에 가까워지게 정렬한다.
+
+- [계획] Korea Daily Data Foundation
+  - 경로: `agent-ops/roadmap/phase/data-foundation/milestones/korea-daily-data-foundation.md`
+  - 요약: 한국장 일봉 데이터를 provider-neutral 모델로 수집, 정규화, 저장하는 첫 파이프라인을 만든다.
+
+## Phase 경계
+
+- 이 Phase는 한국장 일봉 데이터 수집, 정규화, 저장, 조회 가능성까지만 다룬다.
+- 미국장, 분봉/틱/실시간 streaming, 실거래 주문 API, 고급 corporate action adjustment는 제외한다.
+- normalized data는 백테스트 Phase가 소비할 수 있는 형태를 기준으로 한다.

agent-ops/roadmap/phase/data-foundation/milestones/korea-daily-data-foundation.md

@@ -1,16 +1,17 @@
-# Korea Daily Data Foundation
+# Milestone: Korea Daily Data Foundation
+
+## 위치
+
+- Roadmap: `agent-ops/roadmap/ROADMAP.md`
+- Phase: `agent-ops/roadmap/phase/data-foundation/PHASE.md`
 
 ## 목표
 
 한국장 일봉 데이터를 첫 MVP market data로 삼아 provider-neutral import, normalization, persistence 파이프라인을 만든다. 한투/KIS는 초기 provider 후보로 보되, domain model은 한국장에만 종속되지 않게 유지한다.
 
-## 단계
-
-데이터 기반
-
 ## 상태
 
-계획
+[계획]
 
 ## 구현 잠금
 
@@ -30,6 +31,10 @@
 
 ## 필수 기능
 
+### Epic: [market-data] Korea daily market data
+
+한국장 일봉 데이터의 provider-neutral 수집, 정규화, 저장, 검증 흐름을 묶는다.
+
 - [ ] [instrument-map] provider symbol과 ALT instrument identity를 매핑한다.
 - [ ] [daily-bars] 한국장 일봉 OHLCV를 normalized bar 모델로 저장한다.
 - [ ] [calendar-rules] `Asia/Seoul`, KRX, KRW 기준의 최소 calendar/currency 처리를 갖는다.
@@ -44,6 +49,16 @@
 - [ ] normalized data가 backtest milestone에서 소비 가능한 형태로 조회된다.
 - [ ] `bin/test`와 관련 worker 검증이 통과한다.
 
+## 완료 리뷰
+
+- 상태: 없음
+- 요청일: 없음
+- 완료 근거: 아직 필수 기능과 완료 기준이 충족되지 않았다.
+- 리뷰 필요:
+  - [ ] 사용자가 완료 결과를 확인했다
+  - [ ] archive 이동을 승인했다
+- 리뷰 코멘트: 없음
+
 ## 범위 제외
 
 - 미국장 데이터 수집

agent-ops/roadmap/phase/foundation-alignment/PHASE.md

@@ -0,0 +1,33 @@
+# Phase: 기반 정렬
+
+## 상태
+
+[진행중]
+
+## 목표
+
+ALT가 agent-first monorepo 기준선 위에서 계약, proto-socket session loop, durable worker backbone을 안정적으로 쌓을 수 있게 한다. 이 Phase는 런타임 경계와 반복 가능한 검증 흐름을 먼저 고정해 이후 market data, backtest, client 작업이 뒤집히지 않도록 한다.
+
+## Milestone 흐름
+
+완료된 Milestone은 archive 경로를 가리키고, 검토중, 진행중, 계획 또는 보류 Milestone은 이 Phase 하위 `milestones/` 경로를 가리킨다.
+완료, 검토중, 진행중, 계획 순서로 두어 아래로 갈수록 미래 작업에 가까워지게 정렬한다.
+
+- [완료] Workspace Baseline
+  - 경로: `agent-ops/roadmap/archive/phase/foundation-alignment/milestones/workspace-baseline.md`
+  - 요약: agent-ops와 scaffold가 있는 AI-first monorepo 기준선을 마련했다.
+- [계획] Contract and Codegen Baseline
+  - 경로: `agent-ops/roadmap/phase/foundation-alignment/milestones/contract-codegen-baseline.md`
+  - 요약: ALT application protobuf 계약과 Go/Dart 생성 흐름을 반복 가능하게 만든다.
+- [계획] Socket Session Loop
+  - 경로: `agent-ops/roadmap/phase/foundation-alignment/milestones/socket-session-loop.md`
+  - 요약: proto-socket 기반 API와 Flutter client 사이의 최소 handshake/request-response loop를 닫는다.
+- [계획] Persistence and Worker Backbone
+  - 경로: `agent-ops/roadmap/phase/foundation-alignment/milestones/persistence-worker-backbone.md`
+  - 요약: PostgreSQL/Redis 기반의 durable storage와 비동기 worker 실행 기준을 마련한다.
+
+## Phase 경계
+
+- 이 Phase는 monorepo 운영 기준, contracts/codegen, socket session boundary, storage/worker backbone까지만 다룬다.
+- 실제 market data import, backtest engine, operator 화면 완성, paper/live trading 구현은 후속 Phase에서 다룬다.
+- API는 socket/session boundary를 맡고 worker execution을 직접 소유하지 않는다.

agent-ops/roadmap/phase/foundation-alignment/milestones/contract-codegen-baseline.md

@@ -1,16 +1,17 @@
-# Contract and Codegen Baseline
+# Milestone: Contract and Codegen Baseline
+
+## 위치
+
+- Roadmap: `agent-ops/roadmap/ROADMAP.md`
+- Phase: `agent-ops/roadmap/phase/foundation-alignment/PHASE.md`
 
 ## 목표
 
 proto-socket을 transport로 유지하면서 ALT application protobuf 계약을 Go API/worker와 Flutter client가 반복 가능하게 소비할 수 있는 기준을 만든다. 계약은 `alt.v1`을 유지하고, generated output은 source schema에서만 생성한다.
 
-## 단계
-
-기반 정렬
-
 ## 상태
 
-계획
+[계획]
 
 ## 구현 잠금
 
@@ -27,6 +28,10 @@ proto-socket을 transport로 유지하면서 ALT application protobuf 계약을
 
 ## 필수 기능
 
+### Epic: [contracts] Contract schema and codegen
+
+ALT application protobuf 계약과 generated output 검증 흐름을 묶는다.
+
 - [ ] [schema-baseline] `common.proto`, `market.proto`, `backtest.proto`가 MVP payload 기준을 담는다.
 - [ ] [go-codegen] Go generated contract를 반복 생성할 수 있는 명령이 있다.
 - [ ] [dart-codegen] Flutter client가 사용할 Dart generated contract를 반복 생성할 수 있는 명령이 있다.
@@ -41,6 +46,16 @@ proto-socket을 transport로 유지하면서 ALT application protobuf 계약을
 - [ ] proto-socket transport proto와 ALT application proto의 책임이 문서에서 분리되어 있다.
 - [ ] `bin/test`와 `bin/lint`가 contract 변경 후 통과한다.
 
+## 완료 리뷰
+
+- 상태: 없음
+- 요청일: 없음
+- 완료 근거: 아직 필수 기능과 완료 기준이 충족되지 않았다.
+- 리뷰 필요:
+  - [ ] 사용자가 완료 결과를 확인했다
+  - [ ] archive 이동을 승인했다
+- 리뷰 코멘트: 없음
+
 ## 범위 제외
 
 - 실제 KIS 데이터 수집 구현

agent-ops/roadmap/phase/foundation-alignment/milestones/persistence-worker-backbone.md

@@ -1,16 +1,17 @@
-# Persistence and Worker Backbone
+# Milestone: Persistence and Worker Backbone
+
+## 위치
+
+- Roadmap: `agent-ops/roadmap/ROADMAP.md`
+- Phase: `agent-ops/roadmap/phase/foundation-alignment/PHASE.md`
 
 ## 목표
 
 PostgreSQL과 Redis를 ALT의 운영 기본 인프라로 고정하고, worker가 import, normalization, backtest 같은 비동기 작업을 다룰 수 있는 durable backbone을 만든다.
 
-## 단계
-
-기반 정렬
-
 ## 상태
 
-계획
+[계획]
 
 ## 구현 잠금
 
@@ -27,6 +28,10 @@ PostgreSQL과 Redis를 ALT의 운영 기본 인프라로 고정하고, worker가
 
 ## 필수 기능
 
+### Epic: [worker-backbone] Persistence and worker backbone
+
+PostgreSQL, Redis, worker job model, storage boundary 기준을 묶는다.
+
 - [ ] [db-migrations] PostgreSQL migration entrypoint가 있다.
 - [ ] [typed-queries] DB query를 type-safe하게 다루는 생성/검증 흐름이 있다.
 - [ ] [redis-boundary] Redis 사용 목적과 key prefix 기준이 worker 문서나 config에 정리되어 있다.
@@ -41,6 +46,16 @@ PostgreSQL과 Redis를 ALT의 운영 기본 인프라로 고정하고, worker가
 - [ ] worker job이 API 내부 구현에 의존하지 않는다.
 - [ ] `bin/test`, `bin/lint`, `bin/build`가 통과한다.
 
+## 완료 리뷰
+
+- 상태: 없음
+- 요청일: 없음
+- 완료 근거: 아직 필수 기능과 완료 기준이 충족되지 않았다.
+- 리뷰 필요:
+  - [ ] 사용자가 완료 결과를 확인했다
+  - [ ] archive 이동을 승인했다
+- 리뷰 코멘트: 없음
+
 ## 범위 제외
 
 - 실제 KIS API 호출

agent-ops/roadmap/phase/foundation-alignment/milestones/socket-session-loop.md

@@ -1,16 +1,17 @@
-# Socket Session Loop
+# Milestone: Socket Session Loop
+
+## 위치
+
+- Roadmap: `agent-ops/roadmap/ROADMAP.md`
+- Phase: `agent-ops/roadmap/phase/foundation-alignment/PHASE.md`
 
 ## 목표
 
 Go API와 Flutter client 사이에 proto-socket 기반 최소 session loop를 만든다. 첫 loop는 handshake, request-response, disconnect/heartbeat 동작을 확인하는 데 집중하고, 무거운 데이터/백테스트 실행은 worker milestone로 넘긴다.
 
-## 단계
-
-기반 정렬
-
 ## 상태
 
-계획
+[계획]
 
 ## 구현 잠금
 
@@ -27,6 +28,10 @@ Go API와 Flutter client 사이에 proto-socket 기반 최소 session loop를
 
 ## 필수 기능
 
+### Epic: [session-loop] Proto-socket session loop
+
+API와 Flutter client 사이의 최소 연결, 요청, 연결 상태 표현을 묶는다.
+
 - [ ] [api-handshake] API가 ALT Hello request를 받고 Hello response를 반환한다.
 - [ ] [client-connect] Flutter client가 configured socket endpoint에 연결할 client layer를 갖는다.
 - [ ] [request-loop] 최소 request-response 메시지가 API와 client 사이에서 왕복한다.
@@ -40,6 +45,16 @@ Go API와 Flutter client 사이에 proto-socket 기반 최소 session loop를
 - [ ] API가 long-running worker 작업을 직접 실행하지 않는다.
 - [ ] `bin/test`와 `bin/lint`가 통과한다.
 
+## 완료 리뷰
+
+- 상태: 없음
+- 요청일: 없음
+- 완료 근거: 아직 필수 기능과 완료 기준이 충족되지 않았다.
+- 리뷰 필요:
+  - [ ] 사용자가 완료 결과를 확인했다
+  - [ ] archive 이동을 승인했다
+- 리뷰 코멘트: 없음
+
 ## 범위 제외
 
 - market data import

agent-ops/roadmap/phase/operator-surface/PHASE.md

@@ -0,0 +1,24 @@
+# Phase: 운영 표면
+
+## 상태
+
+[계획]
+
+## 목표
+
+Flutter client를 ALT의 공식 operator surface로 삼아 market data 상태와 backtest 실행 및 결과를 조회할 수 있게 한다. web/mobile/desktop 단일 UI 표면을 유지하면서 API와 generated contract 기준을 맞춘다.
+
+## Milestone 흐름
+
+완료된 Milestone은 archive 경로를 가리키고, 검토중, 진행중, 계획 또는 보류 Milestone은 이 Phase 하위 `milestones/` 경로를 가리킨다.
+완료, 검토중, 진행중, 계획 순서로 두어 아래로 갈수록 미래 작업에 가까워지게 정렬한다.
+
+- [계획] Flutter Operator Console
+  - 경로: `agent-ops/roadmap/phase/operator-surface/milestones/flutter-operator-console.md`
+  - 요약: Flutter client에서 market data, backtest run, result를 조회하고 실행 요청할 수 있는 운영 화면을 만든다.
+
+## Phase 경계
+
+- 이 Phase는 Flutter client의 운영 화면과 API/client 통신 표면에 집중한다.
+- 별도 TypeScript web app, 고급 charting 전체, mobile app store 배포 설정은 제외한다.
+- UI는 generated/mapped contracts와 proto-socket client layer를 기준으로 API와 통신한다.

agent-ops/roadmap/phase/operator-surface/milestones/flutter-operator-console.md

@@ -1,16 +1,17 @@
-# Flutter Operator Console
+# Milestone: Flutter Operator Console
+
+## 위치
+
+- Roadmap: `agent-ops/roadmap/ROADMAP.md`
+- Phase: `agent-ops/roadmap/phase/operator-surface/PHASE.md`
 
 ## 목표
 
 Flutter client를 ALT의 공식 UI client로 삼아 market data 상태, backtest run, result를 조회하고 실행 요청할 수 있는 operator console을 만든다. 별도 TypeScript web app은 기본 경로로 두지 않는다.
 
-## 단계
-
-운영 표면
-
 ## 상태
 
-계획
+[계획]
 
 ## 구현 잠금
 
@@ -28,6 +29,10 @@ Flutter client를 ALT의 공식 UI client로 삼아 market data 상태, backtest
 
 ## 필수 기능
 
+### Epic: [operator-console] Flutter operator console
+
+market data와 backtest 상태를 조회하고 실행 요청할 수 있는 Flutter 운영 표면을 묶는다.
+
 - [ ] [connect-state] client가 API socket 연결 상태를 표시한다.
 - [ ] [backtest-list] backtest run 목록을 조회하고 표시한다.
 - [ ] [backtest-detail] backtest run detail과 result를 표시한다.
@@ -42,6 +47,16 @@ Flutter client를 ALT의 공식 UI client로 삼아 market data 상태, backtest
 - [ ] presentation widget에 production endpoint 가정이 hard-code되지 않는다.
 - [ ] `bin/test`, `bin/lint`, `bin/build`가 통과한다.
 
+## 완료 리뷰
+
+- 상태: 없음
+- 요청일: 없음
+- 완료 근거: 아직 필수 기능과 완료 기준이 충족되지 않았다.
+- 리뷰 필요:
+  - [ ] 사용자가 완료 결과를 확인했다
+  - [ ] archive 이동을 승인했다
+- 리뷰 코멘트: 없음
+
 ## 범위 제외
 
 - 별도 TypeScript web app

agent-ops/roadmap/phase/trading-expansion/PHASE.md

@@ -0,0 +1,30 @@
+# Phase: 거래 확장
+
+## 상태
+
+[계획]
+
+## 목표
+
+백테스트와 운영 표면이 안정화된 뒤 paper trading, 미국장 확장, live trading boundary를 단계적으로 연다. 실거래는 서두르지 않고 adapter, order, risk, portfolio 경계를 명확히 한 뒤 다룬다.
+
+## Milestone 흐름
+
+완료된 Milestone은 archive 경로를 가리키고, 검토중, 진행중, 계획 또는 보류 Milestone은 이 Phase 하위 `milestones/` 경로를 가리킨다.
+완료, 검토중, 진행중, 계획 순서로 두어 아래로 갈수록 미래 작업에 가까워지게 정렬한다.
+
+- [계획] Paper Trading Readiness
+  - 경로: `agent-ops/roadmap/phase/trading-expansion/milestones/paper-trading-readiness.md`
+  - 요약: 실거래 전에 전략 실행, 가상 주문, 포지션, 리스크 흐름을 paper trading 경계로 검증한다.
+- [계획] US Market Expansion
+  - 경로: `agent-ops/roadmap/phase/trading-expansion/milestones/us-market-expansion.md`
+  - 요약: 한국장 MVP 구조 위에 미국장 데이터를 추가한다.
+- [보류] Live Trading Boundary
+  - 경로: `agent-ops/roadmap/phase/trading-expansion/milestones/live-trading-boundary.md`
+  - 요약: 실거래 adapter, 주문, 리스크, 포트폴리오 경계를 paper trading 안정화 이후에 연다.
+
+## Phase 경계
+
+- 이 Phase는 MVP 이후 확장으로 다루며, paper trading 안정화 전에는 live trading 구현을 열지 않는다.
+- 실거래 주문 제출, 무인 자동 실거래, 고빈도/초단타 execution은 범위 밖이다.
+- 시장 확장은 provider adapter와 market metadata 확장으로 처리하고 백테스트 코어를 복제하지 않는다.

agent-ops/roadmap/phase/trading-expansion/milestones/live-trading-boundary.md

@@ -1,16 +1,17 @@
-# Live Trading Boundary
+# Milestone: Live Trading Boundary
+
+## 위치
+
+- Roadmap: `agent-ops/roadmap/ROADMAP.md`
+- Phase: `agent-ops/roadmap/phase/trading-expansion/PHASE.md`
 
 ## 목표
 
 실거래 adapter, 주문 관리, 리스크 관리, 포트폴리오 동기화 경계를 paper trading 안정화 이후에 연다. 이 milestone은 실제 주문 제출을 서두르지 않고, broker adapter와 운영 안전장치를 먼저 명확히 하는 데 목적이 있다.
 
-## 단계
-
-거래 확장
-
 ## 상태
 
-보류
+[보류]
 
 ## 구현 잠금
 
@@ -30,6 +31,10 @@
 
 ## 필수 기능
 
+### Epic: [live-boundary] Live trading boundary
+
+실거래 adapter, 주문 lifecycle, risk guard, account sync, audit trail 경계를 묶는다.
+
 - [ ] [broker-port] broker adapter port가 paper/live 공통 경계를 갖는다.
 - [ ] [order-lifecycle] 주문 생성, 제출, 체결, 취소, 실패 lifecycle이 정의된다.
 - [ ] [risk-limits] 실거래 전 최소 risk limit과 kill switch가 있다.
@@ -43,6 +48,16 @@
 - [ ] live adapter 없이도 관련 domain/contract 테스트가 가능하다.
 - [ ] 사용자 결정 항목이 해소되기 전까지 구현 잠금이 유지된다.
 
+## 완료 리뷰
+
+- 상태: 없음
+- 요청일: 없음
+- 완료 근거: 아직 필수 기능과 완료 기준이 충족되지 않았다.
+- 리뷰 필요:
+  - [ ] 사용자가 완료 결과를 확인했다
+  - [ ] archive 이동을 승인했다
+- 리뷰 코멘트: 없음
+
 ## 범위 제외
 
 - MVP 단계 실거래 실행

agent-ops/roadmap/phase/trading-expansion/milestones/paper-trading-readiness.md

@@ -1,16 +1,17 @@
-# Paper Trading Readiness
+# Milestone: Paper Trading Readiness
+
+## 위치
+
+- Roadmap: `agent-ops/roadmap/ROADMAP.md`
+- Phase: `agent-ops/roadmap/phase/trading-expansion/PHASE.md`
 
 ## 목표
 
 실거래 전에 전략 실행, 가상 주문, 포지션, 리스크 흐름을 paper trading 경계에서 검증한다. 백테스트 기반을 실시간 또는 준실시간 실행 흐름으로 확장할 때 뒤집지 않을 adapter 경계를 만든다.
 
-## 단계
-
-거래 확장
-
 ## 상태
 
-계획
+[계획]
 
 ## 구현 잠금
 
@@ -29,6 +30,10 @@
 
 ## 필수 기능
 
+### Epic: [paper-trading] Paper trading readiness
+
+실거래 전 전략 실행, 가상 주문, 포지션, 리스크 검증 흐름을 묶는다.
+
 - [ ] [paper-account] paper account와 portfolio state가 있다.
 - [ ] [virtual-orders] 가상 주문과 체결 모델이 있다.
 - [ ] [risk-guard] 최소 risk guard skeleton이 있다.
@@ -42,6 +47,16 @@
 - [ ] 실거래 adapter가 들어와도 paper flow를 뒤집지 않는 경계가 있다.
 - [ ] 관련 테스트와 `bin/test`가 통과한다.
 
+## 완료 리뷰
+
+- 상태: 없음
+- 요청일: 없음
+- 완료 근거: 아직 필수 기능과 완료 기준이 충족되지 않았다.
+- 리뷰 필요:
+  - [ ] 사용자가 완료 결과를 확인했다
+  - [ ] archive 이동을 승인했다
+- 리뷰 코멘트: 없음
+
 ## 범위 제외
 
 - 실거래 주문 제출

agent-ops/roadmap/phase/trading-expansion/milestones/us-market-expansion.md

@@ -1,16 +1,17 @@
-# US Market Expansion
+# Milestone: US Market Expansion
+
+## 위치
+
+- Roadmap: `agent-ops/roadmap/ROADMAP.md`
+- Phase: `agent-ops/roadmap/phase/trading-expansion/PHASE.md`
 
 ## 목표
 
 한국장 MVP에서 만든 provider-neutral market data와 backtest 구조 위에 미국장 데이터를 추가한다. KIS가 국내/해외를 모두 지원한다는 전제를 활용하되, 시장별 calendar, currency, venue 차이를 domain과 persistence에서 흡수한다.
 
-## 단계
-
-거래 확장
-
 ## 상태
 
-계획
+[계획]
 
 ## 구현 잠금
 
@@ -29,6 +30,10 @@
 
 ## 필수 기능
 
+### Epic: [us-market] US market expansion
+
+미국장 instrument, calendar, daily data, shared query, backtest compatibility 확장을 묶는다.
+
 - [ ] [us-instruments] 미국장 instrument identity와 provider symbol mapping이 있다.
 - [ ] [us-calendar] 미국장 timezone/currency/venue 기준이 있다.
 - [ ] [us-daily-bars] 미국장 일봉 데이터를 normalized bar model로 저장한다.
@@ -41,6 +46,16 @@
 - [ ] market/currency/venue 차이가 domain model과 contracts에 일관되게 반영된다.
 - [ ] `bin/test`와 관련 worker 검증이 통과한다.
 
+## 완료 리뷰
+
+- 상태: 없음
+- 요청일: 없음
+- 완료 근거: 아직 필수 기능과 완료 기준이 충족되지 않았다.
+- 리뷰 필요:
+  - [ ] 사용자가 완료 결과를 확인했다
+  - [ ] archive 이동을 승인했다
+- 리뷰 코멘트: 없음
+
 ## 범위 제외
 
 - 미국장 실거래 주문