triflux 3.2.0-dev.9 → 3.3.0-dev.3

package/scripts/setup.mjs

@@ -16,10 +16,17 @@ const CODEX_DIR = join(homedir(), ".codex");
 const CODEX_CONFIG_PATH = join(CODEX_DIR, "config.toml");
 
 const REQUIRED_CODEX_PROFILES = [
+  {
+    name: "high",
+    lines: [
+      'model = "gpt-5.4"',
+      'model_reasoning_effort = "high"',
+    ],
+  },
   {
     name: "xhigh",
     lines: [
-      'model = "gpt-5.3-codex"',
+      'model = "gpt-5.4"',
       'model_reasoning_effort = "xhigh"',
     ],
   },
@@ -50,16 +57,21 @@ const SYNC_MAP = [
     dst: join(CLAUDE_DIR, "scripts", "tfx-route-worker.mjs"),
     label: "tfx-route-worker.mjs",
   },
-  {
-    src: join(PLUGIN_ROOT, "hub", "workers", "codex-mcp.mjs"),
-    dst: join(CLAUDE_DIR, "scripts", "hub", "workers", "codex-mcp.mjs"),
-    label: "hub/workers/codex-mcp.mjs",
-  },
-  {
-    src: join(PLUGIN_ROOT, "hub", "workers", "interface.mjs"),
-    dst: join(CLAUDE_DIR, "scripts", "hub", "workers", "interface.mjs"),
-    label: "hub/workers/interface.mjs",
-  },
+  {
+    src: join(PLUGIN_ROOT, "hub", "workers", "codex-mcp.mjs"),
+    dst: join(CLAUDE_DIR, "scripts", "hub", "workers", "codex-mcp.mjs"),
+    label: "hub/workers/codex-mcp.mjs",
+  },
+  {
+    src: join(PLUGIN_ROOT, "hub", "workers", "delegator-mcp.mjs"),
+    dst: join(CLAUDE_DIR, "scripts", "hub", "workers", "delegator-mcp.mjs"),
+    label: "hub/workers/delegator-mcp.mjs",
+  },
+  {
+    src: join(PLUGIN_ROOT, "hub", "workers", "interface.mjs"),
+    dst: join(CLAUDE_DIR, "scripts", "hub", "workers", "interface.mjs"),
+    label: "hub/workers/interface.mjs",
+  },
   {
     src: join(PLUGIN_ROOT, "hub", "workers", "gemini-worker.mjs"),
     dst: join(CLAUDE_DIR, "scripts", "hub", "workers", "gemini-worker.mjs"),

package/scripts/tfx-route.sh

@@ -1,5 +1,5 @@
 #!/usr/bin/env bash
-# tfx-route.sh v2.2 — CLI 라우팅 래퍼 (triflux)
+# tfx-route.sh v2.3 — CLI 라우팅 래퍼 (triflux)
 #
 # v1.x: cli-route.sh (jq+python3+node 혼재, 동기 후처리 ~1s)
 # v2.0: tfx-route.sh 리네임
@@ -9,7 +9,7 @@
 #   - Gemini health check 지수 백오프 (30×1s → 5×exp)
 #   - 컨텍스트 파일 5번째 인자 지원
 #
-VERSION="2.2"
+VERSION="2.3"
 #
 # 사용법:
 #   tfx-route.sh <agent_type> <prompt> [mcp_profile] [timeout_sec] [context_file]
@@ -226,8 +226,9 @@ route_agent() {
       CLI_TYPE="claude-native"; CLI_CMD=""; CLI_ARGS=""
       CLI_EFFORT="n/a"; DEFAULT_TIMEOUT=300; RUN_MODE="fg"; OPUS_OVERSIGHT="false" ;;
     verifier)
-      CLI_TYPE="claude-native"; CLI_CMD=""; CLI_ARGS=""
-      CLI_EFFORT="n/a"; DEFAULT_TIMEOUT=300; RUN_MODE="fg"; OPUS_OVERSIGHT="false" ;;
+      CLI_TYPE="codex"; CLI_CMD="codex"
+      CLI_ARGS="exec --profile thorough ${codex_base} review"
+      CLI_EFFORT="thorough"; DEFAULT_TIMEOUT=1200; RUN_MODE="fg"; OPUS_OVERSIGHT="false" ;;
     test-engineer)
       CLI_TYPE="claude-native"; CLI_CMD=""; CLI_ARGS=""
       CLI_EFFORT="n/a"; DEFAULT_TIMEOUT=300; RUN_MODE="bg"; OPUS_OVERSIGHT="false" ;;
@@ -253,6 +254,8 @@ route_agent() {
 TFX_CLI_MODE="${TFX_CLI_MODE:-auto}"
 TFX_NO_CLAUDE_NATIVE="${TFX_NO_CLAUDE_NATIVE:-0}"
 TFX_CODEX_TRANSPORT="${TFX_CODEX_TRANSPORT:-auto}"
+TFX_WORKER_INDEX="${TFX_WORKER_INDEX:-}"
+TFX_SEARCH_TOOL="${TFX_SEARCH_TOOL:-}"
 case "$TFX_NO_CLAUDE_NATIVE" in
   0|1) ;;
   *)
