oh-my-customcode 1.1.91 → 1.1.92

package/README.md

@@ -249,7 +249,7 @@ oh-my-customcode ships 42 lifecycle hook scripts covering security, drift detect
 
 Most hooks are advisory (exit 0) — they warn but never block. A small number of hard-block hooks (e.g. `stage-blocker`, `rule-deletion-guard`) reject the tool call outright (exit 2). oh-my-customcode's own governance rules (`.claude/rules/`) follow an **advisory-first enforcement model**: prompt-based guidance is the default, and a rule is only promoted to a blocking hook after repeated, observed violations. Rules also retire — clauses tied to since-fixed platform bugs or that go unused for two minor releases are wrapped in HTML comments (still readable via the source file, invisible to the agent's context) rather than left to accumulate indefinitely.
 
-The hook source of truth is `.claude/hooks/hooks.json`; `omcustom init` compiles it into the `hooks` block of `.claude/settings.json` (via `src/core/hooks-settings.ts`), which is the file Claude Code actually loads.
+The hook source of truth is `.claude/hooks/hooks.json`; `omcustom init` compiles it into the `hooks` block of `.claude/settings.json` (via `src/core/hooks-settings.ts`), which is the file Claude Code actually loads. Hook commands are anchored as `bash "${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/<path>"`, so hooks keep working when the session's working directory moves to a subdirectory. Contributors: do not hand-edit the `hooks` blocks in settings; edit `hooks.json` and run `bun run sync:hooks` (also run at the end of `bun run build`) to regenerate them. Existing installs need no manual step: `omcustom update` (full or hooks component) and `omcustom init --backup` automatically migrate old relative hook commands in `.claude/settings.local.json`, and custom hooks are left untouched.
 
 ---
 

package/dist/cli/index.js

