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.
Files changed (260) hide show
  1. package/CONTRIBUTING.md +2 -2
  2. package/README.md +63 -3
  3. package/README.zh-CN.md +52 -3
  4. package/SKILL.md +43 -43
  5. package/dist/build-dist.mjs +189 -0
  6. package/dist/check-dist-observation.mjs +428 -0
  7. package/dist/check-harness.mjs +489 -0
  8. package/dist/check-import-graph.mjs +511 -0
  9. package/dist/check-runtime-emit.mjs +304 -0
  10. package/dist/check-type-boundaries.mjs +139 -0
  11. package/dist/commands/dashboard-command.mjs +80 -0
  12. package/dist/commands/migration-command.mjs +152 -0
  13. package/dist/commands/preset-command.mjs +91 -0
  14. package/dist/commands/task-command.mjs +324 -0
  15. package/dist/harness.mjs +304 -0
  16. package/dist/lib/capability-registry.mjs +643 -0
  17. package/dist/lib/check-module-parallel.mjs +227 -0
  18. package/dist/lib/check-profiles.mjs +414 -0
  19. package/dist/lib/check-task-contracts.mjs +54 -0
  20. package/dist/lib/core-shared.mjs +254 -0
  21. package/dist/lib/dashboard-data.mjs +608 -0
  22. package/dist/lib/dashboard-workbench.mjs +334 -0
  23. package/dist/lib/dashboard-writer.mjs +200 -0
  24. package/dist/lib/git-status-summary.mjs +45 -0
  25. package/dist/lib/governance-index-generator.mjs +236 -0
  26. package/dist/lib/governance-sync.mjs +617 -0
  27. package/dist/lib/governance-table-boundary.mjs +161 -0
  28. package/{scripts → dist}/lib/harness-core.mjs +2 -0
  29. package/dist/lib/harness-paths.mjs +338 -0
  30. package/dist/lib/lesson-maintenance.mjs +139 -0
  31. package/dist/lib/markdown-utils.mjs +193 -0
  32. package/dist/lib/migration-planner.mjs +439 -0
  33. package/dist/lib/migration-support.mjs +317 -0
  34. package/dist/lib/phase-kind.mjs +46 -0
  35. package/dist/lib/preset-audit-contracts.mjs +40 -0
  36. package/dist/lib/preset-engine.mjs +516 -0
  37. package/dist/lib/preset-registry.mjs +831 -0
  38. package/dist/lib/preset-resource-contracts.mjs +83 -0
  39. package/dist/lib/review-confirm-git-gate.mjs +244 -0
  40. package/dist/lib/status-builder.mjs +87 -0
  41. package/{scripts → dist}/lib/status-dashboard-renderer.mjs +44 -46
  42. package/dist/lib/structure-migration.mjs +404 -0
  43. package/dist/lib/subagent-authorization-audit.mjs +198 -0
  44. package/dist/lib/task-audit-metadata.mjs +376 -0
  45. package/dist/lib/task-audit-migration.mjs +355 -0
  46. package/dist/lib/task-completion-consistency.mjs +29 -0
  47. package/dist/lib/task-index.mjs +133 -0
  48. package/dist/lib/task-lesson-candidates.mjs +239 -0
  49. package/dist/lib/task-lesson-sedimentation.mjs +300 -0
  50. package/dist/lib/task-lifecycle/create-task-helpers.mjs +84 -0
  51. package/dist/lib/task-lifecycle/phase-sync.mjs +82 -0
  52. package/dist/lib/task-lifecycle/review-confirm.mjs +93 -0
  53. package/dist/lib/task-lifecycle/review-gates.mjs +62 -0
  54. package/dist/lib/task-lifecycle/review-submission.mjs +52 -0
  55. package/dist/lib/task-lifecycle/scaffold-provenance.mjs +54 -0
  56. package/dist/lib/task-lifecycle/template-files.mjs +52 -0
  57. package/dist/lib/task-lifecycle/text-utils.mjs +26 -0
  58. package/dist/lib/task-lifecycle.mjs +611 -0
  59. package/dist/lib/task-metadata.mjs +116 -0
  60. package/dist/lib/task-review-model.mjs +474 -0
  61. package/dist/lib/task-scanner.mjs +439 -0
  62. package/dist/lib/task-tombstone-commands.mjs +125 -0
  63. package/dist/postinstall.mjs +14 -0
  64. package/dist/run-built-tests.mjs +84 -0
  65. package/docs-release/README.md +1 -0
  66. package/docs-release/architecture/overview.md +12 -12
  67. package/docs-release/architecture/overview.zh-CN.md +12 -12
  68. package/docs-release/architecture/system-explainer/01-system-overview.md +15 -14
  69. package/docs-release/architecture/system-explainer/02-module-dependency.md +8 -8
  70. package/docs-release/architecture/system-explainer/03-task-lifecycle.md +3 -3
  71. package/docs-release/architecture/system-explainer/04-check-and-governance.md +9 -7
  72. package/docs-release/architecture/system-explainer/05-data-flow.md +5 -5
  73. package/docs-release/architecture/system-explainer/06-preset-and-migration.md +1 -4
  74. package/docs-release/architecture/system-explainer/en-US/01-system-overview.md +15 -14
  75. package/docs-release/architecture/system-explainer/en-US/02-module-dependency.md +8 -8
  76. package/docs-release/architecture/system-explainer/en-US/03-task-lifecycle.md +3 -3
  77. package/docs-release/architecture/system-explainer/en-US/04-check-and-governance.md +10 -8
  78. package/docs-release/architecture/system-explainer/en-US/05-data-flow.md +5 -5
  79. package/docs-release/architecture/system-explainer/en-US/06-preset-and-migration.md +1 -4
  80. package/docs-release/guides/agent-installation.en-US.md +14 -8
  81. package/docs-release/guides/agent-installation.md +14 -8
  82. package/docs-release/guides/contributing.md +3 -3
  83. package/docs-release/guides/contributing.zh-CN.md +3 -3
  84. package/docs-release/guides/document-audience-and-surfaces.en-US.md +10 -10
  85. package/docs-release/guides/document-audience-and-surfaces.md +10 -10
  86. package/docs-release/guides/legacy-migration-agent-prompt.md +25 -2
  87. package/docs-release/guides/legacy-migration-agent-prompt.zh-CN.md +25 -2
  88. package/docs-release/guides/migration-playbook.en-US.md +63 -1
  89. package/docs-release/guides/migration-playbook.md +59 -1
  90. package/docs-release/guides/parent-control-repository-pattern.en-US.md +25 -25
  91. package/docs-release/guides/parent-control-repository-pattern.md +25 -25
  92. package/docs-release/guides/preset-development.md +2 -2
  93. package/docs-release/guides/repository-operating-models.en-US.md +21 -21
  94. package/docs-release/guides/repository-operating-models.md +21 -21
  95. package/docs-release/guides/task-state-machine.en-US.md +5 -5
  96. package/docs-release/guides/task-state-machine.md +5 -5
  97. package/docs-release/guides/typescript-runtime-migration-closeout.md +96 -0
  98. package/examples/minimal-project/AGENTS.md +2 -2
  99. package/examples/minimal-project/coding-agent-harness/harness.yaml +14 -0
  100. package/examples/minimal-project/coding-agent-harness/planning/tasks/demo-task/progress.md +11 -0
  101. package/examples/minimal-project/{docs/09-PLANNING/TASKS → coding-agent-harness/planning/tasks}/demo-task/review.md +1 -1
  102. package/package.json +20 -12
  103. package/presets/legacy-migration/preset.yaml +5 -5
  104. package/presets/legacy-migration/templates/execution_strategy.append.md +1 -1
  105. package/presets/lesson-sedimentation/preset.yaml +3 -3
  106. package/presets/module/preset.yaml +2 -2
  107. package/presets/module/templates/execution_strategy.append.md +1 -1
  108. package/presets/module/templates/task_plan.append.md +3 -3
  109. package/presets/standard-task/preset.yaml +2 -2
  110. package/references/adversarial-review-standard.md +2 -2
  111. package/references/agents-md-pattern.md +14 -14
  112. package/references/cadence-ledger.md +1 -1
  113. package/references/ci-cd-standard.md +1 -1
  114. package/references/delivery-operating-model-standard.md +4 -4
  115. package/references/docs-directory-standard.md +65 -159
  116. package/references/external-source-intake-standard.md +10 -10
  117. package/references/harness-ledger.md +5 -5
  118. package/references/legacy-12-phase-bootstrap.md +2 -2
  119. package/references/lessons-governance.md +15 -15
  120. package/references/long-running-task-standard.md +6 -6
  121. package/references/module-parallel-standard.md +34 -34
  122. package/references/planning-loop.md +6 -6
  123. package/references/project-onboarding-audit.md +4 -4
  124. package/references/regression-system.md +2 -2
  125. package/references/repo-governance-standard.md +4 -4
  126. package/references/review-routing-standard.md +1 -1
  127. package/references/ssot-governance.md +19 -19
  128. package/references/taskr-gap-analysis.md +5 -5
  129. package/references/walkthrough-closeout.md +14 -14
  130. package/references/worktree-parallel.md +3 -3
  131. package/skills/preset-creator/references/complex-task-skeleton/task_plan.md +1 -1
  132. package/skills/preset-creator/references/preset-package-skeleton.md +5 -5
  133. package/templates/AGENTS.md.template +26 -26
  134. package/templates/architecture/README.md +4 -4
  135. package/templates/architecture/service-catalog.md +2 -2
  136. package/templates/architecture/services/service-template.md +1 -1
  137. package/templates/dashboard/assets/app-src/20-overview.js +11 -5
  138. package/templates/dashboard/assets/app-src/40-modules.js +1 -1
  139. package/templates/dashboard/assets/app.js +12 -6
  140. package/templates/dashboard/assets/i18n.js +4 -2
  141. package/templates/development/README.md +10 -10
  142. package/templates/development/cross-repo-debugging.md +3 -3
  143. package/templates/development/external-context/service-template.md +2 -2
  144. package/templates/development/external-source-packs/README.md +4 -4
  145. package/templates/integrations/README.md +4 -4
  146. package/templates/integrations/api-contract.md +2 -2
  147. package/templates/integrations/event-contract.md +2 -2
  148. package/templates/integrations/third-party/vendor-template.md +2 -2
  149. package/templates/integrations/webhook-contract.md +2 -2
  150. package/templates/ledger/Harness-Ledger.md +1 -1
  151. package/templates/planning/INDEX.md +1 -0
  152. package/templates/planning/module_session_prompt.md +1 -1
  153. package/templates/planning/task_plan.md +1 -1
  154. package/templates/planning/walkthrough.md +47 -0
  155. package/templates/reference/docs-library-standard.md +8 -8
  156. package/templates/reference/external-source-intake-standard.md +15 -15
  157. package/templates/reference/repo-governance-standard.md +1 -1
  158. package/templates/ssot/Module-Registry.md +1 -1
  159. package/templates/walkthrough/walkthrough-template.md +2 -2
  160. package/templates-zh-CN/AGENTS.md.template +26 -26
  161. package/templates-zh-CN/CLAUDE.md.template +1 -1
  162. package/templates-zh-CN/architecture/README.md +4 -4
  163. package/templates-zh-CN/architecture/service-catalog.md +2 -2
  164. package/templates-zh-CN/architecture/services/service-template.md +1 -1
  165. package/templates-zh-CN/development/README.md +10 -10
  166. package/templates-zh-CN/development/cross-repo-debugging.md +3 -3
  167. package/templates-zh-CN/development/external-context/service-template.md +2 -2
  168. package/templates-zh-CN/development/external-source-packs/README.md +4 -4
  169. package/templates-zh-CN/integrations/README.md +4 -4
  170. package/templates-zh-CN/integrations/api-contract.md +2 -2
  171. package/templates-zh-CN/integrations/event-contract.md +2 -2
  172. package/templates-zh-CN/integrations/third-party/vendor-template.md +2 -2
  173. package/templates-zh-CN/integrations/webhook-contract.md +2 -2
  174. package/templates-zh-CN/ledger/Harness-Ledger.md +1 -1
  175. package/templates-zh-CN/lessons/lesson-arch-process-change.md +1 -1
  176. package/templates-zh-CN/lessons/lesson-new-doc.md +3 -3
  177. package/templates-zh-CN/lessons/lesson-ref-change.md +4 -4
  178. package/templates-zh-CN/planning/module_session_prompt.md +11 -11
  179. package/templates-zh-CN/planning/walkthrough.md +47 -0
  180. package/templates-zh-CN/reference/adversarial-review-standard.md +2 -2
  181. package/templates-zh-CN/reference/delivery-operating-model-standard.md +3 -3
  182. package/templates-zh-CN/reference/docs-library-standard.md +28 -28
  183. package/templates-zh-CN/reference/execution-workflow-standard.md +1 -1
  184. package/templates-zh-CN/reference/external-source-intake-standard.md +16 -16
  185. package/templates-zh-CN/reference/harness-ledger-standard.md +6 -6
  186. package/templates-zh-CN/reference/regression-ssot-governance.md +2 -2
  187. package/templates-zh-CN/reference/repo-governance-standard.md +1 -1
  188. package/templates-zh-CN/reference/review-routing-standard.md +1 -1
  189. package/templates-zh-CN/reference/walkthrough-standard.md +7 -7
  190. package/templates-zh-CN/reference/worktree-standard.md +1 -1
  191. package/templates-zh-CN/regression/Cadence-Ledger.md +2 -2
  192. package/templates-zh-CN/ssot/Delivery-SSoT.md +3 -3
  193. package/templates-zh-CN/ssot/Module-Registry.md +3 -3
  194. package/templates-zh-CN/ssot/Regression-SSoT.md +2 -2
  195. package/templates-zh-CN/walkthrough/walkthrough-template.md +5 -5
  196. package/tsconfig.dist.json +16 -0
  197. package/tsconfig.json +25 -0
  198. package/tsconfig.runtime.json +24 -0
  199. package/examples/minimal-project/.harness-capabilities.json +0 -8
  200. package/examples/minimal-project/docs/09-PLANNING/TASKS/demo-task/progress.md +0 -11
  201. package/scripts/check-harness.mjs +0 -508
  202. package/scripts/commands/dashboard-command.mjs +0 -67
  203. package/scripts/commands/migration-command.mjs +0 -126
  204. package/scripts/commands/preset-command.mjs +0 -73
  205. package/scripts/commands/task-command.mjs +0 -328
  206. package/scripts/harness.mjs +0 -291
  207. package/scripts/lib/capability-registry.mjs +0 -587
  208. package/scripts/lib/check-module-parallel.mjs +0 -230
  209. package/scripts/lib/check-profiles.mjs +0 -372
  210. package/scripts/lib/check-task-contracts.mjs +0 -55
  211. package/scripts/lib/core-shared.mjs +0 -249
  212. package/scripts/lib/dashboard-data.mjs +0 -520
  213. package/scripts/lib/dashboard-workbench.mjs +0 -336
  214. package/scripts/lib/dashboard-writer.mjs +0 -202
  215. package/scripts/lib/git-status-summary.mjs +0 -46
  216. package/scripts/lib/governance-index-generator.mjs +0 -174
  217. package/scripts/lib/governance-sync.mjs +0 -611
  218. package/scripts/lib/governance-table-boundary.mjs +0 -175
  219. package/scripts/lib/lesson-maintenance.mjs +0 -152
  220. package/scripts/lib/markdown-utils.mjs +0 -191
  221. package/scripts/lib/migration-planner.mjs +0 -476
  222. package/scripts/lib/migration-support.mjs +0 -312
  223. package/scripts/lib/phase-kind.mjs +0 -50
  224. package/scripts/lib/preset-audit-contracts.mjs +0 -37
  225. package/scripts/lib/preset-engine.mjs +0 -494
  226. package/scripts/lib/preset-registry.mjs +0 -776
  227. package/scripts/lib/preset-resource-contracts.mjs +0 -83
  228. package/scripts/lib/review-confirm-git-gate.mjs +0 -248
  229. package/scripts/lib/status-builder.mjs +0 -88
  230. package/scripts/lib/subagent-authorization-audit.mjs +0 -196
  231. package/scripts/lib/task-audit-metadata.mjs +0 -385
  232. package/scripts/lib/task-audit-migration.mjs +0 -350
  233. package/scripts/lib/task-completion-consistency.mjs +0 -26
  234. package/scripts/lib/task-index.mjs +0 -93
  235. package/scripts/lib/task-lesson-candidates.mjs +0 -242
  236. package/scripts/lib/task-lesson-sedimentation.mjs +0 -326
  237. package/scripts/lib/task-lifecycle/create-task-helpers.mjs +0 -67
  238. package/scripts/lib/task-lifecycle/phase-sync.mjs +0 -88
  239. package/scripts/lib/task-lifecycle/review-confirm.mjs +0 -112
  240. package/scripts/lib/task-lifecycle/review-gates.mjs +0 -73
  241. package/scripts/lib/task-lifecycle/review-submission.mjs +0 -63
  242. package/scripts/lib/task-lifecycle/scaffold-provenance.mjs +0 -49
  243. package/scripts/lib/task-lifecycle/template-files.mjs +0 -53
  244. package/scripts/lib/task-lifecycle/text-utils.mjs +0 -24
  245. package/scripts/lib/task-lifecycle.mjs +0 -616
  246. package/scripts/lib/task-metadata.mjs +0 -118
  247. package/scripts/lib/task-review-model.mjs +0 -455
  248. package/scripts/lib/task-scanner.mjs +0 -503
  249. package/scripts/lib/task-tombstone-commands.mjs +0 -140
  250. package/scripts/postinstall.mjs +0 -14
  251. package/templates/walkthrough/Closeout-SSoT.md +0 -43
  252. package/templates-zh-CN/walkthrough/Closeout-SSoT.md +0 -42
  253. /package/examples/minimal-project/{docs → coding-agent-harness/governance/generated}/Harness-Ledger.md +0 -0
  254. /package/examples/minimal-project/{docs/09-PLANNING/TASKS → coding-agent-harness/planning/tasks}/demo-task/INDEX.md +0 -0
  255. /package/examples/minimal-project/{docs/09-PLANNING/TASKS → coding-agent-harness/planning/tasks}/demo-task/brief.md +0 -0
  256. /package/examples/minimal-project/{docs/09-PLANNING/TASKS → coding-agent-harness/planning/tasks}/demo-task/execution_strategy.md +0 -0
  257. /package/examples/minimal-project/{docs/09-PLANNING/TASKS → coding-agent-harness/planning/tasks}/demo-task/findings.md +0 -0
  258. /package/examples/minimal-project/{docs/09-PLANNING/TASKS → coding-agent-harness/planning/tasks}/demo-task/lesson_candidates.md +0 -0
  259. /package/examples/minimal-project/{docs/09-PLANNING/TASKS → coding-agent-harness/planning/tasks}/demo-task/task_plan.md +0 -0
  260. /package/examples/minimal-project/{docs/09-PLANNING/TASKS → coding-agent-harness/planning/tasks}/demo-task/visual_map.md +0 -0
