tfx-plan

tfx-plan — Implementation Plan (Deep by Default)

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

AI makes completeness near-free. 기본은 Opus 4.6(Planner) + Codex(Architect) + Claude Opus(Critic) 합의. Antigravity는 agy --print stdin 경로가 단순 프롬프트에서만 검증됐으므로, schema-driven critic에는 쓰지 않고 --quick freeform 보조로만 사용한다.

---

모드 분기

--quick → Quick 모드 (Antigravity freeform 위임). 그 외 → Deep 모드 (기본, Opus+Codex+Claude critic 합의 + 교차 검토).

---

Deep 모드 (기본)

전제조건 프로브 및 Tier Degradation

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

Tier	조건	실행
Tier 1	Hub + 필요 CLI 전부 정상	auto multi 3-Model (tmux/psmux 리드면 interactive)
Tier 2	일부 CLI	가용 + Claude Agent
Tier 3	Hub 또는 필요 CLI 불가	Claude Agent only

Tier 3:

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

HARD RULES

1. codex exec 직접 호출 및 deprecated Gemini CLI 직접 호출 금지
2. Codex/Antigravity → Bash("tfx multi --assign ...") 만. teammate mode는 생략해 auto 기본값을 쓴다.
3. Claude → Agent(run_in_background=true)
4. Bash + Agent 동시 호출
5. deprecated Gemini CLI 또는 legacy Gemini assign 금지. Antigravity는 antigravity:/agy 이름만 사용한다.
6. agy --print는 stdin prompt만 사용한다. positional prompt 및 strict JSON critic 검증에 실패하면 Claude critic으로 대체한다.

모델 역할

Model	역할	강점
Claude Opus (Planner)	전략 비전	리스크 통합, 아키텍처 결정
Codex (Architect)	기술 설계	API, 파일 구조, 구현 세부
Claude Opus (Critic)	리스크 분석	엣지케이스, 보안, 테스트 전략
Antigravity (Quick/Advisory)	freeform 보조	빠른 초안, UX/DX 관점, 비-schema 검토

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 }"
)