From 04a10c5b5182017be6359644a22940e0a7d0899a Mon Sep 17 00:00:00 2001 From: DongHyeonka Date: Fri, 13 Nov 2026 21:07:58 +0900 Subject: [PATCH] =?UTF-8?q?docs(skills):=20=EB=85=B8=ED=8A=B8=EB=B6=81=20?= =?UTF-8?q?=EA=B0=90=EC=8B=B8=EA=B0=9C=EB=A1=9C=20Docker=20=EC=97=86?= =?UTF-8?q?=EB=8A=94=20=ED=99=95=EC=9D=B8=20=ED=95=98=EB=82=98=EB=A5=BC=20?= =?UTF-8?q?=EB=8F=8C=EB=A6=AC=EB=8A=94=20=EB=B2=95=EC=9D=84=20=EC=A0=81?= =?UTF-8?q?=EB=8A=94=EB=8B=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 문제: desktop 잠금 줄이 길면 leaf 하나를 확인하는 데도 몇 시간을 기다린다. desktop-gates 스킬은 노트북에서는 아무것도 돌리지 않는다고만 적어, 소유자가 2026-11-13에 연 노트북 레인을 세션이 모른다. 고른 방법: 스킬 끝에 「노트북 레인」 단락 하나를 둔다. 무엇을 돌려도 되는지, 명령(~/.claude/bin/laptop-gate -- ./gradlew :check), 감싸개가 거는 제한, 노트북에서 안 되는 것(Testcontainers가 classpath에 있는 테스트, verify.sh 단계, 증거용 --no-cache 실행)을 적는다. 표와 근거는 design-docs 위임 루프 규칙 11절 「실행 위치」를 가리킨다. 버린 대안: operate.md 4.1절에 쓰기. 다른 브랜치가 같은 파일을 고치고 있어 겹치지 않는 스킬에 둔다. 위험·한계: 감싸개와 H1 훅은 소유자 기계의 개인 파일(~/.claude/)이라 이 repo에 없다. 다른 기계에서 이 단락은 쓸 수 없다. 검증: scripts/verify.sh docs rc=0(scripts/tests 166개 통과, check-repo-layout OK). 노트북 감싸개로 :application-core:check rc=0 (39초, 최대 부하 4.65), :adapter:outbound:cache-redis:test는 init script가 테스트 시작 전에 막았다(rc=1). --- .claude/skills/desktop-gates/SKILL.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/.claude/skills/desktop-gates/SKILL.md b/.claude/skills/desktop-gates/SKILL.md index 49a2ea8d..bfc771a8 100644 --- a/.claude/skills/desktop-gates/SKILL.md +++ b/.claude/skills/desktop-gates/SKILL.md @@ -1,6 +1,6 @@ --- name: desktop-gates -description: 이 repo에서 Gradle·Docker·테스트·게이트·성능 측정을 돌려야 할 때 쓴다. 노트북에서는 돌리지 않고 desktop에서 공유 잠금 아래 돌린다. 사용자가 "테스트 돌려", "게이트", "검증해", "check 돌려", "PR 단계 돌려"라고 하거나, 편집 훅이 턴 끝에 desktop 검증이 없다고 알렸거나, 노트북의 gradlew·docker 실행이 훅에 막혔을 때 부른다. 커밋 전 트리를 패치로 보내 같은 트리에서 돌리는 법, 로그·rc 남기기, 정리까지 준다. +description: 이 repo에서 Gradle·Docker·테스트·게이트·성능 측정을 돌려야 할 때 쓴다. 노트북에서는 Docker 없는 확인 하나만 감싸개로 돌리고, 나머지는 desktop에서 공유 잠금 아래 돌린다. 사용자가 "테스트 돌려", "게이트", "검증해", "check 돌려", "PR 단계 돌려"라고 하거나, 편집 훅이 턴 끝에 desktop 검증이 없다고 알렸거나, 노트북의 gradlew·docker 실행이 훅에 막혔을 때 부른다. 커밋 전 트리를 패치로 보내 같은 트리에서 돌리는 법, 로그·rc 남기기, 정리까지 준다. --- # desktop에서 게이트 돌리기 @@ -14,3 +14,5 @@ description: 이 repo에서 Gradle·Docker·테스트·게이트·성능 측정 5. 다른 세션이 잠금을 쥐고 있으면 기다린다. 기다리는 동안 다른 일을 하고, 잠금 대기는 완료나 첫 실패에서 끝나는 대기 하나로 둔다. 6. 단계 밖의 명령(lane 하나, `spotlessApply`, 탐침)은 `operate.md` 4.1절 「절차」대로 손으로 하고, `--no-daemon`을 붙인다(오래 사는 daemon이 여러 worktree를 받으면 compiler worker가 쌓여 desktop 메모리를 채운다). desktop 기존 checkout의 브랜치와 `stash@{0}`는 건드리지 않는다. 7. 보고에는 단계, rc, 직전 부하(로그 첫 줄), 로그 경로, 대상 트리 해시, 캐시 여부를 적는다. + +**노트북 레인.** 작업 중 확인 하나(leaf의 `check`·`compileJava`, `:app-bootstrap:architectureTest`, `:app-bootstrap:documentContractTest`, SpotBugs)는 desktop 잠금을 기다리지 않고 노트북 감싸개로 돌려도 된다. 저장소 루트에서 `~/.claude/bin/laptop-gate --log <작업 이름> -- ./gradlew :check`를 돌린다. 감싸개가 노트북 잠금, CPU 10개·메모리 12GB 상한, `--no-daemon`·workers 6을 걸고 로그를 노트북 `~/laptop-gate-logs/`에 남긴다. Testcontainers가 classpath에 있는 테스트는 감싸개가 시작 전에 실패시키니 desktop에서 돌린다. `verify.sh` 단계와 증거용 `--no-cache` 실행도 desktop이다. 되는 것과 안 되는 것의 표와 근거는 design-docs 저장소 conventions/delegation-loop.md 11절의 「실행 위치」에 있다. 보고에는 "노트북 감싸개", rc, 시간, 최대 부하, 로그 경로를 적는다. -- 2.54.0