triflux 4.2.5 → 4.2.6

package/skills/tfx-multi/references/agent-wrapper-rules.md

@@ -0,0 +1,81 @@
+# Agent 래퍼 상세 규칙
+
+## 슬림 래퍼의 존재 이유
+
+Native Teams의 teammate는 Claude 모델만 가능하다.
+Codex/Gemini는 teammate로 직접 등록할 수 없으므로, Claude slim wrapper를 spawn하고
+래퍼 내부에서 `tfx-route.sh`로 Codex/Gemini CLI를 실행하는 구조이다.
+
+래퍼가 존재하는 이유:
+1. **Shift+Down 네비게이션 등록** — 래퍼 없이 Lead가 직접 Bash를 실행하면 네비게이션에 등록되지 않음
+2. **리드↔워커 피드백 루프** — 워커가 결과를 보고하면 턴 경계가 생겨 리드가 방향을 수정할 수 있음
+3. **실패 시 재실행** — N회 실행을 지원
+
+## 필수 규칙
+
+### 1. Agent 래퍼 생략 금지
+
+Codex/Gemini 서브태스크는 워커 수에 관계없이 반드시 Agent 래퍼를 spawn해야 한다.
+단일 워커(1:gemini 등)여도 Lead가 직접 Bash를 실행하면 안 된다.
+Lead가 "효율적"이라고 판단해서 Agent를 건너뛰는 것은 금지한다.
+
+### 2. mode: bypassPermissions 필수
+
+모든 Agent spawn에 반드시 `mode: "bypassPermissions"`를 포함한다.
+이 설정이 없으면 워커가 Bash 실행 시 사용자 승인을 요청하여 자동 실행이 중단된다.
+
+### 3. tfx-route.sh 경유 필수
+
+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}`을 통해 실행해야 한다.
+
+### 4. 코드 직접 조작 금지
+
+슬림 래퍼 워커가 코드를 직접 읽거나 수정하면 안 된다.
+codex-worker는 반드시 tfx-route.sh를 통해 Codex에 위임하고, gemini-worker도 마찬가지다.
+워커가 Read, Edit, Write, Grep, Glob 등 도구를 직접 사용하는 것은 위임 구조 위반이다.
+
+## 인터럽트 프로토콜
+
+워커가 Bash 실행 전에 SendMessage로 시작을 보고하면 턴 경계가 생겨 리드가 방향 전환 메시지를 보낼 수 있다.
+
+```
+1. TaskUpdate(taskId, status: in_progress) — task claim
+2. SendMessage(to: team-lead, "작업 시작: {agentName}") — 시작 보고 (턴 경계 생성)
+3. Bash(command: tfx-route.sh ..., timeout: {bashTimeoutMs}) — 실행
+4. SendMessage(to: team-lead, "결과: {요약}") — 결과 보고 (턴 경계 생성)
+5. 리드 피드백 대기 — 피드백 수신 시 Step 3으로 돌아가 재실행
+6. 최종 완료 시 TaskUpdate(status: completed, metadata: {result}) + SendMessage → 종료
+```
+
+리드는 워커의 Step 2, Step 4 시점에 턴 경계를 인식하고, 방향 전환/추가 지시/재실행 요청을 보낼 수 있다.
+
+## Bash timeout 동적 상속
+
+Bash timeout은 tfx-route.sh의 role/profile별 timeout + 60초 여유를 ms로 변환하여 동적 상속한다.
+`getRouteTimeout(role, mcpProfile)` 기준:
+- analyze/review 프로필 또는 architect/analyst 역할: 3600초
+- 그 외 기본: 1080초(18분)
+
+## 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}`

package/skills/tfx-multi/references/thorough-pipeline.md

