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
@@ -115,7 +115,9 @@ exec の result の commit 前検査は markdownlint-cli が読む利用リポ
115
115
  `.markdownlintrc` を含む)を優先し、設定がなければ上記の6規則だけをコマンド引数で無効にします。
116
116
  フォールバック用ファイルは利用リポジトリに作りません。CLI2 専用設定はこの検査では読みません。
117
117
 
118
- `package.json` がある場合、provider ごとのオーケストレーター起動スクリプトも追加します。Claude Code は `orch:opus`・`orch:sonnet`、Codex は `orch:sol`(`gpt-6.1-sol`)・`orch:luna`(`gpt-6-luna`)、Antigravity は `orch:flash`(`gemini-3.8-flash-high`)、OpenCode は `orch:opencode` です。既存のスクリプトは `--force` を付けても上書きしません。
118
+ `package.json` がある場合、provider ごとのオーケストレーター起動スクリプトも追加します。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` です。既存のスクリプトは `--force` を付けても上書きしません。
119
+
120
+ agy 1.4.12 以降向けの通常導入は edit / review / report / orchestrator のセッション別プロファイルを配置し、ユーザー設定を書き換えません。非対話用 command template は `specdojo agent launch --provider antigravity --role {mode} -- --sandbox --model {model} -p "$(cat)"`、対話型は `specdojo orchestrator launch --provider antigravity -- <agy 引数>` を使います。各入口が宣言済みルートの保護ルールを一つの `--settings` JSON として渡します。`agent launch` は runner の `SPECDOJO_REPO_*` に示された task worktree と cwd だけを追加し、任意の `--add-dir` や別 `--settings`、bypass、既存会話の再開を拒否します。review / report は全書き込み・command・MCP を拒否します。詳しい移行と実機確認は [[sysd-antigravity-agent-settings|Antigravity CLI エージェント設定]] を参照してください。
119
121
 
120
122
  `antigravity` に限り `--global` を指定すると、`~/.gemini/antigravity-cli/settings.json` へ SpecDojo 用の permission rule を追記します。既存キー・既存 rule は保持し、実書き込み前に timestamp 付きバックアップを作ります。`--global` を省略した通常実行はユーザーディレクトリへ触れません。適用前は次の dry-run で追加 rule を確認してください。
121
123
 
@@ -420,7 +422,7 @@ Schedule設計の詳細は [Schedule設計ガイド](../guides/schedule-design-g
420
422
 
421
423
  ### 4.1. schedule strategy(決定論的な strategy 生成)
422
424
 
423
- `schedule strategy generate` は、DCT、Timeline、strategy の `approach_rules`、Kata の保存済み grade、標準 strategy profile から `sch-strategy-<track>.yaml` を生成します。先に strategy へ scope と成果物別 intent を宣言してください。
425
+ `schedule strategy generate` は、DCT、epic、strategy の `approach_rules`、Kata の保存済み grade、標準 strategy profile から `sch-strategy-<track>.yaml` を生成します。範囲は既存 strategy の scope、対象 track の epic の `domains`、互換用 `tml-index.yaml` の順に解決します。先に strategy へ scope と成果物別 intent を宣言してください。
424
426
 
425
427
  ```bash
426
428
  specdojo schedule strategy generate \
@@ -454,32 +456,17 @@ specdojo schedule strategy generate \
454
456
 
455
457
  書き込み前に intent の網羅・重複、追加パラメータ、都度収集した facts、必要な grade、scope で選択した全 `kind: work` の網羅、`scope.catalogs[].local_ids` の実在、strategy schema、project ID、参照、milestone ID 重複、`schedule build --dry-run` 相当を検証します。catalog の `local_ids` を省略した場合は従来どおり対象 kind の全成果物、指定した場合はその部分集合だけを生成します。不足時は暫定値で進めず停止します。既存 strategy は `--force` なしで保護し、同一内容の再生成は `Unchanged` として書き込みません。生成後は `schedule build --track <track> --force`、`exec refresh` の順に既存コマンドを実行します。
456
458
 
457
- ## 5. timeline
458
-
459
- `timeline` は、人間が着手前に決めた `tml-index.yaml`(トラック順序計画)から、着手順序と成果物カタログ作成の準備情報を生成します。`tml-index.yaml` が正本で、生成物は `timeline/generated/` へ出力する一方通行の流れです。
460
-
461
- | コマンド | 用途 | 例 |
462
- | ---------------- | ------------------------------------------------------- | -------------------------------------------- |
463
- | `timeline build` | `tml-index.yaml` から着手順序と scaffold 対象を生成する | `specdojo timeline build --project prj-0001` |
464
- | `timeline where` | timeline 関連パスを表示する | `specdojo timeline where --project prj-0001` |
465
-
466
- 主要オプション:
467
-
468
- | オプション | 用途 |
469
- | ----------- | ---------------------------------------- |
470
- | `--dry-run` | 生成内容を標準出力へ表示し、書き込まない |
459
+ ## 5. timeline(非推奨)
471
460
 
472
- 生成物は次の3つです。
461
+ `tml-index.yaml`・`timeline build`・`timeline_path` は非推奨です。全体計画は epic で管理し、`dashboard build` で `execution/generated/` に表とガント、未作成カタログを生成します。epic のない track は全体計画に出しません。期間と範囲の扱いは [[specdojo:register-operation-guide|登録簿運用ガイド]]、移行手順は [[specdojo:timeline-design-guide|Timeline からの移行ガイド]] を参照してください。
473
462
 
474
- | ファイル | 内容 |
475
- | --------------------- | ------------------------------------------------------------------------ |
476
- | `timeline-order.md` | `order` / `parallel_group` / `depends_on` から算出した着手 wave 一覧 |
477
- | `catalog-scaffold.md` | `dct-<domain>.yaml` が未作成のドメインと `catalog scaffold` 実行コマンド |
478
- | `timeline.json` | 後続コマンドが読む機械可読サマリー |
463
+ | コマンド | 用途 | 例 |
464
+ | ----------------- | ------------------------------------------------ | --------------------------------------------- |
465
+ | `dashboard build` | epic に基づく全体計画を含む dashboard を生成する | `specdojo dashboard build --project prj-0001` |
466
+ | `timeline build` | 警告付きで旧形式の計画を生成する | `specdojo timeline build --project prj-0001` |
467
+ | `timeline where` | 互換用 timeline の関連パスを表示する | `specdojo timeline where --project prj-0001` |
479
468
 
480
- `depends_on` の未定義参照・循環、`depends_on` と `order` の矛盾、track id の重複を検出した場合は、生成物を書き込まずに終了コード 1 で停止します。`catalog_status` と実カタログの有無が食い違う場合は警告のみを出します。`project_register_path` がある場合、`catalog-planning` の todo を domain ごとに読み、`done` が一件でもあればその domain を `primary`、着手中(`in-progress` / `waiting` / `review`)なら `draft`、`open` だけなら `not_started` と導きます。`rejected` / `deferred` は導出から除外します。対象 todo がない domain は従来の手書き値を使います。複数 domain の track は全 domain が `primary` なら着手可能とし、一部だけ進んでいれば `draft` とします。手書きの値との差は警告し、`tml-index.yaml` は変更しません。todo を reopen した場合も次回 build で再計算します。`timeline.json` の `track_catalog_status` は導出後の track 別状態です。strategy 生成も同じ導出を使います。カタログの突き合わせはファイル名ではなく各 `dct-*.yaml` の `domain` 値で行うため、1 ドメインが複数ファイルに分割されていても検出できます。
481
-
482
- `timeline_path` は未設定の場合、プロジェクト直下の `timeline` を既定とします。記述ルールは [タイムライン作成ルール](../rulebooks/tml-rulebook.md)、生成フローと運用タイミングは [Timeline設計ガイド](../guides/timeline-design-guide.md)、トラックの標準構成と実行順序は [トラック設計ガイド](../guides/track-design-guide.md) を参照します。
469
+ 旧 `timeline build` は `--dry-run` で書き込まずに検証できます。epic の順序と範囲を反映しつつ、既存の strategy と `timeline_path`(既定 `timeline`)の `tml-index.yaml` を互換用に読み、`timeline/generated/` に `timeline-order.md`・`catalog-scaffold.md`・`timeline.json` を出力します。track 重複、依存の未定義参照・循環、`order` との矛盾はエラーです。`catalog-planning` の todo から作成状況を導出し、手書きの状態との不一致は警告します。epic のない project の dashboard は旧 timeline 表示を維持します。
483
470
 
484
471
  ## 6. register
485
472
 
@@ -510,6 +497,8 @@ specdojo schedule strategy generate \
510
497
  | ---------------------------- | ------------------------------------------------------------------- | ------------------------------------------------ |
511
498
  | `--input <text>` | 個票の前提を記録(繰り返し可、update は一覧置換、`-` 単独で全削除) | `add` / `update` |
