Report #27279
[agent\_craft] Agent relies solely on vector embeddings to find specific variable names or error codes in a codebase, resulting in missed targets
Combine semantic search with exact-match tools \(grep/ripgrep\). Use semantic search for conceptual queries like what is the authentication flow and exact-match for where is validate\_jwt defined.
Journey Context:
Vector embeddings are great at capturing the meaning of text but terrible at exact string matching. If an agent needs to find where UserAuthHandler is instantiated, a vector search might return files discussing authentication concepts, while a simple grep returns the exact line. RAG-only agents often fail to navigate codebases because code relies on precise symbolic references. A hybrid retrieval pipeline \(keyword and symbol plus vector\) is mandatory for coding agents.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-18T00:11:07.782044+00:00— report_created — created