@@ -0,0 +1,66 @@
+# --thorough 파이프라인 상세
+
+> `--quick`(기본) 모드에서는 이 파일의 내용이 적용되지 않는다.
+> `--thorough` 모드에서만 Phase 2.5-2.6과 Phase 3.5-3.7이 실행된다.
+
+## Phase 2.5: Plan (Codex architect)
+
+1. Hub pipeline 초기화:
+   ```bash
+   Bash("node hub/bridge.mjs pipeline-advance --team ${teamName} --status plan")
+   ```
+   — 또는 createPipeline(db, teamName) 직접 호출
+2. Codex architect로 작업 분석 + 접근법 설계:
+   ```bash
+   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
+   bash ~/.claude/scripts/tfx-route.sh analyst "${task}" analyze
+   ```
+2. 결과를 파이프라인 artifact에 저장:
+   ```
+   pipeline.setArtifact('prd_path', prdOutputPath)
+   ```
+3. pipeline advance: prd → exec
+
+## Phase 3.5: Verify (Codex review)
+
+1. pipeline advance: exec → verify
+2. Codex verifier로 결과 검증:
+   ```bash
+   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
+   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부터)

package/skills/tfx-workspace/evals/evals.json

@@ -0,0 +1,79 @@
+{
+  "skill_name": "tfx-skills-suite",
+  "evals": [
+    {
+      "id": 1,
+      "prompt": "You are a Claude Code agent. Read the tfx-auto skill definition, then explain how you would handle this user request: '/implement JWT 인증 미들웨어 추가해줘'. List the EXACT bash commands you would run. Do NOT actually execute them.",
+      "expected_output": "Should route to executor agent via tfx-route.sh with 'implement' MCP profile. Command: bash ~/.claude/scripts/tfx-route.sh executor 'JWT 인증 미들웨어 추가해줘' implement",
+      "files": [],
+      "expectations": [
+        "Routes to 'executor' agent (not architect, not analyst)",
+        "Uses 'implement' MCP profile",
+        "Generates correct tfx-route.sh command syntax",
+        "Does NOT trigger triage (single command shortcut)",
+        "Does NOT delegate to tfx-multi"
+      ]
+    },
+    {
+      "id": 2,
+      "prompt": "You are a Claude Code agent. Read the tfx-auto skill definition, then explain how you would handle: '/tfx-auto 프론트엔드 리팩터링하고 보안 리뷰도 해줘'. List all routing decisions, triage steps, and delegation.",
+      "expected_output": "Should enter auto triage mode, classify via Codex, decompose into 2+ subtasks, then delegate to tfx-multi Phase 3",
+      "files": [],
+      "expectations": [
+        "Identifies this as auto mode (not command shortcut)",
+        "Triggers Codex classification step",
+        "Decomposes into at least 2 subtasks",
+        "Notes delegation to tfx-multi for subtasks >= 2",
+        "Does NOT try to execute all subtasks directly"
+      ]
+    },
+    {
+      "id": 3,
+      "prompt": "You are a Claude Code agent. Read the tfx-multi skill definition, then explain step-by-step how you would handle: '/tfx-multi 인증 리팩터링 + UI 개선 + 보안 리뷰'. List all TeamCreate, TaskCreate, Agent calls with exact parameters.",
+      "expected_output": "Should create team, 3 TaskCreates, 3 Agent spawns with slim wrapper structure following Phase 0-5",
+      "files": [],
+      "expectations": [
+        "Creates exactly one TeamCreate with tfx- prefix naming",
+        "Creates 3 TaskCreate calls (one per subtask)",
+        "Spawns 3 Agent wrappers with mode: bypassPermissions",
+        "Uses tfx-route.sh inside Agent wrapper (not direct codex/gemini)",
+        "Includes Phase 5 cleanup (TeamDelete)"
+      ]
+    },
+    {
+      "id": 4,
+      "prompt": "You are a Claude Code agent. Read the tfx-doctor skill definition, then explain how you would handle: 'HUD가 안 보이고 codex도 안 되는데 어떻게 해?'. List exact commands and reasoning.",
+      "expected_output": "Should suggest running triflux doctor first, then triflux doctor --fix if issues found",
+      "files": [],
+      "expectations": [
+        "Runs 'triflux doctor' as first diagnostic step",
+        "Suggests '--fix' mode for auto-repair",
+        "Mentions HUD and CLI path checks in explanation",
+        "Does NOT jump straight to --reset (that's for cache only)"
+      ]
+    },
+    {
+      "id": 5,
+      "prompt": "You are a Claude Code agent. Read the tfx-hub skill definition, then explain how you would handle: '/tfx-hub start'. List exact commands.",
+      "expected_output": "Should run 'node hub/server.mjs' in background",
+      "files": [],
+      "expectations": [
+        "Runs 'node hub/server.mjs' with run_in_background=true",
+        "Mentions port 27888 and /mcp endpoint",
+        "Does NOT try to run any triage or routing"
+      ]
+    },
+    {
+      "id": 6,
+      "prompt": "You are a Claude Code agent. Read the tfx-codex skill definition, then explain the Gemini-to-Codex remapping. For '/tfx-codex API 문서를 작성하고 디자인 가이드도 만들어줘', list the routing showing how designer/writer get remapped.",
+      "expected_output": "designer remapped to Codex(high), writer to Codex Spark(spark_fast), TFX_CLI_MODE=codex env var",
+      "files": [],
+      "expectations": [
+        "designer remapped to Codex with effort: high",
+        "writer remapped to Codex Spark with effort: spark_fast",
+        "Sets TFX_CLI_MODE=codex environment variable",
+        "Changes MCP profile: designer->implement, writer->analyze"
+      ]
+    }
+  ]
+}

package/skills/tfx-workspace/iteration-1/benchmark.json

@@ -0,0 +1,162 @@
+{
+  "metadata": {
+    "skill_name": "tfx-skills-suite",
+    "skill_path": "C:/Users/SSAFY/Desktop/Projects/cli/triflux/skills",
+    "executor_model": "claude-sonnet-4-6",
+    "analyzer_model": "claude-opus-4-6",
+    "timestamp": "2026-03-19T10:00:00Z",
+    "evals_run": [1, 2, 3, 4, 5, 6],
+    "runs_per_configuration": 1
+  },
+  "runs": [
+    {
+      "eval_id": 1, "eval_name": "routing-implement-shortcut", "configuration": "with_skill", "run_number": 1,
+      "result": {"pass_rate": 1.0, "passed": 5, "failed": 0, "total": 5, "time_seconds": 43.6, "tokens": 16303, "tool_calls": 4, "errors": 0},
+      "expectations": [
+        {"text": "Routes to executor agent", "passed": true, "evidence": "Correctly mapped from implement shortcut table"},
+        {"text": "Uses implement MCP profile", "passed": true, "evidence": "Mapped from shortcut table"},
+        {"text": "Generates correct tfx-route.sh command", "passed": true, "evidence": "bash ~/.claude/scripts/tfx-route.sh executor '...' implement"},
+        {"text": "Does NOT trigger triage", "passed": true, "evidence": "Command shortcut skips triage"},
+        {"text": "Does NOT delegate to tfx-multi", "passed": true, "evidence": "No subtask decomposition occurred"}
+      ]
+    },
+    {
+      "eval_id": 1, "eval_name": "routing-implement-shortcut", "configuration": "without_skill", "run_number": 1,
+      "result": {"pass_rate": 1.0, "passed": 5, "failed": 0, "total": 5, "time_seconds": 48.1, "tokens": 16436, "tool_calls": 4, "errors": 0},
+      "expectations": [
+        {"text": "Routes to executor agent", "passed": true, "evidence": "Correctly mapped"},
+        {"text": "Uses implement MCP profile", "passed": true, "evidence": "Assigned by shortcut table"},
+        {"text": "Generates correct tfx-route.sh command", "passed": true, "evidence": "Correct syntax generated"},
+        {"text": "Does NOT trigger triage", "passed": true, "evidence": "Shortcut mode skips triage"},
+        {"text": "Does NOT delegate to tfx-multi", "passed": true, "evidence": "No delegation"}
+      ]
+    },
+    {
+      "eval_id": 2, "eval_name": "routing-multi-task-triage", "configuration": "with_skill", "run_number": 1,
+      "result": {"pass_rate": 1.0, "passed": 5, "failed": 0, "total": 5, "time_seconds": 58.2, "tokens": 17584, "tool_calls": 3, "errors": 0},
+      "expectations": [
+        {"text": "Identifies as auto mode", "passed": true, "evidence": "No shortcut match, auto mode selected"},
+        {"text": "Triggers Codex classification", "passed": true, "evidence": "Codex --full-auto classification triggered"},
+        {"text": "Decomposes into 2+ subtasks", "passed": true, "evidence": "2 subtasks: executor + security-reviewer"},
+        {"text": "Notes tfx-multi delegation", "passed": true, "evidence": "subtasks.length >= 2 triggers tfx-multi Phase 3"},
+        {"text": "Does NOT execute directly", "passed": true, "evidence": "Delegates to tfx-multi"}
+      ]
+    },
+    {
+      "eval_id": 2, "eval_name": "routing-multi-task-triage", "configuration": "without_skill", "run_number": 1,
+      "result": {"pass_rate": 1.0, "passed": 5, "failed": 0, "total": 5, "time_seconds": 77.2, "tokens": 18626, "tool_calls": 4, "errors": 0},
+      "expectations": [
+        {"text": "Identifies as auto mode", "passed": true, "evidence": "Auto mode selected"},
+        {"text": "Triggers Codex classification", "passed": true, "evidence": "Codex --full-auto triggered"},
+        {"text": "Decomposes into 2+ subtasks", "passed": true, "evidence": "2 subtasks decomposed"},
+        {"text": "Notes tfx-multi delegation", "passed": true, "evidence": "Hands off to tfx-multi Phase 3"},
+        {"text": "Does NOT execute directly", "passed": true, "evidence": "Delegates correctly"}
+      ]
+    },
+    {
+      "eval_id": 3, "eval_name": "multi-team-creation", "configuration": "with_skill", "run_number": 1,
+      "result": {"pass_rate": 1.0, "passed": 5, "failed": 0, "total": 5, "time_seconds": 115.3, "tokens": 27197, "tool_calls": 3, "errors": 0},
+      "expectations": [
+        {"text": "Creates TeamCreate with tfx- prefix", "passed": true, "evidence": "TeamCreate({ team_name: 'tfx-<base36>' })"},
+        {"text": "Creates 3 TaskCreate calls", "passed": true, "evidence": "3x TaskCreate with metadata"},
+        {"text": "Spawns 3 Agent wrappers with bypassPermissions", "passed": true, "evidence": "3x Agent({ mode: bypassPermissions })"},
+        {"text": "Uses tfx-route.sh inside wrappers", "passed": true, "evidence": "Direct codex/gemini calls prohibited"},
+        {"text": "Includes Phase 5 TeamDelete", "passed": true, "evidence": "TeamDelete always runs, max 30s wait"}
+      ]
+    },
+    {
+      "eval_id": 3, "eval_name": "multi-team-creation", "configuration": "without_skill", "run_number": 1,
+      "result": {"pass_rate": 1.0, "passed": 5, "failed": 0, "total": 5, "time_seconds": 100.6, "tokens": 26140, "tool_calls": 3, "errors": 0},
+      "expectations": [
+        {"text": "Creates TeamCreate with tfx- prefix", "passed": true, "evidence": "TeamCreate with tfx-<id>"},
+        {"text": "Creates 3 TaskCreate calls", "passed": true, "evidence": "Three TaskCreate calls"},
+        {"text": "Spawns 3 Agent wrappers with bypassPermissions", "passed": true, "evidence": "mode: bypassPermissions in all 3"},
+        {"text": "Uses tfx-route.sh inside wrappers", "passed": true, "evidence": "Never direct codex/gemini calls"},
+        {"text": "Includes Phase 5 TeamDelete", "passed": true, "evidence": "TeamDelete unconditionally"}
+      ]
+    },
+    {
+      "eval_id": 4, "eval_name": "doctor-diagnosis", "configuration": "with_skill", "run_number": 1,
+      "result": {"pass_rate": 1.0, "passed": 4, "failed": 0, "total": 4, "time_seconds": 53.8, "tokens": 14499, "tool_calls": 4, "errors": 0},
+      "expectations": [
+        {"text": "Runs triflux doctor first", "passed": true, "evidence": "Bash(\"triflux doctor\")"},
+        {"text": "Suggests --fix mode", "passed": true, "evidence": "Suggests after diagnosis report"},
+        {"text": "Mentions HUD and CLI checks", "passed": true, "evidence": "HUD and CLI paths checked"},
+        {"text": "Does NOT jump to --reset", "passed": true, "evidence": "--reset reserved for explicit request"}
+      ]
+    },
+    {
+      "eval_id": 4, "eval_name": "doctor-diagnosis", "configuration": "without_skill", "run_number": 1,
+      "result": {"pass_rate": 1.0, "passed": 4, "failed": 0, "total": 4, "time_seconds": 48.3, "tokens": 14482, "tool_calls": 3, "errors": 0},
+      "expectations": [
+        {"text": "Runs triflux doctor first", "passed": true, "evidence": "Bash(\"triflux doctor\")"},
+        {"text": "Suggests --fix mode", "passed": true, "evidence": "Offers --fix after diagnosis"},
+        {"text": "Mentions HUD and CLI checks", "passed": true, "evidence": "All 8 diagnostics listed"},
+        {"text": "Does NOT jump to --reset", "passed": true, "evidence": "--reset reserved for explicit request"}
+      ]
+    },
+    {
+      "eval_id": 5, "eval_name": "hub-start-sequence", "configuration": "with_skill", "run_number": 1,
+      "result": {"pass_rate": 1.0, "passed": 3, "failed": 0, "total": 3, "time_seconds": 47.2, "tokens": 14821, "tool_calls": 4, "errors": 0},
+      "expectations": [
+        {"text": "Runs node hub/server.mjs in background", "passed": true, "evidence": "Bash(\"node hub/server.mjs\", run_in_background=true)"},
+        {"text": "Mentions port 27888 and /mcp", "passed": true, "evidence": "Port 27888, http://127.0.0.1:27888/mcp"},
+        {"text": "No triage or routing attempted", "passed": true, "evidence": "Command match, not fallthrough"}
+      ]
+    },
+    {
+      "eval_id": 5, "eval_name": "hub-start-sequence", "configuration": "without_skill", "run_number": 1,
+      "result": {"pass_rate": 1.0, "passed": 3, "failed": 0, "total": 3, "time_seconds": 51.8, "tokens": 14904, "tool_calls": 4, "errors": 0},
+      "expectations": [
+        {"text": "Runs node hub/server.mjs in background", "passed": true, "evidence": "Bash(\"node hub/server.mjs\", run_in_background=true)"},
+        {"text": "Mentions port 27888 and /mcp", "passed": true, "evidence": "Port 27888, endpoint /mcp"},
+        {"text": "No triage or routing attempted", "passed": true, "evidence": "Command match, not fallthrough"}
+      ]
+    },
+    {
+      "eval_id": 6, "eval_name": "codex-gemini-remap", "configuration": "with_skill", "run_number": 1,
+      "result": {"pass_rate": 1.0, "passed": 4, "failed": 0, "total": 4, "time_seconds": 69.7, "tokens": 14889, "tool_calls": 5, "errors": 0},
+      "expectations": [
+        {"text": "designer remapped to Codex (effort: high)", "passed": true, "evidence": "designer → Codex (effort: high)"},
+        {"text": "writer remapped to Codex Spark (spark_fast)", "passed": true, "evidence": "writer → Codex Spark (effort: spark_fast)"},
+        {"text": "TFX_CLI_MODE=codex set", "passed": true, "evidence": "Set for every Phase 3 call"},
+        {"text": "MCP profiles changed", "passed": true, "evidence": "designer→implement, writer→analyze"}
+      ]
+    },
+    {
+      "eval_id": 6, "eval_name": "codex-gemini-remap", "configuration": "without_skill", "run_number": 1,
+      "result": {"pass_rate": 1.0, "passed": 4, "failed": 0, "total": 4, "time_seconds": 85.2, "tokens": 19802, "tool_calls": 7, "errors": 0},
+      "expectations": [
+        {"text": "designer remapped to Codex (effort: high)", "passed": true, "evidence": "designer → Codex (effort: high)"},
+        {"text": "writer remapped to Codex Spark (spark_fast)", "passed": true, "evidence": "writer → Codex Spark (effort: spark_fast)"},
+        {"text": "TFX_CLI_MODE=codex set", "passed": true, "evidence": "TFX_CLI_MODE set to codex"},
+        {"text": "MCP profiles changed", "passed": true, "evidence": "writer→analyze, designer→implement"}
+      ]
+    }
+  ],
+  "run_summary": {
+    "with_skill": {
+      "pass_rate": {"mean": 1.0, "stddev": 0.0, "min": 1.0, "max": 1.0},
+      "time_seconds": {"mean": 64.6, "stddev": 26.4, "min": 43.6, "max": 115.3},
+      "tokens": {"mean": 17549, "stddev": 4857, "min": 14499, "max": 27197}
+    },
+    "without_skill": {
+      "pass_rate": {"mean": 1.0, "stddev": 0.0, "min": 1.0, "max": 1.0},
+      "time_seconds": {"mean": 68.5, "stddev": 20.4, "min": 48.1, "max": 100.6},
+      "tokens": {"mean": 18398, "stddev": 4227, "min": 14482, "max": 26140}
+    },
+    "delta": {
+      "pass_rate": "+0.00",
+      "time_seconds": "-3.9",
+      "tokens": "-849"
+    }
+  },
+  "notes": [
+    "All 26 assertions pass at 100% for both configurations — the skills are functionally correct",
+    "The fixes applied (dead reference removal, Phase numbering consistency, hub description) don't change routing logic, so pass rates are identical",
+    "NEW version is marginally faster (-3.9s avg) and uses fewer tokens (-849 avg), likely due to cleaner references reducing model confusion",
+    "tfx-multi is the most complex skill (115s / 27K tokens with_skill) — consider extracting reference docs to reduce context load",
+    "tfx-codex OLD references 'Phase(1~6)' which doesn't exist in tfx-auto — the NEW version correctly references the actual workflow names",
+    "All assertions pass regardless of configuration — these test the core routing logic which is unchanged. Consider adding assertions that specifically test the fixed issues (dead refs, phase naming) for differentiation"
+  ]
+}

package/skills/tfx-workspace/iteration-1/codex-gemini-remap/eval_metadata.json

@@ -0,0 +1,11 @@
+{
+  "eval_id": 6,
+  "eval_name": "codex-gemini-remap",
+  "prompt": "/tfx-codex API 문서를 작성하고 디자인 가이드도 만들어줘",
+  "assertions": [
+    "designer remapped to Codex with effort: high",
+    "writer remapped to Codex Spark with effort: spark_fast",
+    "Sets TFX_CLI_MODE=codex environment variable",
+    "Changes MCP profile: designer->implement, writer->analyze"
+  ]
+}

package/skills/tfx-workspace/iteration-1/codex-gemini-remap/old_skill/grading.json

@@ -0,0 +1,9 @@
+{
+  "expectations": [
+    {"text": "designer remapped to Codex with effort: high", "passed": true, "evidence": "Agent output: designer → Codex (effort: high)"},
+    {"text": "writer remapped to Codex Spark with effort: spark_fast", "passed": true, "evidence": "Agent output: writer → Codex Spark (effort: spark_fast)"},
+    {"text": "Sets TFX_CLI_MODE=codex environment variable", "passed": true, "evidence": "Agent output: 'TFX_CLI_MODE: Set to codex'"},
+    {"text": "Changes MCP profile: designer->implement, writer->analyze", "passed": true, "evidence": "Agent output: writer→analyze, designer→implement"}
+  ],
+  "summary": {"passed": 4, "failed": 0, "total": 4, "pass_rate": 1.0}
+}

package/skills/tfx-workspace/iteration-1/codex-gemini-remap/old_skill/outputs/analysis.md

@@ -0,0 +1,154 @@
+# tfx-codex 라우팅 분석 — DRY RUN
+
+**요청**: `/tfx-codex API 문서를 작성하고 디자인 가이드도 만들어줘`
+**분석 기준 SKILL**: `skills/tfx-workspace/skill-snapshot/tfx-codex/SKILL.md`
+
+---
+
+## 1. 에이전트 리매핑 테이블
+
+이 요청은 두 개의 독립 서브태스크로 분해됩니다:
+- 서브태스크 A: "API 문서를 작성" → **writer** 역할
+- 서브태스크 B: "디자인 가이드도 만들어줘" → **designer** 역할
+
+| 에이전트 | 원래 CLI (tfx-auto) | tfx-codex에서 | effort 파라미터 | MCP 프로필 |
+|----------|---------------------|---------------|-----------------|-----------|
+| **writer** | ~~Gemini~~ (`docs` MCP) | **Codex** (effort: spark_fast) — Codex Spark 경량 문서 | `spark_fast` | `analyze` |
+| **designer** | ~~Gemini~~ (`docs` MCP) | **Codex** (effort: high) — UI 코드 생성 | `high` | `implement` |
+
+### 원본 tfx-auto 기준 (리매핑 전)
+
+`tfx-auto` SKILL.md의 에이전트 매핑 테이블에서:
+
+```
+| gemini / designer / writer | Gemini | docs |
+```
+
+즉, 원래 두 역할 모두 Gemini CLI + `docs` MCP로 실행됩니다.
+
+### tfx-codex 기준 (리매핑 후)
+
+`tfx-codex` SKILL.md의 에이전트 라우팅 테이블에서:
+
+```
+| designer | ~~Gemini~~ | Codex (effort: high) — UI 코드 생성     | implement |
+| writer   | ~~Gemini~~ | Codex Spark (effort: spark_fast) — 경량 문서 | analyze   |
+```
+
+---
+
+## 2. TFX_CLI_MODE 환경변수
+
+```
+TFX_CLI_MODE=codex
+```
+
+이 환경변수는 tfx-route.sh에 전달되어 Gemini 에이전트가 선택될 경우 Codex로 강제 교체하도록 지시합니다. Phase 2 트리아지에서 Codex 분류기가 `gemini`를 반환하더라도 이 값에 의해 `codex`로 교체됩니다.
+
+---
+
+## 3. Phase 2 트리아지 동작
+
+**자동 모드** (`/tfx-codex "API 문서를 작성하고 디자인 가이드도 만들어줘"`):
+
+1. **Codex 분류** (`--full-auto --skip-git-repo-check`):
+   - 입력 파싱 결과 예상 JSON:
+     ```json
+     {
+       "parts": [
+         { "description": "API 문서 작성", "agent": "gemini" },
+         { "description": "디자인 가이드 생성", "agent": "gemini" }
+       ]
+     }
+     ```
+   - `TFX_CLI_MODE=codex` 적용 → 두 항목 모두 `"gemini"` → **`"codex"`로 강제 교체**
+
+2. **Opus 인라인 분해** (강제 변환 이후):
+   - `writer` 역할: MCP 프로필 `analyze` 할당
+   - `designer` 역할: MCP 프로필 `implement` 할당
+   - 두 서브태스크는 독립적(INDEPENDENT), `graph_type: "INDEPENDENT"`
+
+3. **서브태스크 수 = 2** → tfx-multi Native Teams 모드로 자동 전환 (tfx-auto 규칙: 2개 이상 시 tfx-multi Phase 3)
+
+---
+
+## 4. 생성되는 Bash 커맨드 (서브태스크별)
+
+서브태스크가 2개이므로 tfx-multi Phase 3a(TeamCreate) → Phase 3b(TaskCreate) → Phase 3c(Agent 래퍼 spawn) 순서로 실행됩니다. 각 Agent 래퍼 내부에서 다음 Bash 커맨드가 실행됩니다:
+
+### 서브태스크 A — writer (API 문서 작성)
+
+```bash
+TFX_CLI_MODE=codex bash ~/.claude/scripts/tfx-route.sh writer 'API 문서를 작성해줘' analyze
+```
+
+- `writer` 에이전트: Codex Spark (`effort: spark_fast`) 로 실행
+- MCP 프로필: `analyze` (문서 기반 리서치+작성)
+- `run_in_background=true` (INDEPENDENT 병렬 실행)
+
+### 서브태스크 B — designer (디자인 가이드 생성)
+
+```bash
+TFX_CLI_MODE=codex bash ~/.claude/scripts/tfx-route.sh designer '디자인 가이드를 만들어줘' implement
+```
+
+- `designer` 에이전트: Codex (`effort: high`) 로 실행
+- MCP 프로필: `implement` (코드 기반 UI 작업)
+- `run_in_background=true` (INDEPENDENT 병렬 실행)
+
+> 두 서브태스크는 `depends_on` 없이 Level 0에서 병렬 실행됩니다.
+
+---
+
+## 5. MCP 프로필 변화 상세
+
+| 에이전트 | tfx-auto 원본 MCP | tfx-codex 변경 후 MCP | 변경 이유 |
+|----------|-------------------|----------------------|----------|
+| **writer** | `docs` | `analyze` | Gemini → Codex 전환 시 문서 리서치+작성에 적합한 `analyze` 프로필 사용 |
+| **designer** | `docs` | `implement` | Gemini → Codex 전환 시 UI 코드 생성에 적합한 `implement` 프로필 사용 |
+
+원래 `docs` MCP는 Gemini CLI의 웹 검색/문서 접근 기능을 전제로 설계되었습니다. Codex로 리매핑 시 각 역할의 실제 작업 성격에 맞는 프로필로 교체됩니다.
+
+---
+
+## 6. 워크플로우 레퍼런스
+
+**tfx-codex는 tfx-auto SKILL.md의 Phase 1~6 전체를 그대로 따릅니다.**
+
+```
+Phase 1: 입력 파싱 — 트리거 `/tfx-codex` 인식, 인자 추출
+Phase 2: 트리아지
+  - Codex 분류 실행 (TFX_CLI_MODE=codex)
+  - gemini 반환값 → codex 강제 교체
+  - Opus 인라인 분해 (writer→analyze MCP, designer→implement MCP)
+Phase 3: CLI 실행
+  - TFX_CLI_MODE=codex 환경변수 포함
+  - tfx-route.sh 호출
+  - 서브태스크 2개 → tfx-multi Phase 3 전환
+Phase 4: 결과 수집
+  - exit_code 0: === OUTPUT === 섹션 파싱
+  - exit_code 124: === PARTIAL OUTPUT === 사용
+  - 그 외: STDERR → Claude fallback
+Phase 5: 실패 처리
+  - 1차: Claude executor(sonnet) fallback
+  - 2차: 실패 보고 + 성공 결과만 종합
+Phase 6: 보고 형식 출력
+  - 모드/그래프/레벨/서브태스크 상태 테이블
+  - Token Savings Report
+```
+
+**핵심 차이점 요약**: Phase 2와 Phase 3에서만 동작이 달라집니다.
+- Phase 2: gemini 분류 결과를 codex로 강제 변환 + MCP 프로필 재할당
+- Phase 3: 모든 tfx-route.sh 호출에 `TFX_CLI_MODE=codex` 접두 추가
+
+---
+
+## 7. 요약
+
+이 요청(`/tfx-codex API 문서를 작성하고 디자인 가이드도 만들어줘`)은 다음과 같이 처리됩니다:
+
+1. 두 서브태스크로 분해 (INDEPENDENT 그래프)
+2. 원래 Gemini로 라우팅될 `writer`와 `designer` 모두 Codex로 리매핑
+3. MCP 프로필: writer → `analyze`, designer → `implement` (원본 `docs`에서 변경)
+4. 서브태스크 2개이므로 tfx-multi Native Teams 모드로 자동 전환하여 병렬 실행
+5. 전체 Phase 1~6은 tfx-auto 워크플로우를 그대로 따름

package/skills/tfx-workspace/iteration-1/codex-gemini-remap/old_skill/timing.json

@@ -0,0 +1,5 @@
+{
+  "total_tokens": 19802,
+  "duration_ms": 85239,
+  "total_duration_seconds": 85.2
+}

package/skills/tfx-workspace/iteration-1/codex-gemini-remap/with_skill/grading.json

@@ -0,0 +1,9 @@
+{
+  "expectations": [
+    {"text": "designer remapped to Codex with effort: high", "passed": true, "evidence": "Agent output: designer → Codex (effort: high)"},
+    {"text": "writer remapped to Codex Spark with effort: spark_fast", "passed": true, "evidence": "Agent output: writer → Codex Spark (effort: spark_fast)"},
+    {"text": "Sets TFX_CLI_MODE=codex environment variable", "passed": true, "evidence": "Agent output: 'TFX_CLI_MODE: Set to codex for every Phase 3 call'"},
+    {"text": "Changes MCP profile: designer->implement, writer->analyze", "passed": true, "evidence": "Agent output: writer→analyze, designer→implement (changed from docs)"}
+  ],
+  "summary": {"passed": 4, "failed": 0, "total": 4, "pass_rate": 1.0}
+}