coding-agent-harness 1.0.4 → 1.0.6

package/references/long-running-task-standard.md

@@ -105,7 +105,7 @@
 必须先升级为 worker 并补齐 worktree 合同。
 
 如果 review loop 使用 reviewer agent、subagent 或外部审查者，必须在任务目录写
-`review.md`，并按 `docs/11-REFERENCE/adversarial-review-standard.md` 记录 material findings、
+`review.md`，并按 `coding-agent-harness/governance/standards/adversarial-review-standard.md` 记录 material findings、
 no-finding statement、evidence checked 和 residual risk。
 
 ### Evidence Depth
@@ -200,10 +200,10 @@ no-finding statement、evidence checked 和 residual risk。
 
 一个项目安装 harness 后，应做到：
 
-- `AGENTS.md` 的 Task-Type Reading Matrix 指向 `docs/11-REFERENCE/long-running-task-standard.md`
-- `docs/09-PLANNING/TASKS/_task-template/` 包含 long-running task contract 模板
-- `docs/09-PLANNING/TASKS/_task-template/` 包含 `review.md` 模板
-- `docs/11-REFERENCE/adversarial-review-standard.md` 定义 reviewer 报告规范
+- `AGENTS.md` 的 Task-Type Reading Matrix 指向 `coding-agent-harness/governance/standards/long-running-task-standard.md`
+- `coding-agent-harness/planning/tasks/_task-template/` 包含 long-running task contract 模板
+- `coding-agent-harness/planning/tasks/_task-template/` 包含 `review.md` 模板
+- `coding-agent-harness/governance/standards/adversarial-review-standard.md` 定义 reviewer 报告规范
 - `execution-workflow-standard.md` 在开始任务前要求判断是否属于长程任务
 - regression / testing 标准能提供可复查证据，而不是只依赖主观判断
-- `docs/Harness-Ledger.md` 记录长程任务是否完成必要的上下文回写
+- `coding-agent-harness/governance/generated/Harness-Ledger.md` 记录长程任务是否完成必要的上下文回写

package/references/module-parallel-standard.md

@@ -25,7 +25,7 @@
 
 ## 模块注册表（Module Registry）
 
-安装位置：`docs/09-PLANNING/Module-Registry.md`
+安装位置：`coding-agent-harness/planning/modules/Module-Registry.md`
 
 使用模板：`templates/ssot/Module-Registry.md`
 
@@ -43,20 +43,20 @@
 
 ## 模块计划（Module Plan）
 
-安装位置：`docs/09-PLANNING/MODULES/<key>/module_plan.md`
+安装位置：`coding-agent-harness/planning/modules/<key>/module_plan.md`
 
 使用模板：`templates/planning/module_plan.md`
 
 职责：
 - 记录该模块的步骤序列、当前进度、完成标准
-- 每个步骤对应一个 task_plan（在模块的 TASKS/ 子目录下）
+- 每个步骤对应一个 task_plan（在模块的 tasks/ 子目录下）
 
 ## 模块会话启动 Prompt（Module Session Prompt）
 
 安装位置由项目选择，推荐二选一：
 
-- 单文件 Prompt Pack：`docs/09-PLANNING/MODULES/Session-Prompt-Pack.md`
-- 每模块 Prompt：`docs/09-PLANNING/MODULES/<key>/session_prompt.md`
+- 单文件 Prompt Pack：`coding-agent-harness/planning/modules/Session-Prompt-Pack.md`
+- 每模块 Prompt：`coding-agent-harness/planning/modules/<key>/session_prompt.md`
 
 使用模板：`templates/planning/module_session_prompt.md`
 
@@ -73,16 +73,16 @@
 - Prompt 必须写清楚至少一个项目级 check 和该模块的 targeted checks。
 - Prompt 必须包含 start gate：校验 registry 当前步骤、branch/worktree、dirty state、共享锁和过期 prompt。
 - Prompt 必须要求开始改代码前创建或更新模块 task_plan，并记录 scope、acceptance、verification、worktree 和 shared coordination。
-- Prompt 必须包含 closeout：review.md 或 skipped-with-reason、walkthrough Lessons Reflection、Closeout SSoT、Lessons Check、Regression SSoT / Harness Ledger 条件更新。
+- Prompt 必须包含 closeout：review.md 或 skipped-with-reason、walkthrough Lessons Reflection、Closeout Index、Lessons Check、Regression SSoT / Harness Ledger 条件更新。
 - Prompt 中不得要求 agent 修改其他模块代码；需要跨模块文件时，必须先进入 `_shared` task 或指定单一 owner。
 
 ## 模块目录结构
 
 ```
-docs/09-PLANNING/MODULES/<key>/
+coding-agent-harness/planning/modules/<key>/
 ├── module_plan.md          ← 模块总览和步骤序列
 ├── session_prompt.md       ← 可选：该模块专用启动 prompt
-└── TASKS/                  ← 该模块的所有 task
+└── tasks/                  ← 该模块的所有 task
     ├── <PREFIX>-NN-<name>/
     │   ├── task_plan.md
     │   ├── progress.md
@@ -90,13 +90,13 @@ docs/09-PLANNING/MODULES/<key>/
     │   └── review.md (如需要)
     └── ...
 
-docs/10-WALKTHROUGH/
+task-local walkthrough.md/
 ├── <module-key>/
 │   ├── <PREFIX>-NN-walkthrough.md
 │   └── ...
 └── _shared/               ← 跨模块基础设施 task 的 walkthrough
 
-docs/09-PLANNING/MODULES/_shared/TASKS/
+coding-agent-harness/planning/modules/_shared/tasks/
 └── YYYY-MM-DD-<name>/     ← 跨模块/基础设施 task
     └── ...
 ```
