triflux 10.43.0 → 10.44.0

package/scripts/tfx-route.sh

@@ -1253,51 +1253,39 @@ route_agent() {
     claude-native) CLI_CMD=""; CLI_ARGS="" ;;
   esac
 
-  # ── 에이전트별 상세 설정 ──
-  case "$agent" in
-    # ─── 구현 레인 ───
-    executor|codex)
-      CLI_ARGS="exec --profile gpt56_terra_high ${codex_base}"
-      CLI_EFFORT="gpt56_terra_high"; DEFAULT_TIMEOUT=1080; RUN_MODE="fg"; OPUS_OVERSIGHT="false" ;;
-    build-fixer)
-      # 빌드 수정 — npm/biome/test-lock 등 도메인 지식 필요. base capability 우위로 gpt56_luna_low (fast tier).
-      CLI_ARGS="exec --profile gpt56_luna_low ${codex_base}"
-      CLI_EFFORT="gpt56_luna_low"; DEFAULT_TIMEOUT=540; RUN_MODE="fg"; OPUS_OVERSIGHT="false" ;;
-    cleanup|deslop)
-      # 슬롭/정리 — 패턴 매칭 위주. GPT-5.6 family mid로 lightweight lane 통일.
-      CLI_ARGS="exec --profile gpt56_terra_med ${codex_base}"
-      CLI_EFFORT="gpt56_terra_med"; DEFAULT_TIMEOUT=540; RUN_MODE="fg"; OPUS_OVERSIGHT="false" ;;
-    debugger)
-      # 디버깅 — 깊은 코드 추적 필요, GPT-5.6 family xhigh
-      CLI_ARGS="exec --profile gpt56_sol_xhigh ${codex_base}"
-      CLI_EFFORT="gpt56_sol_xhigh"; DEFAULT_TIMEOUT=900; RUN_MODE="bg"; OPUS_OVERSIGHT="false" ;;
-
-    # ─── 설계/분석 레인 (GPT-5.6 Sol xhigh) ───
-    deep-executor|architect|critic)
-      CLI_ARGS="exec --profile gpt56_sol_xhigh ${codex_base}"
-      CLI_EFFORT="gpt56_sol_xhigh"; DEFAULT_TIMEOUT=3600; RUN_MODE="bg"; OPUS_OVERSIGHT="true" ;;
-    planner|analyst)
-      CLI_ARGS="exec --profile gpt56_sol_xhigh ${codex_base}"
-      CLI_EFFORT="gpt56_sol_xhigh"; DEFAULT_TIMEOUT=3600; RUN_MODE="fg"; OPUS_OVERSIGHT="true" ;;
-
-    # ─── 리뷰 레인 (GPT-5.6 Terra/Sol) ───
-    code-reviewer|quality-reviewer)
-      CLI_ARGS="exec --profile gpt56_terra_high ${codex_base} review"
-      CLI_EFFORT="gpt56_terra_high"; DEFAULT_TIMEOUT=1800; RUN_MODE="bg"; OPUS_OVERSIGHT="false" ;;
-    security-reviewer)
-      # 보안 = 깊은 사고 → xhigh
-      CLI_ARGS="exec --profile gpt56_sol_xhigh ${codex_base} review"
-      CLI_EFFORT="gpt56_sol_xhigh"; DEFAULT_TIMEOUT=1800; RUN_MODE="bg"; OPUS_OVERSIGHT="true" ;;
-
-    # ─── 리서치 레인 ───
-    scientist|document-specialist)
-      CLI_ARGS="exec --profile gpt56_terra_high ${codex_base}"
-      CLI_EFFORT="gpt56_terra_high"; DEFAULT_TIMEOUT=1440; RUN_MODE="bg"; OPUS_OVERSIGHT="false" ;;
-    scientist-deep)
-      CLI_ARGS="exec --profile gpt56_sol_xhigh ${codex_base}"
-      CLI_EFFORT="gpt56_sol_xhigh"; DEFAULT_TIMEOUT=3600; RUN_MODE="bg"; OPUS_OVERSIGHT="false" ;;
+  # ── Codex role policy: Node SSOT의 enum-validated TSV만 shell이 조립한다. ──
+  if [[ "$CLI_TYPE" == "codex" ]]; then
+    local route_dir policy_file policy_row policy_profile policy_timeout policy_mode policy_oversight policy_mcp policy_subcommand
+    route_dir="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+    policy_file="$route_dir/lib/agent-route-policy.mjs"
+    if [[ ! -f "$policy_file" && -n "$TFX_PKG_ROOT" ]]; then
+      policy_file="$TFX_PKG_ROOT/scripts/lib/agent-route-policy.mjs"
+    fi
+    if [[ ! -f "$policy_file" ]]; then
+      echo "ERROR: agent route policy 미발견 (경로: $policy_file)" >&2
+      exit 1
+    fi
+    policy_row=$("$NODE_BIN" "$policy_file" --format tsv --agent "$agent") || {
+      echo "ERROR: Codex agent route policy 조회 실패: $agent" >&2
+      exit 1
+    }
+    IFS=$'\t' read -r policy_profile policy_timeout policy_mode policy_oversight policy_mcp policy_subcommand <<< "$policy_row"
+    case "$policy_profile" in gpt56_sol_xhigh|gpt56_terra_high|gpt56_terra_med|gpt56_luna_low) ;; *) echo "ERROR: invalid Codex profile policy" >&2; exit 1 ;; esac
+    [[ "$policy_timeout" =~ ^[1-9][0-9]*$ ]] || { echo "ERROR: invalid Codex timeout policy" >&2; exit 1; }
+    case "$policy_mode" in fg|bg) ;; *) echo "ERROR: invalid Codex run mode policy" >&2; exit 1 ;; esac
+    case "$policy_oversight" in true|false) ;; *) echo "ERROR: invalid Codex oversight policy" >&2; exit 1 ;; esac
+    case "$policy_mcp" in implement|analyze|review) ;; *) echo "ERROR: invalid Codex MCP hint policy" >&2; exit 1 ;; esac
+    case "$policy_subcommand" in exec|review) ;; *) echo "ERROR: invalid Codex subcommand policy" >&2; exit 1 ;; esac
+    CLI_ARGS="exec --profile ${policy_profile} ${codex_base}"
+    [[ "$policy_subcommand" == "review" ]] && CLI_ARGS+=" review"
+    CLI_EFFORT="$policy_profile"; DEFAULT_TIMEOUT="$policy_timeout"; RUN_MODE="$policy_mode"; OPUS_OVERSIGHT="$policy_oversight"
+    AGENT_MCP_HINT="$policy_mcp"
+    return
+  fi
 
