triflux 9.0.0 → 9.2.0

package/README.ko.md

@@ -10,7 +10,7 @@
 
 <p align="center">
   <strong>Consensus Intelligence 기반 Tri-CLI 오케스트레이션</strong><br>
-  <em>Claude + Codex + Gemini — 3자 토론, Anti-Herding 검증, Deep/Light 변형을 갖춘 35개 스킬.</em>
+  <em>Claude + Codex + Gemini — 자연어 라우팅, 교차 모델 리뷰, Deep/Light 변형을 갖춘 38개 스킬.</em>
 </p>
 
 <p align="center">
@@ -27,7 +27,7 @@
 <p align="center">
   <a href="#빠른-시작">빠른 시작</a> ·
   <a href="#tri-cli-합의-엔진">Tri-CLI 합의 엔진</a> ·
-  <a href="#35개-스킬">35개 스킬</a> ·
+  <a href="#38개-스킬">38개 스킬</a> ·
   <a href="#아키텍처">아키텍처</a> ·
   <a href="#deep-vs-light">Deep vs Light</a> ·
   <a href="#보안">보안</a>
@@ -80,21 +80,26 @@ tfx setup
 
 ---
 
-## v8의 새로운 기능
+## v9의 새로운 기능
 
-**triflux v8**은 **Tri-CLI Consensus Intelligence**를 도입합니다. Claude, Codex, Gemini가 각각 독립적으로 분석한 뒤, 구조화된 토론을 거쳐 교차 검증하는 근본적으로 새로운 접근 방식입니다. 모든 Deep 스킬은 Anti-Herding(편향 오염 방지)과 Consensus Gate를 통한 출력 보장을 제공합니다.
+**triflux v9**은 **하네스 네이티브 인텔리전스**를 도입합니다. 자연어로 말하면 적절한 스킬로 자동 라우팅되고, 교차 모델 리뷰로 동일 모델의 self-approve를 차단합니다.
 
-### 주요 특징
+### v9 주요 특징
+
+- **자연어 라우팅** — "리뷰해줘"라고 말하면 `/tfx-review`가 자동 호출. "제대로/꼼꼼히" 수정자로 Deep 변형 자동 에스컬레이션
+- **교차 모델 리뷰** — Claude가 작성하면 Codex가 리뷰, Codex가 작성하면 Claude가 리뷰. 동일 모델 self-approve 차단. 커밋 전 미검증 파일 nudge
+- **맥락 격리** — 현재 맥락과 무관한 요청을 감지하면 별도 psmux 세션으로 분리 제안
+- **38개 스킬** — Light 14개 + Deep 10개 + Infrastructure 14개, 10개 도메인으로 구성
+- **Codex Swarm 강화** — PowerShell `.ps1` 런처, 프로파일 기반 실행, `/merge-worktree`로 결과 자동 수집
+- **스킬 메타데이터** — 모든 스킬에 래퍼/인프라/Light-Deep 관계 표기. 트리거 충돌 해소
+
+### v8 기반 (계속 유지)
 
-- **35개 스킬** — Light 11개 + Deep 10개 + Infrastructure 12개, 9개 도메인으로 구성
 - **Tri-Debate Engine** — 3개 CLI가 독립 분석 후 Anti-Herding, 교차 검증, 합의 점수 산출
 - **Deep/Light 변형** — 모든 기능에 토큰 효율적인 Light 모드와 정밀한 Deep 모드를 제공
-- **Consensus Gate** — Deep 스킬은 3개 CLI 중 2개 이상의 동의를 요구하며, 학습된 가중치로 CLI 신뢰도를 추적
-- **Anti-Herding** — 1라운드는 상호 참조 없이 병렬 실행하여 편향 오염을 원천 차단
-- **Expert Panel** — `tfx-panel`을 통한 가상 전문가 시뮬레이션 (Fowler, Newman, Porter 등)
-- **94% 토큰 절감** — `tfx-index`가 58K 토큰 분량의 파일 읽기를 3KB 프로젝트 맵으로 대체
-- **Persistence Loop** — `tfx-persist`(정식 이름, 3자 검증), `/tfx-ralph`(호환 별칭), `tfx-sisyphus`(자동 라우팅)가 검증 완료까지 반복 실행
-- **Hub IPC** — Named Pipe 및 HTTP MCP 브리지를 활용한 초고속 상주형 Hub 서버
+- **Consensus Gate** — Deep 스킬은 3개 CLI 중 2개 이상의 동의 요구
+- **Expert Panel** — `tfx-panel`을 통한 가상 전문가 시뮬레이션
+- **Hub IPC** — Named Pipe 및 HTTP MCP 브리지를 활용한 상주형 Hub 서버
 - **psmux / Windows 네이티브** — `tmux`(WSL)와 `psmux`(Windows Terminal) 하이브리드 지원
 
 ---
@@ -128,7 +133,7 @@ Phase 3: Resolution (합의율 < 70%일 경우)
 
 ---
 
-## 35개 스킬
+## 38개 스킬
 
 ### 리서치
 

package/README.md

@@ -10,7 +10,7 @@
 
 <p align="center">
   <strong>Tri-CLI Orchestration with Consensus Intelligence</strong><br>
-  <em>Claude + Codex + Gemini — 3-party debate, anti-herding verification, and 35 skills with Deep/Light variants.</em>
+  <em>Claude + Codex + Gemini — natural language routing, cross-model review, 38 skills with Deep/Light variants.</em>
 </p>
 
 <p align="center">
@@ -27,7 +27,7 @@
 <p align="center">
   <a href="#quick-start">Quick Start</a> ·
   <a href="#tri-cli-consensus">Tri-CLI Consensus</a> ·
-  <a href="#35-skills">35 Skills</a> ·
+  <a href="#38-skills">38 Skills</a> ·
   <a href="#architecture">Architecture</a> ·
   <a href="#deep-vs-light">Deep vs Light</a> ·
   <a href="#security">Security</a>
@@ -80,21 +80,26 @@ tfx setup
 
 ---
 
-## What's New in v8
+## What's New in v9
 
-**triflux v8** introduces **Tri-CLI Consensus Intelligence** — a fundamentally new approach where Claude, Codex, and Gemini independently analyze, then cross-validate through structured debate. Every Deep skill guarantees anti-herding (no bias contamination) and consensus-gated output.
+**triflux v9** introduces **Harness-Native Intelligence** — speak naturally, and triflux routes to the right skill automatically. Cross-model review ensures no model approves its own work.
 