@@ -217,7 +217,7 @@ var init_package = __esm(() => {
     workspaces: [
       "packages/*"
     ],
-    version: "1.1.91",
+    version: "1.1.92",
     description: "Batteries-included agent harness for Claude Code",
     type: "module",
     bin: {
@@ -241,7 +241,8 @@ var init_package = __esm(() => {
     },
     scripts: {
       dev: "bun run src/cli/index.ts",
-      build: "bun build src/cli/index.ts --outdir dist/cli --target node && bun build src/index.ts --outdir dist --target node && bun run scripts/sync-source-lockfile.ts",
+      build: "bun build src/cli/index.ts --outdir dist/cli --target node && bun build src/index.ts --outdir dist --target node && bun run scripts/sync-source-lockfile.ts && bun run scripts/sync-hooks-settings.ts",
+      "sync:hooks": "bun run scripts/sync-hooks-settings.ts",
       test: "bun test tests/ packages/eval-core/",
       "test:unit": "bun test tests/unit",
       "test:integration": "bun test tests/integration",
@@ -15615,6 +15616,8 @@ var MESSAGES = {
     "install.entry_md_skipped": "{{entry}} skipped ({{reason}})",
     "install.lockfile_generated": "Lockfile generated ({{files}} files tracked)",
     "install.lockfile_failed": "Failed to generate lockfile: {{error}}",
+    "install.hook_commands_migrated": "Migrated {{rewritten}} hook command(s) in settings.local.json",
+    "install.hook_commands_migration_failed": "Failed to migrate hook commands in settings.local.json: {{error}}",
     "lockfile.not_found": "Lockfile not found: {{path}}",
     "lockfile.invalid_version": "Invalid lockfile version: {{path}}",
     "lockfile.invalid_structure": "Invalid lockfile structure: {{path}}",
@@ -15636,6 +15639,8 @@ var MESSAGES = {
     "update.lockfile_failed": "Failed to regenerate lockfile: {{error}}",
     "update.protected_file_updated": "⟳ Protected file {{file}} in {{component}} updated: {{hint}}",
     "update.namespace_synced": "Namespace synced: {{file}} ({{component}})",
+    "update.hook_commands_migrated": "Migrated {{count}} hook command(s) to CLAUDE_PROJECT_DIR-anchored paths",
+    "update.hook_commands_migration_failed": "Failed to migrate hook commands in {{path}}",
     "config.load_failed": "Failed to load config: {{error}}",
     "config.not_found": "Config not found at {{path}}, using defaults",
     "config.saved": "Config saved to {{path}}",
@@ -15661,6 +15666,8 @@ var MESSAGES = {
     "install.entry_md_skipped": "{{entry}} 건너뜀 ({{reason}})",
     "install.lockfile_generated": "잠금 파일 생성 완료 ({{files}}개 파일 추적)",
     "install.lockfile_failed": "잠금 파일 생성 실패: {{error}}",
+    "install.hook_commands_migrated": "settings.local.json의 훅 명령 {{rewritten}}개를 마이그레이션했습니다",
+    "install.hook_commands_migration_failed": "settings.local.json의 훅 명령 마이그레이션에 실패했습니다: {{error}}",
     "lockfile.not_found": "잠금 파일 없음: {{path}}",
     "lockfile.invalid_version": "잠금 파일 버전 유효하지 않음: {{path}}",
     "lockfile.invalid_structure": "잠금 파일 구조 유효하지 않음: {{path}}",
@@ -15682,6 +15689,8 @@ var MESSAGES = {
     "update.lockfile_failed": "잠금 파일 재생성 실패: {{error}}",
     "update.protected_file_updated": "⟳ 보호 파일 {{file}} ({{component}}) 업데이트됨: {{hint}}",
     "update.namespace_synced": "네임스페이스 동기화: {{file}} ({{component}})",
+    "update.hook_commands_migrated": "CLAUDE_PROJECT_DIR 기준 경로로 훅 명령 {{count}}개를 마이그레이션했습니다",
+    "update.hook_commands_migration_failed": "{{path}}의 훅 명령 마이그레이션에 실패했습니다",
     "config.load_failed": "설정 로드 실패: {{error}}",
     "config.not_found": "{{path}}에 설정 없음, 기본값 사용",
     "config.saved": "설정 저장: {{path}}",
@@ -17349,6 +17358,52 @@ function getDefaultWorkflow() {
   };
 }
 
+// src/core/hook-command-migration.ts
+var OLD_HOOK_COMMAND = /^(bash )?(?:\.\/)?\.claude\/hooks\/((?:scripts\/)?[A-Za-z0-9._-]+\.sh)$/;
+function rewriteRelativeHookCommand(command) {
+  const match = OLD_HOOK_COMMAND.exec(command);
+  if (match === null) {
+    return null;
+  }
+  const interpreter = match[1] ?? "";
+  return `${interpreter}"\${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/${match[2]}"`;
+}
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function rewriteNode(node, counter) {
+  if (Array.isArray(node)) {
+    return node.map((item) => rewriteNode(item, counter));
+  }
+  if (!isRecord(node)) {
+    return node;
+  }
+  const out = {};
+  for (const [key, value] of Object.entries(node)) {
+    if (key === "command" && typeof value === "string") {
+      const rewritten = rewriteRelativeHookCommand(value);
+      if (rewritten !== null) {
+        counter.count++;
+        out[key] = rewritten;
+        continue;
+      }
+    }
+    out[key] = rewriteNode(value, counter);
+  }
+  return out;
+}
+function migrateHookCommands(settings) {
+  if (!isRecord(settings.hooks)) {
+    return { settings, rewritten: 0 };
+  }
+  const counter = { count: 0 };
+  const hooks = rewriteNode(settings.hooks, counter);
+  if (counter.count === 0) {
+    return { settings, rewritten: 0 };
+  }
+  return { settings: { ...settings, hooks }, rewritten: counter.count };
+}
+
 // src/core/hooks-settings.ts
 init_fs();
 import { dirname as dirname3 } from "node:path";
@@ -18036,6 +18091,32 @@ async function installHooksSettings(targetDir, _options, result) {
     warn("install.hooks_settings_failed", { error: message });
   }
 }
+var BOM = "\uFEFF";
+async function migrateRestoredHookCommands(targetDir, result) {
+  const layout = getProviderLayout();
+  const settingsPath = join8(targetDir, layout.rootDir, "settings.local.json");
+  if (!await fileExists(settingsPath)) {
+    return;
+  }
+  try {
+    const raw = await readTextFile(settingsPath);
+    const hasBom = raw.startsWith(BOM);
+    const trailingNewline = raw.endsWith(`
+`) ? `
+` : "";
+    const current = JSON.parse(hasBom ? raw.slice(BOM.length) : raw);
+    const { settings, rewritten } = migrateHookCommands(current);
+    if (rewritten > 0) {
+      const body = `${JSON.stringify(settings, null, 2)}${trailingNewline}`;
+      await writeTextFile(settingsPath, hasBom ? `${BOM}${body}` : body);
+      debug("install.hook_commands_migrated", { rewritten: String(rewritten) });
+    }
+  } catch (err) {
+    const message = err instanceof Error ? err.message : String(err);
+    result.warnings.push(`Failed to migrate hook commands in settings.local.json: ${message}`);
+    warn("install.hook_commands_migration_failed", { error: message });
+  }
+}
 async function installEntryDocWithTracking(targetDir, options, result) {
   const language = options.language ?? DEFAULT_LANGUAGE2;
   const overwrite = !!(options.force || options.backup);
@@ -18111,6 +18192,7 @@ async function install(options) {
           result.warnings.push(`Failed to restore ${failure.path}: ${failure.reason}`);
         }
       }
+      await migrateRestoredHookCommands(options.targetDir, result);
       await cleanupPreservation(preservation.tempDir);
     }
     await updateInstallConfig(options.targetDir, options, result.installedComponents);
@@ -20948,6 +21030,37 @@ async function backfillStatusLineRefreshInterval(targetDir, options) {
     });
   }
 }
+async function migrateHookCommandsInSettingsLocal(targetDir, options) {
+  if (options.dryRun) {
+    return;
+  }
+  const layout = getProviderLayout();
+  const settingsPath = join18(targetDir, layout.rootDir, "settings.local.json");
+  if (!await fileExists(settingsPath)) {
+    return;
+  }
+  try {
+    const raw = await readTextFile(settingsPath);
+    const bom = raw.startsWith("\uFEFF") ? "\uFEFF" : "";
+    const parsed = JSON.parse(bom ? raw.slice(bom.length) : raw);
+    if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
+      return;
+    }
+    const { settings, rewritten } = migrateHookCommands(parsed);
+    if (rewritten === 0) {
+      return;
+    }
+    const trailingNewline = raw.endsWith(`
+`) ? `
+` : "";
+    await writeTextFile(settingsPath, `${bom}${JSON.stringify(settings, null, 2)}${trailingNewline}`);
+    info("update.hook_commands_migrated", { count: String(rewritten) });
+  } catch {
+    warn("update.hook_commands_migration_failed", {
+      path: settingsPath
+    });
+  }
+}
 async function runFullUpdatePostProcessing(options, result, config) {
   const isFullUpdate = !options.components || options.components.length === 0;
   if (isFullUpdate) {
@@ -20960,6 +21073,9 @@ async function runFullUpdatePostProcessing(options, result, config) {
       await backfillStatusLineRefreshInterval(options.targetDir, options);
     }
   }
+  if (isFullUpdate || options.components?.includes("hooks")) {
+    await migrateHookCommandsInSettingsLocal(options.targetDir, options);
+  }
   if (!options.dryRun) {
     config.version = result.newVersion;
     config.lastUpdated = new Date().toISOString();

package/dist/index.js

@@ -330,6 +330,8 @@ var MESSAGES = {
     "install.entry_md_skipped": "{{entry}} skipped ({{reason}})",
     "install.lockfile_generated": "Lockfile generated ({{files}} files tracked)",
     "install.lockfile_failed": "Failed to generate lockfile: {{error}}",
+    "install.hook_commands_migrated": "Migrated {{rewritten}} hook command(s) in settings.local.json",
+    "install.hook_commands_migration_failed": "Failed to migrate hook commands in settings.local.json: {{error}}",
     "lockfile.not_found": "Lockfile not found: {{path}}",
     "lockfile.invalid_version": "Invalid lockfile version: {{path}}",
     "lockfile.invalid_structure": "Invalid lockfile structure: {{path}}",
@@ -351,6 +353,8 @@ var MESSAGES = {
     "update.lockfile_failed": "Failed to regenerate lockfile: {{error}}",
     "update.protected_file_updated": "⟳ Protected file {{file}} in {{component}} updated: {{hint}}",
     "update.namespace_synced": "Namespace synced: {{file}} ({{component}})",
+    "update.hook_commands_migrated": "Migrated {{count}} hook command(s) to CLAUDE_PROJECT_DIR-anchored paths",
+    "update.hook_commands_migration_failed": "Failed to migrate hook commands in {{path}}",
     "config.load_failed": "Failed to load config: {{error}}",
     "config.not_found": "Config not found at {{path}}, using defaults",
     "config.saved": "Config saved to {{path}}",
@@ -376,6 +380,8 @@ var MESSAGES = {
     "install.entry_md_skipped": "{{entry}} 건너뜀 ({{reason}})",
     "install.lockfile_generated": "잠금 파일 생성 완료 ({{files}}개 파일 추적)",
     "install.lockfile_failed": "잠금 파일 생성 실패: {{error}}",
+    "install.hook_commands_migrated": "settings.local.json의 훅 명령 {{rewritten}}개를 마이그레이션했습니다",
+    "install.hook_commands_migration_failed": "settings.local.json의 훅 명령 마이그레이션에 실패했습니다: {{error}}",
     "lockfile.not_found": "잠금 파일 없음: {{path}}",
     "lockfile.invalid_version": "잠금 파일 버전 유효하지 않음: {{path}}",
     "lockfile.invalid_structure": "잠금 파일 구조 유효하지 않음: {{path}}",
@@ -397,6 +403,8 @@ var MESSAGES = {
     "update.lockfile_failed": "잠금 파일 재생성 실패: {{error}}",
     "update.protected_file_updated": "⟳ 보호 파일 {{file}} ({{component}}) 업데이트됨: {{hint}}",
     "update.namespace_synced": "네임스페이스 동기화: {{file}} ({{component}})",
+    "update.hook_commands_migrated": "CLAUDE_PROJECT_DIR 기준 경로로 훅 명령 {{count}}개를 마이그레이션했습니다",
+    "update.hook_commands_migration_failed": "{{path}}의 훅 명령 마이그레이션에 실패했습니다",
     "config.load_failed": "설정 로드 실패: {{error}}",
     "config.not_found": "{{path}}에 설정 없음, 기본값 사용",
     "config.saved": "설정 저장: {{path}}",
@@ -1094,6 +1102,52 @@ async function cleanupPreservation(tempDir) {
   }
 }
 
+// src/core/hook-command-migration.ts
+var OLD_HOOK_COMMAND = /^(bash )?(?:\.\/)?\.claude\/hooks\/((?:scripts\/)?[A-Za-z0-9._-]+\.sh)$/;
+function rewriteRelativeHookCommand(command) {
+  const match = OLD_HOOK_COMMAND.exec(command);
+  if (match === null) {
+    return null;
+  }
+  const interpreter = match[1] ?? "";
+  return `${interpreter}"\${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/${match[2]}"`;
+}
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function rewriteNode(node, counter) {
+  if (Array.isArray(node)) {
+    return node.map((item) => rewriteNode(item, counter));
+  }
+  if (!isRecord(node)) {
+    return node;
+  }
+  const out = {};
+  for (const [key, value] of Object.entries(node)) {
+    if (key === "command" && typeof value === "string") {
+      const rewritten = rewriteRelativeHookCommand(value);
+      if (rewritten !== null) {
+        counter.count++;
+        out[key] = rewritten;
+        continue;
+      }
+    }
+    out[key] = rewriteNode(value, counter);
+  }
+  return out;
+}
+function migrateHookCommands(settings) {
+  if (!isRecord(settings.hooks)) {
+    return { settings, rewritten: 0 };
+  }
+  const counter = { count: 0 };
+  const hooks = rewriteNode(settings.hooks, counter);
+  if (counter.count === 0) {
+    return { settings, rewritten: 0 };
+  }
+  return { settings: { ...settings, hooks }, rewritten: counter.count };
+}
+
 // src/core/hooks-settings.ts
 init_fs();
 import { dirname as dirname2 } from "node:path";
@@ -2026,6 +2080,32 @@ async function installHooksSettings(targetDir, _options, result) {
     warn("install.hooks_settings_failed", { error: message });
   }
 }
+var BOM = "\uFEFF";
+async function migrateRestoredHookCommands(targetDir, result) {
+  const layout = getProviderLayout();
+  const settingsPath = join5(targetDir, layout.rootDir, "settings.local.json");
+  if (!await fileExists(settingsPath)) {
+    return;
+  }
+  try {
+    const raw = await readTextFile(settingsPath);
+    const hasBom = raw.startsWith(BOM);
+    const trailingNewline = raw.endsWith(`
+`) ? `
+` : "";
+    const current = JSON.parse(hasBom ? raw.slice(BOM.length) : raw);
+    const { settings, rewritten } = migrateHookCommands(current);
+    if (rewritten > 0) {
+      const body = `${JSON.stringify(settings, null, 2)}${trailingNewline}`;
+      await writeTextFile(settingsPath, hasBom ? `${BOM}${body}` : body);
+      debug("install.hook_commands_migrated", { rewritten: String(rewritten) });
+    }
+  } catch (err) {
+    const message = err instanceof Error ? err.message : String(err);
+    result.warnings.push(`Failed to migrate hook commands in settings.local.json: ${message}`);
+    warn("install.hook_commands_migration_failed", { error: message });
+  }
+}
 async function installEntryDocWithTracking(targetDir, options, result) {
   const language = options.language ?? DEFAULT_LANGUAGE;
   const overwrite = !!(options.force || options.backup);
@@ -2101,6 +2181,7 @@ async function install(options) {
           result.warnings.push(`Failed to restore ${failure.path}: ${failure.reason}`);
         }
       }
+      await migrateRestoredHookCommands(options.targetDir, result);
       await cleanupPreservation(preservation.tempDir);
     }
     await updateInstallConfig(options.targetDir, options, result.installedComponents);
@@ -2326,7 +2407,7 @@ var package_default = {
   workspaces: [
     "packages/*"
   ],
-  version: "1.1.91",
+  version: "1.1.92",
   description: "Batteries-included agent harness for Claude Code",
   type: "module",
   bin: {
@@ -2350,7 +2431,8 @@ var package_default = {
   },
   scripts: {
     dev: "bun run src/cli/index.ts",
-    build: "bun build src/cli/index.ts --outdir dist/cli --target node && bun build src/index.ts --outdir dist --target node && bun run scripts/sync-source-lockfile.ts",
+    build: "bun build src/cli/index.ts --outdir dist/cli --target node && bun build src/index.ts --outdir dist --target node && bun run scripts/sync-source-lockfile.ts && bun run scripts/sync-hooks-settings.ts",
+    "sync:hooks": "bun run scripts/sync-hooks-settings.ts",
     test: "bun test tests/ packages/eval-core/",
     "test:unit": "bun test tests/unit",
     "test:integration": "bun test tests/integration",
@@ -5157,6 +5239,37 @@ async function backfillStatusLineRefreshInterval(targetDir, options) {
     });
   }
 }
+async function migrateHookCommandsInSettingsLocal(targetDir, options) {
+  if (options.dryRun) {
+    return;
+  }
+  const layout = getProviderLayout();
+  const settingsPath = join7(targetDir, layout.rootDir, "settings.local.json");
+  if (!await fileExists(settingsPath)) {
+    return;
+  }
+  try {
+    const raw = await readTextFile(settingsPath);
+    const bom = raw.startsWith("\uFEFF") ? "\uFEFF" : "";
+    const parsed = JSON.parse(bom ? raw.slice(bom.length) : raw);
+    if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
+      return;
+    }
+    const { settings, rewritten } = migrateHookCommands(parsed);
+    if (rewritten === 0) {
+      return;
+    }
+    const trailingNewline = raw.endsWith(`
+`) ? `
+` : "";
+    await writeTextFile(settingsPath, `${bom}${JSON.stringify(settings, null, 2)}${trailingNewline}`);
+    info("update.hook_commands_migrated", { count: String(rewritten) });
+  } catch {
+    warn("update.hook_commands_migration_failed", {
+      path: settingsPath
+    });
+  }
+}
 async function runFullUpdatePostProcessing(options, result, config) {
   const isFullUpdate = !options.components || options.components.length === 0;
   if (isFullUpdate) {
@@ -5169,6 +5282,9 @@ async function runFullUpdatePostProcessing(options, result, config) {
       await backfillStatusLineRefreshInterval(options.targetDir, options);
     }
   }
+  if (isFullUpdate || options.components?.includes("hooks")) {
+    await migrateHookCommandsInSettingsLocal(options.targetDir, options);
+  }
   if (!options.dryRun) {
     config.version = result.newVersion;
     config.lastUpdated = new Date().toISOString();

package/package.json

@@ -3,7 +3,7 @@
   "workspaces": [
     "packages/*"
   ],
-  "version": "1.1.91",
+  "version": "1.1.92",
   "description": "Batteries-included agent harness for Claude Code",
   "type": "module",
   "bin": {
@@ -27,7 +27,8 @@
   },
   "scripts": {
     "dev": "bun run src/cli/index.ts",
-    "build": "bun build src/cli/index.ts --outdir dist/cli --target node && bun build src/index.ts --outdir dist --target node && bun run scripts/sync-source-lockfile.ts",
+    "build": "bun build src/cli/index.ts --outdir dist/cli --target node && bun build src/index.ts --outdir dist --target node && bun run scripts/sync-source-lockfile.ts && bun run scripts/sync-hooks-settings.ts",
+    "sync:hooks": "bun run scripts/sync-hooks-settings.ts",
     "test": "bun test tests/ packages/eval-core/",
     "test:unit": "bun test tests/unit",
     "test:integration": "bun test tests/integration",

package/templates/.claude/hooks/hooks.json

@@ -7,7 +7,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "bash .claude/hooks/scripts/stage-blocker.sh"
+            "command": "bash \"${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/scripts/stage-blocker.sh\""
           }
         ],
         "description": "Block Write/Edit tools during plan/verify/compound stages — only allow in implement stage"
@@ -67,7 +67,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "bash .claude/hooks/scripts/content-hash-validator.sh"
+            "command": "bash \"${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/scripts/content-hash-validator.sh\""
           }
         ],
         "description": "Validate file content hash before Edit — advisory staleness warning"
@@ -77,7 +77,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "bash .claude/hooks/scripts/schema-validator.sh"
+            "command": "bash \"${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/scripts/schema-validator.sh\""
           }
         ],
         "description": "Schema-based tool input validation — Phase 1 advisory only"
@@ -87,7 +87,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "bash .claude/hooks/scripts/rtk-intercept.sh"
+            "command": "bash \"${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/scripts/rtk-intercept.sh\""
           }
         ],
         "description": "RTK auto-intercept — transparently rewrites CLI commands through RTK proxy when available (R013 advisory)"
