docs(skills): document review path-resolution gotcha in agy + grok

review/review-files resolve relative paths only against CWD or
$CLAUDETOOLS_ROOT, never a submodule/subdir — so submodule-relative
paths fail with "file not found". Add a [!WARNING] callout to both
SKILL.md files, fix the misleading "absolute or repo-relative" table
wording, and add inline GOTCHA comments at each resolution site in
both scripts. Bitten us repeatedly (latest: GuruConnect review).

.claude/skills/agy/scripts/ask-gemini.sh

@@ -239,6 +239,9 @@ case "$MODE" in
     [ -z "${1:-}" ] && { echo "usage: $SELF review <file-path> [instructions]" >&2; exit 2; }
     target="$1"
     instr="${2:-Give an independent, critical review of this file: accuracy, gaps/omissions, bugs, and concrete improvements. Be specific.}"
+    # GOTCHA: a relative path resolves against ONLY CWD or $REPO_ROOT ($CLAUDETOOLS_ROOT) --
+    # NOT a submodule/subdir. "server/src/x.rs" relative to a submodule fails ("file not found")
+    # unless CWD is that submodule. Pass ABSOLUTE paths for submodule/subtree files.
     if   [ -f "$target" ];            then resolved="$target"
     elif [ -f "$REPO_ROOT/$target" ]; then resolved="$REPO_ROOT/$target"
     else echo "[$SELF] file not found: $target" >&2; exit 2; fi
@@ -265,6 +268,9 @@ case "$MODE" in
     prep_includes
     list=""
     declare -A seen=()
+    # GOTCHA: each relative path resolves against ONLY CWD or $REPO_ROOT ($CLAUDETOOLS_ROOT) --
+    # NOT a submodule/subdir. Paths relative to a submodule fail unless CWD is that submodule.
+    # Pass ABSOLUTE paths for submodule/subtree files (e.g. build the list with `find "$(pwd)/..."`).
     for f in "${files[@]}"; do
       if   [ -f "$f" ];            then r="$f"
       elif [ -f "$REPO_ROOT/$f" ]; then r="$REPO_ROOT/$f"