From 3412dfefec0916ec941eec8a5962fd62c1fac365 Mon Sep 17 00:00:00 2001
From: Ryan Yin <xiaoyin_c@qq.com>
Date: Mon, 14 Sep 2026 20:57:12 +0800
Subject: [PATCH] docs(agents): require Nushell or Python for shell glue

- limit POSIX shell to a single command with arguments
- route pipes, chaining, substitution, redirection, and ShellCheck/BashPitfalls cases to Nushell or Python
---
 agents/AGENTS.md | 9 ++++-----
 1 file changed, 4 insertions(+), 5 deletions(-)

diff --git a/agents/AGENTS.md b/agents/AGENTS.md
index 55410185..9f6fffa3 100644
--- a/agents/AGENTS.md
+++ b/agents/AGENTS.md
@@ -106,11 +106,10 @@ agents MUST ask which state to use before editing.
 
 ### Local ad-hoc commands
 
-- Agents SHOULD prefer a direct executable with native options over hand-written glue, and keep
-  POSIX shell (e.g. Bash) to single-line ad-hoc glue only.
-- Once a task needs anything ShellCheck or BashPitfalls warns about — e.g. quoting discipline, error
-  handling, structured parsing (JSON/CSV/regex), dates/floats, retries/timeouts, or cross-platform
-  flags — agents MUST move to Nushell or Python.
+- 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`).
 - Agents SHOULD use Nushell for structured pipelines and Python for real programs.
 
 ### Project-owned scripts