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

Document regex code navigation workflow

Browse Source
This commit is contained in:
omigamedev
2026-06-04 21:16:36 +02:00
parent 6440bde002
commit 45802dfc7c
2 changed files with 10 additions and 3 deletions
Download Patch File Download Diff File Expand all files Collapse all files

9
AGENTS.md
View File

@@ -66,9 +66,12 @@ cmake --build --preset windows-msvc-default --config Debug --target clean
Codex has a repo-specific skill named `panopainter-code-navigation`. Use it when Codex has a repo-specific skill named `panopainter-code-navigation`. Use it when
following C++ symbols, finding symbol families with regular expressions, tracing following C++ symbols, finding symbol families with regular expressions, tracing
service/interface wiring, or checking platform/backend boundary usage. service/interface wiring, or checking platform/backend boundary usage.
Reach for `--name-regex`, `--detail-regex`, or `--path-regex` before broad For C++ refactors, use the skill before broad `rg` searches when the question
`rg` searches when a refactor depends on symbol identity, generated-style name depends on symbol identity rather than plain text. Reach for `--name-regex`,
families, signatures, or platform/backend path slices. `--detail-regex`, or `--path-regex` when looking for generated-style name
families, override groups, command/service families, signatures, or
platform/backend path slices. Use normal `rg` for docs, build files, comments,
string literals, generated command names, or exact non-C++ text.
Prefer compiler-aware navigation when following C++ symbols across the legacy Prefer compiler-aware navigation when following C++ symbols across the legacy
flat source tree and extracted components: flat source tree and extracted components:

4
docs/modernization/build-inventory.md
View File

@@ -109,6 +109,10 @@ Known local toolchain state:
`python scripts/dev/clangd_nav.py self-test`, also registered as `python scripts/dev/clangd_nav.py self-test`, also registered as
`panopainter_clangd_nav_regex_self_test`, so regex filter behavior can be `panopainter_clangd_nav_regex_self_test`, so regex filter behavior can be
validated without clangd or a compile database. 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 Reference lookup is guarded because a one-shot clangd process may not have a
complete project index: pass `--background-index` for broader best-effort complete project index: pass `--background-index` for broader best-effort
results or `--allow-incomplete-references` for explicitly results or `--allow-incomplete-references` for explicitly