specdojo 0.8.0 → 0.9.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 (284) hide show
  1. package/.github/agents/specdojo-orchestrator.md +4 -1
  2. package/CHANGELOG.md +64 -0
  3. package/dist/catalog/catalog.js +16 -14
  4. package/dist/commands/agent.js +5 -3
  5. package/dist/commands/build.js +69 -10
  6. package/dist/commands/git.js +206 -0
  7. package/dist/commands/init.js +4 -2
  8. package/dist/commands/where.js +25 -0
  9. package/dist/dashboard/dashboard.js +5 -3
  10. package/dist/dashboard/routines.js +4 -7
  11. package/dist/dashboard/timeline.js +14 -14
  12. package/dist/docs/index-command.js +2 -2
  13. package/dist/docs/yaml-business-tables.js +243 -0
  14. package/dist/docs/yaml-interface-tables.js +106 -0
  15. package/dist/docs/yaml-pages-command.js +5 -3
  16. package/dist/docs/yaml-pages.js +146 -3
  17. package/dist/docs/yaml-table-shared.js +70 -0
  18. package/dist/docs/yaml-tables.js +39 -0
  19. package/dist/exec/agent-config.js +9 -0
  20. package/dist/exec/agent-protected-config.js +2 -0
  21. package/dist/exec/commands.js +31 -18
  22. package/dist/exec/events.js +34 -14
  23. package/dist/exec/evidence.js +13 -3
  24. package/dist/exec/parent-validation.js +56 -3
  25. package/dist/exec/plans-core.js +21 -2
  26. package/dist/exec/plans-generation.js +6 -7
  27. package/dist/exec/post-integration.js +162 -0
  28. package/dist/exec/queue-command.js +166 -0
  29. package/dist/exec/queue.js +285 -0
  30. package/dist/exec/register-foreign-wait.js +84 -0
  31. package/dist/exec/repo-integration-sync.js +17 -5
  32. package/dist/exec/reporter.js +2 -2
  33. package/dist/exec/results.js +24 -4
  34. package/dist/exec/review-kata.js +4 -1
  35. package/dist/exec/run/agent-pipeline.js +3 -2
  36. package/dist/exec/run/agent.js +12 -6
  37. package/dist/exec/run/change-scope.js +365 -0
  38. package/dist/exec/run/deferred-cleanup.js +31 -0
  39. package/dist/exec/run/in-place.js +4 -1
  40. package/dist/exec/run/job-lock.js +66 -0
  41. package/dist/exec/run/job-sequence.js +137 -0
  42. package/dist/exec/run/job.js +56 -19
  43. package/dist/exec/run/lifecycle-commands.js +1 -1
  44. package/dist/exec/run/lock.js +22 -1
  45. package/dist/exec/run/register-command.js +8 -5
  46. package/dist/exec/run/register-mode.js +68 -8
  47. package/dist/exec/run/register-resume.js +68 -14
  48. package/dist/exec/run/register-state.js +13 -8
  49. package/dist/exec/run/register-worktree.js +140 -125
  50. package/dist/exec/run/schedule-mode.js +75 -14
  51. package/dist/exec/run/schedule-prepare.js +3 -0
  52. package/dist/exec/run/schedule-task.js +88 -38
  53. package/dist/exec/run/shared.js +5 -0
  54. package/dist/exec/schedule/schedule.js +116 -4
  55. package/dist/exec/shared.js +1 -1
  56. package/dist/exec/smoke.js +190 -0
  57. package/dist/exec/strategy.js +13 -3
  58. package/dist/exec/task-view.js +6 -4
  59. package/dist/exec/trial-commands.js +5 -2
  60. package/dist/exec/trial-core.js +6 -1
  61. package/dist/exec/validation-metrics.js +181 -0
  62. package/dist/exec/worktree-cleanup-lock.js +26 -0
  63. package/dist/exec/worktree-command.js +9 -1
  64. package/dist/exec/worktree-ops-commit.js +2 -2
  65. package/dist/exec/worktree.js +13 -2
  66. package/dist/grade/command-apply.js +3 -3
  67. package/dist/grade/command-inspect.js +5 -3
  68. package/dist/grade/command-plan.js +1 -1
  69. package/dist/grade/command-run.js +5 -1
  70. package/dist/grade/run.js +64 -8
  71. package/dist/job/definition.js +84 -8
  72. package/dist/job/job.js +79 -23
  73. package/dist/register/authoring-sources.js +22 -16
  74. package/dist/register/maintenance-commands.js +2 -2
  75. package/dist/register/register.js +31 -7
  76. package/dist/routine/definition.js +9 -0
  77. package/dist/routine/routine.js +137 -43
  78. package/dist/routine/status.js +62 -0
  79. package/dist/schedule/schedule.js +38 -39
  80. package/dist/shared/agent-types.js +5 -0
  81. package/dist/shared/cross-process-lock.js +9 -1
  82. package/dist/shared/dist-freshness.js +8 -2
  83. package/dist/shared/git-environment.js +2 -1
  84. package/dist/shared/git.js +44 -1
  85. package/dist/shared/lefthook-scaffold.js +3 -0
  86. package/dist/shared/local-config.js +244 -0
  87. package/dist/shared/specdojo-config.js +34 -20
  88. package/dist/shared/specdojo-gitignore.js +1 -0
  89. package/dist/shared/text.js +9 -1
  90. package/dist/shared/where-alias.js +13 -0
  91. package/dist/specdojo.js +4 -0
  92. package/docs/ja/specdojo/defaults/pm-review-viewpoints.yaml +2 -0
  93. package/docs/ja/specdojo/guides/exec-config-guide.md +23 -4
  94. package/docs/ja/specdojo/guides/exec-operation-guide.md +44 -1
  95. package/docs/ja/specdojo/guides/job-sequence-guide.md +77 -0
  96. package/docs/ja/specdojo/guides/quick-start-guide.md +3 -3
  97. package/docs/ja/specdojo/guides/register-operation-guide.md +1 -1
  98. package/docs/ja/specdojo/guides/routine-operation-guide.md +11 -6
  99. package/docs/ja/specdojo/guides/schedule-design-guide.md +20 -17
  100. package/docs/ja/specdojo/guides/waza-guide.md +12 -8
  101. package/docs/ja/specdojo/recipes/bac-recipe.md +66 -49
  102. package/docs/ja/specdojo/recipes/bes-recipe.md +90 -54
  103. package/docs/ja/specdojo/recipes/bps-recipe.md +88 -139
  104. package/docs/ja/specdojo/recipes/br-recipe.md +40 -47
  105. package/docs/ja/specdojo/recipes/cdfd-overview-recipe.md +97 -109
  106. package/docs/ja/specdojo/recipes/cdfd-recipe.md +85 -146
  107. package/docs/ja/specdojo/recipes/cdfd-uc-recipe.md +91 -110
  108. package/docs/ja/specdojo/recipes/cnd-recipe.md +79 -69
  109. package/docs/ja/specdojo/recipes/cpd-recipe.md +78 -64
  110. package/docs/ja/specdojo/recipes/cxd-recipe.md +92 -75
  111. package/docs/ja/specdojo/recipes/ifd-recipe.md +79 -68
  112. package/docs/ja/specdojo/recipes/ifx-cmd-recipe.md +78 -105
  113. package/docs/ja/specdojo/recipes/ifx-index-recipe.md +105 -71
  114. package/docs/ja/specdojo/recipes/pm-communication-plan-recipe.md +60 -49
  115. package/docs/ja/specdojo/recipes/pm-members-recipe.md +50 -51
  116. package/docs/ja/specdojo/recipes/pm-organization-recipe.md +59 -51
  117. package/docs/ja/specdojo/recipes/pm-plan-recipe.md +69 -56
  118. package/docs/ja/specdojo/recipes/pm-quality-management-plan-recipe.md +37 -56
  119. package/docs/ja/specdojo/recipes/pm-raci-recipe.md +39 -53
  120. package/docs/ja/specdojo/recipes/pm-roles-recipe.md +52 -79
  121. package/docs/ja/specdojo/recipes/prj-assumptions-constraints-dependencies-recipe.md +64 -93
  122. package/docs/ja/specdojo/recipes/prj-charter-recipe.md +71 -106
  123. package/docs/ja/specdojo/recipes/prj-comparison-of-alternatives-recipe.md +78 -157
  124. package/docs/ja/specdojo/recipes/prj-issues-and-approach-recipe.md +62 -111
  125. package/docs/ja/specdojo/recipes/prj-scope-recipe.md +67 -123
  126. package/docs/ja/specdojo/recipes/prj-stakeholder-register-recipe.md +60 -96
  127. package/docs/ja/specdojo/recipes/prj-success-criteria-and-acceptance-criteria-recipe.md +61 -105
  128. package/docs/ja/specdojo/recipes/stsd-recipe.md +79 -109
  129. package/docs/ja/specdojo/recipes/sysd-critical-flows-recipe.md +78 -55
  130. package/docs/ja/specdojo/recipes/sysd-cross-cutting-policy-recipe.md +82 -73
  131. package/docs/ja/specdojo/recipes/sysd-index-recipe.md +78 -59
  132. package/docs/ja/specdojo/recipes/tsd-recipe.md +149 -129
  133. package/docs/ja/specdojo/references/command-reference.md +257 -117
  134. package/docs/ja/specdojo/references/deliverables-reference.md +21 -12
  135. package/docs/ja/specdojo/references/specdojo-config-reference.md +37 -2
  136. package/docs/ja/specdojo/rulebooks/atc-index-rulebook.md +101 -257
  137. package/docs/ja/specdojo/rulebooks/atc-rulebook.md +102 -228
  138. package/docs/ja/specdojo/rulebooks/bac-rulebook.md +19 -28
  139. package/docs/ja/specdojo/rulebooks/bdd-rulebook.md +16 -67
  140. package/docs/ja/specdojo/rulebooks/bds-rulebook.md +30 -51
  141. package/docs/ja/specdojo/rulebooks/bes-index-rulebook.md +41 -61
  142. package/docs/ja/specdojo/rulebooks/bes-rulebook.md +22 -50
  143. package/docs/ja/specdojo/rulebooks/bps-rulebook.md +24 -56
  144. package/docs/ja/specdojo/rulebooks/br-rulebook.md +13 -38
  145. package/docs/ja/specdojo/rulebooks/ccd-mermaid-rulebook.md +41 -76
  146. package/docs/ja/specdojo/rulebooks/cdfd-d2-rulebook.md +18 -93
  147. package/docs/ja/specdojo/rulebooks/cdfd-mermaid-rulebook.md +18 -52
  148. package/docs/ja/specdojo/rulebooks/cdfd-overview-rulebook.md +109 -147
  149. package/docs/ja/specdojo/rulebooks/cdfd-rulebook.md +80 -108
  150. package/docs/ja/specdojo/rulebooks/cdfd-uc-rulebook.md +21 -46
  151. package/docs/ja/specdojo/rulebooks/cdr-rulebook.md +144 -0
  152. package/docs/ja/specdojo/rulebooks/cdsd-rulebook.md +27 -48
  153. package/docs/ja/specdojo/rulebooks/cdt-rulebook.md +37 -50
  154. package/docs/ja/specdojo/rulebooks/clis-rulebook.md +52 -69
  155. package/docs/ja/specdojo/rulebooks/cnd-mermaid-rulebook.md +33 -86
  156. package/docs/ja/specdojo/rulebooks/cnd-rulebook.md +16 -32
  157. package/docs/ja/specdojo/rulebooks/cop-index-rulebook.md +45 -131
  158. package/docs/ja/specdojo/rulebooks/cop-rulebook.md +69 -275
  159. package/docs/ja/specdojo/rulebooks/cpd-mermaid-rulebook.md +20 -112
  160. package/docs/ja/specdojo/rulebooks/cpd-rulebook.md +23 -56
  161. package/docs/ja/specdojo/rulebooks/cxd-mermaid-rulebook.md +12 -145
  162. package/docs/ja/specdojo/rulebooks/cxd-rulebook.md +39 -47
  163. package/docs/ja/specdojo/rulebooks/dct-index-rulebook.md +37 -56
  164. package/docs/ja/specdojo/rulebooks/dct-rulebook.md +118 -175
  165. package/docs/ja/specdojo/rulebooks/dec-rulebook.md +5 -14
  166. package/docs/ja/specdojo/rulebooks/dmd-index-rulebook.md +22 -66
  167. package/docs/ja/specdojo/rulebooks/dmd-rulebook.md +36 -94
  168. package/docs/ja/specdojo/rulebooks/dss-rulebook.md +59 -81
  169. package/docs/ja/specdojo/rulebooks/etc-index-rulebook.md +31 -131
  170. package/docs/ja/specdojo/rulebooks/etc-rulebook.md +50 -104
  171. package/docs/ja/specdojo/rulebooks/gl-rulebook.md +51 -61
  172. package/docs/ja/specdojo/rulebooks/ifd-mermaid-rulebook.md +38 -45
  173. package/docs/ja/specdojo/rulebooks/ifx-api-rulebook.md +14 -20
  174. package/docs/ja/specdojo/rulebooks/ifx-cmd-rulebook.md +26 -38
  175. package/docs/ja/specdojo/rulebooks/ifx-file-rulebook.md +26 -107
  176. package/docs/ja/specdojo/rulebooks/ifx-index-rulebook.md +42 -49
  177. package/docs/ja/specdojo/rulebooks/ifx-msg-rulebook.md +14 -22
  178. package/docs/ja/specdojo/rulebooks/imp-business-rulebook.md +21 -44
  179. package/docs/ja/specdojo/rulebooks/imp-data-rulebook.md +41 -64
  180. package/docs/ja/specdojo/rulebooks/imp-interface-rulebook.md +14 -38
  181. package/docs/ja/specdojo/rulebooks/imp-operations-rulebook.md +34 -61
  182. package/docs/ja/specdojo/rulebooks/imp-test-rulebook.md +27 -50
  183. package/docs/ja/specdojo/rulebooks/itc-index-rulebook.md +70 -199
  184. package/docs/ja/specdojo/rulebooks/itc-rulebook.md +65 -153
  185. package/docs/ja/specdojo/rulebooks/mip-index-rulebook.md +74 -150
  186. package/docs/ja/specdojo/rulebooks/mm-rulebook.md +11 -23
  187. package/docs/ja/specdojo/rulebooks/mtp-rulebook.md +99 -176
  188. package/docs/ja/specdojo/rulebooks/nfr-availability-rulebook.md +35 -61
  189. package/docs/ja/specdojo/rulebooks/nfr-index-rulebook.md +75 -117
  190. package/docs/ja/specdojo/rulebooks/nfr-integrity-rulebook.md +31 -60
  191. package/docs/ja/specdojo/rulebooks/nfr-maintainability-rulebook.md +26 -81
  192. package/docs/ja/specdojo/rulebooks/nfr-operations-rulebook.md +32 -70
  193. package/docs/ja/specdojo/rulebooks/nfr-performance-rulebook.md +45 -87
  194. package/docs/ja/specdojo/rulebooks/nfr-reliability-rulebook.md +48 -101
  195. package/docs/ja/specdojo/rulebooks/nfr-security-safety-rulebook.md +44 -80
  196. package/docs/ja/specdojo/rulebooks/nfr-usability-rulebook.md +59 -127
  197. package/docs/ja/specdojo/rulebooks/opd-index-rulebook.md +31 -50
  198. package/docs/ja/specdojo/rulebooks/opd-rulebook.md +42 -109
  199. package/docs/ja/specdojo/rulebooks/opr-index-rulebook.md +29 -42
  200. package/docs/ja/specdojo/rulebooks/opr-rulebook.md +29 -87
  201. package/docs/ja/specdojo/rulebooks/otp-index-rulebook.md +62 -84
  202. package/docs/ja/specdojo/rulebooks/otp-rulebook.md +11 -61
  203. package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +91 -106
  204. package/docs/ja/specdojo/rulebooks/pm-change-request-log-rulebook.md +25 -34
  205. package/docs/ja/specdojo/rulebooks/pm-communication-plan-rulebook.md +30 -53
  206. package/docs/ja/specdojo/rulebooks/pm-issue-log-rulebook.md +23 -35
  207. package/docs/ja/specdojo/rulebooks/pm-members-rulebook.md +27 -45
  208. package/docs/ja/specdojo/rulebooks/pm-organization-rulebook.md +37 -45
  209. package/docs/ja/specdojo/rulebooks/pm-plan-rulebook.md +45 -46
  210. package/docs/ja/specdojo/rulebooks/pm-quality-management-plan-rulebook.md +37 -48
  211. package/docs/ja/specdojo/rulebooks/pm-raci-rulebook.md +25 -29
  212. package/docs/ja/specdojo/rulebooks/pm-risk-register-rulebook.md +28 -35
  213. package/docs/ja/specdojo/rulebooks/pm-roles-rulebook.md +36 -41
  214. package/docs/ja/specdojo/rulebooks/pr-rulebook.md +5 -18
  215. package/docs/ja/specdojo/rulebooks/prj-assumptions-constraints-dependencies-rulebook.md +16 -37
  216. package/docs/ja/specdojo/rulebooks/prj-charter-rulebook.md +23 -97
  217. package/docs/ja/specdojo/rulebooks/prj-comparison-of-alternatives-rulebook.md +39 -57
  218. package/docs/ja/specdojo/rulebooks/prj-issues-and-approach-rulebook.md +43 -116
  219. package/docs/ja/specdojo/rulebooks/prj-scope-rulebook.md +16 -51
  220. package/docs/ja/specdojo/rulebooks/prj-stakeholder-register-rulebook.md +47 -92
  221. package/docs/ja/specdojo/rulebooks/prj-success-criteria-and-acceptance-criteria-rulebook.md +25 -84
  222. package/docs/ja/specdojo/rulebooks/sac-rulebook.md +44 -107
  223. package/docs/ja/specdojo/rulebooks/sf-index-rulebook.md +39 -49
  224. package/docs/ja/specdojo/rulebooks/sf-rulebook.md +42 -49
  225. package/docs/ja/specdojo/rulebooks/sld-rulebook.md +64 -89
  226. package/docs/ja/specdojo/rulebooks/stc-index-rulebook.md +90 -189
  227. package/docs/ja/specdojo/rulebooks/stc-rulebook.md +45 -105
  228. package/docs/ja/specdojo/rulebooks/stsd-mermaid-rulebook.md +6 -12
  229. package/docs/ja/specdojo/rulebooks/stsd-rulebook.md +49 -68
  230. package/docs/ja/specdojo/rulebooks/sysd-critical-flows-rulebook.md +51 -60
  231. package/docs/ja/specdojo/rulebooks/sysd-cross-cutting-policy-rulebook.md +46 -50
  232. package/docs/ja/specdojo/rulebooks/sysd-index-rulebook.md +39 -64
  233. package/docs/ja/specdojo/rulebooks/sysd-rulebook.md +47 -60
  234. package/docs/ja/specdojo/rulebooks/trc-requirements-to-specs-rulebook.md +69 -70
  235. package/docs/ja/specdojo/rulebooks/trc-requirements-to-tests-rulebook.md +65 -72
  236. package/docs/ja/specdojo/rulebooks/tsd-index-rulebook.md +35 -46
  237. package/docs/ja/specdojo/rulebooks/tsd-rulebook.md +49 -66
  238. package/docs/ja/specdojo/rulebooks/tsp-index-rulebook.md +64 -139
  239. package/docs/ja/specdojo/rulebooks/uis-rulebook.md +41 -108
  240. package/docs/ja/specdojo/rulebooks/utc-index-rulebook.md +49 -144
  241. package/docs/ja/specdojo/rulebooks/utc-rulebook.md +67 -155
  242. package/docs/ja/specdojo/samples/bds-sample.md +58 -71
  243. package/docs/ja/specdojo/samples/bes-index-sample.md +20 -37
  244. package/docs/ja/specdojo/samples/bes-sample.md +43 -53
  245. package/docs/ja/specdojo/samples/bps-sample.md +42 -54
  246. package/docs/ja/specdojo/samples/br-sample.md +40 -52
  247. package/docs/ja/specdojo/samples/ccd-sample.md +0 -1
  248. package/docs/ja/specdojo/samples/cdr-sample.md +78 -0
  249. package/docs/ja/specdojo/samples/cdsd-sample.md +47 -63
  250. package/docs/ja/specdojo/samples/clis-sample.md +70 -77
  251. package/docs/ja/specdojo/samples/dec-sample.md +2 -3
  252. package/docs/ja/specdojo/samples/ifx-api-sample.yaml +0 -2
  253. package/docs/ja/specdojo/samples/ifx-msg-sample.yaml +0 -2
  254. package/docs/ja/specdojo/samples/job-sequence.yaml +67 -0
  255. package/docs/ja/specdojo/samples/mip-index-sample.md +98 -20
  256. package/docs/ja/specdojo/samples/pm-communication-plan-sample.md +26 -19
  257. package/docs/ja/specdojo/samples/pm-organization-sample.md +39 -50
  258. package/docs/ja/specdojo/samples/pm-plan-sample.md +61 -67
  259. package/docs/ja/specdojo/samples/pm-quality-management-plan-sample.md +31 -45
  260. package/docs/ja/specdojo/samples/pm-raci-sample.md +31 -37
  261. package/docs/ja/specdojo/samples/prj-assumptions-constraints-dependencies-sample.md +32 -48
  262. package/docs/ja/specdojo/samples/prj-charter-sample.md +42 -59
  263. package/docs/ja/specdojo/samples/prj-comparison-of-alternatives-sample.md +55 -61
  264. package/docs/ja/specdojo/samples/prj-success-criteria-and-acceptance-criteria-sample.md +30 -33
  265. package/docs/ja/specdojo/samples/sf-index-sample.md +13 -55
  266. package/docs/ja/specdojo/samples/sf-sample.md +73 -85
  267. package/docs/ja/specdojo/samples/sld-sample.md +60 -79
  268. package/docs/ja/specdojo/samples/uis-sample.md +98 -121
  269. package/docs/ja/specdojo/standards/job-definition-standard.md +24 -9
  270. package/docs/ja/specdojo/templates/cdr-template.md +58 -0
  271. package/docs/specdojo/schemas/v1/exec-common.schema.yaml +2 -1
  272. package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +42 -5
  273. package/docs/specdojo/schemas/v1/exec-evidence.schema.yaml +35 -0
  274. package/docs/specdojo/schemas/v1/job-run.schema.yaml +23 -0
  275. package/docs/specdojo/schemas/v1/job.schema.yaml +63 -2
  276. package/docs/specdojo/schemas/v1/sch-strategy.schema.yaml +2 -2
  277. package/package.json +9 -6
  278. package/templates/antigravity/orchestrator.md +4 -1
  279. package/templates/claude/agents/specdojo-orchestrator.md +4 -1
  280. package/templates/codex/agents/specdojo-orchestrator.toml +4 -1
  281. package/templates/codex/orchestrator.md +4 -1
  282. package/templates/init-exec-defaults.yaml +13 -0
  283. package/templates/lefthook/tools/specdojo-pre-commit.mjs +8 -0
  284. package/templates/opencode/agents/specdojo-orchestrator.md +5 -2
