docs: 已完成阶段文档归档到 done/，README 索引补全

按 docs/README.md 既有约定（done/ 放「已实现/当前有效」），把两份已落地的阶段设计文档移入 done/system-design/： - 27-p1-virtual-reference.md P1 虚拟引用寻址，commit 226489d - 27-p2-org-graph.md P2 Org Graph，70a4727 + f20d0d8，真实建公司端到端验证过用 git mv 保留历史（R098 / R087）。移动断掉的 33 处相对链接已全部修复： moved 文件内的出向链接改 ../../todo/system-design/，todo/ 下 6 个文件的入向链接改 ../../done/system-design/。全 docs/ 扫描无断链。 README 此前严重过时——只列了 2 份 27 文档，实际已有 11 份。本次补全 todo/ 表格，每份标注状态与作用（总纲 / 需求源头 / 命名规范 / 端到端 / 参考场景 / P3+P4 已实现 / 验收契约 / P4 设计中），并在 done/ 表格补上 P1、P2 两行。 ■ 刻意没有移动 27-p3-p4-work-graph-console.md 它虽然已实现（c3abf4a），但文档正被另一进程持续修改（工作区 M 状态）。移动会打断它的编辑路径，等它收尾后再归档。 ■ 三份文件的链接修复留在工作区未提交 27-naming-conventions.md / 27-p3-p4-work-graph-console.md / 27-requirement.md 里，我的链接修复与另一进程的在途编辑混在同一文件中，单独拆分风险大于收益。工作区内容是正确的（链接已指向新路径），会随它下次提交一并带上。 Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

docs: 已完成阶段文档归档到 done/，README 索引补全
按 docs/README.md 既有约定（done/ 放「已实现/当前有效」），把两份已落地的阶段设计文档移入 done/system-design/： - 27-p1-virtual-reference.md P1 虚拟引用寻址，commit 226489d - 27-p2-org-graph.md P2 Org Graph，70a4727 + f20d0d8，真实建公司端到端验证过用 git mv 保留历史（R098 / R087）。移动断掉的 33 处相对链接已全部修复： moved 文件内的出向链接改 ../../todo/system-design/，todo/ 下 6 个文件的入向链接改 ../../done/system-design/。全 docs/ 扫描无断链。 README 此前严重过时——只列了 2 份 27 文档，实际已有 11 份。本次补全 todo/ 表格，每份标注状态与作用（总纲 / 需求源头 / 命名规范 / 端到端 / 参考场景 / P3+P4 已实现 / 验收契约 / P4 设计中），并在 done/ 表格补上 P1、P2 两行。 ■ 刻意没有移动 27-p3-p4-work-graph-console.md 它虽然已实现（c3abf4a），但文档正被另一进程持续修改（工作区 M 状态）。移动会打断它的编辑路径，等它收尾后再归档。 ■ 三份文件的链接修复留在工作区未提交 27-naming-conventions.md / 27-p3-p4-work-graph-console.md / 27-requirement.md 里，我的链接修复与另一进程的在途编辑混在同一文件中，单独拆分风险大于收益。工作区内容是正确的（链接已指向新路径），会随它下次提交一并带上。 Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
yibo
1 parent 5f1e1efd
Showing 6 changed files with 47 additions and 37 deletions
docs/README.md
docs/todo/system-design/27-p1-virtual-reference.md → docs/done/system-design/27-p1-virtual-reference.md
docs/todo/system-design/27-p2-org-graph.md → docs/done/system-design/27-p2-org-graph.md
docs/todo/system-design/27-e2e-task-execution-flow.md
docs/todo/system-design/27-example-dev-company-walkthrough.md
docs/todo/system-design/27-graph-agent-architecture.md
@@ -8,7 +8,7 @@
 判断依据：文档正文的显式「状态」标记（✅ 已完成 / 已实现 vs 📝 设计中 / 未实现）、未勾选的 checklist，以及与代码库实际实现的交叉核对（见各条目备注）。
-> **当前主线**：Graph Agent 架构重构（[27-graph-agent-architecture.md](./todo/system-design/27-graph-agent-architecture.md)）。`todo/` 下只保留这一份，其余待办已移入 `todo/future/`，避免和主线抢注意力。
+> **当前主线**：Graph Agent 架构重构（[27-graph-agent-architecture.md](./todo/system-design/27-graph-agent-architecture.md)）。该系列已完成的阶段文档（P1/P2）移入 `done/`，其余非主线待办在 `todo/future/`。
 ## done/
@@ -21,14 +21,24 @@
 | [qa_judge_req.md](./done/qa_judge_req.md) | QA Judge Agent 需求文档 — 已在 `system/templates/qa-judge/` 落地 |
 | [task_timeline_design.md](./done/task_timeline_design.md) | Task Timeline View 设计文档 — 已实现（`server/routes/tasks.js`、`server/services/task-service.js`、`web/src/views/TaskTimeline.vue`） |
 | [user-guides/08-base-agent-4-phase-guide.md](./done/user-guides/08-base-agent-4-phase-guide.md) | Base Agent 四阶段使用指南 |
+| [system-design/27-p1-virtual-reference.md](./done/system-design/27-p1-virtual-reference.md) | P1 虚拟引用寻址 — ✅ 已实现（commit `226489d`，`server/services/graph-service.js`）：`agent.md` 不再逐公司拷贝，改为 `config.json.systemAgentRef` 引用 + `company-context.md` 承载公司语境 |
+| [system-design/27-p2-org-graph.md](./done/system-design/27-p2-org-graph.md) | P2 Org Graph — ✅ 已实现（`70a4727` + `f20d0d8`）：org graph 定位为 company 级 workflow（执行流边），`orggraph-planning` agent 建公司时自动规划并招聘。真实建公司端到端验证通过 |
 | [system-design/01-26](./done/system-design/) | 系统设计正文 01～26 章（14、25-harness-engineering-improvements 例外，见 todo/future/；27 例外，见 todo/），各章节状态见文内「状态」标记 |
 ## todo/（当前主线）
+Graph Agent 架构重构（27 系列）。**已完成的阶段文档已移入 `done/`**（P1、P2），下面是仍在推进或长期有效的部分。
+
 | 文件 | 说明 |
 |------|------|
-| [system-design/27-graph-agent-architecture.md](./todo/system-design/27-graph-agent-architecture.md) | Graph Agent 架构，状态：📝 设计中，未实现。P0-P6 分阶段路线图，当前唯一在推进的重构 |
-| [system-design/27-p1-virtual-reference.md](./todo/system-design/27-p1-virtual-reference.md) | P1（虚拟引用）细化需求与设计文档：`getAgentConfig()`/`PromptBuilder.build()`/`hire()` 的具体改法、验收标准、blast radius、未决问题 |
+| [27-graph-agent-architecture.md](./todo/system-design/27-graph-agent-architecture.md) | **总纲**。P0-P6 分阶段路线图与整体架构。P0-P3+P4 已实现，P4（新）/P5/P6 待做 |
+| [27-requirement.md](./todo/system-design/27-requirement.md) | **需求源头**。用户原话照搬（R-1..R-16）+ 需求→设计落点速查。其余文档都是对它的转述，出现分歧以此为准 |
+| [27-naming-conventions.md](./todo/system-design/27-naming-conventions.md) | **命名规范**。`{作用域}-{职能}`；图节点按层级轴命名；节点名 ≠ 本体名；三种 benchmark 消歧；OKR 正名。新增 agent id / 表名 / 字段名前必读 |
+| [27-e2e-task-execution-flow.md](./todo/system-design/27-e2e-task-execution-flow.md) | 端到端流程总览：建公司 → 下达任务 → org graph 逐节点执行 → work graph 规划与循环 → 验收收敛。含与 DevLoop 既有实现的对应关系分析 |
+| [27-example-dev-company-walkthrough.md](./todo/system-design/27-example-dev-company-walkthrough.md) | 参考场景走查（虚构的「配图工厂」），把架构跑一遍具体的数：各阶段 JSON 形态、成本估算、断点清单 |
+| [27-p3-p4-work-graph-console.md](./todo/system-design/27-p3-p4-work-graph-console.md) | P3+P4（原 P4 回退+Loop-Validator 已并入）图执行引擎与执行控制台 — ✅ 已实现（`c3abf4a`），文档仍在补充中 |
+| [27-goal-contract-format.md](./todo/system-design/27-goal-contract-format.md) | 验收契约格式（`goal-benchmark` / `goal-test-data` / `goal-test-script` 的产物形态与跨节点传递） |
+| [27-p4-parallel-and-artifacts.md](./todo/system-design/27-p4-parallel-and-artifacts.md) | **P4（回收编号）并行执行与产物索引** — 📝 设计中。fan-out 真并发 + 同 agent 多实例隔离 + `files.json` 产物索引。三个 Phase，C 可插队 |
 ## todo/future/（暂缓，非当前重心）
 # 27-P1. 虚拟引用寻址 — 需求与设计文档
-> **所属**: [27 Graph Agent 架构](./27-graph-agent-architecture.md) 的 Phase P1（"虚拟引用"）
+> **所属**: [27 Graph Agent 架构](../../todo/system-design/27-graph-agent-architecture.md) 的 Phase P1（"虚拟引用"）
 > **版本**: v0.2（设计阶段，未实现；因 P0 完工同步更新）
 > **日期**: 2026-08-15
