From 1f38b9cfe8c4e523a6c86810b08439a4c948cc1a Mon Sep 17 00:00:00 2001
From: hslee <fadeguy@gmail.com>
Date: Mon, 5 Oct 2026 11:56:11 +0900
Subject: [PATCH 1/4] =?UTF-8?q?feat(hooks):=20=EC=BB=A4=EB=B0=8B=20?=
 =?UTF-8?q?=EA=B2=8C=EC=9D=B4=ED=8A=B8=EA=B0=80=20package.json=20lint=20?=
 =?UTF-8?q?=EC=8A=A4=ED=81=AC=EB=A6=BD=ED=8A=B8=EB=A5=BC=20=EB=8F=8C?=
 =?UTF-8?q?=EB=A6=B0=EB=8B=A4?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

typecheck → lint → test 순서. lint 위반은 exit 2로 차단하고, 실행 불가(exit 127 — 린터 미설치)는 경고 후 통과한다. test 게이트는 127도 계속 차단한다(의도된 비대칭). 직전 판을 stock sha 테이블·fixture에 추가해 migrate refresh로 배달한다.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
---
 docs/diagrams/harness-overview/hooks.mmd      |   5 +-
 docs/harness-overview.html                    |  13 +-
 docs/harness-overview.template.html           |   3 +-
 .../commit-gate-lint-artifact.md              |  38 +++++
 .../commit-gate-lint-context.md               |  22 +++
 .../commit-gate-lint-handoff.md               |   3 +
 .../commit-gate-lint-meta.json                |  11 ++
 .../commit-gate-lint/commit-gate-lint-plan.md |  20 +++
 .../commit-gate-lint/commit-gate-lint-spec.md |  84 +++++++++++
 src/commands/migrate.mjs                      |   1 +
 templates/.claude/hooks/pre-commit-check.sh   |  30 +++-
 tests/fixtures/stock-hooks/README.md          |   3 +
 .../stock-hooks/pre-lint/pre-commit-check.sh  | 133 ++++++++++++++++++
 tests/hooks-jq-fallback.test.mjs              |  56 ++++++++
 tests/migrate-hooks.test.mjs                  |  12 +-
 15 files changed, 420 insertions(+), 14 deletions(-)
 create mode 100644 docs/hslee/commit-gate-lint/commit-gate-lint-artifact.md
 create mode 100644 docs/hslee/commit-gate-lint/commit-gate-lint-context.md
 create mode 100644 docs/hslee/commit-gate-lint/commit-gate-lint-handoff.md
 create mode 100644 docs/hslee/commit-gate-lint/commit-gate-lint-meta.json
 create mode 100644 docs/hslee/commit-gate-lint/commit-gate-lint-plan.md
 create mode 100644 docs/hslee/commit-gate-lint/commit-gate-lint-spec.md
 create mode 100755 tests/fixtures/stock-hooks/pre-lint/pre-commit-check.sh

diff --git a/docs/diagrams/harness-overview/hooks.mmd b/docs/diagrams/harness-overview/hooks.mmd
index af0eb457..8da4da8e 100644
--- a/docs/diagrams/harness-overview/hooks.mmd
+++ b/docs/diagrams/harness-overview/hooks.mmd
@@ -27,8 +27,9 @@ sequenceDiagram
     rect rgb(40, 26, 26)
         Note over Claude,Tool: PreToolUse — Bash git commit 실행 전
         Claude->>Hook: pre-commit-check.sh (명령어 전달)
-        Hook->>Hook: pnpm tsc --noEmit
-        Hook->>Hook: pnpm test
+        Hook->>Hook: $PM tsc --noEmit (tsconfig.json 있을 때)
+        Hook->>Hook: $PM run lint (127이면 경고 후 통과)
+        Hook->>Hook: $PM test
         alt 실패
             Hook-->>Claude: exit 2 (커밋 차단)
         else 통과
diff --git a/docs/harness-overview.html b/docs/harness-overview.html
index b0e31b83..d6c902bc 100644
--- a/docs/harness-overview.html
+++ b/docs/harness-overview.html
@@ -847,8 +847,9 @@ <h3>release --json</h3>
     rect rgb(40, 26, 26)
         Note over Claude,Tool: PreToolUse — Bash git commit 실행 전
         Claude->>Hook: pre-commit-check.sh (명령어 전달)
-        Hook->>Hook: pnpm tsc --noEmit
-        Hook->>Hook: pnpm test
+        Hook->>Hook: $PM tsc --noEmit (tsconfig.json 있을 때)
+        Hook->>Hook: $PM run lint (127이면 경고 후 통과)
+        Hook->>Hook: $PM test
         alt 실패
             Hook-->>Claude: exit 2 (커밋 차단)
         else 통과
@@ -882,7 +883,8 @@ <h3><span class="hook-badge hook-pre">PreToolUse</span> pre-commit-check.sh</h3>
         <p>Bash 도구에서 <code>git commit</code> 명령 감지 시 검증 실행.</p>
         <ul style="margin-top:0.6rem">
           <li>lockfile로 pnpm/yarn/bun/npm을 감지해 <code>&lt;pm&gt; tsc --noEmit</code> — 타입 에러 시 차단</li>
-          <li><code>&lt;pm&gt; test</code> — 테스트 실패 시 차단 (package.json에 test 스크립트가 없으면 통과)</li>
+          <li><code>&lt;pm&gt; run lint</code> — lint 위반 시 차단 (package.json에 lint 스크립트가 없으면 건너뜀). 린터를 실행할 수 없으면(exit 127, 린터 미설치) ⚠ 경고만 내고 통과</li>
+          <li><code>&lt;pm&gt; test</code> — 테스트 실패 시 차단 (package.json에 test 스크립트가 없으면 통과). lint와 달리 exit 127도 차단한다</li>
           <li>timeout: 120초</li>
         </ul>
       </div>
@@ -2529,6 +2531,11 @@ <h3>병합 마커 포맷</h3>
             <td><span class="tag tag-blue" style="font-size:0.7rem;padding:1px 7px;">Test</span></td>
             <td>자동 회귀 검증</td>
           </tr>
+          <tr>
+            <td><code>tests/fixtures/stock-hooks/pre-lint/pre-commit-check.sh</code></td>
+            <td><span class="tag tag-blue" style="font-size:0.7rem;padding:1px 7px;">Test</span></td>
+            <td>자동 회귀 검증</td>
+          </tr>
           <tr>
             <td><code>tests/fixtures/stock-hooks/pre-rn-ios-secrets/protect-files.sh</code></td>
             <td><span class="tag tag-blue" style="font-size:0.7rem;padding:1px 7px;">Test</span></td>
diff --git a/docs/harness-overview.template.html b/docs/harness-overview.template.html
index 1502a1e9..1f8bcf7f 100644
--- a/docs/harness-overview.template.html
+++ b/docs/harness-overview.template.html
@@ -606,7 +606,8 @@ <h3><span class="hook-badge hook-pre">PreToolUse</span> pre-commit-check.sh</h3>
         <p>Bash 도구에서 <code>git commit</code> 명령 감지 시 검증 실행.</p>
         <ul style="margin-top:0.6rem">
           <li>lockfile로 pnpm/yarn/bun/npm을 감지해 <code>&lt;pm&gt; tsc --noEmit</code> — 타입 에러 시 차단</li>
-          <li><code>&lt;pm&gt; test</code> — 테스트 실패 시 차단 (package.json에 test 스크립트가 없으면 통과)</li>
+          <li><code>&lt;pm&gt; run lint</code> — lint 위반 시 차단 (package.json에 lint 스크립트가 없으면 건너뜀). 린터를 실행할 수 없으면(exit 127, 린터 미설치) ⚠ 경고만 내고 통과</li>
+          <li><code>&lt;pm&gt; test</code> — 테스트 실패 시 차단 (package.json에 test 스크립트가 없으면 통과). lint와 달리 exit 127도 차단한다</li>
           <li>timeout: 120초</li>
         </ul>
       </div>