@@ -97,7 +97,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "bash .claude/hooks/scripts/destructive-git-guard.sh"
+            "command": "bash \"${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/scripts/destructive-git-guard.sh\""
           }
         ],
         "description": "Warn before destructive git commands — advisory recovery guidance (R001/R021)"
@@ -107,7 +107,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "bash .claude/hooks/scripts/rule-deletion-guard.sh"
+            "command": "bash \"${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/scripts/rule-deletion-guard.sh\""
           }
         ],
         "description": "Block rule file deletion — requires individual user confirmation per rule (R001 safety)"
@@ -121,15 +121,15 @@
           },
           {
             "type": "command",
-            "command": "bash .claude/hooks/scripts/git-delegation-guard.sh"
+            "command": "bash \"${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/scripts/git-delegation-guard.sh\""
           },
           {
             "type": "command",
-            "command": "bash .claude/hooks/scripts/agent-teams-advisor.sh"
+            "command": "bash \"${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/scripts/agent-teams-advisor.sh\""
           },
           {
             "type": "command",
-            "command": "bash .claude/hooks/scripts/model-escalation-advisor.sh"
+            "command": "bash \"${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/scripts/model-escalation-advisor.sh\""
           }
         ],
         "description": "HUD statusline + R010 git delegation guard + R018 Agent Teams advisor on Agent/Task spawn"
