triflux 3.2.0-dev.1 → 3.2.0-dev.10

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

@@ -0,0 +1,77 @@
+---
+name: tfx-auto-codex
+description: Codex 리드형 tfx-auto. Claude 네이티브 역할을 Codex로 치환하고 Gemini 사용은 유지합니다.
+triggers:
+  - tfx-auto-codex
+argument-hint: "\"작업 설명\" | N:agent_type \"작업 설명\""
+---
+
+# tfx-auto-codex — Codex 리드형 tfx-auto
+
+> 목적: 기존 `tfx-auto`의 오케스트레이션 패턴을 유지하면서
+> Claude 네이티브 역할(`explore`, `verifier`, `test-engineer`, `qa-tester`)을
+> Codex로 치환해 Codex/Gemini만으로 실행한다.
+
+## 핵심 원칙
+
+1. **Codex 라우팅 유지**
+   - 구현/분석/리뷰/디버깅/검증은 Codex 우선.
+2. **Gemini 유지**
+   - `designer`, `writer`는 Gemini 경로를 그대로 사용.
+3. **Claude 네이티브 제거**
+   - 실행 시 `TFX_NO_CLAUDE_NATIVE=1`로 강제.
+4. **고난도 설계는 xhigh**
+   - 설계/분해/비판 검토 성격의 작업은 `codex --profile xhigh` 기준으로 운용.
+
+## 사용법
+
+```bash
+/tfx-auto-codex "인증 리팩터링 + UI 개선 + 테스트 보강"
+/tfx-auto-codex 3:codex "src/api, src/auth, src/payment 병렬 리뷰"
+/tfx-auto-codex 2:gemini "온보딩 UI 카피 + 접근성 개선"
+```
+
+## 실행 규칙
+
+`tfx-auto` 워크플로우(입력 파싱 → 트리아지 → 분해 → DAG 실행 → 수집/보고)를 그대로 사용한다.
+
+단, **실행 명령은 아래 환경변수를 반드시 포함**한다:
+
+```bash
+TFX_NO_CLAUDE_NATIVE=1 bash ~/.claude/scripts/tfx-route.sh {agent} '{prompt}' {mcp_profile}
+```
+
+### 역할 치환 (자동)
+
+`TFX_NO_CLAUDE_NATIVE=1`일 때:
+
+- `explore` -> Codex `fast`
+- `verifier` -> Codex `thorough review`
+- `test-engineer` -> Codex `high`
+- `qa-tester` -> Codex `thorough review`
+
+## 트리아지 기준
+
+- `codex`: 코드 구현/수정/분석/리뷰/디버깅/테스트/검증/리서치
+- `gemini`: 문서/UI/디자인/멀티모달
+
+Claude 타입 반환은 기본적으로 허용하지 않는다.
+분류 결과에 `claude`가 포함되면 `codex`로 치환 후 분해를 진행한다.
+단, Codex CLI 미설치 환경에서는 실행 안전성을 위해 `claude-native` fallback이 유지될 수 있다.
+
+## 권장 프로필
+
+- 설계/계획/비판적 검토: `xhigh`
+- 일반 구현/수정: `high`
+- 리뷰: `thorough`
+- 빠른 탐색: `fast`
+
+## 의존성
+
+- `~/.claude/scripts/tfx-route.sh` 최신 동기화 상태
+- Codex CLI 설치
+- Gemini CLI 설치 (UI/문서 경로 사용 시)
+
+## Troubleshooting
+
+문제 발생 시 `/tfx-doctor` 실행. (`--fix` 자동 수정, `--reset` 캐시 초기화)

package/skills/tfx-codex/SKILL.md

@@ -62,7 +62,4 @@ argument-hint: "\"작업 설명\" | N:codex \"작업 설명\""
 
 ## Troubleshooting
 