@@ -13,7 +13,7 @@ Event
13
13
 
14
14
  | Service Profile | Development Context | Contract Index | Last Verified | Confidence |
15
15
  | --- | --- | --- | --- | --- |
16
- | `docs/03-ARCHITECTURE/services/<service-key>.md` | `docs/04-DEVELOPMENT/external-context/<service-key>.md` | `docs/06-INTEGRATIONS/README.md` | unknown | low |
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
  ## Topic / Channel
19
19
 
@@ -43,4 +43,4 @@ Event
43
43
 
44
44
  ## Placement Rule
45
45
 
46
- This file describes one event contract only. Put service responsibility in `03-ARCHITECTURE`; put local mock/stub/debug details in `04-DEVELOPMENT`.
46
+ This file describes one event contract only. Put service responsibility in `context/architecture`; put local mock/stub/debug details in `context/development`.
@@ -13,7 +13,7 @@ Third-party service
13
13
 
14
14
  | Service Profile | Development Context | Contract Index | Last Verified | Confidence |
15
15
  | --- | --- | --- | --- | --- |
16
- | `docs/03-ARCHITECTURE/services/<vendor-key>.md` | `docs/04-DEVELOPMENT/external-context/<vendor-key>.md` | `docs/06-INTEGRATIONS/README.md` | unknown | low |
16
+ | `coding-agent-harness/context/architecture/services/<vendor-key>.md` | `coding-agent-harness/context/development/external-context/<vendor-key>.md` | `coding-agent-harness/context/integrations/README.md` | unknown | low |
17
17
 
