Code Review Reference - REFACTOR

[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. Do not modify or check the 코드리뷰 전용 체크리스트; it is owned by the review agent only. Follow the ownership table at the bottom of this file for which sections you own.

개요

date=2026-05-19 task=01+02_runtime_context, plan=0, tag=REFACTOR

이 파일을 읽는 리뷰 에이전트에게

각 항목의 구현을 실제 소스 파일과 대조하고, 검증 결과 섹션의 출력이 코드와 일치하는지 확인하세요. review 완료 후 반드시 아래 순서로 아카이브하세요.

CODE_REVIEW-cloud-G07.md → code_review_cloud_G07_N.log (N = 기존 code_review_*.log 수)
PLAN-cloud-G07.md → plan_cloud_G07_M.log (M = 기존 plan_*.log 수)
PASS인 경우 complete.log 작성 후 agent-task/archive/YYYY/MM/01+02_runtime_context/로 task 디렉터리 이동. WARN/FAIL인 경우 새 routed plan + review 스텁 작성.

어떤 판정에서도 아카이브를 건너뛰지 마세요. PASS/WARN/FAIL 모두 코드리뷰 결과 append 후 active plan/review 파일을 먼저 아카이브하고, 그 다음 complete.log 또는 다음 plan/review 파일을 작성해야 합니다. PASS에서는 agent-ops/skills/common/code-review/templates/complete-log-template.md의 섹션 순서와 필수 항목을 기준으로 complete.log를 작성하세요. 작성 후 현재 날짜의 YYYY/MM 기준으로 task 디렉터리를 agent-task/archive/YYYY/MM/01+02_runtime_context/로 이동하고, 최종 archive 경로의 code_review_*.log에서 코드리뷰 전용 체크리스트를 갱신한 다음 보고하세요. WARN/FAIL에서는 다음 상태 파일 작성 후 현재 task 경로의 archived code_review_*.log에서 적용 가능한 코드리뷰 전용 체크리스트 항목을 체크한 다음 보고하세요.

구현 항목별 완료 여부

항목	완료 여부
[REFACTOR-1] `ExecutionContext`를 추가하고 Application mutable state를 context로 위임한다	[ ]

구현 체크리스트

[REFACTOR-1] ExecutionContext를 추가하고 Application mutable state를 context로 위임한다.
모든 중간 검증과 최종 검증을 실행하고 실제 출력을 CODE_REVIEW-*-G??.md에 기록한다.
CODE_REVIEW-*-G??.md의 구현 에이전트 소유 섹션을 실제 구현 내용과 검증 출력으로 채운다. 이 항목이 완료되기 전에는 구현이 완료된 것이 아니다.

코드리뷰 전용 체크리스트

[REVIEW AGENT ONLY] 이 체크리스트는 코드리뷰 에이전트만 사용한다. 구현 에이전트는 이 섹션을 수정하거나 체크하지 않는다.

코드리뷰 결과에 PASS, WARN, FAIL 중 하나의 판정을 append한다.
판정과 차원별 평가, Required/Suggested/Nit 분류가 서로 일치한다.
active CODE_REVIEW-*-G??.md를 code_review_cloud_G07_N.log로 아카이브한다.
active PLAN-*-G??.md를 plan_cloud_G07_M.log로 아카이브한다.
PASS이면 agent-ops/skills/common/code-review/templates/complete-log-template.md 기준으로 complete.log를 작성하고 active .md 파일을 남기지 않는다.
PASS이면 agent-task/01+02_runtime_context/를 agent-task/archive/YYYY/MM/01+02_runtime_context/로 이동하고 최종 archive 경로에서 이 체크리스트를 갱신한다.
WARN/FAIL이면 다음 active PLAN-cloud-G07.md와 CODE_REVIEW-cloud-G07.md를 작성하고 complete.log를 작성하지 않는다.

계획 대비 변경 사항

구현 에이전트가 계획과 다르게 구현한 부분을 이유와 함께 기록한다.

주요 설계 결정

구현 에이전트가 주요 설계 결정 사항을 기록한다.

리뷰어를 위한 체크포인트

기존 Application.instance.property = {} 패턴이 깨지지 않는지 확인한다.
TagSystem이 context를 경유하는지 확인한다.
final rg 결과가 직접 mutable state 접근 제거와 일치하는지 확인한다.

검증 결과

구현 에이전트가 각 중간 검증 및 최종 검증 명령 실행 후 출력을 여기에 붙여 넣는다.

필수 규칙:

검증 명령은 고정된 계약이다. 임의로 대체하지 않는다.
대체가 필요하면 계획 대비 변경 사항에 이유와 대체 명령을 기록한다.
검증 결과에는 실제 stdout/stderr를 붙여 넣는다.

REFACTOR-1 중간 검증

$ dart test test/oto_context_test.dart
(output)

최종 검증

$ dart analyze
(output)

$ dart test
(output)

$ rg --sort path -n "Application\\.instance\\.(property|commonData|commandStates|dataCommandMap)" lib/oto/core lib/oto/commands/command.dart
(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 the review-agent-only checklist unchanged.

5.3 KiB Raw Blame History