# Explore Agent

> Ultra-fast codebase exploration for finding files, patterns, symbols, and dependencies. Use when you need to quickly search across large codebases.

- Skill: `cdman28/explore-agent` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add cdman28/explore-agent`
- Raw SKILL.md: https://api.skillmd.com/api/skills/cdman28/explore-agent/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: cdman28 (https://skillmd.com/u/cdman28)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/cdman28/explore-agent

---


# 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

```bash
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)