docs: add architecture awareness system — CLAUDE.md §13/§14 + ARCHITECTURE_BRIEF

- Activate CLAUDE.md with §13 architecture snapshot (auto-sync markers)
  and §14 anti-pattern warnings + scenario instructions
- Fix dead link to non-existent STABILIZATION_DIRECTIVE.md
- Update stale numbers (93→130 SaaS APIs, 171→182 Tauri commands, 13→15 admin pages)
- Create docs/ARCHITECTURE_BRIEF.md as permanent architecture reference
  covering 10 subsystems (butler, chatstream, LLM drivers, client routing,
  SaaS auth, memory pipeline, Pipeline DSL, Hands, middleware, key paths)
- Add /sync-arch skill for manual or workflow-triggered architecture sync
- Add PostToolUse hook to remind doc sync after git commit/push
- Update §8.3 completion flow to include architecture snapshot updates
- Mark memory files (system_architecture, butler_mode) as migrated to BRIEF
- Add ARCHITECTURE_BRIEF.md as top entry in MEMORY.md index

CLAUDE.md

@@ -2,8 +2,7 @@
 
 > **ZCLAW 是一个独立成熟的 AI Agent 桌面客户端**，专注于提供真实可用的 AI 能力，而不是演示 UI。
 
-> **当前阶段: 稳定化。** 参见 [docs/STABILIZATION_DIRECTIVE.md](docs/STABILIZATION_DIRECTIVE.md)
-> 在 P0 缺陷修复完成前，不接受任何新功能。所有 AI 会话必须先确认稳定化状态。
+> **当前阶段: 发布前管家模式实施。** 稳定化基线已达成，管家模式6交付物已完成。
 
 ## 1. 项目定位
 
@@ -30,15 +29,15 @@ ZCLAW 是面向中文用户的 AI Agent 桌面端，核心能力包括：
 
 ### 1.3 稳定化铁律
 
-**在 [STABILIZATION_DIRECTIVE.md](docs/STABILIZATION_DIRECTIVE.md) 完成标准达标前，以下行为被禁止：**
+**稳定化基线达成后仍需遵守以下约束：**
 
 | 禁止行为 | 原因 |
 |----------|------|
-| 新增 SaaS API 端点 | 已有 93 个（含 2 个 dev-only），前端未全部接通 |
+| 新增 SaaS API 端点 | 已有 130 个（含 2 个 dev-only），前端未全部接通 |
 | 新增 SKILL.md 文件 | 已有 75 个，大部分未执行验证 |
-| 新增 Tauri 命令 | 已有 171 个，24 个无前端调用 |
+| 新增 Tauri 命令 | 已有 182 个，70 个无前端调用且无 @reserved |
 | 新增中间件/Store | 已有 12 层中间件 + 18 个 Store |
-| 新增 admin 页面 | 已有 13 页 |
+| 新增 admin 页面 | 已有 15 页 |
 
 ### 1.4 系统真实状态
 
@@ -53,13 +52,13 @@ ZCLAW/
 │   ├── zclaw-types/          # L1: 基础类型 (AgentId, Message, Error)
 │   ├── zclaw-memory/         # L2: 存储层 (SQLite, KV, 会话管理)
 │   ├── zclaw-runtime/        # L3: 运行时 (4 Driver, 7 工具, 12 层中间件)
-│   ├── zclaw-kernel/         # L4: 核心协调 (171 Tauri 命令)
+│   ├── zclaw-kernel/         # L4: 核心协调 (182 Tauri 命令)
 │   ├── zclaw-skills/         # 技能系统 (75 SKILL.md 解析, 语义路由)
 │   ├── zclaw-hands/          # 自主能力 (9 启用, 106 Rust 测试)
 │   ├── zclaw-protocols/      # 协议支持 (MCP 完整, A2A feature-gated)
 │   ├── zclaw-pipeline/       # Pipeline DSL (v1/v2, 10 行业模板)
 │   ├── zclaw-growth/         # 记忆增长 (FTS5 + TF-IDF)
-│   └── zclaw-saas/           # SaaS 后端 (93 API, Axum + PostgreSQL)
+│   └── zclaw-saas/           # SaaS 后端 (130 API, Axum + PostgreSQL)
 ├── admin-v2/                 # 管理后台 (Vite + Ant Design Pro, 13 页)
 ├── desktop/                  # Tauri 桌面应用
 │   ├── src/
@@ -351,9 +350,11 @@ docs/
 检查以下文档是否需要更新，有变更则立即修改：
 
 1. **CLAUDE.md** — 项目结构、技术栈、工作流程、命令变化时