-    # ─── Antigravity CLI 레인 (Gemini CLI 후속) ───
+  # ── Non-Codex provider settings ──
+  case "$agent" in
+    # ─── Antigravity CLI lane ───
     # effort 차등: agent 별 GEMINI_PROFILE 을 설정하면 run_antigravity_exec() 가
     # resolve_gemini_profile 로 해석해 `--model "<display name>"`을 agy_args 에
     # 주입한다. 우선순위는 TFX_GEMINI_PROFILE(env) > GEMINI_PROFILE(agent) > flash35.
@@ -1326,27 +1314,9 @@ route_agent() {
     explore|claude)
       CLI_EFFORT="n/a"; DEFAULT_TIMEOUT=600; RUN_MODE="fg"; OPUS_OVERSIGHT="false" ;;
 
-    # ─── 검증/테스트 ───
-    verifier)
-      CLI_ARGS="exec --profile gpt56_terra_high ${codex_base} review"
-      CLI_EFFORT="gpt56_terra_high"; DEFAULT_TIMEOUT=1200; RUN_MODE="fg"; OPUS_OVERSIGHT="false" ;;
-    test-engineer)
-      CLI_ARGS="exec --profile gpt56_terra_high ${codex_base}"
-      CLI_EFFORT="gpt56_terra_high"; DEFAULT_TIMEOUT=1200; RUN_MODE="bg"; OPUS_OVERSIGHT="false" ;;
-    qa-tester)
-      CLI_ARGS="exec --profile gpt56_terra_high ${codex_base} review"
-      CLI_EFFORT="gpt56_terra_high"; DEFAULT_TIMEOUT=1200; RUN_MODE="bg"; OPUS_OVERSIGHT="false" ;;
-
-    # ─── 경량 ───
-    spark)
-      CLI_ARGS="exec --profile gpt56_luna_low ${codex_base}"
-      CLI_EFFORT="gpt56_luna_low"; DEFAULT_TIMEOUT=180; RUN_MODE="fg"; OPUS_OVERSIGHT="false" ;;
     # ─── agent-map.json에만 정의된 신규 에이전트 (CLI_TYPE별 기본값) ───
     *)
       case "$CLI_TYPE" in
-        codex)
-          CLI_ARGS="exec --profile gpt56_terra_high ${codex_base}"
-          CLI_EFFORT="gpt56_terra_high"; DEFAULT_TIMEOUT=1080; RUN_MODE="fg"; OPUS_OVERSIGHT="false" ;;
         gemini|antigravity)
           CLI_ARGS="--print --dangerously-skip-permissions"
           CLI_EFFORT="agy_v1"; DEFAULT_TIMEOUT=900; RUN_MODE="bg"; OPUS_OVERSIGHT="false" ;;
@@ -1361,6 +1331,7 @@ TFX_CLI_MODE="${TFX_CLI_MODE:-auto}"
 TFX_NO_CLAUDE_NATIVE="${TFX_NO_CLAUDE_NATIVE:-0}"
 TFX_VERIFIER_OVERRIDE="${TFX_VERIFIER_OVERRIDE:-auto}"
 TFX_CODEX_TRANSPORT="${TFX_CODEX_TRANSPORT:-auto}"
