coding-agent-harness 1.0.4 → 1.0.6

package/templates-zh-CN/reference/docs-library-standard.md

@@ -2,21 +2,21 @@
 
 ## 职责
 
-本标准定义 `docs/` 文档库的目录、命名、归档和引用规则。文档库服务于 agent 执行，不是资料堆；每个文件都应有明确职责、当前事实和可追溯证据。
+本标准定义 `coding-agent-harness/` 文档库的目录、命名、归档和引用规则。文档库服务于 agent 执行，不是资料堆；每个文件都应有明确职责、当前事实和可追溯证据。
 
 ## 目录职责
 
 | 位置 | 职责 |
 | --- | --- |
-| `docs/Harness-Ledger.md` | 全局上下文维护总账，记录非平凡任务是否完成计划、审查、回归、Lessons 和收口回写。 |
-| `docs/01-GOVERNANCE/` | promoted lesson 详情、治理记录、归档。 |
-| `docs/03-ARCHITECTURE/` | ADR、架构设计、接口决策、关键技术方案。 |
-| `docs/04-DEVELOPMENT/` | 本地开发、代码地图、外部服务开发上下文、mock/stub、跨仓调试。 |
-| `docs/05-TEST-QA/` | Regression SSoT、Cadence Ledger、测试策略和回归证据索引。 |
-| `docs/09-PLANNING/` | Delivery SSoT、Module Registry、任务目录、模块计划。 |
-| `docs/09-PLANNING/TASKS/` | 每个任务一个目录，包含 task plan、progress、findings、review。 |
-| `docs/10-WALKTHROUGH/` | 收口记录和 Closeout SSoT。 |
-| `docs/11-REFERENCE/` | agent 按需加载的标准文件，控制行为而不是记录流水账。 |
+| `coding-agent-harness/governance/generated/Harness-Ledger.md` | 全局上下文维护总账，记录非平凡任务是否完成计划、审查、回归、Lessons 和收口回写。 |
+| `coding-agent-harness/governance/` | promoted lesson 详情、治理记录、归档。 |
+| `coding-agent-harness/context/architecture/` | ADR、架构设计、接口决策、关键技术方案。 |
+| `coding-agent-harness/context/development/` | 本地开发、代码地图、外部服务开发上下文、mock/stub、跨仓调试。 |
+| `coding-agent-harness/governance/regression/` | Regression SSoT、Cadence Ledger、测试策略和回归证据索引。 |
+| `coding-agent-harness/planning/` | Delivery SSoT、Module Registry、任务目录、模块计划。 |
+| `coding-agent-harness/planning/tasks/` | 每个任务一个目录，包含 task plan、progress、findings、review。 |
+| `coding-agent-harness/planning/tasks/<task>/` | 收口记录和 Closeout Index。 |
+| `coding-agent-harness/governance/standards/` | agent 按需加载的标准文件，控制行为而不是记录流水账。 |
 | `docs/99-TMP/` | 临时材料，定期清理，不作为长期事实来源。 |
 
 ## 03 / 04 / 06 路由规则
@@ -29,16 +29,16 @@
 
 | 目录 | 负责 | 不负责 | 必需 schema 信号 |
 | --- | --- | --- | --- |
-| `docs/03-ARCHITECTURE/` | 系统结构、服务职责、owner、service catalog、critical flows、ADR | endpoint payload、mock 指南、任务日志 | `Context Doc Type`, `Source Evidence`, `Last Verified`, `Confidence` |
-| `docs/04-DEVELOPMENT/` | local setup、codebase map、external development context、external source packs、mock/stub、cross-repo debugging | 长期架构事实、API payload 合同、未经摘要的外部资料堆 | `Context Doc Type`, `Development Use`, `Do Not Assume`, `Mocks / Stubs`, `Source Evidence`, `Last Verified`, `Confidence` |
-| `docs/06-INTEGRATIONS/` | API/event/webhook/SDK/third-party contract、auth、payload、errors、contract tests | 全局拓扑、service ownership catalog、调试笔记 | `Context Doc Type`, `Contract Type`, `Auth`, `Payload`, `Errors`, `Contract Tests`, `Source Evidence`, `Last Verified`, `Confidence` |
+| `coding-agent-harness/context/architecture/` | 系统结构、服务职责、owner、service catalog、critical flows、ADR | endpoint payload、mock 指南、任务日志 | `Context Doc Type`, `Source Evidence`, `Last Verified`, `Confidence` |
+| `coding-agent-harness/context/development/` | local setup、codebase map、external development context、external source packs、mock/stub、cross-repo debugging | 长期架构事实、API payload 合同、未经摘要的外部资料堆 | `Context Doc Type`, `Development Use`, `Do Not Assume`, `Mocks / Stubs`, `Source Evidence`, `Last Verified`, `Confidence` |
+| `coding-agent-harness/context/integrations/` | API/event/webhook/SDK/third-party contract、auth、payload、errors、contract tests | 全局拓扑、service ownership catalog、调试笔记 | `Context Doc Type`, `Contract Type`, `Auth`, `Payload`, `Errors`, `Contract Tests`, `Source Evidence`, `Last Verified`, `Confidence` |
 
 具体分工：
 