-### Highlights
+### v9 Highlights
+
+- **Natural Language Routing** — Say "review this" or "리뷰해줘" instead of memorizing `/tfx-review`. Depth modifiers ("thoroughly", "제대로") auto-escalate to Deep variants
+- **Cross-Model Review** — Claude writes → Codex reviews. Codex writes → Claude reviews. Same-model self-approve is blocked. Pre-commit nudge for unreviewed files
+- **Context Isolation** — Off-topic requests auto-detected; spawns a clean psmux session so your main context stays focused
+- **38 Skills** — 14 Light + 10 Deep + 14 Infrastructure, organized across 10 domains
+- **Codex Swarm Hardened** — PowerShell `.ps1` launchers, profile-based execution (no `--dangerously` flag), `/merge-worktree` auto-invocation for result collection
+- **Skill Metadata** — Every skill labeled: wrapper/infrastructure/Light-Deep pairs. Trigger conflicts resolved
+
+### v8 Foundations (carried forward)
 
-- **35 Skills** — 11 Light + 10 Deep + 12 Infrastructure, organized across 9 domains
 - **Tri-Debate Engine** — 3-CLI independent analysis with anti-herding, cross-validation, and consensus scoring
 - **Deep/Light Variants** — Every capability has a token-efficient Light mode and a thorough Deep mode
 - **Consensus Gate** — Deep skills require 2/3+ CLI agreement; learned weights track CLI reliability over time
-- **Anti-Herding** — Round 1 runs in parallel with zero cross-visibility to prevent bias contamination
-- **Expert Panel** — Virtual expert simulation (Fowler, Newman, Porter, etc.) via `tfx-panel`
-- **94% Token Reduction** — `tfx-index` creates a 3KB project map replacing 58K tokens of file reads
-- **Persistence Loops** — `tfx-persist` (canonical, 3-party verified), `/tfx-ralph` (compat alias), and `tfx-sisyphus` (auto-routing) run until verified complete
-- **Hub IPC** — Lightning-fast resident Hub server with Named Pipe & HTTP MCP bridge
+- **Expert Panel** — Virtual expert simulation via `tfx-panel`
+- **Hub IPC** — Resident Hub server with Named Pipe & HTTP MCP bridge
 - **psmux / Windows Native** — Hybrid support for `tmux` (WSL) and `psmux` (Windows Terminal)
 
 ---
@@ -128,7 +133,7 @@ Phase 3: Resolution (if consensus < 70%)
 
 ---
 
-## 35 Skills
+## 38 Skills
 
 ### Research
 

package/bin/triflux.mjs

@@ -16,8 +16,24 @@ const PKG_ROOT = dirname(dirname(fileURLToPath(import.meta.url)));
 const CLAUDE_DIR = join(homedir(), ".claude");
 const CODEX_DIR = join(homedir(), ".codex");
 const CODEX_CONFIG_PATH = join(CODEX_DIR, "config.toml");
+const GEMINI_DIR = join(homedir(), ".gemini");
+const GEMINI_PROFILES_PATH = join(GEMINI_DIR, "triflux-profiles.json");
 const PKG = JSON.parse(readFileSync(join(PKG_ROOT, "package.json"), "utf8"));
 
