docs/subsystems/ 每页描述一个子系统已经实现的行为、边界与验收。决策理由与还没实现的设计写在 Agent Notes。文档分层与写作规则见 AGENTS.md。
| 文档 | 内容 |
|---|---|
| architecture.md | 进程与通信、包与依赖方向、数据归属、领域词汇 |
| local-services.md | 本地 PostgreSQL 的启动、检查与重建 |
| testing.md | 测试分层、原则、写法与运行方式 |
| defensive-patterns.md | 本仓库实际出现过的缺陷与对应的写法 |
| AGENTS.md | 文档标准 |
| templates/package-readme.md | 包 README 的结构与写法 |
| 文档 | 内容 |
|---|---|
| messaging.md | Server：数据模型、消息与序号、已读位置、运行期状态、接口与 SSE |
| agent-runtime.md | Computer：启动与停止、Runner 与 Turn、OpenCode、Seatbelt、本机目录、crew 命令 |
每个包的入口、源码地图与对模型上下文的影响。
| 包 | 内容 |
|---|---|
| @crew/protocol | 接口契约、branded ID、启动握手、SSE 读取 |
| @crew/server | Collaboration Server |
| @crew/computer | Agent 宿主与 crew 命令 |
| @crew/desktop | Electron 主进程与界面 |
| 问题 | 看哪里 |
|---|---|
| 现在实际是什么 | 源码与 packages/server/drizzle/ 中的迁移；子系统页与它们一致 |
| 为什么这样设计 | .agents/notes/ |
| 怎样运行、有哪些命令 | 仓库根 README.md 与 AGENTS.md |
子系统页与代码不一致时，以代码为准，并在同一个改动里修正子系统页。
第一次接触这个项目：
- architecture.md：整体怎样组成。
- messaging.md：消息怎样保存与通知。
- agent-runtime.md：Agent 怎样被唤醒、运行与回复。