-- `03-ARCHITECTURE/service-catalog.md` 只写服务摘要和链接。
-- `06-INTEGRATIONS/<service>-api-contract.md` 才写 payload、auth、errors、contract tests。
-- `04-DEVELOPMENT/external-context/<service>.md` 写 mock/stub、不安全假设和调试说明。
-- `04-DEVELOPMENT/external-source-packs/` 只写外部资料索引、digest 和投影状态；最终事实必须回写到 `03/04/06`。
+- `coding-agent-harness/context/architecture/service-catalog.md` 只写服务摘要和链接。
+- `coding-agent-harness/context/integrations/<service>-api-contract.md` 才写 payload、auth、errors、contract tests。
+- `coding-agent-harness/context/development/external-context/<service>.md` 写 mock/stub、不安全假设和调试说明。
+- `coding-agent-harness/context/development/external-source-packs/` 只写外部资料索引、digest 和投影状态；最终事实必须回写到 `context/{architecture,development,integrations}`。
 
 ## 外部资料摄取规则
 
@@ -54,7 +54,7 @@ Inventory -> Classify -> Sanitize -> Digest -> Project -> Verify -> Residual
 
 ## 命名规则
 
-- 目录可使用编号前缀，例如 `09-PLANNING`、`11-REFERENCE`。
+- 目录可使用编号前缀，例如 `coding-agent-harness/planning`、`coding-agent-harness/governance/standards`。
 - 标准文件使用 kebab-case，例如 `testing-standard.md`。
 - 时序文档使用日期前缀，例如 `2026-05-19-runtime-cleanup-walkthrough.md`。
 - 模板目录或模板文件用 `_` 前缀，例如 `_task-template/`。
@@ -64,15 +64,15 @@ Inventory -> Classify -> Sanitize -> Digest -> Project -> Verify -> Residual
 
 | 类型 | 推荐位置 | 要求 |
 | --- | --- | --- |
-| 任务计划 | `09-PLANNING/TASKS/<task>/task_plan.md` | 写目标、范围、证据、stop condition。 |
-| 进度记录 | `09-PLANNING/TASKS/<task>/progress.md` | 记录阶段状态、阻塞、决策和验证。 |
-| 研究发现 | `09-PLANNING/TASKS/<task>/findings.md` | 记录调查证据，不替代审查报告。 |
-| 审查报告 | `09-PLANNING/TASKS/<task>/review.md` | 记录 Confidence Challenge、material findings、evidence、residual。 |
-| 收口记录 | `10-WALKTHROUGH/<date>-<name>.md` | 给下一轮 agent 的可追溯交接。 |
-| Closeout SSoT | `10-WALKTHROUGH/Closeout-SSoT.md` | closed task 的 walkthrough 路径和跳过原因索引。 |
-| Regression SSoT | `05-TEST-QA/Regression-SSoT.md` | 管回归 surface、evidence depth、residual。 |
+| 任务计划 | `coding-agent-harness/planning/tasks/<task>/task_plan.md` | 写目标、范围、证据、stop condition。 |
+| 进度记录 | `coding-agent-harness/planning/tasks/<task>/progress.md` | 记录阶段状态、阻塞、决策和验证。 |
+| 研究发现 | `coding-agent-harness/planning/tasks/<task>/findings.md` | 记录调查证据，不替代审查报告。 |
+| 审查报告 | `coding-agent-harness/planning/tasks/<task>/review.md` | 记录 Confidence Challenge、material findings、evidence、residual。 |
+| 收口记录 | `coding-agent-harness/planning/tasks/<task>/<date>-<name>.md` | 给下一轮 agent 的可追溯交接。 |
+| Closeout Index | `coding-agent-harness/governance/generated/Closeout-Index.md` | closed task 的 walkthrough 路径和跳过原因索引。 |
+| Regression SSoT | `coding-agent-harness/governance/regression/Regression-SSoT.md` | 管回归 surface、evidence depth、residual。 |
 | Harness Ledger | `Harness-Ledger.md` | 管上下文维护合规性，不复制业务事实。 |
-| Reference 标准 | `11-REFERENCE/*.md` | 管长期规则，避免写成任务日志。 |
+| Reference 标准 | `coding-agent-harness/governance/standards/*.md` | 管长期规则，避免写成任务日志。 |
 
 ## 归档规则
 
@@ -81,7 +81,7 @@ Inventory -> Classify -> Sanitize -> Digest -> Project -> Verify -> Residual
 - 归档不删除原始 ID，不破坏 task plan、walkthrough、SSoT、Ledger 之间的引用。
 - 活跃文件必须留下归档指针，说明历史记录在哪里。
 - `review.md` 留在对应任务目录，不移动到 walkthrough 或根目录。
-- `docs/Harness-Ledger.md` 固定保留在 docs 根目录，是根目录过程文件禁令的唯一例外。
+- `coding-agent-harness/governance/generated/Harness-Ledger.md` 由 CLI 生成，不应手写。
 - `docs/99-TMP/` 下超过 7 天未更新的文件应清理或迁移到正式位置。
 
 ## 写作原则