@@ -267,6 +270,20 @@ case "$TFX_CODEX_TRANSPORT" in
     exit 1
     ;;
 esac
+case "$TFX_WORKER_INDEX" in
+  "") ;;
+  *[!0-9]*|0)
+    echo "ERROR: TFX_WORKER_INDEX 값은 1 이상의 정수여야 합니다. (현재: $TFX_WORKER_INDEX)" >&2
+    exit 1
+    ;;
+esac
+case "$TFX_SEARCH_TOOL" in
+  ""|brave-search|tavily|exa) ;;
+  *)
+    echo "ERROR: TFX_SEARCH_TOOL 값은 brave-search, tavily, exa 중 하나여야 합니다. (현재: $TFX_SEARCH_TOOL)" >&2
+    exit 1
+    ;;
+esac
 CODEX_MCP_TRANSPORT_EXIT_CODE=70
 
 apply_cli_mode() {
@@ -408,23 +425,60 @@ get_mcp_hint() {
 
   has_server() { echo ",$servers," | grep -q ",$1,"; }
 
+  get_search_tool_order() {
+    local available=()
+    local ordered=()
+    local tool
+
+    for tool in brave-search tavily exa; do
+      has_server "$tool" && available+=("$tool")
+    done
+
+    if [[ ${#available[@]} -eq 0 ]]; then
+      return 0
+    fi
+
+    if [[ -n "$TFX_SEARCH_TOOL" ]]; then
+      for tool in "${available[@]}"; do
+        [[ "$tool" == "$TFX_SEARCH_TOOL" ]] && ordered+=("$tool")
+      done
+      for tool in "${available[@]}"; do
+        [[ "$tool" != "$TFX_SEARCH_TOOL" ]] && ordered+=("$tool")
+      done
+    elif [[ -n "$TFX_WORKER_INDEX" && ${#available[@]} -gt 1 ]]; then
+      local offset=$(( (TFX_WORKER_INDEX - 1) % ${#available[@]} ))
+      local i idx
+      for ((i=0; i<${#available[@]}; i++)); do
+        idx=$(( (offset + i) % ${#available[@]} ))
+        ordered+=("${available[$idx]}")
+      done
+    else
+      ordered=("${available[@]}")
+    fi
+
+    printf '%s\n' "${ordered[*]}"
+  }
+
+  local ordered_tools=()
+  read -r -a ordered_tools <<< "$(get_search_tool_order)"
+  local ordered_tools_csv=""
+  if [[ ${#ordered_tools[@]} -gt 0 ]]; then
+    ordered_tools_csv=$(printf '%s, ' "${ordered_tools[@]}")
+    ordered_tools_csv="${ordered_tools_csv%, }"
+  fi
+
   local hint=""
   case "$profile" in
     implement)
       has_server "context7" && hint+="context7으로 라이브러리 문서를 조회하세요. "
-      if has_server "brave-search"; then hint+="웹 검색은 brave-search를 사용하세요. "
-      elif has_server "exa"; then hint+="웹 검색은 exa를 사용하세요. "
-      elif has_server "tavily"; then hint+="웹 검색은 tavily를 사용하세요. "
+      if [[ ${#ordered_tools[@]} -gt 0 ]]; then
+        hint+="웹 검색은 ${ordered_tools[0]}를 사용하세요. "
       fi
-      hint+="검색 도구 실패 시 재시도하지 말고 다음 도구로 전환하세요."
+      hint+="검색 도구 실패 시 402, 429, 432, 433, quota 에러에서 재시도하지 말고 다음 도구로 전환하세요."
       ;;
     analyze)
       has_server "context7" && hint+="context7으로 관련 문서를 조회하세요. "
-      local search_tools=""
-      has_server "brave-search" && search_tools+="brave-search, "
-      has_server "tavily" && search_tools+="tavily, "
-      has_server "exa" && search_tools+="exa, "
-      [[ -n "$search_tools" ]] && hint+="웹 검색 우선순위: ${search_tools%, }. 402 에러 시 즉시 다음 도구로 전환. "
+      [[ -n "$ordered_tools_csv" ]] && hint+="웹 검색 우선순위: ${ordered_tools_csv}. 402, 429, 432, 433, quota 에러 시 즉시 다음 도구로 전환. "
       has_server "playwright" && hint+="모든 검색 실패 시 playwright로 직접 방문 (최대 3 URL). "
       hint+="검색 깊이를 제한하고 결과를 빠르게 요약하세요."
       ;;
@@ -433,7 +487,9 @@ get_mcp_hint() {
       ;;
     docs)
       has_server "context7" && hint+="context7으로 공식 문서를 참조하세요. "
-      has_server "brave-search" && hint+="추가 검색은 brave-search를 사용하세요. "
+      if [[ ${#ordered_tools[@]} -gt 0 ]]; then
+        hint+="추가 검색은 ${ordered_tools[0]}를 사용하세요. "
+      fi
       hint+="검색 결과의 출처 URL을 함께 제시하세요."
       ;;
     minimal|none) ;;
@@ -446,7 +502,7 @@ get_gemini_mcp_servers() {
   local profile="$1"
   case "$profile" in
     implement)  echo "context7 brave-search" ;;
-    analyze)    echo "context7 brave-search exa" ;;
+    analyze)    echo "context7 brave-search exa tavily" ;;
     review)     echo "sequential-thinking" ;;
     docs)       echo "context7 brave-search" ;;
     *)          echo "" ;;
@@ -782,6 +838,9 @@ ${ctx_content}
   # 메타정보 (stderr)
   echo "[tfx-route] v${VERSION} type=$CLI_TYPE agent=$AGENT_TYPE effort=$CLI_EFFORT mode=$RUN_MODE timeout=${TIMEOUT_SEC}s" >&2
   echo "[tfx-route] opus_oversight=$OPUS_OVERSIGHT mcp_profile=$MCP_PROFILE" >&2
+  if [[ -n "$TFX_WORKER_INDEX" || -n "$TFX_SEARCH_TOOL" ]]; then
+    echo "[tfx-route] worker_index=${TFX_WORKER_INDEX:-auto} search_tool=${TFX_SEARCH_TOOL:-auto}" >&2
+  fi
   if [[ "$CLI_TYPE" == "codex" ]]; then
     echo "[tfx-route] codex_transport_request=$TFX_CODEX_TRANSPORT" >&2
   fi

package/skills/{tfx-team → tfx-multi}/SKILL.md

@@ -1,26 +1,32 @@
 ---
-name: tfx-team
+name: tfx-multi
 description: 멀티-CLI 팀 모드. Claude Native Agent Teams + Codex/Gemini 멀티모델 오케스트레이션.
 triggers:
-  - tfx-team
+  - tfx-multi
 argument-hint: '"작업 설명" | --agents codex,gemini "작업" | --tmux "작업" | status | stop'
 ---
 
-# tfx-team v2.2 — 슬림 래퍼 + 네비게이션 복원 기반 멀티-CLI 팀 오케스트레이터
+# tfx-multi v3 — 파이프라인 기반 멀티-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% 절감.
+> v3 — `--quick`(기본, v2.2 호환) + `--thorough`(전체 파이프라인: plan→prd→exec→verify→fix loop).
+
+> **[필수] Lead 웹 서치 직접 사용 금지**
+> Lead(Claude Opus)는 brave-search, exa, tavily 등 웹 서치 MCP 도구를 직접 호출하지 마라.
+> 리서치/검색 태스크는 반드시 `scientist` 또는 `document-specialist` 역할의 Codex 워커에 위임하라.
+> Lead가 MCP 검색 도구에 직접 접근 가능하더라도, 위임해야 Claude 토큰을 절약할 수 있다.
 
 ## 사용법
 
 ```
-/tfx-team "인증 리팩터링 + UI 개선 + 보안 리뷰"
-/tfx-team --agents codex,gemini "프론트+백엔드"
-/tfx-team --tmux "작업"         # 레거시 tmux 모드
-/tfx-team status
-/tfx-team stop
+/tfx-multi "인증 리팩터링 + UI 개선 + 보안 리뷰"           # --quick (기본)
+/tfx-multi --thorough "인증 리팩터링 + UI 개선 + 보안 리뷰"  # 전체 파이프라인
+/tfx-multi --agents codex,gemini "프론트+백엔드"
+/tfx-multi --tmux "작업"         # 레거시 tmux 모드
+/tfx-multi status
+/tfx-multi stop
 ```
 
 ## 실행 워크플로우
@@ -56,11 +62,11 @@ argument-hint: '"작업 설명" | --agents codex,gemini "작업" | --tmux "작
 ```
 
 **제어 커맨드 감지:**
-- `status`, `stop`, `kill`, `attach`, `list`, `send` → `Bash("node bin/triflux.mjs team {cmd}")` 직행
+- `status`, `stop`, `kill`, `attach`, `list`, `send` → `Bash("node bin/triflux.mjs multi {cmd}")` 직행
   (`bin/triflux.mjs` 절대경로는 triflux 패키지 루트 기준)
 - 그 외 → Phase 2 트리아지
 
-**--tmux 감지:** 입력에 `--tmux`가 포함되면 Phase 3-tmux로 분기.
+**--tmux/--psmux 감지:** 입력에 `--tmux` 또는 `--psmux`가 포함되면 Phase 3-mux로 분기. psmux가 primary (Windows).
 
 ### Phase 2: 트리아지 (tfx-auto와 동일)
 
@@ -96,6 +102,32 @@ Bash("codex exec --full-auto --skip-git-repo-check '다음 작업을 분석하
 
 Codex 분류 건너뜀 → Opus가 직접 N개 서브태스크 분해.
 
+### Phase 2.5–2.6: 파이프라인 Plan/PRD (`--thorough` 전용)
+
+> `--quick`(기본) 모드에서는 이 단계를 건너뛰고 Phase 3으로 직행한다.
+> `--thorough` 모드에서만 실행된다.
+
+```
+[--thorough 모드 감지]
+
+Phase 2.5: Plan (Codex architect)
+  1. Hub pipeline 초기화:
+     Bash("node hub/bridge.mjs pipeline-advance --team ${teamName} --status plan")
+     — 또는 createPipeline(db, teamName) 직접 호출
+  2. Codex architect로 작업 분석 + 접근법 설계:
+     bash ~/.claude/scripts/tfx-route.sh architect "${task}" analyze
+  3. 결과를 파이프라인 artifact에 저장:
+     pipeline.setArtifact('plan_path', planOutputPath)
+  4. pipeline advance: plan → prd
+
+Phase 2.6: PRD (Codex analyst)
+  1. Codex analyst로 수용 기준 확정:
+     bash ~/.claude/scripts/tfx-route.sh analyst "${task}" analyze
+  2. 결과를 파이프라인 artifact에 저장:
+     pipeline.setArtifact('prd_path', prdOutputPath)
+  3. pipeline advance: prd → exec
+```
+
 ### Phase 3: Native Teams 실행 (v2.1 개편)
 
 트리아지 결과를 Claude Code 네이티브 Agent Teams로 실행한다.
@@ -107,7 +139,7 @@ teamName = "tfx-" + Date.now().toString(36).slice(-6)
 
 TeamCreate({
   team_name: teamName,
-  description: "tfx-team: {원본 작업 요약}"
+  description: "tfx-multi: {원본 작업 요약}"
 })
 ```
 
@@ -165,7 +197,22 @@ status는 "completed"만 사용. 실패 여부는 `metadata.result`로 구분.
 > Windows 호환 경로, 타임아웃, 후처리(토큰 추적/이슈 로깅)가 모두 누락된다.
 > 반드시 `bash ~/.claude/scripts/tfx-route.sh {role} '{subtask}' {mcp_profile}`을 통해 실행해야 한다.
 
-**핵심 차이 vs v2:** 프롬프트 ~100 토큰 (v2의 ~500), task claim/complete/report는 tfx-route.sh Hub bridge가 수행.
+**Bash timeout 동적 상속:** Bash timeout은 tfx-route.sh의 role/profile별 timeout + 60초 여유를 ms로 변환하여 동적 상속한다. `getRouteTimeout(role, mcpProfile)` 기준: analyze/review 프로필 또는 architect/analyst 역할은 3600초, 그 외 기본 1080초(18분).
+
+**핵심 차이 vs v2:** 프롬프트 ~100 토큰 (v2의 ~500), task claim/complete/report는 tfx-route.sh가 Named Pipe(우선)/HTTP(fallback) 경유로 수행.
+
+#### 인터럽트 프로토콜
+
+워커가 Bash 실행 전에 SendMessage로 시작을 보고하면 턴 경계가 생겨 리드가 방향 전환 메시지를 보낼 수 있다.
+
+```
+1. TaskUpdate(taskId, status: in_progress) — task claim
+2. SendMessage(to: team-lead, "작업 시작: {agentName}") — 시작 보고 (턴 경계 생성)
+3. Bash(command: tfx-route.sh ..., timeout: {bashTimeoutMs}) — 1회 실행
+4. TaskUpdate(status: completed, metadata: {result}) + SendMessage → 종료
+```
+
+리드는 워커의 Step 2 시점에 턴 경계를 인식하고, 필요 시 방향 전환/중단 메시지를 보낼 수 있다.
 
 `tfx-route.sh` 팀 통합 동작(이미 구현됨, `TFX_TEAM_*` 기반):
 - `TFX_TEAM_NAME`: 팀 식별자
@@ -173,11 +220,12 @@ status는 "completed"만 사용. 실패 여부는 `metadata.result`로 구분.
 - `TFX_TEAM_AGENT_NAME`: 워커 표기 이름
 - `TFX_TEAM_LEAD_NAME`: 리드 수신자 이름 (기본 `team-lead`)
 
-Bridge 연동:
-- 실행 시작 시 `POST /bridge/team/task-update`로 `claim + in_progress`
-- 실행 종료 시 `POST /bridge/team/task-update`로 `completed|failed`
-- 리드 보고 `POST /bridge/team/send-message`
-- 이벤트 채널 `POST /bridge/result` (`topic=task.result`) 발행
+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 직접 실행
 
@@ -207,8 +255,38 @@ Agent({
 ```
 "팀 '{teamName}' 생성 완료.
 Codex/Gemini 워커가 슬림 래퍼 Agent로 네비게이션에 등록되었습니다.
-Shift+Down으로 다음 워커 (마지막→리드 wrap), Shift+Tab으로 이전 워커 전환이 가능합니다.
-(Shift+Up은 Claude Code 미지원 — 대부분 터미널에서 scroll-up으로 먹힘)"
+Shift+Down으로 다음 워커로 전환 (마지막→리드 wrap). Shift+Tab으로 이전 워커 전환."
+```
+
+### Phase 3.5–3.7: Verify/Fix Loop (`--thorough` 전용)
+
+> `--quick`(기본) 모드에서는 이 단계를 건너뛰고 Phase 4로 직행한다.
+> `--thorough` 모드에서만 실행된다.
+
+```
+Phase 3.5: Verify (Codex review)
+  1. pipeline advance: exec → verify
+  2. Codex verifier로 결과 검증:
+     bash ~/.claude/scripts/tfx-route.sh verifier "결과 검증: ${task}" review
+     — verifier는 Codex --profile thorough review로 실행됨
+  3. 검증 결과를 파이프라인 artifact에 저장:
+     pipeline.setArtifact('verify_report', verifyOutputPath)
+  4. 통과 → pipeline advance: verify → complete → Phase 5 (cleanup)
+  5. 실패 → Phase 3.6
+
+Phase 3.6: Fix (Codex executor, max 3회)
+  1. pipeline advance: verify → fix
+     — fix_attempt 자동 증가, fix_max(3) 초과 시 전이 거부
+  2. fix_attempt > fix_max → Phase 3.7 (ralph loop) 또는 failed 보고 → Phase 5
+  3. Codex executor로 실패 항목 수정:
+     bash ~/.claude/scripts/tfx-route.sh executor "실패 항목 수정: ${failedItems}" implement
+  4. pipeline advance: fix → exec (재실행)
+  5. → Phase 3 (exec) → Phase 3.5 (verify) 재실행
+
+Phase 3.7: Ralph Loop (fix 3회 초과 시)
+  1. ralph_iteration 증가 (pipeline.restart())
+  2. ralph_iteration > ralph_max(10) → 최종 failed → Phase 5
+  3. fix_attempt 리셋, 전체 파이프라인 재시작 (Phase 2.5 plan부터)
 ```
 
 ### Phase 4: 결과 수집 (truth source = team_task_list)
@@ -217,17 +295,17 @@ Shift+Down으로 다음 워커 (마지막→리드 wrap), Shift+Tab으로 이전
 2. `team_task_list`를 최종 truth source로 조회한다.
 
 ```bash
-Bash("curl -sf http://127.0.0.1:27888/bridge/team/task-list -H \"Content-Type: application/json\" -d \"{\\\"team_name\\\":\\\"${teamName}\\\"}\"")
+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`와 `/bridge/result(task.result)` 이벤트는 진행 관찰 채널로 사용하고, 최종 판정은 반드시 `team_task_list` 기준으로 한다.
-6. Hub bridge의 `task-update`에서는 `status: "failed"`를 그대로 사용한다 (Hub API는 자체 상태 관리). Claude Code `TaskUpdate`만 `"completed"` + `metadata.result`로 구분한다.
+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-team 실행 결과
+## tfx-multi 실행 결과
 
 | # | Worker | CLI | 작업 | 상태 |
 |---|--------|-----|------|------|
@@ -253,9 +331,12 @@ Bash("curl -sf http://127.0.0.1:27888/bridge/team/task-list -H \"Content-Type: a
    ```
 5. 종합 보고서를 출력한다.
 
-### Phase 3-tmux: 레거시 tmux 모드
---tmux 플래그 시 기존 v1 방식으로 실행: Bash("node {PKG_ROOT}/bin/triflux.mjs team --no-attach --agents {agents} \\\"{task}\\\"")
-이후 사용자에게 tmux 세션 연결 안내.
+### Phase 3-mux: 레거시 psmux/tmux 모드
+`--tmux` 또는 `--psmux` 플래그 시 pane 기반 실행. `detectMultiplexer()`가 psmux → tmux → wsl-tmux → git-bash-tmux 순으로 자동 감지.
+Windows에서는 **psmux가 1순위** (ADR-001).
+
+Bash("node {PKG_ROOT}/bin/triflux.mjs multi --no-attach --agents {agents} \\\"{task}\\\"")
+이후 사용자에게 세션 연결 안내.
 
 ## 에이전트 매핑
 > 에이전트 매핑: codex/gemini → tfx-route.sh, claude → Agent(subagent_type) 직접 실행. 상세는 Phase 3c/3d 참조.
@@ -265,31 +346,33 @@ Bash("curl -sf http://127.0.0.1:27888/bridge/team/task-list -H \"Content-Type: a
 - **CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1** — settings.json env에 설정 (`tfx setup`이 자동 설정)
 - **codex/gemini CLI** — 해당 에이전트 사용 시
 - **tfx setup** — tfx-route.sh 동기화 + AGENT_TEAMS 자동 설정 (사전 실행 권장)
-- **Hub bridge 활성 상태** — 기본 `http://127.0.0.1:27888` (`/bridge/team/*`, `/bridge/result` 사용)
+- **Hub 활성 상태** — Named Pipe(`\\.\pipe\triflux-{pid}`) 우선, HTTP `127.0.0.1:27888` fallback. `bridge.mjs`가 자동 선택. Hub 미실행 시 nativeProxy fallback.
+- **멀티플렉서** — psmux(Windows 1순위) / tmux / wsl-tmux / git-bash-tmux 자동 감지 (`--tmux`/`--psmux` 모드)
 - **출력 정책** — preflight는 비동기/요약 출력이 기본이며, 실패 시에만 상세 출력
 
 ## 에러 처리
 
 | 에러 | 처리 |
 |------|------|
-| TeamCreate 실패 / Agent Teams 비활성 | `--tmux` 폴백 (Phase 3-tmux로 전환) |
+| TeamCreate 실패 / Agent Teams 비활성 | `--psmux/--tmux` 폴백 (Phase 3-mux로 전환) |
 | tfx-route.sh 없음 | `tfx setup` 실행 안내 |
 | CLI 미설치 (codex/gemini) | 해당 서브태스크를 claude 워커로 대체 |
 | Codex 분류 실패 | Opus 직접 분류+분해 |
 | Bash 실행 실패 (Lead) | task를 `completed` + `metadata.result: "failed"`로 마킹 후 Claude fallback 재시도 |
-| `team_task_list` 조회 실패 | `/bridge/result`/stdout로 임시 관찰 후 bridge 복구 뒤 상태 재검증 |
+| `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 bridge API(`/bridge/team/task-update`)는 자체 상태 관리이므로 `"failed"` 사용 가능.
+> Hub API(`bridge.mjs team-task-update`)는 자체 상태 관리이므로 `"failed"` 사용 가능.
 
 ## 관련
 
 | 항목 | 설명 |
 |------|------|
-| `scripts/tfx-route.sh` | 팀 통합 라우터 (`TFX_TEAM_*`, task claim/complete, send-message, `/bridge/result`) |
+| `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` 레거시 모드) |
+| `hub/pipeline/` | 파이프라인 상태 기계 (transitions, state, index) — `--thorough` 모드 |
 | `tfx-auto` | one-shot 실행 오케스트레이터 (병행 유지) |
 | `tfx-hub` | MCP 메시지 버스 관리 (tmux 모드용) |