coding-agent-harness 1.0.4 → 1.0.6

package/templates-zh-CN/integrations/README.md

@@ -13,8 +13,8 @@ Keep the English field names and section headings because CLI checks rely on the
 
 ## Boundary
 
-- 服务拓扑和职责归属放 `docs/03-ARCHITECTURE/`。
-- 开发 mock 和调试说明放 `docs/04-DEVELOPMENT/`。
+- 服务拓扑和职责归属放 `coding-agent-harness/context/architecture/`。
+- 开发 mock 和调试说明放 `coding-agent-harness/context/development/`。
 - endpoint、payload、error、auth、event、webhook、SDK 契约放这里。
 
 ## Structure Contract
@@ -30,8 +30,8 @@ Keep the English field names and section headings because CLI checks rely on the
 
 每个接口契约必须是独立文件，并链接回对应服务：
 
-- 服务职责和上下游关系：`docs/03-ARCHITECTURE/service-catalog.md` 或 `services/<service-key>.md`
-- 本地 mock / stub / debug：`docs/04-DEVELOPMENT/external-context/<service-key>.md`
+- 服务职责和上下游关系：`coding-agent-harness/context/architecture/service-catalog.md` 或 `services/<service-key>.md`
+- 本地 mock / stub / debug：`coding-agent-harness/context/development/external-context/<service-key>.md`
 - 具体 payload、auth、error、contract test：本文件夹
 
 不要在一个“接口说明”大文档里混写多个服务。多个微服务就维护多个契约文件；README 里的 Contract Index 负责让人和 Agent 快速定位。

package/templates-zh-CN/integrations/api-contract.md

@@ -13,7 +13,7 @@ API
 
 | Service Profile | Development Context | Contract Index | Last Verified | Confidence |
 | --- | --- | --- | --- | --- |
-| `docs/03-ARCHITECTURE/services/<service-key>.md` | `docs/04-DEVELOPMENT/external-context/<service-key>.md` | `docs/06-INTEGRATIONS/README.md` | unknown | low |
+| `coding-agent-harness/context/architecture/services/<service-key>.md` | `coding-agent-harness/context/development/external-context/<service-key>.md` | `coding-agent-harness/context/integrations/README.md` | unknown | low |
 
 ## Auth
 
@@ -39,4 +39,4 @@ API
 
 ## Placement Rule
 
-本文件只写一个 API 契约。服务职责放 `03-ARCHITECTURE`，本地 mock/stub/debug 放 `04-DEVELOPMENT`。
+本文件只写一个 API 契约。服务职责放 `context/architecture`，本地 mock/stub/debug 放 `context/development`。

package/templates-zh-CN/integrations/event-contract.md

@@ -13,7 +13,7 @@ Event
 
 | Service Profile | Development Context | Contract Index | Last Verified | Confidence |
 | --- | --- | --- | --- | --- |
-| `docs/03-ARCHITECTURE/services/<service-key>.md` | `docs/04-DEVELOPMENT/external-context/<service-key>.md` | `docs/06-INTEGRATIONS/README.md` | unknown | low |
+| `coding-agent-harness/context/architecture/services/<service-key>.md` | `coding-agent-harness/context/development/external-context/<service-key>.md` | `coding-agent-harness/context/integrations/README.md` | unknown | low |
 
 ## Topic / Channel
 
@@ -43,4 +43,4 @@ Event
 
 ## Placement Rule
 
-本文件只写一个 event 契约。服务职责放 `03-ARCHITECTURE`，本地 mock/stub/debug 放 `04-DEVELOPMENT`。
+本文件只写一个 event 契约。服务职责放 `context/architecture`，本地 mock/stub/debug 放 `context/development`。

package/templates-zh-CN/integrations/third-party/vendor-template.md

@@ -13,7 +13,7 @@ Third-party service
 
 | Service Profile | Development Context | Contract Index | Last Verified | Confidence |
 | --- | --- | --- | --- | --- |
-| `docs/03-ARCHITECTURE/services/<vendor-key>.md` | `docs/04-DEVELOPMENT/external-context/<vendor-key>.md` | `docs/06-INTEGRATIONS/README.md` | unknown | low |
+| `coding-agent-harness/context/architecture/services/<vendor-key>.md` | `coding-agent-harness/context/development/external-context/<vendor-key>.md` | `coding-agent-harness/context/integrations/README.md` | unknown | low |
 
 ## Auth
 
@@ -39,4 +39,4 @@ Third-party service
 
 ## Placement Rule
 
-本文件只写一个第三方集成。账号/权限/SDK/限制放这里；业务职责和系统拓扑放 `03-ARCHITECTURE`。
+本文件只写一个第三方集成。账号/权限/SDK/限制放这里；业务职责和系统拓扑放 `context/architecture`。

