# Repo Navigator

> Navigate and map this monorepo structure. Find files, packages, and dependencies. Use when asked to locate code, understand package relationships, find where something is defined, or explore repo structure. Use when this capability is needed.

- Skill: `tomevault-io/repo-navigator` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/repo-navigator`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/repo-navigator/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/repo-navigator

---


# Repo Navigator

Maps this Turborepo monorepo and locates code quickly.

## When to Use

- "Where is X defined?"
- "Find files related to..."
- "What packages exist?"
- "Show me the structure"
- "How do packages depend on each other?"

## Quick Reference

### Package Locations

| Package    | Path                   | Purpose                          |
| ---------- | ---------------------- | -------------------------------- |
| Web App    | `apps/web/`            | Next.js 16 frontend + API routes |
| Mobile App | `apps/mobile/`         | React Native bare                |
| Database   | `packages/db/`         | Drizzle ORM, schema, migrations  |
| Auth       | `packages/auth/`       | Better Auth config               |
| AI         | `packages/ai/`         | Vercel AI SDK integration        |
| API Client | `packages/api-client/` | Shared fetch client              |
| Security   | `packages/security/`   | Rate limiting                    |
| Types      | `packages/types/`      | Shared TypeScript types          |
| Tests      | `packages/tests/`      | Integration tests                |
| Tools      | `packages/tools/`      | AI tool definitions              |
| RAG        | `packages/rag/`        | Embeddings support               |
| Evals      | `packages/evals/`      | LLM evaluation framework         |
| Obs        | `packages/obs/`        | Observability utilities          |

### Key File Locations

| Looking for...    | Check...                             |
| ----------------- | ------------------------------------ |
| API endpoints     | `apps/web/app/api/`                  |
| Database schema   | `packages/db/src/schema.ts`          |
| Auth config       | `packages/auth/src/index.ts`         |
| Rate limiting     | `packages/security/src/rateLimit.ts` |
| Shared types      | `packages/types/src/index.ts`        |
| Integration tests | `packages/tests/src/`                |
| Mobile screens    | `apps/mobile/src/screens/`           |
| CI workflows      | `.github/workflows/`                 |

## Procedure

### 1. Understand the Request

Identify what the user is looking for:

- Specific file/function → use Grep with pattern
- Package overview → use Glob for structure
- Dependency → check package.json imports

### 2. Search Strategy

**For specific code:**

```
Grep pattern: "export (function|const|class) {name}"
Glob pattern: "**/*.ts" or "**/*.tsx"
```

**For package structure:**

```
Glob: "{apps,packages}/*/package.json"
```

**For imports/usage:**

```
Grep: "from '@acme/{package}'"
Grep: "import.*{name}"
```

### 3. Report Findings

Output format:

```
## Found: {description}

**Location:** `{path}:{line}`

**Context:**
- Package: {package-name}
- Exports: {what it exports}
- Used by: {importers}
```

## Common Searches

### Find API endpoint

```
Glob: apps/web/app/api/**/*.ts
Grep: "export (async function|const) (GET|POST|PUT|DELETE)"
```

### Find database table

```
Read: packages/db/src/schema.ts
Grep: "export const {tableName}"
```

### Find component

```
Glob: apps/web/components/**/*.tsx
Glob: apps/mobile/src/components/**/*.tsx
```

### Find where package is used

```
Grep: "@acme/{package-name}"
```

## Guardrails

- DO NOT modify any files
- DO NOT execute commands
- Report file paths with line numbers when found
- If not found, suggest alternative search terms

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/jamesjlundin) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-11 -->