diff --git a/docs/hslee/commit-gate-lint/commit-gate-lint-artifact.md b/docs/hslee/commit-gate-lint/commit-gate-lint-artifact.md
new file mode 100644
index 00000000..045426f9
--- /dev/null
+++ b/docs/hslee/commit-gate-lint/commit-gate-lint-artifact.md
@@ -0,0 +1,38 @@
+# commit-gate-lint — Artifact
+
+*최종 결과물과 학습 내용을 기록한다.*
+
+## 결과
+
+- 커밋 게이트(`templates/.claude/hooks/pre-commit-check.sh`)가 typecheck → **lint** → test 순으로 돈다.
+  package.json `lint`가 있을 때만 `<pm> run lint` — 위반은 `exit 2`, 127(실행 불가)은 ⚠ 경고 후 통과.
+  test 게이트는 바꾸지 않았다(127도 차단 — 의도된 비대칭, spec 참조). `has_test_script` → `has_script <name>` 일반화.
+- 배달: 직전 판(blob `ed90db5b`)을 `KNOWN_STOCK_HOOK_SHA256`·`tests/fixtures/stock-hooks/pre-lint/`에 추가 —
+  stock 설치본은 migrate refresh로 갱신, 커스터마이즈본은 보존(기존 계약).
+- 테스트: `tests/hooks-jq-fallback.test.mjs`에 npm 스텁 기반 4케이스 × jq 있음/없음(위반·통과·없음·127),
+  `tests/migrate-hooks.test.mjs`에 pre-lint 판 refresh 1건. 구 훅으로 바꿔 돌리면 신규 6건이 실패(판별력 확인).
+- 문서: overview 카드(lint 단계·127 비대칭)와 `hooks.mmd`(낡은 `pnpm` 하드코딩 → `$PM`, lint 단계) 갱신.
+  `/verify` 스킬·README는 훅 동작을 서술하지 않아 변경하지 않았다(`/verify` 수정은 stock-template 테이블 갱신만 늘린다).
+
+### 착수 전 실측 (2026-10-05)
+- deep-math `npm run lint` → exit 127 `sh: eslint: command not found` (eslint 의존성·설정 모두 없음 — 죽은 스크립트).
+- heliosent-profile `bun run lint` → exit 0.
+- → 사용자 결정 C안: 위반은 차단, 127만 경고.
+
+### 후속 후보 (이번 task에서 고치지 않음 — 사용자 지시)
+- 템플릿 `detect_pm`이 `bun.lockb`만 봐서 bun 1.2+ 텍스트 락파일 `bun.lock` 프로젝트를 npm으로 오인한다
+  (heliosent-profile은 로컬 수정으로 우회 중).
+- heliosent-profile의 `pre-commit-check.sh`는 커스터마이즈본이라 migrate가 덮지 않는다 → lint 게이트가 배달되지 않는다.
+  수동 병합 또는 bun.lock 수정을 템플릿에 올린 뒤 stock 판정 재검토가 필요하다.
+- deep-math의 죽은 `lint` 스크립트: eslint 설치 또는 스크립트 제거(현재는 매 커밋 ⚠ 경고).
+- package.json 없는 프로젝트(ruff의 job-scraper)로의 확장.
+
+## Reviews
+*Codex 등 리뷰 실행 시 결과(요약·발견·조치)를 날짜와 함께 남긴다. 남기지 않은 리뷰는 "안 한 것"으로 간주.*
+*기계 판독용 마커를 함께 남긴다: `<!-- harness:review kind=codex scope=worktree tip=<sha|none> at=<ISO8601> -->`*
+
+
+## Learnings
+
+- 훅 템플릿 바이트를 바꾸면 세 곳을 함께 바꿔야 한다: `KNOWN_STOCK_HOOK_SHA256` 직전 판 sha, `stock-hooks/<era>/` fixture,
+  드리프트 가드의 fixture 개수(`checked`). 이력 완전성 테스트는 `HEAD` 기준이라 **커밋 전에는 반드시 실패**한다.
diff --git a/docs/hslee/commit-gate-lint/commit-gate-lint-context.md b/docs/hslee/commit-gate-lint/commit-gate-lint-context.md
new file mode 100644
index 00000000..b0a9bc31
--- /dev/null
+++ b/docs/hslee/commit-gate-lint/commit-gate-lint-context.md
@@ -0,0 +1,22 @@
+# commit-gate-lint — Context Card
+<!-- working set only; UTF-8 <= 6 KiB, nonblank lines <= 100 -->
+
+## Now
+- Goal: 커밋 게이트에 package.json `lint` 단계 추가 — 위반 exit 2, 127 경고 후 통과
+- Current atomic step: 커밋 후 `npm run test` 전체 → Codex read-only 리뷰
+- Stop / human-decision condition: push·PR은 사용자 명시 지시 전 금지
+
+## Constraints and settled decisions
+- 사용자 결정 C안(2026-10-05): lint 127만 경고, test 게이트는 127도 차단(불변)
+- jq-fallback 블록·timeout 120s 불변, detect_pm bun.lock·heliosent 커스텀 훅은 후속(artifact)
+
+## JIT retrieval map
+- Identifiers / symbols: `has_script`, `lint_rc`, `KNOWN_STOCK_HOOK_SHA256`
+- Narrow globs: `templates/.claude/hooks/pre-commit-check.sh`, `tests/fixtures/stock-hooks/pre-lint/`
+- Read next: `tests/hooks-jq-fallback.test.mjs` (runCommitWithNpm), `tests/migrate-hooks.test.mjs`
+- Verification command: `npm run test`, `npm run docs:check`
+
+## Failure capsules (max 3 unresolved)
+
+## Resume checklist
+- 이력 완전성 테스트는 HEAD 기준 — 커밋 후 재실행
diff --git a/docs/hslee/commit-gate-lint/commit-gate-lint-handoff.md b/docs/hslee/commit-gate-lint/commit-gate-lint-handoff.md
new file mode 100644
index 00000000..038d4477
--- /dev/null
+++ b/docs/hslee/commit-gate-lint/commit-gate-lint-handoff.md
@@ -0,0 +1,3 @@
+# commit-gate-lint — Handoff
+
+(세션 종료 시 post-commit hook이 자동 갱신합니다)
diff --git a/docs/hslee/commit-gate-lint/commit-gate-lint-meta.json b/docs/hslee/commit-gate-lint/commit-gate-lint-meta.json
new file mode 100644
index 00000000..a8e94f52
--- /dev/null
+++ b/docs/hslee/commit-gate-lint/commit-gate-lint-meta.json
@@ -0,0 +1,11 @@
+{
+  "user": "hslee",
+  "task": "commit-gate-lint",
+  "created": "2026-10-05",
+  "firstActivatedAt": "2026-10-05T02:50:50.742Z",
+  "status": "open",
+  "closedAt": null,
+  "forcedAt": null,
+  "forcedIssues": null,
+  "reviews": []
+}
diff --git a/docs/hslee/commit-gate-lint/commit-gate-lint-plan.md b/docs/hslee/commit-gate-lint/commit-gate-lint-plan.md
new file mode 100644
index 00000000..6e1d0968
--- /dev/null
+++ b/docs/hslee/commit-gate-lint/commit-gate-lint-plan.md
@@ -0,0 +1,20 @@
+# commit-gate-lint — Plan
+
+## 목표
+커밋 게이트가 package.json `lint`를 typecheck와 test 사이에 돌린다 — 위반은 차단, 127은 경고 후 통과.
+
+## 단계
+- [x] 훅: `has_script` 일반화 + lint 단계(0 통과 / 127 ⚠ / 그 외 exit 2)
+- [x] 배달: 직전 판을 `KNOWN_STOCK_HOOK_SHA256`·`tests/fixtures/stock-hooks/pre-lint/`·fixture README에 추가
+- [x] 테스트: hooks-jq-fallback(위반·통과·없음·127, jq 매트릭스) + migrate-hooks(pre-lint 판 refresh)
+- [x] 문서: overview 카드·`hooks.mmd`(127 비대칭 명시), `npm run docs:check`
+- [ ] 검증: `npm run test` 전체 통과
+- [ ] Codex read-only 리뷰 → artifact `## Reviews`
+
+## Ontology 변경 로그
+*개념이 새로 정의되거나 의미가 바뀌면 한 줄로 기록. spec.md의 Ontology 섹션을 갱신할 트리거가 된다.*
+
+- 2026-10-05: "lint 위반"과 "lint 실행 불가(127)"를 구분 — 후자는 경고만.
+
+## 참고
+- spec의 PM별 127 실측 표
diff --git a/docs/hslee/commit-gate-lint/commit-gate-lint-spec.md b/docs/hslee/commit-gate-lint/commit-gate-lint-spec.md
new file mode 100644
index 00000000..0e788025
--- /dev/null
+++ b/docs/hslee/commit-gate-lint/commit-gate-lint-spec.md
@@ -0,0 +1,84 @@
+# commit-gate-lint — Spec
+
+## 목적 / 요구사항
+*문제(오늘 무엇이 안 되는가) → 영향받는 사용자·시스템 → 기대 결과 → 제약 순으로 쓴다.
+답 없는 질문은 요구가 아니다 — `## 참고` 절에 `- (open) …`으로 남긴다.*
+
+- **문제**: 템플릿 커밋 게이트 `templates/.claude/hooks/pre-commit-check.sh`는 `tsc --noEmit`(tsconfig.json 있을 때)과
+  package.json `test`만 돌린다. lint는 사람이 `/verify`(`disable-model-invocation: true`)를 부를 때만 돌아,
+  AI가 무시할 수 있는 규범에 머문다.
+- **영향**: 하네스를 설치한 JS 소비자 프로젝트(deep-math·heliosent-profile 등)의 Claude Code 커밋.
+- **기대 결과**: package.json에 `lint` 스크립트가 있으면 커밋 직전에 결정론적으로 실행한다.
+  - 실제 위반(exit ≠ 0, ≠ 127) → `exit 2`로 차단, 기존 두 줄 형식(❌ + `→ 확인 명령`).
+  - 실행 불가(exit 127, command not found — 린터 미설치·스크립트만 남은 경우) → ⚠ 경고 두 줄 후 통과.
+  - lint 스크립트 없음 → 건너뜀. jq 유무와 무관하게 같은 판정(jq 없으면 node 폴백).
+  - 순서: typecheck → lint → test (싼 검사 먼저).
+- **의도된 비대칭**: test 게이트는 127이어도 **차단**한다(변경하지 않음). lint만 127을 경고로 강등한다 —
+  사용자 결정 C안(2026-10-05). 근거: 착수 전 실측에서 deep-math의 `lint` 스크립트가 eslint 미설치로 exit 127
+  (죽은 스크립트)이라, 차단 도입 시 stock 훅을 쓰는 소비자의 모든 커밋이 갑자기 막히는 회귀가 난다.
+- **제약**: 특정 린터·규칙 세트를 내장하지 않는다(스택 중립). 훅 timeout(120s)과 `harness:jq-fallback` 공통 블록은
+  건드리지 않는다. package.json 없는 프로젝트(ruff의 job-scraper)·AGENTS.md `lint:` 파싱·auto-format·린터 규칙은 범위 밖.
+
+## 설계 / 접근
+
+- `has_test_script`를 `has_script <name>`으로 일반화(jq `.scripts[$s]` / node `scripts[argv]`), test·lint 공용.
+- lint 실행은 `"$PM" run lint` — npm·pnpm·yarn·bun 모두 `run <script>`가 package.json 스크립트를 탄다
+  (bun은 `bun run lint`가 되어 요구사항과 일치). stderr는 test 게이트처럼 버린다.
+- 종료 코드 분기: `0` 통과 · `127` ⚠ 경고 후 통과 · 그 외 ❌ `exit 2`.
+- 배달: 훅 바이트가 바뀌므로 직전 판(blob `ed90db5b`)을 `KNOWN_STOCK_HOOK_SHA256`·`tests/fixtures/stock-hooks/pre-lint/`에
+  추가한다 — stock 설치본은 migrate refresh로 갱신되고, 커스터마이즈본은 덮지 않는다(기존 계약 유지).
+
+### PM별 127 전파 실측 (2026-10-05, 빈 프로젝트 + `"lint": "nonexistent-linter-xyz ."`)
+
+| PM | 버전 | `<pm> run lint` exit |
+|---|---|---|
+| npm | 11.9.0 | 127 |
+| pnpm | 12.4.1 | 127 |
+| yarn classic | 1.22.22 (npx) | 127 |
+| yarn berry | 4.5.0 (npx, `yarn install` 후) | 127 (`yarn lint`도 127) |
+| bun | 1.3.9 | 127 |
+
+**성립하지 않는 경우(차단으로 남는다)**:
+- yarn berry에서 **install하지 않은** 프로젝트는 스크립트 실행 전 lockfile 오류로 **exit 1** → lint 위반과 구분 불가 → 차단.
+- PM 바이너리 자체가 없으면(예: pnpm-lock.yaml인데 pnpm 미설치) bash가 127을 돌려 lint는 경고·통과하고, test 게이트가 같은 이유로 차단한다.
+- lint 스크립트 체인 안의 다른 명령이 없어서 127이 나도 "실행 불가"로 보고 경고한다(구분 불가, 수용).
+
+## Ontology
+*이 task가 다루는 핵심 개념의 정의. "X가 정확히 뭔가?"에 답한다.*
+
+- **lint 위반**: `<pm> run lint`가 0도 127도 아닌 코드로 끝난 상태 — 커밋 차단 사유.
+- **lint 실행 불가**: `<pm> run lint`가 127(command not found)로 끝난 상태 — 경고 사유, 차단하지 않는다.
+- 게이트 통과 근거: Goal·Constraint·Success·Context 모두 명확(사용자 결정 C안 + PM 실측) → Ambiguity ≈ 0.
+
+## Ambiguity 자가진단
+*각 항목이 명확하면 체크. 3개 이상 미체크면 구현 진입 금지 — 인터뷰/브레인스토밍으로 복귀해
+모호성을 제거한다. 게이트를 통과하면 그 근거를 위 Ontology 섹션에 한 줄로 남긴다.*
+
+- [x] **Goal 명확도** (40%) — package.json `lint`가 있으면 커밋 전에 돌려 위반은 막고 127은 경고한다.
+- [x] **Constraint 명확도** (30%) — 스택 중립·timeout/jq 블록 불변·test 게이트 불변·범위 밖 4항목 명시.
+- [x] **Success 기준** (30%) — 아래 Success 기준 + `npm run test`·`npm run docs:check` 통과.
+- [x] **Context 명확도** (brownfield 한정) — 훅·migrate 테이블·fixture·hooks/migrate 테스트·overview 카드·hooks.mmd.
+- [x] **Ambiguity ≤ 0.2** — 가중합 1.0
+
+### Success 기준
+- jq 있음/없음 각각: lint 위반 → exit 2 + `lint 실패` · lint 통과 → exit 0 · lint 없음 → lint 미실행 · lint 127 → exit 0 + ⚠ 경고.
+- test 127은 여전히 exit 2(기존 테스트가 고정).
+- 직전 stock 판 설치본이 migrate refresh로 lint 게이트를 받는다.
+
+<!-- 선택 선언. 아래 주석을 벗기면 done 가드가 검사한다.
+     미선언 기본값: "tests": "required" (소스가 바뀌면 테스트 파일 변경을 요구), "review": "optional",
+     "verify": "optional" ("required"면 검증 프레이밍 kind 마커 — -adversarial 등 — 를 요구). -->
+## Done evidence
+```json
+{ "version": 1, "review": "required", "tests": "required" }
+```
+
+## 참고
+*코드 기반 참조가 산문 설계보다 정밀하다 — 테스트 스위트·Boundary contract(JSON Schema)·
+다이어그램·기존 코드 경로를 우선 링크하고, 산문은 코드로 표현 못 하는 의도만 담는다.*
+
+- `templates/.claude/hooks/pre-commit-check.sh` — 게이트 본체
+- `tests/hooks-jq-fallback.test.mjs` — pre-commit-check jq 매트릭스
+- `tests/migrate-hooks.test.mjs`, `src/commands/migrate.mjs` `KNOWN_STOCK_HOOK_SHA256` — 배달 경로
+- 소비자 실측(2026-10-05): deep-math `npm run lint` exit 127(`eslint: command not found`, 의존성·설정 없음) /
+  heliosent-profile `bun run lint` exit 0
diff --git a/src/commands/migrate.mjs b/src/commands/migrate.mjs
index e8f03a89..e58ddb58 100644
--- a/src/commands/migrate.mjs
+++ b/src/commands/migrate.mjs
@@ -391,6 +391,7 @@ export const KNOWN_STOCK_HOOK_SHA256 = {
     '239cedf809c22cfcf09b07ac5f9d21a98da88bc85aaadd0cd577daadaf5de392', // d4662b9b detect_pm판
     'f5b79e0c0fd2cd54a284a7c4f3139681ad95b761cf45738282523f1c85bdcf0d', // d2132caf PR #29
     '524cf3b6cb5952a02c4464a3b46b47dbef8abb82388ea786d50ca8ca17ca24ef', // 757d115f tool_input 스코프판 (`git -C`·`--no-pager` 우회 이전)
+    '2d45fd26d6e68288c1ee6386b32d91190d8a5a0e13fd20e560c78f9d7820eab7', // ed90db5b 토큰 경계판 (lint 게이트 이전)
   ],
   'auto-format.sh': [
     'ba2ab843b6609543748e66d96ba26dbb2982444e8f24c4af10910ab8546e8327', // 58c4fe2e initial
diff --git a/templates/.claude/hooks/pre-commit-check.sh b/templates/.claude/hooks/pre-commit-check.sh
index ed90db5b..a2a6869d 100755
--- a/templates/.claude/hooks/pre-commit-check.sh
+++ b/templates/.claude/hooks/pre-commit-check.sh
@@ -1,5 +1,5 @@
 #!/bin/bash
-# PreToolUse hook: git commit 실행 전 typecheck + test 통과 여부 확인.
+# PreToolUse hook: git commit 실행 전 typecheck → lint → test 통과 여부 확인.
 # Bash 도구에서 git commit 명령 감지 시 동작한다.
 # 패키지 매니저는 lockfile로 감지한다 (src/detect-stack.mjs와 동일 우선순위):
 #   pnpm-lock.yaml → pnpm, yarn.lock → yarn, bun.lockb → bun, 없으면 npm.
@@ -94,14 +94,14 @@ pm_run_test() {
   esac
 }
 
-# package.json에 test 스크립트가 있는지 — jq가 없으면 node로 판정한다.
+# package.json에 $1 스크립트(test·lint)가 있는지 — jq가 없으면 node로 판정한다.
 # node는 이 하네스의 기존 하드 의존(settings.json이 매 도구 호출마다 observe-tools.mjs를 돌린다)이라
-# jq보다 안전한 폴백이다. 둘 다 없으면 테스트를 실행할 수단 자체가 없으므로 판정 불가로 둔다.
-has_test_script() {
+# jq보다 안전한 폴백이다. 둘 다 없으면 스크립트를 실행할 수단 자체가 없으므로 판정 불가로 둔다.
+has_script() {
   if [[ $jq_missing -eq 0 ]]; then
-    jq -e '.scripts.test // empty' package.json >/dev/null 2>&1
+    jq -e --arg s "$1" '.scripts[$s] // empty' package.json >/dev/null 2>&1
   elif command -v node >/dev/null 2>&1; then
-    node -e 'const s=(require("./package.json").scripts||{}).test; process.exit(s?0:1)' >/dev/null 2>&1
+    node -e 'const s=(require("./package.json").scripts||{})[process.argv[1]]; process.exit(s?0:1)' "$1" >/dev/null 2>&1
   else
     return 1
   fi
@@ -120,8 +120,24 @@ if [[ -f tsconfig.json ]]; then
   fi
 fi
 
+# 린트 — package.json에 lint 스크립트가 있을 때만. 린터·규칙은 프로젝트 것을 그대로 쓴다.
+# 127(command not found — 린터 미설치, 스크립트만 남은 경우)은 위반이 아니라 실행 불가라 경고 후 통과한다.
+# 테스트 게이트는 127이어도 막는다 — 의도된 비대칭이다(죽은 lint 스크립트로 모든 커밋이 막히는 회귀 방지).
+if has_script lint; then
+  lint_rc=0
+  "$PM" run lint 2>/dev/null || lint_rc=$?
+  if [[ $lint_rc -eq 127 ]]; then
+    echo "⚠ lint를 실행할 수 없습니다 (exit 127: 린터 미설치?). lint 없이 진행합니다." >&2
+    echo "   → $PM run lint 로 원인을 확인하세요." >&2
+  elif [[ $lint_rc -ne 0 ]]; then
+    echo "❌ lint 실패. 커밋을 중단합니다." >&2
+    echo "   → $PM run lint 로 위반을 확인하세요." >&2
+    exit 2
+  fi
+fi
+
 # 테스트 — package.json에 test 스크립트가 있을 때만.
-if has_test_script; then
+if has_script test; then
   if ! pm_run_test 2>/dev/null; then
     echo "❌ 테스트 실패. 커밋을 중단합니다." >&2
     echo "   → $PM test 로 실패한 테스트를 확인하세요." >&2
diff --git a/tests/fixtures/stock-hooks/README.md b/tests/fixtures/stock-hooks/README.md
index 083b7e74..713a9960 100644
--- a/tests/fixtures/stock-hooks/README.md
+++ b/tests/fixtures/stock-hooks/README.md
@@ -31,3 +31,6 @@
 | `pre-rn-ios-secrets/protect-files.sh` | `804e3181` | `58b2284` audit-cleanup판 (`Fastfile`·`figma-export.y(a)ml`·`*.xcconfig` 보호 이전) |
 
 `pre-rn-ios-secrets`는 `c46ea0d`(2026-09-22, RN·iOS 빌드 비밀 3종 추가) 직전 판이다 — v0.24.0~v0.40.2가 이 바이트를 배포했다.
+| `pre-lint/pre-commit-check.sh` | `ed90db5b` | `631f2fd` 토큰 경계판 (package.json `lint` 게이트 이전) |
+
+`pre-lint`는 commit-gate-lint(커밋 게이트에 lint 단계 추가) 직전 판이다.
diff --git a/tests/fixtures/stock-hooks/pre-lint/pre-commit-check.sh b/tests/fixtures/stock-hooks/pre-lint/pre-commit-check.sh
new file mode 100755
index 00000000..ed90db5b
--- /dev/null
+++ b/tests/fixtures/stock-hooks/pre-lint/pre-commit-check.sh
@@ -0,0 +1,133 @@
+#!/bin/bash
+# PreToolUse hook: git commit 실행 전 typecheck + test 통과 여부 확인.
+# Bash 도구에서 git commit 명령 감지 시 동작한다.
+# 패키지 매니저는 lockfile로 감지한다 (src/detect-stack.mjs와 동일 우선순위):
+#   pnpm-lock.yaml → pnpm, yarn.lock → yarn, bun.lockb → bun, 없으면 npm.
+
+# --- harness:jq-fallback (훅 4개 공통 — 동일 블록 유지, tests/hooks-jq-fallback.test.mjs가 대조) ---
+# jq가 PATH에 없으면 이 훅들은 파싱 결과가 빈 문자열이 되어 조용히 통과(fail-open)했다.
+# jq 없이도 같은 판정이 나오도록 `"key": "value"` 문자열만 잘라내 같은 검사에 넘긴다(저정밀 모드).
+# 한계: 같은 키가 여러 번 나오면 첫 매치만 읽고, JSON 이스케이프를 일절 디코드하지 않는다 —
+# 값 속 문자 하나만 \uXXXX 등으로 인코딩돼도 저정밀 매칭을 우회할 수 있다(해법: jq 설치).
+if command -v jq >/dev/null 2>&1; then jq_missing=0; else jq_missing=1; fi
+
+json_field() {  # $1=key, $2=json — 값만 stdout, 못 찾으면 return 1
+  local raw
+  raw=$(printf '%s' "$2" | grep -oE "\"$1\""'[[:space:]]*:[[:space:]]*"([^"\\]|\\.)*"')
+  raw=${raw%%$'\n'*}
+  [[ -z "$raw" ]] && return 1
+  raw=${raw#*:}
+  raw=${raw#*\"}
+  printf '%s' "${raw%\"}"
+}
+
+json_input_field() {  # $1=key, $2=json — "tool_input" 이후로 좁혀 최상위 동명 키 오인을 막는다.
+  # 마커가 없으면 ${...#...}가 원문을 그대로 돌려주므로 전체 스캔이 유지된다(fail-closed).
+  json_field "$1" "${2#*\"tool_input\"}"
+}
+# --- /harness:jq-fallback ---
+
+INPUT=$(cat)
+
+if [[ $jq_missing -eq 0 ]]; then
+  TOOL_NAME=$(echo "$INPUT" | jq -r '.tool_name // empty')
+  COMMAND=$(echo "$INPUT" | jq -r '.tool_input.command // empty')
+
+  # Bash 도구의 git commit 명령만 가로챔
+  if [[ "$TOOL_NAME" != "Bash" ]]; then
+    exit 0
+  fi
+else
+  # 저정밀 모드: tool_name을 뽑을 수 있을 때만 Bash 게이트를 적용한다.
+  # 못 뽑았다는 이유로 통과시키는 것이 바로 여기서 고치는 fail-open이다.
+  if TOOL_NAME=$(json_field tool_name "$INPUT") && [[ "$TOOL_NAME" != "Bash" ]]; then
+    exit 0
+  fi
+  # command를 못 뽑으면 payload 전체를 검사한다 — 커밋 게이트를 조용히 건너뛰지 않는다.
+  COMMAND=$(json_input_field command "$INPUT") || COMMAND="$INPUT"
+fi
+
+# git과 subcommand 사이에 올 수 있는 전역 옵션 — block-dangerous-git.sh의 GIT/END와 같은 규칙.
+# `git -C . commit`·`git --no-pager commit`이 `*"git commit"*` 부분 문자열 검사를 비껴가 게이트 없이
+# 통과하던 우회(2026-09-13 Codex 분석 P2)를 막는다. subcommand 자리에는 대시 없는 토큰이 와야 하므로
+# `git log | grep "git commit"` 같은 인용 안 문자열은 잡지 않는다.
+GIT='git([[:space:]]+(-C[[:space:]]+[^[:space:]]+|-c[[:space:]]+[^[:space:]]+|--(git-dir|work-tree|namespace|super-prefix|exec-path)[[:space:]]+[^[:space:]]+|-[^[:space:]]+))*[[:space:]]+'
+# 경계는 "단어 문자가 아니면 전부"다 — 공백·`"`·`;`·`&&`·`|`·`)`·`>`·`'` 등 어떤 구분자가 와도
+# 게이트가 돈다(열거하면 `git commit>/dev/null`처럼 빠진 글자마다 새는 회귀 — 2026-09-13 codex 리뷰 P2 ×2).
+# `-`는 단어 문자로 둔다: `git commit-tree`는 ref를 옮기지 않는 저수준 명령이라 commit이 아니다.
+END='([^[:alnum:]_-]|$)'
+if ! [[ "$COMMAND" =~ ${GIT}commit${END} ]]; then
+  exit 0
+fi
+
+# package.json이 없으면 JS 프로젝트가 아니다 — 검증할 게 없으니 통과.
+if [[ ! -f package.json ]]; then
+  exit 0
+fi
+
+# lockfile 기반 패키지 매니저 감지.
+detect_pm() {
+  if [[ -f pnpm-lock.yaml ]]; then echo pnpm
+  elif [[ -f yarn.lock ]]; then echo yarn
+  elif [[ -f bun.lockb ]]; then echo bun
+  else echo npm
+  fi
+}
+PM=$(detect_pm)
+
+# 로컬 바이너리 실행 형태 (tsc 등) — npm은 npx, bun은 bunx, 그 외는 매니저 직접.
+pm_exec() {
+  case "$PM" in
+    pnpm) pnpm exec "$@" ;;
+    yarn) yarn "$@" ;;
+    bun)  bunx "$@" ;;
+    *)    npx "$@" ;;
+  esac
+}
+
+# package.json test 스크립트 실행 — bun은 `bun run`이라야 스크립트를 탄다
+# (`bun test`는 스크립트를 무시하고 bun 자체 러너를 돌린다).
+pm_run_test() {
+  case "$PM" in
+    bun) bun run test ;;
+    *)   "$PM" test ;;
+  esac
+}
+
+# package.json에 test 스크립트가 있는지 — jq가 없으면 node로 판정한다.
+# node는 이 하네스의 기존 하드 의존(settings.json이 매 도구 호출마다 observe-tools.mjs를 돌린다)이라
+# jq보다 안전한 폴백이다. 둘 다 없으면 테스트를 실행할 수단 자체가 없으므로 판정 불가로 둔다.
+has_test_script() {
+  if [[ $jq_missing -eq 0 ]]; then
+    jq -e '.scripts.test // empty' package.json >/dev/null 2>&1
+  elif command -v node >/dev/null 2>&1; then
+    node -e 'const s=(require("./package.json").scripts||{}).test; process.exit(s?0:1)' >/dev/null 2>&1
+  else
+    return 1
+  fi
+}
+
+DEGRADED_NOTE=""
+[[ $jq_missing -eq 1 ]] && DEGRADED_NOTE=" — jq 없음(저정밀 모드)"
+echo "🔍 커밋 전 검증 실행 중... (패키지 매니저: $PM)$DEGRADED_NOTE" >&2
+
+# TypeScript 타입 체크 — tsconfig.json이 있을 때만.
+if [[ -f tsconfig.json ]]; then
+  if ! pm_exec tsc --noEmit 2>/dev/null; then
+    echo "❌ TypeScript 타입 에러가 있습니다. 커밋을 중단합니다." >&2
+    echo "   → $PM 로 tsc --noEmit 를 실행해 에러를 확인하세요." >&2
+    exit 2
+  fi
+fi
+
+# 테스트 — package.json에 test 스크립트가 있을 때만.
+if has_test_script; then
+  if ! pm_run_test 2>/dev/null; then
+    echo "❌ 테스트 실패. 커밋을 중단합니다." >&2
+    echo "   → $PM test 로 실패한 테스트를 확인하세요." >&2
+    exit 2
+  fi
+fi
+
+echo "✅ 검증 통과. 커밋을 진행합니다." >&2
+exit 0
diff --git a/tests/hooks-jq-fallback.test.mjs b/tests/hooks-jq-fallback.test.mjs
index 204f3aec..d16a6168 100644
--- a/tests/hooks-jq-fallback.test.mjs
+++ b/tests/hooks-jq-fallback.test.mjs
@@ -359,6 +359,62 @@ for (const mode of MODES) {
   });
 }
 