@@ -141,7 +141,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": ".claude/hooks/scripts/omcustom-auto-update.sh"
+            "command": "\"${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/scripts/omcustom-auto-update.sh\""
           }
         ],
         "description": "Interactive oh-my-customcode update check at session start (#752)"
@@ -151,7 +151,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "bash .claude/hooks/scripts/session-env-check.sh"
+            "command": "bash \"${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/scripts/session-env-check.sh\""
           }
         ],
         "description": "Check codex CLI and Agent Teams availability at session start"
@@ -161,7 +161,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "bash .claude/hooks/scripts/stale-todo-scanner.sh"
+            "command": "bash \"${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/scripts/stale-todo-scanner.sh\""
           }
         ],
         "description": "Scan TODO.md files for stale items at session start"
@@ -171,7 +171,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "bash .claude/hooks/scripts/adaptive-harness-scan.sh"
+            "command": "bash \"${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/scripts/adaptive-harness-scan.sh\""
           }
         ],
         "description": "Lightweight project profile staleness check for adaptive harness (#831)"
@@ -181,7 +181,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "bash .claude/hooks/scripts/session-autofix.sh"
+            "command": "bash \"${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/scripts/session-autofix.sh\""
           }
         ],
         "description": "Auto-detect and fix previous session issues at start (#838)"
