vaultspec-rag-discoverylisted

# Semantic discovery with vaultspec-rag vaultspec-rag finds things by MEANING. When you need to locate where or how something is done and do not already know the exact symbol, lead with a semantic search rather than a keyword sweep: keyword search only finds the words you already guessed, while semantic search finds the concept even when the code names it differently. The project's own discovery benchmarking is the basis for leading with it - a semantic-led hybrid sweep reaches the right file in about one call at roughly 1.3-2x less context than a broad grep or glob on a large tree, and recalls the governing decision with almost no noise. Treat vaultspec-rag as a discovery instrument and grep as the exact-symbol confirmer: a search lands you on the right surface, grep pins the precise line. Never conclude "there is no such site" from a search alone - confirm with grep. ## The method: locate by meaning, read, confirm 1. **Locate by meaning.** Run a semantic search to reach the epicenter file (code) or the governing record (a decision). One tight query gets you there. 1. **Read the epicenter whole.** Open the top file (or the nearest existing analogue) in full. This whole-file read is the step that actually grounds you. 1. **Confirm with grep.** Pin the exact symbol, call site, or insertion point with a targeted grep, which is sharper than semantic search at exact-name lookup. ## Two corpora: code and decisions vaultspec-rag searches two things. Choose with `--ty