shield_lock
JinDaGe
← Back to skills
extension
Category: Development & EngineeringNo API key required

repo-navigator

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

personAuthor: jakexiaohubgithub
open_in_newRepositorydownloadDownload package

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