18
18
  ## Auth
19
19
 
@@ -39,4 +39,4 @@ Third-party service
39
39
 
40
40
  ## Placement Rule
41
41
 
42
- This file describes one third-party integration only. Put account/permission/SDK/limit facts here; put business responsibility and system topology in `03-ARCHITECTURE`.
42
+ This file describes one third-party integration only. Put account/permission/SDK/limit facts here; put business responsibility and system topology in `context/architecture`.
@@ -13,7 +13,7 @@ Webhook
13
13
 
14
14
  | Service Profile | Development Context | Contract Index | Last Verified | Confidence |
15
15
  | --- | --- | --- | --- | --- |
16
- | `docs/03-ARCHITECTURE/services/<service-key>.md` | `docs/04-DEVELOPMENT/external-context/<service-key>.md` | `docs/06-INTEGRATIONS/README.md` | unknown | low |
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
- This file describes one webhook contract only. Put service responsibility in `03-ARCHITECTURE`; put local mock/stub/debug details in `04-DEVELOPMENT`.
41
+ This file describes one webhook contract only. Put service responsibility in `context/architecture`; put local mock/stub/debug details in `context/development`.
@@ -12,7 +12,7 @@ Repo Governance / CI-CD changes remain routed through their reference standards
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 | Short operational title | planned | none | docs/09-PLANNING/TASKS/.../task_plan.md | pending | pending | pending | none | YYYY-MM-DD |
15
+ | HL-YYYY-MM-DD-001 | task | none | Short operational title | planned | none | coding-agent-harness/planning/tasks/.../task_plan.md | pending | pending | pending | none | YYYY-MM-DD |
16
16
 
17
17
  ## Field Rules
18
18
 
@@ -49,6 +49,7 @@ Task Contract: harness-task/v1
49
49
  | `task_plan.md` | Current task goal, scope, selected budget, acceptance, and operating decisions. |
50
50
  | `visual_map.md` | Phase map, evidence status, next lifecycle commands, and supporting diagrams. |
51
51
  | `progress.md` | Execution log, verification evidence, decisions, and handoff notes. |
52
+ | `walkthrough.md` | Task-local closeout summary, verification, review disposition, residual risk, and links. |
52
53
 
53
54
  ## Standard Task Files
54
55
 
@@ -39,7 +39,7 @@ Do not edit shared SSoT files, coordinator-owned integration files, or unrelated
39
39
 
40
40
  ## Shared Sync Rule
41
41
 
42
- Do not update Module Registry, Harness Ledger, Closeout SSoT, Regression SSoT, or Cadence Ledger from a worker session unless the coordinator assigned the shared lock.
42
+ Do not update Module Registry, Harness Ledger, Closeout Index, Regression SSoT, or Cadence Ledger from a worker session unless the coordinator assigned the shared lock.
43
43
 