@@ -91,4 +91,4 @@ Inventory -> Classify -> Sanitize -> Digest -> Project -> Verify -> Residual
 3. 证据用路径、命令、日志、截图、PR、CI run 引用，不依赖聊天记录。
 4. 表格用于状态和路由；段落用于解释判断和边界。
 5. 更新 reference 或 template 时，必须在 Harness Ledger 记录本次上下文维护。
-6. `03/04/06` 文档必须使用 schema 信号，发现内容错位时迁移到正确目录。
+6. `context/{architecture,development,integrations}` 文档必须使用 schema 信号，发现内容错位时迁移到正确目录。

package/templates-zh-CN/reference/execution-workflow-standard.md

@@ -10,7 +10,7 @@
 2. 读取功能 SSoT 或 Delivery SSoT，确认任务状态、owner 和依赖。
 3. 读取 `task_plan.md`，确认目标、范围、证据、stop condition 和允许修改的路径。
 4. 读取 `delivery-operating-model-standard.md`，判断本轮是 solo、team、split-repo、program、waterfall 还是 kanban 交付形态。
-5. 多人、多 agent、多仓、共享文件或阶段交付任务必须更新 `docs/09-PLANNING/Delivery-SSoT.md`。
+5. 多人、多 agent、多仓、共享文件或阶段交付任务必须更新 `coding-agent-harness/planning/Delivery-SSoT.md`。
 6. 判断是否属于长程任务；如属于，按 `long-running-task-standard.md` 补齐合同。
 7. 判断是否需要对抗性审查；如需要，按 `adversarial-review-standard.md` 创建或更新 `review.md`。
 8. planned task 默认需要 closeout review；先读取 `review-routing-standard.md`。
@@ -28,7 +28,31 @@
 6. 遇到共享文件冲突，由 coordinator 或人工决定串行顺序。
 7. 遇到目标失效、权限阻塞、高风险决策或 stop condition 不适用，立即暂停并记录。
 8. 主动提交已验证的、有意义的中间成果；commit message 应说明变更类型和范围。除非用户明确要求暂不提交、检查失败、dirty 归属不清，或安全边界阻止干净提交，否则不要把已完成切片长期留在未提交状态；延期提交必须写明 no-commit reason、owner 和下一步。
-9. 机械化 Harness 写入优先使用 CLI lifecycle 命令。CLI-owned 写入会加锁、限制 allowlist 并自动提交，也会拒绝 dirty Git 状态；agent-owned 手工编辑仍需要明确任务提交或延期提交理由。
+9. 机械化 Harness 写入优先使用 CLI lifecycle 命令。CLI-owned 写入会加锁、限制 allowlist 并自动提交。`new-task` 可以保留无关 dirty 文件，并只提交本次命令自己的 write scope；但 write scope 重叠 dirty 或无关 staged 文件仍会阻塞命令。其他 lifecycle 命令仍可能要求 clean tree。agent-owned 手工编辑仍需要明确任务提交或延期提交理由。
+10. 把 `visual_map.md` 当作生命周期阶段地图。`init` 阶段准备工作，`execution` 阶段定义实现完成度，`gate` 阶段定义审查、人工确认、lesson routing 和 closeout。只有当前操作者匹配阶段 `Actor` 时，才执行该阶段 `Exit Command`；Agent 不得执行 `human` gate。
+11. 新任务目录必须在 `INDEX.md` 保留机器可读任务审计元数据。正常路径是 `Created By: harness new-task`；手工创建只能作为 `manual-exception`，并写清具体原因；历史迁移使用 `historical-backfill`。
+
+## 任务包结构
+
+使用 `harness new-task` 创建任务目录，不要手工复制任务文件。CLI 会按所选预算创建文件集，并在 `INDEX.md` 记录任务审计元数据，供 `harness check` 校验。
+
+| 预算 | 必需文件 |
+| --- | --- |
+| simple | `INDEX.md`、`brief.md`、`task_plan.md`、`visual_map.md`、`progress.md` |
+| standard | simple 文件，加 `execution_strategy.md`、`findings.md`、`lesson_candidates.md`、`review.md` |
+| complex | standard 文件，加 `references/INDEX.md`、`artifacts/INDEX.md` |
+| long-running 附加项 | 选择 `--long-running` 时额外创建 `long-running-task-contract.md` |
+
+`INDEX.md` 是任务包导航页，也是审计元数据 SSoT。它只指向合同文件和可选索引，不替代这些文件。
+
+可选目录只在触发时创建：
+
+- `references/INDEX.md`：任务本地资料、外部链接、reviewer 输入包、preset 提供的 required reads。
+- `artifacts/INDEX.md`：命令输出、截图、fixture、生成报告、审查记录和其他证据。
+- `lessons/LC-*.md`：进入 `needs-promotion` 的 lesson candidate 的任务本地详情文件。
+- `slices/<slice-id>/`：明确启用多切片任务包时使用。
+
+Preset 包不能新增或替换根级 base scaffold 文档。Preset 只能追加固定基础文档的受控 section，或把隔离资源写入 `references/**` 和 `artifacts/**`。resource rows 只能登记在 `references/INDEX.md` 和 `artifacts/INDEX.md`；根 `INDEX.md` 最多显示系统渲染的 preset summary 字段。
 
 ## 完成任务后
 
