Document regex code navigation workflow

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:

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(