tfx-review

tfx-review — Code Review (Deep by Default)

ARGUMENTS 처리: 이 스킬이 ARGUMENTS: <값>과 함께 호출되면, 해당 값을 사용자 입력으로 취급하여 워크플로우의 첫 단계 입력으로 사용한다. --quick 플래그 감지 시 quick 경로로 분기.

---

기본값: Deep (3-CLI Consensus)

AI makes completeness near-free. 기본은 풀프라이스 딥. 빠른 피드백은 --quick opt-out.

Anti-Herding: Round 1에서 3개 CLI가 서로의 결과를 보지 않고 독립 리뷰. Consensus Only: 2개 이상 CLI가 동일 이슈를 지적한 항목만 최종 보고 → false-positive 87% 감소.

---

모드 분기 (첫 단계)

ARGUMENTS 에 --quick 포함 → Quick 모드 (아래 Quick 섹션). 그 외 → Deep 모드 (기본).

---

Deep 모드 (기본)

전제조건 프로브

진입 즉시 실행 — 10초 내 가시적 출력 보장. 빈 stdout + exit 0 금지.

(tmux -V 2>/dev/null || psmux -V 2>/dev/null) && \
  curl -sf http://127.0.0.1:27888/status >/dev/null && \
  codex --version 2>/dev/null && \
  agy --version 2>/dev/null

Tier 판정

Tier	조건	실행 방식
Tier 1	Hub + Codex + Antigravity 전부 정상	auto multi 3-CLI (tmux/psmux 리드면 interactive)
Tier 2	Codex 또는 Antigravity 중 하나만 가용	가용 CLI + Claude Agent 조합
Tier 3	Hub 또는 필요 CLI 불가, 또는 claude -p one-shot	Claude Agent only (consensus 미적용)

IF claude -p (one-shot):
  → Tier 3

IF Hub 미응답:
  → hub-ensure 자동 재시작 시도: Bash("node ~/.claude/scripts/hub-ensure.mjs")
  → 성공 → Tier 판정 재시도
  → 실패 → Tier 3

IF Codex 없음 AND Antigravity 없음:
  → Tier 3

IF Codex 없음 OR Antigravity 없음:
  → Tier 2

ELSE:
  → Tier 1

Tier 3 진입 시 필수 출력

⚠ [Tier 3] multi 실행 환경 미충족 — single-model 모드로 실행합니다 (consensus 미적용)
  누락: {missing_components}
  권장: Hub, Codex CLI, Antigravity CLI 설치 후 재실행
  또는 /tfx-review --quick 으로 명시적 quick 경로 사용

HARD RULES (Tier 1/2)

headless-guard가 이 규칙 위반을 자동 차단한다.

1. codex exec 직접 호출 및 deprecated Gemini CLI 직접 호출 절대 금지
2. Codex·Antigravity → Bash("tfx multi --auto-attach --dashboard --assign 'cli:프롬프트:역할' --timeout 1800", run_in_background=true) 만 사용 — teammate mode는 생략해 auto 기본값을 쓰며, foreground Bash는 하니스가 600s에 강제 종료. 결과는 task-notification 후 회수
3. Claude → Agent(run_in_background=true)
4. Bash + Agent를 같은 메시지에서 동시 호출하여 병렬 실행