docs: require removing merged worktrees

One worktree per ticket under D:/OPC/goauto-worktrees/issue-<N>; runtime and release worktrees are excluded. After the branch is merged (and released if needed) the implementing agent removes it with git worktree remove after checking merged/clean/process/link state, never --force and never deleting branches.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

AGENTS.md

@@ -188,9 +188,24 @@ Gitea 不可用时，输出完整工单草稿并说明阻塞。未经用户明
 - 不得默认使用 `-ExecutionPolicy Bypass`；只有可信 `.ps1` 确实被执行策略阻止且没有更小替代方案时，才对该次进程使用并在工单记录原因。
 - 涉及创建订单、权限、安全、并发、迁移和删除数据属于高风险，真机或正式实施前必须再次等待人工确认。
 
+### worktree 使用与清理
+
+- 一个单元工单一个 worktree，统一放在 `D:/OPC/goauto-worktrees/issue-<N>`，从最新 `origin/main` 拉分支；不在主仓库 `D:/OPC/goauto` 里切分支开发（它保存本地配置和用户自己的未提交改动）。
+- 运行和部署目录不是开发 worktree：supervisor 运行目录（`D:/OPC/goauto-runtime`、`D:/OPC/goauto-worktrees/main-runtime`）和 `release-*` 发布工作区由部署流程管理，不在其中开发，也不按本节清理。发布用的二进制和压缩包上传服务器后不要长期留在开发 worktree 里，回滚以服务器发布目录为准。
+- 新建 worktree 的前端依赖各自安装，不用 junction 链接别的目录的 `node_modules`，避免删除时连带破坏其他目录。
+- 工单分支合并进 main 并推送后（需要发布的，在发布完成后），由实施该工单的 Agent 在同一任务内删除对应 worktree，并在工单回写中记录。删除前逐项确认：
+  - HEAD 已是 `origin/main` 的祖先；
+  - `git status --porcelain` 为空；未跟踪的产物先确认去向，不能当作已备份；
+  - 没有进程或 supervisor 配置引用该目录，也没有其他目录链接到它；
+  - 目录内指向外部的链接先用 `rmdir`（只删链接）断开，并确认链接目标完好。
+- 删除使用 `git worktree remove <路径>`，不加 `--force`，不删除分支和提交历史；之后执行 `git worktree prune`。不对 `goauto*` 这类通配路径做递归强删。
+- 删除失败时（例如 pnpm 硬链接的原生模块被运行中的服务锁住）不强删，在工单记录残留路径，服务重启后再清理。
+- 未合并、有未提交改动或含本地数据（测试数据库、HAR、日志、任务资料）的 worktree 不得删除，先向用户报告并等待确认。
+
 ## 6. 完成与验收
 
 1. 逐项完成验收、测试、实现提交和推送，并把最终方案、差异、结果、提交及遗留问题写回工单。
+   - 分支合并进 main 后（需要发布的，在发布完成后），按第 5 节「worktree 使用与清理」删除该工单的 worktree，并在工单记录删除结果或残留路径。
 2. 工单保持「待验收」，用户没有明确验收通过前不得关闭。
 3. 有长期文档影响时，在本次待验收前完成唯一一轮 Wiki 更新、在线回读、镜像同步与一致性检查，并把页面和 revision 写回工单；无影响时在工单说明原因并跳过。
 4. 用户验收通过后只记录验收时间和结论，关闭单元工单并同步更新 MVP 和 Epic；没有新的长期事实变化时不重复 Wiki 同步。