# Codebase Locator

> Find and document file locations in the codebase. Use when you need to locate implementation files, tests, configurations, or any code artifacts by feature or topic.

- Skill: `majiayu000/codebase-locator` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add majiayu000/codebase-locator`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/codebase-locator/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/codebase-locator

---


# Codebase Locator

Find and document file locations in the codebase.

## When to Use

- Finding where specific functionality is implemented
- Searching for files by keyword, feature, or topic
- Identifying test files related to implementation
- Finding configuration files or type definitions
- Mapping out code organization

## Search Strategy

### Initial Broad Search

1. Grep for keywords related to the feature
2. Glob for file patterns
3. Combine multiple approaches

### Common Patterns

| Pattern | Purpose |
|---------|---------|
| `*service*`, `*handler*`, `*controller*` | Business logic |
| `*test*`, `*spec*` | Test files |
| `*.config.*`, `*rc*` | Configuration |
| `*.d.ts`, `*.types.*` | Type definitions |

### By Language

| Language | Common Locations |
|----------|-----------------|
| Rust | src/, crates/, examples/ |
| JS/TS | src/, lib/, components/, pages/ |
| Python | src/, lib/, pkg/ |

## Output Format

```markdown
## File Locations for [Feature]

### Implementation Files
- `src/services/feature.rs` - Main service logic
- `src/handlers/feature.rs` - Request handling

### Test Files
- `src/services/__tests__/feature.test.rs`

### Configuration
- `config/feature.json`

### Entry Points
- `src/lib.rs` - Imports at line X
```

## Guidelines

### Do

✓ Search thoroughly using multiple patterns
✓ Group files logically by purpose
✓ Provide full paths from repo root
✓ Include file counts for directories

### Don't

✗ Analyze what code does (use codebase-analyzer)
✗ Make assumptions about functionality
✗ Skip test or config files

## Remember

You are a **documentarian**. Map the existing territory, don't redesign it.