<!-- task=final_full_validation/02+01_nightly_full_performance plan=2 tag=REVIEW_REVIEW_TEST -->

# Plan - REVIEW_REVIEW_TEST Verification Evidence Recovery

## 이 파일을 읽는 구현 에이전트에게

`CODE_REVIEW-cloud-G07.md`의 구현 에이전트 소유 섹션을 실제 실행 내용과 검증 출력으로 채우는 것이 구현의 마지막 단계다. 이번 루프는 존재하지 않는 full performance record와 실제 문서 상태에 맞지 않는 검증 출력이 기록된 문제만 좁게 복구한다. 직접 사용자에게 질문하지 않는다. 선택된 SDD 결정 또는 Milestone lock 결정이 막는 경우에만 review stub의 `사용자 리뷰 요청` 섹션에 연결 대상, 차단 근거, 실행한 명령, 재개 조건을 기록한다. 환경/secret/서비스 준비, 일반 범위 변경, 검증 증거 공백은 사용자 리뷰 요청이 아니라 검증 결과 또는 후속 plan 대상이다.

## Archive Evidence Snapshot

- 이전 plan: `agent-task/final_full_validation/02+01_nightly_full_performance/plan_cloud_G07_1.log`
- 이전 review: `agent-task/final_full_validation/02+01_nightly_full_performance/code_review_cloud_G07_1.log`
- 이전 verdict: FAIL
- Required 요약:
  - `code_review_cloud_G07_1.log`의 검증 결과는 `agent-test/runs/20260619-201532-proto-socket-performance-full.md`와 `overall_result: PASS`, `regression_result: PASS`를 주장했다.
  - 리뷰 시점 실제 파일 확인 결과 `agent-test/runs/20260619-201532-proto-socket-performance-full.md`는 존재하지 않았다.
  - 실제 최신 full record는 `agent-test/runs/20260618-144710-proto-socket-performance-full.md`였고, README/ROADMAP도 20260619 full baseline PASS로 갱신되어 있지 않았다.
- 영향 파일:
  - `README.md`: 실제 새 full comparison record가 존재하고 `overall_result: PASS`, `regression_result: PASS`일 때만 최신 full baseline 근거를 반영한다.
  - `agent-roadmap/ROADMAP.md`: 실제 새 full comparison record가 존재하고 PASS일 때만 잠정 완료 판단 근거를 보강한다.
  - `agent-task/final_full_validation/02+01_nightly_full_performance/CODE_REVIEW-cloud-G07.md`: 실제 명령 출력, 실제 record path, 실제 문서 diff/검색 결과를 기록한다.
- 검증 근거:
  - baseline: `agent-test/runs/20260614-123328-proto-socket-performance-full.md`
  - 마지막 실제 full record: `agent-test/runs/20260618-144710-proto-socket-performance-full.md`
  - 결함 근거: `agent-task/final_full_validation/02+01_nightly_full_performance/code_review_cloud_G07_1.log`
- 좁은 archive 재확인 허용 경로:
  - `agent-task/final_full_validation/02+01_nightly_full_performance/plan_cloud_G07_1.log`
  - `agent-task/final_full_validation/02+01_nightly_full_performance/code_review_cloud_G07_1.log`

## 배경

이전 루프는 full performance rerun이 PASS했다고 기록했지만, 해당 record 파일과 문서 갱신 근거가 실제 작업본에 없었다. 이 상태에서는 성능 regression PASS 여부를 판단할 수 없으므로, 후속 구현은 새 결과를 만들거나 미실행 사유를 기록할 때 실제 command output과 파일 존재 여부만 사용해야 한다.

## 범위 결정 근거

- runner 스크립트, 프로토콜 구현, benchmark harness 수정은 제외한다.
- full functional matrix 재실행은 제외한다.
- full performance command를 실제로 실행하지 못하면 PASS를 주장하지 않는다. 그 경우 tracked docs도 갱신하지 않고 미실행 사유와 실행 가능한 다음 명령을 review stub에 남긴다.
- `agent-test/runs/**` 결과 파일은 ignored local evidence로만 사용한다.

## 빌드 등급

- build lane: `cloud-G07`
- review lane: `cloud-G07`
- 근거: long-running benchmark-style terminal task와 verification evidence trust 복구가 핵심이다.

## 구현 체크리스트

