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').
This commit is contained in:
DongHyeonka
2026-11-07 18:27:30 +09:00
parent 65749238b2
commit 4fc586478c
5 changed files with 17 additions and 5 deletions
+10
View File
@@ -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`.
@@ -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를 거절한다.
+1 -1
View File
@@ -60,7 +60,7 @@
`WebSecurityAutoConfiguration`, `WebMethodSecurityAutoConfiguration`)과 support
(`OutboundSupportConfig`)는 자기 `AutoConfiguration.imports`로 들어온다. `autoconfigure/<name>/`에
남는 것은 모든 애플리케이션에 필요한 애플리케이션 조립인 `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`
+1 -1
View File
@@ -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를 켠다.
+2 -1
View File
@@ -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`로.