triflux 9.2.1 → 9.2.2

package/bin/triflux.mjs

@@ -20,7 +20,7 @@ const CODEX_CONFIG_PATH = join(CODEX_DIR, "config.toml");
 const PKG = JSON.parse(readFileSync(join(PKG_ROOT, "package.json"), "utf8"));
 
 // 이 배열에 포함된 버전에서만 star prompt를 표시한다 (빈 배열 = 모든 버전에서 표시)
-const STAR_PROMPT_VERSIONS = ["9.2.1"];
+const STAR_PROMPT_VERSIONS = [];
 
 const REQUIRED_CODEX_PROFILES = [
   {
@@ -825,7 +825,7 @@ function buildSetupDryRunPlan() {
 }
 
 function cmdSetup(options = {}) {
-  const { dryRun = false, fromUpdate = false } = options;
+  const { dryRun = false } = options;
   if (dryRun) {
     printJson(buildSetupDryRunPlan());
     return;
@@ -979,7 +979,7 @@ function cmdSetup(options = {}) {
   }
 
   // Star request (버전 게이팅)
-  const showStar = !fromUpdate && (STAR_PROMPT_VERSIONS.length === 0 || STAR_PROMPT_VERSIONS.includes(PKG.version));
+  const showStar = STAR_PROMPT_VERSIONS.length === 0 || STAR_PROMPT_VERSIONS.includes(PKG.version);
   if (showStar) {
     try {
       execFileSync("gh", ["auth", "status"], { timeout: 5000, stdio: ["pipe", "pipe", "pipe"] });

package/hooks/agent-route-guard.mjs

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+// PreToolUse:Agent hook — triflux 프로젝트 기본 에이전트 라우팅
+// 특정 시스템을 차단하지 않고, triflux의 의도를 context로 주입
+
+console.log(
+  "triflux 프로젝트 기본: Agent spawn 시 subagent_type='general-purpose'를 사용하세요. " +
+  "프로젝트 스킬(tfx-*)이 활성 상태이면 스킬 MD의 라우팅 지시를 우선합니다."
+);

package/hooks/hooks.json

@@ -40,6 +40,18 @@
         ]
       }
     ],
+    "PreToolUse": [
+      {
+        "matcher": "Agent",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/agent-route-guard.mjs\"",
+            "timeout": 3
+          }
+        ]
+      }
+    ],
     "Stop": [
       {
         "matcher": "*",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "triflux",
-  "version": "9.2.1",
+  "version": "9.2.2",
   "description": "CLI-first multi-model orchestrator for Claude Code — route tasks to Codex, Gemini, and Claude",
   "type": "module",
   "bin": {

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

@@ -25,6 +25,24 @@ argument-hint: "<topic>"
 /딥인터뷰 데이터 파이프라인 설계
 ```
 
+## 위임 패턴
+
+Claude 토큰을 절약하기 위해 분석 작업은 Gemini CLI에 위임합니다.
+
+- **Claude 담당**: AskUserQuestion (사용자 상호작용), 산출물 저장
+- **Gemini 담당**: 질문 생성, 응답 분석, 종합 문서 초안 작성
+
+각 단계에서 Claude는 누적 컨텍스트를 Gemini에 전달하고, Gemini가 반환한 질문을 AskUserQuestion으로 사용자에게 제시합니다. 사용자 답변은 다음 단계 Gemini 호출의 입력으로 전달됩니다.
+
+**Fallback**: Gemini 호출이 실패하면 Claude Opus가 모든 분석을 직접 수행합니다 (원래 동작 유지).
+
+## 토큰 예산
+
+| 담당 | 토큰 | 역할 |
+|------|------|------|
+| Claude | ~2K | 오케스트레이션 + AskUserQuestion만 |
+| Gemini | ~10K | 분석 + 질문 생성 + 문서 초안 |
+
 ## 5단계 인터뷰 프로세스
 
 인터뷰는 반드시 아래 5단계를 순서대로 진행합니다. 각 단계에서 사용자 응답을 수집한 후 다음 단계로 이동합니다.
@@ -35,7 +53,15 @@ argument-hint: "<topic>"
 
 목표를 한 문장으로 정의하고, 성공 기준과 현재 상태의 차이를 파악합니다.
 
-**질문 템플릿:**
+**단계 진입 시 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}'")
+```
+
+Gemini가 반환한 `questions` 배열을 AskUserQuestion으로 사용자에게 제시합니다.
+
+**질문 템플릿 (Gemini 실패 시 Fallback):**
 
 1. "이 작업의 핵심 목표를 한 문장으로 설명해주세요."
 2. "완료 후 어떤 상태가 되어야 성공인가요?"
@@ -47,7 +73,15 @@ argument-hint: "<topic>"
 
 대상을 3-5개의 독립적 하위 문제로 분해하고, 의존성과 우선순위를 결정합니다.
 
-**질문 템플릿:**
+**단계 진입 시 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}'")
+```
+
+Gemini가 반환한 `questions` 배열을 AskUserQuestion으로 사용자에게 제시합니다.
+
+**질문 템플릿 (Gemini 실패 시 Fallback):**
 
 1. "이 작업을 3-5개의 독립된 단계로 나눈다면?"
 2. "각 단계 사이에 의존성이 있나요?"
@@ -59,7 +93,15 @@ argument-hint: "<topic>"
 
 선택한 접근 방식의 단점을 식별하고, 실패 시나리오와 기술 부채 가능성을 탐색합니다.
 
-**질문 템플릿:**
+**단계 진입 시 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}'")
+```
+
+Gemini가 반환한 `questions` 배열을 AskUserQuestion으로 사용자에게 제시합니다.
+
+**질문 템플릿 (Gemini 실패 시 Fallback):**
 
 1. "이 방식이 실패할 수 있는 시나리오는?"
 2. "6개월 후 이 코드를 유지보수할 때 문제가 될 부분은?"
@@ -71,7 +113,15 @@ argument-hint: "<topic>"
 
 최소 2개의 대안을 검토하고, 각 대안의 trade-off를 비교합니다.
 
-**질문 템플릿:**
+**단계 진입 시 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}'")
+```
+
+Gemini가 반환한 `questions` 배열을 AskUserQuestion으로 사용자에게 제시합니다.
+
+**질문 템플릿 (Gemini 실패 시 Fallback):**
 
 1. "같은 목표를 달성할 수 있는 완전히 다른 접근은?"
 2. "시간이 절반밖에 없다면 어떤 방식을 택하겠습니까?"
@@ -83,7 +133,15 @@ argument-hint: "<topic>"
 
 인터뷰 결과를 종합하여 실행 계획을 도출하고, 구조화된 요구사항 문서를 생성합니다.
 
-**질문 템플릿:**
+**단계 진입 시 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}'")
+```
+
+Gemini가 반환한 `questions` 배열을 AskUserQuestion으로 사용자에게 제시합니다.
+
+**질문 템플릿 (Gemini 실패 시 Fallback):**
 
 1. "지금까지의 논의를 종합하면, 최적의 접근 방식은?"
 2. "첫 번째 단계로 무엇을 실행하시겠습니까?"
@@ -91,7 +149,15 @@ argument-hint: "<topic>"
 
 ## 산출물
 
-인터뷰 완료 후 `.tfx/plans/interview-{timestamp}.md` 경로에 구조화된 요구사항 문서를 생성합니다.
+인터뷰 완료 후 Gemini가 전체 인터뷰 문서 초안을 생성하고, Claude가 Write 툴로 `.tfx/plans/interview-{timestamp}.md`에 저장합니다.
+
+**산출물 생성 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.'")
+```
+
+Gemini 실패 시 Claude가 직접 아래 형식으로 문서를 작성합니다.
 
 ### 산출물 형식
 

package/skills/tfx-index/SKILL.md

@@ -13,6 +13,8 @@ argument-hint: "[--update] [경로]"
 
 > SuperClaude index-repo 오마주. 1회 2K 토큰으로 인덱스 생성, 이후 세션마다 55K 토큰 절감.
 
+> **Gemini 위임**: 스캔 + 인덱스 생성 작업은 Gemini CLI에 위임한다. Claude는 모드 선택(Step 0)과 파일 쓰기만 담당. Claude 토큰 소비 ~500 tokens으로 줄어든다.
+
 ## 원리
 
 매 세션마다 프로젝트 구조를 파악하려면 수십 개 파일을 읽어야 한다 (~58K tokens).
@@ -40,102 +42,65 @@ AskUserQuestion:
 
 `--update` 플래그나 경로 인자가 이미 제공된 경우 이 단계를 건너뛴다.
 
-### Step 1: 파일 트리 스캔
-
-```
-병렬 Glob으로 전체 파일 트리 수집:
-  - **/*.{ts,js,mjs,tsx,jsx,py,go,rs,java} (소스)
-  - **/*.{md,json,yaml,toml} (설정/문서)
-  - **/package.json, **/tsconfig.json (프로젝트 메타)
-
-제외:
-  - node_modules/, .git/, dist/, build/, coverage/
-  - *.lock, *.log, *.map
-```
-
-### Step 2: 메타데이터 추출 (병렬)
-
-각 소스 파일에서 핵심 메타데이터만 추출 (전체 읽기 금지):
+### Step 1: Gemini에 스캔 + 인덱스 생성 위임
 
-```
-파일당 추출 항목:
-  - exports (함수, 클래스, 상수 이름)
-  - imports (의존성)
-  - 파일 크기 (라인 수)
-  - 주요 패턴 (테스트? 설정? 컴포넌트? 유틸?)
+Claude는 프로젝트 경로와 모드를 Gemini에 전달하고, Gemini가 파일 트리 스캔·메타데이터 추출·인덱스 생성을 모두 수행한다.
 
-추출 방법:
-  - Grep으로 export/import 문 추출 (파일당 ~20줄만)
-  - 전체 파일을 읽지 않음 → 토큰 절약
 ```
+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:
 
-### Step 3: 인덱스 생성
-
-```markdown
+PROJECT_INDEX.md:
 # PROJECT_INDEX.md
 Generated: {date} | Files: {count} | Lines: {total_lines}
-
 ## Architecture
-{1-2줄 아키텍처 요약}
-
+{1-2 line summary}
 ## Directory Map
-```
-src/
-  ├─ hub/          # MCP 메시지 버스 (bridge, router, pipe)
-  │   ├─ team/     # 멀티-CLI 팀 모드 (headless, psmux, native)
-  │   └─ pipeline/ # 상태 관리 (state, transitions, gates)
-  ├─ skills/       # 스킬 정의 (tfx-*, SKILL.md)
-  └─ bin/          # CLI 진입점
-```
-
+{tree with inline comments}
 ## Key Files
 | File | Lines | Exports | Role |
-|------|-------|---------|------|
-| hub/bridge.mjs | 850 | BridgeServer, createBridge | MCP 프로토콜 브릿지 |
-| hub/router.mjs | 720 | Router, routeRequest | 요청/응답 라우팅 |
-| ... | ... | ... | ... |
-
 ## Dependencies
 | Package | Version | Purpose |
-|---------|---------|---------|
-| express | 4.x | HTTP 서버 |
-| ... | ... | ... |
-
 ## Entry Points
-- `bin/tfx` → CLI 메인
-- `hub/bridge.mjs` → MCP 서버
-- `skills/*/SKILL.md` → 스킬 정의
-```
-
-### Step 4: JSON 인덱스 (기계용)
+- {entry}: {role}
 
-```json
-// PROJECT_INDEX.json (~10KB)
+PROJECT_INDEX.json:
 {
-  "generated": "2026-03-29",
-  "stats": { "files": 45, "lines": 12500 },
-  "files": {
-    "hub/bridge.mjs": {
-      "lines": 850,
-      "exports": ["BridgeServer", "createBridge"],
-      "imports": ["express", "./router"],
-      "type": "server"
-    }
-  },
-  "graph": {
-    "hub/bridge.mjs": ["hub/router.mjs", "hub/pipe.mjs"],
-    "hub/router.mjs": ["hub/intent.mjs"]
-  }
+  "generated": "{date}",
+  "stats": { "files": N, "lines": N },
+  "files": { "{path}": { "lines": N, "exports": [], "imports": [], "type": "" } },
+  "graph": { "{path}": ["{dep}", ...] }
 }
+
+Return the full content of both files separated by the delimiter: ===PROJECT_INDEX_JSON_START===
+Mode: {mode}
+'")
+```
+
+Gemini 출력을 받은 후 Claude가 파일로 기록한다:
+
+```
+Write("PROJECT_INDEX.md", <md_section>)
+Write("PROJECT_INDEX.json", <json_section>)
+```
+
+#### Fallback: Gemini 실패 시
+
+Gemini 위임이 실패하거나 `tfx-route.sh`가 없는 경우, Claude가 직접 원래 워크플로우로 폴백한다:
+
+```
+1. 병렬 Glob으로 파일 트리 수집 (**/*.{ts,js,mjs,tsx,jsx,...})
+2. Grep으로 export/import 문 추출 (파일당 ~20줄)
+3. PROJECT_INDEX.md + PROJECT_INDEX.json 직접 생성
 ```
 
-### Step 5: 검증
+### Step 2: 검증 (Claude 담당)
 
 ```
-생성된 인덱스 검증:
-  - 파일 수 일치 확인
+생성된 인덱스 빠른 검증:
+  - 파일 수 일치 확인 (stats.files vs 실제)
   - 주요 진입점 포함 확인
   - 인덱스 크기 < 5KB 확인
+  - PROJECT_INDEX.json 파싱 가능 여부 확인
 ```
 
 ## --update 모드
@@ -158,12 +123,15 @@ src/
 
 ## 토큰 예산
 
-| 작업 | 토큰 |
-|------|------|
-| 스캔+추출 | ~1.5K |
-| 인덱스 생성 | ~0.5K |
-| **총합** | **~2K** |
-| **세션당 절감** | **~55K** |
+| 작업 | Claude | Gemini |
+|------|--------|--------|
+| 모드 선택 (Step 0) | ~100 | — |
+| 스캔 + 메타데이터 추출 | — | Gemini 부담 |
+| 인덱스 생성 (MD + JSON) | — | Gemini 부담 |
+| 파일 쓰기 (Write) | ~300 | — |
+| 검증 (Step 2) | ~100 | — |
+| **Claude 총합** | **~500** | — |
+| **세션당 절감** | **~55K** | — |
 
 ## 사용 예
 

package/skills/tfx-interview/SKILL.md

@@ -14,6 +14,25 @@ argument-hint: "<구현할 주제 또는 요구사항>"
 
 > OMC deep-interview + ouroboros 오마주. 모호성을 숫자로 측정하고 20% 미만까지 질문한다.
 > "측정할 수 없으면 개선할 수 없다."
+>
+> **Gemini 위임**: 분석·점수 계산·산출물 초안은 Gemini CLI에 위임하여 Claude 토큰을 절약한다.
+> 위임 패턴: `Bash("bash scripts/tfx-route.sh gemini exec '{prompt}'")`
+
+## 위임 패턴
+
+Claude와 Gemini의 역할을 분리하여 토큰을 최적화한다.
+
+| 담당 | 작업 |
+|------|------|
+| **Claude** | AskUserQuestion (사용자 상호작용), 최종 파일 저장 |
+| **Gemini** | 모호성 점수 계산, 질문 생성, 응답 분석, 산출물 초안 |
+
+```bash
+# 위임 호출 형태
+Bash("bash scripts/tfx-route.sh gemini exec '{prompt}'")
+```
+
+Gemini 실패 시 Fallback: Claude Opus가 분석을 직접 처리한다.
 
 ## 용도
 
@@ -48,15 +67,17 @@ ambiguity = 1 - (goal × 0.40 + constraints × 0.30 + criteria × 0.30)
 
 ### Step 1: 초기 모호성 평가
 
-사용자 입력을 분석하여 초기 ambiguity score를 계산한다:
+사용자 입력을 Gemini에 전달하여 초기 ambiguity score를 계산한다:
 
+```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}'")
 ```
-입력 분석:
-  1. goal, constraints, criteria 각 요소의 현재 명확도 평가
-  2. ambiguity score 계산
-  3. 가장 불명확한 요소 식별 → 해당 단계부터 질문 시작
 
-출력:
+Gemini가 반환한 JSON에서 점수를 읽어 사용자에게 표시한다:
+
+```
+출력 예시:
   "📊 현재 모호성: 71%
    - 목표: 50% 명확 (어떤 인증 방식?)
    - 제약: 20% 명확 (기술 스택 미정)
@@ -66,7 +87,9 @@ ambiguity = 1 - (goal × 0.40 + constraints × 0.30 + criteria × 0.30)
 
 ### Step 2: 5단계 인터뷰 (모호성 < 20%까지)
 
-각 단계에서 AskUserQuestion으로 질문하고, 응답 후 ambiguity score를 재계산한다.
+각 단계에서 Claude가 AskUserQuestion으로 질문하고, 사용자 응답을 Gemini에 전달하여 분석 및 다음 질문을 생성한다.
+
+흐름: `Claude(질문) → 사용자(응답) → Gemini(분석+재계산) → Claude(다음 질문 제시)`
 
 #### Stage 1: Clarify (명확화) — goal 개선
 
@@ -75,8 +98,15 @@ ambiguity = 1 - (goal × 0.40 + constraints × 0.30 + criteria × 0.30)
   - "정확히 무엇을 달성하려는가?"
   - "이 작업의 범위는 어디까지인가?"
   - "완료 후 어떤 상태가 되어야 하는가?"
+```
 
-응답 후: goal 점수 재평가 → ambiguity 재계산
+```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.'")
+```
+
+```
+응답 후: Gemini JSON에서 goal 점수 읽기 → ambiguity 재계산 결과 사용자에게 표시
 ```
 
 #### Stage 2: Decompose (분해) — constraints 개선
@@ -86,8 +116,15 @@ ambiguity = 1 - (goal × 0.40 + constraints × 0.30 + criteria × 0.30)
   - "이것을 어떤 하위 문제로 나눌 수 있는가?"
   - "기술적 제약 조건은? (스택, 호환성, 성능)"
   - "의존하는 외부 시스템이나 API는?"
+```
 
-응답 후: constraints 점수 재평가 → ambiguity 재계산
+```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.'")
+```
+
+```
+응답 후: Gemini JSON에서 constraints 점수 읽기 → ambiguity 재계산 결과 사용자에게 표시
 ```
 
 #### Stage 3: Challenge (반론) — 숨은 제약 발견
@@ -97,8 +134,15 @@ ambiguity = 1 - (goal × 0.40 + constraints × 0.30 + criteria × 0.30)
   - "이 접근의 약점은?"
   - "실패할 수 있는 시나리오는?"
   - "6개월 후 유지보수 관점에서 문제될 부분은?"
+```
+
+```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.'")
+```
 
-응답 후: constraints + criteria 재평가 → ambiguity 재계산
+```
+응답 후: Gemini JSON에서 constraints + criteria 점수 읽기 → ambiguity 재계산 결과 사용자에게 표시
 ```
 
 #### Stage 4: Alternatives (대안) — criteria 정밀화
@@ -108,8 +152,15 @@ ambiguity = 1 - (goal × 0.40 + constraints × 0.30 + criteria × 0.30)
   - "다른 방법은 없는가?"
   - "시간이 절반이라면 어떤 방식을 택하겠는가?"
   - "각 대안의 trade-off는?"
+```
+
+```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.'")
+```
 
-응답 후: criteria 점수 재평가 → ambiguity 재계산
+```
+응답 후: Gemini JSON에서 criteria 점수 읽기 → ambiguity 재계산 결과 사용자에게 표시
 ```
 
 #### Stage 5: Synthesize (종합) — 최종 확인
@@ -119,8 +170,15 @@ ambiguity = 1 - (goal × 0.40 + constraints × 0.30 + criteria × 0.30)
   - "지금까지의 논의를 종합하면 최적 경로는?"
   - "첫 번째로 실행할 단계는?"
   - "이 결정에 대한 확신도는? (1-10)"
+```
 
-응답 후: 전체 재평가 → 최종 ambiguity score
+```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.'")
+```
+
+```
+응답 후: Gemini JSON에서 전체 점수 읽기 → 최종 ambiguity score 사용자에게 표시
 ```
 
 ### Step 3: 조기 종료 판단
@@ -140,7 +198,18 @@ ambiguity = 1 - (goal × 0.40 + constraints × 0.30 + criteria × 0.30)
 
 ### Step 4: 산출물 생성
 
-인터뷰 결과를 구조화된 문서로 저장한다:
+Gemini가 인터뷰 전체 컨텍스트를 바탕으로 구조화된 문서 초안을 생성하고, Claude가 파일로 저장한다:
+
+```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.'")
+```
+
+Claude는 Gemini가 반환한 마크다운을 Write 도구로 저장한다.
+
+저장 위치: `.omc/plans/interview-{timestamp}.md`
+
+산출물 형식:
 
 ```markdown
 # Interview: {topic}
@@ -179,8 +248,6 @@ Date: {date} | Final Ambiguity: {score}%
 3. ...
 ```
 
-저장 위치: `.omc/plans/interview-{timestamp}.md`
-
 ## 동작 규칙
 
 1. 각 단계에서 반드시 사용자 응답을 수집한 후 다음으로 이동한다.
@@ -192,13 +259,16 @@ Date: {date} | Final Ambiguity: {score}%
 
 ## 토큰 예산
 
-| 단계 | 토큰 |
-|------|------|
-| 초기 평가 | ~1K |
-| 5단계 인터뷰 (질문+분석) | ~10K |
-| 산출물 생성 | ~2K |
-| 코드베이스 탐색 | ~2K |
-| **총합** | **~15K** |
+| 단계 | Claude | Gemini |
+|------|--------|--------|
+| 초기 평가 (모호성 분석) | ~0.2K | ~1K |
+| 5단계 인터뷰 (질문 제시) | ~1K | ~10K |
+| 산출물 초안 생성 | — | ~2K |
+| 최종 파일 저장 | ~0.5K | — |
+| 코드베이스 탐색 | ~0.3K | — |
+| **총합** | **~2K** | **~13K** |
+
+Fallback: Gemini 호출 실패 시 Claude Opus가 분석을 직접 처리한다 (총합 ~15K).
 
 ## 사용 예
 

package/skills/tfx-plan/SKILL.md

@@ -12,26 +12,28 @@ argument-hint: "<구현할 기능 설명>"
 # tfx-plan — Light Implementation Plan
 
 > **Deep 버전**: tfx-deep-plan. "제대로/꼼꼼히" 수정자로 자동 에스컬레이션.
-> Claude Opus 단독 빠른 계획. 복잡한 합의 없이 즉시 태스크 분해.
+> Gemini 위임 빠른 계획 — Claude는 컨텍스트 수집·출력 포맷만, 핵심 계획 수립은 Gemini에 위임.
 
 ## 워크플로우
 
 ### Step 1: 요구사항 파싱
 사용자 입력 + 프로젝트 컨텍스트(PROJECT_INDEX.md 있으면 활용)에서 핵심 추출.
 
-### Step 2: Claude Opus 계획 수립
+### Step 2: Gemini 위임 계획 수립
+
+Claude는 최소 컨텍스트만 수집한다.
+- Glob으로 영향 가능 파일 목록 수집
+- PROJECT_INDEX.md 존재 시 읽기 (없으면 생략)
+
+수집 후 Gemini에 위임:
 ```
-"소프트웨어 아키텍트로서 다음 기능의 구현 계획을 수립하라:
- 기능: {feature}
- 프로젝트 컨텍스트: {context}
-
- 출력 형식:
- 1. 영향 범위 (수정할 파일 목록)
- 2. 태스크 분해 (순서대로, 각 태스크에 검증 방법 포함)
- 3. 리스크 및 의존성
- 4. 예상 복잡도 (low/medium/high)"
+Bash("bash scripts/tfx-route.sh gemini exec '소프트웨어 아키텍트로서 다음 기능의 구현 계획을 수립하라.\n기능: {feature}\n프로젝트 컨텍스트: {context}\n관련 파일: {file_list}\n\n출력 형식:\n1. 영향 범위 (수정할 파일 목록)\n2. 태스크 분해 (순서대로, 각 태스크에 검증 방법 포함)\n3. 리스크 및 의존성\n4. 예상 복잡도 (low/medium/high)'")
 ```
 
+Claude는 Gemini 출력을 받아 아래 출력 형식으로 포맷팅만 수행한다.
+
+> **Fallback**: Gemini 호출이 실패(exit non-zero 또는 빈 출력)하면 Claude Opus가 동일 프롬프트로 직접 계획을 수립한다.
+
 ### Step 3: 구조화된 계획 출력
 ```markdown
 ## 구현 계획: {feature}
@@ -51,4 +53,12 @@ argument-hint: "<구현할 기능 설명>"
 ### 복잡도: {level}
 ```
 
-## 토큰: ~8K
+## 토큰 절감
+
+| 구분 | 변경 전 | 변경 후 |
+|------|---------|---------|
+| Claude 입력 | ~6K (컨텍스트 + 계획 프롬프트) | ~1K (컨텍스트 수집 + 포맷 지시) |
+| Claude 출력 | ~2K (계획 전문) | ~0.5K (포맷팅만) |
+| 합계 | ~8K | ~1.5K (**-81%**) |
+
+Gemini가 계획 생성의 대부분을 담당하므로 Claude 토큰 비용이 대폭 감소한다.

package/skills/tfx-research/SKILL.md

@@ -14,7 +14,7 @@ argument-hint: "<검색 주제>"
 # tfx-research — Light Web Research
 
 > **Deep 버전**: tfx-deep-research. "제대로/꼼꼼히" 수정자로 자동 에스컬레이션.
-> 빠른 단일 소스 검색 + 요약. 토큰 최소화, 즉시 결과.
+> 빠른 단일 소스 검색 + 요약. **검색 자체를 Gemini에 위임**해 Claude 토큰 최소화. Gemini CLI의 네이티브 Google Search로 검색+요약을 한 번에 처리.
 
 ## 용도
 
@@ -26,9 +26,9 @@ argument-hint: "<검색 주제>"
 
 ## 워크플로우
 
-### Step 1: 쿼리 최적화
+### Step 1: 쿼리 최적화 (Claude — ~100 토큰)
 
-사용자 입력을 검색에 최적화된 쿼리로 변환한다:
+사용자 입력을 검색에 최적화된 영문 키워드로 변환한다. 이 단계만 Claude가 처리한다:
 
 ```
 입력: "React 19에서 use() 훅 사용법"
@@ -49,10 +49,58 @@ AskUserQuestion:
   5. URL 콘텐츠 추출
 ```
 
-선택 결과에 따라 Step 2의 자동 선택 로직을 건너뛰고 해당 MCP를 직접 사용한다.
-인자가 제공된 경우 이 단계를 건너뛰고 Step 2의 자동 선택 로직을 따른다.
+선택 결과에 따라 Step 2 Gemini 위임 시 프롬프트에 검색 유형 힌트를 추가한다.
+인자가 제공된 경우 이 단계를 건너뛰고 Step 2로 직행한다.
 
-### Step 2: MCP 소스 자동 선택
+### Step 2: Gemini에 검색+요약 위임 (검색 실행 전체를 Gemini가 처리)
+
+최적화된 쿼리를 Gemini CLI로 전달한다. Gemini는 네이티브 Google Search를 사용해 검색과 요약을 모두 수행한다:
+
+```
+Bash("bash scripts/tfx-route.sh gemini exec 'Research the following topic. Use Google Search to find current information. Return a structured markdown summary with sources: {optimized_query}'")
+```
+
+Gemini가 반환하는 결과에는 검색 결과, 출처 URL, 핵심 요약이 포함된다. Claude는 이 단계에서 토큰을 소비하지 않는다.
+
+**실패 시**: Gemini CLI가 응답하지 않거나 오류가 발생하면 → [Claude Fallback](#claude-fallback-gemini-실패-시) 으로 전환.
+
+### Step 3: 결과 포맷팅 (Claude — 경량, ~300 토큰)
+
+Gemini 출력을 표준 결과 템플릿으로 정리한다. 새로운 검색이나 요약 없이 포맷 변환만 수행:
+
+```markdown
+## 검색 결과: {query}
+
+### 핵심 답변
+{Gemini 요약에서 추출한 1-3문장 직접 답변}
+
+### 상세 내용
+- **[출처 1 제목](URL)**: {하이라이트 요약}
+- **[출처 2 제목](URL)**: {하이라이트 요약}
+- **[출처 3 제목](URL)**: {하이라이트 요약}
+
+### 관련 키워드
+{추가 검색에 유용한 키워드}
+```
+
+## 토큰 예산
+
+| 단계 | 담당 | 토큰 |
+|------|------|------|
+| 쿼리 최적화 | Claude | ~100 |
+| 검색 실행 + 요약 | Gemini | 0 (Claude 미소비) |
+| 결과 포맷팅 | Claude | ~300 |
+| **Claude 총합** | | **~500 (오케스트레이션만)** |
+
+> 기존 대비 Claude 토큰 ~90% 절감. 검색 품질은 Gemini의 Google Search 네이티브 연동으로 유지.
+
+---
+
+## Claude Fallback (Gemini 실패 시)
+
+Gemini CLI가 실패하거나 응답이 없을 경우 Claude + MCP 원본 워크플로우로 폴백한다.
+
+### Fallback Step 2: MCP 소스 자동 선택
 
 검색 유형에 따라 최적 MCP를 자동 선택한다:
 
@@ -73,7 +121,7 @@ elif query contains URL → Exa crawling
 else → Tavily (가장 범용적)
 ```
 
-### Step 3: 검색 실행
+### Fallback Step 3: 검색 실행
 
 선택된 MCP로 검색 실행. 결과를 토큰 효율적으로 포맷:
 
@@ -85,36 +133,6 @@ else → Tavily (가장 범용적)
   - freshness: 상황에 따라 자동 설정
 ```
 
-### Step 4: 결과 요약
-
-검색 결과를 구조화된 요약으로 변환:
-
-```markdown
-## 검색 결과: {query}
-
-### 핵심 답변
-{1-3문장 직접 답변}
-
-### 상세 내용
-- **[출처 1 제목](URL)**: {하이라이트 요약}
-- **[출처 2 제목](URL)**: {하이라이트 요약}
-- **[출처 3 제목](URL)**: {하이라이트 요약}
-
-### 관련 키워드
-{추가 검색에 유용한 키워드}
-```
-
-## 토큰 예산
-
-| 단계 | 토큰 |
-|------|------|
-| 쿼리 최적화 | ~200 |
-| 검색 실행 | ~2K (MCP 결과) |
-| 결과 요약 | ~2K |
-| **총합** | **~5K** |
-
-## Fallback 전략
-
 MCP 사용 불가 시 순서:
 1. context7 → 2. WebSearch (내장) → 3. Brave → 4. Exa → 5. Tavily