@@ -39,11 +63,12 @@
 5. 确认 `review.md` 没有 open P0/P1 finding；material P2 已修复或写为 `accepted-risk` 并路由。
 6. planned task 必须完成 closeout review，或写明 `skipped-with-reason`。
 7. 写 walkthrough，引用 task plan、review、证据、residual、Regression SSoT 和 commit。
-8. 执行 Lessons 检查：新任务默认先写 `lesson_candidates.md` 并交给人工审查；人工标记后可记录 `queued-promotion`，再由维护命令写 promoted lesson 详情文档。没有可复用候选时记录 `no-candidate-accepted`；旧任务兼容可记录 `checked-none: <reason>`。
-9. 最后更新 Harness Ledger，因为它记录本轮上下文维护的最终状态。
-10. 完成 commit / PR / release note，并确认本任务工作区没有未解释的遗留改动。
-11. 如使用 worker，coordinator 集成 worker commit 后运行最终 gates，并记录 integration evidence。
-12. 如使用 worktree，按 `worktree-standard.md` 清理或记录保留原因。
+8. 确认当前 `visual_map.md` lifecycle gate 已执行，或已记录 blocker。
+9. 执行 Lessons 检查：新任务默认先写 `lesson_candidates.md` 并交给人工审查；人工标记后可记录 `queued-promotion`，再由维护命令写 promoted lesson 详情文档。没有可复用候选时记录 `no-candidate-accepted`；旧任务兼容可记录 `checked-none: <reason>`。
+10. 最后更新 Harness Ledger，因为它记录本轮上下文维护的最终状态。
+11. 完成 commit / PR / release note，并确认本任务工作区没有未解释的遗留改动。
+12. 如使用 worker，coordinator 集成 worker commit 后运行最终 gates，并记录 integration evidence。
+13. 如使用 worktree，按 `worktree-standard.md` 清理或记录保留原因。
 
 ## 提交规范
 

package/templates-zh-CN/reference/external-source-intake-standard.md

@@ -2,15 +2,15 @@
 
 ## 职责
 
-本标准定义 Agent 如何接收、过滤、整理外部项目或微服务团队提供的大量文档。目标是把外部资料变成可执行上下文，而不是把资料堆进 `03/04/06`。
+本标准定义 Agent 如何接收、过滤、整理外部项目或微服务团队提供的大量文档。目标是把外部资料变成可执行上下文，而不是把资料堆进 `context/{architecture,development,integrations}`。
 
 ## 核心模型
 
 ```text
-外部原始资料 -> source pack 索引 -> digest 摘要 -> 03/04/06 执行投影
+外部原始资料 -> source pack 索引 -> digest 摘要 -> context/{architecture,development,integrations} 执行投影
 ```
 
-`03-ARCHITECTURE`、`04-DEVELOPMENT`、`06-INTEGRATIONS` 只保存已经提炼并可用于执行的事实。外部团队丢来的原文、长文档、截图、聊天记录、导出包和历史资料先进入 `docs/04-DEVELOPMENT/external-source-packs/`，不能直接污染执行文档。
+`context/architecture`、`context/development`、`context/integrations` 只保存已经提炼并可用于执行的事实。外部团队丢来的原文、长文档、截图、聊天记录、导出包和历史资料先进入 `coding-agent-harness/context/development/external-source-packs/`，不能直接污染执行文档。
 
 ## 何时询问用户
 
@@ -32,27 +32,27 @@
 
 | 场景 | 存储方式 |
 | --- | --- |
-| 只有 1-4 个稳定外部文档 | 不必建独立 source pack；在对应 `03/04/06` 的 `Source Evidence` 中链接即可 |
-| 外部资料超过 5 份、跨多个主题、或会持续增长 | 创建 `docs/04-DEVELOPMENT/external-source-packs/<source-key>/` |
+| 只有 1-4 个稳定外部文档 | 不必建独立 source pack；在对应 `context/{architecture,development,integrations}` 的 `Source Evidence` 中链接即可 |
+| 外部资料超过 5 份、跨多个主题、或会持续增长 | 创建 `coding-agent-harness/context/development/external-source-packs/<source-key>/` |
 | 资料含敏感信息、密钥、客户数据或不能进仓 | 不复制原文；在 source pack README 记录外部路径、owner、访问条件和摘要 |
 | 资料是可公开或可入仓的原始文档 | 可放 `raw/`，但仍要经过 digest 后才能投影到执行文档 |
 
 建议结构：
 
 ```text
-docs/04-DEVELOPMENT/external-source-packs/<source-key>/
+coding-agent-harness/context/development/external-source-packs/<source-key>/
 ├── README.md              # 资料索引和投影状态
 ├── digests/               # 每份或每组资料的摘要
 ├── raw/                   # 可入仓原文；禁止放密钥、隐私或客户数据
 └── raw-index.md           # 原文不能入仓时，用路径/URL/owner 索引替代 raw/
 ```
 
-不要为每个微服务复制一套完整 `03/04/06` 目录。source pack 是资料入口；稳定执行入口仍然是：
+不要为每个微服务复制一套完整 `context/{architecture,development,integrations}` 目录。source pack 是资料入口；稳定执行入口仍然是：
 
