iop/agent-ops/skills/common/plan/templates/review-stub-template.md

Code Review Reference - {TAG}

[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. This implementation model must differ from the plan and review models. Fill implementation-owned sections, report review-ready, and stop. Do not review or start another agent. If a selected Milestone 구현 잠금 > 결정 필요 item blocks implementation, record it in 사용자 리뷰 요청. Record other blockers in the implementation-owned evidence; they are not user-facing stopping states. A later review model consumes this file state. Finalization (코드리뷰 결과, log rename, complete.log, archive moves, 코드리뷰 전용 체크리스트) belongs only to the review model. review-ready ends the current invocation. USER_REVIEW.md stops the loop for a decision; complete.log ends the task. Follow the ownership table at the bottom of this file for which sections you own.

개요

date={date} task={task_name}, plan={plan_number}, tag={TAG}

역할 모델

• Plan: {plan_model_identity}
• Implementation: pending
• Review: pending

Runtime만 최초 역할 시작 시 해당 identity를 기록한다. 기록된 identity는 이 pair에서 변경하지 않으며, 재시도는 같은 model identity를 사용한다. 세 identity는 모두 달라야 한다.

{roadmap_targets_or_omit} {archive_evidence_snapshot_or_omit}

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

[REVIEW AGENT ONLY] 아래 종결 절차는 코드리뷰 에이전트 전용이다. 구현 에이전트는 이 섹션을 실행하지 않는다. Review 모델은 plan/implementation 모델과 달라야 한다. product source/test를 수정하거나 plan을 실행하지 않는다. Review는 후속 PLAN/CODE_REVIEW pair, USER_REVIEW.md, complete.log 중 정확히 하나를 남긴 뒤 종료한다. archive log만 남기고 종료하지 않는다.

각 항목의 구현을 실제 소스 파일과 대조하고, 검증 결과 섹션의 출력이 코드와 일치하는지 확인하세요. 리뷰 완료는 아래 순서까지 끝난 상태를 의미합니다.

1. 판정을 append한다.
2. CODE_REVIEW-{review_lane}-{review_grade}.md → code_review_{review_lane}_{review_grade}_{review_log_number}.log, PLAN-{build_lane}-{build_grade}.md → plan_{build_lane}_{build_grade}_{plan_log_number}.log로 아카이브한다.
3. PASS이면 complete.log 작성 후 task를 archive한다. WARN/FAIL이면 USER_REVIEW.md를 쓰거나 다른 Plan 모델을 호출해 후속 pair를 만든다.
4. PASS이고 task group이 m-<milestone-slug>이면 완료 이벤트 메타데이터를 준비한다. roadmap 상태 체크와 update-roadmap 호출은 런타임 책임이다.
5. 적용 가능한 코드리뷰 전용 체크리스트 항목을 최종 .log 위치에서 체크한다.

---

구현 항목별 완료 여부

항목	완료 여부
{implementation_completion_rows}

구현 체크리스트

{implementation_checklist}

{agent_ui_completion_or_omit}

코드리뷰 전용 체크리스트

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

• 코드리뷰 결과에 PASS, WARN, FAIL 중 하나의 판정을 append한다.
• 판정과 차원별 평가, Required/Suggested/Nit 분류가 서로 일치한다.
• Runtime이 기록한 Plan/Implementation/Review model identity가 모두 다르다.
• active CODE_REVIEW-*-G??.md를 code_review_{review_lane}_{review_grade}_{review_log_number}.log로 아카이브한다.
• active PLAN-*-G??.md를 plan_{build_lane}_{build_grade}_{plan_log_number}.log로 아카이브한다.
• .gitignore의 Agent-Ops 관리 block이 agent-task/**/*.md와 agent-task/**/*.log를 unignore하고 agent-roadmap/current.md를 ignore하는지 확인한다.
• archive 전에 NEXT_STATE.md를 기록하고 branch finalization이 끝날 때까지 유지한다.
• PASS이면 agent-ops/skills/common/code-review/templates/complete-log-template.md 기준으로 complete.log를 작성하고 active .md 파일을 남기지 않는다.
• PASS이면 active task 디렉터리 agent-task/{task_name}/를 agent-task/archive/YYYY/MM/{task_name}/로 이동하고 최종 archive 경로에서 이 체크리스트를 갱신한다.
• PASS이고 task group이 m-<milestone-slug>이면 런타임이 읽을 완료 이벤트 메타데이터를 준비하고, roadmap 수정이나 update-roadmap 직접 호출을 하지 않는다.
• PASS split 작업이면 이동 후 빈 active parent agent-task/{task_group}/를 제거하거나, 남은 sibling/file이 있어 유지했다고 확인한다.
• WARN/FAIL이고 user-review gate가 아니면 active pair를 archive하고 다른 Plan 모델이 같은 task path에 후속 pair를 쓰게 한 뒤 implementation-ready 보고 정보를 준비한다. Review 모델은 직접 plan이나 구현을 하지 않는다.
• 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가 연결된 Milestone 결정으로 완료/PASS 해소되면 USER_REVIEW.md를 해소 상태로 갱신하고 complete.log를 작성한 뒤 task directory를 archive로 이동한다.
• USER_REVIEW 해소가 새 구현을 요구하면 USER_REVIEW.md를 archive하고 다른 Plan 모델이 후속 pair를 쓰게 한 뒤 implementation-ready 보고 정보를 준비한다.

계획 대비 변경 사항

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

주요 설계 결정

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

{implementation_user_review_request_section}

리뷰어를 위한 체크포인트

{review_checkpoints}

검증 결과

{verification_result_sections}

---

[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-only sections unchanged, report review-ready, and stop. Do not execute code-review or start another agent.

섹션 소유권

Section	Owner	Note
Header comment, 개요, 리뷰 에이전트 지시	Fixed	Implementation model fills its sections, reports review-ready, and stops
역할 모델	Mixed	Plan identity is fixed; runtime replaces each pending role once. Filled identities are immutable, and duplicate identity blocks that role
Roadmap Targets	Fixed at stub creation from plan when present	Implementing agent must not modify; code-review copies it into complete.log as Roadmap Completion only on PASS
Archive Evidence Snapshot	Fixed at stub creation from plan when present	Implementing agent uses it as default prior-loop context; read only the specific archive files cited there when more detail is required
Agent UI Completion	Mixed	Present only for plan-required agent-ui code work; implementing agent fills actual evidence, review agent applies 구현됨 status/evidence update on PASS and copies the section into complete.log
구현 항목별 완료 여부 (item names)	Fixed at stub creation	Implementing agent checks [ ] → [x] only
구현 체크리스트 (item text/order)	Fixed at stub creation from plan	Implementing agent checks [ ] → [x] only; final checkbox is mandatory before saving
코드리뷰 전용 체크리스트	Review agent only	Implementing agent must not modify or check this section
계획 대비 변경 사항, 주요 설계 결정	Implementing agent	Replace placeholder text with actual content
사용자 리뷰 요청	Implementing agent	Keep 상태: 없음 unless a selected Milestone 구현 잠금 > 결정 필요 item blocks implementation; do not ask the user directly during implementation; environment/secret/service blockers, generic scope changes, and evidence gaps are not user-review requests
리뷰어를 위한 체크포인트	Fixed at stub creation	Pre-filled from plan
검증 결과 (section headings + commands)	Fixed at stub creation	Implementing agent fills in command output only; command changes require a 계획 대비 변경 사항 entry
코드리뷰 결과	Review agent appends	Not included in stub