+TFX_CODEX_PROFILE="${TFX_CODEX_PROFILE:-auto}"
 # Preflight 캐시 일괄 로드 — CLI/Hub 가용성 + Codex 요금제를 환경변수로 내보냄
 # 하위 프로세스(스킬 포함)가 TFX_CODEX_OK, TFX_GEMINI_OK, TFX_ANTIGRAVITY_OK, TFX_HUB_OK로 즉시 참조 가능
 if [[ -z "${TFX_PREFLIGHT_LOADED:-}" ]]; then
@@ -1421,6 +1392,13 @@ case "$TFX_CODEX_TRANSPORT" in
     exit 1
     ;;
 esac
+case "$TFX_CODEX_PROFILE" in
+  auto|max|ultra|gpt56_luna_low|gpt56_terra_med|gpt56_terra_high|gpt56_sol_xhigh|gpt56_sol_max|gpt56_sol_ultra) ;;
+  *)
+    echo "ERROR: TFX_CODEX_PROFILE 값은 auto, max, ultra 또는 canonical gpt56_* profile이어야 합니다. (현재: $TFX_CODEX_PROFILE)" >&2
+    exit 1
+    ;;
+esac
 case "$TFX_VERIFIER_OVERRIDE" in
   auto|claude) ;;
   *)
@@ -1637,6 +1615,116 @@ apply_no_claude_native_mode() {
 ## bridge retry-run/status exposes cliInvocation.argv for escalation-chain
 ## profile steps. Consume those argv directly instead of duplicating profile
 ## resolution here.
+resolve_safe_retry_codex_profile() {
+  local profile="$1"
+  case "$profile" in
+    ultra|gpt56_sol_ultra|*_ultra)
+      echo "gpt56_sol_max"
+      return
+      ;;
+    gpt56_luna_low|gpt56_terra_med|gpt56_terra_high|gpt56_sol_xhigh|gpt56_sol_max)
+      echo "$profile"
+      return
+      ;;
+  esac
+
+  local codex_home profile_file effort
+  codex_home="${CODEX_HOME:-${TFX_CODEX_HOME:-${HOME:-}/.codex}}"
+  profile_file="${codex_home}/${profile}.config.toml"
+  if [[ ! -f "$profile_file" ]]; then
+    echo "gpt56_terra_high"
+    return
+  fi
+  effort=$(awk -F= '
+    /^[[:space:]]*model_reasoning_effort[[:space:]]*=/ {
+      value=$2
+      sub(/[[:space:]]*#.*/, "", value)
+      gsub(/^[[:space:]"'"'']+|[[:space:]"'"'']+$/, "", value)
+      print tolower(value)
+      exit
+    }
+  ' "$profile_file" 2>/dev/null || true)
+  case "$effort" in
+    ultra) echo "gpt56_sol_max" ;;
+    "") echo "gpt56_terra_high" ;;
+    *) echo "$profile" ;;
+  esac
+}
+
+read_codex_profile_effort() {
+  local profile="$1"
+  local codex_home profile_file effort
+  codex_home="${CODEX_HOME:-${TFX_CODEX_HOME:-${HOME:-}/.codex}}"
+  profile_file="${codex_home}/${profile}.config.toml"
+  if [[ -f "$profile_file" ]]; then
+    effort=$(awk -F= '
+      /^[[:space:]]*model_reasoning_effort[[:space:]]*=/ {
+        value=$2
+        sub(/[[:space:]]*#.*/, "", value)
+        gsub(/^[[:space:]"'"'']+|[[:space:]"'"'']+$/, "", value)
+        print tolower(value)
+        exit
+      }
+    ' "$profile_file" 2>/dev/null || true)
+    echo "$effort"
+    return
+  fi
+  case "$profile" in
+    *_ultra) echo "ultra" ;;
+    *_max) echo "max" ;;
+    *_xhigh) echo "xhigh" ;;
+    *_high) echo "high" ;;
+    *_med|*_medium) echo "medium" ;;
+    *_low) echo "low" ;;
+    *) echo "" ;;
+  esac
+}
+
+apply_codex_concrete_effort_guard() {
+  [[ "${CLI_TYPE:-}" == "codex" ]] || return 0
+
+  local -a args=()
+  read -r -a args <<< "$CLI_ARGS"
+  local profile="" i
+  for ((i = 0; i < ${#args[@]}; i++)); do
+    case "${args[$i]}" in
+      --profile) profile="${args[$((i + 1))]:-}" ;;
+      --profile=*) profile="${args[$i]#--profile=}" ;;
+    esac
+  done
+  [[ -n "$profile" ]] || return 0
+
+  local allow_ultra=0
+  if [[ "$TFX_CODEX_PROFILE" == "ultra" || "$TFX_CODEX_PROFILE" == "gpt56_sol_ultra" ]]; then
+    if ! is_nested_codex_runtime && [[ -z "${TFX_RETRY_SNAPSHOT:-${TFX_RETRY_SNAPSHOT_FILE:-}}" ]]; then
+      case "$AGENT_TYPE" in
+        deep-executor|scientist-deep) allow_ultra=1 ;;
+      esac
+    fi
+  fi
+
+  local effort target_effort=""
+  effort="$(read_codex_profile_effort "$profile")"
+  case "$profile" in
+    gpt56_sol_max) target_effort="max" ;;
+    gpt56_sol_ultra)
+      [[ "$allow_ultra" -eq 1 ]] && target_effort="ultra" || target_effort="max"
+      ;;
+    *)
+      if [[ "$effort" == "ultra" ]]; then
+        [[ "$allow_ultra" -eq 1 ]] && target_effort="ultra" || target_effort="max"
+      fi
+      ;;
+  esac
+  [[ -n "$target_effort" ]] || return 0
+
+  CLI_ARGS+=" -c model=\"gpt-5.6-sol\" -c model_reasoning_effort=\"${target_effort}\""
+  CLI_EFFORT="gpt56_sol_${target_effort}"
+  CODEX_MODEL_OVERRIDE="gpt-5.6-sol"
+  CODEX_REASONING_EFFORT_OVERRIDE="$target_effort"
+  echo "[tfx-route] final Codex effort guard: ${profile}/${effort:-unknown} -> ${target_effort}" >&2
+}
+
 apply_retry_snapshot_cli_invocation() {
   [[ "${CLI_TYPE:-}" == "codex" ]] || return 0
 
@@ -1688,10 +1776,24 @@ apply_retry_snapshot_cli_invocation() {
       --profile)
         retry_has_profile=1
         retry_profile="${retry_args[$((i + 1))]:-}"
+        local safe_retry_profile
+        safe_retry_profile="$(resolve_safe_retry_codex_profile "$retry_profile")"
+        if [[ "$safe_retry_profile" != "$retry_profile" ]]; then
+          echo "[tfx-route] retry Codex profile guard: ${retry_profile} -> ${safe_retry_profile}" >&2
+          retry_profile="$safe_retry_profile"
+          retry_args[$((i + 1))]="$safe_retry_profile"
+        fi
         ;;
       --profile=*)
         retry_has_profile=1
         retry_profile="${retry_args[$i]#--profile=}"
