docs(skills): 노트북 감싸개로 Docker 없는 확인 하나를 돌리는 법을 적는다 #41

Open
donghyeon.kang wants to merge 1 commits from donghyeon.kang/docs/laptop-gate-lane AGit into main
Owner

무엇을, 왜

desktop 잠금 줄이 길면 leaf 하나를 확인하는 데도 몇 시간을 기다린다. 소유자가 2026-11-13에 노트북에서 Docker 없는 검사를 감싸개로 돌리는 「노트북 레인」을 열었는데, .claude/skills/desktop-gates/SKILL.md는 노트북에서는 돌리지 않는다고만 적어 세션이 모른다. 스킬 끝에 「노트북 레인」 단락 하나를 두고 description 한 문장을 고친다.

고른 방법과 버린 대안

  • 스킬에 무엇을 돌려도 되는지(leaf check·compileJava, :app-bootstrap:architectureTest, :app-bootstrap:documentContractTest, SpotBugs), 명령(~/.claude/bin/laptop-gate -- ./gradlew <gradle-path>:check), 감싸개가 거는 제한, 노트북에서 안 되는 것을 적는다. 표와 근거는 design-docs 위임 루프 규칙 11절 「실행 위치」를 가리킨다.
  • docs/work/operate.md 4.1절에 쓰기는 버렸다. 다른 브랜치(claude/redteam-be-fixes)가 같은 파일을 고치고 있어 겹치지 않는 스킬에 둔다.

위험과 영향

  • 감싸개와 H1 훅은 소유자 기계의 개인 파일(~/.claude/)이다. 다른 기계에서는 이 단락의 명령이 없다.
  • 노트북 결과는 작업 중 확인용이다. verify.sh 단계와 증거용 --no-cache 실행은 desktop이라고 적었다.

검증

  • scripts/verify.sh docs(노트북): rc=0. scripts/tests 166개 통과, check-repo-layout OK.
  • 노트북 감싸개 실측: :application-core:check rc=0(39초, 최대 부하 4.65, 테스트 437개), :app-bootstrap:architectureTest :app-bootstrap:documentContractTest rc=0(51초, 6.04, 338개). :adapter:outbound:cache-redis:test는 init script가 테스트 시작 전에 막았다(rc=1, 의도).

리뷰어가 볼 곳

  • .claude/skills/desktop-gates/SKILL.md 끝 단락과 description.

관련

  • design-docs conventions/delegation-loop.md 11절 「실행 위치」 PR(브랜치 docs/laptop-gate-lane).
## 무엇을, 왜 desktop 잠금 줄이 길면 leaf 하나를 확인하는 데도 몇 시간을 기다린다. 소유자가 2026-11-13에 노트북에서 Docker 없는 검사를 감싸개로 돌리는 「노트북 레인」을 열었는데, `.claude/skills/desktop-gates/SKILL.md`는 노트북에서는 돌리지 않는다고만 적어 세션이 모른다. 스킬 끝에 「노트북 레인」 단락 하나를 두고 description 한 문장을 고친다. ## 고른 방법과 버린 대안 - 스킬에 무엇을 돌려도 되는지(leaf `check`·`compileJava`, `:app-bootstrap:architectureTest`, `:app-bootstrap:documentContractTest`, SpotBugs), 명령(`~/.claude/bin/laptop-gate -- ./gradlew <gradle-path>:check`), 감싸개가 거는 제한, 노트북에서 안 되는 것을 적는다. 표와 근거는 design-docs 위임 루프 규칙 11절 「실행 위치」를 가리킨다. - `docs/work/operate.md` 4.1절에 쓰기는 버렸다. 다른 브랜치(`claude/redteam-be-fixes`)가 같은 파일을 고치고 있어 겹치지 않는 스킬에 둔다. ## 위험과 영향 - 감싸개와 H1 훅은 소유자 기계의 개인 파일(`~/.claude/`)이다. 다른 기계에서는 이 단락의 명령이 없다. - 노트북 결과는 작업 중 확인용이다. `verify.sh` 단계와 증거용 `--no-cache` 실행은 desktop이라고 적었다. ## 검증 - `scripts/verify.sh docs`(노트북): rc=0. `scripts/tests` 166개 통과, `check-repo-layout` OK. - 노트북 감싸개 실측: `:application-core:check` rc=0(39초, 최대 부하 4.65, 테스트 437개), `:app-bootstrap:architectureTest :app-bootstrap:documentContractTest` rc=0(51초, 6.04, 338개). `:adapter:outbound:cache-redis:test`는 init script가 테스트 시작 전에 막았다(rc=1, 의도). ## 리뷰어가 볼 곳 - `.claude/skills/desktop-gates/SKILL.md` 끝 단락과 description. ## 관련 - design-docs `conventions/delegation-loop.md` 11절 「실행 위치」 PR(브랜치 `docs/laptop-gate-lane`).
donghyeon.kang added 1 commit 2026-11-13 12:09:36 +00:00
문제: desktop 잠금 줄이 길면 leaf 하나를 확인하는 데도 몇 시간을
기다린다. desktop-gates 스킬은 노트북에서는 아무것도 돌리지 않는다고만
적어, 소유자가 2026-11-13에 연 노트북 레인을 세션이 모른다.

고른 방법: 스킬 끝에 「노트북 레인」 단락 하나를 둔다. 무엇을 돌려도
되는지, 명령(~/.claude/bin/laptop-gate -- ./gradlew <gradle-path>: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).
All checks were successful
pr / done (pull_request) Successful in 13m23s
Required
Details
This pull request is blocked because it's outdated.
You are not authorized to merge this pull request.
This branch is out-of-date with the base branch
View command line instructions

Checkout

From your project repository, check out a new branch and test the changes.
git fetch -u origin refs/pull/41/head:donghyeon.kang/docs/laptop-gate-lane
git checkout donghyeon.kang/docs/laptop-gate-lane
Sign in to join this conversation.
No Reviewers
No labels
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: donghyeon.kang/clean-architecture-backend-template#41