From d96df9adfa7c9182cbf8569ac8ba6093c618dd61 Mon Sep 17 00:00:00 2001
From: Ryan Yin <xiaoyin_c@qq.com>
Date: Mon, 14 Sep 2026 21:35:43 +0800
Subject: [PATCH] docs(agents): note single-quote inline code for nu/python

---
 agents/AGENTS.md | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/agents/AGENTS.md b/agents/AGENTS.md
index 9f6fffa3..6cb1ebdf 100644
--- a/agents/AGENTS.md
+++ b/agents/AGENTS.md
@@ -109,7 +109,8 @@ agents MUST ask which state to use before editing.
 - Agents SHOULD prefer a direct executable with native options over hand-written glue.
 - POSIX shell (e.g. Bash) is limited to invoking a single command with arguments. Any glue — pipes,
   chaining (`;`, `&&`), substitution, or redirection — or anything ShellCheck or BashPitfalls warns
-  about MUST be done in Nushell or Python instead (e.g. `nu -c`, `python -c`).
+  about MUST be done in Nushell or Python instead (e.g. `nu -c '...'`, `python -c '...'`, with the
+  inline code in single quotes so the shell does not expand it).
 - Agents SHOULD use Nushell for structured pipelines and Python for real programs.
 
 ### Project-owned scripts