+// 이 배열에 포함된 버전에서만 star prompt를 표시한다 (빈 배열 = 모든 버전에서 표시)
+const STAR_PROMPT_VERSIONS = ["9.2.0"];
+
+const DEFAULT_GEMINI_PROFILES = {
+  model: "gemini-3.1-pro-preview",
+  profiles: {
+    pro31:   { model: "gemini-3.1-pro-preview",   hint: "3.1 Pro — 플래그십 (1M ctx, 멀티모달)" },
+    flash3:  { model: "gemini-3-flash-preview",   hint: "3.0 Flash — 빠른 응답, 비용 효율" },
+    pro25:   { model: "gemini-2.5-pro",           hint: "2.5 Pro — 안정 (추론 강화)" },
+    flash25: { model: "gemini-2.5-flash",         hint: "2.5 Flash — 경량 범용" },
+    lite25:  { model: "gemini-2.5-flash-lite",    hint: "2.5 Flash Lite — 최경량" },
+  },
+};
+
 const REQUIRED_CODEX_PROFILES = [
   {
     name: "codex53_high",
@@ -496,6 +512,44 @@ function previewCodexProfiles() {
   };
 }
 
+function ensureGeminiProfiles() {
+  try {
+    if (!existsSync(GEMINI_DIR)) mkdirSync(GEMINI_DIR, { recursive: true });
+
+    if (!existsSync(GEMINI_PROFILES_PATH)) {
+      writeFileSync(GEMINI_PROFILES_PATH, JSON.stringify(DEFAULT_GEMINI_PROFILES, null, 2) + "\n", "utf8");
+      return { ok: true, created: true, count: Object.keys(DEFAULT_GEMINI_PROFILES.profiles).length };
+    }
+
+    let cfg;
+    try {
+      cfg = JSON.parse(readFileSync(GEMINI_PROFILES_PATH, "utf8"));
+    } catch {
+      // 파싱 실패 → 재생성
+      writeFileSync(GEMINI_PROFILES_PATH, JSON.stringify(DEFAULT_GEMINI_PROFILES, null, 2) + "\n", "utf8");
+      return { ok: true, created: true, count: Object.keys(DEFAULT_GEMINI_PROFILES.profiles).length };
+    }
+
+    if (!cfg.profiles) cfg.profiles = {};
+    let added = 0;
+    for (const [name, value] of Object.entries(DEFAULT_GEMINI_PROFILES.profiles)) {
+      if (!cfg.profiles[name]) {
+        cfg.profiles[name] = value;
+        added++;
+      }
+    }
+    if (!cfg.model) cfg.model = DEFAULT_GEMINI_PROFILES.model;
+
+    if (added > 0) {
+      writeFileSync(GEMINI_PROFILES_PATH, JSON.stringify(cfg, null, 2) + "\n", "utf8");
+    }
+
+    return { ok: true, created: false, added, count: Object.keys(cfg.profiles).length };
+  } catch (e) {
+    return { ok: false, message: e.message };
+  }
+}
+
 function syncFile(src, dst, label) {
   const dstDir = dirname(dst);
   if (!existsSync(dstDir)) mkdirSync(dstDir, { recursive: true });
@@ -869,19 +923,42 @@ function cmdSetup(options = {}) {
     }
   }
 
+  // ── 결과 추적 ──
+  const summary = [];
+
   const codexProfileResult = ensureCodexProfiles();
   if (!codexProfileResult.ok) {
     warn(`Codex profiles 설정 실패: ${codexProfileResult.message}`);
+    summary.push({ item: "Codex profiles", status: "⚠️", detail: codexProfileResult.message });
   } else if (codexProfileResult.added > 0) {
     ok(`Codex profiles: ${codexProfileResult.added}개 추가됨 (~/.codex/config.toml)`);
+    summary.push({ item: "Codex profiles", status: "✅", detail: `${codexProfileResult.added}개 추가됨` });
   } else {
     ok("Codex profiles: 이미 준비됨");
+    summary.push({ item: "Codex profiles", status: "✅", detail: "이미 준비됨" });
+  }
+
+  // Gemini 프로필
+  const geminiResult = ensureGeminiProfiles();
+  if (!geminiResult.ok) {
+    warn(`Gemini profiles 설정 실패: ${geminiResult.message}`);
+    summary.push({ item: "Gemini profiles", status: "⚠️", detail: geminiResult.message });
+  } else if (geminiResult.created) {
+    ok(`Gemini profiles: ${geminiResult.count}개 생성됨 (~/.gemini/triflux-profiles.json)`);
+    summary.push({ item: "Gemini profiles", status: "✅", detail: `${geminiResult.count}개 생성됨` });
+  } else if (geminiResult.added > 0) {
+    ok(`Gemini profiles: ${geminiResult.added}개 추가됨`);
+    summary.push({ item: "Gemini profiles", status: "✅", detail: `${geminiResult.added}개 추가됨 (총 ${geminiResult.count}개)` });
+  } else {
+    ok(`Gemini profiles: ${geminiResult.count}개 준비됨`);
+    summary.push({ item: "Gemini profiles", status: "✅", detail: `${geminiResult.count}개 준비됨` });
   }
 
   // hub MCP 사전 등록 (서버 미실행이어도 설정만 등록 — hub start 시 즉시 사용 가능)
   if (existsSync(join(PKG_ROOT, "hub", "server.mjs"))) {
     const defaultHubUrl = `http://127.0.0.1:${process.env.TFX_HUB_PORT || "27888"}/mcp`;
     autoRegisterMcp(defaultHubUrl);
+    summary.push({ item: "Hub MCP", status: "✅", detail: "등록됨" });
     console.log("");
   }
 
@@ -900,6 +977,7 @@ function cmdSetup(options = {}) {
       const currentCmd = settings.statusLine?.command || "";
       if (currentCmd.includes("hud-qos-status.mjs")) {
         ok("statusLine 이미 설정됨");
+        summary.push({ item: "HUD statusLine", status: "✅", detail: "이미 설정됨" });
       } else {
         const nodePath = process.execPath.replace(/\\/g, "/");
         const hudForward = hudPath.replace(/\\/g, "/");
@@ -917,6 +995,7 @@ function cmdSetup(options = {}) {
 
         writeFileSync(settingsPath, JSON.stringify(settings, null, 2) + "\n", "utf8");
         ok("statusLine 설정 완료 — 세션 재시작 후 HUD 표시");
+        summary.push({ item: "HUD statusLine", status: "✅", detail: "설정 완료" });
       }
     } catch (e) {
       throw createCliError(`settings.json 처리 실패: ${e.message}`, {
@@ -928,9 +1007,50 @@ function cmdSetup(options = {}) {
     }
   } else {
     warn("HUD 파일 없음 — 먼저 파일 동기화 필요");
+    summary.push({ item: "HUD statusLine", status: "⚠️", detail: "HUD 파일 없음" });
+  }
+
+  // CLI 존재 확인
+  const cliChecks = [
+    { name: "codex", install: "npm i -g @openai/codex" },
+    { name: "gemini", install: "npm i -g @google/gemini-cli" },
+  ];
+  for (const { name, install } of cliChecks) {
+    if (which(name)) {
+      summary.push({ item: `${name} CLI`, status: "✅", detail: "설치됨" });
+    } else {
+      summary.push({ item: `${name} CLI`, status: "⏭️", detail: `미설치 (${install})` });
+    }
   }
 
-  console.log(`\n${DIM}설치 위치: ${CLAUDE_DIR}${RESET}\n`);
+  // Star request (버전 게이팅)
+  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"] });
+      try {
+        execFileSync("gh", ["api", "user/starred/tellang/triflux"], { timeout: 5000, stdio: ["pipe", "pipe", "pipe"] });
+        console.log();
+        ok(`이미 함께하고 계시군요. ${AMBER}⭐${RESET}`);
+      } catch {
+        console.log();
+        info(`${AMBER}⭐${RESET} 하나가 큰 차이를 만듭니다. ${CYAN}https://github.com/tellang/triflux${RESET}`);
+      }
+    } catch {
+      console.log();
+      info(`${AMBER}⭐${RESET} 하나가 큰 차이를 만듭니다. ${CYAN}https://github.com/tellang/triflux${RESET}`);
+    }
+  }
+
+  // ── 결과 요약 테이블 ──
+  console.log(`\n${BOLD}── 설정 요약 ──${RESET}`);
+  const maxItem = Math.max(...summary.map((s) => s.item.length));
+  for (const { item, status, detail } of summary) {
+    console.log(`  ${status} ${item.padEnd(maxItem)}  ${DIM}${detail}${RESET}`);
+  }
+
+  console.log(`\n${DIM}설치 위치: ${CLAUDE_DIR}${RESET}`);
+  console.log(`${DIM}버전: v${PKG.version}${RESET}\n`);
 }
 
 function addDoctorCheck(report, entry) {
@@ -1849,7 +1969,7 @@ function cmdUpdate() {
     return;
   }
 
-  // 3. setup 재실행 (tfx-route.sh, HUD, 스킬 동기화)
+  // 3. setup 재실행 (파일 동기화, 프로파일, HUD, CLI 확인)
   if (updated) {
     console.log("");
     // 업데이트 후 새 버전 읽기
@@ -1865,18 +1985,17 @@ function cmdUpdate() {
       ok(`버전: v${oldVer} (이미 최신)`);
     }
 
-    // setup 재실행
-    console.log("");
-    info("setup 재실행 중...");
+    // setup 재실행 — 개선된 cmdSetup()이 Gemini 프로필, CLI 확인, 요약 테이블 포함
+    console.log(`\n${CYAN}── 설정 동기화 ──${RESET}`);
     cmdSetup();
 
     if (stoppedHubInfo) {
-      if (startHubAfterUpdate(stoppedHubInfo)) info("hub 재기동 완료");
+      if (startHubAfterUpdate(stoppedHubInfo)) ok("hub 재기동 완료");
       else warn("hub 재기동 실패 — `tfx hub start`로 수동 시작 필요");
     }
   }
 
-  console.log(`${GREEN}${BOLD}업데이트 완료${RESET}\n`);
+  console.log(`${GREEN}${BOLD}✓ 업데이트 완료${RESET}\n`);
 }
 
 function cmdList(options = {}) {

package/package.json

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

package/scripts/setup.mjs

@@ -331,6 +331,56 @@ function ensureCodexProfiles() {
   }
 }
 
+const GEMINI_DIR = join(homedir(), ".gemini");
+const GEMINI_PROFILES_PATH = join(GEMINI_DIR, "triflux-profiles.json");
+
+const DEFAULT_GEMINI_PROFILES = {
+  model: "gemini-3.1-pro-preview",
+  profiles: {
+    pro31:   { model: "gemini-3.1-pro-preview",   hint: "3.1 Pro — 플래그십 (1M ctx, 멀티모달)" },
+    flash3:  { model: "gemini-3-flash-preview",   hint: "3.0 Flash — 빠른 응답, 비용 효율" },
+    pro25:   { model: "gemini-2.5-pro",           hint: "2.5 Pro — 안정 (추론 강화)" },
+    flash25: { model: "gemini-2.5-flash",         hint: "2.5 Flash — 경량 범용" },
+    lite25:  { model: "gemini-2.5-flash-lite",    hint: "2.5 Flash Lite — 최경량" },
+  },
+};
+
+function ensureGeminiProfiles() {
+  try {
+    if (!existsSync(GEMINI_DIR)) mkdirSync(GEMINI_DIR, { recursive: true });
+
+    if (!existsSync(GEMINI_PROFILES_PATH)) {
+      writeFileSync(GEMINI_PROFILES_PATH, JSON.stringify(DEFAULT_GEMINI_PROFILES, null, 2) + "\n", "utf8");
+      return Object.keys(DEFAULT_GEMINI_PROFILES.profiles).length;
+    }
+
+    let cfg;
+    try {
+      cfg = JSON.parse(readFileSync(GEMINI_PROFILES_PATH, "utf8"));
+    } catch {
+      writeFileSync(GEMINI_PROFILES_PATH, JSON.stringify(DEFAULT_GEMINI_PROFILES, null, 2) + "\n", "utf8");
+      return Object.keys(DEFAULT_GEMINI_PROFILES.profiles).length;
+    }
+
+    if (!cfg.profiles) cfg.profiles = {};
+    let added = 0;
+    for (const [name, value] of Object.entries(DEFAULT_GEMINI_PROFILES.profiles)) {
+      if (!cfg.profiles[name]) {
+        cfg.profiles[name] = value;
+        added++;
+      }
+    }
+    if (!cfg.model) cfg.model = DEFAULT_GEMINI_PROFILES.model;
+
+    if (added > 0) {
+      writeFileSync(GEMINI_PROFILES_PATH, JSON.stringify(cfg, null, 2) + "\n", "utf8");
+    }
+    return added;
+  } catch {
+    return 0;
+  }
+}
+
 export { replaceProfileSection, hasProfileSection, detectDevMode, SYNC_MAP, BREADCRUMB_PATH, PLUGIN_ROOT, CLAUDE_DIR, SKILL_ALIASES };
 
 async function main() {
@@ -813,6 +863,13 @@ if (codexProfilesAdded > 0) {
   synced++;
 }
 
+// ── Gemini 프로필 자동 보정 ──
+
+const geminiProfilesAdded = ensureGeminiProfiles();
+if (geminiProfilesAdded > 0) {
+  synced++;
+}
+
 // ── MCP 인벤토리 백그라운드 갱신 ──
 
 const mcpCheck = join(PLUGIN_ROOT, "scripts", "mcp-check.mjs");

package/skills/star-prompt/SKILL.md

@@ -0,0 +1,122 @@
+---
+name: star-prompt
+description: >-
+  CLI 프로젝트의 setup/postinstall 흐름에 GitHub 스타 요청 프롬프트를 추가한다.
+  gh CLI 인증 확인 → 이미 스타 여부 감지 → 인터랙티브 confirm → gh API로 자동 스타.
+  Apple 스타일 UX 카피 포함. 'star prompt', '스타 요청', '리포 스타', 'star request',
+  '깃헙 스타 넣어줘', 'star 눌러달라고', '응원 요청' 같은 요청에 사용한다.
+---
+
+# tfx-star-prompt — GitHub Star Request Prompt
+
+CLI 도구의 setup 완료 시점에 GitHub 리포 스타를 요청하는 프롬프트를 추가한다.
+사용자 경험을 해치지 않으면서, 이미 스타한 사용자에겐 감사를 표하고, 아직 안 한 사용자에겐 부담 없이 한 번 물어본다.
+
+## 동작 흐름
+
+```
+gh auth status ─── 실패 → URL만 표시 (비인터랙티브 폴백)
+       │
+       ✓ 인증됨
+       │
+gh api user/starred/{owner}/{repo} ─── 성공 → "이미 함께하고 계시군요. ⭐"
+       │
+       ✗ 미스타
+       │
+confirm("⭐ 하나가 큰 차이를 만듭니다.") ─── N → URL 조용히 표시
+       │
+       Y
+       │
+gh api -X PUT /user/starred/{owner}/{repo} → "함께해 주셔서 감사합니다. ⭐"
+       │
+       실패 → URL 폴백
+```
+
+## 구현 패턴
+
+### 인터랙티브 (TUI / readline confirm)
+
+setup 위저드 완료 후 호출. `confirm()` 으로 Y/n 입력 받고 `gh api`로 자동 스타.
+
+```javascript
+async function starRequest() {
+  let ghOk = false;
+  try {
+    execFileSync("gh", ["auth", "status"], {
+      timeout: 5000, encoding: "utf8", stdio: ["pipe", "pipe", "pipe"],
+    });
+    ghOk = true;
+  } catch {}
+
+  if (!ghOk) {
+    // gh 미설치/미인증 — URL만 표시
+    info(`⭐ 하나가 큰 차이를 만듭니다. https://github.com/{owner}/{repo}`);
+    return;
+  }
+
+  let alreadyStarred = false;
+  try {
+    execFileSync("gh", ["api", "user/starred/{owner}/{repo}"], {
+      timeout: 5000, encoding: "utf8", stdio: ["pipe", "pipe", "pipe"],
+    });
+    alreadyStarred = true;
+  } catch {}
+
+  if (alreadyStarred) {
+    ok(`이미 함께하고 계시군요. ⭐`);
+    return;
+  }
+
+  if (await confirm(`⭐ 하나가 큰 차이를 만듭니다.`, true)) {
+    try {
+      execFileSync("gh", ["api", "-X", "PUT", "/user/starred/{owner}/{repo}"], {
+        timeout: 5000, stdio: ["pipe", "pipe", "pipe"],
+      });
+      ok(`함께해 주셔서 감사합니다. ⭐`);
+    } catch {
+      info(`https://github.com/{owner}/{repo}`);
+    }
+  } else {
+    // 거절 시 URL만 조용히
+    console.log(`     https://github.com/{owner}/{repo}`);
+  }
+}
+```
+
+### 비인터랙티브 (postinstall / CLI banner)
+
+confirm 불가한 환경. 이미 스타 여부만 감지하고 메시지 분기.
+
+```javascript
+try {
+  execFileSync("gh", ["auth", "status"], { timeout: 5000, stdio: ["pipe","pipe","pipe"] });
+  try {
+    execFileSync("gh", ["api", "user/starred/{owner}/{repo}"], { timeout: 5000, stdio: ["pipe","pipe","pipe"] });
+    ok(`이미 함께하고 계시군요. ⭐`);
+  } catch {
+    info(`⭐ 하나가 큰 차이를 만듭니다. https://github.com/{owner}/{repo}`);
+  }
+} catch {
+  info(`⭐ 하나가 큰 차이를 만듭니다. https://github.com/{owner}/{repo}`);
+}
+```
+
+## 적용 시 규칙
+
+1. `{owner}/{repo}`를 대상 리포로 치환한다
+2. 프로젝트의 기존 ANSI 컬러 상수(AMBER, CYAN, RESET 등)를 사용한다
+3. setup 완료 직후, 최종 요약 다음에 호출한다 — 핵심 설정 흐름을 방해하지 않는다
+4. 모든 gh 호출은 `timeout: 5000`, `stdio: ["pipe","pipe","pipe"]`로 감싸서 실패해도 setup을 블로킹하지 않는다
+5. 거절 시 죄책감을 주지 않는다 — URL만 조용히 남긴다
+
+## UX 카피 톤
+
+Apple 스타일: 짧고, 자신감 있고, 부담 없이.
+
+| 상황 | 멘트 |
+|------|------|
+| 이미 스타 | `이미 함께하고 계시군요. ⭐` |
+| 요청 | `⭐ 하나가 큰 차이를 만듭니다.` |
+| 수락 후 | `함께해 주셔서 감사합니다. ⭐` |
+| 거절 | URL만 |
+| gh 없음 | `⭐ 하나가 큰 차이를 만듭니다.` + URL |

package/skills/tfx-codex-swarm/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: tfx-codex-swarm
-description: OMX 스킬을 활용하는 Codex 다중 세션 스폰 오케스트레이터. PRD/태스크 파일을 스캔하여 각각 독립 git worktree + psmux 세션���로 Codex를 full-auto 실행한다. 'codex swarm', 'codex 다중', '코덱스 스웜', '코덱스 다중 실행', 'PRD 일괄 실행', 'codex spawn', '코덱스 스폰', '다중 코덱스', 'swarm codex', 'omx swarm' 같은 요청에 반드시 사용. PRD가 여러 개이거나 병렬 Codex 실행이 필요한 모든 상황에 적극 활용.
+description: OMX 스킬을 활용하는 Codex 다중 세션 스폰 오케스트레이터. PRD/태스크 파일을 스캔하여 각각 독립 git worktree + psmux 세션���로 Codex를 full-auto 실행한다. 'codex swarm', 'codex 다중', '코덱스 스웜', '코덱스 다중 실행', 'PRD 일괄 실행', 'codex spawn', '코덱스 스폰', '다중 코덱스', 'swarm codex', 'omx swarm', '새 창에서 진행', '새 창에서 prd', 'prd 부터', 'prd 실행', 'prd 돌려', '병렬로 돌려', 'worktree로 실행' 같은 요청에 반드시 사용. PRD가 여러 개이거나 병렬 Codex 실행이 필요한 모든 상황에 적극 활용.
 ---
 
 # tfx-codex-swarm — Codex 다중 세션 스폰 오케스트레이터
@@ -10,10 +10,11 @@ description: OMX 스킬을 활용하는 Codex 다중 세션 스폰 오케스트
 
 ## 전제 조건
 
-- `codex` CLI 설치됨
+- **`tfx-psmux-rules` 스킬 필수** — psmux 명령/런처 생성 시 이 스킬의 규칙을 반드시 준수
+- `codex` CLI 설치됨 (0.117.0+)
 - `psmux` 설치됨 (세션 관리)
 - `git` (worktree 생성)
-- Windows Terminal (`wt.exe` 탭 기반 attach)
+- Windows Terminal (`wt.exe` 패인 기반 attach)
 - MCP 싱글톤 데몬 (`supergateway` + `mcp-remote`) — 선택적이나 스웜 시 강력 권장
 
 ## 설정
@@ -176,18 +177,25 @@ PRD 파일을 읽고 아래 시그널에서 규모를 판단한다:
 |-------------|-----|-----|-----|-----|
 | **구현** | `codex53_xhigh` | `codex53_high` | `codex53_med` | `codex53_low` |
 | **조사** | `gpt54_high` | `gpt54_high` | `gpt54_low` | `mini54_med` |
-| **리팩터링** | `codex53_xhigh` | `codex53_high` | `codex53_med` | `spark53_med` |
-| **린트/포맷** | — | — | `spark53_med` | `spark53_low` |
+| **리팩터링** | `codex53_xhigh` | `codex53_high` | `codex53_med` | `codex53_low` |
+| **린트/포맷** | — | — | `codex53_low` | `codex53_low` |
 
-프로파일은 `~/.codex/config.toml`의 v9 체계(`{model}{ver}_{effort}`)를 `-p` 플래그로 직접 참조한다.
-`-c` 하드코딩은 사용하지 않는다. (레거시 `fast/normal/high` 프로파일도 사용하지 않는다.)
+> **NOTE**: `spark53_*` 프로파일은 Pro 구독 전용. 비-Pro 환경에서는 `codex53_low`로 폴백한다.
+
+프로파일 이름(`codex53_high` 등)은 `~/.codex/config.toml`에 정의된 프로파일이다.
+**모델·effort·실행모드는 인자로 하드코딩하지 않고 프로파일로 관리한다.**
+(→ tfx-psmux-rules RULE 4)
 
 ```bash