+// lint 단계는 종료 코드로 판정하므로 실제로 스크립트를 실행하는 npm 스텁이 필요하다.
+// 스텁은 받은 인자를 NPM_LOG에 남기고 package.json 스크립트를 sh로 실행해 종료 코드를 그대로 돌려준다 —
+// PATH에 없는 명령은 sh가 127을 낸다(실측: npm·pnpm·yarn·bun 모두 127을 그대로 전파).
+const NPM_LOG = 'npm-args.log';
+const NPM_STUB = join(BINS.dir, 'npm-stub');
+await mkdir(NPM_STUB);
+await writeFile(join(NPM_STUB, 'npm'), '#!/bin/sh\necho "$@" >> "$NPM_LOG"\n[ "$1" = run ] && shift\n'
+  + 'exec /bin/sh -c "$(node -e \'process.stdout.write((require("./package.json").scripts||{})[process.argv[1]]||"")\' "$1")"\n');
+await chmod(join(NPM_STUB, 'npm'), 0o755);
+
+async function runCommitWithNpm(mode, scripts) {
+  const dir = await jsProject({ name: 'x', scripts });
+  try {
+    const r = await runHook('pre-commit-check.sh', bash('git commit -m "wip"'),
+      { mode, cwd: dir, env: { PATH: `${NPM_STUB}:${BINS[mode]}`, NPM_LOG: join(dir, NPM_LOG) } });
+    const log = await readFile(join(dir, NPM_LOG), 'utf8').catch(() => '');
+    return { ...r, log };
+  } finally { await rm(dir, { recursive: true, force: true }); }
+}
+
+for (const mode of MODES) {
+  test(`pre-commit-check [${mode}]: lint 위반은 test 전에 커밋을 막는다`, async () => {
+    const r = await runCommitWithNpm(mode, { lint: 'exit 1', test: 'true' });
+    assert.equal(r.code, 2, `stderr: ${r.stderr}`);
+    assert.match(r.stderr, /❌ lint 실패/);
+    assert.match(r.stderr, /→ npm run lint/);
+    assert.equal(r.log, 'run lint\n', 'lint에서 막히면 test는 돌지 않는다');
+  });
+
+  test(`pre-commit-check [${mode}]: lint가 통과하면 test로 넘어가 커밋을 통과시킨다`, async () => {
+    const r = await runCommitWithNpm(mode, { lint: 'true', test: 'true' });
+    assert.equal(r.code, 0, `stderr: ${r.stderr}`);
+    assert.equal(r.log, 'run lint\ntest\n', '순서: lint → test');
+    assert.match(r.stderr, /검증 통과/);
+  });
+
+  test(`pre-commit-check [${mode}]: lint 스크립트가 없으면 lint를 건너뛴다`, async () => {
+    const r = await runCommitWithNpm(mode, { test: 'true' });
+    assert.equal(r.code, 0, `stderr: ${r.stderr}`);
+    assert.equal(r.log, 'test\n');
+    assert.doesNotMatch(r.stderr, /lint/);
+  });
+
+  test(`pre-commit-check [${mode}]: lint 실행 불가(127)는 경고 후 통과 — test 127은 여전히 차단`, async () => {
+    const lintOnly = await runCommitWithNpm(mode, { lint: 'eslint-not-installed .' });
+    assert.equal(lintOnly.code, 0, `stderr: ${lintOnly.stderr}`);
+    assert.match(lintOnly.stderr, /⚠ lint를 실행할 수 없습니다 \(exit 127/);
+    assert.match(lintOnly.stderr, /검증 통과/);
+
+    const both = await runCommitWithNpm(mode, { lint: 'eslint-not-installed .', test: 'jest-not-installed' });
+    assert.equal(both.code, 2, '의도된 비대칭: test 게이트는 127도 차단한다');
+    assert.match(both.stderr, /⚠ lint를 실행할 수 없습니다/);
+    assert.match(both.stderr, /테스트 실패/);
+  });
+}
+
 test('pre-commit-check: jq 없이도 게이트가 돌고 저정밀 모드를 알린다', async () => {
   const dir = await jsProject({ name: 'x', scripts: { test: 'node --test' } });
   try {
diff --git a/tests/migrate-hooks.test.mjs b/tests/migrate-hooks.test.mjs
index b377ec51..9be7175a 100644
--- a/tests/migrate-hooks.test.mjs
+++ b/tests/migrate-hooks.test.mjs
@@ -78,7 +78,7 @@ test('KNOWN_STOCK_HOOK_SHA256는 fixture의 실제 바이트와 일치한다 (
       checked++;
     }
   }
-  assert.equal(checked, 17, `알려진 stock 버전 17개를 기대 — 실제: ${checked}`);
+  assert.equal(checked, 18, `알려진 stock 버전 18개를 기대 — 실제: ${checked}`);
 });
 
 // audit-cleanup (2026-09-03) — observe-tools.mjs와 boundary-checkpoint.sh는 refresh 목록에 없어
@@ -171,6 +171,16 @@ test('PR #29 판(jq-fallback v1)도 stock이면 최신 템플릿으로 갱신된
   } finally { await rm(dir, { recursive: true, force: true }); }
 });
 
