@angar2/taskery 0.1.1 → 0.1.3

package/bin/prune.js

@@ -0,0 +1,189 @@
+#!/usr/bin/env node
+/**
+ * bin/prune.js
+ * `npx @angar2/taskery prune` — stale 워크트리 / 브랜치 대화형 정리.
+ *
+ * 흐름:
+ *   1. git worktree prune (자동, 케이스 A 폴더 없는 등록 정리)
+ *   2. 의심 항목 목록 표시 (케이스 B/C/D + orphan)
+ *   3. 사용자 항목별 보존 / 삭제 선택
+ *   4. 선택된 항목 삭제:
+ *      - 브랜치: git branch -D <name>  ← 사용자 명시 선택이므로 -D 허용 (rebase 잔여 등 -d 거부 가능)
+ *      - 워크트리: git worktree remove --force <path>
+ *   5. 결과 보고
+ *
+ * 본 명령은 *변경 발생 가능* — 사용자 confirm 항목별로 받음.
+ */
+
+const fs = require('fs');
+const path = require('path');
+const readline = require('readline');
+
+const {
+  MANIFEST_NAME,
+  readManifest,
+  gitCapture,
+  getMainWorktreePath,
+  getActiveTasks,
+  getWorktreesRoot,
+  DEFAULT_STALE_DAYS,
+} = require('./lib');
+const { execFileSync } = require('child_process');
+
+function ask(rl, q) {
+  return new Promise((resolve) => rl.question(q, (a) => resolve(a.trim().toLowerCase())));
+}
+
+function daysAgo(date) {
+  return Math.floor((Date.now() - date.getTime()) / (1000 * 60 * 60 * 24));
+}
+
+async function main() {
+  const mainWt = getMainWorktreePath();
+  const manifest = readManifest(path.join(mainWt, MANIFEST_NAME));
+  if (!manifest) {
+    console.error(`${MANIFEST_NAME} 없음 — 'init' 먼저.`);
+    process.exit(1);
+  }
+  const projectId = manifest.projectId;
+  const staleDays = manifest.stale_days ?? DEFAULT_STALE_DAYS;
+
+  console.log(`\ntaskery prune\n`);
+  console.log(`메인 워크트리: ${mainWt}`);
+  console.log(`stale_days: ${staleDays}\n`);
+
+  // 1. git worktree prune (자동 — 케이스 A)
+  console.log(`Step 1 — git worktree prune (폴더 없는 워크트리 등록 정리)`);
+  try {
+    execFileSync('git', ['-C', mainWt, 'worktree', 'prune', '-v'], { stdio: 'inherit' });
+  } catch (e) {
+    console.error(`  git worktree prune 실패: ${e.message}`);
+  }
+  console.log();
+
+  // 2. 의심 항목 수집
+  const active = getActiveTasks(mainWt);
+  const worktreesRoot = getWorktreesRoot(projectId);
+
+  // 케이스 B/C/D
+  const suspects = [];
+  for (const t of active) {
+    const wtPath = path.join(
+      worktreesRoot,
+      `TASK-${String(t.taskNum).padStart(3, '0')}_${t.src}_${t.slug}`,
+    );
+    const wtExists = fs.existsSync(wtPath);
+    const lastCommit = gitCapture(mainWt, ['log', '-1', '--format=%ci', t.branch], {
+      allowFail: true,
+    });
+    const lastDate = lastCommit ? new Date(lastCommit) : null;
+    const days = lastDate ? daysAgo(lastDate) : null;
+
+    let kase = null;
+    if (!wtExists) kase = 'A (폴더 없음 — git worktree prune 처리됐을 가능성)';
+    else if (days !== null && days >= staleDays) kase = `C (워크트리 폴더 존재 + ${days}일 비활성)`;
+
+    if (wtExists) {
+      const rebaseApply = path.join(wtPath, '.git', 'rebase-apply');
+      const rebaseMerge = path.join(wtPath, '.git', 'rebase-merge');
+      if (fs.existsSync(rebaseApply) || fs.existsSync(rebaseMerge)) {
+        kase = `D (rebase 잔여 상태)`;
+      }
+    }
+
+    if (kase) {
+      suspects.push({ branch: t.branch, wtPath, wtExists, days, kase });
+    }
+  }
+
+  // orphan 워크트리 (SSoT에 없는 폴더)
+  const orphans = [];
+  if (fs.existsSync(worktreesRoot)) {
+    const folders = fs.readdirSync(worktreesRoot).filter((n) => n.startsWith('TASK-'));
+    const activeFolders = new Set(
+      active.map(
+        (t) => `TASK-${String(t.taskNum).padStart(3, '0')}_${t.src}_${t.slug}`,
+      ),
+    );
+    for (const f of folders) {
+      if (!activeFolders.has(f)) {
+        orphans.push(path.join(worktreesRoot, f));
+      }
+    }
+  }
+
+  if (suspects.length === 0 && orphans.length === 0) {
+    console.log(`✅ 정리할 의심 항목 없음.`);
+    return;
+  }
+
+  console.log(`Step 2 — 의심 항목 (${suspects.length + orphans.length}건)\n`);
+
+  const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+  const toDelete = { branches: [], worktrees: [] };
+
+  // suspects 처리
+  for (const s of suspects) {
+    console.log(`[${s.kase}] ${s.branch}`);
+    console.log(`  워크트리: ${s.wtPath}${s.wtExists ? '' : ' (폴더 X)'}`);
+    if (s.days !== null) console.log(`  마지막 커밋: ${s.days}일 전`);
+    const ans = await ask(rl, `  삭제? (y=브랜치+워크트리 / w=워크트리만 / k=보존, 기본 k) `);
+    if (ans === 'y') {
+      toDelete.branches.push(s.branch);
+      if (s.wtExists) toDelete.worktrees.push(s.wtPath);
+    } else if (ans === 'w' && s.wtExists) {
+      toDelete.worktrees.push(s.wtPath);
+    } else {
+      console.log(`  보존`);
+    }
+    console.log();
+  }
+
+  // orphan 처리
+  for (const o of orphans) {
+    console.log(`[orphan] 워크트리 폴더 (SSoT에 없는 브랜치)`);
+    console.log(`  ${o}`);
+    const ans = await ask(rl, `  워크트리 폴더 삭제? (y/N) `);
+    if (ans === 'y') toDelete.worktrees.push(o);
+    else console.log(`  보존`);
+    console.log();
+  }
+
+  rl.close();
+
+  // 3. 실제 삭제
+  if (toDelete.branches.length === 0 && toDelete.worktrees.length === 0) {
+    console.log(`삭제 대상 없음.`);
+    return;
+  }
+
+  console.log(`\nStep 3 — 삭제 실행\n`);
+
+  for (const wt of toDelete.worktrees) {
+    try {
+      execFileSync('git', ['-C', mainWt, 'worktree', 'remove', '--force', wt], {
+        stdio: 'inherit',
+      });
+      console.log(`  worktree removed: ${wt}`);
+    } catch (e) {
+      console.error(`  worktree remove 실패 (${wt}): ${e.message}`);
+    }
+  }
+
+  for (const b of toDelete.branches) {
+    try {
+      // -D 강제 삭제 — 사용자 명시 선택 (prune 대화형) 이므로 허용
+      execFileSync('git', ['-C', mainWt, 'branch', '-D', b], { stdio: 'inherit' });
+      console.log(`  branch deleted: ${b}`);
+    } catch (e) {
+      console.error(`  branch -D 실패 (${b}): ${e.message}`);
+    }
+  }
+
+  console.log(`\n✅ taskery prune 완료 — 워크트리 ${toDelete.worktrees.length}건 / 브랜치 ${toDelete.branches.length}건 삭제.`);
+}
+
+main().catch((e) => {
+  console.error(`taskery prune 실패: ${e.message}`);
+  process.exit(1);
+});

