iop/agent-ops/skills/common/code-review/templates/user-review-template.md
toki e8df747b5f docs(agent-ops): agent-ops 스킬·룰·라우터 갱신
- router: refine-local-plans 라우팅 추가, plan/review 역할 경계 명시
- plan: review stub 템플릿 및 SKILL.md 보강
- code-review: SKILL.md, agent yaml, user-review 템플릿 갱신
- finalize-task-routing: SKILL.md 및 agent yaml 갱신
- _templates: implementation-user-review-request-section 수정
- rules/common/rules.md, AGENTS.md: archive 접근 예외 확장
2026-07-22 18:10:26 +09:00

50 lines
2.1 KiB
Markdown

# User Review Required - {task_name}
## 요청 일시
{YYYY-MM-DD or ISO-8601}
## 상태
USER_REVIEW
## 사유
- 유형: milestone-lock
- 연결 대상: {agent-roadmap/phase/<phase>/milestones/<milestone>.md}
- 현재 리뷰 회차: {review-number}
- 최종 판정: {WARN or FAIL}
- 요약: {Milestone 구현 잠금 항목이 실구현을 차단한 이유}
## 루프 이력
| 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}
- 차단 판단 근거: {연결 대상의 Milestone 결정 필요 항목과 일치하는 근거}
## 연결 결정 필요
- [ ] {Milestone `구현 잠금 > 결정 필요`에 기록된 결정 항목}
## 재개 조건
- {위 결정이 Milestone 구현 잠금에 반영되고, 필요한 경우 해당 USER_REVIEW.md가 user_review_N.log로 해결되어야 한다}
## 다음 실행 힌트
- {resolve-review 또는 update-roadmap으로 반영할 대상 경로와 후속 plan/review 재개 조건}
## 종료 규칙
- 연결 결정과 evidence가 이 stop state를 완료/PASS로 해소하면 `USER_REVIEW.md`를 해소 상태로 갱신하고, `agent-ops/skills/common/code-review/templates/complete-log-template.md` 기준 `complete.log`를 작성한 뒤 task directory를 archive로 이동한다.
- 새 구현이 필요하면 review가 해소 결과와 `kind: user-review-resolution`, `target: plan`, task/plan, 예상 user-review archive, 기존 loop evidence, 금지 model identity를 `NEXT_STATE.md`에 기록한 뒤 `USER_REVIEW.md`를 아카이브한다. 다른 Plan 모델이 새 pair를 작성하면 review가 검증하고 pending 파일 제거를 마지막 파일 변경으로 수행한다.