44
44
  ## Stop Rule
45
45
 
@@ -69,4 +69,4 @@ Rationale: [why this budget fits this task]
69
69
 
70
70
  - Global sync owner: coordinator / n/a
71
71
  - Global sync status: pending-coordinator-pass / synced / n/a
72
- - Shared updates needed: [Module Registry / Harness Ledger / Closeout SSoT / Regression SSoT / none]
72
+ - Shared updates needed: [Module Registry / Harness Ledger / Closeout Index / Regression SSoT / none]
@@ -0,0 +1,47 @@
1
+ # Walkthrough: {{TASK_TITLE}}
2
+
3
+ ## Summary
4
+
5
+ Pending closeout.
6
+
7
+ ## Scope
8
+
9
+ | Area | Details |
10
+ | --- | --- |
11
+ | Changed modules | pending |
12
+ | New files | pending |
13
+ | Removed files | pending |
14
+ | Out of scope | pending |
15
+
16
+ ## Verification
17
+
18
+ | Check | Command or Procedure | Result | Evidence |
19
+ | --- | --- | --- | --- |
20
+ | pending | pending | not run | pending |
21
+
22
+ ## Review Disposition
23
+
24
+ | Source | Material Findings | Resolution | Evidence |
25
+ | --- | --- | --- | --- |
26
+ | pending | pending | pending | `review.md` |
27
+
28
+ ## Residual Risk
29
+
30
+ | Risk | Owner | Accepted? | Follow-up |
31
+ | --- | --- | --- | --- |
32
+ | pending | owner | pending | pending |
33
+
34
+ ## Lessons Reflection
35
+
36
+ | Question | Answer |
37
+ | --- | --- |
38
+ | Was a lesson candidate reviewed? | pending |
39
+ | Lessons detail doc | `lesson_candidates.md` |
40
+
41
+ ## Closeout Links
42
+
43
+ | Artifact | Link |
44
+ | --- | --- |
45
+ | Task plan | `task_plan.md` |
46
+ | Review | `review.md` |
47
+ | Progress | `progress.md` |
@@ -20,16 +20,16 @@ Use these directories as a low-entropy context system:
20
20
 
21
21
  | Directory | Owns | Must Not Own | Required Schema Signals |
22
22
  | --- | --- | --- | --- |
23
- | `docs/03-ARCHITECTURE/` | system structure, service responsibility, ownership, service catalog, critical flows, ADRs | endpoint payloads, mock instructions, task logs | `Context Doc Type`, `Source Evidence`, `Last Verified`, `Confidence` |
24
- | `docs/04-DEVELOPMENT/` | local setup, codebase map, external development context, external source packs, mocks, stubs, cross-repo debugging | long-lived architecture facts, API payload contracts, undigested external document dumps | `Context Doc Type`, `Development Use`, `Do Not Assume`, `Mocks / Stubs`, `Source Evidence`, `Last Verified`, `Confidence` |
25
- | `docs/06-INTEGRATIONS/` | API/event/webhook/SDK/third-party contracts, auth, payloads, errors, contract tests | global topology, service ownership catalog, debugging notes | `Context Doc Type`, `Contract Type`, `Auth`, `Payload`, `Errors`, `Contract Tests`, `Source Evidence`, `Last Verified`, `Confidence` |
23
+ | `coding-agent-harness/context/architecture/` | system structure, service responsibility, ownership, service catalog, critical flows, ADRs | endpoint payloads, mock instructions, task logs | `Context Doc Type`, `Source Evidence`, `Last Verified`, `Confidence` |
24
+ | `coding-agent-harness/context/development/` | local setup, codebase map, external development context, external source packs, mocks, stubs, cross-repo debugging | long-lived architecture facts, API payload contracts, undigested external document dumps | `Context Doc Type`, `Development Use`, `Do Not Assume`, `Mocks / Stubs`, `Source Evidence`, `Last Verified`, `Confidence` |
25
+ | `coding-agent-harness/context/integrations/` | API/event/webhook/SDK/third-party contracts, auth, payloads, errors, contract tests | global topology, service ownership catalog, debugging notes | `Context Doc Type`, `Contract Type`, `Auth`, `Payload`, `Errors`, `Contract Tests`, `Source Evidence`, `Last Verified`, `Confidence` |
26
26
 
27
27
  Concrete split:
28
28
 
29
- - `03-ARCHITECTURE/service-catalog.md` gives only the service summary and links.
30
- - `06-INTEGRATIONS/<service>-api-contract.md` owns payload bodies, auth, errors, and contract tests.
31
- - `04-DEVELOPMENT/external-context/<service>.md` owns mocks, stubs, unsafe assumptions, and debug notes.
32
- - `04-DEVELOPMENT/external-source-packs/` owns external source indexes, digests, and projection status only; final facts must be written back to `03/04/06`.
29
+ - `coding-agent-harness/context/architecture/service-catalog.md` gives only the service summary and links.
30
+ - `coding-agent-harness/context/integrations/<service>-api-contract.md` owns payload bodies, auth, errors, and contract tests.
31
+ - `coding-agent-harness/context/development/external-context/<service>.md` owns mocks, stubs, unsafe assumptions, and debug notes.
32
+ - `coding-agent-harness/context/development/external-source-packs/` owns external source indexes, digests, and projection status only; final facts must be written back to `context/{architecture,development,integrations}`.
33
33
 
34
34
  ## External Source Intake
35
35
 
@@ -51,7 +51,7 @@ Raw external material that has not been digested and projected must not become e
51
51
  - Generated or private artifacts are excluded or explicitly separated.
52
52
  - Cross-links point to the source of truth for each subject.
53
53
  - New standards include closeout and evidence expectations.
54
- - `03/04/06` documents use the required schema signals and route misplaced content back to the correct directory.
54
+ - `context/{architecture,development,integrations}` documents use the required schema signals and route misplaced content back to the correct directory.
55
55
  - External source packs, when present, have a registry, digests, projection targets, and residuals.
56
56
 
57
57
  ## Closeout Expectations
@@ -7,10 +7,10 @@ This standard defines how agents receive, filter, organize, and project large ex
7
7
  ## Core Model
8
8
 
9
9
  ```text
10
- external source material -> source pack index -> digest -> 03/04/06 execution projection
10
+ external source material -> source pack index -> digest -> context/{architecture,development,integrations} execution projection
11
11
  ```
12
12
 
13
- `03-ARCHITECTURE`, `04-DEVELOPMENT`, and `06-INTEGRATIONS` only hold facts that have been distilled enough to guide work. Raw external files, long documents, screenshots, exported chats, diagrams, and historical packets first go through `docs/04-DEVELOPMENT/external-source-packs/`.
13
+ `context/architecture`, `context/development`, and `context/integrations` only hold facts that have been distilled enough to guide work. Raw external files, long documents, screenshots, exported chats, diagrams, and historical packets first go through `coding-agent-harness/context/development/external-source-packs/`.
14
14
 
15
15
  ## When To Ask The User
16
16
 
@@ -32,27 +32,27 @@ Recommended questions:
32
32
 
33
33
  | Case | Storage |
34
34
  | --- | --- |
35
- | Only 1-4 stable external documents | No separate source pack is required; link them from `Source Evidence` in the relevant `03/04/06` docs |
36
- | More than 5 documents, multiple topics, or continuing growth | Create `docs/04-DEVELOPMENT/external-source-packs/<source-key>/` |
35
+ | Only 1-4 stable external documents | No separate source pack is required; link them from `Source Evidence` in the relevant `context/{architecture,development,integrations}` docs |
36
+ | More than 5 documents, multiple topics, or continuing growth | Create `coding-agent-harness/context/development/external-source-packs/<source-key>/` |
37
37
  | Material contains secrets, customer data, private links, or cannot be committed | Do not copy raw files; record external location, owner, access condition, and digest only |