-- `docs/03-ARCHITECTURE/service-catalog.md`
-- `docs/03-ARCHITECTURE/services/<service-key>.md`
-- `docs/04-DEVELOPMENT/external-context/<service-key>.md`
-- `docs/06-INTEGRATIONS/<contract>.md`
+- `coding-agent-harness/context/architecture/service-catalog.md`
+- `coding-agent-harness/context/architecture/services/<service-key>.md`
+- `coding-agent-harness/context/development/external-context/<service-key>.md`
+- `coding-agent-harness/context/integrations/<contract>.md`
 
 ## 摄取流程
 
@@ -60,7 +60,7 @@ docs/04-DEVELOPMENT/external-source-packs/<source-key>/
 2. **Classify**：按 architecture、development、integration、security、operations、product、unknown 分类。
 3. **Sanitize**：检查密钥、token、客户数据、隐私、内部账号、不可公开链接；不能入仓的只存引用。
 4. **Digest**：用 digest 模板提炼事实、疑问、不安全假设和证据。
-5. **Project**：把稳定事实投影到 `03/04/06`，并在 source pack README 标记 projected。
+5. **Project**：把稳定事实投影到 `context/{architecture,development,integrations}`，并在 source pack README 标记 projected。
 6. **Verify**：能用代码、接口测试、owner 确认或运行证据验证的，更新 `Last Verified` 和 `Confidence`。
 7. **Residual**：不能确认的内容留在 source pack，不进入执行文档，或进入 `Do Not Assume`。
 
@@ -68,14 +68,14 @@ docs/04-DEVELOPMENT/external-source-packs/<source-key>/
 
 | 资料内容 | 投影位置 |
 | --- | --- |
-| 服务职责、上下游、owner、数据归属、系统拓扑 | `03-ARCHITECTURE/service-catalog.md` 或 `services/<service-key>.md` |
-| 本仓开发时如何 mock、stub、启动、联调、排查 | `04-DEVELOPMENT/external-context/<service-key>.md` |
-| endpoint、payload、auth、error、event、webhook、SDK、contract test | `06-INTEGRATIONS/<contract>.md` |
+| 服务职责、上下游、owner、数据归属、系统拓扑 | `coding-agent-harness/context/architecture/service-catalog.md` 或 `services/<service-key>.md` |
+| 本仓开发时如何 mock、stub、启动、联调、排查 | `coding-agent-harness/context/development/external-context/<service-key>.md` |
+| endpoint、payload、auth、error、event、webhook、SDK、contract test | `coding-agent-harness/context/integrations/<contract>.md` |
 | 仍未确认、来源冲突、过期或只作为背景参考 | 留在 source pack README / digest，不进入执行文档 |
 
 ## 禁止事项
 
-- 不要把几十份外部文档直接复制到 `03-ARCHITECTURE`、`04-DEVELOPMENT` 或 `06-INTEGRATIONS` 根目录。
+- 不要把几十份外部文档直接复制到 `context/architecture`、`context/development` 或 `context/integrations` 根目录。
 - 不要把外部资料摘要当成已验证事实；必须记录 `Source Evidence`、`Last Verified` 和 `Confidence`。
 - 不要在执行文档里保留大段原文、聊天流水或历史会议记录。
 - 不要把密钥、真实 token、客户数据、个人隐私或不可公开资料提交进仓。

package/templates-zh-CN/reference/harness-ledger-standard.md

@@ -2,13 +2,13 @@
 
 ## 职责
 
-Harness Ledger 是 `docs/` 骨架的全局上下文维护总账，固定位置为：
+Harness Ledger 是 `coding-agent-harness/` 骨架的全局上下文维护总账，固定位置为：
 
 ```text
-docs/Harness-Ledger.md
+coding-agent-harness/governance/generated/Harness-Ledger.md
 ```
 
-它记录每个非平凡任务是否完成了 task plan、progress、review、功能 SSoT、Delivery SSoT、Regression SSoT、lesson candidates/detail docs、walkthrough、Closeout SSoT、reference/template 和 CI/CD 治理回写。它不复制业务事实，只记录上下文维护是否合规。
+它记录每个非平凡任务是否完成了 task plan、progress、review、功能 SSoT、Delivery SSoT、Regression SSoT、lesson candidates/detail docs、walkthrough、Closeout Index、reference/template 和 CI/CD 治理回写。它不复制业务事实，只记录上下文维护是否合规。
 
 ## 必须更新的场景
 
@@ -17,7 +17,7 @@ docs/Harness-Ledger.md
 - 新增或修改 AGENTS.md、CLAUDE.md、reference、template、checker 或 dashboard。
 - coordinator pass 汇总模块任务、worker handoff、review、closeout 或 regression 结果。
 - 创建或更新 required review。
-- 修改功能 SSoT、Delivery SSoT、Regression SSoT、lesson detail docs、Closeout SSoT 任一文件。
+- 修改功能 SSoT、Delivery SSoT、Regression SSoT、lesson detail docs、Closeout Index 任一文件。
 - 创建 walkthrough 或接受受控跳过。
 - Lessons approved 后合入正式 reference。
 
@@ -67,7 +67,7 @@ docs/Harness-Ledger.md
 - [ ] repo governance、CI/CD required checks 已验证、更新或 residualized。
 - [ ] 功能 SSoT 或 Delivery SSoT 已更新，或标记 `n/a`。
 - [ ] Regression SSoT / Cadence Ledger 已更新，或标记 `n/a`。
