triflux 8.11.2 → 8.12.2

package/skills/tfx-codex-swarm-workspace/iteration-1/selective-spawn-with-override/without_skill/outputs/routing.md

@@ -0,0 +1,61 @@
+# Codex Swarm - Profile Routing (Selective: Issue 24, 28 with xhigh override)
+
+> Generated: 2026-03-30
+> Mode: without_skill (no SKILL.md guidance)
+
+## Size Assessment
+
+| # | PRD File | Lines | Affected Files | High-cost Keywords | Dependencies | Size |
+|---|----------|-------|----------------|-------------------|--------------|------|
+| 24 | prd-issue-24 | 73 | 4 (`remote-spawn.mjs`, handoff, scp, staging) | 0 | none | **L** |
+| 28 | prd-issue-28 | 69 | 4 (`headless-guard.mjs`, `hub/team/psmux.mjs`, codex, gemini) | 0 | none | **L** |
+
+Both PRDs fall in the **L (standard)** range.
+
+## Default Routing (what auto-routing would produce)
+
+Under normal routing for L-size implement tasks:
+
+| # | Task | Size | Type | Auto Profile | Auto Flags |
+|---|------|------|------|-------------|------------|
+| 24 | file-transfer | L | implement | `codex53_high` | `-c 'model="gpt-5.3-codex"' -c 'model_reasoning_effort="high"'` |
+| 28 | guard-deadlock | L | implement | `codex53_high` | `-c 'model="gpt-5.3-codex"' -c 'model_reasoning_effort="high"'` |
+
+## Applied Routing (after user xhigh override)
+
+User directive: "둘 다 xhigh로 세팅하고" overrides the auto-routed `codex53_high` to `codex53_xhigh`.
+
+| # | Task | Size | Type | Profile | Codex Flags |
+|---|------|------|------|---------|-------------|
+| 24 | file-transfer | L | implement | **`codex53_xhigh`** | `-c 'model="gpt-5.3-codex"' -c 'model_reasoning_effort="xhigh"'` |
+| 28 | guard-deadlock | L | implement | **`codex53_xhigh`** | `-c 'model="gpt-5.3-codex"' -c 'model_reasoning_effort="xhigh"'` |
+
+### Profile Resolution
+
+`codex53_xhigh` maps to the existing Codex config profile `[profiles.codex53_xhigh]`:
+```toml
+[profiles.codex53_xhigh]
+model = "gpt-5.3-codex"
+model_reasoning_effort = "xhigh"
+```
+
+This profile exists in `~/.codex/config.toml`, so either `-c` inline flags or `--profile codex53_xhigh` can be used.
+
+## Execution Defaults
+
+| Setting | Value | Note |
+|---------|-------|------|
+| Mode | `--full-auto` | Sandbox auto-approve (YOLO) |
+| Worktree | enabled | Per-session independent worktree |
+| psmux | enabled | Session management via send-keys |
+| WT | 2 tabs in single window | Only 2 sessions (not 7) |
+| OMX skill | `$ralph` | Persist loop until task fully complete |
+
+## Cost / Duration Estimate
+
+| Factor | Value |
+|--------|-------|
+| Model | gpt-5.3-codex (SWE-Bench 72%, Terminal-Bench 77%) |
+| Effort | xhigh (maximum reasoning, slowest) |
+| Sessions | 2 concurrent |
+| Expected duration | 15-45 min per session (xhigh adds ~2-3x vs high) |

package/skills/tfx-codex-swarm-workspace/iteration-1/selective-spawn-with-override/without_skill/timing.json

@@ -0,0 +1,5 @@
+{
+  "total_tokens": 65928,
+  "duration_ms": 259460,
+  "total_duration_seconds": 259.5
+}

package/skills/tfx-profile/SKILL.md

@@ -1,22 +1,43 @@
 ---
 name: tfx-profile
 description: >
-  Codex CLI 프로파일/모델 관리 인터랙티브 UI. tfx-route가 사용하는
+  Codex/Gemini CLI 프로파일·모델 관리 인터랙티브 UI. tfx-route가 사용하는
   프로파일 목록 조회, 모델 변경, effort 조정, 추가/삭제를 AskUserQuestion 기반
   인터랙티브 선택지로 수행합니다.