+        local safe_retry_profile
+        safe_retry_profile="$(resolve_safe_retry_codex_profile "$retry_profile")"
+        if [[ "$safe_retry_profile" != "$retry_profile" ]]; then
+          echo "[tfx-route] retry Codex profile guard: ${retry_profile} -> ${safe_retry_profile}" >&2
+          retry_profile="$safe_retry_profile"
+          retry_args[$i]="--profile=$safe_retry_profile"
+        fi
         ;;
     esac
   done
@@ -1773,6 +1875,45 @@ apply_dynamic_routing_override() {
   esac
 }
 
+is_nested_codex_runtime() {
+  [[ -n "${TFX_TEAM_NAME:-}" || -n "${TFX_WORKER_INDEX:-}" || -n "${TFX_WORKER_SANDBOX_SCOPE:-}" ]]
+}
+
+apply_codex_profile_override() {
+  [[ "$CLI_TYPE" != "codex" ]] && return
+  [[ "$TFX_CODEX_PROFILE" == "auto" ]] && return
+
+  local requested="$TFX_CODEX_PROFILE"
+  local profile="$requested"
+  case "$requested" in
+    max) profile="gpt56_sol_max" ;;
+    ultra) profile="gpt56_sol_ultra" ;;
+  esac
+
+  if [[ "$profile" == "gpt56_sol_ultra" ]]; then
+    local downgrade_reason=""
+    case "$AGENT_TYPE" in
+      deep-executor|scientist-deep) ;;
+      *) downgrade_reason="agent ${AGENT_TYPE} is not ultra-eligible" ;;
+    esac
+    if is_nested_codex_runtime; then
+      downgrade_reason="nested team/worker runtime"
+    fi
+    if [[ -n "$downgrade_reason" ]]; then
+      echo "[tfx-route] Codex ultra -> max: ${downgrade_reason}" >&2
+      profile="gpt56_sol_max"
+    fi
+  fi
+
+  local codex_base
+  codex_base="$(build_codex_base)"
+  local review_suffix=""
+  [[ "$CLI_ARGS" == *" review" ]] && review_suffix=" review"
+  CLI_ARGS="exec --profile ${profile} ${codex_base}${review_suffix}"
+  CLI_EFFORT="$profile"
+  echo "[tfx-route] Codex profile override: ${requested} -> ${profile}" >&2
+}
+
 apply_verifier_override() {
   [[ "$AGENT_TYPE" != "verifier" ]] && return
 
@@ -2627,17 +2768,22 @@ run_codex_exec() {
   if [[ "$exit_code_local" -ne 0 ]] && grep -qE "is not supported when using Codex with a ChatGPT account" "$STDERR_LOG" 2>/dev/null; then
     local fallback_profile=""
     case "$CLI_EFFORT" in
-      gpt56_sol_xhigh|gpt56_terra_high|gpt56_terra_med) fallback_profile="gpt56_luna_low" ;;
+      gpt56_sol_ultra|gpt56_sol_max|gpt56_sol_xhigh|gpt56_terra_high|gpt56_terra_med) fallback_profile="gpt56_luna_low" ;;
     esac
     if [[ -n "$fallback_profile" ]]; then
       echo "[tfx-route] tier fallback: $CLI_EFFORT not supported on ChatGPT account → retry with $fallback_profile" >&2
       local -a new_args=()
