coding-agent-harness 1.0.5 → 1.0.6

package/references/harness-ledger.md

@@ -11,10 +11,10 @@ Harness Ledger 是任务生命周期的全局生成索引。它把任务目录
 ## 文件位置
 
 ```text
-docs/Harness-Ledger.md
+coding-agent-harness/governance/generated/Harness-Ledger.md
 ```
 
-放在 `docs/` 根目录，因为它横跨 planning、review、walkthrough、lessons 和模块索引。
+放在 `coding-agent-harness/` 根目录，因为它横跨 planning、review、walkthrough、lessons 和模块索引。
 
 ## 职责边界
 
@@ -63,7 +63,7 @@ Agent 不应手写或机械更新 Ledger 的任务行。如果发现生成结果
 - Delivery SSoT 仍管理交付 block、跨仓顺序、owner 和依赖。
 - Regression SSoT 仍管理回归面、证据深度和 residual。
 - Cadence Ledger 仍管理周期性验证节奏。
-- Closeout SSoT 仍管理 walkthrough、closeout status 和受控 skip reason。
+- Closeout Index 仍管理 walkthrough、closeout status 和受控 skip reason。
 - Module Registry 仍管理模块边界、owner、worktree 和写入范围。
 
 这些表不是任务生命周期小表。本版本只移除 `Feature-SSoT.md` / `Private-Feature-SSoT.md` 这类生命周期投影，不删除尚无等价 scanner/generator 的治理表。
@@ -73,7 +73,7 @@ Agent 不应手写或机械更新 Ledger 的任务行。如果发现生成结果
 旧生命周期表切换时归档到：
 
 ```text
-docs/09-PLANNING/_archive/<timestamp>/
+coding-agent-harness/planning/_archive/<timestamp>/
 ```
 
 归档不改变历史证据，也不要求迁移 Agent 删除旧快照。确认 Dashboard、`task-list`、`task-index` 和新 Ledger 都能表达当前任务后，项目 owner 再决定是否清理归档。
@@ -88,7 +88,7 @@ docs/09-PLANNING/_archive/<timestamp>/
 4. 回写 Repo Governance / CI-CD 状态（如适用）。
 5. 回写 Regression SSoT / Cadence Ledger / Delivery SSoT 等本轮实际触达的非生命周期治理表（如适用）。
 6. 写 walkthrough。
-7. 更新 Closeout SSoT。
+7. 更新 Closeout Index。
 8. 执行 Lessons 检查；新任务先更新 `lesson_candidates.md`，如人工确认沉淀，再由维护命令写详情文档。
 9. 运行 Harness CLI 生成或刷新 Harness Ledger。
 

package/references/legacy-12-phase-bootstrap.md

@@ -16,7 +16,7 @@ This document preserves the legacy bootstrap sequence used before the v1.0 capab
 4. Optional module registration: identify independent modules, write scopes, module registry rows, and module plans.
 5. Directory structure: create or adapt `docs/` according to the docs directory standard.
 6. AGENTS.md and CLAUDE.md: generate the root agent entrypoint and Claude Code shim.
-7. Reference standards: generate project-specific reference files under `docs/11-REFERENCE/`.
+7. Reference standards: generate project-specific reference files under `coding-agent-harness/governance/standards/`.
 8. Repository governance and CI/CD: define PR policy, required checks, branch protection, CI, and worktree concurrency.
 9. Planning loop: create task templates and task directories.
 10. Long-running task protocol: add long-running task standard and contract template.
@@ -31,7 +31,7 @@ This document preserves the legacy bootstrap sequence used before the v1.0 capab
 | Task directory with only `task_plan.md` | Add `brief.md`, `execution_strategy.md`, `visual_map.md`, `progress.md`, `findings.md`, and `review.md` only for active tasks. |
 | Embedded roadmap in `task_plan.md` | Move active roadmap rows into standalone `visual_map.md`; leave historical tasks untouched unless they are reopened. |
 | Single-line progress status | Normalize active tasks through `harness task-start`, `task-block`, `task-log`, and `task-complete`. |
-| Broad reference bundle | Declare only capabilities that are actually adopted in `.harness-capabilities.json`. |
+| Broad reference bundle | Declare only capabilities that are actually adopted in `coding-agent-harness/harness.yaml`. |
 | Long-running task artifacts | Add or declare `long-running-task` only when active work needs continuous autonomous execution. |
 | Informal module lists | Adopt `module-parallel` only after modules have owners, write scopes, dependency rules, and registry maintenance. |
 | Historical review notes | Do not rewrite all old review files. Upgrade active release-blocking reviews to the v1 review schema first. |

