# 开发计划（Plans）

English: [README.en.md](./README.en.md)

## 这里存放什么

大型开发任务的实施计划，例如：

- feature；
- refactor；
- migration；
- architectural change。

## 目录结构

```text
active/     正在执行或尚未开始的计划
completed/  已完成的计划
```

任务完成后，将计划从 `active/` 迁移到 `completed/`：

```text
active/
→
completed/
```

有长期参考价值的计划不应删除。

## 不应该存放什么

- 小型任务的临时 TODO；
- 已被放弃且无参考价值的草稿（可直接删除）；
- 正式设计文档（放入 `../architecture/` 或使用 `../../.agent/templates/design.md`）。

## 当前状态

active：

- [2026-10-20-dsh-plugin-scaffold.md](./active/2026-10-20-dsh-plugin-scaffold.md) — DSH 插件脚手架开发路径与**进度总账**：初始化（bundle 骨架、兼容性契约、构建/验证链、文档体系）已完成，`v0.0.0` 未发布。

completed：暂无。

### 编号口径

- 本仓库只有初始化阶段；派生项目自行建立里程碑。
- 唯一真源：[路线图的进度总账](./active/2026-10-20-dsh-plugin-scaffold.md#进度总账)。

## 推荐命名

使用小写中划线命名，例如：

```text
YYYY-MM-DD-<short-title>.md
```

可参考 `.agent/templates/plan.md` 模板。