From 4fc586478c30d84a82147888540985ab36e9c28e Mon Sep 17 00:00:00 2001 From: DongHyeonka Date: Sat, 7 Nov 2026 18:27:30 +0900 Subject: [PATCH] =?UTF-8?q?docs(claude):=20=EC=A7=84=EC=9E=85=20=EB=AC=B8?= =?UTF-8?q?=EC=84=9C=EC=97=90=20=EB=8B=A8=EB=8F=85=20=EB=B2=88=ED=98=B8?= =?UTF-8?q?=EB=A1=9C=20=EB=82=A8=EC=9D=80=20=EC=9D=B4=EB=A0=A5=20ID?= =?UTF-8?q?=EB=A5=BC=20=EB=82=B4=EC=9A=A9=EA=B3=BC=20=EB=82=A0=EC=A7=9C?= =?UTF-8?q?=EB=A1=9C=20=EB=B0=94=EA=BE=BC=EB=8B=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 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'). --- docs/work/evidence.md | 10 ++++++++++ src/adapter/outbound/persistence-jpa/CLAUDE.md | 5 +++-- src/app-bootstrap/CLAUDE.md | 2 +- src/platforms/grpc/CLAUDE.md | 2 +- src/platforms/messaging/CLAUDE.md | 3 ++- 5 files changed, 17 insertions(+), 5 deletions(-) diff --git a/docs/work/evidence.md b/docs/work/evidence.md index 7fc6ff72..96aaecf8 100644 --- a/docs/work/evidence.md +++ b/docs/work/evidence.md @@ -318,6 +318,16 @@ - 줄바꿈 검사: 한 줄에서 안 걸려도 다음 줄과 이었을 때 줄 경계를 넘는 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`. diff --git a/src/adapter/outbound/persistence-jpa/CLAUDE.md b/src/adapter/outbound/persistence-jpa/CLAUDE.md index cb4f403f..2fd3e384 100644 --- a/src/adapter/outbound/persistence-jpa/CLAUDE.md +++ b/src/adapter/outbound/persistence-jpa/CLAUDE.md @@ -153,8 +153,9 @@ driver 타입을 import하는 것이 없으므로, 그것들이 `.postgresql` `config/PersistenceVendorSettings`가 선택자를 enum으로 바인딩한다. 그래서 모르는 값은 두 조립 중 어느 것도 읽지 않고 `OutboxClaimRepository`가 없다는 오류로 나타나는 대신 기동 때 실패한다. 선택은 모듈이 정한다: 그 `config/module-defaults/persistence-jpa.yml`이 모든 profile에서 vendor를 PostgreSQL로, `spring.flyway.enabled`를 -`APP_FLYWAY_ENABLED`(true)로 기본 설정한다. 조립 루트의 profile 파일은 더는 그것을 다시 적지 않는다(07-08). H2는 -`bootRunH2` 태스크가 고르는, 개발자가 명시해서 빠지는 길이다. `PersistenceVendorProdSafetyValidator`(`startup`)는 어떤 +`APP_FLYWAY_ENABLED`(true)로 기본 설정한다. 조립 루트의 profile 파일은 더는 그것을 다시 적지 않는다(2026-11-01 +성숙도 리뷰 뒤로. 기본 조립 루트가 고르지 않은 capability의 설정을 알면 안 된다). H2는 `bootRunH2` 태스크가 +고르는, 개발자가 명시해서 빠지는 길이다. `PersistenceVendorProdSafetyValidator`(`startup`)는 어떤 속성 출처가 주든 prod에서 H2를 거절한다. `bootRunH2`에서는 멱등성 provider가 `disabled`나 `redis`여야 한다: `postgresql` provider는 기동 때 H2 data source를 거절한다. diff --git a/src/app-bootstrap/CLAUDE.md b/src/app-bootstrap/CLAUDE.md index 3ec72357..21ed43ce 100644 --- a/src/app-bootstrap/CLAUDE.md +++ b/src/app-bootstrap/CLAUDE.md @@ -60,7 +60,7 @@ `WebSecurityAutoConfiguration`, `WebMethodSecurityAutoConfiguration`)과 support (`OutboundSupportConfig`)는 자기 `AutoConfiguration.imports`로 들어온다. `autoconfigure//`에 남는 것은 모든 애플리케이션에 필요한 애플리케이션 조립인 `common`(시계)뿐이다. outbox relay, - 멱등성 executor, durable operation(유스케이스와 `/operations` endpoint, 07-08)은 + 멱등성 executor, durable operation(유스케이스와 `/operations` endpoint. 2026-11-01 성숙도 리뷰 뒤로 bootstrap 밖)은 `composition:outbox-relay`, `composition:idempotency`, `composition:durable-operation`이다. 각각 `runtimeOnly` 한 줄로 고르고, 자기 포트가 생기기 전에는 아무것도 만들지 않는다. capability의 role → permission 대응은 `config/security.yml`이 아니라 그 capability의 `config/module-defaults` diff --git a/src/platforms/grpc/CLAUDE.md b/src/platforms/grpc/CLAUDE.md index d79d4be7..3e128277 100644 --- a/src/platforms/grpc/CLAUDE.md +++ b/src/platforms/grpc/CLAUDE.md @@ -142,7 +142,7 @@ cd src ### durable operation 원장 채택 -`grpc-spring-boot-starter`는 JPA 원장 어댑터를 전이 의존으로 끌어오지 않는다(11-M9). durable +`grpc-spring-boot-starter`는 JPA 원장 어댑터를 전이 의존으로 끌어오지 않는다(2026-09-18 리뷰가 찾은 문제). durable operation 멱등성이 필요한 배포는 `:grpc:grpc-operation-ledger-jpa`를 직접 더하고, `GrpcOperationLedger` bean(`new JpaGrpcOperationLedger(repository)`)을 정의하고, 그 어댑터의 Flyway 위치 `db/migration/grpc`(V001 테이블, V002 보존 index, V003 claim attempt)를 넣고, 아래 flag를 켠다. diff --git a/src/platforms/messaging/CLAUDE.md b/src/platforms/messaging/CLAUDE.md index 705cc3f3..807a5890 100644 --- a/src/platforms/messaging/CLAUDE.md +++ b/src/platforms/messaging/CLAUDE.md @@ -52,7 +52,8 @@ registry edge를 주면 그 경계가 깨진다. 복사본을 고칠 때(키 길 publish를 거부한 뒤 멈추기 때문이다. `retryable`을 믿는 publisher가 그 몇 분 동안의 레코드를 영구 보류하지 않게 하려는 것이다. -06-01 수정이 이 제품에서 바꾼 것(모두 publish 경로, 소비 경로 동작은 그대로): +다시 시도하면 될 거부를 relay가 즉시 DEAD로 보내던 결함의 수정(2026-11-01 성숙도 리뷰 뒤)이 이 제품에서 바꾼 것(모두 +publish 경로, 소비 경로 동작은 그대로): - `KafkaPublishFailureClassifier`: 인증·인가 거부를 `retryable = true`로. - `DefaultMessagePublisher`: runtime이 없을 때의 거부(`PUBLISH_RUNTIME_UNAVAILABLE`)를 `retryable = true`로.