specdojo 0.6.0 → 0.8.0

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 (366) hide show
  1. package/.github/agents/specdojo-orchestrator.md +3 -2
  2. package/CHANGELOG.md +193 -0
  3. package/README.md +2 -2
  4. package/dist/catalog/build.js +24 -1
  5. package/dist/catalog/plan.js +1 -1
  6. package/dist/catalog/scaffold.js +4 -1
  7. package/dist/commands/agent.js +33 -0
  8. package/dist/commands/init.js +6 -1
  9. package/dist/commands/night-orchestrator.js +6 -4
  10. package/dist/commands/orchestrator.js +10 -1
  11. package/dist/dashboard/dashboard-timeline.js +18 -16
  12. package/dist/dashboard/dashboard.js +612 -259
  13. package/dist/dashboard/epic-plan.js +81 -0
  14. package/dist/dashboard/exec-records.js +16 -20
  15. package/dist/dashboard/routines.js +8 -6
  16. package/dist/dashboard/timeline-build.js +5 -9
  17. package/dist/dashboard/timeline.js +9 -4
  18. package/dist/devcontainer/command.js +18 -0
  19. package/dist/devcontainer/host-script.js +21 -0
  20. package/dist/devcontainer/scaffold.js +22 -3
  21. package/dist/docs/frontmatter-namespace.js +1 -48
  22. package/dist/docs/yaml-pages.js +125 -3
  23. package/dist/exec/agent-config.js +22 -0
  24. package/dist/exec/agent-plan.js +3 -2
  25. package/dist/exec/antigravity-session.js +154 -0
  26. package/dist/exec/commands.js +69 -21
  27. package/dist/exec/commit-hook-skips.js +78 -0
  28. package/dist/exec/core.js +19 -7
  29. package/dist/exec/events.js +159 -8
  30. package/dist/exec/evidence.js +64 -16
  31. package/dist/exec/handoff.js +9 -13
  32. package/dist/exec/limit.js +1 -1
  33. package/dist/exec/mechanical-result.js +45 -0
  34. package/dist/exec/migrate-records.js +249 -0
  35. package/dist/exec/parent-validation.js +160 -12
  36. package/dist/exec/pipeline-state.js +27 -5
  37. package/dist/exec/plan-markdownlint.js +89 -0
  38. package/dist/exec/plans-condense-findings.js +89 -0
  39. package/dist/exec/plans-core.js +24 -17
  40. package/dist/exec/plans-generation.js +52 -25
  41. package/dist/exec/plans-grade-findings.js +8 -3
  42. package/dist/exec/plans-kata-findings.js +61 -0
  43. package/dist/exec/plans-planning.js +3 -3
  44. package/dist/exec/plans-storage.js +12 -24
  45. package/dist/exec/register-resume.js +69 -42
  46. package/dist/exec/register.js +26 -22
  47. package/dist/exec/repo-integration-sync.js +8 -4
  48. package/dist/exec/repo-integration.js +21 -1
  49. package/dist/exec/reporter.js +121 -23
  50. package/dist/exec/results.js +85 -24
  51. package/dist/exec/review-completion.js +47 -0
  52. package/dist/exec/review-kata.js +109 -0
  53. package/dist/exec/run/agent-pipeline.js +75 -6
  54. package/dist/exec/run/agent.js +20 -7
  55. package/dist/exec/run/in-place.js +69 -32
  56. package/dist/exec/run/job.js +81 -24
  57. package/dist/exec/run/lifecycle-commands.js +264 -43
  58. package/dist/exec/run/mode-shared.js +11 -3
  59. package/dist/exec/run/register-command.js +12 -10
  60. package/dist/exec/run/register-core.js +20 -13
  61. package/dist/exec/run/register-mode.js +12 -12
  62. package/dist/exec/run/register-post-review.js +21 -9
  63. package/dist/exec/run/register-resume.js +28 -18
  64. package/dist/exec/run/register-state.js +10 -7
  65. package/dist/exec/run/register-worktree.js +60 -30
  66. package/dist/exec/run/schedule-mode.js +26 -6
  67. package/dist/exec/run/schedule-prepare.js +228 -45
  68. package/dist/exec/run/schedule-task.js +132 -25
  69. package/dist/exec/run/shared.js +4 -3
  70. package/dist/exec/run/trailing-records.js +35 -0
  71. package/dist/exec/run-records.js +2 -0
  72. package/dist/exec/strategy.js +1 -0
  73. package/dist/exec/trailing-records.js +242 -0
  74. package/dist/exec/trial-commands.js +3 -2
  75. package/dist/exec/validate-records-commit.js +110 -0
  76. package/dist/exec/validate-records.js +148 -0
  77. package/dist/exec/worktree-command.js +29 -16
  78. package/dist/exec/worktree-ops-commit.js +118 -59
  79. package/dist/exec/worktree-ops-lifecycle.js +77 -44
  80. package/dist/exec/worktree-ops-merge.js +13 -2
  81. package/dist/exec/worktree-ops.js +2 -2
  82. package/dist/exec/worktree.js +19 -2
  83. package/dist/grade/apply.js +32 -6
  84. package/dist/grade/command-inspect.js +2 -2
  85. package/dist/grade/command-run.js +2 -0
  86. package/dist/grade/command-shared.js +1 -1
  87. package/dist/grade/core.js +18 -5
  88. package/dist/grade/markdown.js +3 -3
  89. package/dist/grade/pipeline-state.js +15 -11
  90. package/dist/grade/plan.js +37 -17
  91. package/dist/grade/result.js +3 -3
  92. package/dist/grade/run.js +23 -3
  93. package/dist/grade/target-discovery.js +17 -4
  94. package/dist/grade/targets.js +12 -11
  95. package/dist/job/job.js +31 -17
  96. package/dist/job/noop.js +104 -0
  97. package/dist/register/core.js +2 -0
  98. package/dist/register/create-commands.js +28 -3
  99. package/dist/register/deliverable-target.js +9 -1
  100. package/dist/register/epic.js +104 -26
  101. package/dist/register/event-merge.js +3 -0
  102. package/dist/register/events.js +4 -0
  103. package/dist/register/external-project.js +3 -0
  104. package/dist/register/item.js +6 -0
  105. package/dist/register/maintenance-commands.js +4 -1
  106. package/dist/register/planning.js +7 -14
  107. package/dist/register/register.js +74 -32
  108. package/dist/register/track-domains.js +34 -0
  109. package/dist/register/track-plan.js +78 -0
  110. package/dist/register/transition-commands.js +8 -0
  111. package/dist/register/work-table.js +64 -0
  112. package/dist/review/grade.js +35 -13
  113. package/dist/routine/definition.js +4 -3
  114. package/dist/routine/failure.js +30 -0
  115. package/dist/routine/routine.js +56 -32
  116. package/dist/routine/storage.js +33 -0
  117. package/dist/schedule/schedule.js +1 -0
  118. package/dist/schedule/strategy-generate-document.js +26 -14
  119. package/dist/schedule/strategy-generate-scope.js +17 -45
  120. package/dist/schedule/strategy-generate.js +33 -3
  121. package/dist/schedule/strategy-profiles.js +86 -12
  122. package/dist/shared/agent-types.js +2 -0
  123. package/dist/shared/condense-records.js +25 -0
  124. package/dist/shared/deprecation.js +8 -0
  125. package/dist/shared/document-metadata.js +20 -0
  126. package/dist/shared/finding-cause.js +20 -0
  127. package/dist/shared/frontmatter-namespace.js +48 -0
  128. package/dist/shared/git.js +149 -15
  129. package/dist/shared/grade-result.js +17 -1
  130. package/dist/shared/local-state.js +20 -0
  131. package/dist/shared/markdownlint-config.js +8 -3
  132. package/dist/shared/plan-conventions.js +129 -0
  133. package/dist/shared/plan-templates.js +57 -41
  134. package/dist/shared/provider-scaffold.js +2 -0
  135. package/dist/shared/run-records.js +224 -0
  136. package/dist/shared/specdojo-config.js +39 -21
  137. package/dist/shared/specdojo-gitignore.js +1 -0
  138. package/dist/shared/text.js +65 -5
  139. package/dist/shared/timeline-index.js +2 -0
  140. package/docs/ja/specdojo/defaults/pm-review-viewpoints.yaml +11 -2
  141. package/docs/ja/specdojo/exec-templates/xep-common-conventions-template.md +4 -74
  142. package/docs/ja/specdojo/exec-templates/xep-condense-template.md +50 -0
  143. package/docs/ja/specdojo/exec-templates/xep-draft-template.md +17 -5
  144. package/docs/ja/specdojo/exec-templates/xep-fully-guided-template.md +16 -3
  145. package/docs/ja/specdojo/exec-templates/xep-recipe-guided-template.md +15 -5
  146. package/docs/ja/specdojo/exec-templates/xep-recipe-maintenance-template.md +6 -0
  147. package/docs/ja/specdojo/exec-templates/xep-register-template.md +1 -1
  148. package/docs/ja/specdojo/exec-templates/xep-rulebook-maintenance-template.md +6 -0
  149. package/docs/ja/specdojo/exec-templates/xep-sample-maintenance-template.md +6 -0
  150. package/docs/ja/specdojo/exec-templates/xep-template-maintenance-template.md +6 -0
  151. package/docs/ja/specdojo/exec-templates/xer-condense-template.md +25 -0
  152. package/docs/ja/specdojo/exec-templates/xp-common-conventions-template.md +50 -0
  153. package/docs/ja/specdojo/exec-templates/xrp-common-conventions-template.md +30 -0
  154. package/docs/ja/specdojo/guides/branch-workflow-guide.md +1 -1
  155. package/docs/ja/specdojo/guides/docs-editing-guide.md +48 -0
  156. package/docs/ja/specdojo/guides/docs-structure-guide.md +48 -15
  157. package/docs/ja/specdojo/guides/exec-config-guide.md +61 -28
  158. package/docs/ja/specdojo/guides/exec-operation-guide.md +61 -13
  159. package/docs/ja/specdojo/guides/exec-worktree-guide.md +20 -11
  160. package/docs/ja/specdojo/guides/orchestrator-operation-guide.md +4 -2
  161. package/docs/ja/specdojo/guides/plan-result-lifecycle-guide.md +92 -55
  162. package/docs/ja/specdojo/guides/project-move-guide.md +381 -0
  163. package/docs/ja/specdojo/guides/quick-start-guide.md +589 -807
  164. package/docs/ja/specdojo/guides/register-operation-guide.md +26 -4
  165. package/docs/ja/specdojo/guides/remote-host-development-guide.md +33 -4
  166. package/docs/ja/specdojo/guides/review-guide.md +22 -19
  167. package/docs/ja/specdojo/guides/routine-operation-guide.md +14 -8
  168. package/docs/ja/specdojo/guides/ryu-guide.md +23 -13
  169. package/docs/ja/specdojo/guides/schedule-design-guide.md +7 -4
  170. package/docs/ja/specdojo/guides/schedule-operation-guide.md +41 -3
  171. package/docs/ja/specdojo/guides/specdojo-overview-guide.md +5 -4
  172. package/docs/ja/specdojo/guides/timeline-design-guide.md +27 -144
  173. package/docs/ja/specdojo/guides/use-case-guide.md +471 -74
  174. package/docs/ja/specdojo/recipes/bac-recipe.md +94 -0
  175. package/docs/ja/specdojo/recipes/bes-recipe.md +105 -0
  176. package/docs/ja/specdojo/recipes/br-recipe.md +84 -0
  177. package/docs/ja/specdojo/recipes/cdfd-overview-recipe.md +88 -86
  178. package/docs/ja/specdojo/recipes/cdfd-uc-recipe.md +108 -122
  179. package/docs/ja/specdojo/recipes/cnd-recipe.md +125 -0
  180. package/docs/ja/specdojo/recipes/cpd-recipe.md +126 -0
  181. package/docs/ja/specdojo/recipes/cxd-recipe.md +145 -0
  182. package/docs/ja/specdojo/recipes/ifd-recipe.md +134 -0
  183. package/docs/ja/specdojo/recipes/ifx-cmd-recipe.md +135 -86
  184. package/docs/ja/specdojo/recipes/ifx-index-recipe.md +130 -0
  185. package/docs/ja/specdojo/recipes/pm-organization-recipe.md +29 -26
  186. package/docs/ja/specdojo/recipes/pm-plan-recipe.md +35 -26
  187. package/docs/ja/specdojo/recipes/pm-quality-management-plan-recipe.md +38 -28
  188. package/docs/ja/specdojo/recipes/pm-raci-recipe.md +39 -31
  189. package/docs/ja/specdojo/recipes/pm-roles-recipe.md +26 -28
  190. package/docs/ja/specdojo/recipes/prj-assumptions-constraints-dependencies-recipe.md +10 -8
  191. package/docs/ja/specdojo/recipes/prj-comparison-of-alternatives-recipe.md +18 -17
  192. package/docs/ja/specdojo/recipes/stsd-recipe.md +100 -62
  193. package/docs/ja/specdojo/recipes/sysd-critical-flows-recipe.md +106 -0
  194. package/docs/ja/specdojo/recipes/sysd-cross-cutting-policy-recipe.md +137 -0
  195. package/docs/ja/specdojo/recipes/sysd-index-recipe.md +122 -0
  196. package/docs/ja/specdojo/references/command-reference.md +146 -99
  197. package/docs/ja/specdojo/references/deliverables-reference.md +9 -4
  198. package/docs/ja/specdojo/references/directory-layout-reference.md +3 -2
  199. package/docs/ja/specdojo/references/specdojo-config-reference.md +17 -16
  200. package/docs/ja/specdojo/rulebooks/bac-rulebook.md +72 -290
  201. package/docs/ja/specdojo/rulebooks/bdd-rulebook.md +212 -79
  202. package/docs/ja/specdojo/rulebooks/bds-rulebook.md +138 -154
  203. package/docs/ja/specdojo/rulebooks/bes-index-rulebook.md +147 -59
  204. package/docs/ja/specdojo/rulebooks/bes-rulebook.md +100 -96
  205. package/docs/ja/specdojo/rulebooks/br-rulebook.md +88 -108
  206. package/docs/ja/specdojo/rulebooks/ccd-mermaid-rulebook.md +126 -211
  207. package/docs/ja/specdojo/rulebooks/cdfd-d2-rulebook.md +367 -0
  208. package/docs/ja/specdojo/rulebooks/cdfd-mermaid-rulebook.md +6 -5
  209. package/docs/ja/specdojo/rulebooks/cdfd-overview-rulebook.md +96 -100
  210. package/docs/ja/specdojo/rulebooks/cdfd-rulebook.md +38 -47
  211. package/docs/ja/specdojo/rulebooks/cdfd-uc-rulebook.md +132 -106
  212. package/docs/ja/specdojo/rulebooks/cdsd-rulebook.md +102 -68
  213. package/docs/ja/specdojo/rulebooks/cdt-rulebook.md +152 -0
  214. package/docs/ja/specdojo/rulebooks/cld-rulebook.md +9 -184
  215. package/docs/ja/specdojo/rulebooks/clis-rulebook.md +187 -0
  216. package/docs/ja/specdojo/rulebooks/cnd-rulebook.md +93 -247
  217. package/docs/ja/specdojo/rulebooks/cpd-rulebook.md +104 -241
  218. package/docs/ja/specdojo/rulebooks/cxd-rulebook.md +124 -257
  219. package/docs/ja/specdojo/rulebooks/dct-index-rulebook.md +87 -98
  220. package/docs/ja/specdojo/rulebooks/dct-rulebook.md +9 -7
  221. package/docs/ja/specdojo/rulebooks/dec-rulebook.md +2 -1
  222. package/docs/ja/specdojo/rulebooks/dss-rulebook.md +193 -0
  223. package/docs/ja/specdojo/rulebooks/gl-rulebook.md +100 -54
  224. package/docs/ja/specdojo/rulebooks/ifd-mermaid-rulebook.md +69 -252
  225. package/docs/ja/specdojo/rulebooks/ifx-cmd-rulebook.md +91 -76
  226. package/docs/ja/specdojo/rulebooks/ifx-file-rulebook.md +252 -226
  227. package/docs/ja/specdojo/rulebooks/ifx-index-rulebook.md +118 -40
  228. package/docs/ja/specdojo/rulebooks/imp-business-rulebook.md +11 -11
  229. package/docs/ja/specdojo/rulebooks/imp-data-rulebook.md +9 -9
  230. package/docs/ja/specdojo/rulebooks/imp-interface-rulebook.md +4 -4
  231. package/docs/ja/specdojo/rulebooks/imp-operations-rulebook.md +11 -11
  232. package/docs/ja/specdojo/rulebooks/imp-test-rulebook.md +11 -11
  233. package/docs/ja/specdojo/rulebooks/mm-rulebook.md +4 -3
  234. package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +34 -29
  235. package/docs/ja/specdojo/rulebooks/pm-change-request-log-rulebook.md +8 -8
  236. package/docs/ja/specdojo/rulebooks/pm-issue-log-rulebook.md +2 -2
  237. package/docs/ja/specdojo/rulebooks/pm-organization-rulebook.md +50 -56
  238. package/docs/ja/specdojo/rulebooks/pm-plan-rulebook.md +46 -55
  239. package/docs/ja/specdojo/rulebooks/pm-quality-management-plan-rulebook.md +57 -54
  240. package/docs/ja/specdojo/rulebooks/pm-raci-rulebook.md +50 -65
  241. package/docs/ja/specdojo/rulebooks/pm-risk-register-rulebook.md +2 -2
  242. package/docs/ja/specdojo/rulebooks/pm-roles-rulebook.md +70 -97
  243. package/docs/ja/specdojo/rulebooks/pr-rulebook.md +2 -1
  244. package/docs/ja/specdojo/rulebooks/prj-assumptions-constraints-dependencies-rulebook.md +47 -56
  245. package/docs/ja/specdojo/rulebooks/prj-comparison-of-alternatives-rulebook.md +61 -135
  246. package/docs/ja/specdojo/rulebooks/sf-index-rulebook.md +116 -32
  247. package/docs/ja/specdojo/rulebooks/sf-rulebook.md +118 -61
  248. package/docs/ja/specdojo/rulebooks/sld-rulebook.md +152 -57
  249. package/docs/ja/specdojo/rulebooks/stsd-mermaid-rulebook.md +51 -39
  250. package/docs/ja/specdojo/rulebooks/stsd-rulebook.md +101 -46
  251. package/docs/ja/specdojo/rulebooks/sysd-critical-flows-rulebook.md +72 -329
  252. package/docs/ja/specdojo/rulebooks/sysd-cross-cutting-policy-rulebook.md +74 -263
  253. package/docs/ja/specdojo/rulebooks/sysd-index-rulebook.md +78 -195
  254. package/docs/ja/specdojo/rulebooks/tml-rulebook.md +4 -9
  255. package/docs/ja/specdojo/rulebooks/trc-requirements-to-specs-rulebook.md +3 -4
  256. package/docs/ja/specdojo/rulebooks/trc-requirements-to-tests-rulebook.md +3 -3
  257. package/docs/ja/specdojo/rulebooks/uis-rulebook.md +140 -143
  258. package/docs/ja/specdojo/samples/bac-sample.md +106 -21
  259. package/docs/ja/specdojo/samples/bdd-sample.yaml +143 -35
  260. package/docs/ja/specdojo/samples/bds-sample.md +100 -21
  261. package/docs/ja/specdojo/samples/bes-index-sample.md +59 -20
  262. package/docs/ja/specdojo/samples/bes-sample.md +80 -21
  263. package/docs/ja/specdojo/samples/br-sample.md +68 -14
  264. package/docs/ja/specdojo/samples/ccd-sample.md +81 -19
  265. package/docs/ja/specdojo/samples/cdfd-overview-sample.md +248 -140
  266. package/docs/ja/specdojo/samples/cdfd-sample.md +172 -99
  267. package/docs/ja/specdojo/samples/cdfd-uc-sample.md +130 -97
  268. package/docs/ja/specdojo/samples/cdsd-sample.md +89 -20
  269. package/docs/ja/specdojo/samples/cdt-sample.md +116 -0
  270. package/docs/ja/specdojo/samples/cld-sample.md +3 -30
  271. package/docs/ja/specdojo/samples/clis-sample.md +132 -0
  272. package/docs/ja/specdojo/samples/cnd-sample.md +127 -21
  273. package/docs/ja/specdojo/samples/cpd-sample.md +136 -22
  274. package/docs/ja/specdojo/samples/cxd-sample.md +108 -22
  275. package/docs/ja/specdojo/samples/dct-index-sample.yaml +63 -17
  276. package/docs/ja/specdojo/samples/dss-sample.md +175 -0
  277. package/docs/ja/specdojo/samples/gl-sample.yaml +50 -14
  278. package/docs/ja/specdojo/samples/ifd-sample.md +105 -21
  279. package/docs/ja/specdojo/samples/ifx-cmd-sample.yaml +91 -60
  280. package/docs/ja/specdojo/samples/ifx-file-sample.md +462 -21
  281. package/docs/ja/specdojo/samples/ifx-index-sample.yaml +87 -19
  282. package/docs/ja/specdojo/samples/pm-members-sample.yaml +37 -13
  283. package/docs/ja/specdojo/samples/pm-organization-sample.md +52 -20
  284. package/docs/ja/specdojo/samples/pm-plan-sample.md +84 -26
  285. package/docs/ja/specdojo/samples/pm-quality-management-plan-sample.md +55 -22
  286. package/docs/ja/specdojo/samples/pm-raci-sample.md +69 -28
  287. package/docs/ja/specdojo/samples/pm-roles-sample.yaml +13 -12
  288. package/docs/ja/specdojo/samples/prj-assumptions-constraints-dependencies-sample.md +50 -26
  289. package/docs/ja/specdojo/samples/prj-comparison-of-alternatives-sample.md +89 -62
  290. package/docs/ja/specdojo/samples/sf-index-sample.md +89 -20
  291. package/docs/ja/specdojo/samples/sf-sample.md +121 -21
  292. package/docs/ja/specdojo/samples/sld-sample.md +107 -21
  293. package/docs/ja/specdojo/samples/stsd-sample.md +54 -26
  294. package/docs/ja/specdojo/samples/sysd-critical-flows-sample.md +166 -21
  295. package/docs/ja/specdojo/samples/sysd-cross-cutting-policy-sample.md +178 -21
  296. package/docs/ja/specdojo/samples/sysd-index-sample.md +82 -21
  297. package/docs/ja/specdojo/samples/tml-sample.yaml +4 -1
  298. package/docs/ja/specdojo/samples/uis-sample.md +164 -20
  299. package/docs/ja/specdojo/standards/document-metadata-standard.md +33 -4
  300. package/docs/ja/specdojo/standards/id-and-file-naming-standard.md +3 -1
  301. package/docs/ja/specdojo/standards/rulebook-authoring-standard.md +1 -0
  302. package/docs/ja/specdojo/templates/bac-template.md +76 -0
  303. package/docs/ja/specdojo/templates/bes-template.md +56 -0
  304. package/docs/ja/specdojo/templates/br-template.md +64 -0
  305. package/docs/ja/specdojo/templates/cdfd-overview-template.md +161 -83
  306. package/docs/ja/specdojo/templates/cdfd-template.md +81 -54
  307. package/docs/ja/specdojo/templates/cdfd-uc-template.md +130 -89
  308. package/docs/ja/specdojo/templates/cnd-template.md +137 -0
  309. package/docs/ja/specdojo/templates/cpd-template.md +129 -0
  310. package/docs/ja/specdojo/templates/cxd-template.md +105 -0
  311. package/docs/ja/specdojo/templates/dct-data-model-cdt-template.yaml +40 -0
  312. package/docs/ja/specdojo/templates/dct-data-model-cld-template.yaml +7 -14
  313. package/docs/ja/specdojo/templates/dct-index-template.md +9 -20
  314. package/docs/ja/specdojo/templates/dct-project-management-template.yaml +5 -1
  315. package/docs/ja/specdojo/templates/ifd-template.md +86 -0
  316. package/docs/ja/specdojo/templates/ifx-cmd-template.yaml +44 -28
  317. package/docs/ja/specdojo/templates/ifx-index-template.yaml +40 -0
  318. package/docs/ja/specdojo/templates/opr-template.md +2 -4
  319. package/docs/ja/specdojo/templates/pm-organization-template.md +9 -3
  320. package/docs/ja/specdojo/templates/pm-plan-template.md +4 -4
  321. package/docs/ja/specdojo/templates/pm-quality-management-plan-template.md +17 -9
  322. package/docs/ja/specdojo/templates/pm-raci-template.md +24 -13
  323. package/docs/ja/specdojo/templates/pm-roles-template.yaml +3 -2
  324. package/docs/ja/specdojo/templates/prj-assumptions-constraints-dependencies-template.md +6 -3
  325. package/docs/ja/specdojo/templates/prj-comparison-of-alternatives-template.md +22 -19
  326. package/docs/ja/specdojo/templates/stsd-template.md +46 -21
  327. package/docs/ja/specdojo/templates/sysd-critical-flows-template.md +94 -0
  328. package/docs/ja/specdojo/templates/sysd-cross-cutting-policy-template.md +122 -0
  329. package/docs/ja/specdojo/templates/sysd-index-template.md +89 -0
  330. package/docs/specdojo/lib/yaml-metadata.cjs +7 -0
  331. package/docs/specdojo/schemas/v1/bdd.schema.yaml +25 -57
  332. package/docs/specdojo/schemas/v1/condense-records.schema.yaml +26 -0
  333. package/docs/specdojo/schemas/v1/dct.schema.yaml +10 -0
  334. package/docs/specdojo/schemas/v1/deliverable-frontmatter.schema.yaml +3 -0
  335. package/docs/specdojo/schemas/v1/esil.schema.yaml +7 -141
  336. package/docs/specdojo/schemas/v1/exec-common.schema.yaml +3 -0
  337. package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +54 -3
  338. package/docs/specdojo/schemas/v1/exec-evidence.schema.yaml +3 -0
  339. package/docs/specdojo/schemas/v1/exec-plan-frontmatter.schema.yaml +14 -0
  340. package/docs/specdojo/schemas/v1/exec-result-frontmatter.schema.yaml +18 -0
  341. package/docs/specdojo/schemas/v1/finding-cause.schema.yaml +22 -0
  342. package/docs/specdojo/schemas/v1/grade-pipeline-state.schema.yaml +1 -1
  343. package/docs/specdojo/schemas/v1/grade-result.schema.yaml +2 -0
  344. package/docs/specdojo/schemas/v1/ifx-cmd.schema.yaml +65 -5
  345. package/docs/specdojo/schemas/v1/ifx-index.schema.yaml +142 -0
  346. package/docs/specdojo/schemas/v1/register-events.schema.yaml +2 -0
  347. package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +17 -1
  348. package/docs/specdojo/schemas/v1/specdojo-config.schema.yaml +1 -0
  349. package/package.json +6 -3
  350. package/templates/antigravity/README.md +19 -46
  351. package/templates/antigravity/exec-defaults-snippet.yaml +5 -6
  352. package/templates/antigravity/orchestrator.md +3 -2
  353. package/templates/antigravity/settings.edit.json +73 -0
  354. package/templates/antigravity/settings.orchestrator.json +15 -0
  355. package/templates/antigravity/settings.report.json +7 -0
  356. package/templates/antigravity/settings.review.json +7 -0
  357. package/templates/claude/agents/specdojo-orchestrator.md +3 -2
  358. package/templates/codex/agents/specdojo-orchestrator.toml +3 -2
  359. package/templates/codex/orchestrator.md +3 -2
  360. package/templates/devcontainer/remote-host/devcontainer-tmux.sh +217 -0
  361. package/templates/devcontainer/remote-host/specdojo-tmux.sh.sample +8 -96
  362. package/templates/devcontainer/remote-host/ssh-config.sample +3 -1
  363. package/templates/devcontainer/tmux.conf +6 -0
  364. package/templates/init-agent-members.yaml +1 -0
  365. package/templates/init-exec-defaults.yaml +1 -1
  366. package/templates/opencode/agents/specdojo-orchestrator.md +3 -2
