tfx-plan

tfx-plan — Implementation Plan (Deep by Default)

ARGUMENTS 처리: --quick → Quick 모드. 그 외 → Deep 모드 (기본).

AI makes completeness near-free. 기본은 Opus 4.6(Planner) + Codex(Architect) + Gemini(Critic) Tri-Model 합의. 빠른 Gemini 위임 계획은 --quick.

---

모드 분기

--quick → Quick 모드 (Gemini 위임). 그 외 → Deep 모드 (기본, 3-Model 합의 + 교차 검토).

---

Deep 모드 (기본)

전제조건 프로브 및 Tier Degradation

psmux --version 2>/dev/null && \
  curl -sf http://127.0.0.1:27888/status >/dev/null && \
  codex --version 2>/dev/null && \
  gemini --version 2>/dev/null

Tier	조건	실행
Tier 1	전부 정상	headless multi 3-Model
Tier 2	일부 CLI	가용 + Claude Agent
Tier 3	headless 불가	Claude Agent only

Tier 3:

⚠ [Tier 3] 환경 미충족 (consensus 미적용)
  누락: {missing} | 또는 /tfx-plan --quick

HARD RULES

1. codex exec / gemini -p 직접 호출 금지
2. Codex/Gemini → Bash("tfx multi --teammate-mode headless --assign ...") 만
3. Claude → Agent(run_in_background=true)
4. Bash + Agent 동시 호출

모델 역할

Model	역할	강점
Claude Opus (Planner)	전략 비전	리스크 통합, 아키텍처 결정
Codex (Architect)	기술 설계	API, 파일 구조, 구현 세부
Gemini (Critic)	리스크 분석	엣지케이스, 보안, 테스트 전략

EXECUTION — TASK 는 사용자 입력

Step 1: 코드베이스 정찰

Agent(
  subagent_type="Explore",
  model="haiku",
  prompt="다음 기능 관련 코드베이스 탐색: [TASK]
  보고: (1) 관련 파일/디렉토리 (2) 기존 아키텍처 패턴 (3) 주요 의존성/인터페이스. bullet."
)

결과를 RECON으로 보유.

Step 2: Round 1 독립 설계 (Anti-Herding) — Bash + Agent 동시 호출

Agent (Claude Planner):

Agent(
  subagent_type="oh-my-claudecode:architect",
  model="opus",
  run_in_background=true,
  name="planner-r1",
  prompt="소프트웨어 아키텍트로서 구현 계획 수립. 기능: [TASK]. 코드베이스: [RECON]. JSON: { vision, tasks: [{id, title, desc, deps, complexity}], order, risks, files, confidence, reasoning }"
)

Bash (Codex Architect + Gemini Critic):

Bash("tfx multi --teammate-mode headless --auto-attach --dashboard \
  --assign 'codex:시니어 엔지니어 기술 설계. 기능: [TASK]. 코드베이스: [RECON]. JSON: { architecture, components, data_models, api, files, impl_notes, confidence }:architect' \
  --assign 'gemini:QA 보안 전문가 리스크 분석. JSON: { edge_cases, security, performance, test_strategy: {unit, integration, edge_case}, missing_reqs, risk_level, confidence }:critic' \
  --timeout 600")

Step 3: 결과 수집

• RESULT_PLANNER / RESULT_ARCHITECT / RESULT_CRITIC
• 실패 워커 → Claude Agent 로 대체

Step 4: Round 2 교차 검토 — Bash + Agent 동시 호출

각 모델에게 다른 두 모델 Round 1 결과 제시. ACCEPT/MODIFY/REJECT.

Agent:

Agent(
  subagent_type="oh-my-claudecode:critic",
  model="opus",
  run_in_background=true,
  name="planner-r2",
  prompt="Round 1 교차 검토. 네 계획: [RESULT_PLANNER]. Architect: [RESULT_ARCHITECT]. Critic: [RESULT_CRITIC]. JSON: { revisions: [...], updated_plan: {...} }"
)

Bash: (위와 동일 패턴, Codex/Gemini 각각 교차검토)

Step 5: 합의 점수 산출 (Claude 직접)

각 고유 항목:
  동의 수 >= 2 → CONSENSUS
  == 1 → DISPUTED

consensus_score = CONSENSUS / 전체 * 100

>= 80% → Step 6
60-79% → Round 3 (미합의만 재토론)
< 60%  → AskUserQuestion

Step 6: 합의 계획 출력

## 합의된 구현 계획: [TASK]
**Consensus**: {score}% | **Rounds**: {n} | **Models**: Opus+Codex+Gemini

### 설계 방향
### 태스크 (T1..., 복잡도, 합의 P:A:C)
### 파일 변경
### 리스크 & 완화 (심각도, 합의도)
### 테스트 전략 (Critic 주도)
### 미합의 사항

Token (Deep): ~25-32K

---

Quick 모드 (--quick)

Step 1: 요구사항 파싱

사용자 입력 + PROJECT_INDEX.md (있으면) + Glob 파일 목록.

Step 2: Gemini 위임

Bash("bash ~/.claude/scripts/tfx-route.sh gemini exec '소프트웨어 아키텍트로서 구현 계획. 기능: {feature}. 컨텍스트: {context}. 파일: {file_list}. 출력: 1) 영향 범위 2) 태스크 분해 (검증 방법 포함) 3) 리스크/의존성 4) 복잡도'")

Fallback: Gemini 실패 시 Claude Opus 직접.

Step 3: 구조화 출력

## 구현 계획: {feature}

### 영향 범위
### 태스크 (체크박스 + 검증)
### 리스크
### 복잡도: {level}

Token (Quick): ~1.5K (Claude), ~2K (Gemini)

사용 예

/tfx-plan "JWT 인증 미들웨어 추가"          # Deep (기본)
/tfx-plan "마이크로서비스 분리"             # Deep
/tfx-plan --quick "README 섹션 추가"        # Quick (Gemini)