38
38
  | Material is safe to commit | Raw files may go under `raw/`, but only digested facts may be projected into execution docs |
39
39
 
40
40
  Recommended structure:
41
41
 
42
42
  ```text
43
- docs/04-DEVELOPMENT/external-source-packs/<source-key>/
43
+ coding-agent-harness/context/development/external-source-packs/<source-key>/
44
44
  ├── README.md # source index and projection status
45
45
  ├── digests/ # digest for each source or source group
46
46
  ├── raw/ # commit-safe raw material only
47
47
  └── raw-index.md # path/URL/owner index when raw material cannot be committed
48
48
  ```
49
49
 
50
- Do not replicate a full `03/04/06` tree for every microservice. The source pack is the intake layer. The stable execution entries remain:
50
+ Do not replicate a full `context/{architecture,development,integrations}` tree for every microservice. The source pack is the intake layer. The stable execution entries remain:
51
51
 
52
- - `docs/03-ARCHITECTURE/service-catalog.md`
53
- - `docs/03-ARCHITECTURE/services/<service-key>.md`
54
- - `docs/04-DEVELOPMENT/external-context/<service-key>.md`
55
- - `docs/06-INTEGRATIONS/<contract>.md`
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
  ## Intake Flow
58
58
 
@@ -60,7 +60,7 @@ Do not replicate a full `03/04/06` tree for every microservice. The source pack
60
60
  2. **Classify**: tag each source as architecture, development, integration, security, operations, product, or unknown.
61
61
  3. **Sanitize**: check for secrets, tokens, customer data, personal information, internal accounts, and private links; keep non-committable material as references only.
62
62
  4. **Digest**: extract facts, questions, unsafe assumptions, and evidence with the digest template.
63
- 5. **Project**: move stable facts into `03/04/06`, then mark the source as projected in the source pack README.
63
+ 5. **Project**: move stable facts into `context/{architecture,development,integrations}`, then mark the source as projected in the source pack README.
64
64
  6. **Verify**: use code evidence, contract tests, owner confirmation, or runtime checks where feasible; update `Last Verified` and `Confidence`.
65
65
  7. **Residual**: keep unverified or conflicting facts in the source pack or in `Do Not Assume`; do not treat them as execution facts.
66
66
 
@@ -68,14 +68,14 @@ Do not replicate a full `03/04/06` tree for every microservice. The source pack
68
68
 
69
69
  | Source Content | Projection Target |
70
70
  | --- | --- |
