- 归档 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 .
2.1 KiB
2.1 KiB
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 断裂引用。