<!-- task=final_full_validation/02+01_nightly_full_performance plan=1 tag=REVIEW_TEST -->

# Plan - REVIEW_TEST Full Performance Regression WARN Follow-up

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

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

## Archive Evidence Snapshot

- 이전 plan: `agent-task/final_full_validation/02+01_nightly_full_performance/plan_cloud_G07_0.log`
- 이전 review: `agent-task/final_full_validation/02+01_nightly_full_performance/code_review_cloud_G07_0.log`
- 이전 verdict: WARN
- 이슈 요약:
  - Suggested: 최신 full performance record `agent-test/runs/20260618-144710-proto-socket-performance-full.md`가 `overall_result: WARN`, `regression_result: WARN`으로 종료됐다.
  - 구성요소는 same-language, cross-language, typescript-gateway 모두 PASS였지만 regression comparison은 `compared rows: 336`, `missing baseline rows: 3`, `warning rows: 96`이었다.
  - `--fail-on-regression` 때문에 command exit code는 5였고, README/ROADMAP은 최신 full baseline PASS로 갱신되지 않았다.
- 영향 파일:
  - `README.md`: 새 full comparison이 PASS일 때만 최신 full baseline record/ref/regression 결과로 갱신한다.
  - `agent-roadmap/ROADMAP.md`: 새 full comparison이 PASS일 때만 잠정 완료 판단 근거를 최신 full baseline PASS로 보강한다.
  - `agent-task/final_full_validation/02+01_nightly_full_performance/CODE_REVIEW-cloud-G07.md`: rerun 결과, record path, regression rows, 문서 갱신 여부를 기록한다.
- 검증 근거:
  - baseline: `agent-test/runs/20260614-123328-proto-socket-performance-full.md`
  - WARN record: `agent-test/runs/20260618-144710-proto-socket-performance-full.md`
  - 주요 previous output: `code_review_cloud_G07_0.log`의 `검증 결과`와 `코드리뷰 결과`
- 좁은 archive 재확인 허용 경로:
  - `agent-task/final_full_validation/02+01_nightly_full_performance/plan_cloud_G07_0.log`
  - `agent-task/final_full_validation/02+01_nightly_full_performance/code_review_cloud_G07_0.log`

## 배경

이 작업은 장시간 benchmark-style terminal task다. 이전 실행은 20:00 이후 시작했고 baseline 파일도 존재했지만 regression gate에서 WARN이 발생했다. stability hard gate는 구성요소 summary 기준 모두 PASS였으므로, 후속 범위는 full performance comparison 재실행과 결과 해석으로 제한한다.

## 범위 결정 근거

- runner 스크립트, 프로토콜 구현, benchmark harness 수정은 제외한다. 새 run이 반복해서 WARN을 내고 원인이 코드 변경으로 좁혀질 때만 별도 작업으로 분리한다.
- full functional matrix 재실행은 제외한다. predecessor `01_daytime_functional_preflight`에서 이미 PASS 완료됐다.
- tracked docs는 새 full comparison이 PASS일 때만 최신 full baseline PASS로 갱신한다. WARN/FAIL이면 tracked docs를 PASS로 갱신하지 않고 review stub에 record와 regression evidence를 남긴다.
- `agent-test/runs/**` 결과 파일은 ignored local evidence로만 사용한다.

## 빌드 등급

- build lane: `cloud-G07`
- review lane: `cloud-G07`
- 근거: long-running benchmark-style terminal task, regression evidence diagnosis, large local result record 해석이 핵심이다.

## 구현 체크리스트

- [ ] archived 이전 review `agent-task/final_full_validation/02+01_nightly_full_performance/code_review_cloud_G07_0.log`와 plan `agent-task/final_full_validation/02+01_nightly_full_performance/plan_cloud_G07_0.log`가 존재하는지 확인한다.
- [ ] `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 파일 존재를 확인한다.
- [ ] `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`을 한 번 실행한다.
- [ ] command가 PASS이면 최신 full performance record의 `overall_result: PASS`, `regression_result: PASS`, same-language/cross-language/typescript-gateway PASS를 확인하고 `README.md`와 `agent-roadmap/ROADMAP.md`에 최신 full baseline 근거를 반영한다.
- [ ] command가 WARN/FAIL/non-zero이면 tracked 문서를 PASS로 갱신하지 말고 latest record path, component summary, `warning rows`, 대표 WARN rows 또는 FAIL/BLOCKED 사유를 `CODE_REVIEW-cloud-G07.md`에 기록한다.
- [ ] `git diff --check`와 `rg --sort path -n "proto-socket-performance-full|regression|full baseline|잠정 완료" README.md agent-roadmap/ROADMAP.md`를 실행한다.
- [ ] CODE_REVIEW-*-G??.md의 구현 에이전트 소유 섹션을 실제 구현 내용과 검증 출력으로 채운다. 이 항목이 완료되기 전에는 구현이 완료된 것이 아니다.

### [REVIEW_TEST-1] full performance regression WARN 재실행 및 문서 반영 여부 결정

#### 문제

이전 full performance comparison은 stability 구성요소가 모두 PASS였지만 regression comparison이 WARN이었다. 최신 full baseline PASS 근거로 닫으려면 같은 baseline 기준으로 regression WARN이 사라지는지 확인하거나, WARN이 반복되는 경우 PASS 문서 갱신을 하지 않았다는 근거를 남겨야 한다.

#### 해결 방법

1. 20:00 이후 조건과 baseline 파일을 확인한다.
2. 기존 full baseline record를 baseline으로 지정하고 `--fail-on-regression`을 켠 full comparison을 한 번 재실행한다.
3. PASS이면 README/ROADMAP에 최신 full record, ref, regression PASS 결과를 반영한다.
4. WARN/FAIL이면 README/ROADMAP을 PASS로 갱신하지 않고 review stub에 record, summary, 대표 WARN/FAIL 근거를 남긴다.

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

- [ ] `README.md`: PASS일 때만 최신 full performance record/ref/regression 결과 반영.
- [ ] `agent-roadmap/ROADMAP.md`: PASS일 때만 잠정 완료 판단에 최신 full baseline PASS 근거 반영.
- [ ] `CODE_REVIEW-cloud-G07.md`: date, command, record path, component summary, regression result, 문서 갱신 여부 기록.

#### 테스트 작성

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

#### 중간 검증

```bash
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 exit 0. 결과 record `agent-test/runs/*-proto-socket-performance-full.md`에 `overall_result: PASS`, `regression_result: PASS`, same-language/cross-language/typescript-gateway PASS가 기록된다. WARN/FAIL이면 PASS 문서 갱신을 하지 않고 actual stdout/stderr와 record 근거를 남긴다.

## 수정 파일 요약

| 파일 | 항목 |
|---|---|
| `README.md` | REVIEW_TEST-1 |
| `agent-roadmap/ROADMAP.md` | REVIEW_TEST-1 |
| `agent-task/final_full_validation/02+01_nightly_full_performance/CODE_REVIEW-cloud-G07.md` | 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"
git diff --check
rg --sort path -n "proto-socket-performance-full|regression|full baseline|잠정 완료" README.md agent-roadmap/ROADMAP.md
```

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