SnowsonZ · Oct 10, 2026 · Oct 10, 2026
diff --git a/.github/pull_request_template.md b/.github/pull_request_template.md
@@ -1,5 +1,5 @@
 <!--
-可验证交付（docs/plans/verifiable-delivery.md）：通过与否只认机器输出。
+可验证交付（机制文档见 [delivery-harness](https://github.com/SnowsonZ/delivery-harness/blob/main/README.zh-CN.md)）：通过与否只认机器输出。
 - 不要手写「测试通过」「CI 通过」「已修复」：CI 的 harness job 会在 job summary 里生成风险等级与修复证据。
 - 修复缺陷的提交在说明末尾带 `Defect: <来源>-<序号>`（纯规格修复写 `Defect: <编号> doc`）。
 - 声明行为不变的重构：每个提交带 `Risk: R1`，由 risk.py 核对，不满足按 R2。

diff --git a/AGENTS.md b/AGENTS.md
@@ -8,7 +8,7 @@
 - 统一验证：`bin/verify`（lint、仓库卫生、Python 测试、macOS 上的 Swift 测试，与 CI 同口径）。修复提交带 `Defect: <编号>` trailer，通过与否只认 verify 与 CI 输出，不手写。约定与护栏见 docs/specs/delivery-harness.md；harness 引擎是独立项目 delivery-harness（装在 `.harness/engine/`，只能经 `upgrade` 整体替换），引擎的开发、待办与路线都在该仓库（本机 `../delivery-harness`）进行，本仓库只经升级 PR 接收新版本，升级流程（含迁移项处理）按 `../delivery-harness/docs/upgrading.md`。
 - 新环境准备由 Agent 自行完成，不交给人（均幂等，可重复执行）：`scratch/iterm-probe-venv` 缺失时按 README.zh-CN.md「快速上手」重建；`scratch/iterm-probe-venv/bin/python -m pip install -r requirements-dev.txt`；`bin/harness guard-git install`；最后 `bin/verify`，它会检查前两步。
 - Agent 工具的项目守卫需要人确认一次信任，Agent 不得代为授权（自授信任等于执行者给自己放行）：Agent 不得替执行方信任槽位或仓库里执行方能改的项目文件。`bin/dispatch` 派发 Pi 时用 `-na` 忽略槽位中的全部项目文件、`-e` 显式加载从 origin/main 导出的守卫，守卫来自经用户批准合并的 harness，不需要也不构成对槽位的信任（用户 2026-09-28 确认）。开工时自查，未信任就把命令交给用户：Zcode 用 `zcode hooks trust status --workspace <仓库根>` 查看，按其提示由用户 `grant`；Pi 由用户在仓库根启动 `pi` 执行 `/trust`；Claude Code 首次启动时由用户确认项目钩子；OpenCode 无需确认。未信任时 Agent 层守卫不生效，只剩 git 与服务端两层。
-- 派发与评审：执行方任务先写任务书（`docs/templates/task.md`，合并后）再用 `bin/dispatch run <任务书>` 派发，不在主目录运行执行方；设计方自己实现的工作也写任务书，与实现同一个 PR。R2 以上 PR 的独立评审用 `bin/dispatch review`（本机常驻 `--watch`）。现状与下一阶段见 docs/review/2026-09-29-harness-status.md。
+- 派发与评审：执行方任务先写任务书（`docs/templates/task.md`，合并后）再用 `bin/dispatch run <任务书>` 派发，不在主目录运行执行方；设计方自己实现的工作也写任务书，与实现同一个 PR。R2 以上 PR 的独立评审用 `bin/dispatch review`（本机常驻 `--watch`）。
 - Python 检查：`python3 -W error::ResourceWarning -m unittest discover -s tests -v`（ResourceWarning 按错误对待，与 CI 同口径）。
 - Zcode 辅助程序：`xcrun swiftc native/ZcodeFocus.swift -o build/zcode-focus`；无 UI 自检：`build/zcode-focus --self-test`。
 - 原生收件箱构建：`python3 scripts/build_inbox_app.py`；先退出正在运行的本项目 App，再覆盖可执行文件。

diff --git a/README.md b/README.md
@@ -108,7 +108,7 @@ python3 -W error::ResourceWarning -m unittest discover -s tests -v
 
 ## Documentation
 
-The complete documentation (specifications, design plans, dated research records, and reviews) is available in Chinese under [`docs/`](docs/). Start with [the unified inbox specification](docs/specs/unified-inbox.md); the latest cross-project health review is the [2026-09-21 project assessment](docs/review/2026-09-21-project-assessment.md). For the verifiable-delivery harness, start with [delivery-harness](https://github.com/SnowsonZ/delivery-harness/blob/main/README.zh-CN.md) (vision, sources, and how each design principle maps to a component). The underlying theory is the research report [Low-intervention, continuous, high-quality delivery with AI agents](docs/research/2026-09-23-agent-delivery-theory.md); the plan and decision log are in [docs/plans/verifiable-delivery.md](docs/plans/verifiable-delivery.md), the baseline in the [2026-09-25 harness baseline review](docs/review/2026-09-25-harness-baseline.md), and open items in the [backlog](docs/plans/backlog.md).
+The complete documentation (specifications, design plans, dated research records, and reviews) is available in Chinese under [`docs/`](docs/). Start with [the unified inbox specification](docs/specs/unified-inbox.md); the latest cross-project health review is the [2026-09-21 project assessment](docs/review/2026-09-21-project-assessment.md). For the verifiable-delivery harness, start with [delivery-harness](https://github.com/SnowsonZ/delivery-harness/blob/main/README.zh-CN.md) (vision, sources, and how each design principle maps to a component). The underlying theory (research snapshot), the original plan and decision log, the build-era baseline review and the target-state design now live in the engine repository (moved 2026-10-09): [research snapshot](https://github.com/SnowsonZ/delivery-harness/blob/main/docs/research/2026-09-23-agent-delivery-theory.md), [plan & decisions](https://github.com/SnowsonZ/delivery-harness/blob/main/docs/plans/2026-09-25-verifiable-delivery.md), [baseline review](https://github.com/SnowsonZ/delivery-harness/blob/main/docs/review/2026-09-25-harness-baseline.md). This repository keeps usage notes and its own open items in the [backlog](docs/plans/backlog.md).
 
 ## License
 

diff --git a/README.zh-CN.md b/README.zh-CN.md
@@ -138,9 +138,9 @@ python3 -W error::ResourceWarning -m unittest discover -s tests -v
 | [任务 005：金额热力分级边界测试](docs/plans/task-005-cost-level-boundaries.md) | 设计方案 | K2：杀死 `cost_level` 的两处存活变异；`bin/dispatch` 端到端验收（待办 B21） |
 | [待办清单](docs/plans/backlog.md) | 设计方案 | 未关闭事项的唯一清单（有日期或触发条件、可做未排期、持续或暂缓、用户本机环境） |
 | [delivery-harness 引擎](https://github.com/SnowsonZ/delivery-harness/blob/main/README.zh-CN.md) | 外部项目 | 从本仓库抽出的可验证交付引擎：愿景、理念出处、原则与组件对照；本仓库以内置副本装在 `.harness/engine/` |
-| [0001 harness 抽成独立引擎](docs/decisions/0001-harness-extraction.md) | 决策记录 | 以带锁文件的内置副本安装、引擎不带使用者默认值、放弃 pip/submodule/可复用 workflow 的理由 |
-| [2026-09-25 落地交接说明](docs/plans/2026-09-25-harness-rollout-handoff.md) | 设计方案（历史） | harness 开工时的基线、失败分类、可验证性地图与 P0–P6 路线，原为调研报告最后一节 |
-| [可验证交付方案](docs/plans/verifiable-delivery.md) | 设计方案 | 以本项目为标杆的全链路 harness：可验证定义、角色、风险等级、护栏分层与 P0–P6 阶段 |
+| [0001 harness 抽成独立引擎](https://github.com/SnowsonZ/delivery-harness/blob/main/docs/decisions/0001-harness-extraction.md) | 决策记录 | 以带锁文件的内置副本安装、引擎不带使用者默认值、放弃 pip/submodule/可复用 workflow 的理由 |
+| [2026-09-25 落地交接说明](https://github.com/SnowsonZ/delivery-harness/blob/main/docs/plans/2026-09-25-harness-rollout-handoff.md) | 设计方案（历史） | harness 开工时的基线、失败分类、可验证性地图与 P0–P6 路线，原为调研报告最后一节 |
+| [可验证交付方案](https://github.com/SnowsonZ/delivery-harness/blob/main/docs/plans/2026-09-25-verifiable-delivery.md) | 设计方案 | 以本项目为标杆的全链路 harness：可验证定义、角色、风险等级、护栏分层与 P0–P6 阶段 |
 | [日报与桌面组件重设计](docs/plans/2026-09-24-report-widget-redesign.md) | 设计决策记录 | 口径决定（金额伴随/USD-only/官方图标）、实施与已知边界 |
 | [日报金额与跨周期统计](docs/plans/usage-cost-report.md) | 设计方案 | 已定稿为规范，保留调研与取舍背景 |
 | [桌面组件](docs/plans/desktop-widgets.md) | 设计方案 | 已定稿为规范，保留设计背景与签名探针结论 |
@@ -151,13 +151,13 @@ python3 -W error::ResourceWarning -m unittest discover -s tests -v
 | [Zcode 状态语义排查](docs/research/2026-09-14-zcode-state-semantics.md) | 调研记录 | 等待权限状态的可达性边界 |
 | [Codex 受管理可行性论证](docs/research/2026-09-16-codex-managed-feasibility.md) | 调研记录 | notify/插件/rollout 三通道实测与暂缓决策 |
 | [各来源推送通道盘点](docs/research/2026-09-20-push-channels-per-source.md) | 调研记录 | 七家消息通道现状；codex hooks.json 全生命周期实测（含信任门禁）与 zcode 文件事件方案 |
-| [harness 现状复核](docs/review/2026-09-29-harness-status.md) | 评审记录 | 对照调研报告与目标态设计逐项复核：阶段一、二已落地，M1 完整、M2 准入数据未满足，下一阶段（阶段三放权）的顺序与完成标准 |
-| [harness 全链路审计](docs/review/2026-09-27-harness-audit.md) | 评审记录 | 8 个环节与 3 个横切面逐节点审计：现状、差距、可实现性与补齐计划（2026-09-27） |
-| [harness 评审交接](docs/review/2026-09-25-harness-review-brief.md) | 评审记录 | 交给独立评审方的范围、阅读顺序、复现命令、重点质疑与产出要求 |
-| [可验证交付基线](docs/review/2026-09-25-harness-baseline.md) | 评审记录 | v0.8.0 失败分类（R1–R19 与过程失败）、基线指标、Agent 就绪度与可验证性地图 |
+| [harness 现状复核](https://github.com/SnowsonZ/delivery-harness/blob/main/docs/review/2026-09-29-harness-status.md) | 评审记录 | 对照调研报告与目标态设计逐项复核：阶段一、二已落地，M1 完整、M2 准入数据未满足，下一阶段（阶段三放权）的顺序与完成标准 |
+| [harness 全链路审计](https://github.com/SnowsonZ/delivery-harness/blob/main/docs/review/2026-09-27-harness-audit.md) | 评审记录 | 8 个环节与 3 个横切面逐节点审计：现状、差距、可实现性与补齐计划（2026-09-27） |
+| [harness 评审交接](https://github.com/SnowsonZ/delivery-harness/blob/main/docs/review/2026-09-25-harness-review-brief.md) | 评审记录 | 交给独立评审方的范围、阅读顺序、复现命令、重点质疑与产出要求 |
+| [可验证交付基线](https://github.com/SnowsonZ/delivery-harness/blob/main/docs/review/2026-09-25-harness-baseline.md) | 评审记录 | v0.8.0 失败分类（R1–R19 与过程失败）、基线指标、Agent 就绪度与可验证性地图 |
 | [项目整体评估](docs/review/2026-09-21-project-assessment.md) | 评审记录 | v0.7.4 全库复评、七项缺陷与验证边界；附 v0.7.3 历史评估 |
 | [桌面组件签名探针](docs/research/2026-09-23-widget-adhoc-probe.md) | 调研记录 | ad-hoc 签名组件可行性实测、构建要点与未覆盖系统 |
-| [低人工干预下 AI Agent 持续高质量交付：理论与全链路最佳实践](docs/research/2026-09-23-agent-delivery-theory.md) | 调研报告 | harness 的理念来源（入库快照，编辑源为 Claude 文档） |
+| [低人工干预下 AI Agent 持续高质量交付：理论与全链路最佳实践](https://github.com/SnowsonZ/delivery-harness/blob/main/docs/research/2026-09-23-agent-delivery-theory.md) | 调研报告 | harness 的理念来源（入库快照，编辑源为 Claude 文档） |
 | [市场调研](docs/research/2026-09-13-market-survey.md) | 调研记录 | 现成工具比较与选型依据 |
 
 调研记录为带日期的历史档案，反映当时状态；现行行为以规范文档为准。

diff --git a/docs/decisions/0001-harness-extraction.md b/docs/decisions/0001-harness-extraction.md
diff --git a/docs/plans/2026-09-25-harness-rollout-handoff.md b/docs/plans/2026-09-25-harness-rollout-handoff.md