From 96035a2e4a7e3ff95af0c946e5022429e02f1d0e Mon Sep 17 00:00:00 2001
From: Kros Dai <xdanger@gmail.com>
Date: Fri, 21 Aug 2026 02:35:36 -0400
Subject: [PATCH] =?UTF-8?q?=F0=9F=93=9D=20docs(agents):=20fail=20fast=20on?=
 =?UTF-8?q?=20`EROFS`?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- :memo: prevent runaway cleanup retries when sandboxed Trash writes fail
---
 agents/AGENTS.md | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/agents/AGENTS.md b/agents/AGENTS.md
index 5229da2..17bbf1a 100644
--- a/agents/AGENTS.md
+++ b/agents/AGENTS.md
@@ -7,7 +7,8 @@
 
 ## CLI Overrides
 
-- `rm` → `trash`, `mv`(tracked) → `git mv`
+- `rm` → `trash`, `mv`(tracked) → `git mv`. If a cleanup operation using `trash`
+  receives `EROFS`, fail immediately and report the error; never retry indefinitely.
 - `grep` → `rg`，`find` → `fd`，`cat` → `bat`，`ls` → `eza`
 - `sed` → `sd`，`du` → `dust`，`df` → `duf`，`make` → `just`
 - Also available: `jq`, `yq`, `fzf`, `glow`, `tldr`, `watchexec`, `difft`, `tokei`, `hyperfine`