package/bin/status.js

@@ -0,0 +1,148 @@
+#!/usr/bin/env node
+/**
+ * bin/status.js
+ * `npx @angar2/taskery status` — 멀티세션 현황 요약.
+ *
+ * 출력:
+ *   - 메인 워크트리 + 현재 브랜치
+ *   - projectId / stale_days / lock_timeout_ms
+ *   - 진행중 태스크 (SSoT) + 각 워크트리 폴더 존재 여부 + 마지막 커밋 시각
+ *   - stale 의심 항목 (케이스 A/B/C/D)
+ *   - 머지 락 상태 (잡혀 있으면 누가 잡고 있는지)
+ *
+ * 본 명령은 *변경 X — 읽기 전용*. 정리는 `taskery prune`.
+ */
+
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+const {
+  MANIFEST_NAME,
+  readManifest,
+  gitCapture,
+  getMainWorktreePath,
+  getActiveTasks,
+  getWorktreesRoot,
+  getMergeLockPath,
+  DEFAULT_STALE_DAYS,
+  DEFAULT_LOCK_TIMEOUT_MS,
+} = require('./lib');
+
+function daysAgo(date) {
+  const now = Date.now();
+  const ms = now - date.getTime();
+  return Math.floor(ms / (1000 * 60 * 60 * 24));
+}
+
+function main() {
+  // 1. 메인 워크트리 + manifest
+  let mainWt;
+  try {
+    mainWt = getMainWorktreePath();
+  } catch (e) {
+    console.error(`taskery status 실패: ${e.message}`);
+    process.exit(1);
+  }
+
+  const manifest = readManifest(path.join(mainWt, MANIFEST_NAME));
+  if (!manifest) {
+    console.error(`${MANIFEST_NAME} 없음 — 'npx @angar2/taskery init' 먼저 실행 필요.`);
+    process.exit(1);
+  }
+
+  const projectId = manifest.projectId;
+  const staleDays = manifest.stale_days ?? DEFAULT_STALE_DAYS;
+  const lockTimeoutMs = manifest.lock_timeout_ms ?? DEFAULT_LOCK_TIMEOUT_MS;
+
+  const currentBranch = gitCapture(mainWt, ['rev-parse', '--abbrev-ref', 'HEAD']);
+  const isOnDev = currentBranch === 'dev';
+
+  console.log(`\ntaskery status\n`);
+  console.log(`메인 워크트리: ${mainWt}`);
+  console.log(`현재 브랜치: ${currentBranch}${isOnDev ? '' : ' ⚠ (메인 워크트리 = dev 정책 위배)'}`);
+  console.log(`projectId: ${projectId}`);
+  console.log(`stale_days: ${staleDays} / lock_timeout_ms: ${lockTimeoutMs}\n`);
+
+  // 2. 머지 락 상태
+  const lockPath = getMergeLockPath(projectId);
+  const lockDir = lockPath + '.lock'; // proper-lockfile은 <file>.lock 디렉토리 생성
+  if (fs.existsSync(lockDir)) {
+    let lockInfo = '';
+    try {
+      const stat = fs.statSync(lockDir);
+      const ageMs = Date.now() - stat.mtimeMs;
+      lockInfo = ` (잡힘 ${Math.round(ageMs / 1000)}초 전)`;
+    } catch (_) {}
+    console.log(`머지 락: 활성${lockInfo}`);
+  } else {
+    console.log(`머지 락: 비활성`);
+  }
+  console.log();
+
+  // 3. 진행중 태스크 (SSoT)
+  const active = getActiveTasks(mainWt);
+  console.log(`진행중 태스크 (SSoT, ${active.length}건):`);
+
+  if (active.length === 0) {
+    console.log(`  (없음)`);
+  } else {
+    const worktreesRoot = getWorktreesRoot(projectId);
+    for (const t of active) {
+      const wtPath = path.join(worktreesRoot, `TASK-${String(t.taskNum).padStart(3, '0')}_${t.src}_${t.slug}`);
+      const wtExists = fs.existsSync(wtPath);
+      const lastCommit = gitCapture(mainWt, [
+        'log', '-1', '--format=%ci', t.branch,
+      ], { allowFail: true });
+      const lastDate = lastCommit ? new Date(lastCommit) : null;
+      const daysOld = lastDate ? daysAgo(lastDate) : null;
+
+      console.log(`  ${t.branch}`);
+      console.log(`    워크트리: ${wtPath}${wtExists ? '' : ' ⚠ 폴더 없음 (케이스 A — prune 필요)'}`);
+      if (lastDate) {
+        console.log(`    마지막 커밋: ${lastCommit} (${daysOld}일 전)${daysOld >= staleDays ? ' ⚠ stale 의심 (케이스 B/C)' : ''}`);
+      } else {
+        console.log(`    마지막 커밋: (조회 실패)`);
+      }
+      if (wtExists) {
+        const rebaseApply = path.join(wtPath, '.git', 'rebase-apply');
+        const rebaseMerge = path.join(wtPath, '.git', 'rebase-merge');
+        if (fs.existsSync(rebaseApply) || fs.existsSync(rebaseMerge)) {
+          console.log(`    ⚠ rebase 잔여 상태 (케이스 D) — taskery prune 또는 워크트리에서 git rebase --abort`);
+        }
+      }
+    }
+  }
+  console.log();
+
+  // 4. 워크트리 폴더 vs SSoT mismatch (orphan)
+  const worktreesRoot = getWorktreesRoot(projectId);
+  if (fs.existsSync(worktreesRoot)) {
+    const folders = fs.readdirSync(worktreesRoot).filter((n) => n.startsWith('TASK-'));
+    const activeFolders = new Set(
+      active.map(
+        (t) => `TASK-${String(t.taskNum).padStart(3, '0')}_${t.src}_${t.slug}`,
+      ),
+    );
+    const orphans = folders.filter((f) => !activeFolders.has(f));
+    if (orphans.length > 0) {
+      console.log(`⚠ SSoT에 없는 워크트리 폴더 ${orphans.length}건 (이미 dev 머지된 잔존?):`);
+      for (const o of orphans) {
+        console.log(`  ${path.join(worktreesRoot, o)}`);
+      }
+      console.log(`  → 'taskery prune' 으로 정리`);
+      console.log();
+    }
+  }
+
+  console.log(`기타 명령:`);
+  console.log(`  npx @angar2/taskery prune   stale 워크트리 / 브랜치 대화형 정리`);
+  console.log();
+}
+
+try {
+  main();
+} catch (e) {
+  console.error(`taskery status 실패: ${e.message}`);
+  process.exit(1);
+}

