44 lines
2.1 KiB
Markdown
44 lines
2.1 KiB
Markdown
|
# 10-19 AGENTS.md 架构参考路径断裂
|
|||
|
|
|
|||
|
|
## 状态
|
|||
|
|
|
|||
|
|
- 状态：done
|
|||
|
|
- Owner：10-review / AGENTS 协作规则
|
|||
|
|
- 发现时间：2026-05-31
|
|||
|
|
|
|||
|
|
## 现象
|
|||
|
|
|
|||
|
|
发现时，`AGENTS.md` 的“需要架构判断时，优先参考”列表中有两个路径已经断裂。因为 `AGENTS.md` 是 agent 的顶层协作规则，这类失效引用会直接误导后续任务启动时的架构判断。
|
|||
|
|
|
|||
|
|
## 证据
|
|||
|
|
|
|||
|
|
- 发现时，`AGENTS.md` 仍引用 `/mnt/Data1T/mnote/design/01-05-current-priority-overview.md`，但该文件实际位于 `design/old/01-05-current-priority-overview.md`，根路径不存在。
|
|||
|
|
- 发现时，`AGENTS.md` 仍引用 `/mnt/Data1T/mnote/design/01-tree-first-graph-kernel/process/1-tree-first-graph-kernel-v1.md`，但实际文件位于 `design/01-tree-first-graph-kernel/reference/1-tree-first-graph-kernel-v1.md`。
|
|||
|
|
- 本轮已更新 `design/README.md`、`1-8` 与 `AGENTS.md` 的 active 入口。
|
|||
|
|
|
|||
|
|
## 影响
|
|||
|
|
|
|||
|
|
- 后续 agent 按 `AGENTS.md` 查架构依据时会遇到文件不存在。
|
|||
|
|
- worker 可能因此退回旧记忆或自己猜测口径。
|
|||
|
|
- `01-05` 已迁入 `old/` 但仍被当作当前入口，削弱 `design/README.md` 和 `1-8` 的入口权威。
|
|||
|
|
|
|||
|
|
## 修复建议
|
|||
|
|
|
|||
|
|
修复方式：
|
|||
|
|
|
|||
|
|
- 将 `01-05-current-priority-overview.md` 替换为 `CURRENT_ARCHITECTURE.md` 与 `design/01-tree-first-graph-kernel/process/1-8-mvp-post-process-execution-order-v1.md`。
|
|||
|
|
- 将 `process/1-tree-first-graph-kernel-v1.md` 改为 `reference/1-tree-first-graph-kernel-v1.md`，或删除该历史参考入口。
|
|||
|
|
|
|||
|
|
## 本轮进展
|
|||
|
|
|
|||
|
|
- 2026-05-31：用户设置的 P0 goal 已明确包含 `AGENTS/design 断裂引用`，本轮已更新 `AGENTS.md`：
|
|||
|
|
- 新增 `CURRENT_ARCHITECTURE.md`。
|
|||
|
|
- 新增 `design/01-tree-first-graph-kernel/process/1-8-mvp-post-process-execution-order-v1.md`。
|
|||
|
|
- 将 `1-tree-first-graph-kernel-v1.md` 指向 `reference/`。
|
|||
|
|
- 移除已不存在的 root `design/01-05-current-priority-overview.md` 引用。
|
|||
|
|
|
|||
|
|
## 验收
|
|||
|
|
|
|||
|
|
- `test -f` 验证 `AGENTS.md` 中列出的每个绝对路径都存在。
|
|||
|
|
- `rg -n "design/01-05-current-priority-overview.md|process/1-tree-first-graph-kernel-v1.md" AGENTS.md` 不再命中 active 断裂引用。
|