@@ -113,25 +113,25 @@ docs/09-PLANNING/MODULES/_shared/TASKS/
 新会话的读取顺序：
 
 1. `AGENTS.md` — 获取项目总览和模块并行指引
-2. `docs/09-PLANNING/Module-Registry.md` — 了解全局模块状态
-3. `docs/09-PLANNING/MODULES/Session-Prompt-Pack.md` 或目标模块的 `session_prompt.md` — 获取会话启动合同
-4. 目标模块的 `docs/09-PLANNING/MODULES/<key>/module_plan.md` — 了解模块进度
+2. `coding-agent-harness/planning/modules/Module-Registry.md` — 了解全局模块状态
+3. `coding-agent-harness/planning/modules/Session-Prompt-Pack.md` 或目标模块的 `session_prompt.md` — 获取会话启动合同
+4. 目标模块的 `coding-agent-harness/planning/modules/<key>/module_plan.md` — 了解模块进度
 5. 当前步骤的 `task_plan.md` — 了解具体任务
 
 会话开始时，用户告知目标模块（如"做 Reader"），agent 据此定位。
 
 会话结束时必须更新：
 - module_plan.md 的步骤状态和"当前状态"段落
-- 模块 TASKS 下的 progress / findings / review / walkthrough 相关引用
-- 模块 TASKS 下的 Coordinator Handoff，列出需要 coordinator 同步到总表的 registry / ledger / closeout 项
+- 模块 tasks 下的 progress / findings / review / walkthrough 相关引用
+- 模块 tasks 下的 Coordinator Handoff，列出需要 coordinator 同步到总表的 registry / ledger / closeout 项
 
 模块 worker 默认不得写全局总表：
 
-- `docs/09-PLANNING/Module-Registry.md`
-- `docs/Harness-Ledger.md`
-- `docs/10-WALKTHROUGH/Closeout-SSoT.md`
-- `docs/05-TEST-QA/Regression-SSoT.md`
-- `docs/05-TEST-QA/Cadence-Ledger.md`
+- `coding-agent-harness/planning/modules/Module-Registry.md`
+- `coding-agent-harness/governance/generated/Harness-Ledger.md`
+- `coding-agent-harness/governance/generated/Closeout-Index.md`
+- `coding-agent-harness/governance/regression/Regression-SSoT.md`
+- `coding-agent-harness/governance/regression/Cadence-Ledger.md`
 
 这些文件只有 coordinator pass 或显式 shared lock owner 能写。模块 worker 需要总表同步时，只在模块任务的
 `progress.md` / `task_plan.md` 中写 `Coordinator Handoff`，状态使用
@@ -144,9 +144,9 @@ docs/09-PLANNING/MODULES/_shared/TASKS/
 
 本项目启用了模块并行开发。开始任何模块工作前：
 
-1. 读 docs/09-PLANNING/Module-Registry.md 了解全局状态
-2. 读 docs/09-PLANNING/MODULES/Session-Prompt-Pack.md 或目标模块的 session_prompt.md
-3. 读目标模块的 docs/09-PLANNING/MODULES/<key>/module_plan.md
+1. 读 coding-agent-harness/planning/modules/Module-Registry.md 了解全局状态
+2. 读 coding-agent-harness/planning/modules/Session-Prompt-Pack.md 或目标模块的 session_prompt.md
+3. 读目标模块的 coding-agent-harness/planning/modules/<key>/module_plan.md
 4. 在模块对应的 worktree 上工作
 5. 不跨模块修改文件（不修改 write scope 之外的代码）
 6. 如果作为 worker subagent 改代码/测试/文档，必须在 coordinator 分配的独立 worktree / branch 中工作，提交自己的 commit，并 handoff commit SHA / checks / residual risks
@@ -163,7 +163,7 @@ docs/09-PLANNING/MODULES/_shared/TASKS/
 - 发布 = git tag + merge 到 main 的一批模块步骤
 - 在 git tag message 中列出包含的步骤 ID
 - 示例：`git tag -a v0.3.0 -m "Release 3: RDR-01, RDR-02, GRF-01, MOT-01"`
-- 如需更正式的发布管理，可选创建 `docs/09-PLANNING/releases/` 目录
+- 如需更正式的发布管理，可选创建 `coding-agent-harness/planning/releases/` 目录
 
 ## 共享文件冲突规则
 
@@ -188,10 +188,10 @@ shell、data layer、design system 等共享基础设施的修改：
 
 最小协调产物：
 
-- `_shared` task：`docs/09-PLANNING/MODULES/_shared/TASKS/<id>/task_plan.md`
+- `_shared` task：`coding-agent-harness/planning/modules/_shared/tasks/<id>/task_plan.md`
 - 或模块 task_plan 中的 `Shared Coordination` 段落，必须写明 owner、touched files、allowed change、reviewer、merge order。
 
-Module Registry 本身也是 shared lock。活跃模块会话默认更新自己的 module_plan 和 TASKS；Registry 的 Current Step / Status 只在持锁或 coordinator pass 中更新，避免多个会话同时改同一个表。
+Module Registry 本身也是 shared lock。活跃模块会话默认更新自己的 module_plan 和 tasks；Registry 的 Current Step / Status 只在持锁或 coordinator pass 中更新，避免多个会话同时改同一个表。
 
 Checker 必须反向扫描模块任务目录：
 