@@ -101,6 +101,8 @@ register 実行の場所は `.specdojo/exec-defaults.yaml` の `run.register_exe
101
101
 
102
102
  schedule タスクの自動実行・手動実行の具体的な手順は [Schedule実行運用ガイド](schedule-operation-guide.md)、routine の定義と実行は [routine運用ガイド](routine-operation-guide.md) を参照してください。
103
103
 
104
+ 自動実行を 1 つの track に限る場合は、`exec run --auto --track <track>` を使います。`--parallel`・`--loop`・`--dry-run` と併用でき、失敗後もほかの track のタスクを選びません。たとえば `specdojo exec run --project prj-0001 --auto --track data-flow-uc-rewrite --parallel 3` で、その track から最大 3 件を選びます。`--track` は単一指定で、`--auto` 以外との併用と存在しない track はエラーになります。省略時は全 track が対象です。
105
+
104
106
  ### 1.4. project単位の実行ロック
105
107
 
106
108
  `exec run` は、実行対象 project の `execution_path/exec/.locks/exec-run.lock` を run 全体で保持します。同じ project に対する手動実行、routine、CI の `exec run` は同時に進まず、1つの run 内の `--parallel` worker だけが並列に動きます(register の worktree 実行へ `--join` で合流する場合を除きます。後述の「実行中の register worktree 実行へ後から合流する」を参照してください)。`exec resume` も同じロックへ参加するため、再開処理と新規実行も重なりません。`exec cycle` は再開・古い track の再生成・状態再計算・`--auto` loop の一連の step をこの単一ロック内で保持し、step 間に他の実行が割り込まないことを保証します。
@@ -247,18 +249,28 @@ agent起動時はhook由来の`GIT_DIR`などを継承せず、各trialのcwdか
247
249
 
248
250
  `blocked` は人の判断や外部対応が必要な障害を表します。状況に応じて次のコマンドを使います。
249
251
 
250
- | 状況 | コマンド | 結果 |
251
- | --------------------------------- | ------------------------- | ---------------------------- |
252
- | 中断で `doing` のまま | `exec resume` | 既存 worktree 上で継続 |
253
- | pipeline の reporter で `blocked` | `exec resume --task <id>` | executor evidence から再開 |
254
- | pipeline の統合段で `blocked` | `exec resume --task <id>` | agent を起動せず統合だけ再開 |
255
- | 障害を解消し同じ試行を続ける | `exec unblock` | `blocked -> doing` |
256
- | 試行を破棄して最初からやり直す | `exec release` | `blocked -> todo` |
257
- | 着手前のタスクを恒久的に中止する | `exec cancel` | `todo -> cancelled` |
252
+ | 状況 | コマンド | 結果 |
253
+ | --------------------------------------------------------------------------------------- | ------------------------------------------------ | ------------------------------------------------------------------ |
254
+ | 中断で `doing` のまま | `exec resume` | 既存 worktree 上で継続 |
255
+ | pipeline の reporter で `blocked` | `exec resume --task <id>` | executor evidence から再開 |
256
+ | reporter・統合段で `blocked`、または中断で `doing` の pipeline を executor からやり直す | `exec resume --task <id> --resume-from executor` | 既存 worktree と変更を引き継ぎ、executor → reporter → 統合を再実行 |
257
+ | pipeline の統合段で `blocked` | `exec resume --task <id>` | agent を起動せず統合だけ再開 |
258
+ | 障害を解消し同じ試行を続ける | `exec unblock` | `blocked -> doing` |
259
+ | 試行を破棄して最初からやり直す | `exec release` | `blocked -> todo` |
260
+ | 着手前のタスクを恒久的に中止する | `exec cancel` | `todo -> cancelled` |
258
261
 
259
262
  `release` は `doing` / `blocked` の試行を破棄して `todo` に戻します。`cancel` は `todo` のタスクを終端状態にする操作です。
260
263
 
261
- executor / reporter pipeline では、run ごとの `exec/evidence/<task>/<run>/pipeline-state.json` に各段(executor / reporter と、runner が担う統合段 `integrate`)の状態、agent、試行回数、evidence / result 参照を保存します。executor 中断の block event は `pipeline_stage=executor`、reporter 失敗は `pipeline_stage=reporter`、統合失敗は `pipeline_stage=integrate` を持ち、いずれも `pipeline_state_ref` から同じ run を再開します。`exec resume --task <task-id>` は state に応じて未完了の段から再開し、完了済みの agent 段を重複実行しません。
264
+ executor / reporter pipeline では、run ごとの `<execution_path>/runs/<出どころ>/<項目 ID>/<run ID>/pipeline-state.json` に各段(executor / reporter と、runner が担う統合段 `integrate`)の状態、agent、試行回数、evidence / result 参照を保存します。executor 中断の block event は `pipeline_stage=executor`、reporter 失敗は `pipeline_stage=reporter`、統合失敗は `pipeline_stage=integrate` を持ち、いずれも `pipeline_state_ref` から同じ run を再開します。`exec resume --task <task-id>` は state に応じて未完了の段から再開し、完了済みの agent 段を重複実行しません。
265
+
266
+ 成果物の不足を executor に直させる場合は `--resume-from executor` を付けます。対象は executor が `succeeded` で、reporter が未完了または統合段(commit・検査・merge)で止まった pipeline と、approach の必須項目(`condense_records` など)を欠いた報告として runner が executor の段で止めた pipeline に限ります。既存 run の executor 試行回数を増やし、`blocked` からの再開は `unblock` イベントを記録します。統合段から戻す場合は、executor を起動する前に統合先(project は root の現在ブランチ)を exec branch と worktree へ取り込むため、統合先で直した不具合を worktree で `git merge` せずに受け取れます。未 commit の変更と run の記録は取り込みの前に控えて戻し、戻せない場合は取り込み前へ戻して停止します。統合段の block 理由と result には、失敗した操作のメッセージと、この再開と統合だけの再試行(`exec resume --task <id>`)の 2 つの次の操作を記録します。統合が成功済みの run、一部のリポジトリを統合済みの run、exec branch が merge 済みの run、worktree が merge の途中の run(中止すると stage 済みの変更を失うため)、executor 未成功、pipeline 以外、`executor` 以外の値は理由を表示して停止します。この指定には `--task` が必要で、`--due` とは併用できません。
267
+
268
+ 停止後に plan の指示を補う場合は、次の手順で再開します。
269
+
270
+ 1. `specdojo exec worktree status --project <project-id> --task <task-id>` で残っている worktree を確認する。
271
+ 2. その worktree の `<execution_path>/runs/<出どころ>/<項目 ID>/<run ID>/plan.md` を編集し、追加の指示と、変更の理由・再開までの経緯を result の申し送りへ残す指示を書く。
272
+ 3. `specdojo exec resume --project <project-id> --task <task-id> --resume-from executor`(登録簿の場合は `specdojo exec run --project <project-id> --register <id> --resume --resume-from executor`)を実行する。root で plan を生成し直さず、worktree にある編集済み plan を executor と reporter へ渡す。既存の成果物と未コミット変更も引き継ぎ、統合時には直した plan がコミットに含まれて元の plan で上書きされずに履歴に残る。
273
+ 4. 再開後の result で経緯と検証結果を確認する。pipeline の executor は result を直接編集せず、報告の `handoff` に経緯を記載し、reporter と runner が result へ反映する。
262
274
 
263
275
  stage agent を明示する場合は次のように指定します。片方を省略すると、その stage は要件と優先度から自動選択されます。
264
276
 
@@ -270,6 +282,8 @@ specdojo exec resume \
270
282
  --reporter-by <reporter-nickname>
271
283
  ```