@@ -191,7 +191,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "bash .claude/hooks/scripts/plugin-cache-check.sh"
+            "command": "bash \"${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/scripts/plugin-cache-check.sh\""
           }
         ],
         "description": "Advisory check for plugin cache directories missing node_modules (#1207)"
@@ -201,7 +201,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "bash .claude/hooks/scripts/claude-md-reinject.sh"
+            "command": "bash \"${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/scripts/claude-md-reinject.sh\""
           }
         ],
         "description": "Re-inject project CLAUDE.md into model context on compact re-entry only — CC already natively auto-loads CLAUDE.md on startup/resume/clear, so re-injecting there is pure duplication (~13.8KB/session); matcher narrowed to \"compact\" to keep the original #1617 purpose (post-compact amnesia defense) without the startup double-injection (#1626)"
@@ -213,7 +213,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "bash .claude/hooks/scripts/user-prompt-preprocessor.sh"
+            "command": "bash \"${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/scripts/user-prompt-preprocessor.sh\""
           }
         ],
         "description": "Advisory pre-processing of user input — skill matching hints and intent analysis"
@@ -223,7 +223,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "bash .claude/hooks/scripts/r007-r008-drift-advisor.sh"
+            "command": "bash \"${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/scripts/r007-r008-drift-advisor.sh\""
           }
         ],
         "description": "Proactive R007/R008 drift advisory — checks last assistant turn for identification omission (#1229)"
@@ -233,7 +233,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "bash .claude/hooks/scripts/session-autofix-prompt.sh"
+            "command": "bash \"${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/scripts/session-autofix-prompt.sh\""
           }
         ],
         "description": "Inject session auto-fix findings into first user prompt (#838)"
@@ -243,7 +243,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "bash .claude/hooks/scripts/fail-axis-cause-advisor.sh"
+            "command": "bash \"${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/scripts/fail-axis-cause-advisor.sh\""
           }
         ],
         "description": "Advisory on cause-free progress nudges when this session has logged tool failures — delivers via hookSpecificOutput.additionalContext (#1561)"
@@ -259,7 +259,7 @@
           },
           {
             "type": "command",
-            "command": "bash .claude/hooks/scripts/agent-start-recorder.sh"
+            "command": "bash \"${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/scripts/agent-start-recorder.sh\""
           }
         ],
         "description": "HUD display + agent start time recording for stall detection (R009)"
@@ -271,23 +271,23 @@
         "hooks": [
           {
             "type": "command",
-            "command": "bash .claude/hooks/scripts/task-outcome-recorder.sh"
+            "command": "bash \"${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/scripts/task-outcome-recorder.sh\""
           },
           {
             "type": "command",
-            "command": "bash .claude/hooks/scripts/stall-detection-advisor.sh"
+            "command": "bash \"${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/scripts/stall-detection-advisor.sh\""
           },
           {
             "type": "command",
-            "command": "bash .claude/hooks/scripts/auto-continue-guard.sh"
+            "command": "bash \"${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/scripts/auto-continue-guard.sh\""
           },
           {
             "type": "command",
-            "command": "bash .claude/hooks/scripts/r007-r008-drift-advisor.sh"
+            "command": "bash \"${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/scripts/r007-r008-drift-advisor.sh\""
           },
           {
             "type": "command",
-            "command": "bash .claude/hooks/scripts/subagent-failure-advisor.sh"
+            "command": "bash \"${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/scripts/subagent-failure-advisor.sh\""
           }
         ],
         "description": "Record agent outcomes + auto-continue workflow + R007/R008 drift advisory + failure advisory on subagent completion (autonomous-loop re-entry, #1545; #1631 replaced the self-referential prompt-type judge hook with an advisory-only command hook)"
@@ -299,7 +299,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "bash .claude/hooks/scripts/cwd-change-detector.sh"
+            "command": "bash \"${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/scripts/cwd-change-detector.sh\""
           }
         ],
         "description": "Auto-detect project type on working directory change (v2.1.83+)"
@@ -311,7 +311,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "bash .claude/hooks/scripts/file-change-validator.sh"
+            "command": "bash \"${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/scripts/file-change-validator.sh\""
           }
         ],
         "description": "Validate externally modified files — advisory staleness warning (v2.1.83+)"
@@ -371,7 +371,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "bash .claude/hooks/scripts/task-state-precompact.sh"
+            "command": "bash \"${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/scripts/task-state-precompact.sh\""
           }
         ],
         "description": "Serialize active task state before compaction — pairs with PostCompact restore (#922)"
@@ -469,7 +469,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "bash .claude/hooks/scripts/context-budget-advisor.sh",
+            "command": "bash \"${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/scripts/context-budget-advisor.sh\"",
             "continueOnBlock": true
           }
         ],
@@ -480,7 +480,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "bash .claude/hooks/scripts/r007-r008-drift-advisor.sh",
+            "command": "bash \"${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/scripts/r007-r008-drift-advisor.sh\"",
             "continueOnBlock": true
           }
         ],
@@ -491,7 +491,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "bash .claude/hooks/scripts/stuck-detector.sh",
+            "command": "bash \"${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/scripts/stuck-detector.sh\"",
             "continueOnBlock": true
           }
         ],
@@ -502,7 +502,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "bash .claude/hooks/scripts/cost-cap-advisor.sh",
+            "command": "bash \"${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/scripts/cost-cap-advisor.sh\"",
             "continueOnBlock": true
           }
         ],
@@ -513,7 +513,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "bash .claude/hooks/scripts/content-hash-validator.sh"
+            "command": "bash \"${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/scripts/content-hash-validator.sh\""
           }
         ],
         "description": "Store content hashes for Read operations — enables Edit staleness detection"
@@ -523,7 +523,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "bash .claude/hooks/scripts/secret-filter.sh"
+            "command": "bash \"${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/scripts/secret-filter.sh\""
           }
         ],
         "description": "Detect potential secrets in Bash/Read/Grep output — advisory warning only"
@@ -533,7 +533,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "bash .claude/hooks/scripts/audit-log.sh"
+            "command": "bash \"${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/scripts/audit-log.sh\""
           }
         ],
         "description": "Append-only audit log for state-changing tool operations"