@@ -203,7 +203,7 @@ Checker 必须反向扫描模块任务目录：
 严格模式命令：
 
 ```bash
-HARNESS_REQUIRE_GLOBAL_MODULE_SYNC=1 node scripts/check-harness.mjs <repo-path>
+HARNESS_REQUIRE_GLOBAL_MODULE_SYNC=1 node dist/check-harness.mjs <repo-path>
 ```
 
 这条规则的目的不是让每个 worker 都改总表，而是让总表同步变成单一 owner 的串行步骤。
@@ -218,7 +218,7 @@ HARNESS_REQUIRE_GLOBAL_MODULE_SYNC=1 node scripts/check-harness.mjs <repo-path>
 4. 各模块 worktree rebase 到最新主干
 5. 可选：在 Module Registry 标注 `infra-task-pending: true`，提醒各模块会话 rebase
 
-基础设施 task 的文件放在 `docs/09-PLANNING/MODULES/_shared/TASKS/` 下。
+基础设施 task 的文件放在 `coding-agent-harness/planning/modules/_shared/tasks/` 下。
 
 ## 模块级 Worktree
 
@@ -253,7 +253,7 @@ HARNESS_REQUIRE_GLOBAL_MODULE_SYNC=1 node scripts/check-harness.mjs <repo-path>
 
 切换时必须归档 legacy 生命周期表：
 
-- `Feature-SSoT.md` / `Private-Feature-SSoT.md` 移到 `docs/09-PLANNING/_archive/`。
+- `Feature-SSoT.md` / `Private-Feature-SSoT.md` 移到 `coding-agent-harness/planning/_archive/`。
 - Phase 历史和 completed 明细作为历史证据保留，不再作为 active 表继续维护。
 - 使用 `harness governance rebuild --archive --apply` 从 task / module 文件重建 Harness Ledger、module plan 和 visual map 索引。
 - 不允许把历史大表留在 active 生命周期入口底部作为"文件内归档"；这会让 Agent 继续读取旧状态。
@@ -263,8 +263,8 @@ HARNESS_REQUIRE_GLOBAL_MODULE_SYNC=1 node scripts/check-harness.mjs <repo-path>
 ### 归档
 
 - 模块所有步骤完成后，状态改为 `completed`
-- 将模块目录移入 `docs/09-PLANNING/MODULES/_archive/<key>/`
-- 对应的 walkthrough 保留在 `docs/10-WALKTHROUGH/<key>/`（不归档）
+- 将模块目录移入 `coding-agent-harness/planning/modules/_archive/<key>/`
+- 对应的 walkthrough 保留在 `walkthrough.md/`（不归档）
 
 ### 过期检测
 
@@ -277,9 +277,9 @@ HARNESS_REQUIRE_GLOBAL_MODULE_SYNC=1 node scripts/check-harness.mjs <repo-path>
 对已有线性 Phase 历史的项目：
 
 1. 冻结 legacy 生命周期表当前状态，标注"后续工作按模块推进"
-2. 将 `Feature-SSoT.md` / `Private-Feature-SSoT.md` 历史明细移入 `docs/09-PLANNING/_archive/`
-3. 将历史 `docs/09-PLANNING/TASKS/` 移入 `docs/09-PLANNING/_archive/`
-4. 将历史 walkthrough 移入 `docs/10-WALKTHROUGH/_archive/`
+2. 将 `Feature-SSoT.md` / `Private-Feature-SSoT.md` 历史明细移入 `coding-agent-harness/planning/_archive/`
+3. 将历史 `coding-agent-harness/planning/tasks/` 移入 `coding-agent-harness/planning/_archive/`
+4. 将历史 walkthrough 移入 `coding-agent-harness/governance/archive/legacy-walkthrough/`
 5. 从最后一个 Phase 的未完成项中识别模块
 6. 创建 Module Registry 和各模块的 module_plan.md
 7. 创建 Module Session Prompt Pack 或每模块 `session_prompt.md`

package/references/planning-loop.md

@@ -17,7 +17,7 @@
 `trivial` 不进入 CLI：小到不值得建立任务目录的修改，可以直接执行并在 commit 或交付说明中写清楚原因。
 
 ```
-docs/09-PLANNING/TASKS/<YYYY-MM-DD-任务名>/
+coding-agent-harness/planning/tasks/<YYYY-MM-DD-任务名>/
 ├── task_plan.md    ← 计划：目标、范围、步骤、验收标准
 ├── execution_strategy.md ← 执行策略：模式、subagent、冲突控制、验证深度、handoff
 ├── visual_map.md ← 图表集合：阶段图、架构图、时序图、数据流、状态机、完成度、证据状态
@@ -118,11 +118,11 @@ the same contract.
 
 当项目启用模块并行开发（见 `references/module-parallel-standard.md`）时：
 
-- 任务目录位于模块内：`docs/09-PLANNING/MODULES/<key>/TASKS/<PREFIX>-NN-<name>/`
-- 跨模块基础设施任务位于：`docs/09-PLANNING/MODULES/_shared/TASKS/YYYY-MM-DD-<name>/`
+- 任务目录位于模块内：`coding-agent-harness/planning/modules/<key>/tasks/<PREFIX>-NN-<name>/`
+- 跨模块基础设施任务位于：`coding-agent-harness/planning/modules/_shared/tasks/YYYY-MM-DD-<name>/`
 - task_plan.md 应填写"模块关联"段（Module、Step、Module Plan link）
 - 会话结束时除了更新 progress.md，还需更新 module_plan.md。
-- 模块 worker 不直接写 Module Registry / Harness Ledger / Closeout SSoT。需要总表同步时，在 task_plan.md 或 progress.md 的 `Coordinator Handoff` 段标记 `pending-coordinator-pass`，由 coordinator 串行同步。
+- 模块 worker 不直接写 Module Registry / Harness Ledger / Closeout Index。需要总表同步时，在 task_plan.md 或 progress.md 的 `Coordinator Handoff` 段标记 `pending-coordinator-pass`，由 coordinator 串行同步。
 - coordinator pass 完成后，才更新 Module Registry、Harness Ledger、必要的 Closeout / Regression 表，并把 handoff 标记为 `synced`。
 
 ## 为什么这套东西有效
@@ -214,7 +214,7 @@ standard / complex:
 
 每次状态变更时，必须更新 task-local facts，例如 `progress.md`、`review.md` 或 `lesson_candidates.md`。任务生命周期总表由 lifecycle CLI 或 `harness governance rebuild` 生成，不手工维护 Feature lifecycle 表。
 
-任务完成时，必须在 `docs/Harness-Ledger.md` 中记录本轮 task plan、SSoT、
+任务完成时，必须在 `coding-agent-harness/governance/generated/Harness-Ledger.md` 中记录本轮 task plan、SSoT、
 walkthrough、Lessons 检查等上下文回写结果。
 
 ## Commit Convention
@@ -228,7 +228,7 @@ walkthrough、Lessons 检查等上下文回写结果。
 ```text
 feat: implement task review gate
 