@@ -0,0 +1,77 @@
1
+ ---
2
+ specdojo:
3
+ id: specdojo:job-sequence-guide
4
+ type: guide
5
+ status: draft
6
+ ---
7
+
8
+ # 順次実行 Job の例
9
+
10
+ Sequential Job Guide
11
+
12
+ 止まった Schedule task の再開 → track の auto ループ → 次の register 項目 → grade → docs build を、runner が順に実行する例です。`docs/ja/specdojo/samples/job-sequence.yaml` を project の `jobs_path` へコピーして使います。値制約と記録形式は [[specdojo:job-definition-standard|Job 定義標準]] を参照してください。
13
+
14
+ **対象読者**
15
+
16
+ - exec・grade・検査を夜間などにまとめて順次実行する開発者、運用者
17
+
18
+ **この文書で分かること**
19
+
20
+ - 順次実行 Job の定義例、手動・routine / cron からの起動、結果確認と再試行
21
+
22
+ **次に読む文書**
23
+
24
+ - [[specdojo:job-definition-standard|Job 定義標準]]
25
+ - [[specdojo:routine-operation-guide|routine 運用ガイド]]
26
+
27
+ ## 1. 手動実行
28
+
29
+ 入力の task ID・track・個票・評価対象を、実在する対象へ置き換えます。`schedule_state` は `execution_path` の `generated/state.json` を指し、段の末尾の `exec refresh` で最新状態を生成します。例は SpecDojo 本体の `docs:build` を呼ぶため、別の repository では導入済みの検査へ差し替えます。
30
+
31
+ ```bash
32
+ specdojo job validate --project prj-0001
33
+ specdojo exec run --project prj-0001 --job job-sequence \
34
+ --input resume_task=T-EXAMPLE-document-020 track=example \
35
+ track_end_task=T-EXAMPLE-document-090 \
36
+ schedule_state=docs/ja/projects/prj-0001/execution/generated/state.json \
37
+ register_item=PJR-XXXX \
38
+ register_ticket=docs/ja/projects/prj-0001/controls/project-register/pjr-xxxx-example.md \
39
+ grade_path=docs/ja/product/example.md --dry-run
40
+ ```
41
+
42
+ dry-run で解決済みの段・状態参照先を確かめ、実行時は `--dry-run` を外します。resume と auto は refresh 後の task 状態、register は個票の状態を終了コードに加えて確認します。grade は選択した文書の pipeline が完了しなければ非 0 で終了するため、その終了コードを使います。grade の失敗後も build を試す `on_failure: continue` を例示していますが、Run 全体は失敗のままです。
43
+
44
+ ## 2. routine と cron
45
+
46
+ 同じ Job を routine の `action` で参照します。`rtn-sequence.yaml` を `routines_path` に置き、入力は手動例と同様に対象へ合わせます。運用前に実行対象と agent 設定を確認してください。
47
+
48
+ ```yaml
49
+ id: rtn-sequence
50
+ name: 夜間の順次実行
51
+ enabled: true
52
+ trigger:
53
+ cron: "0 1 * * *"
54
+ timezone: Asia/Tokyo
55
+ action:
56
+ kind: job
57
+ job: job-sequence
58
+ inputs:
59
+ resume_task: T-EXAMPLE-document-020
60
+ track: example
61
+ track_end_task: T-EXAMPLE-document-090
62
+ schedule_state: docs/ja/projects/prj-0001/execution/generated/state.json
63
+ register_item: PJR-XXXX
64
+ register_ticket: docs/ja/projects/prj-0001/controls/project-register/pjr-xxxx-example.md
65
+ grade_path: docs/ja/product/example.md
66
+ policy:
67
+ missed_run: latest
68
+ overlap: skip
69
+ ```
70
+
71
+ cron は repository に移動して `routine run --due` を起動するだけです。たとえば5分ごとに `cd /path/to/repository && specdojo routine run --project prj-0001 --due` を呼びます。runner 自身が待機・各段の起動・完了判定を行うので、Claude Code・Codex・Antigravity の会話機能には依存しません。
72
+
73
+ ## 3. 結果と再試行
74
+
75
+ Job Run JSON の `attempts[].steps` で成功・失敗・延期、終了コード、理由、各 command evidence 参照を確認します。project lock を取得するまでの上限は定義の3600秒です。grade 独自の lock も `--if-busy wait` で待ちます。grade 段の `timeout_seconds: 7200` は待機と処理を含む実行時間の上限で、超過するとプロセスを停止して延期にします。次回は同じ `job_run_id` による grade の再開を使います。
76
+
77
+ 同じ `--scheduled-at` と入力で再実行すると、失敗した Run の次 attempt で先頭から実行します。完了済み Run の同じ実行枠は重複実行しません。新しい `--scheduled-at` は新規 Run になるため、停止した task の再開条件を確認して入力を変えます。routine 自体の失敗・延期履歴と実行枠の扱いは [[specdojo:routine-operation-guide|routine 運用ガイド]] に従います。
@@ -675,7 +675,7 @@ npx specdojo catalog validate --project prj-0001
675
675
  npx specdojo deliverable scaffold --project prj-0001