package/bin/taskery.js

@@ -6,6 +6,8 @@
  * 서브커맨드:
  *   init    — 현재 디렉토리에 taskery 자산 카피 + manifest 생성
  *   update  — 최신 버전 fetch + manifest 비교 + 머지 갱신
+ *   status  — 멀티세션 현황 요약 (진행중 태스크 / 워크트리 / 머지 락, 0.1.2+)
+ *   prune   — stale 워크트리 / 브랜치 대화형 정리 (0.1.2+)
  *   help    — 사용법 출력
  */
 
@@ -28,6 +30,8 @@ function help() {
 사용법:
   npx @angar2/taskery init      현재 디렉토리에 taskery 자산 설치
   npx @angar2/taskery update    최신 버전 fetch + 머지 갱신
+  npx @angar2/taskery status    멀티세션 현황 (진행중 태스크 / 워크트리 / 머지 락)
+  npx @angar2/taskery prune     stale 워크트리 / 브랜치 대화형 정리
   npx @angar2/taskery help      도움말
 
 새 프로젝트 시작:
@@ -44,6 +48,27 @@ switch (sub) {
   case 'update':
     runScript('update.js');
     break;
+  case 'status':
+    runScript('status.js');
+    break;
+  case 'prune':
+    if (process.argv[3] === '--help' || process.argv[3] === '-h') {
+      console.log(`taskery prune — stale 워크트리 / 브랜치 대화형 정리
+
+사용법:
+  npx @angar2/taskery prune
+
+설명:
+  .taskery-manifest.json의 stale_days (기본 30일) 기준으로 비활성 워크트리 + 브랜치를 대화형 정리합니다.
+  케이스 분기: A (워크트리 + 브랜치 모두 stale) / B (브랜치만 stale) / C (워크트리 폴더 잔존) / D (정합 영역).
+  각 케이스마다 y/n/k 선택 가능 (y = 삭제 / n = 건너뜀 / k = 보존 명시).
+
+상세: https://github.com/angar2/taskery
+`);
+      break;
+    }
+    runScript('prune.js');
+    break;
   case 'help':
   case '--help':
   case '-h':

package/bin/update.js

@@ -3,7 +3,7 @@
  * bin/update.js
  * `npx @angar2/taskery update` — template/ 최신 자산과 사용자 측 비교 + 머지 갱신.
  *
- * 머지 로직 (§9-1):
+ * 머지 로직 (DISTRIBUTION.md §6):
  *   1. .taskery-manifest.json (cwd) 읽기 — 없으면 에러 ('init' 먼저)
  *   2. template/ 정독 → 새 해시 맵
  *   3. 각 파일 분기:
@@ -31,6 +31,9 @@ const {
   readManifest,
   getPackageVersion,
   isLocalOverride,
+  generateProjectId,
+  DEFAULT_STALE_DAYS,
+  DEFAULT_LOCK_TIMEOUT_MS,
 } = require('./lib');
 
 async function confirm(msg) {
@@ -146,15 +149,36 @@ async function main() {
     }
   }
 
-  // 5. manifest 갱신
+  // 5. manifest 갱신 — 멀티세션(0.1.2+) 필드 누락 시 자동 마이그레이션
+  const migration = { projectId: false, stale_days: false, lock_timeout_ms: false };
+  const projectId = oldManifest.projectId || (migration.projectId = true, generateProjectId());
+  const stale_days =
+    typeof oldManifest.stale_days === 'number'
+      ? oldManifest.stale_days
+      : (migration.stale_days = true, DEFAULT_STALE_DAYS);
+  const lock_timeout_ms =
+    typeof oldManifest.lock_timeout_ms === 'number'
+      ? oldManifest.lock_timeout_ms
+      : (migration.lock_timeout_ms = true, DEFAULT_LOCK_TIMEOUT_MS);
+
   const newManifest = {
     version: getPackageVersion(),
     installed_at: oldManifest.installed_at,
     updated_at: new Date().toISOString(),
+    projectId,
+    stale_days,
+    lock_timeout_ms,
     files: newFiles,
   };
   writeManifest(newManifest, manifestPath);
 
+  const migratedFields = Object.entries(migration)
+    .filter(([, added]) => added)
+    .map(([k]) => k);
+  if (migratedFields.length > 0) {
+    console.log(`  manifest 마이그레이션: ${migratedFields.join(', ')} 필드 추가`);
+  }
+
   // 결과 보고
   console.log(`\n✅ taskery update 완료`);
   console.log(`   동일: ${summary.unchanged}, 신규: ${summary.new}, 자동 갱신: ${summary.autoUpdated}`);

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@angar2/taskery",
-  "version": "0.1.1",
-  "description": "Lightweight task system for Claude Code — 1 메인 세션 + 스킬 8종 + catastrophic hook 안전망 3종",
+  "version": "0.1.3",
+  "description": "Lightweight task system for Claude Code — 1 메인 세션(또는 멀티세션) + 스킬 9종 + catastrophic hook 안전망 2종",
   "bin": {
     "taskery": "bin/taskery.js",
     "create-taskery": "bin/create.js"
@@ -38,6 +38,10 @@
     "access": "public"
   },
   "engines": {
-    "node": ">=18.0.0"
+    "node": ">=18.0.0",
+    "git": ">=2.31.0"
+  },
+  "dependencies": {
+    "proper-lockfile": "^4.1.2"
   }
 }

package/template/.claude/hooks/closed-immutable.sh

@@ -10,7 +10,8 @@
 # 차단 안 함 (의도적):
 #   - .project/tasks/<vX.X>/spec-diffs/*.md — 역사적 자료, 자유 수정
 #   - .project/tasks/<vX.X>/screenshots/* — 자유
-#   - 폴더 승격 task 폴더 안 추가 자료 — 자유
+#   - .project/tasks/<vX.X>/mockup/*.html — UX/UI 목업, 자유 수정 (vX.X 공통)
+#   - 폴더 승격 task 폴더 안 추가 자료 (서브 문서 등) — 자유
 #   - 코드 영역 — closed task 코드 재수정은 *새 task로 처리*가 정상 흐름
 #
 # 우회 (의도적으로 closed task를 풀어 다시 진행해야 하는 경우):
@@ -32,9 +33,9 @@ except Exception:
 " 2>/dev/null)
 
 # task.md 본 파일 매칭 (단일 + 폴더 승격)
-# - 단일: .project/tasks/v*/<NNN>_<slug>.md (NNN_<slug> 패턴 — vX.X 직속, spec-diffs/screenshots 하위 X)
+# - 단일: .project/tasks/v*/<NNN>_<slug>.md (NNN_<slug> 패턴 — vX.X 직속, spec-diffs/screenshots/mockup 하위 X)
 # - 폴더: .project/tasks/v*/TASK-<NNN>_<slug>/task.md
-# spec-diffs/ + screenshots/ 직속 파일은 매칭 안 됨 (보호 대상 X)
+# spec-diffs/ + screenshots/ + mockup/ 직속 파일은 매칭 안 됨 (보호 대상 X)
 if ! echo "$FILE_PATH" | grep -qE '\.project/tasks/v[^/]+/([0-9]+_[^/]+\.md|TASK-[^/]+/task\.md)$'; then
   exit 0
 fi
@@ -67,7 +68,7 @@ print(m.group(1) if m else '')
 if [ "$STATUS" = "closed" ]; then
   echo "closed-immutable: '$FILE_PATH' 차단. task '$TASK_MD' 상태가 'closed' — 재수정 금지." >&2
   echo "  의도적 재진입 필요 시: sed로 헤더 status를 'developing' 또는 다른 상태로 직접 변경 후 Edit 가능." >&2
-  echo "  *closed task 코드 / spec-diffs / screenshots*는 보호 영역 외 — 자유 수정. 단 코드 변경은 *새 task로 처리*가 정상 흐름." >&2
+  echo "  *closed task 코드 / spec-diffs / screenshots / mockup*은 보호 영역 외 — 자유 수정. 단 코드 변경은 *새 task로 처리*가 정상 흐름." >&2
   exit 2
 fi
 

package/template/.claude/hooks/git-guard.sh

@@ -3,7 +3,7 @@
 # PreToolUse(Bash) 훅 — catastrophic git 명령 차단
 #
 # 잡는 것:
-#   1. main / dev 브랜치 직접 커밋
+#   1. main / dev 브랜치 직접 커밋 (5종 변형 인식: -C / --git-dir / --work-tree)
 #   2. git push --force / -f
 #   3. git commit --no-verify
 #   4. git branch -D (강제 삭제)
@@ -31,19 +31,53 @@ if ! echo "$CMD" | grep -qE '(^|;|&&|\|\|)\s*git\s'; then
   exit 0
 fi
 
-# 1. main / dev 직접 커밋 차단
+# 헬퍼: git 명령에서 대상 워크트리 경로 추출 (5종 변형)
+#   1. git -C <경로>
+#   2. git --git-dir=<경로>  (= 형태)
+#   3. git --git-dir <경로>  (공백 분리)
+#   4. git --work-tree=<경로>  (= 형태)
+#   5. git --work-tree <경로>  (공백 분리)
+# 추출 실패 시 빈 문자열 (cwd 사용).
+# --git-dir 변형은 `.git` 디렉토리를 가리키므로 dirname 처리해 워크트리 경로로 변환.
+extract_target_path() {
+  local cmd="$1"
+  local path=""
+
+  if [[ "$cmd" =~ git[[:space:]]+-C[[:space:]]+([^[:space:]]+) ]]; then
+    path="${BASH_REMATCH[1]}"
+  elif [[ "$cmd" =~ --git-dir=([^[:space:]]+) ]]; then
+    path=$(dirname "${BASH_REMATCH[1]}")
+  elif [[ "$cmd" =~ --git-dir[[:space:]]+([^[:space:]]+) ]]; then
+    path=$(dirname "${BASH_REMATCH[1]}")
+  elif [[ "$cmd" =~ --work-tree=([^[:space:]]+) ]]; then
+    path="${BASH_REMATCH[1]}"
+  elif [[ "$cmd" =~ --work-tree[[:space:]]+([^[:space:]]+) ]]; then
+    path="${BASH_REMATCH[1]}"
+  fi
+
+  echo "$path"
+}
+
+# 1. main / dev 직접 커밋 차단 (5종 변형 인식)
 # 현재 브랜치 확인 + git commit 명령 감지 시 차단
-if echo "$CMD" | grep -qE '(^|;|&&|\|\|)\s*git\s+commit\b'; then
-  CURRENT_BRANCH=$(git branch --show-current 2>/dev/null)
+if echo "$CMD" | grep -qE '(^|;|&&|\|\|)\s*git(\s+(-C\s+\S+|--git-dir[= ]\S+|--work-tree[= ]\S+))*\s+commit\b'; then
+  TARGET_PATH=$(extract_target_path "$CMD")
+  if [ -n "$TARGET_PATH" ]; then
+    CURRENT_BRANCH=$(git -C "$TARGET_PATH" branch --show-current 2>/dev/null)
+  else
+    CURRENT_BRANCH=$(git branch --show-current 2>/dev/null)
+  fi
   if [ "$CURRENT_BRANCH" = "main" ] || [ "$CURRENT_BRANCH" = "dev" ]; then
     echo "git-guard: '$CURRENT_BRANCH' 브랜치 직접 커밋 차단. 작업 브랜치({타입}/{개발자}_TASK-NNN_slug)에서 커밋. (.project/rules/GIT_RULE.md §기본 원칙)" >&2
+    echo "  변형 인식: 'git -C <경로> ...' / 'git --git-dir=<경로> ...' / 'git --work-tree=<경로> ...' — 메인 cwd에서 워크트리 대상 커밋 가능." >&2
+    echo "  셸 prefix('cd <경로> && git ...' / '(cd ... && git ...)')는 hook이 정확히 인식 X — 'git -C <경로> ...' 형태로만 발행." >&2
     exit 2
   fi
 fi
 
 # 2. git commit --no-verify 차단
 if echo "$CMD" | grep -qE 'git\s+commit\b.*--no-verify'; then
-  echo "git-guard: 'git commit --no-verify' 차단. pre-commit-verify hook 우회 금지. (.project/rules/GIT_RULE.md §금지 사항)" >&2
+  echo "git-guard: 'git commit --no-verify' 차단. commit hook 우회 금지. (.project/rules/GIT_RULE.md §금지 사항)" >&2
   exit 2
 fi
 

package/template/.claude/settings.json

@@ -4,8 +4,7 @@
       {
         "matcher": "Bash",
         "hooks": [
-          { "type": "command", "command": ".claude/hooks/git-guard.sh" },
-          { "type": "command", "command": ".claude/hooks/pre-commit-verify.sh" }
+          { "type": "command", "command": ".claude/hooks/git-guard.sh" }
         ]
       },
       {