@@ -543,7 +543,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "bash .claude/hooks/skill-count-reminder.sh",
+            "command": "bash \"${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/skill-count-reminder.sh\"",
             "continueOnBlock": true
           }
         ],
@@ -554,7 +554,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "bash .claude/hooks/scripts/playwright-compress.sh"
+            "command": "bash \"${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/scripts/playwright-compress.sh\""
           }
         ],
         "description": "Layer 4: Compress Playwright/Chrome MCP output via Haiku summarization"
@@ -564,7 +564,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "bash .claude/hooks/scripts/auto-dev-token-tracker.sh"
+            "command": "bash \"${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/scripts/auto-dev-token-tracker.sh\""
           }
         ],
         "description": "auto-dev token spend tracker — records per-phase token estimates during /pipeline auto-dev (Issue #1057, advisory)"
@@ -576,7 +576,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "bash .claude/hooks/scripts/stop-console-audit.sh"
+            "command": "bash \"${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/scripts/stop-console-audit.sh\""
           }
         ],
         "description": "Final console.log audit and session diagnostics before session ends"
@@ -586,7 +586,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "bash .claude/hooks/scripts/eval-core-batch-save.sh"
+            "command": "bash \"${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/scripts/eval-core-batch-save.sh\""
           }
         ],
         "description": "Batch-save agent outcomes to eval-core DB on session end (advisory, exit 0)"
@@ -596,7 +596,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "bash .claude/hooks/scripts/feedback-collector.sh"
+            "command": "bash \"${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/scripts/feedback-collector.sh\""
           }
         ],
         "description": "Auto-extract failure patterns from session outcomes (advisory, exit 0)"
@@ -606,7 +606,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "bash .claude/hooks/scripts/session-reflection.sh"
+            "command": "bash \"${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/scripts/session-reflection.sh\""
           }
         ],
         "description": "Transcript-based self-reflection: detect R007/R008 violations and log to .claude/outputs/reflections/ (Phase 1 MVP, advisory, exit 0)"
@@ -616,7 +616,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "bash .claude/hooks/scripts/skill-extractor-analyzer.sh"
+            "command": "bash \"${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/scripts/skill-extractor-analyzer.sh\""
           }
         ],
         "description": "Detect reusable skill candidates from session task outcomes (advisory, exit 0)"
@@ -626,7 +626,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "bash .claude/hooks/scripts/auto-dev-token-summary.sh"
+            "command": "bash \"${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/scripts/auto-dev-token-summary.sh\""
           }
         ],
         "description": "Print auto-dev token spend summary on session end (Issue #1057, advisory)"
@@ -638,7 +638,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "bash .claude/hooks/scripts/failure-ledger.sh"
+            "command": "bash \"${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/scripts/failure-ledger.sh\""
           }
         ],
         "description": "FAIL-axis instrumentation — append tool failures to the error ledger (JSONL). Never blocks; feeds fail-axis-cause-advisor.sh (#1561)"

package/templates/.claude/hooks/scripts/rule-deletion-guard.sh

@@ -13,7 +13,7 @@ if ! command -v jq &>/dev/null; then
 fi
 
 # Parse tool input
-tool=$(printf '%s\n' "$input" | jq -r '.tool // ""' 2>/dev/null) || { printf '%s\n' "$input"; exit 0; }
+tool=$(printf '%s\n' "$input" | jq -r '.tool_name // .tool // ""' 2>/dev/null) || { printf '%s\n' "$input"; exit 0; }
 cmd=$(printf '%s\n' "$input" | jq -r '.tool_input.command // ""' 2>/dev/null) || { printf '%s\n' "$input"; exit 0; }
 
 # Only check Bash tool

package/templates/.claude/hooks/scripts/schema-validator.sh

@@ -21,7 +21,11 @@ tool_name=$(printf '%s\n' "$input" | jq -r '.tool_name? // "unknown"')
 tool_input=$(printf '%s\n' "$input" | jq -c 'if (.tool_input? | type) == "object" then .tool_input else {} end' 2>/dev/null) || tool_input='{}'
 [ -n "$tool_input" ] || tool_input='{}'
 
-SCHEMA_FILE=".claude/schemas/tool-inputs.json"
+# Locate the repo root ourselves (#1767): hooks run in the session cwd, which may be
+# a subdirectory. Prefer CLAUDE_PROJECT_DIR; fall back to this script's own location
+# (<root>/.claude/hooks/scripts/ -> three levels up).
+ROOT="${CLAUDE_PROJECT_DIR:-$(cd "$(dirname "${BASH_SOURCE[0]}")/../../.." && pwd)}"
+SCHEMA_FILE="$ROOT/.claude/schemas/tool-inputs.json"
 
 # Skip if schema file doesn't exist
 if [ ! -f "$SCHEMA_FILE" ]; then

package/templates/.claude/hooks/skill-count-reminder.sh

@@ -5,6 +5,9 @@
 
 set -euo pipefail
 
+# Locate the repo root ourselves: hooks run in the session cwd, which may be a subdirectory
+ROOT="${CLAUDE_PROJECT_DIR:-$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)}"
+
 # Read tool input from stdin
 INPUT=$(cat)
 
@@ -14,7 +17,8 @@ FILE_PATH=$(echo "$INPUT" | jq -r '.tool_input.file_path // .tool_input.path //
 # Only trigger for .claude/skills/ paths with SKILL.md
 if [[ "$FILE_PATH" == *".claude/skills/"*"SKILL.md"* ]]; then
     SKILL_NAME=$(echo "$FILE_PATH" | sed 's|.*\.claude/skills/||' | sed 's|/SKILL.md||')
-    ACTUAL_COUNT=$(find .claude/skills -name 'SKILL.md' 2>/dev/null | wc -l | tr -d ' ')
+    # '|| true' keeps the advisory contract (exit 0) even if the skills directory is missing under pipefail
+    ACTUAL_COUNT=$( { find "$ROOT/.claude/skills" -name 'SKILL.md' 2>/dev/null || true; } | wc -l | tr -d ' ')
 
     cat >&2 << EOF
 ─── [Skill Sync Reminder] New/modified skill: ${SKILL_NAME} ───

package/templates/.claude/rules/MUST-enforcement-policy.md

@@ -33,7 +33,7 @@ oh-my-customcode uses an **advisory-first enforcement model**. Most rules are en
 
 | Anti-pattern | Required |
 |--------------|----------|
-| `hooks.json`만 편집하고 커밋 → settings.json `hooks` 블록 미재생성 | 편집 후 `hooks-settings.ts` 변환기(빌드) 실행 → settings.json(+local+templates) 재생성 확인 후 커밋 |
+| `hooks.json`만 편집하고 커밋 → settings.json `hooks` 블록 미재생성 | 편집 후 `bun run sync:hooks`(또는 `bun run build`) 실행 → settings.json(+local+templates) 재생성 확인 후 커밋 |
 
 교훈: **배선 확인 ≠ 전달 확인 ≠ 발화 확인 ≠ 로드 확인** — R020 "actual outcome ≠ attempt"의 훅 도메인 재현 사례. 상세는 Read 도구로 열람.
 

package/templates/.claude/settings.json

@@ -8,7 +8,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "bash .claude/hooks/scripts/stage-blocker.sh"
+            "command": "bash \"${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/scripts/stage-blocker.sh\""
           }
         ],
         "matcher": "Write|Edit",