package/templates-zh-CN/integrations/webhook-contract.md

@@ -13,7 +13,7 @@ Webhook
 
 | Service Profile | Development Context | Contract Index | Last Verified | Confidence |
 | --- | --- | --- | --- | --- |
-| `docs/03-ARCHITECTURE/services/<service-key>.md` | `docs/04-DEVELOPMENT/external-context/<service-key>.md` | `docs/06-INTEGRATIONS/README.md` | unknown | low |
+| `coding-agent-harness/context/architecture/services/<service-key>.md` | `coding-agent-harness/context/development/external-context/<service-key>.md` | `coding-agent-harness/context/integrations/README.md` | unknown | low |
 
 ## Auth
 
@@ -38,4 +38,4 @@ Webhook
 
 ## Placement Rule
 
-本文件只写一个 webhook 契约。服务职责放 `03-ARCHITECTURE`，本地 mock/stub/debug 放 `04-DEVELOPMENT`。
+本文件只写一个 webhook 契约。服务职责放 `context/architecture`，本地 mock/stub/debug 放 `context/development`。

package/templates-zh-CN/ledger/Harness-Ledger.md

@@ -12,7 +12,7 @@ Repo Governance / CI-CD 变化仍通过对应 reference 和任务证据路由。
 
 | ID | Scope | Module | Task | State | Queues | Plan | Review | Lessons Check | Closeout | Residual | Updated |
 | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
-| HL-YYYY-MM-DD-001 | task | none | 短任务标题 | planned | none | docs/09-PLANNING/TASKS/.../task_plan.md | pending | pending | pending | none | YYYY-MM-DD |
+| HL-YYYY-MM-DD-001 | task | none | 短任务标题 | planned | none | coding-agent-harness/planning/tasks/.../task_plan.md | pending | pending | pending | none | YYYY-MM-DD |
 
 ## 字段规则
 

package/templates-zh-CN/lessons/lesson-arch-process-change.md

@@ -4,7 +4,7 @@
 
 - **ID**: L-[YYYY-MM-DD-NNN]
 - **日期**: YYYY-MM-DD
-- **来源**: `docs/10-WALKTHROUGH/[walkthrough文件名].md`
+- **来源**: `coding-agent-harness/planning/tasks/<task>/walkthrough.md`
 - **类型**: arch-change / process-change
 - **目标**: [受影响的模块、流程、reference、template 或 checker]
 - **提出者**: [agent session / model / human]

package/templates-zh-CN/lessons/lesson-new-doc.md

@@ -4,9 +4,9 @@
 
 - **ID**: L-[YYYY-MM-DD-NNN]
 - **日期**: YYYY-MM-DD
-- **来源**: `docs/10-WALKTHROUGH/[walkthrough文件名].md`
+- **来源**: `coding-agent-harness/planning/tasks/<task>/walkthrough.md`
 - **类型**: new-doc
-- **建议路径**: `docs/11-REFERENCE/[建议文件名].md`
+- **建议路径**: `coding-agent-harness/governance/standards/[建议文件名].md`
 - **提出者**: [agent session / model / human]
 
 ## 背景
@@ -23,7 +23,7 @@
 
 ## 建议路径
 
-`docs/11-REFERENCE/[建议文件名].md`
+`coding-agent-harness/governance/standards/[建议文件名].md`
 
 ## 建议文档内容
 

package/templates-zh-CN/lessons/lesson-ref-change.md

@@ -4,9 +4,9 @@
 
 - **ID**: L-[YYYY-MM-DD-NNN]
 - **日期**: YYYY-MM-DD
-- **来源**: `docs/10-WALKTHROUGH/[walkthrough文件名].md`
+- **来源**: `coding-agent-harness/planning/tasks/<task>/walkthrough.md`
 - **类型**: ref-change
-- **目标**: `docs/11-REFERENCE/[目标文件].md`
+- **目标**: `coding-agent-harness/governance/standards/[目标文件].md`
 - **提出者**: [agent session / model / human]
 
 ## 背景
@@ -42,7 +42,7 @@
 - 当前是否有其他 pending 条目指向同一目标：是 / 否
 - 如果有，涉及条目：L-[XXX]
 - 本文档是否已考虑冲突：是 / 否
-- 基于版本：当前正式 reference（`docs/11-REFERENCE/[目标文件].md`）@ YYYY-MM-DD
+- 基于版本：当前正式 reference（`coding-agent-harness/governance/standards/[目标文件].md`）@ YYYY-MM-DD
 
 ## 完整副本
 
@@ -50,7 +50,7 @@
 
 ---
 <!-- 完整副本开始 -->
