# 迭代目录与命名规范

**版本：** 2026-08-07  
**适用范围：** `agent_ops/03.迭代规划/` 下的新迭代目录

## 1. 迭代目录命名

迭代目录统一使用：

```text
<迭代编号>.<简短名称>/
```

例如：

- `04.runtime_workspace/`
- `04A.agent_tool_route/`
- `05.first_isolated_miniapp/`

## 2. 每个迭代目录的推荐结构

```text
<迭代目录>/
├── 01.迭代规划.md
├── 02.设计评审.md
├── 03.设计评审（二）.md              # 按需要增加
├── 05.技术实施规范.md
├── 06.技术实施规范评审.md
├── 07.技术实施规范评审（二）.md      # 按需要增加
├── 08.验收评审.md
├── 09.验收评审（二）.md              # 按需要增加
└── evidence/
```

## 3. 命名原则

- 主规划始终用 `01.迭代规划.md`
- 第一轮设计评审固定用 `02.设计评审.md`
- 技术实施规范固定用 `05.技术实施规范.md`
- 技术实施规范评审固定用 `06.技术实施规范评审.md`
- 验收评审从 `08` 开始，避免和前四步混淆

## 4. 为什么保留编号空位

保留 `03 / 04 / 07 / 09` 等位置，是为了支持：

- 多轮设计评审；
- 多轮技术规范评审；
- 多轮验收评审；
- 不打乱主文件的稳定编号。

## 5. 跨项目迭代的写法

从 `04A` 开始，主规划和技术规范都必须明确写出涉及项目，例如：

- `lineup-app`
- `lineup-adapter/hermes`
- `lineup-app-server`
- `infra/wukongim-v3`
- 文档目录本身

不能再把跨项目迭代只写成某一个仓的局部事项。