repo-map
Navigate this repo quickly to find the correct app, package, or service, and identify the right files for changes.
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.
| name | repo-map |
|---|---|
| description | Navigate 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 frontendspackages/: shared TS libs + Convex backendservices/: Go/Kotlin/Rails/Python servicesargocd/,kubernetes/,tofu/,ansible/: infra + GitOpsscripts/,packages/scripts/: build/deploy helpersskills/: 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