-<!-- 基于: docs/11-REFERENCE/[目标文件].md @ YYYY-MM-DD -->
+<!-- 基于: coding-agent-harness/governance/standards/[目标文件].md @ YYYY-MM-DD -->
 <!-- 本副本独立于其他 pending 改动 -->
 
 [完整的修改后文档内容]

package/templates-zh-CN/planning/INDEX.md

@@ -0,0 +1,87 @@
+# {{TASK_TITLE}} - 任务包索引
+
+Task Contract: harness-task/v1
+
+## 任务身份
+
+| Field | Value |
+| --- | --- |
+| Task ID | `{{TASK_ID}}` |
+| Budget | `{{TASK_BUDGET}}` |
+| Preset | `{{TASK_PRESET}}` |
+| Module | `{{TASK_MODULE}}` |
+| Long-running | `{{TASK_LONG_RUNNING}}` |
+| Created | {{DATE}} |
+
+## 任务审计元数据
+
+| Field | Value |
+| --- | --- |
+| Created By | {{TASK_AUDIT_CREATED_BY}} |
+| Created At | {{TASK_AUDIT_CREATED_AT}} |
+| Command Shape | {{TASK_AUDIT_COMMAND_SHAPE}} |
+| Budget | {{TASK_AUDIT_BUDGET}} |
+| Template Source | {{TASK_AUDIT_TEMPLATE_SOURCE}} |
+| Task Creator | {{TASK_AUDIT_TASK_CREATOR}} |
+| Task Creator Source | {{TASK_AUDIT_TASK_CREATOR_SOURCE}} |
+| Human Review Status | {{TASK_AUDIT_HUMAN_REVIEW_STATUS}} |
+| Confirmation ID | {{TASK_AUDIT_CONFIRMATION_ID}} |
+| Confirmed At | {{TASK_AUDIT_CONFIRMED_AT}} |
+| Reviewer | {{TASK_AUDIT_REVIEWER}} |
+| Reviewer Email | {{TASK_AUDIT_REVIEWER_EMAIL}} |
+| Confirm Text | {{TASK_AUDIT_CONFIRM_TEXT}} |
+| Evidence Checked | {{TASK_AUDIT_EVIDENCE_CHECKED}} |
+| Review Commit SHA | {{TASK_AUDIT_REVIEW_COMMIT_SHA}} |
+| Audit Source | {{TASK_AUDIT_AUDIT_SOURCE}} |
+| Audit Status | {{TASK_AUDIT_AUDIT_STATUS}} |
+| Exception Reason | {{TASK_AUDIT_EXCEPTION_REASON}} |
+| Message | {{TASK_AUDIT_MESSAGE}} |
+| Migration Status | {{TASK_AUDIT_MIGRATION_STATUS}} |
+| Migrated From | {{TASK_AUDIT_MIGRATED_FROM}} |
+| Legacy Extra Fields | {{TASK_AUDIT_LEGACY_EXTRA_FIELDS}} |
+| Migration Notes | {{TASK_AUDIT_MIGRATION_NOTES}} |
+
+## 核心合同文件
+
+| 文件 | 用途 |
+| --- | --- |
+| `brief.md` | 面向人和下一轮 agent 的任务摘要与上下文入口。 |
+| `task_plan.md` | 当前任务目标、范围、所选预算、验收标准和执行决策。 |
+| `visual_map.md` | 阶段图、证据状态、下一步生命周期命令和支持性图表。 |
+| `progress.md` | 执行日志、验证证据、决策和交接记录。 |
+
+## 标准任务文件
+
+standard 和 complex 任务包含以下文件。
+
+| 文件 | 用途 |
+| --- | --- |
+| `execution_strategy.md` | 执行模式、owner、冲突控制和证据策略。 |
+| `findings.md` | 发现、研究记录、已接受风险和未解决问题。 |
+| `lesson_candidates.md` | closeout 前的任务本地 lesson candidate 决策。 |
+| `review.md` | Agent Review Submission、对抗审查、findings、evidence 和 routing。 |
+
+## 可选索引
+
+| 索引 | 用途 |
+| --- | --- |
+| `references/INDEX.md` | 参考资料和 preset 提供的 required reads。 |
+| `artifacts/INDEX.md` | 生成产物、证据包、截图、报告和命令输出。 |
+
+## Preset 摘要
+
+本节由系统渲染。Preset 不能新增自定义根级文件，也不能任意追加根 `INDEX.md` 内容。
+
+| Field | Value |
+| --- | --- |
+| Preset | `{{TASK_PRESET}}` |
+| Preset Version | `{{TASK_PRESET_VERSION}}` |
+| Evidence Bundle | `{{TASK_EVIDENCE_BUNDLE}}` |
+| Resource Indexes | `references/INDEX.md`; `artifacts/INDEX.md` |
+
+## 更新规则
+
+- 状态和决策写入 `progress.md`。
+- 任务专属目标和验收标准写入 `task_plan.md`。
+- 大段命令输出、截图、报告和生成文件放入 `artifacts/INDEX.md`。
+- 源材料、外部链接和 preset required reads 放入 `references/INDEX.md`。

