tfx-auto

tfx-auto — 통합 CLI 오케스트레이터

ARGUMENTS 처리: 이 스킬이 ARGUMENTS: <값>과 함께 호출되면, 해당 값을 사용자 입력으로 취급하여 워크플로우의 첫 단계 입력으로 사용한다. ARGUMENTS가 비어있거나 없으면 기존 절차대로 사용자에게 입력을 요청한다.

Step 0: 스마트 라우팅 (tfx-auto 진입 시 자동 실행)

preamble에서 routing-weights.json을 읽고, 사용자 입력을 분석하여 dispatch 결정.

SLUG=$(basename "$(git rev-parse --show-toplevel 2>/dev/null)" 2>/dev/null || echo "unknown")
WEIGHTS_FILE="$HOME/.gstack/projects/$SLUG/routing-weights.json"
USER_MODE=""
if [ -f "$WEIGHTS_FILE" ]; then
  USER_MODE=$(node -e "
    const w=JSON.parse(require('fs').readFileSync('$WEIGHTS_FILE','utf8'));
    const m=w.weights?.mode_bias||{};
    const top=Object.entries(m).sort((a,b)=>b[1]-a[1])[0];
    if(top && top[1]>0.3) console.log(top[0]);
  " 2>/dev/null)
fi
echo "USER_PREFERRED_MODE: ${USER_MODE:-none}"

판단 기준 (우선순위 순):

1. 명시 플래그 (최우선, 추론 스킵): ARGUMENTS 에 --cli/--mode/--risk-tier/--shape/--cli-set/--parallel/--retry/--isolation/--remote 플래그가 있으면 분류/추론을 건너뛰고 플래그 값대로 즉시 dispatch. 자세한 플래그 동작은 아래 "플래그 오버라이드" 섹션 참조.

   • --parallel swarm → tfx-swarm 엔진 위임 (PRD 필요)
   • --parallel N → tfx-multi 엔진 위임 (auto: 리드 tmux면 interactive pane, 없으면 in-process)
   • --cli codex|antigravity → TFX_CLI_MODE 설정 + 단일 실행
   • --mode deep → -t/--thorough 동일 동작 (pipeline init)
   • --risk-tier low|medium|high → risk-tier 기준으로 verification 강도와 mode 결정
   • --mode ... 명시 시 --risk-tier 는 무시 (mode 우선)
   • --mode consensus --shape debate|panel → prompt ensemble fold 경로
   • --mode live → tfx-live 엔진 위임 (분해/트리아지 스킵)
   • --retry ralph → stderr 경고 후 bounded 3회 degrade (Phase 2 미구현)

2. 사용자 명시 키워드 (플래그 없을 때):

   • "swarm", "PRD 돌려", "격리해서", "충돌 없이 돌려" → --parallel swarm --mode consensus --isolation worktree
   • "병렬", "동시에", "multi", "협업"(단순 동시 작업 의미) → --parallel N --mode deep — 여기서 미리 swarm으로 단정하지 않는다. 실제 코드 변경이 여러 파일에 걸치면 "멀티 태스크 라우팅"의 자동 분류가 swarm으로 승격시킨다 ("병렬" 한 단어만으로 곧장 worktree 격리+3-CLI 합의까지 가는 건 과함)
   • "팀"은 모호하다: 서로 메시지를 주고받는 영속 협업을 원하면 정답은 OMC 네이티브 /team이고(tfx-auto 관할 밖), 그냥 여러 작업을 동시에 처리해달라는 뜻이면 바로 위 --parallel N 행을 따른다. "팀"만 보고 바로 --parallel N으로 단정하지 말고 어느 쪽인지 애매하면 되묻는다
   • "꼼꼼히", "제대로", "deep" → --mode deep
   • "끝까지", "멈추지마", "ralph" → --retry ralph
   • "codex로", "antigravity로" → --cli codex 또는 --cli antigravity
   • "원격으로", "다른 기기에서", "리모트로 돌려" → --remote <host> (--parallel swarm 자동 동반. host 미지정 시 hosts.json 목록에서 질의)
   • "논쟁시켜", "서로 반박하게 해", "계속 대화하면서 풀게", "왕복으로 주고받게" → --mode live (tfx-live peer 고정). "협업"/"팀"과 겹쳐 보여도 이 쪽은 "논쟁/반박/대화를 계속 이어간다"는 뉘앙스가 명시적으로 있을 때만 해당