package/references/lessons-governance.md

@@ -8,23 +8,23 @@ Lessons 不再使用一张手工维护的全局表。原因很简单：lesson ca
 
 | 层级 | 文件 | 职责 |
 | --- | --- | --- |
-| 任务本地队列 | `docs/09-PLANNING/**/lesson_candidates.md` | 记录候选、拒绝、无候选、排队 promotion 和人工判定 |
-| 任务本地详情 | `docs/09-PLANNING/**/lessons/LC-*.md` | 在源任务上下文还新鲜时写完整 lesson 正文，供后续沉淀任务读取 |
-| Promoted lesson 详情 | `docs/01-GOVERNANCE/lessons/L-YYYY-MM-DD-NNN-<slug>.md` | 记录已接受、可复用、需要后续治理合入的经验 |
+| 任务本地队列 | `coding-agent-harness/planning/**/lesson_candidates.md` | 记录候选、拒绝、无候选、排队 promotion 和人工判定 |
+| 任务本地详情 | `coding-agent-harness/planning/**/lessons/LC-*.md` | 在源任务上下文还新鲜时写完整 lesson 正文，供后续沉淀任务读取 |
+| Promoted lesson 详情 | `coding-agent-harness/governance/lessons/L-YYYY-MM-DD-NNN-<slug>.md` | 记录已接受、可复用、需要后续治理合入的经验 |
 