272
284
 
285
+ executor 段から再開するとき(`--resume-from executor` を付けた再開、または executor 段で止まったタスクの再開)に `--executor-by` で現在の claim の持ち主と異なる executor を指定すると、実行前に元の actor の `release` イベントと新しい executor の `claim` イベントを記録して claim を新しい executor へ移し、完了時の `complete` イベント(および中断時の `block` イベント)も新しい executor で記録します。`--executor-by` を省略した場合や同じ executor を指定した場合は既存の claim を維持します(`doing` はそのまま継続し、`blocked` は `unblock` イベントで `doing` に戻します)。reporter 段や統合段のみを再開する場合は既存の claim を維持します。
286
+
273
287
  ```bash
274
288
  specdojo exec release \
275
289
  --project <project-id> \
@@ -291,6 +305,17 @@ specdojo exec release \
291
305
 
292
306
  `--reset-worktree` は未commitの result や成果物変更を破棄します。内容を確認したい場合は、先に [exec worktree運用ガイド](exec-worktree-guide.md) の `status` を使います。
293
307
 
308
+ #### 2.2.1. 人が unblock するときの続行と引き取り
309
+
310
+ `exec unblock` を人が実行しても、claim の持ち主は変わりません。claim の持ち主は `claim` イベントの actor で、`note` やほかの actor の `unblock` では移りません。人が障害を取り除いて agent の run を続けさせる場合と、人が自分で直して完了させる場合は、`--take-over` の有無で区別します。
311
+
312
+ | 意図 | コマンド | claim の持ち主 | その後 |
313
+ | ------------------------------------ | ------------------------------------------------------------- | ------------------------- | --------------------------------------------------------------------------------------- |
314
+ | agent の run を続けさせる | `exec unblock --task <id> --by <human> --msg ...` | 元の actor(agent)のまま | `exec resume --task <id>` が元の agent で再開し、runner の `complete` / `block` も通る |
315
+ | 人が引き取り、自分で直して完了させる | `exec unblock --task <id> --by <human> --msg ... --take-over` | unblock した人 | 人が `exec complete --task <id> --by <human>` で完了させる。agent の run は完了できない |
316
+
317
+ `--take-over` は roster の `type: human` の actor だけが使えます。`--take-over` の `unblock` イベントは `take_over=true` を持ち、pipeline の再開情報(`pipeline_stage` など)を引き継ぎません。claim の持ち主を確かめるには `exec status --state doing` を使います。`by` 列と `--by` の絞り込みは claim の持ち主を表します。
318
+
294
319
  ### 2.3. 完了済みタスクをtodoに戻す
295
320
 
296
321
  完了条件を満たしていないのに `complete` した場合など、完了判定そのものを訂正するときは `exec reopen` を使います。単に追加作業が発生した場合は、完了履歴を訂正せず新しい schedule task として計画します。
@@ -316,7 +341,7 @@ specdojo exec refresh --project <project-id>
316
341
 
317
342
  後続 task も完了済みの場合は、依存グラフの下流から順に `reopen` します。後続 task が `doing` / `blocked` の場合は、先に同じ試行を完了させるか、`exec release` で `todo` に戻します。これにより、完了していない依存先を前提に後続 task が進行・完了している状態を防ぎます。
318
343
 
319
- `reopen` は plan、result、成果物、Git 履歴を削除・復元しません。完了済み plan は `exec/plans/done/` に残り、次の `exec plan` / `exec run` で新しい固定名 plan を生成します。再 claim 時は固定名 result を再利用し、新しい試行の状態と時刻に更新します。
344
+ `reopen` は過去 run の plan・result、成果物、Git 履歴を変更・削除しません。完了済み plan は同じ run ディレクトリに残り、次の `exec plan` / `exec run` で新しい run を生成します。同じ run の続きは `exec resume` で再開します。
320
345
 
321
346
  ```bash
