# Roadmap

> Tier 3 文档（人写，永不自动）。节奏单位：季度。规划单位：feature 或 epic。每条 epic 对应 [features/](features/) 或 GitHub Milestone。

## 当前版本：v0.1（<季度，例如 2026-Q2>）

**Theme**: <本季度主题，一句话>

<2-3 句描述本季度目标与重点。>

| Feature / Epic | Status | Milestone |
|---|---|---|
| <name> | planned / in-progress / done | <#N or link> |
| <name> | planned / in-progress / done | <#N or link> |

---

## v0.2（<下季度>）

**Theme**: <主题>

| Epic | 描述 | 优先级 |
|---|---|---|
| <#N name> | <一句话描述> | high / medium / low |
| <#N name> | <一句话描述> | high / medium / low |

**预计交付**：<日期>。

---

## v0.3（<再下季度，规划中>）

**Theme**: <主题>

| Epic | 描述 | 优先级 |
|---|---|---|
| <#N name> | <一句话描述> | TBD |

**预计交付**：<日期>。

---

## 长期方向（v1+）

不做承诺，仅记录方向：

- <方向 1>
- <方向 2>
- <方向 3>

---

## 节奏约定

- **季度结束前 1 周**：roadmap 评审，砍掉未启动 epic / 调整下季优先级
- **每季度首周**：[Pruning sprint](https://github.com/koala-agent/koala/blob/main/wiki/specs/framework-redesign.md)（先减再加）
- **roadmap 改动**：必须由 [vision.md](vision.md) 推导，且写新 ADR 解释变化

## 工作单元

- **Vision / Roadmap** 由人类维护（Tier 3）
- **Epic** = GitHub Milestone（包含 1-N 个 issue）
- **Story** = GitHub Issue
- **Task** = PR task list checkbox
- **Atomic** = git commit

详见 [`framework-redesign.md` §4](https://github.com/koala-agent/koala/blob/main/wiki/specs/framework-redesign.md)。

> 注：framework-redesign.md 是 koala 框架的设计文档，托管在 koala-agent/koala 仓库；新项目可参考但不必复制。

---

> 此文件由 `koala-core init` 创建。删除 `<...>` 占位后开始填写。
> 写作约束：季度级更新；与 vision 一致；roadmap 改动需 ADR。Tier 3（纯人工）。
