triflux 10.3.4 → 10.7.0

package/scripts/token-snapshot.mjs

@@ -9,9 +9,16 @@
  *   node token-snapshot.mjs report <session-id|all>
  */
 
-import { readFileSync, writeFileSync, existsSync, readdirSync, mkdirSync, statSync } from "node:fs";
-import { join, dirname } from "node:path";
+import {
+  existsSync,
+  mkdirSync,
+  readdirSync,
+  readFileSync,
+  statSync,
+  writeFileSync,
+} from "node:fs";
 import { homedir } from "node:os";
+import { dirname, join } from "node:path";
 import { fileURLToPath } from "node:url";
 
 const HOME = homedir();
@@ -25,13 +32,13 @@ const PRICING = {
   claude_sonnet: { input: 3, output: 15 },
   claude_opus: { input: 15, output: 75 },
   codex: { input: 0, output: 0 },
-  gemini_flash: { input: 0.10, output: 0.40 },
+  gemini_flash: { input: 0.1, output: 0.4 },
 };
 
 // Claude 캐시 가격 ($/MTok) — 오케스트레이션 비용 정밀 계산용
 const CLAUDE_CACHE_PRICING = {
-  claude_sonnet: { cache_write: 3.75, cache_read: 0.30 },
-  claude_opus: { cache_write: 18.75, cache_read: 1.50 },
+  claude_sonnet: { cache_write: 3.75, cache_read: 0.3 },
+  claude_opus: { cache_write: 18.75, cache_read: 1.5 },
 };
 
 // 에이전트 → Claude 대체 모델
@@ -62,15 +69,20 @@ const CLI_COST_MAP = {
 // ── 유틸리티 ──
 function readJson(filePath, fallback = null) {
   if (!existsSync(filePath)) return fallback;
-  try { return JSON.parse(readFileSync(filePath, "utf-8")); }
-  catch { return fallback; }
+  try {
+    return JSON.parse(readFileSync(filePath, "utf-8"));
+  } catch {
+    return fallback;
+  }
 }
 
 function writeJsonSafe(filePath, data) {
   try {
     mkdirSync(dirname(filePath), { recursive: true });
     writeFileSync(filePath, JSON.stringify(data, null, 2));
-  } catch (e) { console.error(`[token-snapshot] 쓰기 실패: ${e.message}`); }
+  } catch (e) {
+    console.error(`[token-snapshot] 쓰기 실패: ${e.message}`);
+  }
 }
 
 function formatTokenCount(n) {
@@ -85,7 +97,9 @@ function formatCost(dollars) {
 }
 
 function calcCost(tokens, pricing) {
-  return (tokens.input * pricing.input + tokens.output * pricing.output) / 1_000_000;
+  return (
+    (tokens.input * pricing.input + tokens.output * pricing.output) / 1_000_000
+  );
 }
 
 // ── Codex 세션 스캔 ──
@@ -107,8 +121,11 @@ function scanCodexSessions() {
     if (!existsSync(dayDir)) continue;
 
     let files;
-    try { files = readdirSync(dayDir).filter(f => f.endsWith(".jsonl")); }
-    catch { continue; }
+    try {
+      files = readdirSync(dayDir).filter((f) => f.endsWith(".jsonl"));
+    } catch {
+      continue;
+    }
 
     for (const file of files) {
       const filepath = join(dayDir, file);
@@ -124,18 +141,31 @@ function scanCodexSessions() {
               sessions[filepath] = {
                 input: t.input_tokens || t.input || 0,
                 output: t.output_tokens || t.output || 0,
-                total: t.total_tokens || t.total || ((t.input_tokens || t.input || 0) + (t.output_tokens || t.output || 0)),
+                total:
+                  t.total_tokens ||
+                  t.total ||
+                  (t.input_tokens || t.input || 0) +
+                    (t.output_tokens || t.output || 0),
                 timestamp: evt.timestamp || stat.mtimeMs,
               };
               break;
             }
-          } catch { /* 라인 파싱 실패 */ }
+          } catch {
+            /* 라인 파싱 실패 */
+          }
         }
         // 토큰 이벤트 없는 파일도 기록 (존재 추적용)
         if (!sessions[filepath]) {
-          sessions[filepath] = { input: 0, output: 0, total: 0, timestamp: stat.mtimeMs };
+          sessions[filepath] = {
+            input: 0,
+            output: 0,
+            total: 0,
+            timestamp: stat.mtimeMs,
+          };
         }
