triflux 10.9.19 → 10.9.21

package/references/hosts.json

@@ -0,0 +1,46 @@
+{
+  "hosts": {
+    "ultra4": {
+      "description": "Windows 데스크탑 (22코어/64GB RAM)",
+      "aliases": ["울트라", "울트라4", "데스크탑"],
+      "default_dir": "~/Desktop/Projects/cli/triflux",
+      "tailscale": {
+        "ip": "100.110.136.64",
+        "dns": "ultra-book-4-1",
+        "ssh_mode": "ssh-over-vpn"
+      },
+      "ssh_user": "SSAFY",
+      "os": "windows",
+      "specs": {
+        "cores": 22,
+        "ram_gb": 64,
+        "codex": "0.118.0",
+        "node": "24.14.0"
+      },
+      "capabilities": ["codex", "claude", "high-memory"]
+    },
+    "m2": {
+      "description": "MacBook Air M2 (8코어/16GB RAM)",
+      "aliases": ["맥", "맥북", "m2"],
+      "default_dir": "~/Desktop/Projects/triflux",
+      "tailscale": {
+        "ip": "100.104.61.126",
+        "dns": "tellang의-macbook-air",
+        "ssh_mode": "ssh-over-vpn"
+      },
+      "ssh_user": "tellang",
+      "os": "darwin",
+      "specs": {
+        "cores": 8,
+        "ram_gb": 16,
+        "claude": "2.1.89",
+        "codex": "0.114.0",
+        "gemini": "0.33.1",
+        "node": "25.9.0"
+      },
+      "capabilities": ["codex", "claude", "gemini"]
+    }
+  },
+  "default_host": "m2",
+  "triggers": ["원격에서", "다른 머신에서", "다른 컴퓨터에서"]
+}

package/scripts/__tests__/keyword-detector.test.mjs

@@ -34,7 +34,7 @@ const { extractPrompt, sanitizeForKeywordDetection } = detectorModule;
 
 function loadCompiledRules() {
   const rules = loadRules(rulesPath);
-  assert.ok(rules.length >= 32);
+  assert.equal(rules.length, 32);
   return compileRules(rules);
 }
 
