# Change Workflow

## 目标

给 AI 一个稳定的执行顺序，避免直接跳到编码而漏掉规格、文档和回归验证。

## 推荐流程

1. 读取 `AGENTS.md`
2. 读取 `docs/ai/DOC_SOURCES.md`，确认这次需求涉及哪些权威文档
3. 按需读取 `docs/ARCHITECTURE.md`、专题规范和相关目录内 README
4. 检查 `.trae/specs/` 是否已有对应 feature
5. 如果是新功能或行为变化，先补或更新 `spec.md / tasks.md / checklist.md`
6. 再改代码
7. 补测试或复用已有测试文件
8. 运行最小必要验证
9. 回写文档入口和迁移说明

## 什么时候必须先更新 `.trae/specs/`

- 用户可见行为变化
- 设置页或主界面结构变化
- 组件系统规则变化
- 插件宿主集成、共享契约、SDK 使用模式变化

## 什么时候可以直接改代码

- 纯文档修复
- 不改变行为的内部重构
- 小范围 bugfix 且现有 spec 已完整覆盖该功能意图

## 最小验证清单

默认优先：

```bash
dotnet build LanMountainDesktop.slnx -c Debug
dotnet test LanMountainDesktop.slnx -c Debug
```

按需增加：

- 运行桌面宿主验证 UI 或启动行为
- 检查插件打包或 market 调试路径
- 手工验证设置页、主题切换、组件布局等高风险交互

## 回写要求

出现以下变化时，AI 应同步回写文档：

- 命令变化：更新 `docs/DEVELOPMENT.md`
- 模块职责变化：更新 `docs/ARCHITECTURE.md`
- 产品定位或阶段变化：更新 `docs/PRODUCT.md`
- AI 入口或权威来源变化：更新 `AGENTS.md` 或 `docs/ai/DOC_SOURCES.md`

## 不要做的事

- 不要把根目录 `README.md` 写成 feature 详细设计文档
- 不要在多份文档里重复维护同一条事实
- 不要把 `LanAirApp` 的资料误写成本仓库权威来源