tfx-findlisted

# tfx-find — Fast Codebase Explorer > **ARGUMENTS 처리**: 이 스킬이 `ARGUMENTS: <값>`과 함께 호출되면, 해당 값을 사용자 입력으로 취급하여 > 워크플로우의 첫 단계 입력으로 사용한다. ARGUMENTS가 비어있거나 없으면 기존 절차대로 사용자에게 입력을 요청한다. > **Telemetry** > > - Skill: `tfx-find` > - Description: `코드베이스에서 파일, 함수, 클래스, 문자열을 빠르게 찾을 때 사용한다. '코드 검색', 'find in code', '어디에 있어?', '이 함수 어디서 쓰여?', '파일 찾아줘', '코드베이스 탐색' 같은 요청에 반드시 사용. 파일 위치, 심볼 사용처, 패턴 검색이 필요한 모든 상황에 적극 활용.` > - Session: 요청별 식별자를 유지해 단계별 실행 로그를 추적한다. > - Errors: 실패 시 원인/복구/재시도 여부를 구조화해 기록한다. > OMC explore agent 오마주. Haiku의 속도 + Glob/Grep/Read의 정밀도. > "찾는 건 빠르게, 읽는 건 정확하게." ## 용도 - 파일 위치를 모를 때 빠르게 찾기 - 특정 함수/클래스/변수가 어디서 사용되는지 추적 - 문자열 패턴으로 코드 검색 - 프로젝트 구조 빠르게 파악 - 설정 파일, 진입점, 테스트 파일 탐색 ## 워크플로우 ### Step 1: 검색 의도 파싱 사용자 입력에서 검색 유형을 판별한다: ``` 검색 유형: file_pattern — "*.test.ts 파일 찾아" → Glob symbol — "createBridge 함수 어디?" → Grep (정규식) string — "TODO 주석 찾아" → Grep (리터럴) structure — "프로젝트 구조 보여줘" → Glob + tree usage — "Router 클래스 사용처" → Grep (import/require + 참조) definition — "handleAuth 정의 찾아" → Grep (function/class/const 패턴) ``` ### Step 2: 검색 실행 검색 유형에 따라 최적 도구 조합을 선택한다: ``` file_pattern: Glob("**/{pattern}") → 매칭 파일 목록 symbol: Grep(pattern="{symbol}", type="{lang}") → 파일 목록 → 상위 5개 파일 Read (정의부 중심, 각 ±10줄) string: Grep(pattern="{string}", output_mode="content", context=2) → 매칭 라인 + 컨텍스트 structure: Glob("**/*.{ts,js,mjs,py,go}") → 파일 트리 구성 → 디렉토리별 파일 수 + 역할 요약 usage: Grep(pattern="import.*{symbol}|require.*{symbo