-Harness: TASKS/2026-05-21-task-review-gate
+Harness: tasks/2026-05-21-task-review-gate
 ```
 
 格式：`Harness: <task-id>`，其中 task-id 是 `task-list --json` 输出的 `id` 字段。

package/references/project-onboarding-audit.md

@@ -22,7 +22,7 @@
 
 ### 3. 现有文档
 - 有没有 AGENTS.md / CLAUDE.md / COPILOT.md？
-- 有没有 docs/ 目录？结构如何？
+- 有没有 coding-agent-harness/ 目录？结构如何？
 - 有没有 README 以外的开发文档？
 - 有没有架构设计文档？
 - 如果项目属于微服务、多仓或前后端分仓，用户是否有外部服务文档、接口文档、架构图、会议纪要、链接或导出包？
@@ -58,7 +58,7 @@
 - 是否是前后端分仓、app/service 分仓或 program 多仓？
 - 前端 agent 是否只能看到 API 文档 / mock / schema？后端 agent 是否只能看到消费合同？
 - 当前使用敏捷 sprint、kanban 连续流、瀑布 stage-gate，还是个人连续执行？
-- 是否需要 `docs/09-PLANNING/Delivery-SSoT.md` 记录 feature block owner、依赖、集成顺序和 acceptance gates？
+- 是否需要 `coding-agent-harness/planning/Delivery-SSoT.md` 记录 feature block owner、依赖、集成顺序和 acceptance gates？
 
 ### 6b. Repo Governance
 - repo platform 是 GitHub / GitLab / local-only / 其他？
@@ -91,7 +91,7 @@
 | 维度 | 现状 | 评级 |
 |------|------|------|
 | AGENTS.md | [有/无/需改造] | 🟢/🟡/🔴 |
-| docs/ 目录 | [有/无/需改造] | 🟢/🟡/🔴 |
+| coding-agent-harness/ 目录 | [有/无/需改造] | 🟢/🟡/🔴 |
 | Reference 标准 | [有/无/需改造] | 🟢/🟡/🔴 |
 | Planning Loop | [有/无/需改造] | 🟢/🟡/🔴 |
 | Delivery Operating Model | [solo/team/split-repo/program/waterfall/kanban/需确认] | 🟢/🟡/🔴 |
@@ -139,7 +139,7 @@
 
 最小配置：
 - AGENTS.md
-- docs/11-REFERENCE/ 下 2-3 个标准文件
+- coding-agent-harness/governance/standards/ 下 2-3 个标准文件
 - Delivery Operating Model 标准，明确是否为 `solo-orchestrator`
 - Planning task plan / findings / progress / review 模板
 - repo governance / CI-CD 标准和 residual

package/references/regression-system.md

@@ -49,7 +49,7 @@
 
 | Archive | Range | Notes |
 |---------|-------|-------|
-| `docs/05-TEST-QA/_archive/Regression-SSoT-archive-YYYY-QN.md` | RG-XXX-RG-YYY | retired gates |
+| `coding-agent-harness/governance/regression/_archive/Regression-SSoT-archive-YYYY-QN.md` | RG-XXX-RG-YYY | retired gates |
 ```
 
 ## Cadence Ledger
@@ -86,4 +86,4 @@ Harness Ledger 只在当前任务收口时记录 `Regression=updated`、`Regress
 6. 持续迭代：每次新增 surface 或 evidence depth 提升时更新 SSoT
 
 废弃 gate 或过期 shared batch 明细不要长期堆在 Active 表底部；移动到
-`docs/05-TEST-QA/_archive/`，并在 Regression SSoT 中保留 Archive Index。
+`coding-agent-harness/governance/regression/_archive/`，并在 Regression SSoT 中保留 Archive Index。

package/references/repo-governance-standard.md

@@ -13,13 +13,13 @@ Harness 不是只生成文档骨架。每个项目必须有项目级 repository
 标准文件：
 
 ```text
-docs/11-REFERENCE/repo-governance-standard.md
+coding-agent-harness/governance/standards/repo-governance-standard.md
 ```
 
 如果项目需要更详细的 CI/CD 说明，另见：
 
 ```text
