nomadcode/agent-ops/skills/common/code-review/templates/user-review-template.md

User Review Required - {task_name}

요청 일시

{YYYY-MM-DD or ISO-8601}

상태

USER_REVIEW

사유

• 유형: {loop-limit, environment-blocked, or implementation-blocked}
• 현재 리뷰 회차: {review-number}
• 최종 판정: {WARN or FAIL}
• 요약: {why automatic follow-up stopped}

루프 이력

Plan	Review	Verdict	메모
{plan-log-0}	{code-review-log-0}	{PASS/WARN/FAIL/unknown}	{main issue or blocking reason}
{current-archived-plan-log}	{current-archived-review-log}	{WARN/FAIL}	{main issue or blocking reason}

차단 근거

• 문제: {review finding summary}
• 현재 archive plan: {current-archived-plan-log}
• 현재 archive review: {current-archived-review-log}
• 검증 명령: {command or 없음}
• 실제 출력: {stdout/stderr excerpt or saved output path}
• 차단 판단 근거: {why this needs user decision or is outside repo-fixable scope, or 없음}

사용자 결정 필요

• 자동 follow-up plan/review를 계속 진행한다.
• 계획을 재작성한다.
• 테스트 환경, secret, 외부 서비스, SDK, 장비 조건을 준비한 뒤 재시도한다.
• 작업 범위를 줄이거나 보류/폐기한다.

재개 조건

• {what must be true before the next plan/review loop should start}

다음 실행 힌트

• {suggested command, task path, or user decision needed to resume}

종료 규칙

• 사용자가 이 stop state를 완료/PASS로 해소하면 USER_REVIEW.md를 해소 상태로 갱신하고, agent-ops/skills/common/code-review/templates/complete-log-template.md 기준 complete.log를 작성한 뒤 task directory를 archive로 이동한다.
• 새 구현이 필요하면 plan 스킬이 USER_REVIEW.md를 user_review_N.log로 아카이브한 뒤 새 PLAN-*-G??.md / CODE_REVIEW-*-G??.md를 작성한다.