-- [ ] walkthrough 已创建，或 Closeout SSoT 写明受控跳过原因。
+- [ ] walkthrough 已创建，或 Closeout Index 写明受控跳过原因。
 - [ ] walkthrough 包含 Lessons 反思。
 - [ ] Lessons 检查结果为 `checked-candidate: LC-...`、`queued-promotion: LC-...`、`checked-created: L-YYYY-MM-DD-NNN`，或旧任务兼容的 `checked-none: <reason>`。
 - [ ] Harness Ledger 行已收口，或 residual 已写明 owner 和后续路径。
@@ -88,7 +88,7 @@ docs/Harness-Ledger.md
 活跃表保留最近 50 条。更早的 `closed` 或 `superseded` 条目按季度归档：
 
 ```text
-docs/01-GOVERNANCE/_archive/Harness-Ledger-archive-YYYY-QN.md
+coding-agent-harness/governance/archive/Harness-Ledger-archive-YYYY-QN.md
 ```
 
 归档后，活跃表必须留下归档位置说明。

package/templates-zh-CN/reference/regression-ssot-governance.md

@@ -7,7 +7,7 @@ Regression SSoT 是项目回归控制塔，管理所有 regression surface 的 g
 默认位置：
 
 ```text
-docs/05-TEST-QA/Regression-SSoT.md
+coding-agent-harness/governance/regression/Regression-SSoT.md
 ```
 
 ## 维护时机
@@ -61,7 +61,7 @@ docs/05-TEST-QA/Regression-SSoT.md
 
 ## 废弃回归门禁
 
-1. 将 gate 移入 `docs/05-TEST-QA/_archive/Regression-SSoT-archive-YYYY-QN.md`。
+1. 将 gate 移入 `coding-agent-harness/governance/regression/_archive/Regression-SSoT-archive-YYYY-QN.md`。
 2. 写明废弃原因、替代 gate 和最后状态。
 3. 同步更新 Cadence Ledger。
 4. 在 walkthrough 和 Harness Ledger 记录本次治理变化。

package/templates-zh-CN/reference/repo-governance-standard.md

@@ -33,7 +33,7 @@
 | --- | --- |
 | 是否必须 PR | yes / no / local-only |
 | PR 标题格式 | 通常与 commit 规范一致 |
-| PR 描述要求 | 遵守 `docs/11-REFERENCE/pull-request-standard.md`；写清改动、原因、版本影响、验证、residual、关联 task / SSoT / review |
+| PR 描述要求 | 遵守 `coding-agent-harness/governance/standards/pull-request-standard.md`；写清改动、原因、版本影响、验证、residual、关联 task / SSoT / review |
 | 必需审查者 | reviewer、外部 agent、人类 owner 或代码 owner |
 | 必需审查类型 | self-review、subagent review、human review、security review |
 | merge method | merge commit、squash、rebase、fast-forward |

package/templates-zh-CN/reference/review-routing-standard.md

@@ -86,4 +86,4 @@ Worker 必须走 `worktree-standard.md`，并先在 `execution_strategy.md` 记
 - [ ] open P0/P1 findings 为 0。
 - [ ] material P2 已修复或 `accepted-risk` 并路由。
 - [ ] 如使用 worker，已记录 branch、commit SHA、checks、residual 和 integration evidence。
-- [ ] walkthrough、Closeout SSoT、Harness Ledger 引用了审查报告或跳过原因。
+- [ ] walkthrough、Closeout Index、Harness Ledger 引用了审查报告或跳过原因。

package/templates-zh-CN/reference/walkthrough-standard.md

@@ -7,13 +7,13 @@
 默认位置：
 
 ```text
-docs/10-WALKTHROUGH/YYYY-MM-DD-<feature-name>.md
+coding-agent-harness/planning/tasks/<task>/walkthrough.md
 ```
 
-Closeout SSoT 固定位置：
+Closeout Index 固定位置：
 
 ```text
-docs/10-WALKTHROUGH/Closeout-SSoT.md
+coding-agent-harness/governance/generated/Closeout-Index.md
 ```
 
 ## 何时必须写
@@ -46,13 +46,13 @@ docs/10-WALKTHROUGH/Closeout-SSoT.md
 
 ## 收口单一事实源规则
 
-以下 Harness Ledger row 必须有 Closeout SSoT row：
+以下 Harness Ledger row 必须有 Closeout Index row：
 
 - `closed`
 - `closed-with-residual`
 - `closed-local-only`
 
-Closeout SSoT 中：
+Closeout Index 中：
 
 - walkthrough 列写实际路径，或写受控跳过原因。
 - Lessons 检查列写 `checked-candidate: LC-...`、`queued-promotion: LC-...`、`checked-created: L-YYYY-MM-DD-NNN`，或旧任务兼容的 `checked-none: <reason>`。
@@ -73,7 +73,7 @@ Closeout SSoT 中：
 - 人工审查后，如需沉淀，再由维护命令写 promoted lesson 详情文档。
 - `checked-created:<L-ID>` 必须能追溯到该详情文档。
 