-# 예시: -p 플래그로 프로파일 지정
-codex -p codex53_high --dangerously-bypass-approvals-and-sandbox "prompt"
-codex -p gpt54_high --dangerously-bypass-approvals-and-sandbox "prompt"
+# 프로파일이 config.toml에 정의되어 있으면 깔끔하게 호출
+codex < prompt.md
+
+# 프로파일 관리: tfx-profile 스킬 또는 config.toml 직접 편집
 ```
 
+> **config.toml 중복 금지**: 이미 설정된 값을 CLI 플래그로 다시 지정하면 에러.
+> 런처 생성 전 config.toml 확인 필수.
+
 #### 4-3. 라우팅 결과 표시
 
 프로파일 결정 후 테이블로 표시한다:
@@ -221,7 +229,7 @@ options:
 
 | 설정 | 기본값 | 설명 |
 |------|--------|------|
-| 실행 모드 | `--dangerously-bypass-approvals-and-sandbox` | YOLO (승인+샌드박스 완전 해제). `--skip-git-repo-check`는 `codex exec` 전용이므로 대화식에서 사용 금지 |
+| 실행 모드 | `--full-auto` (config.toml 미설정 시만) | config.toml에 `approval_mode`/`sandbox` 이미 있으면 **생략 필수** (중복 에러). `--skip-git-repo-check`는 `codex exec` 전용 |
 | worktree | 활성화 | 세션당 독립 worktree |
 | psmux | 활성화 | 세션 관리 |
 
@@ -287,41 +295,94 @@ cp {PRD_PATH} .codex-swarm/wt-issue-{N}/{PRD_PATH}
 
 각 태스크에 대해 psmux 세션을 생성하고 Codex를 실행한다:
 
+> **CRITICAL — psmux 셸 = PowerShell**
+> psmux 세션의 기본 셸은 **PowerShell**이다. `cd '/c/...'`, `$(cat ...)`, `&&` 등
+> bash 문법을 `send-keys`로 직접 전달하면 경로 오류 + 인자 파싱 실패가 발생한다.
+> **반드시 `.sh` 런처 파일을 생성하고, PowerShell 구문으로 bash.exe 전체 경로를 호출해야 한다.**
+
+**실행 방식 2가지 (택 1):**
+
+**A) .sh 런처 + send-keys (권장)**
 ```bash
