feat(agent-task): m-backtest-multi-timeframe-coverage 작업 계획과 코드 리뷰를 추가한다

01_domain_capability_matrix: PLAN-local-G05, CODE_REVIEW-local-G05 02+01_kis_job_capability: PLAN-local-G06, CODE_REVIEW-local-G06
2026-06-17 21:37:12 +09:00 · 2026-06-17 21:37:12 +09:00 · 97373ca14e
commit 97373ca14e
parent 9d8dde6dc9
4 changed files with 743 additions and 0 deletions
--- a/agent-task/m-backtest-multi-timeframe-coverage/01_domain_capability_matrix/CODE_REVIEW-local-G05.md
+++ b/agent-task/m-backtest-multi-timeframe-coverage/01_domain_capability_matrix/CODE_REVIEW-local-G05.md
@ -0,0 +1,138 @@
+<!-- task=m-backtest-multi-timeframe-coverage/01_domain_capability_matrix plan=0 tag=API -->
+
+# Code Review Reference - API
+
+> **[IMPLEMENTING AGENT — READ FIRST] Filling in this file is the mandatory final step of implementation.**
+> The task is NOT complete until every implementation-owned section below is filled in.
+> Complete the `구현 체크리스트`; the final checklist item is mandatory before saving.
+> Fill implementation-owned sections, then stop with active files in place and report ready for review.
+> If implementation is blocked by a selected SDD decision or selected Milestone `구현 잠금 > 결정 필요` item, fill `사용자 리뷰 요청` with linked evidence and stop with active files in place; code-review decides whether to write `USER_REVIEW.md`. Environment/secret/service blockers, generic scope changes, repeated failures, and evidence gaps that a follow-up agent can close are normal follow-up issues, not user-review blockers by themselves.
+> Do not ask the user directly, present choices in chat, or call `request_user_input` during implementation; record only SDD/Milestone lock decisions in `사용자 리뷰 요청` and stop for code-review.
+> Finalization (`코드리뷰 결과`, log rename, `complete.log`, archive moves, `코드리뷰 전용 체크리스트`) is review-agent-only, even after compaction/resume.
+> Follow the ownership table at the bottom of this file for which sections you own.
+
+## 개요
+
+date=2026-06-17
+task=m-backtest-multi-timeframe-coverage/01_domain_capability_matrix, plan=0, tag=API
+
+## 이 파일을 읽는 리뷰 에이전트에게
+
+> **[REVIEW AGENT ONLY]** 아래 종결 절차는 코드리뷰 에이전트 전용이다. 구현 에이전트는 이 섹션을 실행하지 않는다.
+
+각 항목의 구현을 실제 소스 파일과 대조하고, `검증 결과` 섹션의 출력이 코드와 일치하는지 확인하세요.
+리뷰 완료는 아래 순서까지 끝난 상태를 의미합니다.
+
+1. 판정을 append한다.
+2. `CODE_REVIEW-local-G05.md` -> `code_review_local_G05_N.log`, `PLAN-local-G05.md` -> `plan_local_G05_M.log`로 아카이브한다.
+3. PASS이면 `complete.log` 작성 후 active task 디렉터리를 `agent-task/archive/YYYY/MM/m-backtest-multi-timeframe-coverage/01_domain_capability_matrix/`로 이동한다. WARN/FAIL이면 user-review gate를 확인한 뒤 다음 active plan/review 파일 또는 `USER_REVIEW.md`를 작성한다.
+4. PASS이고 task group이 `m-<milestone-slug>`이면 완료 이벤트 메타데이터를 보고한다. roadmap 상태 체크와 `update-roadmap` 호출은 런타임 책임이다.
+5. 적용 가능한 `코드리뷰 전용 체크리스트` 항목을 최종 `.log` 위치에서 체크한 뒤 보고한다.
+
+---
+
+## 구현 항목별 완료 여부
+
+| 항목 | 완료 여부 |
+|------|---------|
+| [API-1] Domain capability matrix API | [ ] |
+| [API-2] Compatibility compile guard | [ ] |
+
+## 구현 체크리스트
+
+- [ ] `ProviderCapability`를 provider/market/venue/asset type/timeframe matrix request와 accepted/rejected decision을 표현하도록 확장하되, 후속 rollout 전 기존 daily call site가 컴파일될 수 있는 호환 wrapper를 유지한다.
+- [ ] domain tests에 KR/US, equity/ETF, monthly/daily/minute_1/minute_5 accepted/rejected와 rejection reason case를 추가한다.
+- [ ] `go test ./packages/domain/...`와 `go test ./services/worker/...`를 실행해 domain behavior와 기존 worker call-site compile을 확인한다.
+- [ ] CODE_REVIEW-*-G??.md의 구현 에이전트 소유 섹션을 실제 구현 내용과 검증 출력으로 채운다. 이 항목이 완료되기 전에는 구현이 완료된 것이 아니다.
+
+## 코드리뷰 전용 체크리스트
+
+> **[REVIEW AGENT ONLY]** 이 체크리스트는 코드리뷰 에이전트만 사용한다.
+> 구현 에이전트는 이 섹션을 수정하거나 체크하지 않는다.
+
+- [ ] `코드리뷰 결과`에 `PASS`, `WARN`, `FAIL` 중 하나의 판정을 append한다.
+- [ ] 판정과 `차원별 평가`, Required/Suggested/Nit 분류가 서로 일치한다.
+- [ ] active `CODE_REVIEW-*-G??.md`를 `code_review_local_G05_N.log`로 아카이브한다.
+- [ ] active `PLAN-*-G??.md`를 `plan_local_G05_M.log`로 아카이브한다.
+- [ ] `.gitignore`의 Agent-Ops 관리 block이 `agent-task/**/*.md`와 `agent-task/**/*.log`를 unignore하고 `agent-roadmap/current.md`를 ignore하는지 확인한다.
+- [ ] PASS이면 `agent-ops/skills/common/code-review/templates/complete-log-template.md` 기준으로 `complete.log`를 작성하고 active `.md` 파일을 남기지 않는다.
+- [ ] PASS이면 active task 디렉터리 `agent-task/m-backtest-multi-timeframe-coverage/01_domain_capability_matrix/`를 `agent-task/archive/YYYY/MM/m-backtest-multi-timeframe-coverage/01_domain_capability_matrix/`로 이동하고 최종 archive 경로에서 이 체크리스트를 갱신한다.
+- [ ] PASS이고 task group이 `m-<milestone-slug>`이면 런타임이 읽을 완료 이벤트 메타데이터를 보고하고, roadmap 수정이나 `update-roadmap` 직접 호출을 하지 않는다.
+- [ ] PASS split 작업이면 이동 후 빈 active parent `agent-task/m-backtest-multi-timeframe-coverage/`를 제거하거나, 남은 sibling/file이 있어 유지했다고 확인한다.
+- [ ] WARN/FAIL이고 user-review gate가 트리거되지 않았으면 다음 active `PLAN-local-G05.md`와 `CODE_REVIEW-local-G05.md`를 작성하고 `complete.log`를 작성하지 않는다.
+- [ ] USER_REVIEW이면 `agent-ops/skills/common/code-review/templates/user-review-template.md` 기준으로 `USER_REVIEW.md`를 작성하고 active `PLAN-*.md`, `CODE_REVIEW-*.md`, `complete.log`를 남기지 않는다.
+- [ ] USER_REVIEW가 연결된 SDD/Milestone 결정으로 완료/PASS 해소되면 `USER_REVIEW.md`를 해소 상태로 갱신하고 `complete.log`를 작성한 뒤 task directory를 archive로 이동한다.
+
+## 계획 대비 변경 사항
+
+_구현 에이전트가 계획과 다르게 구현한 부분을 이유와 함께 기록한다._
+
+## 주요 설계 결정
+
+_구현 에이전트가 주요 설계 결정 사항을 기록한다._
+
+## 사용자 리뷰 요청
+
+_기본값은 `없음`이다. 구현 중 새 결정이 필요해 보여도 직접 질문하거나 선택지를 제시하거나 `request_user_input`을 호출하지 않는다. 이 섹션은 선택된 SDD 결정 또는 선택된 Milestone `구현 잠금 > 결정 필요` 항목이 실구현을 차단할 때만 채운다. 외부 환경/secret/서비스 준비, 검증 증거 공백, 반복 실패, 일반 범위 조정은 사용자 리뷰 요청이 아니며 `검증 결과`, `계획 대비 변경 사항`, 또는 code-review의 일반 follow-up plan으로 처리한다._
+
+- 상태: 없음
+- 사유 유형: 없음
+- 연결 대상: 없음
+- 결정 필요: 없음
+- 차단 근거: 없음
+- 실행한 검증/명령: 없음
+- 자동 후속 불가 이유: 없음
+- 재개 조건: 없음
+
+## 리뷰어를 위한 체크포인트
+
+- `ProviderCapability`가 provider/market/venue/asset type/timeframe 차원을 모두 판정하는지 확인한다.
+- rejected decision reason이 테스트 가능한 stable text인지 확인한다.
+- 기존 `RequireDailyBars` call site가 후속 rollout 전에도 컴파일되는지 확인한다.
+
+## 검증 결과
+
+_구현 에이전트가 각 중간 검증 및 최종 검증 명령 실행 후 출력을 여기에 붙여 넣는다._
+
+필수 규칙:
+- 검증 명령은 고정된 계약이다. 임의로 대체하지 않는다.
+- 대체가 필요하면 `계획 대비 변경 사항`에 이유와 대체 명령을 기록한다.
+- `검증 결과`에는 실제 stdout/stderr를 붙여 넣는다.
+- 사용자 리뷰 요청으로 명령을 끝까지 실행하지 못했다면 `사용자 리뷰 요청`에 실행한 명령, 실제 출력, 미실행 명령의 사유를 기록한다.
+
+### API-1 중간 검증
+```bash
+$ go test ./packages/domain/...
+(output)
+```
+
+### API-2 중간 검증
+```bash
+$ go test ./services/worker/...
+(output)
+```
+
+### 최종 검증
+```bash
+$ go test ./packages/domain/... ./services/worker/...
+(output)
+```
+
+---
+
+> **[IMPLEMENTING AGENT — BEFORE SAVING] Have you filled in every implementation-owned section: completion table, implementation checklist, changes from plan, design decisions, and verification output?**
+> If anything is blank, go back and fill it in before saving this file.
+> Leave review-agent-only sections unchanged.
+
+## Ownership
+
+| Section | Owner | Note |
+|---------|-------|------|
+| Header comment, 개요, 리뷰 에이전트 지시 | Fixed at stub creation | Implementing agent must not modify or execute these |
+| 구현 항목별 완료 여부 | Implementing agent | Check boxes only |
+| 구현 체크리스트 | Implementing agent | Check boxes only |
+| 코드리뷰 전용 체크리스트 | Review agent only | Implementing agent must not modify |
+| 계획 대비 변경 사항, 주요 설계 결정 | Implementing agent | Replace placeholder text |
+| 사용자 리뷰 요청 | Implementing agent | Keep `상태: 없음` unless selected SDD/Milestone lock decision blocks |
+| 리뷰어를 위한 체크포인트 | Fixed at stub creation | Review focus |
+| 검증 결과 | Implementing agent | Paste actual command output |
--- a/agent-task/m-backtest-multi-timeframe-coverage/01_domain_capability_matrix/PLAN-local-G05.md
+++ b/agent-task/m-backtest-multi-timeframe-coverage/01_domain_capability_matrix/PLAN-local-G05.md
@ -0,0 +1,202 @@
+<!-- task=m-backtest-multi-timeframe-coverage/01_domain_capability_matrix plan=0 tag=API -->
+
+# Plan - API
+
+## 이 파일을 읽는 구현 에이전트에게
+
+`CODE_REVIEW-local-G05.md`의 구현 에이전트 소유 섹션을 채우는 것이 구현의 마지막 단계다. 코드를 바꾸고 검증을 실행한 뒤 실제 구현 내용과 stdout/stderr를 리뷰 stub에 남기고, active 파일은 그대로 둔 채 리뷰 준비를 보고한다. 선택된 SDD 결정 또는 Milestone `구현 잠금 > 결정 필요` 항목이 막으면 리뷰 stub의 `사용자 리뷰 요청`만 채우고 멈춘다. 구현 중 사용자에게 직접 질문하거나 선택지를 제시하거나 `request_user_input`, `USER_REVIEW.md` 작성, log archive, `complete.log` 작성을 하지 않는다. 환경/secret/service 차단과 검증 증거 공백은 사용자 리뷰가 아니라 `검증 결과` 또는 후속 plan 대상으로 남긴다.
+
+## 배경
+
+`capability-matrix`는 provider, market, venue, asset type, timeframe 조합별 accepted/rejected와 거부 사유를 표현해야 한다. 현재 `ProviderCapability`는 venue/timeframe map과 daily 전용 `RequireDailyBars`만 있어 monthly/minute rejected case와 asset type 차원을 표현할 수 없다. 이 선행 plan은 domain 모델과 domain tests만 바꿔 worker/KIS rollout이 안정적으로 이어지게 한다.
+
+## 사용자 리뷰 요청 흐름
+
+사용자 리뷰 요청은 선택된 SDD 결정 또는 선택된 Milestone lock 결정이 실구현을 차단할 때만 active `CODE_REVIEW-local-G05.md`의 `사용자 리뷰 요청` 섹션에 기록한다. 직접 chat 질문은 금지이며, code-review가 검증 후 실제 `USER_REVIEW.md` 작성 여부를 판단한다.
+
+## 분석 결과
+
+### 읽은 파일
+
+- `agent-ops/rules/project/rules.md`
+- `agent-ops/rules/common/rules-roadmap.md`
+- `agent-ops/skills/common/router.md`
+- `agent-ops/skills/common/plan/SKILL.md`
+- `agent-ops/skills/common/roadmap-sdd/SKILL.md`
+- `agent-roadmap/current.md`
+- `agent-roadmap/phase/backtest-loop/PHASE.md`
+- `agent-roadmap/phase/backtest-loop/milestones/backtest-multi-timeframe-coverage.md`
+- `agent-roadmap/sdd/backtest-loop/backtest-multi-timeframe-coverage/SDD.md`
+- `agent-ops/rules/project/domain/domain-model/rules.md`
+- `agent-ops/rules/project/domain/worker/rules.md`
+- `agent-test/local/rules.md`
+- `agent-test/local/domain-model-smoke.md`
+- `agent-test/local/worker-smoke.md`
+- `packages/domain/market/types.go`
+- `packages/domain/market/types_test.go`
+- `services/worker/internal/jobs/marketdata_jobs.go`
+- `services/worker/internal/jobs/marketdata_jobs_test.go`
+- `services/worker/internal/providers/kis/daily_itemchartprice.go`
+- `services/worker/internal/providers/kis/daily_itemchartprice_test.go`
+- `services/worker/cmd/alt-worker/main.go`
+- `services/worker/cmd/alt-worker/main_test.go`
+
+### 테스트 환경 규칙
+
+- test_env: `local`
+- env rules: `agent-test/local/rules.md` 존재 및 정독 완료
+- matched profiles: `agent-test/local/domain-model-smoke.md`, `agent-test/local/worker-smoke.md`
+- 적용 명령: domain-only 선행 작업은 `go test ./packages/domain/...`; worker call-site compile 확인은 `go test ./services/worker/...`
+- fallback: 없음
+
+### 테스트 커버리지 공백
+
+- 현재 `packages/domain/market/types_test.go`는 daily bar import gate만 검증하고 provider/market/venue/asset type/timeframe matrix와 rejected reason을 검증하지 않는다.
+- 현재 worker tests는 daily import handler가 old `RequireDailyBars`를 호출한다는 경로만 검증한다. 이 plan은 worker rollout을 하지 않으므로 worker rejected case는 후속 `02+01_kis_job_capability`에서 닫는다.
+
+### 심볼 참조
+
+- 변경 대상 심볼: `market.ProviderCapability`, `ProviderCapability.SupportsDailyBars`, `ProviderCapability.RequireDailyBars`
+- call sites:
+  - `packages/domain/market/types_test.go`
+  - `services/worker/internal/jobs/marketdata_jobs.go`
+  - `services/worker/internal/jobs/marketdata_jobs_test.go`
+  - `services/worker/internal/providers/kis/daily_itemchartprice.go`
+  - `services/worker/cmd/alt-worker/main.go`
+
+### 분할 판단
+
+- split decision policy를 plan 파일 선택 전에 적용했다.
+- shared task group: `agent-task/m-backtest-multi-timeframe-coverage/`
+- sibling subtasks:
+  - `01_domain_capability_matrix`: domain capability request/decision/rule API와 domain tests. predecessor 없음.
+  - `02+01_kis_job_capability`: KIS capability table과 worker job gate rollout. `01_domain_capability_matrix`의 `complete.log` 필요.
+- split 이유: shared domain API/foundation과 worker/KIS call-site rollout이 분리되는 API-vs-call-site boundary다. 첫 번째 작업이 실패해도 worker wiring 계획을 다시 쓰지 않게 한다.
+
+### 범위 결정 근거
+
+- 포함: `packages/domain/market/types.go`, `packages/domain/market/types_test.go`
+- 제외: `.proto`, API socket, CLI runner, monthly aggregation, minute provider import, worker job handler 실제 변경. 이 plan은 S02 완료를 주장하지 않고 foundation만 만든다.
+
+### 빌드 등급
+
+- build: `local-G05`
+- review: `local-G05`
+- 근거: shared domain API 변경이지만 범위가 두 파일로 작고, call-site compile을 후속 task에서 명시적으로 처리한다.
+
+## 구현 체크리스트
+
+- [ ] `ProviderCapability`를 provider/market/venue/asset type/timeframe matrix request와 accepted/rejected decision을 표현하도록 확장하되, 후속 rollout 전 기존 daily call site가 컴파일될 수 있는 호환 wrapper를 유지한다.
+- [ ] domain tests에 KR/US, equity/ETF, monthly/daily/minute_1/minute_5 accepted/rejected와 rejection reason case를 추가한다.
+- [ ] `go test ./packages/domain/...`와 `go test ./services/worker/...`를 실행해 domain behavior와 기존 worker call-site compile을 확인한다.
+- [ ] CODE_REVIEW-*-G??.md의 구현 에이전트 소유 섹션을 실제 구현 내용과 검증 출력으로 채운다. 이 항목이 완료되기 전에는 구현이 완료된 것이 아니다.
+
+### [API-1] Domain capability matrix API
+
+문제:
+`packages/domain/market/types.go:103`의 `ProviderCapability`는 venue/timeframe map만 갖고, `packages/domain/market/types.go:123`의 `RequireDailyBars`는 daily 전용이라 asset type과 arbitrary timeframe rejection reason을 표현할 수 없다.
+
+해결 방법:
+`ProviderCapabilityRequest`, `ProviderCapabilityDecision`, `ProviderCapabilityRule`를 추가한다. `ProviderCapability.CheckBars(req)` 또는 동등한 이름의 pure function이 provider mismatch, missing venue, unknown venue, market/venue mismatch, asset type mismatch, unsupported timeframe을 stable reason으로 반환하게 한다. 기존 `RequireDailyBars(provider, selector)`는 `CheckBars`에 daily + empty asset type request를 위임하는 wrapper로 남겨 후속 rollout 전 컴파일을 유지한다.
+
+Before:
+
+```go
+// packages/domain/market/types.go:107
+type ProviderCapability struct {
+	Provider   Provider
+	Venues     map[Venue]bool
+	Timeframes map[Timeframe]bool
+}
+
+// packages/domain/market/types.go:123
+func (c ProviderCapability) RequireDailyBars(provider Provider, selector UniverseSelector) error {
+```
+
+After:
+
+```go
+type ProviderCapability struct {
+	Provider Provider
+	Rules    []ProviderCapabilityRule
+}
+
+type ProviderCapabilityRule struct {
+	Market     Market
+	Venue      Venue
+	AssetTypes map[AssetType]bool
+	Timeframes map[Timeframe]bool
+}
+
+type ProviderCapabilityRequest struct {
+	Provider  Provider
+	Market    Market
+	Venue     Venue
+	AssetType AssetType
+	Timeframe Timeframe
+}
+
+type ProviderCapabilityDecision struct {
+	Accepted bool
+	Reason   string
+}
+```
+
+수정 파일 및 체크리스트:
+
+- [ ] `packages/domain/market/types.go`: matrix request/decision/rule 타입 추가
+- [ ] `packages/domain/market/types.go`: `CheckBars` 또는 동등한 판정 함수 추가
+- [ ] `packages/domain/market/types.go`: 기존 `SupportsDailyBars`/`RequireDailyBars`를 새 판정 함수 wrapper로 유지하거나 명시적으로 deprecate comment를 남긴다
+- [ ] `packages/domain/market/types.go`: rejection reason 문자열은 테스트에서 검증 가능한 stable text로 둔다
+
+테스트 작성:
+`packages/domain/market/types_test.go`에 `TestProviderCapabilityMatrix`를 추가한다. KIS-like matrix로 KR/KRX equity daily, US/NASDAQ equity daily, US/NASDAQ ETF daily는 accepted, monthly/minute_1/minute_5는 rejected reason 포함으로 검증한다. provider mismatch, unknown venue, market/venue mismatch, unsupported asset type도 포함한다.
+
+중간 검증:
+
+```bash
+go test ./packages/domain/...
+```
+
+기대 결과: exit code 0.
+
+### [API-2] Compatibility compile guard
+
+문제:
+`services/worker/internal/jobs/marketdata_jobs.go:113`은 `capability.RequireDailyBars(...)`를 호출하고, `services/worker/internal/providers/kis/daily_itemchartprice.go:32`는 기존 struct literal을 반환한다. domain foundation 변경이 worker rollout보다 먼저 merge되면 worker compile이 깨질 수 있다.
+
+해결 방법:
+domain API에 compatibility wrapper와 old-style construction migration path를 함께 둔다. old `Venues`/`Timeframes` 필드를 제거하지 않고 deprecated 호환 필드로 유지하거나, same-plan에서 worker helper test constructors까지 최소 수정한다. 후속 task가 KIS/job gate를 새 matrix API로 전환한다.
+
+수정 파일 및 체크리스트:
+
+- [ ] `packages/domain/market/types.go`: old call site compatibility 전략 적용
+- [ ] `packages/domain/market/types_test.go`: old `RequireDailyBars` wrapper가 daily accepted/rejected를 유지하는 회귀 테스트 보존
+
+테스트 작성:
+기존 `TestProviderCapabilityRequireDailyBars`를 유지하거나 matrix API 기반으로 갱신하되, daily wrapper의 기존 KR/US accepted와 provider/venue rejection이 유지되는 assertion을 둔다.
+
+중간 검증:
+
+```bash
+go test ./services/worker/...
+```
+
+기대 결과: exit code 0.
+
+## 수정 파일 요약
+
+| 파일 | 항목 |
+|------|------|
+| `packages/domain/market/types.go` | API-1, API-2 |
+| `packages/domain/market/types_test.go` | API-1, API-2 |
+
+## 최종 검증
+
+```bash
+go test ./packages/domain/... ./services/worker/...
+```
+
+기대 결과: exit code 0. Go test cache output은 허용한다.
+
+모든 코드 변경 완료 후 반드시 `CODE_REVIEW-*-G??.md`의 구현 에이전트 소유 섹션을 채운다. 이 파일 작성이 구현의 마지막 단계다.
--- a/agent-task/m-backtest-multi-timeframe-coverage/02+01_kis_job_capability/CODE_REVIEW-local-G06.md
+++ b/agent-task/m-backtest-multi-timeframe-coverage/02+01_kis_job_capability/CODE_REVIEW-local-G06.md
@ -0,0 +1,162 @@
+<!-- task=m-backtest-multi-timeframe-coverage/02+01_kis_job_capability plan=0 tag=API -->
+
+# Code Review Reference - API
+
+> **[IMPLEMENTING AGENT — READ FIRST] Filling in this file is the mandatory final step of implementation.**
+> The task is NOT complete until every implementation-owned section below is filled in.
+> Complete the `구현 체크리스트`; the final checklist item is mandatory before saving.
+> Fill implementation-owned sections, then stop with active files in place and report ready for review.
+> If implementation is blocked by a selected SDD decision or selected Milestone `구현 잠금 > 결정 필요` item, fill `사용자 리뷰 요청` with linked evidence and stop with active files in place; code-review decides whether to write `USER_REVIEW.md`. Environment/secret/service blockers, generic scope changes, repeated failures, and evidence gaps that a follow-up agent can close are normal follow-up issues, not user-review blockers by themselves.
+> Do not ask the user directly, present choices in chat, or call `request_user_input` during implementation; record only SDD/Milestone lock decisions in `사용자 리뷰 요청` and stop for code-review.
+> Finalization (`코드리뷰 결과`, log rename, `complete.log`, archive moves, `코드리뷰 전용 체크리스트`) is review-agent-only, even after compaction/resume.
+> Follow the ownership table at the bottom of this file for which sections you own.
+
+## 개요
+
+date=2026-06-17
+task=m-backtest-multi-timeframe-coverage/02+01_kis_job_capability, plan=0, tag=API
+
+## Roadmap Targets
+
+- Milestone: `agent-roadmap/phase/backtest-loop/milestones/backtest-multi-timeframe-coverage.md`
+- Task ids:
+  - `capability-matrix`: provider, market, venue, asset type, timeframe별 지원/미지원 사유를 capability matrix로 표현한다.
+- Completion mode: check-on-pass
+
+## Spec Targets
+
+- SDD: `agent-roadmap/sdd/backtest-loop/backtest-multi-timeframe-coverage/SDD.md`
+- Acceptance scenarios:
+  - `S02`: task=`capability-matrix`; evidence=`capability matrix accepted/rejected tests for KIS KR/US daily, minute, monthly with explicit rejection reasons`
+- Completion mode: spec-check-on-pass
+
+## 이 파일을 읽는 리뷰 에이전트에게
+
+> **[REVIEW AGENT ONLY]** 아래 종결 절차는 코드리뷰 에이전트 전용이다. 구현 에이전트는 이 섹션을 실행하지 않는다.
+
+각 항목의 구현을 실제 소스 파일과 대조하고, `검증 결과` 섹션의 출력이 코드와 일치하는지 확인하세요.
+리뷰 완료는 아래 순서까지 끝난 상태를 의미합니다.
+
+1. 판정을 append한다.
+2. `CODE_REVIEW-local-G06.md` -> `code_review_local_G06_N.log`, `PLAN-local-G06.md` -> `plan_local_G06_M.log`로 아카이브한다.
+3. PASS이면 `complete.log` 작성 후 active task 디렉터리를 `agent-task/archive/YYYY/MM/m-backtest-multi-timeframe-coverage/02+01_kis_job_capability/`로 이동한다. WARN/FAIL이면 user-review gate를 확인한 뒤 다음 active plan/review 파일 또는 `USER_REVIEW.md`를 작성한다.
+4. PASS이고 task group이 `m-<milestone-slug>`이면 완료 이벤트 메타데이터를 보고한다. roadmap 상태 체크와 `update-roadmap` 호출은 런타임 책임이다.
+5. 적용 가능한 `코드리뷰 전용 체크리스트` 항목을 최종 `.log` 위치에서 체크한 뒤 보고한다.
+
+---
+
+## 구현 항목별 완료 여부
+
+| 항목 | 완료 여부 |
+|------|---------|
+| [API-1] KIS capability matrix rollout | [ ] |
+| [API-2] Worker import job gate integration | [ ] |
+
+## 구현 체크리스트
+
+- [ ] `01_domain_capability_matrix`의 `complete.log`가 active 또는 archive 경로에 있는지 확인하고, 없으면 구현하지 않고 dependency missing을 리뷰 stub에 기록한다.
+- [ ] `kis.Capability()`를 KIS KR/US daily accepted, monthly/minute_1/minute_5 rejected reason을 표현하는 matrix로 갱신한다.
+- [ ] `RegisterDailyBarImportHandler`가 새 matrix API로 daily import gate를 통과시키고 rejected reason을 `daily bar import payload` error에 보존하게 한다.
+- [ ] KIS capability와 job handler tests에 KR/US daily accepted, monthly/minute rejected, asset type accepted/rejected case를 추가한다. 검증: KIS KR/US daily, minute, monthly 조합의 accepted/rejected case가 명시적으로 통과한다.
+- [ ] `go test ./packages/domain/...`와 `go test ./services/worker/...`를 실행한다.
+- [ ] CODE_REVIEW-*-G??.md의 구현 에이전트 소유 섹션을 실제 구현 내용과 검증 출력으로 채운다. 이 항목이 완료되기 전에는 구현이 완료된 것이 아니다.
+
+## 코드리뷰 전용 체크리스트
+
+> **[REVIEW AGENT ONLY]** 이 체크리스트는 코드리뷰 에이전트만 사용한다.
+> 구현 에이전트는 이 섹션을 수정하거나 체크하지 않는다.
+
+- [ ] `코드리뷰 결과`에 `PASS`, `WARN`, `FAIL` 중 하나의 판정을 append한다.
+- [ ] 판정과 `차원별 평가`, Required/Suggested/Nit 분류가 서로 일치한다.
+- [ ] active `CODE_REVIEW-*-G??.md`를 `code_review_local_G06_N.log`로 아카이브한다.
+- [ ] active `PLAN-*-G??.md`를 `plan_local_G06_M.log`로 아카이브한다.
+- [ ] `.gitignore`의 Agent-Ops 관리 block이 `agent-task/**/*.md`와 `agent-task/**/*.log`를 unignore하고 `agent-roadmap/current.md`를 ignore하는지 확인한다.
+- [ ] PASS이면 `agent-ops/skills/common/code-review/templates/complete-log-template.md` 기준으로 `complete.log`를 작성하고 active `.md` 파일을 남기지 않는다.
+- [ ] PASS이면 active task 디렉터리 `agent-task/m-backtest-multi-timeframe-coverage/02+01_kis_job_capability/`를 `agent-task/archive/YYYY/MM/m-backtest-multi-timeframe-coverage/02+01_kis_job_capability/`로 이동하고 최종 archive 경로에서 이 체크리스트를 갱신한다.
+- [ ] PASS이고 task group이 `m-<milestone-slug>`이면 런타임이 읽을 완료 이벤트 메타데이터를 보고하고, roadmap 수정이나 `update-roadmap` 직접 호출을 하지 않는다.
+- [ ] PASS split 작업이면 이동 후 빈 active parent `agent-task/m-backtest-multi-timeframe-coverage/`를 제거하거나, 남은 sibling/file이 있어 유지했다고 확인한다.
+- [ ] WARN/FAIL이고 user-review gate가 트리거되지 않았으면 다음 active `PLAN-local-G06.md`와 `CODE_REVIEW-local-G06.md`를 작성하고 `complete.log`를 작성하지 않는다.
+- [ ] USER_REVIEW이면 `agent-ops/skills/common/code-review/templates/user-review-template.md` 기준으로 `USER_REVIEW.md`를 작성하고 active `PLAN-*.md`, `CODE_REVIEW-*.md`, `complete.log`를 남기지 않는다.
+- [ ] USER_REVIEW가 연결된 SDD/Milestone 결정으로 완료/PASS 해소되면 `USER_REVIEW.md`를 해소 상태로 갱신하고 `complete.log`를 작성한 뒤 task directory를 archive로 이동한다.
+
+## 계획 대비 변경 사항
+
+_구현 에이전트가 계획과 다르게 구현한 부분을 이유와 함께 기록한다._
+
+## 주요 설계 결정
+
+_구현 에이전트가 주요 설계 결정 사항을 기록한다._
+
+## 사용자 리뷰 요청
+
+_기본값은 `없음`이다. 구현 중 새 결정이 필요해 보여도 직접 질문하거나 선택지를 제시하거나 `request_user_input`을 호출하지 않는다. 이 섹션은 선택된 SDD 결정 또는 선택된 Milestone `구현 잠금 > 결정 필요` 항목이 실구현을 차단할 때만 채운다. 외부 환경/secret/서비스 준비, 검증 증거 공백, 반복 실패, 일반 범위 조정은 사용자 리뷰 요청이 아니며 `검증 결과`, `계획 대비 변경 사항`, 또는 code-review의 일반 follow-up plan으로 처리한다._
+
+- 상태: 없음
+- 사유 유형: 없음
+- 연결 대상: 없음
+- 결정 필요: 없음
+- 차단 근거: 없음
+- 실행한 검증/명령: 없음
+- 자동 후속 불가 이유: 없음
+- 재개 조건: 없음
+
+## 리뷰어를 위한 체크포인트
+
+- predecessor `01_domain_capability_matrix` 완료 근거가 확인되었는지 본다.
+- KIS matrix가 KR/US daily accepted와 monthly/minute rejected reason을 명시적으로 검증하는지 확인한다.
+- `capability-matrix` Roadmap Targets와 SDD S02 Spec Targets가 PASS 시 complete.log로 복사될 수 있는지 확인한다.
+
+## 검증 결과
+
+_구현 에이전트가 각 중간 검증 및 최종 검증 명령 실행 후 출력을 여기에 붙여 넣는다._
+
+필수 규칙:
+- 검증 명령은 고정된 계약이다. 임의로 대체하지 않는다.
+- 대체가 필요하면 `계획 대비 변경 사항`에 이유와 대체 명령을 기록한다.
+- `검증 결과`에는 실제 stdout/stderr를 붙여 넣는다.
+- 사용자 리뷰 요청으로 명령을 끝까지 실행하지 못했다면 `사용자 리뷰 요청`에 실행한 명령, 실제 출력, 미실행 명령의 사유를 기록한다.
+
+### Dependency 확인
+```bash
+$ test -f agent-task/m-backtest-multi-timeframe-coverage/01_domain_capability_matrix/complete.log || find agent-task/archive -path '*/m-backtest-multi-timeframe-coverage/01_domain_capability_matrix/complete.log' -print -quit
+(output)
+```
+
+### API-1 중간 검증
+```bash
+$ go test ./services/worker/internal/providers/kis
+(output)
+```
+
+### API-2 중간 검증
+```bash
+$ go test ./services/worker/internal/jobs ./services/worker/cmd/alt-worker
+(output)
+```
+
+### 최종 검증
+```bash
+$ go test ./packages/domain/... ./services/worker/...
+(output)
+```
+
+---
+
+> **[IMPLEMENTING AGENT — BEFORE SAVING] Have you filled in every implementation-owned section: completion table, implementation checklist, changes from plan, design decisions, and verification output?**
+> If anything is blank, go back and fill it in before saving this file.
+> Leave review-agent-only sections unchanged.
+
+## Ownership
+
+| Section | Owner | Note |
+|---------|-------|------|
+| Header comment, 개요, 리뷰 에이전트 지시 | Fixed at stub creation | Implementing agent must not modify or execute these |
+| Roadmap Targets | Fixed at stub creation from plan | Implementing agent must not modify |
+| Spec Targets | Fixed at stub creation from plan | Implementing agent must not modify |
+| 구현 항목별 완료 여부 | Implementing agent | Check boxes only |
+| 구현 체크리스트 | Implementing agent | Check boxes only |
+| 코드리뷰 전용 체크리스트 | Review agent only | Implementing agent must not modify |
+| 계획 대비 변경 사항, 주요 설계 결정 | Implementing agent | Replace placeholder text |
+| 사용자 리뷰 요청 | Implementing agent | Keep `상태: 없음` unless selected SDD/Milestone lock decision blocks |
+| 리뷰어를 위한 체크포인트 | Fixed at stub creation | Review focus |
+| 검증 결과 | Implementing agent | Paste actual command output |
--- a/agent-task/m-backtest-multi-timeframe-coverage/02+01_kis_job_capability/PLAN-local-G06.md
+++ b/agent-task/m-backtest-multi-timeframe-coverage/02+01_kis_job_capability/PLAN-local-G06.md
@ -0,0 +1,241 @@
+<!-- task=m-backtest-multi-timeframe-coverage/02+01_kis_job_capability plan=0 tag=API -->
+
+# Plan - API
+
+## 이 파일을 읽는 구현 에이전트에게
+
+이 subtask는 `01_domain_capability_matrix` 완료 후에만 구현한다. 시작 전에 `agent-task/m-backtest-multi-timeframe-coverage/01_domain_capability_matrix/complete.log` 또는 archive의 같은 subtask `complete.log`가 있는지 확인한다. `CODE_REVIEW-local-G06.md`의 구현 에이전트 소유 섹션을 채우는 것이 구현의 마지막 단계다. 선택된 SDD 결정 또는 Milestone `구현 잠금 > 결정 필요` 항목이 막으면 리뷰 stub의 `사용자 리뷰 요청`만 채우고 멈춘다. 구현 중 사용자에게 직접 질문하거나 `USER_REVIEW.md`, `complete.log`, log archive를 만들지 않는다.
+
+## 배경
+
+domain foundation이 생긴 뒤에는 KIS provider capability와 daily import job gate가 같은 matrix 판정을 쓰도록 연결해야 한다. SDD S02는 KIS KR/US daily, minute, monthly 조합의 accepted/rejected case와 거부 사유를 요구한다. 이 plan은 `capability-matrix` Milestone Task와 SDD S02 완료를 목표로 한다.
+
+## 사용자 리뷰 요청 흐름
+
+사용자 리뷰 요청은 선택된 SDD 결정 또는 선택된 Milestone lock 결정이 실구현을 차단할 때만 active `CODE_REVIEW-local-G06.md`의 `사용자 리뷰 요청` 섹션에 기록한다. 직접 chat 질문은 금지이며, code-review가 검증 후 실제 `USER_REVIEW.md` 작성 여부를 판단한다.
+
+## Roadmap Targets
+
+- Milestone: `agent-roadmap/phase/backtest-loop/milestones/backtest-multi-timeframe-coverage.md`
+- Task ids:
+  - `capability-matrix`: provider, market, venue, asset type, timeframe별 지원/미지원 사유를 capability matrix로 표현한다.
+- Completion mode: check-on-pass
+
+## Spec Targets
+
+- SDD: `agent-roadmap/sdd/backtest-loop/backtest-multi-timeframe-coverage/SDD.md`
+- Acceptance scenarios:
+  - `S02`: task=`capability-matrix`; evidence=`capability matrix accepted/rejected tests for KIS KR/US daily, minute, monthly with explicit rejection reasons`
+- Completion mode: spec-check-on-pass
+
+## 분석 결과
+
+### 읽은 파일
+
+- `agent-ops/rules/project/rules.md`
+- `agent-ops/rules/common/rules-roadmap.md`
+- `agent-ops/skills/common/router.md`
+- `agent-ops/skills/common/plan/SKILL.md`
+- `agent-ops/skills/common/roadmap-sdd/SKILL.md`
+- `agent-roadmap/current.md`
+- `agent-roadmap/phase/backtest-loop/PHASE.md`
+- `agent-roadmap/phase/backtest-loop/milestones/backtest-multi-timeframe-coverage.md`
+- `agent-roadmap/sdd/backtest-loop/backtest-multi-timeframe-coverage/SDD.md`
+- `agent-ops/rules/project/domain/domain-model/rules.md`
+- `agent-ops/rules/project/domain/worker/rules.md`
+- `agent-test/local/rules.md`
+- `agent-test/local/domain-model-smoke.md`
+- `agent-test/local/worker-smoke.md`
+- `packages/domain/market/types.go`
+- `packages/domain/market/types_test.go`
+- `services/worker/internal/jobs/marketdata_jobs.go`
+- `services/worker/internal/jobs/marketdata_jobs_test.go`
+- `services/worker/internal/providers/kis/daily_itemchartprice.go`
+- `services/worker/internal/providers/kis/daily_itemchartprice_test.go`
+- `services/worker/cmd/alt-worker/main.go`
+- `services/worker/cmd/alt-worker/main_test.go`
+
+### 테스트 환경 규칙
+
+- test_env: `local`
+- env rules: `agent-test/local/rules.md` 존재 및 정독 완료
+- matched profiles: `agent-test/local/domain-model-smoke.md`, `agent-test/local/worker-smoke.md`
+- 적용 명령: `go test ./packages/domain/...`, `go test ./services/worker/...`
+- fallback: 없음
+
+### 테스트 커버리지 공백
+
+- 현재 `services/worker/internal/providers/kis/daily_itemchartprice_test.go`는 normalized daily bars와 provider symbol fixture를 검증하지만 KIS capability accepted/rejected matrix를 검증하지 않는다.
+- 현재 `services/worker/internal/jobs/marketdata_jobs_test.go`는 daily import accepted/rejected를 old daily gate로 검증한다. monthly/minute rejected reason과 asset type 차원은 없다.
+
+### 심볼 참조
+
+- 변경 대상 심볼: `kis.Capability`, `jobs.RegisterDailyBarImportHandler`, `market.ProviderCapability` matrix API
+- call sites:
+  - `services/worker/cmd/alt-worker/main.go`
+  - `services/worker/internal/jobs/marketdata_jobs.go`
+  - `services/worker/internal/jobs/marketdata_jobs_test.go`
+  - `services/worker/internal/providers/kis/daily_itemchartprice.go`
+  - `services/worker/internal/providers/kis/daily_itemchartprice_test.go`
+
+### 분할 판단
+
+- split decision policy를 plan 파일 선택 전에 적용했다.
+- shared task group: `agent-task/m-backtest-multi-timeframe-coverage/`
+- current subtask: `02+01_kis_job_capability`
+- dependency: predecessor index `01` = `agent-task/m-backtest-multi-timeframe-coverage/01_domain_capability_matrix`
+- predecessor status: active sibling plan exists, `complete.log` missing at plan creation time. 구현자는 시작 전에 active 또는 archive `complete.log`를 확인해야 한다.
+
+### 범위 결정 근거
+
+- 포함: KIS capability table, worker daily import job capability gate, related tests.
+- 제외: `.proto` 변경, API request shape 변경, CLI surface 변경, actual minute import endpoint, monthly aggregation generation, storage schema 변경. Monthly는 이 task에서 provider direct import rejected reason으로만 다룬다.
+
+### 빌드 등급
+
+- build: `local-G06`
+- review: `local-G06`
+- 근거: domain foundation 후 worker/KIS rollout이며 verification이 local Go tests로 닫힌다. 다만 Milestone Task와 SDD S02 completion을 주장하므로 G06으로 둔다.
+
+## 구현 체크리스트
+
+- [ ] `01_domain_capability_matrix`의 `complete.log`가 active 또는 archive 경로에 있는지 확인하고, 없으면 구현하지 않고 dependency missing을 리뷰 stub에 기록한다.
+- [ ] `kis.Capability()`를 KIS KR/US daily accepted, monthly/minute_1/minute_5 rejected reason을 표현하는 matrix로 갱신한다.
+- [ ] `RegisterDailyBarImportHandler`가 새 matrix API로 daily import gate를 통과시키고 rejected reason을 `daily bar import payload` error에 보존하게 한다.
+- [ ] KIS capability와 job handler tests에 KR/US daily accepted, monthly/minute rejected, asset type accepted/rejected case를 추가한다. 검증: KIS KR/US daily, minute, monthly 조합의 accepted/rejected case가 명시적으로 통과한다.
+- [ ] `go test ./packages/domain/...`와 `go test ./services/worker/...`를 실행한다.
+- [ ] CODE_REVIEW-*-G??.md의 구현 에이전트 소유 섹션을 실제 구현 내용과 검증 출력으로 채운다. 이 항목이 완료되기 전에는 구현이 완료된 것이 아니다.
+
+## 의존 관계 및 구현 순서
+
+`02+01_kis_job_capability`는 directory name 기준으로 predecessor `01_domain_capability_matrix`에 의존한다. 구현 시작 전 다음 중 하나가 있어야 한다.
+
+- active: `agent-task/m-backtest-multi-timeframe-coverage/01_domain_capability_matrix/complete.log`
+- archive: `agent-task/archive/*/*/m-backtest-multi-timeframe-coverage/01_domain_capability_matrix/complete.log`
+
+### [API-1] KIS capability matrix rollout
+
+문제:
+`services/worker/internal/providers/kis/daily_itemchartprice.go:32`의 `Capability()`는 venue map과 daily timeframe map만 반환한다. SDD S02의 KIS KR/US daily, minute, monthly accepted/rejected case와 거부 사유를 표현하지 못한다.
+
+해결 방법:
+`01_domain_capability_matrix`에서 만든 matrix API로 `kis.Capability()`를 작성한다. KR/KRX equity daily, US/NASDAQ equity daily, US/NASDAQ ETF daily는 accepted로 둔다. `monthly`는 D02에 따라 provider direct source가 아니라 daily aggregation source라는 reason으로 rejected한다. `minute_1`/`minute_5`는 이번 task에서 provider daily import gate 미지원 reason으로 rejected한다.
+
+Before:
+
+```go
+// services/worker/internal/providers/kis/daily_itemchartprice.go:32
+func Capability() market.ProviderCapability {
+	return market.ProviderCapability{
+		Provider: market.ProviderKIS,
+		Venues: map[market.Venue]bool{
+			market.VenueKRX:    true,
+			market.VenueNASDAQ: true,
+			market.VenueNYSE:   true,
+		},
+		Timeframes: map[market.Timeframe]bool{
+			market.TimeframeDaily: true,
+		},
+	}
+}
+```
+
+After:
+
+```go
+func Capability() market.ProviderCapability {
+	return market.ProviderCapability{
+		Provider: market.ProviderKIS,
+		Rules: []market.ProviderCapabilityRule{
+			{Market: market.MarketKR, Venue: market.VenueKRX, AssetTypes: ..., Timeframes: ...},
+			{Market: market.MarketUS, Venue: market.VenueNASDAQ, AssetTypes: ..., Timeframes: ...},
+			{Market: market.MarketUS, Venue: market.VenueNYSE, AssetTypes: ..., Timeframes: ...},
+		},
+	}
+}
+```
+
+수정 파일 및 체크리스트:
+
+- [ ] `services/worker/internal/providers/kis/daily_itemchartprice.go`: `Capability()`를 matrix API로 갱신
+- [ ] `services/worker/internal/providers/kis/daily_itemchartprice_test.go`: KIS matrix accepted/rejected 테스트 추가
+
+테스트 작성:
+`TestKISCapabilityMatrixDailyAcceptedAndTimeframeRejections`를 추가한다. `market.ProviderCapabilityRequest` 또는 01에서 만든 동등한 request로 KR/KRX equity daily, US/NASDAQ equity daily, US/NASDAQ ETF daily accepted를 확인하고, KR/US monthly, minute_1, minute_5 rejected reason을 확인한다.
+
+중간 검증:
+
+```bash
+go test ./services/worker/internal/providers/kis
+```
+
+기대 결과: exit code 0.
+
+### [API-2] Worker import job gate integration
+
+문제:
+`services/worker/internal/jobs/marketdata_jobs.go:113`은 old daily-only `RequireDailyBars`를 호출한다. 새 matrix API가 생겨도 worker job gate가 accepted/rejected reason을 직접 검증하지 않으면 SDD S02 증거가 job boundary까지 이어지지 않는다.
+
+해결 방법:
+`RegisterDailyBarImportHandler`가 payload selector를 capability request로 변환해 daily import gate를 검사한다. payload에 asset type이 없으므로 daily import job은 empty asset type을 wildcard 또는 unknown으로 넘긴다. rejected reason은 `fmt.Errorf("daily bar import payload: %w", err)` 형태로 보존한다. 기존 daily import payload schema는 바꾸지 않는다.
+
+Before:
+
+```go
+// services/worker/internal/jobs/marketdata_jobs.go:113
+if err := capability.RequireDailyBars(market.Provider(p.Provider), p.selector()); err != nil {
+	return fmt.Errorf("daily bar import payload: %w", err)
+}
+```
+
+After:
+
+```go
+decision := capability.CheckBars(market.ProviderCapabilityRequest{
+	Provider:  market.Provider(p.Provider),
+	Market:    market.Market(p.Market),
+	Venue:     market.Venue(p.Venue),
+	Timeframe: market.TimeframeDaily,
+})
+if !decision.Accepted {
+	return fmt.Errorf("daily bar import payload: %s", decision.Reason)
+}
+```
+
+수정 파일 및 체크리스트:
+
+- [ ] `services/worker/internal/jobs/marketdata_jobs.go`: new matrix gate 사용
+- [ ] `services/worker/internal/jobs/marketdata_jobs_test.go`: helper capability를 matrix API로 갱신
+- [ ] `services/worker/internal/jobs/marketdata_jobs_test.go`: unsupported monthly/minute reason은 domain/KIS matrix에서 검증하고, job handler는 daily import payload rejection behavior를 유지하도록 테스트
+- [ ] `services/worker/cmd/alt-worker/main.go`: `kis.Capability()` call site compile 확인
+
+테스트 작성:
+기존 `TestRegisterDailyBarImportHandlerDispatchesImporter`, `TestRegisterDailyBarImportHandlerDispatchesUSWatchlist`, `TestRegisterDailyBarImportHandlerRejectsUnsupportedVenue`를 새 matrix helper로 갱신한다. rejected error message에 capability reason이 남는 assertion을 추가한다.
+
+중간 검증:
+
+```bash
+go test ./services/worker/internal/jobs ./services/worker/cmd/alt-worker
+```
+
+기대 결과: exit code 0.
+
+## 수정 파일 요약
+
+| 파일 | 항목 |
+|------|------|
+| `services/worker/internal/providers/kis/daily_itemchartprice.go` | API-1 |
+| `services/worker/internal/providers/kis/daily_itemchartprice_test.go` | API-1 |
+| `services/worker/internal/jobs/marketdata_jobs.go` | API-2 |
+| `services/worker/internal/jobs/marketdata_jobs_test.go` | API-2 |
+| `services/worker/cmd/alt-worker/main.go` | API-2 |
+
+## 최종 검증
+
+```bash
+go test ./packages/domain/... ./services/worker/...
+```
+
+기대 결과: exit code 0. Go test cache output은 허용한다.
+
+모든 코드 변경 완료 후 반드시 `CODE_REVIEW-*-G??.md`의 구현 에이전트 소유 섹션을 채운다. 이 파일 작성이 구현의 마지막 단계다.