-문제가 발생하면:
-1. `/tfx-doctor` — 진단 실행
-2. `/tfx-doctor --fix` — 자동 수정
-3. `/tfx-doctor --reset` — 캐시 초기화 (HUD 이상 시)
+문제 발생 시 `/tfx-doctor` 실행. (`--fix` 자동 수정, `--reset` 캐시 초기화)

package/skills/tfx-doctor/SKILL.md

@@ -34,6 +34,7 @@ argument-hint: "[--fix|--reset]"
 - 플러그인 등록 상태
 - MCP 인벤토리 캐시
 - CLI 이슈 트래커
+- 잔존 팀(orphan teams) 감지 (`~/.claude/teams/`)
 
 ### 수정 모드 (`/tfx-doctor --fix`)
 

package/skills/tfx-gemini/SKILL.md

@@ -79,7 +79,4 @@ argument-hint: "\"작업 설명\" | N:gemini \"작업 설명\""
 
 ## Troubleshooting
 
-문제가 발생하면:
-1. `/tfx-doctor` — 진단 실행
-2. `/tfx-doctor --fix` — 자동 수정
-3. `/tfx-doctor --reset` — 캐시 초기화 (HUD 이상 시)
+문제 발생 시 `/tfx-doctor` 실행. (`--fix` 자동 수정, `--reset` 캐시 초기화)

package/skills/tfx-multi/SKILL.md