-# 세션 생성 (-s: 세션명, -d: detached 백그라운드)
-# psmux 기본 셸이 PowerShell이므로, bash 런처 스크립트를 PowerShell에서 호출
 psmux new-session -s "codex-swarm-{id}" -d
 
-# bash 런처를 PowerShell 구문으로 실행 (경로는 Windows 형식)
+# PowerShell 구문으로 bash.exe를 호출 — 경로는 반드시 Windows 형식
 BASH_WIN='C:\\Program Files\\Git\\bin\\bash.exe'
 LAUNCH_DIR='C:\\path\\to\\.codex-swarm'
 psmux send-keys -t "codex-swarm-{id}" \
   "& '$BASH_WIN' '$LAUNCH_DIR\\launch-{id}.sh'" Enter
+```
 
-# launch-{id}.sh 내용:
-#   #!/bin/bash
-#   cd /c/path/.codex-swarm/wt-issue-{N} || exit 1
-#   prompt=$(cat /c/path/.codex-swarm/prompts/prompt-{id}.md)
-#   exec codex -p {PROFILE} --dangerously-bypass-approvals-and-sandbox "$prompt"
-#
-# {PROFILE}은 Step 4 라우팅 결과: codex53_high, gpt54_high 등 (v9 체계)
-# --dangerously-bypass-approvals-and-sandbox: 진짜 YOLO (승인+샌드박스 완전 해제)
-# --skip-git-repo-check: codex exec 전용이므로 대화식 모드에서 사용 불가
+launch-{id}.sh:
+```bash
+#!/bin/bash
+cd /c/path/.codex-swarm/wt-issue-{N} || exit 1
+# stdin으로 프롬프트 전달 (-- 접두사 텍스트 파싱 회피)
+exec codex < /c/path/.codex-swarm/prompts/prompt-{id}.md
+# config.toml에 model/approval_mode 미설정 시만 플래그 추가:
+# exec codex -c 'model="gpt-5.3-codex"' -c 'model_reasoning_effort="high"' --full-auto < prompt.md
 ```
 
+**B) .ps1 런처 + send-keys**
+```bash
+psmux new-session -s "codex-swarm-{id}" -d
+psmux send-keys -t "codex-swarm-{id}" \
+  "& '.\\launch-{id}.ps1'" Enter
+```
+
+launch-{id}.ps1:
+```powershell
+Set-Location 'C:\path\.codex-swarm\wt-issue-{N}'
+# stdin 파이프로 전달 (& ; | -- 등 특수문자 안전)
+Get-Content 'C:\path\.codex-swarm\prompts\prompt-{id}.md' -Raw | codex
+# config.toml에 model 미설정 시만:
+# Get-Content 'prompt.md' -Raw | codex -c 'model="gpt-5.3-codex"' -c 'model_reasoning_effort="high"'
+```
+
+> **금지 패턴** (절대 사용하지 말 것):
+> ```bash
+> # WRONG — bash 문법을 PowerShell 세션에 직접 전달
+> psmux send-keys -t "codex-swarm-{id}" \
+>   "cd '/c/path/...' && codex -p profile \"$(cat prompt.md)\"" Enter
+> ```
+
+{PROFILE}은 Step 4 라우팅 결과 → `-c` 쌍으로 변환 (4-2 매핑 테이블 참조).
+실행 모드/모델 설정은 `~/.codex/config.toml` 우선. CLI 플래그는 미설정 항목만 추가.
+
 ### Step 8: WT attach
 
 > WT `triflux` 프로파일 사용 필수 (`commandline: "psmux"`, One Half Dark, acrylic).
-> 기본은 **split-pane 직접 attach**. 4개 이하 2x2 그리드, 5개 이상은 사용자 확인.
+> **새 탭(nt) 금지** — split + dashboard가 기본.
+
+**WT 레이아웃은 반드시 AskUserQuestion으로 먼저 확인한다:**
+
+```
+question: "WT 레이아웃을 선택하세요"
+header: "WT 배치"
+options:
+  - label: "새 창에서 스플릿"
+    description: "새 WT 윈도우를 열고 세션을 split-pane으로 배치"
+  - label: "현재 창에서 스플릿"
+    description: "현재 WT 윈도우(-w 0)에 split-pane 추가"
+  - label: "dashboard 모드"
+    description: "모니터링 전용 단일 패인 (10초 폴링)"
+  - label: "attach 안 함"
+    description: "psmux 세션만 생성, WT attach 생략"
+```
+
+선택에 따른 wt.exe 명령:
 
 ```bash
