From b7d131045993b9b9572f6e27235ca751c65aeb0e Mon Sep 17 00:00:00 2001 From: DongHyeonka Date: Sat, 7 Nov 2026 00:24:58 +0900 Subject: [PATCH] =?UTF-8?q?fix(scripts):=20=EC=9D=B4=EB=A0=A5=20=EA=B2=80?= =?UTF-8?q?=EC=82=AC=EA=B0=80=20=EC=95=9E=EB=A7=90=20=EC=97=86=EB=8A=94=20?= =?UTF-8?q?=EB=B2=88=ED=98=B8=20=EB=AA=A9=EB=A1=9D=C2=B7=EB=A6=AC=EB=B7=B0?= =?UTF-8?q?=20=EC=98=81=EC=97=AD=C2=B7=EB=AC=B6=EC=9D=8C=20=EB=B2=88?= =?UTF-8?q?=ED=98=B8=EB=A5=BC=20=EC=9E=A1=EB=8A=94=EB=8B=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 문제: check-work-docs.py --history는 리뷰·라운드 낱말 바로 뒤의 NN-NN만 발견 번호로 본다. 그래서 앞말 없이 나열한 "(05-01, 04-01, 06-01)", "리뷰 01 영역 5.2절", "sample P30 결정"을 놓친다. 2026-11-07 docs/manual 이력 걷어내기에서 검사가 찾은 16줄을 고친 뒤 docs-writing.md 9절대로 grep으로 다시 읽으니 이 꼴 3줄이 더 있었다. 고른 방법: 패턴 셋을 더한다. - 쉼표+공백이나 가운뎃점으로 이은 NN-NN 둘 이상. 콜론 뒤 줄 범위 ("Foo.java:10-12,20-24")와 공백 없는 쉼표 범위는 잡지 않는다 - "리뷰 NN 영역", "NN 영역 N.N절" - 2026-09-25 리뷰 후속 묶음 번호 P10~P49와 "W3-P30" 꼴 버린 대안: - 홀로 선 NN-NN 하나까지 잡기. 장 번호·범위 같은 보통 숫자가 걸린다 - P 뒤 두 자리를 모두 잡기. P95·P99 같은 백분위수가 걸린다 위험·한계: 검사는 여전히 아는 꼴만 잡는다. P1~P9 묶음 번호는 우선순위 P0~P3과 겹쳐 잡지 않는다. 문서가 자기 목록에 P10~P49 번호를 붙이면 이력이 아니어도 잡는다(docs/study/graphql-walkthrough.ko.md의 할 일 번호 P10·P11). 지금 검사 대상인 docs/work 본문과 docs/manual에는 그런 줄이 없다. 이 커밋만 있으면 --history docs/manual이 19줄, rc=1이다. 다음 커밋이 그 19줄을 걷어낸다. 기본 모드(docs/work 본문, 루트 CLAUDE.md)는 0줄 그대로다. 검증(desktop worktree, 다음 커밋까지 얹은 트리 8ff82a67과 같은 스크립트): - 기준 커밋 73d39212의 docs/manual: 옛 스크립트 16줄, 새 스크립트 19줄. 더 잡은 3줄은 03-placement.md:40·:54, 05-idempotency.md:93이다 - 오탐 시험 14줄: 보통 문장 8줄(p95·P99, 콜론 뒤 줄 범위, 날짜 쌍, 홀로 선 번호, 장 번호)은 안 잡고 이력 6줄은 잡았다 - 노트북에서 docs/reviews 밖 *.md에 새 패턴을 돌려 걸린 65줄을 읽었다. 위 할 일 번호 4줄 말고는 모두 실제 이력 번호였다 - 기본 모드 rc=0, 본문 이력 0줄 --- scripts/check-work-docs.py | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/scripts/check-work-docs.py b/scripts/check-work-docs.py index ed88b94b..1789f6db 100755 --- a/scripts/check-work-docs.py +++ b/scripts/check-work-docs.py @@ -87,6 +87,15 @@ HISTORY_PATTERNS = [ ("finding number after a review or round word (리뷰 02-01)", re.compile(r"(?:리뷰|라운드|(?