-docs/11-REFERENCE/ci-cd-standard.md
+coding-agent-harness/governance/standards/ci-cd-standard.md
 ```
 
 ## 必填字段
@@ -46,7 +46,7 @@ docs/11-REFERENCE/ci-cd-standard.md
 
 - PR required before merge: [yes / no]
 - PR title format
-- PR body requirements. Use `docs/11-REFERENCE/pull-request-standard.md` for
+- PR body requirements. Use `coding-agent-harness/governance/standards/pull-request-standard.md` for
   the required bilingual structure, version impact, verification, review
   evidence, residual risk, and references.
 - Required reviewers
@@ -137,6 +137,6 @@ Bootstrap is not complete unless repository governance is at least:
 
 ## Related Standards
 
-- `docs/11-REFERENCE/pull-request-standard.md` — PR body structure, bilingual
+- `coding-agent-harness/governance/standards/pull-request-standard.md` — PR body structure, bilingual
   requirements, version impact, verification, review evidence, residual risk,
   and references.

package/references/review-routing-standard.md

@@ -63,7 +63,7 @@ Reviewer subagent 在单个任务内默认允许，可重复用于只读审查
 
 1. 在当前任务的 `review.md` 记录触发来源和审查范围。
 2. 如果是一次性审查，按本轮任务执行。
-3. 如果用户希望长期遵循，创建或更新项目级 `docs/11-REFERENCE/review-routing-standard.md`。
+3. 如果用户希望长期遵循，创建或更新项目级 `coding-agent-harness/governance/standards/review-routing-standard.md`。
 4. 在 `AGENTS.md` 的 Task-Type Reading Matrix 中加入 reviewer routing 入口。
 5. 在 Harness Ledger 记录该规则变更。
 

package/references/ssot-governance.md

@@ -2,7 +2,7 @@
 
 ## 核心思路
 
-SSoT（Single Source of Truth，单一事实源）保存当前事实。任务生命周期状态现在由任务本地文件承载，并由 Harness CLI 生成 `docs/Harness-Ledger.md`，避免 Agent 或人手写多张重复进度表。
+SSoT（Single Source of Truth，单一事实源）保存当前事实。任务生命周期状态现在由任务本地文件承载，并由 Harness CLI 生成 `coding-agent-harness/governance/generated/Harness-Ledger.md`，避免 Agent 或人手写多张重复进度表。
 
 ## 当前治理表
 
@@ -10,7 +10,7 @@ SSoT（Single Source of Truth，单一事实源）保存当前事实。任务生
 
 管理多人、多 agent、多仓或传统流程下的 feature block 分配、依赖和集成顺序。
 
-- 文件：`docs/09-PLANNING/Delivery-SSoT.md`
+- 文件：`coding-agent-harness/planning/Delivery-SSoT.md`
 - 职责：谁负责哪个 feature block、agent 能看哪些上下文、依赖和 merge 顺序是什么
 - 规则：多人、多仓、split-repo、program、waterfall 或 kanban 团队流程必须维护
 
@@ -18,7 +18,7 @@ SSoT（Single Source of Truth，单一事实源）保存当前事实。任务生
 
 管理所有 regression surface 的状态、证据深度和残项。
 
-- 文件：`docs/05-TEST-QA/Regression-SSoT.md`
+- 文件：`coding-agent-harness/governance/regression/Regression-SSoT.md`
 - 职责：哪些回归面存在、每条的标准入口、当前证据深度、residual
 - 规则：新增固定 gate 或 evidence depth 变化时必须更新
 
@@ -26,7 +26,7 @@ SSoT（Single Source of Truth，单一事实源）保存当前事实。任务生
 
 管理需要周期性复查的回归、release、migration 或环境检查。
 
-- 文件：`docs/05-TEST-QA/Cadence-Ledger.md`
+- 文件：`coding-agent-harness/governance/regression/Cadence-Ledger.md`
 - 职责：哪些检查需要按节奏重跑、最近一次证据是什么、下一次应该何时触发
 - 规则：新增或改变周期性 gate 时必须更新
 
@@ -34,15 +34,15 @@ SSoT（Single Source of Truth，单一事实源）保存当前事实。任务生
 
 管理模块边界、owner、worktree 和写入范围。
 
-- 文件：`docs/09-PLANNING/Module-Registry.md`
+- 文件：`coding-agent-harness/planning/modules/Module-Registry.md`
 - 职责：模块 key、路径范围、负责人、状态、worktree、模块计划和依赖
 - 规则：启用模块并行时必须维护；模块内步骤进度由 module plan / module visual map 的生成索引表达
 
-### Closeout SSoT（收口表）
+### Closeout Index（收口表）
 
 管理任务是否有 walkthrough、Lessons Check 和受控 skip reason。
 
-- 文件：`docs/10-WALKTHROUGH/Closeout-SSoT.md`
+- 文件：`coding-agent-harness/governance/generated/Closeout-Index.md`
 - 职责：任务收口状态、walkthrough 路径、lesson 结果和 residual
 - 规则：非平凡任务完成或关闭时必须维护
 
@@ -50,7 +50,7 @@ SSoT（Single Source of Truth，单一事实源）保存当前事实。任务生
 
 管理 Agent 在开发过程中发现的经验、改进建议和规范演进。
 
-- 文件：任务本地 `lesson_candidates.md` 与 `docs/01-GOVERNANCE/lessons/*.md`
+- 文件：任务本地 `lesson_candidates.md` 与 `coding-agent-harness/governance/lessons/*.md`
 - 职责：哪些经验值得沉淀、人工如何判定、哪些 lesson 已提升为详情文档
 - 规则：Walkthrough 收口后检查是否有沉淀建议；promotion 前必须查重 candidate 和 detail doc
 - 详细治理规范：`references/lessons-governance.md`
@@ -59,7 +59,7 @@ SSoT（Single Source of Truth，单一事实源）保存当前事实。任务生
 
 管理任务生命周期的可扫描汇总。
 
-- 文件：`docs/Harness-Ledger.md`
+- 文件：`coding-agent-harness/governance/generated/Harness-Ledger.md`
 - 职责：从任务本地事实生成 scope、module、task、state、queues、plan、review、lesson、closeout、residual
 - 规则：由 Harness CLI 生成；不要手写任务生命周期行
 - 详细规范：`references/harness-ledger.md`
@@ -71,8 +71,8 @@ SSoT（Single Source of Truth，单一事实源）保存当前事实。任务生
 ## 分工规则
 
 - Delivery SSoT 不替代 Regression SSoT；它管交付组织和集成顺序。
-- Regression SSoT 不替代 Closeout SSoT；它管验证面和证据深度。
-- Closeout SSoT 不替代 task-local `lesson_candidates.md`；它只记录收口状态。
+- Regression SSoT 不替代 Closeout Index；它管验证面和证据深度。
+- Closeout Index 不替代 task-local `lesson_candidates.md`；它只记录收口状态。
 - Module Registry 不替代 module plan；它登记模块边界和 owner。
 - Harness Ledger 不替代上述治理表；它只生成任务生命周期索引。
 - 任务生命周期状态不要同时维护在旧 Feature 表和新 Ledger 中。
@@ -92,14 +92,14 @@ SSoT（Single Source of Truth，单一事实源）保存当前事实。任务生
 
 | 表 | Active 保留 | 归档触发 | 归档位置 |
 |------|-------------|----------|----------|
-| Legacy Feature / Private Feature 生命周期表 | 不再作为 active 表保留 | 迁移到 ledger-only 版本 | `docs/09-PLANNING/_archive/` |
-| Delivery SSoT | 当前交付 block、集成顺序和阻塞项 | wave 结束或 completed/superseded blocks 超过 20 条 | `docs/09-PLANNING/_archive/` |
-| Module Registry | 活跃 / 暂停不久的模块 | 模块 completed 或 paused 超过 60 天 | `docs/09-PLANNING/MODULES/_archive/<key>/` |
-| Regression SSoT | active gates | gate 废弃或长期不再运行 | `docs/05-TEST-QA/_archive/` |
-| Cadence Ledger | active cadence checks | cadence 废弃或合并到其他 gate | `docs/05-TEST-QA/_archive/` |
-| Closeout SSoT | 当前 closeout 索引 | closed/superseded 超过保留窗口 | `docs/10-WALKTHROUGH/_archive/` |
-| Lesson detail docs | pending / approved / superseded 详情文档 | merged/rejected 超过 20 条 | `docs/01-GOVERNANCE/_archive/` |
-| Harness Ledger | 当前生成索引 | 重新生成前 archive 旧快照 | `docs/01-GOVERNANCE/_archive/` 或迁移会话 archive |
+| Legacy Feature / Private Feature 生命周期表 | 不再作为 active 表保留 | 迁移到 ledger-only 版本 | `coding-agent-harness/planning/_archive/` |
+| Delivery SSoT | 当前交付 block、集成顺序和阻塞项 | wave 结束或 completed/superseded blocks 超过 20 条 | `coding-agent-harness/planning/_archive/` |
+| Module Registry | 活跃 / 暂停不久的模块 | 模块 completed 或 paused 超过 60 天 | `coding-agent-harness/planning/modules/_archive/<key>/` |
+| Regression SSoT | active gates | gate 废弃或长期不再运行 | `coding-agent-harness/governance/regression/_archive/` |
+| Cadence Ledger | active cadence checks | cadence 废弃或合并到其他 gate | `coding-agent-harness/governance/regression/_archive/` |
+| Closeout Index | 当前 closeout 索引 | closed/superseded 超过保留窗口 | `coding-agent-harness/governance/archive/legacy-walkthrough/` |
+| Lesson detail docs | pending / approved / superseded 详情文档 | merged/rejected 超过 20 条 | `coding-agent-harness/governance/_archive/` |
+| Harness Ledger | 当前生成索引 | 重新生成前 archive 旧快照 | `coding-agent-harness/governance/_archive/` 或迁移会话 archive |
 
 归档不改变 ID，不删除证据文件；Active 文件必须留下 archive index 或指向归档文件。
 

package/references/taskr-gap-analysis.md

@@ -16,7 +16,7 @@
 | 定位 | Repo-local **任务协议** + 轻量工作流 | 项目级 **工程方法论** + 完整 harness 体系 |
 | 粒度 | 单任务卡片级别（一个 md 文件 = 一个任务） | 项目 / wave / feature 级别（多文件协作体系） |
 | 目标用户 | 任何用 AI coding agent 的人 | 需要长程项目工程化支撑的团队 |
-| 核心产出 | `.taskr/tasks/*.md` | `docs/` 完整骨架 + SSoT + Ledger + Walkthrough |
+| 核心产出 | `.taskr/tasks/*.md` | `coding-agent-harness/` 完整骨架 + SSoT + Ledger + Walkthrough |
 | 产品形态 | Skill + npm CLI + 本地看板 + VS Code 插件 | Skill（纯文档协议，无代码工具） |
 | 默认重量 | **轻量优先**（checklist 够了就不加仪式） | **完整优先**（12 个 Phase 全走一遍） |
 
@@ -211,7 +211,7 @@ verification:
 **建议吸收方式**：
 扩展为 Harness 级别的 doctor，检查项包括：
 - `AGENTS.md` / `CLAUDE.md` 存在且非空
-- `docs/` 目录结构是否符合标准
+- `coding-agent-harness/` 目录结构是否符合标准
 - 三张 SSoT 文件存在
 - Harness Ledger 存在
 - 任务目录下的 task_plan 是否通过 validate
@@ -345,9 +345,9 @@ verification:
 
 **建议吸收方式**（两条路选一条）：
 
-**路线 A（轻量）**：扩展现有 `harness-dashboard.html`，增加任务视图页签，读 `docs/09-PLANNING/TASKS/` 目录下的任务文件。
+**路线 A（轻量）**：扩展现有 `harness-dashboard.html`，增加任务视图页签，读 `coding-agent-harness/planning/tasks/` 目录下的任务文件。
 
-**路线 B（对齐）**：把 Taskr 的 board 直接集成进来，让它同时读 `.taskr/` 和我们的 `docs/09-PLANNING/TASKS/`。Taskr 是 MIT 开源，可以直接用。
+**路线 B（对齐）**：把 Taskr 的 board 直接集成进来，让它同时读 `.taskr/` 和我们的 `coding-agent-harness/planning/tasks/`。Taskr 是 MIT 开源，可以直接用。
 
 **注意**：Board 是 nice-to-have，不是核心方法论差异。核心价值在 3.1-3.6。
 
@@ -504,7 +504,7 @@ Footer 格式：`Taskr: <task-id>`（注意不是旧的 `[taskr:<id>]` subject-l
 
 | Taskr 特性 | 不吸收的原因 |
 |------------|-------------|
-| `.taskr/` 目录名 | 我们用 `docs/09-PLANNING/TASKS/`，已是 harness 骨架的一部分，不应再搞一套平行目录 |
+| `.taskr/` 目录名 | 我们用 `coding-agent-harness/planning/tasks/`，已是 harness 骨架的一部分，不应再搞一套平行目录 |
 | 6-section 固定结构（Request/AC/Plan/ProgressLog/AgentNotes/CompletionSummary） | 我们的三件套（plan/findings/progress）更细粒度；但可以考虑对齐 section 名 |
 | 无 SSoT / 无 Regression / 无 Lessons | 这是 Taskr 的定位选择（轻量），不代表我们该砍掉已有能力 |
 | HTML-in-Markdown 片段 | 我们的任务文件面向 agent 消费，不需要富渲染 |

package/references/walkthrough-closeout.md

@@ -36,7 +36,7 @@
 - 有没有反复出现、跨页面/跨模块/跨阶段的共性问题：[有/无，写一句理由]
 - 有没有下次 agent 也可能重复踩的坑：[有/无，写一句理由]
 - Lessons 结果：[checked-created: L-YYYY-MM-DD-NNN / queued-promotion: LC-YYYYMMDD-NNN / checked-candidate: LC-YYYYMMDD-NNN / checked-none: 一句话原因]
-- Lessons Detail Doc：[如 checked-created，填 `docs/01-GOVERNANCE/lessons/...md`；如 queued/checked-candidate，填 `lesson_candidates.md` 和任务本地 `lessons/LC-...md`；否则写"无"]
+- Lessons Detail Doc：[如 checked-created，填 `coding-agent-harness/governance/lessons/...md`；如 queued/checked-candidate，填 `lesson_candidates.md` 和任务本地 `lessons/LC-...md`；否则写"无"]
 
 ## 相关文件
 - Task Plan: [路径]
@@ -48,13 +48,13 @@
 ## 存放位置
 
 ```
-docs/10-WALKTHROUGH/<YYYY-MM-DD-wave名称>.md
+walkthrough.md.md
 ```
 
-Closeout SSoT:
+Closeout Index:
 
 ```text
-docs/10-WALKTHROUGH/Closeout-SSoT.md
+coding-agent-harness/governance/generated/Closeout-Index.md
 ```
 
 ## 规则
@@ -67,15 +67,15 @@ docs/10-WALKTHROUGH/Closeout-SSoT.md
 6. **Walkthrough 不是代码注释** — 不需要逐行解释代码，重点是决策、验证和可复用教训
 7. **Walkthrough 完成后必须执行经验沉淀检查** — 见下方“经验沉淀检查”章节
 8. **收口后必须更新 Harness Ledger** — 记录本轮上下文回写是否完成
-9. **收口后必须更新 Closeout SSoT** — 每个 `closed` / `closed-with-residual` / `closed-local-only` 的 Harness Ledger row 必须有 Closeout SSoT row
+9. **收口后必须更新 Closeout Index** — 每个 `closed` / `closed-with-residual` / `closed-local-only` 的 Harness Ledger row 必须有 Closeout Index row
 
-## Closeout SSoT 规则
+## Closeout Index 规则
 
-`Closeout-SSoT.md` 是 walkthrough 是否写入的硬门槛，不是目录索引。
+`Closeout-Index.md` 是 walkthrough 是否写入的硬门槛，不是目录索引。
 
 每个 closed 任务必须满足一项：
 
-1. `Walkthrough` 列写入 `docs/10-WALKTHROUGH/<file>.md`
+1. `Walkthrough` 列写入 `walkthrough.md.md`
 2. `Walkthrough` 列写入受控 skip reason
 
 允许的 skip reason 只有：
@@ -106,27 +106,27 @@ docs/10-WALKTHROUGH/Closeout-SSoT.md
 
 如果任何一条答案是“有”：
 
-1. 查找任务本地 `lesson_candidates.md`、任务本地 `lessons/LC-*.md` 和 `docs/01-GOVERNANCE/lessons/*.md`
+1. 查找任务本地 `lesson_candidates.md`、任务本地 `lessons/LC-*.md` 和 `coding-agent-harness/governance/lessons/*.md`
 2. 按 `references/lessons-governance.md` 中的规则处理冲突
 3. 先在任务目录 `lesson_candidates.md` 中登记候选；候选进入 `needs-promotion` 时同步写任务本地 `lessons/LC-*.md` 详情文件并在 `Detail Artifact` 链接
-4. 人工确认后，如需沉淀，使用 maintenance CLI 写入 `docs/01-GOVERNANCE/lessons/` promoted 详情文档
-5. 在 Closeout SSoT 和 Harness Ledger 中记录 `queued-promotion: LC-...` 或 `checked-created: L-YYYY-MM-DD-NNN`
+4. 人工确认后，如需沉淀，使用 maintenance CLI 写入 `coding-agent-harness/governance/lessons/` promoted 详情文档
+5. 在 Closeout Index 和 Harness Ledger 中记录 `queued-promotion: LC-...` 或 `checked-created: L-YYYY-MM-DD-NNN`
 
-如果所有答案都是“没有”，不能静默跳过；在 Closeout SSoT 和 Harness Ledger 中记录
+如果所有答案都是“没有”，不能静默跳过；在 Closeout Index 和 Harness Ledger 中记录
 新任务在 `lesson_candidates.md` 中写 `no-candidate-accepted` 和 No-Candidate Reason；旧任务可记录
 `checked-none: <一句话原因>`。
 
 ## Harness Ledger 回写
 
 写完 Walkthrough、更新 Regression SSoT 或其他本轮实际触达的非任务生命周期 SSoT，并完成 Lessons 检查后，Agent 必须更新
-`docs/10-WALKTHROUGH/Closeout-SSoT.md`；任务生命周期总账由 CLI 重新生成 `docs/Harness-Ledger.md`：
+`coding-agent-harness/governance/generated/Closeout-Index.md`；任务生命周期总账由 CLI 重新生成 `coding-agent-harness/governance/generated/Harness-Ledger.md`：
 
 1. 为本轮任务追加或更新对应 `HL-*` 条目
 2. 记录 Task Plan、Regression SSoT、Review Report、Walkthrough、Lessons Check 的结果
 3. 列出本轮触碰的 harness 文档
 4. 如有未完成项，使用 `missing` 或 `skipped-with-reason` 并写明 residual
 
-没有 Harness Ledger 条目或 Closeout SSoT 条目的 wave，不视为完整 closed。
+没有 Harness Ledger 条目或 Closeout Index 条目的 wave，不视为完整 closed。
 
 ## 为什么 Walkthrough 有效
 

package/references/worktree-parallel.md

@@ -6,7 +6,7 @@
 
 但 worktree 只是 `solo-orchestrator` 或单仓并行的一种实现。若项目是多人团队、
 前后端分仓、program 多仓或瀑布 stage-gate，必须先读
-`docs/11-REFERENCE/delivery-operating-model-standard.md`，再决定使用 worktree、
+`coding-agent-harness/governance/standards/delivery-operating-model-standard.md`，再决定使用 worktree、
 feature branch、contract branch、release branch 或跨仓 paired PR。
 
 ## 什么时候必须开 worktree
@@ -39,7 +39,7 @@ feature branch、contract branch、release branch 或跨仓 paired PR。
 - `fix/` — Bug 修复
 - `refactor/` — 重构
 - `test/` — 测试相关
-- `docs/` — 文档相关
+- `coding-agent-harness/` — 文档相关
 
 示例：
 - `feat/user-auth-oauth2`
@@ -135,7 +135,7 @@ Coordinator 集成规则：
 
 ## 并发上限
 
-项目必须在 `docs/11-REFERENCE/repo-governance-standard.md` 的 Worktree Concurrency
+项目必须在 `coding-agent-harness/governance/standards/repo-governance-standard.md` 的 Worktree Concurrency
 中定义 max active worktrees、merge ordering rule 和 cleanup owner。
 
 未定义并发上限时，不应启动多 agent 并行开发。

package/skills/preset-creator/references/complex-task-skeleton/brief.md

@@ -30,3 +30,14 @@ State the user-visible or project-visible result this task must deliver.
 ## First Next Step
 
 Replace this line with the first concrete action before implementation starts.
+
+## Scaffold Provenance
+
+| Field | Value |
+| --- | --- |
+| Created By | {{SCAFFOLD_CREATED_BY}} |
+| Command Shape | {{SCAFFOLD_COMMAND}} |
+| Created At | {{SCAFFOLD_CREATED_AT}} |
+| Budget | {{SCAFFOLD_BUDGET}} |
+| Template Source | {{SCAFFOLD_TEMPLATE_SOURCE}} |
+| Exception Reason | {{SCAFFOLD_EXCEPTION_REASON}} |

package/skills/preset-creator/references/complex-task-skeleton/task_plan.md

@@ -108,4 +108,4 @@ File purposes:
 
 - Global sync owner: coordinator / n/a
 - Global sync status: pending-coordinator-pass / synced / n/a
-- Shared updates needed: [Module Registry / Harness Ledger / Closeout SSoT / Regression SSoT / none]
+- Shared updates needed: [Module Registry / Harness Ledger / Closeout Index / Regression SSoT / none]