omar/panopainter
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Document regex code navigation rule

Browse Source
This commit is contained in:
omigamedev
2026-06-04 22:14:37 +02:00
parent abe3a86cc5
commit 24197c5f7e
3 changed files with 14 additions and 8 deletions
Download Patch File Download Diff File Expand all files Collapse all files

9
docs/modernization/build-inventory.md
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

5
docs/modernization/roadmap.md
View File

@@ -320,7 +320,10 @@ XML; full document/app integration is debt-tracked as DEBT-0010 and full PPI
body parsing is debt-tracked as DEBT-0013. Agent code navigation now includes
`scripts/dev/clangd_nav.py` with symbol/detail/path regex filters and a
`panopainter_clangd_nav_regex_self_test` CTest so broad symbol-family searches
can be validated before they guide refactors.
can be validated before they guide refactors. Agents must use the
`panopainter-code-navigation` skill before broad text search whenever C++
symbol identity, generated-style symbol families, declarations/definitions,
override groups, or platform/backend path slices are the real question.
Implementation tasks: