Task #13: PR 템플릿 검증 섹션 구조 강화

[postmelee]

요약

• 대상 타스크: PR 템플릿 검증 섹션 구조 강화 #13 PR 템플릿 검증 섹션 구조 강화
• 왜: 기존 PR 검증 섹션이 실행 명령 나열에 가까워 리뷰어가 검증 목적, 결과, 근거, 한계를 빠르게 판단하기 어려웠습니다.
• 무엇: PR 템플릿의 검증 목차를 주제별 구조로 강화하고, PR 작성 매뉴얼과 task-final-report SKILL, README/workflow 안내를 동기화했습니다.
• 리뷰 포인트: 새 검증 섹션의 표 구조가 PR 본문 가독성과 재현 가능성 사이의 균형을 잘 맞추는지 확인이 필요합니다.

변경 내역

• Stage 1 (c043e32): PR 템플릿 두 벌의 검증 섹션을 자동 검증, 수동/시나리오 검증, CI/원격 검증, 검증 한계 구조로 개편했습니다.
• Stage 2 (059b5f5): pr_process_guide.md와 task-final-report/SKILL.md에 새 검증 작성 기준을 반영했습니다.
• Stage 3 (a77660e): README와 task_workflow_guide.md의 상위 안내를 동기화했습니다.

영향 영역

영역	변경	리뷰 포인트
PR 템플릿	검증 하위 목차와 표 구조 추가	실행자가 실제 결과와 근거를 충분히 쓰도록 유도하는지
PR 작성 절차	매뉴얼과 task-final-report SKILL 갱신	PR 생성 절차가 템플릿 구조와 충돌하지 않는지
사용자 안내	README와 workflow guide 문구 보정	상위 안내가 과하게 길어지지 않았는지

작업 문서

• 수행 계획서: task_m020_13.md
• 구현 계획서: task_m020_13_impl.md
• 최종 보고서: task_m020_13_report.md

핵심 리뷰 포인트

• 검증 섹션을 네 하위 목차로 나누면서도, 해당 없는 하위 섹션은 삭제하도록 안내해 PR 본문 과밀화를 줄였습니다.
• 실행하지 않은 검증은 표에 남기지 않고 검증 한계 또는 남은 리스크로 분리하도록 템플릿, 매뉴얼, SKILL에 같은 기준을 넣었습니다.
• templates/.github/pull_request_template.md의 {REPO_SLUG} placeholder는 그대로 보존했습니다.

검증

자동 검증

주제	검증 방법	결과	근거
PR 템플릿 목차	grep -nE '### 자동 검증|### 수동/시나리오 검증|### CI/원격 검증|### 검증 한계' .github/pull_request_template.md templates/.github/pull_request_template.md	OK	두 템플릿 모두 네 하위 섹션 확인
매뉴얼/SKILL 동기화	grep -nE '자동 검증|수동/시나리오 검증|CI/원격 검증|검증 한계' templates/mydocs/manual/pr_process_guide.md templates/mydocs/skills/task-final-report/SKILL.md	OK	PR 작성 규칙과 final-report SKILL 모두 새 구조 확인
README 안내	grep -nE 'task-final-report|Open PR|PR 본문|검증 결과|검증 근거' README.md	OK	task-final-report와 검증 결과·근거 중심 PR 설명 확인
workflow 안내	grep -nE 'PR 본문|pull_request_template|검증 한계|검증 결과|SKILL 호출 표시' templates/mydocs/manual/task_workflow_guide.md	OK	PR 본문 검증 구조와 SKILL 호출 안내 연결 확인
placeholder 보존	grep -nF '{REPO_SLUG}' templates/.github/pull_request_template.md	OK	{REPO_SLUG} 4곳 보존
템플릿 정규화 비교	ruby -e 'a=File.read(".github/pull_request_template.md"); b=File.read("templates/.github/pull_request_template.md").gsub("{REPO_SLUG}", "postmelee/hyper-waterfall"); abort("template mismatch beyond REPO_SLUG") unless a == b; puts "OK: templates match after REPO_SLUG normalization"'	OK	{REPO_SLUG} 정규화 후 두 템플릿 동일
문서 형식	git diff --check origin/main..HEAD	OK	whitespace 경고 없음

수동/시나리오 검증

시나리오	확인 절차	결과	자료
PR 본문 가독성	이 PR 본문을 새 검증 구조로 작성해 자동 검증과 검증 한계를 분리해 확인	OK	현재 PR 본문

검증 한계

• PR 생성 전이라 GitHub Checks는 아직 실행 전입니다. PR 생성 후 Checks 결과에서 원격 검증을 확인합니다.

관련 이슈

• 참고 PR: Task #7: GitHub Release + manifest + migration guide 도입 #12
• 참고 PR: Task #598: 본문 각주 마커 이동 및 삭제 edwardkim/rhwp#642

후속 이슈 제안

• 없음.

남은 리스크

• 없음.