322
347
  specdojo exec claim --project <project-id> --task <task-id> --by <actor> --msg "rerun"
@@ -380,11 +405,13 @@ specdojo exec run --project <project-id> --task <task-id> --worktree
380
405
  schedule に `agent_pipeline` を持たない plan(`exec plan --deliverable <localId> --mode review` で生成した review plan など)は、`exec run --plan` または `exec run --deliverable` に `--executor-by` / `--reporter-by` を足すと同じ 2 stage で実行します。片方だけ指定した場合、もう一方は `stage_role` による自動選択で決まります。reporter が scaffold 済みの result を記入するため、`--plan` では frontmatter に `task_id` を持つ plan が必要です。`--by` に `stage_role` を持つ pipeline 用 agent を指定すると、result 未記入の blocked にはせず、`--executor-by` / `--reporter-by` を使うよう案内するエラーで実行前に拒否します。
381
406
 
382
407
  ```bash
383
- specdojo exec run --project <project-id> --plan <execution-path>/exec/plans/<stem>-plan.md \
408
+ specdojo exec run --project <project-id> --plan <execution_path>/runs/<出どころ>/<項目 ID>/<run ID>/plan.md \
384
409
  --executor-by <executor-nickname> --reporter-by <reporter-nickname>
385
410
  ```
386
411
 
387
- run ごとの実行記録は `<execution_path>/exec/evidence/<task-id>/<run-id>/` に残ります。停止位置と再開可否はここを見て判断します。
412
+ 新規 run の plan・result・evidence・ログ・state は `<execution_path>/runs/<出どころ>/<項目 ID>/<run ID>/` に残ります。出どころは `register`・`schedule`・`job` です。停止位置と再開可否はここを見て判断します。
413
+
414
+ 旧配置の `<execution_path>/exec/evidence/<task-id>/<run-id>/` に checkpoint がある run は、`--resume`(`--resume-from executor` を含む)後も同じ run ID とディレクトリへ記録を続けます。executor を再実行すると、前回の state・evidence・ログを同じ場所の `*.attempt-N.*` に退避します。統合では result の配置にかかわらず現在の run の記録を commit します。commit 対象から外した別 run の記録は、ほかの許可外の変更とともに標準出力と `integrate.log` に一覧を表示します。
388
415
 
389
416
  | ファイル | 確認できること |
390
417
  | --------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- |