71
- | Service responsibility, upstream/downstream relationship, owner, data ownership, topology | `03-ARCHITECTURE/service-catalog.md` or `services/<service-key>.md` |
72
- | Local mocks, stubs, startup, debugging, cross-repo development behavior | `04-DEVELOPMENT/external-context/<service-key>.md` |
73
- | Endpoint, payload, auth, error, event, webhook, SDK, contract test | `06-INTEGRATIONS/<contract>.md` |
71
+ | Service responsibility, upstream/downstream relationship, owner, data ownership, topology | `coding-agent-harness/context/architecture/service-catalog.md` or `services/<service-key>.md` |
72
+ | Local mocks, stubs, startup, debugging, cross-repo development behavior | `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
  | Unconfirmed, conflicting, stale, or background-only material | Keep in source pack README / digest; do not project into execution docs |
75
75
 
76
76
  ## Prohibited
77
77
 
78
- - Do not copy large external document sets directly into `03-ARCHITECTURE`, `04-DEVELOPMENT`, or `06-INTEGRATIONS`.
78
+ - Do not copy large external document sets directly into `context/architecture`, `context/development`, or `context/integrations`.
79
79
  - Do not treat an external-source digest as verified fact without `Source Evidence`, `Last Verified`, and `Confidence`.
80
80
  - Do not keep long raw excerpts, chat logs, or meeting transcripts inside execution docs.
81
81
  - Do not commit secrets, production tokens, customer data, personal information, or non-public raw material.
@@ -12,7 +12,7 @@ Define repository-level rules for branches, commits, pull requests, ownership, g
12
12
  4. Generated files, caches, build output, local runtime state, and secrets must be ignored or stored in the approved location.
13
13
  5. Commit verified, meaningful slices proactively. Deferred commits require an explicit no-commit reason, owner, and next step.
14
14
  6. Do not mix unrelated dirty changes into a task commit. CLI-owned Harness writes should use the local Harness commands so their locked, allowlisted auto-commit can protect shared governance files.
15
- 7. Pull requests must follow `docs/11-REFERENCE/pull-request-standard.md` and describe intent, changed surfaces, version impact, checks run, checks not run, review status, references, and residual risk.
15
+ 7. Pull requests must follow `coding-agent-harness/governance/standards/pull-request-standard.md` and describe intent, changed surfaces, version impact, checks run, checks not run, review status, references, and residual risk.
16
16
  8. Required checks and material review findings block merge unless an approved exception is recorded.
17
17
  9. Merge or release ownership must be explicit when several branches or workers contribute to the same outcome.
18
18
 
@@ -20,7 +20,7 @@ Track module ownership, write scope, branch or worktree assignment, and coordina
20
20
 
21
21
  | ID | Module | Path Scope | Owner | Status | Branch or Worktree | Task Plan | Shared Files | Depends On | Handoff Evidence | Residual | Updated |
22
22
  | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
23
- | M-000 | Module title | src/module/** or docs/area/** | owner | reserved | branch or worktree path | docs/09-PLANNING/TASKS/.../task_plan.md | none | none | pending | none | YYYY-MM-DD |
23
+ | M-000 | Module title | src/module/** or docs/area/** | owner | reserved | branch or worktree path | coding-agent-harness/planning/modules/<module>/tasks/.../task_plan.md | none | none | pending | none | YYYY-MM-DD |
24
24
 
25
25
  ## Shared-File Register
26
26
 
@@ -56,8 +56,8 @@ One sentence describing what changed and why it matters.
56
56
 
57
57
  | Artifact | Link |
58
58
  | --- | --- |
59
- | Task plan | docs/09-PLANNING/TASKS/.../task_plan.md |
59
+ | Task plan | coding-agent-harness/planning/tasks/.../task_plan.md |
60
60
  | Feature or Delivery SSoT | F-000 or D-000 |
61
61
  | Harness Ledger | HL-YYYY-MM-DD-001 |
62
- | Closeout SSoT | CO-YYYY-MM-DD-001 |
62
+ | Task-local closeout | walkthrough.md |
63
63
  | Pull request or commit | link or hash |
@@ -1,7 +1,7 @@
1
1
  # [项目名称]
2
2
 
3
3
  这个文件是 Agent 进入本仓库时的工作入口。它只负责说明硬规则和阅读路由;
4
- 详细规范放在 `docs/11-REFERENCE/`,不要把操作手册全部塞进这里。
4
+ 详细规范放在 `coding-agent-harness/governance/standards/`,不要把操作手册全部塞进这里。
5
5
 
6
6
  ## 项目概况
7
7
 
@@ -13,9 +13,9 @@
13
13
 
14
14
  ## 不可违反的规则
15
15
 
16
- 1. 遵守 `docs/11-REFERENCE/engineering-standard.md` 中的架构边界。
16
+ 1. 遵守 `coding-agent-harness/governance/standards/engineering-standard.md` 中的架构边界。
17
17
  2. 不提交密钥、令牌、私有接口、用户隐私数据或生产凭据。
18
- 3. 非平凡任务先用 Harness CLI 在 `docs/09-PLANNING/TASKS/` 下建立任务目录。
18
+ 3. 非平凡任务先用 Harness CLI 在 `coding-agent-harness/planning/tasks/` 下建立任务目录。
19
19
  4. 声称完成前必须记录证据。
20
20
  5. 保护无关工作区改动,不回滚任务范围外文件。
21
21
  6. 已验证的、有意义的工作切片要主动提交。除非用户明确暂停提交、检查失败、dirty 归属不清,或安全边界导致无法形成干净提交,否则不要把已完成工作只留在未提交文件里;不能提交时,必须在 progress、handoff 或 closeout 中写明 no-commit reason、owner 和下一步。不要把无关 dirty 改动混入本任务提交。
@@ -27,23 +27,23 @@
27
27
 
28
28
  | 任务类型 | 先读文件 |
29
29
  | --- | --- |
30
- | 架构、核心模块、跨模块改动 | `docs/11-REFERENCE/engineering-standard.md` |
31
- | 系统地图、服务职责、外部系统关系 | `docs/03-ARCHITECTURE/README.md`、`docs/03-ARCHITECTURE/service-catalog.md` |
32
- | 本地开发、mock、stub、跨仓调试 | `docs/04-DEVELOPMENT/README.md`、`docs/04-DEVELOPMENT/codebase-map.md` |
33
- | API、event、webhook、SDK、第三方契约 | `docs/06-INTEGRATIONS/README.md` 和相关契约文件 |
34
- | 测试、冒烟、回归 | `docs/11-REFERENCE/testing-standard.md`、`docs/05-TEST-QA/Regression-SSoT.md` |
35
- | 开发执行、提交、PR、发布 | `docs/11-REFERENCE/execution-workflow-standard.md`、`docs/11-REFERENCE/repo-governance-standard.md`、`docs/11-REFERENCE/pull-request-standard.md`、`docs/11-REFERENCE/ci-cd-standard.md` |
36
- | 创建或推进任务 | `docs/09-PLANNING/TASKS/` 下的当前任务目录;如果本项目已配置 Harness CLI,使用 `harness new-task` / lifecycle 命令 |
30
+ | 架构、核心模块、跨模块改动 | `coding-agent-harness/governance/standards/engineering-standard.md` |
31
+ | 系统地图、服务职责、外部系统关系 | `coding-agent-harness/context/architecture/README.md`、`coding-agent-harness/context/architecture/service-catalog.md` |
32
+ | 本地开发、mock、stub、跨仓调试 | `coding-agent-harness/context/development/README.md`、`coding-agent-harness/context/development/codebase-map.md` |
33
+ | API、event、webhook、SDK、第三方契约 | `coding-agent-harness/context/integrations/README.md` 和相关契约文件 |
34
+ | 测试、冒烟、回归 | `coding-agent-harness/governance/standards/testing-standard.md`、`coding-agent-harness/governance/regression/Regression-SSoT.md` |
35
+ | 开发执行、提交、PR、发布 | `coding-agent-harness/governance/standards/execution-workflow-standard.md`、`coding-agent-harness/governance/standards/repo-governance-standard.md`、`coding-agent-harness/governance/standards/pull-request-standard.md`、`coding-agent-harness/governance/standards/ci-cd-standard.md` |
36
+ | 创建或推进任务 | `coding-agent-harness/planning/tasks/` 下的当前任务目录;如果本项目已配置 Harness CLI,使用 `harness new-task` / lifecycle 命令 |
37
37
  | Brief、Execution Strategy、Visual Map | 当前任务的 `brief.md`、`execution_strategy.md`、`visual_map.md` |
38
- | 长程任务 | `docs/11-REFERENCE/long-running-task-standard.md` |
39
- | reviewer、subagent、对抗性审查 | `docs/11-REFERENCE/review-routing-standard.md`、`docs/11-REFERENCE/adversarial-review-standard.md` |
40
- | 多人协作、多仓交付、阶段性交付 | `docs/11-REFERENCE/delivery-operating-model-standard.md`、`docs/09-PLANNING/Delivery-SSoT.md` |
41
- | 模块并行 | `docs/09-PLANNING/Module-Registry.md` 和相关 module plan |
42
- | 文档治理或 Harness 更新 | `docs/11-REFERENCE/docs-library-standard.md`、`.harness-capabilities.json` |
43
- | 外部资料摄取 | `docs/11-REFERENCE/external-source-intake-standard.md` |
44
- | Regression SSoT 维护 | `docs/11-REFERENCE/regression-ssot-governance.md` |
45
- | 收口、walkthrough、Lessons | `docs/11-REFERENCE/walkthrough-standard.md`、`docs/10-WALKTHROUGH/Closeout-SSoT.md`、当前任务 `lesson_candidates.md`、`docs/01-GOVERNANCE/lessons/` |
46
- | Worktree、并行开发隔离 | `docs/11-REFERENCE/worktree-standard.md` |
38
+ | 长程任务 | 当前任务的 `long-running-task-contract.md`(如存在) |
39
+ | reviewer、subagent、对抗性审查 | 当前任务 `review.md`、`coding-agent-harness/governance/standards/review-routing-standard.md` |
40
+ | 多人协作、多仓交付、阶段性交付 | `coding-agent-harness/governance/standards/delivery-operating-model-standard.md`、`coding-agent-harness/planning/Delivery-SSoT.md` |
41
+ | 模块并行 | `coding-agent-harness/planning/modules/Module-Registry.md` 和相关 module plan |
42
+ | 文档治理或 Harness 更新 | `coding-agent-harness/governance/standards/docs-library-standard.md`、`coding-agent-harness/harness.yaml` |
43
+ | 外部资料摄取 | `coding-agent-harness/governance/standards/external-source-intake-standard.md` |
44
+ | Regression SSoT 维护 | `coding-agent-harness/governance/standards/regression-ssot-governance.md` |
45
+ | 收口、walkthrough、Lessons | `coding-agent-harness/governance/standards/walkthrough-standard.md`、当前任务 `walkthrough.md`、当前任务 `lesson_candidates.md`、`coding-agent-harness/governance/lessons/` |
46
+ | Worktree、并行开发隔离 | `coding-agent-harness/governance/standards/worktree-standard.md` |
47
47
 
48
48
  ## 标准执行流程
49
49
 
@@ -72,14 +72,14 @@
72
72
 
73
73
  ## 单一事实源
74
74
 
75
- - Harness Ledger:`docs/Harness-Ledger.md`(任务生命周期总账,由 CLI 生成)
76
- - Delivery SSoT:`docs/09-PLANNING/Delivery-SSoT.md`
77
- - Module Registry:`docs/09-PLANNING/Module-Registry.md`
78
- - Regression SSoT:`docs/05-TEST-QA/Regression-SSoT.md`
79
- - Cadence Ledger:`docs/05-TEST-QA/Cadence-Ledger.md`
75
+ - Harness Ledger:`coding-agent-harness/governance/generated/Harness-Ledger.md`(任务生命周期总账,由 CLI 生成)
76
+ - Delivery SSoT:`coding-agent-harness/planning/Delivery-SSoT.md`
77
+ - Module Registry:`coding-agent-harness/planning/modules/Module-Registry.md`
78
+ - Regression SSoT:`coding-agent-harness/governance/regression/Regression-SSoT.md`
79
+ - Cadence Ledger:`coding-agent-harness/governance/regression/Cadence-Ledger.md`
80
80
  - Lesson Candidates:当前任务 `lesson_candidates.md`
81
- - Lesson Detail Docs:`docs/01-GOVERNANCE/lessons/`
82
- - Closeout SSoT:`docs/10-WALKTHROUGH/Closeout-SSoT.md`
81
+ - Lesson Detail Docs:`coding-agent-harness/governance/lessons/`
82
+ - Generated Closeout Index:`coding-agent-harness/governance/generated/Closeout-Index.md`
83
83
 
84
84
  ## 本地命令
85
85
 
@@ -6,7 +6,7 @@ Claude Code 开始任何任务前应当:
6
6
 
7
7
  1. 先读取 `AGENTS.md`。
8
8
  2. 按 `AGENTS.md` 的任务阅读矩阵选择当前任务需要的文件。
9
- 3. 只加载必要的 `docs/11-REFERENCE/` 标准文件和任务目录上下文。
9
+ 3. 只加载必要的 `coding-agent-harness/governance/standards/` 标准文件和任务目录上下文。
10
10
  4. 把本文件视为 Claude Code 兼容入口,而不是第二份项目规范。
11
11
 
12
12
  不要在这里复制项目规则。长期有效的项目指令应维护在 `AGENTS.md` 及其引用文档中,避免两套规则逐渐漂移。
@@ -24,8 +24,8 @@ Keep the English field names and file names because CLI checks rely on them.
24
24
  ## Boundary
25
25
 
26
26
  - 系统结构、服务责任、归属关系、关键流程放这里。
27
- - Payload、endpoint 参数、event schema、SDK 细节放 `docs/06-INTEGRATIONS/`。
28
- - 本地启动、mock、stub、跨仓调试经验放 `docs/04-DEVELOPMENT/`。
27
+ - Payload、endpoint 参数、event schema、SDK 细节放 `coding-agent-harness/context/integrations/`。
28
+ - 本地启动、mock、stub、跨仓调试经验放 `coding-agent-harness/context/development/`。
29
29
 
30
30
  ## Structure Contract
31
31
 
@@ -46,6 +46,6 @@ Keep the English field names and file names because CLI checks rely on them.
46
46
 
47
47
  1. 这个服务负责什么、拥有什么数据。
48
48
  2. 它和本仓有什么关系。
49
- 3. Agent 修改本仓前还需要读哪些 `04-DEVELOPMENT` 和 `06-INTEGRATIONS` 文档。
49
+ 3. Agent 修改本仓前还需要读哪些 `context/development` 和 `context/integrations` 文档。
50
50
 
51
- 不要在 `03-ARCHITECTURE` 里堆接口字段、mock 指令或临时调试记录。那些内容分别放到 `06-INTEGRATIONS` 和 `04-DEVELOPMENT`。
51
+ 不要在 `context/architecture` 里堆接口字段、mock 指令或临时调试记录。那些内容分别放到 `context/integrations` 和 `context/development`。
@@ -12,6 +12,6 @@ Confidence: low
12
12
 
13
13
  ## Boundary Rule
14
14
 
15
- 这个目录只放服务责任、接口摘要和跳转链接。Payload、auth、error code、event schema 放 `docs/06-INTEGRATIONS/`。
15
+ 这个目录只放服务责任、接口摘要和跳转链接。Payload、auth、error code、event schema 放 `coding-agent-harness/context/integrations/`。
16
16
 
17
- 一个服务或微服务只占一行。只要该服务影响本仓开发或判断,就补 `services/<service-key>.md`、`docs/04-DEVELOPMENT/external-context/<service-key>.md` 和相关 `docs/06-INTEGRATIONS/<contract>.md` 链接。
17
+ 一个服务或微服务只占一行。只要该服务影响本仓开发或判断,就补 `services/<service-key>.md`、`coding-agent-harness/context/development/external-context/<service-key>.md` 和相关 `coding-agent-harness/context/integrations/<contract>.md` 链接。
@@ -9,7 +9,7 @@ Confidence: low
9
9
 
10
10
  | Catalog Row | Development Context | Source Pack | Integration Contracts | Last Verified | Confidence |
11
11
  | --- | --- | --- | --- | --- | --- |
12
- | `docs/03-ARCHITECTURE/service-catalog.md` | `docs/04-DEVELOPMENT/external-context/<service-key>.md` | `docs/04-DEVELOPMENT/external-source-packs/<source-key>/README.md` 或 N/A | `docs/06-INTEGRATIONS/<contract>.md` | unknown | low |
12
+ | `coding-agent-harness/context/architecture/service-catalog.md` | `coding-agent-harness/context/development/external-context/<service-key>.md` | `coding-agent-harness/context/development/external-source-packs/<source-key>/README.md` 或 N/A | `coding-agent-harness/context/integrations/<contract>.md` | unknown | low |
13
13
 
14
14
  ## Responsibility
15
15
 
@@ -14,8 +14,8 @@ Keep the English field names and section headings because CLI checks rely on the
14
14
  ## Boundary
15
15
 
16
16
  - 本地启动、代码地图、外部服务开发摘要、mock、stub、跨仓调试放这里。
17
- - 长期系统结构放 `docs/03-ARCHITECTURE/`。
18
- - API、event、webhook 等具体契约放 `docs/06-INTEGRATIONS/`。
17
+ - 长期系统结构放 `coding-agent-harness/context/architecture/`。
18
+ - API、event、webhook 等具体契约放 `coding-agent-harness/context/integrations/`。
19
19
 
20
20
  ## Structure Contract
21
21
 
@@ -32,21 +32,21 @@ Keep the English field names and section headings because CLI checks rely on the
32
32
 
33
33
  如果本仓依赖多个微服务,不要把所有外部知识写进一个大文档。只要某个外部服务会影响本仓开发或测试,就创建:
34
34
 
35
- - `docs/03-ARCHITECTURE/services/<service-key>.md`:该服务是什么、负责什么。
36
- - `docs/04-DEVELOPMENT/external-context/<service-key>.md`:本仓开发时如何 mock、stub、调试它。
37
- - `docs/06-INTEGRATIONS/<contract>.md`:具体 API/event/webhook 契约。
35
+ - `coding-agent-harness/context/architecture/services/<service-key>.md`:该服务是什么、负责什么。
36
+ - `coding-agent-harness/context/development/external-context/<service-key>.md`:本仓开发时如何 mock、stub、调试它。
37
+ - `coding-agent-harness/context/integrations/<contract>.md`:具体 API/event/webhook 契约。
38
38
 
39
- `04-DEVELOPMENT` 只放“开发时怎么处理这个外部服务”。不要在这里维护完整系统拓扑,也不要把 payload schema 塞进来。
39
+ `context/development` 只放“开发时怎么处理这个外部服务”。不要在这里维护完整系统拓扑,也不要把 payload schema 塞进来。
40
40
 
41
41
  ## External Source Pack Rule
42
42
 
43
- 如果外部团队给了多份文档、截图、导出包、会议纪要或链接,不要直接塞进 `03/04/06`。先读 `docs/11-REFERENCE/external-source-intake-standard.md`,再决定是否创建 `external-source-packs/<source-key>/`。
43
+ 如果外部团队给了多份文档、截图、导出包、会议纪要或链接,不要直接塞进 `context/{architecture,development,integrations}`。先读 `coding-agent-harness/governance/standards/external-source-intake-standard.md`,再决定是否创建 `external-source-packs/<source-key>/`。
44
44
 
45
45
  `external-source-packs/` 只负责资料索引、摘要和投影状态。稳定结论必须回写到:
46
46
 
47
- - `docs/03-ARCHITECTURE/services/<service-key>.md`
48
- - `docs/04-DEVELOPMENT/external-context/<service-key>.md`
49
- - `docs/06-INTEGRATIONS/<contract>.md`
47
+ - `coding-agent-harness/context/architecture/services/<service-key>.md`
48
+ - `coding-agent-harness/context/development/external-context/<service-key>.md`
49
+ - `coding-agent-harness/context/integrations/<contract>.md`
50
50
 
51
51
  ## External Context Index
52
52
 
@@ -8,9 +8,9 @@ Confidence: low
8
8
  ## Debug Flow
9
9
 
10
10
  1. 先定位失败的 interface 或 flow。
11
- 2. 读 `docs/03-ARCHITECTURE/service-catalog.md`,确认归属和上下游服务。
12
- 3. 读对应的 `docs/06-INTEGRATIONS/` 契约。
13
- 4. 读 `docs/04-DEVELOPMENT/external-context/<service-key>.md`,使用其中的 mock、stub 和本地调试说明。
11
+ 2. 读 `coding-agent-harness/context/architecture/service-catalog.md`,确认归属和上下游服务。
12
+ 3. 读对应的 `coding-agent-harness/context/integrations/` 契约。
13
+ 4. 读 `coding-agent-harness/context/development/external-context/<service-key>.md`,使用其中的 mock、stub 和本地调试说明。
14
14
 
15
15
  ## Known Failure Modes
16
16
 
@@ -9,7 +9,7 @@ Confidence: low
9
9
 
10
10
  | Service Profile | Source Pack | Integration Contracts | Last Verified | Confidence |
11
11
  | --- | --- | --- | --- | --- |
12
- | `docs/03-ARCHITECTURE/services/<service-key>.md` | `docs/04-DEVELOPMENT/external-source-packs/<source-key>/README.md` 或 N/A | `docs/06-INTEGRATIONS/<contract>.md` | unknown | low |
12
+ | `coding-agent-harness/context/architecture/services/<service-key>.md` | `coding-agent-harness/context/development/external-source-packs/<source-key>/README.md` 或 N/A | `coding-agent-harness/context/integrations/<contract>.md` | unknown | low |
13
13
 
14
14
  ## Development Use
15
15
 
@@ -30,4 +30,4 @@ Confidence: low
30
30
 
31
31
  ## Placement Rule
32
32
 
33
- 本文件只写本仓开发、测试、调试这个外部服务时需要的上下文。服务职责放 `03-ARCHITECTURE`,接口字段和 schema 放 `06-INTEGRATIONS`。
33
+ 本文件只写本仓开发、测试、调试这个外部服务时需要的上下文。服务职责放 `context/architecture`,接口字段和 schema 放 `context/integrations`。
@@ -7,18 +7,18 @@ Confidence: low
7
7
 
8
8
  ## Purpose
9
9
 
10
- 这个目录只承载外部资料的摄取、索引和摘要。稳定事实必须投影到 `03-ARCHITECTURE`、`04-DEVELOPMENT/external-context` 或 `06-INTEGRATIONS` 后才算进入 Harness 执行上下文。
10
+ 这个目录只承载外部资料的摄取、索引和摘要。稳定事实必须投影到 `context/architecture`、`coding-agent-harness/context/development/external-context` 或 `context/integrations` 后才算进入 Harness 执行上下文。
11
11
 
12
- 先读 `docs/11-REFERENCE/external-source-intake-standard.md`,再新增资料包。
12
+ 先读 `coding-agent-harness/governance/standards/external-source-intake-standard.md`,再新增资料包。
13
13
 
14
14
  ## Source Packs
15
15
 
16
- | Source Key | External Project / Service | Raw Storage Mode | Source Count | Digest Status | Projected To 03/04/06 | Owner | Last Verified | Confidence |
16
+ | Source Key | External Project / Service | Raw Storage Mode | Source Count | Digest Status | Projected To context/{architecture,development,integrations} | Owner | Last Verified | Confidence |
17
17
  | --- | --- | --- | --- | --- | --- | --- | --- | --- |
18
18
 
19
19
  ## Placement Rule
20
20
 
21
- - 资料量小于 5 份时,优先在 `03/04/06` 的 `Source Evidence` 中引用,不必建资料包。
21
+ - 资料量小于 5 份时,优先在 `context/{architecture,development,integrations}` 的 `Source Evidence` 中引用,不必建资料包。
22
22
  - 资料很多、跨多个主题或会持续增长时,创建 `<source-key>/README.md` 和 `digests/`。
23
23
  - `raw/` 只能放允许入仓、无密钥、无隐私、无客户数据的原始材料。
24
24
  - 不能入仓的资料只记录外部路径、owner、访问条件和 digest。
@@ -13,8 +13,8 @@ Keep the English field names and section headings because CLI checks rely on the
13
13
 
14
14
  ## Boundary
15
15
 
16
- - 服务拓扑和职责归属放 `docs/03-ARCHITECTURE/`。
17
- - 开发 mock 和调试说明放 `docs/04-DEVELOPMENT/`。
16
+ - 服务拓扑和职责归属放 `coding-agent-harness/context/architecture/`。
17
+ - 开发 mock 和调试说明放 `coding-agent-harness/context/development/`。
18
18
  - endpoint、payload、error、auth、event、webhook、SDK 契约放这里。
19
19
 
20
20
  ## Structure Contract
@@ -30,8 +30,8 @@ Keep the English field names and section headings because CLI checks rely on the
30
30
 
31
31
  每个接口契约必须是独立文件,并链接回对应服务:
32
32
 
33
- - 服务职责和上下游关系:`docs/03-ARCHITECTURE/service-catalog.md` 或 `services/<service-key>.md`
34
- - 本地 mock / stub / debug:`docs/04-DEVELOPMENT/external-context/<service-key>.md`
33
+ - 服务职责和上下游关系:`coding-agent-harness/context/architecture/service-catalog.md` 或 `services/<service-key>.md`
34
+ - 本地 mock / stub / debug:`coding-agent-harness/context/development/external-context/<service-key>.md`
35
35
  - 具体 payload、auth、error、contract test:本文件夹
36
36
 
37
37
  不要在一个“接口说明”大文档里混写多个服务。多个微服务就维护多个契约文件;README 里的 Contract Index 负责让人和 Agent 快速定位。
@@ -13,7 +13,7 @@ API
13
13
 
14
14
  | Service Profile | Development Context | Contract Index | Last Verified | Confidence |
15
15
  | --- | --- | --- | --- | --- |
16
- | `docs/03-ARCHITECTURE/services/<service-key>.md` | `docs/04-DEVELOPMENT/external-context/<service-key>.md` | `docs/06-INTEGRATIONS/README.md` | unknown | low |
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
 
@@ -39,4 +39,4 @@ API
39
39
 
40
40
  ## Placement Rule
41
41
 
42
- 本文件只写一个 API 契约。服务职责放 `03-ARCHITECTURE`,本地 mock/stub/debug 放 `04-DEVELOPMENT`。
42
+ 本文件只写一个 API 契约。服务职责放 `context/architecture`,本地 mock/stub/debug 放 `context/development`。
@@ -13,7 +13,7 @@ Event
13
13
 
14
14
  | Service Profile | Development Context | Contract Index | Last Verified | Confidence |
15
15
  | --- | --- | --- | --- | --- |
16
- | `docs/03-ARCHITECTURE/services/<service-key>.md` | `docs/04-DEVELOPMENT/external-context/<service-key>.md` | `docs/06-INTEGRATIONS/README.md` | unknown | low |
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
  ## Topic / Channel
19
19
 
@@ -43,4 +43,4 @@ Event
43
43
 
44
44
  ## Placement Rule
45
45
 
46
- 本文件只写一个 event 契约。服务职责放 `03-ARCHITECTURE`,本地 mock/stub/debug 放 `04-DEVELOPMENT`。
46
+ 本文件只写一个 event 契约。服务职责放 `context/architecture`,本地 mock/stub/debug 放 `context/development`。
@@ -13,7 +13,7 @@ Third-party service
13
13
 
14
14
  | Service Profile | Development Context | Contract Index | Last Verified | Confidence |
15
15
  | --- | --- | --- | --- | --- |
16
- | `docs/03-ARCHITECTURE/services/<vendor-key>.md` | `docs/04-DEVELOPMENT/external-context/<vendor-key>.md` | `docs/06-INTEGRATIONS/README.md` | unknown | low |
16
+ | `coding-agent-harness/context/architecture/services/<vendor-key>.md` | `coding-agent-harness/context/development/external-context/<vendor-key>.md` | `coding-agent-harness/context/integrations/README.md` | unknown | low |
17
17
 
18
18
  ## Auth
19
19
 
@@ -39,4 +39,4 @@ Third-party service
39
39
 
40
40
  ## Placement Rule
41
41
 
42
- 本文件只写一个第三方集成。账号/权限/SDK/限制放这里;业务职责和系统拓扑放 `03-ARCHITECTURE`。
42
+ 本文件只写一个第三方集成。账号/权限/SDK/限制放这里;业务职责和系统拓扑放 `context/architecture`。