676
676
 
677
677
  # カタログの Markdown 派生ビューをビルド
678
- npx specdojo catalog build --project prj-0001
678
+ npx specdojo build --only catalog --project prj-0001
679
679
  ```
680
680
 
681
681
  </details>
@@ -735,7 +735,7 @@ npx specdojo schedule strategy generate \
735
735
  ```chat
736
736
  あなた: スケジュールを生成して、今すぐ着手できるタスクを確認したいです。
737
737
 
738
- オーケストレーター: track launch の内容と出力先(`schedule_path` の既定は docs/ja/projects/prj-0001/schedule)を確認しました。schedule build と exec refresh を実行してよろしいですか?
738
+ オーケストレーター: track launch の内容と出力先(`schedule_path` の既定は docs/ja/projects/prj-0001/schedule)を確認しました。build --only schedule と exec refresh を実行してよろしいですか?
739
739
 
740
740
  あなた: はい、実行してください。
741
741
 
@@ -755,7 +755,7 @@ npx specdojo schedule strategy generate \
755
755
 
756
756
  ```bash
757
757
  # スケジュールのビルド
758
- npx specdojo schedule build --project prj-0001 --track launch --force
758
+ npx specdojo build --only schedule --project prj-0001 --track launch --force
759
759
 
760
760
  # Ready タスクと CPM の更新
761
761
  npx specdojo exec refresh --project prj-0001
@@ -267,7 +267,7 @@ specdojo register close \
267
267
  --commit
268
268
  ```
