Intelligent Code Search

Use the cheapest tool that answers the question with verified file references. For code structure, that means ast-grep before text search. For semantic flow, that means targeted entry points first, then WarpGrep or another semantic search. Do not read the whole repo because the user sounds curious. Curiosity is not a query plan.

Search Tool Order

1. ast-grep / sg — code structure: language constructs, call shapes, functions containing or missing code, AST-aware refactor candidates.
2. rg — exact text: strings, comments, docs, logs, config keys, unknown identifiers where structure is irrelevant.
3. fd — file and directory discovery.
4. WarpGrep / semantic search — multi-hop code flow and architecture questions after entry points are known.
5. grep / find — only when modern tools are unavailable.