Document regex code navigation rule

This commit is contained in:
2026-06-04 22:14:37 +02:00
parent abe3a86cc5
commit 24197c5f7e
3 changed files with 14 additions and 8 deletions

View File

@@ -109,10 +109,11 @@ 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.
Agents must use the repo skill `panopainter-code-navigation` before broad
text searches when a C++ refactor needs symbol identity, symbol-family lookup,
generated-style names, signatures, override groups, declarations/definitions,
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