Document regex code navigation workflow

This commit is contained in:
2026-06-04 21:16:36 +02:00
parent 6440bde002
commit 45802dfc7c
2 changed files with 10 additions and 3 deletions

View File

@@ -109,6 +109,10 @@ Known local toolchain state:
`python scripts/dev/clangd_nav.py self-test`, also registered as
`panopainter_clangd_nav_regex_self_test`, so regex filter behavior can be
validated without clangd or a compile database.
Use the repo skill `panopainter-code-navigation` before broad text searches
when a C++ refactor needs symbol-family lookup, generated-style names,
signatures, override groups, or platform/backend path slices. Keep `rg` for
docs, build files, string literals, comments, and exact non-symbol text.
Reference lookup is guarded because a one-shot clangd process may not have a
complete project index: pass `--background-index` for broader best-effort
results or `--allow-incomplete-references` for explicitly