@@ -108,8 +108,8 @@ test("sanitizeForKeywordDetection: 코드블록/URL/파일경로/XML 태그 제
 
 test("loadRules: 유효한 JSON 로드", () => {
   const rules = loadRules(rulesPath);
-  assert.ok(rules.length >= 32);
-  assert.ok(rules.filter((rule) => rule.skill).length >= 18);
+  assert.equal(rules.length, 32);
+  assert.equal(rules.filter((rule) => rule.skill).length, 18);
   assert.equal(rules.filter((rule) => rule.mcp_route).length, 10);
 });
 
@@ -130,7 +130,7 @@ test("loadRules: 잘못된 파일 처리", () => {
 test("compileRules: 정규식 컴파일 성공", () => {
   const rules = loadRules(rulesPath);
   const compiled = compileRules(rules);
-  assert.equal(compiled.length, rules.length);
+  assert.equal(compiled.length, 32);
   for (const rule of compiled) {
     assert.ok(Array.isArray(rule.compiledPatterns));
     assert.ok(rule.compiledPatterns.length > 0);

package/scripts/cross-review-gate.mjs

@@ -38,6 +38,11 @@ function isGitCommitCommand(command) {
   return /\bgit\s+commit\b/i.test(command);
 }
 
+function hasCoAuthoredByTrailer(command) {
+  if (typeof command !== "string") return false;
+  return /co-authored-by\s*:/i.test(command);
+}
+
 function summarizePending(entries) {
   return entries
     .map((item) => {
@@ -64,6 +69,14 @@ async function main() {
   if (toolName !== "Bash") process.exit(0);
   if (!isGitCommitCommand(toolInput.command || "")) process.exit(0);
 
+  // ISSUE-9: Co-Authored-By 트레일러 차단
+  if (hasCoAuthoredByTrailer(toolInput.command || "")) {
+    deny(
+      "[co-author-guard] Co-Authored-By 트레일러가 감지되었습니다. " +
+        "커밋 메시지에서 Co-Authored-By 줄을 제거하세요.",
+    );
+  }
+
   // cwd 전파: tracker와 동일한 resolveBaseDir 사용
   const baseDir = resolveBaseDir(payload);
   const statePath = join(baseDir, STATE_REL_PATH);

package/scripts/remote-spawn.mjs

@@ -606,27 +606,19 @@ function spawnLocalFallback(args, claudePath, prompt) {
     return;
   }
 
-  const wtArgs = ["new-tab", "-d", dir, "--"];
   const claudeForward = claudePath.replace(/\\/g, "/");
+  let command;
 
   if (prompt) {
     const psQuoted = `'${prompt.replace(/'/g, "''")}'`;
-    wtArgs.push(
-      "pwsh",
-      "-NoProfile",
-      "-Command",
-      `& '${claudeForward}' ${getPermissionFlag().join(" ")} ${psQuoted}`,
-    );
+    command = `pwsh -NoProfile -Command "& '${claudeForward}' ${getPermissionFlag().join(" ")} ${psQuoted}"`;
   } else {
-    wtArgs.push(claudeForward, ...getPermissionFlag());
+    command = `${claudeForward} ${getPermissionFlag().join(" ")}`;
   }
 
   try {
-    spawn("wt.exe", wtArgs, {
-      detached: true,
-      stdio: "ignore",
-      windowsHide: false,
-    }).unref();
+    const wt = (await import("../hub/team/wt-manager.mjs")).createWtManager();
+    await wt.createTab({ title: "Claude", command, cwd: dir });
     console.log(`spawned local Claude in WT tab → ${dir}`);
   } catch (error) {
     console.error("wt.exe spawn failed:", error.message);
@@ -717,23 +709,9 @@ function spawnRemoteFallback(args, promptContext) {
   const remoteCmd = `pwsh -NoExit -File ${remoteScript}`;
 
   if (IS_WINDOWS_LOCAL) {
-    const wtArgs = [
-      "new-tab",
-      "--title",
-      `Claude@${host}`,
-      "--",
-      "ssh",
-      "-t",
-      "--",
-      host,
-      remoteCmd,
-    ];
     try {
-      spawn("wt.exe", wtArgs, {
-        detached: true,
-        stdio: "ignore",
-        windowsHide: false,
-      }).unref();
+      const wt = (await import("../hub/team/wt-manager.mjs")).createWtManager();
+      await wt.createTab({ title: `Claude@${host}`, command: `ssh -t -- ${host} ${remoteCmd}` });
       console.log(`spawned remote Claude → ${host}:${dir}`);
     } catch (error) {
       console.error("wt.exe spawn failed:", error.message);
@@ -1024,23 +1002,10 @@ function listSpawnSessions() {
 function openAttachTab(sessionName, title = null) {
   if (IS_WINDOWS_LOCAL) {
     const wtArgs = title
-      ? [
-          "new-tab",
-          "--title",
-          title,
-          "--suppressApplicationTitle",
-          "--",
-          "psmux",
-          "attach",
-          "-t",
-          sessionName,
-        ]
-      : ["new-tab", "--", "psmux", "attach", "-t", sessionName];
-    spawn("wt.exe", wtArgs, {
-      detached: true,
-      stdio: "ignore",
-      windowsHide: false,
-    }).unref();
+    try {
+      const wt = (await import("../hub/team/wt-manager.mjs")).createWtManager();
+      await wt.createTab({ title: title || sessionName, command: `psmux attach -t ${sessionName}` });
+    } catch { /* fallback below */ }
     return;
   }
 

package/scripts/session-spawn-helper.mjs

@@ -1,6 +1,7 @@
 #!/usr/bin/env node
 import { execFileSync } from "node:child_process";
 import { spawn } from "../hub/lib/spawn-trace.mjs";
+import { createWtManager } from "../hub/team/wt-manager.mjs";
 
 const SESSION_PREFIX = "tfx-isolated";
 const DEFAULT_ATTACH_PROFILE = "triflux";
@@ -103,31 +104,17 @@ export function createIsolatedSession(options = {}) {
   return { sessionName };
 }
 
-export function attachWithWindowsTerminal(sessionName, options = {}) {
+export async function attachWithWindowsTerminal(sessionName, options = {}) {
   const profile = options.profile || DEFAULT_ATTACH_PROFILE;
   const title = options.title || sessionName;
-  const spawnFn = options.spawnFn || spawn;
 
-  // sp (split-pane), not new-tab
-  const wtArgs = [
-    "sp",
-    "-p",
-    profile,
-    "--title",
+  const wt = createWtManager();
+  await wt.splitPane({
+    direction: "H",
     title,
-    "--",
-    "psmux",
-    "attach-session",
-    "-t",
-    sessionName,
-  ];
-  const child = spawnFn("wt.exe", wtArgs, {
-    detached: true,
-    stdio: "ignore",
-    windowsHide: false,
+    profile,
+    command: `psmux attach-session -t ${sessionName}`,
   });
-  child.unref();
-  return wtArgs;
 }
 
 export function waitForCompletion(sessionName, opts = {}) {
@@ -252,7 +239,7 @@ async function main() {
   process.stdout.write(`[session-spawn] 세션 생성: ${sessionName}\n`);
 
   if (args.attach) {
-    attachWithWindowsTerminal(sessionName);
+    await attachWithWindowsTerminal(sessionName);
     process.stdout.write(`[session-spawn] WT split-pane attach 완료\n`);
   }
 

package/scripts/test-tfx-route-no-claude-native.mjs

@@ -4,12 +4,14 @@ import { spawnSync } from "node:child_process";
 import { dirname, resolve } from "node:path";
 import test from "node:test";
 import { fileURLToPath } from "node:url";
+import { resolveBashExecutable } from "../hub/lib/bash-path.mjs";
 
 const SCRIPT_DIR = dirname(fileURLToPath(import.meta.url));
 const PROJECT_ROOT = resolve(SCRIPT_DIR, "..");
+const BASH_EXE = resolveBashExecutable();
 
 function runBash(command) {
-  return spawnSync("bash", ["-lc", command], {
+  return spawnSync(BASH_EXE, ["-lc", command], {
     cwd: PROJECT_ROOT,
     encoding: "utf8",
     env: {
@@ -39,7 +41,7 @@ test("gemini 모드에서는 no-claude-native 강제 치환이 적용되지 않
 
 test("auto 모드 + no-claude-native=1이면 explore가 codex로 치환된다", () => {
   const result = runBash(
-    "TFX_CLI_MODE=auto TFX_NO_CLAUDE_NATIVE=1 CODEX_BIN=true bash scripts/tfx-route.sh explore 'test-case' minimal 5",
+    "TFX_CLI_MODE=auto TFX_NO_CLAUDE_NATIVE=1 CODEX_BIN=echo bash scripts/tfx-route.sh explore 'test-case' minimal 5",
   );
 
   assert.equal(result.status, 0, out(result));

package/scripts/tfx-route.sh

@@ -104,6 +104,19 @@ if [[ -f "$_CODEX_CONFIG" ]] && awk '
   _CODEX_HAS_SANDBOX="1"
 fi
 
+# ── MCP tool approval_mode stall 방지 (ISSUE-4) ──
+# oh-my-codex 업데이트가 MCP tool 블록의 approval_mode를 "approve"로 복원함.
+# codex exec는 non-TTY subprocess이므로 interactive 승인 대기 = output 0B stall.
+# 실행 전 자동으로 "full-auto"로 교체한다.
+if [[ -f "$_CODEX_CONFIG" ]] && grep -q 'approval_mode = "approve"' "$_CODEX_CONFIG" 2>/dev/null; then
+  _approve_count=$(grep -c 'approval_mode = "approve"' "$_CODEX_CONFIG" 2>/dev/null || echo 0)
+  if [[ "$_approve_count" -gt 0 ]]; then
+    cp "$_CODEX_CONFIG" "${_CODEX_CONFIG}.bak-$(date +%Y%m%d-%H%M%S)" 2>/dev/null || true
+    sed -i 's/approval_mode = "approve"/approval_mode = "full-auto"/g' "$_CODEX_CONFIG"
+    echo "[tfx-route] MCP tool approval_mode stall 방지: ${_approve_count}개 블록 approve→full-auto 자동 수정" >&2
+  fi
+fi
+
 build_codex_base() {
   # codex exec는 항상 non-TTY subprocess에서 실행되므로 --dangerously-bypass 필수.
   # --dangerously-bypass는 config.toml의 approval_mode/sandbox와 충돌하지 않음

package/skills/tfx-deep-interview/SKILL.md

@@ -60,7 +60,7 @@ Claude 토큰을 절약하기 위해 분석 작업은 Gemini CLI에 위임합니
 **단계 진입 시 Gemini 위임:**
 
 ```
-Bash("bash scripts/tfx-route.sh gemini exec 'Deep interview Stage 1: Clarify. Topic: {topic}. Previous answers: none. Generate 3 probing questions for this stage and analyze prior responses. Return JSON: {analysis, questions, key_insights}'")
+Bash("bash ~/.claude/scripts/tfx-route.sh gemini exec 'Deep interview Stage 1: Clarify. Topic: {topic}. Previous answers: none. Generate 3 probing questions for this stage and analyze prior responses. Return JSON: {analysis, questions, key_insights}'")
 ```
 
 Gemini가 반환한 `questions` 배열을 AskUserQuestion으로 사용자에게 제시합니다.
@@ -80,7 +80,7 @@ Gemini가 반환한 `questions` 배열을 AskUserQuestion으로 사용자에게
 **단계 진입 시 Gemini 위임:**
 
 ```
-Bash("bash scripts/tfx-route.sh gemini exec 'Deep interview Stage 2: Decompose. Topic: {topic}. Previous answers: {stage1_answers}. Generate 3 probing questions for this stage and analyze prior responses. Return JSON: {analysis, questions, key_insights}'")
+Bash("bash ~/.claude/scripts/tfx-route.sh gemini exec 'Deep interview Stage 2: Decompose. Topic: {topic}. Previous answers: {stage1_answers}. Generate 3 probing questions for this stage and analyze prior responses. Return JSON: {analysis, questions, key_insights}'")
 ```
 
 Gemini가 반환한 `questions` 배열을 AskUserQuestion으로 사용자에게 제시합니다.
@@ -100,7 +100,7 @@ Gemini가 반환한 `questions` 배열을 AskUserQuestion으로 사용자에게
 **단계 진입 시 Gemini 위임:**
 
 ```
-Bash("bash scripts/tfx-route.sh gemini exec 'Deep interview Stage 3: Challenge. Topic: {topic}. Previous answers: {stage1_answers} {stage2_answers}. Generate 3 probing questions for this stage and analyze prior responses. Return JSON: {analysis, questions, key_insights}'")
+Bash("bash ~/.claude/scripts/tfx-route.sh gemini exec 'Deep interview Stage 3: Challenge. Topic: {topic}. Previous answers: {stage1_answers} {stage2_answers}. Generate 3 probing questions for this stage and analyze prior responses. Return JSON: {analysis, questions, key_insights}'")
 ```
 
 Gemini가 반환한 `questions` 배열을 AskUserQuestion으로 사용자에게 제시합니다.
@@ -120,7 +120,7 @@ Gemini가 반환한 `questions` 배열을 AskUserQuestion으로 사용자에게
 **단계 진입 시 Gemini 위임:**
 
 ```
-Bash("bash scripts/tfx-route.sh gemini exec 'Deep interview Stage 4: Alternatives. Topic: {topic}. Previous answers: {stage1_answers} {stage2_answers} {stage3_answers}. Generate 3 probing questions for this stage and analyze prior responses. Return JSON: {analysis, questions, key_insights}'")
+Bash("bash ~/.claude/scripts/tfx-route.sh gemini exec 'Deep interview Stage 4: Alternatives. Topic: {topic}. Previous answers: {stage1_answers} {stage2_answers} {stage3_answers}. Generate 3 probing questions for this stage and analyze prior responses. Return JSON: {analysis, questions, key_insights}'")
 ```
 
 Gemini가 반환한 `questions` 배열을 AskUserQuestion으로 사용자에게 제시합니다.
@@ -140,7 +140,7 @@ Gemini가 반환한 `questions` 배열을 AskUserQuestion으로 사용자에게
 **단계 진입 시 Gemini 위임:**
 
 ```
-Bash("bash scripts/tfx-route.sh gemini exec 'Deep interview Stage 5: Synthesize. Topic: {topic}. Previous answers: {stage1_answers} {stage2_answers} {stage3_answers} {stage4_answers}. Generate 3 probing questions for this stage and analyze prior responses. Return JSON: {analysis, questions, key_insights}'")
+Bash("bash ~/.claude/scripts/tfx-route.sh gemini exec 'Deep interview Stage 5: Synthesize. Topic: {topic}. Previous answers: {stage1_answers} {stage2_answers} {stage3_answers} {stage4_answers}. Generate 3 probing questions for this stage and analyze prior responses. Return JSON: {analysis, questions, key_insights}'")
 ```
 
 Gemini가 반환한 `questions` 배열을 AskUserQuestion으로 사용자에게 제시합니다.
@@ -158,7 +158,7 @@ Gemini가 반환한 `questions` 배열을 AskUserQuestion으로 사용자에게
 **산출물 생성 Gemini 위임:**
 
 ```
-Bash("bash scripts/tfx-route.sh gemini exec 'Deep interview complete. Topic: {topic}. All answers: {all_answers}. Generate a structured requirements document draft. Return the full markdown document.'")
+Bash("bash ~/.claude/scripts/tfx-route.sh gemini exec 'Deep interview complete. Topic: {topic}. All answers: {all_answers}. Generate a structured requirements document draft. Return the full markdown document.'")
 ```
 
 Gemini 실패 시 Claude가 직접 아래 형식으로 문서를 작성합니다.

package/skills/tfx-deep-interview/SKILL.md.tmpl

@@ -60,7 +60,7 @@ Claude 토큰을 절약하기 위해 분석 작업은 Gemini CLI에 위임합니
 **단계 진입 시 Gemini 위임:**
 
 ```
-Bash("bash scripts/tfx-route.sh gemini exec 'Deep interview Stage 1: Clarify. Topic: {topic}. Previous answers: none. Generate 3 probing questions for this stage and analyze prior responses. Return JSON: {analysis, questions, key_insights}'")
+Bash("bash ~/.claude/scripts/tfx-route.sh gemini exec 'Deep interview Stage 1: Clarify. Topic: {topic}. Previous answers: none. Generate 3 probing questions for this stage and analyze prior responses. Return JSON: {analysis, questions, key_insights}'")
 ```
 
 Gemini가 반환한 `questions` 배열을 AskUserQuestion으로 사용자에게 제시합니다.
@@ -80,7 +80,7 @@ Gemini가 반환한 `questions` 배열을 AskUserQuestion으로 사용자에게
 **단계 진입 시 Gemini 위임:**
 
 ```
-Bash("bash scripts/tfx-route.sh gemini exec 'Deep interview Stage 2: Decompose. Topic: {topic}. Previous answers: {stage1_answers}. Generate 3 probing questions for this stage and analyze prior responses. Return JSON: {analysis, questions, key_insights}'")
+Bash("bash ~/.claude/scripts/tfx-route.sh gemini exec 'Deep interview Stage 2: Decompose. Topic: {topic}. Previous answers: {stage1_answers}. Generate 3 probing questions for this stage and analyze prior responses. Return JSON: {analysis, questions, key_insights}'")
 ```
 
 Gemini가 반환한 `questions` 배열을 AskUserQuestion으로 사용자에게 제시합니다.
@@ -100,7 +100,7 @@ Gemini가 반환한 `questions` 배열을 AskUserQuestion으로 사용자에게
 **단계 진입 시 Gemini 위임:**
 
 ```
-Bash("bash scripts/tfx-route.sh gemini exec 'Deep interview Stage 3: Challenge. Topic: {topic}. Previous answers: {stage1_answers} {stage2_answers}. Generate 3 probing questions for this stage and analyze prior responses. Return JSON: {analysis, questions, key_insights}'")
+Bash("bash ~/.claude/scripts/tfx-route.sh gemini exec 'Deep interview Stage 3: Challenge. Topic: {topic}. Previous answers: {stage1_answers} {stage2_answers}. Generate 3 probing questions for this stage and analyze prior responses. Return JSON: {analysis, questions, key_insights}'")
 ```
 
 Gemini가 반환한 `questions` 배열을 AskUserQuestion으로 사용자에게 제시합니다.
@@ -120,7 +120,7 @@ Gemini가 반환한 `questions` 배열을 AskUserQuestion으로 사용자에게
 **단계 진입 시 Gemini 위임:**
 
 ```
-Bash("bash scripts/tfx-route.sh gemini exec 'Deep interview Stage 4: Alternatives. Topic: {topic}. Previous answers: {stage1_answers} {stage2_answers} {stage3_answers}. Generate 3 probing questions for this stage and analyze prior responses. Return JSON: {analysis, questions, key_insights}'")
+Bash("bash ~/.claude/scripts/tfx-route.sh gemini exec 'Deep interview Stage 4: Alternatives. Topic: {topic}. Previous answers: {stage1_answers} {stage2_answers} {stage3_answers}. Generate 3 probing questions for this stage and analyze prior responses. Return JSON: {analysis, questions, key_insights}'")
 ```
 
 Gemini가 반환한 `questions` 배열을 AskUserQuestion으로 사용자에게 제시합니다.
@@ -140,7 +140,7 @@ Gemini가 반환한 `questions` 배열을 AskUserQuestion으로 사용자에게
 **단계 진입 시 Gemini 위임:**
 
 ```
-Bash("bash scripts/tfx-route.sh gemini exec 'Deep interview Stage 5: Synthesize. Topic: {topic}. Previous answers: {stage1_answers} {stage2_answers} {stage3_answers} {stage4_answers}. Generate 3 probing questions for this stage and analyze prior responses. Return JSON: {analysis, questions, key_insights}'")
+Bash("bash ~/.claude/scripts/tfx-route.sh gemini exec 'Deep interview Stage 5: Synthesize. Topic: {topic}. Previous answers: {stage1_answers} {stage2_answers} {stage3_answers} {stage4_answers}. Generate 3 probing questions for this stage and analyze prior responses. Return JSON: {analysis, questions, key_insights}'")
 ```
 
 Gemini가 반환한 `questions` 배열을 AskUserQuestion으로 사용자에게 제시합니다.
@@ -158,7 +158,7 @@ Gemini가 반환한 `questions` 배열을 AskUserQuestion으로 사용자에게
 **산출물 생성 Gemini 위임:**
 
 ```
-Bash("bash scripts/tfx-route.sh gemini exec 'Deep interview complete. Topic: {topic}. All answers: {all_answers}. Generate a structured requirements document draft. Return the full markdown document.'")
+Bash("bash ~/.claude/scripts/tfx-route.sh gemini exec 'Deep interview complete. Topic: {topic}. All answers: {all_answers}. Generate a structured requirements document draft. Return the full markdown document.'")
 ```
 
 Gemini 실패 시 Claude가 직접 아래 형식으로 문서를 작성합니다.

package/skills/tfx-index/SKILL.md

@@ -63,7 +63,7 @@ AskUserQuestion:
 Claude는 프로젝트 경로와 모드를 Gemini에 전달하고, Gemini가 파일 트리 스캔·메타데이터 추출·인덱스 생성을 모두 수행한다.
 
 ```
-Bash("bash scripts/tfx-route.sh gemini exec 'Scan the project at {path}. For each source file, extract: exports, imports, line count, file type. Exclude node_modules/, .git/, dist/, build/, coverage/, *.lock, *.log, *.map. Generate both PROJECT_INDEX.md and PROJECT_INDEX.json following this format:
+Bash("bash ~/.claude/scripts/tfx-route.sh gemini exec 'Scan the project at {path}. For each source file, extract: exports, imports, line count, file type. Exclude node_modules/, .git/, dist/, build/, coverage/, *.lock, *.log, *.map. Generate both PROJECT_INDEX.md and PROJECT_INDEX.json following this format:
 
 PROJECT_INDEX.md:
 # PROJECT_INDEX.md

package/skills/tfx-index/SKILL.md.tmpl

@@ -53,7 +53,7 @@ AskUserQuestion:
 Claude는 프로젝트 경로와 모드를 Gemini에 전달하고, Gemini가 파일 트리 스캔·메타데이터 추출·인덱스 생성을 모두 수행한다.
 
 ```
-Bash("bash scripts/tfx-route.sh gemini exec 'Scan the project at {path}. For each source file, extract: exports, imports, line count, file type. Exclude node_modules/, .git/, dist/, build/, coverage/, *.lock, *.log, *.map. Generate both PROJECT_INDEX.md and PROJECT_INDEX.json following this format:
+Bash("bash ~/.claude/scripts/tfx-route.sh gemini exec 'Scan the project at {path}. For each source file, extract: exports, imports, line count, file type. Exclude node_modules/, .git/, dist/, build/, coverage/, *.lock, *.log, *.map. Generate both PROJECT_INDEX.md and PROJECT_INDEX.json following this format:
 
 PROJECT_INDEX.md:
 # PROJECT_INDEX.md

package/skills/tfx-interview/SKILL.md

@@ -21,7 +21,7 @@ argument-hint: "<구현할 주제 또는 요구사항>"
 > "측정할 수 없으면 개선할 수 없다."
 >
 > **Gemini 위임**: 분석·점수 계산·산출물 초안은 Gemini CLI에 위임하여 Claude 토큰을 절약한다.
-> 위임 패턴: `Bash("bash scripts/tfx-route.sh gemini exec '{prompt}'")`
+> 위임 패턴: `Bash("bash ~/.claude/scripts/tfx-route.sh gemini exec '{prompt}'")`
 
 ## 위임 패턴
 
@@ -34,7 +34,7 @@ Claude와 Gemini의 역할을 분리하여 토큰을 최적화한다.
 
 ```bash
 # 위임 호출 형태
-Bash("bash scripts/tfx-route.sh gemini exec '{prompt}'")
+Bash("bash ~/.claude/scripts/tfx-route.sh gemini exec '{prompt}'")
 ```
 
 Gemini 실패 시 Fallback: Claude Opus가 분석을 직접 처리한다.
@@ -76,7 +76,7 @@ ambiguity = 1 - (goal × 0.40 + constraints × 0.30 + criteria × 0.30)
 
 ```bash
 # Claude → Gemini 위임
-Bash("bash scripts/tfx-route.sh gemini exec 'Analyze the following requirement and calculate ambiguity score. Return JSON: {goal, constraints, criteria, ambiguity, suggested_questions}: {user_input}'")
+Bash("bash ~/.claude/scripts/tfx-route.sh gemini exec 'Analyze the following requirement and calculate ambiguity score. Return JSON: {goal, constraints, criteria, ambiguity, suggested_questions}: {user_input}'")
 ```
 
 Gemini가 반환한 JSON에서 점수를 읽어 사용자에게 표시한다:
@@ -107,7 +107,7 @@ Gemini가 반환한 JSON에서 점수를 읽어 사용자에게 표시한다:
 
 ```bash
 # 응답 수집 후 Gemini에 분석 위임
-Bash("bash scripts/tfx-route.sh gemini exec 'Stage 1 response analysis. Previous context: {context}. User answer: {answer}. Calculate updated ambiguity score and generate next stage questions. Return JSON.'")
+Bash("bash ~/.claude/scripts/tfx-route.sh gemini exec 'Stage 1 response analysis. Previous context: {context}. User answer: {answer}. Calculate updated ambiguity score and generate next stage questions. Return JSON.'")
 ```
 
 ```
@@ -125,7 +125,7 @@ Bash("bash scripts/tfx-route.sh gemini exec 'Stage 1 response analysis. Previous
 
 ```bash
 # 응답 수집 후 Gemini에 분석 위임
-Bash("bash scripts/tfx-route.sh gemini exec 'Stage 2 response analysis. Previous context: {context}. User answer: {answer}. Calculate updated ambiguity score and generate next stage questions. Return JSON.'")
+Bash("bash ~/.claude/scripts/tfx-route.sh gemini exec 'Stage 2 response analysis. Previous context: {context}. User answer: {answer}. Calculate updated ambiguity score and generate next stage questions. Return JSON.'")
 ```
 
 ```
@@ -143,7 +143,7 @@ Bash("bash scripts/tfx-route.sh gemini exec 'Stage 2 response analysis. Previous
 
 ```bash
 # 응답 수집 후 Gemini에 분석 위임
-Bash("bash scripts/tfx-route.sh gemini exec 'Stage 3 response analysis. Previous context: {context}. User answer: {answer}. Calculate updated ambiguity score and generate next stage questions. Return JSON.'")
+Bash("bash ~/.claude/scripts/tfx-route.sh gemini exec 'Stage 3 response analysis. Previous context: {context}. User answer: {answer}. Calculate updated ambiguity score and generate next stage questions. Return JSON.'")
 ```
 
 ```
@@ -161,7 +161,7 @@ Bash("bash scripts/tfx-route.sh gemini exec 'Stage 3 response analysis. Previous
 
 ```bash
 # 응답 수집 후 Gemini에 분석 위임
-Bash("bash scripts/tfx-route.sh gemini exec 'Stage 4 response analysis. Previous context: {context}. User answer: {answer}. Calculate updated ambiguity score and generate next stage questions. Return JSON.'")
+Bash("bash ~/.claude/scripts/tfx-route.sh gemini exec 'Stage 4 response analysis. Previous context: {context}. User answer: {answer}. Calculate updated ambiguity score and generate next stage questions. Return JSON.'")
 ```
 
 ```
@@ -179,7 +179,7 @@ Bash("bash scripts/tfx-route.sh gemini exec 'Stage 4 response analysis. Previous
 
 ```bash
 # 응답 수집 후 Gemini에 최종 분석 위임
-Bash("bash scripts/tfx-route.sh gemini exec 'Stage 5 response analysis. Previous context: {context}. User answer: {answer}. Calculate updated ambiguity score and generate next stage questions. Return JSON.'")
+Bash("bash ~/.claude/scripts/tfx-route.sh gemini exec 'Stage 5 response analysis. Previous context: {context}. User answer: {answer}. Calculate updated ambiguity score and generate next stage questions. Return JSON.'")
 ```
 
 ```
@@ -207,7 +207,7 @@ Gemini가 인터뷰 전체 컨텍스트를 바탕으로 구조화된 문서 초
 
 ```bash
 # Gemini에 산출물 초안 생성 위임
-Bash("bash scripts/tfx-route.sh gemini exec 'Generate a structured interview output document based on the following interview context: {full_context}. Return the complete markdown document.'")
+Bash("bash ~/.claude/scripts/tfx-route.sh gemini exec 'Generate a structured interview output document based on the following interview context: {full_context}. Return the complete markdown document.'")
 ```
 
 Claude는 Gemini가 반환한 마크다운을 Write 도구로 저장한다.

package/skills/tfx-interview/SKILL.md.tmpl

@@ -21,7 +21,7 @@ argument-hint: "<구현할 주제 또는 요구사항>"
 > "측정할 수 없으면 개선할 수 없다."
 >
 > **Gemini 위임**: 분석·점수 계산·산출물 초안은 Gemini CLI에 위임하여 Claude 토큰을 절약한다.
-> 위임 패턴: `Bash("bash scripts/tfx-route.sh gemini exec '{prompt}'")`
+> 위임 패턴: `Bash("bash ~/.claude/scripts/tfx-route.sh gemini exec '{prompt}'")`
 
 ## 위임 패턴
 
@@ -34,7 +34,7 @@ Claude와 Gemini의 역할을 분리하여 토큰을 최적화한다.
 
 ```bash
 # 위임 호출 형태
-Bash("bash scripts/tfx-route.sh gemini exec '{prompt}'")
+Bash("bash ~/.claude/scripts/tfx-route.sh gemini exec '{prompt}'")
 ```
 
 Gemini 실패 시 Fallback: Claude Opus가 분석을 직접 처리한다.
@@ -76,7 +76,7 @@ ambiguity = 1 - (goal × 0.40 + constraints × 0.30 + criteria × 0.30)
 
 ```bash
 # Claude → Gemini 위임
-Bash("bash scripts/tfx-route.sh gemini exec 'Analyze the following requirement and calculate ambiguity score. Return JSON: {goal, constraints, criteria, ambiguity, suggested_questions}: {user_input}'")
+Bash("bash ~/.claude/scripts/tfx-route.sh gemini exec 'Analyze the following requirement and calculate ambiguity score. Return JSON: {goal, constraints, criteria, ambiguity, suggested_questions}: {user_input}'")
 ```
 
 Gemini가 반환한 JSON에서 점수를 읽어 사용자에게 표시한다:
@@ -107,7 +107,7 @@ Gemini가 반환한 JSON에서 점수를 읽어 사용자에게 표시한다:
 
 ```bash
 # 응답 수집 후 Gemini에 분석 위임
-Bash("bash scripts/tfx-route.sh gemini exec 'Stage 1 response analysis. Previous context: {context}. User answer: {answer}. Calculate updated ambiguity score and generate next stage questions. Return JSON.'")
+Bash("bash ~/.claude/scripts/tfx-route.sh gemini exec 'Stage 1 response analysis. Previous context: {context}. User answer: {answer}. Calculate updated ambiguity score and generate next stage questions. Return JSON.'")
 ```
 
 ```
@@ -125,7 +125,7 @@ Bash("bash scripts/tfx-route.sh gemini exec 'Stage 1 response analysis. Previous
 
 ```bash
 # 응답 수집 후 Gemini에 분석 위임
-Bash("bash scripts/tfx-route.sh gemini exec 'Stage 2 response analysis. Previous context: {context}. User answer: {answer}. Calculate updated ambiguity score and generate next stage questions. Return JSON.'")
+Bash("bash ~/.claude/scripts/tfx-route.sh gemini exec 'Stage 2 response analysis. Previous context: {context}. User answer: {answer}. Calculate updated ambiguity score and generate next stage questions. Return JSON.'")
 ```
 
 ```
@@ -143,7 +143,7 @@ Bash("bash scripts/tfx-route.sh gemini exec 'Stage 2 response analysis. Previous
 
 ```bash
 # 응답 수집 후 Gemini에 분석 위임
-Bash("bash scripts/tfx-route.sh gemini exec 'Stage 3 response analysis. Previous context: {context}. User answer: {answer}. Calculate updated ambiguity score and generate next stage questions. Return JSON.'")
+Bash("bash ~/.claude/scripts/tfx-route.sh gemini exec 'Stage 3 response analysis. Previous context: {context}. User answer: {answer}. Calculate updated ambiguity score and generate next stage questions. Return JSON.'")
 ```
 
 ```
@@ -161,7 +161,7 @@ Bash("bash scripts/tfx-route.sh gemini exec 'Stage 3 response analysis. Previous
 
 ```bash
 # 응답 수집 후 Gemini에 분석 위임
-Bash("bash scripts/tfx-route.sh gemini exec 'Stage 4 response analysis. Previous context: {context}. User answer: {answer}. Calculate updated ambiguity score and generate next stage questions. Return JSON.'")
+Bash("bash ~/.claude/scripts/tfx-route.sh gemini exec 'Stage 4 response analysis. Previous context: {context}. User answer: {answer}. Calculate updated ambiguity score and generate next stage questions. Return JSON.'")
 ```
 
 ```
@@ -179,7 +179,7 @@ Bash("bash scripts/tfx-route.sh gemini exec 'Stage 4 response analysis. Previous
 
 ```bash
 # 응답 수집 후 Gemini에 최종 분석 위임
-Bash("bash scripts/tfx-route.sh gemini exec 'Stage 5 response analysis. Previous context: {context}. User answer: {answer}. Calculate updated ambiguity score and generate next stage questions. Return JSON.'")
+Bash("bash ~/.claude/scripts/tfx-route.sh gemini exec 'Stage 5 response analysis. Previous context: {context}. User answer: {answer}. Calculate updated ambiguity score and generate next stage questions. Return JSON.'")
 ```
 
 ```
@@ -207,7 +207,7 @@ Gemini가 인터뷰 전체 컨텍스트를 바탕으로 구조화된 문서 초
 
 ```bash
 # Gemini에 산출물 초안 생성 위임
-Bash("bash scripts/tfx-route.sh gemini exec 'Generate a structured interview output document based on the following interview context: {full_context}. Return the complete markdown document.'")
+Bash("bash ~/.claude/scripts/tfx-route.sh gemini exec 'Generate a structured interview output document based on the following interview context: {full_context}. Return the complete markdown document.'")
 ```
 
 Claude는 Gemini가 반환한 마크다운을 Write 도구로 저장한다.

package/skills/tfx-plan/SKILL.md

@@ -41,7 +41,7 @@ Claude는 최소 컨텍스트만 수집한다.
 
 수집 후 Gemini에 위임:
 ```
-Bash("bash scripts/tfx-route.sh gemini exec '소프트웨어 아키텍트로서 다음 기능의 구현 계획을 수립하라.\n기능: {feature}\n프로젝트 컨텍스트: {context}\n관련 파일: {file_list}\n\n출력 형식:\n1. 영향 범위 (수정할 파일 목록)\n2. 태스크 분해 (순서대로, 각 태스크에 검증 방법 포함)\n3. 리스크 및 의존성\n4. 예상 복잡도 (low/medium/high)'")
+Bash("bash ~/.claude/scripts/tfx-route.sh gemini exec '소프트웨어 아키텍트로서 다음 기능의 구현 계획을 수립하라.\n기능: {feature}\n프로젝트 컨텍스트: {context}\n관련 파일: {file_list}\n\n출력 형식:\n1. 영향 범위 (수정할 파일 목록)\n2. 태스크 분해 (순서대로, 각 태스크에 검증 방법 포함)\n3. 리스크 및 의존성\n4. 예상 복잡도 (low/medium/high)'")
 ```
 
 Claude는 Gemini 출력을 받아 아래 출력 형식으로 포맷팅만 수행한다.

package/skills/tfx-plan/SKILL.md.tmpl

@@ -31,7 +31,7 @@ Claude는 최소 컨텍스트만 수집한다.
 
 수집 후 Gemini에 위임:
 ```
-Bash("bash scripts/tfx-route.sh gemini exec '소프트웨어 아키텍트로서 다음 기능의 구현 계획을 수립하라.\n기능: {feature}\n프로젝트 컨텍스트: {context}\n관련 파일: {file_list}\n\n출력 형식:\n1. 영향 범위 (수정할 파일 목록)\n2. 태스크 분해 (순서대로, 각 태스크에 검증 방법 포함)\n3. 리스크 및 의존성\n4. 예상 복잡도 (low/medium/high)'")
+Bash("bash ~/.claude/scripts/tfx-route.sh gemini exec '소프트웨어 아키텍트로서 다음 기능의 구현 계획을 수립하라.\n기능: {feature}\n프로젝트 컨텍스트: {context}\n관련 파일: {file_list}\n\n출력 형식:\n1. 영향 범위 (수정할 파일 목록)\n2. 태스크 분해 (순서대로, 각 태스크에 검증 방법 포함)\n3. 리스크 및 의존성\n4. 예상 복잡도 (low/medium/high)'")
 ```
 
 Claude는 Gemini 출력을 받아 아래 출력 형식으로 포맷팅만 수행한다.

package/skills/tfx-research/SKILL.md

@@ -71,7 +71,7 @@ AskUserQuestion:
 최적화된 쿼리를 Gemini CLI로 전달한다. Gemini는 네이티브 Google Search를 사용해 검색과 요약을 모두 수행한다:
 
 ```
-Bash("bash scripts/tfx-route.sh gemini 'Research the following topic. Use Google Search to find current information. Return a structured markdown summary with sources: {optimized_query}' auto 120")
+Bash("bash ~/.claude/scripts/tfx-route.sh gemini 'Research the following topic. Use Google Search to find current information. Return a structured markdown summary with sources: {optimized_query}' auto 120")
 ```
 
 Gemini가 반환하는 결과에는 검색 결과, 출처 URL, 핵심 요약이 포함된다. Claude는 이 단계에서 토큰을 소비하지 않는다.

package/skills/tfx-research/SKILL.md.tmpl

@@ -61,7 +61,7 @@ AskUserQuestion:
 최적화된 쿼리를 Gemini CLI로 전달한다. Gemini는 네이티브 Google Search를 사용해 검색과 요약을 모두 수행한다:
 
 ```
-Bash("bash scripts/tfx-route.sh gemini 'Research the following topic. Use Google Search to find current information. Return a structured markdown summary with sources: {optimized_query}' auto 120")
+Bash("bash ~/.claude/scripts/tfx-route.sh gemini 'Research the following topic. Use Google Search to find current information. Return a structured markdown summary with sources: {optimized_query}' auto 120")
 ```
 
 Gemini가 반환하는 결과에는 검색 결과, 출처 URL, 핵심 요약이 포함된다. Claude는 이 단계에서 토큰을 소비하지 않는다.