-`docs/Harness-Ledger.md` 和 `docs/10-WALKTHROUGH/Closeout-SSoT.md` 只记录 closeout 结果：
+`coding-agent-harness/governance/generated/Harness-Ledger.md` 和 `coding-agent-harness/governance/generated/Closeout-Index.md` 只记录 closeout 结果：
 `checked-candidate:<LC-ID>`、`queued-promotion:<LC-ID>`、`checked-created:<L-ID>` 或历史兼容的 `checked-none:<reason>`。
 
 ## 目录结构
 
 ```text
-docs/01-GOVERNANCE/
+coding-agent-harness/governance/
 ├── lessons/                     ← promoted lesson 详情文档
 │   ├── L-2026-05-07-001-xxx.md
 │   └── ...
 └── _archive/                    ← 已合入或废弃的历史详情归档
 
-docs/09-PLANNING/TASKS/<task-id>/
+coding-agent-harness/planning/tasks/<task-id>/
 ├── lesson_candidates.md          ← 候选索引和人工路由状态
 └── lessons/
     └── LC-YYYYMMDD-NNN.md        ← task-local detail artifact
@@ -50,7 +50,7 @@ docs/09-PLANNING/TASKS/<task-id>/
 - `promoted`：维护命令已经创建 promoted lesson 详情文档，并回写源 candidate。
 - `rejected`：候选已带理由拒绝。
 
-`needs-promotion` 不阻塞任务 closeout，但必须在 Closeout SSoT / Harness Ledger 中记录 `queued-promotion: LC-YYYYMMDD-NNN`，并由后续维护任务处理。模块级候选还必须填写 `Module Key`，避免沉淀任务丢失模块边界。`promoted` 或人工直接创建详情文档时记录 `checked-created: L-YYYY-MM-DD-NNN`。如果没有候选，记录 `checked-candidate: LC-...` 或 `checked-none: <reason>`；`checked-none` 只用于旧任务兼容或没有 candidate 文件的历史收口。
+`needs-promotion` 不阻塞任务 closeout，但必须在 Closeout Index / Harness Ledger 中记录 `queued-promotion: LC-YYYYMMDD-NNN`，并由后续维护任务处理。模块级候选还必须填写 `Module Key`，避免沉淀任务丢失模块边界。`promoted` 或人工直接创建详情文档时记录 `checked-created: L-YYYY-MM-DD-NNN`。如果没有候选，记录 `checked-candidate: LC-...` 或 `checked-none: <reason>`；`checked-none` 只用于旧任务兼容或没有 candidate 文件的历史收口。
 
 ## Promotion 执行
 
@@ -60,13 +60,13 @@ promotion 只写 promoted 详情文档和源 candidate，不写共享 Lessons
 2. 选择 `templates/lessons/` 下的对应模板，或由 `lesson-promote --apply` 创建 promoted 详情文档。
 3. promoted 详情文档写清背景、现状问题、建议改动、影响范围和冲突声明。
 4. 回写源任务 `lesson_candidates.md`：对应候选标记为 `promoted`，并记录 `promoted:<L-ID>`。
-5. 在 Closeout SSoT / Harness Ledger 中记录 `checked-created:<L-ID>` 或 `queued-promotion:<LC-ID>`。
+5. 在 Closeout Index / Harness Ledger 中记录 `checked-created:<L-ID>` 或 `queued-promotion:<LC-ID>`。
 
 `lesson-promote --apply` 是 CLI-owned 机械写入：目标仓库必须是干净 Git root，
 命令会加 governance lock，只允许提交新 lesson detail 和源任务 `lesson_candidates.md`。
 如果存在 unrelated dirty diff，命令必须拒绝，让 coordinator 先提交、归属或记录 no-commit reason。
 
-如果四个问题的答案全是“没有”，也不能静默跳过。新任务必须在 `lesson_candidates.md` 中使用 `no-candidate-accepted` 并填写 No-Candidate Reason；旧任务可在 Closeout SSoT 和 Harness Ledger 中记录 `checked-none: <一句话原因>`。
+如果四个问题的答案全是“没有”，也不能静默跳过。新任务必须在 `lesson_candidates.md` 中使用 `no-candidate-accepted` 并填写 No-Candidate Reason；旧任务可在 Closeout Index 和 Harness Ledger 中记录 `checked-none: <一句话原因>`。
 
 ## Closeout 判定
 
@@ -79,10 +79,10 @@ promotion 只写 promoted 详情文档和源 candidate，不写共享 Lessons
 
 以下状态不合格：
 
-- 只在 walkthrough 或 progress 中说“无 lessons”，但 Closeout SSoT / Harness Ledger 没有记录。
+- 只在 walkthrough 或 progress 中说“无 lessons”，但 Closeout Index / Harness Ledger 没有记录。
 - 新任务跳过 `lesson_candidates.md`，只用 `checked-none` 代替 candidate 判定。
 - 用 `n/a` 代替检查结果，除非任务是纯只读分析且没有 closed ledger row。
-- `checked-created:<L-ID>` 指向的 `docs/01-GOVERNANCE/lessons/*.md` 不存在。
+- `checked-created:<L-ID>` 指向的 `coding-agent-harness/governance/lessons/*.md` 不存在。
 
 ## 沉淀类型
 
@@ -101,7 +101,7 @@ Agent 在产出任何 promoted lesson 之前，必须查看：
 
 - 任务本地 `lesson_candidates.md`
 - 任务本地 `lessons/LC-*.md`
-- `docs/01-GOVERNANCE/lessons/*.md`
+- `coding-agent-harness/governance/lessons/*.md`
 - 目标 reference / template / checker
 
 目的是确认是否已有同一 target、同一问题或冲突建议。
@@ -146,14 +146,14 @@ pending governance integration -> approved -> merged
 
 ## 归档机制
 
-当 `docs/01-GOVERNANCE/lessons/` 中已合入或废弃的详情文档过多时，可以把 `merged`、`rejected`、`superseded` 的文档移入 `docs/01-GOVERNANCE/_archive/`。不要归档仍被 Closeout SSoT 或 Harness Ledger 当前行引用的文档，除非同步更新引用。
+当 `coding-agent-harness/governance/lessons/` 中已合入或废弃的详情文档过多时，可以把 `merged`、`rejected`、`superseded` 的文档移入 `coding-agent-harness/governance/_archive/`。不要归档仍被 Closeout Index 或 Harness Ledger 当前行引用的文档，除非同步更新引用。
 
 ## 人的审批工作流
 
 1. 打开 dashboard 的 Lessons 队列，或搜索任务本地 `lesson_candidates.md` 中的 `needs-promotion`。
 2. 查看候选行的 `Detail Artifact`，确认任务本地详情正文足够完整。
 3. 需要提升时创建后续 sedimentation task，或批准 `lesson-promote --apply`。
-4. 查看生成的 `docs/01-GOVERNANCE/lessons/*.md`。
+4. 查看生成的 `coding-agent-harness/governance/lessons/*.md`。
 5. 有冲突的 lesson 一起审。
 6. 批准后由维护任务更新目标 reference / template / checker。
 
@@ -166,4 +166,4 @@ pending governance integration -> approved -> merged
 - `arch-change`：按建议更新架构文档。
 - `process-change`：按建议更新流程文档或 CLI/checker。
 
-合入任务收口时，必须在 `docs/Harness-Ledger.md` 的当前任务 row 中记录 `checked-created:<L-ID>`、`queued-promotion:<LC-ID>` 或 `checked-candidate:<LC-ID>`。
+合入任务收口时，必须在 `coding-agent-harness/governance/generated/Harness-Ledger.md` 的当前任务 row 中记录 `checked-created:<L-ID>`、`queued-promotion:<LC-ID>` 或 `checked-candidate:<LC-ID>`。

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 或指向归档文件。