+# [새 창에서 스플릿] — wt -w new
+# [현재 창에서 스플릿] — wt -w 0
+
 # 2개: 상하 분할
-wt.exe -w 0 \
+wt.exe -w {WINDOW} \
   sp -H -p triflux --title "{t1}" psmux attach-session -t {id1} \; \
   sp -V -p triflux --title "{t2}" psmux attach-session -t {id2}
 
 # 4개: 2x2 그리드
-wt.exe -w 0 \
+wt.exe -w {WINDOW} \
   sp -H -p triflux --title "{t1}" psmux attach-session -t {id1} \; \
   sp -V -p triflux --title "{t2}" psmux attach-session -t {id2} \; \
   move-focus up \; \
@@ -330,7 +391,7 @@ wt.exe -w 0 \
   sp -V -p triflux --title "{t4}" psmux attach-session -t {id4}
 ```
 
-5개 이상이면 AskUserQuestion으로 확인 후 dashboard 모드 제안:
+5개 이상이면 dashboard 모드를 추천:
 ```bash
 # dashboard 모드 (모니터링 전용)
 wt.exe -w 0 -p triflux --title "swarm-dashboard" bash -c '
@@ -481,13 +542,26 @@ fi
 ## 정리
 
 전체 스웜 종료 시:
+
+> **WT 프리징 방지**: `kill-session` 전에 반드시 각 세션에 `exit`을 보내
+> 프로세스를 정상 종료시킨다. WT 패인이 attach 중인 상태에서 세션을
+> 강제 kill하면 WT가 응답 없음 상태로 전환될 수 있다.
+
 ```bash
-# 세션 종료
+# 1) graceful exit — 각 세션에 exit 전송 (WT 패인 자연 종료 유도)
+for s in $(psmux list-sessions -F '#{session_name}' 2>/dev/null | grep codex-swarm); do
+  psmux send-keys -t "$s" "exit" Enter 2>/dev/null || true
+done
+
+# 2) 프로세스 종료 대기 (WT 패인이 닫힐 시간 확보)
+sleep 2
+
+# 3) 잔여 세션 강제 종료 (exit이 먹히지 않은 경우)
 for s in $(psmux list-sessions -F '#{session_name}' 2>/dev/null | grep codex-swarm); do
-  psmux kill-session -t "$s"
+  psmux kill-session -t "$s" 2>/dev/null || true
 done
 
-# worktree 정리 (머지 완료된 것만)
+# 4) worktree 정리 (머지 완료된 것만)
 git worktree prune
 rm -rf .codex-swarm/
 ```

