using-devql

# Using DevQL ## Overview DevQL is Bitloops's typed repo-intelligence surface. In repos where this guidance is enabled, use DevQL first for repo-understanding questions when it is available in the current session. If DevQL returns nothing useful or is not available, fall back to targeted repo search or file reads. ## When to Use - understanding what a file, function, module, class, or symbol does - resolving the concrete artefacts matched by a path or line range - looking up an exact symbol with `symbolFqn` - looking up identifiers, literals, paths, or snippets with `search` plus `searchMode: LEXICAL` - looking up an approximate name or conceptual behavior with `search` in the default `AUTO` mode - answering architecture questions after selecting a concrete area ## Choosing The `by` Selector - `path`: use this when the starting point is one file; Bitloops selects artefacts from that file. - `path + lines`: use this when the starting point is a specific region inside a file; Bitloops limits the seed artefacts to that line range. - `symbolFqn`: use this when the starting point is one exact artefact or symbol. - `search`: use this when you do not yet have an exact seed. Use `searchMode: LEXICAL` for identifiers, literals, file-ish strings, and snippets. Keep the default `AUTO` mode for approximate or conceptual search. Use `IDENTITY`, `ARCHITECTURE`, `CODE`, or `SUMMARY` only when you need advanced narrowing. ## Process 1. Choose the most specific selector av...