tfx-indexlisted

# tfx-index — Project Indexing (94% Token Reduction) > **ARGUMENTS 처리**: 이 스킬이 `ARGUMENTS: <값>`과 함께 호출되면, 해당 값을 사용자 입력으로 취급하여 > 워크플로우의 첫 단계 입력으로 사용한다. ARGUMENTS가 비어있거나 없으면 기존 절차대로 사용자에게 입력을 요청한다. > **Telemetry** > > - Skill: `tfx-index` > - Description: `프로젝트 구조를 빠르게 파악하거나 토큰을 절약할 때 사용한다. '인덱싱', '프로젝트 구조', '인덱스 만들어', '코드베이스 맵', '프로젝트 개요' 같은 요청에 사용. 새 프로젝트 온보딩, 세션 시작 시 컨텍스트 효율화에 적극 활용.` > - Session: 요청별 식별자를 유지해 단계별 실행 로그를 추적한다. > - Errors: 실패 시 원인/복구/재시도 여부를 구조화해 기록한다. > SuperClaude index-repo 오마주. 1회 2K 토큰으로 인덱스 생성, 이후 세션마다 55K 토큰 절감. > **Antigravity 위임**: 스캔 + 인덱스 생성 작업은 Antigravity CLI에 위임한다. Claude는 모드 선택(Step 0)과 파일 쓰기만 담당. Claude 토큰 소비 ~500 tokens으로 줄어든다. ## 원리 매 세션마다 프로젝트 구조를 파악하려면 수십 개 파일을 읽어야 한다 (~58K tokens). 인덱스를 한 번 생성하면 3K 토큰짜리 PROJECT_INDEX.md만 읽으면 된다. **ROI**: 1회 투자 2K → 세션당 55K 절감 → 10세션이면 550K 절감 ## 워크플로우 ### Step 0: 인덱싱 모드 선택 인자 없이 호출되거나 모드가 불명확한 경우, AskUserQuestion으로 모드를 선택받는다: ``` AskUserQuestion: "인덱싱 모드를 선택하세요:" 1. 전체 인덱스 생성 (처음 또는 재생성) 2. 증분 업데이트 (변경분만) 3. 특정 디렉토리만 ``` - 1번 선택 → Step 1부터 전체 실행 - 2번 선택 → `--update` 모드로 전환 (기존 인덱스 필요, 없으면 1번으로 fallback) - 3번 선택 → 추가 AskUserQuestion으로 대상 디렉토리 경로 입력받음 `--update` 플래그나 경로 인자가 이미 제공된 경우 이 단계를 건너뛴다. ### Step 1: Antigravity에 스캔 + 인덱스 생성 위임 Claude는 프로젝트 경로와 모드를 Antigravity에 전달하고, Antigravity가 파일 트리 스캔·메타데이터 추출·인덱스 생성을 모두 수행한다. ``` Bash("TFX_CLI_MODE=antigravity bash ~/.claude/scripts/tfx-route.sh antigravity 'Scan the project at {path}. For each source file, extract: exports, imports, li