package/templates-zh-CN/planning/brief.md

@@ -24,7 +24,7 @@
 
 - Owner：coordinator
 - 生命周期状态：未开始
-- 必需文件：`task_plan.md`、`execution_strategy.md`、`visual_map.md`、`progress.md`、`findings.md`、`review.md`
+- 必需文件：`INDEX.md`、`task_plan.md`、`execution_strategy.md`、`visual_map.md`、`progress.md`、`findings.md`、`review.md`
 - 完成条件：验证证据必须记录到 `progress.md`
 
 ## 第一步

package/templates-zh-CN/planning/module_session_prompt.md

@@ -12,14 +12,14 @@
 - Coordinator 负责集成 worker commit 并运行最终门禁；不要在一个 checkout 中混合多个 worker 的未提交改动。
 
 目标：
-- 执行 docs/09-PLANNING/Module-Registry.md 与 docs/09-PLANNING/MODULES/<module-key>/module_plan.md 中为 <module-key> 标记的当前步骤。
+- 执行 coding-agent-harness/planning/modules/Module-Registry.md 与 coding-agent-harness/planning/modules/<module-key>/module_plan.md 中为 <module-key> 标记的当前步骤。
 - 除非触发 stop condition，否则持续推进到该步骤已实现、已验证、已记录，并可进入审查。
 
 冷启动：
 1. 阅读 AGENTS.md。
-2. 阅读 docs/09-PLANNING/Module-Registry.md。
-3. 阅读 docs/09-PLANNING/MODULES/Session-Prompt-Pack.md 或 docs/09-PLANNING/MODULES/<module-key>/session_prompt.md。
-4. 阅读 docs/09-PLANNING/MODULES/<module-key>/module_plan.md。
+2. 阅读 coding-agent-harness/planning/modules/Module-Registry.md。
+3. 阅读 coding-agent-harness/planning/modules/Session-Prompt-Pack.md 或 coding-agent-harness/planning/modules/<module-key>/session_prompt.md。
+4. 阅读 coding-agent-harness/planning/modules/<module-key>/module_plan.md。
 5. 按项目任务阅读矩阵读取本任务涉及文件对应的标准文档。
 
 启动门禁：
@@ -27,9 +27,9 @@
 - 确认当前 checkout/worktree path 是 <worktree-path>，当前分支是 <branch-name>。
 - 编辑前检查 dirty state，不要 revert 无关改动。
 - 如果另一个活跃会话拥有该模块或必需共享文件，停止并记录冲突。
-- 代码编辑前，基于项目 planning 模板创建或更新 docs/09-PLANNING/MODULES/<module-key>/TASKS/<current-step>-<short-name>/task_plan.md，写清范围、验收、验证、分支/worktree 和共享协调。
+- 代码编辑前，基于项目 planning 模板创建或更新 coding-agent-harness/planning/modules/<module-key>/tasks/<current-step>-<short-name>/task_plan.md，写清范围、验收、验证、分支/worktree 和共享协调。
 - 代码编辑前，确认模块任务目录含有 `execution_strategy.md` 与 `visual_map.md`。如缺失，先补齐再实现。
-- 如果 docs/09-PLANNING/MODULES/<module-key>/ 缺少模块级 `execution_strategy.md` 或 `visual_map.md`，在派发 worker 前补齐或更新。
+- 如果 coding-agent-harness/planning/modules/<module-key>/ 缺少模块级 `execution_strategy.md` 或 `visual_map.md`，在派发 worker 前补齐或更新。
 
 分支与工作树：
 - Worktree path: <worktree-path>.
@@ -41,7 +41,7 @@
 写入范围：
 - 允许：<module-write-scope>.
 - 未明确协调前禁止：<shared-or-forbidden-scope>.
-- 共享协调产物：docs/09-PLANNING/MODULES/_shared/TASKS/<id>/task_plan.md，或模块任务计划中的“共享协调”段，必须写明 owner、涉及文件、允许改动、reviewer 和 merge 顺序。
+- 共享协调产物：coding-agent-harness/planning/modules/_shared/tasks/<id>/task_plan.md，或模块任务计划中的“共享协调”段，必须写明 owner、涉及文件、允许改动、reviewer 和 merge 顺序。
 - 如果实现需要触碰允许范围之外的文件，停止并记录所需协调，不要直接编辑。
 
 验证：
@@ -52,14 +52,15 @@
 
 收口：
 - 更新模块计划和模块任务进度。