@@ -0,0 +1,296 @@
+---
+name: tfx-multi
+description: 멀티-CLI 팀 모드. Claude Native Agent Teams + Codex/Gemini 멀티모델 오케스트레이션.
+triggers:
+  - tfx-multi
+argument-hint: '"작업 설명" | --agents codex,gemini "작업" | --tmux "작업" | status | stop'
+---
+
+# tfx-multi v2.2 — 슬림 래퍼 + 네비게이션 복원 기반 멀티-CLI 팀 오케스트레이터
+
+> Claude Code Native Teams의 Shift+Down 네비게이션을 복원한다.
+> Codex/Gemini 워커마다 최소 프롬프트(~100 토큰)의 슬림 Agent 래퍼를 spawn하여 네비게이션에 등록하고,
+> 실제 작업은 `tfx-route.sh`가 수행한다. task 상태는 `team_task_list`를 truth source로 검증한다.
+> v2.2 현재 — 슬림 래퍼 Agent로 Shift+Down 네비게이션 복원, Opus 토큰 77% 절감.
+
+## 사용법
+
+```
+/tfx-multi "인증 리팩터링 + UI 개선 + 보안 리뷰"
+/tfx-multi --agents codex,gemini "프론트+백엔드"
+/tfx-multi --tmux "작업"         # 레거시 tmux 모드
+/tfx-multi status
+/tfx-multi stop
+```
+
+## 실행 워크플로우
+
+### Phase 0: 사전 점검 정책 (출력 최소화 + 즉시 spawn)
+
+> **[필수] Agent spawn 지연 금지 — preflight와 Agent 생성을 병렬로 실행한다.**
+> Lead가 preflight를 순차 완료한 뒤 Agent를 spawn하면 사용자 체감 지연이 발생한다.
+> 수동 모드(`N:agent`)에서는 입력 파싱 직후 TeamCreate + Agent spawn을 먼저 시작하고,
+> preflight는 **동시에 병렬**로 수행한다. preflight 실패 시에만 Agent를 중단한다.
+
+- 원칙:
+  - **수동 모드:** Phase 1 파싱 → Phase 3a~3c(TeamCreate + Agent spawn) + Phase 0(preflight) **동시 병렬**
+  - **자동 모드:** Phase 0(preflight) + Phase 2(triage) **동시 병렬** → Phase 3
+  - 사용자가 요청하지 않으면 `Searched for ...`, 개별 `Bash(...)` 로그를 전면 보고하지 않는다.
+  - 리드에는 요약 한 줄만 노출한다. 예: `preflight: ok (route/hub)`
+  - Hub 점검은 `/status`를 기준으로 한다 (`/health` 단독 판정 금지).
+- 권장 체크 예시 (단일 Bash로 통합):
+  - `curl -sf http://127.0.0.1:27888/status >/dev/null && test -f ~/.claude/scripts/tfx-route.sh && echo "preflight: ok" || echo "preflight: FAIL"`
+- 실패 시에만 상세를 노출한다:
+  - `tfx-route.sh` 없음
+  - Hub 비정상/미기동
+  - 필수 CLI 미설치
+
+### Phase 1: 입력 파싱
+
+```
+입력: "3:codex 리뷰"         → 수동 모드: N=3, agent=codex
+입력: "인증 + UI + 테스트"    → 자동 모드: Codex 분류 → Opus 분해
+입력: "--tmux 인증 + UI"     → tmux 레거시 모드 → Phase 3-tmux로 분기
+입력: "status"               → 제어 커맨드
+입력: "stop"                 → 제어 커맨드
+```
+
+**제어 커맨드 감지:**
+- `status`, `stop`, `kill`, `attach`, `list`, `send` → `Bash("node bin/triflux.mjs multi {cmd}")` 직행
+  (`bin/triflux.mjs` 절대경로는 triflux 패키지 루트 기준)
+- 그 외 → Phase 2 트리아지
+
+**--tmux 감지:** 입력에 `--tmux`가 포함되면 Phase 3-tmux로 분기.
+
+### Phase 2: 트리아지 (tfx-auto와 동일)
+
+#### 자동 모드 — Codex 분류 → Opus 분해
+
+```bash
+# Step 2a: Codex 분류 (무료)
+Bash("codex exec --full-auto --skip-git-repo-check '다음 작업을 분석하고 각 부분에 적합한 agent를 분류하라.
+
+  agent 선택:
+  - codex: 코드 구현/수정/분석/리뷰/디버깅/설계 (기본값)
+  - gemini: 문서/UI/디자인/멀티모달
+  - claude: 코드베이스 탐색/테스트 실행/검증 (최후 수단)
+
+  작업: {task}
+
+  JSON만 출력:
+  { \"parts\": [{ \"description\": \"...\", \"agent\": \"codex|gemini|claude\" }] }
+'")
+```
+
+> Codex 분류 실패 시 → Opus(오케스트레이터)가 직접 분류+분해
+
+```
+# Step 2b: 인라인 분해
+분류 결과 → 서브태스크 배열 구성:
+  [{ cli: "codex", subtask: "인증 리팩터링", role: "executor" },
+   { cli: "gemini", subtask: "UI 개선", role: "designer" },
+   { cli: "codex", subtask: "보안 리뷰", role: "reviewer" }]
+```
+
+#### 수동 모드 (`N:agent_type` 또는 `--agents`)
+
+Codex 분류 건너뜀 → Opus가 직접 N개 서브태스크 분해.
+
+### Phase 3: Native Teams 실행 (v2.1 개편)
+
+트리아지 결과를 Claude Code 네이티브 Agent Teams로 실행한다.
+
+#### Step 3a: 팀 생성
+
+```
+teamName = "tfx-" + Date.now().toString(36).slice(-6)
+
+TeamCreate({
+  team_name: teamName,
+  description: "tfx-multi: {원본 작업 요약}"
+})
+```
+
+#### Step 3b: 공유 작업 등록
+
+각 서브태스크에 대해 `TaskCreate`를 호출하고 `taskId`를 보존한다.
+리드가 실행 시 사용할 `agentName`도 함께 확정한다.
+
+```
+for each assignment in assignments (index i):
+  TaskCreate({
+    subject: assignment.subtask,
+    description: "CLI: {assignment.cli}, 역할: {assignment.role}\n\n{상세 작업 내용}",
+    metadata: { cli: assignment.cli, role: assignment.role }
+  })
+  taskId = created_task.id
+  agentName = "{assignment.cli}-worker-{i+1}"
+  runQueue.push({ taskId, agentName, ...assignment })
+```
+
+#### Step 3c: 슬림 래퍼 Agent 실행 (v2.2 네비게이션 복원)
+
+> **[필수] Codex/Gemini 서브태스크는 워커 수에 관계없이 반드시 Agent 래퍼를 spawn해야 한다.**
+> 단일 워커(1:gemini 등)여도 Lead가 직접 Bash를 실행하면 안 된다.
+> Agent 래퍼를 생략하면 Shift+Down 네비게이션에 워커가 등록되지 않아 v2.2의 핵심 가치가 사라진다.
+> Lead가 "효율적"이라고 판단해서 Agent를 건너뛰는 것은 금지한다.
+
+Codex/Gemini 서브태스크마다 최소 프롬프트의 Agent를 spawn하여 네비게이션에 등록한다.
+Agent 내부에서 `Bash(tfx-route.sh)` 1회 실행 후 결과 보고하고 종료한다.
+
+```
+for each item in runQueue where item.cli in ["codex", "gemini"]:
+  Agent({
+    name: item.agentName,
+    team_name: teamName,
+    run_in_background: true,
+    prompt: buildSlimWrapperPrompt(item.cli, {
+      subtask: item.subtask,
+      role: item.role,
+      teamName: teamName,
+      taskId: item.taskId,
+      agentName: item.agentName,
+      leadName: "team-lead",
+      mcp_profile: mcp_profile
+    })
+  })
+```
+
+슬림 래퍼 프롬프트는 `hub/team/native.mjs`의 `buildSlimWrapperPrompt()`가 **단일 truth source**.
+핵심 동작: Bash 1회 실행(tfx-route.sh) → TaskUpdate(completed) + SendMessage → 종료.
+status는 "completed"만 사용. 실패 여부는 `metadata.result`로 구분.
+
+> **[금지] Lead 또는 Agent 래퍼가 `gemini -y -p "..."` 또는 `codex exec "..."`를 직접 호출하면 안 된다.**
+> 직접 호출하면 tfx-route.sh의 모델 지정(`-m gemini-3.1-pro-preview`), MCP 필터, 팀 bridge 연동,
+> Windows 호환 경로, 타임아웃, 후처리(토큰 추적/이슈 로깅)가 모두 누락된다.
+> 반드시 `bash ~/.claude/scripts/tfx-route.sh {role} '{subtask}' {mcp_profile}`을 통해 실행해야 한다.
+
+**핵심 차이 vs v2:** 프롬프트 ~100 토큰 (v2의 ~500), task claim/complete/report는 tfx-route.sh가 Named Pipe(우선)/HTTP(fallback) 경유로 수행.
+
+`tfx-route.sh` 팀 통합 동작(이미 구현됨, `TFX_TEAM_*` 기반):
+- `TFX_TEAM_NAME`: 팀 식별자
+- `TFX_TEAM_TASK_ID`: 작업 식별자
+- `TFX_TEAM_AGENT_NAME`: 워커 표기 이름
+- `TFX_TEAM_LEAD_NAME`: 리드 수신자 이름 (기본 `team-lead`)
+
+Hub 통신 (Named Pipe 우선, HTTP fallback):
+- `bridge.mjs`가 Named Pipe(`\\.\pipe\triflux-{pid}`) 우선 연결, 실패 시 HTTP `/bridge/*` fallback
+- 실행 시작: `node hub/bridge.mjs team-task-update --team {name} --task-id {id} --claim --status in_progress`
+- 실행 종료: `node hub/bridge.mjs team-task-update --team {name} --task-id {id} --status completed|failed`
+- 리드 보고: `node hub/bridge.mjs team-send-message --team {name} --from {agent} --to team-lead --text "..."`
+- 결과 발행: `node hub/bridge.mjs result --agent {id} --topic task.result --file {output}`
+
+#### Step 3d: claude 타입만 Agent 직접 실행
+
+`cli == claude`인 서브태스크에만 `Agent(subagent_type)`를 사용한다.
+
+```
+Agent({
+  name: "claude-worker-{n}",
+  team_name: teamName,
+  description: "claude-worker-{n}",
+  run_in_background: true,
+  subagent_type: "{role}",
+  prompt: "너는 {teamName}의 Claude 워커이다.
+
+1. TaskGet 후 TaskUpdate(status: in_progress, owner: 너의 이름)로 claim
+2. 도구를 직접 사용해 작업 수행
+3. 성공 시 TaskUpdate(status: completed, metadata: {result: 'success'}) + SendMessage(to: team-lead)
+4. 실패 시 TaskUpdate(status: completed, metadata: {result: 'failed', error: '에러 요약'}) + SendMessage(to: team-lead)
+
+중요: status는 'completed'만 사용. 'failed'는 API 미지원. 실패 여부는 metadata.result로 구분.
+어떤 경우에도 TaskUpdate + SendMessage 후 반드시 종료하라."
+})
+```
+
+#### Step 3e: 사용자 안내
+
+```
+"팀 '{teamName}' 생성 완료.
+Codex/Gemini 워커가 슬림 래퍼 Agent로 네비게이션에 등록되었습니다.
+Shift+Down으로 다음 워커 (마지막→리드 wrap), Shift+Tab으로 이전 워커 전환이 가능합니다.
+(Shift+Up은 Claude Code 미지원 — 대부분 터미널에서 scroll-up으로 먹힘)"
+```
+
+### Phase 4: 결과 수집 (truth source = team_task_list)
+
+1. 리드가 Step 3c에서 실행한 모든 백그라운드 Bash 프로세스 완료를 대기한다.
+2. `team_task_list`를 최종 truth source로 조회한다.
+
+```bash
+Bash("node hub/bridge.mjs team-task-list --team ${teamName}")
+```
+
+3. `completed` 상태이지만 `metadata.result == "failed"`인 task가 있으면 Claude fallback으로 재시도한다.
+4. 재시도 후 다시 `team_task_list`를 조회해 최종 상태를 확정한다.
+5. `send-message`와 `result(task.result)` 이벤트는 진행 관찰 채널로 사용하고, 최종 판정은 반드시 `team_task_list` 기준으로 한다.
+6. Hub `task-update`에서는 `status: "failed"`를 그대로 사용한다 (Hub API는 자체 상태 관리). Claude Code `TaskUpdate`만 `"completed"` + `metadata.result`로 구분한다.
+
+종합 보고서 예시:
+```markdown
+## tfx-multi 실행 결과
+
+| # | Worker | CLI | 작업 | 상태 |
+|---|--------|-----|------|------|
+| 1 | codex-worker-1 | codex | 인증 리팩터링 | completed |
+| 2 | gemini-worker-1 | gemini | UI 개선 | completed |
+| 3 | claude-worker-1 | claude | 실패 fallback 재시도 | completed |
+```
+
+### Phase 5: 정리 (반드시 실행)
+
+> **[필수] Phase 5는 성공/실패에 관계없이 반드시 실행해야 한다.**
+> 워커 실패, Bash 에러, fallback 실패 등 어떤 상황에서도 TeamDelete를 건너뛰면 안 된다.
+> TeamDelete를 하지 않으면 `~/.claude/teams/{teamName}/`이 잔존하여 OMC hook이 "team executing"을
+> 반복 감지하는 무한 루프에 빠진다.
+
+정리 순서:
+1. 모든 백그라운드 Agent 완료를 **최대 30초** 대기한다.
+2. 30초 후에도 미완료 Agent가 있으면 대기를 중단하고 정리를 진행한다.
+3. `TeamDelete()`를 호출한다.
+4. TeamDelete가 실패하면 (활성 멤버 잔존) 수동 정리를 안내한다:
+   ```
+   rm -rf ~/.claude/teams/{teamName}/ ~/.claude/tasks/{teamName}/
+   ```
+5. 종합 보고서를 출력한다.
+
+### Phase 3-tmux: 레거시 tmux 모드
+--tmux 플래그 시 기존 v1 방식으로 실행: Bash("node {PKG_ROOT}/bin/triflux.mjs multi --no-attach --agents {agents} \\\"{task}\\\"")
+이후 사용자에게 tmux 세션 연결 안내.
+
+## 에이전트 매핑
+> 에이전트 매핑: codex/gemini → tfx-route.sh, claude → Agent(subagent_type) 직접 실행. 상세는 Phase 3c/3d 참조.
+
+## 전제 조건
+
+- **CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1** — settings.json env에 설정 (`tfx setup`이 자동 설정)
+- **codex/gemini CLI** — 해당 에이전트 사용 시
+- **tfx setup** — tfx-route.sh 동기화 + AGENT_TEAMS 자동 설정 (사전 실행 권장)
+- **Hub 활성 상태** — Named Pipe(`\\.\pipe\triflux-{pid}`) 우선, HTTP `127.0.0.1:27888` fallback. `bridge.mjs`가 자동 선택.
+- **출력 정책** — preflight는 비동기/요약 출력이 기본이며, 실패 시에만 상세 출력
+
+## 에러 처리
+
+| 에러 | 처리 |
+|------|------|
+| TeamCreate 실패 / Agent Teams 비활성 | `--tmux` 폴백 (Phase 3-tmux로 전환) |
+| tfx-route.sh 없음 | `tfx setup` 실행 안내 |
+| CLI 미설치 (codex/gemini) | 해당 서브태스크를 claude 워커로 대체 |
+| Codex 분류 실패 | Opus 직접 분류+분해 |
+| Bash 실행 실패 (Lead) | task를 `completed` + `metadata.result: "failed"`로 마킹 후 Claude fallback 재시도 |
+| `team_task_list` 조회 실패 | Named Pipe/stdout로 임시 관찰 후 Hub 복구 뒤 상태 재검증 |
+| claude fallback 실패 | 실패 task 목록/원인 요약 후 사용자 승인 대기 |
+
+> **[중요] TaskUpdate 상태값 제약:** Claude Code API는 `pending`, `in_progress`, `completed`, `deleted`만 지원한다.
+> `failed` 상태는 존재하지 않으므로 절대 사용하지 마라. 실패는 `status: "completed"` + `metadata: {result: "failed"}`로 표현한다.
+> Hub API(`bridge.mjs team-task-update`)는 자체 상태 관리이므로 `"failed"` 사용 가능.
+
+## 관련
+
+| 항목 | 설명 |
+|------|------|
+| `scripts/tfx-route.sh` | 팀 통합 라우터 (`TFX_TEAM_*`, task claim/complete, send-message, Named Pipe/HTTP bridge) |
+| `hub/team/native.mjs` | Native Teams 래퍼 (프롬프트 템플릿, 팀 설정 빌더) |
+| `hub/team/cli.mjs` | tmux 팀 CLI (`--tmux` 레거시 모드) |
+| `tfx-auto` | one-shot 실행 오케스트레이터 (병행 유지) |
+| `tfx-hub` | MCP 메시지 버스 관리 (tmux 모드용) |

