Files
clean-architecture-backend-…/docs/work/evidence.md
T
DongHyeonka 4fc586478c docs(claude): 진입 문서에 단독 번호로 남은 이력 ID를 내용과 날짜로 바꾼다
AGENTS.md와 src/**/CLAUDE.md는 본문에 지난 리뷰 ID를 두지 않는다
(docs/work/README.md 8절). 번역한 CLAUDE.md 넷에 짝 하나짜리 번호가
남았다: persistence-jpa·app-bootstrap의 「07-08」, grpc의 「11-M9」,
messaging의 「06-01 수정」. check-work-docs.py는 단독 NN-NN을 일부러 잡지
않으므로(범위·절 번호와 구별할 수 없다) 통과했다(번역 묶음 D2b가 넘긴 것).

ID 대신 그 발견의 내용과 날짜를 적었다. 원래 ID와 근거 리뷰 파일은
docs/work/evidence.md 10절 끝에 행 넷으로 남겼다(앞 행들과 같은 칸).

검증(노트북): check-work-docs.py OK, --history(바꾼 파일) 이력 ID 0,
check-docs.py OK. 이 넷을 읽는 테스트는 없다(git grep 'CLAUDE.md' -- '*Test.java').
2026-11-07 18:27:30 +09:00

71 KiB

근거와 이력

docs/work/ 본문은 지난 리뷰를 모르는 사람도 읽을 수 있게 썼다. 그래서 규칙이 나온 사건과 지난 리뷰 ID는 본문에 넣지 않고 여기에 모았다. 본문을 따르는 데 이 문서는 필요 없다. 규칙의 이유를 확인하거나 규칙을 바꾸려 할 때 읽는다.

표기: 1101/05-01은 docs/reviews/2026-11-01-maturity-review/의 발견 05-01이다. 1103/RR6-01-05는 docs/reviews/2026-11-03-rereview/의 발견이다. 접두어와 문서: RR-는 1차 재리뷰(폴더 바로 아래 0107 영역 문서)와 round2의 0103 영역 문서(1차 번호를 이어 썼다), RR2-는 round2의 04 영역 문서, RR3-RR7-는 round3round7이다. 1101 README, 1103 README는 각 폴더의 README.md다. 「결정 N」은 docs/reviews/2026-09-25-review-followup-status.md 「소유자 결정」의 N번이다.

더 오래된 표기:

  • 「1라운드」·「2라운드」·「3라운드」: 1101 README 13·14·15.1절의 수정 라운드(2026-11-01~03). r2-05a, r3-I처럼 r<라운드>-<묶음>은 그 라운드의 수정 묶음 이름이다. r9-a, r10-02는 1103 README 16·17절의 묶음이다.
  • P<N>·W<n>-P<N>: 2026-09-25 리뷰 후속 작업(docs/reviews/2026-09-25-review-followup-status.md)의 묶음 이름(Wave n의 묶음 N). 같은 문서는 2026-09-24 리뷰들의 발견을 S<n>-#<m>, S<n>-lead-<m>, X<n>-#<m>, X<n>-P<k>-<m>, G-3a처럼 부른다. 그 행을 찾으면 내용과 처리 묶음이 있다.
  • MSG-·BOOT-·JPA-·MNG-·GQL-·NTF- + 세 자리: 2026-11 전의 모듈 리뷰(docs/reviews/2026-08-14-messaging-module-code-review.md, 2026-09-07-app-bootstrap-module-code-review.md 등)의 발견이다.
  • D<N>: 문맥에 따라 둘이다. 이 매뉴얼의 설계 결정(design-docs delegation-loop/02-design.md 13절, D1~D14)이거나, leaf CLAUDE.md가 이름을 댄 설계 기록(feature-*-contract 등)의 결정 번호다. 그 설계 기록들은 이 repo에 없다(10절).

1. 이 매뉴얼이 나온 곳

  • 조사와 설계: design-docs delegation-loop/01-research.md(15단계), delegation-loop/02-design.md(6단계, 4·5·6·7·10절). 2026-11-06 소유자가 결정 D1D14를 모두 권하는 안대로 승인했다.
  • 공통 정본: design-docs conventions/work-thinking-order.md(작업 사고 순서), conventions/delegation-loop.md(위임 루프 운영).
  • 재료: 옛 개선 매뉴얼 브랜치 claude/improvement-manual-6ae516(커밋 3b66358e, 319cff91, 06477350, 2026-11-05). 병합하지 않고 설계 10절 표대로 옮겼다(결정 D12).
  • 옛 매뉴얼을 버린 이유(2026-11-06 소유자 판정): 조사 없이 만들었다, 범위가 리뷰·수정뿐이다, 본문 159줄에 지난 리뷰 ID가 있다, 진입 분량이 717줄이다, 시험한 적이 없다.

옛 매뉴얼에서 옮긴 곳:

옛 위치 새 위치
README 「정본 표」, 적용 범위 docs/work/README.md 1·7절, 각 playbook
결정 M-5(저장소 밖 문서는 코드 표기), M-6(소유자 환경 규칙은 한 절에만) docs-writing.md 4절, operate.md 4.1절
결정 M-3(심각도 두 체계) reference/review-criteria.md 3절
결정 M-4(결정 표는 색인) reference/decisions.md 머리말
결정 M-7(커밋 정책은 두고 예외만) docs/work/README.md 4절, AGENTS.md 커밋 문장
결정 M-8(개선 제안도 닫는다) reference/review-criteria.md 1절
결정 M-9(분업과 "Minor도 고친다"의 저장소 안 정본) improve.md 4.5절, delegate.md
결정 M-1(위치 docs/improvement/), M-2(프론트와 장 번호 맞추기) 버림. 위치는 docs/work/, 두 repo는 장 번호 대신 같은 playbook 파일 이름을 쓴다
01장 판정표, 0절 공통 단계, 1~6절 docs/work/README.md 3절, improve.md
02장 reference/review-criteria.md(지난 예는 이 문서 5절)
03장 reference/review-criteria.md 9절
04장 P1~P11 reference/defect-patterns.md 「막는 기준」
05장 reference/review-criteria.md 7절, improve.md 4.2·4.3절
06장 reference/review-criteria.md 8절, reference/gates.md 5절, 기준선은 이 문서 6절
07장 reference/gates.md, operate.md
08장 reference/decisions.md
09장 delegate.md, improve.md 4.4·4.5절, design-docs conventions/delegation-loop.md
부록 결함 패턴 reference/defect-patterns.md + 이 문서 4절

2. 규칙과 사건

규칙(본문 위치) 사건 근거
무거운 실행은 desktop에서, 공유 잠금으로 (operate.md 4.1) 2026-11-05 하위 세션 넷이 노트북에서 Gradle을 돌려 노트북 부하가 22까지 올랐다 1103 README 17.1절, design-docs delegation-loop/01-research.md 4.2절
진입 분량 상한, 본문 이력 ID 금지 (docs/work/README.md 8절) 옛 개선 매뉴얼은 진입 717줄, 이력 ID가 든 본문 159줄 01-research.md 4.1절
색인은 기계로 대조한다 (improve.md 4.1) 원래 리뷰 색인이 119건이었다. 06 영역 문서의 NN-10~NN-14 5건이 색인과 모든 수정 묶음에서 빠졌다. 실제는 124건 1101 README 12절 정정, 1103 README 1절, 1103/RR-05-10
「새로 가정하는 것」 칸, 수정 묶음 크기 상한 (improve.md 4.4, 8절) round6 발견 25건 중 17건(68%)을 직전 수정 커밋이 만들었다. 짝 프론트 1106 리뷰도 25건 중 16건(64%) 01-research.md 4.3절, design-docs delegation-loop/02-design.md 4.3절
보고한 태스크가 로그에 있는지 확인 (improve.md 9절, gates.md 4절) 묶음 보고가 없는 태스크 :adapter:outbound:persistence-jpa:documentContractTest를 적었다 1103 README 17.2절
성능 lane은 상한을 매번 단언하고, 끄는 값은 테스트 전에 실패한다 (gates.md 5절) r10 desktop 게이트의 performanceCheck가 -Pperformance.assertions.enabled=true 없이 돌아, httpclient 시간 단언 없이 통과했다. 그 전에는 JPA pool lane이 같은 속성 뒤에 숨어 상한을 비교하지 않았다(PoolLaneClaimTest). 2026-11-06 빌드가 강제하게 바꿨다 desktop ~/r10-logs/gates.sh, docs/testing/TESTING_STRATEGY.md PERFORMANCE 문단, 커밋 e6b6e18e
캐시에서 가져온 결과는 지금 통과한다는 증거가 아니다. 기준 상태와 시간·환경에 민감한 테스트는 --rerun으로 (operate.md 9절, gates.md 6절) 2026-11-06 B3 desktop ci rc=0은 캐시 결과였다(태스크 701개 중 403개를 캐시에서). 그 사이 httpclient CircuitBreakerStatusAccountingTest 2건은 기준 커밋 3d73b6f1에서도 10번 중 10번 실패하고 있었다 desktop ~/b3-logs/ci.log, 2026-11-06 총괄 전달
묶음을 너무 크게 만들지 않는다 (delegate.md 4.2) 알림·파일 서버를 한 묶음(r2-05a)으로 묶었다가 마감 안에 검증 보고가 오지 않아 합치지 못했다. 다음 라운드(r3-a)에 다시 올려 합쳤다 1101 README 14.3절, 16절
두 묶음이 같은 파일을 건드리지 않게 (delegate.md 4.2) 2라운드 묶음 r2-06이 10개 파일 충돌로 처음부터 다시 작업했다 1101 README 14.1절
전 leaf import를 바꾸는 묶음은 마지막에 혼자 (improve.md 6절, delegate.md 4.2) r3-G 1101 README 15.1절
묶음마다 그 시점 최신 기준에서 시작 (delegate.md 4.2) 3라운드가 2라운드보다 충돌이 적었다 1101 README 16.1절
합친 트리는 따로 검증 (improve.md 4.4, gates.md 3절) 두 묶음의 수정이 한 트리에서 처음 만나 BC_IMPOSSIBLE_INSTANCEOF가 생겼다. 최종 게이트에서 드러난 2건 1101 README 16.1절, 1103 README 6.1절
캐시로 통과한 것은 그렇게 적는다 (gates.md 4절) ci가 434초에서 51초로 준 것은 캐시 재사용이었다 1101 README 16.2절
같은 결함은 한 묶음에만 (delegate.md 4.2) 같은 runbook 문장을 두 리뷰가 적어 한 번 고쳤다(1103/RR6-01-07, 1103/RR6-02-03) 1103 README 17절
RED가 머신에 따라 통과하지 않게 (improve.md 7절) watchdog RED 테스트가 공용 풀 병렬도 1인 머신에서 옛 코드도 통과시켰다 1103/RR4-03-01, 1103 README 16절 r9-b
실 vendor 결함은 실 vendor에서 RED (improve.md 4.2) 새 실 PostgreSQL 테스트 3개의 수정 전 실패를 실 PostgreSQL로 확인하지 않았다 1101 README 14절 r2-04
Agent 도구를 쓰지 않는다 (delegate.md 4.3) 하위 세션 시작이 막히자 Agent 하위 에이전트로 우회했다. 지난 라운드는 사용량 한도 때문에도 하위 에이전트 없이 진행했다 01-research.md 4.2절, 1101 README 16절, 1103 README 6절
예전 멈춤 기준을 거둠 (improve.md 4.5) 2026-11-05 소유자 지시 "보고할 때 남은 문제가 없어야 한다". "새 Important 0이면 멈춤"(9.1절), "Minor는 기록만"(11.1절)을 거뒀다 1103 README 16절
종료 조건은 repo마다 (improve.md 4.5) 2026-11-05 소유자 원문 "각자 유지" 2026-11-05 총괄 세션 전달