-- 除非 coordinator 明确分配共享锁，worker session 不得更新 docs/09-PLANNING/Module-Registry.md、docs/Harness-Ledger.md、Closeout SSoT、Regression SSoT 或 Cadence Ledger。
+- 除非 coordinator 明确分配共享锁，worker session 不得更新 coding-agent-harness/planning/modules/Module-Registry.md、coding-agent-harness/governance/generated/Harness-Ledger.md、Closeout Index、Regression SSoT 或 Cadence Ledger。
 - 如果需要全局表更新，在 task_plan.md 或 progress.md 写 Coordinator 交接，并标记 `Global sync status: pending-coordinator-pass`。
-- 只有 coordinator pass 或明确的 shared-lock owner 可以更新 docs/09-PLANNING/Module-Registry.md。
+- 只有 coordinator pass 或明确的 shared-lock owner 可以更新 coding-agent-harness/planning/modules/Module-Registry.md。
 - 汇报状态时区分 `task.state`、`lifecycleState`、`reviewStatus` 和 `closeoutStatus`；`done` 只表示实现步骤完成，不等于 `closed`。
-- 更新 docs/09-PLANNING/MODULES/<module-key>/module_plan.md。
+- 把当前任务 `visual_map.md` 阶段表作为生命周期地图。切片结束时检查当前 gate phase；只有 `Actor` 为 `agent` 的 `Exit Command` 才由 Agent 执行。
+- 更新 coding-agent-harness/planning/modules/<module-key>/module_plan.md。
 - 写 review.md，或记录 review skipped-with-reason。需要人工确认审查完成时，必须通过本地 dashboard workbench，或由 coordinator 执行 `harness review-confirm`；存在开放 P0/P1/P2 finding 时不得确认。
 - 步骤完成时写 walkthrough，并包含 Lessons 反思。
-- Coordinator pass 在任务关闭时更新 Closeout SSoT 和 Lessons 检查。
+- Coordinator pass 在任务关闭时更新 Closeout Index 和 Lessons 检查。
 - Coordinator pass 在行为、测试、架构或流程改变时更新 Regression SSoT 和 Harness Ledger。
 - 验证未通过前不得声明完成；无法解决的残余必须记录 owner 和原因。
 

package/templates-zh-CN/planning/review.md