package/skills/tfx-psmux-rules/SKILL.md

@@ -0,0 +1,208 @@
+---
+name: tfx-psmux-rules
+description: >
+  psmux + Codex CLI 명령 생성 시 반드시 적용되는 강제 규칙. PowerShell/bash 구분,
+  경로 형식, 인자 이스케이프, WT 정리, 프로파일 지정 방식 등을 검증한다.
+  이 스킬은 psmux, send-keys, codex exec, codex spawn, 세션 생성, worktree 실행,
+  launch 스크립트 생성, WT attach, 패널 스플릿, 스웜 정리 시 자동 트리거된다.
+  다른 스킬(tfx-codex-swarm, tfx-multi, tfx-remote-spawn 등)이 psmux 명령을
+  생성할 때 이 스킬의 규칙을 위반하면 생성을 중단하고 수정해야 한다.
+triggers:
+  - tfx-psmux-rules
+  - psmux-rules
+---
+
+# tfx-psmux-rules — psmux + Codex CLI 강제 규칙
+
+> **이 스킬은 참고 문서가 아니다. 강제 규칙이다.**
+> psmux 명령, launch 스크립트, Codex CLI 호출을 생성하는 모든 스킬은
+> 아래 규칙을 **반드시** 준수해야 한다. 위반 시 생성을 중단하고 수정한다.
+
+## 적용 시점
+
+다음 행위 중 하나라도 수행할 때 이 규칙이 자동 적용된다:
+- `psmux send-keys` 명령 생성
+- `launch-*.sh` 또는 `launch-*.ps1` 스크립트 생성
+- `codex` CLI 호출 인자 조합
+- `wt.exe` 탭/패인 명령 생성
+- 스웜 세션 정리
+
+---
+
+## RULE 1: psmux 기본 셸 = PowerShell
+
+psmux 세션의 기본 셸은 **PowerShell**이다.
+
+### MUST NOT (금지)
+
+```bash
+# WRONG — bash 문법을 PowerShell 세션에 직접 전달
+psmux send-keys -t session "cd '/c/Users/...' && codex ..." Enter
+psmux send-keys -t session "prompt=\$(cat file.md)" Enter
+psmux send-keys -t session "export FOO=bar" Enter
+```
+
+### MUST (필수)
+
+```bash
+# CORRECT — PowerShell 구문으로 bash.exe 전체 경로 호출
+BASH_WIN='C:\\Program Files\\Git\\bin\\bash.exe'
+psmux send-keys -t session "& '$BASH_WIN' './launch.sh'" Enter
+
+# CORRECT — PowerShell 네이티브 명령 사용
+psmux send-keys -t session "Set-Location 'C:\\path'" Enter
+psmux send-keys -t session "\$p = Get-Content 'file.md' -Raw" Enter
+```
+
+### 금지 패턴 체크리스트
+
+| 패턴 | 문제 | 대체 |
+|------|------|------|
+| `cd '/c/...'` | PS가 `/c/`를 상대경로로 해석 → `C:\c\...` | `Set-Location 'C:\...'` |
+| `$(cat file)` | bash 명령 치환, PS에서 `Get-Content` 호출됨 | `$p = Get-Content file -Raw` |
+| `&&` | PS7에서 작동하지만 앞 명령 실패 시 의미 다름 | `;` 또는 별도 send-keys |
+| `export VAR=val` | bash 전용 | `$env:VAR = 'val'` |
+| `grep`, `awk`, `sed` | bash 유틸리티 | PS cmdlet 또는 bash.exe 경유 |
+
+---
+
+## RULE 2: 경로는 Windows 형식
+
+psmux send-keys로 전달하는 경로는 반드시 **Windows 형식**이다.
+
+```
+WRONG:  /c/Users/SSAFY/Desktop/Projects/...
+RIGHT:  C:\Users\SSAFY\Desktop\Projects\...
+```
+
+`.sh` 런처 내부에서만 Unix 경로(`/c/...`) 사용 가능.
+
+---
+
+## RULE 3: 프롬프트 인자 인용 필수
+
+PRD/프롬프트 내용을 CLI 인자로 전달할 때 **반드시 인용**한다.
+
+### PowerShell (.ps1)
+
+```powershell
+$p = (Get-Content 'prompt.md' -Raw) -replace "`r`n"," " -replace "`n"," "
+
+# MUST — 인용 필수
+codex -c 'model="gpt-5.3-codex"' "$p"
+
+# MUST NOT — 미인용 시 & ; | 등이 PS 연산자로 해석됨
+codex -c 'model="gpt-5.3-codex"' $p
+```
+
+### Bash (.sh)
+
+```bash
+prompt=$(cat prompt.md)
+
+# MUST — 더블쿼트 필수
+exec codex "$prompt"
+
+# MUST NOT — 워드 스플리팅 + 글로빙 발생
+exec codex $prompt
+```
+
+---
+
+## RULE 4: 프로파일 사용, 인자 하드코딩 금지
+
+Codex든 Gemini든 **모델·effort·실행모드는 프로파일(config)로 관리**한다.
+CLI 인자로 하드코딩하지 않는다.
+
+### 4-1. 프로파일 우선
+
+```bash
+# CORRECT — 프로파일에 model/effort/approval_mode 모두 정의해두고 호출
+codex < prompt.md
+codex --full-auto < prompt.md   # config.toml에 approval_mode 미설정 시만
+
+# WRONG — 인자로 모델·effort 하드코딩
+codex -c 'model="gpt-5.3-codex"' -c 'model_reasoning_effort="high"' "prompt"
+```
+
+프로파일 관리는 `tfx-profile` 스킬 또는 `~/.codex/config.toml` 직접 편집.
+
+### 4-2. config.toml 중복 플래그 금지
+
+config.toml에 이미 설정된 값을 CLI 플래그로 다시 지정하면 **에러**:
+```
+error: the argument '--dangerously-bypass-approvals-and-sandbox' cannot be used multiple times
+```
+
+**규칙**: 런처 생성 전 config.toml을 확인하고, 이미 있는 항목은 CLI에서 생략.
+
+### 4-3. 프롬프트는 stdin으로 전달
+
+프롬프트를 CLI 인자로 넘기면 `--` 접두사 텍스트가 플래그로 파싱되는 문제 발생.
+**항상 stdin(파이프 또는 리다이렉션)으로 전달한다.**
+
+```bash
+# bash 런처
+exec codex < /c/path/prompts/prompt.md
+```
+
+```powershell
+# PS1 런처
+Get-Content 'C:\path\prompts\prompt.md' -Raw | codex
+```
+
+---
+
+## RULE 5: WT 패인 정리 (프리징 방지)
+
+WT 패인이 psmux 세션에 attach된 상태에서 `kill-session`하면 WT가 프리징된다.
+
+### MUST (3단계 정리)
+
+```bash
+# 1) graceful exit
+for s in $(psmux list-sessions -F '#{session_name}' 2>/dev/null | grep codex-swarm); do
+  psmux send-keys -t "$s" "exit" Enter 2>/dev/null || true
+done
+
+# 2) WT 패인 종료 대기
+sleep 2
+
+# 3) 잔여 세션 강제 종료
+for s in $(psmux list-sessions -F '#{session_name}' 2>/dev/null | grep codex-swarm); do
+  psmux kill-session -t "$s" 2>/dev/null || true
+done
+```
+
+### MUST NOT
+
+```bash
+# WRONG — WT 프리징 발생
+for s in $(psmux list-sessions -F '#{session_name}' 2>/dev/null | grep codex-swarm); do
+  psmux kill-session -t "$s"
+done
+```
+
+---
+
+## RULE 6: spark53 프로파일은 Pro 전용
+
+`spark53_med`, `spark53_low` 등 spark 모델 프로파일은 **Codex Pro 구독 전용**이다.
+비-Pro 환경에서는 `codex53_low`로 폴백한다.
+
+---
+
+## RULE 7: WT 레이아웃 선택 필수
+
+WT에 패인을 배치하기 전에 **반드시** 사용자에게 레이아웃을 확인한다.
+새 탭(`nt`)은 금지 — split + dashboard가 기본.
+
+선택지: 새 창에서 스플릿 / 현재 창에서 스플릿 / dashboard / attach 안 함
+
+---
+
+## 위반 감지 시 행동
+
+1. 생성한 명령/스크립트가 위 규칙을 위반하면 **즉시 수정**한다
+2. 수정 불가능하면 **생성을 중단**하고 사용자에게 알린다
+3. 다른 스킬이 이 규칙을 무시하고 명령을 생성하면 **경고를 출력**한다

package/tui/setup.mjs

@@ -326,6 +326,56 @@ function showSummary(results) {
   }
 }
 
+// ── Star Request ──
+
+async function starRequest() {
+  let ghOk = false;
+  try {
+    execFileSync("gh", ["auth", "status"], {
+      timeout: 5000, encoding: "utf8", stdio: ["pipe", "pipe", "pipe"],
+    });
+    ghOk = true;
+  } catch {}
+
+  if (!ghOk) {
+    console.log();
+    info(`${AMBER}⭐${RESET} 하나가 큰 차이를 만듭니다. ${CYAN}https://github.com/tellang/triflux${RESET}`);
+    console.log();
+    return;
+  }
+
+  // gh 인증됨 — 스타 여부 확인
+  let alreadyStarred = false;
+  try {
+    execFileSync("gh", ["api", "user/starred/tellang/triflux"], {
+      timeout: 5000, encoding: "utf8", stdio: ["pipe", "pipe", "pipe"],
+    });
+    alreadyStarred = true;
+  } catch {}
+
+  console.log();
+
+  if (alreadyStarred) {
+    ok(`이미 함께하고 계시군요. ${AMBER}⭐${RESET}`);
+    console.log();
+    return;
+  }
+
+  if (await confirm(`${AMBER}⭐${RESET} 하나가 큰 차이를 만듭니다.`, true)) {
+    try {
+      execFileSync("gh", ["api", "-X", "PUT", "/user/starred/tellang/triflux"], {
+        timeout: 5000, stdio: ["pipe", "pipe", "pipe"],
+      });
+      ok(`함께해 주셔서 감사합니다. ${AMBER}⭐${RESET}`);
+    } catch {
+      info(`${CYAN}https://github.com/tellang/triflux${RESET}`);
+    }
+  } else {
+    console.log(`     ${DIM}${CYAN}https://github.com/tellang/triflux${RESET}`);
+  }
+  console.log();
+}
+
 // ── Main Menu ──
 
 const MENU = [
@@ -357,6 +407,7 @@ async function main() {
       case 0: {
         const results = await runWizard();
         showSummary(results);
+        await starRequest();
         break;
       }