3. 수정 묶음 크기 (improve.md 4.4)

추가 줄은 git show --shortstat의 insertions다(테스트·문서 포함).

수정 커밋 고친 것 추가 줄 다음 확인 리뷰 그 리뷰의 발견
01a8a2a70..5786126c(커밋 3개) 원래 리뷰 발견 +60,167 1차 재리뷰 Important 27, Minor 41
bbe944bd 1차 재리뷰 발견 + 색인에서 빠졌던 5건 +13,479 round2 Important 7, Minor 22
1885bf8d 2차 재리뷰 결함 29건 +5,495 round3 Important 0, Minor 19
f40c03c6 Minor 19건(영역 묶음 4개) +1,877 round4 Important 0, Minor 7
70fb80bf 소유자가 다시 정한 기본값 3가지 +906 round5 Important 0, Minor 9
45d2a478 기록만 했던 결함 전부(영역 묶음 4개) +5,420 round6 Important 2, Minor 23(17건은 이 커밋이 만듦)
6e992970 round6 결함 25건(영역 묶음 4개) +5,143 아직 없음 —

읽는 법: 추가 2,000줄 아래 두 번은 다음 발견이 7·9건, 5,000줄 위 네 번은 19·25·29·68건이었다. 상한(묶음 8건, 확인 리뷰당 1,500줄)은 이 표에서 정한 판단 값이다. 위임 루프 지표(라운드당 새 결함, 수정이 만든 결함 비율)로 다시 맞춘다.

4. 결함 패턴의 근거 (reference/defect-patterns.md)

패턴 근거
A1 갈라진 복사본 1101/01-03, 1101/01-07, 1101/04-06, 1101/05-09, 1101/07-06, 1101/01-11, 1103/RR-01-14, 1101 README 16.3절(템플릿 패키지 목록 두 곳), 1103 README 16절 r9-c(버전 정규식 사본)
A2 문서와 코드 불일치 1101/02-01, 1101/07-11, 1101/03-04, 1101/06-11, 1103/RR-01-03, 1103/RR-01-11, 1103/RR5-01-01, 1103/RR6-02-05, 1103/RR6-03-05, 1103/RR6-04-05
A3 선언과 실행이 떨어져 있다 1101/05-15, 1101/03-11, 1101/02-03, 1101/07-06, 1103/RR-06-01, 1103/RR2-04-03, 1103 README 6.1절(redis.capability.* 6개)
A4 결과 불명을 확실함으로 1101/05-01, 1101/04-01, 1101/06-01, 1101/05-17, 1101/05-11, 1103/RR-02-03, 1103/RR-01-11, 1101 README 4절 원인 1
A5 중복·경쟁을 코드 순서로 1101/09-02, 1101/04-08, 1101/04-02, 1101/03-10, 1101/04-13, 1103/RR-03-01, 1103/RR-02-04
A6 주장하는 것을 보지 않는 테스트 1101/05-08, 1101/02-02, 1101/01-05, 1103 README 14절(CountDownLatch 7건), 1103/RR4-03-01, 1103/RR6-01-08, 1103/RR6-02-02
A7 거짓 통과 게이트 1101/08-01, 1101/04-04, 1101/03-12, 1103/RR-06-02, 1103/RR-06-03, 1103/RR-04-05, 1103 README 14절(테스트 SpotBugs 53개), 1103/RR3-04-02, 1103/RR6-04-01, r10 desktop performanceCheck(2절)
A8 로그로 새는 입력값·원인 1103/RR6-01-05, 1103/RR6-01-06, 1103 README 16절 r9-a, 1101/02-11, 1101/01-04
A9 이름만 보는 허용·거부 1103/RR-07-02, 1103/RR2-04-02, 1103/RR2-04-01, 1101/07-14
A10 글로만 있는 규칙 1103/RR-01-02, 1101/04-03, 1101/05-16
A11 샘플·fixture가 운영과 다르게 조립 1101/07-03, 1101/09-03, 1101/09-08, 1101/07-04, 1101/01-02, 1101/07-09
A12 수정이 새 결함을 만든다 1103 README 1절(Important 27), 9절, 1103/RR6-01-01(회귀), 1101 README 16.1절, 1103 README 6.1절, round6 68%(2절)
A13 합치는 과정의 누락 1101 README 12절 정정, 1101 README 14.1절(충돌 처리 목록)
A14 타이밍에 기댄 약속 1103 README 16.1절(ClientRuntimeRegistry.close), 1103/RR3-03-01, 1101/05-06
A15 사라지는 외부 공급원 1101/05-09, 1101/08-04
A16 상한 없는 자원 1101/03-06, 1101/03-09, 1101/04-10, 1101/02-09, 1101/04-12

5. 리뷰 기준의 예 (reference/review-criteria.md)

결함의 모양(1절): 이름과 다른 동작 1101/05-03(ONLY_IF_SOURCE_REVISION_NEWER가 조건 없이 덮어씀), HARD-STOP 위반 1101/07-08(기본 조립 루트가 선택 capability를 앎), 갈라진 복사본 1101/01-03(TenantId 3벌)·1101/04-06(SQLState 표 2벌), 막지 못하는 게이트 1101/05-08(소유자 검사를 지워도 442개 통과)·1101/08-01(어떤 workflow도 돌리지 않는 strict lane 14개), 틀린 조치를 시키는 문서 1103/RR-05-01(DEAD 재발행 SQL을 따르면 다시 DEAD), 기본값 뒤에 숨은 위험 1101/02-03(JWT audience가 비면 검증을 건너뜀).

성격(2절): 구조적 위험 1101 README 6절, 미검증 1103 README 10.3절(CI runner가 꺼져 있다).

심각도(3절): 전체 리뷰 체계는 1101 README 12절. High 예 1101/05-01, 1101/04-02, 1101/02-03. Medium 예 1101/04-06, 1101/04-05. Low 예 1101/07-11. 확인 리뷰 체계는 1103 README 2절 이후 모든 round, Important 기준은 1103 README 11절, Minor 예는 1103/round4/review.md·round6/. "이번 커밋 / 이전부터"는 1103/round6/04-build-logic.md 「결론」. Minor도 고친다는 규칙은 1103 README 16절, High·Important 재확인은 1101 README 2절.

증거 수준(4절): 이전 결과를 쓰지 않은 예 1101/09-performance-measurement.md 1절, 섞인 증거 수준 표기 예 1103/round6/03-persistence.md RR6-03-01.

통제 수준(5절): M0 예 2026-11-01 시점 JPA 양방향 연관관계 금지(1101/04-03), M1 예 @SystemInvoked를 bean으로 등록하지 말라는 주석(1103/RR-01-02), M4 예 DB 유일 제약(1101/09-02 수정 뒤).

28개 관점(6절)의 지난 예: 1 1101/05-03 · 2 1101/07-08, 1101/08-05 · 3 1101/01-07 · 4 1101/01-01, 1101/07-09 · 5 1101/02-03, 1103/RR-07-02 · 6 1101/04-01, 1101/06-01, 1101/05-01 · 7 1103/RR-05-01, 1103 README 6.1절 · 8 1103 README 16절 r9-a, 1101/01-04 · 9 1101/04-06, 1101/07-11 · 10 1101/05-08, 1101/02-02 · 11 1101/09-02, 1103/RR-02-09 · 12 1101/04-02, 1101/03-10 · 13 1101/03-06, 1101/03-09 · 14 1101/09-01, 1101/09-02 · 15 1101/02-03, 1101/07-03, 1103/RR6-01-05 · 16 1101/05-09, 1101/09-09 · 17 1101/02-01, 1101/02-02 · 18 1101/07-04, 1101/06-02 · 19 1101/05-15, 1101/07-06 · 20 1103/RR-01-01, 1103/RR-01-03 · 21 1101/08-01, 1103/RR-06-02, 1103 README 14절 · 22 1101/04-13 · 23 1101/01-03, 1101/01-12 · 24 1101/05-21 · 25 1101/01-10 · 26 1101/04-16 · 27 1101/07-08, 1101/05-19 · 28 1101/03-10, 1101/06-03.

시나리오(6절)의 지난 추적: 1101/01-core-and-feature-pattern.md 4.1·4.2·4.4절, 1101/09-performance-measurement.md 5.1~5.3절, 1101/05-05·05-06·05-01, 1101/04-01·04-05, 1103/RR-03-03, 1101/06-01, 1103/RR-03-02, 1103/RR-02-09·RR-02-10, 1101/04-02·03-10, 1101/05-08, 1101/03-01·02-09, 1101/06-02·07-07, 1101/08-build-ci-test.md 4절.

테스트 점검표(7절): 1103/RR6-01-08, 1101/02-02, 1101/05-08, 1103 README 14절, 1103/RR6-02-02, 1103/RR6-01-03, 1103 README 17절 r10-01, 1103 README 16.1절. fake 예 1103/RR-01-04, 1103 README 17절 r10-02(손 사본 20건 삭제, skip 17 → 0).

