| 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/Antigravity만으로 실행한다.
핵심 원칙
- Codex 라우팅 유지
- 구현/분석/리뷰/디버깅/검증은 Codex 우선.
- Gemini 유지
designer, writer는 Gemini 경로를 그대로 사용.
- Claude 네이티브 제거
- 실행 시
TFX_NO_CLAUDE_NATIVE=1로 강제.
- 고난도 설계는 xhigh
- 설계/분해/비판 검토 성격의 작업은
codex --profile xhigh 기준으로 운용.
사용법
/tfx-auto-codex "인증 리팩터링 + UI 개선 + 테스트 보강"
/tfx-auto-codex 3:codex "src/api, src/auth, src/payment 병렬 리뷰"
/tfx-auto-codex 2:gemini "온보딩 UI 카피 + 접근성 개선"
실행 규칙
tfx-auto 워크플로우(입력 파싱 → 트리아지 → 분해 → DAG 실행 → 수집/보고)를 그대로 사용한다.
단, 실행 명령은 아래 환경변수를 반드시 포함한다:
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 설치
- Antigravity CLI 설치 (UI/문서 경로 사용 시)
Troubleshooting
문제 발생 시 /tfx-doctor 실행. (--fix 자동 수정, --reset 캐시 초기화)