diff --git a/content/posts/code-doc-bot.md b/content/posts/code-doc-bot.md
index f0841c1..a79575b 100644
--- a/content/posts/code-doc-bot.md
+++ b/content/posts/code-doc-bot.md
@@ -22,6 +22,26 @@ summary: "code 是工程层,doc 是协作层,bot 在两层间穿梭。三位一
 | 面向 | 机器(也给人 review) | 人(也给 bot 读) | 桥接两层 |
 | 寿命 | 长期 + git 历史 | 长期、可追溯 | 一次次 session |
 
+```mermaid
+flowchart LR
+    Human(("人"))
+    Agent(("AI Agent"))
+    Doc["doc · 协作层"]
+    Code["code · 工程层"]
+
+    Human <-->|"操作"| Doc
+    Human -->|"review"| Code
+    Agent <-->|"读写"| Doc
+    Agent -->|"生成"| Code
+
+    style Human fill:#fff,stroke:#333,stroke-width:2px,color:#000
+    style Agent fill:#fff,stroke:#333,stroke-width:2px,color:#000
+    style Doc fill:#fc9,stroke:#333,stroke-width:2px,color:#000
+    style Code fill:#9cf,stroke:#333,stroke-width:2px,color:#000
+```
+
+人和 AI Agent 各从一边接入两层:人在 doc 抛意图、在 code 上 review;AI 在 doc 上读写、把成果生成到 code。两个 actor 不在同一介质上面对面,而是隔着 doc 和 code 两层异步协作——这正是它健康的姿势。
+
 注意 code 和 doc 不是按"内容种类"切分的——不是"过程归 code、结论归 doc"那种粗暴分工。它们是**同一份协作在两个层面的同时呈现**:
 
 - doc 端是**入口和出口**。入口是用户的混沌意图(需求一句话、背景几段、随手贴的截图);出口是给用户看的最终产出(结论、决策、总结)。doc 必须**灵活**,因为人脑就是灵活的、混乱的、随时改主意的