-  Use when: codex profile, codex model, 프로파일 변경, 모델 변경, effort 변경,
-  codex 설정, profile manager, 프로파일 관리, 어떤 모델, tfx profile
+  Use when: codex profile, codex model, gemini profile, gemini model,
+  프로파일 변경, 모델 변경, effort 변경, codex 설정, gemini 설정,
+  profile manager, 프로파일 관리, 어떤 모델, tfx profile
 triggers:
   - tfx-profile
-argument-hint: "[--list]"
+argument-hint: "[--list] [--codex | --gemini]"
 ---
 
-# codex-profile — Codex 프로파일 매니저
+# tfx-profile — Codex/Gemini 프로파일 매니저
 
-> Codex CLI 프로파일의 모델/effort를 AskUserQuestion 선택지로 관리합니다.
+> CLI 프로파일의 모델/effort를 AskUserQuestion 선택지로 관리합니다.
+> Codex(`~/.codex/config.toml`)와 Gemini(`~/.gemini/triflux-profiles.json`) 모두 지원.
 
 ## 워크플로우
 
+### Step 0: CLI 선택
+
+인자에 `--codex` 또는 `--gemini`가 있으면 해당 CLI로 직행.
+없으면 AskUserQuestion으로 선택:
+
+```
+question: "어느 CLI의 프로파일을 관리하시겠습니까?"
+header: "CLI"
+options:
+  - label: "Codex"
+    description: "~/.codex/config.toml (TOML)"
+  - label: "Gemini"
+    description: "~/.gemini/triflux-profiles.json (JSON)"
+```
+
+---
+
+## Codex 워크플로우
+
 ### Step 1: config.toml 읽기 + 현재 상태 표시
 
 `~/.codex/config.toml`을 Read 도구로 읽고 프로파일 테이블을 마크다운으로 출력한다:
@@ -32,8 +53,6 @@ argument-hint: "[--list]"
 
 ### Step 2: 작업 선택 (AskUserQuestion)
 
-AskUserQuestion으로 메인 메뉴를 제시한다:
-
 ```
 question: "어떤 작업을 하시겠습니까?"
 header: "작업"
@@ -52,68 +71,115 @@ options:
 
 #### 프로파일 모델 변경
 
-1. AskUserQuestion으로 프로파일 선택 (현재 프로파일 목록에서 2-4개씩 나눠서, 또는 "Other"로 직접 입력)
+1. AskUserQuestion으로 프로파일 선택
 2. AskUserQuestion으로 모델 선택:
    ```
-   question: "모델을 선택하세요"
-   header: "Model"
    options:
-     - label: "gpt-5.4"
-       description: "최신 플래그십"
-     - label: "gpt-5.3-codex"
-       description: "코딩 특화 (Recommended)"
-     - label: "gpt-5.1-codex-mini"
-       description: "경량 Spark"
-     - label: "o3"
-       description: "추론 특화"
+     - label: "gpt-5.4"         → 최신 플래그십
+     - label: "gpt-5.3-codex"   → 코딩 특화 (Recommended)
+     - label: "gpt-5.1-codex-mini" → 경량 Spark
+     - label: "o3"              → 추론 특화
+     - label: "o4-mini"         → 추론 경량
    ```
-3. AskUserQuestion으로 effort 선택:
+3. AskUserQuestion으로 effort 선택: `low | medium | high | xhigh`
+4. Edit 도구로 config.toml 수정
+
+#### 기본 모델 변경
+
+위와 동일한 모델/effort 선택 후 top-level `model`, `model_reasoning_effort` 수정.
+
+#### 프로파일 추가/삭제
+
+추가: 이름 → 모델 → effort → `[profiles.name]` 섹션 추가
+삭제: 선택 → 확인 → 섹션 제거
+
+### Step 4: 결과 확인
+
+변경된 config.toml을 다시 읽어 업데이트된 테이블 표시.
+
+---
+
+## Gemini 워크플로우
+
+### Step 1: triflux-profiles.json 읽기 + 현재 상태 표시
+
+`~/.gemini/triflux-profiles.json`을 Read 도구로 읽고 프로필 테이블을 마크다운으로 출력한다:
+
+```
+| 프로필 | 모델 | 설명 |
+|--------|------|------|
+| pro31  | gemini-3.1-pro-preview | 3.1 Pro — 플래그십 |
+| flash3 | gemini-3-flash-preview | 3.0 Flash — 빠른 응답 |
+| ...    | ...                    | ...                 |
+```
+
+기본 모델(top-level `model`)도 함께 표시.
+
+### Step 2: 작업 선택 (AskUserQuestion)
+
+```
+question: "어떤 작업을 하시겠습니까?"
+header: "작업"
+options:
+  - label: "프로필 모델 변경"
+    description: "기존 프로필의 모델을 수정"
+  - label: "기본 모델 변경"
+    description: "top-level default 모델 수정"
+  - label: "프로필 추가"
+    description: "새 프로필 생성"
+  - label: "프로필 삭제"
+    description: "기존 프로필 제거"
+```
+
+### Step 3: 선택에 따른 세부 플로우
+
+#### 프로필 모델 변경
+
+1. AskUserQuestion으로 프로필 선택
+2. AskUserQuestion으로 모델 선택:
    ```