@@ -78,24 +78,6 @@ Scanner 会根据必需文件、章节、证据和这个严格提交块派生 `m
 
 [如果没有重要发现，明确写：本轮已检查上述证据，未发现阻塞目标的重要发现。]
 
-## Human Review Confirmation（人工审查确认）
-
-本节只能由人工 reviewer，或代表明确人工确认的命令 / workbench 动作填写。Agent 提交审查、自查、subagent 审查都不能满足这个门禁。
-
-| Field | Value |
-| --- | --- |
-| Confirmation ID | [由 review-confirm 生成] |
-| Confirmed At | [timestamp] |
-| Reviewer | [人工 reviewer 姓名] |
-| Reviewer Email | [邮箱，如可用] |
-| Task Key | {{TASK_ID}} |
-| Confirm Text | [必须匹配任务 ID 或命令要求的确认短语] |
-| Evidence Checked | [review packet / tests / diff 摘要] |
-| Commit SHA | [由 review-confirm 生成的确认提交 SHA] |
-| Audit Status | committed / blocked |
-
-任务仍属于缺材料、阻塞或 Lessons 路由时，不要填写本节。`review-confirm` 与 Dashboard Workbench 必须在 Git dirty、提交身份缺失、hook 失败，或写入超出当前任务 `review.md` / `progress.md` 白名单时拒绝确认。
-
 ## 残余风险
 
 | Risk | Owner | Accepted? | Follow-up |

package/templates-zh-CN/planning/task_plan.md

@@ -1,6 +1,7 @@
 # [任务名称]
 
 Task Contract: harness-task/v1
+Task Package Index: required
 
 ## 目标
 
@@ -12,24 +13,11 @@ Task Contract: harness-task/v1
 - 不做什么：[明确排除的内容，避免执行中扩大范围]
 - 主要风险：[当前已知的技术、产品、协作或验证风险]
 
-## 任务信息架构预算
-
-| 预算 | 适用场景 | 必需结构 |
-| --- | --- | --- |
-| simple | 单 owner、无 subagent、证据深度为 L0/L1、不需要正式 review gate | `brief.md`、`task_plan.md`、`visual_map.md`、`progress.md` |
-| standard | 常规功能、修复或文档改动 | `brief.md`、`task_plan.md`、`execution_strategy.md`、`visual_map.md`、`findings.md`、`lesson_candidates.md`、`progress.md`、`review.md` |
-| complex | 需要 L2/L3 证据、subagent/reviewer、外部参考、生成产物，或超过 5 个切片 | standard 文件，并额外创建 `references/INDEX.md` 与 `artifacts/INDEX.md` |
+## 预算选择
 
 选择预算：{{TASK_BUDGET}}
 
-可选子目录按触发条件创建，不作为默认脚手架：
-
-- `lessons/LC-*.md`：进入 `needs-promotion` 的 lesson candidate 的任务本地详情文件。
-- `references/INDEX.md`：任务本地资料、外部链接、reviewer 输入包、跨仓上下文。
-- `artifacts/INDEX.md`：命令输出、截图、fixture、生成报告、审查记录等证据。
-- `slices/<slice-id>/`：多切片任务。每个切片使用 `brief.md`、`evidence.md`、`review.md`。
-
-没有真实触发条件时，不创建可选目录；已创建则必须有 index 和明确用途。
+选择理由：[为什么本任务适合这个预算]
 
 ## 上下文包（Context Packet）
 
@@ -37,54 +25,6 @@ Task Contract: harness-task/v1
 | --- | --- | --- | --- | --- |
 | C-001 | public-doc / private-plan / external / code | PUBLIC:path 或 PRIVATE:path 或 TARGET:path 或 EXTERNAL:path 或 URL:https://example.com | [说明这份上下文如何影响任务] | coordinator / reviewer / worker |
 
-路径前缀约定：
-
-- `PUBLIC:`：公开源仓库中的文件。
-- `PRIVATE:`：私有 harness 仓库中的文件。
-- `TARGET:`：已安装目标项目中的文件。
-- `EXTERNAL:` 或 `URL:`：外部资料。
-
-## 执行与可视化文件
-
-不要手工复制本模板来创建任务目录。必须使用 `harness new-task`，让所选预算自动
-创建正确文件集，并让 `harness check` 能按同一契约校验。
-
-`execution_strategy.md` 和 `visual_map.md` 是本任务的同级合同文件，不嵌入 `task_plan.md`。这样 dashboard 和 checker 可以稳定读取。
-
-| 预算 | 必需文件 |
-| --- | --- |
-| simple | `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` |
-
-文件职责：
-
-| 合同文件 | 用途 |
-| --- | --- |
-| `brief.md` | 面向人和下一轮 agent 的任务摘要与上下文包 |
-| `task_plan.md` | 目标、范围、预算、验收与执行决策 |
-| `execution_strategy.md` | 执行模式、subagent 使用、冲突控制、证据深度、交接规则 |
-| `visual_map.md` | 图表集合：阶段图、可选架构/时序/数据流/状态图、完成度、证据状态、阻塞风险 |
-| `progress.md` | 执行日志、决策和交接 |
-| `findings.md` | 发现、研究记录和未解决风险 |
-| `lesson_candidates.md` | 任务本地教训候选队列。人工审查确认前必须接受无候选、拒绝候选，或排队 promotion |
-| `lessons/LC-*.md` | 可选的任务本地 lesson 详情文件，趁源任务上下文还新鲜写出，并由 `Detail Artifact` 链接 |
-| `review.md` | Agent Review Submission、对抗性审查、release review、外部 reviewer 结论 |
-| `references/INDEX.md` | complex 任务的资料包和参考索引 |
-| `artifacts/INDEX.md` | complex 任务的生成证据和产物索引 |
-| `long-running-task-contract.md` | 连续执行权限、循环规则和停止条件 |
-
-旧任务可以保留历史嵌入式段落作为 fallback；新任务必须使用独立文件。
-
-## 产物索引（Artifact Index）
-
-简单任务可在这里登记关键证据。产物较多时，创建 `artifacts/INDEX.md` 并在此引用 ID。
-
-| Artifact ID | 类型 | 路径 | 摘要 |
-| --- | --- | --- | --- |
-| A-001 | command / diff / fixture / screenshot / review / report | PUBLIC:path 或 PRIVATE:path 或 TARGET:path 或 EXTERNAL:path 或 URL:https://example.com | [这份证据证明了什么] |
-
 ## 步骤
 
 1. [步骤 1]

package/templates-zh-CN/planning/visual_map.md

@@ -14,22 +14,29 @@ Visual Map Contract: v1.0
 
 ```mermaid
 flowchart LR
