Files
mnote/bugs/10-review/done/10-19-agents-md-broken-design-references-v1.md
T
lix-2026 1882db7681 收口 MNote P0 P1 P2 审查尾项
- 归档 OnlyOffice live bridge、Page AI、mindmap、design governance 与相关 bug 条目
- 补齐 MinerU OCR 后端 runtime 合同与 smoke/test 基线
- 收口 ChatOnly/Doubao、ObjectIdentity、Page Aggregate compat 与 runtime owner 文档口径

验证:
- cargo test --manifest-path rust/Cargo.toml -p mnote-web local_ocr -- --test-threads=1
- cargo test --manifest-path rust/Cargo.toml -p mnote-web onlyoffice_bridge -- --test-threads=1
- git diff --check
- git diff --cached --check
- codegraph index . --force && codegraph status .
- codegraph sync . && codegraph status .
2026-06-01 09:29:12 +08:00

2.1 KiB
Raw Blame History

10-19 AGENTS.md 架构参考路径断裂

状态

  • 状态:done
  • Owner10-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.md1-8AGENTS.md 的 active 入口。

影响

  • 后续 agent 按 AGENTS.md 查架构依据时会遇到文件不存在。
  • worker 可能因此退回旧记忆或自己猜测口径。
  • 01-05 已迁入 old/ 但仍被当作当前入口,削弱 design/README.md1-8 的入口权威。

修复建议

修复方式:

  • 01-05-current-priority-overview.md 替换为 CURRENT_ARCHITECTURE.mddesign/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 断裂引用。