From 96bbdf6c2e5aa2a39be859b3847a27c95170cf80 Mon Sep 17 00:00:00 2001 From: DongHyeonka Date: Thu, 12 Nov 2026 21:39:53 +0900 Subject: [PATCH] =?UTF-8?q?docs(work):=20=EC=9E=AC=EB=B0=B0=EC=B9=98=20?= =?UTF-8?q?=EB=92=A4=EC=97=90=EB=8F=84=20src/=EC=97=90=EC=84=9C=20Gradle?= =?UTF-8?q?=EC=9D=84=20=EB=8F=8C=EB=A6=AC=EB=9D=BC=EB=8A=94=20=EC=A0=88?= =?UTF-8?q?=EC=B0=A8=EB=A5=BC=20=EA=B3=A0=EC=B9=9C=EB=8B=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 문제: 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. --- docs/work/operate.md | 4 ++-- docs/work/reference/related-repos.md | 4 ++-- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/work/operate.md b/docs/work/operate.md index 94f4eecf..83365b17 100644 --- a/docs/work/operate.md +++ b/docs/work/operate.md @@ -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' # 같은 해시여야 한다 ``` diff --git a/docs/work/reference/related-repos.md b/docs/work/reference/related-repos.md index 8f7765b4..587242e9 100644 --- a/docs/work/reference/related-repos.md +++ b/docs/work/reference/related-repos.md @@ -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 결과와 다를 수 있다. 최종 판정은 배포한 좌표로 돈 템플릿 게이트다.