完善文档

docs/README.md

@@ -6,6 +6,36 @@
 
 下层文档发现冲突时必须回报并修订，不能以现有代码或当前实现状态覆盖产品定义。
 
+- `architecture/`：总体架构与系统数据流
+- `agent/`：Agent Runtime 与认知架构
+- `rag/`：RAG 与知识系统
+- `tools/`：工具系统
+- `mcp/`：MCP 集成
+- `api/`：API 与流式协议
+- `data/`：数据库、缓存、向量、图和文件存储
+- `client/`：Web、BFF、Desktop
+- `services/`：Go 高并发服务
+- `security/`：安全设计
+- `infrastructure/`：部署、容器、可观测性
+- `testing/`：测试与评估
+- `decisions/`：架构决策记录
+
+## 阅读顺序
+
+新开发者：
+
+`architecture/overview.md -> agent/overview.md -> 对应领域文档`
+
+AI Agent：
+
+`AGENTS.md -> 本目录 -> 对应领域文档 -> ADR`
+
+## 文档原则
+
+文档描述系统为什么这样设计、系统如何工作以及修改时需要遵守的边界。
+
+具体实现应以源码和测试为最终事实来源。
+
 ## 快速阅读
 
 ### 理解产品