소유자(2026-11-08)가 개인 도메인 이름(hyeonworks)을 공용 라이브러리에 쓰지 않기로 했다. 원래 이름 dev.caskeleton.grpc로 되돌리면 템플릿 재사용 체크리스트(「dev.caskeleton을 자기 패키지로 바꾼다」)가 파생 서비스의 라이브러리 import까지 깨뜨린다(설계 05 NS1의 단점). 그래서 둘 다 아닌 중립 이름 cakit을 쓴다(총괄 결정).
전
후
Maven group
com.hyeonworks.grpc
dev.cakit.grpc
Java 패키지
com.hyeonworks.grpc…
dev.cakit.grpc…
proto package
hyeonworks.grpc.common.v1
cakit.grpc.common.v1
생성 Java 패키지
hyeonworks.grpc.common.v1.generated
cakit.grpc.common.v1.generated
artifact
모듈 이름
그대로
고른 방법과 버린 대안
새 커밋 셋으로 바꾼다. 이력은 고쳐 쓰지 않는다(force push 없음).
생성 Java 패키지는 dev.cakit.grpc 아래가 아니라 cakit.grpc.common.v1.generated다. 「생성 코드는 손으로 쓴 루트와 겹치지 않는다」는 규칙을 GrpcContractGeneratedCodeTest가 고정한다. 이름만 바꾸는 PR에서 그 규칙까지 바꾸지 않았다. 총괄 지시의 「java_package는 Java와 같음」을 dev.cakit.grpc… 아래로 읽어야 한다면 그 시험과 함께 따로 바꾼다.
bufBreaking: proto 패키지를 바꾸면 깨짐이다. 지금까지는 깨짐이면 무조건 실패해서 이 PR도, 병합 뒤 main도 빨개진다. 기준과 HEAD 사이 커밋 하나가 BREAKING CHANGE: 꼬리말로 선언한 깨짐만 통과시키게 했다(d9d1cfb). 커밋 규칙이 이미 요구하는 표시이고 MAJOR의 근거다. 버린 대안: 첫 릴리스 전 검사 끄기(첫 태그 뒤 깨짐을 놓침), 마지막 릴리스 태그와 비교(한 번 선언한 뒤 다음 릴리스까지 모든 PR이 빨개짐).
위험과 영향
proto 패키지는 wire 이름이다. 아직 배포한 버전이 없어 깨질 소비자는 없다. 이 PR이 1.0.0 전의 마지막 이름 바꾸기다.
git grep -i hyeonworks에 둘이 남는다: Gitea 서버 주소 git.learn.hyeonworks.com(gradle.properties·README·runner), 기록 docs/adr/ADR-GRPC-002 본문의 「예전에는 hyeonworks」(기록 본문은 고치지 않는다).
SpotBugs 제외에서 템플릿 클래스(@RequiresPermission)를 가리키던 줄을 지웠다. 이 repo에는 그런 bean이 없다.
검증
desktop(~/x2-grpc-library, 이 브랜치 eed2d15): DESKTOP_RESULTS
buf 규칙: 이 브랜치 HEAD와 기준 bbe49ac — 깨짐을 알리고 rc=0. 같은 트리에 꼬리말 없는 메시지로 바꾼 버리는 사본 — rc=1.
## 무엇을, 왜
소유자(2026-11-08)가 개인 도메인 이름(`hyeonworks`)을 공용 라이브러리에 쓰지 않기로 했다. 원래 이름 `dev.caskeleton.grpc`로 되돌리면 템플릿 재사용 체크리스트(「`dev.caskeleton`을 자기 패키지로 바꾼다」)가 파생 서비스의 라이브러리 import까지 깨뜨린다(설계 05 NS1의 단점). 그래서 둘 다 아닌 중립 이름 `cakit`을 쓴다(총괄 결정).
| | 전 | 후 |
| --- | --- | --- |
| Maven group | `com.hyeonworks.grpc` | `dev.cakit.grpc` |
| Java 패키지 | `com.hyeonworks.grpc…` | `dev.cakit.grpc…` |
| proto package | `hyeonworks.grpc.common.v1` | `cakit.grpc.common.v1` |
| 생성 Java 패키지 | `hyeonworks.grpc.common.v1.generated` | `cakit.grpc.common.v1.generated` |
| artifact | 모듈 이름 | 그대로 |
## 고른 방법과 버린 대안
- 새 커밋 셋으로 바꾼다. 이력은 고쳐 쓰지 않는다(force push 없음).
- 생성 Java 패키지는 `dev.cakit.grpc` 아래가 아니라 `cakit.grpc.common.v1.generated`다. 「생성 코드는 손으로 쓴 루트와 겹치지 않는다」는 규칙을 `GrpcContractGeneratedCodeTest`가 고정한다. 이름만 바꾸는 PR에서 그 규칙까지 바꾸지 않았다. 총괄 지시의 「java_package는 Java와 같음」을 `dev.cakit.grpc…` 아래로 읽어야 한다면 그 시험과 함께 따로 바꾼다.
- `bufBreaking`: proto 패키지를 바꾸면 깨짐이다. 지금까지는 깨짐이면 무조건 실패해서 이 PR도, 병합 뒤 main도 빨개진다. 기준과 HEAD 사이 커밋 하나가 `BREAKING CHANGE:` 꼬리말로 선언한 깨짐만 통과시키게 했다(`d9d1cfb`). 커밋 규칙이 이미 요구하는 표시이고 MAJOR의 근거다. 버린 대안: 첫 릴리스 전 검사 끄기(첫 태그 뒤 깨짐을 놓침), 마지막 릴리스 태그와 비교(한 번 선언한 뒤 다음 릴리스까지 모든 PR이 빨개짐).
## 위험과 영향
- proto 패키지는 wire 이름이다. 아직 배포한 버전이 없어 깨질 소비자는 없다. 이 PR이 1.0.0 전의 마지막 이름 바꾸기다.
- `git grep -i hyeonworks`에 둘이 남는다: Gitea 서버 주소 `git.learn.hyeonworks.com`(gradle.properties·README·runner), 기록 `docs/adr/ADR-GRPC-002` 본문의 「예전에는 `hyeonworks`」(기록 본문은 고치지 않는다).
- SpotBugs 제외에서 템플릿 클래스(`@RequiresPermission`)를 가리키던 줄을 지웠다. 이 repo에는 그런 bean이 없다.
## 검증
- desktop(`~/x2-grpc-library`, 이 브랜치 `eed2d15`): DESKTOP_RESULTS
- buf 규칙: 이 브랜치 HEAD와 기준 `bbe49ac` — 깨짐을 알리고 rc=0. 같은 트리에 꼬리말 없는 메시지로 바꾼 버리는 사본 — rc=1.
- 이 PR의 `pr.yml` 실행 결과.
## 리뷰어가 볼 곳
- `scripts/buf.sh` breaking 분기, `docs/work/gates.md` 4절.
- 기계적으로 만든 부분: `c8f8721`(git mv로 폴더 이동, `com.hyeonworks` → `dev.cakit`, 그 밖의 `hyeonworks` → `cakit`, Gitea 주소 제외, desktop `spotlessApply`로 import 순서만).
## 관련
- 총괄 지시(2026-11-08), design-docs `repo-structure/05-library-repos.md` 6.3절 Q3·Q4(정정은 총괄)
- 템플릿 PR https://git.learn.hyeonworks.com/donghyeon.kang/clean-architecture-backend-template/pulls/6
41d73a1이 패키지를 com.hyeonworks.grpc로 바꿨다. 소유자(2026-11-08)가
개인 도메인 이름을 공용 라이브러리에 쓰지 않기로 했다. 원래 이름
dev.caskeleton.grpc로 되돌리면 템플릿 재사용 체크리스트(「dev.caskeleton을
자기 패키지로 바꾼다」)가 파생 서비스의 라이브러리 import까지 깨뜨린다
(설계 05 NS1의 단점). 그래서 개인 도메인도 템플릿 자리표시 이름도 아닌
중립 이름 cakit을 쓴다(총괄 결정, 소유자가 맡김).
- Java: com.hyeonworks.grpc → dev.cakit.grpc(폴더도 옮김)
- proto: package hyeonworks.grpc.common.v1 → cakit.grpc.common.v1,
생성 Java 패키지 → cakit.grpc.common.v1.generated. proto 폴더도 Buf
PACKAGE_DIRECTORY_MATCH에 맞게 옮겼다
- 시험의 가짜 서비스 이름(hyeonworks.document.v1 등)과 SpotBugs 제외의
클래스 이름, AutoConfiguration.imports
생성 Java 패키지를 dev.cakit.grpc 아래로 두지 않은 이유: 「생성 코드는
손으로 쓴 루트와 겹치지 않는다」는 규칙을 GrpcContractGeneratedCodeTest가
고정한다. 이름만 바꾸는 이 커밋에서 그 규칙까지 바꾸지 않는다.
만든 법: git mv로 폴더를 옮기고 grpc·grpc-advanced·config/spotbugs의 추적
파일에서 com.hyeonworks → dev.cakit, 그 밖의 hyeonworks → cakit(Gitea 주소
git.learn.hyeonworks.com은 제외)으로 바꾼 뒤 desktop spotlessApply(rc=0)로
import 순서만 맞췄다.
위험: proto 패키지는 wire 이름이다. 아직 배포 전이라 깨질 소비자가 없다.
BREAKING CHANGE: Java 패키지 com.hyeonworks.grpc.* → dev.cakit.grpc.*,
proto 패키지 hyeonworks.grpc.common.v1 → cakit.grpc.common.v1. 배포한 버전이
없어 옮길 소비자는 없다.
Refs: design-docs repo-structure/05-library-repos.md 6.3절(Q3·Q4 정정은 총괄)
bufBreaking은 기준(PR이면 merge base, main이면 직전 커밋)과 schema를
비교해 깨짐이면 무조건 실패했다. 그래서 일부러 깨는 변경(바로 앞 커밋의
proto 패키지 이름 바꾸기 같은 것)은 PR도 병합 뒤 main도 빨갛게 만들고,
통과시킬 길이 기준을 손으로 바꾸는 것뿐이었다.
기준과 HEAD 사이 커밋 하나가 `BREAKING CHANGE:` 꼬리말로 선언하면
통과시킨다. 커밋 규칙이 이미 깨지는 변경에 요구하는 표시이고, 그 표시가
MAJOR 버전의 근거다(docs/work/release.md 2절). 선언 없는 깨짐은 전처럼
실패하고, 고치는 길(되돌리기 또는 선언)을 말한다.
버린 대안: 첫 릴리스 전에는 검사를 끄기(태그 뒤의 첫 깨짐을 놓친다),
마지막 릴리스 태그와 비교(한 번 선언한 깨짐 뒤로 다음 릴리스까지 모든
PR이 빨개진다).
검증(desktop): HEAD c8f8721(BREAKING CHANGE 선언)과 기준 bbe49ac — 깨짐을
알리고 rc=0. 같은 트리에 꼬리말 없는 메시지로 바꾼 버리는 사본 — rc=1과
안내. gates.md 4절에 규칙을 적었다.
앞 커밋에서 패키지를 dev.cakit.grpc로 바꿨다. 배포 좌표(group)와 문서는
아직 com.hyeonworks.grpc였다.
- gradle.properties libraryGroup = dev.cakit.grpc(모든 모듈과 SBOM
artifact의 group)
- README 받는 법(exclusiveContent 필터 dev.cakit), AGENTS.md, CHANGELOG
옮기는 법, problem-statement, release.md, family AGENTS.md 둘
- SpotBugs 제외에서 템플릿 클래스(@RequiresPermission)를 가리키던 줄을
지웠다. 이 repo에는 그런 bean이 없다
남긴 것: Gitea 주소 git.learn.hyeonworks.com(서버 주소), 기록
ADR-GRPC-002 본문의 「예전에는 hyeonworks」(기록 본문은 고치지 않는다).
검증: git grep -i hyeonworks에서 위 둘만 남는다. 빌드 게이트는 desktop
(이 PR 본문).
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.
무엇을, 왜
소유자(2026-11-08)가 개인 도메인 이름(
hyeonworks)을 공용 라이브러리에 쓰지 않기로 했다. 원래 이름dev.caskeleton.grpc로 되돌리면 템플릿 재사용 체크리스트(「dev.caskeleton을 자기 패키지로 바꾼다」)가 파생 서비스의 라이브러리 import까지 깨뜨린다(설계 05 NS1의 단점). 그래서 둘 다 아닌 중립 이름cakit을 쓴다(총괄 결정).com.hyeonworks.grpcdev.cakit.grpccom.hyeonworks.grpc…dev.cakit.grpc…hyeonworks.grpc.common.v1cakit.grpc.common.v1hyeonworks.grpc.common.v1.generatedcakit.grpc.common.v1.generated고른 방법과 버린 대안
dev.cakit.grpc아래가 아니라cakit.grpc.common.v1.generated다. 「생성 코드는 손으로 쓴 루트와 겹치지 않는다」는 규칙을GrpcContractGeneratedCodeTest가 고정한다. 이름만 바꾸는 PR에서 그 규칙까지 바꾸지 않았다. 총괄 지시의 「java_package는 Java와 같음」을dev.cakit.grpc…아래로 읽어야 한다면 그 시험과 함께 따로 바꾼다.bufBreaking: proto 패키지를 바꾸면 깨짐이다. 지금까지는 깨짐이면 무조건 실패해서 이 PR도, 병합 뒤 main도 빨개진다. 기준과 HEAD 사이 커밋 하나가BREAKING CHANGE:꼬리말로 선언한 깨짐만 통과시키게 했다(d9d1cfb). 커밋 규칙이 이미 요구하는 표시이고 MAJOR의 근거다. 버린 대안: 첫 릴리스 전 검사 끄기(첫 태그 뒤 깨짐을 놓침), 마지막 릴리스 태그와 비교(한 번 선언한 뒤 다음 릴리스까지 모든 PR이 빨개짐).위험과 영향
git grep -i hyeonworks에 둘이 남는다: Gitea 서버 주소git.learn.hyeonworks.com(gradle.properties·README·runner), 기록docs/adr/ADR-GRPC-002본문의 「예전에는hyeonworks」(기록 본문은 고치지 않는다).@RequiresPermission)를 가리키던 줄을 지웠다. 이 repo에는 그런 bean이 없다.검증
~/x2-grpc-library, 이 브랜치eed2d15): DESKTOP_RESULTSbbe49ac— 깨짐을 알리고 rc=0. 같은 트리에 꼬리말 없는 메시지로 바꾼 버리는 사본 — rc=1.pr.yml실행 결과.리뷰어가 볼 곳
scripts/buf.shbreaking 분기,docs/work/gates.md4절.c8f8721(git mv로 폴더 이동,com.hyeonworks→dev.cakit, 그 밖의hyeonworks→cakit, Gitea 주소 제외, desktopspotlessApply로 import 순서만).관련
repo-structure/05-library-repos.md6.3절 Q3·Q4(정정은 총괄)