269
269
 
270
- `--commit` は register の worktree 実行の記帳・統合と同じ `register lifecycle` 枠が空くまで待ち、枠の内側で記帳、`register build` 相当の検証・再生成、commit を順に行います。commit 対象はそのコマンドが新たに変更した個票・event・参照文書だけで、開始前からあるほかの未 commit 変更は残します。対象個票やevent自体に開始前の変更がある場合は、既存差分を混ぜないため書き込み前に停止します。既定の件名は `docs(register PJR-XXXX): <command> <title>` で、`-m <message>` または `--message <message>` で上書きできます。`--dry-run` と同時に指定した場合は表示だけを行い、枠の取得と commit は行いません。
270
+ `--commit` は register の worktree 実行の記帳・統合と同じ `register lifecycle` 枠が空くまで待ち、枠の内側で記帳、`register build` 相当の検証・再生成、commit を順に行います。commit 対象はそのコマンドが新たに変更した個票・event・参照文書だけで、開始前からあるほかの未 commit 変更は残します。対象個票やevent自体に開始前の変更がある場合は、既存差分を混ぜないため書き込み前に停止します。既定の件名は `docs(register PJR-XXXX): <command> <title>` で、`-m <message>` または `--message <message>` で上書きできます。`-m` を繰り返すと、`git commit -m` と同じく 1 つ目を件名、2 つ目以降を本文の段落にします。commit に失敗した場合は、記帳済みで未 commit のファイルを示して終了コード 1 で終わります。`--dry-run` と同時に指定した場合は表示だけを行い、枠の取得と commit は行いません。
271
271
 
272
272
  ほかのファイルがすでに stage されていても、初回 commit と hook 整形後の amend は対象パスだけを記録し、既存の staged 変更を保持します。実行中に別タスクの exec event が増えても対象へ取り込みません。stage 後の検査や commit・amend が失敗した場合、または `SIGINT`・`SIGTERM`・`SIGHUP` で中断された場合は、そのコマンドが stage した対象だけを unstage し、作業ツリーの本文を残します。Git の実行中に届いた中断は Git が戻ってから処理します。初回 commit 後の失敗・中断では commit が残るため、本文と HEAD の差分を確認してから再実行してください。
273
273
 
@@ -13,7 +13,7 @@ Routine Operation Guide
13
13
 
14
14
  routineは、既存の未完了Schedule/Register項目を探索するほか、再利用可能なJob Definitionから期間・revisionごとのJob Runを生成できます。週報や変更文書の翻訳は[Job実行設計](../../product/040-system-design/sysd-job-execution.md)を参照してください。
15
15
 
16
- 継続品質評価は `job-grade-kata` や `job-grade-deliverable` の Job Definition から `action.kind: job` の routine で定期起動します。文書の選択、各文書の executor 実行、executor の marker を GradeSubmission へ機械変換する `grade apply --path --analysis-from` の逐次処理は `tools/grade/run-per-document.sh` が持ちます。このスクリプトと、このスクリプトを前提とする定期 Job は SpecDojo 本体リポジトリの開発用であり、スクリプトは npm package に含まれません。定期 Job は `--stages 1` で codex 単段を選びます。Job runnerは`task.command`からその入口を直接起動してevidenceを記録し、成功後の結果判断だけを`task.analysis`のreporter agentへ委譲します。責務の切り分け基準は [Job定義標準](../standards/job-definition-standard.md) を参照します。
16
+ 継続品質評価は `job-grade-kata` や `job-grade-deliverable` の Job Definition から `action.kind: job` の routine で定期起動します。Job の `task.command` は選択条件ごとの `grade list` の和集合を Run ごとに固定し、各文書の executor 実行と marker の機械変換・反映を `grade run` に任せます(PJR-R7BQ)。`grade run` は単段で評価します。Job runnerは`task.command`からその入口を直接起動してevidenceを記録し、成功後の結果判断だけを`task.analysis`のreporter agentへ委譲します。責務の切り分け基準は [Job定義標準](../standards/job-definition-standard.md) を参照します。
17
17
 
