Gradle 루트가 src/라서 빌드 도구(build-logic, gradle, config, 빌드 파일)가 계층 코드 폴더 옆에 섞여 있었다. 조립 계층은 composition/과 app-bootstrap/ 두 폴더로 갈라져 있었고, application 모듈 넷은 src/ 최상위에 흩어져 있었다. 그 결과 「Gradle은 src/에서 실행」이라는 예외 규칙이 문서·스크립트·workflow 곳곳에 퍼졌다.
이 PR은 저장소 루트를 Gradle 루트로 하고 src/에는 계층 코드만 남긴다(설계 design-docs repo-structure/01-backend-layout.md 6.1절 가-2·가-3, 라이브러리 분리 뒤에 하기로 한 순서 05-library-repos.md).
refactor(layout)!: 옮기기만(git mv, R100 1541개). 내용은 바꾸지 않았다(.gitignore 합치기만). 파생 서비스가 이름 바꾸기와 내용 변경을 따로 받게 하려고 나눴다. 이 커밋만으로는 빌드되지 않는다.
refactor(layout)!: 경로를 부르는 모든 곳을 고친다.
고른 방법과 버린 대안
Gradle 경로·registry id는 그대로 둔다. 폴더만 옮겼다(:application-core는 src/application/core, :app-bootstrap은 src/bootstrap/app, :composition:outbox-relay는 src/bootstrap/outbox-relay). registry가 이미 둘을 나눈다(ModuleRegistrySettingsInstaller가 source_path로 projectDir을 정한다).
안
비용(살아 있는 파일, 기록 제외)
버린 이유
폴더만 옮김 (고름)
0
—
폴더에 맞춰 경로 이름도 바꿈(:domain:core, :application:core, :bootstrap:app)
:app-bootstrap 44파일 96줄, :application-* 70파일 106줄, :domain-core 25파일 38줄, :composition: 26파일 63줄 + 파생 서비스의 모든 project(':…')
프로젝트 이름 core가 둘이 된다: jar core-<ver>.jar가 boot jar BOOT-INF/lib에서 겹치고 기본 capability dev.caskeleton:core가 충돌한다. 우회(archivesName·capability) 설정을 새로 둬야 한다. jar 이름이 app-<ver>.jar로 바뀌어 이미지·문서도 따라 바뀐다
:composition:* → :bootstrap:*만
26파일 63줄. tech-log-backend에는 composition이 없어 충돌 없음
:app-bootstrap과 어긋난 채 남는다. 소유자가 원하면 따로 할 수 있는 작은 후속으로 남긴다
registry와 시험 이미지 목록은 gradle/로.gradle/modules.json(프로젝트 안 의존: leaf와 허용 edge), gradle/container-images.properties(시험이 띄우는 이미지)는 옆의 gradle/libs.versions.toml(프로젝트 밖 의존: 라이브러리 버전)과 같은 종류다 — 빌드가 고정하는 것. config/는 설계대로 코드 검사 도구 설정(checkstyle·spotbugs)만 둔다. 버린 안: config/ 그대로(설계의 「config = 코드 검사 도구 설정」과 어긋남), 루트 architecture/ 새 폴더(최상위가 늘어남), src/modules.json(src/는 코드만).
그 밖의 자리: src/README.md(빌드·env 참조) → docs/build.md(루트 README는 저장소 소개라 겹치지 않게). src/composition/AGENTS.md → src/bootstrap/AGENTS.md(조립 루트와 조립 leaf를 한 family로 다시 씀). 이미지 빌드 context는 저장소 루트이고 .dockerignore는 허용 목록(전에 context였던 것만 들어감)으로 다시 썼다.
위험과 영향
파생 서비스: 거의 모든 빌드 파일과 계층 폴더의 경로가 바뀐다. 태그 pre-relayout-2026-11(main 66eaa982)까지 먼저 받고 이 PR을 두 번째로 받는다. 옛 경로 → 새 경로 표와 순서는 docs/upgrade/2026-11-relayout.md.
동작 변경 둘: bootRun working dir가 저장소 루트가 됐다(.env와 상대 경로 설정이 루트 기준, /logs/를 무시). 로컬 .env가 compose.yaml 옆에 와서 Docker Compose가 보간에도 읽는다(APP_DATASOURCE_USERNAME·PASSWORD·APP_SERVER_PORT가 db·포트 매핑에 들어감). 둘 다 upgrade 문서 5절.
기록 문서는 머리 블록만 고쳤다: docs/design·docs/history·docs/reviews 본문과 지난 upgrade 문서, capability-status.md 제거 표의 옛 경로는 쓴 때의 기록이라 그대로다.
문서 검사 범위: check-docs.py 경로 검사가 build-logic/·gradle/로 시작하는 인라인 경로도 본다(전에는 src/build-logic/·src/gradle/로 보던 것). 그 김에 드러난 옛 경로 하나(build-logic/README.md의 config/jpa/release-registry.json)를 고쳤다.
검증
desktop 증거 실행 — 새 worktree, 트리 60838b16(= 커밋 123fc0bf의 트리. 그 뒤 커밋은 장부 한 줄뿐), Gradle --no-build-cache, 공유 잠금 아래, 2026-11-11 23:27~00:38 KST. 로그 desktop ~/t2b-logs/ev-*.log.
단계
명령
rc
시간
FROM-CACHE
docs
scripts/verify.sh docs
0
4초
0
pr
scripts/verify.sh pr --on here --no-cache (:prCheck, :verifyStrictLaneStages --dry-run)
0
487초
0
main
scripts/verify.sh main --on here --no-cache (:mainCheck, :integrationCheck, -p build-logic test, 설정 캐시 스크립트)
0
2199초
바깥 0, 중첩 빌드 14(verifyFeatureScaffold가 띄운 복사본의 compile·checkstyle)
구조 리뷰(arch-reviewer, 읽기만): 지적 5건 모두 반영 — notification API surface의 application-notification 소스 루트(놓치면 272개 타입이 surface에서 말없이 빠짐), 루트 전체를 훑는 fileTree가 .claude/worktrees를 줍는 것, src/bootstrap/AGENTS.md 시험 문구, build-logic fixture가 새 배치(Gradle 루트 = 저장소 루트, 빌드 폴더 .)를 시험하지 않던 것(시험 셋 추가), javadoc 위치.
돌리지 않은 것: performanceCheck(brief 범위 밖, nightly 몫), runner에서만 도는 nightly 행렬(PostgreSQL major, Redis topology, NFS, compose smoke runner 실행). Docker 레이어 캐시는 끄지 않았다(빌드 context와 COPY 경로가 바뀌어 옛 레이어는 다시 쓰이지 않는다).
리뷰어가 볼 곳
기계적으로 만든 부분: 1번 커밋은 git mv만. 2번 커밋의 경로 치환은 스크립트(옛 경로 접두사 → 새 경로, 기록 문서 제외)로 하고, 그 뒤 손으로 고친 곳은 아래.
손으로 고친 곳: build-logic의 저장소 루트 계산(ArchitectureRegistrySettingsPlugin, ArchitecturePlugin, ConfigContractPlugin), 빌드 스크립트의 rootProject.projectDir.parentFile·rootProject.file('../…'), 옛 src/ 기준 경로를 쓰던 시험(FileserverDocumentationCoverageTest는 Gradle 경로 → 폴더를 registry로 찾게 바꿈, MessagingAuthorityContractTest·NotificationPayloadAtRestContractTest처럼 없는 폴더를 조용히 건너뛰던 목록), DeveloperExperienceContractTest의 Docker 계약, .dockerignore, workflow의 working-directory: src 삭제, scripts/(verify.sh, ci/*, bootstrap-local, new-feature, verify-feature-scaffold), check-repo-layout.py 허용 목록.
## 무엇을, 왜
Gradle 루트가 `src/`라서 빌드 도구(`build-logic`, `gradle`, `config`, 빌드 파일)가 계층 코드 폴더 옆에 섞여 있었다. 조립 계층은 `composition/`과 `app-bootstrap/` 두 폴더로 갈라져 있었고, application 모듈 넷은 `src/` 최상위에 흩어져 있었다. 그 결과 「Gradle은 `src/`에서 실행」이라는 예외 규칙이 문서·스크립트·workflow 곳곳에 퍼졌다.
이 PR은 저장소 루트를 Gradle 루트로 하고 `src/`에는 계층 코드만 남긴다(설계 design-docs `repo-structure/01-backend-layout.md` 6.1절 가-2·가-3, 라이브러리 분리 뒤에 하기로 한 순서 `05-library-repos.md`).
```
저장소 루트 = Gradle 루트: settings.gradle · build.gradle · gradlew · gradle/ · build-logic/ · config/ · Dockerfile · .env.example · compose.yaml · compose/ · docs/ · scripts/
src/
├── domain/core
├── application/{core, fileserver, notification, objectstorage}
├── adapter/{inbound, outbound}/… (그대로)
├── shared-contract (그대로)
└── bootstrap/{app, durable-operation, fileserver-platform, idempotency, notification-platform, outbox-relay, service-runtime}
```
커밋은 둘이다.
1. `refactor(layout)!:` 옮기기만(git mv, R100 1541개). 내용은 바꾸지 않았다(`.gitignore` 합치기만). 파생 서비스가 이름 바꾸기와 내용 변경을 따로 받게 하려고 나눴다. 이 커밋만으로는 빌드되지 않는다.
2. `refactor(layout)!:` 경로를 부르는 모든 곳을 고친다.
## 고른 방법과 버린 대안
**Gradle 경로·registry id는 그대로 둔다.** 폴더만 옮겼다(`:application-core`는 `src/application/core`, `:app-bootstrap`은 `src/bootstrap/app`, `:composition:outbox-relay`는 `src/bootstrap/outbox-relay`). registry가 이미 둘을 나눈다(`ModuleRegistrySettingsInstaller`가 `source_path`로 `projectDir`을 정한다).
| 안 | 비용(살아 있는 파일, 기록 제외) | 버린 이유 |
| --- | --- | --- |
| **폴더만 옮김 (고름)** | 0 | — |
| 폴더에 맞춰 경로 이름도 바꿈(`:domain:core`, `:application:core`, `:bootstrap:app`) | `:app-bootstrap` 44파일 96줄, `:application-*` 70파일 106줄, `:domain-core` 25파일 38줄, `:composition:` 26파일 63줄 + 파생 서비스의 모든 `project(':…')` | 프로젝트 이름 `core`가 둘이 된다: jar `core-<ver>.jar`가 boot jar `BOOT-INF/lib`에서 겹치고 기본 capability `dev.caskeleton:core`가 충돌한다. 우회(archivesName·capability) 설정을 새로 둬야 한다. jar 이름이 `app-<ver>.jar`로 바뀌어 이미지·문서도 따라 바뀐다 |
| `:composition:*` → `:bootstrap:*`만 | 26파일 63줄. tech-log-backend에는 composition이 없어 충돌 없음 | `:app-bootstrap`과 어긋난 채 남는다. 소유자가 원하면 따로 할 수 있는 작은 후속으로 남긴다 |
**registry와 시험 이미지 목록은 `gradle/`로.** `gradle/modules.json`(프로젝트 안 의존: leaf와 허용 edge), `gradle/container-images.properties`(시험이 띄우는 이미지)는 옆의 `gradle/libs.versions.toml`(프로젝트 밖 의존: 라이브러리 버전)과 같은 종류다 — 빌드가 고정하는 것. `config/`는 설계대로 코드 검사 도구 설정(checkstyle·spotbugs)만 둔다. 버린 안: `config/` 그대로(설계의 「config = 코드 검사 도구 설정」과 어긋남), 루트 `architecture/` 새 폴더(최상위가 늘어남), `src/modules.json`(`src/`는 코드만).
그 밖의 자리: `src/README.md`(빌드·env 참조) → `docs/build.md`(루트 README는 저장소 소개라 겹치지 않게). `src/composition/AGENTS.md` → `src/bootstrap/AGENTS.md`(조립 루트와 조립 leaf를 한 family로 다시 씀). 이미지 빌드 context는 저장소 루트이고 `.dockerignore`는 허용 목록(전에 context였던 것만 들어감)으로 다시 썼다.
## 위험과 영향
- **파생 서비스**: 거의 모든 빌드 파일과 계층 폴더의 경로가 바뀐다. 태그 `pre-relayout-2026-11`(main `66eaa982`)까지 먼저 받고 이 PR을 두 번째로 받는다. 옛 경로 → 새 경로 표와 순서는 `docs/upgrade/2026-11-relayout.md`.
- **동작 변경 둘**: `bootRun` working dir가 저장소 루트가 됐다(`.env`와 상대 경로 설정이 루트 기준, `/logs/`를 무시). 로컬 `.env`가 `compose.yaml` 옆에 와서 Docker Compose가 보간에도 읽는다(`APP_DATASOURCE_USERNAME`·`PASSWORD`·`APP_SERVER_PORT`가 `db`·포트 매핑에 들어감). 둘 다 upgrade 문서 5절.
- **기록 문서는 머리 블록만 고쳤다**: `docs/design`·`docs/history`·`docs/reviews` 본문과 지난 upgrade 문서, `capability-status.md` 제거 표의 옛 경로는 쓴 때의 기록이라 그대로다.
- **문서 검사 범위**: `check-docs.py` 경로 검사가 `build-logic/`·`gradle/`로 시작하는 인라인 경로도 본다(전에는 `src/build-logic/`·`src/gradle/`로 보던 것). 그 김에 드러난 옛 경로 하나(`build-logic/README.md`의 `config/jpa/release-registry.json`)를 고쳤다.
## 검증
**desktop 증거 실행** — 새 worktree, 트리 `60838b16`(= 커밋 `123fc0bf`의 트리. 그 뒤 커밋은 장부 한 줄뿐), Gradle `--no-build-cache`, 공유 잠금 아래, 2026-11-11 23:27~00:38 KST. 로그 desktop `~/t2b-logs/ev-*.log`.
| 단계 | 명령 | rc | 시간 | FROM-CACHE |
| --- | --- | --- | --- | --- |
| docs | `scripts/verify.sh docs` | 0 | 4초 | 0 |
| pr | `scripts/verify.sh pr --on here --no-cache` (`:prCheck`, `:verifyStrictLaneStages --dry-run`) | 0 | 487초 | 0 |
| main | `scripts/verify.sh main --on here --no-cache` (`:mainCheck`, `:integrationCheck`, `-p build-logic test`, 설정 캐시 스크립트) | 0 | 2199초 | 바깥 0, 중첩 빌드 14(`verifyFeatureScaffold`가 띄운 복사본의 compile·checkstyle) |
| release | `scripts/verify.sh release --on here --no-cache` | 0 | 28초 | 0 |
| compose smoke | `scripts/run-compose-runtime-smoke.sh --matrix src/bootstrap/app/compose-lanes/compose-profile-contracts.json` | 0 | 1495초 | — (18/18 lane passed) |
| 빠른 시작 | `scripts/verify.sh app` (`scripts/bootstrap-local.sh`) | 0 | 61초 | — (`/api/healthcheck` HTTP 200, `status=UP`, 뒤에 `docker compose down -v`) |
시험 결과 XML 합계: tests=8154, failures=0, errors=0, skipped=28.
**runner**: `pr / gradle`, `pr / vulnerabilities`, `pr / done (pull_request)` 모두 success — 커밋 `123fc0bf`(run 85)와 지금 head `97798b5a`(run 88, 장부 실측 한 줄만 더함).
**노트북**: `scripts/check-docs.py`, `check-work-docs.py`, `check-repo-layout.py`, `python3 -m unittest discover -s scripts/tests`(148) OK.
**구조 리뷰**(`arch-reviewer`, 읽기만): 지적 5건 모두 반영 — notification API surface의 application-notification 소스 루트(놓치면 272개 타입이 surface에서 말없이 빠짐), 루트 전체를 훑는 fileTree가 `.claude/worktrees`를 줍는 것, `src/bootstrap/AGENTS.md` 시험 문구, build-logic fixture가 새 배치(Gradle 루트 = 저장소 루트, 빌드 폴더 `.`)를 시험하지 않던 것(시험 셋 추가), javadoc 위치.
돌리지 않은 것: `performanceCheck`(brief 범위 밖, nightly 몫), runner에서만 도는 nightly 행렬(PostgreSQL major, Redis topology, NFS, compose smoke runner 실행). Docker 레이어 캐시는 끄지 않았다(빌드 context와 COPY 경로가 바뀌어 옛 레이어는 다시 쓰이지 않는다).
## 리뷰어가 볼 곳
- 기계적으로 만든 부분: 1번 커밋은 git mv만. 2번 커밋의 경로 치환은 스크립트(옛 경로 접두사 → 새 경로, 기록 문서 제외)로 하고, 그 뒤 손으로 고친 곳은 아래.
- 손으로 고친 곳: `build-logic`의 저장소 루트 계산(`ArchitectureRegistrySettingsPlugin`, `ArchitecturePlugin`, `ConfigContractPlugin`), 빌드 스크립트의 `rootProject.projectDir.parentFile`·`rootProject.file('../…')`, 옛 `src/` 기준 경로를 쓰던 시험(`FileserverDocumentationCoverageTest`는 Gradle 경로 → 폴더를 registry로 찾게 바꿈, `MessagingAuthorityContractTest`·`NotificationPayloadAtRestContractTest`처럼 없는 폴더를 조용히 건너뛰던 목록), `DeveloperExperienceContractTest`의 Docker 계약, `.dockerignore`, workflow의 `working-directory: src` 삭제, `scripts/`(verify.sh, ci/*, bootstrap-local, new-feature, verify-feature-scaffold), `check-repo-layout.py` 허용 목록.
## 관련
- design-docs `repo-structure/01-backend-layout.md` 6.1절, `repo-structure/05-library-repos.md`
- `docs/upgrade/2026-11-relayout.md`, `docs/work/reference/decisions.md` 「Gradle 루트 위치」
문제: Gradle 루트가 src/라서 빌드 도구(build-logic, gradle, config, 빌드
파일)가 계층 코드 폴더 옆에 섞여 있다. composition과 app-bootstrap은 같은
조립 계층인데 폴더가 따로이고, application 모듈 넷은 최상위에 흩어져 있다.
「Gradle은 src/에서 실행」이라는 예외 규칙이 모든 문서와 스크립트에 퍼졌다.
고른 방법: 저장소 루트를 Gradle 루트로 하고 src/에는 계층 코드만 둔다
(design-docs repo-structure/01-backend-layout.md 6.1절 가-2·가-3, 소유자
승인 2026-11-07). 이 커밋은 git mv만 한다. 이름 바꾸기 감지가 1541개
파일 모두를 R100으로 잡도록 내용을 바꾸지 않았다. 바뀐 곳은 둘뿐이다:
src/.gitignore의 줄을 루트 .gitignore로 옮겼다.
- 빌드 파일, gradle/, build-logic/ → 저장소 루트
- config/checkstyle·spotbugs → config/ (코드 검사 도구 설정만)
- registry config/architecture/modules.json → gradle/modules.json,
시험 이미지 config/testing/container-images.properties
→ gradle/container-images.properties, registry 설명 → gradle/README.md
- Dockerfile, .dockerignore, .env*.example → 저장소 루트
- src/README.md(빌드·env 참조) → docs/build.md
- src/domain-core → src/domain/core,
src/application-* → src/application/*,
src/app-bootstrap → src/bootstrap/app,
src/composition/* → src/bootstrap/*
- 기능 생성 템플릿 scripts/feature-scaffold/{templates,probes}/src/ 아래도
같은 모양으로(domain/core, application/core, bootstrap/app)
위험: 이 커밋만으로는 빌드되지 않는다. 경로를 부르는 곳은 다음 커밋이
고친다. 두 커밋을 나눈 것은 파생 서비스가 merge할 때 이름 바꾸기와 내용
변경을 따로 보게 하려는 것이다.
검증: git diff --cached -M --name-status 에서 R100 1541개, 그 밖은
.gitignore 수정과 src/.gitignore 삭제뿐.
BREAKING CHANGE: 모든 빌드 파일과 계층 폴더의 경로가 바뀐다. 옛 경로 →
새 경로 표와 받는 순서는 docs/upgrade/2026-11-relayout.md에 있다.
Refs: design-docs repo-structure/01-backend-layout.md 6.1절
문제: 앞 커밋이 Gradle 루트를 저장소 루트로 옮기고 계층 폴더를 묶었다.
빌드 스크립트·build-logic·시험·workflow·스크립트·문서가 아직 옛 배치
(Gradle 루트 = src/)를 가정해 빌드가 되지 않는다.
고른 방법:
- Gradle 경로와 registry id는 그대로 둔다(:app-bootstrap, :application-core,
:composition:*). registry의 source_path만 새 폴더를 가리킨다. 폴더에 맞춘
이름(:domain:core, :application:core)은 프로젝트 이름 core가 둘이 되어
boot jar의 BOOT-INF/lib와 기본 capability가 겹치고, 파생 서비스의 모든
project(':…') 줄을 바꾸게 한다.
- registry는 gradle/modules.json, 시험 이미지 목록은
gradle/container-images.properties: 버전 카탈로그 옆, 빌드가 고정하는 것.
config/는 코드 검사 도구 설정만 둔다.
- build-logic: settings·architecture 플러그인의 저장소 루트를 Gradle 루트로
(getParentFile 제거). config contract의 파일 트리는 src/만 훑는다(루트를
훑으면 docs·.claude/worktrees까지 줍는다).
- 빌드 스크립트: rootProject.projectDir.parentFile → rootProject.projectDir,
rootProject.file('../…') → rootProject.file('…'), 옛 src 기준 include에
src/를 붙인다. notification API surface의 application-notification 소스
루트를 새 폴더로(놓치면 272개 타입이 surface에서 말없이 빠진다).
- 시험: 옛 src 기준 모듈 목록과 ../ 개수를 고친다. 없는 폴더를 말없이
건너뛰던 목록(MessagingAuthority, NotificationPayloadAtRest 등)을 새
폴더로, FileserverDocumentationCoverageTest는 Gradle 경로 → 폴더를
registry로 찾는다. Docker 계약은 WORKDIR /build, 새 jar 경로.
- Docker: 빌드 context를 저장소 루트로, .dockerignore는 허용 목록으로 다시
써서 전에 context였던 것만 들어가게 한다. compose의 build.context는 .,
env_file은 ./.env.
- workflow: working-directory: src 기본값과 그것을 되돌리던 줄을 지운다.
- scripts: verify.sh, ci/*, bootstrap-local, new-feature,
verify-feature-scaffold, mongo 검증, hooks, check-repo-layout 허용 목록.
check-docs의 경로 검사는 build-logic/·gradle/로 시작하는 경로도 본다.
- 문서: AGENTS.md 지도, README 구조 표, leaf AGENTS.md의 cd src, gates·
operate·결정 색인, src/bootstrap/AGENTS.md를 조립 계층 family 규칙으로
다시 쓴다. 기록 문서(docs/design·history·reviews, 지난 upgrade 안내,
capability-status 제거 표)는 머리 블록만 고친다. 파생 서비스용 안내
docs/upgrade/2026-11-relayout.md를 더한다.
위험: bootRun working dir가 저장소 루트가 되어 .env와 상대 경로 설정이
루트 기준이다. 루트 .env는 compose 보간에도 읽힌다(upgrade 안내 5절).
파생 서비스는 태그 pre-relayout-2026-11까지 받은 뒤 이 묶음을 받는다.
검증: desktop에서 캐시 없이 scripts/verify.sh docs·pr·main·release,
compose smoke 18 lane, 빠른 시작(scripts/verify.sh app). 결과는 PR 본문.
구조 리뷰(arch-reviewer) 지적 5건을 반영했다.
BREAKING CHANGE: Gradle은 저장소 루트에서 돈다(cd src 없음). registry는
gradle/modules.json, 이미지 빌드 context는 저장소 루트다. 옛 경로 → 새 경로
표는 docs/upgrade/2026-11-relayout.md.
Refs: design-docs repo-structure/01-backend-layout.md 6.1절 가-2·가-3
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.
무엇을, 왜
Gradle 루트가
src/라서 빌드 도구(build-logic,gradle,config, 빌드 파일)가 계층 코드 폴더 옆에 섞여 있었다. 조립 계층은composition/과app-bootstrap/두 폴더로 갈라져 있었고, application 모듈 넷은src/최상위에 흩어져 있었다. 그 결과 「Gradle은src/에서 실행」이라는 예외 규칙이 문서·스크립트·workflow 곳곳에 퍼졌다.이 PR은 저장소 루트를 Gradle 루트로 하고
src/에는 계층 코드만 남긴다(설계 design-docsrepo-structure/01-backend-layout.md6.1절 가-2·가-3, 라이브러리 분리 뒤에 하기로 한 순서05-library-repos.md).커밋은 둘이다.
refactor(layout)!:옮기기만(git mv, R100 1541개). 내용은 바꾸지 않았다(.gitignore합치기만). 파생 서비스가 이름 바꾸기와 내용 변경을 따로 받게 하려고 나눴다. 이 커밋만으로는 빌드되지 않는다.refactor(layout)!:경로를 부르는 모든 곳을 고친다.고른 방법과 버린 대안
Gradle 경로·registry id는 그대로 둔다. 폴더만 옮겼다(
:application-core는src/application/core,:app-bootstrap은src/bootstrap/app,:composition:outbox-relay는src/bootstrap/outbox-relay). registry가 이미 둘을 나눈다(ModuleRegistrySettingsInstaller가source_path로projectDir을 정한다).:domain:core,:application:core,:bootstrap:app):app-bootstrap44파일 96줄,:application-*70파일 106줄,:domain-core25파일 38줄,:composition:26파일 63줄 + 파생 서비스의 모든project(':…')core가 둘이 된다: jarcore-<ver>.jar가 boot jarBOOT-INF/lib에서 겹치고 기본 capabilitydev.caskeleton:core가 충돌한다. 우회(archivesName·capability) 설정을 새로 둬야 한다. jar 이름이app-<ver>.jar로 바뀌어 이미지·문서도 따라 바뀐다:composition:*→:bootstrap:*만:app-bootstrap과 어긋난 채 남는다. 소유자가 원하면 따로 할 수 있는 작은 후속으로 남긴다registry와 시험 이미지 목록은
gradle/로.gradle/modules.json(프로젝트 안 의존: leaf와 허용 edge),gradle/container-images.properties(시험이 띄우는 이미지)는 옆의gradle/libs.versions.toml(프로젝트 밖 의존: 라이브러리 버전)과 같은 종류다 — 빌드가 고정하는 것.config/는 설계대로 코드 검사 도구 설정(checkstyle·spotbugs)만 둔다. 버린 안:config/그대로(설계의 「config = 코드 검사 도구 설정」과 어긋남), 루트architecture/새 폴더(최상위가 늘어남),src/modules.json(src/는 코드만).그 밖의 자리:
src/README.md(빌드·env 참조) →docs/build.md(루트 README는 저장소 소개라 겹치지 않게).src/composition/AGENTS.md→src/bootstrap/AGENTS.md(조립 루트와 조립 leaf를 한 family로 다시 씀). 이미지 빌드 context는 저장소 루트이고.dockerignore는 허용 목록(전에 context였던 것만 들어감)으로 다시 썼다.위험과 영향
pre-relayout-2026-11(main66eaa982)까지 먼저 받고 이 PR을 두 번째로 받는다. 옛 경로 → 새 경로 표와 순서는docs/upgrade/2026-11-relayout.md.bootRunworking dir가 저장소 루트가 됐다(.env와 상대 경로 설정이 루트 기준,/logs/를 무시). 로컬.env가compose.yaml옆에 와서 Docker Compose가 보간에도 읽는다(APP_DATASOURCE_USERNAME·PASSWORD·APP_SERVER_PORT가db·포트 매핑에 들어감). 둘 다 upgrade 문서 5절.docs/design·docs/history·docs/reviews본문과 지난 upgrade 문서,capability-status.md제거 표의 옛 경로는 쓴 때의 기록이라 그대로다.check-docs.py경로 검사가build-logic/·gradle/로 시작하는 인라인 경로도 본다(전에는src/build-logic/·src/gradle/로 보던 것). 그 김에 드러난 옛 경로 하나(build-logic/README.md의config/jpa/release-registry.json)를 고쳤다.검증
desktop 증거 실행 — 새 worktree, 트리
60838b16(= 커밋123fc0bf의 트리. 그 뒤 커밋은 장부 한 줄뿐), Gradle--no-build-cache, 공유 잠금 아래, 2026-11-11 23:27~00:38 KST. 로그 desktop~/t2b-logs/ev-*.log.scripts/verify.sh docsscripts/verify.sh pr --on here --no-cache(:prCheck,:verifyStrictLaneStages --dry-run)scripts/verify.sh main --on here --no-cache(:mainCheck,:integrationCheck,-p build-logic test, 설정 캐시 스크립트)verifyFeatureScaffold가 띄운 복사본의 compile·checkstyle)scripts/verify.sh release --on here --no-cachescripts/run-compose-runtime-smoke.sh --matrix src/bootstrap/app/compose-lanes/compose-profile-contracts.jsonscripts/verify.sh app(scripts/bootstrap-local.sh)/api/healthcheckHTTP 200,status=UP, 뒤에docker compose down -v)시험 결과 XML 합계: tests=8154, failures=0, errors=0, skipped=28.
runner:
pr / gradle,pr / vulnerabilities,pr / done (pull_request)모두 success — 커밋123fc0bf(run 85)와 지금 head97798b5a(run 88, 장부 실측 한 줄만 더함).노트북:
scripts/check-docs.py,check-work-docs.py,check-repo-layout.py,python3 -m unittest discover -s scripts/tests(148) OK.구조 리뷰(
arch-reviewer, 읽기만): 지적 5건 모두 반영 — notification API surface의 application-notification 소스 루트(놓치면 272개 타입이 surface에서 말없이 빠짐), 루트 전체를 훑는 fileTree가.claude/worktrees를 줍는 것,src/bootstrap/AGENTS.md시험 문구, build-logic fixture가 새 배치(Gradle 루트 = 저장소 루트, 빌드 폴더.)를 시험하지 않던 것(시험 셋 추가), javadoc 위치.돌리지 않은 것:
performanceCheck(brief 범위 밖, nightly 몫), runner에서만 도는 nightly 행렬(PostgreSQL major, Redis topology, NFS, compose smoke runner 실행). Docker 레이어 캐시는 끄지 않았다(빌드 context와 COPY 경로가 바뀌어 옛 레이어는 다시 쓰이지 않는다).리뷰어가 볼 곳
build-logic의 저장소 루트 계산(ArchitectureRegistrySettingsPlugin,ArchitecturePlugin,ConfigContractPlugin), 빌드 스크립트의rootProject.projectDir.parentFile·rootProject.file('../…'), 옛src/기준 경로를 쓰던 시험(FileserverDocumentationCoverageTest는 Gradle 경로 → 폴더를 registry로 찾게 바꿈,MessagingAuthorityContractTest·NotificationPayloadAtRestContractTest처럼 없는 폴더를 조용히 건너뛰던 목록),DeveloperExperienceContractTest의 Docker 계약,.dockerignore, workflow의working-directory: src삭제,scripts/(verify.sh, ci/*, bootstrap-local, new-feature, verify-feature-scaffold),check-repo-layout.py허용 목록.관련
repo-structure/01-backend-layout.md6.1절,repo-structure/05-library-repos.mddocs/upgrade/2026-11-relayout.md,docs/work/reference/decisions.md「Gradle 루트 위치」문제: Gradle 루트가 src/라서 빌드 도구(build-logic, gradle, config, 빌드 파일)가 계층 코드 폴더 옆에 섞여 있다. composition과 app-bootstrap은 같은 조립 계층인데 폴더가 따로이고, application 모듈 넷은 최상위에 흩어져 있다. 「Gradle은 src/에서 실행」이라는 예외 규칙이 모든 문서와 스크립트에 퍼졌다. 고른 방법: 저장소 루트를 Gradle 루트로 하고 src/에는 계층 코드만 둔다 (design-docs repo-structure/01-backend-layout.md 6.1절 가-2·가-3, 소유자 승인 2026-11-07). 이 커밋은 git mv만 한다. 이름 바꾸기 감지가 1541개 파일 모두를 R100으로 잡도록 내용을 바꾸지 않았다. 바뀐 곳은 둘뿐이다: src/.gitignore의 줄을 루트 .gitignore로 옮겼다. - 빌드 파일, gradle/, build-logic/ → 저장소 루트 - config/checkstyle·spotbugs → config/ (코드 검사 도구 설정만) - registry config/architecture/modules.json → gradle/modules.json, 시험 이미지 config/testing/container-images.properties → gradle/container-images.properties, registry 설명 → gradle/README.md - Dockerfile, .dockerignore, .env*.example → 저장소 루트 - src/README.md(빌드·env 참조) → docs/build.md - src/domain-core → src/domain/core, src/application-* → src/application/*, src/app-bootstrap → src/bootstrap/app, src/composition/* → src/bootstrap/* - 기능 생성 템플릿 scripts/feature-scaffold/{templates,probes}/src/ 아래도 같은 모양으로(domain/core, application/core, bootstrap/app) 위험: 이 커밋만으로는 빌드되지 않는다. 경로를 부르는 곳은 다음 커밋이 고친다. 두 커밋을 나눈 것은 파생 서비스가 merge할 때 이름 바꾸기와 내용 변경을 따로 보게 하려는 것이다. 검증: git diff --cached -M --name-status 에서 R100 1541개, 그 밖은 .gitignore 수정과 src/.gitignore 삭제뿐. BREAKING CHANGE: 모든 빌드 파일과 계층 폴더의 경로가 바뀐다. 옛 경로 → 새 경로 표와 받는 순서는 docs/upgrade/2026-11-relayout.md에 있다. Refs: design-docs repo-structure/01-backend-layout.md 6.1절문제: 앞 커밋이 Gradle 루트를 저장소 루트로 옮기고 계층 폴더를 묶었다. 빌드 스크립트·build-logic·시험·workflow·스크립트·문서가 아직 옛 배치 (Gradle 루트 = src/)를 가정해 빌드가 되지 않는다. 고른 방법: - Gradle 경로와 registry id는 그대로 둔다(:app-bootstrap, :application-core, :composition:*). registry의 source_path만 새 폴더를 가리킨다. 폴더에 맞춘 이름(:domain:core, :application:core)은 프로젝트 이름 core가 둘이 되어 boot jar의 BOOT-INF/lib와 기본 capability가 겹치고, 파생 서비스의 모든 project(':…') 줄을 바꾸게 한다. - registry는 gradle/modules.json, 시험 이미지 목록은 gradle/container-images.properties: 버전 카탈로그 옆, 빌드가 고정하는 것. config/는 코드 검사 도구 설정만 둔다. - build-logic: settings·architecture 플러그인의 저장소 루트를 Gradle 루트로 (getParentFile 제거). config contract의 파일 트리는 src/만 훑는다(루트를 훑으면 docs·.claude/worktrees까지 줍는다). - 빌드 스크립트: rootProject.projectDir.parentFile → rootProject.projectDir, rootProject.file('../…') → rootProject.file('…'), 옛 src 기준 include에 src/를 붙인다. notification API surface의 application-notification 소스 루트를 새 폴더로(놓치면 272개 타입이 surface에서 말없이 빠진다). - 시험: 옛 src 기준 모듈 목록과 ../ 개수를 고친다. 없는 폴더를 말없이 건너뛰던 목록(MessagingAuthority, NotificationPayloadAtRest 등)을 새 폴더로, FileserverDocumentationCoverageTest는 Gradle 경로 → 폴더를 registry로 찾는다. Docker 계약은 WORKDIR /build, 새 jar 경로. - Docker: 빌드 context를 저장소 루트로, .dockerignore는 허용 목록으로 다시 써서 전에 context였던 것만 들어가게 한다. compose의 build.context는 ., env_file은 ./.env. - workflow: working-directory: src 기본값과 그것을 되돌리던 줄을 지운다. - scripts: verify.sh, ci/*, bootstrap-local, new-feature, verify-feature-scaffold, mongo 검증, hooks, check-repo-layout 허용 목록. check-docs의 경로 검사는 build-logic/·gradle/로 시작하는 경로도 본다. - 문서: AGENTS.md 지도, README 구조 표, leaf AGENTS.md의 cd src, gates· operate·결정 색인, src/bootstrap/AGENTS.md를 조립 계층 family 규칙으로 다시 쓴다. 기록 문서(docs/design·history·reviews, 지난 upgrade 안내, capability-status 제거 표)는 머리 블록만 고친다. 파생 서비스용 안내 docs/upgrade/2026-11-relayout.md를 더한다. 위험: bootRun working dir가 저장소 루트가 되어 .env와 상대 경로 설정이 루트 기준이다. 루트 .env는 compose 보간에도 읽힌다(upgrade 안내 5절). 파생 서비스는 태그 pre-relayout-2026-11까지 받은 뒤 이 묶음을 받는다. 검증: desktop에서 캐시 없이 scripts/verify.sh docs·pr·main·release, compose smoke 18 lane, 빠른 시작(scripts/verify.sh app). 결과는 PR 본문. 구조 리뷰(arch-reviewer) 지적 5건을 반영했다. BREAKING CHANGE: Gradle은 저장소 루트에서 돈다(cd src 없음). registry는 gradle/modules.json, 이미지 빌드 context는 저장소 루트다. 옛 경로 → 새 경로 표는 docs/upgrade/2026-11-relayout.md. Refs: design-docs repo-structure/01-backend-layout.md 6.1절 가-2·가-3