coding-agent-harness 1.0.5 → 1.0.6
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CONTRIBUTING.md +2 -2
- package/README.md +63 -3
- package/README.zh-CN.md +52 -3
- package/SKILL.md +43 -43
- package/dist/build-dist.mjs +189 -0
- package/dist/check-dist-observation.mjs +428 -0
- package/dist/check-harness.mjs +489 -0
- package/dist/check-import-graph.mjs +511 -0
- package/dist/check-runtime-emit.mjs +304 -0
- package/dist/check-type-boundaries.mjs +139 -0
- package/dist/commands/dashboard-command.mjs +80 -0
- package/dist/commands/migration-command.mjs +152 -0
- package/dist/commands/preset-command.mjs +91 -0
- package/dist/commands/task-command.mjs +324 -0
- package/dist/harness.mjs +304 -0
- package/dist/lib/capability-registry.mjs +643 -0
- package/dist/lib/check-module-parallel.mjs +227 -0
- package/dist/lib/check-profiles.mjs +414 -0
- package/dist/lib/check-task-contracts.mjs +54 -0
- package/dist/lib/core-shared.mjs +254 -0
- package/dist/lib/dashboard-data.mjs +608 -0
- package/dist/lib/dashboard-workbench.mjs +334 -0
- package/dist/lib/dashboard-writer.mjs +200 -0
- package/dist/lib/git-status-summary.mjs +45 -0
- package/dist/lib/governance-index-generator.mjs +236 -0
- package/dist/lib/governance-sync.mjs +617 -0
- package/dist/lib/governance-table-boundary.mjs +161 -0
- package/{scripts → dist}/lib/harness-core.mjs +2 -0
- package/dist/lib/harness-paths.mjs +338 -0
- package/dist/lib/lesson-maintenance.mjs +139 -0
- package/dist/lib/markdown-utils.mjs +193 -0
- package/dist/lib/migration-planner.mjs +439 -0
- package/dist/lib/migration-support.mjs +317 -0
- package/dist/lib/phase-kind.mjs +46 -0
- package/dist/lib/preset-audit-contracts.mjs +40 -0
- package/dist/lib/preset-engine.mjs +516 -0
- package/dist/lib/preset-registry.mjs +831 -0
- package/dist/lib/preset-resource-contracts.mjs +83 -0
- package/dist/lib/review-confirm-git-gate.mjs +244 -0
- package/dist/lib/status-builder.mjs +87 -0
- package/{scripts → dist}/lib/status-dashboard-renderer.mjs +44 -46
- package/dist/lib/structure-migration.mjs +404 -0
- package/dist/lib/subagent-authorization-audit.mjs +198 -0
- package/dist/lib/task-audit-metadata.mjs +376 -0
- package/dist/lib/task-audit-migration.mjs +355 -0
- package/dist/lib/task-completion-consistency.mjs +29 -0
- package/dist/lib/task-index.mjs +133 -0
- package/dist/lib/task-lesson-candidates.mjs +239 -0
- package/dist/lib/task-lesson-sedimentation.mjs +300 -0
- package/dist/lib/task-lifecycle/create-task-helpers.mjs +84 -0
- package/dist/lib/task-lifecycle/phase-sync.mjs +82 -0
- package/dist/lib/task-lifecycle/review-confirm.mjs +93 -0
- package/dist/lib/task-lifecycle/review-gates.mjs +62 -0
- package/dist/lib/task-lifecycle/review-submission.mjs +52 -0
- package/dist/lib/task-lifecycle/scaffold-provenance.mjs +54 -0
- package/dist/lib/task-lifecycle/template-files.mjs +52 -0
- package/dist/lib/task-lifecycle/text-utils.mjs +26 -0
- package/dist/lib/task-lifecycle.mjs +611 -0
- package/dist/lib/task-metadata.mjs +116 -0
- package/dist/lib/task-review-model.mjs +474 -0
- package/dist/lib/task-scanner.mjs +439 -0
- package/dist/lib/task-tombstone-commands.mjs +125 -0
- package/dist/postinstall.mjs +14 -0
- package/dist/run-built-tests.mjs +84 -0
- package/docs-release/README.md +1 -0
- package/docs-release/architecture/overview.md +12 -12
- package/docs-release/architecture/overview.zh-CN.md +12 -12
- package/docs-release/architecture/system-explainer/01-system-overview.md +15 -14
- package/docs-release/architecture/system-explainer/02-module-dependency.md +8 -8
- package/docs-release/architecture/system-explainer/03-task-lifecycle.md +3 -3
- package/docs-release/architecture/system-explainer/04-check-and-governance.md +9 -7
- package/docs-release/architecture/system-explainer/05-data-flow.md +5 -5
- package/docs-release/architecture/system-explainer/06-preset-and-migration.md +1 -4
- package/docs-release/architecture/system-explainer/en-US/01-system-overview.md +15 -14
- package/docs-release/architecture/system-explainer/en-US/02-module-dependency.md +8 -8
- package/docs-release/architecture/system-explainer/en-US/03-task-lifecycle.md +3 -3
- package/docs-release/architecture/system-explainer/en-US/04-check-and-governance.md +10 -8
- package/docs-release/architecture/system-explainer/en-US/05-data-flow.md +5 -5
- package/docs-release/architecture/system-explainer/en-US/06-preset-and-migration.md +1 -4
- package/docs-release/guides/agent-installation.en-US.md +14 -8
- package/docs-release/guides/agent-installation.md +14 -8
- package/docs-release/guides/contributing.md +3 -3
- package/docs-release/guides/contributing.zh-CN.md +3 -3
- package/docs-release/guides/document-audience-and-surfaces.en-US.md +10 -10
- package/docs-release/guides/document-audience-and-surfaces.md +10 -10
- package/docs-release/guides/legacy-migration-agent-prompt.md +25 -2
- package/docs-release/guides/legacy-migration-agent-prompt.zh-CN.md +25 -2
- package/docs-release/guides/migration-playbook.en-US.md +63 -1
- package/docs-release/guides/migration-playbook.md +59 -1
- package/docs-release/guides/parent-control-repository-pattern.en-US.md +25 -25
- package/docs-release/guides/parent-control-repository-pattern.md +25 -25
- package/docs-release/guides/preset-development.md +2 -2
- package/docs-release/guides/repository-operating-models.en-US.md +21 -21
- package/docs-release/guides/repository-operating-models.md +21 -21
- package/docs-release/guides/task-state-machine.en-US.md +5 -5
- package/docs-release/guides/task-state-machine.md +5 -5
- package/docs-release/guides/typescript-runtime-migration-closeout.md +96 -0
- package/examples/minimal-project/AGENTS.md +2 -2
- package/examples/minimal-project/coding-agent-harness/harness.yaml +14 -0
- package/examples/minimal-project/coding-agent-harness/planning/tasks/demo-task/progress.md +11 -0
- package/examples/minimal-project/{docs/09-PLANNING/TASKS → coding-agent-harness/planning/tasks}/demo-task/review.md +1 -1
- package/package.json +20 -12
- package/presets/legacy-migration/preset.yaml +5 -5
- package/presets/legacy-migration/templates/execution_strategy.append.md +1 -1
- package/presets/lesson-sedimentation/preset.yaml +3 -3
- package/presets/module/preset.yaml +2 -2
- package/presets/module/templates/execution_strategy.append.md +1 -1
- package/presets/module/templates/task_plan.append.md +3 -3
- package/presets/standard-task/preset.yaml +2 -2
- package/references/adversarial-review-standard.md +2 -2
- package/references/agents-md-pattern.md +14 -14
- package/references/cadence-ledger.md +1 -1
- package/references/ci-cd-standard.md +1 -1
- package/references/delivery-operating-model-standard.md +4 -4
- package/references/docs-directory-standard.md +65 -159
- package/references/external-source-intake-standard.md +10 -10
- package/references/harness-ledger.md +5 -5
- package/references/legacy-12-phase-bootstrap.md +2 -2
- package/references/lessons-governance.md +15 -15
- package/references/long-running-task-standard.md +6 -6
- package/references/module-parallel-standard.md +34 -34
- package/references/planning-loop.md +6 -6
- package/references/project-onboarding-audit.md +4 -4
- package/references/regression-system.md +2 -2
- package/references/repo-governance-standard.md +4 -4
- package/references/review-routing-standard.md +1 -1
- package/references/ssot-governance.md +19 -19
- package/references/taskr-gap-analysis.md +5 -5
- package/references/walkthrough-closeout.md +14 -14
- package/references/worktree-parallel.md +3 -3
- package/skills/preset-creator/references/complex-task-skeleton/task_plan.md +1 -1
- package/skills/preset-creator/references/preset-package-skeleton.md +5 -5
- package/templates/AGENTS.md.template +26 -26
- package/templates/architecture/README.md +4 -4
- package/templates/architecture/service-catalog.md +2 -2
- package/templates/architecture/services/service-template.md +1 -1
- package/templates/dashboard/assets/app-src/20-overview.js +11 -5
- package/templates/dashboard/assets/app-src/40-modules.js +1 -1
- package/templates/dashboard/assets/app.js +12 -6
- package/templates/dashboard/assets/i18n.js +4 -2
- package/templates/development/README.md +10 -10
- package/templates/development/cross-repo-debugging.md +3 -3
- package/templates/development/external-context/service-template.md +2 -2
- package/templates/development/external-source-packs/README.md +4 -4
- package/templates/integrations/README.md +4 -4
- package/templates/integrations/api-contract.md +2 -2
- package/templates/integrations/event-contract.md +2 -2
- package/templates/integrations/third-party/vendor-template.md +2 -2
- package/templates/integrations/webhook-contract.md +2 -2
- package/templates/ledger/Harness-Ledger.md +1 -1
- package/templates/planning/INDEX.md +1 -0
- package/templates/planning/module_session_prompt.md +1 -1
- package/templates/planning/task_plan.md +1 -1
- package/templates/planning/walkthrough.md +47 -0
- package/templates/reference/docs-library-standard.md +8 -8
- package/templates/reference/external-source-intake-standard.md +15 -15
- package/templates/reference/repo-governance-standard.md +1 -1
- package/templates/ssot/Module-Registry.md +1 -1
- package/templates/walkthrough/walkthrough-template.md +2 -2
- package/templates-zh-CN/AGENTS.md.template +26 -26
- package/templates-zh-CN/CLAUDE.md.template +1 -1
- package/templates-zh-CN/architecture/README.md +4 -4
- package/templates-zh-CN/architecture/service-catalog.md +2 -2
- package/templates-zh-CN/architecture/services/service-template.md +1 -1
- package/templates-zh-CN/development/README.md +10 -10
- package/templates-zh-CN/development/cross-repo-debugging.md +3 -3
- package/templates-zh-CN/development/external-context/service-template.md +2 -2
- package/templates-zh-CN/development/external-source-packs/README.md +4 -4
- package/templates-zh-CN/integrations/README.md +4 -4
- package/templates-zh-CN/integrations/api-contract.md +2 -2
- package/templates-zh-CN/integrations/event-contract.md +2 -2
- package/templates-zh-CN/integrations/third-party/vendor-template.md +2 -2
- package/templates-zh-CN/integrations/webhook-contract.md +2 -2
- package/templates-zh-CN/ledger/Harness-Ledger.md +1 -1
- package/templates-zh-CN/lessons/lesson-arch-process-change.md +1 -1
- package/templates-zh-CN/lessons/lesson-new-doc.md +3 -3
- package/templates-zh-CN/lessons/lesson-ref-change.md +4 -4
- package/templates-zh-CN/planning/module_session_prompt.md +11 -11
- package/templates-zh-CN/planning/walkthrough.md +47 -0
- package/templates-zh-CN/reference/adversarial-review-standard.md +2 -2
- package/templates-zh-CN/reference/delivery-operating-model-standard.md +3 -3
- package/templates-zh-CN/reference/docs-library-standard.md +28 -28
- package/templates-zh-CN/reference/execution-workflow-standard.md +1 -1
- package/templates-zh-CN/reference/external-source-intake-standard.md +16 -16
- package/templates-zh-CN/reference/harness-ledger-standard.md +6 -6
- package/templates-zh-CN/reference/regression-ssot-governance.md +2 -2
- package/templates-zh-CN/reference/repo-governance-standard.md +1 -1
- package/templates-zh-CN/reference/review-routing-standard.md +1 -1
- package/templates-zh-CN/reference/walkthrough-standard.md +7 -7
- package/templates-zh-CN/reference/worktree-standard.md +1 -1
- package/templates-zh-CN/regression/Cadence-Ledger.md +2 -2
- package/templates-zh-CN/ssot/Delivery-SSoT.md +3 -3
- package/templates-zh-CN/ssot/Module-Registry.md +3 -3
- package/templates-zh-CN/ssot/Regression-SSoT.md +2 -2
- package/templates-zh-CN/walkthrough/walkthrough-template.md +5 -5
- package/tsconfig.dist.json +16 -0
- package/tsconfig.json +25 -0
- package/tsconfig.runtime.json +24 -0
- package/examples/minimal-project/.harness-capabilities.json +0 -8
- package/examples/minimal-project/docs/09-PLANNING/TASKS/demo-task/progress.md +0 -11
- package/scripts/check-harness.mjs +0 -508
- package/scripts/commands/dashboard-command.mjs +0 -67
- package/scripts/commands/migration-command.mjs +0 -126
- package/scripts/commands/preset-command.mjs +0 -73
- package/scripts/commands/task-command.mjs +0 -328
- package/scripts/harness.mjs +0 -291
- package/scripts/lib/capability-registry.mjs +0 -587
- package/scripts/lib/check-module-parallel.mjs +0 -230
- package/scripts/lib/check-profiles.mjs +0 -372
- package/scripts/lib/check-task-contracts.mjs +0 -55
- package/scripts/lib/core-shared.mjs +0 -249
- package/scripts/lib/dashboard-data.mjs +0 -520
- package/scripts/lib/dashboard-workbench.mjs +0 -336
- package/scripts/lib/dashboard-writer.mjs +0 -202
- package/scripts/lib/git-status-summary.mjs +0 -46
- package/scripts/lib/governance-index-generator.mjs +0 -174
- package/scripts/lib/governance-sync.mjs +0 -611
- package/scripts/lib/governance-table-boundary.mjs +0 -175
- package/scripts/lib/lesson-maintenance.mjs +0 -152
- package/scripts/lib/markdown-utils.mjs +0 -191
- package/scripts/lib/migration-planner.mjs +0 -476
- package/scripts/lib/migration-support.mjs +0 -312
- package/scripts/lib/phase-kind.mjs +0 -50
- package/scripts/lib/preset-audit-contracts.mjs +0 -37
- package/scripts/lib/preset-engine.mjs +0 -494
- package/scripts/lib/preset-registry.mjs +0 -776
- package/scripts/lib/preset-resource-contracts.mjs +0 -83
- package/scripts/lib/review-confirm-git-gate.mjs +0 -248
- package/scripts/lib/status-builder.mjs +0 -88
- package/scripts/lib/subagent-authorization-audit.mjs +0 -196
- package/scripts/lib/task-audit-metadata.mjs +0 -385
- package/scripts/lib/task-audit-migration.mjs +0 -350
- package/scripts/lib/task-completion-consistency.mjs +0 -26
- package/scripts/lib/task-index.mjs +0 -93
- package/scripts/lib/task-lesson-candidates.mjs +0 -242
- package/scripts/lib/task-lesson-sedimentation.mjs +0 -326
- package/scripts/lib/task-lifecycle/create-task-helpers.mjs +0 -67
- package/scripts/lib/task-lifecycle/phase-sync.mjs +0 -88
- package/scripts/lib/task-lifecycle/review-confirm.mjs +0 -112
- package/scripts/lib/task-lifecycle/review-gates.mjs +0 -73
- package/scripts/lib/task-lifecycle/review-submission.mjs +0 -63
- package/scripts/lib/task-lifecycle/scaffold-provenance.mjs +0 -49
- package/scripts/lib/task-lifecycle/template-files.mjs +0 -53
- package/scripts/lib/task-lifecycle/text-utils.mjs +0 -24
- package/scripts/lib/task-lifecycle.mjs +0 -616
- package/scripts/lib/task-metadata.mjs +0 -118
- package/scripts/lib/task-review-model.mjs +0 -455
- package/scripts/lib/task-scanner.mjs +0 -503
- package/scripts/lib/task-tombstone-commands.mjs +0 -140
- package/scripts/postinstall.mjs +0 -14
- package/templates/walkthrough/Closeout-SSoT.md +0 -43
- package/templates-zh-CN/walkthrough/Closeout-SSoT.md +0 -42
- /package/examples/minimal-project/{docs → coding-agent-harness/governance/generated}/Harness-Ledger.md +0 -0
- /package/examples/minimal-project/{docs/09-PLANNING/TASKS → coding-agent-harness/planning/tasks}/demo-task/INDEX.md +0 -0
- /package/examples/minimal-project/{docs/09-PLANNING/TASKS → coding-agent-harness/planning/tasks}/demo-task/brief.md +0 -0
- /package/examples/minimal-project/{docs/09-PLANNING/TASKS → coding-agent-harness/planning/tasks}/demo-task/execution_strategy.md +0 -0
- /package/examples/minimal-project/{docs/09-PLANNING/TASKS → coding-agent-harness/planning/tasks}/demo-task/findings.md +0 -0
- /package/examples/minimal-project/{docs/09-PLANNING/TASKS → coding-agent-harness/planning/tasks}/demo-task/lesson_candidates.md +0 -0
- /package/examples/minimal-project/{docs/09-PLANNING/TASKS → coding-agent-harness/planning/tasks}/demo-task/task_plan.md +0 -0
- /package/examples/minimal-project/{docs/09-PLANNING/TASKS → coding-agent-harness/planning/tasks}/demo-task/visual_map.md +0 -0
|
@@ -13,7 +13,7 @@ Webhook
|
|
|
13
13
|
|
|
14
14
|
| Service Profile | Development Context | Contract Index | Last Verified | Confidence |
|
|
15
15
|
| --- | --- | --- | --- | --- |
|
|
16
|
-
| `
|
|
16
|
+
| `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 |
|
|
17
17
|
|
|
18
18
|
## Auth
|
|
19
19
|
|
|
@@ -38,4 +38,4 @@ Webhook
|
|
|
38
38
|
|
|
39
39
|
## Placement Rule
|
|
40
40
|
|
|
41
|
-
本文件只写一个 webhook 契约。服务职责放 `
|
|
41
|
+
本文件只写一个 webhook 契约。服务职责放 `context/architecture`,本地 mock/stub/debug 放 `context/development`。
|
|
@@ -12,7 +12,7 @@ Repo Governance / CI-CD 变化仍通过对应 reference 和任务证据路由。
|
|
|
12
12
|
|
|
13
13
|
| ID | Scope | Module | Task | State | Queues | Plan | Review | Lessons Check | Closeout | Residual | Updated |
|
|
14
14
|
| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
|
|
15
|
-
| HL-YYYY-MM-DD-001 | task | none | 短任务标题 | planned | none |
|
|
15
|
+
| HL-YYYY-MM-DD-001 | task | none | 短任务标题 | planned | none | coding-agent-harness/planning/tasks/.../task_plan.md | pending | pending | pending | none | YYYY-MM-DD |
|
|
16
16
|
|
|
17
17
|
## 字段规则
|
|
18
18
|
|
|
@@ -4,7 +4,7 @@
|
|
|
4
4
|
|
|
5
5
|
- **ID**: L-[YYYY-MM-DD-NNN]
|
|
6
6
|
- **日期**: YYYY-MM-DD
|
|
7
|
-
- **来源**: `
|
|
7
|
+
- **来源**: `coding-agent-harness/planning/tasks/<task>/walkthrough.md`
|
|
8
8
|
- **类型**: arch-change / process-change
|
|
9
9
|
- **目标**: [受影响的模块、流程、reference、template 或 checker]
|
|
10
10
|
- **提出者**: [agent session / model / human]
|
|
@@ -4,9 +4,9 @@
|
|
|
4
4
|
|
|
5
5
|
- **ID**: L-[YYYY-MM-DD-NNN]
|
|
6
6
|
- **日期**: YYYY-MM-DD
|
|
7
|
-
- **来源**: `
|
|
7
|
+
- **来源**: `coding-agent-harness/planning/tasks/<task>/walkthrough.md`
|
|
8
8
|
- **类型**: new-doc
|
|
9
|
-
- **建议路径**: `
|
|
9
|
+
- **建议路径**: `coding-agent-harness/governance/standards/[建议文件名].md`
|
|
10
10
|
- **提出者**: [agent session / model / human]
|
|
11
11
|
|
|
12
12
|
## 背景
|
|
@@ -23,7 +23,7 @@
|
|
|
23
23
|
|
|
24
24
|
## 建议路径
|
|
25
25
|
|
|
26
|
-
`
|
|
26
|
+
`coding-agent-harness/governance/standards/[建议文件名].md`
|
|
27
27
|
|
|
28
28
|
## 建议文档内容
|
|
29
29
|
|
|
@@ -4,9 +4,9 @@
|
|
|
4
4
|
|
|
5
5
|
- **ID**: L-[YYYY-MM-DD-NNN]
|
|
6
6
|
- **日期**: YYYY-MM-DD
|
|
7
|
-
- **来源**: `
|
|
7
|
+
- **来源**: `coding-agent-harness/planning/tasks/<task>/walkthrough.md`
|
|
8
8
|
- **类型**: ref-change
|
|
9
|
-
- **目标**: `
|
|
9
|
+
- **目标**: `coding-agent-harness/governance/standards/[目标文件].md`
|
|
10
10
|
- **提出者**: [agent session / model / human]
|
|
11
11
|
|
|
12
12
|
## 背景
|
|
@@ -42,7 +42,7 @@
|
|
|
42
42
|
- 当前是否有其他 pending 条目指向同一目标:是 / 否
|
|
43
43
|
- 如果有,涉及条目:L-[XXX]
|
|
44
44
|
- 本文档是否已考虑冲突:是 / 否
|
|
45
|
-
- 基于版本:当前正式 reference(`
|
|
45
|
+
- 基于版本:当前正式 reference(`coding-agent-harness/governance/standards/[目标文件].md`)@ YYYY-MM-DD
|
|
46
46
|
|
|
47
47
|
## 完整副本
|
|
48
48
|
|
|
@@ -50,7 +50,7 @@
|
|
|
50
50
|
|
|
51
51
|
---
|
|
52
52
|
<!-- 完整副本开始 -->
|
|
53
|
-
<!-- 基于:
|
|
53
|
+
<!-- 基于: coding-agent-harness/governance/standards/[目标文件].md @ YYYY-MM-DD -->
|
|
54
54
|
<!-- 本副本独立于其他 pending 改动 -->
|
|
55
55
|
|
|
56
56
|
[完整的修改后文档内容]
|
|
@@ -12,14 +12,14 @@
|
|
|
12
12
|
- Coordinator 负责集成 worker commit 并运行最终门禁;不要在一个 checkout 中混合多个 worker 的未提交改动。
|
|
13
13
|
|
|
14
14
|
目标:
|
|
15
|
-
- 执行
|
|
15
|
+
- 执行 coding-agent-harness/planning/modules/Module-Registry.md 与 coding-agent-harness/planning/modules/<module-key>/module_plan.md 中为 <module-key> 标记的当前步骤。
|
|
16
16
|
- 除非触发 stop condition,否则持续推进到该步骤已实现、已验证、已记录,并可进入审查。
|
|
17
17
|
|
|
18
18
|
冷启动:
|
|
19
19
|
1. 阅读 AGENTS.md。
|
|
20
|
-
2. 阅读
|
|
21
|
-
3. 阅读
|
|
22
|
-
4. 阅读
|
|
20
|
+
2. 阅读 coding-agent-harness/planning/modules/Module-Registry.md。
|
|
21
|
+
3. 阅读 coding-agent-harness/planning/modules/Session-Prompt-Pack.md 或 coding-agent-harness/planning/modules/<module-key>/session_prompt.md。
|
|
22
|
+
4. 阅读 coding-agent-harness/planning/modules/<module-key>/module_plan.md。
|
|
23
23
|
5. 按项目任务阅读矩阵读取本任务涉及文件对应的标准文档。
|
|
24
24
|
|
|
25
25
|
启动门禁:
|
|
@@ -27,9 +27,9 @@
|
|
|
27
27
|
- 确认当前 checkout/worktree path 是 <worktree-path>,当前分支是 <branch-name>。
|
|
28
28
|
- 编辑前检查 dirty state,不要 revert 无关改动。
|
|
29
29
|
- 如果另一个活跃会话拥有该模块或必需共享文件,停止并记录冲突。
|
|
30
|
-
- 代码编辑前,基于项目 planning 模板创建或更新
|
|
30
|
+
- 代码编辑前,基于项目 planning 模板创建或更新 coding-agent-harness/planning/modules/<module-key>/tasks/<current-step>-<short-name>/task_plan.md,写清范围、验收、验证、分支/worktree 和共享协调。
|
|
31
31
|
- 代码编辑前,确认模块任务目录含有 `execution_strategy.md` 与 `visual_map.md`。如缺失,先补齐再实现。
|
|
32
|
-
- 如果
|
|
32
|
+
- 如果 coding-agent-harness/planning/modules/<module-key>/ 缺少模块级 `execution_strategy.md` 或 `visual_map.md`,在派发 worker 前补齐或更新。
|
|
33
33
|
|
|
34
34
|
分支与工作树:
|
|
35
35
|
- Worktree path: <worktree-path>.
|
|
@@ -41,7 +41,7 @@
|
|
|
41
41
|
写入范围:
|
|
42
42
|
- 允许:<module-write-scope>.
|
|
43
43
|
- 未明确协调前禁止:<shared-or-forbidden-scope>.
|
|
44
|
-
- 共享协调产物:
|
|
44
|
+
- 共享协调产物:coding-agent-harness/planning/modules/_shared/tasks/<id>/task_plan.md,或模块任务计划中的“共享协调”段,必须写明 owner、涉及文件、允许改动、reviewer 和 merge 顺序。
|
|
45
45
|
- 如果实现需要触碰允许范围之外的文件,停止并记录所需协调,不要直接编辑。
|
|
46
46
|
|
|
47
47
|
验证:
|
|
@@ -52,15 +52,15 @@
|
|
|
52
52
|
|
|
53
53
|
收口:
|
|
54
54
|
- 更新模块计划和模块任务进度。
|
|
55
|
-
- 除非 coordinator 明确分配共享锁,worker session 不得更新
|
|
55
|
+
- 除非 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。
|
|
56
56
|
- 如果需要全局表更新,在 task_plan.md 或 progress.md 写 Coordinator 交接,并标记 `Global sync status: pending-coordinator-pass`。
|
|
57
|
-
- 只有 coordinator pass 或明确的 shared-lock owner 可以更新
|
|
57
|
+
- 只有 coordinator pass 或明确的 shared-lock owner 可以更新 coding-agent-harness/planning/modules/Module-Registry.md。
|
|
58
58
|
- 汇报状态时区分 `task.state`、`lifecycleState`、`reviewStatus` 和 `closeoutStatus`;`done` 只表示实现步骤完成,不等于 `closed`。
|
|
59
59
|
- 把当前任务 `visual_map.md` 阶段表作为生命周期地图。切片结束时检查当前 gate phase;只有 `Actor` 为 `agent` 的 `Exit Command` 才由 Agent 执行。
|
|
60
|
-
- 更新
|
|
60
|
+
- 更新 coding-agent-harness/planning/modules/<module-key>/module_plan.md。
|
|
61
61
|
- 写 review.md,或记录 review skipped-with-reason。需要人工确认审查完成时,必须通过本地 dashboard workbench,或由 coordinator 执行 `harness review-confirm`;存在开放 P0/P1/P2 finding 时不得确认。
|
|
62
62
|
- 步骤完成时写 walkthrough,并包含 Lessons 反思。
|
|
63
|
-
- Coordinator pass 在任务关闭时更新 Closeout
|
|
63
|
+
- Coordinator pass 在任务关闭时更新 Closeout Index 和 Lessons 检查。
|
|
64
64
|
- Coordinator pass 在行为、测试、架构或流程改变时更新 Regression SSoT 和 Harness Ledger。
|
|
65
65
|
- 验证未通过前不得声明完成;无法解决的残余必须记录 owner 和原因。
|
|
66
66
|
|
|
@@ -0,0 +1,47 @@
|
|
|
1
|
+
# 收口记录:{{TASK_TITLE}}
|
|
2
|
+
|
|
3
|
+
## 摘要
|
|
4
|
+
|
|
5
|
+
待收口。
|
|
6
|
+
|
|
7
|
+
## 范围
|
|
8
|
+
|
|
9
|
+
| 范围 | 详情 |
|
|
10
|
+
| --- | --- |
|
|
11
|
+
| 变更模块 | pending |
|
|
12
|
+
| 新增文件 | pending |
|
|
13
|
+
| 删除文件 | pending |
|
|
14
|
+
| 不在范围内 | pending |
|
|
15
|
+
|
|
16
|
+
## 验证
|
|
17
|
+
|
|
18
|
+
| 检查 | 命令或过程 | 结果 | 证据 |
|
|
19
|
+
| --- | --- | --- | --- |
|
|
20
|
+
| pending | pending | not run | pending |
|
|
21
|
+
|
|
22
|
+
## 审查结论
|
|
23
|
+
|
|
24
|
+
| 来源 | 重要发现 | 处理 | 证据 |
|
|
25
|
+
| --- | --- | --- | --- |
|
|
26
|
+
| pending | pending | pending | `review.md` |
|
|
27
|
+
|
|
28
|
+
## 残余风险
|
|
29
|
+
|
|
30
|
+
| 风险 | Owner | 是否接受 | 跟进 |
|
|
31
|
+
| --- | --- | --- | --- |
|
|
32
|
+
| pending | owner | pending | pending |
|
|
33
|
+
|
|
34
|
+
## 经验沉淀反思
|
|
35
|
+
|
|
36
|
+
| 问题 | 答案 |
|
|
37
|
+
| --- | --- |
|
|
38
|
+
| 是否完成经验候选检查? | pending |
|
|
39
|
+
| 经验候选详情文件 | `lesson_candidates.md` |
|
|
40
|
+
|
|
41
|
+
## 收口链接
|
|
42
|
+
|
|
43
|
+
| 产物 | 链接 |
|
|
44
|
+
| --- | --- |
|
|
45
|
+
| 任务计划 | `task_plan.md` |
|
|
46
|
+
| 审查记录 | `review.md` |
|
|
47
|
+
| 进度记录 | `progress.md` |
|
|
@@ -7,7 +7,7 @@
|
|
|
7
7
|
审查报告默认写入:
|
|
8
8
|
|
|
9
9
|
```text
|
|
10
|
-
|
|
10
|
+
coding-agent-harness/planning/tasks/<YYYY-MM-DD-任务名>/review.md
|
|
11
11
|
```
|
|
12
12
|
|
|
13
13
|
审查路由由 `review-routing-standard.md` 决定;本文件只规定审查报告怎么写、什么结论可以收口。
|
|
@@ -86,4 +86,4 @@ No material findings. 当前证据覆盖了本轮 stop condition,未发现阻
|
|
|
86
86
|
- 缺少 `Confidence Challenge` 或 `Final Confidence Basis`。
|
|
87
87
|
- 缺少 `Evidence Checked`,或证据只来自聊天记录。
|
|
88
88
|
- finding 修复后没有重跑对应证据。
|
|
89
|
-
- walkthrough、Closeout
|
|
89
|
+
- walkthrough、Closeout Index 或 Harness Ledger 没有引用审查结果或跳过原因。
|
|
@@ -21,8 +21,8 @@
|
|
|
21
21
|
| 层级 | 负责人 | 主要产物 | 规则 |
|
|
22
22
|
| --- | --- | --- | --- |
|
|
23
23
|
| 路线图 | product / tech lead / owner | roadmap、release plan | 只放阶段目标,不替代任务计划。 |
|
|
24
|
-
| 功能块 | coordinator / feature lead | `
|
|
25
|
-
| 任务 | task owner | `
|
|
24
|
+
| 功能块 | coordinator / feature lead | `coding-agent-harness/planning/Delivery-SSoT.md` 或功能 SSoT | 标明 owner、依赖、集成顺序。 |
|
|
25
|
+
| 任务 | task owner | `coding-agent-harness/planning/tasks/<task>/task_plan.md` | 每个任务有目标、范围、证据和 stop condition。 |
|
|
26
26
|
| 审查 | reviewer / subagent / human | `review.md` 或 PR review | 按审查路由执行,不只留在聊天里。 |
|
|
27
27
|
| 集成 | coordinator / maintainer | PR、integration branch、release branch | 由集成 owner 决定 merge 顺序和最终 gates。 |
|
|
28
28
|
|
|
@@ -40,7 +40,7 @@
|
|
|
40
40
|
|
|
41
41
|
## 交付单一事实源要求
|
|
42
42
|
|
|
43
|
-
以下任一条件成立时,必须维护 `
|
|
43
|
+
以下任一条件成立时,必须维护 `coding-agent-harness/planning/Delivery-SSoT.md`:
|
|
44
44
|
|
|
45
45
|
- 多人或多 agent 并行开发。
|
|
46
46
|
- 多仓或前后端分离协作。
|
|
@@ -2,21 +2,21 @@
|
|
|
2
2
|
|
|
3
3
|
## 职责
|
|
4
4
|
|
|
5
|
-
本标准定义 `
|
|
5
|
+
本标准定义 `coding-agent-harness/` 文档库的目录、命名、归档和引用规则。文档库服务于 agent 执行,不是资料堆;每个文件都应有明确职责、当前事实和可追溯证据。
|
|
6
6
|
|
|
7
7
|
## 目录职责
|
|
8
8
|
|
|
9
9
|
| 位置 | 职责 |
|
|
10
10
|
| --- | --- |
|
|
11
|
-
| `
|
|
12
|
-
| `
|
|
13
|
-
| `
|
|
14
|
-
| `
|
|
15
|
-
| `
|
|
16
|
-
| `
|
|
17
|
-
| `
|
|
18
|
-
| `
|
|
19
|
-
| `
|
|
11
|
+
| `coding-agent-harness/governance/generated/Harness-Ledger.md` | 全局上下文维护总账,记录非平凡任务是否完成计划、审查、回归、Lessons 和收口回写。 |
|
|
12
|
+
| `coding-agent-harness/governance/` | promoted lesson 详情、治理记录、归档。 |
|
|
13
|
+
| `coding-agent-harness/context/architecture/` | ADR、架构设计、接口决策、关键技术方案。 |
|
|
14
|
+
| `coding-agent-harness/context/development/` | 本地开发、代码地图、外部服务开发上下文、mock/stub、跨仓调试。 |
|
|
15
|
+
| `coding-agent-harness/governance/regression/` | Regression SSoT、Cadence Ledger、测试策略和回归证据索引。 |
|
|
16
|
+
| `coding-agent-harness/planning/` | Delivery SSoT、Module Registry、任务目录、模块计划。 |
|
|
17
|
+
| `coding-agent-harness/planning/tasks/` | 每个任务一个目录,包含 task plan、progress、findings、review。 |
|
|
18
|
+
| `coding-agent-harness/planning/tasks/<task>/` | 收口记录和 Closeout Index。 |
|
|
19
|
+
| `coding-agent-harness/governance/standards/` | agent 按需加载的标准文件,控制行为而不是记录流水账。 |
|
|
20
20
|
| `docs/99-TMP/` | 临时材料,定期清理,不作为长期事实来源。 |
|
|
21
21
|
|
|
22
22
|
## 03 / 04 / 06 路由规则
|
|
@@ -29,16 +29,16 @@
|
|
|
29
29
|
|
|
30
30
|
| 目录 | 负责 | 不负责 | 必需 schema 信号 |
|
|
31
31
|
| --- | --- | --- | --- |
|
|
32
|
-
| `
|
|
33
|
-
| `
|
|
34
|
-
| `
|
|
32
|
+
| `coding-agent-harness/context/architecture/` | 系统结构、服务职责、owner、service catalog、critical flows、ADR | endpoint payload、mock 指南、任务日志 | `Context Doc Type`, `Source Evidence`, `Last Verified`, `Confidence` |
|
|
33
|
+
| `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` |
|
|
34
|
+
| `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` |
|
|
35
35
|
|
|
36
36
|
具体分工:
|
|
37
37
|
|
|
38
|
-
- `
|
|
39
|
-
- `
|
|
40
|
-
- `
|
|
41
|
-
- `
|
|
38
|
+
- `coding-agent-harness/context/architecture/service-catalog.md` 只写服务摘要和链接。
|
|
39
|
+
- `coding-agent-harness/context/integrations/<service>-api-contract.md` 才写 payload、auth、errors、contract tests。
|
|
40
|
+
- `coding-agent-harness/context/development/external-context/<service>.md` 写 mock/stub、不安全假设和调试说明。
|
|
41
|
+
- `coding-agent-harness/context/development/external-source-packs/` 只写外部资料索引、digest 和投影状态;最终事实必须回写到 `context/{architecture,development,integrations}`。
|
|
42
42
|
|
|
43
43
|
## 外部资料摄取规则
|
|
44
44
|
|
|
@@ -54,7 +54,7 @@ Inventory -> Classify -> Sanitize -> Digest -> Project -> Verify -> Residual
|
|
|
54
54
|
|
|
55
55
|
## 命名规则
|
|
56
56
|
|
|
57
|
-
- 目录可使用编号前缀,例如 `
|
|
57
|
+
- 目录可使用编号前缀,例如 `coding-agent-harness/planning`、`coding-agent-harness/governance/standards`。
|
|
58
58
|
- 标准文件使用 kebab-case,例如 `testing-standard.md`。
|
|
59
59
|
- 时序文档使用日期前缀,例如 `2026-05-19-runtime-cleanup-walkthrough.md`。
|
|
60
60
|
- 模板目录或模板文件用 `_` 前缀,例如 `_task-template/`。
|
|
@@ -64,15 +64,15 @@ Inventory -> Classify -> Sanitize -> Digest -> Project -> Verify -> Residual
|
|
|
64
64
|
|
|
65
65
|
| 类型 | 推荐位置 | 要求 |
|
|
66
66
|
| --- | --- | --- |
|
|
67
|
-
| 任务计划 | `
|
|
68
|
-
| 进度记录 | `
|
|
69
|
-
| 研究发现 | `
|
|
70
|
-
| 审查报告 | `
|
|
71
|
-
| 收口记录 | `
|
|
72
|
-
| Closeout
|
|
73
|
-
| Regression SSoT | `
|
|
67
|
+
| 任务计划 | `coding-agent-harness/planning/tasks/<task>/task_plan.md` | 写目标、范围、证据、stop condition。 |
|
|
68
|
+
| 进度记录 | `coding-agent-harness/planning/tasks/<task>/progress.md` | 记录阶段状态、阻塞、决策和验证。 |
|
|
69
|
+
| 研究发现 | `coding-agent-harness/planning/tasks/<task>/findings.md` | 记录调查证据,不替代审查报告。 |
|
|
70
|
+
| 审查报告 | `coding-agent-harness/planning/tasks/<task>/review.md` | 记录 Confidence Challenge、material findings、evidence、residual。 |
|
|
71
|
+
| 收口记录 | `coding-agent-harness/planning/tasks/<task>/<date>-<name>.md` | 给下一轮 agent 的可追溯交接。 |
|
|
72
|
+
| Closeout Index | `coding-agent-harness/governance/generated/Closeout-Index.md` | closed task 的 walkthrough 路径和跳过原因索引。 |
|
|
73
|
+
| Regression SSoT | `coding-agent-harness/governance/regression/Regression-SSoT.md` | 管回归 surface、evidence depth、residual。 |
|
|
74
74
|
| Harness Ledger | `Harness-Ledger.md` | 管上下文维护合规性,不复制业务事实。 |
|
|
75
|
-
| Reference 标准 | `
|
|
75
|
+
| Reference 标准 | `coding-agent-harness/governance/standards/*.md` | 管长期规则,避免写成任务日志。 |
|
|
76
76
|
|
|
77
77
|
## 归档规则
|
|
78
78
|
|
|
@@ -81,7 +81,7 @@ Inventory -> Classify -> Sanitize -> Digest -> Project -> Verify -> Residual
|
|
|
81
81
|
- 归档不删除原始 ID,不破坏 task plan、walkthrough、SSoT、Ledger 之间的引用。
|
|
82
82
|
- 活跃文件必须留下归档指针,说明历史记录在哪里。
|
|
83
83
|
- `review.md` 留在对应任务目录,不移动到 walkthrough 或根目录。
|
|
84
|
-
- `
|
|
84
|
+
- `coding-agent-harness/governance/generated/Harness-Ledger.md` 由 CLI 生成,不应手写。
|
|
85
85
|
- `docs/99-TMP/` 下超过 7 天未更新的文件应清理或迁移到正式位置。
|
|
86
86
|
|
|
87
87
|
## 写作原则
|
|
@@ -91,4 +91,4 @@ Inventory -> Classify -> Sanitize -> Digest -> Project -> Verify -> Residual
|
|
|
91
91
|
3. 证据用路径、命令、日志、截图、PR、CI run 引用,不依赖聊天记录。
|
|
92
92
|
4. 表格用于状态和路由;段落用于解释判断和边界。
|
|
93
93
|
5. 更新 reference 或 template 时,必须在 Harness Ledger 记录本次上下文维护。
|
|
94
|
-
6. `
|
|
94
|
+
6. `context/{architecture,development,integrations}` 文档必须使用 schema 信号,发现内容错位时迁移到正确目录。
|
|
@@ -10,7 +10,7 @@
|
|
|
10
10
|
2. 读取功能 SSoT 或 Delivery SSoT,确认任务状态、owner 和依赖。
|
|
11
11
|
3. 读取 `task_plan.md`,确认目标、范围、证据、stop condition 和允许修改的路径。
|
|
12
12
|
4. 读取 `delivery-operating-model-standard.md`,判断本轮是 solo、team、split-repo、program、waterfall 还是 kanban 交付形态。
|
|
13
|
-
5. 多人、多 agent、多仓、共享文件或阶段交付任务必须更新 `
|
|
13
|
+
5. 多人、多 agent、多仓、共享文件或阶段交付任务必须更新 `coding-agent-harness/planning/Delivery-SSoT.md`。
|
|
14
14
|
6. 判断是否属于长程任务;如属于,按 `long-running-task-standard.md` 补齐合同。
|
|
15
15
|
7. 判断是否需要对抗性审查;如需要,按 `adversarial-review-standard.md` 创建或更新 `review.md`。
|
|
16
16
|
8. planned task 默认需要 closeout review;先读取 `review-routing-standard.md`。
|
|
@@ -2,15 +2,15 @@
|
|
|
2
2
|
|
|
3
3
|
## 职责
|
|
4
4
|
|
|
5
|
-
本标准定义 Agent 如何接收、过滤、整理外部项目或微服务团队提供的大量文档。目标是把外部资料变成可执行上下文,而不是把资料堆进 `
|
|
5
|
+
本标准定义 Agent 如何接收、过滤、整理外部项目或微服务团队提供的大量文档。目标是把外部资料变成可执行上下文,而不是把资料堆进 `context/{architecture,development,integrations}`。
|
|
6
6
|
|
|
7
7
|
## 核心模型
|
|
8
8
|
|
|
9
9
|
```text
|
|
10
|
-
外部原始资料 -> source pack 索引 -> digest 摘要 ->
|
|
10
|
+
外部原始资料 -> source pack 索引 -> digest 摘要 -> context/{architecture,development,integrations} 执行投影
|
|
11
11
|
```
|
|
12
12
|
|
|
13
|
-
`
|
|
13
|
+
`context/architecture`、`context/development`、`context/integrations` 只保存已经提炼并可用于执行的事实。外部团队丢来的原文、长文档、截图、聊天记录、导出包和历史资料先进入 `coding-agent-harness/context/development/external-source-packs/`,不能直接污染执行文档。
|
|
14
14
|
|
|
15
15
|
## 何时询问用户
|
|
16
16
|
|
|
@@ -32,27 +32,27 @@
|
|
|
32
32
|
|
|
33
33
|
| 场景 | 存储方式 |
|
|
34
34
|
| --- | --- |
|
|
35
|
-
| 只有 1-4 个稳定外部文档 | 不必建独立 source pack;在对应 `
|
|
36
|
-
| 外部资料超过 5 份、跨多个主题、或会持续增长 | 创建 `
|
|
35
|
+
| 只有 1-4 个稳定外部文档 | 不必建独立 source pack;在对应 `context/{architecture,development,integrations}` 的 `Source Evidence` 中链接即可 |
|
|
36
|
+
| 外部资料超过 5 份、跨多个主题、或会持续增长 | 创建 `coding-agent-harness/context/development/external-source-packs/<source-key>/` |
|
|
37
37
|
| 资料含敏感信息、密钥、客户数据或不能进仓 | 不复制原文;在 source pack README 记录外部路径、owner、访问条件和摘要 |
|
|
38
38
|
| 资料是可公开或可入仓的原始文档 | 可放 `raw/`,但仍要经过 digest 后才能投影到执行文档 |
|
|
39
39
|
|
|
40
40
|
建议结构:
|
|
41
41
|
|
|
42
42
|
```text
|
|
43
|
-
|
|
43
|
+
coding-agent-harness/context/development/external-source-packs/<source-key>/
|
|
44
44
|
├── README.md # 资料索引和投影状态
|
|
45
45
|
├── digests/ # 每份或每组资料的摘要
|
|
46
46
|
├── raw/ # 可入仓原文;禁止放密钥、隐私或客户数据
|
|
47
47
|
└── raw-index.md # 原文不能入仓时,用路径/URL/owner 索引替代 raw/
|
|
48
48
|
```
|
|
49
49
|
|
|
50
|
-
不要为每个微服务复制一套完整 `
|
|
50
|
+
不要为每个微服务复制一套完整 `context/{architecture,development,integrations}` 目录。source pack 是资料入口;稳定执行入口仍然是:
|
|
51
51
|
|
|
52
|
-
- `
|
|
53
|
-
- `
|
|
54
|
-
- `
|
|
55
|
-
- `
|
|
52
|
+
- `coding-agent-harness/context/architecture/service-catalog.md`
|
|
53
|
+
- `coding-agent-harness/context/architecture/services/<service-key>.md`
|
|
54
|
+
- `coding-agent-harness/context/development/external-context/<service-key>.md`
|
|
55
|
+
- `coding-agent-harness/context/integrations/<contract>.md`
|
|
56
56
|
|
|
57
57
|
## 摄取流程
|
|
58
58
|
|
|
@@ -60,7 +60,7 @@ docs/04-DEVELOPMENT/external-source-packs/<source-key>/
|
|
|
60
60
|
2. **Classify**:按 architecture、development、integration、security、operations、product、unknown 分类。
|
|
61
61
|
3. **Sanitize**:检查密钥、token、客户数据、隐私、内部账号、不可公开链接;不能入仓的只存引用。
|
|
62
62
|
4. **Digest**:用 digest 模板提炼事实、疑问、不安全假设和证据。
|
|
63
|
-
5. **Project**:把稳定事实投影到 `
|
|
63
|
+
5. **Project**:把稳定事实投影到 `context/{architecture,development,integrations}`,并在 source pack README 标记 projected。
|
|
64
64
|
6. **Verify**:能用代码、接口测试、owner 确认或运行证据验证的,更新 `Last Verified` 和 `Confidence`。
|
|
65
65
|
7. **Residual**:不能确认的内容留在 source pack,不进入执行文档,或进入 `Do Not Assume`。
|
|
66
66
|
|
|
@@ -68,14 +68,14 @@ docs/04-DEVELOPMENT/external-source-packs/<source-key>/
|
|
|
68
68
|
|
|
69
69
|
| 资料内容 | 投影位置 |
|
|
70
70
|
| --- | --- |
|
|
71
|
-
| 服务职责、上下游、owner、数据归属、系统拓扑 | `
|
|
72
|
-
| 本仓开发时如何 mock、stub、启动、联调、排查 | `
|
|
73
|
-
| endpoint、payload、auth、error、event、webhook、SDK、contract test | `
|
|
71
|
+
| 服务职责、上下游、owner、数据归属、系统拓扑 | `coding-agent-harness/context/architecture/service-catalog.md` 或 `services/<service-key>.md` |
|
|
72
|
+
| 本仓开发时如何 mock、stub、启动、联调、排查 | `coding-agent-harness/context/development/external-context/<service-key>.md` |
|
|
73
|
+
| endpoint、payload、auth、error、event、webhook、SDK、contract test | `coding-agent-harness/context/integrations/<contract>.md` |
|
|
74
74
|
| 仍未确认、来源冲突、过期或只作为背景参考 | 留在 source pack README / digest,不进入执行文档 |
|
|
75
75
|
|
|
76
76
|
## 禁止事项
|
|
77
77
|
|
|
78
|
-
- 不要把几十份外部文档直接复制到 `
|
|
78
|
+
- 不要把几十份外部文档直接复制到 `context/architecture`、`context/development` 或 `context/integrations` 根目录。
|
|
79
79
|
- 不要把外部资料摘要当成已验证事实;必须记录 `Source Evidence`、`Last Verified` 和 `Confidence`。
|
|
80
80
|
- 不要在执行文档里保留大段原文、聊天流水或历史会议记录。
|
|
81
81
|
- 不要把密钥、真实 token、客户数据、个人隐私或不可公开资料提交进仓。
|
|
@@ -2,13 +2,13 @@
|
|
|
2
2
|
|
|
3
3
|
## 职责
|
|
4
4
|
|
|
5
|
-
Harness Ledger 是 `
|
|
5
|
+
Harness Ledger 是 `coding-agent-harness/` 骨架的全局上下文维护总账,固定位置为:
|
|
6
6
|
|
|
7
7
|
```text
|
|
8
|
-
|
|
8
|
+
coding-agent-harness/governance/generated/Harness-Ledger.md
|
|
9
9
|
```
|
|
10
10
|
|
|
11
|
-
它记录每个非平凡任务是否完成了 task plan、progress、review、功能 SSoT、Delivery SSoT、Regression SSoT、lesson candidates/detail docs、walkthrough、Closeout
|
|
11
|
+
它记录每个非平凡任务是否完成了 task plan、progress、review、功能 SSoT、Delivery SSoT、Regression SSoT、lesson candidates/detail docs、walkthrough、Closeout Index、reference/template 和 CI/CD 治理回写。它不复制业务事实,只记录上下文维护是否合规。
|
|
12
12
|
|
|
13
13
|
## 必须更新的场景
|
|
14
14
|
|
|
@@ -17,7 +17,7 @@ docs/Harness-Ledger.md
|
|
|
17
17
|
- 新增或修改 AGENTS.md、CLAUDE.md、reference、template、checker 或 dashboard。
|
|
18
18
|
- coordinator pass 汇总模块任务、worker handoff、review、closeout 或 regression 结果。
|
|
19
19
|
- 创建或更新 required review。
|
|
20
|
-
- 修改功能 SSoT、Delivery SSoT、Regression SSoT、lesson detail docs、Closeout
|
|
20
|
+
- 修改功能 SSoT、Delivery SSoT、Regression SSoT、lesson detail docs、Closeout Index 任一文件。
|
|
21
21
|
- 创建 walkthrough 或接受受控跳过。
|
|
22
22
|
- Lessons approved 后合入正式 reference。
|
|
23
23
|
|
|
@@ -67,7 +67,7 @@ docs/Harness-Ledger.md
|
|
|
67
67
|
- [ ] repo governance、CI/CD required checks 已验证、更新或 residualized。
|
|
68
68
|
- [ ] 功能 SSoT 或 Delivery SSoT 已更新,或标记 `n/a`。
|
|
69
69
|
- [ ] Regression SSoT / Cadence Ledger 已更新,或标记 `n/a`。
|
|
70
|
-
- [ ] walkthrough 已创建,或 Closeout
|
|
70
|
+
- [ ] walkthrough 已创建,或 Closeout Index 写明受控跳过原因。
|
|
71
71
|
- [ ] walkthrough 包含 Lessons 反思。
|
|
72
72
|
- [ ] Lessons 检查结果为 `checked-candidate: LC-...`、`queued-promotion: LC-...`、`checked-created: L-YYYY-MM-DD-NNN`,或旧任务兼容的 `checked-none: <reason>`。
|
|
73
73
|
- [ ] Harness Ledger 行已收口,或 residual 已写明 owner 和后续路径。
|
|
@@ -88,7 +88,7 @@ docs/Harness-Ledger.md
|
|
|
88
88
|
活跃表保留最近 50 条。更早的 `closed` 或 `superseded` 条目按季度归档:
|
|
89
89
|
|
|
90
90
|
```text
|
|
91
|
-
|
|
91
|
+
coding-agent-harness/governance/archive/Harness-Ledger-archive-YYYY-QN.md
|
|
92
92
|
```
|
|
93
93
|
|
|
94
94
|
归档后,活跃表必须留下归档位置说明。
|
|
@@ -7,7 +7,7 @@ Regression SSoT 是项目回归控制塔,管理所有 regression surface 的 g
|
|
|
7
7
|
默认位置:
|
|
8
8
|
|
|
9
9
|
```text
|
|
10
|
-
|
|
10
|
+
coding-agent-harness/governance/regression/Regression-SSoT.md
|
|
11
11
|
```
|
|
12
12
|
|
|
13
13
|
## 维护时机
|
|
@@ -61,7 +61,7 @@ docs/05-TEST-QA/Regression-SSoT.md
|
|
|
61
61
|
|
|
62
62
|
## 废弃回归门禁
|
|
63
63
|
|
|
64
|
-
1. 将 gate 移入 `
|
|
64
|
+
1. 将 gate 移入 `coding-agent-harness/governance/regression/_archive/Regression-SSoT-archive-YYYY-QN.md`。
|
|
65
65
|
2. 写明废弃原因、替代 gate 和最后状态。
|
|
66
66
|
3. 同步更新 Cadence Ledger。
|
|
67
67
|
4. 在 walkthrough 和 Harness Ledger 记录本次治理变化。
|
|
@@ -33,7 +33,7 @@
|
|
|
33
33
|
| --- | --- |
|
|
34
34
|
| 是否必须 PR | yes / no / local-only |
|
|
35
35
|
| PR 标题格式 | 通常与 commit 规范一致 |
|
|
36
|
-
| PR 描述要求 | 遵守 `
|
|
36
|
+
| PR 描述要求 | 遵守 `coding-agent-harness/governance/standards/pull-request-standard.md`;写清改动、原因、版本影响、验证、residual、关联 task / SSoT / review |
|
|
37
37
|
| 必需审查者 | reviewer、外部 agent、人类 owner 或代码 owner |
|
|
38
38
|
| 必需审查类型 | self-review、subagent review、human review、security review |
|
|
39
39
|
| merge method | merge commit、squash、rebase、fast-forward |
|
|
@@ -86,4 +86,4 @@ Worker 必须走 `worktree-standard.md`,并先在 `execution_strategy.md` 记
|
|
|
86
86
|
- [ ] open P0/P1 findings 为 0。
|
|
87
87
|
- [ ] material P2 已修复或 `accepted-risk` 并路由。
|
|
88
88
|
- [ ] 如使用 worker,已记录 branch、commit SHA、checks、residual 和 integration evidence。
|
|
89
|
-
- [ ] walkthrough、Closeout
|
|
89
|
+
- [ ] walkthrough、Closeout Index、Harness Ledger 引用了审查报告或跳过原因。
|
|
@@ -7,13 +7,13 @@
|
|
|
7
7
|
默认位置:
|
|
8
8
|
|
|
9
9
|
```text
|
|
10
|
-
|
|
10
|
+
coding-agent-harness/planning/tasks/<task>/walkthrough.md
|
|
11
11
|
```
|
|
12
12
|
|
|
13
|
-
Closeout
|
|
13
|
+
Closeout Index 固定位置:
|
|
14
14
|
|
|
15
15
|
```text
|
|
16
|
-
|
|
16
|
+
coding-agent-harness/governance/generated/Closeout-Index.md
|
|
17
17
|
```
|
|
18
18
|
|
|
19
19
|
## 何时必须写
|
|
@@ -46,13 +46,13 @@ docs/10-WALKTHROUGH/Closeout-SSoT.md
|
|
|
46
46
|
|
|
47
47
|
## 收口单一事实源规则
|
|
48
48
|
|
|
49
|
-
以下 Harness Ledger row 必须有 Closeout
|
|
49
|
+
以下 Harness Ledger row 必须有 Closeout Index row:
|
|
50
50
|
|
|
51
51
|
- `closed`
|
|
52
52
|
- `closed-with-residual`
|
|
53
53
|
- `closed-local-only`
|
|
54
54
|
|
|
55
|
-
Closeout
|
|
55
|
+
Closeout Index 中:
|
|
56
56
|
|
|
57
57
|
- walkthrough 列写实际路径,或写受控跳过原因。
|
|
58
58
|
- Lessons 检查列写 `checked-candidate: LC-...`、`queued-promotion: LC-...`、`checked-created: L-YYYY-MM-DD-NNN`,或旧任务兼容的 `checked-none: <reason>`。
|
|
@@ -73,7 +73,7 @@ Closeout SSoT 中:
|
|
|
73
73
|
- 人工审查后,如需沉淀,再由维护命令写 promoted lesson 详情文档。
|
|
74
74
|
- `checked-created:<L-ID>` 必须能追溯到该详情文档。
|
|
75
75
|
|
|
76
|
-
三个答案都为“没有”时,Closeout
|
|
76
|
+
三个答案都为“没有”时,Closeout Index 和 Harness Ledger 仍要记录:
|
|
77
77
|
|
|
78
78
|
```text
|
|
79
79
|
lesson_candidates.md: no-candidate-accepted
|
|
@@ -81,4 +81,4 @@ lesson_candidates.md: no-candidate-accepted
|
|
|
81
81
|
|
|
82
82
|
## 收口要求
|
|
83
83
|
|
|
84
|
-
walkthrough 写完后,必须更新 Closeout
|
|
84
|
+
walkthrough 写完后,必须更新 Closeout Index 和 Harness Ledger。涉及回归、CI/CD、repo governance、reference 或 template 的,还要同步对应标准或 SSoT。
|
|
@@ -25,11 +25,11 @@
|
|
|
25
25
|
|
|
26
26
|
## 归档索引
|
|
27
27
|
|
|
28
|
-
> 批次日志超过 50 行或完成阶段收口时,移入 `
|
|
28
|
+
> 批次日志超过 50 行或完成阶段收口时,移入 `coding-agent-harness/governance/regression/_archive/Cadence-Ledger-archive-YYYY-QN.md`。
|
|
29
29
|
|
|
30
30
|
| 归档文件 | 覆盖批次 | 移入日期 | 说明 |
|
|
31
31
|
| --- | --- | --- | --- |
|
|
32
|
-
| `
|
|
32
|
+
| `coding-agent-harness/governance/regression/_archive/Cadence-Ledger-archive-YYYY-QN.md` | SRB-... 至 SRB-... | YYYY-MM-DD | [说明] |
|
|
33
33
|
|
|
34
34
|
## 结果状态
|
|
35
35
|
|
|
@@ -33,11 +33,11 @@
|
|
|
33
33
|
|
|
34
34
|
## 归档索引
|
|
35
35
|
|
|
36
|
-
> 已完成交付块在 release 或阶段收口后移入 `
|
|
36
|
+
> 已完成交付块在 release 或阶段收口后移入 `coding-agent-harness/planning/_archive/Delivery-SSoT-archive-YYYY-QN.md`,活跃表只保留当前仍会影响集成决策的内容。
|
|
37
37
|
|
|
38
38
|
| 归档文件 | 覆盖范围 | 移入日期 | 说明 |
|
|
39
39
|
| --- | --- | --- | --- |
|
|
40
|
-
| `
|
|
40
|
+
| `coding-agent-harness/planning/_archive/Delivery-SSoT-archive-YYYY-QN.md` | DB-... 至 DB-... | YYYY-MM-DD | [说明] |
|
|
41
41
|
|
|
42
42
|
## 状态说明
|
|
43
43
|
|
|
@@ -57,4 +57,4 @@
|
|
|
57
57
|
2. 依赖未满足时不得标记 `ready-for-integration`。
|
|
58
58
|
3. 跨仓接口变化必须有合同条目,不能只靠聊天说明。
|
|
59
59
|
4. 集成队列是合并顺序来源;临时改顺序必须更新本文件。
|
|
60
|
-
5. 完成后的证据和残余同步回 Harness Ledger 与 Closeout
|
|
60
|
+
5. 完成后的证据和残余同步回 Harness Ledger 与 Closeout Index。
|