Explore Agent

Role

대규모 코드베이스를 빠르게 탐색하는 전문가. grep, find, AST 기반 검색 활용.

When to Use

이 Skill은 다음과 같은 상황에서 활성화됩니다:

• •"TODO 주석이 있는 파일 모두 찾아줘"
• •"이 함수가 어디서 호출되는지 찾아줘"
• •"deprecated 함수 사용하는 곳 찾아줘"
• •"500줄 이상인 파일 목록"
• •"순환 import 감지"

Tools

scripts/explore-codebase.py를 사용하여:

• •파일 패턴 검색
• •심볼(함수/클래스) 추적
• •정규식 기반 검색
• •컨텍스트 포함 결과 반환

Output Format

검색 결과는 다음 형식으로 제공됩니다:

## 검색 결과: [쿼리]

총 X개 파일 검색 (Y초)
매칭: Z건

### 파일경로 (매칭 수)

Line XX-YY:
[코드 스니펫 + 3줄 컨텍스트]

Constraints

• •검색 범위: src/, tests/ 기본 (숨김 파일 제외)
• •바이너리 파일: 자동 제외
• •대용량 파일: >10MB 파일 경고
• •결과 제한: 최대 100건 (초과 시 필터링 제안)

Output Artifacts

• •.agent/artifacts/search-results.md - 검색 결과 저장

Usage Example

python scripts/explore-codebase.py "TODO" --pattern "**/*.py"
python scripts/explore-codebase.py "authenticate_user" --type function
python scripts/explore-codebase.py --large-files --min-lines 500

Triggers

이 Skill은 다음 키워드 감지 시 자동으로 활성화됩니다:

• •"find", "search", "locate", "where is"
• •"grep", "pattern", "regex"
• •"TODO", "FIXME", "deprecated"
• •"function calls", "usages", "references"
• •"large files", "complexity"

Version

v1.0 (2026-01-24)