문제: main.yml의 `performance`는 한 번도 돌지 않았다. 수동 실행(run 63)에서는
2.5일 동안, main push(run 79)에서는 지금까지 Blocked다. Gitea API의 job
상태 `waiting`은 runner를 기다리는 것(`queued`)이 아니라 서버의 Blocked다.
Gitea 1.27은 앞 job이 끝나면 `needs`가 있는 job의 `if`를 서버에서 계산하고,
계산이 실패하면 Blocked로 둔다. 일회용 workflow 세 가지(입력 있음·없음,
concurrency 있음·없음)를 수동 실행해 보니, `needs`와 `if`를 함께 가진 job
여섯 개가 `if` 내용(`!cancelled()`, `always()`, 이벤트 이름만)과 앞 job 결과에
상관없이 모두 Blocked였다. `if`가 없는 `needs` job과 `needs`가 없는 `if` job은
제대로 풀렸다. release.yml의 `app-image-signing`도 같은 모양이라 수동 실행이
끝나지 않는다.
고른 방법:
- performance: `needs`를 지우고 파일 맨 끝에 둔다. `needs` 없는 job은 run이
시작할 때 대기열에 들어가고, capacity 1인 runner 하나는 run의 job을 만든
순서(파일 순서)대로 돈다. 조건은 `github.event_name != 'push'` 하나다.
build.gradle의 strict lane 단계 선언도 같은 조건으로 바꾼다.
- app-image-signing: job 조건을 두 step의 조건으로 옮긴다. 수동 실행에서는
job이 뜨고 step이 모두 건너뛴다. 키를 가진 job이 하나뿐이라는 시험은
그대로 두고, 조건을 보는 단언만 step으로 옮긴다.
버린 대안: performance를 별도 workflow로 빼기. workflow는 셋(pr·main·release)만
둔다는 규칙(docs/work/reference/gates.md)을 바꾸게 된다.
위험·한계: runner가 둘이 되거나 capacity가 1보다 커지면 performance가 다른
job과 겹칠 수 있다. 그래도 돌기는 한다. 원인이 Gitea 서버 쪽이라 Gitea를
올리면 다시 확인할 일이다. 수동 실행으로만 재현했고 push 실행의 원인은
같은 증상으로 판단했다.
검증: verifyStrictLaneStages --dry-run(desktop·runner PR), runner main 수동
실행에서 performance가 마지막에 도는지(이 PR 본문에 적는다).
문제: main의 links job이 run 52·63·79 모두 `lychee: unexpected argument
'--root-dir'`로 실패한다. 고정한 lychee-action v2.0.2는 lychee v0.16.1을
받는데, 그 버전에는 --root-dir이 없다. 상대 경로 --root-dir은 lychee
v0.22.0부터 읽는다.
고른 방법: action을 v2.9.0(lychee v0.24.2, 2026-07-09)의 커밋 SHA로 올린다.
Gitea의 job token은 lychee가 보낼 GitHub 쪽에서 의미가 없어 token을 비우고,
Gitea에 없는 job summary를 끈다. DeveloperExperienceContractTest가 고정한
SHA를 함께 바꾼다.
버린 대안: v2.0.2에 lycheeVersion만 새로 주기. v2.0.2의 내려받기 경로는
lychee 0.16 이전의 자산 이름을 쓴다.
위험·한계: 새 lychee가 전보다 많은 외부 링크를 깨졌다고 볼 수 있다. 그러면
링크를 고치거나 .lycheeignore에 이유와 함께 넣는다.
검증: runner main 수동 실행의 links job(이 PR 본문에 적는다).
문제: 앞 커밋이 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
문제: 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절