@@ -394,7 +421,7 @@ run ごとの実行記録は `<execution_path>/exec/evidence/<task-id>/<run-id>/
394
421
  | `reporter-attempt-<n>.stdout.log` / `reporter-attempt-<n>.stderr.log` | 失敗した reporter の形式試行別の生出力(秘匿値は伏せ字化、各ストリーム 64KiB で切り詰め) |
395
422
  | `integrate.log` | checkpoint・統合段の commit / merge 失敗の stdout / stderr 全文(秘匿値は伏せ字化) |
396
423
 
397
- agent ログは人が調査するための参照先で、reporter には渡りません。reporter が受け取るのは plan、runner 管理記録を除いた `evidence.json` の変更一覧、文章項目と対応づけ用パスだけの出力スキーマです。runner 管理記録は、解決済みの execution path 配下の evidence、project register とその派生ビュー、当該 result のパスを基準に除外します。ただし executor の試行中に runner 管理記録が実際に変わった場合、そのパスと状態は reporter 専用の `runner_context.runner_managed_attempt_changes` に含めます。reporter は、executor の最終メッセージがその変更に触れたのに `changed_files` にないという理由だけで確認を求めません。result の変更パスはこの除外後の `changes`、`outcome` と `block_reason` は executor の stage・終了コード・保護理由と検証結果から runner が機械生成します。executor または親 runner の検証に failed / `not_run` があれば blocked です。executor の `not_run` は、親 runner が同じコマンドを project で実行して成功していれば満たされたものとして扱います。また、対応する npm script がない、`npx` の package が未導入、または SpecDojo サブコマンドの設定上の適用条件を満たさないと runner が確定できる場合は適用外として block せず、result の申し送りへ「適用外の検証(runner の判定)」を残します。この判定は reporter 専用の `runner_context.mechanically_not_applicable` にも含め、reporter は同じ検証の実行を申し送りで求めません。`catalog validate` は対象 project の `catalog_path` で判定し、設定や対象 project を特定できない場合と適用条件が未定義のサブコマンドは救済しません。対象 project は `--project <id>`、run の対象 project、`current_project` の順に決めるため、別の project の `catalog_path` では判定しません。`<repo>:<path>` を引数に含むコマンドや `--prefix <repo>` 付きのコマンドは、そのプロダクトリポジトリの `package.json` で判定します。`npm run <name> -- <args>` と `npm run <name> <args>` も `<name>` の script が存在すれば適用外の申告を反証しますが、引数付きコマンドを親 runner が実行した引数なしコマンドと同一とはみなしません。`npm run check` のような合成コマンドは、構成する各コマンドが親 runner か executor の検証で通っていれば満たされたものとして扱います。理由付きの `not_applicable` は block せず result の申し送りへ残しますが、理由がない場合や、存在する npm script/依存 package を適用外とした場合は blocked です。ただし SpecDojo サブコマンドは package の有無だけでは反証せず、既知の適用条件を設定から判定します。executor の `requires_human` は sandbox 外で人が行う確認として block せず、runner が edit result の申し送りへ「人の確認が必要: `<コマンド>`(<要約>)」を機械的に追記します。reporter は実施内容、パスと対にした各変更の説明、申し送り、approach、review の判断根拠と改善指示だけを返します。runner はパスで説明を突き合わせ、順序は問いません。説明がない evidence のパスには差分参照を促す既定文を記録し、evidence にないパスの説明は捨てるため、件数の過不足で result の作成は失敗しません。機械管理項目を追加した出力は形式不正として拒否されます。失敗理由の要約だけでは原因が分からない場合は、記録済み `evidence.json` の `log_refs` から stdout / stderr を個別に確認します。ログは Git 管理対象の evidence ディレクトリにありますが、失敗中の worktree では未コミットのため、`--force-restart` などで破棄する前に確認します(詳細は [exec設定ガイド](exec-config-guide.md) の `evidence とログの引き渡し方針`)。
424
+ agent ログは人が調査するための参照先で、reporter には渡りません。reporter が受け取るのは plan、runner 管理記録を除いた `evidence.json` の変更一覧、文章項目と対応づけ用パスだけの出力スキーマです。runner 管理記録は、解決済みの execution path 配下の evidence、project register とその派生ビュー、当該 result のパスを基準に除外します。ただし executor の試行中に runner 管理記録が実際に変わった場合、そのパスと状態は reporter 専用の `runner_context.runner_managed_attempt_changes` に含めます。reporter は、executor の最終メッセージがその変更に触れたのに `changed_files` にないという理由だけで確認を求めません。result の変更パスはこの除外後の `changes`、`outcome` と `block_reason` は executor の stage・終了コード・保護理由と検証結果から runner が機械生成します。executor または親 runner の検証に failed / `not_run` があれば blocked です。executor の `not_run` は、親 runner が同じコマンドを project で実行して成功していれば満たされたものとして扱います。また、対応する npm script がない、`npx` の package が未導入、変更ファイル種別を含む適用条件を満たさない、または SpecDojo サブコマンドの設定上の適用条件を満たさないと runner が確定できる場合は適用外として block せず、result の申し送りへ「適用外の検証(runner の判定)」を残します。この判定は reporter 専用の `runner_context.mechanically_not_applicable` にも含め、reporter は同じ検証の実行を申し送りで求めません。変更範囲の判定では、runner が生成・更新する `exec/` 配下(`plans/`・`results/`・`evidence/`・`events/`・`.locks/`)を executor の変更ファイルから除外します。`validate:history-links`(`specdojo-docs-lint history-links` を含む)は履歴蓄積ファイル(`pjr-*.md`(`pjr-index.md` を除く)、または executor 自身が変更した `execution/runs/<origin>/<item>/<run>/` 配下の `plan.md`・`result.md` や旧来の `exec/plans/**/*.md`・`exec/results/**/*.md`)の変更がある場合だけ適用対象とします。`catalog validate`(`npm run validate:catalog` および `tools/catalog-validate-if-configured.mjs` を含む)は対象 project の `catalog_path` と、runner 管理記録を除いた変更が `docs/ja/projects/` 配下に及ぶかで判定し、設定や対象 project を特定できない場合と適用条件が未定義のサブコマンドは救済しません。対象 project は `--project <id>`、run の対象 project、`current_project` の順に決めるため、別の project の `catalog_path` では判定しません。`<repo>:<path>` を引数に含むコマンドや `--prefix <repo>` 付きのコマンドは、そのプロダクトリポジトリの `package.json` で判定します。`npm run <name> -- <args>` と `npm run <name> <args>` も `<name>` の script が存在すれば適用外の申告を反証しますが、引数付きコマンドを親 runner が実行した引数なしコマンドと同一とはみなしません。`npm run check` のような合成コマンドは、構成する各コマンドが親 runner か executor の検証で通っていれば満たされたものとして扱います。理由付きの `not_applicable` は block せず result の申し送りへ残しますが、理由がない場合や、変更ファイル種別を含む適用条件を満たしたうえで存在する npm script/依存 package を適用外とした場合は blocked です。ただし SpecDojo サブコマンドは package の有無だけでは反証せず、既知の適用条件を設定から判定します。executor の `requires_human` は sandbox 外で人が行う確認として block せず、runner が edit result の申し送りへ「人の確認が必要: `<コマンド>`(<要約>)」を機械的に追記します。reporter は実施内容、パスと対にした各変更の説明、申し送り、approach、review の判断根拠と改善指示だけを返します。runner はパスで説明を突き合わせ、順序は問いません。説明がない evidence のパスには差分参照を促す既定文を記録し、evidence にないパスの説明は捨てるため、件数の過不足で result の作成は失敗しません。機械管理項目を追加した出力は形式不正として拒否されます。失敗理由の要約だけでは原因が分からない場合は、記録済み `evidence.json` の `log_refs` から stdout / stderr を個別に確認します。ログは Git 管理対象の evidence ディレクトリにありますが、失敗中の worktree では未コミットのため、`--force-restart` などで破棄する前に確認します(詳細は [exec設定ガイド](exec-config-guide.md) の `evidence とログの引き渡し方針`)。
398
425
 
399
426
  stage 別の失敗と対応は次のとおりです。
400
427
 
@@ -514,6 +541,25 @@ reporter 段の再開の入力は、`pipeline-state.json`(stage 状態と plan
514
541
 
515
542
  統合段の再開は、executor と reporter が成功したまま commit・merge・worktree 撤去のいずれかが失敗した run が対象です。worktree は統合が完了したときにだけ撤去されるため、reporter 成功済みの worktree が残っていること自体が統合の未完了を意味します。この再開では agent を1つも起動せず、worktree に残っている成果物と記入済み result をそのまま統合します。前回の試行で merge まで完了していた場合は、取り込み済みの exec ブランチを再 merge せずに残りの手順(worktree 撤去と `register review`)だけを進めます。再開の開始時に項目は `in-progress` へ戻り、成功なら `review`、失敗なら `waiting` へ遷移するため、再試行の成否は登録簿の状態とイベントに残ります。統合段の進捗(開始と失敗)は `pipeline-state.json` の `integrate` にも記録します。
516
543
 
544
+ register の統合で許可外の追加など commit 対象外の変更が見つかると、成果物の commit・merge を止め、項目を `waiting` にして worktree を保持します。`block_reason` に未 commit の件数・先頭3件のパス・worktree 内の `integrate.log` の場所、run の最後の要約に `uncommitted=<件数>` を表示します。ログには全対象パスが残ります。移動元の削除が許可内でも、移動先が許可外なら同じ扱いです。
545
+
546
+ 新しい最上位ディレクトリへの移動など必要な変更の場合は、ログと差分を確認し、利用者の承認後に保持した worktree で対象パスを明示して commit します。次は `docs/ja/product/trash/` から `archive/ja/product/trash/` への移動の例です。`<worktree-path>` は停止時に表示された場所に置き換えます。
547
+
548
+ ```bash
549
+ git -C <worktree-path> status --short --untracked-files=all
550
+ git -C <worktree-path> diff -- docs/ja/product/trash/
551
+ # 移動先の内容と links.json も確認し、利用者の承認を得てから実行する
552
+ git -C <worktree-path> add -A -- docs/ja/product/trash/ archive/ja/product/trash/
553
+ git -C <worktree-path> diff --cached --stat
554
+ git -C <worktree-path> commit -m "Archive documents approved by user"
555
+ ```
556
+
557
+ その後、統合先の worktree から次を実行します。executor と reporter を再実行せず、手動 commit と残りの成果物を統合します。不要な一時ファイルだった場合は worktree 内で対象だけを除去してから同じコマンドで再開します。新しいディレクトリの自動許可や `--force-restart` による破棄は必要ありません。
558
+
559
+ ```bash
560
+ specdojo exec run --project <project-id> --register <PJR-ID> --worktree --resume
561
+ ```
562
+
517
563
  `specdojo.config.json` の project に `repos` を宣言している場合、統合段は宣言順のプロダクトリポジトリ、最後にプロジェクトリポジトリの順で統合し、リポジトリ別の状態(`pending` / `merged` / `unchanged` / `failed`)を `pipeline-state.json` の `integrate.repos` に記録します。途中で失敗すると、統合済みのリポジトリはそのまま残し、項目を `waiting` へ戻して全リポジトリの worktree を保持します。統合段の再開では、統合先へ取り込み済みのプロダクトを merge し直さず、失敗したリポジトリから統合を続けます。統合の順序と部分状態の詳細は [[specdojo:docs-structure-guide|ドキュメント構成ガイド]] の「複数リポジトリの統合の失敗と再開」を参照してください。
518
564
 
519
565
  再開できるかどうかは、対象 worktree の最新 run だけで判定します。次の場合は worktree・exec ブランチ・未コミットの成果を一切変更せず、理由を出力して終了コード 1 で終わります。
@@ -655,6 +701,8 @@ specdojo:
655
701
  - **対象(`targets`)**: 成果物カタログ(DCT)に定義されている成果物の文書 ID(doc id)を指定します(例: `prj-0001:cxd-specdojo`、`specdojo:exec-config-guide`)。プロダクト成果物の場合は `local_id` の canonical 形式(`<project-id>:<local_id>`)も受け付けます。まだ文書ファイルが作成されていない成果物であっても、カタログに定義されていればカタログで解決され、起票・実行できます。
656
702
  - **進め方(`approach`)**: 成果物を作成・修正する進め方(`draft`(文脈を調べて下書き)、`fully-guided`(既存成果物の磨き込み)、`recipe-guided`、`freeform`、`bootstrap`、`retrofit`、`cross-deliverable-dedup` など)から目的に応じて選びます。
657
703
 
704
+ `draft`・`fully-guided`・`recipe-guided` の edit plan は、カタログの `evidence_refs` を「実装エビデンスと未作成の依存」節へ展開します。列挙された実装は読み取り専用で、変更許可範囲と commit 対象には入りません。`evidence_refs` がない場合やカタログなしの場合も、それだけでは停止しません。未作成の `depends_on` はインラインコードと「未作成」で示し、内容を推測せず _TODO_ / _ASSUMPTION_ と次のアクションを残して進めます。資料が食い違うときの根拠の使い分けは [[specdojo:ryu-guide|実践の進め方ガイド]] を参照してください。
705
+
658
706
  #### 4.3.2. kata(実践の型)を対象にする場合
659
707
 
660
708
  - **対象(`targets`)**: kata の文書 ID(doc id)を指定します(例: `specdojo:pjr-rulebook`、`specdojo:exec-human-finalize-recipe` など)。kata は文書索引(doc-index)で解決されます。
@@ -82,6 +82,8 @@ specdojo exec complete \
82
82
 
83
83
  `exec worktree` は独自の JSON や状態ファイルを作りません。必要な情報は毎回既存情報から導出します。
84
84
 
85
+ worktree の配置は `--worktree-base`、project 設定の `run.worktree_base`、既定値 `../worktrees` の順で決まります。設定値と既定値の相対パスは主の作業ツリーを基準に解決するため、Job worktree 内からの起動でも同じ配置になります。明示的な `--worktree-base` の相対パスは起動元の作業ツリーが基準で、絶対パスはそのまま使います。統合先は起動元のブランチです。
86
+
85
87
  | 情報 | 導出元 |
86
88
  | ------------------- | ---------------------------------------------------------- |
87
89
  | worktree名 / branch | project 修飾 task ID から `<slug>` と `exec/<slug>` を導出 |
@@ -136,7 +138,7 @@ specdojo exec worktree prepare \
136
138
 
137
139
  root にある無関係な未commit変更は checkpoint commit に含めません。stage 済み変更はパスを警告へ表示して保持し、plan、result、claim event などの checkpoint 対象と重複する場合だけ停止します。checkpoint commit が hook などで失敗した場合は、checkpoint 対象だけを unstage し、無関係な stage 済み変更は変更しません。checkpoint は exec branch だけに置かれるため、統合先の first-parent に `prepare execution` commit は増えません。root 側の plan、result、claim event は未commitのまま残り、task が `doing` であることは統合先からも見えます。これらの root 側の複製は `worktree merge` が統合の直前に解放し(HEAD の状態へ戻し)、merge が exec branch の commit 済み内容を持ち込みます。merge が失敗した場合は複製を元に戻します。
138
140
 
139
- 作成または再利用した task worktree では、tracked `package-lock.json` ごとに `npm ci --include=dev` を実行し、root と独立 package の `node_modules` を worktree 内へ実体として配置します。依存関係を元 worktree と共有しないため、agent の sandbox は task worktree 内だけへの書き込みで build、typecheck、依存更新を実行できます。
141
+ 作成または再利用した task worktree では、tracked `package-lock.json` ごとに `npm ci --include=dev --prefer-offline --no-audit --no-fund` を実行し、root と独立 package の `node_modules` を worktree 内へ実体として配置します。依存関係を元 worktree と共有しないため、agent の sandbox は task worktree 内だけへの書き込みで build、typecheck、依存更新を実行できます。lock から入る依存は主の作業ツリーと同じになるため、npm cache にある tarball を再検証せずに使い、準備に要らない audit と fund の問い合わせは省きます(PJR-T01P)。
140
142
 
141
143
  過去のバージョンが作成した `node_modules` シンボリックリンクを検出した場合は、リンク先へ変更を加えずリンクだけを削除してから `npm ci` で置き換えます。install に失敗した場合は agent を起動せず、調査できるよう task worktree を保持したままエラー終了します。依存取得に必要な registry と npm cache は、`exec run` を起動する環境から利用できる必要があります。
142
144
 
@@ -202,19 +204,19 @@ specdojo exec worktree commit \
202
204
 
203
205
  commit 対象から除外する主なパス:
204
206
 
205
- | 除外対象 | 理由 |
206
- | -------------------------------- | ---------------------------------------------- |
207
- | `tmp/` | agent の作業用一時ファイルは commit に含めない |
208
- | `exec/plans/` | plan は実行入力であり agent の成果物ではない |
209
- | 対象 task 以外の `exec/results/` | 他タスクの記録を混ぜない |
210
- | `exec/events/` | event は root 側の状態管理で扱う |
211
- | `generated/` | 再生成物を task 成果物に混ぜない |
207
+ | 除外対象 | 理由 |
208
+ | --------------------------------- | ---------------------------------------------- |
209
+ | `tmp/` | agent の作業用一時ファイルは commit に含めない |
210
+ | `plan.md` | plan は実行入力であり agent の成果物ではない |
211
+ | 対象 run 以外の `execution/runs/` | 他タスク・他 run の記録を混ぜない |
212
+ | `exec/events/` | event は root 側の状態管理で扱う |
213
+ | `generated/` | 再生成物を task 成果物に混ぜない |
212
214
 
213
215
  対象 task の result は成果物変更と同じ commit に含めます。変更がない場合は commit を作成しません。
214
216
 
215
- 上表の除外に加え、プロンプトインジェクション対策として commit 対象を mode 別の許可リストで絞ります。review は対象 task の result のみ、edit は result と plan の `targets` から解決した成果物(maintenance / bootstrap 系 approach は実践の型ディレクトリも)だけを commit し、許可リスト外の変更は `commit-scope:` 警告を出して worktree に残します。詳細は [exec設定ガイド](exec-config-guide.md) の `agent 権限とプロンプトインジェクション対策` を参照します。
217
+ 上表の除外に加え、プロンプトインジェクション対策として commit 対象を mode 別の許可リストで絞ります。review は対象 task の result のみ、edit は result と plan の `targets` から解決した成果物(maintenance / bootstrap 系 approach は実践の型ディレクトリも)だけを commit し、許可リスト外の変更が残っていれば `commit-scope: integration blocked` と対象パスを出力し、commit・統合・通常の worktree 撤去を止めます。対象パスと次のアクションは result の申し送りと `integrate.log` に残します。詳細は [[specdojo:exec-config-guide|exec 設定ガイド]] の `agent 権限とプロンプトインジェクション対策` を参照します。
216
218
 
217
- 登録簿由来(`origin: register`)のタスクは許可リストを使わず、上表の除外だけを適用して作業ツリーの差分を commit します。HEAD に無い新規ファイルは、リポジトリ最上位、既知の成果物ディレクトリ(`docs/`、`src/`、`tests/`、`tools/`、`scripts/`、`packages/`)、HEAD で追跡済みの最上位ディレクトリ、対象 task の result と evidence、plan の `targets` から解決した成果物に置かれたものを commit します。`tmp/` 配下のファイルは常に commit 対象から除外します。それ以外の未追跡ディレクトリに置かれた新規ファイルは `commit-scope:` 警告を出して worktree に残し、pipeline 実行では run の `integrate.log` にも記録します。最上位に追加した新規ファイルを commit した場合は、統合ログと result の申し送りに「最上位に追加したファイル」として列挙します。既存ファイルの変更と削除、人間の作業(`execution: human`)は従来どおり commit します。`ready` への昇格検査は commit 対象のパスだけに適用するため、commit しない一時ファイルは統合を止めません。
219
+ 登録簿由来(`origin: register`)のタスクは許可リストを使わず、上表の除外だけを適用して作業ツリーの差分を commit します。HEAD に無い新規ファイルは、リポジトリ最上位、既知の成果物ディレクトリ(`docs/`、`src/`、`tests/`、`tools/`、`scripts/`、`packages/`)、HEAD で追跡済みの最上位ディレクトリ、対象 task の result と evidence、plan の `targets` から解決した成果物に置かれたものを commit します。`tmp/` 配下のファイルは常に commit 対象から除外します。それ以外の未追跡ディレクトリに置かれた新規ファイルは、上記の停止ガードの対象です。最上位に追加した新規ファイルを commit した場合は、統合ログと result の申し送りに「最上位に追加したファイル」として列挙します。既存ファイルの変更と削除、人間の作業(`execution: human`)は従来どおり commit します。`ready` への昇格検査は commit 対象のパスだけに適用するため、`tmp/` 配下の一時ファイルの `ready` は統合を止めません。
218
220
 
219
221
  ### 2.5. merge
220
222
 
@@ -233,10 +235,13 @@ specdojo exec worktree merge \
233
235
  | exec branch 側に未統合 commit がある | merge する差分が存在する |
234
236
  | task worktree に commit 対象の未commit変更がない | result / 成果物を取りこぼさない |
235
237
  | 現在ブランチが exec branch ではない | 自分自身へ merge しない |
238
+ | 統合先の index に stage 済み変更がない | 別の操作の stage を保持する |
236
239
  | 現在の未commit変更と merge 対象パスが重複しない | 手作業の変更を壊さない |
237
240
 
238
241
  `prepare` が root に残した plan、result、claim event の複製は、重複判定の前に解放します(exec branch の commit 済み内容が merge で入るため)。それ以外の未commit変更が merge 対象パスと重複する場合は停止します。
239
242
 
243
+ stage 済み変更は merge 対象との重複にかかわらず、複製の解放前に対象パスと復旧手順を示して停止します。表示された worktree で commit するか、各パスに `git restore --staged -- <path>` を実行して本文を残してから再開します。複数リポジトリの統合も、いずれかの統合先に stage 済み変更があれば全体の事前検査で停止します。
244
+
240
245
  通常は `git merge --no-ff` 相当で統合します。自動実行では `exec(<task-id>): <task name>` を merge commit の subject に使い、統合先の first-parent を1タスク1commitにします(`prepare execution` / `apply task changes` は exec branch 側に残ります)。`--ff-only` 指定時は fast-forward 可能な場合だけ統合します。
241
246
 
242
247
  register 項目の統合で競合したのが項目自身の記帳ファイル(個票・イベント・plan・result)だけの場合は、記帳ファイルを次のように解決して merge commit を作ります。`waiting` を複数回経た項目では、wait 時の同期 merge の後も統合先と exec branch の双方で記帳ファイルが変わるためです。解決後の commit は通常の `git merge` と同じく pre-commit hook を実行しません。
@@ -246,11 +251,13 @@ register 項目の統合で競合したのが項目自身の記帳ファイル
246
251
  - 個票は exec branch 側を基準にし、統合先だけにあるイベントが変えた `type` / `priority` / `owner` / `due` をイベントから再構築します。同じフィールドを後から exec branch 側のイベントが変えている場合は、exec branch 側を残します。タイトル・説明(本文)、状態遷移に伴うフィールド、登録日時はイベントから元の値を復元できないため再構築しません。
247
252
  - plan・result・登録簿(`pjr-index.md`)は exec branch 側(再開後の最新の記帳)の内容で解決します。
248
253
 
254
+ Schedule タスクの統合で、run の終わりの記帳 commit が先に統合先へ入れた plan・result・claim event と、exec branch 側の同じファイルが両側の追加として競合した場合も、その task の run の記録(`runs/schedule/<task-id>/` 配下)と checkpoint の複製に限って exec branch 側の内容で解決します([Schedule実行運用ガイド](schedule-operation-guide.md) の「実行記録の記帳」を参照)。
255
+
249
256
  上記以外の競合または commit hook の失敗で merge commit を作れなかった場合は、runner が `git merge --abort` を実行して統合先を開始前の状態へ戻します。Schedule タスクは `blocked`、register 項目は `waiting` へ遷移し、再開に使う exec branch と worktree は保持します。register の `wait` commit は abort 後に作るため、統合先へ `MERGE_HEAD` を残したまま部分 commit を試みません。block reason には hook の罫線や色を除いた失敗ステップ名、最初のエラー行、Vitest の末尾にある `FAIL`・`Test Files`・`Tests` の集計行を記録します。executor/reporter pipeline では checkpoint と統合段の commit / merge が失敗したときの stdout / stderr 全文と abort 結果を秘匿処理し、同じ run の `integrate.log` に保存します。
250
257
 
251
258
  register 項目を `waiting` へ遷移したあとは、`wait` commit と、その時点までに統合先へ入った変更を exec branch へ通常 merge します。root の `wait` commit に保存済みの個票・イベント・plan・result は、worktree に残る同内容の未 commit 変更を解放してから merge し、これらの記帳パスの競合だけを `wait` commit 側で解決します。それ以外の競合は自動解決せずに同期 merge を中断します。これにより、再開時の merge-base を進めながら、別項目が統合先へ追加した成果を exec branch 側の削除として扱わないようにします。
252
259
 
253
- hook や検査を直した後は、Schedule タスクでは `specdojo exec resume --project <project-id> --task <task-id>`、register 項目では元の `exec run --register ... --worktree --resume` を実行します。統合段から再開するため agent は再実行せず、保持した exec branch を merge します。親検証の失敗を成果物側で修正する必要がある register 項目は `--resume-from executor` を併用します。保護対象の設定変更を人が統合先へ適用した場合も、通常の `--resume` が統合先を exec branch と worktree へ取り込んでから executor を再開するため、worktree で手動 merge しません。
260
+ hook や検査を直した後は、Schedule タスクでは `specdojo exec resume --project <project-id> --task <task-id>`、register 項目では元の `exec run --register ... --worktree --resume` を実行します。統合段から再開するため agent は再実行せず、保持した exec branch を merge します。親検証の失敗を成果物側で修正する必要がある register 項目は `--resume-from executor` を併用します。統合段で止まった Schedule タスクの成果物を直す場合は `specdojo exec resume --project <project-id> --task <task-id> --resume-from executor` を実行します。統合先を exec branch と worktree へ取り込んでから executor を再実行するため、worktree で `git merge` や `git merge --abort` を実行しません。保護対象の設定変更を人が統合先へ適用した場合も、通常の `--resume` が統合先を exec branch と worktree へ取り込んでから executor を再開するため、worktree で手動 merge しません。
254
261
 
255
262
  runner は `git merge --abort` の前に `git update-index -q --refresh` を実行します。同じ作業ツリーで動く routine などがファイルの stat だけを変えた場合でも、`not uptodate` で abort が失敗しないようにするためです。自動の `git merge --abort` 自体が失敗した場合は、runner が標準エラーへ手動復旧を案内します。案内された root worktree で状態と失敗原因を確認し、ロックファイルや Git プロセスなどの原因を解消してから次を実行してください。abort が完了するまでは commit や統合再開を行いません。
256
263
 
@@ -304,6 +311,8 @@ specdojo exec worktree prune --project <project-id>
304
311
 
305
312
  分割コマンドは状態 event を更新しないため、成果物確認後に人が明示的に `complete` または `block` を実行します。
306
313
 
314
+ 人が書いたイベントは、書いた人が成果物と合わせて commit します。runner の記帳 commit(`exec run` / `exec resume` / `exec cycle` の終わり)が拾うのは、`by` が `.specdojo/agent-members.yaml` の agent のイベントだけです。
315
+
307
316
  ```bash