- [ ] `test ! -f agent-test/runs/20260619-201532-proto-socket-performance-full.md`와 `ls -1t agent-test/runs/*-proto-socket-performance-full.md | head -5`를 실행해 이전 루프의 record 주장과 실제 최신 record 상태를 확인하고 실제 출력을 기록한다.
- [ ] `date '+%Y-%m-%d %H:%M:%S %Z'`로 20:00 이후 시작인지 확인한다. 20:00 전이면 full baseline을 실행하지 않고 review stub에 미실행 사유를 기록한다.
- [ ] `test -f agent-test/runs/20260614-123328-proto-socket-performance-full.md`로 baseline 파일 존재를 확인한다.
- [ ] 20:00 이후이면 `bash agent-ops/skills/project/run-proto-socket-test-matrix/scripts/run_performance.sh --full --baseline agent-test/runs/20260614-123328-proto-socket-performance-full.md --fail-on-regression`을 실행하고 실제 stdout/stderr, exit code, 생성된 record path를 기록한다. 실행하지 못했으면 그 사유와 미실행 exit 상태를 기록한다.
- [ ] `latest_full_record="$(ls -1t agent-test/runs/*-proto-socket-performance-full.md | head -1)" && printf '%s\n' "$latest_full_record" && test -f "$latest_full_record" && sed -n '1,32p' "$latest_full_record"`를 실행해 최신 record 파일 존재와 header의 `overall_result`, `regression_result`를 실제 출력으로 검증한다.
- [ ] 새 latest record가 `overall_result: PASS` 및 `regression_result: PASS`이면 `README.md`와 `agent-roadmap/ROADMAP.md`에 최신 full baseline record/ref/regression PASS 근거를 반영한다.
- [ ] 새 latest record가 WARN/FAIL이거나 full command가 미실행이면 `README.md`와 `agent-roadmap/ROADMAP.md`를 PASS로 갱신하지 말고 실제 record header 또는 미실행 사유를 `CODE_REVIEW-cloud-G07.md`에 기록한다.
- [ ] `git diff --check`, `git diff -- README.md agent-roadmap/ROADMAP.md`, `rg --sort path -n "proto-socket-performance-full|regression|full baseline|잠정 완료" README.md agent-roadmap/ROADMAP.md`를 실행하고 실제 출력을 기록한다.
- [ ] CODE_REVIEW-*-G??.md의 구현 에이전트 소유 섹션을 실제 구현 내용과 검증 출력으로 채운다. 이 항목이 완료되기 전에는 구현이 완료된 것이 아니다.

### [REVIEW_REVIEW_TEST-1] 실제 full performance 증거와 문서 상태 정합성 복구

#### 문제

이전 루프의 PASS 검증 출력은 실제 파일 시스템과 문서 상태로 재현되지 않았다. 존재하지 않는 record 또는 실제와 다른 `rg` 출력을 근거로 full baseline PASS를 주장하면 안 된다.

#### 해결 방법

1. 이전 루프가 주장한 record의 부재와 현재 최신 record를 실제 명령 출력으로 확인한다.
2. 20:00 이후 조건을 만족할 때만 full performance comparison을 실제 실행한다.
3. 생성된 latest record 파일 header를 직접 확인한다.
4. PASS일 때만 README/ROADMAP을 갱신하고, 그렇지 않으면 문서를 유지한 채 실제 evidence를 review stub에 남긴다.

#### 수정 파일 및 체크리스트

- [ ] `README.md`: 실제 latest full record가 PASS일 때만 갱신.
- [ ] `agent-roadmap/ROADMAP.md`: 실제 latest full record가 PASS일 때만 갱신.
- [ ] `CODE_REVIEW-cloud-G07.md`: actual command output, record existence check, latest record header, 문서 diff/검색 결과 기록.

#### 테스트 작성

- 별도 테스트 파일 작성 없음. 이 task 자체가 full 성능/안정성 검증 실행과 증거 정합성 확인이다.

#### 중간 검증

```bash
test ! -f agent-test/runs/20260619-201532-proto-socket-performance-full.md
ls -1t agent-test/runs/*-proto-socket-performance-full.md | head -5
date '+%Y-%m-%d %H:%M:%S %Z'
test -f agent-test/runs/20260614-123328-proto-socket-performance-full.md
bash agent-ops/skills/project/run-proto-socket-test-matrix/scripts/run_performance.sh --full --baseline agent-test/runs/20260614-123328-proto-socket-performance-full.md --fail-on-regression
```

기대 결과: 20:00 이후 실제 실행 시 command output이 record 파일을 생성한다. PASS가 아니면 exit code와 record header를 그대로 기록하고 문서를 PASS로 갱신하지 않는다.

## 수정 파일 요약

| 파일 | 항목 |
|---|---|
| `README.md` | REVIEW_REVIEW_TEST-1 |
| `agent-roadmap/ROADMAP.md` | REVIEW_REVIEW_TEST-1 |
| `agent-task/final_full_validation/02+01_nightly_full_performance/CODE_REVIEW-cloud-G07.md` | REVIEW_REVIEW_TEST-1 |

## 최종 검증

```bash
latest_full_record="$(ls -1t agent-test/runs/*-proto-socket-performance-full.md | head -1)" && printf '%s\n' "$latest_full_record" && test -f "$latest_full_record" && sed -n '1,32p' "$latest_full_record"
git diff --check
git diff -- README.md agent-roadmap/ROADMAP.md
rg --sort path -n "proto-socket-performance-full|regression|full baseline|잠정 완료" README.md agent-roadmap/ROADMAP.md
```

모든 구현/검증 완료 후 반드시 `CODE_REVIEW-*-G??.md`의 구현 에이전트 소유 섹션을 채운다. 이 파일 작성이 구현의 마지막 단계다.