18
18
  v0.3.0 の公開物における grade は試験的な機能です。利用者は `grade list` / `plan` / `apply` / `validate` / `result` などの部品を利用できますが、定期実行や通しの pipeline は自分で組み合わせます。成果物の grade には project の `catalog_path` が必要です。1 文書の最小手順は [CLI コマンドリファレンス](../references/command-reference.md#81-npm-package-で-1-文書を評価する)を参照してください。
19
19
 
@@ -32,6 +32,8 @@ v0.3.0 の公開物における grade は試験的な機能です。利用者は
32
32
 
33
33
  ## 1. routineの定義
34
34
 
35
+ resume → auto → register → grade → build のように前段の完了を待つ流れは、command Job の `task.steps` に定義し、routine からその Job を1回呼びます。各段の失敗方針・状態判定・有限の lock 待機は runner が処理するため、agent の会話再開機能を必要としません。設定例と cron 起動は [[specdojo:job-sequence-guide|順次実行 Job の例]] を参照してください。
36
+
35
37
  `routine` は `rtn-*.yaml` の定義に基づき、Schedule の依存グラフとは独立にタスクを定期実行します。CLI は常駐しません。外部スケジューラ(cron / CI の scheduled workflow)から `routine run --due` を冪等に呼び出す前提です。
36
38
 
37
39
  定義は `.specdojo/specdojo.config.json` の `routines_path` 配下に `rtn-<slug>.yaml` として置き、`id` はファイル名と一致させます。
@@ -162,9 +164,9 @@ Job Definition を持たないため、Job Run と evidence は作られませ
162
164
 
163
165
  ### 1.2. grade の単段評価
164
166
 
165
- Kata と成果物の定期評価は、SpecDojo 本体リポジトリ内で executor の単段により実行します。GradeSubmission は LLM の reporter を通さず、`grade apply` が executor の marker から機械的に生成します。executor は判定根拠と finding を日本語で書き、その文が正本になります。正本の grade result を保存した後、旧結果から再掲された英語の正本など英語 finding が1件以上ある場合だけ `gemma26-translator` が日本語へ翻訳し、表示用の `message_ja` を更新します。0件なら翻訳の段を流しません。モデルには英語文だけの配列を渡し、件数、各訳文の仮名、元の文と訳文のインラインコードの多重集合の一致をコードで検証します。元にないインラインコードが増えた項目も不合格とし、不合格項目だけを1件ずつ1回再翻訳します。それでも不合格なら正本の英語を表示に使います。翻訳は判定値を変えません。`job-grade-kata` と `job-grade-deliverable` は本体リポジトリにだけある `tools/grade/run-per-document.sh --stages 1` を起動し、条件付きの後続段は持ちません。変更済み・未評価・段未完了・旧 rubric を横断的に再評価する `rtn-grade-recheck` は `kind: all`、`changed_only: true`、`ungraded: true`、`incomplete: true`、`rubric_outdated: true`、`limit: 15` を入力します。
167
+ Kata と成果物の定期評価は、SpecDojo 本体リポジトリ内で executor の単段により実行します。GradeSubmission は LLM の reporter を通さず、`grade apply` が executor の marker から機械的に生成します。executor は判定根拠と finding を日本語で書き、その文が正本になります。正本の grade result を保存した後、旧結果から再掲された英語の正本など英語 finding が1件以上ある場合だけ `gemma26-translator` が日本語へ翻訳し、表示用の `message_ja` を更新します。0件なら翻訳の段を流しません。モデルには英語文だけの配列を渡し、件数、各訳文の仮名、元の文と訳文のインラインコードの多重集合の一致をコードで検証します。元にないインラインコードが増えた項目も不合格とし、不合格項目だけを1件ずつ1回再翻訳します。それでも不合格なら正本の英語を表示に使います。翻訳は判定値を変えません。`job-grade-kata` と `job-grade-deliverable` は `grade run` を起動し、条件付きの後続段は持ちません。`job-grade-kata` は `--reference-per-kind` で各文書を同じ種別の `prj-overview` 文書と比較します。`grade run` は翻訳の段を持たないため、上記の英語 finding の翻訳は定期 Job では流れません。変更済み・未評価・段未完了・旧 rubric を横断的に再評価する `rtn-grade-recheck` は `kind: all`、`changed_only: true`、`ungraded: true`、`incomplete: true`、`rubric_outdated: true`、`limit: 15` を入力します。
166
168
 
167
- 成果物は `rtn-grade-deliverable-recheck` が `job-grade-deliverable` を起動します。Job は同じ script を `--stages 1 --target deliverable` で実行し、成果物カタログから変更済み・未評価・段未完了・旧 rubric の Markdown 成果物だけを最大10件選びます。評価結果は成果物の最新 grade と成果物ごとの `done_criteria` 詳細へ上書きされるため、実行ごとの review result は増やしません。
169
+ 成果物は `rtn-grade-deliverable-recheck` が `job-grade-deliverable` を起動します。Job は `grade run --target deliverable` を実行し、成果物カタログから変更済み・未評価・段未完了・旧 rubric の Markdown 成果物だけを最大10件選びます。評価結果は成果物の最新 grade と成果物ごとの `done_criteria` 詳細へ上書きされるため、実行ごとの review result は増やしません。
168
170
 
169
171
  `rtn-grade-deliverable-recheck` は毎日1時、`rtn-grade-recheck` は毎日5時に実行し、いずれも `missed_run: skip` とします。`rtn-dashboard-refresh` は `action.kind: specdojo` で毎時 `dashboard build` を直接起動します(exec の実行ロックを取らないため、grade や register の実行中でも並行して動きます)。devcontainer の cron は毎時 `routine run --due` を呼びますが、各 routine の発火時刻は routine 側の cron で決まります。コンテナ停止中の実行枠を日中へ持ち越さず、対話的な register 実行との競合を避けます。
170
172
 
@@ -200,7 +202,7 @@ Job Definition は script を `if` の条件として起動し、終了コード
200
202
 
201
203
  実行履歴は同じ保存先の `routine-runs.jsonl` へ1実行1行で追記します。各行は `routine_id`、`scheduled_for`、`started_at`、`completed_at`、`result`、`job_run_ids` を持ち、`docs/specdojo/schemas/v1/routine-run.schema.yaml` に従います。最新状態は due 判定、追記履歴は dashboard の日別実績表示に使います。
202
204
 
203
- 保存先は `$XDG_STATE_HOME/specdojo/<repository-key>/routines/<path-key>/`、環境変数が未設定または相対パスなら `~/.local/state/specdojo/` 以下です。repository key は Git 共通ディレクトリの実パス(Git がなければリポジトリの実パス)、path key はリポジトリからの routine 定義の相対パスの SHA-256 です。linked worktree 間で共有し、別リポジトリ・別 routine ツリーを分離します。`routine where` で実際のパスを確認できます。初回の `routine list`・通常実行・dashboard 集計時に旧 `generated/` の状態と履歴をコピーし、新しいファイルがあれば上書きしません。旧ファイルは復旧用に残しますが以後は参照しません。移行前に旧版の routine プロセスを停止してください。別端末へ状態を引き継ぐ場合はこの保存先を別途コピーします。
205
+ 保存先は `$XDG_STATE_HOME/specdojo/<repository-key>/routines/<path-key>/`、環境変数が未設定または相対パスなら `~/.local/state/specdojo/` 以下です。repository key は Git 共通ディレクトリの実パス(Git がなければリポジトリの実パス)、path key はリポジトリからの routine 定義の相対パスの SHA-256 です。linked worktree 間で共有し、別リポジトリ・別 routine ツリーを分離します。`where routine` で実際のパスを確認できます。初回の `routine list`・通常実行・dashboard 集計時に旧 `generated/` の状態と履歴をコピーし、新しいファイルがあれば上書きしません。旧ファイルは復旧用に残しますが以後は参照しません。移行前に旧版の routine プロセスを停止してください。別端末へ状態を引き継ぐ場合はこの保存先を別途コピーします。
204
206
 
205
207
  routine 自身が Git に残すのは、結果が `failure` かつ関連 Job Run ID が空の実行だけです。`<execution-path>/routines/failures/<routine-id>/<UUID>.json` に履歴と同じ項目と `run_id` を書き、理由を伏せ字処理したうえで、そのファイルだけを commit します。Job Run があればその記録を診断に使います。成功・skip・無変更の履歴は端末側にだけ保存し、dashboard も同じ状態・履歴を参照します。lock は文書ツリー外にあり、`.gitignore` の追加設定は不要です。
206
208
 
@@ -242,13 +244,16 @@ specdojo routine run --project <project-id> --id rtn-daily-register-sweep
242
244
  specdojo routine run --project <project-id> --due --dry-run
243
245
  ```
244
246
 
245
- 各 action は委譲先へ `--if-busy skip` を渡します。同じ project の `exec run` または `exec resume` が動作中なら待機せず、次のように記録して終了します。単一の routine 実行内では再試行せず、次回の cron tick に委ねます。
247
+ 各 action は委譲先へ `--if-busy skip` を渡します。同じ project の `exec run` または `exec resume` が動作中なら待機せず、次のように記録して終了します。単一の routine 実行内では再試行せず、次の `routine run --due` に委ねます。
246
248
 
247
249
  ```text
248
250
  [routine] skipped rtn-daily-register-sweep: job action skipped
251
+ [routine] rtn-daily-register-sweep: busy skip 1/24, retried on the next routine run --due
249
252
  ```
250
253
 
251
- `routine-state.json` の `last_result` は、実行開始時に `running` が記録され、実行完了時に `success`、`partial`、`failure`、`skipped` のいずれかへ更新されます。実行中は前回の結果や理由を残さず、`routine list` の最終実行の欄には `(running)` と表示されます(例: `2026-10-15T21:00:03Z (running)`)。実行プロセスの異常終了などにより `running` の表示が残った場合でも、次回の due 判定は `last_run` の時刻(cron の場合は `last_scheduled_for`)に基づいて判定されるため、次回の実行機会には影響しません。`partial` は完了分の統合と失敗分の再試行待ちが混在する状態であり、`routine list` では `(partial)` と表示されます。`skipped` は project busy または Job precondition の skip を表し、failure 件数や終了コードへ加算されません。`routine list` では最終実行時刻の後ろに `(skipped)` と表示されます。
254
+ 別の run の lock による skip(busy)は済んだ回として扱いません。cron の routine は `missed_run` が `latest` または `all`(省略時を含む)なら `last_scheduled_for` を進めず、空いた次の `routine run --due` でその回を流し直します。`latest` で新しい回が既に来ていれば新しい回だけを流します。`all` で同じ実行内に後の回が残っていても、busy の回より後は流さず次に回します。interval の routine は `busy_skip_count` が正の間、interval の経過を待たずに次の回で due になります。続いた busy skip が 24 回(毎時の `routine run --due` でおよそ 1 日)を超えたら、その回を済んだ回として扱い、`last_reason` と履歴の `reason` に上限到達を残します。`missed_run: skip` の cron、Job precondition の skip、失敗の回は従来どおり流し直しません。履歴の各行には skip の内訳を `skip_reason`(`busy` / `precondition`)で、流し直し待ちを `retry_pending: true` で残し、`routine status` で状態と直近の履歴を確認できます。
255
+
256
+ `routine-state.json` の `last_result` は、実行開始時に `running` が記録され、実行完了時に `success`、`partial`、`failure`、`skipped` のいずれかへ更新されます。実行中は前回の結果や理由を残さず、`routine list` の最終実行の欄には `(running)` と表示されます(例: `2026-10-15T21:00:03Z (running)`)。実行プロセスの異常終了などにより `running` の表示が残った場合でも、次回の due 判定は `last_run` の時刻(cron の場合は `last_scheduled_for`)に基づいて判定されるため、次回の実行機会には影響しません。`partial` は完了分の統合と失敗分の再試行待ちが混在する状態であり、`routine list` では `(partial)` と表示されます。`skipped` は project busy または Job precondition の skip を表し、failure 件数や終了コードへ加算されません。内訳は `routine-state.json` の `last_skip_reason` に残ります。`routine list` では最終実行時刻の後ろに `(skipped)` と表示されます。
252
257
 
253
258
  ### 2.1. devcontainerでのcron設定
254
259
 
@@ -148,14 +148,15 @@ specdojo schedule strategy generate --project <project-id> --track <track> \
148
148
 
149
149
  `sch-strategy-<track>.yaml`(生成入力)から `sch-track-<track>.yaml`(生成物)への展開では、タスク単位で確定する実行情報だけを展開します。
150
150
 
151
- | 展開する情報 | 理由 |
152
- | ------------------ | -------------------------------------------------------- |
153
- | `name` | 実行者が作業を識別するために必要 |
154
- | `description` | エージェント・人間が実行時に参照するフェーズ指示 |
155
- | `target_local_ids` | 横断タスクの対象成果物群を plan / commit scope へ渡す |
156
- | `owner` | 誰が実行するかを決定するために必要 |
157
- | `duration_days` | CPM 計算に必要 |
158
- | `depends_on` | 実行順序の決定に必要。タスク ID に解決済みの形で展開する |
151
+ | 展開する情報 | 理由 |
152
+ | ------------------ | --------------------------------------------------------------------------------------------------------------------- |
153
+ | `name` | 実行者が作業を識別するために必要 |
154
+ | `description` | エージェント・人間が実行時に参照するフェーズ指示 |
155
+ | `target_local_ids` | 横断タスクの対象成果物群を plan / commit scope へ渡す |
156
+ | `owner` | 誰が実行するかを決定するために必要 |
157
+ | `duration_days` | CPM 計算に必要 |
158
+ | `depends_on` | 実行順序の決定に必要。タスク ID に解決済みの形で展開する |
159
+ | `agent` | phase の `agent` と `owner_rules[].phase_overrides[].agent` を解決した指名。plan だけで実行者を確かめられるようにする |
159
160
 
160
161
  トラック全体に共通する生成ルールや設計意図は strategy に留めます。
161
162
 
@@ -166,6 +167,8 @@ specdojo schedule strategy generate --project <project-id> --track <track> \
166
167
  | `cross_domain_dependencies` | 依存関係の設計意図。トラックには解決済み `depends_on` として反映 |
167
168
  | `phase_gates`・`group_milestones` | 生成ロジック。トラックにはマイルストーンとして展開済み |
168
169
 
170
+ `agent` もトラックへ展開しますが、実行時の解決は strategy を正とし、トラックの値では上書きしません。指名を変えるときは strategy を直し、`schedule build --track <track> --force` で作り直します。トラックを直接直すと、`exec validate` と `exec run --auto` が strategy から作り直した結果との違いを警告します。
171
+
169
172
  `description` をトラックへ展開するのは、エージェントや人間が plan ファイルだけを読んで実行できるようにするためです。strategy を参照させる方式は plan 生成時にファイルが 2 つ必要になり、自己完結性が損なわれます。
170
173
 
171
174
  反復タスクには、実行時にタスク ID の文字列解析へ依存しないよう、生成元を表す `phase_set`・`phase_id`・`phase_suffix` と、該当する `cycle`・`iteration` を展開します。
@@ -276,14 +279,14 @@ phase_sets:
276
279
  proficiency: expert
277
280
  ```
278
281
 
279
- | フィールド | 用途 |
280
- | -------------- | ------------------------------------------ |
281
- | `execution` | `agent` または `human`。省略時は `agent` |
282
- | `mode` | `edit` または `review`。省略時は `edit` |
283
- | `approach` | plan テンプレートの進め方を選ぶ |
284
- | `capabilities` | 必要なツールや能力を示す |
285
- | `proficiency` | 必要な習熟度を示す |
286
- | `agent` | executor / reporter を nickname で指名する |
282
+ | フィールド | 用途 |
283
+ | -------------- | ------------------------------------------------------------------- |
284
+ | `execution` | `agent` または `human`。省略時は `agent` |
285
+ | `mode` | `edit` または `review`。省略時は `edit` |
286
+ | `approach` | plan テンプレートの進め方を選ぶ |
287
+ | `capabilities` | 必要なツールや能力を示す |
288
+ | `proficiency` | 必要な習熟度を示す。`frontier` は明示要求時だけ自動選択の候補になる |
289
+ | `agent` | executor / reporter を nickname で指名する |
287
290
 
288
291
  `approach` の値ごとの意味と、rulebook / recipe / sample / template の参照方針は [実践の進め方ガイド](ryu-guide.md) を参照します。エージェント選択の詳細は [exec設定ガイド](exec-config-guide.md) を参照します。
289
292
 
@@ -320,7 +323,7 @@ phase_sets:
320
323
  - pipeline を指定した phase は agent 実行専用です。`execution: human` と併用できません。
321
324
  - `mode` と `approach` は phase 全体へ適用し、各 stage の agent 選択要件は stage 内の `capabilities` と `proficiency` で定義します。
322
325
  - 通常は `stage_role` と実行要件に一致する member を実行時に自動選択します。provider の利用枠を phase ごとに計画する場合は、phase の `agent.executor` / `agent.reporter` に `.specdojo/agent-members.yaml` の nickname を指定します。
323
- - `agent` と `agent_pipeline` は併用できます。`--executor-by` / `--reporter-by`、phase の `agent`、stage の `capabilities` / `proficiency` による自動選択の順で解決します。`owner_rules[].phase_overrides[].agent` では成果物単位に指名を上書きできます。
326
+ - `agent` と `agent_pipeline` は併用できます。`--executor-by` / `--reporter-by`、成果物単位に指名を上書きする `owner_rules[].phase_overrides[].agent`、phase の `agent`、stage の `capabilities` / `proficiency` による自動選択の順で解決します。ready の作り直し・タスクの表示・実行のどれでも同じ順で、strategy を持つトラックでは、トラックへ展開した `agent` を使いません(トラックへ展開する情報を参照)。
324
327
  - by-name の agent が rate limit になった場合は別 agent へ自動フォールバックせず、タスクを待機状態にします。再開時も同じ agent を使い、緊急の差し替えだけを CLI の stage override で行います。
325
328
  - 登録簿の項目(`exec run --register`)は per-item のパイプライン宣言を持たないため、`agent_pipeline` の YAML 定義は使いません。代わりに `--executor-by <nickname>` と `--reporter-by <nickname>` を両方指定すると、同じ executor/reporter 2段階(evidence の受け渡し・result 描画を含む)で実行します。詳細は [CLIコマンドリファレンス](../references/command-reference.md) の `exec run` を参照します。
326
329
 
@@ -41,6 +41,8 @@ SpecDojo は道場のメタファーとして、`specdojo` CLI のコマンド
41
41
  | 定期実行定義 | `rtn-*.yaml` | `routine` |
42
42
  | ドキュメントIDインデックス | `.specdojo/doc-index.json` | `index` |
43
43
 
44
+ 保存先を確認するときは `specdojo where <種類> --project <id>` を使います。種類は `exec`・`catalog`・`schedule`・`timeline`・`job`・`routine` です。たとえば `specdojo where exec --project prj-0001` で実行記録の保存先を確認できます。旧 `<種類> where` は1版の移行期間後に削除するため、新しい構文へ置き換えてください。
45
+
44
46
  ### 1.1. 技の名前
45
47
 
46
48
  主要な CLI 機能には、Spec道(仕様道)の道場で使う技の名前を付けています。
@@ -58,15 +60,17 @@ SpecDojo は道場のメタファーとして、`specdojo` CLI のコマンド
58
60
 
59
61
  生成や実行を伴うコマンドは、出力の性質と副作用に応じて次の動詞を使います。
60
62
 
61
- | 動詞 | 用途 | 再実行と上書きの原則 | 代表例 |
62
- | ---------- | ------------------------------------------------------------ | ------------------------------------------------------------ | ------------------------------------------ |
63
- | `scaffold` | 人が編集する正本や設定の初期雛形を作る | 既存ファイルを既定で保護し、上書きは `--force` で明示する | `catalog scaffold`、`deliverable scaffold` |
64
- | `build` | 正本から再現可能な派生物を組み立てる | 同じ入力から繰り返し生成でき、派生物の置換を許容する | `catalog build`、`schedule build`、`build` |
65
- | `refresh` | イベントやScheduleから変化する実行状態スナップショットを更新 | 実行履歴や正本を変更せず、現在状態を安全に再計算する | `exec refresh` |
66
- | `run` | タスク、routine、agentなどの処理を実際に実行する | 状態遷移、外部プロセス起動、成果物編集などの副作用を許容する | `exec run`、`routine run` |
63
+ | 動詞 | 用途 | 再実行と上書きの原則 | 代表例 |
64
+ | ---------- | ------------------------------------------------------------ | ------------------------------------------------------------ | -------------------------------------------------------- |
65
+ | `scaffold` | 人が編集する正本や設定の初期雛形を作る | 既存ファイルを既定で保護し、上書きは `--force` で明示する | `catalog scaffold`、`deliverable scaffold` |
66
+ | `build` | 正本から再現可能な派生物を組み立てる | 同じ入力から繰り返し生成でき、派生物の置換を許容する | `build`、`build --only catalog`、`build --only schedule` |
67
+ | `refresh` | イベントやScheduleから変化する実行状態スナップショットを更新 | 実行履歴や正本を変更せず、現在状態を安全に再計算する | `exec refresh` |
68
+ | `run` | タスク、routine、agentなどの処理を実際に実行する | 状態遷移、外部プロセス起動、成果物編集などの副作用を許容する | `exec run`、`routine run` |
67
69
 
68
70
  `scaffold` と `build` の違いは、生成後のファイルを人が正本として編集するか、入力から再生成できる派生物かです。`refresh` は build 可能な一般成果物ではなく、イベントを反映して時点ごとに変わる実行状態に限定します。`run` はファイル生成そのものではなく、処理の遂行を表します。
69
71
 
72
+ 区分を絞る場合は `build --only <区分>` を使います。対応する区分・オプションと内部互換用の旧入口は [[specdojo:command-reference|CLIコマンドリファレンス]] の「watch / build」を参照してください。
73
+
70
74
  ## 2. 標準ディレクトリ構成
71
75
 
72
76
  プロジェクト文書は `docs/ja/projects/<project-id>/` 配下に置きます。代表的な構成は次のとおりです。
@@ -188,10 +192,10 @@ specdojo catalog validate --project prj-0001
188
192
 
189
193
  # 3.1 カタログが指す成果物ファイル本体を一括生成する
190
194
  specdojo deliverable scaffold --project prj-0001
191
- specdojo catalog build --project prj-0001
195
+ specdojo build --only catalog --project prj-0001
192
196
 
193
197
  # 4. sch-strategy-launch.yaml を用意し、track schedule を生成する
194
- specdojo schedule build --project prj-0001 --track launch --force
198
+ specdojo build --only schedule --project prj-0001 --track launch --force
195
199
 
196
200
  # 5. 実行状態、Ready、CPMを生成する
197
201
  specdojo exec refresh --project prj-0001
@@ -11,84 +11,101 @@ specdojo:
11
11
 
12
12
  Business Acceptance Criteria Writing Recipe
13
13
 
14
- 業務仕様から利用者が受け入れられる状態を取り出し、前提・行為・結果・証跡へ具体化する作成手順です。正常完了だけでなく、判断を止める場面と次の担当へ渡す情報を掘り下げます。
14
+ 業務仕様から利用者が受け入れられる状態を取り出し、前提・行為・結果・証跡へ具体化する作り方を示す。
15
15
 
16
16
  ## 1. このレシピの使い方
17
17
 
18
- - 上位の業務目的から、誰が何をできずに困っているかを引き継ぎ、受入で守る価値を絞る。
19
- - 業務が成立したと言える状態を先に書き、その状態へ至る前提と行為を逆算する。実装方式と詳細なテスト操作は後続の担当へ渡す。
20
- - 業務仕様の判断とシナリオ ID、確認する証跡を結ぶ。根拠がない期待値は新たに決めず、判断依頼として残す。
18
+ - 業務受入条件は、上位の目的から誰の困りごとを解くか(Why)を引き継ぎ、業務が成立した状態(What)を決め、そこへ至る前提と業務行為(How)を逆算する。期待結果は根拠・シナリオ ID・証跡でたどれるようにする(Trace)。
19
+ - 「作成前に集める情報」をメモでそろえてから、「全体の作成手順」の順に書く。
21
20
 
22
21
  ## 2. 作成前に集める情報
23
22
 
24
- | 項目 | 集める情報・問い |
25
- | -------------- | ------------------------------------------------------------------------------------------ |
26
- | 利用者と価値 | 誰のどの負担・誤判断・引き継ぎ漏れを減らすか。どの場面でその価値を確認するか |
27
- | 業務の境界 | 何が起点で、どの記録や引き継ぎまでできれば終わるか |
28
- | 確定済みの根拠 | BPS・業務ルール・プロジェクト受入条件のどの判断を確認するか |
29
- | 前提 | 必要な状態、入力、判断権限は何か。不足すると何が止まるか |
30
- | 証跡と関係者 | 誰がいつ何を照合し、誰が業務的妥当性を承認するか |
31
- | 未決事項 | 期待値を決める材料はそろっているか。誰の判断をいつまでに得るか。現行の受入を止めるか |
32
- | 改訂時の影響 | 根拠の変更・廃止はどのシナリオへ及ぶか。旧 ID や期待値を参照する仕様・設計・テストはどれか |
23
+ | 項目 | 集める情報 | 取り出し元 |
24
+ | -------------- | -------------------------------------------------- | ---------------------------- |
25
+ | 利用者と価値 | 誰のどの負担・誤判断・引き継ぎ漏れを減らすか | プロジェクトの受入条件 |
26
+ | 業務の境界 | 何が起点で、どの記録や引き継ぎまでで終わるか | 業務プロセス仕様 |
27
+ | 確定済みの判断 | 不足・拒否・途中変更をどう扱うと決まっているか | 業務プロセス仕様、業務ルール |
28
+ | 前提 | 必要な状態・入力・権限と、不足すると止まること | 業務プロセス仕様 |
29
+ | 確認者と証跡 | 誰がいつ何を照合して合否を決め、誰が合意するか | 業務担当者の代表への確認 |
30
+ | 未決の論点 | 期待値を決める材料がない場面と、受入を止めるか否か | 確認の過程のメモ |
33
31
 
34
32
  ## 3. 全体の作成手順
35
33
 
36
- 1. 概要に受入対象、価値、利用場面、範囲と対象外を書く。価値ごとに確認する場面を選び、確認者と承認者が合意する内容をそろえる。
37
- 2. 受入条件に、代表的な正常完了を一つ書く。開始状態を前提、担当者の業務行為を操作、終了状態を期待結果へ分け、根拠と ID を添える。
38
- 3. 期待結果の各項目に、確認時点・確認者・証跡を対応させて判定方法を書く。確認できない結果は観測可能な記録か状態へ具体化する。
39
- 4. 不足・拒否・途中変更などで結果が変わる場面を加える。同じ行為と観測点で入力だけが違う場合はケース表で差分を示す。
40
- 5. 概要の価値とシナリオ ID を結び、確認できない価値や根拠のないシナリオを見つける。未確定の期待値はメモ / 将来課題へ移し、影響、判断依頼先、解消時点、追跡先を整理する。
41
- 6. 改訂では旧 ID・条件の参照元を検索し、変更する期待結果、判定方法、後続テストを洗い出す。未決の業務判断は入力元へ戻し、BA の影響整理を QE・ARC・PO の確認と PM の追従作業管理へ渡す。
34
+ 1. 概要の受入対象と価値を最初に書く。業務の終わりが決まらないと、シナリオの範囲が決まらない。
35
+ 2. 正常完了のシナリオを一つ書く。終了状態を先に決め、開始状態と業務行為を逆算する。
36
+ 3. 期待結果ごとに、誰がいつどの記録で確かめるかを書く。
37
+ 4. 不足・拒否・途中変更・再開で結果が変わる場面を足す。
38
+ 5. 根拠で期待値を決められない場面をメモ / 将来課題へ移す。
39
+ 6. 最後に価値とシナリオ ID の対応を見直す。書いた後のほうが、確認漏れの価値に気づきやすい。
42
40
 
43
41
  ## 4. 各章の書き方
44
42
 
45
43
  ### 4.1. 概要
46
44
 
47
- - 問い: この受入に合格すると、誰が次にどの業務を進められるか。隣の業務の判断まで引き受けていないか。
48
- - 具体化: 利用者の困りごとを一つ選び、開始点と終了点を先に決める。価値を確認するシナリオ ID を添え、対象外の業務を別文書で扱うならその参照先を示す。
49
- - 良い例: 「家族が店番しても販売・在庫を記録して引き継げる」。悪い例: 「販売画面を作る」。手段だけで受入の価値を表していない。
45
+ 問い:
46
+
47
+ - この受入に合格すると、誰が次にどの業務を進められるか。
48
+ - 隣の業務の判断まで引き受けていないか。
49
+
50
+ コツ:
51
+
52
+ - 画面名から書くと、手段が受入対象になりやすい。困りごとを一つ選び、開始点と終了点を先に決める。
53
+ - 上位の目的や受入条件の本文は、写さず参照に置き換える。
50
54
 
51
55
  ### 4.2. 受入条件
52
56
 
53
- - 問い: その前提でその行為を行ったとき、何が変わり、何が変わらないか。別の人も同じ証跡から合否を判断できるか。
54
- - 具体化: 一つの記録を照合する場面から始め、正常、入力不足、停止後の再開で異なる結果を探す。必要な数値には単位と確認時点を添える。期待結果を一項目ずつ読み、確認者・確認時点・観測先・照合対象に抜けがないか確かめる。
55
- - 良い例: 「数量 2 の販売後に在庫が 5 から 3 へ減ることを確定後の記録で照合する」。悪い例: 「在庫が正しい」。確認する差分を特定できない。
57
+ 問い:
58
+
59
+ - その前提でその行為を行うと、何が変わり、何が変わらないか。
60
+ - 別の人も同じ証跡から合否を判断できるか。
61
+
62
+ コツ:
63
+
64
+ - 業務担当者に「確定したと誰がどの記録で分かるか」を聞くと、操作の列挙から観測できる結果へ移れる。
65
+ - 数値には単位と確認時点を付ける。
56
66
 
57
67
  ### 4.3. メモ / 将来課題
58
68
 
59
- - 問い: どのシナリオの期待値が未確定で、誰の判断があれば何を再開できるか。現行の受入、期限、依存先へどの影響が及ぶか。
60
- - 具体化: 確認・追記作業は `_TODO_`、意思決定待ちは `_UNDECIDED_` で区別し、解消条件を添える。現行の受入や追従作業に影響する論点は、BA が影響を整理して PM へ PJR 登録候補として渡し、登録後は個票への参照で追跡する。将来拡張は追加条件を考え、未決がなければ「なし」で閉じる。
61
- - 良い例: 「記録不能時の販売継続は店主代表が当該シナリオ作成前に判断する。BA が販売停止への影響を整理して PM へ渡し、登録後は個票を追跡する」。悪い例: 「例外は後で追加」。影響と判断の追跡先が分からない。
69
+ 問い:
70
+
71
+ - どのシナリオの期待値が未確定で、誰の判断があれば再開できるか。
72
+ - その論点は現行の受入を止めるか、将来の拡張か。
73
+
74
+ コツ:
75
+
76
+ - 既定値で期待結果を埋めたくなったら、論点として残す。
77
+ - 受入を止める論点は、当面どの経路を保留するかを聞いて書く。
62
78
 
63
79
  ## 5. 深掘り手順
64
80
 
65
- 1. 概要の価値からシナリオをたどり、確認されない価値と、価値・根拠に結び付かないシナリオを探す。
66
- 2. 正常シナリオの前提を一つずつ外し、業務を進めてよいか、結果を確定してよいかを問う。担当者の権限や入力の不足で止める範囲を掘り下げる。
67
- 3. 行為の途中で入力や対象が変わる場面を置き、以前の記録をそのまま利用できるかを確認する。
68
- 4. 停止後に次の担当が受け取る情報をたどり、再開に必要な状態と証跡を特定する。根拠で判断できないものは未決事項へ戻す。
81
+ 内容が浅いときは、次の順で対応のない主張を探す。
82
+
83
+ 1. 概要の価値からシナリオをたどり、確認されない価値と、根拠に結び付かないシナリオを探す。
84
+ 2. 正常シナリオの前提を一つずつ外し、業務を進めてよいか、結果を確定してよいかを問う。
85
+ 3. 途中で入力や対象が変わる場面を置き、前の記録を使えるかを確かめる。
86
+ 4. 停止後に次の担当が受け取る情報をたどり、再開に要る状態と証跡を特定する。
69
87
 
70
88
  ## 6. 良い例 / 悪い例
71
89
 
72
- | 観点 | 良い例 | 悪い例 | 良し悪しを分ける点 |
73
- | ---- | -------------------------------------------- | ------------------------------ | ------------------------------------ |
74
- | 根拠 | 業務仕様の入力不足の扱いをシナリオで確認する | 書き手が不足時の既定値を決める | 決定済みの判断を受入へ変換しているか |
75
- | 操作 | 家族利用者代表が販売を確定する | ボタンと画面遷移を列挙する | 業務行為として読めるか |
76
- | 停止 | 販売を確定せず、不足情報を担当者へ渡す | エラーを表示する | 未確定の範囲と次の手が分かるか |
77
- | 判定 | 確定後の販売記録と在庫差分を照合する | 動けば合格とする | 証跡から再現可能か |
90
+ | 観点 | 良い例 | 悪い例 |
91
+ | -------- | ---------------------------------------------------- | ------------------------------ |
92
+ | 受入対象 | 家族が店番しても販売と在庫を記録して引き継げる | 販売画面を作る |
93
+ | 根拠 | 業務仕様で決まった入力不足の扱いをシナリオで確かめる | 書き手が不足時の既定値を決める |
94
+ | 操作 | 家族利用者代表が販売を確定する | ボタンと画面遷移を列挙する |
95
+ | 停止 | 販売を確定せず、不足情報を担当者へ渡す | エラーを表示する |
96
+ | 判定 | 数量 2 の販売の確定後、在庫が 5 から 3 へ減ると照合 | 在庫が正しい |
97
+ | 未決 | 記録不能時の販売継続は未決とし、その経路の受入を保留 | 例外は後で追加 |
78
98
 
79
99
  ## 7. レビュー観点
80
100
 
81
- | 観点 | 確認する問い |
82
- | ---------- | -------------------------------------------------------------------------------------------------------------------- |
83
- | 業務価値 | 各シナリオの必要性を利用者の課題または根拠の判断から説明できるか |
84
- | 観測可能性 | 前提・操作と期待結果がつながり、確認時点と証跡を特定できるか |
85
- | 例外と継承 | 止める判断・記録と、次の担当の行為を区別できるか |
86
- | 責務境界 | 新しい承認規則や実装方式を受入条件の中で決めていないか |
87
- | 合意と継承 | BA の整理した範囲を QE が検証へ、ARC が設計へ引き継げるか。PO が判断する合意対象と PM が追跡する残作業を特定できるか |
101
+ | 観点 | 確認内容 |
102
+ | ---------- | ------------------------------------------------------ |
103
+ | 業務価値 | 各シナリオの必要性を利用者の困りごとから説明できるか |
104
+ | 例外と継承 | 止める判断と、次の担当の行為を区別できるか |
105
+ | 責務境界 | 新しい判断規則や実装方式を受入条件の中で決めていないか |
88
106
 
89
107
  ## 8. 仕上げチェック
90
108
 
91
- - シナリオ ID と根拠をたどれ、同じ意味のケースを重ねていない。改訂時は旧参照と期待値の更新先を特定できる。
92
- - 共有前提と例外の前提が両立し、未決の値を確定済みの期待結果へ混ぜていない。
93
- - 構文・保存構造・詳細テスト操作を整理し、必要な観測点、確認者、承認待ちの影響を残している。
94
- - 条件を合意できる状態と試行済みの合格実績を区別し、準備作業や未決事項を解消済みとして扱っていない。
109
+ - 概要の各価値がシナリオ ID で確認され、各シナリオが根拠へたどれる。
110
+ - 未決の値を確定済みの期待結果へ混ぜていない。
111
+ - 条件を合意できる状態と、受入を試行して合格した実績を区別している。