From d04de2e85f8f775d1585a480b04f18004308b8c5 Mon Sep 17 00:00:00 2001 From: DongHyeonka Date: Fri, 6 Nov 2026 20:00:49 +0900 Subject: [PATCH] =?UTF-8?q?docs(work):=20=ED=99=95=EC=9D=B8=20=EB=A6=AC?= =?UTF-8?q?=EB=B7=B0=20=EC=83=81=ED=95=9C=EC=9D=84=20=EB=84=98=EB=8A=94=20?= =?UTF-8?q?=ED=95=9C=20=EC=BB=A4=EB=B0=8B=EC=9D=80=20=EC=98=81=EC=97=AD=20?= =?UTF-8?q?pathspec=EC=9C=BC=EB=A1=9C=20=EB=82=98=EB=88=88=EB=8B=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 문제: improve.md 4.4절은 확인 리뷰 하나가 보는 수정 diff를 추가 1,500줄로 묶고, 넘으면 "묶음 커밋별로" 나누라고만 했다. 여러 영역 묶음을 한 커밋에 합친 수정(예: 영역 묶음 넷을 합친 +5,143줄 커밋)은 커밋으로 나눌 수 없어, 그 확인 리뷰를 맡은 세션이 어떻게 나눌지 답이 없었다. 고른 방법: 커밋이 따로 있으면 커밋별로, 한 커밋에 섞였으면 영역 pathspec별로 `git diff --shortstat .. -- `를 재서 각각 상한 안이 되게 나눈다. 지난 확인 리뷰도 영역 4개를 pathspec으로 나눠 봤다. 위험·한계: pathspec 하나가 그 자체로 1,500줄을 넘으면 더 나눌 기준은 아직 없다. 그때는 그 영역을 맡은 리뷰를 둘로 나누거나 맡긴 쪽에 묻는다. 검증 - python3 scripts/check-work-docs.py: rc=0, improve.md 132/150 --- docs/work/improve.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/work/improve.md b/docs/work/improve.md index 954ea146..39f3a8e2 100644 --- a/docs/work/improve.md +++ b/docs/work/improve.md @@ -68,7 +68,7 @@ ### 4.4 수정 묶음의 크기 - 묶음 하나는 리뷰 영역 하나 안이고 발견 8건 이하다. 묶음마다 커밋 하나다. -- 확인 리뷰 하나가 보는 수정 diff는 추가 1,500줄 이하다(`git diff --shortstat ..`, 테스트 포함, lockfile·스냅숏 같은 생성 파일 제외). 넘으면 묶음 커밋별로 나눠 따로 확인 리뷰한다. +- 확인 리뷰 하나가 보는 수정 diff는 추가 1,500줄 이하다(`git diff --shortstat ..`, 테스트 포함, lockfile·스냅숏 같은 생성 파일 제외). 넘으면 확인 리뷰를 나눈다. 묶음 커밋이 따로 있으면 커밋별로, 한 커밋에 여러 영역이 섞였으면 영역 pathspec별로(`git diff --shortstat .. -- `) 나눠 각각 상한 안이 되게 한다. - 왜: 지난 수정 라운드에서 추가 줄이 2,000줄 아래면 다음 확인 리뷰 발견이 9건 이하였고, 5,000줄을 넘으면 19건 이상이었다([evidence.md](evidence.md) 「수정 묶음 크기」). 상한 값은 판단이다. 라운드당 새 결함 수로 다시 맞춘다. - 묶음을 합친 트리는 따로 검증한다([reference/gates.md](reference/gates.md) 「라운드 끝」). 두 묶음의 수정은 한 트리에서 처음 만날 때 새 결함을 만든다.