From 1b771287f9f7692f88db6618e29cd81a6a2ef3dd Mon Sep 17 00:00:00 2001 From: omigamedev Date: Thu, 4 Jun 2026 20:03:15 +0200 Subject: [PATCH] Document regex code navigation workflow --- AGENTS.md | 3 +++ scripts/dev/clangd_nav.py | 2 +- 2 files changed, 4 insertions(+), 1 deletion(-) diff --git a/AGENTS.md b/AGENTS.md index e8e8b5f..c24634b 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -66,6 +66,9 @@ cmake --build --preset windows-msvc-default --config Debug --target clean Codex has a repo-specific skill named `panopainter-code-navigation`. Use it when following C++ symbols, finding symbol families with regular expressions, tracing service/interface wiring, or checking platform/backend boundary usage. +Reach for `--name-regex`, `--detail-regex`, or `--path-regex` before broad +`rg` searches when a refactor depends on symbol identity, generated-style name +families, signatures, or platform/backend path slices. Prefer compiler-aware navigation when following C++ symbols across the legacy flat source tree and extracted components: diff --git a/scripts/dev/clangd_nav.py b/scripts/dev/clangd_nav.py index 5e7f021..d36f032 100644 --- a/scripts/dev/clangd_nav.py +++ b/scripts/dev/clangd_nav.py @@ -577,7 +577,7 @@ def main(argv: list[str]) -> int: "--ignore-case", action=argparse.BooleanOptionalAction, default=True, - help="Use case-insensitive --name-regex matching. Enabled by default.", + help="Use case-insensitive regex matching for --name-regex, --detail-regex, and --path-regex. Enabled by default.", ) parser.add_argument("--max-results", type=int, default=100, help="Maximum locations/symbols to print; <=0 disables.") parser.add_argument(