docs: 更新 README 和 DEVELOPMENT，补充设计决策说明

DEVELOPMENT.md

@@ -65,6 +65,38 @@ CLI 通过子命令提供帮助和版本信息，不使用 `--help`/`--version`
 - `src/cli/output.ts` — 格式化输出（`错误:`、`用法:`、`提示:` 三段式）
 - `src/cli/help.ts` — 帮助文本生成
 
+## 设计决策
+
+### 阶段与配置
+
+- **四阶段固定**：discuss → plan → build → archive，不可自定义增删
+- **配置覆盖策略**：阶段级别全量覆盖，不支持字段级合并。自定义 plan 时需完整重写所有 documents
+- **配置文件名**：`.rune/config.yaml`，不是 `rune.yml`
+- **模板变量**：仅支持 `{{change-name}}`，不需要其他变量（信息已在上下文中）
+
+### 各阶段行为
+
+- **discuss**：不持久化讨论结果，完全依赖 AI 会话上下文传递；不设强制门控，通过提示词引导
+- **plan**：命令只输出提示词，不写入文件；AI 负责根据提示词生成文档内容并写入。重复调用同一文档的 plan 会追加已有内容用于增量修订。依赖未满足时有友好提示（非报错）
+- **build**：按 task.md 的 checkbox 顺序执行；任务间无结构化依赖；可多次执行直到全部完成
+- **archive**：归档前命令行校验 task 完成状态，未完成时在提示词中注入警告并引导 AI 询问用户
+
+### 变更名校验
+
+变更名仅支持中文、英文、短横线（`-`），不支持空格、下划线等其他符号。
+
+### update 命令
+
+`rune update <tool>` 对比已注入的命令/skill 文件内容与内置版本，不一致则覆盖，不存在则新建。用于升级 Rune 后更新编辑器配置。
+
+### 其他决策
+
+- 无跨变更依赖，变更之间完全独立
+- 无并发锁，同一变更可被多个 agent 同时操作
+- 无需变更废弃命令，手动删除目录即可
+- 同一变更名同天多次归档不处理冲突（日期+名称去重）
+- plan skill 应引导 AI 先通过 `rune status` 获取文档列表
+
 ## 测试策略
 
 ### Level 1 — 纯单元/集成测试（当前）