-      } catch { /* 파일 읽기 실패 */ }
+      } catch {
+        /* 파일 읽기 실패 */
+      }
     }
   }
   return sessions;
@@ -155,14 +185,19 @@ function scanGeminiSessions() {
       if (!existsSync(chatsDir)) continue;
 
       let files;
-      try { files = readdirSync(chatsDir).filter(f => f.endsWith(".json")); }
-      catch { continue; }
+      try {
+        files = readdirSync(chatsDir).filter((f) => f.endsWith(".json"));
+      } catch {
+        continue;
+      }
 
       for (const file of files) {
         const filepath = join(chatsDir, file);
         try {
           const data = JSON.parse(readFileSync(filepath, "utf-8"));
-          let input = 0, output = 0, model = "unknown";
+          let input = 0,
+            output = 0,
+            model = "unknown";
           for (const msg of data.messages || []) {
             if (msg.tokens) {
               input += msg.tokens.input || 0;
@@ -171,13 +206,20 @@ function scanGeminiSessions() {
             if (msg.model) model = msg.model;
           }
           sessions[filepath] = {
-            input, output, total: input + output,
-            model, lastUpdated: data.lastUpdated || null,
+            input,
+            output,
+            total: input + output,
+            model,
+            lastUpdated: data.lastUpdated || null,
           };
-        } catch { /* 무시 */ }
+        } catch {
+          /* 무시 */
+        }
       }
     }
-  } catch { /* 무시 */ }
+  } catch {
+    /* 무시 */
+  }
   return sessions;
 }
 
@@ -193,12 +235,19 @@ function scanClaudeSessions() {
     for (const proj of projects) {
       const projDir = join(projectsDir, proj);
       let stat;
-      try { stat = statSync(projDir); } catch { continue; }
+      try {
+        stat = statSync(projDir);
+      } catch {
+        continue;
+      }
       if (!stat.isDirectory()) continue;
 
       let files;
-      try { files = readdirSync(projDir).filter(f => f.endsWith(".jsonl")); }
-      catch { continue; }
+      try {
+        files = readdirSync(projDir).filter((f) => f.endsWith(".jsonl"));
+      } catch {
+        continue;
+      }
 
       for (const file of files) {
         const filepath = join(projDir, file);
@@ -231,11 +280,16 @@ function scanClaudeSessions() {
                 cache_creation: msg.usage.cache_creation_input_tokens || 0,
                 cache_read: msg.usage.cache_read_input_tokens || 0,
               };
-            } catch { /* 라인 파싱 실패 */ }
+            } catch {
+              /* 라인 파싱 실패 */
+            }
           }
 
           // requestId별 usage 합산
-          let input = 0, output = 0, cache_creation = 0, cache_read = 0;
+          let input = 0,
+            output = 0,
+            cache_creation = 0,
+            cache_read = 0;
           for (const u of Object.values(reqUsage)) {
             input += u.input;
             output += u.output;
@@ -246,16 +300,24 @@ function scanClaudeSessions() {
           const total = input + output + cache_creation + cache_read;
           if (total > 0) {
             sessions[filepath] = {
-              input, output, cache_creation, cache_read,
-              total, model,
+              input,
+              output,
+              cache_creation,
+              cache_read,
+              total,
+              model,
               timestamp: fileStat.mtimeMs,
               requests: Object.keys(reqUsage).length,
             };
           }
-        } catch { /* 파일 읽기 실패 */ }
+        } catch {
+          /* 파일 읽기 실패 */
+        }
       }
     }
-  } catch { /* 무시 */ }
+  } catch {
+    /* 무시 */
+  }
   return sessions;
 }
 