-  PH01["PH-01 计划确认"] --> PH02["PH-02 实现"]
-  PH02 --> PH03["PH-03 验证"]
-  PH03 --> PH04["PH-04 审查与收口"]
+  INIT01["INIT-01 范围与上下文\nkind=init"] --> EXEC01["EXEC-01 实现切片\nkind=execution"]
+  EXEC01 --> GATE01["GATE-01 Agent 提交审查\nkind=gate"]
+  GATE01 --> GATE02["GATE-02 人工审查确认\nkind=gate"]
 ```
 
 ## 阶段表（Phase Table，表头供 checker 解析）
 
-| Phase ID | Depends On | State | Completion | Output | Required Evidence | Evidence Status | Blocking Risk | Owner / Handoff |
-| --- | --- | --- | ---: | --- | --- | --- | --- | --- |
-| PH-01 | none | planned | 0 | [计划输出] | [必需证据] | missing | none | coordinator |
+| Phase ID | Kind | Depends On | State | Completion | Output | Required Evidence | Exit Command | Actor | Evidence Status | Blocking Risk | Owner / Handoff |
+| --- | --- | --- | --- | ---: | --- | --- | --- | --- | --- | --- | --- |
+| INIT-01 | init | none | planned | 0 | 任务计划和执行策略已确认 | `task_plan.md`; `execution_strategy.md` | `harness task-start {{TASK_ID}}` | agent | missing | none | coordinator |
+| EXEC-01 | execution | INIT-01 | planned | 0 | 有边界的实现、文档切片和验证证据 | diff、commands、worker handoff 或 artifact path | `harness task-phase {{TASK_ID}} EXEC-01 --state done --completion 100 --evidence present` | agent | missing | [risk] | [owner] |
+| GATE-01 | gate | EXEC-01 | planned | 0 | Agent Review Submission | `review.md`、progress update、lesson routing | `harness task-review {{TASK_ID}} --message "<summary>"` | agent | missing | [risk] | coordinator |
+| GATE-02 | gate | GATE-01 | planned | 0 | Human Review Confirmation | review packet 和人工确认 | `harness review-confirm {{TASK_ID}} --confirm {{TASK_ID}}` | human | missing | Agent 不能代办人工确认 | human |
 
 允许的 `State`：`planned`, `in_progress`, `review`, `blocked`, `done`, `skipped`。
 
 允许的 `Evidence Status`：`missing`, `partial`, `present`, `waived`。
 
-`Completion` 使用 `0..100` 的整数；`done` 应为 `100`，`planned` 应为 `0`，`skipped` 不计入 dashboard 总完成度。dashboard 以阶段表计算进度，不从正文推断。
+允许的 `Kind`：`init`, `execution`, `gate`。
+
+允许的 `Actor`：`agent`, `human`, `coordinator`。
+
+`Completion` 使用 `0..100` 的整数；`done` 应为 `100`，`planned` 应为 `0`，`skipped` 不计入 dashboard 总完成度。dashboard 的实现完成度只由非 skipped 的 `execution` 阶段计算；`init` 和 `gate` 阶段表达生命周期门禁、下一步命令和责任人，不拉低实现完成度。
 
 ## 支持性图表（Supporting Maps）
 

package/templates-zh-CN/planning/visual_map.simple.md

@@ -0,0 +1,48 @@
+# Visual Map / 可视化图谱
+
+Visual Map Contract: v1.0
+
+本文件是任务图表集合，不只是阶段路线图。只有对人或 agent 理解任务有实际帮助的图才放进来。
+
+## 图表索引（Map Index）
+
+| ID | Type | Purpose | Required For Understanding | Source Evidence | Promotion Candidate |
+| --- | --- | --- | --- | --- | --- |
+| MAP-01 | phase | 展示执行阶段和依赖关系 | yes | `task_plan.md` | no |
+
+## 阶段关系图（Phase Graph）
+
+```mermaid
+flowchart LR
+  INIT01["INIT-01 范围与上下文\nkind=init"] --> EXEC01["EXEC-01 实现切片\nkind=execution"]
+  EXEC01 --> GATE01["GATE-01 直接完成\nkind=gate"]
+```
+
+## 阶段表（Phase Table，表头供 checker 解析）
+
+| Phase ID | Kind | Depends On | State | Completion | Output | Required Evidence | Exit Command | Actor | Evidence Status | Blocking Risk | Owner / Handoff |
+| --- | --- | --- | --- | ---: | --- | --- | --- | --- | --- | --- | --- |
+| INIT-01 | init | none | planned | 0 | 任务边界已清楚到可以执行 | `task_plan.md` | `harness task-start {{TASK_ID}}` | agent | missing | none | coordinator |
+| EXEC-01 | execution | INIT-01 | planned | 0 | 简单实现或文档变更已完成 | diff、command 或 artifact path | `harness task-phase {{TASK_ID}} EXEC-01 --state done --completion 100 --evidence present` | agent | missing | [risk] | [owner] |
+| GATE-01 | gate | EXEC-01 | planned | 0 | 直接完成任务 | progress update 和最终证据说明 | `harness task-complete {{TASK_ID}} --message "<summary>"` | agent | missing | [risk] | coordinator |
+
+允许的 `State`：`planned`, `in_progress`, `review`, `blocked`, `done`, `skipped`。
+
+允许的 `Evidence Status`：`missing`, `partial`, `present`, `waived`。
+
+允许的 `Kind`：`init`, `execution`, `gate`。
+
+允许的 `Actor`：`agent`, `human`, `coordinator`。
+
+`Completion` 使用 `0..100` 的整数；`done` 应为 `100`，`planned` 应为 `0`，`skipped` 不计入 dashboard 总完成度。dashboard 的实现完成度只由非 skipped 的 `execution` 阶段计算；`init` 和 `gate` 阶段表达生命周期门禁、下一步命令和责任人，不拉低实现完成度。
+
+## 支持性图表（Supporting Maps）
+
+按需添加，不要求每类都存在：
+
+- architecture：模块、组件、服务结构。
+- sequence：前端、后端、服务、数据库、agent 时序。
+- data-flow：数据流转和所有权。
+- state：状态机或生命周期。
+- topology：repo、服务、worker、worktree 拓扑。
+- decision：方案分叉和决策树。

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

@@ -0,0 +1,47 @@
+# 收口记录：{{TASK_TITLE}}
+
+## 摘要
+
+待收口。
+
+## 范围
+
+| 范围 | 详情 |
+| --- | --- |
+| 变更模块 | pending |
+| 新增文件 | pending |
+| 删除文件 | pending |
+| 不在范围内 | pending |
+
+## 验证
+
+| 检查 | 命令或过程 | 结果 | 证据 |
+| --- | --- | --- | --- |
+| pending | pending | not run | pending |
+
+## 审查结论
+
+| 来源 | 重要发现 | 处理 | 证据 |
+| --- | --- | --- | --- |
+| pending | pending | pending | `review.md` |
+
+## 残余风险
+
+| 风险 | Owner | 是否接受 | 跟进 |
+| --- | --- | --- | --- |
+| pending | owner | pending | pending |
+
+## 经验沉淀反思
+
+| 问题 | 答案 |
+| --- | --- |
+| 是否完成经验候选检查？ | pending |
+| 经验候选详情文件 | `lesson_candidates.md` |
+
+## 收口链接
+
+| 产物 | 链接 |
+| --- | --- |
+| 任务计划 | `task_plan.md` |
+| 审查记录 | `review.md` |
+| 进度记录 | `progress.md` |

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

@@ -7,7 +7,7 @@
 审查报告默认写入：
 
 ```text
