From 0d5fb04965bf24f0243a23be9fad416a6291f4ee Mon Sep 17 00:00:00 2001
From: cfdaily <cfdaily@gitee.com>
Date: Thu, 14 May 2026 10:59:14 +0800
Subject: [PATCH] auto-sync: 2026-05-14 10:59:13

---
 docs/design/architecture-v2.md | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/docs/design/architecture-v2.md b/docs/design/architecture-v2.md
index e3ad857..1e4570c 100644
--- a/docs/design/architecture-v2.md
+++ b/docs/design/architecture-v2.md
@@ -1520,6 +1520,17 @@ sanguo_moziplus_v2/
         │   └── s3/
         │       └── ...
         │
+        ├── observations/                # Agent 主动观察与建议（v2.4 新增）
+        │   # Agent 执行中发现的异常、建议、洞察
+        │   # 其他 Agent 和庞统可直接 read 获取
+        │   ├── zhaoyun-001.md           # "数据有缺失值，建议加清洗步骤"
+        │   ├── zhangfei-001.md          # "建议用 MACD 替代均线"
+        │   └── ...
+        │
+        ├── status.json                  # 全局状态摘要（v2.4 新增，daemon 实时维护）
+        │   # {phase, steps: {s1: {state, agent}, ...}, anomalies, observations}
+        │   # Agent 执行前第一步 read 此文件获取全局视野
+        │
         ├── moments.jsonl               # 原子事件流（冗余 SQLite moments 表，追加写入）
         │   # 每行: {"type":"step_completed","ts":"...","agent":"zhaoyun","data":{...}}
         │