fix(claude-code): precise docs wording and add remoteUser test scenario

Update NOTES.md to accurately describe which existing definitions are
detected. Add test scenario combining yoloAlias with remoteUser to
verify file ownership for non-root users.

Author: tmaier

src/claude-code/NOTES.md

@@ -19,7 +19,7 @@ When `yoloAlias` is set to `true`, a `yolo` shell alias is created that expands
 
 > **Warning:** `--allow-dangerously-skip-permissions` disables Claude Code's normal permission checks and confirmation prompts for potentially sensitive actions. This meaningfully reduces safety and may allow unintended or unsafe changes, so only enable `yoloAlias` if you understand and accept the security implications.
 >
-> If a `yolo` alias or function already exists in your shell configuration, the installer will skip adding it to avoid overwriting your setup.
+> If a `yolo` alias already exists in `.bashrc`/`.zshrc`, or a `yolo.fish` function file already exists, the installer will skip adding it to avoid overwriting your setup.
 
 ## Auto-Updates
 

test/claude-code/claude_code_yolo_alias_with_custom_user.sh

@@ -0,0 +1,22 @@
+#!/bin/bash
+
+# This test file will be executed against the 'claude_code_yolo_alias_with_custom_user' scenario
+# to verify that the yolo alias is properly configured for a non-root remoteUser.
+
+set -e
+
+# Import test library bundled with the devcontainer CLI
+source dev-container-features-test-lib
+
+# Feature-specific tests
+check "claude command available" which claude
+check "yolo alias in bashrc" bash -c "grep -Fq 'claude --allow-dangerously-skip-permissions' ~/.bashrc"
+check "yolo alias in zshrc" bash -c "grep -Fq 'claude --allow-dangerously-skip-permissions' ~/.zshrc"
+check "fish yolo function body" bash -c "test -f ~/.config/fish/functions/yolo.fish && grep -Fq 'claude --allow-dangerously-skip-permissions' ~/.config/fish/functions/yolo.fish"
+check "bashrc owned by current user" bash -c "test \"$(stat -c '%U' ~/.bashrc)\" = \"$(whoami)\""
+check "zshrc owned by current user" bash -c "test \"$(stat -c '%U' ~/.zshrc)\" = \"$(whoami)\""
+check "fish function owned by current user" bash -c "test \"$(stat -c '%U' ~/.config/fish/functions/yolo.fish)\" = \"$(whoami)\""
+check "yolo resolves in bash" bash -ic "type yolo"
+
+# Report results
+reportResults

test/claude-code/scenarios.json

@@ -27,5 +27,14 @@
                 "yoloAlias": true
             }
         }
+    },
+    "claude_code_yolo_alias_with_custom_user": {
+        "image": "mcr.microsoft.com/devcontainers/base:ubuntu",
+        "remoteUser": "vscode",
+        "features": {
+            "claude-code": {
+                "yoloAlias": true
+            }
+        }
     }
 }