diff --git a/AGENTS.md b/AGENTS.md
index 27f98e7..625b509 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -4110,13 +4110,57 @@ cargo test -p markbase-core --lib --features smb-server,ldap  # 355 passed, 0 fa
 
 **替代方案**：
 - 使用 Kerberos/SPNEGO（smb-server 不支持）
-- 使用 LDAP password sync 工具（独立 CLI 命令）
+- 使用 LDAP password sync 工具（独立 CLI）
 
 ---
 
-### 下一步 ⭐⭐⭐⭐⭐
+### Phase 3：Write/Read Cache ⭐⭐⭐⭐⭐
 
-**Phase 3**：Write/Read Cache (~150 lines)
+**完成時間**：约 30 分钟
+**新增代碼量**：~335 行
+**Git commit**：ebe976e
+
+---
+
+### Write/Read Cache 实现 ⭐⭐⭐⭐⭐
+
+**核心功能**：
+- ReadCache（64MB default, 64KB blocks, 5min TTL）
+- WriteCache（32MB default）
+- LRU eviction + TTL expiry
+- Block-based caching for read operations
+- Pending write buffer for write operations
+
+**CacheConfig**：
+```rust
+pub struct CacheConfig {
+    pub read_cache_size: usize,        // 64MB
+    pub read_cache_block_size: usize,  // 64KB
+    pub write_cache_size: usize,       // 32MB
+    pub cache_ttl_secs: u64,           // 5min
+}
+```
+
+**测试**：7 个单元测试 pass
+
+---
+
+### 測試結果 ⭐⭐⭐⭐⭐
+
+```bash
+cargo test -p markbase-core --lib  # 362 passed, 0 failed
+```
+
+---
+
+### Session 統計 ⭐⭐⭐⭐⭐
+
+| 指標 | 值 |
+|------|-----|
+| Commits | 29 (Phase 1-3 complete) |
+| 新增代碼 | ~980 行 |
+| 測試 | 362 passed ✅ |
+| 時間 | ~5 小時 |
 
 ---