# 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.

- Skill: `majiayu000/repo-navigator` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add majiayu000/repo-navigator`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/repo-navigator/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/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