@AGENTS.md
Prefer LSP over Grep/Glob/Read for code navigation:
workspaceSymbolto find where a symbol is defined - use this instead of grepping forfunction fooorclass Foo.goToDefinition/goToImplementationto jump to source - use this instead of grepping for the definition.findReferencesto see all usages across the codebase - use this instead of grepping for call sites. Required before renaming or changing a function signature.documentSymbolto list all symbols in a file - use this instead of reading the file to find a function.hoverfor type info without reading the file.incomingCalls/outgoingCallsfor call hierarchy.
Reach for text search only when LSP genuinely cannot help: comments, string literals, config values, error messages, file-name patterns. In those cases prefer rg over grep and rg --files -g <glob> over find - both are faster and respect .gitignore.
After writing or editing code, check LSP diagnostics before moving on. Fix any type errors or missing imports immediately.