512
499
  | `--track <track>` | epic が担う track(epic で必須、update で置換、削除不可) | `add` / `update` |
500
+ | `--domain <domain>` | epic の対象 domain(反復指定、update は一覧置換、`-` 単独で削除) | `add` / `update` |
501
+ | `--start-on <YYYY-MM-DD>` | epic の予定開始日(実在する暦日、`-` で省略・削除) | `add` / `update` |
513
502
  | `--to <PJR-ID>` | 移動先の PJR-ID を指定する | `renumber` |
514
503
  | `--registered <datetime>` | 起票日時(タイムゾーン付き RFC 3339)。省略時は実行時刻 | `add` |
515
504
  | `--completed <datetime>` | 完了・却下日時(タイムゾーン付き RFC 3339)。省略時は実行時刻 | `close` / `reject` |
@@ -537,6 +526,8 @@ specdojo schedule strategy generate \
537
526
 
538
527
  `register add` は個票 Frontmatter の `registered_at`(起票日時)を、`register close` / `register reject` は `completed_at`(完了・却下日時)を自動記入します。値は UTC の RFC 3339・秒精度(例: `2026-08-09T14:08:51Z`)で、OS / コンテナの `TZ` 環境変数には依存しません。`register reopen` は `completed_at` を削除します。
539
528
 
529
+ `--start-on` は epic の `start_on` に予定開始日を記録します。epic 以外への指定や不正な日付は記帳前に拒否します。`update` で未指定なら保持し、`-` で削除します。`start_on` が `due_on` より後でも記録は保持しますが、`register build` は警告し、全体計画の期間を未定として扱います。開始日の優先順位は [[specdojo:register-operation-guide|登録簿運用ガイド]] を参照してください。
530
+
540
531
  `register` の `--by` は、project の `pm-members.yaml` にある人の nickname、`.specdojo/agent-members.yaml` にある agent の nickname または alias、予約 actor の `SpecDojo`・`specdojo-orchestrator`・`night-orchestrator` だけを受け付けます。agent alias は実体名で event に記録し、未知の値は書き込み前に拒否します。省略時は `SpecDojo` です。決定・承認では `PO` などの Role code や予約 actor ではなく、本人の nickname を指定します。
541
532
 
542
533
  `--input <text>` は、対話で得た前提・制約・委任範囲を個票本文の `入力` 節へ指定順に記録します。`update` で未指定なら保持し、指定すれば一覧を置換します。追記するときは既存分も含めて再指定し、`--input -` 単独で全削除します。add での `-`、空文字、削除と他の値の混在は拒否します。既存個票に節がなければ更新時に追加します。event の `input` は変更前後の JSON 配列を保持し、空は `-` で表します。register から生成する plan は approach の有無によらず、入力がある場合だけ完了条件とは別の「個票の入力(前提)」へ載せます。
@@ -549,7 +540,14 @@ specdojo schedule strategy generate \
549
540
 
550
541
  `sample-maintenance` は `type` を見ず、対象 `id` の末尾が `-sample` かどうかで判定します。利用者の authority の sample も同じ規則です。recipe・template・rulebook の maintenance は従来どおり `type` の一致を検証します。sample の `type` の規約は [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] を参照してください。
551
542
 
552
- カタログなしで使える成果物の approach は `fully-guided`・`recipe-guided`・`freeform`・`retrofit`・`bootstrap`・`finalize`・`bootstrap-finalize` です。`cross-deliverable-dedup` はカタログが必要です。
543
+ カタログなしで使える成果物の approach は `fully-guided`・`condense`・`recipe-guided`・`freeform`・`retrofit`・`bootstrap`・`finalize`・`bootstrap-finalize` です。`cross-deliverable-dedup` はカタログが必要です。
544
+
545
+ `condense` は既存成果物 1 件の冗長さを直す edit です。カタログなしでも索引と `specdojo.rulebook` から解決できます。未作成の文書は指定できません。記録形式と Kata の手入れへの振り分けは [[specdojo:plan-result-lifecycle-guide]] を参照してください。
546
+
547
+ ```bash
548
+ specdojo register add --project prj-0001 --type todo --title "概要の冗長さを整理" --owner ARC --approach condense --target prj-0001:prj-overview
549
+ specdojo exec run --project prj-0001 --register <PJR-ID> --worktree
550
+ ```
553
551
 
554
552
  - 新規文書には `--target-path <リポジトリ相対パス>` と `--target-rulebook <rulebook-id>` を指定します。個票の `target_path` と `target_rulebook` に保存されます。既存文書は `--target` の ID を索引で引き、パスと `specdojo.rulebook` を使います。明示指定と既存文書が矛盾した場合は停止します。
555
553
  - パスはリポジトリ外、外を指すシンボリックリンク、別の ID を持つ既存ファイルを受け付けません。更新時も同じ検証を行い、`--target-path -`・`--target-rulebook -` で各指定を削除できます。
@@ -559,7 +557,7 @@ specdojo schedule strategy generate \
559
557
  - カタログなしの plan は、カタログの `done_criteria` がないことを明示し、個票の完了条件と rulebook を使います。`retrofit` の実装調査入力は個票にパスを明記します。
560
558
  - カタログ設定済みで対象が未登録の場合、パスと rulebook を両方明示した場合だけカタログなしと同じ解決を使います。未指定なら従来のエラーで停止します。カタログにある対象ではカタログの宣言を優先します。
561
559
 
562
- `register add --type epic --track <track>` は track ごとの仕事を起票します。type は `epic` / `todo` / `question` / `risk` / `issue` / `change-request` / `decision` / `note` です。epic は todo と同じ状態を使い、通常終端は `done`、例外終端は `rejected` / `deferred` です。track は Frontmatter の `track` に保存し、`update --track` で置換します。英小文字・数字・ハイフン(先頭は英小文字か数字)の識別子が必須で、削除やほかの type への指定は拒否します。project の `timeline_path`(既定 `timeline`)に `tml-index.yaml` があるときは、add・update・build で track の定義を検証します。子 todo は `register add --type todo --from <epic-id>` で関連付けます。`register build` は `generated/pjr-epic-items.md` に epic ごとの直接の子項目と状態を表示し、別 project の子を project 修飾 ID で識別します。子のない epic も表示し、孫の再帰表示や epic の自動 close は行いません。完了は子項目と schedule を材料に人が判断します。
560
+ `register add --type epic --track <track>` は track ごとの仕事を起票します。type は `epic` / `todo` / `question` / `risk` / `issue` / `change-request` / `decision` / `note` です。epic は todo と同じ状態を使い、通常終端は `done`、例外終端は `rejected` / `deferred` です。track は Frontmatter の `track` に保存し、`update --track` で置換します。英小文字・数字・ハイフン(先頭は英小文字か数字)の識別子が必須で、削除やほかの type への指定は拒否します。旧 timeline への登録は不要です。add・update・build は epic どうしの track 重複を拒否し、build は依存循環も検出します。任意の `domains` は反復可能な `--domain` で指定し、ほかの type への指定は拒否します。子 todo は `register add --type todo --from <epic-id>` で関連付けます。`register build` は `generated/pjr-epic-items.md` に epic ごとの直接の子項目と状態を表示し、別 project の子を project 修飾 ID で識別します。子のない epic も表示し、孫の再帰表示や epic の自動 close は行いません。完了は子項目と schedule を材料に人が判断します。
563
561
 
564
562
  `item_type: note` は `open` のまま更新する記録です。`register close` / `register reject` / `register defer` は終了コード 1 で拒否し、対応・回答・判断が必要な場合は `todo` / `question` / `decision` など目的に合う別の `item_type` で起票するよう案内します。本文の追記や修正には `register update` を使用できます。
565
563
 