@@ -68,7 +68,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "bash .claude/hooks/scripts/content-hash-validator.sh"
+            "command": "bash \"${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/scripts/content-hash-validator.sh\""
           }
         ],
         "matcher": "Edit",
@@ -78,7 +78,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "bash .claude/hooks/scripts/schema-validator.sh"
+            "command": "bash \"${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/scripts/schema-validator.sh\""
           }
         ],
         "matcher": "Write|Edit|Bash",
@@ -88,7 +88,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "bash .claude/hooks/scripts/rtk-intercept.sh"
+            "command": "bash \"${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/scripts/rtk-intercept.sh\""
           }
         ],
         "matcher": "Bash",
@@ -98,7 +98,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "bash .claude/hooks/scripts/destructive-git-guard.sh"
+            "command": "bash \"${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/scripts/destructive-git-guard.sh\""
           }
         ],
         "matcher": "Bash",
@@ -108,7 +108,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "bash .claude/hooks/scripts/rule-deletion-guard.sh"
+            "command": "bash \"${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/scripts/rule-deletion-guard.sh\""
           }
         ],
         "matcher": "Bash",
@@ -122,15 +122,15 @@
           },
           {
             "type": "command",
-            "command": "bash .claude/hooks/scripts/git-delegation-guard.sh"
+            "command": "bash \"${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/scripts/git-delegation-guard.sh\""
           },
           {
             "type": "command",
-            "command": "bash .claude/hooks/scripts/agent-teams-advisor.sh"
+            "command": "bash \"${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/scripts/agent-teams-advisor.sh\""
           },
           {
             "type": "command",
-            "command": "bash .claude/hooks/scripts/model-escalation-advisor.sh"
+            "command": "bash \"${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/scripts/model-escalation-advisor.sh\""
           }
         ],
         "matcher": "Task|Agent",
@@ -142,7 +142,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": ".claude/hooks/scripts/omcustom-auto-update.sh"
+            "command": "\"${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/scripts/omcustom-auto-update.sh\""
           }
         ],
         "matcher": "*",
@@ -152,7 +152,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "bash .claude/hooks/scripts/session-env-check.sh"
+            "command": "bash \"${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/scripts/session-env-check.sh\""
           }
         ],
         "matcher": "*",
@@ -162,7 +162,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "bash .claude/hooks/scripts/stale-todo-scanner.sh"
+            "command": "bash \"${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/scripts/stale-todo-scanner.sh\""
           }
         ],
         "matcher": "*",
@@ -172,7 +172,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "bash .claude/hooks/scripts/adaptive-harness-scan.sh"
+            "command": "bash \"${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/scripts/adaptive-harness-scan.sh\""
           }
         ],
         "matcher": "*",
@@ -182,7 +182,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "bash .claude/hooks/scripts/session-autofix.sh"
+            "command": "bash \"${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/scripts/session-autofix.sh\""
           }
         ],
         "matcher": "*",
@@ -192,7 +192,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "bash .claude/hooks/scripts/plugin-cache-check.sh"
+            "command": "bash \"${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/scripts/plugin-cache-check.sh\""
           }
         ],
         "matcher": "*",
@@ -202,7 +202,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "bash .claude/hooks/scripts/claude-md-reinject.sh"
+            "command": "bash \"${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/scripts/claude-md-reinject.sh\""
           }
         ],
         "matcher": "compact",
@@ -214,7 +214,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "bash .claude/hooks/scripts/user-prompt-preprocessor.sh"
+            "command": "bash \"${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/scripts/user-prompt-preprocessor.sh\""
           }
         ],
         "matcher": "*",
@@ -224,7 +224,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "bash .claude/hooks/scripts/r007-r008-drift-advisor.sh"
+            "command": "bash \"${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/scripts/r007-r008-drift-advisor.sh\""
           }
         ],
         "matcher": "*",
@@ -234,7 +234,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "bash .claude/hooks/scripts/session-autofix-prompt.sh"
+            "command": "bash \"${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/scripts/session-autofix-prompt.sh\""
           }
         ],
         "matcher": "*",
@@ -244,7 +244,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "bash .claude/hooks/scripts/fail-axis-cause-advisor.sh"
+            "command": "bash \"${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/scripts/fail-axis-cause-advisor.sh\""
           }
         ],
         "matcher": "*",
@@ -260,7 +260,7 @@
           },
           {
             "type": "command",
-            "command": "bash .claude/hooks/scripts/agent-start-recorder.sh"
+            "command": "bash \"${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/scripts/agent-start-recorder.sh\""
           }
         ],
         "matcher": "*",
@@ -272,23 +272,23 @@
         "hooks": [
           {
             "type": "command",
-            "command": "bash .claude/hooks/scripts/task-outcome-recorder.sh"
+            "command": "bash \"${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/scripts/task-outcome-recorder.sh\""
           },
           {
             "type": "command",
-            "command": "bash .claude/hooks/scripts/stall-detection-advisor.sh"
+            "command": "bash \"${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/scripts/stall-detection-advisor.sh\""
           },
           {
             "type": "command",
-            "command": "bash .claude/hooks/scripts/auto-continue-guard.sh"
+            "command": "bash \"${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/scripts/auto-continue-guard.sh\""
           },
           {
             "type": "command",
-            "command": "bash .claude/hooks/scripts/r007-r008-drift-advisor.sh"
+            "command": "bash \"${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/scripts/r007-r008-drift-advisor.sh\""
           },
           {
             "type": "command",
-            "command": "bash .claude/hooks/scripts/subagent-failure-advisor.sh"
+            "command": "bash \"${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/scripts/subagent-failure-advisor.sh\""
           }
         ],
         "matcher": "*",
