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').
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-round7이다. RR7-는 round31101 README, 1103 README는 각 폴더의 README.md다. 「결정 N」은 docs/reviews/2026-09-25-review-followup-status.md 「소유자 결정」의 N번이다.
더 오래된 표기:
- 「1라운드」·「2라운드」·「3라운드」:
1101README 13·14·15.1절의 수정 라운드(2026-11-01~03).r2-05a,r3-I처럼r<라운드>-<묶음>은 그 라운드의 수정 묶음 이름이다.r9-a,r10-02는1103README 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-docsdelegation-loop/02-design.md13절, D1~D14)이거나, leafCLAUDE.md가 이름을 댄 설계 기록(feature-*-contract등)의 결정 번호다. 그 설계 기록들은 이 repo에 없다(10절).
1. 이 매뉴얼이 나온 곳
- 조사와 설계: design-docs
delegation-loop/01-research.md(15단계),D14를 모두 권하는 안대로 승인했다.delegation-loop/02-design.md(6단계, 4·5·6·7·10절). 2026-11-06 소유자가 결정 D1 - 공통 정본: 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-145건을 "자리표시자 영역"으로 잡고 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.md4.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(확인 리뷰), Bc-t1-baseline(같은 리뷰를 옛 매뉴얼로, 기준선), T2c-t2-circuit-breaker(결함 수정), T3c-t3-error-codes(조사·설계 → 구현), T4c-t4-manual-ids(문서), T5c-t5-idempotency-opid(결함 수정), T6c-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.md4.1절 「독립 리뷰어 둘」·4.5절 1,delegate.md4.1·4.3절,reference/review-criteria.md10절 「ID」,reference/decisions.md2.1, design-docsconventions/delegation-loop.md3절 5·9절 M11,delegation-loop/metrics.md. - 「자주 하는 실수」에 넣은 줄:
improve.md(strict lane 탐침),operate.md(--rerun범위를 기존 줄에 더함, push 뒤 검증),docs-writing.md(--history0을 믿음),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.md4절 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, F2r8-f2-arch-rules, F3r8-f3-persistence, F4r8-f4-idempotency, F5r8-f5-small-fixes(결함 수정 다섯), Mc-t4-2-manual-ids(문서), Ir8-integration(통합과 전체 게이트), Ar8-review-a(정본 확인 리뷰어), Br8-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을 기존 줄에 더함).