@@ -585,7 +583,7 @@ specdojo register add --project prj-0001 --type todo --from PJR-AB12 \
585
583
  ```
586
584
 
587
585
  - `catalog-planning`: `catalog_path` が必要です。plan は既存カタログと DCT の kata・domain ごとの template を参照し、`catalog plan prompt` に沿った agent の判定、`catalog plan scaffold --from`、`catalog plan validate`、`catalog scaffold --plan`、`catalog validate` を完了条件として展開します。上流資料が不足する場合は `--input` で明示し、未確定事項を推測で補いません。
588
- - `strategy-planning`: `catalog_path` と `schedule_path` が必要です。timeline がある場合は定義済み track に限定します。timeline がない場合は strategy の明示 scope を使います。plan は既存カタログと Schedule の kata を参照し、`sch-strategy-<track>.yaml` の `scope.catalogs`・`approach_rules` の intent・担当の宣言、`schedule strategy generate`、`schedule build --track` の成功を完了条件として展開します。
586
+ - `strategy-planning`: `catalog_path` と `schedule_path` が必要です。対象 track を担う epic が必要です。範囲は既存 strategy の scope、epic の `domains`、互換用 timeline の順に解決します。plan は既存カタログと Schedule の kata を参照し、`sch-strategy-<track>.yaml` の `scope.catalogs`・`approach_rules` の intent・担当の宣言、`schedule strategy generate`、`schedule build --track` の成功を完了条件として展開します。
589
587
  - 対象はそれぞれ `domain:<id>` / `track:<id>` の 1 件です。ID は英小文字・数字・ハイフン、先頭は英小文字または数字、最大 63 文字です。個票の追加完了条件も plan に取り込みます。両 approach を schedule の成果物タスクへ指定することはできません。
590
588
 
591
589
  `register add --approach <approach> --target <doc-id>` は、個票 Frontmatter に進め方と対象を書きます。成果物を作成・修正する進め方は成果物カタログにある文書を、`rulebook-maintenance` などの保守の進め方は名前に対応する kata 種別を対象にし、対象は 1 件だけです。`rulebook-authoring` / `recipe-authoring` / `sample-authoring` / `template-authoring` は `--target` に新しい kata ID、繰り返し可能な `--source` に手本を指定し、個票 Frontmatter の `sources` へ保存します。
@@ -618,32 +616,38 @@ kata authoring は register 専用です。Schedule の task は対象成果物
618
616
 
619
617
  `exec` は schedule に基づいたタスクの実行、状態追跡、plan/result 生成、worktree 隔離実行を扱います。
620
618
 
621
- | コマンド | 用途 | 例 |
622
- | ---------------- | ------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------- |
623
- | `exec where` | execution 関連パスを表示する | `specdojo exec where --project prj-0001` |
624
- | `exec validate` | schedule と event を検証する | `specdojo exec validate --project prj-0001` |
625
- | `exec refresh` | state、Ready、CPM、gantt-chart を再計算する | `specdojo exec refresh --project prj-0001` |
626
- | `exec scheduler` | 次のタスクを自動選択して claim する(`--dry-run` で選択のみ) | `specdojo exec scheduler --project prj-0001 --by agent-1` |
627
- | `exec claim` | タスクを `doing` にする | `specdojo exec claim --project prj-0001 --task <task-id> --by agent-1` |
628
- | `exec complete` | タスクを `done` にする(actor の `doing` が1件なら `--task` 省略可) | `specdojo exec complete --project prj-0001 --by agent-1` |
629
- | `exec reopen` | 誤って完了したタスクを `done` から `todo` に戻す | `specdojo exec reopen --project prj-0001 --task <task-id> --by indie --msg "completion criteria unmet"` |
630
- | `exec block` | タスクを `blocked` にする | `specdojo exec block --project prj-0001 --task <task-id> --by agent-1 --msg "waiting"` |
631
- | `exec unblock` | `blocked` を `doing` に戻す | `specdojo exec unblock --project prj-0001 --task <task-id> --by agent-1 --msg "resume"` |
632
- | `exec release` | `doing` / `blocked` を `todo` に戻す | `specdojo exec release --project prj-0001 --task <task-id> --by agent-1` |
633
- | `exec cancel` | `todo` を `cancelled` にする | `specdojo exec cancel --project prj-0001 --task <task-id> --by agent-1 --msg "scope removed"` |
634
- | `exec note` | メモイベントを残す | `specdojo exec note --project prj-0001 --task <task-id> --by agent-1 --msg "memo"` |
635
- | `exec link` | 外部参照イベントを残す | `specdojo exec link --project prj-0001 --task <task-id> --by agent-1 --ref pr=https://example.com/pr/1` |
636
- | `exec estimate` | 見積もりイベントを残す | `specdojo exec estimate --project prj-0001 --task <task-id> --by agent-1 --meta duration_days=1` |
637
- | `exec run` | plan を生成してエージェントを実行する | `specdojo exec run --project prj-0001 --task <task-id>` |
638
- | `exec handoff` | block された保護設定の提案差分を確認し、統合先へ適用して commit する | `specdojo exec handoff apply --project prj-0001 --register PJR-0012` |
639
- | `exec resume` | `doing`、または due な利用制限延期 task を既存 worktree で再開する | `specdojo exec resume --project prj-0001 --due` |
640
- | `exec cycle` | 延期 task 再開・doc-index 再構築・古い track の再生成・状態再計算・`--auto` loop を単一ロック内で順次実行する | `specdojo exec cycle --project prj-0001 --loop` |
641
- | `exec slots` | 同じ project の exec run が共有する枠(`--join`・provider・親検証など)の上限と使用数を表示する | `specdojo exec slots --project prj-0001` |
642
- | `exec trial` | 同一planを複数agentで隔離試行し、比較・評価・採否を管理する | `specdojo exec trial run --project prj-0001 --plan <path> --agent agent-a agent-b` |
643
- | `exec status` | 実行状態を表示する | `specdojo exec status --project prj-0001 --state blocked` |
644
- | `exec scaffold` | 共通レビュー観点を継承するプロジェクト差分を生成する | `specdojo exec scaffold --project prj-0001` |
645
- | `exec plan` | plan だけを生成する | `specdojo exec plan --project prj-0001 --task <task-id>` |
646
- | `exec archive` | 完了済み plan を `done/` へ移動する | `specdojo exec archive --project prj-0001 --task <task-id>` |
619
+ | コマンド | 用途 | 例 |
620
+ | ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------- |
621
+ | `exec where` | execution 関連パスを表示する | `specdojo exec where --project prj-0001` |
622
+ | `exec validate` | schedule・event・実行記録の配置と lock の Git 除外を検証する(`--records-only` は配置のみ、`--schedule-only` は schedule・event のみ。併用不可) | `specdojo exec validate --project prj-0001` |
623
+ | `exec refresh` | state、Ready、CPM、gantt-chart を再計算する | `specdojo exec refresh --project prj-0001` |
624
+ | `exec scheduler` | 次のタスクを自動選択して claim する(`--dry-run` で選択のみ) | `specdojo exec scheduler --project prj-0001 --by agent-1` |
625
+ | `exec claim` | タスクを `doing` にする | `specdojo exec claim --project prj-0001 --task <task-id> --by agent-1` |
626
+ | `exec complete` | タスクを `done` にする(actor の `doing` が1件なら `--task` 省略可) | `specdojo exec complete --project prj-0001 --by agent-1` |
627
+ | `exec reopen` | 誤って完了したタスクを `done` から `todo` に戻す | `specdojo exec reopen --project prj-0001 --task <task-id> --by indie --msg "completion criteria unmet"` |
628
+ | `exec block` | タスクを `blocked` にする | `specdojo exec block --project prj-0001 --task <task-id> --by agent-1 --msg "waiting"` |
629
+ | `exec unblock` | `blocked` を `doing` に戻す | `specdojo exec unblock --project prj-0001 --task <task-id> --by agent-1 --msg "resume"` |
630
+ | `exec release` | `doing` / `blocked` を `todo` に戻す | `specdojo exec release --project prj-0001 --task <task-id> --by agent-1` |
631
+ | `exec cancel` | `todo` を `cancelled` にする | `specdojo exec cancel --project prj-0001 --task <task-id> --by agent-1 --msg "scope removed"` |
632
+ | `exec note` | メモイベントを残す | `specdojo exec note --project prj-0001 --task <task-id> --by agent-1 --msg "memo"` |
633
+ | `exec link` | 外部参照イベントを残す | `specdojo exec link --project prj-0001 --task <task-id> --by agent-1 --ref pr=https://example.com/pr/1` |
634
+ | `exec estimate` | 見積もりイベントを残す | `specdojo exec estimate --project prj-0001 --task <task-id> --by agent-1 --meta duration_days=1` |
635
+ | `exec run` | plan を生成してエージェントを実行する | `specdojo exec run --project prj-0001 --task <task-id>` |
636
+ | `exec handoff` | block された保護設定の提案差分を確認し、統合先へ適用して commit する | `specdojo exec handoff apply --project prj-0001 --register PJR-0012` |
637
+ | `exec resume` | `doing`、または due な利用制限延期 task を既存 worktree で再開する | `specdojo exec resume --project prj-0001 --due` |
638
+ | `exec cycle` | 延期 task 再開・doc-index 再構築・古い track の再生成・状態再計算・`--auto` loop を単一ロック内で順次実行する | `specdojo exec cycle --project prj-0001 --loop` |
639
+ | `exec slots` | 同じ project の exec run が共有する枠(`--join`・provider・親検証など)の上限と使用数を表示する | `specdojo exec slots --project prj-0001` |
640
+ | `exec trial` | 同一planを複数agentで隔離試行し、比較・評価・採否を管理する | `specdojo exec trial run --project prj-0001 --plan <path> --agent agent-a agent-b` |
641
+ | `exec status` | 実行状態を表示する | `specdojo exec status --project prj-0001 --state blocked` |
642
+ | `exec scaffold` | 共通レビュー観点を継承するプロジェクト差分を生成する | `specdojo exec scaffold --project prj-0001` |
643
+ | `exec plan` | plan だけを生成する | `specdojo exec plan --project prj-0001 --task <task-id>` |
644
+ | `exec archive` | 完了済み plan を同じ run に保持する | `specdojo exec archive --project prj-0001 --task <task-id>` |
645
+
646
+ `exec validate` は、一部だけの run 記録を通常は `WARN:` で報告し、欠落だけなら終了コード 0 を返します。`--records-only` は同じ欠落を `ERROR:` と終了コード 1 にします。両モードとも、plan・result がそろい state・evidence のない evidence 導入前の run、state・evidence のみがあり同じ出どころ・項目の別 run に plan・result の対がある移行後の先行試行、旧 `exec/plans/`・`results/`・`evidence/` の記録はエラー・警告にしません。`execution/grade/generated/` と空の lock のディレクトリも配置の検査から外します。これら以外の配置違反、Git に無視されない lock、Git 確認失敗は通常時もエラーです。`--schedule-only` は従来どおり schedule・event だけを検査します。`--records-only --commit <rev>` は作業ツリーではなく `<rev>` の tree の記録を検査し、未 commit の run や空のディレクトリを対象にしません(pre-push の検査で使います)。
647
+
648
+ `exec migrate-records` は検査を通すためには不要です。移さない旧記録は、再開候補の自動探索、task ID からの plan・result の取得、dashboard の実行記録一覧・件数に含まれません。`register build` は旧記録を探索せず、個票の既存リンクを自動移行・補完しません。明示パスを読む経路などの条件と移行手順は [[specdojo:plan-result-lifecycle-guide|plan/resultライフサイクルガイド]] の「既存記録の移行」を参照してください。
649
+
650
+ schedule の `exec resume --task <task-id> --resume-from executor` は、executor が `succeeded` で reporter が未完了、または統合段(commit・検査・merge)で止まった pipeline、あるいは approach の必須項目(`condense_records` など)を欠いた報告として runner が executor の段で止めた pipeline を、既存 worktree・変更・同じ run を引き継いで executor → reporter → 統合の順に再実行します。対象状態は reporter 段・統合段・executor 段の `blocked` または中断した `doing` で、executor の試行回数を増やし、`blocked` からの状態遷移は `unblock` イベントへ記録します。統合段から戻す場合は、executor を起動する前に統合先(project は root の現在ブランチ)を exec branch と worktree へ取り込みます。統合が成功済みの run、一部のリポジトリを統合済みの run、exec branch が merge 済みの run、worktree が merge の途中の run、executor 未成功、pipeline 以外、`executor` 以外の値は拒否します。`--task` は必須で、`--due` とは併用できません。worktree の `<execution_path>/runs/schedule/<task-id>/<run-id>/plan.md` を編集してから再開すると、その plan を使います。変更理由と再開の経緯を報告の `handoff` へ記載するよう plan に指示し、再開後の result の申し送りを確認してください。手順は [[specdojo:exec-operation-guide|exec運用ガイド]] の「blockedタスクの復帰」を参照してください。
647
651
 
