docs(work): 재배치 뒤에도 src/에서 Gradle을 돌리라는 절차를 고친다

문제: Gradle 루트를 저장소 루트로 옮긴 뒤(refactor(layout)!) src/에는
gradlew가 없다. 그런데 operate.md 4.1절 손 절차 두 곳은 아직
`cd ~/workspace/<작업 이름>/src` 다음 ./gradlew를 돌리라고 한다.
desktop-gates 스킬 6단계가 단계 밖 명령(lane 하나, spotlessApply, 탐침)을
이 절차로 보내므로 그대로 따르면 명령이 없다고 실패한다.
related-repos.md도 "Gradle 루트가 src/라 경로는 두 단계 위"라며
--include-build ../../messaging-library를 적는다. 지금은 workspace 밖을
가리킨다.

고른 방법: /src를 지우고, 라이브러리 경로를 한 단계 위(../messaging-library)로
고친다. 다른 살아 있는 문서에 같은 꼴(cd src, src/gradlew)이 남았는지
git grep으로 봤다. 시험 fixture(broken-readme.md)만 걸린다.

검증: python3 scripts/check-work-docs.py rc=0, check-docs.py rc=0.
This commit is contained in:
DongHyeonka
2026-11-12 21:39:53 +09:00
parent 48789b7c5f
commit 96bbdf6c2e
2 changed files with 4 additions and 4 deletions
+2 -2
View File
@@ -54,7 +54,7 @@ mkdir -p ~/<작업 이름>-logs
uptime # 다른 빌드가 돌고 있는지 부하를 본다
# 3) 공유 잠금 아래에서 한 번에 하나씩 돌리고 rc와 로그를 남긴다
cd ~/workspace/<작업 이름>/src
cd ~/workspace/<작업 이름>
flock /tmp/claude-gates/heavy.lock ./gradlew <게이트> --no-daemon --console=plain > ~/<작업 이름>-logs/<게이트>.log 2>&1; echo "rc=$?"
# 4) 끝나면 worktree를 지운다
@@ -84,7 +84,7 @@ git diff --cached --binary <기준 커밋> | ssh desktop 'cd ~/workspace/<작업
- 형식은 편집 훅이 파일마다 맞추므로 보통 바뀌는 것이 없다. 그래도 커밋을 나누기 전에 확인한다(나눈 뒤에 고치면 앞 커밋을 다시 만들어야 한다). 형식 맞추기(`spotlessApply`)도 Gradle이라 desktop에서 돈다. 패치를 얹은 worktree에서 돌리고, 바뀐 파일을 노트북에 가져와 두 트리 해시가 같은지 본다. 그 뒤의 게이트는 이 트리에서 돌린다.
```bash
ssh desktop 'cd ~/workspace/<작업 이름>/src && flock /tmp/claude-gates/heavy.lock ./gradlew spotlessApply --no-daemon --console=plain'
ssh desktop 'cd ~/workspace/<작업 이름> && flock /tmp/claude-gates/heavy.lock ./gradlew spotlessApply --no-daemon --console=plain'
ssh desktop 'cd ~/workspace/<작업 이름> && git diff --binary' | git apply --index && git write-tree # 노트북
ssh desktop 'cd ~/workspace/<작업 이름> && git add -A && git write-tree' # 같은 해시여야 한다
```
+2 -2
View File
@@ -16,10 +16,10 @@
## 2. 라이브러리를 고칠 때
- 템플릿 안에서 라이브러리 코드를 고치지 않는다. 라이브러리 repo에서 고치고 릴리스한다.
- 템플릿 변경 때문에 라이브러리를 고쳐야 하면 두 repo에 브랜치를 하나씩 만들고, 두 repo를 같은 부모 폴더에 둔다(desktop은 `~/workspace/`). 템플릿에서 명령 줄로만 라이브러리를 끼워 같이 시험한다(composite build: Gradle이 같은 `group:artifact`의 외부 의존성을 끼운 빌드의 프로젝트로 바꿔 끼운다). Gradle 루트가 `src/`라 경로는 두 단계 위다.
- 템플릿 변경 때문에 라이브러리를 고쳐야 하면 두 repo에 브랜치를 하나씩 만들고, 두 repo를 같은 부모 폴더에 둔다(desktop은 `~/workspace/`). 템플릿에서 명령 줄로만 라이브러리를 끼워 같이 시험한다(composite build: Gradle이 같은 `group:artifact`의 외부 의존성을 끼운 빌드의 프로젝트로 바꿔 끼운다). Gradle 루트가 저장소 루트라 경로는 한 단계 위다.
```bash
./gradlew --include-build ../../messaging-library <태스크>
./gradlew --include-build ../messaging-library <태스크>
```
그 상태로 lockfile을 쓰거나 커밋하지 않는다. 끼운 모듈은 lockfile 밖으로 빠질 수 있다. 끼운 빌드는 자기 카탈로그로 컴파일되므로 라이브러리 repo CI 결과와 다를 수 있다. 최종 판정은 배포한 좌표로 돈 템플릿 게이트다.