docs/ 现在按两条线拆开：

• docs/design/ 设计总览、运行流程、领域模型、模块拆解、依赖关系。
• docs/tutorial/ 分模块教程，适合对照源码逐个击破。

如果你第一次读，先看 design 建地图，再进 tutorial 深挖。

• design/01-overview.md
• design/02-runtime-flows.md
• design/03-domain-models.md
• design/04-module-design.md
• design/05-dependencies.md

• TUTORIALS.md
• tutorial/01-architecture-overview.md
• tutorial/02-prompt-system.md
• tutorial/03-context-management.md
• tutorial/04-memory-system.md
• tutorial/05-sub-agent.md
• tutorial/06-agent-team.md
• tutorial/07-tool-system.md
• tutorial/08-command-system.md
• tutorial/09-state-management.md
• tutorial/10-query-engine.md
• tutorial/11-mcp-system.md
• tutorial/12-session.md

1. design/01-overview.md
2. design/02-runtime-flows.md
3. tutorial/01-architecture-overview.md

看完这三篇，你会知道：

• 入口在哪里
• 主执行链路是什么
• 命令、工具、Agent、Session 分别处在哪一层

1. tutorial/03-context-management.md
2. tutorial/10-query-engine.md
3. tutorial/07-tool-system.md
4. tutorial/12-session.md

这条线是 Claude Code 的主干：

• Context 怎么组装
• Query Loop 怎么跑
• Tool 怎么执行
• Session 怎么持久化

1. tutorial/02-prompt-system.md
2. tutorial/04-memory-system.md
3. tutorial/05-sub-agent.md
4. tutorial/06-agent-team.md

1. tutorial/08-command-system.md
2. tutorial/09-state-management.md
3. tutorial/11-mcp-system.md
4. design/04-module-design.md
5. design/05-dependencies.md

如果你只想要一条不绕路的顺序，就按下面读：

1. design/01-overview.md
2. design/02-runtime-flows.md
3. tutorial/01-architecture-overview.md
4. tutorial/03-context-management.md
5. tutorial/10-query-engine.md
6. tutorial/07-tool-system.md
7. tutorial/12-session.md
8. tutorial/02-prompt-system.md
9. tutorial/04-memory-system.md
10. tutorial/05-sub-agent.md
11. tutorial/06-agent-team.md
12. tutorial/08-command-system.md
13. tutorial/11-mcp-system.md
14. design/03-domain-models.md
15. design/04-module-design.md
16. design/05-dependencies.md