codebase-navigationlisted

# Codebase Navigation ## What This Skill Enables An agent that can quickly orient itself in any codebase - finding the right files, understanding the architecture, and identifying conventions - before writing a single line of code. Agents without this skill guess at file locations, miss existing utilities, and create duplicates. ## Core Competencies ### 1. Project Reconnaissance Before touching code, build a mental map: - Read `README.md`, `CONTRIBUTING.md`, and any project-level config files - Identify the package manager and build system (`package.json`, `pyproject.toml`, `Cargo.toml`, `go.mod`) - Map the directory structure - where does source live? Tests? Config? Docs? - Identify the entry point(s) of the application ### 2. Convention Detection Infer the project's conventions from existing code: - **Naming**: camelCase vs snake_case vs kebab-case - match what exists - **File organization**: feature-based vs layer-based vs hybrid - **Import style**: relative vs absolute, barrel files, path aliases - **Testing conventions**: co-located tests vs separate `__tests__` directory, naming patterns - **Error handling**: custom error classes, result types, try/catch patterns ### 3. Dependency Mapping Trace how components connect: - Follow imports from the entry point to understand the call graph - Identify shared utilities and where they live - Locate configuration and environment variable usage - Map database models/schemas to their consumers - Identify external API integrati