@@ -300,7 +300,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "bash .claude/hooks/scripts/cwd-change-detector.sh"
+            "command": "bash \"${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/scripts/cwd-change-detector.sh\""
           }
         ],
         "matcher": "*",
@@ -312,7 +312,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "bash .claude/hooks/scripts/file-change-validator.sh"
+            "command": "bash \"${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/scripts/file-change-validator.sh\""
           }
         ],
         "matcher": "*",
@@ -372,7 +372,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "bash .claude/hooks/scripts/task-state-precompact.sh"
+            "command": "bash \"${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/scripts/task-state-precompact.sh\""
           }
         ],
         "matcher": "*",
@@ -470,7 +470,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "bash .claude/hooks/scripts/context-budget-advisor.sh",
+            "command": "bash \"${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/scripts/context-budget-advisor.sh\"",
             "continueOnBlock": true
           }
         ],
@@ -481,7 +481,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "bash .claude/hooks/scripts/r007-r008-drift-advisor.sh",
+            "command": "bash \"${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/scripts/r007-r008-drift-advisor.sh\"",
             "continueOnBlock": true
           }
         ],
@@ -492,7 +492,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "bash .claude/hooks/scripts/stuck-detector.sh",
+            "command": "bash \"${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/scripts/stuck-detector.sh\"",
             "continueOnBlock": true
           }
         ],
@@ -503,7 +503,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "bash .claude/hooks/scripts/cost-cap-advisor.sh",
+            "command": "bash \"${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/scripts/cost-cap-advisor.sh\"",
             "continueOnBlock": true
           }
         ],
@@ -514,7 +514,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "bash .claude/hooks/scripts/content-hash-validator.sh"
+            "command": "bash \"${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/scripts/content-hash-validator.sh\""
           }
         ],
         "matcher": "Read",
@@ -524,7 +524,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "bash .claude/hooks/scripts/secret-filter.sh"
+            "command": "bash \"${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/scripts/secret-filter.sh\""
           }
         ],
         "matcher": "Bash|Read|Grep",
@@ -534,7 +534,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "bash .claude/hooks/scripts/audit-log.sh"
+            "command": "bash \"${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/scripts/audit-log.sh\""
           }
         ],
         "matcher": "Edit|Write|Bash|Agent",
@@ -544,7 +544,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "bash .claude/hooks/skill-count-reminder.sh",
+            "command": "bash \"${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/skill-count-reminder.sh\"",
             "continueOnBlock": true
           }
         ],
@@ -555,7 +555,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "bash .claude/hooks/scripts/playwright-compress.sh"
+            "command": "bash \"${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/scripts/playwright-compress.sh\""
           }
         ],
         "matcher": "mcp__playwright__.*|mcp__claude-in-chrome__.*",
@@ -565,7 +565,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "bash .claude/hooks/scripts/auto-dev-token-tracker.sh"
+            "command": "bash \"${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/scripts/auto-dev-token-tracker.sh\""
           }
         ],
         "matcher": "Task|Agent",
@@ -577,7 +577,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "bash .claude/hooks/scripts/stop-console-audit.sh"
+            "command": "bash \"${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/scripts/stop-console-audit.sh\""
           }
         ],
         "matcher": "*",
@@ -587,7 +587,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "bash .claude/hooks/scripts/eval-core-batch-save.sh"
+            "command": "bash \"${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/scripts/eval-core-batch-save.sh\""
           }
         ],
         "matcher": "*",
@@ -597,7 +597,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "bash .claude/hooks/scripts/feedback-collector.sh"
+            "command": "bash \"${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/scripts/feedback-collector.sh\""
           }
         ],
         "matcher": "*",
@@ -607,7 +607,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "bash .claude/hooks/scripts/session-reflection.sh"
+            "command": "bash \"${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/scripts/session-reflection.sh\""
           }
         ],
         "matcher": "*",
@@ -617,7 +617,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "bash .claude/hooks/scripts/skill-extractor-analyzer.sh"
+            "command": "bash \"${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/scripts/skill-extractor-analyzer.sh\""
           }
         ],
         "matcher": "*",
@@ -627,7 +627,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "bash .claude/hooks/scripts/auto-dev-token-summary.sh"
+            "command": "bash \"${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/scripts/auto-dev-token-summary.sh\""
           }
         ],
         "matcher": "*",
@@ -639,7 +639,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "bash .claude/hooks/scripts/failure-ledger.sh"
+            "command": "bash \"${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/scripts/failure-ledger.sh\""
           }
         ],
         "matcher": "*",

package/templates/guides/hook-data-flow/README.md

@@ -85,12 +85,14 @@ The SubagentStop hook array in `hooks.json` defines a strict ordering:
 
 ```json
 "SubagentStop": [
-  { "command": "bash .claude/hooks/scripts/task-outcome-recorder.sh" },
-  { "command": "bash .claude/hooks/scripts/stall-detection-advisor.sh" },
+  { "command": "bash \"${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/scripts/task-outcome-recorder.sh\"" },
+  { "command": "bash \"${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/scripts/stall-detection-advisor.sh\"" },
   ...
 ]
 ```
 
+Hook commands are anchored to the project root with `${CLAUDE_PROJECT_DIR:-.}`: hooks run in the session cwd, Claude Code injects `CLAUDE_PROJECT_DIR` into hook processes, and the `:-.` fallback keeps the relative-path behavior when it is unset. `hooks.json` is the source; the tracked `settings.json` hooks blocks are generated from it by `bun run sync:hooks` (also run at the end of `bun run build`) — never hand-edit them.
+
 **task-outcome-recorder MUST run before stall-detection-advisor.**
 
 Reason: `stall-detection-advisor.sh` removes the matching start entry from `.claude-agent-starts-$PPID` after reading it (to prevent re-matching on the next SubagentStop). If the order were reversed, `task-outcome-recorder.sh` would find no start entry for the agent and would always record `duration_seconds=0`.

package/templates/manifest.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.1.91",
+  "version": "1.1.92",
   "lastUpdated": "2026-09-03",
   "omcustomMinClaudeCode": "2.1.121",
   "omcustomMinClaudeCodeReason": "Sensitive-path direct Write/Edit on .claude/** under bypassPermissions (R010 deprecation, #1101)",