tfx-plan — Light Implementation Plan

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

Deep 버전: tfx-deep-plan. "제대로/꼼꼼히" 수정자로 자동 에스컬레이션. Gemini 위임 빠른 계획 — Claude는 컨텍스트 수집·출력 포맷만, 핵심 계획 수립은 Gemini에 위임.

워크플로우

Step 1: 요구사항 파싱

사용자 입력 + 프로젝트 컨텍스트(PROJECT_INDEX.md 있으면 활용)에서 핵심 추출.

Step 2: Gemini 위임 계획 수립

Claude는 최소 컨텍스트만 수집한다.

• Glob으로 영향 가능 파일 목록 수집
• PROJECT_INDEX.md 존재 시 읽기 (없으면 생략)

수집 후 Gemini에 위임:

Bash("bash scripts/tfx-route.sh gemini exec '소프트웨어 아키텍트로서 다음 기능의 구현 계획을 수립하라.\n기능: {feature}\n프로젝트 컨텍스트: {context}\n관련 파일: {file_list}\n\n출력 형식:\n1. 영향 범위 (수정할 파일 목록)\n2. 태스크 분해 (순서대로, 각 태스크에 검증 방법 포함)\n3. 리스크 및 의존성\n4. 예상 복잡도 (low/medium/high)'")

Claude는 Gemini 출력을 받아 아래 출력 형식으로 포맷팅만 수행한다.

Fallback: Gemini 호출이 실패(exit non-zero 또는 빈 출력)하면 Claude Opus가 동일 프롬프트로 직접 계획을 수립한다.

Step 3: 구조화된 계획 출력

## 구현 계획: {feature}

### 영향 범위
- `src/auth/middleware.ts` — 신규 생성
- `src/routes/index.ts` — 수정 (라우트 추가)

### 태스크
1. [ ] {태스크1} → 검증: {확인 방법}
2. [ ] {태스크2} → 검증: {확인 방법}
3. [ ] {태스크3} → 검증: {확인 방법}

### 리스크
- {리스크1}: 완화 방안 — {방안}

### 복잡도: {level}

토큰 절감

Gemini가 계획 생성의 대부분을 담당하므로 Claude 토큰 비용이 대폭 감소한다.