308
317
  specdojo exec complete \
309
318
  --project <project-id> \
@@ -58,14 +58,16 @@ CLI を直接操作する場合の代表フローは [遂行の技活用ガイ
58
58
  | `orch:qwen:work` | OpenCode / Qwen 3.8 | `../worktrees/qwen-work`(無ければ自動作成) |
59
59
  | `orch:gemma` | OpenCode / Gemma 4 | なし |
60
60
  | `orch:gemma:work` | OpenCode / Gemma 4 | `../worktrees/gemma-work`(無ければ自動作成) |
61
+ | `orch:argon` | Antigravity / `gemini-4-argon-medium` | なし |
62
+ | `orch:argon:work` | Antigravity / `gemini-4-argon-medium` | `../worktrees/argon-work`(無ければ自動作成) |
61
63
  | `orch:flash` | Antigravity / `gemini-3.8-flash-high` | なし |
62
64
  | `orch:flash:work` | Antigravity / `gemini-3.8-flash-high` | `../worktrees/agy-work`(無ければ自動作成) |
63
65
 
64
66
  Antigravity CLI(`agy`)はファイル定義の agent を持たないため、Codex と同じく SSOT `.agents/specdojo-orchestrator.agent.md` の本文を `-i`(初期プロンプトを与えて対話を続ける)で渡します。ラッパーは不要で、`.agents/rules/*.md` の薄いラッパー経由で `.github/instructions/` の規則も読み込まれます。
65
67
 
66
- Antigravity で使えるモデル ID は `agy models` で確認してください。配布時点の既定値は、agy 1.3.5 で提供される `gemini-3.8-flash-high` です。
68
+ Antigravity で使えるモデル ID は `agy models` で確認してください。配布スクリプトは `gemini-4-argon-medium` と `gemini-3.8-flash-high` を指定します。
67
69
 
68
- `specdojo init` と `config scaffold` が利用者の `package.json` へ追加するスクリプトは、Claude Code が `orch:opus`・`orch:sonnet`、Codex が `orch:sol`(`gpt-6.1-sol`)・`orch:luna`(`gpt-6-luna`)、Antigravity が `orch:flash`、OpenCode が `orch:opencode` です。Codex と Antigravity のスクリプトは、名前に対応するモデルを起動コマンドで明示します。
70
+ `specdojo init` と `config scaffold` が利用者の `package.json` へ追加するスクリプトは、Claude Code が `orch:opus`・`orch:sonnet`、Codex が `orch:sol`(`gpt-6.1-sol`)・`orch:luna`(`gpt-6-luna`)、Antigravity が `orch:argon`(`gemini-4-argon-medium`)・`orch:flash`(`gemini-3.8-flash-high`)、OpenCode が `orch:opencode` です。Codex と Antigravity のスクリプトは、名前に対応するモデルを起動コマンドで明示します。
69
71
 
70
72
  0.4.0 以前に作った `orch:codex`・`orch:agy` は自動では削除・上書きされません。`config scaffold --provider codex` または `config scaffold --provider antigravity` を再実行して新しいスクリプトを追加し、新しい名前で起動できることを確認してから、旧スクリプトを `package.json` から削除してください。
71
73
 
@@ -42,61 +42,87 @@ plan / result の frontmatter には `targets`(対象文書の doc id リス
42
42
 
43
43
  ### 1.2. 配置
44
44
 
45
- | 種別 | 配置 |
46
- | ------------- | ----------------------------------- |
47
- | plan | `<execution_path>/exec/plans/` |
48
- | 完了後の plan | `<execution_path>/exec/plans/done/` |
49
- | result | `<execution_path>/exec/results/` |
45
+ 1 回の実行を `execution/runs/<出どころ>/<項目 ID>/<run ID>/` にまとめます。配置の決め方は `src/shared/run-records.ts` を正本とします。
50
46
 
51
- result は完了記録であり、review などから参照されるため `done/` へ移動しません。
52
-
53
- ## 2. 命名規則
47
+ ```text
48
+ execution/
49
+ runs/<出どころ>/<項目 ID>/<run ID>/
50
+ plan.md
51
+ result.md
52
+ evidence.json
53
+ pipeline-state.json
54
+ executor.log
55
+ reporter.log
56
+ ```
54
57
 
55
- task identity の有無によるファイル名の決め方と、対象成果物の解決方法を示します。
58
+ ログは実行した段に応じて保存し、親検証・統合のログも同じディレクトリに置きます。human の実行は result のみです。完了しても保存先は変わりません。共通規約の版は `execution/conventions/`、成果物ごとの評価結果は `execution/grade/results/`、job の状態管理 JSON は `execution/jobs/runs/` に残します。
56
59
 
57
- ### 2.1. task identityありの命名
60
+ ### 1.3. 配置の検査
58
61
 
59
- `--task <task-id>` を使う場合、plan と result は task ID を使った固定名になります。
62
+ `exec validate` は schedule・event とともに実行記録の配置を検査し、欠けた記録を `WARN:` で知らせます。欠落だけなら終了コードは 0 です。CI などで配置だけを検査し、欠落もエラーにする場合は次を使います。
60
63
 
61
- ```text
62
- exec/plans/<task-id>-plan.md
63
- exec/results/<task-id>-result.md
64
+ ```bash
65
+ specdojo exec validate --project <project-id> --records-only
64
66
  ```
65
67
 
66
- 対象:
68
+ 次の過去の世代の記録は、通常の検査でも `--records-only` でもエラー・警告にしません。
67
69
 
68
- | 操作 | 命名 |
69
- | ------------------------ | -------------------- |
70
- | `exec plan --task` | 固定名 plan |
71
- | `exec run --task` | 固定名 plan / result |
72
- | `exec claim` | 固定名 result |
73
- | `exec run --track-state` | 固定名 plan / result |
74
- | `exec run --worktree` | 固定名 plan / result |
70
+ - evidence 導入前: `plan.md` と `result.md` がそろい、`pipeline-state.json` と `evidence.json` がない run。
71
+ - 移行で plan・result を集約した先行試行: `pipeline-state.json` と `evidence.json` があり、plan・result が両方なく、同じ出どころ・項目の別 run に plan・result の対がある run。
72
+ - 旧配置: `execution/exec/plans/`・`results/`・`evidence/` 配下。evidence や対になる記録がなくても検査対象から外します。
75
73
 
76
- 同じ task の再生成や再実行では同じファイルを上書きします。過去内容は Git 履歴、完了の事実は event と commit 履歴で追跡します。
74
+ このほか `execution: human` を明記した result は単独で正常とします。それ以外で `plan.md`・`result.md`・`evidence.json` が欠けた run は、通常は警告、`--records-only` では `ERROR:` と終了コード 1 で報告します。生成直後の plan 単独や中断中の run も含みます。ログと checkpoint は実行段に応じた任意の記録で、退避した試行も同じ run に保持できます。
77
75
 
78
- ### 2.2. task identityなしの命名
76
+ run の外の plan・result・evidence・checkpoint・ログ、不正な出どころや深さは、上の例外を除き両モードでエラーにします。`exec/events/`・`exec/trials/`、規約の版、`grade/results/`・`grade/generated/`、job の状態、生成物、routine の失敗記録は独立した形式として検査から除きます。runtime lock は `git check-ignore` で確認し、追跡済みや無視されていない lock、Git で確認できない場合は両モードで終了コード 1 を返します。旧 `routines/.locks/` も設定された routine のディレクトリで検査しますが、ファイルのない lock のディレクトリは対象外です。
79
77
 
80
- `--deliverable <local_id>` や ad-hoc 実行では、task ID がないためユニーク名を使います。
78
+ 検査は記録を書き換えず、欠けたファイルも生成しません。CI で `--records-only` を使う場合は、実行が終了して記録がそろった revision を対象にしてください。
81
79
 
82
- ```text
83
- exec/plans/<stem>-plan.md
84
- exec/results/<stem>-result.md
80
+ 作業ツリーには中断中の run や空のディレクトリが残ることがあるため、push する前の確認は commit の tree を対象にします。`--commit <rev>` を付けると、`<rev>` の tree を一時ディレクトリへ書き出して同じ検査を流し、未 commit の記録は対象にしません。pre-push hook(`tools/check-run-record-layout-push.mjs`)は push する各 ref の先端 commit をこの形で検査し、CI の Check execution record layout と同じ欠落を push の前に止めます。
81
+
82
+ ```bash
83
+ specdojo exec validate --project <project-id> --records-only --commit <rev>
85
84
  ```
86
85
 
87
- `<stem>` は plan と result の連結キーです。同じ plan から実行する result は同じ `<stem>` を使います。
86
+ `exec run` と `exec cycle` の事前検証は `exec validate --schedule-only` で schedule・event だけを調べます。生成途中や中断中の run と、取得中の runtime lock があっても、実行・再開を妨げません。`--schedule-only` と `--records-only` は併用できません。
87
+
88
+ ## 2. 命名規則
89
+
90
+ ### 2.1. 出どころと項目 ID
91
+
92
+ | 出どころ | 項目 ID |
93
+ | ---------- | -------------------------- |
94
+ | `register` | 登録項目 ID(`PJR-XXXX`) |
95
+ | `schedule` | タスク ID(`T-...`) |
96
+ | `job` | job の実行 ID(`JBR-...`) |
97
+
98
+ review は元の項目の下の別 run とします。plan と result の文書 ID は frontmatter の `specdojo.id` を正本とし、ファイルの移動で変更しません。
99
+
100
+ ### 2.2. run ID
101
+
102
+ 新しい plan の生成では `<slug>-<UTC>-<rand>` のユニークな run ID を採番します。`<rand>` は4バイト(16進8桁)で、同一プロセス内で重複した場合は連番を加えます。job の attempt など、呼び出し側が run ID を指定する場合も同じ配置モジュールを通します。
103
+
104
+ plan と result のファイル名はそれぞれ `plan.md` と `result.md` です。同じ task の新しい実行は別 run に保存します。同一 run の再開では保存先を維持し、executor をやり直す前の state・evidence・ログを `*.attempt-N.*` に退避します。
105
+
106
+ state と evidence は元も残し、ログは退避先へ移します。退避した evidence の `log_refs` も退避先を指します。引き継ぐ evidence が参照するログは元の名前でも保持します。reporter からの再開では executor の試行を退避せず、evidence とログをそのまま使います。
88
107
 
89
- ### 2.3. stemの決定順序
108
+ ### 2.3. 既存記録の移行
90
109
 
91
- `<stem>` は次の優先順位で決まります。
110
+ `exec migrate-records` は検査を通すためには不要です。旧配置の記録を CLI の通常の探索で使う場合に移行します。移さない場合の制約は次のとおりです。
92
111
 
93
- 1. `--out <path>` または `--plan <path>` を指定した場合は、そのファイル名から導出します。
94
- 2. `--task <task-id>` がある場合は、`<stem> = <task-id>` とします。
95
- 3. task identity がない場合は、`<slug>-<UTC>-<rand>` のユニーク名を採番します。
112
+ - `exec run --register ... --resume` と schedule の executor 再開は、`runs/` 内の checkpoint を候補にするため旧 `exec/evidence/` の run を発見しません。schedule の通常実行・統合再開も、plan・result の通常の探索では旧配置を参照しません。保存済みイベントや checkpoint の明示的なパス参照を読む経路はありますが、旧配置を自動探索する互換機能ではありません。
113
+ - `dashboard build` の実行記録一覧と plan・result 件数には、旧配置の記録が含まれません。`exec archive` や task ID からの plan・result の取得も `runs/` のみを探索します。
114
+ - `register build` は個票とイベントから派生ビューを作り、旧記録の探索やリンクの移行はしません。個票にある既存リンクは元ファイルが残れば利用できますが、検査の成功によって補完・更新されることはありません。
96
115
 
97
- `<rand>` は4バイト(16進8桁)です。同じプロセス内で slug・UTC秒・乱数がすべて重複した場合は、`<rand>-1`、`<rand>-2` のように連番を加えます。plan path から stem を読む処理は stem 全体を連結キーとして扱うため、従来の16進4桁の名前と連番付きの名前をどちらも読み取れます。
116
+ 移行対象の run を完了または破棄し、対応する worktree を撤去してから、Git index に書き込める環境で移行します。プロセスを止めただけで worktree が残っている場合は、`--dry-run` でも項目 ID・worktree のパス・ブランチを示して処理前に停止します。進行中の run の移行と再開は対象外です。
98
117
 
99
- これにより、task 実行は固定名で扱い、schedule 非依存の実行は実行ごとの証跡を残せます。
118
+ ```bash
119
+ specdojo exec migrate-records --project <project-id> --dry-run
120
+ specdojo exec migrate-records --project <project-id>
121
+ ```
122
+
123
+ コマンドは移動先と参照の更新対象、対になる plan または result が欠けた記録を表示します。移動には `git mv` を使い、ログ本文と文書 ID を保持してパスの欄と旧形式の共通規約への相対参照を更新します。ルート相対パスの新形式は移動しても変更しません。移動先の衝突・追跡されていない移動元は処理前に拒否します。移行済みの状態で再実行すると移動は 0 件です。
124
+
125
+ checkpoint に同じ plan / result を参照する試行が複数ある場合、対は最新の checkpoint の run に置き、先行試行の evidence とログはそれぞれの run に残します。対応が特定できない記録は元の stem を run ID とし、欠けた記録を捏造しません。比較実験の `exec/trials/` は独立した保存形式のため移行対象から外します。通常の読み取りは `runs/` のみを対象にします。
100
126
 
101
127
  ### 2.4. deliverable指定の解決
102
128
 
@@ -141,16 +167,40 @@ plan の構造と生成規則は schema・本ガイド・各テンプレート
141
167
  | `mode: review` | `xrp-template.md` |
142
168
  | `approach` が指定済み | `xep-<approach>-template.md` |
143
169
 
170
+ 共通規約は `xp-common-conventions-template.md`(edit / review 共通)と、`mode` に対応する `xep-common-conventions-template.md`(edit 専用)または `xrp-common-conventions-template.md`(review 専用)を組み合わせます。接頭辞の `x` は exec、`p` は plan、`e` / `r` は edit / review を表します。各ファイルの `plan-essentials` マーカー間を plan の `_COMMON_CONVENTIONS_` 位置へ順に展開し、規約の詳細を読む案内には両ファイルのパスを載せます。マーカーのないローカル断片は全文を展開します。grade の plan はこれらの規約を使いません。
171
+
172
+ 保存する plan では、末尾に展開済みの共通規約を `` `共通規約 sha256:<内容のハッシュ>` `<リポジトリルートからのパス>` `` の形で記録します。パスは `docs/ja/projects/<project-id>/execution/conventions/<SHA-256>.txt` などで、Markdown リンクにはしません。規約本体は `<execution_path>/conventions/<SHA-256>.txt` に版ごとに一度だけ保存し、整形で内容が変わらないようプレーンテキストで保持します。版は mode・schema の解決後の本文(末尾の改行を含む)から計算します。規約本文の資源への参照はリポジトリ相対とし、別 checkout の同梱資源は package 内の相対パスにするため、端末の絶対パスで版が変わりません。agent と reporter へ渡す前に保存した版を復元するため、テンプレートの更新後や再開時も当時の規約が届きます。`exec run --plan` と `agent run --plan` も同じ読み取りを使います。参照先が欠けている場合やハッシュが一致しない場合は、版とパスを示すエラーで停止します。規約を埋め込んだ既存 plan と、末尾に `[共通規約 sha256:<内容のハッシュ>](<plan からの相対パス>)` を持つ旧形式もそのまま読めます。復元するのは末尾の独立した段落の参照だけで、個票から転記した本文やコードブロックの例は読み取りません。plan に指示を追記するときは、この参照より前に置いてください。別 checkout で使うときは規約ファイルも同じルート相対パスに引き継ぎます。旧形式の plan を移す場合は、plan からの相対参照を維持してください。
173
+
144
174
  `execution: human` のタスクに `exec plan` を実行するとエラーになります。human の確定手順は [Human Finalize 実行レシピ](../recipes/exec-human-finalize-recipe.md)、共通規約は [Human Finalize 実行標準](../standards/exec-human-finalize-standard.md)を正本とし、human result から参照します。
145
175
 
146
- `approach` が指定されていれば `xep-fully-guided-template.md`、`xep-recipe-guided-template.md`、`xep-freeform-template.md`、`xep-retrofit-template.md`、`xep-rulebook-maintenance-template.md` のような approach 別テンプレートを優先します。該当テンプレートが存在しない場合は標準テンプレートにフォールバックします。
176
+ `approach` が指定されていれば `xep-fully-guided-template.md`、`xep-condense-template.md`、`xep-recipe-guided-template.md`、`xep-freeform-template.md`、`xep-retrofit-template.md`、`xep-rulebook-maintenance-template.md` のような approach 別テンプレートを優先します。該当テンプレートが存在しない場合は標準テンプレートにフォールバックします。
147
177
 
148
178
  register のカタログなしの成果物 plan は、個票の `target_path`・`target_rulebook` または既存文書の索引と frontmatter から対象を解決します。カタログの `done_criteria` がないことを明記し、個票の完了条件と rulebook を使います。`bootstrap` は未作成 kata の ID・パスと参照宣言の指示、`finalize`・`bootstrap-finalize` は既存成果物の確認チェック表と確定対象を plan に載せます。実 agent は `status: ready` への昇格を行いません。対象と起票の条件は [[specdojo:command-reference]] を参照してください。
149
179
 
150
180
  `approach: retrofit` では、対象成果物の DCT エントリに宣言された `evidence_refs` を edit / review plan の「実装エビデンス」へ展開します。カタログ経由で `evidence_refs` がない場合は plan 生成をエラーにします。カタログなしでは実装の調査パスを個票に明記して調査入力とします。実装エビデンスは調査入力であり、frontmatter の `targets` には追加しません。実行者は実際に参照したパス、抽出した現在動作、成果物との一致・乖離、未確認範囲を result に記録します。
151
181
 
182
+ `draft`・`fully-guided`・`recipe-guided` の edit plan にも `evidence_refs` を読み取り専用で展開します。未指定・カタログなしでは「なし」と示し、生成を拒否しません。これらの plan の `depends_on` は、既存文書を wikilink、未作成文書をインラインコードと「未作成」で表示します。未作成の依存の内容は推測せず _TODO_ / _ASSUMPTION_ として残し、存在しないことだけを理由に実行を止めません。`condense` など他 approach と review の plan は従来のままです。
183
+
152
184
  実践の型の扱いは [実践の進め方ガイド](ryu-guide.md) を参照します。
153
185
 
186
+ ### condense の記録
187
+
188
+ `condense` は既存の 1 文書を対象とする edit で、標準フローでは磨き込みの後・review の前に置きます。plan は `xep-condense-template.md`、result は `xer-condense-template.md` を使います。判定基準は [[specdojo:pm-review-viewpoints]] の `vp-arc-conciseness` とし、判断に要る背景・制約・例外・完了条件と意味を維持します。
189
+
190
+ result の `specdojo.condense_records` は修正・保持の記録のリストです。候補がなければ `[]` とし、変更不要の理由を本文へ書きます。各要素は次の 5 項目を持ち、本文の「修正・保持の記録」の表と 1 対 1 に対応します。
191
+
192
+ | 項目 | 内容 |
193
+ | ---------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- |
194
+ | `location` | 修正前の成果物の見出し・行・引用 |
195
+ | `category` | `repetition`(繰り返し)、`table-prose`(表と本文)、`figure-prose`(図をなぞる文)、`unneeded-background`(不要な背景)、`canonical-restatement`(正本の再掲) |
196
+ | `action` | `delete`(削る)、`merge`(まとめる)、`reference`(参照)、`retain`(残す) |
197
+ | `reason` | 意味を保った根拠、または残した理由 |
198
+ | `cause` | `FindingCause`: `{"type":"document"}`、または `{"type":"kata","kind":"recipe","location":"根拠の箇所"}`。`kind` は rulebook / recipe / sample / template |
199
+
200
+ Kata が原因とするのは、宣言された Kata の箇所を示せる場合だけです。schema は `condense-records.schema.yaml` から共通の `finding-cause.schema.yaml` を参照します。pipeline executor は最終 evidence に `condense_records` を出し、runner が検証済みの同じリストを frontmatter と表へ転記します。reporter の要約によって省略・変更しません。executor が `condense_records` を出さない、または形式が正しくない場合は、reporter を起動せず executor の段の失敗として止めます([[specdojo:exec-config-guide]] の executor の報告の説明を参照)。通常の識別項目は scaffold と照合し、`condense_records` は記録用の可変項目として検証します。完了・block などの状態更新後も記録を保持します。
201
+
202
+ Kata の手入れ plan は成果物ごとの最新の完了済み `condense` result から Kata が原因の記録を展開します。成果物が宣言する rulebook から辿れる対象 Kata と原因の種類が一致する記録に限り、grade 由来とは出どころを区別します。
203
+
154
204
  ### 3.3. resultテンプレート
155
205
 
156
206
  result は実行記録です。agent では plan と対になり、human では作業指示も兼ねます。`claim` または `exec run` が scaffold 生成します。
@@ -172,7 +222,7 @@ result の `status` は、個々の実行試行がどの状態にあるかを表
172
222
  | `blocked` | 障害や未充足条件によって停止した試行 | 理由を解消して再開または再実行する |
173
223
  | `superseded` | 後続の新しい run に置き換えられ、破棄された先行の試行 | なし。履歴として保持し、再開対象にしない |
174
224
 
175
- runner は一意名の新しい result を scaffold するとき、同じ `task_id` を持つ先行 result のうち `in_progress` または `blocked` のものを `superseded` へ更新します。`completed_at` には後続 run の開始時刻を記録し、先行 result の `block_reason` は除去します。`complete` の result は完了記録として変更しません。固定名 result の再利用や、同じ run を続ける `exec resume` は新しい result を作らないため、この遷移の対象外です。
225
+ runner は一意名の新しい result を scaffold するとき、同じ `task_id` を持つ先行 result のうち `in_progress` または `blocked` のものを `superseded` へ更新します。`completed_at` には後続 run の開始時刻を記録し、先行 result の `block_reason` は除去します。`complete` の result は完了記録として変更しません。同じ run を続ける `exec resume` は新しい result を作らないため、この遷移の対象外です。
176
226
 
177
227
  `exec status` が表示・集計する Schedule の `doing` / `blocked` などは event log から導出するタスク状態であり、result の status とは別です。このため、履歴上の `superseded` result が実行中件数や対応待ちの blocked 件数へ加算されることはありません。
178
228
 
@@ -190,30 +240,17 @@ worktree を再利用する `exec resume` では、再開直前の worktree resu
190
240
 
191
241
  ### 4.1. アーカイブ
192
242
 
193
- 完了後の plan は `exec/plans/done/` へ移動できます。
243
+ `exec archive` は完了した plan を同じ run ディレクトリに保持します。`exec complete`、`exec run --track-state` の成功時、`--archive-on-success` でも保存先は変わりません。
194
244
 
195
245
  ```bash
196
246
  specdojo exec archive --project <project-id> --task <task-id>
197
247
  ```
198
248
 
199
- | ケース | アーカイブ |
200
- | ------------------------------- | --------------------------------- |
201
- | `exec complete` | 対象 plan を自動移動する |
202
- | `exec run --track-state` 成功時 | 対象 plan を自動移動する |
203
- | 軽量実行(状態追跡なし) | `exec archive` で明示的に移動する |
204
- | `exec run --archive-on-success` | 成功時に移動する |
205
-
206
- 固定名 plan を `done/` へ移動する場合は、UTC タイムスタンプと4バイトの乱数を付けます。同じ名前が既にある場合は、既存ファイルを上書きせず末尾に連番を加えます。
207
-
208
- ```text
209
- exec/plans/done/<slug>-<UTC>-<rand>[-<sequence>]-plan.md
210
- ```
211
-
212
- 不要な plan は `done/` へ移動せず削除してもかまいません。plan は catalog と schedule から再生成でき、result が記録として残るためです。
249
+ 不要な plan は `--delete` で削除できます。result は実行記録として残ります。
213
250
 
214
251
  ### 4.2. 再実行
215
252
 
216
- 完了済み task を軽くやり直す場合は、固定名 plan / result を再生成してカレントリポジトリで実行します。
253
+ 完了済み task をやり直す場合は、新しい run の plan / result を生成してカレントリポジトリで実行します。
217
254
 
218
255
  ```bash
219
256
  specdojo exec run --project <project-id> --task <task-id>
@@ -229,4 +266,4 @@ specdojo exec run --project <project-id> --task <task-id>
229
266
  specdojo exec complete --project <project-id> --task <task-id> --by <actor> --msg "rerun done"
230
267
  ```
231
268
 
232
- `reopen` は完了済み plan を `done/` から戻さず、固定名 result の内容も変更しません。次の `exec plan` / `exec run` で新しい固定名 plan を生成し、再 claim 時に既存 result の `status` を `in_progress`、`started_at` と `agent` を新しい試行の値へ更新し、`completed_at` と `block_reason` を除去します。result 本文は前回の記録を引き継ぎ、過去の完了状態は Git 履歴と `complete` / `reopen` event で追跡します。
269
+ `reopen` は過去 run の plan / result を変更しません。次の `exec plan` / `exec run` は新しい run を作り、過去の完了状態は保存した記録と `complete` / `reopen` event で追跡します。同じ run の続きは `exec resume` で再開します。