+test('lint 게이트 이전 판(pre-lint)도 stock이면 갱신된다 (lint 게이트 배달)', async () => {
+  const dir = await plantHooks(join(FIXTURES, 'pre-lint'), ['pre-commit-check.sh']);
+  try {
+    assert.equal(await refreshClaudeHooks(ctxFor(dir)), true);
+    const installed = await readFile(join(dir, '.claude/hooks/pre-commit-check.sh'), 'utf8');
+    assert.equal(installed, await readFile(join(TEMPLATES, 'pre-commit-check.sh'), 'utf8'));
+    assert.match(installed, /has_script lint/, 'pre-lint → 현재 템플릿 갱신이 lint 게이트를 배달한다');
+  } finally { await rm(dir, { recursive: true, force: true }); }
+});
+
 test('훅 미설치 프로젝트 → false (설치 없는 곳에 새로 깔지 않는다)', async () => {
   const dir = await mkdtemp(join(tmpdir(), 'harness-hookrefresh-'));
   try {

From 732beb4b2caee20938ce0cc9ed8519f1f162fabf Mon Sep 17 00:00:00 2001
From: hslee <fadeguy@gmail.com>
Date: Mon, 5 Oct 2026 11:57:56 +0900
Subject: [PATCH 2/4] =?UTF-8?q?chore(task):=20commit-gate-lint=20=EA=B2=80?=
 =?UTF-8?q?=EC=A6=9D=C2=B7Codex=20=EB=A6=AC=EB=B7=B0=20=EA=B8=B0=EB=A1=9D?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
---
 .../commit-gate-lint-artifact.md               |  8 ++++++++
 .../commit-gate-lint-context.md                |  2 +-
 .../commit-gate-lint-handoff.md                | 18 ++++++++++++++++++
 .../commit-gate-lint/commit-gate-lint-plan.md  |  4 ++--
 4 files changed, 29 insertions(+), 3 deletions(-)

diff --git a/docs/hslee/commit-gate-lint/commit-gate-lint-artifact.md b/docs/hslee/commit-gate-lint/commit-gate-lint-artifact.md
index 045426f9..a4aff565 100644
--- a/docs/hslee/commit-gate-lint/commit-gate-lint-artifact.md
+++ b/docs/hslee/commit-gate-lint/commit-gate-lint-artifact.md
@@ -31,6 +31,14 @@
 *Codex 등 리뷰 실행 시 결과(요약·발견·조치)를 날짜와 함께 남긴다. 남기지 않은 리뷰는 "안 한 것"으로 간주.*
 *기계 판독용 마커를 함께 남긴다: `<!-- harness:review kind=codex scope=worktree tip=<sha|none> at=<ISO8601> -->`*
 
+### 2026-10-05 — Codex read-only (`codex exec --sandbox read-only`, model gpt-6.1-sol)
+<!-- harness:review kind=codex scope=commit tip=1f38b9c at=2026-10-05T02:57:42Z -->
+- **요약**: P0–P3 결함 없음. 종료 코드 캡처, 유효한 scripts 값의 jq/node 판정, npm 테스트 스텁,
+  migrate sha·fixture provenance, macOS bash 3.2 구문을 확인. lint/test 127 비대칭은 요구대로 유지.
+- **한계**: read-only 샌드박스라 테스트 스위트는 돌리지 않았다(작성 세션이 `npm run test` 1087 pass로 대신 입증).
+- **조치**: 없음. 작성 세션의 추가 관찰(기존 동작, 무변경): `"lint": ""`(빈 문자열)은 jq(`"" // empty`는 참)와
+  node(`""`는 거짓)의 판정이 갈린다 — jq 쪽은 빈 스크립트를 실행해 exit 0이라 결과는 같다. test도 동일한 기존 동작.
+
 
 ## Learnings
 
diff --git a/docs/hslee/commit-gate-lint/commit-gate-lint-context.md b/docs/hslee/commit-gate-lint/commit-gate-lint-context.md
index b0a9bc31..572e39c7 100644
--- a/docs/hslee/commit-gate-lint/commit-gate-lint-context.md
+++ b/docs/hslee/commit-gate-lint/commit-gate-lint-context.md
@@ -3,7 +3,7 @@
 
 ## Now
 - Goal: 커밋 게이트에 package.json `lint` 단계 추가 — 위반 exit 2, 127 경고 후 통과
-- Current atomic step: 커밋 후 `npm run test` 전체 → Codex read-only 리뷰
+- Current atomic step: 구현·검증·리뷰 완료 — push·PR 지시 대기
 - Stop / human-decision condition: push·PR은 사용자 명시 지시 전 금지
 
 ## Constraints and settled decisions
diff --git a/docs/hslee/commit-gate-lint/commit-gate-lint-handoff.md b/docs/hslee/commit-gate-lint/commit-gate-lint-handoff.md
index 038d4477..1dfc62f9 100644
--- a/docs/hslee/commit-gate-lint/commit-gate-lint-handoff.md
+++ b/docs/hslee/commit-gate-lint/commit-gate-lint-handoff.md
@@ -1,3 +1,21 @@
 # commit-gate-lint — Handoff
 
 (세션 종료 시 post-commit hook이 자동 갱신합니다)
+
+## 2026-10-05T02:56:11.972Z — 1f38b9c feat(hooks): 커밋 게이트가 package.json lint 스크립트를 돌린다
+docs/diagrams/harness-overview/hooks.mmd           |   5 +-
+ docs/harness-overview.html                         |  13 +-
+ docs/harness-overview.template.html                |   3 +-
+ .../commit-gate-lint/commit-gate-lint-artifact.md  |  38 ++++++
+ .../commit-gate-lint/commit-gate-lint-context.md   |  22 ++++
+ .../commit-gate-lint/commit-gate-lint-handoff.md   |   3 +
+ .../commit-gate-lint/commit-gate-lint-meta.json    |  11 ++
+ .../commit-gate-lint/commit-gate-lint-plan.md      |  20 ++++
+ .../commit-gate-lint/commit-gate-lint-spec.md      |  84 +++++++++++++
+ src/commands/migrate.mjs                           |   1 +
+ templates/.claude/hooks/pre-commit-check.sh        |  30 +++--
+ tests/fixtures/stock-hooks/README.md               |   3 +
+ .../stock-hooks/pre-lint/pre-commit-check.sh       | 133 +++++++++++++++++++++
+ tests/hooks-jq-fallback.test.mjs                   |  56 +++++++++
+ tests/migrate-hooks.test.mjs                       |  12 +-
+ 15 files changed, 420 insertions(+), 14 deletions(-)
diff --git a/docs/hslee/commit-gate-lint/commit-gate-lint-plan.md b/docs/hslee/commit-gate-lint/commit-gate-lint-plan.md
index 6e1d0968..ceb1c1da 100644
--- a/docs/hslee/commit-gate-lint/commit-gate-lint-plan.md
+++ b/docs/hslee/commit-gate-lint/commit-gate-lint-plan.md
@@ -8,8 +8,8 @@
 - [x] 배달: 직전 판을 `KNOWN_STOCK_HOOK_SHA256`·`tests/fixtures/stock-hooks/pre-lint/`·fixture README에 추가
 - [x] 테스트: hooks-jq-fallback(위반·통과·없음·127, jq 매트릭스) + migrate-hooks(pre-lint 판 refresh)
 - [x] 문서: overview 카드·`hooks.mmd`(127 비대칭 명시), `npm run docs:check`
-- [ ] 검증: `npm run test` 전체 통과
-- [ ] Codex read-only 리뷰 → artifact `## Reviews`
+- [x] 검증: `npm run test` 전체 통과
+- [x] Codex read-only 리뷰 → artifact `## Reviews`
 
 ## Ontology 변경 로그
 *개념이 새로 정의되거나 의미가 바뀌면 한 줄로 기록. spec.md의 Ontology 섹션을 갱신할 트리거가 된다.*

From fe3e7fe300e9d84e4cd9d0ebcde1f0bdc8d70fa9 Mon Sep 17 00:00:00 2001
From: hslee <fadeguy@gmail.com>
Date: Mon, 5 Oct 2026 13:06:53 +0900
Subject: [PATCH 3/4] chore(task): commit-gate-lint ship

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
---
 .../commit-gate-lint-artifact.md              | 35 +++++++++++++++++++
 .../commit-gate-lint-context.md               |  2 +-
 .../commit-gate-lint-handoff.md               |  7 ++++
 .../commit-gate-lint-meta.json                | 12 ++++++-
 4 files changed, 54 insertions(+), 2 deletions(-)

diff --git a/docs/hslee/commit-gate-lint/commit-gate-lint-artifact.md b/docs/hslee/commit-gate-lint/commit-gate-lint-artifact.md
index a4aff565..f9676898 100644
--- a/docs/hslee/commit-gate-lint/commit-gate-lint-artifact.md
+++ b/docs/hslee/commit-gate-lint/commit-gate-lint-artifact.md
@@ -14,6 +14,16 @@
 - 문서: overview 카드(lint 단계·127 비대칭)와 `hooks.mmd`(낡은 `pnpm` 하드코딩 → `$PM`, lint 단계) 갱신.
   `/verify` 스킬·README는 훅 동작을 서술하지 않아 변경하지 않았다(`/verify` 수정은 stock-template 테이블 갱신만 늘린다).
 
+### 검증 증거 (ship, HEAD 732beb4, origin/main 5c12947 대비 rebase 불요)
+```
+$ npm run test      → exit 0
+ℹ tests 1088 · pass 1087 · fail 0 · skipped 1   (skip = CI 전용 jq 매트릭스 가드)
+ℹ tests 1 · pass 1 · fail 0                      (perf)
+$ npm run docs:check → harness overview 생성 상태가 최신입니다.
+```
+- 판별력: 구 훅(pre-lint fixture)으로 바꿔 `--test-name-pattern=lint` 실행 시 신규 6건 fail(pass 2 = "lint 없음" 2건).
+- 다이어그램: 옵트인하지 않은 task(plan에 단계 없음) — 미실행.
+
 ### 착수 전 실측 (2026-10-05)
 - deep-math `npm run lint` → exit 127 `sh: eslint: command not found` (eslint 의존성·설정 모두 없음 — 죽은 스크립트).
 - heliosent-profile `bun run lint` → exit 0.
@@ -39,6 +49,31 @@
 - **조치**: 없음. 작성 세션의 추가 관찰(기존 동작, 무변경): `"lint": ""`(빈 문자열)은 jq(`"" // empty`는 참)와
   node(`""`는 거짓)의 판정이 갈린다 — jq 쪽은 빈 스크립트를 실행해 exit 0이라 결과는 같다. test도 동일한 기존 동작.
 
+### 2026-10-05T04:06:41.520Z — codex-shipcheck (harness-team review)
+
+- engine: codex · scope: diff · tip: 732beb4b2caee20938ce0cc9ed8519f1f162fabf · exit 0 · 2658 B
+
+```text
+전하, `git status`와 `git diff origin/main`을 직접 확인했습니다. 아래 판정은 **현재 워킹트리 포함** 기준입니다. artifact와 handoff에 미커밋 변경이 있으며, 테스트는 재실행하지 않았습니다. 파일은 수정하지 않았습니다.
+
+| id | 항목 | 심각도 | 판정 | 근거 |
+|---|---|---|---|---|
+| S1 | 요구사항과 구현 대응 | BLOCKER | pass | spec의 “순서: typecheck → lint → test”와 “127 … 경고 두 줄 후 통과”에 대응하여 diff에 `if has_script lint`, `"$PM" run lint … \|\| lint_rc=$?`, `lint_rc -eq 127` 경고 및 그 외 실패의 `exit 2`가 추가됐습니다. jq/node 공용 판정, stock SHA·fixture·refresh 테스트도 추가됐으며, 공통 jq 블록과 기존 test 차단 동작은 유지됩니다. |
+| S2 | 완료 체크의 실재 근거 | MAJOR | pass | plan의 훅·배달·테스트·문서 항목은 해당 diff에 모두 존재합니다. handoff에 `1f38b9c feat(hooks)`와 `732beb4 chore(task)`가 기록되어 실제 git log와 일치합니다. 검증 항목은 artifact의 `$ npm run test → exit 0` 및 `$ npm run docs:check` 출력, 리뷰 항목은 `## Reviews` 기록에 대응합니다. |
+| S3 | 스코프 밖 변경 | MAJOR | pass | 제품 변경은 훅·migrate SHA·fixture·관련 테스트·overview에 한정됩니다. artifact는 “overview 카드…와 `hooks.mmd`…갱신”을 명시하고, 후속 범위는 “이번 task에서 고치지 않음”으로 기록합니다. 나머지는 해당 task의 관리 문서입니다. |
+| S4 | 실행 리뷰 기록과 마커 | MAJOR | pass | 확인된 기존 리뷰는 artifact `## Reviews`에 날짜·요약·한계·조치와 함께 `<!-- harness:review kind=codex scope=commit tip=1f38b9c at=2026-10-05T02:57:42Z -->`로 기록되어 있습니다. 제공된 문서·diff에서 추가 완료 리뷰의 누락 증거는 없습니다. |
+| S5 | 검증 결과의 명령·출력 인용 | BLOCKER | pass | artifact의 fenced block에 `$ npm run test → exit 0`, `ℹ tests 1088 · pass 1087 · fail 0 · skipped 1`, perf 결과 및 `$ npm run docs:check → harness overview 생성 상태가 최신입니다.`가 있습니다. 단순 “통과했다” 선언을 넘어 명령과 결과를 인용합니다. 다만 원본 실행 로그의 진위까지 독립 확인한 판정은 아닙니다. |
+
+검증 증거 블록은 **미커밋 artifact 변경**에 포함되어 있으므로, 현재 HEAD만으로는 동일한 증거 상태가 전달되지 않습니다. 이번 검증 결과도 작성 세션에서 `## Reviews`에 기록해야 합니다.
+
+**Verdict: PASS — fail 항목 없음.**
+```
+
+<!-- harness:review kind=codex-shipcheck scope=diff tip=732beb4b2caee20938ce0cc9ed8519f1f162fabf at=2026-10-05T04:06:41.520Z -->
+
+- **판별·조치**: S1–S5 전부 pass, 진짜 결함 없음. "증거 블록이 미커밋"이라는 지적은 사실이며, ship 커밋에 함께 담아 해소한다.
+  shipcheck는 scope CLI가 `worktree`(미커밋 handoff뿐)를 줬지만 코드 diff가 커밋에 있어 `--scope diff --base origin/main`으로 돌렸다 —
+  검증자는 `git status`로 미커밋 문서 변경까지 함께 읽었다.
 
 ## Learnings
 
diff --git a/docs/hslee/commit-gate-lint/commit-gate-lint-context.md b/docs/hslee/commit-gate-lint/commit-gate-lint-context.md
index 572e39c7..2b442992 100644
--- a/docs/hslee/commit-gate-lint/commit-gate-lint-context.md
+++ b/docs/hslee/commit-gate-lint/commit-gate-lint-context.md
@@ -3,7 +3,7 @@
 
 ## Now
 - Goal: 커밋 게이트에 package.json `lint` 단계 추가 — 위반 exit 2, 127 경고 후 통과
-- Current atomic step: 구현·검증·리뷰 완료 — push·PR 지시 대기
+- Current atomic step: ship 완료 — push·PR 생성, 머지 금지
 - Stop / human-decision condition: push·PR은 사용자 명시 지시 전 금지
 
 ## Constraints and settled decisions
diff --git a/docs/hslee/commit-gate-lint/commit-gate-lint-handoff.md b/docs/hslee/commit-gate-lint/commit-gate-lint-handoff.md
index 1dfc62f9..b625cbd7 100644
--- a/docs/hslee/commit-gate-lint/commit-gate-lint-handoff.md
+++ b/docs/hslee/commit-gate-lint/commit-gate-lint-handoff.md
@@ -19,3 +19,10 @@ docs/diagrams/harness-overview/hooks.mmd           |   5 +-
  tests/hooks-jq-fallback.test.mjs                   |  56 +++++++++
  tests/migrate-hooks.test.mjs                       |  12 +-
  15 files changed, 420 insertions(+), 14 deletions(-)
+
+## 2026-10-05T02:57:56.841Z — 732beb4 chore(task): commit-gate-lint 검증·Codex 리뷰 기록
+.../commit-gate-lint/commit-gate-lint-artifact.md      |  8 ++++++++
+ .../hslee/commit-gate-lint/commit-gate-lint-context.md |  2 +-
+ .../hslee/commit-gate-lint/commit-gate-lint-handoff.md | 18 ++++++++++++++++++
+ docs/hslee/commit-gate-lint/commit-gate-lint-plan.md   |  4 ++--
+ 4 files changed, 29 insertions(+), 3 deletions(-)
diff --git a/docs/hslee/commit-gate-lint/commit-gate-lint-meta.json b/docs/hslee/commit-gate-lint/commit-gate-lint-meta.json
index a8e94f52..d3b27b9a 100644
--- a/docs/hslee/commit-gate-lint/commit-gate-lint-meta.json
+++ b/docs/hslee/commit-gate-lint/commit-gate-lint-meta.json
@@ -7,5 +7,15 @@
   "closedAt": null,
   "forcedAt": null,
   "forcedIssues": null,
-  "reviews": []
+  "reviews": [
+    {
+      "kind": "codex-shipcheck",
+      "engine": "codex",
+      "scope": "diff",
+      "tip": "732beb4b2caee20938ce0cc9ed8519f1f162fabf",
+      "at": "2026-10-05T04:06:41.520Z",
+      "exitCode": 0,
+      "outputBytes": 2658
+    }
+  ]
 }

From 6771b5392a5e3214e626c1373ce615fc173bf2b2 Mon Sep 17 00:00:00 2001
From: hslee <fadeguy@gmail.com>
Date: Mon, 5 Oct 2026 13:06:59 +0900
Subject: [PATCH 4/4] chore(handoff): commit-gate-lint handoff sweep

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
---
 docs/hslee/commit-gate-lint/commit-gate-lint-handoff.md | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/docs/hslee/commit-gate-lint/commit-gate-lint-handoff.md b/docs/hslee/commit-gate-lint/commit-gate-lint-handoff.md
index b625cbd7..d602728a 100644
--- a/docs/hslee/commit-gate-lint/commit-gate-lint-handoff.md
+++ b/docs/hslee/commit-gate-lint/commit-gate-lint-handoff.md
@@ -26,3 +26,10 @@ docs/diagrams/harness-overview/hooks.mmd           |   5 +-
  .../hslee/commit-gate-lint/commit-gate-lint-handoff.md | 18 ++++++++++++++++++
  docs/hslee/commit-gate-lint/commit-gate-lint-plan.md   |  4 ++--
  4 files changed, 29 insertions(+), 3 deletions(-)
+
+## 2026-10-05T04:06:53.880Z — fe3e7fe chore(task): commit-gate-lint ship
+.../commit-gate-lint/commit-gate-lint-artifact.md  | 35 ++++++++++++++++++++++
+ .../commit-gate-lint/commit-gate-lint-context.md   |  2 +-
+ .../commit-gate-lint/commit-gate-lint-handoff.md   |  7 +++++
+ .../commit-gate-lint/commit-gate-lint-meta.json    | 12 +++++++-
+ 4 files changed, 54 insertions(+), 2 deletions(-)