-docs/09-PLANNING/TASKS/<YYYY-MM-DD-任务名>/review.md
+coding-agent-harness/planning/tasks/<YYYY-MM-DD-任务名>/review.md
 ```
 
 审查路由由 `review-routing-standard.md` 决定；本文件只规定审查报告怎么写、什么结论可以收口。
@@ -86,4 +86,4 @@ No material findings. 当前证据覆盖了本轮 stop condition，未发现阻
 - 缺少 `Confidence Challenge` 或 `Final Confidence Basis`。
 - 缺少 `Evidence Checked`，或证据只来自聊天记录。
 - finding 修复后没有重跑对应证据。
-- walkthrough、Closeout SSoT 或 Harness Ledger 没有引用审查结果或跳过原因。
+- walkthrough、Closeout Index 或 Harness Ledger 没有引用审查结果或跳过原因。

package/templates-zh-CN/reference/delivery-operating-model-standard.md

@@ -21,8 +21,8 @@
 | 层级 | 负责人 | 主要产物 | 规则 |
 | --- | --- | --- | --- |
 | 路线图 | product / tech lead / owner | roadmap、release plan | 只放阶段目标，不替代任务计划。 |
-| 功能块 | coordinator / feature lead | `docs/09-PLANNING/Delivery-SSoT.md` 或功能 SSoT | 标明 owner、依赖、集成顺序。 |
-| 任务 | task owner | `docs/09-PLANNING/TASKS/<task>/task_plan.md` | 每个任务有目标、范围、证据和 stop condition。 |
+| 功能块 | coordinator / feature lead | `coding-agent-harness/planning/Delivery-SSoT.md` 或功能 SSoT | 标明 owner、依赖、集成顺序。 |
+| 任务 | task owner | `coding-agent-harness/planning/tasks/<task>/task_plan.md` | 每个任务有目标、范围、证据和 stop condition。 |
 | 审查 | reviewer / subagent / human | `review.md` 或 PR review | 按审查路由执行，不只留在聊天里。 |
 | 集成 | coordinator / maintainer | PR、integration branch、release branch | 由集成 owner 决定 merge 顺序和最终 gates。 |
 
@@ -40,7 +40,7 @@
 
 ## 交付单一事实源要求
 
-以下任一条件成立时，必须维护 `docs/09-PLANNING/Delivery-SSoT.md`：
+以下任一条件成立时，必须维护 `coding-agent-harness/planning/Delivery-SSoT.md`：
 
 - 多人或多 agent 并行开发。
 - 多仓或前后端分离协作。