리뷰 문서 양식(10절): 전체 리뷰 README는 1101 README 절 순서, 영역 문서는 1101/01-core-and-feature-pattern.md, 확인 리뷰 문서는 1103/round6/*.md, 확인 리뷰 발견 필드는 1103/round6/03-persistence.md RR6-03-01, 전체 리뷰 발견 필드는 1101/08-build-ci-test.md 08-01.

6. 성능 기준선 (improve.md 4.3)

잰 커밋과 함께만 쓴다. 현재 HEAD에서 다시 잰 값이 아니다. 성능 작업을 시작하면 현재 커밋에서 다시 재고 이 표와 비교한다.

측정 값 커밋·출처
기본 조합 bootJar / 기동 중앙값 / 빈 수 41.4 MB / 3.44 s / 407 01a8a2a70, 1101/09-performance-measurement.md 3.1절
샘플 bootJar / 기동 중앙값 / 빈 수 99.0 MB / 8.05 s / 603 같음
필터 체인만 지나는 요청 27,130 rps, p50 0.51 ms 같은 문서 3.4절 (d)
샘플 단건 조회 5,521 rps, p50 2.70 ms, SQL 7개 같은 문서 3.2·3.3절
샘플 목록 20건 829 rps, p50 15.54 ms, SQL 46개 같음(수정 전)
샘플 목록 20건(수정 뒤) SQL 46 → 6, 765 → 2,528 rps 1101 README 14절 r2-09(묶음 보고 — E0, 다시 재지 않음)
관측 기능 비용 처리량 약 3% 같은 문서 3.4절 (b)
가상 스레드 처리량 차이 없음(병목은 커넥션 10개와 DB 왕복) 같은 문서 3.3절
설정만 바꾼 실험 hibernate.default_batch_fetch_size=100만으로 목록 처리량 2.9배 같은 문서 3.4절
게이트 시간(desktop, 12코어·31GB) ci+verifyDependencyLocks 5분 42초, mainCheck 8분 8초, integrationCheck 17분 10초 2c692554, 1103 README 17.2절

측정 스크립트(run-app.sh, Load.java, sqlcount.sh)는 그때 scratchpad에 두었고 repo에는 없다. 다시 재려면 1101/09-performance-measurement.md 「측정 명령 (다시 돌리는 법)」으로 다시 만든다.

7. 리뷰 색인 대조 결과 (2026-11-06)

scripts/check-review-index.py를 지난 리뷰 폴더 두 곳에 돌린 결과다(기준 커밋 3d73b6f1).

폴더 명령 영역 문서 발견 색인에 있음 없음 rc
docs/reviews/2026-11-01-maturity-review/ --index-heading "12. 발견 색인" 124 124 0 0
docs/reviews/2026-11-03-rereview/ README 전체 157 135 22 1
  • 2026-11-01 폴더: 지금은 모두 있다. 같은 검사를 사고 시점 커밋 34565130의 폴더에 돌리면 NN-10~NN-14 5건을 "자리표시자 영역"으로 잡고 rc=1로 실패한다. 이 검사가 그 사고를 막았을 것이다.
  • 2026-11-03 폴더의 22건은 처리되지 않은 발견이 아니라 README가 ID로 적지 않은 발견이다.
    • RR-05-10(색인 누락 5건 자체에 대한 발견)은 README 1절 정정과 6.1절이 내용으로 다룬다.
    • RR-07-05(CSRF 제외 규칙의 이유)는 README 6절 r4-f 행이 내용으로 다룬다.
    • 나머지 20건은 round6 Minor다(RR6-01-0206·08·09, RR6-02-02·04·05, RR6-03-0205, RR6-04-01~06). README 17절은 영역별 건수만 적었고, r10 묶음이 영역 단위로 고쳤다.
  • 이 검사는 "색인에 이름이 있나"만 본다. 고쳤는지는 처리 표와 확인 리뷰가 본다. 앞으로의 리뷰 README는 모든 ID를 이름으로 적는다(improve.md 4.1절 7단계).

8. docs/manual/에서 걷어낸 이력 ID (2026-11-06, 2026-11-07)

docs/manual/ 본문에서 리뷰 ID와 번호만 쓴 결정을 걷어냈다. 문장의 뜻은 그대로이고, 괄호 안 근거만 여기로 옮겼다. 줄 번호는 걷어내기 전 기준 커밋 06f520e6의 줄이다.

원래 위치 원래 괄호 지금 본문 근거
docs/manual/05-idempotency.md:57 "재리뷰 2026-11-04 RR5-01-05, 라운드6 RR6-02-05, 정본 docs/web/http-contract.md 2절" 정본 가리킴만 남겼다 1103/RR5-01-05(PostgreSQL 기본 모양에서는 lease 상황이 생기지 않는다, round5/review.md), 1103/RR6-02-05(매뉴얼 첫 문장이 PostgreSQL 항목과 어긋났다, round6/02-idempotency-outbound.md)
docs/manual/05-idempotency.md:78 "라운드6 RR6-02-01" "2026-11-05 확인 리뷰가 찾아 고쳤다" 1103/RR6-02-01(LEASE_EXPIRED로 거절당한 attempt를 다시 보내도 503만 받았다, round6/02-idempotency-outbound.md). 수정 커밋 6e992970(2026-11-05), 1103 README 17절 r10-02
docs/manual/05-idempotency.md:81 "재리뷰 2026-11-04 RR-01-11·RR-03-11" IdempotencyStoreContract 가리킴만 남겼다 1103/RR-01-11(lease가 지난 실행 기록을 Redis가 넘겨받아 다시 실행했다, round2/01-core-app-inbound.md), 1103/RR-03-11(replay TTL이 lease보다 짧으면 key가 lease 도중 사라졌다, round2/03-outbound.md). 수정 커밋 1885bf8d(2026-11-04)
docs/manual/05-idempotency.md:84 "RR3-03-02, 2026-11-04 소유자 결정" "2026-11-04 소유자 결정" 1103/RR3-03-02(서버가 기억하는 기간 문서가 failure-retention을 빠뜨렸다, round3/03-outbound.md)
docs/manual/07-authorization.md:98, :115 "D4 문단", "D4 실패" "권한 선언 검사 문단", "쓰기 유스케이스의 권한 선언 검사 실패" D4는 인증·인가 계약 설계(feature-authentication-authorization-contract)의 결정 번호로, 규칙 MUTATING_USE_CASES_DECLARE_REQUIRED_PERMISSION을 가리킨다. 그 설계 문서는 이 repo에 없다. ApplicationBoundaryArchitectureTest의 주석 "D1 / D4"와 1101/01-core-and-feature-pattern.md 「ArchUnit D4」가 같은 번호다
docs/manual/08-testing.md:38 "소유자 결정 5" "2026-09-25 소유자 결정" docs/reviews/2026-09-25-review-followup-status.md 「소유자 결정」 5번(@DisplayName은 한국어)
docs/manual/09-outbox-events.md:78 "재리뷰 2차 RR-02-10" runbook 가리킴만 남겼다 1103/RR-02-10(tenant scope가 바뀌는 배포의 rolling 구간에서 새 번호가 옛 버전이 쓴 번호보다 작다, round2/02-persistence-messaging.md)
docs/manual/09-outbox-events.md:89 "재리뷰 RR-05-03" runbook 가리킴만 남겼다 1103/RR-05-03(끝나지 않는 재시도 행을 운영자가 구분·처분할 수단이 없었다, 05-messaging.md)
  • RR-01-11·RR-02-10·RR-03-11은 2차 재리뷰(round2/) 문서의 발견이다. 그 문서들은 1차 번호에 이어 RR- 접두어를 그대로 썼다(머리말 「표기」).

2026-11-07에 남은 19줄을 같은 방식으로 걷어냈다. 16줄은 2026-11-06 검사 패턴을 넓힌 뒤 드러난 줄이다(9절 T4-1). 3줄(아래 표에서 「손으로 찾음」)은 그 패턴도 못 잡아 docs-writing.md 9절대로 grep으로 찾았고, 그 꼴을 잡는 패턴 셋을 scripts/check-work-docs.py에 더했다. 줄 번호는 걷어내기 전 기준 커밋 73d39212의 줄이다. 「1라운드」는 1101 README 13절 「조치 현황 (개선 순서 1~3)」으로, 리뷰 직후 2026-11-01에 한 첫 수정이다(같은 날 밤 13.1절 게이트, 14절 「2라운드」가 이어졌다). 영역 문서 이름은 docs/reviews/2026-11-01-maturity-review/ 안의 파일이다.

원래 위치 원래 괄호 지금 본문 근거
docs/manual/README.md:59 "리뷰 2026-11-01 01-01·07-09" "2026-11-01 성숙도 리뷰" 1101/01-01(새 기능을 어느 leaf에 두는지 세 가지 모양이 있고 고르는 기준이 없다, 01-core-and-feature-pattern.md), 1101/07-09(새 기능을 만들 때 따라 할 예시가 세 갈래다, 07-bootstrap-composition-config.md)
docs/manual/README.md:68, :70 제목 "1라운드 수정으로 생긴 패턴 (리뷰 README 13절)", 본문 "리뷰 뒤 1라운드" 제목 "리뷰 뒤 첫 수정으로 생긴 패턴", 본문 "2026-11-01 성숙도 리뷰 뒤 같은 날 한 첫 수정" 1101 README 13절. 표의 패턴 행은 13절 각 행의 수정 내용이다
docs/manual/03-placement.md:40 (손으로 찾음) "리뷰 01 영역 5.2절" 괄호를 지웠다. 다시 볼 조건 문장이 내용 전부다 01-core-and-feature-pattern.md 5.2절 「새 기능의 배치」 표의 「7. 바뀔 조건」
docs/manual/03-placement.md:54 (손으로 찾음) "sample P30 결정과 같다" "sample-portfolio도 2026-09-29에 이 배치로 옮겼다" P30은 2026-09-25 리뷰 후속 작업 Wave 3 라운드 4의 묶음 이름이다. 그 묶음이 S6-#10a(sample 패키지가 종류별·기능별로 섞였다)를 고쳐 sample application을 기능별 패키지로 옮겼다(docs/reviews/2026-09-25-review-followup-status.md S6-#10a 행, 커밋 8bbf1bf01, 2026-09-29). 07-bootstrap-composition-config.md 07-09 「근거」의 "P30 결정"도 같은 것이다
docs/manual/04-persistence.md:131 "리뷰 README 13.2, 09-02" "2026-11-01 샘플에 포스터 제목 유일 제약을 더할 때" 1101/09-02(포스터 제목 중복 규칙이 동시 요청에서 깨지고 검사 쿼리가 순차 스캔이다, 09-performance-measurement.md). 번호 선택은 1101 README 13.2절 「09-02 마이그레이션 번호」 행
docs/manual/05-idempotency.md:88 "리뷰 02-01 결정" "2026-11-01 소유자 결정" 1101/02-01("처리 중" 409의 클라이언트 행동이 코드·문서·짝 계약에서 서로 다르다, 02-inbound-web.md). 고른 안은 1101 README 5절 (A), 소유자 결정은 15절 「처리 중 409」 행 "소유자 결정(11-01)"
docs/manual/05-idempotency.md:93 (손으로 찾음) "리뷰가 찾은 반복 원인 1번", "(05-01, 04-01, 06-01)" "2026-11-01 성숙도 리뷰가 찾은 반복 원인 첫째", "알림 발송·DB 커밋·메시지 relay 세 경계" 1101 README 4절 1번. 1101/05-01(알림 attempt를 "시작 안 함(확정)"으로 저장한 채 provider를 부른다), 1101/04-01(커밋 중 끊김을 재시도 가능으로 답한다), 1101/06-01(재시도 가능한 거부를 즉시 DEAD로 보낸다)
docs/manual/05-idempotency.md:104 "리뷰 05-17" "2026-11-01 성숙도 리뷰가 Redis 연결 수립 실패에서 찾았다" 1101/05-17(Redis 연결 실패를 결과 불명으로 보고하고, 시간 초과된 연결을 pool에 돌려준다, 05-outbound-capabilities.md). README 4절 1번의 "반대 방향"
docs/manual/06-errors.md:46 "리뷰 01-04" 괄호를 지웠다 1101/01-04(IllegalArgumentException 하나가 입력 오류와 서버 조립 오류를 함께 뜻하고, web은 둘 다 로그 없이 400으로 바꾼다, 01-core-and-feature-pattern.md)
docs/manual/07-authorization.md:28 "1라운드 07-03 수정" "2026-11-01부터. 전에는 샘플이 인증 체인 자동 설정을 빼자 권한 검사도 함께 빠졌다" 1101/07-03(실행 중인 샘플에서 @RequiresPermission이 아무 일도 하지 않았다, 07-bootstrap-composition-config.md). 수정은 1101 README 13절 07-03+09-03 행
docs/manual/07-authorization.md:51 "1라운드 02-03 수정" "2026-11-01부터. 전에는 비어 있으면 검증을 건너뛰었다" 1101/02-03(JWT audience 검증이 기본으로 꺼져 있고 모든 client의 role을 합친다, 02-inbound-web.md). 수정은 13절 02-03+07-05 행
docs/manual/07-authorization.md:146 "리뷰 01-06" 괄호를 지웠다 1101/01-06(@RequiresPermission은 application 계약인데 검사는 web leaf가 켜 주는 AOP에만 있다, 01-core-and-feature-pattern.md)
docs/manual/08-testing.md:49 "리뷰 01-05의 lock fake" "2026-11-01 성숙도 리뷰가 분산 lock 포트 계약 테스트 안의 fake에서 찾았다" 1101/01-05(application-core 포트 절반이 fake·adapter 공유 계약 밖에 있다, 01-core-and-feature-pattern.md). lock fake는 그 근거 칸의 DistributedLockPortContractTest.java:46 private 클래스다
docs/manual/08-testing.md:74 "1라운드 08-01" "2026-11-01부터. 전에는 어떤 workflow도 돌리지 않는 strict lane이 14개 있었다" 1101/08-01(CI가 실행하지 않는 strict lane 14개, 08-build-ci-test.md). 수정은 13절 08-01+08-04+03-12 행
docs/manual/09-outbox-events.md:38 "리뷰 06-10" 괄호를 지웠다 1101/06-10(이벤트 payload 버전을 올리는 방법과 호환성 검사가 없다, 06-messaging.md. 색인 누락을 정정하며 붙은 번호)
docs/manual/09-outbox-events.md:64 "리뷰 06-06" 괄호를 지웠다 1101/06-06(application EventId 문법과 platform MessageId(UUID)가 다르다, 06-messaging.md)
docs/manual/09-outbox-events.md:73 "리뷰 06-07" 괄호를 지웠다 1101/06-07(샘플이 aggregate 순서 번호를 벽시계로 만든다, 06-messaging.md)
docs/manual/09-outbox-events.md:86 "1라운드 06-01·06-03" "2026-11-01부터. 전에는 broker가 몇 분만 멈춰도 행이 대량으로 DEAD가 됐다" 1101/06-01(다시 시도하면 될 거부를 relay가 즉시 DEAD로 보낸다), 1101/06-03(broker가 몇 분만 멈춰도 행이 대량으로 DEAD가 된다), 둘 다 06-messaging.md. 수정은 13절 06-01+06-03 행
  • 더한 패턴 셋: 앞말 없이 나열한 발견 번호(05-01, 04-01, 01-01·07-09), 리뷰 영역 번호(리뷰 01 영역, 01 영역 5.2절), 리뷰 후속 묶음 번호(P30, W3-P30. P50 이상은 백분위수라 잡지 않는다). 홀로 선 NN-NN 하나는 보통 범위나 장 번호일 수 있어 여전히 잡지 않는다.

9. cold-read 시험 1회차 빈틈 처리 (2026-11-06~07)

2026-11-06 이력 없는 세션 6개에 이 매뉴얼만 주고 실제 일을 시켰다(기준선 1개는 옛 매뉴얼). 6개 모두 일은 끝냈지만 매뉴얼에서 답을 못 찾은 곳이 1~9건씩 나와 모두 불합격이었다. 아래는 시험 기록(design-docs delegation-loop/trials/2026-11-06-*.md)의 「질문」·「위반」 표와 각 세션 공유 노트(~/.config/Claude/side-session-notes/local_fcd89c34-c754-4c5b-a38f-fa322834286f/)의 「매뉴얼에서 답을 못 찾은 곳」을 한 줄씩 처리한 결과다. 기준 커밋 2c8a359d. 2026-11-07 운영 playbook 시험(T6, trials/2026-11-07-integration-gates.md, 1회차 수정 전 매뉴얼로 돌림)의 빈틈 6건을 T6 행으로 더했다.

  • 세션: T1 c-t1-r10-review(확인 리뷰), B c-t1-baseline(같은 리뷰를 옛 매뉴얼로, 기준선), T2 c-t2-circuit-breaker(결함 수정), T3 c-t3-error-codes(조사·설계 → 구현), T4 c-t4-manual-ids(문서), T5 c-t5-idempotency-opid(결함 수정), T6 c-t6-integration-gates(합친 브랜치 전체 게이트).
  • 출처 칸: 기록 N은 시험 기록 「질문」 표의 N번, 노트 N은 공유 노트의 N번이다. T3 노트는 1단계 1-N, 2단계 2-N이다.
  • 처리 칸: 고침(고친 곳) / 고치지 않음(이유) / 소유자 결정 필요. 기준선(B)은 새 매뉴얼에도 해당하는 것만 고쳤다.
# 출처 빈틈 처리
T1-1 기록 1, 노트 1 상한을 넘어 나눈 확인 리뷰를 한 세션이 차례로 해도 되나 고침 — improve.md 4.4절: 나누는 것은 맡긴 쪽, brief 하나로 받으면 차례로, 단위마다 문서 하나
T1-2 노트 2 영역 pathspec이 파일 단위로 안 갈림, 수정 커밋 안의 리뷰 기록을 상한에서 빼나 고침 — improve.md 4.4절: 리뷰 기록 docs/reviews/** 제외, 테스트 파일은 지키는 코드의 영역
T1-3 기록 2, 노트 3 수정 보고에 「새로 가정하는 것」 칸이 없을 때 고침 — improve.md 4.1절 2단계: 커밋 본문 「위험·한계」와 처리 표 「결정」에서 뽑고 뽑은 곳을 적는다
T1-4 기록 3, 노트 4 지난 라운드 색인 누락으로 색인 검사가 처음부터 rc=1 고침 — improve.md 4.1절 8단계: 이번 색인 절에 「색인 보완」 한 줄
T1-5 기록 4, 노트 5 리뷰 README를 누가 쓰나: delegate.md(총괄)와 improve.md(리뷰어)가 다름 — 모순 고침 — improve.md 4.1절 7단계, delegate.md 4.2절 표, reference/decisions.md 2.1 「리뷰 README 분담」: 리뷰어는 자기 라운드 색인 절 하나, 나머지는 총괄
T1-6 기록 5, 노트 6 지난 라운드 영역을 나눌 때 영역 번호 고침 — reference/review-criteria.md 10절 「ID」: 그 라운드 영역 표의 순번, 나누면 뒤에 새 번호, 「범위」에 대응
T1-7 기록 6, 노트 7 클래스 이름으로 고르는 strict lane에서 탐침 돌리기 고침 — improve.md 9절(자주 하는 실수): 기존 클래스에 메서드로, -Werror 주의
T1-8 기록 7, 노트 8 --rerun이 바로 앞 태스크에만 걸림 고침 — operate.md 9절, reference/gates.md 6절: 태스크마다 붙인다
T1-9 노트 9 지난 라운드 Declined 30건이 닫힌 기록 없음, 확인 리뷰어가 다시 판정하나 고침 — improve.md 4.1절 9단계(brief가 맡겼을 때만), delegate.md 4.1절(확인 리뷰 brief에 적는다)
T1-10 기록 8, 노트 10 같은 범위를 두 리뷰가 같은 라운드 ID로 씀 고침 — reference/review-criteria.md 10절 「ID」(정본 리뷰 하나, 다른 쪽은 새 ID와 대응표), delegate.md 9절
T1-11 기록 9, 노트 11 다른 브랜치 병합을 기다리는 Declined는 닫힌 것인가 고침 — improve.md 4.5절 2: 합친 트리에서 확인할 때까지 열림
B-1 기록 1, 노트 1 한 리뷰어가 모든 영역을 볼 때 문서 모양 고침 — reference/review-criteria.md 10절 「위치」: roundN/NN-<영역>.md, 영역마다 하나
B-2 기록 2, 노트 2 리뷰어가 리뷰 README에 쓰나 고침 — T1-5와 같은 곳
B-3 기록 3, 노트 3 strict lane 탐침, 탐침에도 -Werror 고침 — T1-7과 같은 곳
B-4 기록 4, 노트 4 확인 리뷰에 넣을 「이전부터」 결함의 경계 고침 — improve.md 4.1절 3단계: 읽은 주변 코드에서 본 것은 적고, 그 밖을 찾아 나서지 않는다
B-5 기록 5, 노트 5 앞 라운드 Declined가 닫히지 않은 채 시작 고침 — T1-9와 같은 곳
B-6 기록 6, 노트 6 리뷰 스킬은 하위 에이전트를 쓰라 하고 매뉴얼은 금지 — 모순 고치지 않음 — 새 매뉴얼에 답이 있다: improve.md 3절 끝 줄, delegate.md 4.3절. 새 매뉴얼로 같은 리뷰를 한 T1은 묻지 않았다
B-7 기록 7, 노트 7 리뷰 기록 문서도 document-contract lane 대상인가 고침 — reference/gates.md 2절, docs-writing.md 4절 9단계: 읽는 테스트를 파일·폴더로 찾고, 없으면 돌리지 않고 grep 결과를 적는다
T2-1 기록 1 push한 커밋은 못 고치고 desktop은 push된 것만 받는다. 커밋 본문에 desktop 결과를 넣으려면 고침 — operate.md 2절·4.1절 「push 전에 검증하기」(패치와 트리 해시)·9절, design-docs conventions/delegation-loop.md 11절 「실행 위치」
T3-1 기록 1, 노트 1-1 「파일 하나여도 큼」 표면에 대한 설계 메모만 쓰는 일의 크기 고침 — design-docs conventions/work-thinking-order.md 2.1절, research-design.md 3절, 스킬 research-first
T3-2 기록 5, 노트 1-2 push 허용: docs/work/README.md 4절·decisions.md는 "커밋·push", 정본 11절은 "push는 소유자" — 모순 고침 — 커밋과 push를 brief 7절이 따로 허용한다: docs/work/README.md 4절, reference/decisions.md 2.1, delegate.md 2·4.1·6절, 루트 CLAUDE.md 5절, design-docs conventions/delegation-loop.md 2·3·4.1·11절, 스킬 delegate
T3-3 기록 2, 노트 1-3 탐침을 생략해도 되는 기준 고침 — research-design.md 4절 3단계
T3-4 기록 3, 노트 1-4 파생 서비스 영향을 어떻게 확인하나 고침 — research-design.md 4절 5단계, design-docs conventions/delegation-loop.md 11절 「세션」(파생 서비스 위치)
T3-5 기록 4, 노트 1-5 조사·설계에서 범위 밖 결함을 어디에 적나 고침 — docs/work/README.md 6절: 모든 보고에 「범위 밖에서 본 것」
T3-6 기록 4, 노트 1-6 하위 세션이 Slack 브리핑을 하나 고침 — design-docs conventions/delegation-loop.md 4.1절 7절 칸·11절 「보고」, reference/decisions.md 2.1 「하위 세션 보고」: 전역 규칙 그대로, brief가 "Slack 말고"면 안 보냄
T3-7 기록 4, 노트 2-1 push 전에 RED를 보려면 desktop에 무엇을 보내나 고침 — operate.md 4.1절 「push 전에 검증하기」 RED 줄
T3-8 기록 4, 노트 2-2 커밋 본문 「검증」 칸과 push 순서 고침 — T2-1과 같은 곳
T3-9 기록 4, 노트 2-3 git add -p 없이 한 파일을 두 커밋으로 나눠 stage 고침 — design-docs conventions/delegation-loop.md 11절 「커밋과 병합」(패치 hunk를 지우고 git apply --cached)
T4-1 기록 1, 노트 「스크립트가 못 잡는 이력 ID」 --history가 "리뷰 NN-NN"·"N라운드 NN-NN"을 못 잡아 0이 나와도 16줄 남음 고침 — scripts/check-work-docs.py 패턴 셋, docs-writing.md 9절. 새로 드러난 docs/manual/ 16줄은 고치지 않음 — 이번 범위 밖, 2회차 시험 과제
T4-2 기록 2 바꾼 문서를 읽는 테스트가 없을 때 무엇을 돌리나 고침 — B-7과 같은 곳
T4-3 기록 3 이 문서 머리말의 ID 표기가 실제(2차 재리뷰도 RR-)와 다름 — 모순 고침 — 이 문서 머리말 「표기」(접두어별 문서), 8절 끝 줄
T4-4 기록 4 원래 문서가 repo에 없는 결정 번호 고침 — docs-writing.md 4절 6단계
T4-5 기록 5 하위 세션이 Slack 브리핑을 하나 고침 — T3-6과 같은 곳
T5-1 기록 1 설계서 둘과 포트 Javadoc이 서로 다를 때 무엇을 따르나 고침 — improve.md 7절: 결정이 없으면 고르지 않고 양쪽 근거로 묻는다
T5-2 기록 2 소유자 지시로 생긴 큰 변경도 따로 멈춰야 하나 고침 — design-docs conventions/work-thinking-order.md 2.3절, 스킬 research-first
T5-V 기록 「위반」 1 총괄 보고를 영어로 씀 고침 — docs/work/README.md 6절, design-docs conventions/delegation-loop.md 5·11절. 훅으로는 막지 않는다(보고 문장은 도구 호출이 아니라 훅이 볼 수 없다)
T6-1 기록 1, 노트 1 reference/gates.md 3절 묶음에 경로 필터 PR lane과 main job(configuration-cache, compose smoke, http3, notification)이 없어 "workflow와 같은 명령"이 성립하지 않음 고침 — reference/gates.md 3절 (가) 늘 도는 것(main job·optional 빌드·태그 단계 명령 더함)
T6-2 기록 2, 노트 2 합친 트리가 어떤 경로 필터 lane을 켜는지 정하는 절차, "바뀐 영역의 lane"의 정의 고침 — reference/gates.md 3절 (나): git diff --name-only를 on.pull_request.paths(glob)와 pr-adapters.yml emit 줄(정규식)에 맞춘다
T6-3 기록 3, 노트 3 집계 태스크 전체가 실제로 돌았음을 보이는 법(--rerun은 앞 태스크 하나만) 고침 — reference/gates.md 3절 「실제로 돌았음을 보이기」(새 worktree, --no-build-cache, FROM-CACHE 0)·6절, operate.md 9절
T6-4 기록 4, 노트 4 lychee 대체 명령이 lychee 범위보다 좁음, buf·dependency review 대체 안내 없음 고침 — reference/gates.md 2절 링크 검사(lychee와 같은 glob을 git ls-files로), 3절 (다) 로컬 도구가 없는 job 표
T6-5 기록 5, 노트 5 compose bind mount가 tmp/heap-dumps를 root 소유로 만들어 git worktree remove가 실패 고침 — operate.md 4.1절(compose down 뒤 컨테이너로 폴더를 지운다)
T6-6 기록 6, 노트 6 reference/gates.md 4절 기록 형식이 "게이트 하나 = Gradle 명령 하나"를 가정 고침 — reference/gates.md 4절(한 줄 = 명령 하나, 여러 명령 job은 순번, 「실제 실행」 칸)
  • 기준선과 새 매뉴얼의 리뷰 발견은 8건 중 1건만 겹쳤다. 이를 근거로 확인 리뷰를 독립 리뷰어 둘로 할지 소유자에게 물었고, 2026-11-07 소유자가 세 경우에만 둘로 하는 안을 골랐다(소유자 원문 "(c)로 받기"). 넣은 곳: improve.md 4.1절 「독립 리뷰어 둘」·4.5절 1, delegate.md 4.1·4.3절, reference/review-criteria.md 10절 「ID」, reference/decisions.md 2.1, design-docs conventions/delegation-loop.md 3절 5·9절 M11, delegation-loop/metrics.md.
  • 「자주 하는 실수」에 넣은 줄: improve.md(strict lane 탐침), operate.md(--rerun 범위를 기존 줄에 더함, push 뒤 검증), docs-writing.md(--history 0을 믿음), delegate.md(두 리뷰의 ID).

10. 진입 문서에서 걷어낸 이력 ID (2026-11-07)

2026-11-07 소유자가 이력 ID 0 규칙을 진입 문서로 넓혔다: AGENTS.md와 src/**/CLAUDE.md다(1103 README 19.4절 ③의 (b)). 모듈 README·설계 문서·docs/reviews/**는 넓히지 않는다. 새 세션이 처음 읽는 규칙 문서에서만 ID가 이해를 막고, 나머지는 같은 repo의 리뷰 문서로 따라갈 수 있어서다. scripts/check-work-docs.py 기본 모드가 이제 이 문서들을 본다.

걷어낸 줄은 87줄이다. 넓힌 범위에서 옛 패턴이 74줄을 잡았고, 그중 2줄은 날짜로 쓴 소유자 결정을 잘못 잡은 것이었다. 새 패턴과 줄바꿈 검사가 15줄을 더 잡았다. 줄 번호는 기준 커밋 83948d58의 줄이다. feature-*-contract 같은 설계 기록은 이 repo에 없다(git ls-files로 0건). 그래서 그 번호의 근거 칸은 가리키는 규칙과 코드 위치를 적는다.

원래 위치 원래 괄호 지금 본문 근거
AGENTS.md:83, :202 "소유자 결정 4", "소유자 결정 5" "2026-09-25 소유자 결정" 결정 4(verifyEnvKeys는 app-bootstrap 태스크, 구현은 build-logic ca.config-contract), 결정 5(@DisplayName은 한국어). 결정 색인 2.7·2.1
AGENTS.md:267, src/adapter/outbound/cache-redis/CLAUDE.md:197~198 "리뷰 05-18", "review finding 05-18" "2026-11-03 정함", "decided 2026-11-03" 1101/05-18(설정 prefix·바인딩 방식이 capability 기준 4와 다르다, 05-outbound-capabilities.md). 결정은 1101 README 15절(2026-11-03, 위임), 결정 색인 2.6 「Redis prefix 예외」
src/adapter/inbound/graphql/CLAUDE.md:76, :130 "owner decision 25", "소유자 결정 25" "owner decision 2026-09-25", "2026-09-25 소유자 결정" 결정 25(GraphQL DataLoader 키 실패는 등록된 ApiErrorCode만 노출). 결정 색인 2.3
src/adapter/inbound/graphql/CLAUDE.md:104 "servlet 단일 스택(D4)" 괄호를 지웠다 D4는 servlet 단일 스택 결정의 번호다. 결정 9 행의 "D4를 outbound에도 적용"이 같은 번호다(2026-09-25-review-followup-status.md 「소유자 결정」). D4를 적은 원래 설계 기록은 이 repo에 없다
src/adapter/inbound/web/CLAUDE.md:45~46(줄바꿈으로 갈림), src/adapter/outbound/support/CLAUDE.md:30 "review 2026-11-01 07-10" "since 2026-11-01" 1101/07-10(설정 오타·죽은 키가 기동에서도 게이트에서도 안 잡히는 곳이 있다, 07-bootstrap-composition-config.md). 그 수정이 app.security를 StrictSettingsBinder로 묶었다
src/adapter/inbound/web/CLAUDE.md:136, :143, :154, :161, :163, :164 "D2", "D3", "D3 / SBMS-C3", "D5", "D6", "D7" 괄호를 지웠다. S1~S5는 이 문서의 항목 이름이라 남겼다 설계 기록 feature-schema-serialization-contract(이 repo에 없음)의 결정 번호. 규칙은 각 항목 본문, JacksonSerializationPolicyTest, ArchUnit no_bigdecimal_double_constructor가 가진다
src/adapter/inbound/web/CLAUDE.md:191 "C3 / C7 / D9" "C3 / C7" 설계 기록 feature-business-rule-validation-contract(이 repo에 없음)의 결정 번호. 규칙은 BusinessRuleValidationContractTest와 누출 테스트
src/adapter/outbound/persistence-jpa/CLAUDE.md:222 "persistence-multi-db-extensibility D3" 괄호를 지웠다 설계 기록 persistence-multi-db-extensibility(이 repo에 없음)의 결정 번호. 규칙은 같은 문장의 ArchUnit PERSISTENCE_RDBMS_STAYS_VENDOR_NEUTRAL·PERSISTENCE_RDBMS_STAYS_NEUTRAL_OF_H2
src/adapter/outbound/persistence-jpa/CLAUDE.md:239 "review 09-05" 괄호를 지웠다. 이유는 같은 문단 끝 문장(시작마다 SHOW TRANSACTION ISOLATION LEVEL 왕복)이 적는다 1101/09-05(트랜잭션마다 SHOW TRANSACTION ISOLATION LEVEL 왕복 1회, 09-performance-measurement.md)
src/adapter/outbound/persistence-jpa/CLAUDE.md:246 "review 04-10" "since 2026-11-01" 1101/04-10(기본 쓰기·읽기 트랜잭션에 시간 제한이 없다, 04-persistence.md)
src/adapter/outbound/persistence-jpa/CLAUDE.md:251 "review RR-03-03" 지웠다 1103/RR-03-03(JPA 경로에서 트랜잭션 마감 초과가 분류되지 않고 500이 된다, 03-persistence.md)
src/adapter/outbound/persistence-jpa/CLAUDE.md:265, :277, :367 "D12 of …", "… D1", "D9 of …" 설계 기록 이름만 남겼다 feature-application-port-usecase-contract의 D12(inNew 풀 크기 제약), feature-persistence-failure-baseline의 D1(영속성 실패 번역 계약), feature-architecture-enforcement-rules의 D9(MapStruct 생성 mapper 예외). 셋 다 이 repo에 없다
src/adapter/outbound/persistence-jpa/CLAUDE.md:309 "review 04-06" "before 2026-11-01 a hand-kept second table had already drifted" 1101/04-06(SQLState 분류표가 두 벌이고 이미 갈라졌다, 04-persistence.md)
src/adapter/outbound/persistence-jpa/CLAUDE.md:318 "review 04-05" 지웠다 1101/04-05(@Version 충돌이 변환되지 않고 500 INTERNAL_ERROR로 나간다, 04-persistence.md)
src/adapter/outbound/persistence-jpa/CLAUDE.md:340, :341, :343, :348, :349, :357, :361 "D3", "D2", "D6", "D1", "D4", "D5" 지웠다 설계 기록 feature-persistence-auditing-contract(같은 문서 「Persistence auditing contract」 절 제목이 이름을 댄다, 이 repo에 없음)의 결정 번호. 규칙은 AuditableEntity와 ArchUnit domain_is_pure가 가진다
src/application-core/CLAUDE.md:40, :42, :44, :242, :250, :332 "D3", "ArchUnit D11", "per D12", "(D11)", "(D12)" D11 하나는 ArchUnit 규칙 이름 application_does_not_depend_on_application_context로 바꿨다. 나머지는 지웠다 설계 기록 feature-application-port-usecase-contract(이 repo에 없음)의 결정 번호: D3 TransactionPort, D11 콜백 시그니처와 ApplicationContext 금지, D12 inNew 풀 크기(문자열 키 bean 조회의 정적 분석 사각지대 문장도 같은 번호를 썼다)
src/application-core/CLAUDE.md:174 "review 2026-11-01 01-10 (b)" "weighed in the 2026-11-01 maturity review" 1101/01-10(application-core 한 이름공간에 커널·플랫폼 기능·업무 기능이 섞인다, 01-core-and-feature-pattern.md)의 대안 (b)
src/application-core/CLAUDE.md:288, :290 "re-review RR5-01-02·03", "re-review 2026-11-04 RR-01-11, RR-03-11, RR3-03-04" 앞은 "owner decision 2026-11-04"만 남겼다. 뒤 줄은 지웠다 1103/RR5-01-02(renew·inspect 결과 값의 뜻이 하나씩 늘었다)·RR5-01-03(포트 javadoc의 "주인의 마지막 보고를 기록이 갖는다"가 동작과 다르다), round5/review.md. 1103/RR-01-11(lease가 지나면 Redis 저장소가 작업을 다시 돌린다, round2/01-core-app-inbound.md), 1103/RR-03-11(replay TTL이 lease보다 짧으면 key가 lease 도중 사라진다, round2/03-outbound.md), 1103/RR3-03-04(watchdog·계약으로 바뀐 뒤 옛 표현이 남은 문서, round3/03-outbound.md)
src/application-core/CLAUDE.md:293, :297 "owner decision 2026-11-06" 그대로 걷어낼 ID가 아니다. 옛 패턴 owner decision \d+가 날짜를 번호로 잡은 오탐이라 패턴을 고쳤다(아래)
src/application-core/CLAUDE.md:311, :317, :319, :322, :326, :336 "D1", "D3", "D4", "D5", "D2", "query-bypass D1" 항목 이름만 남겼다(Purity guardrail, Strict ceremony, Transaction, Capability) 설계 기록 feature-application-query-bypass-contract(같은 문서 「Read / query path」 절 제목, 이 repo에 없음)의 결정 번호. D1은 ArchUnit query_ports_do_not_leak_domain_jpa_or_web_types가 지킨다
src/adapter/outbound/cache-redis/CLAUDE.md:137, :138, src/adapter/outbound/httpclient/CLAUDE.md:93 "review 2026-11-01 05-16", "review 2026-11-03 RR-04-05" "since 2026-11-01", "until 2026-11-03", httpclient는 지웠다 1101/05-16(capability 완료 기준 5가 영역 전체에서 지켜지지 않는다, 05-outbound-capabilities.md), 1103/RR-04-05(Redis 멱등성 계약의 실서버 실행이 어느 게이트에도 없다, 04-outbound-capabilities.md)
src/adapter/outbound/cache-redis/CLAUDE.md:186~187(줄바꿈으로 갈림) "review 2026-11-03 README §4, RR-04-02" "decided 2026-11-03" 1103/RR-04-02(캐시 조건부 쓰기가 멱등성·rate-limit·lease와 SCRIPT lane을 나눠 쓴다, 04-outbound-capabilities.md). 결정은 1103 README 4절(위임), 결정 색인 2.4 「Redis 연결 예산」
src/adapter/outbound/cache-redis/CLAUDE.md:190 "RR-04-10" 지웠다 1103/RR-04-10(DEGRADED 정렬 순서를 상태를 내지 않는 leaf가 싣는다, 04-outbound-capabilities.md)
src/adapter/outbound/httpclient/CLAUDE.md:27 "decision 9 (2026-09-25)" "the 2026-09-25 owner decision" 결정 9(httpclient reactive 스택 삭제). 결정 색인 2.7
src/adapter/outbound/identifier/CLAUDE.md:22 "review 2026-11-01 06-06" 지웠다 1101/06-06(application EventId 문법과 platform MessageId(UUID)가 다르다, 06-messaging.md)
src/adapter/outbound/identifier/CLAUDE.md:24 "README, review 05-21" "README" 1101/05-21(identifier leaf: 이름·문서가 내용과 맞지 않는다, 05-outbound-capabilities.md)
src/adapter/outbound/identifier/CLAUDE.md:32, src/adapter/outbound/persistence-mongo/CLAUDE.md:53~54(줄바꿈), src/messaging/CLAUDE.md:33, src/grpc/CLAUDE.md:44, src/grpc-advanced/CLAUDE.md:21, src/shared-contract/CLAUDE.md:34 "review 2026-11-01 01-11"(shared-contract는 "…, decision in the review README §15") 지웠다. shared-contract는 "decided 2026-11-03" 1101/01-11(공용 다이제스트 헬퍼가 있는데 복사본이 남아 있고, 일부 leaf는 registry 때문에 복사가 강제된다, 01-core-and-feature-pattern.md). 결정은 1101 README 15절(2026-11-03, 위임), 결정 색인 2.2 「edge 없는 복사본」
src/adapter/outbound/messaging/CLAUDE.md:42 "owner decision 29" "owner decision 2026-09-25" 결정 29(messaging 카드 검증기의 YAML 라이브러리는 테스트에서만). 결정 색인 2.6
src/adapter/outbound/persistence-fileserver/CLAUDE.md:15, src/adapter/outbound/persistence-notification/CLAUDE.md:9 "review 04-16" 지웠다 1101/04-16(notification·fileserver leaf에 가까운 안내 문서가 없고 패키지가 평평하다, 04-persistence.md)
src/adapter/outbound/persistence-fileserver/CLAUDE.md:26 "review 04-17" 지웠다 1101/04-17(미리 정한 UUID + primitive long version이라 save()가 merge로 동작한다, 04-persistence.md)
src/adapter/outbound/persistence-fileserver/CLAUDE.md:58~59 "added in review 2026-11-03 RR-01-04" "added on 2026-11-03" 1103/RR-01-04(application-fileserver 저장 포트 9개 중 7개는 공유 계약이 없다, 01-core-application.md)
src/adapter/outbound/persistence-fileserver/CLAUDE.md:64 "review 04-04" 지웠다 1101/04-04(실 PostgreSQL lane 9개가 어떤 게이트·workflow에서도 돌지 않는다, 04-persistence.md)
src/adapter/outbound/persistence-notification/CLAUDE.md:20 "review RR-03-09" 지웠다 1103/RR-03-09(notification 엔티티의 변경 메서드가 public이 됐다, 03-persistence.md)
src/adapter/outbound/persistence-notification/CLAUDE.md:40 "owner decision 33" "owner decision 2026-09-25" 결정 33(caller 트랜잭션 guard: persistence-jpa edge, CallerTransaction 하나). 결정 색인 2.2
src/adapter/outbound/support/CLAUDE.md:32 "review 15절, r3-I" "decided 2026-11-03" 1101 README 15절(2026-11-03) 「선택 숫자 설정의 빈 env 값 (r3-I 발견)」 행. r3-I는 3라운드 수정 묶음이다. 결정 색인 2.6 「빈 env 값」
src/app-bootstrap/CLAUDE.md:49 "BOOT-006 / BOOT-007" 리뷰 문서 경로만 남겼다 docs/reviews/2026-09-07-app-bootstrap-module-code-review.md의 BOOT-006(패키지 분류가 두 축으로 섞이고 Settings 배치 규칙이 없다), BOOT-007(같은 분해 문제를 두 방식으로 푼다)
src/messaging/CLAUDE.md:29 "S7-#5b" "2026-09-25 리뷰 후속 작업에서 나눴다" 2026-09-25-review-followup-status.md S7-#5b 행(한 leaf가 relay 로직·PG repository·admin journal을 함께 가졌다, W3-P18에서 완료)
src/messaging/CLAUDE.md:38, src/grpc/CLAUDE.md:50, src/grpc-advanced/CLAUDE.md:25, src/shared-contract/CLAUDE.md:31~32 "MSG-023 §6.2", "MSG-023" "2026-08-14 messaging 모듈 리뷰 뒤 소유자가 정한 배치" 등 docs/reviews/2026-08-14-messaging-module-code-review.md MSG-023(module 이름·폴더 구조와 canonical 정책 문서가 실제 구조를 설명하지 못한다). vendored 플랫폼은 Clean Architecture 계층이 아니라는 결정은 1101/06-messaging.md 머리의 "소유자 결정 유지" 줄
src/messaging/CLAUDE.md:43 "review 2026-11-01 06-01" 지웠다 1101/06-01(다시 시도하면 될 거부를 relay가 즉시 DEAD로 보낸다, 06-messaging.md)
src/messaging/CLAUDE.md:66 "재리뷰 2026-11-03 RR-05-07" "2026-11-03" 1103/RR-05-07(vendored 제품 안에 두 재시도 규칙이 생겼고 고른 이유가 제품 쪽에 없다, 05-messaging.md)
src/messaging/CLAUDE.md:98, :113, src/grpc/CLAUDE.md:98 "MSG-015", "MSG-015 cutover는 끝났다(2026-09-28, 소유자 결정 7)", "MSG-015(bridge 부재)" "cutover 완료", "application bridge cutover는 2026-09-28에 끝났다(2026-09-25 소유자 결정)", "bridge 부재(2026-08-14 messaging 모듈 리뷰)" MSG-015(기존 application/runtime과 신규 platform 사이에 semantic bridge와 cutover 권한이 없다, 같은 messaging 리뷰). 결정 7(outbox append를 canonical OutboxAppendPort로 통일)
src/messaging/CLAUDE.md:140 "MSG-022" 지웠다 MSG-022(experimental adapter가 class 이름 문자열로 오류를 추측한다, 같은 messaging 리뷰)
src/grpc/CLAUDE.md:167, :169 "03-11 (b)", "The review", "re-review 2026-11-03, RR-02-07" "option (b)", "The 2026-11-01 maturity review", "(b) was chosen on 2026-11-03" 1101/03-11(app.grpc.platform.operation-ledger-enabled가 검증만 통과시키고 key를 처리하는 코드가 없다, 03-inbound-realtime-graphql-grpc.md)의 대안 (a)·(b), 1103/RR-02-07(같은 문제를 다시 본 발견, 02-inbound-transports.md). 고른 안은 ADR-GRPC-004
src/grpc/CLAUDE.md:185 "re-review RR-02-04" ADR 이름만 남겼다 1103/RR-02-04(ledger에 시도 구분이 없어 takeover 뒤 옛 owner의 기록이 새 시도를 덮는다, 02-inbound-transports.md)
src/grpc-advanced/CLAUDE.md:64 "리뷰 2026-09-24 S5-lead-4" "2026-09-25 리뷰 후속 작업에서 삭제했다" 2026-09-25-review-followup-status.md S5-lead-4 행(release·promotion gate가 websocket·grpc에도 반복되는지, W3-P16에서 삭제). 같은 ID가 docs/runbooks/grpc-advanced-capabilities.md와 docs/adr/ADR-GRPC-ADV-001-capability-promotion-is-per-capability.md에 남아 있다(검사 대상 밖)
src/shared-contract/CLAUDE.md:27 "review X2-P1-5, X2-P1-4b, X1-#9" "moved here in the 2026-09-25 review follow-up" 2026-09-25-review-followup-status.md의 X2-P1-5(SHA-256 보일러플레이트 → Sha256), X2-P1-4b(서명 헬퍼만 shared-contract로), X1-#9(Backoff 계산식 10개 → Backoff). 셋 다 W3-P19

scripts/check-work-docs.py에 더하고 고친 것(2026-11-07):

  • 기본 검사 대상: AGENTS.md와 src/**/CLAUDE.md(build 출력 밖)를 더했다. AGENTS.md는 링크 검사에도 더했다(lychee 범위 밖이다).
  • 새 패턴 넷: 모듈 리뷰 발견(MSG-023, BOOT-006 — 접두어는 docs/reviews/에서 세 자리 번호로 쓰인 여섯), 리뷰 후속 발견(S6-#10a, X2-P1-5, S5-lead-4), 고른 대안이 붙은 발견 번호(03-11 (b)), 영어 리뷰 README 절(review README §15). 「결정 N」 패턴에 영어 decision 9를 더했다.
  • 고친 오탐: 날짜로 쓴 결정(owner decision 2026-11-06, 소유자 결정 2026-11-07)은 잡지 않는다.
  • 줄바꿈 검사: 한 줄에서 안 걸려도 다음 줄과 이었을 때 줄 경계를 넘는 ID((review ↵ 2026-11-01 07-10))를 잡는다. 이번에 2줄(web·persistence-mongo)이 이 꼴이었다. persistence-fileserver·cache-redis의 갈린 괄호는 둘째 줄의 RR- 접두어가 따로 잡혔다.
  • 오탐 시험(docs-writing.md 4절 12단계): 잡아야 할 문장 10개는 모두 잡혔다. 잡지 말아야 할 문장 8개 중 하나가 걸렸다: 일부러 만든 "line 10-12 (b)"(콜론 없는 줄 범위 뒤 대안 표시)다. repo에는 그 꼴이 없어 그대로 뒀다. docs/reviews/** 밖 전체에 돌리면 새로 125줄이 걸린다. 모두 검사 대상 밖(모듈 README, ADR, docs/httpclient/ 등)의 실제 ID이고, 검사 대상 안의 오탐은 0이다.

문서 2단계 통합(2026-11-07)에서 걷어낸 것: 번역한 진입 문서에 단독 번호(07-08처럼 짝 하나)로 남은 이력 ID 넷이다. 검사 패턴은 단독 번호를 일부러 잡지 않는다(범위나 절 번호와 구별할 수 없다). 줄 번호는 커밋 9c4ca9f3의 줄이다.

원래 위치 원래 괄호 지금 본문 근거
src/adapter/outbound/persistence-jpa/CLAUDE.md:156 "(07-08)" "2026-11-01 성숙도 리뷰 뒤로. 기본 조립 루트가 고르지 않은 capability의 설정을 알면 안 된다" 1101/07-08(기본 조립 루트가 아직 선택 capability를 안다, 07-bootstrap-composition-config.md)
src/app-bootstrap/CLAUDE.md:63 "07-08" "2026-11-01 성숙도 리뷰 뒤로 bootstrap 밖" 같은 1101/07-08. 그 수정 표가 DurableOperationConfig를 composition:* 모듈로 옮겼다
src/platforms/grpc/CLAUDE.md:145 "(11-M9)" "2026-09-18 리뷰가 찾은 문제" docs/reviews/2026-09-18-techlead-review/11-grpc-platform.md M9(starter가 JPA를 무조건 끌고 온다)
src/platforms/messaging/CLAUDE.md:55 "06-01 수정" "다시 시도하면 될 거부를 relay가 즉시 DEAD로 보내던 결함의 수정(2026-11-01 성숙도 리뷰 뒤)" 1101/06-01(06-messaging.md)

11. cold-read 시험 2회차 빈틈 처리 (2026-11-07)

2026-11-07 round7 수정과 통합, round8 확인 리뷰를 시험으로 돌렸다. 이력 없는 세션 9개가 1회차 수정을 넣은 매뉴얼(기준 73d39212, 통합과 리뷰는 83a12f66)로 일했다. 9개 모두 일은 끝냈고, 매뉴얼에서 답을 못 찾은 곳이 52건 나왔다(1회차 35건). 코드 수정 과제에서 같은 질문이 되풀이됐다. 아래는 공유 노트(~/.config/Claude/side-session-notes/local_fcd89c34-c754-4c5b-a38f-fa322834286f/)의 「매뉴얼에서 답을 못 찾은 곳」과 시험 기록(design-docs delegation-loop/trials/2026-11-07-*.md)의 「질문」 표를 한 줄씩 처리한 결과다. 기준 커밋 83948d58.

  • 세션과 출처 번호: F1 r8-f1-transport-errors, F2 r8-f2-arch-rules, F3 r8-f3-persistence, F4 r8-f4-idempotency, F5 r8-f5-small-fixes(결함 수정 다섯), M c-t4-2-manual-ids(문서), I r8-integration(통합과 전체 게이트), A r8-review-a(정본 확인 리뷰어), B r8-review-b(다른 확인 리뷰어). F1-3은 F1 시험 기록 「질문」 표의 3번이다(노트의 순서와 같다). A는 노트 15와 2차의 추가 1건(A-6), B는 노트 11절의 15다. B의 시험 기록 「질문」 표는 "노트에 절이 없음"이라고 적었지만 노트 11절에 다섯 건이 있다.
  • 두 세션 이상이 같은 질문을 했으면 한 행으로 묶고 「세션」 칸에 수를 적었다. 묶은 행이 먼저다.
  • 처리 칸: 고침(고친 곳) / 고치지 않음(이유) / 소유자 결정 필요. 「고침(기본값)」은 이 수정이 정하고 결정 색인에 기본값으로 남긴 것이다(소유자가 뒤집을 수 있다).
  • 수정 과제의 답(round8 발견을 어떻게 고칠지)은 매뉴얼에 쓰지 않았다. 다음 시험이 그 과제다.
# 출처 세션 빈틈 처리
R2-1 F1-3, F2-3, F3-2, F4-5 4 desktop에서 spotlessApply로 고친 형식을 노트북 트리로 가져오는 절차가 없다. 첫 GREEN이 형식 위반으로 실패한 세션도 있다 고침 — operate.md 4.1절 「push 전에 검증하기」(형식 맞추기 명령 세 줄, 두 트리 해시 대조, 그 트리에서 게이트)
R2-2 F1-6, F3-6, F5-2, M-4 4 커밋 단위가 두 문서에서 다르다(commit-and-pr.md "논리 변경 하나", improve.md "묶음마다 커밋 하나") — 모순. 리팩터링 추출을 따로 커밋하나, 나눈 중간 커밋도 검증하나, 검사를 넓히는 커밋은 언제 두나 고침(기본값) — docs/work/README.md 4절(논리 변경마다, 리팩터링은 앞 커밋, 커밋마다 그 검사), improve.md 4.4절(묶음은 브랜치 하나), operate.md 4.1절(중간 커밋은 바뀐 leaf check, 무거운 묶음은 마지막 트리), docs-writing.md 4절 12단계(검사를 넓히는 커밋은 문서 커밋 뒤), reference/decisions.md 2.1 「커밋 단위」(기본값)
R2-3 F4-6, F3-4, I-2 3 테스트 수를 어디서 세나(성공한 Gradle 로그에 없다). 같은 worktree의 다음 실행이 결과 XML을 덮어써 다시 셀 수 없다 고침 — reference/gates.md 4절 「테스트 수 세기」(복사와 세는 명령, desktop에서 시험), operate.md 4.1절, docs/work/README.md 6절
R2-4 F2-1, F3-1, F4-3 3 RED가 없는 수정(문서를 동작에 맞춤, 계약만 넓힘)은 무엇을 증거로 남기나 고침 — improve.md 4.2절 3단계 아래 줄, 5절, 8절 RED 칸, design-docs conventions/work-thinking-order.md 1절, 스킬 research-first 4절
R2-5 A-2, B-1, I-4 3 수정 세션의 「범위 밖에서 본 것」이 README 남은 항목인지, 다음 확인 리뷰의 입력인지, 누가 판정하나(Declined와 같은 취급인가) 고침(기본값) — improve.md 4.1절 9단계, reference/review-criteria.md 10절(확인 리뷰 문서 「넘어온 항목 판정」, 「확인 리뷰 라운드의 README 절」 끝 문단), delegate.md 4.1절, reference/decisions.md 2.1 「넘어온 「범위 밖」 항목」, design-docs conventions/delegation-loop.md 6절
R2-6 F1-4, F4-7 2 앞 실행(같은 worktree의 UP-TO-DATE, 같은 트리 해시의 이전 실행)을 통과 증거로 써도 되나 고침 — reference/gates.md 4절 「앞 실행을 증거로 쓰기」. 3절 「실제로 돌았음을 보이기」가 4절을 가리킨다
R2-7 F1-2, F2-2 2 brief의 "pull request 단계 게이트"가 어느 명령들인지 한 곳에 없다 고침 — reference/gates.md 3절 「단계별 묶음」 표(PR·main·라운드 끝). F2가 찾지 못한 buf job은 3절 (다)에 이미 있다(F2가 읽은 73d39212 뒤에 더해졌다)
R2-8 F1-5, F4-2 2 "같은 원인의 다른 자리를 찾는다"와 "범위 밖 결함을 고치지 않는다"의 경계 고침 — improve.md 4.2절 5단계(brief 영역 안이고 공개 동작이 그대로면 함께 고친다. 아니면 「범위 밖」에 권하는 안과 적는다)
R2-9 F4-4, F5-3 2 소유자가 이미 정한 큰 변경도 따로 멈추나. 규칙이 스킬과 design-docs에만 있고 repo 매뉴얼에 없다 고침 — docs/work/README.md 2절(정본 conventions/work-thinking-order.md 2.3절과 같은 뜻)
R2-10 F2-4, F5-1 2 아직 릴리스하지 않은 업그레이드 안내 행이 같은 표면을 다룰 때 고치나 더하나, 머리 「커밋:」 목록, ! 고침(기본값) — improve.md 4.2절 7단계 아래 줄, reference/decisions.md 2.7 「아직 합치지 않은 업그레이드 안내」
R2-11 A-4, B-4 2 탐침이 그 source set에 없는 의존성을 써야 할 때 build.gradle·lockfile을 바꿔도 되나(A는 바꾸지 않고 E1, B는 버릴 worktree에서 바꿈) 고침 — reference/gates.md 2절 「탐침」 셋째 줄(버릴 worktree에서만, 바꾼 줄을 적는다, 안 하면 E1), improve.md 4.1절 5단계
R2-12 F1-1 1 improve.md 7절 "응답 코드를 바꾸면 묻는다"가 레지스트리가 이미 약속한 응답으로 코드를 맞추는 경우(500→409)에도 해당하나 고침(기본값) — improve.md 7절 첫 줄, reference/decisions.md 2.3 「약속한 응답으로 맞추기」
R2-13 F1-7 1 결정 색인 2.3절 표에 날짜 칸이 없다 고침 — reference/decisions.md 2절 머리(날짜는 「누가」나 「출처」 칸에). 기존 행은 이미 출처 칸에 날짜가 있어 표 모양은 두었다
R2-14 F2-5 1 리뷰 권장안과 다른 안을 고르면 누가 확인하나 고침 — improve.md 3절 대안 줄, 8절 「정한 기본값」 칸(보고에 적어 확인 리뷰와 맡긴 쪽이 본다. 공개 동작이 다르면 묻는다)
R2-15 F3-3 1 임시 RED 메서드에도 Error Prone 규칙(CheckReturnValue)이 오류로 걸린다 고침 — improve.md 9절 strict lane 탐침 줄
R2-16 F3-5 1 이미 문서화된 규칙을 검사가 더 엄하게 지키게 바꾸면 「파생 서비스가 따라 고쳐야 하는 변경」(큼·!)인가 고침(기본값) — improve.md 4.2절 7단계(!와 안내 행은 단다, 크기는 올리지 않는다), reference/decisions.md 2.7 「검사를 더 엄하게 하는 수정」
R2-17 F3-7 1 ArchUnit fixture도 testQualityCheck(SpotBugs)가 분석하고, Lombok 클래스를 상속한 fixture는 실패한다 고침 — reference/gates.md 2절 표(「테스트 코드(ArchUnit fixture 포함)」)와 그 아래 줄
R2-18 F3-8 1 optional 빌드 leaf의 RED·탐침에 main 리소스 임시 파일(임시 마이그레이션)을 두는 법 고침 — improve.md 4.2절 3단계(임시 파일은 main 리소스든 그 worktree에만)
R2-19 F4-1 1 brief의 "같은 핸들"이 넘겨받기 전 핸들인지 적용한 핸들인지 정해지지 않았다 고침 — brief를 쓰는 규칙: design-docs conventions/delegation-loop.md 4.2절(결정을 옮길 때 대상이 둘 이상으로 읽히면 경우마다 적는다). repo 매뉴얼이 아니라 brief 문구의 빈틈이다
R2-20 M-1 1 brief 완료 기준(대조 테스트 통과)과 playbook(읽는 테스트가 없으면 lane을 돌리지 않음)이 다르다 고침 — docs-writing.md 4절 9단계, reference/gates.md 2절(brief가 lane을 정했으면 돌린다)
R2-21 M-2 1 이력 표기 정의가 없다(「1라운드」, P30·W3-P30) 고침 — 이 문서 머리말 「더 오래된 표기」
R2-22 M-3 1 걷어낸 ID의 근거를 이 문서 어느 절에 더하나. 9절 T4-1 행을 고치나 고침 — docs-writing.md 4절 6단계(문서 묶음마다 절 하나, 다시 걷어내면 그 절에 표). T4-1 행은 기록이라 두었다(8절 둘째 표가 그 결과다)
R2-23 M-5 1 새 이력 패턴의 오탐을 어떻게 시험하고 어디까지 받아들이나 고침 — docs-writing.md 4절 12단계 아래 줄. 이번 패턴 추가에 그대로 적용했다(10절 끝)
R2-24 I-1 1 mainCheck 안 verifyFeatureScaffold의 중첩 빌드에는 --no-build-cache가 넘어가지 않아 FROM-CACHE 0을 만들 수 없다 고침 — reference/gates.md 3절 「실제로 돌았음을 보이기」 아래 줄(바깥 0, 중첩 빌드 N을 따로 적는다)
R2-25 I-3 1 라운드 끝 묶음의 태그 단계 범위(release.yml의 다른 gate job) 고침(기본값) — reference/gates.md 3절 「단계별 묶음」 아래 줄, reference/decisions.md 2.7 「라운드 끝 태그 단계 범위」
R2-26 I-5 1 확인 리뷰 README 안의 하위 절 순서, 처리 표 칸(improve.md 8절과 brief가 다름) 고침 — reference/review-criteria.md 10절 「확인 리뷰 라운드의 README 절」(여덟 절의 순서, 처리 표 칸, brief가 먼저)
R2-27 I-6 1 trivy-fs job은 trivy를 내려받아 설치한다. 설치까지 하나 고침(기본값) — operate.md 4.1절(설치 단계는 따라 하지 않는다), reference/gates.md 3절 (다) 표, reference/decisions.md 2.1 「desktop 도구 설치」, design-docs conventions/delegation-loop.md 11절
R2-28 A-1 1 독립 리뷰어 둘일 때 정본 리뷰어의 색인 검사: 매뉴얼은 rc=0을 요구하고 README 색인 절은 총괄이 쓰게 한다 — 모순(발견 1103/RR8-06-01) 고침 — scripts/check-review-index.py --extra-index, improve.md 4.1절 7·8단계와 5절, delegate.md 4.1절, reference/decisions.md 2.1 「리뷰 README 분담」. 시험: 정본 리뷰어 커밋 27260ad0의 리뷰 폴더에 옵션 없이 rc=1(180 중 172), 리뷰어 A의 색인 표(r8-review-a-probes/index-table.md)를 넘기면 rc=0(180/180). 리뷰가 권한 "임시 사본" 절차 대신 옵션을 골랐다: 복사·붙이기 단계 없이 명령 하나로 같은 대조를 한다
R2-29 A-3 1 확인 리뷰 범위에 결함 수정이 아닌 커밋(매뉴얼 수정)이 섞이면 그것도 보나("그 수정만 본다") 고침 — improve.md 4.1절 3단계(brief 범위의 커밋을 본다, 결함 수정이 아닌 커밋은 영역 하나로)
R2-30 A-5 1 strict lane에 --tests 필터로 탐침만 돌려도 되나 고침 — reference/gates.md 2절 「탐침」 둘째 줄(requires lane은 필터 없이. StrictTestLanePlugin의 required 검사가 고른 클래스가 다 돌지 않으면 실패시킨다)
R2-31 A-6 1 두 리뷰의 「이번 수정 / 이전부터」 분류가 다를 때 어느 쪽을 쓰나 고침 — reference/review-criteria.md 10절 「ID」 끝 줄(정본 리뷰어가 근거를 붙여 정하고 차이를 대응표에)
R2-32 B-2 1 확인 리뷰가 수정 세션의 「정한 기본값」을 어떻게 다루나, README·결정 색인으로 옮겨졌는지 누가 보나(round8 Important 회귀 하나가 옮겨지지 않은 기본값에서 나왔다) 고침 — improve.md 4.1절 2단계(옮겨지지 않은 공개 동작 기본값은 발견), delegate.md 4.1절(총괄이 옮긴다), reference/review-criteria.md 10절, design-docs conventions/delegation-loop.md 6절
R2-33 B-3 1 상한을 넘는 범위를 brief가 노트 하나로 받았을 때 문서 모양 고침 — improve.md 4.4절(출력 파일 하나면 그 안에 단위마다 절)
R2-34 B-5 1 탐침 rc를 읽는 법(결함 동작을 단언한 탐침과 약속을 단언한 탐침이 섞임) 고침 — reference/gates.md 2절 「탐침」 첫 줄, reference/review-criteria.md 10절 「실행한 명령과 결과」 칸
  • 합계: 52건, 34행. 고침 34행(그중 기본값 7행), 고치지 않음 0, 소유자 결정 필요 0.
  • 소유자 결정(2026-11-07)으로 한 일: 이력 ID 0 규칙을 진입 문서로 넓혔다(10절, 결정 색인 2.1 「이력 ID 0 규칙의 범위」).
  • 「자주 하는 실수」에 넣은 줄: improve.md(탐침의 Error Prone을 기존 줄에 더함).