From bd7ff978e9b78f0d52509d04ca42d0d52be60894 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E5=8F=B6=E6=9E=97=E7=AB=8B?= <sia@yelinlideMini-2.lan>
Date: Wed, 19 Aug 2026 22:26:57 +0800
Subject: [PATCH] docs: add Hippo memory workflow

---
 AGENTS.md | 26 ++++++++++++++++++++++++++
 1 file changed, 26 insertions(+)

diff --git a/AGENTS.md b/AGENTS.md
index f5e556e..e9b384d 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -172,3 +172,29 @@ Hippo 脚本变化必须额外用隔离 HOME/PATH 和 mock `pi`、`npm`、`hippo
 - `npm run check`：类型、测试和打包检查的完整验证。
 
 若环境缺少依赖或未执行某项验证，交付时明确说明，不以静态检查代替运行结果。
+
+<!-- hippo:start -->
+## Project Memory (Hippo)
+
+At the start of every task, run:
+```bash
+hippo context --auto --budget 1500
+```
+Read the output before writing any code.
+
+On errors or unexpected behaviour:
+```bash
+hippo remember "<description of what went wrong>" --error
+```
+
+On task completion:
+```bash
+hippo outcome --good
+```
+
+When Hippo's Codex wrapper is installed, session-end capture runs automatically.
+If the wrapper is not installed, capture a brief summary manually:
+```bash
+hippo capture --stdin <<< '<decisions, errors, lessons — 2-5 bullets>'
+```
+<!-- hippo:end -->