-   question: "Reasoning Effort 레벨을 선택하세요"
-   header: "Effort"
    options:
-     - label: "low"
-       description: "빠른 응답, 최소 추론"
-     - label: "medium"
-       description: "균형 잡힌 추론"
-     - label: "high"
-       description: "깊은 추론"
-     - label: "xhigh"
-       description: "최대 추론 (느림)"
+     - label: "gemini-3.1-pro-preview"   → 3.1 Pro — 플래그십
+     - label: "gemini-3-flash-preview"   → 3.0 Flash — 빠른 응답
+     - label: "gemini-2.5-pro"           → 2.5 Pro — 안정
+     - label: "gemini-2.5-flash"         → 2.5 Flash — 경량
+     - label: "gemini-2.5-flash-lite"    → 2.5 Flash Lite — 최경량
    ```
-4. 변경 diff를 preview로 보여주고 Edit 도구로 config.toml 수정
+3. Edit 도구로 triflux-profiles.json 수정
 
 #### 기본 모델 변경
 
-위와 동일한 모델/effort 선택 후 top-level `model`, `model_reasoning_effort` 수정.
+모델 선택 후 top-level `model` 수정.
 
-#### 프로파일 추가
+#### 프로필 추가/삭제
 
-1. AskUserQuestion(Other)으로 프로파일 이름 입력
-2. 모델 선택 → effort 선택
-3. config.toml 끝에 새 `[profiles.name]` 섹션 추가
+추가: 이름 → 모델 → 설명 → profiles에 추가
+삭제: 선택 → 확인 → profiles에서 제거
 
-#### 프로파일 삭제
+### Step 4: 결과 확인
 
-1. 프로파일 선택
-2. AskUserQuestion 확인: "정말 삭제하시겠습니까?"
-3. 해당 섹션 제거
+변경된 JSON을 다시 읽어 업데이트된 테이블 표시.
 
-### Step 4: 결과 확인
+---
 
-변경된 config.toml을 다시 읽어 업데이트된 테이블 표시.
-"계속하시겠습니까?" AskUserQuestion → 반복 또는 종료.
+## 수정 규칙
 
-## config.toml 수정 규칙
+### Codex (config.toml)
 
-- **백업 필수**: 수정 전 원본 내용을 기억해둘 것 (rollback 가능하도록)
+- **백업 필수**: 수정 전 원본 기억
 - **프로파일 섹션 형식**: `[profiles.name]\nmodel = "..."\nmodel_reasoning_effort = "..."`
-- **다른 섹션 건드리지 않기**: `[notice]`, `[features]`, `[mcp_servers.*]`, `[projects.*]` 등은 절대 수정 금지
+- **다른 섹션 건드리지 않기**: `[notice]`, `[features]`, `[mcp_servers.*]` 등 절대 수정 금지
 - **Edit 도구 사용**: old_string → new_string으로 정확한 섹션만 치환
 
+### Gemini (triflux-profiles.json)
+
+- **백업 필수**: `.bak` 자동 생성
+- **JSON 형식 유지**: `profiles.{name}.model`, `profiles.{name}.hint`
+- **Edit 도구 사용**: old_string → new_string으로 해당 프로필만 치환
+
 ## 참조
 
-### 알려진 모델
+### Codex 모델
 
 | 모델 | 용도 |
 |------|------|
@@ -123,7 +189,7 @@ options:
 | o3 | 추론 특화 |
 | o4-mini | 추론 경량 |
 
-### Effort 레벨
+### Codex Effort 레벨
 
 | 레벨 | 설명 |
 |------|------|
@@ -132,18 +198,42 @@ options:
 | high | 깊은 추론 |
 | xhigh | 최대 추론 (느림) |
 
-### config.toml 경로
+### Gemini 모델
+
+| 모델 | 용도 |
+|------|------|
+| gemini-3.1-pro-preview | 3.1 Pro — 플래그십 (1M ctx) |
+| gemini-3-flash-preview | 3.0 Flash — 빠른 응답, 비용 효율 |
+| gemini-2.5-pro | 2.5 Pro — 안정 (추론 강화) |
+| gemini-2.5-flash | 2.5 Flash — 경량 범용 |
+| gemini-2.5-flash-lite | 2.5 Flash Lite — 최경량 |
+
+### Gemini → 에이전트 배치 (벤치마크 기반)
+
+| 프로필 | 모델 | 에이전트 |
+|--------|------|----------|
+| pro31 | gemini-3.1-pro-preview | executor, debugger, deep-executor, architect, planner, critic, analyst, code-reviewer, security-reviewer, quality-reviewer, scientist-deep, designer |
+| flash3 | gemini-3-flash-preview | writer, build-fixer, spark, 기본 폴백 |
+| pro25 | gemini-2.5-pro | (예비 — 3.1 불안정 시 폴백) |
+| flash25 | gemini-2.5-flash | (예비 — 대량 배치) |
+| lite25 | gemini-2.5-flash-lite | (예비 — 최경량) |
+
+### 설정 파일 경로
 
-`~/.codex/config.toml` (`$HOME/.codex/config.toml`)
+- Codex: `~/.codex/config.toml`
+- Gemini: `~/.gemini/triflux-profiles.json`
 
 ## 에러 처리
 
 | 상황 | 처리 |
 |------|------|
 | config.toml 미존재 | `/tfx-setup` 안내 |
+| triflux-profiles.json 미존재 | 기본값으로 자동 생성 |
 | 파싱 실패 | 백업 후 수동 수정 안내 |
 | 중복 프로파일명 | 이미 존재함 알림, 기존 편집으로 전환 |
 
 ## standalone TUI
 
-터미널에서 직접 실행도 가능: `node tui/codex-profile.mjs` (arrow key 방식)
+터미널에서 직접 실행:
+- Codex: `node tui/codex-profile.mjs`
+- Gemini: `node tui/gemini-profile.mjs`

package/skills/tfx-qa/SKILL.md

@@ -1,117 +1,117 @@
----
-name: tfx-qa
-description: "테스트 실행하고 실패하면 수정해서 통과시켜야 할 때 사용한다. 'qa', '검증해', '테스트 돌려', 'test-fix', '테스트 통과시켜' 같은 요청에 반드시 사용. 테스트 실패를 반복 수정하여 전부 통과시켜야 할 때 적극 활용."
-triggers:
-  - qa
-  - 검증
-  - 테스트 검증
-  - test-fix
-argument-hint: "[테스트 명령 또는 파일 경로]"
----
-
-# tfx-qa — Light Test-Fix Cycle
-
-> 테스트 실행 → 실패 분석 → 자동 수정 → 재실행. 최대 3회. OMC ultraqa 영감.
-
-## 용도
-
-- 테스트 실행 후 실패 자동 수정
-- CI 실패 빠른 해결
-- 리팩터링 후 회귀 검증 + 수정
-- "테스트 돌려서 깨진 거 고쳐" 류의 요청
-
-## 워크플로우
-
-### Step 1: 테스트 대상 식별
-
-```
-우선순위:
-  1. 사용자가 테스트 명령 지정 → 그대로 실행
-  2. 사용자가 파일 지정 → 해당 파일의 테스트 탐색
-  3. 지정 없음 → 프로젝트 테스트 전체 (npm test / pytest 등 자동 감지)
-
-자동 감지:
-  package.json의 "test" 스크립트 → npm test
-  pytest.ini / pyproject.toml → pytest
-  Makefile의 test 타깃 → make test
-```
-
-### Step 2: 테스트 실행 (Round 1)
-
-```bash
-bash ~/.claude/scripts/tfx-route.sh codex \
-  "다음 테스트를 실행하고 결과를 보고하라:
-   명령: {test_command}
-
-   출력 형식:
-   - 총 테스트 수
-   - 통과/실패/스킵 수
-   - 실패한 테스트 목록 (파일:테스트명:에러 메시지)
-   - 실패 원인 분석 (각 실패별)" implement
-```
-
-### Step 3: 실패 수정 + 재실행 루프
-
-```
-MAX_RETRIES = 3
-retry = 0
-
-WHILE (failures > 0 AND retry < MAX_RETRIES):
-  retry++
-
-  Codex로 실패 수정:
-    bash ~/.claude/scripts/tfx-route.sh codex \
-    "다음 테스트 실패를 수정하라:
-     실패 목록: {failures}
-
-     규칙:
-     - 테스트 코드가 아닌 구현 코드를 수정하라 (테스트가 정확한 경우)
-     - 테스트 자체가 잘못된 경우만 테스트를 수정하라
-     - 수정 후 해당 테스트를 다시 실행하여 확인하라" implement
-
-  재실행하여 결과 확인
-
-END WHILE
-```
-
-### Step 4: 결과 보고
-
-```markdown
-## QA 결과: {test_target}
-
-### 실행 요약
-| 라운드 | 통과 | 실패 | 수정 |
-|--------|------|------|------|
-| Round 1 | {n} | {n} | — |
-| Round 2 | {n} | {n} | {수정 내용} |
-| Round 3 | {n} | {n} | {수정 내용} |
-
-### 최종 결과
-- 테스트: {pass}/{total} 통과
-- 수정된 파일: {list}
-- 미해결 실패: {list, 있으면}
-
-### 수정 상세
-- `{file}:{line}` — {무엇을 왜 수정했는지}
-```
-
-3회 후에도 실패가 남으면 미해결 목록 + 원인 분석을 사용자에게 보고.
-
-## 토큰 예산
-
-| 단계 | 토큰 |
-|------|------|
-| Step 1 (식별) | ~300 |
-| Step 2 (실행) | ~1.5K |
-| Step 3 (수정, 회당) | ~1.5K |
-| Step 4 (보고) | ~500 |
-| **총합 (최대 3회)** | **~5K** |
-
-## 사용 예
-
-```
-/tfx-qa
-/tfx-qa "npm test -- --grep auth"
-/tfx-qa "pytest tests/test_api.py -v"
-/tfx-qa "깨진 테스트 고쳐줘"
-```
+---
+name: tfx-qa
+description: "테스트 실행하고 실패하면 수정해서 통과시켜야 할 때 사용한다. 'qa', '검증해', '테스트 돌려', 'test-fix', '테스트 통과시켜' 같은 요청에 반드시 사용. 테스트 실패를 반복 수정하여 전부 통과시켜야 할 때 적극 활용."
+triggers:
+  - qa
+  - 검증
+  - 테스트 검증
+  - test-fix
+argument-hint: "[테스트 명령 또는 파일 경로]"
+---
+
+# tfx-qa — Light Test-Fix Cycle
+
+> 테스트 실행 → 실패 분석 → 자동 수정 → 재실행. 최대 3회. OMC ultraqa 영감.
+
+## 용도
+
+- 테스트 실행 후 실패 자동 수정
+- CI 실패 빠른 해결
+- 리팩터링 후 회귀 검증 + 수정
+- "테스트 돌려서 깨진 거 고쳐" 류의 요청
+
+## 워크플로우
+
+### Step 1: 테스트 대상 식별
+
+```
+우선순위:
+  1. 사용자가 테스트 명령 지정 → 그대로 실행
+  2. 사용자가 파일 지정 → 해당 파일의 테스트 탐색
+  3. 지정 없음 → 프로젝트 테스트 전체 (npm test / pytest 등 자동 감지)
+
+자동 감지:
+  package.json의 "test" 스크립트 → npm test
+  pytest.ini / pyproject.toml → pytest
+  Makefile의 test 타깃 → make test
+```
+
+### Step 2: 테스트 실행 (Round 1)
+
+```bash
+bash ~/.claude/scripts/tfx-route.sh codex \
+  "다음 테스트를 실행하고 결과를 보고하라:
+   명령: {test_command}
+
+   출력 형식:
+   - 총 테스트 수
+   - 통과/실패/스킵 수
+   - 실패한 테스트 목록 (파일:테스트명:에러 메시지)
+   - 실패 원인 분석 (각 실패별)" implement
+```
+
+### Step 3: 실패 수정 + 재실행 루프
+
+```
+MAX_RETRIES = 3
+retry = 0
+
+WHILE (failures > 0 AND retry < MAX_RETRIES):
+  retry++
+
+  Codex로 실패 수정:
+    bash ~/.claude/scripts/tfx-route.sh codex \
+    "다음 테스트 실패를 수정하라:
+     실패 목록: {failures}
+
+     규칙:
+     - 테스트 코드가 아닌 구현 코드를 수정하라 (테스트가 정확한 경우)
+     - 테스트 자체가 잘못된 경우만 테스트를 수정하라
+     - 수정 후 해당 테스트를 다시 실행하여 확인하라" implement
+
+  재실행하여 결과 확인
+
+END WHILE
+```
+
+### Step 4: 결과 보고
+
+```markdown
+## QA 결과: {test_target}
+
+### 실행 요약
+| 라운드 | 통과 | 실패 | 수정 |
+|--------|------|------|------|
+| Round 1 | {n} | {n} | — |
+| Round 2 | {n} | {n} | {수정 내용} |
+| Round 3 | {n} | {n} | {수정 내용} |
+
+### 최종 결과
+- 테스트: {pass}/{total} 통과
+- 수정된 파일: {list}
+- 미해결 실패: {list, 있으면}
+
+### 수정 상세
+- `{file}:{line}` — {무엇을 왜 수정했는지}
+```
+
+3회 후에도 실패가 남으면 미해결 목록 + 원인 분석을 사용자에게 보고.
+
+## 토큰 예산
+
+| 단계 | 토큰 |
+|------|------|
+| Step 1 (식별) | ~300 |
+| Step 2 (실행) | ~1.5K |
+| Step 3 (수정, 회당) | ~1.5K |
+| Step 4 (보고) | ~500 |
+| **총합 (최대 3회)** | **~5K** |
+
+## 사용 예
+
+```
+/tfx-qa
+/tfx-qa "npm test -- --grep auth"
+/tfx-qa "pytest tests/test_api.py -v"
+/tfx-qa "깨진 테스트 고쳐줘"
+```

package/skills/tfx-remote-spawn/references/hosts.json

@@ -1,16 +1,16 @@
-{
-  "hosts": {
-    "ultra4": {
-      "description": "Windows 데스크탑 (SSAFY)",
-      "aliases": ["울트라", "데스크탑"],
-      "default_dir": "~/Desktop/Projects"
-    },
-    "m2": {
-      "description": "MacBook Pro",
-      "aliases": ["맥북", "맥"],
-      "default_dir": "~/projects"
-    }
-  },
-  "default_host": "ultra4",
-  "triggers": ["원격에서", "다른 머신에서", "다른 컴퓨터에서"]
-}
+{
+  "hosts": {
+    "ultra4": {
+      "description": "Windows 데스크탑 (SSAFY)",
+      "aliases": ["울트라", "데스크탑"],
+      "default_dir": "~/Desktop/Projects"
+    },
+    "m2": {
+      "description": "MacBook Pro",
+      "aliases": ["맥북", "맥"],
+      "default_dir": "~/projects"
+    }
+  },
+  "default_host": "ultra4",
+  "triggers": ["원격에서", "다른 머신에서", "다른 컴퓨터에서"]
+}