-> **前置**: P0 地基已**全部完工**并提交（commit `8421f55`）——`seedGlobalAgents()`/`seedTemplates()`/`seedCompanyAgents()`/`verifyCounts()` 四步全部实现，`system_agents.legacy_path` 可用，`org_graph_nodes` 已经把**现有全部公司雇佣关系**回填完毕（不再是空表）。P0 实施过程中发现一个直接影响 P1 设计的问题：**`system/agents/` 与 `system/templates/` 存在 6 个同名但内容可能不同步的 id**，详见 [27 号文档 §7](./27-graph-agent-architecture.md#七p0-实施发现2026-08-15) 与下文 §4.6——本版本已针对这个问题修正了查表逻辑。
+> **前置**: P0 地基已**全部完工**并提交（commit `8421f55`）——`seedGlobalAgents()`/`seedTemplates()`/`seedCompanyAgents()`/`verifyCounts()` 四步全部实现，`system_agents.legacy_path` 可用，`org_graph_nodes` 已经把**现有全部公司雇佣关系**回填完毕（不再是空表）。P0 实施过程中发现一个直接影响 P1 设计的问题：**`system/agents/` 与 `system/templates/` 存在 6 个同名但内容可能不同步的 id**，详见 [27 号文档 §7](../../todo/system-design/27-graph-agent-architecture.md#七p0-实施发现2026-08-15) 与下文 §4.6——本版本已针对这个问题修正了查表逻辑。
 ---
 # 27-P2. Org Graph â€” å…¬å¸çº§ Workflow çš„ç”Ÿæˆä¸Žè½åœ°
-> **æ‰€å±ž**: [27 Graph Agent æž¶æž„](./27-graph-agent-architecture.md) çš„ Phase P2
+> **æ‰€å±ž**: [27 Graph Agent æž¶æž„](../../todo/system-design/27-graph-agent-architecture.md) çš„ Phase P2
 > **ç‰ˆæœ¬**: v0.4ï¼ˆ**æŒ‰æ‰§è¡Œæµè¾¹æ¨¡åž‹é‡å†™**ï¼›v0.1-v0.3 æŠŠ Org Graph å»ºæ¨¡ä¸ºé™æ€æ±‡æŠ¥ç»“æž„ï¼Œè¯¥æ¨¡åž‹å·²ä½œåºŸï¼Œè§ Â§ä¸€ï¼‰
 > **æ—¥æœŸ**: 2026-08-15
 > **å‰ç½®**: P0 åœ°åŸºå·²å®Œå·¥ï¼ˆcommit `8421f55`ï¼‰ã€**P1 è™šæ‹Ÿå¼•ç”¨å¯»å€å·²å®žçŽ°**ï¼ˆcommit `226489d`ï¼Œ`server/services/graph-service.js`ï¼‰
-> **å‘½å**: å…¨æ–‡éµå¾ª [27-NAMING å‘½åè§„èŒƒ](./27-naming-conventions.md)ã€‚v0.3 çš„ `org-graph-creator` åœ¨æœ¬ç‰ˆæœ¬ç»Ÿä¸€æ”¹åä¸º **`orggraph-planning`**ã€‚
-> **é…å¥—**: [27-E2E ç«¯åˆ°ç«¯æµç¨‹](./27-e2e-task-execution-flow.md)ï¼ˆæœ¬æ–‡æ¡£åœ¨æ•´æ¡é“¾è·¯é‡Œçš„ä½ç½®ï¼‰ã€[27-EXAMPLE å‚è€ƒåœºæ™¯](./27-example-dev-company-walkthrough.md)ï¼ˆè·‘ä¸€éå…·ä½“çš„æ•°ï¼‰
+> **å‘½å**: å…¨æ–‡éµå¾ª [27-NAMING å‘½åè§„èŒƒ](../../todo/system-design/27-naming-conventions.md)ã€‚v0.3 çš„ `org-graph-creator` åœ¨æœ¬ç‰ˆæœ¬ç»Ÿä¸€æ”¹åä¸º **`orggraph-planning`**ã€‚
+> **é…å¥—**: [27-E2E ç«¯åˆ°ç«¯æµç¨‹](../../todo/system-design/27-e2e-task-execution-flow.md)ï¼ˆæœ¬æ–‡æ¡£åœ¨æ•´æ¡é“¾è·¯é‡Œçš„ä½ç½®ï¼‰ã€[27-EXAMPLE å‚è€ƒåœºæ™¯](../../todo/system-design/27-example-dev-company-walkthrough.md)ï¼ˆè·‘ä¸€éå…·ä½“çš„æ•°ï¼‰
 ---
@@ -25,7 +25,7 @@ v0.1-v0.3 æŠŠ Org Graph å»ºæ¨¡ä¸º**é™æ€æ±‡æŠ¥ç»“æž„**ï¼šèŠ‚ç‚¹æ˜¯è§’è‰²å¼•ç”¨ï
 | ç”Ÿæˆæ—¶æœº | å»ºå…¬å¸æ—¶ï¼Œä¸€æ¬¡ | æ¯ä¸ª org node æŽ¥åˆ°ä»»åŠ¡æ—¶ |
 | èŠ‚ç‚¹æŒ‡å‘ | org node agentï¼ˆ`org-planner` ç‰ï¼‰ | system agent å¼•ç”¨ |
 | è¾¹çš„è¯ä¹‰ | **æ‰§è¡Œæµ**ï¼š`condition âˆˆ {success, fail}` | **æ‰§è¡Œæµ**ï¼šåŒå·¦ |
-| æ‰§è¡Œå¼•æ“Ž | [27-P3/P4](./27-p3-p4-work-graph-console.md) çš„åŒä¸€å¥— | åŒå·¦ |
+| æ‰§è¡Œå¼•æ“Ž | [27-P3/P4](../../todo/system-design/27-p3-p4-work-graph-console.md) çš„åŒä¸€å¥— | åŒå·¦ |
 **ç”±æ¤å¸¦æ¥çš„å››å¤„ç»“æž„æ€§æ”¹åŠ¨**ï¼ˆè¿™ä¹Ÿæ˜¯æœ¬æ¬¡é‡å†™çš„ä¸»è¦å†…å®¹ï¼‰ï¼š
@@ -47,7 +47,7 @@ v0.1-v0.3 æŠŠ Org Graph å»ºæ¨¡ä¸º**é™æ€æ±‡æŠ¥ç»“æž„**ï¼šèŠ‚ç‚¹æ˜¯è§’è‰²å¼•ç”¨ï
 ### éžç›®æ ‡
-- **ä¸åš**å›¾çš„æ‰§è¡Œ â€”â€” æ‰§è¡Œå¼•æ“Žã€å¯åŠ¨/æš‚åœ/å•æ¥/é‡è¯•ã€SSE å…¨éƒ¨å±žäºŽ [27-P3/P4](./27-p3-p4-work-graph-console.md)ã€‚P2 åªè´Ÿè´£"æŠŠå›¾å»ºå‡ºæ¥ã€å˜å¥½ã€èƒ½è¯»èƒ½ç”»"ã€‚
+- **ä¸åš**å›¾çš„æ‰§è¡Œ â€”â€” æ‰§è¡Œå¼•æ“Žã€å¯åŠ¨/æš‚åœ/å•æ¥/é‡è¯•ã€SSE å…¨éƒ¨å±žäºŽ [27-P3/P4](../../todo/system-design/27-p3-p4-work-graph-console.md)ã€‚P2 åªè´Ÿè´£"æŠŠå›¾å»ºå‡ºæ¥ã€å˜å¥½ã€èƒ½è¯»èƒ½ç”»"ã€‚
 - **ä¸åš** `company.json.agents[]` çš„åºŸå¼ƒ â€”â€” å®ƒä»æ˜¯"è¿™å®¶å…¬å¸é›‡äº†è°"çš„çœŸç›¸æºï¼›org graph å›žç”çš„æ˜¯"ä»»åŠ¡æ€Žä¹ˆæµè¿‡è¿™äº›äºº"ï¼Œä¸¤è€…å¹¶å˜ã€‚
 - **ä¸åš**å˜é‡å…¬å¸çš„è¡¥å›¾ â€”â€” è§ Â§å…ã€‚
 - **ä¸åš** `workgraph-planning` agent æœ¬èº«çš„è®¾è®¡ â€”â€” å±žäºŽ P3ã€‚
@@ -95,10 +95,10 @@ CREATE UNIQUE INDEX IF NOT EXISTS idx_org_graph_edges_dedupe_active
 ### 3.3 å›¾çš„åˆæ³•æ€§çº¦æŸï¼ˆå†™å…¥å‰æ ¡éªŒï¼‰
-ä¸Ž work graph çš„æ‰§è¡Œå‰æ ¡éªŒåŒä¸€å¥—è§„åˆ™ï¼ˆ[27-P3/P4](./27-p3-p4-work-graph-console.md) Â§å››.Aï¼‰ï¼š
+ä¸Ž work graph çš„æ‰§è¡Œå‰æ ¡éªŒåŒä¸€å¥—è§„åˆ™ï¼ˆ[27-P3/P4](../../todo/system-design/27-p3-p4-work-graph-console.md) Â§å››.Aï¼‰ï¼š
 1. **æ— çŽ¯**ï¼ˆä»…é’ˆå¯¹ `edge_kind='forward'`ï¼‰â€”â€” ä¸‰è‰² DFSï¼Œå¤ç”¨ DevLoop `doc-store.js:167` çš„ `hasCycle()` å®žçŽ°ã€‚
-2. **å•ä¸€å…¥å£**ï¼ˆâœ… å·²å®šæ¡ˆï¼Œè§ [27-REQ](./27-requirement.md) R-13ï¼‰â€”â€” å¿…é¡»æ°å¥½æœ‰ä¸€ä¸ªå…¥åº¦ä¸º 0 çš„ forward èŠ‚ç‚¹ï¼Œä»»åŠ¡ä»Žè¿™é‡Œè¿›å…¥ã€‚å¤šå…¥å£ä¼šè®©"ä»»åŠ¡ä»Žå“ªå¼€å§‹"æ— æ³•ç¡®å®šï¼Œä¸”éœ€è¦ä»»åŠ¡å…¥å£å¤šå¸¦ä¸€ä¸ªå‚æ•°ã€‚
+2. **å•ä¸€å…¥å£**ï¼ˆâœ… å·²å®šæ¡ˆï¼Œè§ [27-REQ](../../todo/system-design/27-requirement.md) R-13ï¼‰â€”â€” å¿…é¡»æ°å¥½æœ‰ä¸€ä¸ªå…¥åº¦ä¸º 0 çš„ forward èŠ‚ç‚¹ï¼Œä»»åŠ¡ä»Žè¿™é‡Œè¿›å…¥ã€‚å¤šå…¥å£ä¼šè®©"ä»»åŠ¡ä»Žå“ªå¼€å§‹"æ— æ³•ç¡®å®šï¼Œä¸”éœ€è¦ä»»åŠ¡å…¥å£å¤šå¸¦ä¸€ä¸ªå‚æ•°ã€‚
 3. **å¯è¾¾æ€§** â€”â€” æ¯ä¸ªèŠ‚ç‚¹éƒ½å¿…é¡»ä»Žå…¥å£å¯è¾¾ï¼Œå¤ç«‹èŠ‚ç‚¹ç›´æŽ¥æ‹’ç»ã€‚
 4. **å›žé€€è¾¹å¿…é¡»æ˜¾å¼æ ‡æ³¨** â€”â€” ä»»ä½•æŒ‡å‘"æ‹“æ‰‘åºæ›´æ—©èŠ‚ç‚¹"çš„è¾¹ï¼Œ`edge_kind` å¿…é¡»æ˜¯ `backward`ï¼›å¼•æ“Žç‹¬ç«‹å¤æ ¸ï¼Œä¸ä¿¡ä»»æ ‡æ³¨ï¼ˆ27 å·æ–‡æ¡£ Â§3.4 ç¬¬ 5 ç‚¹çš„åŒæ¬¾å…œåº•ï¼‰ã€‚
@@ -111,7 +111,7 @@ CREATE UNIQUE INDEX IF NOT EXISTS idx_org_graph_edges_dedupe_active
 æ–°å¢ž system agent æ¨¡æ¿ `system/templates/orggraph-planning/`ï¼ˆ`config.json.type` å– `meta-bootstrap`ï¼Œä¸Žä¸šåŠ¡è§’è‰²åŒºåˆ†ï¼‰ã€‚å·¥ä½œæµï¼š
 1. **è¯»è¾“å…¥**ï¼šå…¬å¸ `id` / `name` / **`goal`ï¼ˆcompany-goalï¼‰** / `description`ï¼ˆç”± Â§4.4 çš„é¦–è½®æ¶ˆæ¯å¸¦å…¥ï¼‰ã€‚
-   `company-goal` æ˜¯ã€Œè¿™å®¶å…¬å¸è¦è¾¾æˆä»€ä¹ˆã€ï¼Œ`description` æ˜¯ã€Œè¿™å®¶å…¬å¸æ˜¯å¹²ä»€ä¹ˆçš„ã€â€”â€”å‰è€…æ˜¯è§„åˆ’æµæ°´çº¿çš„ä¸»ä¾æ®ï¼ŒåŽè€…æ˜¯èƒŒæ™¯ã€‚è§ [27-NAMING](./27-naming-conventions.md) Â§å››ã€‚
+   `company-goal` æ˜¯ã€Œè¿™å®¶å…¬å¸è¦è¾¾æˆä»€ä¹ˆã€ï¼Œ`description` æ˜¯ã€Œè¿™å®¶å…¬å¸æ˜¯å¹²ä»€ä¹ˆçš„ã€â€”â€”å‰è€…æ˜¯è§„åˆ’æµæ°´çº¿çš„ä¸»ä¾æ®ï¼ŒåŽè€…æ˜¯èƒŒæ™¯ã€‚è§ [27-NAMING](../../todo/system-design/27-naming-conventions.md) Â§å››ã€‚
 2. **è¯»å€™é€‰éª¨æž¶**ï¼š`ls system/org-graph-templates/`ï¼Œé€ä¸ªè¯»å–ï¼Œç†è§£å„è‡ªçš„ `whenToUse`ã€‚
 3. **è¯»å¯æ‹›è§’è‰²**ï¼š`node bin/lemon.js company templates`ï¼ˆå¤ç”¨çŽ°æˆ CLIï¼Œ`listTemplates()` è¿”å›ž id/name/type/descriptionï¼‰ã€‚
 4. **è§„åˆ’**ï¼šç»¼åˆä¸‰è€…ï¼Œäº§å‡ºä¸€å¼  workflow â€”â€” èŠ‚ç‚¹åˆ—è¡¨ + æ‰§è¡Œæµè¾¹ã€‚å…è®¸è£å‰ªã€æ›¿æ¢ã€ç»„åˆå¤šä¸ªæ¨¡æ¿ï¼Œä¹Ÿå…è®¸åˆ¤æ–éœ€è¦ä¸€ä¸ªæ¨¡æ¿åº“é‡Œæ²¡æœ‰çš„æ–°è§’è‰²ã€‚
@@ -119,7 +119,7 @@ CREATE UNIQUE INDEX IF NOT EXISTS idx_org_graph_edges_dedupe_active
 6. **æäº¤å›¾**ï¼šè°ƒç”¨ Â§4.3 çš„æ•´ä½“å†™å…¥ APIï¼Œå›¾é€šè¿‡ Â§3.3 æ ¡éªŒåŽè½åº“ã€‚
 7. **æ‰§è¡Œæ‹›è˜**ï¼šæŒ‰æ‹“æ‰‘åºå¯¹æ¯ä¸ªèŠ‚ç‚¹è°ƒ `hire()`ã€‚
    - **æ¨¡æ¿å·²å˜åœ¨** â†’ èµ° P1 è™šæ‹Ÿå¼•ç”¨å¯»å€ï¼Œä¸æ‹·è´ `agent.md`ã€‚
-   - **æ¨¡æ¿ä¸å˜åœ¨** â†’ **ä»Ž `system/templates/base/` å…ƒ agent ç»§æ‰¿å‡ºéª¨æž¶**ï¼ˆè‡ªåŠ¨å¸¦ä¸Š base çš„ `RESEARCH â†’ PLAN â†’ EXECUTE â†’ VERIFY` å››æ®µå¼ç”Ÿå‘½å‘¨æœŸï¼‰ï¼Œå†ç”± `agent-creator` å¡«å……è¯¥è§’è‰²ç‰¹æœ‰çš„å®šä¹‰ã€‚è¿™æ˜¯ [27-E2E](./27-e2e-task-execution-flow.md) Â§å…«bisã€Œæ‰€æœ‰ node agent ç”±å…ƒ agent ç»§æ‰¿ç”Ÿæˆã€åœ¨ P2 çš„è½åœ°ç‚¹â€”â€”**ä¸æ˜¯**ç›´æŽ¥èµ°çŽ°æœ‰çš„ `needs_training` å…¨é‡åŸ¹å…»åˆ†æ”¯ã€‚
+   - **æ¨¡æ¿ä¸å˜åœ¨** â†’ **ä»Ž `system/templates/base/` å…ƒ agent ç»§æ‰¿å‡ºéª¨æž¶**ï¼ˆè‡ªåŠ¨å¸¦ä¸Š base çš„ `RESEARCH â†’ PLAN â†’ EXECUTE â†’ VERIFY` å››æ®µå¼ç”Ÿå‘½å‘¨æœŸï¼‰ï¼Œå†ç”± `agent-creator` å¡«å……è¯¥è§’è‰²ç‰¹æœ‰çš„å®šä¹‰ã€‚è¿™æ˜¯ [27-E2E](../../todo/system-design/27-e2e-task-execution-flow.md) Â§å…«bisã€Œæ‰€æœ‰ node agent ç”±å…ƒ agent ç»§æ‰¿ç”Ÿæˆã€åœ¨ P2 çš„è½åœ°ç‚¹â€”â€”**ä¸æ˜¯**ç›´æŽ¥èµ°çŽ°æœ‰çš„ `needs_training` å…¨é‡åŸ¹å…»åˆ†æ”¯ã€‚
    - **æ–°å»º agent çš„ `scope`**ï¼šä¸€å¾‹é»˜è®¤ `scope='company'`ã€`owner_company_id` ä¸ºæœ¬å…¬å¸ï¼ˆ27 å·æ–‡æ¡£ Â§3.2ï¼‰ã€‚å‡çº§ä¸º `public` èµ°æ—¢æœ‰çš„ benchmark â‰¥95 é—¨æ§›ï¼Œä¸åœ¨ P2 èŒƒå›´å†…ã€‚
    - **è®ç»ƒæ˜¯å¯é€‰çš„åŽç½®æ¥éª¤**ï¼šå»ºæˆåŽå¯æ‰‹åŠ¨è§¦å‘ `innovator` åŸ¹å…»ï¼Œä¹Ÿå¯æŒ‰å…¬å¸éœ€æ±‚é…ç½®ä¸ºè‡ªåŠ¨è§¦å‘ã€‚P2 åªä¿è¯ã€Œè§’è‰²èƒ½è¢«å»ºå‡ºæ¥ä¸”å¸¦å››æ®µå¼éª¨æž¶ã€ï¼Œä¸å¼ºåˆ¶ç‰è®ç»ƒå®Œæˆã€‚
 8. **æ”¶å°¾**ï¼šå…³é—è‡ªå·±çš„å¿ƒè·³è½¬å…¥ä¼‘çœ ã€‚åŽç»å¢žé‡è°ƒæ•´å½’ HRã€‚
@@ -183,7 +183,7 @@ if (bootstrap.status === &#39;hired_from_template&#39;) {
 ### 4.5 å‰ç«¯
-**ä¸è‡ªå·±å†™æ¸²æŸ“é€»è¾‘** â€”â€” org graph ä¸Ž work graph åŒæž„ï¼Œç›´æŽ¥å¤ç”¨ [27-P3/P4](./27-p3-p4-work-graph-console.md) T3 çš„ç”»å¸ƒç»„ä»¶ï¼ˆå…¶æœ¬èº«åˆæ˜¯æ‰©å±•è‡ªæ—¢æœ‰çš„ `web/src/components/devloop/UnitsDAG.vue`ï¼Œå·²å®žçŽ° SVG + Kahn åˆ†æ³¢å¸ƒå±€ + çŠ¶æ€ç€è‰² + ç‚¹å‡»ä¸‹é’»ï¼‰ã€‚
+**ä¸è‡ªå·±å†™æ¸²æŸ“é€»è¾‘** â€”â€” org graph ä¸Ž work graph åŒæž„ï¼Œç›´æŽ¥å¤ç”¨ [27-P3/P4](../../todo/system-design/27-p3-p4-work-graph-console.md) T3 çš„ç”»å¸ƒç»„ä»¶ï¼ˆå…¶æœ¬èº«åˆæ˜¯æ‰©å±•è‡ªæ—¢æœ‰çš„ `web/src/components/devloop/UnitsDAG.vue`ï¼Œå·²å®žçŽ° SVG + Kahn åˆ†æ³¢å¸ƒå±€ + çŠ¶æ€ç€è‰² + ç‚¹å‡»ä¸‹é’»ï¼‰ã€‚
 è¿™ä¹Ÿæ„å‘³ç€ **P2 çš„å‰ç«¯å·¥ä½œä¾èµ– P3 çš„ç”»å¸ƒç»„ä»¶å…ˆåšå‡ºæ¥**ã€‚è‹¥æƒ³è®© P2 ç‹¬ç«‹ä¸Šçº¿ï¼Œå¯ä»¥å…ˆåœ¨ Company Dashboard ç”¨ä¸€ä¸ªçº¯æ–‡æœ¬çš„æ‹“æ‰‘åºåˆ—è¡¨å ä½ï¼ˆ`org-planner â†’ org-coder â†’ org-validator`ï¼‰ï¼Œç‰ P3 ç”»å¸ƒå°±ç»ªå†æ›¿æ¢ã€‚
@@ -209,9 +209,9 @@ if (bootstrap.status === &#39;hired_from_template&#39;) {
 ```
 åŒç†æä¾› `content.json`ï¼ˆ`org-planner â†’ org-writer â†’ org-validator`ï¼‰ã€`ops.json`ã€‚ä¸‰å¼ å›¾**é¦–å°¾èŠ‚ç‚¹åŒå**ï¼Œ
-åªæœ‰ä¸æ®µæ‰§è¡ŒèŠ‚ç‚¹ä¸åŒâ€”â€”å‘½åè½´æ˜¯èŠ‚ç‚¹æ‰€åœ¨å›¾çš„å±‚çº§ï¼Œä¸æ˜¯ä¸šåŠ¡é¢†åŸŸï¼ˆ[27-NAMING](./27-naming-conventions.md) Â§3.1ï¼‰ã€‚
+åªæœ‰ä¸æ®µæ‰§è¡ŒèŠ‚ç‚¹ä¸åŒâ€”â€”å‘½åè½´æ˜¯èŠ‚ç‚¹æ‰€åœ¨å›¾çš„å±‚çº§ï¼Œä¸æ˜¯ä¸šåŠ¡é¢†åŸŸï¼ˆ[27-NAMING](../../todo/system-design/27-naming-conventions.md) Â§3.1ï¼‰ã€‚
-`dev.json` é‚£ä¸¤æ¡ `fail` è¾¹æ˜¯ P3 çš„ `fail_reason` ç»†åˆ†è·¯ç”±ï¼ˆ[27-P3/P4](./27-p3-p4-work-graph-console.md) Â§å››.D.2.2ï¼‰ï¼š
+`dev.json` é‚£ä¸¤æ¡ `fail` è¾¹æ˜¯ P3 çš„ `fail_reason` ç»†åˆ†è·¯ç”±ï¼ˆ[27-P3/P4](../../todo/system-design/27-p3-p4-work-graph-console.md) Â§å››.D.2.2ï¼‰ï¼š
 å¸¦ `failReason` çš„è¾¹æŒ‰å½’å› ç»“æžœç²¾ç¡®åŒ¹é…ï¼Œä¸å¸¦ `failReason` çš„é‚£æ¡æ˜¯**å…œåº•è¾¹**ï¼Œ
 ä»»ä½•æœ‰ `fail` å‡ºè¾¹çš„èŠ‚ç‚¹éƒ½å¿…é¡»ç•™ä¸€æ¡ï¼Œå¦åˆ™å½’å› äº§å‡ºå›¾ä¸Šæ²¡æœ‰çš„å–å€¼æ—¶ä¼šè½åˆ°æ»è·¯ã€‚
 `content.json` / `ops.json` ç›®å‰åªæœ‰å…œåº•è¾¹ã€‚
@@ -220,7 +220,7 @@ if (bootstrap.status === &#39;hired_from_template&#39;) {
 - **æ˜¯èµ·ç‚¹é›†åˆï¼Œä¸æ˜¯ç©·ä¸¾æžšä¸¾** â€”â€” åŠ ä¸€ç§å…¬å¸ç±»åž‹åªéœ€åŠ ä¸€ä¸ª JSON æ–‡ä»¶ï¼Œä¸æ”¹ä»»ä½•ä»£ç ã€‚`orggraph-planning` è¯»å…¨éƒ¨æ¨¡æ¿åŽè‡ªè¡Œé€‰åž‹/è£å‰ª/ç»„åˆï¼Œä¸æ˜¯ä»£ç é‡Œçš„ `switch(type)`ã€‚
 - **`nodes` é‡Œçš„è§’è‰²åæ˜¯å»ºè®®**ï¼Œ`orggraph-planning` å¿…é¡»å¯¹ç…§ `company templates` æ ¸å®žæ˜¯å¦çœŸæœ‰å¯æ‹›æ¨¡æ¿ï¼›æ²¡æœ‰åˆ™èµ° `needs_training` åŸ¹å…»åˆ†æ”¯ã€‚
-- **æ¨¡æ¿é‡Œçš„è§’è‰²åå¿…é¡»éµå¾ª [27-NAMING](./27-naming-conventions.md) Â§3.1 çš„ `org-{èŒèƒ½}` è§„åˆ™**ï¼Œä¸å…è®¸è£¸ç”¨ `planner` / `validator`ï¼Œä¹Ÿä¸å†æŒ‰ä¸šåŠ¡é¢†åŸŸèµ· `code-` / `content-` è¿™ç±»å‰ç¼€ï¼ˆv0.2 çš„å†™æ³•ï¼Œå·²ä½œåºŸï¼‰ã€‚
+- **æ¨¡æ¿é‡Œçš„è§’è‰²åå¿…é¡»éµå¾ª [27-NAMING](../../todo/system-design/27-naming-conventions.md) Â§3.1 çš„ `org-{èŒèƒ½}` è§„åˆ™**ï¼Œä¸å…è®¸è£¸ç”¨ `planner` / `validator`ï¼Œä¹Ÿä¸å†æŒ‰ä¸šåŠ¡é¢†åŸŸèµ· `code-` / `content-` è¿™ç±»å‰ç¼€ï¼ˆv0.2 çš„å†™æ³•ï¼Œå·²ä½œåºŸï¼‰ã€‚
 - âš ï¸ **é¿å¼€å‘½åå†²çª id**ï¼š`agent-creator` / `digester` / `evolver` / `evolver-youtube-crawler` / `hunter` / `innovator` è¿™ 6 ä¸ª id åœ¨ `system/agents/` ä¸Ž `system/templates/` ä¸‹åŒæ—¶å˜åœ¨ä¸”å†…å®¹å¯èƒ½ä¸åŒæ¥ï¼ˆ27 å·æ–‡æ¡£ Â§ä¸ƒï¼‰ï¼Œæ¨¡æ¿é‡Œä¸è¦å¼•ç”¨å®ƒä»¬ã€‚
 ---
@@ -292,7 +292,7 @@ P0 çš„ `seedCompanyAgents()` å·²æŠŠæ‰€æœ‰å˜é‡å…¬å¸çš„è§’è‰²å›žå¡«æˆ `org_gra
 ## å…«ã€é£Žé™© / Open Questions
-1. ~~**å•ä¸€å…¥å£çº¦æŸæ˜¯å¦è¿‡ä¸¥**~~ âœ… **å·²å®šæ¡ˆ**ï¼ˆ[27-REQ](./27-requirement.md) R-13.4ï¼‰ï¼šå¼ºåˆ¶å•å…¥å£ã€‚ä¿ç•™åŽŸå§‹è®ºè¯ï¼šå¦‚æžœå°†æ¥å‡ºçŽ°"ä¸¤ç±»ä»»åŠ¡ä»Žä¸åŒèŠ‚ç‚¹è¿›å…¥åŒä¸€å®¶å…¬å¸"çš„éœ€æ±‚ï¼ˆå¦‚ bugfix ç›´æŽ¥ä»Ž coder è¿›å…¥ï¼‰ï¼Œéœ€æ”¾å®½ä¸º"å…è®¸å¤šå…¥å£ + ä»»åŠ¡æºå¸¦æŒ‡å®šå…¥å£"ï¼Œå±Šæ—¶ä»»åŠ¡å…¥å£è¦å¤šå¸¦ä¸€ä¸ªå‚æ•°ã€‚
+1. ~~**å•ä¸€å…¥å£çº¦æŸæ˜¯å¦è¿‡ä¸¥**~~ âœ… **å·²å®šæ¡ˆ**ï¼ˆ[27-REQ](../../todo/system-design/27-requirement.md) R-13.4ï¼‰ï¼šå¼ºåˆ¶å•å…¥å£ã€‚ä¿ç•™åŽŸå§‹è®ºè¯ï¼šå¦‚æžœå°†æ¥å‡ºçŽ°"ä¸¤ç±»ä»»åŠ¡ä»Žä¸åŒèŠ‚ç‚¹è¿›å…¥åŒä¸€å®¶å…¬å¸"çš„éœ€æ±‚ï¼ˆå¦‚ bugfix ç›´æŽ¥ä»Ž coder è¿›å…¥ï¼‰ï¼Œéœ€æ”¾å®½ä¸º"å…è®¸å¤šå…¥å£ + ä»»åŠ¡æºå¸¦æŒ‡å®šå…¥å£"ï¼Œå±Šæ—¶ä»»åŠ¡å…¥å£è¦å¤šå¸¦ä¸€ä¸ªå‚æ•°ã€‚
 2. **`orggraph-planning` çš„è§„åˆ’è´¨é‡æ²¡æœ‰ç¡¬æ ¡éªŒ**ï¼šÂ§3.3 åªä¿è¯å›¾**ç»“æž„åˆæ³•**ï¼Œä¸ä¿è¯å®ƒ**é€‚åˆè¿™å®¶å…¬å¸**ã€‚ç¼“è§£ï¼š`workspace/orggraph-plan.md` ç•™ä¸‹å†³ç–è®°å½•ä¾›äººå·¥å¤æ ¸ï¼›å‘çŽ°ä¸åˆç†æ—¶èµ° Â§4.3 çš„ PATCH å¢žé‡ä¿®æ£ã€‚
 3. **ä¸€æ¬¡å»ºå…¬å¸å¤šä¸€è½® LLM å¯¹è¯**ï¼šâœ… å®žæµ‹çº¦ 30 ç§’ï¼ˆ`p2-verify` éªŒè¯å…¬å¸ï¼Œ4 èŠ‚ç‚¹ 5 è¾¹ + 4 ä¸ªè§’è‰²æ‹›è˜ï¼‰ã€‚`POST /create` ä¿æŒåŒæ¥è¿”å›žï¼ˆfire-and-forgetï¼‰ã€‚âš ï¸ å‰ç«¯ç©ºæ€æ–‡æ¡ˆå·²æåŠ"å˜é‡å…¬å¸æˆ–è§„åˆ’ä»åœ¨è¿›è¡Œä¸"ï¼Œä½†**æ²¡æœ‰çœŸæ£åŒºåˆ†è¿™ä¸¤ç§çŠ¶æ€**â€”â€”è¦åŒºåˆ†éœ€è¦è½®è¯¢ `/org-graph` æˆ–ç»™å…¬å¸åŠ ä¸€ä¸ª `orgGraphStatus` å—æ®µã€‚å½“å‰æ˜¯åˆ»æ„çš„ç®€åŒ–ã€‚
 4. **6 ä¸ªå‘½åå†²çª id**ï¼ˆ27 å·æ–‡æ¡£ Â§ä¸ƒï¼‰ï¼šæœ¬æ–‡æ¡£ Â§4.6 å·²è¦æ±‚æ¨¡æ¿é¿å¼€å®ƒä»¬ï¼Œä½†å¦‚æžœ `orggraph-planning` è‡ªä¸»åˆ¤æ–éœ€è¦å…¶ä¸æŸä¸ªè§’è‰²ï¼Œä»ä¼šæ’žä¸Š"è¯¥è¯»å“ªä»½ `agent.md`"çš„æ§ä¹‰ã€‚å»ºè®®åœ¨ P2 ä¸Šçº¿å‰æŠŠè¿™ä¸ªäº§å“å†³ç–åšæŽ‰ã€‚
@@ -304,4 +304,4 @@ P0 çš„ `seedCompanyAgents()` å·²æŠŠæ‰€æœ‰å˜é‡å…¬å¸çš„è§’è‰²å›žå¡«æˆ `org_gra
 - **P0/P1**ï¼šå‡å·²å®žçŽ°ã€‚P2 å”¯ä¸€éœ€è¦åŠ¨ P1 ä»£ç çš„åœ°æ–¹æ˜¯ DROP å®ƒå»ºçš„å…¨é‡å”¯ä¸€ç´¢å¼•ï¼ˆT1ï¼‰ã€‚
 - **P3/P4**ï¼šP2 äº§å‡ºå›¾ï¼ŒP3/P4 æ‰§è¡Œå›¾ã€‚**ä¸¤è€…å…±ç”¨åŒä¸€å¥— schema å½¢æ€ã€æ‰§è¡Œå¼•æ“Žå’Œç”»å¸ƒç»„ä»¶** â€”â€” è¿™æ˜¯ v0.4 æ–°æ¨¡åž‹æœ€å¤§çš„æ”¶ç›Šã€‚P2 ä¸å«ä»»ä½•æ‰§è¡Œé€»è¾‘ã€‚
-- **ç«¯åˆ°ç«¯**ï¼šæœ¬æ–‡æ¡£åœ¨æ•´æ¡é“¾è·¯é‡Œçš„ä½ç½®è§ [27-E2E](./27-e2e-task-execution-flow.md) Â§ä¸‰ é˜¶æ®µ 2ï¼Œå…·ä½“è·‘ä¸€éçš„æ ·åè§ [27-EXAMPLE](./27-example-dev-company-walkthrough.md) é˜¶æ®µ 2ã€‚
+- **ç«¯åˆ°ç«¯**ï¼šæœ¬æ–‡æ¡£åœ¨æ•´æ¡é“¾è·¯é‡Œçš„ä½ç½®è§ [27-E2E](../../todo/system-design/27-e2e-task-execution-flow.md) Â§ä¸‰ é˜¶æ®µ 2ï¼Œå…·ä½“è·‘ä¸€éçš„æ ·åè§ [27-EXAMPLE](../../todo/system-design/27-example-dev-company-walkthrough.md) é˜¶æ®µ 2ã€‚
@@ -3,7 +3,7 @@
 > **æ‰€å±ž**: [27 Graph Agent æž¶æž„](./27-graph-agent-architecture.md) çš„è·¨é˜¶æ®µæ€»è§ˆæ–‡æ¡£ï¼Œä¸²èµ· P2ï¼ˆOrg Graphï¼‰ã€P3/P4ï¼ˆWork Graph æ‰§è¡Œï¼‰ã€P5ï¼ˆè‡ªæˆ‘è¿›åŒ–ï¼‰ã€‚
 > **ç‰ˆæœ¬**: v0.1
 > **æ—¥æœŸ**: 2026-08-15
-> **å‰ç½®**: [27-P2 Org Graph è½åœ°](./27-p2-org-graph.md)ã€[27-P3/P4 Work Graph æ‰§è¡ŒæŽ§åˆ¶å°](./27-p3-p4-work-graph-console.md)ã€**ä»¥åŠæœ¬æ–‡æ¡£æœ€é‡è¦çš„å‚è€ƒæº** `docs/prd/newfunction/_spec/`ï¼ˆDevLoop çš„å®Œæ•´ MVCP è§„æ ¼ï¼Œå°¤å…¶ `loops-overview.md` / `loops-l1.md` / `loops-l2.md` / `loops-l3.md` / `sdd-process.md` / `plan-cost-concurrency.md`ï¼‰ã€‚
+> **å‰ç½®**: [27-P2 Org Graph è½åœ°](../../done/system-design/27-p2-org-graph.md)ã€[27-P3/P4 Work Graph æ‰§è¡ŒæŽ§åˆ¶å°](./27-p3-p4-work-graph-console.md)ã€**ä»¥åŠæœ¬æ–‡æ¡£æœ€é‡è¦çš„å‚è€ƒæº** `docs/prd/newfunction/_spec/`ï¼ˆDevLoop çš„å®Œæ•´ MVCP è§„æ ¼ï¼Œå°¤å…¶ `loops-overview.md` / `loops-l1.md` / `loops-l2.md` / `loops-l3.md` / `sdd-process.md` / `plan-cost-concurrency.md`ï¼‰ã€‚
 > **éœ€æ±‚æºå¤´**: [27-REQ åŽŸå§‹éœ€æ±‚](./27-requirement.md) â€”â€” æœ¬æ–‡æ¡£æ˜¯å¯¹é‚£äº›åŽŸè¯çš„ç»“æž„åŒ–è½¬è¿°ï¼ŒåŽŸæ–‡ä»¥é‚£ä»½ä¸ºå‡†ã€‚
 > **é…å¥—**: [27-EXAMPLE å‚è€ƒåœºæ™¯èµ°æŸ¥](./27-example-dev-company-walkthrough.md) â€”â€” æœ¬æ–‡æ¡£è®²æœºåˆ¶ï¼Œé‚£ä»½æ–‡æ¡£æŠŠæœºåˆ¶åœ¨ä¸€å®¶å…·ä½“å…¬å¸ä¸Šè·‘ä¸€éæ•°ã€‚ä¸¤ä»½å¯¹ç…§ç€è¯»ã€‚
@@ -67,7 +67,7 @@
 ### é˜¶æ®µ 2 Â· orggraph-planning æ ¹æ®æè¿°ç”ŸæˆåŸºç¡€ org graph
-**çŠ¶æ€**ï¼šðŸ“ å·²è®¾è®¡æœªå®žçŽ°ï¼ˆ[27-P2](./27-p2-org-graph.md) Â§4.8/Â§4.9/Â§4.10ï¼‰
+**çŠ¶æ€**ï¼šðŸ“ å·²è®¾è®¡æœªå®žçŽ°ï¼ˆ[27-P2](../../done/system-design/27-p2-org-graph.md) Â§4.8/Â§4.9/Â§4.10ï¼‰
 P2 å·²ç»è®¾è®¡äº†ï¼š`system/org-graph-templates/{dev,content,ops}.json` æ¨¡æ¿åº“ + `orggraph-planning` agent + åˆ›å»ºæ—¶è‡ªåŠ¨æ‹›è˜å¹¶ fire-and-forget è§¦å‘é¦–è½®å¯¹è¯ã€‚
@@ -177,7 +177,7 @@ P2 å·²ç»è®¾è®¡äº†ï¼š`system/org-graph-templates/{dev,content,ops}.json` æ¨¡æ¿å
 > | **Org Graph** | orggraph-planning | å»ºå…¬å¸æ—¶ï¼Œä¸€æ¬¡ | org node agent | æ‰§è¡Œæµï¼ˆsuccess/fail æ¡ä»¶ï¼‰ |
 > | **Work Graph** | workgraph-planning agent | æ¯ä¸ª org node æŽ¥åˆ°ä»»åŠ¡æ—¶ | system agent å¼•ç”¨ | æ‰§è¡Œæµï¼ˆsuccess/fail æ¡ä»¶ï¼‰ |
 >
-> **è¿™æ„å‘³ç€ [27-P2](./27-p2-org-graph.md) çŽ°åœ¨çš„ org graph æ¨¡åž‹éœ€è¦æ”¹**ï¼šå®ƒæŠŠè¾¹å®šä¹‰æˆ `reports_to` / `collaborates_with`ï¼ˆé™æ€æ±‡æŠ¥ç»“æž„ï¼‰ï¼Œè€Œå®žé™…éœ€è¦çš„æ˜¯**å¸¦ success/fail æ¡ä»¶çš„æ‰§è¡Œæµè¾¹**ï¼Œä¸Ž work graph çš„è¾¹åŒæž„ã€‚æ±‡æŠ¥å…³ç³»å¦‚æžœè¿˜éœ€è¦ï¼Œåº”é™çº§ä¸ºèŠ‚ç‚¹ä¸Šçš„å…ƒæ•°æ®å±žæ€§ï¼Œè€Œä¸æ˜¯ org graph çš„ä¸»å¹²è¯ä¹‰ã€‚
+> **è¿™æ„å‘³ç€ [27-P2](../../done/system-design/27-p2-org-graph.md) çŽ°åœ¨çš„ org graph æ¨¡åž‹éœ€è¦æ”¹**ï¼šå®ƒæŠŠè¾¹å®šä¹‰æˆ `reports_to` / `collaborates_with`ï¼ˆé™æ€æ±‡æŠ¥ç»“æž„ï¼‰ï¼Œè€Œå®žé™…éœ€è¦çš„æ˜¯**å¸¦ success/fail æ¡ä»¶çš„æ‰§è¡Œæµè¾¹**ï¼Œä¸Ž work graph çš„è¾¹åŒæž„ã€‚æ±‡æŠ¥å…³ç³»å¦‚æžœè¿˜éœ€è¦ï¼Œåº”é™çº§ä¸ºèŠ‚ç‚¹ä¸Šçš„å…ƒæ•°æ®å±žæ€§ï¼Œè€Œä¸æ˜¯ org graph çš„ä¸»å¹²è¯ä¹‰ã€‚
 >
 > **å¥½å¤„**ï¼šä¸€å¥— schemaã€ä¸€å¥—æ‰§è¡Œå¼•æ“Žã€ä¸€å¥—æŽ§åˆ¶å° UIï¼Œåœ¨ä¸¤ä¸ªå±‚çº§ä¸ŠåŽŸæ ·å¤ç”¨ï¼›ä¸‰å±‚ä¸‹é’»ï¼ˆorg graph â†’ work graph â†’ å¹¶è¡Œåå›¾ï¼‰å¤©ç„¶é€’å½’ï¼›"å¯åŠ¨/ä¸‹ä¸€æ¥/æš‚åœ/åœæ¢/é‡è¯•"äº”ä¸ªæ“ä½œåœ¨æ¯ä¸€å±‚è¯ä¹‰å®Œå…¨ä¸€è‡´ã€‚
 >
@@ -356,7 +356,7 @@ DevLoop å°±è¿™ä¸ªé—®é¢˜åšè¿‡æ˜¾å¼å†³ç–ï¼ˆ`loops-l2.md` æ–¹æ¡ˆ A/B/Cï¼‰ï¼Œé€‰æ
 **æ‰€æœ‰ org graph / work graph çš„ node agentï¼Œéƒ½ç”±ä¸€ä¸ªå…ƒ agent æž¶æž„ç»§æ‰¿ç”Ÿæˆï¼Œç»Ÿä¸€æ˜¯ã€Œå…¨å±€é€šç”¨æœ¬ä½“ + å…¬å¸/è§’è‰²è®°å¿†åˆ†åŒºã€çš„ç»“æž„ã€‚**
-è¿™æ¡å®šæ¡ˆå–ä»£äº† v0.1 Â§å›› é‡Œ"ä¸‰ä¸ªéªŒæ”¶ agent è¦ä¸è¦æŒ‰çˆ¶èŠ‚ç‚¹ç‰¹åŒ–"è¿™ä¸ªé—®é¢˜â€”â€”ç”æ¡ˆæ˜¯**ä¸ç‰¹åŒ–**ï¼šä¸å˜åœ¨ `goal-benchmark` / `test-planner-benchmark` å„è‡ªç‹¬ç«‹çš„ agentï¼Œåªæœ‰é€šç”¨çš„ benchmark è®¾è®¡èƒ½åŠ›ï¼Œé è®°å¿†åˆ†åŒºåŒºåˆ†å®ƒåœ¨ä¸åŒ org node / ä¸åŒå…¬å¸ä¸‹çš„ç»éªŒç§¯ç´¯ã€‚agent æ± ä¸éš org node æ•°é‡è†¨èƒ€ï¼Œä¹Ÿä¸Ž [27-P1](./27-p1-virtual-reference.md) è™šæ‹Ÿå¼•ç”¨å¯»å€çš„åˆè¡·ä¸€è‡´ï¼ˆåŒä¸€ä»½æœ¬ä½“ï¼Œå¤šå¤„å¼•ç”¨ï¼Œå„è‡ªç§æœ‰è¯å¢ƒï¼‰ã€‚
+è¿™æ¡å®šæ¡ˆå–ä»£äº† v0.1 Â§å›› é‡Œ"ä¸‰ä¸ªéªŒæ”¶ agent è¦ä¸è¦æŒ‰çˆ¶èŠ‚ç‚¹ç‰¹åŒ–"è¿™ä¸ªé—®é¢˜â€”â€”ç”æ¡ˆæ˜¯**ä¸ç‰¹åŒ–**ï¼šä¸å˜åœ¨ `goal-benchmark` / `test-planner-benchmark` å„è‡ªç‹¬ç«‹çš„ agentï¼Œåªæœ‰é€šç”¨çš„ benchmark è®¾è®¡èƒ½åŠ›ï¼Œé è®°å¿†åˆ†åŒºåŒºåˆ†å®ƒåœ¨ä¸åŒ org node / ä¸åŒå…¬å¸ä¸‹çš„ç»éªŒç§¯ç´¯ã€‚agent æ± ä¸éš org node æ•°é‡è†¨èƒ€ï¼Œä¹Ÿä¸Ž [27-P1](../../done/system-design/27-p1-virtual-reference.md) è™šæ‹Ÿå¼•ç”¨å¯»å€çš„åˆè¡·ä¸€è‡´ï¼ˆåŒä¸€ä»½æœ¬ä½“ï¼Œå¤šå¤„å¼•ç”¨ï¼Œå„è‡ªç§æœ‰è¯å¢ƒï¼‰ã€‚
 âœ… **å…ƒ agent åœ¨ä»“åº“é‡Œå·²ç»å˜åœ¨**ï¼š`system/templates/base/`ï¼ˆ"æ ‡å‡†åŸºåº§å‘˜å·¥ Base Agent"ï¼‰ã€‚å®ƒå·²ç»å¼ºåˆ¶äº†ä¸€å¥—å››æ®µå¼ç”Ÿå‘½å‘¨æœŸï¼š
@@ -376,9 +376,9 @@ RESEARCH â†’ PLAN â†’ EXECUTE â†’ VERIFY
 | # | æ–‡æ¡£ | åŽŸé”™è¯¯é™ˆè¿° | äº‹å®ž | ä¿®è®¢ç»“æžœ |
 |---|---|---|---|---|
-| 1 | [27-P2](./27-p2-org-graph.md) Â§ä¹ã€[27-P3/P4](./27-p3-p4-work-graph-console.md) Â§ä¹ | "P1 ç›®å‰ä»æ˜¯è®¾è®¡ç¨¿ï¼Œæœªå®žçŽ°ï¼Œ`graph-service.js` å°šä¸å˜åœ¨" | **P1 å·²å®žçŽ°å¹¶æäº¤**ï¼ˆcommit `226489d`ï¼‰ï¼Œ`server/services/graph-service.js` å·²å˜åœ¨ï¼Œé…å¥—æµ‹è¯• `graph-service.test.js` / `agent-manager-p1.test.js` å‡åœ¨ | **âœ… å·²æ”¹**ã€‚27-P2 æ–‡ä»¶å¤´ã€Œå‰ç½®ã€å·²å†™æ˜Žã€ŒP1 è™šæ‹Ÿå¼•ç”¨å¯»å€å·²å®žçŽ°ï¼ˆcommit `226489d`ï¼‰ã€ï¼›27-P3/P4 Â§ä¹ã€Œä¸Ž P1ã€æ¡å†™æ˜Žã€Œæ— ç›´æŽ¥ä¾èµ–ï¼Œå·²å®žçŽ°ï¼ˆcommit `226489d`ï¼‰ã€ |
+| 1 | [27-P2](../../done/system-design/27-p2-org-graph.md) Â§ä¹ã€[27-P3/P4](./27-p3-p4-work-graph-console.md) Â§ä¹ | "P1 ç›®å‰ä»æ˜¯è®¾è®¡ç¨¿ï¼Œæœªå®žçŽ°ï¼Œ`graph-service.js` å°šä¸å˜åœ¨" | **P1 å·²å®žçŽ°å¹¶æäº¤**ï¼ˆcommit `226489d`ï¼‰ï¼Œ`server/services/graph-service.js` å·²å˜åœ¨ï¼Œé…å¥—æµ‹è¯• `graph-service.test.js` / `agent-manager-p1.test.js` å‡åœ¨ | **âœ… å·²æ”¹**ã€‚27-P2 æ–‡ä»¶å¤´ã€Œå‰ç½®ã€å·²å†™æ˜Žã€ŒP1 è™šæ‹Ÿå¼•ç”¨å¯»å€å·²å®žçŽ°ï¼ˆcommit `226489d`ï¼‰ã€ï¼›27-P3/P4 Â§ä¹ã€Œä¸Ž P1ã€æ¡å†™æ˜Žã€Œæ— ç›´æŽ¥ä¾èµ–ï¼Œå·²å®žçŽ°ï¼ˆcommit `226489d`ï¼‰ã€ |
 | 2 | [27-P3/P4](./27-p3-p4-work-graph-console.md) Â§ä¸‰.1 | "`runProject` ç›®å‰ç›´æŽ¥ 501" | **å·²å®Œæ•´å®žçŽ°**ï¼ˆ`loop-controller.js:576`ï¼‰ï¼Œå« Kahn åˆ†æ³¢ã€L2 é—¸é—¨ã€Triager å››åˆ†æ”¯ã€é¢„ç®—ç†”æ– | **âœ… å·²æ”¹**ã€‚27-P3/P4 Â§ä¸‰.1 çŽ°ä¸ºã€Œ`runProject()`ï¼ˆè¡Œ 576ï¼Œ**å·²å®Œæ•´å®žçŽ°**â€¦ï¼‰ã€ï¼Œå¹¶è¿½åŠ äº†ã€Œæ³¢å†…å®žé™…æ˜¯ä¸²è¡Œã€çš„è¡¥å……è§‚å¯Ÿ |
-| 3 | [27-P2](./27-p2-org-graph.md) Â§4.1 | æè®®å»ºéƒ¨åˆ†å”¯ä¸€ç´¢å¼• `idx_org_graph_nodes_company_role_active`ï¼ˆå¸¦ `WHERE status='active'`ï¼‰ï¼Œä½†æ²¡è¯´è¦å…ˆ DROP æ—§ç´¢å¼• | **`graph-service.js` å·²ç»å»ºäº†å…¨é‡å”¯ä¸€ç´¢å¼• `idx_org_graph_nodes_company_role`**ï¼ˆæ—  WHEREï¼‰ï¼Œå¿…é¡»å…ˆ DROP | **âœ… å·²æ”¹ä¸”å·²è½åœ°ä»£ç **ã€‚27-P2 Â§4.1 çš„ SQL çŽ°ä»¥ `DROP INDEX IF EXISTS idx_org_graph_nodes_company_role;` å¼€å¤´ï¼›`graph-db.js:59-60` å·²å®žçŽ°è¿™æ¡ DROP + é‡å»º |
+| 3 | [27-P2](../../done/system-design/27-p2-org-graph.md) Â§4.1 | æè®®å»ºéƒ¨åˆ†å”¯ä¸€ç´¢å¼• `idx_org_graph_nodes_company_role_active`ï¼ˆå¸¦ `WHERE status='active'`ï¼‰ï¼Œä½†æ²¡è¯´è¦å…ˆ DROP æ—§ç´¢å¼• | **`graph-service.js` å·²ç»å»ºäº†å…¨é‡å”¯ä¸€ç´¢å¼• `idx_org_graph_nodes_company_role`**ï¼ˆæ—  WHEREï¼‰ï¼Œå¿…é¡»å…ˆ DROP | **âœ… å·²æ”¹ä¸”å·²è½åœ°ä»£ç **ã€‚27-P2 Â§4.1 çš„ SQL çŽ°ä»¥ `DROP INDEX IF EXISTS idx_org_graph_nodes_company_role;` å¼€å¤´ï¼›`graph-db.js:59-60` å·²å®žçŽ°è¿™æ¡ DROP + é‡å»º |
 | 4 | [27-P3/P4](./27-p3-p4-work-graph-console.md) Â§å››.B.2ã€Â§äº” T3 | æŠŠ"æ‰‹å†™åˆ†å±‚å¸ƒå±€ç®—æ³•ï¼Œä¸å¼•å…¥å›¾å½¢åº“"å½“ä½œ**æ–°**å·¥ä½œé‡ | `web/src/components/devloop/UnitsDAG.vue` **å·²å®žçŽ°** SVG + Kahn åˆ†æ³¢å¸ƒå±€ | **âœ… å·²æ”¹**ã€‚27-P3/P4 Â§ä¸‰.5 æ–°å¢žã€Œå‰ç«¯ DAG å·²å®žçŽ°ï¼Œæ‰©å±•è€Œéžé‡å†™ã€ä¸€èŠ‚ï¼›Â§å››.B.2 ä¸Ž Â§äº” T3 å‡æ”¹ä¸ºã€Œ**æ‰©å±• `UnitsDAG.vue`**ã€ï¼Œå¹¶æŠŠæ–°å¢žå·¥ä½œé‡æ”¶çª„åˆ°ã€Œsubgraph è§’æ ‡ + backward æ›²çº¿è·¯ç”± + å¾ªçŽ¯å¾½æ ‡ã€ä¸‰å— |
 ### æ¤å¤–å»ºè®®ï¼ˆå¤æ ¸ç»“è®ºï¼‰
@@ -33,7 +33,7 @@
 }
 ```
-**系统动作**（[27-P2](./27-p2-org-graph.md) §4.10）：
+**系统动作**（[27-P2](../../done/system-design/27-p2-org-graph.md) §4.10）：
 1. `companyService.create()` 建目录 + `company.json`（`agents: []`）
 2. 🔴 自动 `hire(id, 'orggraph-planning', {})`
@@ -48,7 +48,7 @@
 **它读三样东西**：
 1. 公司 description（上面那段）
-2. `system/org-graph-templates/*.json`（候选骨架，[27-P2](./27-p2-org-graph.md) §4.8）
+2. `system/org-graph-templates/*.json`（候选骨架，[27-P2](../../done/system-design/27-p2-org-graph.md) §4.8）
 3. `node bin/lemon.js company templates`（现实里能招到的角色，`listTemplates()` 返回 id/name/type/description）
 **它的判断**：description 里有"做一个工具""跑在本地""CLI 版本"→ 匹配 `dev.json`。
@@ -76,7 +76,7 @@
 `ceo` / `hr` 这类不参与任务执行的角色仍然可以被招聘进公司（存在于 `company.json.agents[]`），但**不出现在 org graph 这张 workflow 里**——org graph 只画"任务怎么流过这家公司"。
-**它提交图 + 执行招聘**（两步，[27-P2](./27-p2-org-graph.md) §4.1 第 6-7 步）：
+**它提交图 + 执行招聘**（两步，[27-P2](../../done/system-design/27-p2-org-graph.md) §4.1 第 6-7 步）：
 ```bash
 # 1. 整体提交图定义，过四项校验（无环 / 单一入口 / 可达性 / 回退边标注）后事务性落库
@@ -255,10 +255,10 @@ brd-planning → prd-planning → sdd-planning ─┬→ goal-test-data ──
 | 1 | `qa-judge` 没有程序化调用入口（判决无法驱动任何自动动作） | 5, 6, 7 | [27-E2E](./27-e2e-task-execution-flow.md) §11.3 |
 | 2 | org-validator 节点的验收执行能力（跑 test_script / 喂 test_data）未实现 | 5, 7 | §11.3 |
 | 3 | 「用户 → 公司」任务入口不存在 | 3 | §三 阶段 3 |
-| 4 | **P2 的 org graph 边模型需从 `reports_to` 改为 `success`/`fail` 执行流边** | 2, 4 | §五定案 + [27-P2](./27-p2-org-graph.md) v0.4 修正 |
+| 4 | **P2 的 org graph 边模型需从 `reports_to` 改为 `success`/`fail` 执行流边** | 2, 4 | §五定案 + [27-P2](../../done/system-design/27-p2-org-graph.md) v0.4 修正 |
 | 5 | fan-out 并行撞 CONVENTIONS §12 不变量 + SessionPool key 复用 | 5, 6 | §7.4 |
 | 6 | 任务级总预算不存在 | 7 | §7.1 |
 | 7 | L4-general 的 agent dream 流程不存在（跨公司批量蒸馏层缺失，单点接口已齐） | 7 之后（离线） | §8.1 |
-| 8 | orggraph-planning / workgraph-planning agent 均未实现 | 2, 5, 6 | [27-P2](./27-p2-org-graph.md) §4.9 |
+| 8 | orggraph-planning / workgraph-planning agent 均未实现 | 2, 5, 6 | [27-P2](../../done/system-design/27-p2-org-graph.md) §4.9 |
 第 4 项是**架构前提**，必须先改；改完之后做 1-3 项，这个场景就能在"串行、无 L4"的模式下端到端跑通一遍。
@@ -35,7 +35,7 @@
 |------|------|
 | **System Agent** | 全局唯一的可执行 Agent 实体。自带 prompt 定义、公共记忆（`memory.md`）、按公司分区的私有历史。是 24 号文档里"System Agent"与"Agent Template"两个概念的合并——不再区分"模板"和"实例"，只有"这个 agent，被谁调用过"。 |
 | **scope** | System Agent 的可见性：`public`（跨公司共享，记忆公共累积）或 `company`（私有，只属于 `owner_company_id` 指定的一家公司）。 |
-| **Org Graph** | **company 级别生成的 workflow**。由 `orggraph-planning` agent 在建公司时根据公司目标/描述生成一次。节点 = 对某个 org node agent 的引用；边 = **执行流**（`condition ∈ {success, fail}` + `edge_kind ∈ {forward, backward}`）。⚠️ v0.3 修正：本文档 v0.2 曾把它定义为"静态汇报结构、边是汇报/协作关系"，该建模已作废，详见 [27-P2 v0.4](./27-p2-org-graph.md) §一。 |
+| **Org Graph** | **company 级别生成的 workflow**。由 `orggraph-planning` agent 在建公司时根据公司目标/描述生成一次。节点 = 对某个 org node agent 的引用；边 = **执行流**（`condition ∈ {success, fail}` + `edge_kind ∈ {forward, backward}`）。⚠️ v0.3 修正：本文档 v0.2 曾把它定义为"静态汇报结构、边是汇报/协作关系"，该建模已作废，详见 [27-P2 v0.4](../../done/system-design/27-p2-org-graph.md) §一。 |
 | **Work Graph** | **org graph node 级别生成的 workflow**。某个 org node 收到任务后，现场调用 `workgraph-planning` agent 针对这一具体任务规划出。节点 = 对某个 system agent 的一次调用；边的语义与 Org Graph **完全同构**。执行完归档，不复用到下一个任务。 |
 | **两者关系** | Org Graph 与 Work Graph 是**同一种东西在不同层级上的递归**——同一套 schema 形态、同一个执行引擎、同一套控制台 UI，区别只在生成者、生成时机、节点指向。 |
 | **Loop-Validator** | 一个专职的 system agent，内置带硬编码熔断逻辑的 skill。所有"回退到历史节点"的边必须先经过它：备案 → 审计上次修复是否生效 → 判断修复方案是否被正确传递 → 循环数 > 3 强制终止。 |
@@ -101,7 +101,7 @@ system/agents/{agentId}/
 ### 3.3 Org Graph：company 级 workflow
-> ⚠️ **v0.3 修正**：本节 v0.2 的内容（"公司静态结构、边是汇报/协作关系、招聘时由 CEO 或 HR 维护"）已作废。完整设计见 [27-P2 v0.4](./27-p2-org-graph.md)。
+> ⚠️ **v0.3 修正**：本节 v0.2 的内容（"公司静态结构、边是汇报/协作关系、招聘时由 CEO 或 HR 维护"）已作废。完整设计见 [27-P2 v0.4](../../done/system-design/27-p2-org-graph.md)。
 - **节点**：对某个 org node agent 的引用（`org_graph_nodes`）。
 - **边**：**执行流**（`org_graph_edges`：`condition ∈ {success, fail}`、`edge_kind ∈ {forward, backward}`），与 `work_graph_edges` 同构。
@@ -225,8 +225,8 @@ CREATE TABLE work_graph_edges (
 | Phase | 目标 | 交付物 | 验收标准 |
 |-------|------|--------|----------|
 | **P0 地基** ✅ | 建表 + 现有数据迁移，不改变任何现有执行路径 | `system_agents`/`org_graph_*` 表；把现有 `system/agents/` + `system/templates/` 目录扫描导入为种子数据（`system_agents` 行，`scope` 按当前所属推断） | 迁移脚本跑完，`system_agents` 表行数与现有 agent+模板目录数一致（**实际行数与本文档最初估计不同，见第七节**）；现有 `company-service.js` 行为不变（并行只读验证，已确认零改动） |
-| **P1 虚拟引用** | 停止文件拷贝，改为引用 | 改造 `AgentManager.getAgentConfig()` + `PromptBuilder.build()` 支持 `(agentId, companyId)` 寻址；`company-service.hire()` 改为创建 org_graph 引用节点而非 `_copyTemplate()`。细化需求与设计见 [27-P1 虚拟引用寻址](./27-p1-virtual-reference.md) | 新雇佣的 agent 不再产生文件拷贝，调用时能正确拼装公共+私有上下文；旧公司（仍是拷贝模式）继续可跑，不强制迁移存量数据 |
-| **P2 Org Graph** | `company.json.agents[]` 迁移为图结构 | `org_graph_nodes`/`edges` 落地；HR/CEO 招聘走新表。细化需求与设计见 [27-P2 Org Graph 落地](./27-p2-org-graph.md) | 现有 Company Dashboard 前端能正确读出 org graph 并渲染（哪怕暂时按列表展示） |
+| **P1 虚拟引用** | 停止文件拷贝，改为引用 | 改造 `AgentManager.getAgentConfig()` + `PromptBuilder.build()` 支持 `(agentId, companyId)` 寻址；`company-service.hire()` 改为创建 org_graph 引用节点而非 `_copyTemplate()`。细化需求与设计见 [27-P1 虚拟引用寻址](../../done/system-design/27-p1-virtual-reference.md) | 新雇佣的 agent 不再产生文件拷贝，调用时能正确拼装公共+私有上下文；旧公司（仍是拷贝模式）继续可跑，不强制迁移存量数据 |
+| **P2 Org Graph** | `company.json.agents[]` 迁移为图结构 | `org_graph_nodes`/`edges` 落地；HR/CEO 招聘走新表。细化需求与设计见 [27-P2 Org Graph 落地](../../done/system-design/27-p2-org-graph.md) | 现有 Company Dashboard 前端能正确读出 org graph 并渲染（哪怕暂时按列表展示） |
 | **P3+P4 图执行引擎与执行控制台**（**两个 Phase 已合并**） | **一套引擎同时驱动 org graph 与 work graph**（R-15.4 引擎泛化），带回退与熔断 | 定义层 `work_graphs`/`work_graph_nodes`/`work_graph_edges` + **两层共用的运行时层** `graph_runs`/`graph_run_nodes`/`graph_run_loop_records`（共五张新表）；`graph-engine.js` 的 `advanceOne(runId)` 幂等推进原语 + 两种 node executor（`agent_call` / `subgraph`）；五个控制操作（启动 / 下一步 / 暂停 / 停止 / 重试）× 手动·自动两种模式；`GraphConsole.vue` 执行控制台页面；`workgraph-planning` agent + 用户→公司任务入口。细化需求与设计见 [27-P3/P4 Work Graph 执行控制台](./27-p3-p4-work-graph-console.md) **v0.3**，落地切成**五个可独立验收的阶段**（0 验收契约 / A 引擎地基 / B 回退熔断 / C 控制台 / D 规划闭环） | 见该文档 §六 的 17 条。**核心验收点是第 6 条**：一张 `graph_kind='org'` 的图与一张 work graph 用**同一套端点、同一条代码路径**跑通「手动逐步 / 自动跑完 / 暂停恢复 / 停止」；外加第 8 条「总是失败的节点第 4 次 `force_terminated` 收敛到 `blocked`」、第 17 条「一句自然语言任务两层跑到 `completed`」 |
 | ~~**P4 回退 + Loop-Validator**~~ | **已并入上一行**，不再单列 | 合并理由见 [27-P3/P4](./27-p3-p4-work-graph-console.md) §二：执行引擎一旦要支持「暂停/单步/停止/重试」这种可被外部随时打断的控制语义，「先做单向、再加回退」会让第一版状态机设计得过窄，P4 加回退时必然回来重改数据模型和主循环。**两处定案变更**：① 熔断改为**引擎无条件做的整数计数**（单边 `loop_count > 3` + run 级 `backward_count > 5` 双层硬顶），不依赖 LLM，`loop_validator` 节点由「强制」降级为**可选增强**；② 结构校验从四项扩到**五项**，新增 `fail-fallback-edge`（有 `fail` 出边的节点必须留一条 `fail_reason IS NULL` 兜底边），org / work 两层都加 | 同上 |
 | **P4 并行执行与产物索引**（**回收编号**） | fan-out 真并发 + 产物统一索引 | `advanceBatch` 批量拾取（手动模式退化为 `maxConcurrency=1`，行为与 P3 一致）；同 agent 多实例隔离（启用 `SessionPool.getKey` 已预留但从未使用的 `scope` 参数）；解除「一家公司一个 active root run」；`data/companies/{cid}/tasks/{taskId}/` 产物目录 + `files.json` 检索索引。细化设计见 [27-P4 并行执行与产物索引](./27-p4-parallel-and-artifacts.md) | 3 个并行分支同时 running 且总墙钟明显短于串行；部分失败时 fan-in 停等且可视化「在等谁」；`files.json` 可从节点行 rebuild |
@@ -263,7 +263,7 @@ P0 阶段的处理方式是**迁移脚本层面的临时保护**：`system_agent
 - **[27-E2E 端到端任务执行流程](./27-e2e-task-execution-flow.md)** — 跨阶段总览：从建公司 → 下达任务 → org graph 逐节点执行 → work graph 规划与循环 → 验收收敛。**建议先读这一份**，它指出了本文档体系与已有 DevLoop 实现之间的对应关系、三处语义冲突和若干空白。
 - **[27-NAMING 命名规范](./27-naming-conventions.md)** — 跨文档命名约定（`{作用域}-{职能}`）。新增 agent id / 表名 / 字段名前必读，避免与既有的 `benchmark` / `goal` 等命名撞车。
 - **[27-EXAMPLE 参考场景走查](./27-example-dev-company-walkthrough.md)** — 把上面那套架构在一家具体公司上跑一遍数（含各阶段真实形态的 JSON / 图 / 成本估算 / 断点清单）。实现时的靶子与端到端验收场景。
-- [27-P1 虚拟引用寻址](./27-p1-virtual-reference.md) — 已实现（commit `226489d`）
-- [27-P2 Org Graph 落地](./27-p2-org-graph.md) — 设计稿
+- [27-P1 虚拟引用寻址](../../done/system-design/27-p1-virtual-reference.md) — 已实现（commit `226489d`）
+- [27-P2 Org Graph 落地](../../done/system-design/27-p2-org-graph.md) — 设计稿
 - [27-P3/P4 Work Graph 执行控制台](./27-p3-p4-work-graph-console.md) — 已实现（commit `c3abf4a`）
 - [27-P4 并行执行与产物索引](./27-p4-parallel-and-artifacts.md) — 设计稿