매뉴얼 보강 묶음이 각 빈틈을 어디에 넣었는지, 넣지 않았으면 왜인지를 다음 cold-read 시험과 총괄 대조가 찾을 곳이 없다. 1·2회차는 evidence.md 9·11절에 처리 표를 두었다. 같은 방식으로 12절을 더한다. - 22행: 3회차 빈틈 9건(R3-1~R3-8), 장부의 통합·배치·문서·번역 세션 빈틈, 공유 노트 목록, repo-structure 세 문서의 매뉴얼 규칙. 고침 21행(기본값 2), 고치지 않음 1행(design-docs 몫). - 리뷰 ID와 세션 이름은 이 근거 문서에만 둔다(매뉴얼 본문 이력 ID 0 규칙). 검증: check-work-docs, check-docs rc=0.
415 lines
77 KiB
Markdown
415 lines
77 KiB
Markdown
# 근거와 이력
|
|
|
|
`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차 재리뷰(폴더 바로 아래 `01`~`07` 영역 문서)와 round2의 `01`~`03` 영역 문서(1차 번호를 이어 썼다), `RR2-`는 round2의 `04` 영역 문서, `RR3-`~`RR7-`는 round3~round7이다. `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`(1~5단계), `delegation-loop/02-design.md`(6단계, 4·5·6·7·10절). 2026-11-06 소유자가 결정 D1~D14를 모두 권하는 안대로 승인했다.
|
|
- 공통 정본: 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-02`~`06`·`08`·`09`, `RR6-02-02`·`04`·`05`, `RR6-03-02`~`05`, `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는 노트 1~5와 2차의 추가 1건(A-6), B는 노트 11절의 1~5다. 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을 기존 줄에 더함).
|
|
|
|
## 12. cold-read 시험 3회차 빈틈과 쌓인 매뉴얼 규칙 처리 (2026-11-07)
|
|
|
|
하네스 재설계를 적용한 묶음(design-docs `harness/01-harness-design.md`, 소유자 결정 2026-11-07 「매뉴얼 보강은 한 묶음」)에서 함께 넣었다. 원천은 넷이다: cold-read 3회차(수정 세션 넷 `r9-g1`~`r9-g4`의 빈틈 9건), 위임 장부(design-docs `delegation-loop/ledger.jsonl`)의 `"to": "manual"` 줄 중 백엔드 몫, 공유 노트의 매뉴얼 보강 목록, design-docs `repo-structure/01-backend-layout.md` 10·12절·`02-docs.md` 9절·`03-ci.md` 8절.
|
|
|
|
- 처리 칸: 고침(고친 곳) / 이미 있음(그 자리) / 고치지 않음(이유). 「고침(기본값)」은 이 묶음이 정하고 결정 색인에 기본값으로 남긴 것이다.
|
|
- 1·2회차 빈틈(장부 6~22줄)은 9절·11절에서 이미 처리했다. 다시 넣지 않았다.
|
|
|
|
| # | 출처 | 빈틈 | 처리 |
|
|
| --- | --- | --- | --- |
|
|
| R3-1 | G1-1 | brief가 옮긴 결정 설명과 결정 원문이 다를 때 무엇을 따르나 | 고침 — `reference/decisions.md` 1절 1(원문을 따르고 차이를 보고) |
|
|
| R3-2 | G1-3 | desktop 잠금을 여러 세션이 기다릴 때 순서와 시간 | 고침 — `reference/gates.md` 4절 「공유 잠금 기다리기」 |
|
|
| R3-3 | G2-1 | 커밋하는 수정에서 lockfile을 손으로 고쳐도 되나 | 고침 — `reference/gates.md` 2절 탐침 첫 줄(desktop `resolveAndLockAll --write-locks`) |
|
|
| R3-4 | G2-2 | desktop에서 자기 실행을 멈추는 법(`pkill -f`가 ssh 세션을 끊음) | 고침 — `operate.md` 4.1절 |
|
|
| R3-5 | G3-1, G3-3 | 절차 문서 결함과 대기 결함의 RED 모양 | 고침 — `improve.md` 4.2절 3 |
|
|
| R3-6 | G3-2 | 검증 뒤 앞 커밋에 형식 수정을 넣는 법 | 고침 — `operate.md` 4.1절(커밋을 나누기 전에 확인, 편집 훅이 파일마다 맞춤) |
|
|
| R3-7 | G4-1 | 그 코드를 지키는 lane을 찾는 법 | 고침 — `improve.md` 4.2절 8 |
|
|
| R3-8 | G4-2 | upgrade 안내 「커밋:」 줄을 여러 묶음이 고칠 때 | 고침 — `delegate.md` 4.2절 표 |
|
|
| R3-9 | 장부 r9 통합(5건) | OOM 재시작 거짓 통과, 자원 의존 실패의 판정, `--no-build-cache` 차이, zsh 파이프 rc, 처음 켜진 lane의 이전 실패 | 고침 — `reference/gates.md` 6절 표·4절 「원래 있던 실패 가리기」·3절, `operate.md` 4.1절, `reference/gates.md` 3절 (나) 5 |
|
|
| R3-10 | 장부 t1(5건) | smoke 이미지 재사용, `if` 안 `set -e`, leaf 데이터 폴더, 트리 해시로 커밋에 묶기, 코드 주석 언어 | 고침 — `reference/gates.md` 4절·6절, `new-feature.md` 6절, 이미 있음 — `operate.md` 4.1절 「push 전에 검증하기」, 고침 — `docs-writing.md` 4절 4 |
|
|
| R3-11 | 장부 d1(5건) | 이동 커밋과 검사, Gradle 밖 검사의 자리, 줄기만 하는 예외 목록, MANIFEST, scripts 시험 위치 | 고침 — `docs-writing.md` 4절 13·14, `reference/gates.md` 7절 1·8, 이미 있음 — `docs/README.md` 「문서 검사」 |
|
|
| R3-12 | 장부 i1(4건+2) | 병합에서만 생긴 수정, FROZEN 지문, smoke 이미지, 순서 의존 재현, check-docs 줄 누락, lychee·buf·trivy | 고침(기본값) — `delegate.md` 4.2절(병합 커밋에는 충돌 해결만), 이미 있음 — `docs/README.md`, 고침 — `reference/gates.md` 4절 둘, `docs-writing.md` 4절 10·5절·8절, `review-criteria.md` 9절, `reference/gates.md` 3절 (다) |
|
|
| R3-13 | 장부 i2(4건) | smoke 이미지 출처, trivy DB 받기, 문체 검사의 주인, 테스트 Javadoc | 고침 — `reference/gates.md` 4절, 고침(기본값) — `operate.md` 4.1절·결정 색인 「desktop 도구 설치」, 고침 — `check-docs.py` `style`, `improve.md` 4.2절 6 |
|
|
| R3-14 | 장부 d2a, d2c(4건) | 레지스트리 yaml 번역, 영어 절 제목 인용, 머리말 없는 runbook, `@DisplayName` 범위 | 고침 — `docs-writing.md` 4절 14, `.claude/rules/java-tests.md` 규칙 2 |
|
|
| R3-15 | 장부 41(프론트 총괄) | brief의 「충돌 없음」, 중복 PR | 고침 — `delegate.md` 9절 |
|
|
| R3-16 | 공유 노트 | 결정 기록 머리 둘째 줄이 번역한 ADR에 맞지 않음 | 고침 — `check-docs.py` `DECISION_LABEL`, `docs/README.md`, ADR 머리 블록. design-docs `docs-system.md` 4.1절과 프론트는 이 repo 밖 |
|
|
| R3-17 | 공유 노트 | `check-repo-layout.py` 설명과 지도 범위, `template-vs-consumer.md` 분류 | 고침 — 루트 `AGENTS.md` 지도, `check-repo-layout.py`, `docs/ci-cd/template-vs-consumer.md` |
|
|
| R3-18 | 01-backend-layout 10.1·10.3 | 리뷰 기준의 최상위 폴더·참조 0 파일·배포·개발자 경험·삭제 가능성, 최상위 폴더 일의 크기, 테스트 환경 위치 | 고침 — `review-criteria.md` 관점 2·9·18·20·27, `README.md` 2절, `new-feature.md` 6절 |
|
|
| R3-19 | 01-backend-layout 12절 | 개발 환경의 뜻 | 고침 — `reference/terms.md`(새) |
|
|
| R3-20 | 02-docs 9절 | 용어집, 모듈 README 칸, 리뷰의 문서 기준, Important 예시 | 고침 — `reference/terms.md`, `docs/README.md` 「모듈 README」, `review-criteria.md` 관점 4·9·20·23·26·3절 |
|
|
| R3-21 | 03-ci 8절 | workflow·스크립트를 더하는 기준, 빌드·CI 비례성, 같은 장치 결함 되풀이, runner 사실 | 고침 — `reference/gates.md` 7절, `review-criteria.md` 관점 4·20·21, `improve.md` 7절·`delegate.md` 4.2절, `operate.md` 4.1절 |
|
|
| R3-22 | 장부 1·33·43줄, 01 10.2·12절 6, 02·03의 design-docs 몫 | 결정 질문 상자, 훅 빈틈, live 클러스터 적용, 성숙도 리뷰 가이드, design-docs README | 고치지 않음 — design-docs(총괄) 몫. 이 repo 밖 |
|
|
|
|
- 합계: 22행. 고침 21행(그중 기본값 2), 고치지 않음 1행(이 repo 밖).
|
|
- 「자주 하는 실수」에 넣은 줄: `delegate.md` 둘.
|