repo-map

Navigate this repo quickly to find the correct app, package, or service, and identify the right files for changes.

⭐4stars🔀0forks📁View on GitHub🕐Updated Jan 4, 2026

When & Why to Use This Skill

The repo-map skill is a high-performance codebase navigation utility designed to help developers and AI agents efficiently map out and explore complex repositories. By leveraging tools like ripgrep (rg), it enables users to quickly locate specific services, packages, and infrastructure files across multi-language environments, significantly accelerating the 'code discovery' phase of software development and maintenance.

Use Cases

  • Monorepo Navigation: Quickly orienting within large-scale repositories containing multiple frontends (Next.js), backends (Go/Kotlin), and shared libraries.
  • Impact Analysis: Identifying all relevant files and dependencies that need to be modified when implementing a new feature or fixing a bug.
  • Infrastructure-as-Code (IaC) Discovery: Locating specific Kubernetes manifests, ArgoCD applications, or Terraform/Tofu configurations related to a particular service.
  • Onboarding Efficiency: Helping new team members understand the project structure and find entry points for different services without manual documentation searches.
namerepo-map
descriptionNavigate this repo quickly to find the correct app, package, or service, and identify the right files for changes.

Repo Map

Overview

Use rg to search code and identify the correct area to edit. Check READMEs in relevant directories for commands.

Structure

  • apps/: Next.js/TanStack frontends
  • packages/: shared TS libs + Convex backend
  • services/: Go/Kotlin/Rails/Python services
  • argocd/, kubernetes/, tofu/, ansible/: infra + GitOps
  • scripts/, packages/scripts/: build/deploy helpers
  • skills/: agent skills

Find a service

rg -n "enrichRepository" services/bumba
rg --files -g "*bumba*"

Find infra

rg -n "open-webui" argocd/applications

Resources

  • Reference: references/repo-structure.md
  • Finder: scripts/find-in-repo.sh
  • Notes: assets/repo-notes.md