From 97373ca14e06fab64bb680524c5305a5b8842d5c Mon Sep 17 00:00:00 2001 From: toki Date: Wed, 17 Jun 2026 21:37:12 +0900 Subject: [PATCH] =?UTF-8?q?feat(agent-task):=20m-backtest-multi-timeframe-?= =?UTF-8?q?coverage=20=EC=9E=91=EC=97=85=20=EA=B3=84=ED=9A=8D=EA=B3=BC=20?= =?UTF-8?q?=EC=BD=94=EB=93=9C=20=EB=A6=AC=EB=B7=B0=EB=A5=BC=20=EC=B6=94?= =?UTF-8?q?=EA=B0=80=ED=95=9C=EB=8B=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 01_domain_capability_matrix: PLAN-local-G05, CODE_REVIEW-local-G05 02+01_kis_job_capability: PLAN-local-G06, CODE_REVIEW-local-G06 --- .../CODE_REVIEW-local-G05.md | 138 ++++++++++ .../PLAN-local-G05.md | 202 +++++++++++++++ .../CODE_REVIEW-local-G06.md | 162 ++++++++++++ .../PLAN-local-G06.md | 241 ++++++++++++++++++ 4 files changed, 743 insertions(+) create mode 100644 agent-task/m-backtest-multi-timeframe-coverage/01_domain_capability_matrix/CODE_REVIEW-local-G05.md create mode 100644 agent-task/m-backtest-multi-timeframe-coverage/01_domain_capability_matrix/PLAN-local-G05.md create mode 100644 agent-task/m-backtest-multi-timeframe-coverage/02+01_kis_job_capability/CODE_REVIEW-local-G06.md create mode 100644 agent-task/m-backtest-multi-timeframe-coverage/02+01_kis_job_capability/PLAN-local-G06.md diff --git 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 new file mode 100644 index 0000000..8b0f073 --- /dev/null +++ b/agent-task/m-backtest-multi-timeframe-coverage/01_domain_capability_matrix/CODE_REVIEW-local-G05.md @@ -0,0 +1,138 @@ + + +# 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-`이면 완료 이벤트 메타데이터를 보고한다. 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-`이면 런타임이 읽을 완료 이벤트 메타데이터를 보고하고, 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 | diff --git 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 new file mode 100644 index 0000000..cf22899 --- /dev/null +++ b/agent-task/m-backtest-multi-timeframe-coverage/01_domain_capability_matrix/PLAN-local-G05.md @@ -0,0 +1,202 @@ + + +# 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`의 구현 에이전트 소유 섹션을 채운다. 이 파일 작성이 구현의 마지막 단계다. diff --git 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 new file mode 100644 index 0000000..abdab18 --- /dev/null +++ b/agent-task/m-backtest-multi-timeframe-coverage/02+01_kis_job_capability/CODE_REVIEW-local-G06.md @@ -0,0 +1,162 @@ + + +# 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-`이면 완료 이벤트 메타데이터를 보고한다. 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-`이면 런타임이 읽을 완료 이벤트 메타데이터를 보고하고, 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 | diff --git 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 new file mode 100644 index 0000000..03db825 --- /dev/null +++ b/agent-task/m-backtest-multi-timeframe-coverage/02+01_kis_job_capability/PLAN-local-G06.md @@ -0,0 +1,241 @@ + + +# 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`의 구현 에이전트 소유 섹션을 채운다. 이 파일 작성이 구현의 마지막 단계다.