-      local skip_next=0
-      for arg in "${codex_args[@]}"; do
-        if [[ "$skip_next" -eq 1 ]]; then
-          new_args+=("$fallback_profile"); skip_next=0
-        elif [[ "$arg" == "--profile" ]]; then
-          new_args+=("$arg"); skip_next=1
+      local i arg next_arg
+      for ((i = 0; i < ${#codex_args[@]}; i++)); do
+        arg="${codex_args[$i]}"
+        next_arg="${codex_args[$((i + 1))]:-}"
+        if [[ "$arg" == "--profile" ]]; then
+          new_args+=("$arg" "$fallback_profile")
+          i=$((i + 1))
+        elif [[ "$arg" == --profile=* ]]; then
+          new_args+=("--profile=$fallback_profile")
+        elif [[ "$arg" == "-c" && ( "$next_arg" == model=* || "$next_arg" == model_reasoning_effort=* ) ]]; then
+          i=$((i + 1))
         else
           new_args+=("$arg")
         fi
@@ -2681,6 +2827,13 @@ run_codex_mcp() {
     "--codex-command" "$CODEX_BIN"
   )
 
+  if [[ -n "${CODEX_MODEL_OVERRIDE:-}" ]]; then
+    mcp_args+=("--model" "$CODEX_MODEL_OVERRIDE")
+  fi
+  if [[ -n "${CODEX_REASONING_EFFORT_OVERRIDE:-}" ]]; then
+    mcp_args+=("--reasoning-effort" "$CODEX_REASONING_EFFORT_OVERRIDE")
+  fi
+
   if [[ -n "$CODEX_CONFIG_JSON" && "$CODEX_CONFIG_JSON" != "{}" ]]; then
     mcp_args+=("--config-json" "$CODEX_CONFIG_JSON")
   fi
@@ -2744,7 +2897,9 @@ main() {
   apply_plan_guard
   apply_verifier_override
   apply_dynamic_routing_override
+  apply_codex_profile_override
   apply_retry_snapshot_cli_invocation
+  apply_codex_concrete_effort_guard
 
   # CLI 경로 해석
   case "$CLI_CMD" in
@@ -2831,6 +2986,14 @@ ${ctx_content}
   # Claude 네이티브 에이전트는 이 스크립트로 처리 불가
   if [[ "$CLI_TYPE" == "claude-native" ]]; then
     if [[ -n "$TFX_TEAM_NAME" ]]; then
+      local native_model native_adapter
+      native_adapter="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/lib/cli-claude.mjs"
+      [[ -f "$native_adapter" ]] || native_adapter="${TFX_PKG_ROOT:-}/scripts/lib/cli-claude.mjs"
+      native_model=$("$NODE_BIN" -e 'import(process.argv[1]).then(({plan}) => process.stdout.write(plan({agent: process.argv[2]}).model || ""))' "$native_adapter" "$AGENT_TYPE" 2>/dev/null)
+      if [[ -z "$native_model" ]]; then
+        echo "ERROR: Claude native handoff model 해석 실패: $AGENT_TYPE" >&2
+        exit 1
+      fi
       # 팀 모드: Hub에 fallback 필요 시그널 전송 후 구조화된 출력
       echo "[tfx-route] claude-native 역할($AGENT_TYPE)은 tfx-route.sh로 실행 불가 — Claude Agent fallback 필요" >&2
       team_complete_task "fallback" "claude-native 역할 실행 불가: ${AGENT_TYPE}. Claude Task(sonnet) 에이전트로 위임하세요."
@@ -2838,7 +3001,7 @@ ${ctx_content}
 === TFX_NEEDS_FALLBACK ===
 agent_type: ${AGENT_TYPE}
 reason: claude-native roles require Claude Agent tools (Read/Edit/Grep). tfx-route.sh cannot provide these.
-action: Lead should spawn Agent(subagent_type="${AGENT_TYPE}") for this task.
+action: Lead should spawn Agent(subagent_type="${AGENT_TYPE}", model="${native_model}") for this task.
 task_id: ${TFX_TEAM_TASK_ID:-none}
 FALLBACK_EOF
       exit 0

package/skills/tfx-harness/SKILL.md

@@ -2,88 +2,31 @@
 name: tfx-harness
 internal: true
 description: >
-  메타 라우팅 단일 진입점. 어떤 스킬/워크플로우/실행 레인으로 처리할지부터 판정해야 할 때
-  사용한다. '어떤 스킬 쓰지?', '스킬 추천', '스킬 라우팅', '작업 라우팅', '메타 라우팅',
-  'which skill', 'tfx-harness' 같은 요청에 사용. 작업 자체를 수행하는 스킬이 아니라
-  최소 유기적 경로를 구성해 다음 스킬로 핸드오프하는 라우터다.
+  어떤 스킬·경로를 선택할지 묻는 메타 라우팅 요청에 사용한다. 실행하지 않고
+  canonical routing SSOT에서 branch와 즉시 owner 하나만 반환한다.
 ---
 
-# tfx-harness — TFX/gstack/superpowers/OMC 라우팅 하니스 (Claude 정본)
+# tfx-harness — Claude adapter
 
-## 계약
+이 스킬은 실행 엔진이 아니다. `.claude/rules/tfx-routing.md`의 D0–D11을 읽어
+사용자 intent와 확인 가능한 host capability evidence를 판정한다. 정책 표, keyword
+표, owner 매트릭스를 이 파일에 복제하지 않는다.
 
-이 스킬은 라우팅 하니스이지 실행 엔진이 아니다.
-
-**핵심 행동: 최소 유기적 경로를 구성한 뒤 핸드오프한다.** 사용자의 작업을 분류하고,
-superpowers + gstack + OMC + TFX 중 가장 작은 유용한 조합을 고르고, 즉시 핸드오프
-대상 스킬을 Skill tool로 invoke한다. 다운스트림 스킬이나 오케스트레이션 레인이 없을
-때만 하니스가 직접 작업한다.
-
-라우팅 정책의 SSOT는 `.claude/rules/tfx-routing.md`다. 이 스킬은 그 정책을
-"어느 스킬로 넘길지" 판정으로 번역할 뿐, 표를 복제하지 않는다. 충돌 시 rules 문서가 이긴다.
-
-## 레이어 모델
-
-네 계열을 역할별로 함께 쓴다. 한 계열이 다른 계열을 대체하지 않는다.
-
-| 레이어 | 소유 | 대표 진입점 |
-| --- | --- | --- |
-| superpowers | 방법론·품질 규율 | systematic-debugging, test-driven-development, writing-plans, verification-before-completion |
-| gstack | 운영 워크플로우·증거 수집 | context-save/restore, qa, review, ship, investigate |
-| OMC | 실행 토폴로지·지속성 | autopilot, ralph, ultrawork, team, ralplan |
-| TFX | 로컬 자동화·CLI 브리지 | tfx-auto, tfx-plan, tfx-analysis, tfx-find, tfx-research, tfx-qa, tfx-review, tfx-ship |
-
-유기적 경로 문법:
-
-```text
-선행조건(복원/안전가드/소유권 탐색) -> 방법론 -> 운영 워크플로우 -> 실행 소유자 -> 검증/배포/저장
-```
-
-단계 중 하나만 **즉시 핸드오프 소유자**다. 나머지 레이어는 후속 단계 또는 제약으로 명시한다.
-
-## 판정 절차
-
-1. 지배적 레인 식별: 신규 계획 / 계속 / 직접 구현 / 디버그 / 리서치 / 검증 / 릴리즈 /
-   저장·복원 / 병렬 / 원격.
-2. `.claude/rules/tfx-routing.md`의 기본 워크플로우 ladder와 행동 유형 매핑으로 경로 구성.
-3. 즉시 핸드오프 소유자 하나를 선택한다. 하니스 안에서 전체 경로를 실행하지 않는다.
-4. 사용자가 "어떤 스킬?"만 물었다면: 경로 + 즉시 소유자 + 한 문장 근거로 답하고 실행하지
-   않는다 (recommendation-only).
-5. 진행 요청이거나 경로가 명백하면: Skill tool로 소유자 스킬을 invoke해 핸드오프한다.
-6. 혼합 요청은 선행조건 우선: 복원 → 탐색 → 디버그 → 수정 → 리뷰/QA → ship → 저장.
-7. 핸드오프 이후에는 tfx-harness를 활성 상태로 취급하지 않는다.
-
-## CLI 정책
-
-`.claude/rules/tfx-routing.md`의 "CLI 우선순위 정책 — default = Codex"를 따른다.
-구현/수정/디버그/리뷰/분석 레인의 기본 워커는 Codex(tfx-auto 경유), Antigravity는
-교차 확인, Claude는 메타 라우팅·planning gate·gstack 표면·최종 수단이다.
-모델명/프로파일은 이 문서에 하드코딩하지 않는다 — 프로필 설정이 SSOT다.
-
-## 출력 형태
+반환 형식:
 
 ```text
 [tfx-harness]
-lane: <지배적 레인>
-layers: method=<superpowers|none>, workflow=<gstack|none>, orchestration=<omc|none>, automation=<tfx|none>
-next: <즉시 핸드오프 소유자>
-followups: <후속 경로, 유용할 때만>
-reason: <한 문장>
-status: dispatching | recommendation-only | blocked
+branch: D<n>
+owner: <exactly one immediate owner>
+availability: available | unavailable | unknown
+fallback_notice: <optional>
+status: recommendation-only | dispatching | blocked
 ```
 
-## 회귀 가드
-
-- 존재하지 않는 스킬 이름을 출력하지 않는다. 현재 세션의 available skills 목록에 있는
-  이름만 쓴다.
-- 한 계열이 다른 계열을 대체하게 하지 않는다: superpowers=방법론, gstack=워크플로우,
-  OMC=오케스트레이션, TFX=자동화.
-- 다운스트림 소유자가 정해진 뒤에도 하니스 안에서 작업을 계속하지 않는다.
-- 신선한 검증 증거 없이 ship으로 라우팅하지 않는다.
-
-## Codex twin
-
-Codex 세션용 트윈(영문, `$skill` 문법, "Claude 실행 금지" 규정 포함)은 이 저장소가 아니라
-Codex 사용자 환경 배포 경로(`~/.codex` 스킬 표면)로 별도 배포한다. 이 저장소의
-`skills/tfx-harness/SKILL.md`는 Claude Code 정본이며, 두 문서는 라우팅 표를 공유하되
-호스트 규정(실행 금지 대상, 스킬 문법)만 다르다. 트윈을 이 파일로 덮어쓰지 않는다.
+- 한 판정에는 branch 하나와 immediate owner 하나만 둔다.
+- availability가 unknown이면 fallback하지 않는다. 실제 unavailable 증거가 있을 때만
+  `owner unavailable → tfx-X fallback`을 함께 알릴 수 있다.
+- SSOT를 읽지 못하면 추측하지 말고 `blocked: routing SSOT unavailable`을 반환한다.
+- “어떤 스킬/경로?” 질문은 recommendation-only다. 명백한 진행 요청만 `/skill` 문법으로
+  owner에 handoff한다.
+- downstream implementation agent나 model은 선택하지 않는다.

package/skills/tfx-hub/SKILL.md

@@ -43,7 +43,7 @@ Bash("codex --profile gpt56_sol_xhigh exec --dangerously-bypass-approvals-and-sa
 #          ↑ --profile은 exec 앞에, --skip-git-repo-check은 exec 뒤에
 
 # Claude 네이티브 (탐색/검증)
-Agent(subagent_type="oh-my-claudecode:explore", prompt="{작업}")
+Agent(subagent_type="oh-my-claudecode:explore", model="haiku", prompt="{작업}")
 ```
 
 ## 커맨드

package/skills/tfx-interview/SKILL.md

@@ -1,12 +1,14 @@
 ---
 internal: true
 name: tfx-interview
-description: "요구사항이 모호하거나 구현 전 명확화가 필요할 때 사용한다. 'interview', 'deep-interview', '딥인터뷰', '소크라테스', '깊이 탐색', '요구사항 분석', '인터뷰', '요구사항 정리', '뭘 만들어야 하는지 모르겠어', '명확하게 해줘' 같은 요청에 반드시 사용. 구현 시작 전 스펙을 확정하고 싶을 때 적극 활용."
+description: "명시 `tfx-interview` 또는 TFX 정량·다중 CLI 요구사항 탐색을 요청할 때 사용한다. 무수식 일반 요구사항 명확화는 host deep-interview가 소유한다."
 argument-hint: "<구현할 주제 또는 요구사항>"
 ---
 
 # tfx-interview — Quantified Socratic Requirements Exploration
 
+라우팅 정본 D2는 `.claude/rules/tfx-routing.md`를 따른다.
+
 > **ARGUMENTS 처리**: 이 스킬이 `ARGUMENTS: <값>`과 함께 호출되면, 해당 값을 사용자 입력으로 취급하여
 > 워크플로우의 첫 단계 입력으로 사용한다. ARGUMENTS가 비어있거나 없으면 기존 절차대로 사용자에게 입력을 요청한다.
 

package/skills/tfx-interview/skill.json

@@ -1,18 +1,6 @@
 {
   "name": "tfx-interview",
-  "description": "요구사항이 모호하거나 구현 전 명확화가 필요할 때 사용한다. 'interview', 'deep-interview', '딥인터뷰', '소크라테스', '깊이 탐색', '요구사항 분석', '인터뷰', '요구사항 정리', '뭘 만들어야 하는지 모르겠어', '명확하게 해줘' 같은 요청에 반드시 사용. 구현 시작 전 스펙을 확정하고 싶을 때 적극 활용.",
-  "triggers": [
-    "interview",
-    "deep-interview",
-    "딥인터뷰",
-    "소크라테스",
-    "깊이 탐색",
-    "요구사항 분석",
-    "인터뷰",
-    "요구사항 탐색",
-    "tfx-interview",
-    "모호성 분석"
-  ],
+  "description": "명시 `tfx-interview` 또는 TFX 정량·다중 CLI 요구사항 탐색을 요청할 때 사용한다. 무수식 일반 요구사항 명확화는 host deep-interview가 소유한다.",
   "argument_hint": "<구현할 주제 또는 요구사항>",
   "internal": true
 }

package/skills/tfx-profile/SKILL.md

@@ -13,7 +13,8 @@ argument-hint: "[--list] [--codex | --gemini]"
 # tfx-profile — Codex/Antigravity 프로파일 매니저
 
 > CLI 프로파일의 모델/effort를 AskUserQuestion 선택지로 관리합니다.
-> Codex(`~/.codex/config.toml`)와 Antigravity(`~/.gemini/triflux-profiles.json`) 모두 지원.
+> Codex(`~/.codex/config.toml` + `~/.codex/<profile>.config.toml`)와
+> Antigravity(`~/.gemini/triflux-profiles.json`) 모두 지원.
 
 ## 워크플로우
 
@@ -36,9 +37,10 @@ options:
 
 ## Codex 워크플로우
 
-### Step 1: config.toml 읽기 + 현재 상태 표시
+### Step 1: Codex 설정 읽기 + 현재 상태 표시
 
-`~/.codex/config.toml`을 Read 도구로 읽고 프로파일 테이블을 마크다운으로 출력한다:
+`~/.codex/config.toml`의 top-level 기본값과
+`~/.codex/*.config.toml` 프로파일 파일을 읽어 테이블을 출력한다:
 
 ```
 | 프로파일 | 모델 | Effort |
@@ -76,11 +78,13 @@ options:
      - label: "gpt56_terra_high" → 기본 고품질 (Recommended)
      - label: "gpt56_terra_med"  → 균형형
      - label: "gpt56_luna_low"   → 빠른 경량
-     - label: "gpt56_sol_xhigh"  → 최대 추론
+     - label: "gpt56_sol_xhigh"  → 고강도 추론
+     - label: "gpt56_sol_max"    → 최난도 단일 작업
+     - label: "gpt56_sol_ultra"  → 최상위 자동 위임 (비중첩 전용)
      - label: "custom"      → 사용자가 관리하는 프로필
    ```
-3. AskUserQuestion으로 effort 선택: `low | medium | high | xhigh`
-4. Edit 도구로 config.toml 수정
+3. AskUserQuestion으로 effort 선택: `low | medium | high | xhigh | max | ultra`
+4. Edit 도구로 `~/.codex/<선택한 이름>.config.toml` 수정
 
 #### 기본 모델 변경
 
@@ -88,12 +92,12 @@ options:
 
 #### 프로파일 추가/삭제
 
-추가: 이름 → 모델 → effort → `[profiles.name]` 섹션 추가
-삭제: 선택 → 확인 → 섹션 제거
+추가: 이름 → 모델 → effort → `~/.codex/<name>.config.toml` 생성
+삭제: 선택 → 확인 → 해당 `~/.codex/<name>.config.toml` 삭제
 
 ### Step 4: 결과 확인
 
-변경된 config.toml을 다시 읽어 업데이트된 테이블 표시.
+변경된 top-level config와 프로파일 파일을 다시 읽어 업데이트된 테이블 표시.
 
 ---
 
@@ -162,12 +166,14 @@ options:
 
 ## 수정 규칙
 
-### Codex (config.toml)
+### Codex
 
 - **백업 필수**: 수정 전 원본 기억
-- **프로파일 섹션 형식**: `[profiles.name]\nmodel = "..."\nmodel_reasoning_effort = "..."`
-- **다른 섹션 건드리지 않기**: `[notice]`, `[features]`, `[mcp_servers.*]` 등 절대 수정 금지
-- **Edit 도구 사용**: old_string → new_string으로 정확한 섹션만 치환
+- **프로파일 파일 형식**: `~/.codex/<name>.config.toml` 안에
+  `model = "..."`와 `model_reasoning_effort = "..."`를 top-level 키로 기록
+- **inline 프로파일 금지**: `config.toml`에 `[profiles.<name>]` 섹션을 추가하지 않기
+- **기본값만 config.toml에서 수정**: top-level `model`,
+  `model_reasoning_effort` 외 `[notice]`, `[features]`, `[mcp_servers.*]` 등은 건드리지 않기
 
 ### Antigravity (triflux-profiles.json)
 
@@ -182,7 +188,9 @@ options:
 | 프로필 | 용도 |
 |------|------|
 | gpt56_terra_high | 기본 고품질 |
-| gpt56_sol_xhigh | 최대 추론 |
+| gpt56_sol_xhigh | 고강도 추론 |
+| gpt56_sol_max | 최난도 단일 작업 |
+| gpt56_sol_ultra | 최상위 자동 위임 (비중첩 전용) |
 | gpt56_terra_med | 균형형 |
 | gpt56_luna_low | 빠른 경량 |
 | custom | 사용자가 관리하는 프로필 |
@@ -194,7 +202,9 @@ options:
 | low | 빠른 응답, 최소 추론 |
 | medium | 균형 잡힌 추론 |
 | high | 깊은 추론 |
-| xhigh | 최대 추론 (느림) |
+| xhigh | 고강도 추론 |
+| max | 최난도 단일 작업용 최대 추론 |
+| ultra | 최대 추론 + 자동 작업 위임; 팀/스웜 내부 사용 금지 |
 
 ### Antigravity 프로필