@@ -283,9 +345,15 @@ function takeSnapshot(label) {
   const outPath = join(SNAPSHOTS_DIR, `${label}.json`);
   writeJsonSafe(outPath, snapshot);
   console.log(`[snapshot] ${label} 저장 완료`);
-  console.log(`  Codex: ${snapshot.summary.codex_files}파일, ${formatTokenCount(snapshot.summary.codex_total)} tokens`);
-  console.log(`  Gemini: ${snapshot.summary.gemini_files}파일, ${formatTokenCount(snapshot.summary.gemini_total)} tokens`);
-  console.log(`  Claude: ${snapshot.summary.claude_files}파일, ${formatTokenCount(snapshot.summary.claude_total)} tokens`);
+  console.log(
+    `  Codex: ${snapshot.summary.codex_files}파일, ${formatTokenCount(snapshot.summary.codex_total)} tokens`,
+  );
+  console.log(
+    `  Gemini: ${snapshot.summary.gemini_files}파일, ${formatTokenCount(snapshot.summary.gemini_total)} tokens`,
+  );
+  console.log(
+    `  Claude: ${snapshot.summary.claude_files}파일, ${formatTokenCount(snapshot.summary.claude_total)} tokens`,
+  );
   return snapshot;
 }
 
@@ -298,12 +366,23 @@ function computeDiff(preLabel, postLabel, options = {}) {
     process.exit(1);
   }
 
-  const delta = { codex: {}, gemini: {}, claude: {}, total: { input: 0, output: 0, total: 0 } };
+  const delta = {
+    codex: {},
+    gemini: {},
+    claude: {},
+    total: { input: 0, output: 0, total: 0 },
+  };
 
   // Claude diff — 오케스트레이션 오버헤드 측정
   const preClaude = pre.claude || {};
   const postClaude = post.claude || {};