-2. **docs/features/** — 功能状态变化时
-3. **docs/knowledge-base/** — 新的排查经验或配置说明
-4. **docs/TRUTH.md** — 数字（命令数、Store 数、crates 数等）变化时
+2. **CLAUDE.md §13 架构快照** — 涉及子系统变更时，更新 `<!-- ARCH-SNAPSHOT-START/END -->` 标记区域（可执行 `/sync-arch` 技能自动分析）
+3. **docs/ARCHITECTURE_BRIEF.md** — 架构决策或关键组件变更时
+4. **docs/features/** — 功能状态变化时
+5. **docs/knowledge-base/** — 新的排查经验或配置说明
+6. **docs/TRUTH.md** — 数字（命令数、Store 数、crates 数等）变化时
 
 #### 步骤 B：提交（按逻辑分组）
 
@@ -516,3 +517,64 @@ refactor(store): 统一 Store 数据获取方式
 ### 完整审计报告
 
 参见 `docs/features/SECURITY_PENETRATION_TEST_V1.md`
+
+***
+
+<!-- ARCH-SNAPSHOT-START -->
+<!-- 此区域由 auto-sync 自动更新，请勿手动编辑。更新时间: 2026-04-09 -->
+
+## 13. 当前架构快照
+
+### 活跃子系统
+
+| 子系统 | 状态 | 最新变更 |
+|--------|------|----------|
+| 管家模式 (Butler) | ✅ 活跃 | 04-09 ButlerRouter + 双模式UI + 痛点持久化 + 冷启动 |
+| 聊天流 (ChatStream) | ✅ 稳定 | 04-02 ChatStore 拆分为 4 Store (stream/conversation/message/chat) |
+| 记忆管道 (Memory) | ✅ 稳定 | 04-02 闭环修复: 对话→提取→FTS5+TF-IDF→检索→注入 |
+| SaaS 认证 (Auth) | ✅ 稳定 | Token池 RPM/TPM 轮换 + JWT password_version 失效机制 |
+| Pipeline DSL | ✅ 稳定 | 04-01 17 个 YAML 模板 + DAG 执行器 |
+| Hands 系统 | ✅ 稳定 | 9 启用 (Browser/Collector/Researcher/Twitter/Whiteboard/Slideshow/Speech/Quiz/Clip) |
+| 技能系统 (Skills) | ✅ 稳定 | 75 个 SKILL.md + 语义路由 |
+| 中间件链 | ✅ 稳定 | 12 层 (含 DataMasking@90, ButlerRouter) |
+
+### 关键架构模式
+
+- **管家模式**: 双模式UI (默认简洁/解锁专业) + ButlerRouter 4域关键词分类 (healthcare/data_report/policy/meeting) + 冷启动4阶段hook (idle→greeting→waiting→completed) + 痛点双写 (内存Vec+SQLite)
+- **聊天流**: 3种实现 → GatewayClient(WebSocket) / KernelClient(Tauri Event) / SaaSRelay(SSE) + 5min超时守护。详见 [ARCHITECTURE_BRIEF.md](docs/ARCHITECTURE_BRIEF.md)
+- **客户端路由**: `getClient()` 4分支决策树 → Admin路由 / SaaS Relay(可降级到本地) / Local Kernel / External Gateway
+- **SaaS 认证**: JWT→OS keyring 存储 + HttpOnly cookie + Token池 RPM/TPM 限流轮换 + SaaS unreachable 自动降级
+- **记忆闭环**: 对话→extraction_adapter→FTS5全文+TF-IDF权重→检索→注入系统提示
+- **LLM 驱动**: 4 Rust Driver (Anthropic/OpenAI/Gemini/Local) + 国内兼容 (DeepSeek/Qwen/Moonshot 通过 base_url)
+
+### 最近变更
+
+1. [04-09] 管家模式6交付物完成: ButlerRouter + 冷启动 + 简洁模式UI + 桥测试 + 发布文档
+2. [04-08] 侧边栏 AnimatePresence bug + TopBar 重复 Z 修复 + 发布评估报告
+3. [04-07] @reserved 标注 5 个 butler Tauri 命令 + 痛点持久化 SQLite
+4. [04-06] 4 个发布前 bug 修复 (身份覆盖/模型配置/agent同步/自动身份)
+
+<!-- ARCH-SNAPSHOT-END -->
+
+<!-- ANTI-PATTERN-START -->
+<!-- 此区域由 auto-sync 自动更新，请勿手动编辑。更新时间: 2026-04-09 -->
+
+## 14. AI 协作注意事项
+
+### 反模式警告
+
+- ❌ **不要**建议新增 SaaS API 端点 — 已有 130 个，稳定化约束禁止新增
+- ❌ **不要**忽略管家模式 — 已上线且为默认模式，所有聊天经过 ButlerRouter
+- ❌ **不要**假设 Tauri 直连 LLM — 实际通过 SaaS Token 池中转，SaaS unreachable 时降级到本地 Kernel
+- ❌ **不要**建议从零实现已有能力 — 先查 Hand(9个)/Skill(75个)/Pipeline(17模板) 现有库
+- ❌ **不要**在 CLAUDE.md 以外创建项目级配置或规则文件 — 单一入口原则
+
+### 场景化指令
+
+- 当遇到**聊天相关** → 记住有 3 种 ChatStream 实现，先用 `getClient()` 判断当前路由模式
+- 当遇到**认证相关** → 记住 Tauri 模式用 OS keyring 存 JWT，SaaS 模式用 HttpOnly cookie
+- 当遇到**新功能建议** → 先查 [TRUTH.md](docs/TRUTH.md) 确认可用能力清单，避免重复建设
+- 当遇到**记忆/上下文相关** → 记住闭环已接通: FTS5+TF-IDF+embedding，不是空壳
+- 当遇到**管家/Butler** → 管家模式是默认模式，ButlerRouter 在中间件链中做关键词分类+system prompt 增强
+
+<!-- ANTI-PATTERN-END -->