📝 docs(memory): bound context snapshot sections

tests/test_sync_templates_placeholders.py

@@ -62,6 +62,24 @@ class SyncTemplatesPlaceholdersTests(unittest.TestCase):
         ).read_text(encoding="utf-8")
         self.assertIn("## 成功定义", project_brief_template)
 
+        progress_template = (
+            ROOT / "templates" / "memory-bank" / "progress.template.md"
+        ).read_text(encoding="utf-8")
+        self.assertIn("短期状态快照，不是 changelog", progress_template)
+        self.assertIn("`Recent Changes` 只保留最近 3-5 条", progress_template)
+        self.assertIn("整理/替换旧摘要，不做无限追加", progress_template)
+
+        active_context_template = (
+            ROOT / "templates" / "memory-bank" / "active-context.template.md"
+        ).read_text(encoding="utf-8")
+        self.assertIn("短期上下文快照，不是长期日志", active_context_template)
+        self.assertIn("`Recent Changes` 只保留最近 3-5 条", active_context_template)
+        self.assertIn(
+            "`Touched Files` 只保留当前 Plan / 下一轮仍相关的文件",
+            active_context_template,
+        )
+        self.assertIn("整理/替换旧上下文，不做无限追加", active_context_template)
+
         update_memory_template = (
             ROOT / "templates" / "prompts" / "coding" / "update-memory.template.md"
         ).read_text(encoding="utf-8")
@@ -71,6 +89,15 @@ class SyncTemplatesPlaceholdersTests(unittest.TestCase):
         self.assertIn("## New Context", update_memory_template)
         self.assertIn("## Outstanding Risks", update_memory_template)
         self.assertIn("AGENT_RULES.local.md", update_memory_template)
+        self.assertIn("短期状态快照", update_memory_template)
+        self.assertIn(
+            "不要把 `Recent Changes` 当作无限追加日志", update_memory_template
+        )
+        self.assertIn("短期上下文快照", update_memory_template)
+        self.assertIn(
+            "`Touched Files` 只保留当前 Plan / 下一轮仍相关的文件",
+            update_memory_template,
+        )
 
         close_task_template = (
             ROOT / "templates" / "prompts" / "coding" / "close-task.template.md"
@@ -154,6 +181,8 @@ class SyncTemplatesPlaceholdersTests(unittest.TestCase):
         self.assertIn("`memory-bank/progress.md`", rules_template)
         self.assertIn("必要 memory 更新", rules_template)
         self.assertIn("工作区保持干净后再领取下一个 Plan", rules_template)
+        self.assertIn("`progress.md` 上半部分是短期状态快照", rules_template)
+        self.assertIn("`active-context.md` 是短期上下文快照", rules_template)
 
     def test_sync_templates_replaces_playbook_scripts_without_main_language_support(
         self,