Code Navigation Rules

Native tools: cymbal_* (pi-cymbal) and ast_grep_* (joelhooks/pi-ast-grep) are first-class pi tools — call them directly, not via bash. fffind/ffgrep come from @ff-labs/pi-fff.

Tool Priority

For every file-task, ask: "Can Cymbal do this?"

1. cymbal_search beats fffind (symbol-aware, git-aware, ranked)
2. fffind beats raw find/ls (fuzzy, frecency, git-aware)
3. cymbal_show beats read (structured output, symbol-aware, refs-aware)
4. cymbal_search --text beats ffgrep (git-aware, indexed)
5. read = exact file path only (never directory). grep/rg only for reading a single file's content, not for cross-file search.