# Docs Index

这个目录只保留当前仍有维护价值的文档。
阅读顺序建议从“权威事实”开始，再看“兼容清理”和“规划说明”。

## 权威事实

- [`current-architecture.md`](./current-architecture.md) — 当前项目架构、运行路径和真相源定义
- [`project-layout.md`](./project-layout.md) — 当前仓库目录职责与阅读方式
- [`terminology.md`](./terminology.md) — runtime、run、workspace 等核心术语
- [`runtime-api-changes.md`](./runtime-api-changes.md) — 当前 `runtime_service` API 约定与行为补充
- [`current-architecture.excalidraw`](./current-architecture.excalidraw) — 架构图源文件

## 兼容与遗留清理

- [`legacy-inventory.md`](./legacy-inventory.md) — 兼容层、遗留代码和历史边界清单
- [`compat-removal-plan.md`](./compat-removal-plan.md) — 兼容移除计划与收敛方向

## 规划说明

- [`development-roadmap.md`](./development-roadmap.md) — 后续演进方向和阶段性路线

## 使用原则

- 讨论“现在系统怎么工作”，优先看 `current-architecture.md`
- 讨论“顶层目录应该怎么理解”，优先看 `project-layout.md`
- 讨论“某个旧入口为什么还在”，优先看 `legacy-inventory.md`
- 讨论“准备删哪些兼容路径”，优先看 `compat-removal-plan.md`
- 不要把历史计划或阶段性修复记录当成当前事实源