-  const claudeOverhead = { input: 0, output: 0, cache_creation: 0, cache_read: 0, total: 0 };
+  const claudeOverhead = {
+    input: 0,
+    output: 0,
+    cache_creation: 0,
+    cache_read: 0,
+    total: 0,
+  };
   for (const [fp, postData] of Object.entries(postClaude)) {
     const preData = preClaude[fp];
     if (!preData) {
@@ -319,7 +398,8 @@ function computeDiff(preLabel, postLabel, options = {}) {
       const d = {
         input: (postData.input || 0) - (preData.input || 0),
         output: (postData.output || 0) - (preData.output || 0),
-        cache_creation: (postData.cache_creation || 0) - (preData.cache_creation || 0),
+        cache_creation:
+          (postData.cache_creation || 0) - (preData.cache_creation || 0),
         cache_read: (postData.cache_read || 0) - (preData.cache_read || 0),
         total: postData.total - preData.total,
         type: "increased",
@@ -389,7 +469,10 @@ function computeDiff(preLabel, postLabel, options = {}) {
   const savings = estimateSavings(delta.total, agent, cli, claudeOverhead);
 
   const result = {
-    preLabel, postLabel, agent, cli,
+    preLabel,
+    postLabel,
+    agent,
+    cli,
     timestamp: new Date().toISOString(),
     delta,
     savings,
@@ -400,7 +483,12 @@ function computeDiff(preLabel, postLabel, options = {}) {
 
   // 누적 절약액 업데이트 (HUD ts: 표시용)
   const accPath = join(STATE_DIR, "savings-total.json");
-  const acc = readJson(accPath, { totalSaved: 0, totalClaudeCost: 0, totalActualCost: 0, diffCount: 0 });
+  const acc = readJson(accPath, {
+    totalSaved: 0,
+    totalClaudeCost: 0,
+    totalActualCost: 0,
+    diffCount: 0,
+  });
   acc.totalSaved += savings.saved;
   acc.totalClaudeCost += savings.claudeCost;
   acc.totalActualCost += savings.actualCost;
@@ -410,10 +498,16 @@ function computeDiff(preLabel, postLabel, options = {}) {
 
   console.log(`[diff] ${preLabel} → ${postLabel}`);
   console.log(`  Agent: ${agent} (${cli})`);
-  console.log(`  외부 CLI 토큰: ${formatTokenCount(delta.total.input)} input, ${formatTokenCount(delta.total.output)} output`);
-  console.log(`  Claude 오케스트레이션: ${formatTokenCount(claudeOverhead.total)} tokens (오버헤드 ${formatCost(savings.overheadCost)})`);
+  console.log(
+    `  외부 CLI 토큰: ${formatTokenCount(delta.total.input)} input, ${formatTokenCount(delta.total.output)} output`,
+  );
+  console.log(
+    `  Claude 오케스트레이션: ${formatTokenCount(claudeOverhead.total)} tokens (오버헤드 ${formatCost(savings.overheadCost)})`,
+  );
   console.log(`  Claude-only 비용(추정): ${formatCost(savings.claudeCost)}`);
-  console.log(`  실제 비용: ${formatCost(savings.actualCost)} (외부 CLI ${formatCost(savings.cliCost)} + 오케스트레이션 ${formatCost(savings.overheadCost)})`);
+  console.log(
+    `  실제 비용: ${formatCost(savings.actualCost)} (외부 CLI ${formatCost(savings.cliCost)} + 오케스트레이션 ${formatCost(savings.overheadCost)})`,
+  );
   console.log(`  순절약: ${formatCost(savings.saved)}`);
   return result;
 }
@@ -440,9 +534,12 @@ function estimateSavings(tokens, agent, cli, claudeOverhead = null) {
       claudePricing,
     );
     // 캐시 비용 (cache_creation은 write 가격, cache_read는 read 가격)
-    const cachePricing = CLAUDE_CACHE_PRICING[claudeModel] || CLAUDE_CACHE_PRICING.claude_sonnet;
-    overheadCost += (claudeOverhead.cache_creation * cachePricing.cache_write) / 1_000_000;
-    overheadCost += (claudeOverhead.cache_read * cachePricing.cache_read) / 1_000_000;
+    const cachePricing =
+      CLAUDE_CACHE_PRICING[claudeModel] || CLAUDE_CACHE_PRICING.claude_sonnet;
+    overheadCost +=
+      (claudeOverhead.cache_creation * cachePricing.cache_write) / 1_000_000;
+    overheadCost +=
+      (claudeOverhead.cache_read * cachePricing.cache_read) / 1_000_000;
   }
 
   // 실제 총비용 = 외부 CLI 비용 + Claude 오케스트레이션 비용
@@ -468,7 +565,7 @@ function generateReport(sessionId) {
     process.exit(1);
   }
 
-  const files = readdirSync(DIFFS_DIR).filter(f => f.endsWith(".json"));
+  const files = readdirSync(DIFFS_DIR).filter((f) => f.endsWith(".json"));
   const diffs = [];
   for (const file of files) {
     const data = readJson(join(DIFFS_DIR, file));
@@ -483,7 +580,10 @@ function generateReport(sessionId) {
     return null;
   }
 
-  let totalClaudeCost = 0, totalActualCost = 0, totalSaved = 0, totalOverhead = 0;
+  let totalClaudeCost = 0,
+    totalActualCost = 0,
+    totalSaved = 0,
+    totalOverhead = 0;
   const rows = diffs.map((d, i) => {
     const s = d.savings;
     totalClaudeCost += s.claudeCost;
@@ -509,11 +609,17 @@ function generateReport(sessionId) {
   const reportData = {
     sessionId,
     timestamp: new Date().toISOString(),
-    diffs: diffs.map(d => ({
-      ...d.savings, agent: d.agent, cli: d.cli,
+    diffs: diffs.map((d) => ({
+      ...d.savings,
+      agent: d.agent,
+      cli: d.cli,
       labels: `${d.preLabel}→${d.postLabel}`,
     })),
-    totals: { claudeCost: totalClaudeCost, actualCost: totalActualCost, saved: totalSaved },
+    totals: {
+      claudeCost: totalClaudeCost,
+      actualCost: totalActualCost,
+      saved: totalSaved,
+    },
     markdown: report,
   };
   writeJsonSafe(join(REPORTS_DIR, `${sessionId}.json`), reportData);
@@ -521,48 +627,62 @@ function generateReport(sessionId) {
 }
 
 // ── Named exports (파이프라인 벤치마크 훅용) ──
-export { takeSnapshot, computeDiff, estimateSavings, formatTokenCount, formatCost, DIFFS_DIR, STATE_DIR };
+export {
+  computeDiff,
+  DIFFS_DIR,
+  estimateSavings,
+  formatCost,
+  formatTokenCount,
+  STATE_DIR,
+  takeSnapshot,
+};
 
 // ── CLI 핸들러 (직접 실행 시에만) ──
 const __filename = fileURLToPath(import.meta.url);
-const isDirectRun = process.argv[1] && join(dirname(process.argv[1])) === dirname(__filename)
-  && process.argv[1].endsWith("token-snapshot.mjs");
+const isDirectRun =
+  process.argv[1] &&
+  join(dirname(process.argv[1])) === dirname(__filename) &&
+  process.argv[1].endsWith("token-snapshot.mjs");
 
 if (!isDirectRun) {
   // imported as module — skip CLI
 } else {
-
-const [,, command, ...args] = process.argv;
-
-switch (command) {
-  case "snapshot": {
-    const label = args[0];
-    if (!label) { console.error("사용법: token-snapshot.mjs snapshot <label>"); process.exit(1); }
-    takeSnapshot(label);
-    break;
-  }
-  case "diff": {
-    const [preLabel, postLabel, ...rest] = args;
-    if (!preLabel || !postLabel) {
-      console.error("사용법: token-snapshot.mjs diff <pre> <post> [--agent X] [--cli Y] [--id Z]");
-      process.exit(1);
+  const [, , command, ...args] = process.argv;
+
+  switch (command) {
+    case "snapshot": {
+      const label = args[0];
+      if (!label) {
+        console.error("사용법: token-snapshot.mjs snapshot <label>");
+        process.exit(1);
+      }
+      takeSnapshot(label);
+      break;
     }
-    const options = {};
-    for (let i = 0; i < rest.length; i++) {
-      if (rest[i] === "--agent" && rest[i + 1]) options.agent = rest[++i];
-      else if (rest[i] === "--cli" && rest[i + 1]) options.cli = rest[++i];
-      else if (rest[i] === "--id" && rest[i + 1]) options.id = rest[++i];
+    case "diff": {
+      const [preLabel, postLabel, ...rest] = args;
+      if (!preLabel || !postLabel) {
+        console.error(
+          "사용법: token-snapshot.mjs diff <pre> <post> [--agent X] [--cli Y] [--id Z]",
+        );
+        process.exit(1);
+      }
+      const options = {};
+      for (let i = 0; i < rest.length; i++) {
+        if (rest[i] === "--agent" && rest[i + 1]) options.agent = rest[++i];
+        else if (rest[i] === "--cli" && rest[i + 1]) options.cli = rest[++i];
+        else if (rest[i] === "--id" && rest[i + 1]) options.id = rest[++i];
+      }
+      computeDiff(preLabel, postLabel, options);
+      break;
     }
-    computeDiff(preLabel, postLabel, options);
-    break;
-  }
-  case "report": {
-    const sessionId = args[0] || "all";
-    generateReport(sessionId);
-    break;
-  }
-  default:
-    console.log(`cx-auto Token Savings Tracker
+    case "report": {
+      const sessionId = args[0] || "all";
+      generateReport(sessionId);
+      break;
+    }
+    default:
+      console.log(`cx-auto Token Savings Tracker
 
 사용법:
   node token-snapshot.mjs snapshot <label>     스냅샷 캡처
@@ -570,6 +690,5 @@ switch (command) {
     [--agent <agent>] [--cli <cli>] [--id <id>]
   node token-snapshot.mjs report <session-id>  종합 보고서 생성
     (session-id 대신 "all"로 전체 보고서)`);
-}
-
+  }
 } // end isDirectRun guard

package/skills/.omc/state/agent-replay-8f0e10a9-9693-4410-96f5-a6b07e8ed995.jsonl

@@ -0,0 +1 @@
+{"t":0,"agent":"adb34b0","agent_type":"general-purpose","event":"agent_stop","success":true}

package/skills/.omc/state/idle-notif-cooldown.json

@@ -0,0 +1,3 @@
+{
+  "lastSentAt": "2026-03-29T03:41:07.256Z"
+}

package/skills/.omc/state/last-tool-error.json

@@ -0,0 +1,7 @@
+{
+  "tool_name": "Bash",
+  "tool_input_preview": "{\"command\":\"ls -la \\\"C:/Users/tellang/Desktop/Projects/triflux/skills/tfx-deslop/\\\" 2>/dev/null; echo \\\"===\\\"; ls -la \\\"C:/Users/tellang/Desktop/Projects/triflux/skills/tfx-codebase-search/\\\" 2>/dev/n...",
+  "error": "Exit code 2\n===",
+  "timestamp": "2026-03-29T03:40:35.913Z",
+  "retry_count": 1
+}

package/skills/.omc/state/subagent-tracking.json

@@ -0,0 +1,7 @@
+{
+  "agents": [],
+  "total_spawned": 0,
+  "total_completed": 0,
+  "total_failed": 0,
+  "last_updated": "2026-03-29T03:41:34.338Z"
+}

package/skills/_templates/base.md

@@ -1,9 +1,4 @@
 > **ARGUMENTS 처리**: 이 스킬이 `ARGUMENTS: <값>`과 함께 호출되면, 해당 값을 사용자 입력으로 취급하여
 > 워크플로우의 첫 단계 입력으로 사용한다. ARGUMENTS가 비어있거나 없으면 기존 절차대로 사용자에게 입력을 요청한다.
 
-> **Telemetry**
->
-> - Skill: `{{SKILL_NAME}}`
-> - Description: `{{SKILL_DESCRIPTION}}`
-> - Session: 요청별 식별자를 유지해 단계별 실행 로그를 추적한다.
-> - Errors: 실패 시 원인/복구/재시도 여부를 구조화해 기록한다.
+{{#include shared/telemetry-segment.md}}

package/skills/merge-worktree/SKILL.md.tmpl

@@ -0,0 +1,144 @@
+---
+name: merge-worktree
+description: "워크트리 브랜치를 main으로 squash-merge + conventional commit 자동 생성. codex-swarm 워크트리 자동 인식. '머지해', 'merge worktree', '워크트리 머지', '결과 수집', 'squash merge' 요청에 사용."
+argument-hint: "[target-branch]"
+disable-model-invocation: true
+---
+
+# Merge Worktree
+
+워크트리 브랜치를 대상 브랜치로 squash-merge하고 conventional commit 메시지를 자동 작성한다.
+
+## Current context
+
+* Git dir: `!git rev-parse --git-dir`
+* Current branch: `!git branch --show-current`
+* Recent commits: `!git log --oneline -20`
+* Working tree status: `!git status --short`
+
+## Instructions
+
+### Phase 1: Validation
+
+1. **Worktree 확인**: `git rev-parse --git-dir` 출력에 `/worktrees/`가 포함되어야 한다. 아니면 중지.
+
+2. **현재 브랜치 확인**: `git branch --show-current`
+
+3. **대상 브랜치 결정**:
+   * `$ARGUMENTS`가 있으면 해당 브랜치 사용
+   * 없으면 `main` 존재 확인, 없으면 `master`
+
+4. **원본 레포 경로 확인**: `git rev-parse --git-common-dir`의 부모 디렉토리
+
+5. **클린 상태 확인**: `git status --porcelain`이 비어있어야 한다. 미커밋 변경이 있으면 먼저 커밋/스태시 안내.
+
+### Phase 2: Research
+
+1. **커밋 이력**: `git log --oneline <target>..HEAD`
+
+2. **변경 파일 요약**: `git diff <target>...HEAD --stat`
+
+3. **전체 diff**: `git diff <target>...HEAD` — 꼼꼼히 읽는다.
+
+4. **핵심 파일 읽기**: 가장 큰 변경, 신규 파일, 삭제 파일을 Read로 확인.
+
+5. **변경 분류**:
+   * Features (신규 기능)
+   * Fixes (버그 수정)
+   * Refactors (구조 변경)
+   * Tests (테스트)
+   * Docs (문서)
+   * Config/Chore (빌드, CI, 의존성)
+
+6. **dominant type 결정**: `feat`, `fix`, `refactor`, `docs`, `chore`, `test` 중 하나
+
+### Phase 3: 대상 브랜치 준비
+
+1. **대상 브랜치 최근 커밋 확인**: `git -C <원본레포> log --oneline -10 <target>`
+
+2. **WIP 커밋 감지**: `wip:`, `auto-commit`, `WIP` 시작 커밋이 있으면 사용자에게 경고.
+
+3. **최신 fetch**: `git -C <원본레포> fetch origin <target> 2>/dev/null`
+
+### Phase 4: Squash Merge
+
+1. **대상 브랜치 checkout**:
+   ```
+   git -C <원본레포> checkout <target>
+   ```
+
+2. **squash merge 실행**:
+   ```
+   git -C <원본레포> merge --squash <워크트리브랜치>
+   ```
+
+3. **충돌 처리**: 충돌 발생 시 충돌 파일 목록 + 마커를 보여주고 **중지**. 자동 해결 시도 금지.
+
+### Phase 5: 커밋 메시지 작성 + 커밋
+
+Phase 2 분석 기반으로 아래 구조의 커밋 메시지를 작성한다:
+
+```
+<type>: <명령형 요약, 72자 이내, 마침표 없음>
+
+<무엇을 왜 했는지 2-4문장. 동기와 접근 방식 중심.>
+
+Changes:
+* <그룹별 변경 사항>
+* <하위 항목은 서브 불릿>
+```
+
+**규칙:**
+* `<type>`은 `feat`, `fix`, `refactor`, `docs`, `chore`, `test` 중 하나
+* 여러 유형이 섞이면 dominant 사용
+* 요약: 명령형 ("add", "fix", "refactor"), 마침표 없음, 72자 제한
+* 본문: *왜*와 *맥락*, *무엇*만이 아님
+* Changes: 관련 항목 그룹핑, 중요한 것 먼저
+* Co-Authored-By 푸터 **절대 추가 금지** (글로벌 설정 `includeCoAuthoredBy: false`)
+
+**커밋 실행**:
+```bash
+git -C <원본레포> commit -m "$(cat <<'EOF'
+<커밋 메시지>
+EOF
+)"
+```
+
+### Phase 6: 정리 + 검증
+
+1. **커밋 확인**: `git -C <원본레포> log --oneline -3`
+
+2. **워크트리 자동 정리**:
+   ```bash
+   git -C <원본레포> worktree remove <워크트리경로>
+   git -C <원본레포> branch -d <워크트리브랜치>
+   ```
+
+3. **codex-swarm 정리 감지**: 워크트리 경로가 `.codex-swarm/wt-*` 패턴이면:
+   * 같은 `.codex-swarm/` 디렉토리에 다른 워크트리가 남아있는지 확인
+   * 모든 워크트리가 머지 완료되었으면 `.codex-swarm/` 전체 정리 제안
+   * `git worktree prune` 실행
+
+4. **결과 보고**:
+   * 커밋 해시 + 요약
+   * 머지 대상 브랜치
+   * 워크트리 정리 완료 여부
+   * push 안내 (`git push`)
+
+## codex-swarm 연동
+
+이 스킬은 `tfx-codex-swarm`의 Step 10 "결과 수집"에서 자동으로 호출된다.
+codex-swarm이 완료한 각 워크트리에 대해 순차적으로 실행:
+
+```
+각 워크트리에 대해:
+  1. 워크트리로 cd
+  2. /merge-worktree main
+  3. 다음 워크트리로 이동
+```
+
+## 주의사항
+
+* force-push, destructive 연산은 사용자 확인 없이 절대 실행 금지
+* pre-commit hook 건너뛰기(`--no-verify`) 금지
+* 예상치 못한 상황이면 추측하지 말고 **중지 후 설명**

package/skills/shared/telemetry-segment.md

@@ -0,0 +1,6 @@
+> **Telemetry**
+>
+> - Skill: `{{SKILL_NAME}}`
+> - Description: `{{SKILL_DESCRIPTION}}`
+> - Session: 요청별 식별자를 유지해 단계별 실행 로그를 추적한다.
+> - Errors: 실패 시 원인/복구/재시도 여부를 구조화해 기록한다.