648
652
  `exec scaffold --project <project-id>` は、対象 project の `viewpoints_path` へ `extends: specdojo:pm-review-viewpoints` を持つ空の差分ファイルを生成します。共通正本は [[specdojo:pm-review-viewpoints|共通レビュー観点一覧]] であり、scaffold 時点の全量コピーは作りません。そのため、共通側の更新は次回の review plan 生成時に継承 project へ反映されます。既存ファイルは既定で保持し、`--force` の指定時だけ差分雛形で置き換えます。
649
653
 
@@ -658,35 +662,36 @@ kata authoring は register 専用です。Schedule の task は対象成果物
658
662
 
659
663
  主要オプション:
660
664
 
661
- | オプション | 用途 | 対象 |
662
- | -------------------------------------- | -------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------- |
663
- | `--task <task-id>` | 対象タスクを指定する | 状態遷移系 / `run` / `plan` |
664
- | `--by <actor>` | 実行 actor / agent の nickname を指定する(手動ターゲットの agent 選択も兼ねる) | 状態遷移系 / `run` / `resume` / `worktree agent` |
665
- | `--edit-by <nickname>` | `--auto` バッチで edit タスクに使う agent nickname | `run --auto` / `resume` |
666
- | `--review-by <nickname>` | `--auto` の review タスク、または register の統合後 review に使う agent nickname | `run --auto` / `run --register --post-review` / `resume` |
667
- | `--strategy <name>` | 選択戦略を切り替える(`critical-first` 既定 / `fifo`) | `scheduler` / `run --auto` |
668
- | `--auto` / `--loop` | Ready タスクを自動選択する / Ready がなくなるまで繰り返す | `run` |
669
- | `--parallel <n>` | 同時に走らせる agent 数の上限を指定する | `run --auto` / register の worktree モード |
670
- | `--worktree` | worktree に隔離して実行する | `run --task` / `run --register` |
671
- | `--in-place` | register 項目を現在の作業ツリーで実行する(`run.register_execution` を上書き) | `run --register` |
672
- | `--track-state` | claim / complete の状態イベントを記録する | `run --task` |
673
- | `--register <PJR-ID>` | 登録簿の項目を実行する(空白・カンマ区切りで複数可。場所の既定は `run.register_execution`) | `run` / `plan` |
674
- | `--register-filter` | 登録簿項目を type / priority / status / limit の条件で決定論的に選ぶ | `run` |
675
- | `--register-commit` | 成功したIDごとに、その実行で生じた変更を1コミットにまとめる(worktree モードでは常に commit のため無視) | `run --register` |
676
- | `--post-review` | worktree 統合後に完了 review を行い、todo / issue を verdict に応じて close または waiting にする | `run --register --worktree` |
677
- | `--on-failure <stop\|continue>` | 途中失敗時に残りのIDを停止するか継続するか(既定は `stop`) | `run --register` |
678
- | `--branch <repo>=<name>` | run ごとのプロダクト作業ブランチ名(繰り返し可)を指定する | register の worktree モード |
679
- | `--integration-branch <repo>=<branch>` | run ごとのプロダクトリポジトリの統合先(繰り返し可)を指定する | register の worktree モード |
680
- | `--resume` | run が止まった段(executor / reporter / 統合)を既存 worktree と checkpoint で再開する | register の worktree モード |
681
- | `--resume-from executor` | reporter 段から再開可能な run を、既存成果を保持したまま executor 段から再開する | register の worktree モード(`--resume` と併用) |
682
- | `--force-restart` | 再開可能な run の成果があっても、worktree を破棄して項目全体を再実行する | register の worktree モード |
683
- | `--join` | 実行中の register worktree 実行の終了を待たずに合流して並行実行する(上限は `run.max_concurrent_runs`) | register の worktree モード |
684
- | `--executor-by <nickname>` | executor 段の agent。register では `PJR-ID=nickname,...` による項目別指定も可能 | `run --auto` / `resume` / `run --register` / `run --plan` / `run --deliverable` |
685
- | `--reporter-by <nickname>` | executor/reporter パイプラインの reporter 段に使う agent nickname | `run --auto` / `resume` / `run --register` / `run --plan` / `run --deliverable` |
686
- | `--on-rate-limit <action>` | 指名した agent の上限時の扱い。`stop` / `wait` / `fallback` | `run` / `resume` |
687
- | `--fallback-executor-by <name>` | rate limit の `fallback` または接続不能時に executor 段を1回だけ引き継ぐ agent | `run` / `resume` |
688
- | `--fallback-reporter-by <name>` | rate limit の `fallback` または接続不能時に reporter 段を1回だけ引き継ぐ agent | `run` / `resume` |
689
- | `--due` | 再開時刻を迎えた利用制限延期 task を対象にする | `resume` |
665
+ | オプション | 用途 | 対象 |
666
+ | -------------------------------------- | -------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------- |
667
+ | `--task <task-id>` | 対象タスクを指定する | 状態遷移系 / `run` / `plan` |
668
+ | `--by <actor>` | 実行 actor / agent の nickname を指定する(手動ターゲットの agent 選択も兼ねる) | 状態遷移系 / `run` / `resume` / `worktree agent` |
669
+ | `--edit-by <nickname>` | `--auto` バッチで edit タスクに使う agent nickname | `run --auto` / `resume` |
670
+ | `--review-by <nickname>` | `--auto` の review タスク、または register の統合後 review に使う agent nickname | `run --auto` / `run --register --post-review` / `resume` |
671
+ | `--strategy <name>` | 選択戦略を切り替える(`critical-first` 既定 / `fifo`) | `scheduler` / `run --auto` |
672
+ | `--auto` / `--loop` | Ready タスクを自動選択する / Ready がなくなるまで繰り返す | `run` |
673
+ | `--track <track>` | `--auto` の選択を 1 つの track に限定する。存在しない track は claim 前にエラー。省略時は全 track が対象 | `run --auto`(`--parallel` / `--loop` / `--dry-run` と併用可能) |
674
+ | `--parallel <n>` | 同時に走らせる agent 数の上限を指定する | `run --auto` / register の worktree モード |
675
+ | `--worktree` | worktree に隔離して実行する | `run --task` / `run --register` |
676
+ | `--in-place` | register 項目を現在の作業ツリーで実行する(`run.register_execution` を上書き) | `run --register` |
677
+ | `--track-state` | claim / complete の状態イベントを記録する | `run --task` |
678
+ | `--register <PJR-ID>` | 登録簿の項目を実行する(空白・カンマ区切りで複数可。場所の既定は `run.register_execution`) | `run` / `plan` |
679
+ | `--register-filter` | 登録簿項目を type / priority / status / limit の条件で決定論的に選ぶ | `run` |
680
+ | `--register-commit` | 成功したIDごとに、その実行で生じた変更を1コミットにまとめる(worktree モードでは常に commit のため無視) | `run --register` |
681
+ | `--post-review` | worktree 統合後に完了 review を行い、todo / issue を verdict に応じて close または waiting にする | `run --register --worktree` |
682
+ | `--on-failure <stop\|continue>` | 途中失敗時に残りのIDを停止するか継続するか(既定は `stop`) | `run --register` |
683
+ | `--branch <repo>=<name>` | run ごとのプロダクト作業ブランチ名(繰り返し可)を指定する | register の worktree モード |
684
+ | `--integration-branch <repo>=<branch>` | run ごとのプロダクトリポジトリの統合先(繰り返し可)を指定する | register の worktree モード |
685
+ | `--resume` | run が止まった段(executor / reporter / 統合)を既存 worktree と checkpoint で再開する | register の worktree モード |
686
+ | `--resume-from executor` | reporter 段から再開可能な run を、既存成果を保持したまま executor 段から再開する | register の worktree モード(`--resume` と併用)、schedule の `resume --task`(`--due` と併用不可) |
687
+ | `--force-restart` | 再開可能な run の成果があっても、worktree を破棄して項目全体を再実行する | register の worktree モード |
688
+ | `--join` | 実行中の register worktree 実行の終了を待たずに合流して並行実行する(上限は `run.max_concurrent_runs`) | register の worktree モード |
689
+ | `--executor-by <nickname>` | executor 段の agent。register では `PJR-ID=nickname,...` による項目別指定も可能 | `run --auto` / `resume` / `run --register` / `run --plan` / `run --deliverable` |
690
+ | `--reporter-by <nickname>` | executor/reporter パイプラインの reporter 段に使う agent nickname | `run --auto` / `resume` / `run --register` / `run --plan` / `run --deliverable` |
691
+ | `--on-rate-limit <action>` | 指名した agent の上限時の扱い。`stop` / `wait` / `fallback` | `run` / `resume` |
692
+ | `--fallback-executor-by <name>` | rate limit の `fallback` または接続不能時に executor 段を1回だけ引き継ぐ agent | `run` / `resume` |
693
+ | `--fallback-reporter-by <name>` | rate limit の `fallback` または接続不能時に reporter 段を1回だけ引き継ぐ agent | `run` / `resume` |
694
+ | `--due` | 再開時刻を迎えた利用制限延期 task を対象にする | `resume` |
690
695
 
