nexo/agent-task/m-runtime-image-validation/03+01,02_evidence_matrix_closeout/PLAN-cloud-G07.md

Plan - Evidence Matrix Closeout

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

이 subtask는 01_repo_app_validation과 02_consumer_project_validation이 PASS되어 complete.log를 남긴 뒤 시작한다. 완료 evidence가 부족하면 roadmap을 [검토중]으로 올리지 말고 blocker를 review stub에 기록한다.

배경

Milestone closeout은 evidence matrix와 roadmap 체크박스가 같은 사실을 말해야 한다. 현재 image/runtime tasks만 [x]이고 app/consumer/evidence tasks는 아직 열려 있다.

사용자 리뷰 요청 흐름

남은 SKIP/BLOCKED가 Milestone 범위 제외인지 사용자 결정이 필요하면 사용자 리뷰 요청에 남긴다.

분석 결과

읽은 파일

• agent-roadmap/phase/product-foundation/milestones/runtime-image-validation.md
• docs/runtime-image-validation.md
• agent-roadmap/current.md
• agent-roadmap/phase/product-foundation/PHASE.md
• agent-ops/rules/common/rules-roadmap.md

테스트 커버리지 공백

• closeout 자체는 문서/roadmap consistency 작업이다.
• app/consumer verification output은 predecessor task의 complete.log와 updated docs를 source of truth로 삼는다.

심볼 참조

• none. 문서/roadmap update only.

분할 판단

• This subtask is dependent: 03+01,02_evidence_matrix_closeout waits for 01_repo_app_validation and 02_consumer_project_validation.
• It is separated because roadmap status transition should happen only after both evidence-producing subtasks complete.

범위 결정 근거

• 이 작업은 docs/runtime-image-validation.md와 current Milestone roadmap만 갱신한다.
• archive 이동은 사용자 완료 승인 전에는 수행하지 않는다.
• agent-roadmap/archive/**는 읽지 않는다.

빌드 등급

• build=cloud-G07, review=cloud-G07: roadmap state transition depends on external evidence from split tasks and lock/check consistency.

구현 체크리스트

• [VALIDATION-1] predecessor complete.log와 docs evidence를 확인해 app/consumer tasks 완료 여부를 판정한다.
• [VALIDATION-2] docs/runtime-image-validation.md matrix에서 의도치 않은 SKIP/BLOCKED가 없는지 정리한다.
• [VALIDATION-3] Milestone 기능 체크박스를 evidence 기준으로 갱신하고, 모두 충족되면 [검토중]과 완료 리뷰 요청을 남긴다.
• [VALIDATION-4] roadmap/current/phase path와 workspace lock 상태를 검증한다.
• CODE_REVIEW-*-G??.md의 구현 에이전트 소유 섹션을 실제 구현 내용과 검증 출력으로 채운다. 이 항목이 완료되기 전에는 구현이 완료된 것이 아니다.

[VALIDATION-1] Predecessor Evidence Gate

문제: roadmap closeout이 evidence-producing subtasks보다 먼저 실행되면 완료 판정이 추정이 된다.

해결 방법: agent-task/archive/YYYY/MM/m-runtime-image-validation/01_repo_app_validation/complete.log와 02_consumer_project_validation/complete.log를 확인한다. 둘 중 하나가 없으면 이 task를 진행하지 않는다.

수정 파일 및 체크리스트:

• 변경 없음 또는 blocker 기록

테스트 작성: skip. File-state gate다.

중간 검증:

find agent-task/archive -path '*/m-runtime-image-validation/01_repo_app_validation/complete.log' -o -path '*/m-runtime-image-validation/02_consumer_project_validation/complete.log' | sort

[VALIDATION-2] Evidence Matrix Normalize

문제: docs/runtime-image-validation.md에 남은 SKIP/BLOCKED가 있으면 Milestone 완료와 충돌할 수 있다.

해결 방법: SKIP는 실제 PASS, 사용자 승인된 범위 제외, 또는 blocker 중 하나로 정리한다. blocker면 [검토중]으로 전환하지 않는다.

수정 파일 및 체크리스트:

• docs/runtime-image-validation.md

테스트 작성: skip. Documentation consistency.

중간 검증:

rg --sort path -n "SKIP|BLOCKED|TODO|Follow-up" docs/runtime-image-validation.md

[VALIDATION-3] Roadmap Completion Update

문제: Milestone repo-smoke, consumer-projects, evidence-matrix tasks가 unchecked 상태다.

해결 방법: docs evidence와 predecessor logs로 각 task를 [x] 처리한다. 모든 기능 task가 [x]이면 상태를 [검토중]으로 바꾸고 완료 리뷰를 요청됨으로 갱신한다. 사용자 archive 승인은 남겨둔다.

수정 파일 및 체크리스트:

• agent-roadmap/phase/product-foundation/milestones/runtime-image-validation.md

테스트 작성: skip. Roadmap state update.

중간 검증:

rg --sort path -n "^- \\[[ x]\\] \\[[^]]+\\]|^\\[검토중\\]|완료 리뷰|상태:" agent-roadmap/phase/product-foundation/milestones/runtime-image-validation.md

[VALIDATION-4] Roadmap/Lock Verification

문제: roadmap update는 active path와 workspace lock consistency를 유지해야 한다.

해결 방법: current paths, phase milestone path, lock checker, whitespace를 검증한다.

수정 파일 및 체크리스트:

• 필요 시 agent-roadmap/current.md
• 필요 시 agent-roadmap/phase/product-foundation/PHASE.md

테스트 작성: skip. Roadmap structural validation.

중간 검증:

test -f agent-roadmap/current.md
test -f agent-roadmap/phase/product-foundation/milestones/runtime-image-validation.md
agent-ops/bin/roadmap-dependency-checker.sh --find-milestone "nexo:agent-roadmap/phase/product-foundation/milestones/runtime-image-validation.md" both ../.agent-roadmap-sync/locks.yaml
git diff --check

수정 파일 요약

파일	항목
docs/runtime-image-validation.md	VALIDATION-2
agent-roadmap/phase/product-foundation/milestones/runtime-image-validation.md	VALIDATION-3
agent-roadmap/current.md	VALIDATION-4, only if active window needs sync
agent-roadmap/phase/product-foundation/PHASE.md	VALIDATION-4, only if status/flow needs sync

최종 검증

bin/test
bin/lint
git diff --check

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