package/skills/tfx-setup/SKILL.md

@@ -98,7 +98,4 @@ Bash("triflux doctor")
 
 ## Troubleshooting
 
-설정 후에도 문제가 있으면:
-1. `/tfx-doctor` — 상세 진단 실행
-2. `/tfx-doctor --fix` — 파일 동기화 + 캐시 정리
-3. `/tfx-doctor --reset` — 캐시 전체 초기화 (HUD 이상 시)
+문제 발생 시 `/tfx-doctor` 실행. (`--fix` 자동 수정, `--reset` 캐시 초기화)

package/skills/tfx-team/SKILL.md

@@ -1,172 +0,0 @@
----
-name: tfx-team
-description: 멀티-CLI 팀 모드. tfx-auto와 동일한 트리아지/분해, 실행은 tmux + Hub 기반 interactive 세션.
-triggers:
-  - tfx-team
-argument-hint: '"작업 설명" | --agents codex,gemini "작업" | status | stop'
----
-
-# tfx-team — tmux + Hub 기반 멀티-CLI 팀 오케스트레이터
-
-> tfx-auto와 **동일한 트리아지/분해 로직**, 실행 백엔드만 다름.
->
-> | | tfx-auto | tfx-team |
-> |--|----------|----------|
-> | 트리아지 | Codex 분류 → Opus 분해 | **동일** |
-> | 실행 | `tfx-route.sh` one-shot | **tmux pane interactive** |
-> | 관찰 | stdout 반환 후 종료 | **실시간 네이티브 터미널** |
-> | 통신 | 없음 (독립 실행) | **Hub MCP 메시지 버스** |
-> | 개입 | 불가 | **`tfx team send N "추가 지시"`** |
-
-## 사용법
-
-```
-/tfx-team "인증 리팩터링 + UI 개선 + 보안 리뷰"
-/tfx-team --agents codex,gemini "프론트+백엔드"
-/tfx-team status
-/tfx-team stop
-```
-
-## 실행 워크플로우
-
-### Phase 1: 입력 파싱
-
-```
-입력: "3:codex 리뷰"         → 수동 모드: N=3, agent=codex
-입력: "인증 + UI + 테스트"    → 자동 모드: Codex 분류 → Opus 분해
-입력: "status"               → 제어 커맨드 (tfx team status)
-입력: "stop"                 → 제어 커맨드 (tfx team stop)
-```
-
-**제어 커맨드 감지:**
-- `status`, `stop`, `kill`, `attach`, `list`, `send` → `Bash("node bin/triflux.mjs team {cmd}")` 직행
-- 그 외 → Phase 2 트리아지
-
-### Phase 2: 트리아지 (tfx-auto와 동일)
-
-#### 자동 모드 — Codex 분류 → Opus 분해
-
-```bash
-# Step 2a: Codex 분류 (무료)
-Bash("codex exec --full-auto --skip-git-repo-check '다음 작업을 분석하고 각 부분에 적합한 agent를 분류하라.
-
-  agent 선택:
-  - codex: 코드 구현/수정/분석/리뷰/디버깅/설계 (기본값)
-  - gemini: 문서/UI/디자인/멀티모달
-  - claude: 코드베이스 탐색/테스트 실행/검증 (최후 수단)
-
-  작업: {task}
-
-  JSON:
-  { \"parts\": [{ \"description\": \"...\", \"agent\": \"codex|gemini|claude\" }] }
-'")
-```
-
-> Codex 분류 실패 시 → Opus(오케스트레이터)가 직접 분류+분해
-
-```
-# Step 2b: Opus 인라인 분해
-분류 결과 → 에이전트 배정:
-  codex → --agents에 codex 추가
-  gemini → --agents에 gemini 추가
-  claude → --agents에 claude 추가 (또는 codex로 대체 — claude는 최후 수단)
-
-결과: agents 배열 + subtasks 배열
-```
-
-#### 수동 모드 (`N:agent_type`)
-
-Codex 분류 건너뜀 → Opus가 직접 N개 서브태스크 분해.
-
-### Phase 3: tmux 팀 실행
-
-트리아지 결과를 `tfx team` CLI로 실행:
-
-```bash
-# agents 배열과 작업을 tfx team에 전달
-Bash("node {PKG_ROOT}/bin/triflux.mjs team --agents {agents.join(',')} \"{task}\"")
-```
-
-**내부 동작 (hub/team/ 모듈):**
-1. Hub lazy-start (`hub/server.mjs`)
-2. tmux 세션 생성 (2x2 or 1xN 레이아웃)
-3. Pane 0: Dashboard (실시간 상태)
-4. Pane 1~N: 각 CLI interactive 모드 시작 (codex/gemini/claude)
-5. 3초 대기 (CLI 초기화)
-6. 각 pane에 서브태스크 프롬프트 주입 (load-buffer + paste-buffer)
-7. tmux attach → 사용자에게 제어권
-
-### Phase 4: 실시간 관찰 + 개입
-
-tmux 세션 내에서:
-- `Ctrl+B → 방향키`: pane 전환
-- `Ctrl+B → D`: 세션 분리 (백그라운드)
-- `Ctrl+B → Z`: pane 전체화면
-
-세션 분리 후 제어:
-```bash
-/tfx-team status            # 팀 상태 확인
-/tfx-team send 1 "추가 지시"  # Pane 1에 입력
-/tfx-team attach            # 세션 재연결
-/tfx-team stop              # graceful 종료
-```
-
-### Phase 5: 에이전트 간 통신
-
-Hub MCP 도구가 각 CLI에 등록되어 있으면 자동 통신:
-- `register`: 에이전트 등록
-- `publish`: 결과 발행 (topic: task.result)
-- `poll_messages`: 다른 에이전트 메시지 수신
-- `ask`: 다른 에이전트에게 질문
-
-MCP 미등록 시 REST 폴백 (프롬프트에 curl 명령 포함).
-
-## 에이전트 매핑
-
-| 분류 결과 | CLI | 비고 |
-|----------|-----|------|
-| codex | `codex` (interactive) | MCP: ~/.codex/config.json |
-| gemini | `gemini` (interactive) | MCP: ~/.gemini/settings.json |
-| claude | `claude` (interactive) | MCP: .mcp.json |
-
-> **중요:** tfx-auto와 달리 세부 에이전트(executor, debugger 등)로 분류하지 않음.
-> tmux pane에는 CLI 단위(codex/gemini/claude)로 실행하고,
-> 프롬프트에 역할(구현/리뷰/디버깅)을 명시하여 CLI가 알아서 수행.
-
-## tfx-auto와의 차이 요약
-
-| 항목 | tfx-auto | tfx-team |
-|------|----------|----------|
-| 트리아지 | Codex 분류 → Opus 분해 | **동일** |
-| 실행 단위 | 에이전트(executor, reviewer 등) | CLI(codex, gemini, claude) |
-| 실행 방식 | `tfx-route.sh` (one-shot, 블랙박스) | tmux pane (interactive, 관찰 가능) |
-| 결과 수집 | stdout 파싱 | Hub publish/poll |
-| 개입 | 불가 | `tfx team send` |
-| 통신 | 없음 | Hub MCP 메시지 버스 |
-| Dashboard | 없음 | Pane 0 실시간 상태 |
-| tmux 필요 | 아니오 | **예** |
-| 종료 | 자동 (실행 완료) | 수동 (`tfx team stop`) |
-
-## 전제 조건
-
-- **tmux** — 필수 (Git Bash: v3.6a, WSL2, macOS, Linux)
-- **codex/gemini CLI** — 해당 에이전트 사용 시
-- **tfx setup** — Hub MCP 자동 등록 (사전 실행 권장)
-
-## 에러 처리
-
-| 에러 | 처리 |
-|------|------|
-| tmux 미설치 | 안내 메시지 + WSL2 설치 가이드 |
-| Hub 시작 실패 | `tfx hub start` 수동 실행 안내 |
-| CLI 미설치 | 해당 pane 건너뜀 + 경고 |
-| MCP 미등록 | REST 폴백 (curl) |
-| Codex 분류 실패 | Opus 직접 분류+분해 |
-
-## 관련
-
-| 항목 | 설명 |
-|------|------|
-| `hub/team/` | tmux + Hub 팀 모듈 (session, pane, orchestrator, dashboard, cli) |
-| `tfx-auto` | one-shot 실행 오케스트레이터 (기존, 병행 유지) |
-| `tfx-hub` | MCP 메시지 버스 관리 (start/stop/status) |