From 5fe43e3c12ef0ace82adede48ee6ea8147cef50e Mon Sep 17 00:00:00 2001
From: Ryan Yin <xiaoyin_c@qq.com>
Date: Sat, 29 Aug 2026 14:03:50 +0800
Subject: [PATCH] docs(agents): require reader-focused documentation

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

diff --git a/agents/AGENTS.md b/agents/AGENTS.md
index 51e3ad51..511a2ad8 100644
--- a/agents/AGENTS.md
+++ b/agents/AGENTS.md
@@ -64,6 +64,8 @@ At the start of repository work:
 - Preserve backward compatibility unless the user explicitly requests a breaking change.
 - Keep diffs minimal, reviewable, and grouped by logical purpose.
 - Do not revert user changes or unrelated changes unless explicitly asked.
+- Write for the intended reader and make documentation self-contained. Omit prior states, mistakes,
+  and surrounding context unless they are relevant and necessary for the reader's task.
 - Verify changes in proportion to their risk. Never claim a check passed unless it was run.
 
 ### Commit messages