# Codebase Retrieval > Use semantic code search to understand architecture before editing or refactoring. Use when this capability is needed. - Skill: `tomevault-io/codebase-retrieval` (Agent Skill, multi-file: 2 files) - Install (CLI): `npx skillmds@latest add tomevault-io/codebase-retrieval` - Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/codebase-retrieval/raw - Safety review: pending - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Coding & Dev Tools - Author: tomevault-io (https://skillmd.com/u/tomevault-io) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/tomevault-io/codebase-retrieval --- # Codebase Retrieval ## When to use this skill Use this skill when you need to: - Understand where a behavior lives before making a change - Find the real entry points, call graph, and invariants for a feature - Locate the authoritative implementation when file locations are unclear ## Default tool order 1. Use `codebase-retrieval` for semantic codebase search and symbol mapping 2. Use exact search (`grep_search`) only after you know the likely files/symbols 3. Read the relevant files end-to-end before editing core abstractions ## Critical invariants - Prefer semantic retrieval before editing - Identify all call sites/consumers before changing an interface - Avoid partial refactors; pull all code forward to the new pattern ## Optional integration note This skill does not require the this kit product (not public); it uses the Augment context engine only. --- > Converted and distributed by [TomeVault](https://tomevault.io/claim/galeavenworth-personal) — claim your Tome and manage your conversions.