Final Review Report

모든 review mode에서 같은 report shape로 수렴한다. report format은 references/final-report.md를 따른다. repository/scoped/deep review의 primary readable output은 report.html이다.

Workflow

1. confirmed finding과 rejected/deferred candidate를 구분한다.
2. architecture/system design finding과 code/behavior finding을 분리한다.
3. 각 section 안에서 final priority 순서로 finding을 정렬한다: P0, P1, P2, P3, Info.
4. 각 finding에 evidence, validation, impact path, counterevidence, recommendation을 채운다.
5. wibaek-review-scan 또는 wibaek-review-deep-scan이면 architecture/system design review outcome을 반드시 쓴다.
6. rejected/deferred surface는 Reviewed Surfaces에 남긴다.
7. Codex runtime이 code review directive를 지원할 때만 actionable finding마다 ::code-comment directive를 만든다. 지원하지 않으면 normal markdown finding과 file/line reference를 출력한다.
8. references/artifact-paths.md의 final output path에 report.md를 쓴다. 사용자가 명시적으로 artifact 생성을 금지하지 않는 한 콘솔 출력만으로 끝내지 않는다.
9. script가 사용 가능하면 uv run python <skill_dir>/scripts/validate_review_report.py --report-md <review_dir>/report.md로 report shape를 검증한다. 실패하면 <review_dir>/report_validation.md에 output을 남기고, missing section/field를 채운 뒤 다시 검증한다.
10. script와 template이 사용 가능하면 uv run python <skill_dir>/scripts/render_review_report_html.py --report-md <review_dir>/report.md --report-html <review_dir>/report.html --title "<repo_or_target> Engineering Review"로 HTML report를 만든다.
11. final response에는 report.html, report.md, finding count, 검증 제한만 짧게 쓰고, 사용자가 요청하지 않는 한 전체 report를 다시 붙여 넣지 않는다.