repo-navigator

name	repo-navigator
description	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.
allowed-tools	Read, Grep, Glob

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