docs(skills): 노트북 감싸개로 Docker 없는 확인 하나를 돌리는 법을 적는다
frontend-quality-gates / merge / static checks (pull_request) Successful in 1m35s
frontend-quality-gates / merge / browser tests (pull_request) Successful in 6m43s
frontend-quality-gates / FE-GATE-017 / diagram-review (pull_request) Skipped
frontend-quality-gates / main / self-tests and removal drills (pull_request) Skipped
frontend-quality-gates / FE-GATE-026 / lab-performance (pull_request) Skipped
frontend-quality-gates / promote-verified-immutable-candidate (pull_request) Skipped
frontend-quality-gates / deploy-promoted-release (pull_request) Skipped
frontend-quality-gates / FE-GATE-019 / hosting-header (pull_request) Skipped
frontend-quality-gates / FE-GATE-021 / runbook-boot-config (pull_request) Skipped
frontend-quality-gates / FE-GATE-022 / runbook-chunk-mismatch (pull_request) Skipped
frontend-quality-gates / merge / tests (pull_request) Successful in 14m15s
frontend-quality-gates / FE-GATE-014 / config-compatibility (pull_request) Skipped
frontend-quality-gates / FE-GATE-028 / manual-accessibility-review (pull_request) Skipped
frontend-quality-gates / FE-GATE-015 / immutable-release-candidate (pull_request) Skipped
frontend-quality-gates / external-vulnerability-provider (pull_request) Skipped
frontend-quality-gates / external-provenance-provider (pull_request) Skipped
frontend-quality-gates / FE-GATE-018 / field-web-vitals (pull_request) Skipped
frontend-quality-gates / FE-GATE-023 / runbook-api-degradation (pull_request) Skipped
frontend-quality-gates / FE-GATE-024 / runbook-telemetry (pull_request) Skipped
frontend-quality-gates / FE-GATE-025 / runbook-release-rollback (pull_request) Skipped

문제: desktop 잠금 줄이 길면 lint나 unit 하나를 확인하는 데도 몇
시간을 기다린다. desktop-gates 스킬은 노트북에서는 돌리지 않는다고만
적어, 소유자가 2026-11-13에 연 노트북 레인을 세션이 모른다.

고른 방법: 스킬 끝에 「노트북 레인」 단락 하나를 둔다. 노트북에서
돌려도 되는 script(lint, check:types, FE-GATE-010 경계 검사,
test:unit·test:contract·test:runtime-schema, verify:documentation),
명령(~/.claude/bin/laptop-gate -- corepack pnpm test:unit), 처음 한 번의
오프라인 설치, 감싸개가 거절하는 것(FE-GATE-013, Playwright, component·
integration·coverage, build, 게이트·stage 묶음)을 적는다. merge 가능은
desktop merge 단계로만 말한다고 다시 적는다. 표와 근거는 design-docs
위임 루프 규칙 11절 「실행 위치」를 가리킨다.

위험·한계: 감싸개와 H1 훅은 소유자 기계의 개인 파일(~/.claude/)이라
이 repo에 없다. 다른 기계에서 이 단락은 쓸 수 없다.

검증: scripts/verify.sh docs rc=0, scripts/verify.sh hooks rc=0(77개,
스킬 인용 절 대조 시험 포함). 노트북 감싸개로 corepack pnpm test:unit
rc=0(44초, 3260개, 최대 부하 9.26).
This commit is contained in:
DongHyeonka
2026-11-13 21:07:58 +09:00
parent ee95573f9b
commit 99b229bd5a
+3 -1
View File
@@ -1,6 +1,6 @@
---
name: desktop-gates
description: 이 프론트 repo에서 pnpm·게이트·테스트·빌드·브라우저(Playwright)·성능 측정을 돌려야 할 때 쓴다. 노트북에서는 돌리지 않고 scripts/verify.sh로 desktop에 옮겨 공유 잠금 아래 돌린다. 사용자가 "테스트 돌려", "게이트", "검증해", "merge 게이트", "ci:gate", "FE-GATE", "lint 돌려", "타입 검사"라고 하거나, 편집 훅이 턴 끝에 desktop 검증이 없다고 알렸을 때, merge 가능을 말하기 전에 부른다. 지금 트리를 패치로 보내 같은 트리에서 돌리는 법, CI env, FE-GATE-013 기록법, 로그·rc 남기기를 준다.
description: 이 프론트 repo에서 pnpm·게이트·테스트·빌드·브라우저(Playwright)·성능 측정을 돌려야 할 때 쓴다. 노트북에서는 Docker·브라우저 없는 확인 하나만 감싸개로 돌리고, 나머지는 scripts/verify.sh로 desktop에 옮겨 공유 잠금 아래 돌린다. 사용자가 "테스트 돌려", "게이트", "검증해", "merge 게이트", "ci:gate", "FE-GATE", "lint 돌려", "타입 검사"라고 하거나, 편집 훅이 턴 끝에 desktop 검증이 없다고 알렸을 때, merge 가능을 말하기 전에 부른다. 지금 트리를 패치로 보내 같은 트리에서 돌리는 법, CI env, FE-GATE-013 기록법, 로그·rc 남기기를 준다.
---
# desktop에서 게이트 돌리기
@@ -22,3 +22,5 @@ description: 이 프론트 repo에서 pnpm·게이트·테스트·빌드·브라
6. FE-GATE-013은 `scripts/verify.sh`가 시스템 컨테이너(`scripts/run-in-system-container.sh`) 안에서 돌린다. 다른 게이트와 같이 rc로 적는다. 컨테이너를 띄울 수 없는 호스트에서만 `VERIFY_HOST_ENVIRONMENT=off`로 호스트에서 돌리고, 실패가 user namespace 제약 하나뿐이고 뒤 명령이 모두 rc=0일 때 merge 판정에서 뺀다(`docs/work/reference/gates.md` 3절).
7. 실패하면 기준 커밋에서도 돌려 이번 변경 몫인지 가린다. 다시 돌려 통과한 결과를 "통과"로 쓰지 않는다.
8. 보고에는 단계·게이트, rc, 시간, 핵심 숫자, 직전 부하, 트리 해시, 로그 경로를 적는다(`docs/work/operate.md` 8절 표).
**노트북 레인.** 작업 중 확인 하나(`lint`, `check:types`, FE-GATE-010의 경계 검사, vitest의 `test:unit`·`test:contract`·`test:runtime-schema`, `verify:documentation`)는 desktop 잠금을 기다리지 않고 노트북 감싸개로 돌려도 된다. worktree 루트에서 처음 한 번 `~/.claude/bin/laptop-gate -- corepack pnpm install --offline --frozen-lockfile`, 그다음 `~/.claude/bin/laptop-gate --log <작업 이름> -- corepack pnpm test:unit`처럼 돌린다. 한 파일은 `-- node scripts/run-vitest.ts run tests/unit/<파일>`이다. 감싸개가 노트북 잠금, CPU 10개·메모리 12GB 상한, vitest workers 6을 걸고 로그를 노트북 `~/laptop-gate-logs/`에 남긴다. FE-GATE-013, 브라우저(Playwright), component·integration·coverage, build, 게이트·stage 묶음은 감싸개가 거절하니 desktop에서 돌린다. merge 가능은 desktop `merge` 단계로만 말한다. 되는 것과 안 되는 것의 표와 근거는 design-docs 저장소 conventions/delegation-loop.md 11절의 「실행 위치」에 있다. 보고에는 "노트북 감싸개", rc, 시간, 최대 부하, 로그 경로를 적는다.