-三个答案都为“没有”时，Closeout SSoT 和 Harness Ledger 仍要记录：
+三个答案都为“没有”时，Closeout Index 和 Harness Ledger 仍要记录：
 
 ```text
 lesson_candidates.md: no-candidate-accepted
@@ -81,4 +81,4 @@ lesson_candidates.md: no-candidate-accepted
 
 ## 收口要求
 
-walkthrough 写完后，必须更新 Closeout SSoT 和 Harness Ledger。涉及回归、CI/CD、repo governance、reference 或 template 的，还要同步对应标准或 SSoT。
+walkthrough 写完后，必须更新 Closeout Index 和 Harness Ledger。涉及回归、CI/CD、repo governance、reference 或 template 的，还要同步对应标准或 SSoT。

package/templates-zh-CN/reference/worktree-standard.md

@@ -42,7 +42,7 @@ worktree 目录推荐：
 - `fix/`：缺陷修复。
 - `refactor/`：重构。
 - `test/`：测试相关。
-- `docs/`：文档相关。
+- `coding-agent-harness/`：文档相关。
 - `codex/`：agent 任务分支。
 
 示例：

package/templates-zh-CN/regression/Cadence-Ledger.md

@@ -25,11 +25,11 @@
 
 ## 归档索引
 
-> 批次日志超过 50 行或完成阶段收口时，移入 `docs/05-TEST-QA/_archive/Cadence-Ledger-archive-YYYY-QN.md`。
+> 批次日志超过 50 行或完成阶段收口时，移入 `coding-agent-harness/governance/regression/_archive/Cadence-Ledger-archive-YYYY-QN.md`。
 
 | 归档文件 | 覆盖批次 | 移入日期 | 说明 |
 | --- | --- | --- | --- |
-| `docs/05-TEST-QA/_archive/Cadence-Ledger-archive-YYYY-QN.md` | SRB-... 至 SRB-... | YYYY-MM-DD | [说明] |
+| `coding-agent-harness/governance/regression/_archive/Cadence-Ledger-archive-YYYY-QN.md` | SRB-... 至 SRB-... | YYYY-MM-DD | [说明] |
 
 ## 结果状态
 

package/templates-zh-CN/ssot/Delivery-SSoT.md

@@ -33,11 +33,11 @@
 
 ## 归档索引
 
-> 已完成交付块在 release 或阶段收口后移入 `docs/09-PLANNING/_archive/Delivery-SSoT-archive-YYYY-QN.md`，活跃表只保留当前仍会影响集成决策的内容。
+> 已完成交付块在 release 或阶段收口后移入 `coding-agent-harness/planning/_archive/Delivery-SSoT-archive-YYYY-QN.md`，活跃表只保留当前仍会影响集成决策的内容。
 
 | 归档文件 | 覆盖范围 | 移入日期 | 说明 |
 | --- | --- | --- | --- |
-| `docs/09-PLANNING/_archive/Delivery-SSoT-archive-YYYY-QN.md` | DB-... 至 DB-... | YYYY-MM-DD | [说明] |
+| `coding-agent-harness/planning/_archive/Delivery-SSoT-archive-YYYY-QN.md` | DB-... 至 DB-... | YYYY-MM-DD | [说明] |
 
 ## 状态说明
 
@@ -57,4 +57,4 @@
 2. 依赖未满足时不得标记 `ready-for-integration`。
 3. 跨仓接口变化必须有合同条目，不能只靠聊天说明。
 4. 集成队列是合并顺序来源；临时改顺序必须更新本文件。
-5. 完成后的证据和残余同步回 Harness Ledger 与 Closeout SSoT。
+5. 完成后的证据和残余同步回 Harness Ledger 与 Closeout Index。

package/templates-zh-CN/ssot/Module-Registry.md

@@ -22,11 +22,11 @@
 
 ## 归档索引
 
-> 完成、取消或合并进其他模块的条目移入 `MODULES/_archive/Module-Registry-archive-YYYY-QN.md`。
+> 完成、取消或合并进其他模块的条目移入 `coding-agent-harness/planning/modules/_archive/Module-Registry-archive-YYYY-QN.md`。
 
 | 归档文件 | 覆盖模块 | 移入日期 | 说明 |
 | --- | --- | --- | --- |
-| `MODULES/_archive/Module-Registry-archive-YYYY-QN.md` | [模块 Key 范围] | YYYY-MM-DD | [说明] |
+| `coding-agent-harness/planning/modules/_archive/Module-Registry-archive-YYYY-QN.md` | [模块 Key 范围] | YYYY-MM-DD | [说明] |
 
 ## 状态说明
 
@@ -45,4 +45,4 @@
 2. 模块状态变化要有对应的 module plan、progress、review 或 evidence 证据。
 3. `ready-for-sync` 不能直接等同完成；协调者同步后才能标记 `completed`。
 4. 写入范围变化必须先更新本表，再让 worker 修改文件。
-5. 模块完成后，收口证据回写 Harness Ledger、Closeout SSoT 和必要的 Feature / Regression SSoT。
+5. 模块完成后，收口证据回写 Harness Ledger、Closeout Index 和必要的 Feature / Regression SSoT。

package/templates-zh-CN/ssot/Regression-SSoT.md

@@ -27,11 +27,11 @@
 
 ## 归档索引
 
-> 废弃 gate、已关闭残余和历史批次移入 `docs/05-TEST-QA/_archive/Regression-SSoT-archive-YYYY-QN.md`。活跃表只保留仍会影响当前开发和发布判断的内容。
+> 废弃 gate、已关闭残余和历史批次移入 `coding-agent-harness/governance/regression/_archive/Regression-SSoT-archive-YYYY-QN.md`。活跃表只保留仍会影响当前开发和发布判断的内容。
 
 | 归档文件 | 覆盖范围 | 移入日期 | 说明 |
 | --- | --- | --- | --- |
-| `docs/05-TEST-QA/_archive/Regression-SSoT-archive-YYYY-QN.md` | RG-... / R-... | YYYY-MM-DD | [说明] |
+| `coding-agent-harness/governance/regression/_archive/Regression-SSoT-archive-YYYY-QN.md` | RG-... / R-... | YYYY-MM-DD | [说明] |
 
 ## 结果状态
 

package/templates-zh-CN/walkthrough/walkthrough-template.md

@@ -47,16 +47,16 @@
 | 是否出现跨模块、跨阶段、跨 agent 的重复问题？ | [有 / 无，写一句理由] |
 | 下次 agent 是否可能在同类任务中重复踩坑？ | [有 / 无，写一句理由] |
 | Lessons 结果 | `checked-candidate: LC-...` / `queued-promotion: LC-...` / `checked-created: L-YYYY-MM-DD-NNN` / 旧任务 `checked-none: [一句话原因]` |
-| Lessons 详情文档 | `lesson_candidates.md` / `docs/01-GOVERNANCE/lessons/[file].md` / `none` |
+| Lessons 详情文档 | `lesson_candidates.md` / `coding-agent-harness/governance/lessons/[file].md` / `none` |
 
 ## 关联索引
 
-- 任务计划：`docs/09-PLANNING/TASKS/[task]/task_plan.md`
-- 进度记录：`docs/09-PLANNING/TASKS/[task]/progress.md`
-- 审查报告：`docs/09-PLANNING/TASKS/[task]/review.md` / `n/a`
+- 任务计划：`coding-agent-harness/planning/tasks/[task]/task_plan.md`
+- 进度记录：`coding-agent-harness/planning/tasks/[task]/progress.md`
+- 审查报告：`coding-agent-harness/planning/tasks/[task]/review.md` / `n/a`
 - 功能 SSoT：[F-...]
 - Delivery SSoT：[DB-...] / `n/a`
 - 回归 Gate：[RG-...] / `n/a`
 - Harness Ledger：[HL-...]
-- Closeout SSoT：[对应行]
+- 任务本地收口：`walkthrough.md`
 - Commit / PR：[hash、branch 或 PR 链接]

package/tsconfig.dist.json

@@ -0,0 +1,16 @@
+{
+  "extends": "./tsconfig.runtime.json",
+  "compilerOptions": {
+    "rootDir": "scripts",
+    "outDir": "dist"
+  },
+  "include": [
+    "scripts/**/*.mts"
+  ],
+  "exclude": [
+    "node_modules",
+    ".worktrees",
+    "tmp",
+    "dist"
+  ]
+}

package/tsconfig.json

@@ -0,0 +1,25 @@
+{
+  "compilerOptions": {
+    "target": "ES2024",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "verbatimModuleSyntax": true,
+    "strict": true,
+    "noEmit": true,
+    "allowJs": true,
+    "checkJs": false,
+    "skipLibCheck": true
+  },
+  "include": [
+    "scripts/**/*.mts",
+    "scripts/**/*.ts",
+    "tests/**/*.mts",
+    "tests/**/*.ts"
+  ],
+  "exclude": [
+    "node_modules",
+    ".worktrees",
+    "tmp",
+    "dist"
+  ]
+}

package/tsconfig.runtime.json

@@ -0,0 +1,24 @@
+{
+  "compilerOptions": {
+    "target": "ES2024",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "verbatimModuleSyntax": true,
+    "strict": true,
+    "rootDir": ".",
+    "outDir": "tmp/runtime-emit",
+    "declaration": false,
+    "sourceMap": false,
+    "removeComments": false,
+    "skipLibCheck": true
+  },
+  "include": [
+    "scripts/**/*.mts"
+  ],
+  "exclude": [
+    "node_modules",
+    ".worktrees",
+    "tmp",
+    "dist"
+  ]
+}

package/examples/minimal-project/.harness-capabilities.json

@@ -1,8 +0,0 @@
-{
-  "version": 1,
-  "capabilities": [
-    {"name": "core", "state": "configured"},
-    {"name": "review-contract", "state": "verified"},
-    {"name": "dashboard", "state": "verified"}
-  ]
-}

package/examples/minimal-project/docs/09-PLANNING/TASKS/demo-task/progress.md

@@ -1,11 +0,0 @@
-# Demo Task - Progress
-
-## Status
-
-in-progress
-
-## Updates
-
-| Date | Update | Evidence |
-| --- | --- | --- |
-| 2026-05-18 | Created example visual map | report:TARGET:docs/09-PLANNING/TASKS/demo-task/visual_map.md:example phase table |