691
696
  `--plan` と `--deliverable` も Schedule のパイプライン宣言を持たないため、`--executor-by` / `--reporter-by` の少なくとも一方を指定したときだけ executor/reporter 2段階で実行します。指定しなかった段は `stage_role` による自動選択で決まります。`--plan` では reporter が scaffold 済みの result を記入するため、frontmatter に `task_id` を持つ plan が必要です。`--by` との併用はエラーです。`--by` に `stage_role` を持つ pipeline 用 agent を指定すると、result 未記入の blocked にはせず、`--executor-by` / `--reporter-by` を使うよう案内するエラーで実行前に拒否します。
692
697
 
@@ -718,6 +723,9 @@ specdojo exec run --project prj-0001 --auto --parallel 5
718
723
  # Ready がなくなるまで連続実行する
719
724
  specdojo exec run --project prj-0001 --auto --loop --parallel 5
720
725
 
726
+ # 指定した track だけを連続実行する
727
+ specdojo exec run --project prj-0001 --auto --track data-flow-uc-rewrite --loop --parallel 3
728
+
721
729
  # 登録簿の項目を実行する(開始で in-progress、成功で review、失敗で waiting へ遷移)
722
730
  specdojo exec run --project prj-0001 --register PJR-0012
723
731
 
@@ -796,7 +804,7 @@ register 実行の対応内容、状態追跡、commit の扱いは [登録簿
796
804
  ```bash
797
805
  specdojo exec trial run \
798
806
  --project prj-0001 \
799
- --plan docs/ja/projects/prj-0001/execution/exec/plans/<task>-plan.md \
807
+ --plan docs/ja/projects/prj-0001/execution/runs/schedule/<task-id>/<run-id>/plan.md \
800
808
  --base <commit-before-completed-work> \
801
809
  --agent agent-a agent-b \
802
810
  --reporter-by reporter-a \
@@ -805,7 +813,7 @@ specdojo exec trial run \
805
813
  # executorとreporterを組で比較する場合
806
814
  specdojo exec trial run \
807
815
  --project prj-0001 \
808
- --plan docs/ja/projects/prj-0001/execution/exec/plans/<task>-plan.md \
816
+ --plan docs/ja/projects/prj-0001/execution/runs/schedule/<task-id>/<run-id>/plan.md \
809
817
  --base <commit-before-completed-work> \
810
818
  --pair executor-a=reporter-a executor-b=reporter-b
811
819
 
@@ -818,7 +826,7 @@ specdojo exec trial adopt --project prj-0001 --comparison <comparison-id> --tria
818
826
 
819
827
  `--agent`と任意の`--reporter-by`を使うと、reporterなしまたは全trial共通reporterの従来方式になります。`--pair <executor>=<reporter>...`は2組以上を指定し、executorとreporterを一組として比較します。`--pair`は`--agent` / `--reporter-by`と併用できません。比較記録の`reporter_mode`には`none` / `shared` / `paired`のいずれかを保存します。各reporterについて構造化出力の成否、形式試行回数、形式再試行回数、`evidence_blocked` / `invalid_output` / `invocation_failure` / `rate_limit`の失敗分類も保存します。`evidence_blocked` は reporter の申告ではなく、executor evidence から runner が機械判定した blocked を表します。
820
828
 
821
- `pipeline.parent_validations`に指定できるIDは`validate-schema`、`typecheck`、`test-unit`、`test-integration`、`lint-ts`、`lint-fm`、`lint-md`、`lint-mermaid`、`build`、`format-check`です(各IDは組み込み許可リストの固定argvへ解決されます)。`pipeline.parent_validations`はtrialにも適用され、executor成功後・reporter起動前に各worktreeで実行されます。親検証結果は`source: runner`付きでevidenceへ保存し、失敗時はtrialを`failed`にします。比較記録と`trial status`はexecutor・親検証・全体の時間を分け、executorの検証報告総数と`passed` / `failed` / `not_run` / `requires_human`、親検証の状態と件数を別々に表示します。採用前に親検証の成功、executorの未実施・未報告、sandbox 外で人が行う確認を確認してください。
829
+ `pipeline.parent_validations`に指定できるIDは`validate-schema`、`typecheck`、`test-unit`、`test-integration`、`lint-ts`、`lint-fm`、`lint-md`、`lint-mermaid`、`lint-d2`、`build`、`format-check`です(各IDは組み込み許可リストの固定argvへ解決されます)。`pipeline.parent_validations`はtrialにも適用され、executor成功後・reporter起動前に各worktreeで実行されます。親検証結果は`source: runner`付きでevidenceへ保存し、失敗時はtrialを`failed`にします。比較記録と`trial status`はexecutor・親検証・全体の時間を分け、executorの検証報告総数と`passed` / `failed` / `not_run` / `requires_human`、親検証の状態と件数を別々に表示します。採用前に親検証の成功、executorの未実施・未報告、sandbox 外で人が行う確認を確認してください。
822
830
 
823
831
  記録先は`execution_path/exec/trials/<comparison-id>/`です。agent選定への反映は自動化せず、人が複数比較を確認して `.specdojo/agent-members.yaml` を更新します。
824
832
 
@@ -836,7 +844,7 @@ specdojo exec trial adopt --project prj-0001 --comparison <comparison-id> --tria
836
844
  | `grade run` | 文書ごとに評価と反映を実行し、同じ run を再開する |
837
845
  | `grade plan` | 1文書ごとに executor / reporter の評価 plan を保存する |
838
846
  | `grade apply` | executor の申告を GradeSubmission へ機械変換して正本を反映する |
839
- | `grade translation-plan` | 正本の英語 finding から日本語表示用の翻訳 plan を作る |
847
+ | `grade translation-plan` | 英語の正本の finding から日本語表示用の翻訳 plan を作る |
840
848
  | `grade localize` | 訳文を件別検証し、合格した finding の `message_ja` を更新する |
841
849
  | `grade validate` | サイドカーの内容ハッシュと finding 件数を検証する |
842
850
  | `grade result` | 保存済み grade result を Markdown 文書のパスで表示する |
@@ -865,9 +873,13 @@ specdojo grade validate --target kata --project prj-0001
865
873
 
866
874
  `grade run` の `--run-id` は必須です。選択文書と完了状況を `execution_path/grade/generated/runs/<run-id>/run.json` へ保存し、同じ引数での再実行では完了済み文書を再適用しません。選択は初回に固定するため、`--changed-only` で実行中に文書が選択から外れても再開できます。対象内容、観点、完了条件、突き合わせ先、引数が変わった場合や保存済み結果が置き換わった場合は、新しい run ID を使います。`--work-dir` で保存先を変更できます。`--limit` は初回の選択件数を制限します。
867
875
 
876
+ `--isolate-pipeline-state` は、文書別の再試行状態を共有の `<execution_path>/grade/pipeline/` から run 保存先の `pipeline/` へ分離します。`--work-dir` を併用すればその配下になります。再開判定では共有 state を使わず、連続失敗回数と再試行上限も run 内だけで管理し、共有 state の更新・削除は行いません。同じ引数と run ID なら失敗段から再開し、成功後は自分の state だけを削除します。Schedule の review 前の grade はこのオプションを常に指定し、他 run の checkpoint を失敗状態の更新で変更しません。分離した状態は `grade state --exhausted` や `grade list --incomplete` の共有状態一覧には含めません。正本の評価結果と完了条件詳細の保存先、および project 単位の grade 排他制御は変わりません。
877
+
868
878
  `--by`(別名 `--stage-1-executor`)を省略すると、名簿の有効な review executor を既存の priority 規則で選びます。該当しなければ旧形式の review agent を選びます。別名で指定してもサイドカーの `graded_by` と run 記録には実体名を残します。`--exec-defaults` で起動設定を引き継げます。`--dry-run` は選択と actor を表示し、agent の起動とファイル更新を行いません。同一 project の grade 実行は排他制御します。
869
879
 
870
- ネイティブ経路は `--stages 1` と機械 reporter を扱います。`--reference` と `--embed-documents` は plan に反映し、`--kind` は kata の `rulebook` / `recipe` / `sample` / `template` / `all`(既定)を選びます。失敗した文書と理由は run 記録に残し、終了コード 1 を返します。`--max-stage-failures`(既定 3)に達するまでは未完了段を再開できます。日本語 finding の表示用翻訳は `translation-plan` / `localize` で別途行います。開発用シェルの実験的な 3 段構成は CLI の対象外です。
880
+ `--if-busy fail|wait` は同一 project の grade が実行中の場合の動作を指定します。省略時と `fail` は即時エラー、`wait` は既存 run の lock 解放を待って実行します。待機方針は同じ run ID の再開条件に含めません。Schedule の review 前の grade は `wait` を指定します。
881
+
882
+ ネイティブ経路は `--stages 1` と機械 reporter を扱います。`--reference` と `--embed-documents` は plan に反映し、`--kind` は kata の `rulebook` / `recipe` / `sample` / `template` / `all`(既定)を選びます。失敗した文書と理由は run 記録に残し、終了コード 1 を返します。`--max-stage-failures`(既定 3)に達するまでは未完了段を再開できます。`grade run` は翻訳の段を持ちません。finding は日本語の正本で書かれるため通常は翻訳が要らず、旧結果の英語の正本が再掲された場合だけ、必要に応じて `translation-plan` / `localize` で表示用の `message_ja` を作ります。開発用シェルの実験的な 3 段構成は CLI の対象外です。
871
883
 
872
884
  宣言済み `project.repos` 配下の Markdown は、プロジェクトリポジトリから `../product/docs/document.md` のように指定できます。宣言外のリポジトリや symlink による範囲外への参照は拒否します。
873
885
 
@@ -906,11 +918,11 @@ specdojo grade validate --target kata --project prj-0001
906
918
 
907
919
  成果物の plan は、成果物カタログの `done_criteria` を `DC-001` から順に列挙し、条件文、担当 Role code、viewpoint を executor へ渡します。executor は各条件を `satisfied` / `unsatisfied` として score とは独立に申告し、`grade apply` はその判定と不足理由を `[DONE_CRITERIA]` ブロックからそのまま GradeSubmission の `done_criteria` へ変換します。`grade apply --target deliverable` は過不足を検証し、grade result サイドカーの要約と `<execution_path>/grade/criteria/` の詳細 YAML を同時に更新します。詳細は成果物ごとに1ファイルで、再評価では同じファイルを上書きします。
908
920
 
909
- 再評価時は、grade result サイドカーの `findings[]` から `rule`、`severity`、`line`、`anchor`、正本の `message` を前回の指摘として plan へ含めます。表示用の `message_ja` は含めません。agent は各指摘が現在も未解消かを確認し、未解消なら前回の `message` を変更せず、前回と同等以上の severity で今回の finding に含めます。`grade apply` も同じ正本 `message` の finding を未解消と扱い、提出された severity が前回より軽ければ前回値へ戻し、対応する viewpoint level を severity 上限まで補正します。日本語 `message` だけの旧記録はその日本語を互換用の正本とし、英語への翻訳とは照合しません。前回の問題が解消され、別の軽微な問題だけが残る場合は、新しい finding の `message` に引き下げの根拠を含めます。前回の観点割り当てに判定を引きずられないよう各 viewpoint を現在の根拠から独立に評価し、前回指摘にない問題も検出します。前回の level、score、verdict や解消履歴は plan に引き継ぎません。適用結果は最新サイドカーへ上書きされ、成果物本文は変更しません。
921
+ 再評価時は、grade result サイドカーの `findings[]` から `rule`、`severity`、`line`、`anchor`、`message` を前回の指摘として plan へ含めます。`message` には表示用の `message_ja` があればそれを、なければ正本の `message` を示します。英語を正本にした旧記録は、日本語訳があれば日本語で示されます。agent は各指摘が現在も未解消かを確認し、未解消なら示された `message` を一字一句変えず(英語で示された場合も訳さず)、前回と同等以上の severity で今回の finding に含めます。`grade apply` は前回の正本 `message` と `message_ja` のどちらかに一致する finding を未解消と扱い、提出された severity が前回より軽ければ前回値へ戻し、対応する viewpoint level を severity 上限まで補正します。日本語で再掲された指摘はその日本語が新しい正本になり、英語の正本は再評価のたびに日本語へ移ります。前回の問題が解消され、別の軽微な問題だけが残る場合は、新しい finding の `message` に引き下げの根拠を含めます。前回の観点割り当てに判定を引きずられないよう各 viewpoint を現在の根拠から独立に評価し、前回指摘にない問題も検出します。前回の level、score、verdict や解消履歴は plan に引き継ぎません。適用結果は最新サイドカーへ上書きされ、成果物本文は変更しません。
910
922
 
911
923
  パス参照の executor は判定前に、plan が示す評価対象、すべての参考資料、選定された良い実例をファイル読み取りツールで全文読み、実行ログに各パスの読み取り操作を残します。埋め込みを使う executor は、plan に埋め込まれた同じ範囲だけを読みます。参考資料は成果物間整合、良い実例は章ごとの具体性・根拠の密度・過不足を比較する材料であり、どちらも評価対象にはしません。実例の表現や欠点を機械的に転用せず、rubric と viewpoint を最終的な判定基準にします。必要な資料を読み取れない場合は、内容を推測せず異常終了します。grade plan の Frontmatter と「このタスクで行うこと / 対象項目 / 進め方 / 完了手順 / 異常終了の条件」の章構成は exec plan に準拠します。
912
924
 
913
- executor plan は JSON 契約を持ちません。各 viewpoint を `[VIEWPOINT <id>]` と `[END VIEWPOINT]` で囲み、`LEVEL: <0-4>` と、必要な `FINDING <severity> line=<line>: <message>` を申告します。新しい判定根拠と finding の `message` は英語で記述します。marker 間の根拠と検討過程は自由記述です。この軽量な申告形式により、JSON を安定して生成できない agent でも分析を完了できます。
925
+ executor plan は JSON 契約を持ちません。各 viewpoint を `[VIEWPOINT <id>]` と `[END VIEWPOINT]` で囲み、`LEVEL: <0-4>` と、必要な `FINDING <severity> line=<line>: <message>` を申告します。判定根拠と新しい finding の `message` は日本語で記述し、固有名詞・識別子・引用は原文を保ってよいとします。marker 間の根拠と検討過程は自由記述です。この軽量な申告形式により、JSON を安定して生成できない agent でも分析を完了できます。
914
926
 
915
927
  `grade apply --analysis-from <executor-output>` を `--from` なしで実行すると、executor の最終応答の marker を解析して GradeSubmission を機械的に生成し、既存の GradeSubmission 検証を通してから反映します。LLM の reporter は起動しません。severity、line、message、done_criteria の status と reason は申告のまま写し、level だけは severity 上限を超える場合に下方向へ補正します。書き写しの誤りや JSON の構文破損は起こりません。`--submission-out <path>` を指定すると、生成した GradeSubmission をリポジトリ内のパスへ保存します(`--dry-run` では保存しません)。判定主体は executor なので、`--by <executor-nickname>` が `.specdojo/agent-members.yaml` に存在する nickname を検証してサイドカーの `graded_by` へ記録します。
916
928
 
@@ -926,6 +938,15 @@ finding の忠実性照合では、message に限り、Unicode の正準等価
926
938
 
927
939
  複数対象は、生成された executor plan を順に処理し、executor 応答を保存して直ちに `grade apply --path <document> --analysis-from <executor-output>` 相当の処理で反映します。`grade run` がこの連携を担い、後続文書が失敗しても適用済みの grade を保持します。部品ごとに実行する場合は、`agent run` で起動した応答の保存と受け渡しを呼び出し側が担います。保存済み executor plan は `exec trial` などで同じ入力を複数 agent へ渡す用途にも利用できます。
928
940
 
941
+ finding の任意項目 `cause` は原因を表します。成果物の grade plan は、各 `FINDING` の直後に `CAUSE: <JSON>` を1行で申告させ、`grade apply` はその JSON を finding の `cause` へ保存します。Kata そのものの grade では申告しません。原因の共通定義は `src/shared/finding-cause.ts` の `FindingCause` と `docs/specdojo/schemas/v1/finding-cause.schema.yaml` であり、edit の記録でも再利用できます。
942
+
943
+ | 原因 | `cause` の形 | 判定根拠 |
944
+ | -------- | ------------------------------------------------------------------------------ | ------------------------------------------------------------ |
945
+ | この文書 | `{"type":"document"}` | Kata の問題箇所を示せない場合も含む |
946
+ | Kata | `{"type":"kata","kind":"recipe","location":"## 2. 深掘りの問い、3行目の引用"}` | 宣言された Kata の見出し・行・引用で原因箇所を示せる場合だけ |
947
+
948
+ `kind` は `rulebook` / `recipe` / `sample` / `template` のいずれかで、`location` は空にできません。原因のない旧結果は `document` として扱います。原因は冗長さに限らず全観点で付け、score・verdict・severity による level 上限・前の指摘の引き継ぎ・日本語訳には影響しません。reporter 経由でも原因の追加・省略・変更を検査します。手入れの edit plan は、宣言された該当 Kata が原因の指摘を、成果物が評価後に変わっていない最新サイドカーから展開します。`fully-guided` の plan は原因を添えてすべての指摘を残します。運用は [[specdojo:ryu-guide]] の「実践の型メンテナンスの進め方」を参照してください。
949
+
929
950
  ### 8.1. npm package で 1 文書を評価する
930
951
 
931
952
  npm package の部品だけで 1 文書を評価する最小手順は、plan の生成、executor agent の実行、marker の反映です。先に `.specdojo/agent-members.yaml` と agent の実行設定を用意してください。`grade plan` の出力に表示された executor plan のパスを `<executor-plan.md>` に指定し、同じ executor nickname を `agent run` と `grade apply` の `--by` に渡します。
@@ -982,7 +1003,7 @@ tools/grade/run-per-document.sh --run-id 20260928-rubric-v2 --target deliverable
982
1003
 
983
1004
  reporter の既定はすべての段で `machine` です。`machine` の段は reporter agent を起動せず、`grade apply --analysis-from <executor-output> --submission-out <grade-submission.json>` で executor の marker を変換して反映します。finding の severity が許す level 上限を executor の申告が超えた場合は、機械変換が level を上限まで下げ、補正前後を grade result の `level_corrections` に記録します。`grade apply` が応答を拒否した場合は、拒否された応答を `executor-output.rejected.txt`、理由を `apply-rejection.log` として段のディレクトリへ残し、executor を1回だけ再実行して変換し直します。`--stage-<n>-reporter <nickname>` で agent の nickname を指定した段だけ、従来どおり LLM reporter を起動して `--from` の忠実性照合を行い、拒否時は reporter を1回だけ再実行します。LLM reporter は書き写しの精度を比較する用途に限ります。
984
1005
 
985
- 正本の grade result を保存した後、script は `grade translation-plan` で英語 finding の文だけからなる配列を作り、1件以上ある場合だけ既定の `gemma26-translator`(`--translation-by` で変更可)へ渡します。plan は、同じ件数・同じ順序の訳文だけの JSON 文字列配列を返し、元のインラインコードを一字一句変えず、元にないインラインコードやバッククォートを加えないよう求めます。インラインコード以外の英語の語句は、固有名詞・識別子を除いて日本語へ訳します。
1006
+ 正本の grade result を保存した後、script は `grade translation-plan` で英語 finding の文だけからなる配列を作ります。finding は日本語の正本で書かれるため、英語 finding は旧結果から再掲された英語の正本などに限られます。0件なら翻訳の段(翻訳 agent と `grade localize`)を流しません。1件以上ある場合だけ既定の `gemma26-translator`(`--translation-by` で変更可)へ渡します。plan は、同じ件数・同じ順序の訳文だけの JSON 文字列配列を返し、元のインラインコードを一字一句変えず、元にないインラインコードやバッククォートを加えないよう求めます。インラインコード以外の英語の語句は、固有名詞・識別子を除いて日本語へ訳します。
986
1007
 
987
1008
  `grade localize` は件数が一致しなければ全項目を不合格とします。件数が一致する場合は、各要素が空でない文字列であること、平仮名または片仮名を含むこと、元の文と訳文のインラインコードの多重集合が一致することを検証し、合格項目だけを `message_ja` へ反映します。元のインラインコードが欠けた項目は `missing-inline-code`、元にないインラインコードが増えた項目は `extra-inline-code` で不合格にします。必須の `--rejections-out <path>` には、不合格項目の 0 始まりの `translation_index`、finding ID、理由を JSON で出力します。script はこの index ごとに `grade translation-plan --translation-index <index>` と `grade localize --translation-index <index>` を使って1回だけ再翻訳し、再び不合格なら正本の `message` を表示用にも保存します。翻訳 agent や JSON の失敗も同じフォールバックに入り、翻訳段階は viewpoint、level、severity、line、score、verdict を変更しません。
988
1009
 
@@ -1058,7 +1079,7 @@ specdojo exec worktree prune --project prj-0001
1058
1079
  | `watch` | ファイル変更を監視して対象 build を実行する | `specdojo watch --project prj-0001 --scope exec` |
1059
1080
  | `build` | 全生成物または指定 scope を一括再生成する | `specdojo build --project prj-0001 --scope all` |
1060
1081
 
1061
- `dashboard build --project <id>` は `execution/generated/dashboard.md` を再生成します。通常の進捗集計に加え、`routines/generated/routine-runs.jsonl` から昨日の実行と本日の予定を、登録簿個票から着手候補のおすすめ順を、register / exec の event から解除待ちの理由と次の行動を表示します。解除待ちの理由は、制御文字を除いた 1 行へ整形し、表の区切り文字をエスケープしたうえで、長い値を省略記号付きで打ち切ります。
1082
+ `dashboard build --project <id>` は `execution/generated/dashboard.md`、全体計画ガントチャート SVG、未作成カタログを再生成します。ダッシュボードは人の対応が要るもの(review、判断待ち、waiting、human タスク)、おすすめの登録項目(先行項目充足済み上位 10 件)、実行中の epic(開始日・終了日・稼働日数、段ごとの進捗と次に流せるタスク)を先頭に表示し、終わった epic(開始日・終了日・稼働日数一覧)、routine 定義一覧、Grade 全体表、全体の集計(Schedule 進捗・登録簿集計・ガントチャート)を `::: details` で折りたたみ表示します。各項目には文書サイトで開ける相対リンクを付与し、項目がない章は「ありません」を表示します。
1062
1083
 
1063
1084
  `--scope` は `exec`、`catalog`、`register`、`index`、`all` を指定します。
1064
1085
 
@@ -1104,7 +1125,7 @@ specdojo exec run --job job-grade-kata --project prj-0001 --input period=2026-W3
1104
1125
 
1105
1126
  `action` は単一オブジェクト、または先頭から順に実行する1件以上の配列を受け付けます。単一オブジェクトの `action.kind`、配列の各要素の `kind` は `job` または `specdojo` を受け付けます。`job` は実行内容と入力検証を参照先の Job Definition に委ね、`exec run --job` 経由で実行ロックに従います。`specdojo` は `args` に書いた specdojo サブコマンド(例: `[dashboard, build]`)へ `--project` を付けて直接起動し、実行ロックを取りません(agent を呼ばない読み取り・派生生成専用。`exec` と `--project` は `args` に書けません)。`register` / `exec-auto` / `exec-resume` / `exec-cycle` の旧 kind は廃止済みです。定義ファイルの配置、`interval`または`trigger.cron`の書式、複数 action の失敗方針、due判定は [routine運用ガイド](../guides/routine-operation-guide.md) を参照します。
1106
1127
 
1107
- 各 routine の実行完了時には、`routine-state.json` の最新状態とは別に、`routines/generated/routine-runs.jsonl` へ `routine_id`、`scheduled_for`、開始・終了時刻、結果、Job Run ID(`specdojo` action では空)を1実行1行で追記します。この履歴が dashboard の「routine 実行状況(昨日・本日)」の正本です。
1128
+ 各 routine の実行完了時には、端末側の `routine-state.json` の最新状態とは別に、同じ保存先の `routine-runs.jsonl` へ `routine_id`、`scheduled_for`、開始・終了時刻、結果、Job Run ID(`specdojo` action・無変更の Job では空)を1実行1行で追記します。この履歴が dashboard の「routine 実行状況(昨日・本日)」の正本です。保存先は `$XDG_STATE_HOME/specdojo/`(未設定時は `~/.local/state/specdojo/`)以下で、`routine where` から確認できます。旧 `generated/` のファイルは初回利用時にコピーし、新しい状態を優先します。Job Run のない失敗だけを `<execution-path>/routines/failures/` に保存して commit し、成功・skip は Git に残しません。成功した Job が何も変更しなかった場合も Run 記録を commit せず、端末側の `noop` 記録で冪等性と checkpoint を保ちます。
1108
1129
 
1109
1130
  ```bash
1110
1131
  # due な routine をまとめて実行する(cron / CI から呼ぶ想定)
@@ -1123,9 +1144,10 @@ schedule / register / job / routine の使い分けの基準は [exec運用ガ
1123
1144
 
1124
1145
  `agent` は、保存済みの plan を指定した1つの agent へ渡し、その標準出力を取得します。agent の選択は `.specdojo/agent-members.yaml` の nickname で一意に決まるため、実行のたびに担当が変わりません。決定論的な手順を shell script や CLI 側に置き、agent には判断だけを委ねるための最小の部品です。
1125
1146
 
1126
- | コマンド | 用途 |
1127
- | ----------- | ----------------------------------------------------------- |
1128
- | `agent run` | plan を stdin で agent へ渡し、標準出力をファイルへ保存する |
1147
+ | コマンド | 用途 |
1148
+ | -------------- | ----------------------------------------------------------------------- |
1149
+ | `agent run` | plan を stdin で agent へ渡し、標準出力をファイルへ保存する |
1150
+ | `agent launch` | agy を役割別セッション設定と runner の宣言済み task worktree で起動する |
1129
1151
 
1130
1152
  ```bash
1131
1153
  specdojo agent run --plan <plan.md> --by <nickname> --out <response.txt>
@@ -1165,13 +1187,16 @@ specdojo orchestrator night --project prj-0001 \
1165
1187
 
1166
1188
  各 wave は worktree と post-review を必須にし、成功は close、未完了は `waiting` にします。`--max-items` は一晩の件数、`--parallel` は wave の同時数、`--max-consecutive-failures` は次の wave を止める閾値です。`--on-rate-limit fallback` では fallback executor の指定が必須です。失敗を含む朝報告を保存できた場合は部分成功を表す終了コード 2、コマンド自体の異常は 1 を返します。
1167
1189
 
1190
+ Job worktree 内から起動しても、子 run の worktree は主の作業ツリーから起動した場合と同じ場所へ作られます。子の plan・result・実行記録は Job のブランチへ統合されます。Job の worktree 再起動用の内部印と Git の repository 固有環境変数は子の処理へ引き継がれません。配置の指定方法は [[specdojo:exec-worktree-guide|exec worktree運用ガイド]] を参照してください。
1191
+
1168
1192
  ## 16. devcontainer
1169
1193
 
1170
1194
  `devcontainer` は、利用リポジトリの `.devcontainer/` 環境を構築するためのサブコマンドです。VS Code Dev Container などで、オーケストレーターを起動するための分離されたコンテナ環境を生成します。
1171
1195
 
1172
- | コマンド | 用途 |
1173
- | ----------------------- | ------------------------------------------- |
1174
- | `devcontainer scaffold` | `.devcontainer/` の設定ファイル群を生成する |
1196
+ | コマンド | 用途 |
1197
+ | -------------------------- | ----------------------------------------------------------------------- |
1198
+ | `devcontainer scaffold` | `.devcontainer/` の設定ファイル群を生成する |
1199
+ | `devcontainer host-script` | ホストから tmux へ接続するスクリプト本体を `.specdojo/host/` に書き出す |
1175
1200
 
1176
1201
  `devcontainer scaffold` は、指定された provider の CLI と、要求された追加機能を組み込んだ `devcontainer.json` と `post-create.sh` を生成します。あわせて、常時稼働ホストへの接続と tmux セッション維持のためのサンプルスクリプト(`.devcontainer/remote-host/specdojo-tmux.sh.sample`)と接続元 SSH 設定サンプル(`.devcontainer/remote-host/ssh-config.sample`)も生成します。provider は `antigravity`、`claude`、`codex`、`opencode` を指定できます。`--editor emacs` / `--editor vim` を指定した場合は、それぞれ Emacs 用の `emacs/init.el` / Vim 用の `vim/vimrc` も生成します。Dev Container は任意の実行環境であり、既存の Node.js 環境を置き換える必須手順ではありません。
1177
1202
 
@@ -1255,6 +1280,28 @@ post-create は `~/.emacs`、`~/.emacs.el`、`~/.emacs.d/init.el`、`~/.config/e
1255
1280
 
1256
1281
  Vim の雛形は `.devcontainer/vim/vimrc` に生成され、`~/.vimrc` と `~/.vim/vimrc` のどちらも無い場合だけ `~/.vimrc` へコピーされます。既存の Vim 設定は上書きしません。Emacs の雛形も上記と同じ上書き防止を維持します。
1257
1282
 
1283
+ ### 16.1. devcontainer host-script
1284
+
1285
+ `devcontainer host-script` は、常時稼働ホストから devcontainer 内の tmux セッションへ入るためのスクリプト本体(`.specdojo/host/devcontainer-tmux.sh`)をワークスペースへ書き出します。
1286
+
1287
+ ```bash
1288
+ npx specdojo devcontainer host-script
1289
+ ```
1290
+
1291
+ 主要オプション:
1292
+
1293
+ | オプション | 用途 |
1294
+ | ----------- | -------------------------------------------------------- |
1295
+ | `--dry-run` | 実際にファイルを作成せず、作成予定のファイルを表示する。 |
1296
+
1297
+ 本体スクリプトの対応 OS は macOS、Linux、Windows の WSL2 です。ホスト側のスクリプト(`~/bin/specdojo-tmux.sh` など)はワークスペースのパスを渡してこの本体スクリプトを呼び出す数行のみとなり、ホスト側スクリプトの保守負担を抑えられます。
1298
+
1299
+ - ラベル `devcontainer.local_folder` が一致する稼働中のコンテナがあれば、そのまま tmux へ入ります。
1300
+ - 停止中のコンテナがあれば `docker start` で起動してから入ります。この場合ホスト側に Node.js は不要です。
1301
+ - コンテナが存在しないときだけ `devcontainer up` を動かします。環境変数 `SPECDOJO_NODE_BIN` があればそこを `PATH` に足し、なければ利用者のログインシェル(`"$SHELL" -lic`)経由で起動します。mise を利用している場合は shims のディレクトリ(例: `~/.local/share/mise/shims`)を指定してください。
1302
+ - コンテナ内の作業ディレクトリはマウント情報から、実行ユーザーは `devcontainer.json` の `remoteUser` から求めます。求められないときは原因を stderr に出力して終了します。
1303
+ - スクリプトは実行権限(`0o755`)付きで書き出され、同じ版で複数回実行しても内容は変わりません。
1304
+
1258
1305
  ## 17. 関連ガイド
1259
1306
 
1260
1307
  | 詳細 | 参照先 |