specdojo 0.1.0 → 0.2.1

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 (540) hide show
  1. package/LICENSE +22 -0
  2. package/README.md +142 -35
  3. package/dist/agent-response.js +27 -0
  4. package/dist/agent.js +124 -0
  5. package/dist/build-command.js +149 -0
  6. package/dist/build-if-stale.js +35 -0
  7. package/dist/catalog-build.js +1079 -0
  8. package/dist/catalog-generate.js +226 -0
  9. package/dist/catalog-paths.js +31 -0
  10. package/dist/catalog-plan-generate.js +301 -0
  11. package/dist/catalog-plan-prompt.js +73 -0
  12. package/dist/catalog-plan.js +471 -0
  13. package/dist/catalog-scaffold.js +255 -0
  14. package/dist/catalog-types.js +4 -0
  15. package/dist/catalog.js +606 -0
  16. package/dist/dashboard.js +990 -0
  17. package/dist/deliverable-trash.js +148 -0
  18. package/dist/deliverable.js +97 -0
  19. package/dist/dist-freshness.js +150 -0
  20. package/dist/doc-index.js +424 -0
  21. package/dist/exec-agent-config.js +172 -0
  22. package/dist/exec-agent-git-state.js +136 -0
  23. package/dist/exec-agent-protected-config.js +276 -0
  24. package/dist/exec-events.js +250 -112
  25. package/dist/exec-evidence.js +317 -0
  26. package/dist/exec-format.js +54 -0
  27. package/dist/exec-limit.js +202 -0
  28. package/dist/exec-parent-validation.js +169 -0
  29. package/dist/exec-pipeline-state.js +160 -0
  30. package/dist/exec-plans.js +1016 -0
  31. package/dist/exec-project.js +25 -11
  32. package/dist/exec-protection-handoff.js +169 -0
  33. package/dist/exec-provider-scaffold.js +99 -0
  34. package/dist/exec-register-resume.js +196 -0
  35. package/dist/exec-register.js +281 -0
  36. package/dist/exec-reporter.js +329 -0
  37. package/dist/exec-results.js +510 -0
  38. package/dist/exec-run-lock.js +149 -0
  39. package/dist/exec-run.js +4953 -0
  40. package/dist/exec-schedule-calendar.js +86 -9
  41. package/dist/exec-schedule-cpm.js +30 -12
  42. package/dist/exec-schedule-gantt-chart-render.js +428 -0
  43. package/dist/exec-schedule-gantt-chart-scope.js +111 -0
  44. package/dist/exec-schedule-gantt-chart.js +2 -0
  45. package/dist/exec-schedule-hash.js +34 -25
  46. package/dist/exec-schedule-index.js +200 -67
  47. package/dist/exec-schedule-initial.js +100 -0
  48. package/dist/exec-schedule-progress.js +51 -26
  49. package/dist/exec-schedule-ready.js +71 -27
  50. package/dist/exec-schedule.js +171 -93
  51. package/dist/exec-shared.js +146 -25
  52. package/dist/exec-strategy.js +547 -0
  53. package/dist/exec-task-view.js +64 -0
  54. package/dist/exec-trial.js +895 -0
  55. package/dist/exec-worktree-command.js +426 -0
  56. package/dist/exec-worktree-ops.js +847 -0
  57. package/dist/exec-worktree.js +359 -0
  58. package/dist/exec.js +744 -192
  59. package/dist/frontmatter-namespace.js +48 -0
  60. package/dist/git-environment.js +23 -0
  61. package/dist/grade-result.js +137 -0
  62. package/dist/grade.js +2456 -0
  63. package/dist/index-command.js +103 -0
  64. package/dist/job.js +1081 -0
  65. package/dist/kata-command.js +303 -0
  66. package/dist/kata.js +187 -0
  67. package/dist/package-paths.js +33 -0
  68. package/dist/practice-id.js +24 -0
  69. package/dist/register-date.js +122 -0
  70. package/dist/register-events.js +363 -0
  71. package/dist/register-history.js +323 -0
  72. package/dist/register-item.js +455 -0
  73. package/dist/register-migrate-timestamps.js +176 -0
  74. package/dist/register.js +2199 -0
  75. package/dist/review-plan.js +199 -0
  76. package/dist/review-types.js +1 -0
  77. package/dist/role-types.js +1 -0
  78. package/dist/routine.js +814 -0
  79. package/dist/schedule-approach.js +252 -0
  80. package/dist/schedule-build.js +552 -0
  81. package/dist/schedule-phase-sets.js +73 -0
  82. package/dist/schedule-strategy-generate.js +812 -0
  83. package/dist/schedule-strategy-profiles.js +276 -0
  84. package/dist/schedule.js +420 -0
  85. package/dist/spawn-self.js +28 -0
  86. package/dist/specdojo-config.js +133 -39
  87. package/dist/specdojo.js +56 -7
  88. package/dist/template-frontmatter.js +89 -0
  89. package/dist/template-resolution.js +92 -0
  90. package/dist/timeline-build.js +334 -0
  91. package/dist/timeline.js +107 -0
  92. package/dist/watch.js +313 -0
  93. package/dist/yaml-pages-command.js +28 -0
  94. package/dist/yaml-pages.js +180 -0
  95. package/dist/yaml-schema-modeline.js +49 -0
  96. package/docs/ja/specdojo/defaults/pm-review-viewpoints.yaml +600 -0
  97. package/docs/ja/specdojo/exec-templates/xep-bootstrap-template.md +120 -0
  98. package/docs/ja/specdojo/exec-templates/xep-common-conventions-template.md +37 -0
  99. package/docs/ja/specdojo/exec-templates/xep-cross-deliverable-dedup-template.md +51 -0
  100. package/docs/ja/specdojo/exec-templates/xep-freeform-template.md +74 -0
  101. package/docs/ja/specdojo/exec-templates/xep-fully-guided-template.md +109 -0
  102. package/docs/ja/specdojo/exec-templates/xep-job-template.md +43 -0
  103. package/docs/ja/specdojo/exec-templates/xep-recipe-guided-template.md +82 -0
  104. package/docs/ja/specdojo/exec-templates/xep-recipe-maintenance-template.md +86 -0
  105. package/docs/ja/specdojo/exec-templates/xep-register-investigate-template.md +42 -0
  106. package/docs/ja/specdojo/exec-templates/xep-register-template.md +49 -0
  107. package/docs/ja/specdojo/exec-templates/xep-retrofit-template.md +98 -0
  108. package/docs/ja/specdojo/exec-templates/xep-rulebook-maintenance-template.md +86 -0
  109. package/docs/ja/specdojo/exec-templates/xep-sample-maintenance-template.md +86 -0
  110. package/docs/ja/specdojo/exec-templates/xep-template-maintenance-template.md +86 -0
  111. package/docs/ja/specdojo/exec-templates/xep-template.md +66 -0
  112. package/docs/ja/specdojo/exec-templates/xer-cross-deliverable-dedup-template.md +31 -0
  113. package/docs/ja/specdojo/exec-templates/xer-human-bootstrap-finalize-template.md +40 -0
  114. package/docs/ja/specdojo/exec-templates/xer-human-finalize-template.md +30 -0
  115. package/docs/ja/specdojo/exec-templates/xer-template.md +19 -0
  116. package/docs/ja/specdojo/exec-templates/xrp-freeform-template.md +70 -0
  117. package/docs/ja/specdojo/exec-templates/xrp-fully-guided-template.md +97 -0
  118. package/docs/ja/specdojo/exec-templates/xrp-recipe-guided-template.md +76 -0
  119. package/docs/ja/specdojo/exec-templates/xrp-recipe-maintenance-template.md +73 -0
  120. package/docs/ja/specdojo/exec-templates/xrp-retrofit-template.md +74 -0
  121. package/docs/ja/specdojo/exec-templates/xrp-rulebook-maintenance-template.md +74 -0
  122. package/docs/ja/specdojo/exec-templates/xrp-sample-maintenance-template.md +73 -0
  123. package/docs/ja/specdojo/exec-templates/xrp-template-maintenance-template.md +73 -0
  124. package/docs/ja/specdojo/exec-templates/xrp-template.md +67 -0
  125. package/docs/ja/specdojo/exec-templates/xrp-viewpoint-detail-template.md +7 -0
  126. package/docs/ja/specdojo/exec-templates/xrr-template.md +21 -0
  127. package/docs/ja/specdojo/exec-templates/xrr-viewpoint-detail-template.md +7 -0
  128. package/docs/ja/specdojo/guides/branch-workflow-guide.md +354 -0
  129. package/docs/ja/specdojo/guides/docs-editing-guide.md +327 -0
  130. package/docs/ja/specdojo/guides/docs-structure-guide.md +519 -0
  131. package/docs/ja/specdojo/guides/exec-config-guide.md +589 -0
  132. package/docs/ja/specdojo/guides/exec-operation-guide.md +440 -0
  133. package/docs/ja/specdojo/guides/exec-worktree-guide.md +318 -0
  134. package/docs/ja/specdojo/guides/kata-guide.md +89 -0
  135. package/docs/ja/specdojo/guides/orchestrator-operation-guide.md +127 -0
  136. package/docs/ja/specdojo/guides/plan-result-lifecycle-guide.md +228 -0
  137. package/docs/ja/specdojo/guides/practice-system-composition-guide.md +111 -0
  138. package/docs/ja/specdojo/guides/quick-start-guide.md +472 -0
  139. package/docs/ja/specdojo/guides/register-operation-guide.md +418 -0
  140. package/docs/ja/specdojo/guides/remote-host-development-guide.md +163 -0
  141. package/docs/ja/specdojo/guides/review-guide.md +428 -0
  142. package/docs/ja/specdojo/guides/routine-operation-guide.md +282 -0
  143. package/docs/ja/specdojo/guides/ryu-guide.md +230 -0
  144. package/docs/ja/specdojo/guides/schedule-design-guide.md +429 -0
  145. package/docs/ja/specdojo/guides/schedule-operation-guide.md +151 -0
  146. package/docs/ja/specdojo/guides/specdojo-overview-guide.md +257 -0
  147. package/docs/ja/specdojo/guides/timeline-design-guide.md +160 -0
  148. package/docs/ja/specdojo/guides/track-design-guide.md +215 -0
  149. package/docs/ja/specdojo/guides/use-case-guide.md +133 -0
  150. package/docs/ja/specdojo/guides/waza-guide.md +224 -0
  151. package/docs/ja/specdojo/index.md +33 -0
  152. package/docs/ja/specdojo/philosophy/needs-to-implementation-philosophy.md +212 -0
  153. package/docs/ja/specdojo/philosophy/specdojo-philosophy.md +242 -0
  154. package/docs/ja/specdojo/recipes/cdfd-overview-recipe.md +198 -0
  155. package/docs/ja/specdojo/recipes/cdfd-recipe.md +218 -0
  156. package/docs/ja/specdojo/recipes/cdfd-uc-recipe.md +198 -0
  157. package/docs/ja/specdojo/recipes/exec-human-finalize-recipe.md +100 -0
  158. package/docs/ja/specdojo/recipes/ifx-cmd-recipe.md +148 -0
  159. package/docs/ja/specdojo/recipes/pm-communication-plan-recipe.md +97 -0
  160. package/docs/ja/specdojo/recipes/pm-members-recipe.md +149 -0
  161. package/docs/ja/specdojo/recipes/pm-organization-recipe.md +96 -0
  162. package/docs/ja/specdojo/recipes/pm-plan-recipe.md +98 -0
  163. package/docs/ja/specdojo/recipes/pm-quality-management-plan-recipe.md +97 -0
  164. package/docs/ja/specdojo/recipes/pm-raci-recipe.md +96 -0
  165. package/docs/ja/specdojo/recipes/pm-roles-recipe.md +136 -0
  166. package/docs/ja/specdojo/recipes/prj-assumptions-constraints-dependencies-recipe.md +162 -0
  167. package/docs/ja/specdojo/recipes/prj-charter-recipe.md +187 -0
  168. package/docs/ja/specdojo/recipes/prj-comparison-of-alternatives-recipe.md +235 -0
  169. package/docs/ja/specdojo/recipes/prj-issues-and-approach-recipe.md +205 -0
  170. package/docs/ja/specdojo/recipes/prj-overview-recipe.md +289 -0
  171. package/docs/ja/specdojo/recipes/prj-scope-recipe.md +201 -0
  172. package/docs/ja/specdojo/recipes/prj-stakeholder-register-recipe.md +168 -0
  173. package/docs/ja/specdojo/recipes/prj-success-criteria-and-acceptance-criteria-recipe.md +179 -0
  174. package/docs/ja/specdojo/recipes/stsd-recipe.md +138 -0
  175. package/docs/ja/specdojo/references/command-reference.md +718 -0
  176. package/docs/ja/specdojo/references/deliverables-reference.md +407 -0
  177. package/docs/ja/specdojo/references/directory-layout-reference.md +280 -0
  178. package/docs/ja/specdojo/references/specdojo-config-reference.md +133 -0
  179. package/docs/ja/specdojo/rulebooks/atc-index-rulebook.md +372 -0
  180. package/docs/ja/specdojo/rulebooks/atc-rulebook.md +302 -0
  181. package/docs/ja/specdojo/rulebooks/bac-rulebook.md +331 -0
  182. package/docs/ja/specdojo/rulebooks/bdd-rulebook.md +134 -0
  183. package/docs/ja/specdojo/rulebooks/bds-rulebook.md +207 -0
  184. package/docs/ja/specdojo/rulebooks/bes-index-rulebook.md +102 -0
  185. package/docs/ja/specdojo/rulebooks/bes-rulebook.md +131 -0
  186. package/docs/ja/specdojo/rulebooks/bps-rulebook.md +269 -0
  187. package/docs/ja/specdojo/rulebooks/br-rulebook.md +187 -0
  188. package/docs/ja/specdojo/rulebooks/ccd-mermaid-rulebook.md +279 -0
  189. package/docs/ja/specdojo/rulebooks/cdfd-mermaid-rulebook.md +219 -0
  190. package/docs/ja/specdojo/rulebooks/cdfd-overview-rulebook.md +233 -0
  191. package/docs/ja/specdojo/rulebooks/cdfd-rulebook.md +182 -0
  192. package/docs/ja/specdojo/rulebooks/cdfd-uc-rulebook.md +171 -0
  193. package/docs/ja/specdojo/rulebooks/cdsd-rulebook.md +105 -0
  194. package/docs/ja/specdojo/rulebooks/cld-rulebook.md +195 -0
  195. package/docs/ja/specdojo/rulebooks/cnd-mermaid-rulebook.md +285 -0
  196. package/docs/ja/specdojo/rulebooks/cnd-rulebook.md +292 -0
  197. package/docs/ja/specdojo/rulebooks/cop-index-rulebook.md +171 -0
  198. package/docs/ja/specdojo/rulebooks/cop-rulebook.md +325 -0
  199. package/docs/ja/specdojo/rulebooks/cpd-mermaid-rulebook.md +266 -0
  200. package/docs/ja/specdojo/rulebooks/cpd-rulebook.md +294 -0
  201. package/docs/ja/specdojo/rulebooks/cstd-rulebook.md +21 -0
  202. package/docs/ja/specdojo/rulebooks/cxd-mermaid-rulebook.md +401 -0
  203. package/docs/ja/specdojo/rulebooks/cxd-rulebook.md +311 -0
  204. package/docs/ja/specdojo/rulebooks/dct-index-rulebook.md +158 -0
  205. package/docs/ja/specdojo/rulebooks/dct-rulebook.md +287 -0
  206. package/docs/ja/specdojo/rulebooks/dec-rulebook.md +62 -0
  207. package/docs/ja/specdojo/rulebooks/dmd-index-rulebook.md +100 -0
  208. package/docs/ja/specdojo/rulebooks/dmd-rulebook.md +298 -0
  209. package/docs/ja/specdojo/rulebooks/etc-index-rulebook.md +379 -0
  210. package/docs/ja/specdojo/rulebooks/etc-rulebook.md +310 -0
  211. package/docs/ja/specdojo/rulebooks/gl-rulebook.md +86 -0
  212. package/docs/ja/specdojo/rulebooks/ifd-mermaid-rulebook.md +297 -0
  213. package/docs/ja/specdojo/rulebooks/ifx-api-rulebook.md +79 -0
  214. package/docs/ja/specdojo/rulebooks/ifx-cmd-rulebook.md +213 -0
  215. package/docs/ja/specdojo/rulebooks/ifx-file-rulebook.md +311 -0
  216. package/docs/ja/specdojo/rulebooks/ifx-index-rulebook.md +94 -0
  217. package/docs/ja/specdojo/rulebooks/ifx-msg-rulebook.md +81 -0
  218. package/docs/ja/specdojo/rulebooks/imp-business-rulebook.md +117 -0
  219. package/docs/ja/specdojo/rulebooks/imp-data-rulebook.md +118 -0
  220. package/docs/ja/specdojo/rulebooks/imp-interface-rulebook.md +116 -0
  221. package/docs/ja/specdojo/rulebooks/imp-operations-rulebook.md +116 -0
  222. package/docs/ja/specdojo/rulebooks/imp-test-rulebook.md +116 -0
  223. package/docs/ja/specdojo/rulebooks/itc-index-rulebook.md +421 -0
  224. package/docs/ja/specdojo/rulebooks/itc-rulebook.md +307 -0
  225. package/docs/ja/specdojo/rulebooks/mip-index-rulebook.md +312 -0
  226. package/docs/ja/specdojo/rulebooks/mm-rulebook.md +63 -0
  227. package/docs/ja/specdojo/rulebooks/mtp-rulebook.md +353 -0
  228. package/docs/ja/specdojo/rulebooks/nfr-availability-rulebook.md +184 -0
  229. package/docs/ja/specdojo/rulebooks/nfr-index-rulebook.md +179 -0
  230. package/docs/ja/specdojo/rulebooks/nfr-integrity-rulebook.md +184 -0
  231. package/docs/ja/specdojo/rulebooks/nfr-maintainability-rulebook.md +183 -0
  232. package/docs/ja/specdojo/rulebooks/nfr-operations-rulebook.md +185 -0
  233. package/docs/ja/specdojo/rulebooks/nfr-performance-rulebook.md +185 -0
  234. package/docs/ja/specdojo/rulebooks/nfr-reliability-rulebook.md +186 -0
  235. package/docs/ja/specdojo/rulebooks/nfr-security-safety-rulebook.md +186 -0
  236. package/docs/ja/specdojo/rulebooks/nfr-usability-rulebook.md +184 -0
  237. package/docs/ja/specdojo/rulebooks/ntp-rulebook.md +61 -0
  238. package/docs/ja/specdojo/rulebooks/opd-index-rulebook.md +84 -0
  239. package/docs/ja/specdojo/rulebooks/opd-rulebook.md +357 -0
  240. package/docs/ja/specdojo/rulebooks/opr-index-rulebook.md +80 -0
  241. package/docs/ja/specdojo/rulebooks/opr-rulebook.md +484 -0
  242. package/docs/ja/specdojo/rulebooks/otp-index-rulebook.md +120 -0
  243. package/docs/ja/specdojo/rulebooks/otp-rulebook.md +293 -0
  244. package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +211 -0
  245. package/docs/ja/specdojo/rulebooks/pm-change-request-log-rulebook.md +94 -0
  246. package/docs/ja/specdojo/rulebooks/pm-communication-plan-rulebook.md +116 -0
  247. package/docs/ja/specdojo/rulebooks/pm-issue-log-rulebook.md +93 -0
  248. package/docs/ja/specdojo/rulebooks/pm-members-rulebook.md +190 -0
  249. package/docs/ja/specdojo/rulebooks/pm-organization-rulebook.md +108 -0
  250. package/docs/ja/specdojo/rulebooks/pm-plan-rulebook.md +122 -0
  251. package/docs/ja/specdojo/rulebooks/pm-quality-management-plan-rulebook.md +117 -0
  252. package/docs/ja/specdojo/rulebooks/pm-raci-rulebook.md +116 -0
  253. package/docs/ja/specdojo/rulebooks/pm-risk-register-rulebook.md +93 -0
  254. package/docs/ja/specdojo/rulebooks/pm-roles-rulebook.md +146 -0
  255. package/docs/ja/specdojo/rulebooks/pr-rulebook.md +65 -0
  256. package/docs/ja/specdojo/rulebooks/prj-assumptions-constraints-dependencies-rulebook.md +178 -0
  257. package/docs/ja/specdojo/rulebooks/prj-charter-rulebook.md +232 -0
  258. package/docs/ja/specdojo/rulebooks/prj-comparison-of-alternatives-rulebook.md +235 -0
  259. package/docs/ja/specdojo/rulebooks/prj-issues-and-approach-rulebook.md +242 -0
  260. package/docs/ja/specdojo/rulebooks/prj-overview-rulebook.md +187 -0
  261. package/docs/ja/specdojo/rulebooks/prj-scope-rulebook.md +201 -0
  262. package/docs/ja/specdojo/rulebooks/prj-stakeholder-register-rulebook.md +165 -0
  263. package/docs/ja/specdojo/rulebooks/prj-success-criteria-and-acceptance-criteria-rulebook.md +165 -0
  264. package/docs/ja/specdojo/rulebooks/sac-rulebook.md +202 -0
  265. package/docs/ja/specdojo/rulebooks/sch-rulebook.md +139 -0
  266. package/docs/ja/specdojo/rulebooks/sf-index-rulebook.md +63 -0
  267. package/docs/ja/specdojo/rulebooks/sf-rulebook.md +93 -0
  268. package/docs/ja/specdojo/rulebooks/sld-rulebook.md +93 -0
  269. package/docs/ja/specdojo/rulebooks/stc-index-rulebook.md +329 -0
  270. package/docs/ja/specdojo/rulebooks/stc-rulebook.md +297 -0
  271. package/docs/ja/specdojo/rulebooks/stsd-mermaid-rulebook.md +132 -0
  272. package/docs/ja/specdojo/rulebooks/stsd-rulebook.md +215 -0
  273. package/docs/ja/specdojo/rulebooks/sysd-critical-flows-rulebook.md +376 -0
  274. package/docs/ja/specdojo/rulebooks/sysd-cross-cutting-policy-rulebook.md +313 -0
  275. package/docs/ja/specdojo/rulebooks/sysd-index-rulebook.md +246 -0
  276. package/docs/ja/specdojo/rulebooks/sysd-rulebook.md +119 -0
  277. package/docs/ja/specdojo/rulebooks/tml-rulebook.md +188 -0
  278. package/docs/ja/specdojo/rulebooks/trc-requirements-to-specs-rulebook.md +114 -0
  279. package/docs/ja/specdojo/rulebooks/trc-requirements-to-tests-rulebook.md +117 -0
  280. package/docs/ja/specdojo/rulebooks/tsd-index-rulebook.md +101 -0
  281. package/docs/ja/specdojo/rulebooks/tsd-rulebook.md +103 -0
  282. package/docs/ja/specdojo/rulebooks/tsp-index-rulebook.md +396 -0
  283. package/docs/ja/specdojo/rulebooks/uis-rulebook.md +207 -0
  284. package/docs/ja/specdojo/rulebooks/utc-index-rulebook.md +387 -0
  285. package/docs/ja/specdojo/rulebooks/utc-rulebook.md +303 -0
  286. package/docs/ja/specdojo/samples/atc-index-sample.md +38 -0
  287. package/docs/ja/specdojo/samples/atc-sample.md +41 -0
  288. package/docs/ja/specdojo/samples/bac-sample.md +38 -0
  289. package/docs/ja/specdojo/samples/bdd-sample.yaml +71 -0
  290. package/docs/ja/specdojo/samples/bds-sample.md +38 -0
  291. package/docs/ja/specdojo/samples/bes-index-sample.md +38 -0
  292. package/docs/ja/specdojo/samples/bes-sample.md +38 -0
  293. package/docs/ja/specdojo/samples/bps-sample.md +38 -0
  294. package/docs/ja/specdojo/samples/br-sample.md +40 -0
  295. package/docs/ja/specdojo/samples/ccd-sample.md +38 -0
  296. package/docs/ja/specdojo/samples/cdfd-overview-sample.md +284 -0
  297. package/docs/ja/specdojo/samples/cdfd-sample.md +229 -0
  298. package/docs/ja/specdojo/samples/cdfd-uc-sample.md +146 -0
  299. package/docs/ja/specdojo/samples/cdsd-sample.md +38 -0
  300. package/docs/ja/specdojo/samples/cld-sample.md +38 -0
  301. package/docs/ja/specdojo/samples/cnd-sample.md +38 -0
  302. package/docs/ja/specdojo/samples/cop-index-sample.md +38 -0
  303. package/docs/ja/specdojo/samples/cop-sample.md +38 -0
  304. package/docs/ja/specdojo/samples/cpd-sample.md +38 -0
  305. package/docs/ja/specdojo/samples/cstd-sample.md +11 -0
  306. package/docs/ja/specdojo/samples/cxd-sample.md +38 -0
  307. package/docs/ja/specdojo/samples/dct-index-sample.yaml +39 -0
  308. package/docs/ja/specdojo/samples/dct-sample.yaml +91 -0
  309. package/docs/ja/specdojo/samples/dec-sample.md +39 -0
  310. package/docs/ja/specdojo/samples/dmd-index-sample.md +50 -0
  311. package/docs/ja/specdojo/samples/dmd-sample.md +74 -0
  312. package/docs/ja/specdojo/samples/etc-index-sample.md +38 -0
  313. package/docs/ja/specdojo/samples/etc-sample.md +38 -0
  314. package/docs/ja/specdojo/samples/gl-sample.yaml +37 -0
  315. package/docs/ja/specdojo/samples/ifd-sample.md +38 -0
  316. package/docs/ja/specdojo/samples/ifx-api-sample.yaml +102 -0
  317. package/docs/ja/specdojo/samples/ifx-cmd-sample.yaml +107 -0
  318. package/docs/ja/specdojo/samples/ifx-file-sample.md +38 -0
  319. package/docs/ja/specdojo/samples/ifx-msg-sample.yaml +89 -0
  320. package/docs/ja/specdojo/samples/imp-business-sample.md +66 -0
  321. package/docs/ja/specdojo/samples/imp-data-sample.md +60 -0
  322. package/docs/ja/specdojo/samples/imp-interface-sample.md +60 -0
  323. package/docs/ja/specdojo/samples/imp-operations-sample.md +60 -0
  324. package/docs/ja/specdojo/samples/imp-test-sample.md +60 -0
  325. package/docs/ja/specdojo/samples/itc-index-sample.md +38 -0
  326. package/docs/ja/specdojo/samples/itc-sample.md +38 -0
  327. package/docs/ja/specdojo/samples/mip-index-sample.md +38 -0
  328. package/docs/ja/specdojo/samples/mm-sample.md +35 -0
  329. package/docs/ja/specdojo/samples/mtp-sample.md +38 -0
  330. package/docs/ja/specdojo/samples/nfr-availability-sample.md +38 -0
  331. package/docs/ja/specdojo/samples/nfr-index-sample.md +38 -0
  332. package/docs/ja/specdojo/samples/nfr-integrity-sample.md +38 -0
  333. package/docs/ja/specdojo/samples/nfr-maintainability-sample.md +38 -0
  334. package/docs/ja/specdojo/samples/nfr-operations-sample.md +38 -0
  335. package/docs/ja/specdojo/samples/nfr-performance-sample.md +38 -0
  336. package/docs/ja/specdojo/samples/nfr-reliability-sample.md +38 -0
  337. package/docs/ja/specdojo/samples/nfr-security-safety-sample.md +38 -0
  338. package/docs/ja/specdojo/samples/nfr-usability-sample.md +38 -0
  339. package/docs/ja/specdojo/samples/ntp-sample.md +38 -0
  340. package/docs/ja/specdojo/samples/opd-access-control-sample.md +29 -0
  341. package/docs/ja/specdojo/samples/opd-incident-management-sample.md +31 -0
  342. package/docs/ja/specdojo/samples/opd-index-sample.md +41 -0
  343. package/docs/ja/specdojo/samples/opd-monitoring-sample.md +32 -0
  344. package/docs/ja/specdojo/samples/opd-sample.md +38 -0
  345. package/docs/ja/specdojo/samples/opr-access-control-sample.md +24 -0
  346. package/docs/ja/specdojo/samples/opr-backup-restore-sample.md +27 -0
  347. package/docs/ja/specdojo/samples/opr-batch-sample.md +23 -0
  348. package/docs/ja/specdojo/samples/opr-change-sample.md +24 -0
  349. package/docs/ja/specdojo/samples/opr-incident-sample.md +38 -0
  350. package/docs/ja/specdojo/samples/opr-index-sample.md +43 -0
  351. package/docs/ja/specdojo/samples/opr-monitoring-sample.md +27 -0
  352. package/docs/ja/specdojo/samples/opr-sample.md +38 -0
  353. package/docs/ja/specdojo/samples/opr-support-sample.md +23 -0
  354. package/docs/ja/specdojo/samples/otp-index-sample.md +66 -0
  355. package/docs/ja/specdojo/samples/otp-sample.md +68 -0
  356. package/docs/ja/specdojo/samples/pm-change-request-log-sample.md +47 -0
  357. package/docs/ja/specdojo/samples/pm-communication-plan-sample.md +46 -0
  358. package/docs/ja/specdojo/samples/pm-issue-log-sample.md +45 -0
  359. package/docs/ja/specdojo/samples/pm-members-sample.yaml +103 -0
  360. package/docs/ja/specdojo/samples/pm-organization-sample.md +46 -0
  361. package/docs/ja/specdojo/samples/pm-plan-sample.md +57 -0
  362. package/docs/ja/specdojo/samples/pm-quality-management-plan-sample.md +52 -0
  363. package/docs/ja/specdojo/samples/pm-raci-sample.md +57 -0
  364. package/docs/ja/specdojo/samples/pm-risk-register-sample.md +43 -0
  365. package/docs/ja/specdojo/samples/pm-roles-sample.yaml +41 -0
  366. package/docs/ja/specdojo/samples/pr-sample.md +39 -0
  367. package/docs/ja/specdojo/samples/prj-assumptions-constraints-dependencies-sample.md +57 -0
  368. package/docs/ja/specdojo/samples/prj-charter-sample.md +121 -0
  369. package/docs/ja/specdojo/samples/prj-comparison-of-alternatives-sample.md +105 -0
  370. package/docs/ja/specdojo/samples/prj-issues-and-approach-sample.md +78 -0
  371. package/docs/ja/specdojo/samples/prj-overview-sample.md +95 -0
  372. package/docs/ja/specdojo/samples/prj-scope-sample.md +71 -0
  373. package/docs/ja/specdojo/samples/prj-stakeholder-register-sample.md +60 -0
  374. package/docs/ja/specdojo/samples/prj-success-criteria-and-acceptance-criteria-sample.md +62 -0
  375. package/docs/ja/specdojo/samples/sac-sample.md +38 -0
  376. package/docs/ja/specdojo/samples/sf-index-sample.md +38 -0
  377. package/docs/ja/specdojo/samples/sf-sample.md +38 -0
  378. package/docs/ja/specdojo/samples/sld-sample.md +38 -0
  379. package/docs/ja/specdojo/samples/stc-index-sample.md +38 -0
  380. package/docs/ja/specdojo/samples/stc-sample.md +38 -0
  381. package/docs/ja/specdojo/samples/stsd-sample.md +58 -0
  382. package/docs/ja/specdojo/samples/sysd-critical-flows-sample.md +38 -0
  383. package/docs/ja/specdojo/samples/sysd-cross-cutting-policy-sample.md +38 -0
  384. package/docs/ja/specdojo/samples/sysd-index-sample.md +38 -0
  385. package/docs/ja/specdojo/samples/trc-requirements-to-specs-sample.md +56 -0
  386. package/docs/ja/specdojo/samples/trc-requirements-to-tests-sample.md +56 -0
  387. package/docs/ja/specdojo/samples/tsd-index-sample.md +29 -0
  388. package/docs/ja/specdojo/samples/tsd-sample.md +38 -0
  389. package/docs/ja/specdojo/samples/tsp-index-sample.md +38 -0
  390. package/docs/ja/specdojo/samples/uis-sample.md +38 -0
  391. package/docs/ja/specdojo/samples/utc-index-sample.md +38 -0
  392. package/docs/ja/specdojo/samples/utc-sample.md +38 -0
  393. package/docs/ja/specdojo/schemas/v1/guide-content.schema.yaml +20 -0
  394. package/docs/ja/specdojo/schemas/v1/philosophy-content.schema.yaml +21 -0
  395. package/docs/ja/specdojo/schemas/v1/reference-content.schema.yaml +21 -0
  396. package/docs/ja/specdojo/standards/document-metadata-standard.md +323 -0
  397. package/docs/ja/specdojo/standards/exec-human-finalize-standard.md +75 -0
  398. package/docs/ja/specdojo/standards/git-branching-standard.md +227 -0
  399. package/docs/ja/specdojo/standards/guide-authoring-standard.md +124 -0
  400. package/docs/ja/specdojo/standards/id-and-file-naming-standard.md +929 -0
  401. package/docs/ja/specdojo/standards/job-definition-standard.md +148 -0
  402. package/docs/ja/specdojo/standards/people-and-organization-definition-standard.md +431 -0
  403. package/docs/ja/specdojo/standards/philosophy-authoring-standard.md +113 -0
  404. package/docs/ja/specdojo/standards/recipe-authoring-standard.md +143 -0
  405. package/docs/ja/specdojo/standards/reference-authoring-standard.md +99 -0
  406. package/docs/ja/specdojo/standards/rulebook-authoring-standard.md +140 -0
  407. package/docs/ja/specdojo/standards/sample-authoring-standard.md +151 -0
  408. package/docs/ja/specdojo/standards/standard-authoring-standard.md +108 -0
  409. package/docs/ja/specdojo/standards/template-authoring-standard.md +101 -0
  410. package/docs/ja/specdojo/standards/test-document-scope-standard.md +176 -0
  411. package/docs/ja/specdojo/templates/cdfd-overview-template.md +199 -0
  412. package/docs/ja/specdojo/templates/cdfd-template.md +173 -0
  413. package/docs/ja/specdojo/templates/cdfd-uc-template.md +148 -0
  414. package/docs/ja/specdojo/templates/dct-architecture-template.yaml +136 -0
  415. package/docs/ja/specdojo/templates/dct-business-acceptance-criteria-template.yaml +34 -0
  416. package/docs/ja/specdojo/templates/dct-business-model-bes-template.yaml +75 -0
  417. package/docs/ja/specdojo/templates/dct-business-model-bps-template.yaml +49 -0
  418. package/docs/ja/specdojo/templates/dct-business-model-br-template.yaml +50 -0
  419. package/docs/ja/specdojo/templates/dct-data-flow-template.yaml +40 -0
  420. package/docs/ja/specdojo/templates/dct-data-model-bdd-template.yaml +46 -0
  421. package/docs/ja/specdojo/templates/dct-data-model-ccd-template.yaml +46 -0
  422. package/docs/ja/specdojo/templates/dct-data-model-cdsd-template.yaml +41 -0
  423. package/docs/ja/specdojo/templates/dct-data-model-cld-template.yaml +38 -0
  424. package/docs/ja/specdojo/templates/dct-data-model-sld-template.yaml +38 -0
  425. package/docs/ja/specdojo/templates/dct-data-model-stsd-template.yaml +46 -0
  426. package/docs/ja/specdojo/templates/dct-external-interface-specs-template.yaml +114 -0
  427. package/docs/ja/specdojo/templates/dct-glossary-template.yaml +35 -0
  428. package/docs/ja/specdojo/templates/dct-impact-analysis-template.yaml +138 -0
  429. package/docs/ja/specdojo/templates/dct-index-template.md +40 -0
  430. package/docs/ja/specdojo/templates/dct-migration-planning-template.yaml +148 -0
  431. package/docs/ja/specdojo/templates/dct-non-functional-requirements-template.yaml +222 -0
  432. package/docs/ja/specdojo/templates/dct-operations-template.yaml +108 -0
  433. package/docs/ja/specdojo/templates/dct-project-definition-template.yaml +210 -0
  434. package/docs/ja/specdojo/templates/dct-project-management-template.yaml +423 -0
  435. package/docs/ja/specdojo/templates/dct-system-acceptance-criteria-template.yaml +37 -0
  436. package/docs/ja/specdojo/templates/dct-system-design-template.yaml +82 -0
  437. package/docs/ja/specdojo/templates/dct-system-functions-template.yaml +58 -0
  438. package/docs/ja/specdojo/templates/dct-test-specs-template.yaml +261 -0
  439. package/docs/ja/specdojo/templates/dct-user-interface-model-template.yaml +60 -0
  440. package/docs/ja/specdojo/templates/ifx-cmd-template.yaml +88 -0
  441. package/docs/ja/specdojo/templates/opr-template.md +85 -0
  442. package/docs/ja/specdojo/templates/pjr-change-request-template.md +60 -0
  443. package/docs/ja/specdojo/templates/pjr-decision-template.md +61 -0
  444. package/docs/ja/specdojo/templates/pjr-index-template.md +49 -0
  445. package/docs/ja/specdojo/templates/pjr-issue-template.md +50 -0
  446. package/docs/ja/specdojo/templates/pjr-note-template.md +35 -0
  447. package/docs/ja/specdojo/templates/pjr-question-template.md +53 -0
  448. package/docs/ja/specdojo/templates/pjr-risk-template.md +49 -0
  449. package/docs/ja/specdojo/templates/pjr-todo-template.md +41 -0
  450. package/docs/ja/specdojo/templates/pjr-views-by-owner-template.md +22 -0
  451. package/docs/ja/specdojo/templates/pjr-views-by-priority-template.md +22 -0
  452. package/docs/ja/specdojo/templates/pjr-views-by-status-template.md +22 -0
  453. package/docs/ja/specdojo/templates/pm-change-request-log-template.md +20 -0
  454. package/docs/ja/specdojo/templates/pm-communication-plan-template.md +46 -0
  455. package/docs/ja/specdojo/templates/pm-decision-log-template.md +20 -0
  456. package/docs/ja/specdojo/templates/pm-issue-log-template.md +20 -0
  457. package/docs/ja/specdojo/templates/pm-members-template.yaml +105 -0
  458. package/docs/ja/specdojo/templates/pm-organization-template.md +44 -0
  459. package/docs/ja/specdojo/templates/pm-plan-template.md +52 -0
  460. package/docs/ja/specdojo/templates/pm-quality-management-plan-template.md +46 -0
  461. package/docs/ja/specdojo/templates/pm-raci-template.md +51 -0
  462. package/docs/ja/specdojo/templates/pm-risk-register-template.md +20 -0
  463. package/docs/ja/specdojo/templates/pm-roles-template.yaml +53 -0
  464. package/docs/ja/specdojo/templates/prj-assumptions-constraints-dependencies-template.md +59 -0
  465. package/docs/ja/specdojo/templates/prj-charter-template.md +116 -0
  466. package/docs/ja/specdojo/templates/prj-comparison-of-alternatives-template.md +116 -0
  467. package/docs/ja/specdojo/templates/prj-issues-and-approach-template.md +89 -0
  468. package/docs/ja/specdojo/templates/prj-overview-template.md +85 -0
  469. package/docs/ja/specdojo/templates/prj-scope-template.md +75 -0
  470. package/docs/ja/specdojo/templates/prj-stakeholder-register-template.md +64 -0
  471. package/docs/ja/specdojo/templates/prj-success-criteria-and-acceptance-criteria-template.md +60 -0
  472. package/docs/ja/specdojo/templates/stsd-template.md +57 -0
  473. package/docs/specdojo/schemas/v1/bdd.schema.yaml +230 -0
  474. package/docs/specdojo/schemas/v1/common-frontmatter.schema.yaml +77 -0
  475. package/docs/specdojo/schemas/v1/dct-index.schema.yaml +85 -0
  476. package/docs/specdojo/schemas/v1/dct-plan.schema.yaml +324 -0
  477. package/docs/specdojo/schemas/v1/dct.schema.yaml +368 -0
  478. package/docs/specdojo/schemas/v1/deliverable-frontmatter.schema.yaml +91 -0
  479. package/docs/specdojo/schemas/v1/esil.schema.yaml +142 -0
  480. package/docs/specdojo/schemas/v1/exec-common.schema.yaml +101 -0
  481. package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +272 -0
  482. package/docs/specdojo/schemas/v1/exec-evidence.schema.yaml +162 -0
  483. package/docs/specdojo/schemas/v1/exec-plan-frontmatter.schema.yaml +126 -0
  484. package/docs/specdojo/schemas/v1/exec-reporter-output.schema.yaml +151 -0
  485. package/docs/specdojo/schemas/v1/exec-result-frontmatter.schema.yaml +144 -0
  486. package/docs/specdojo/schemas/v1/grade-done-criteria.schema.yaml +79 -0
  487. package/docs/specdojo/schemas/v1/grade-pipeline-state.schema.yaml +60 -0
  488. package/docs/specdojo/schemas/v1/grade-result.schema.yaml +118 -0
  489. package/docs/specdojo/schemas/v1/guide-frontmatter.schema.yaml +19 -0
  490. package/docs/specdojo/schemas/v1/ifx-cmd.schema.yaml +293 -0
  491. package/docs/specdojo/schemas/v1/job-run.schema.yaml +90 -0
  492. package/docs/specdojo/schemas/v1/job.schema.yaml +198 -0
  493. package/docs/specdojo/schemas/v1/philosophy-frontmatter.schema.yaml +19 -0
  494. package/docs/specdojo/schemas/v1/pipeline-state.schema.yaml +56 -0
  495. package/docs/specdojo/schemas/v1/pm-members.schema.yaml +252 -0
  496. package/docs/specdojo/schemas/v1/pm-review-viewpoints.schema.yaml +387 -0
  497. package/docs/specdojo/schemas/v1/pm-roles.schema.yaml +106 -0
  498. package/docs/specdojo/schemas/v1/recipe-frontmatter.schema.yaml +27 -0
  499. package/docs/specdojo/schemas/v1/reference-frontmatter.schema.yaml +18 -0
  500. package/docs/specdojo/schemas/v1/register-events.schema.yaml +106 -0
  501. package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +204 -0
  502. package/docs/specdojo/schemas/v1/routine-run.schema.yaml +36 -0
  503. package/docs/specdojo/schemas/v1/routine.schema.yaml +87 -0
  504. package/docs/specdojo/schemas/v1/rulebook-frontmatter.schema.yaml +61 -0
  505. package/docs/specdojo/schemas/v1/sch-common.schema.yaml +258 -0
  506. package/docs/specdojo/schemas/v1/sch-defaults.schema.yaml +48 -0
  507. package/docs/specdojo/schemas/v1/sch-milestones.schema.yaml +64 -0
  508. package/docs/specdojo/schemas/v1/sch-strategy.schema.yaml +772 -0
  509. package/docs/specdojo/schemas/v1/sch-track.schema.yaml +66 -0
  510. package/docs/specdojo/schemas/v1/standard-frontmatter.schema.yaml +18 -0
  511. package/docs/specdojo/schemas/v1/tml-index.schema.yaml +103 -0
  512. package/package.json +121 -24
  513. package/templates/antigravity/README.md +35 -0
  514. package/templates/antigravity/exec-defaults-snippet.yaml +38 -0
  515. package/templates/antigravity/orchestrator.md +146 -0
  516. package/templates/antigravity/pm-members-snippet.yaml +55 -0
  517. package/templates/claude/README.md +46 -0
  518. package/templates/claude/agents/claude-expert-review-executor.md +14 -0
  519. package/templates/claude/agents/claude-review-executor.md +14 -0
  520. package/templates/claude/agents/specdojo-orchestrator.md +153 -0
  521. package/templates/claude/settings.edit.json +6 -0
  522. package/templates/claude/settings.report.json +6 -0
  523. package/templates/claude/settings.review.json +7 -0
  524. package/templates/codex/README.md +61 -0
  525. package/templates/codex/agents/codex-executor.toml +12 -0
  526. package/templates/codex/agents/codex-expert-executor.toml +12 -0
  527. package/templates/codex/agents/codex-expert-review-executor.toml +10 -0
  528. package/templates/codex/agents/codex-review-executor.toml +10 -0
  529. package/templates/codex/agents/specdojo-orchestrator.toml +154 -0
  530. package/templates/codex/orchestrator.md +146 -0
  531. package/templates/copilot/README.md +41 -0
  532. package/templates/copilot/exec-defaults-snippet.yaml +28 -0
  533. package/templates/copilot/pm-members-snippet.yaml +44 -0
  534. package/templates/opencode/README.md +41 -0
  535. package/templates/opencode/agents/opencode-executor.md +59 -0
  536. package/templates/opencode/agents/opencode-reporter.md +26 -0
  537. package/templates/opencode/agents/opencode-review-executor.md +48 -0
  538. package/templates/opencode/agents/specdojo-orchestrator.md +193 -0
  539. package/dist/exec-schedule-timeline-render.js +0 -201
  540. package/dist/exec-schedule-timeline.js +0 -2
@@ -0,0 +1,718 @@
1
+ ---
2
+ specdojo:
3
+ id: specdojo:command-reference
4
+ type: reference
5
+ status: draft
6
+ supersedes:
7
+ - command-reference-guide
8
+ ---
9
+
10
+ # CLIコマンドリファレンス
11
+
12
+ CLI Command Reference
13
+
14
+ `specdojo` CLI の主要コマンドを、用途、代表例、主要オプションに絞って説明します。背景や運用手順は各専門ガイドを参照します。
15
+
16
+ **対象範囲**
17
+
18
+ - `specdojo` CLI の主要コマンド(config / kata / catalog / deliverable / schedule / register / exec / agent / grade / index / watch / build / routine)
19
+
20
+ **ここで引けるもの**
21
+
22
+ - コマンドごとの用途と実行例、全体で共通のオプション、コマンド別の主要オプション
23
+
24
+ **詳細の参照先**
25
+
26
+ - CLI 全体の流れは [遂行の技活用ガイド](../guides/waza-guide.md)、運用上の判断と手順は各コマンド節からリンクした専門ガイドを参照してください。
27
+
28
+ ## 1. 共通オプション
29
+
30
+ | オプション | 用途 | 主な対象 |
31
+ | ----------------- | -------------------------------------------------- | ------------------------------------------ |
32
+ | `--project <id>` | 対象 project を明示する | project に紐づくコマンド |
33
+ | `--dry-run` | 書き込みや実行を行わず予定内容を表示する | scaffold / build / run / worktree / kata |
34
+ | `--force` | 既存ファイルの上書きや通常拒否される操作を明示する | scaffold / schedule build / release / kata |
35
+ | `--scope <scope>` | build / watch の対象範囲を絞る | `build` / `watch` |
36
+
37
+ project の解決順序と設定は [遂行の技活用ガイド](../guides/waza-guide.md) を参照します。
38
+
39
+ ## 2. config / project
40
+
41
+ | コマンド | 用途 | 例 |
42
+ | ----------------- | ------------------------------------------ | ------------------------------------------- |
43
+ | `config init` | `specdojo.config.json` を作成する | `specdojo config init` |
44
+ | `config scaffold` | provider の agent・settings 設定を配置する | `specdojo config scaffold --provider codex` |
45
+ | `project list` | 登録済み project を表示する | `specdojo project list` |
46
+
47
+ `config init` は、register 単体で始められる `prj-0001` の最小設定を作成し、設定確認、任意の
48
+ provider 設定、登録簿作成の順に次のコマンドを案内します。`config scaffold` の `--provider` には
49
+ `claude`、`codex`、`copilot`、`opencode` を指定でき、`--dry-run` と `--force` も利用できます。
50
+
51
+ `current_project` を設定しておくと、多くのコマンドで `--project` を省略できます。
52
+
53
+ ### 2.1. kata
54
+
55
+ `kata` は、利用リポジトリで上書きした実践体系と npm package から参照中の実践体系を確認・取得します。対象種別は rulebook / standard / recipe / sample / template です。同じ正準パスにファイルがある場合は利用リポジトリ側を優先します。
56
+
57
+ | コマンド | 用途 | 例 |
58
+ | ---------------- | ------------------------------------------------------- | ------------------------------------------------ |
59
+ | `kata list` | kata を解決元と eject 可否つきで一覧表示 | `specdojo kata list --all` |
60
+ | `kata show <id>` | 解決順序に従って kata の内容を表示 | `specdojo kata show specdojo:pjr-rulebook` |
61
+ | `kata status` | 参照中 / eject 済みと package 原本との差分を表示 | `specdojo kata status --kind template` |
62
+ | `kata eject` | package の 1 ファイルを利用リポジトリの正準パスへコピー | `specdojo kata eject --id specdojo:pjr-rulebook` |
63
+ | `kata install` | eject 可能な全種別を利用リポジトリへコピー | `specdojo kata install --all --dry-run` |
64
+
65
+ 主要オプション:
66
+
67
+ | オプション | 用途 |
68
+ | --------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
69
+ | `--kind <kind>` | `list` / `show` / `status` を対象種別で絞る |
70
+ | `--dry-run` | コピー系では予定だけを表示する。閲覧系でも共通指定として受理する |
71
+ | `--force` | `eject` / `install --all` で既存ファイルを上書きする |
72
+ | `--all` | `list` で eject できない `exec-template` / `schema` も表示する。`install` では rulebook / standard / recipe / sample / template の全ファイルを対象にする |
73
+
74
+ `status` の `ejected` は利用リポジトリ側を参照している状態、`referenced` は package 側を参照している状態です。eject 済みのファイルは package 原本と比較し、`same` / `modified` / `package-missing` を表示します。
75
+
76
+ `list` は既定で eject できる種別だけを表示します。`EJECTABLE` 列が `no` の `exec-template` と `schema` は `--all` または `--kind exec-template` のように種別を指定したときに表示します。これらの ID は frontmatter を持たないためファイル名由来(`xep-template`、`dct-plan.schema`)になり、`specdojo:` の接頭辞が付きません。`show` は種別を問わず参照できます。
77
+
78
+ `eject` と `install --all` は既存ファイルを `--force` なしで上書きせず、`skip` として表示します。CLI と同じバージョンで使う必要がある `exec-templates` と `schemas` は個別 eject の対象外で、指定すると参照固定である旨を表示して終了コード 1 で終わります。`install --all` は docs サイト配信やオフライン運用向けの明示的な全量取得であり、通常のセットアップ導線では使用しません。
79
+
80
+ ## 3. catalog / deliverable
81
+
82
+ `catalog` は成果物カタログ(`dct-*.yaml`)を扱います。
83
+
84
+ | コマンド | 用途 | 例 |
85
+ | ------------------ | ---------------------------------------- | ---------------------------------------------- |
86
+ | `catalog scaffold` | テンプレートから `dct-*.yaml` を生成する | `specdojo catalog scaffold --project prj-0001` |
87
+ | `catalog where` | catalog 関連パスを表示する | `specdojo catalog where --project prj-0001` |
88
+ | `catalog validate` | `dct-*.yaml` を検証する | `specdojo catalog validate --project prj-0001` |
89
+ | `catalog build` | `generated/dct-*.md` を生成する | `specdojo catalog build --project prj-0001` |
90
+
91
+ `deliverable` はカタログが指す、人が編集する成果物ファイル本体を扱います。
92
+
93
+ | コマンド | 用途 | 例 |
94
+ | ---------------------- | ----------------------------------------------------------------------- | ---------------------------------------------------------------------------------- |
95
+ | `deliverable scaffold` | `dct-*.yaml` が指す成果物ファイル本体を生成する | `specdojo deliverable scaffold --project prj-0001` |
96
+ | `deliverable trash` | 非推奨化した成果物ファイルを `trash` ディレクトリへ移動する(idは不変) | `specdojo deliverable trash --project prj-0001 --local-id cdfd-register-operation` |
97
+
98
+ 主要オプション:
99
+
100
+ | オプション | 用途 |
101
+ | -------------------- | ------------------------------------------------------------------------- |
102
+ | `--size <size>` | `small` / `medium` / `large` の成果物セットを選ぶ |
103
+ | `--project-id <id>` | 生成ファイルに埋め込む project ID を上書きする |
104
+ | `--domain <domain>` | `catalog scaffold` の対象をtemplateの`domain`で絞る(反復・カンマ区切り) |
105
+ | `--var <NAME=value>` | `catalog scaffold` で`_NAME_` placeholderを置換する(反復可能) |
106
+ | `--plan` | 保存済みの `dct-plan-<domain>.yaml` から決定論的に生成する |
107
+ | `--dry-run` | `--plan` の生成結果と既存ファイルとの差分を、書き込まずに表示する |
108
+ | `--dct <name>` | `deliverable scaffold` の対象を特定の `dct-*.yaml` に絞る(後述) |
109
+ | `--force` | 既存ファイルを上書きする |
110
+
111
+ `catalog scaffold`は、`--domain`を省略すると従来どおりすべてのDCT templateを対象にします。指定した場合は、ファイル名ではなくtemplate内の`domain`が一致するものだけを生成します。存在しないdomainを指定した場合は、部分的な生成を行わずエラーで終了します。
112
+
113
+ `--var`はtemplate内の文字列に含まれる`_NAME_`を置換します。`local_id`、`path`、`depends_on`、名称、概要、注記も同じ値で展開されます。`PROJECT_ID`は予約済みであり、project IDの上書きには`--project-id`を使用します。変数指定後もplaceholderが残る成果物は従来どおり生成対象から除外し、除外した`local_id`を警告します。
114
+
115
+ ```bash
116
+ specdojo catalog scaffold \
117
+ --project prj-0001 \
118
+ --size large \
119
+ --domain data-flow,data-model \
120
+ --domain business-model \
121
+ --var TERM=specdojo \
122
+ --var DOMAIN=specdojo
123
+ ```
124
+
125
+ `--dct <name>` で対象を特定の `dct-*.yaml` に絞れます。`name` は `dct-` プレフィックスや `.yaml` の有無を問わず、ドメイン名(例: `project-definition`)でも一致します。カンマ区切りまたは複数回指定で複数のカタログを対象にできます。指定名に一致する `dct-*.yaml` がない場合はエラーで終了します。
126
+
127
+ `deliverable scaffold` が使用する template は、各成果物の `rulebook` を辿り、rulebook frontmatter の `template` 文書 ID から解決します。同じ rulebook を参照する成果物は template を共有できます。`template: not-needed`、`template: undecided`、項目省略では template を使用せず、最小雛形を生成します。`local_id` と同名の template を暗黙には探索しません。
128
+
129
+ ```bash
130
+ specdojo deliverable scaffold --project prj-0001 --dct project-definition
131
+ specdojo deliverable scaffold --project prj-0001 --dct dct-project-definition.yaml,dct-project-management.yaml
132
+ ```
133
+
134
+ `deliverable scaffold` の生成方針と `specdojo build` に含めない理由は [遂行の技活用ガイド](../guides/waza-guide.md) の `deliverable scaffold の生成方針`、生成系動詞の使い分けは同ガイドの `生成系動詞の標準`、成果物カタログから Schedule への展開は [Schedule設計ガイド](../guides/schedule-design-guide.md) の `成果物カタログとの責務分担` を参照します。
135
+
136
+ ### 3.1. catalog plan(成果物インスタンスの判定)
137
+
138
+ `catalog plan` は、data-flow 等の上流成果物からどの成果物インスタンスが必要かを agent が判定した結果(`dct-plan-<domain>.yaml`)を扱います。判定結果はカタログディレクトリ配下の `plans/` に保存し、後続の決定論的ジェネレーターの入力にします。
139
+
140
+ | コマンド | 用途 | 例 |
141
+ | ----------------------- | ------------------------------------------------------------- | ---------------------------------------------------------------------- |
142
+ | `catalog plan prompt` | agent へ渡す判定指示(入力文書・出力規約)を出力する | `specdojo catalog plan prompt --project prj-0001 --domain data-flow` |
143
+ | `catalog plan scaffold` | 判定計画の骨組みを作る、または agent の判定結果を検証保存する | `specdojo catalog plan scaffold --project prj-0001 --domain data-flow` |
144
+ | `catalog plan validate` | 保存済みの `dct-plan-*.yaml` を検証する | `specdojo catalog plan validate --project prj-0001` |
145
+
146
+ 主要オプション:
147
+
148
+ | オプション | 用途 |
149
+ | ------------------- | ---------------------------------------------------------- |
150
+ | `--domain <domain>` | 対象ドメインを指定する(`prompt` / `scaffold` は必須) |
151
+ | `--input <path>` | data-flow 以外の上流成果物を入力として明示する(反復可能) |
152
+ | `--from <path>` | agent が出力した判定計画を検証して正準パスへ保存する |
153
+ | `--out <path>` | `catalog plan prompt` の出力をファイルへ書き出す |
154
+ | `--dry-run` | 書き込まずに差分を表示する |
155
+ | `--force` | 既存の判定計画を上書きする |
156
+
157
+ 運用手順は次のとおりです。
158
+
159
+ ```bash
160
+ specdojo catalog plan prompt --project prj-0001 --domain data-flow --out logs/dct-plan-prompt.md
161
+ # 上記の指示で agent に判定させ、出力 YAML を保存先候補へ書き出す
162
+ specdojo catalog plan scaffold --project prj-0001 --domain data-flow --from <agent-output>.yaml
163
+ specdojo catalog plan validate --project prj-0001 --domain data-flow
164
+ specdojo catalog scaffold --project prj-0001 --domain data-flow --plan --dry-run
165
+ specdojo catalog scaffold --project prj-0001 --domain data-flow --plan
166
+ ```
167
+
168
+ `catalog plan scaffold` は、`--from` を省略すると入力文書と未確定事項だけを埋めた骨組みを作ります。既存の判定計画がある場合は上書きせず、差分を表示して終了します。上書きは `--force` で明示します。
169
+
170
+ 判定に使う data-flow 成果物が 1 件も無いドメインでは、`--input` で上流成果物を明示しない限りエラーで終了します。`trash/` へ移動した非推奨成果物は入力に含めません。既に `dct-<domain>.yaml` があるドメインでは、既存カタログを基準線として入力に記録し、差分レビューを促す警告を出します。
171
+
172
+ 検証では、スキーマ適合に加えて、template との対応、placeholder の解決、パターンA / パターンBの整合、`local_id` の重複、`depends_on` の解決を確認します。未解決の placeholder や根拠の無い判断はエラーになり、`open_questions` へ移すよう促されます。スキーマ単体で検証する場合は次を実行します。
173
+
174
+ `catalog scaffold --plan` は判定済み plan と同じ `domain` の template をすべて読み、通常の scaffold と同じ `min_size`・placeholder・`part_of`・group・base path 規則で `dct-<domain>.yaml` を生成します。物理分割 template は `dct-<domain>-<part>.yaml` のまま生成します。検証エラーや既存ファイル競合が一件でもあれば、その domain のファイルは一件も書き込みません。既存内容を変更する場合は、`--dry-run` の差分を確認してから `--force` を指定します。
175
+
176
+ ```bash
177
+ npm run validate:schema:file -- \
178
+ --schema docs/specdojo/schemas/v1/dct-plan.schema.yaml \
179
+ --data "docs/ja/**/plans/dct-plan-*.yaml" --allow-empty
180
+ ```
181
+
182
+ ## 4. schedule
183
+
184
+ `schedule` は `sch-strategy-<track>.yaml` から `sch-track-<track>.yaml` を生成します。
185
+
186
+ | コマンド | 用途 | 例 |
187
+ | ---------------- | --------------------------------------- | ------------------------------------------------------------------- |
188
+ | `schedule build` | strategy から track schedule を生成する | `specdojo schedule build --project prj-0001 --track launch --force` |
189
+ | `schedule where` | schedule 関連パスを表示する | `specdojo schedule where --project prj-0001` |
190
+
191
+ 主要オプション:
192
+
193
+ | オプション | 用途 |
194
+ | ----------------- | -------------------------------------------- |
195
+ | `--track <track>` | 生成対象 track を指定する |
196
+ | `--force` | 既存の `sch-track-<track>.yaml` を上書きする |
197
+ | `--dry-run` | 生成予定を確認する |
198
+
199
+ `--track` で指定した `sch-track-<track>.yaml` だけを生成・上書きします。プロジェクト共通の `sch-milestones.yaml` は、同じ `schedule_path` にある全 `sch-strategy-*.yaml` から再構築するため、指定外 track のマイルストーンも保持されます。既存 ID の表示順は維持し、新規 ID は末尾へ追加します。全 strategy のいずれかが不正、project ID が不一致、またはマイルストーン ID が重複している場合は、生成物を書き込まずに停止します。
200
+
201
+ Schedule設計の詳細は [Schedule設計ガイド](../guides/schedule-design-guide.md) を参照します。
202
+
203
+ ### 4.1. schedule strategy(決定論的な strategy 生成)
204
+
205
+ `schedule strategy generate` は、DCT、Timeline、strategy の `approach_rules`、Kata の保存済み grade、標準 strategy profile から `sch-strategy-<track>.yaml` を生成します。先に strategy へ scope と成果物別 intent を宣言してください。
206
+
207
+ ```bash
208
+ specdojo schedule strategy generate \
209
+ --project prj-0001 \
210
+ --track data-model \
211
+ --default-owner ARC \
212
+ --gate-owner PM \
213
+ --milestone-owner PM \
214
+ --dry-run
215
+ specdojo schedule strategy generate \
216
+ --project prj-0001 \
217
+ --track data-model \
218
+ --default-owner ARC \
219
+ --gate-owner PM \
220
+ --milestone-owner PM
221
+ ```
222
+
223
+ 主要オプション:
224
+
225
+ | オプション | 用途 |
226
+ | -------------------------- | ------------------------------------------------------------------ |
227
+ | `--owner <local_id=ROLE>` | 一成果物の主担当を明示する(反復可能) |
228
+ | `--default-owner <ROLE>` | 既存 strategy から解決できない成果物の既定主担当 |
229
+ | `--gate-owner <ROLE>` | 生成する phase gate の owner |
230
+ | `--milestone-owner <ROLE>` | 生成する group milestone の owner |
231
+ | `--pass-owner <ROLE>` | owner が複数にまたがる横断 pass の主担当 |
232
+ | `--no-bootstrap-ordering` | 非 bootstrap 成果物を代表 bootstrap の後へ置く既定動作を無効にする |
233
+ | `--dry-run` / `--force` | 差分だけを表示する / 確認済みの差分で既存 strategy を上書きする |
234
+
235
+ 主担当の解決順は `--owner`、既存 strategy の `owner_rules`、`--default-owner` です。DCT の `done_criteria.roles` はレビュー担当であり、主担当として複製しません。主担当、gate / milestone / pass owner を決定できない場合、または `pm-roles.yaml` に存在しない場合は推測せず停止します。
236
+
237
+ 書き込み前に 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` の順に既存コマンドを実行します。
238
+
239
+ ## 5. timeline
240
+
241
+ `timeline` は、人間が着手前に決めた `tml-index.yaml`(トラック順序計画)から、着手順序と成果物カタログ作成の準備情報を生成します。`tml-index.yaml` が正本で、生成物は `timeline/generated/` へ出力する一方通行の流れです。
242
+
243
+ | コマンド | 用途 | 例 |
244
+ | ---------------- | ------------------------------------------------------- | -------------------------------------------- |
245
+ | `timeline build` | `tml-index.yaml` から着手順序と scaffold 対象を生成する | `specdojo timeline build --project prj-0001` |
246
+ | `timeline where` | timeline 関連パスを表示する | `specdojo timeline where --project prj-0001` |
247
+
248
+ 主要オプション:
249
+
250
+ | オプション | 用途 |
251
+ | ----------- | ---------------------------------------- |
252
+ | `--dry-run` | 生成内容を標準出力へ表示し、書き込まない |
253
+
254
+ 生成物は次の3つです。
255
+
256
+ | ファイル | 内容 |
257
+ | --------------------- | ------------------------------------------------------------------------ |
258
+ | `timeline-order.md` | `order` / `parallel_group` / `depends_on` から算出した着手 wave 一覧 |
259
+ | `catalog-scaffold.md` | `dct-<domain>.yaml` が未作成のドメインと `catalog scaffold` 実行コマンド |
260
+ | `timeline.json` | 後続コマンドが読む機械可読サマリー |
261
+
262
+ `depends_on` の未定義参照・循環、`depends_on` と `order` の矛盾、track id の重複を検出した場合は、生成物を書き込まずに終了コード 1 で停止します。`catalog_status` と実カタログの有無が食い違う場合は警告のみを出します。カタログの突き合わせはファイル名ではなく各 `dct-*.yaml` の `domain` 値で行うため、1 ドメインが複数ファイルに分割されていても検出できます。
263
+
264
+ `timeline_path` は未設定の場合、プロジェクト直下の `timeline` を既定とします。記述ルールは [タイムライン作成ルール](../rulebooks/tml-rulebook.md)、生成フローと運用タイミングは [Timeline設計ガイド](../guides/timeline-design-guide.md)、トラックの標準構成と実行順序は [トラック設計ガイド](../guides/track-design-guide.md) を参照します。
265
+
266
+ ## 6. register
267
+
268
+ `register` は個票を正本とするプロジェクト登録簿と、その生成ビューを扱います。
269
+
270
+ | コマンド | 用途 | 例 |
271
+ | ------------------- | ---------------------------------------------- | --------------------------------------------------------------------------- |
272
+ | `register scaffold` | 登録簿ディレクトリと生成ビューを初期化する | `specdojo register scaffold --project prj-0001` |
273
+ | `register add` | issue / todo / question などの項目を追加する | `specdojo register add --project prj-0001 --type issue --title "確認事項"` |
274
+ | `register build` | 個票から登録項目一覧と派生ビューを生成する | `specdojo register build --project prj-0001` |
275
+ | `register update` | 登録項目を更新する | `specdojo register update --project prj-0001 --id PJR-001 --owner PM` |
276
+ | `register start` | 項目を対応中へ変更する | `specdojo register start --project prj-0001 --id PJR-001` |
277
+ | `register wait` | 項目を待ち状態へ変更する | `specdojo register wait --project prj-0001 --id PJR-001` |
278
+ | `register review` | 項目をレビュー状態へ変更する | `specdojo register review --project prj-0001 --id PJR-001` |
279
+ | `register close` | 項目を完了にし、個票を `ready` へ昇格する | `specdojo register close --project prj-0001 --id PJR-001` |
280
+ | `register reject` | 項目を却下にし、個票を `deprecated` にする | `specdojo register reject --project prj-0001 --id PJR-001` |
281
+ | `register defer` | 項目を延期にする | `specdojo register defer --project prj-0001 --id PJR-001` |
282
+ | `register reopen` | 終了済み項目を再オープンする | `specdojo register reopen --project prj-0001 --id PJR-001` |
283
+ | `register renumber` | 重複・衝突した PJR-ID を未使用の ID へ移す | `specdojo register renumber --project prj-0001 --id PJR-0137 --to PJR-0140` |
284
+ | `register history` | 追記型 event と旧 Git 履歴から変更を再構成する | `specdojo register history --project prj-0001 --since 2026-08-01` |
285
+ | `register migrate` | 旧形式の登録簿データを現行形式へ移行する | `specdojo register migrate --project prj-0001 --dry-run` |
286
+
287
+ `register add` は ID を省略すると自動採番し、現在の作業ツリーに type 別の個票を作成します。ID は乱数部分を持ち、曖昧文字(`I` / `L` / `O` / `U`)を除いた英大文字+数字の 32 文字セットによる 4 桁(例: `PJR-4B7K`)です。個票 Frontmatter が分類、処理状態、優先度、担当、日付、結論の正本であり、`register build` は個票から一覧と派生ビューを生成します。`register` 系コマンドはすべて、成功時の通常出力を標準出力へ、エラーメッセージを標準エラー出力へ書きます。
288
+
289
+ 主要オプション:
290
+
291
+ | オプション | 用途 | 対象 |
292
+ | ------------------------- | ------------------------------------------------------------- | ----------------------------------------- |
293
+ | `--to <PJR-ID>` | 移動先の PJR-ID を指定する | `renumber` |
294
+ | `--registered <datetime>` | 起票日時(タイムゾーン付き RFC 3339)。省略時は実行時刻 | `add` |
295
+ | `--completed <datetime>` | 完了・却下日時(タイムゾーン付き RFC 3339)。省略時は実行時刻 | `close` / `reject` |
296
+ | `--by <actor>` | 追記型 event に記録する actor を指定 | `add` / 更新 / 遷移コマンド |
297
+ | `--reason <text>` | event の理由を記録(`wait` では `block_reason` も更新) | `add` / 更新 / 遷移コマンド |
298
+ | `--conclusion <text>` | 終端時の結論を記録・更新(`update` では `-` で削除) | `add` / `update` / 終端コマンド |
299
+ | `--topic <slug>` | 個票ファイル名と文書 ID の論点部分を指定・更新する | `add` / `update` |
300
+ | `--dry-run` | 書き込みを行わず変更対象を表示する | `renumber` / `add` / `update` / `migrate` |
301
+ | `--since <date>` | 対象コミットの開始日(`YYYY-MM-DD`、当日を含む) | `history` |
302
+ | `--until <date>` | 対象コミットの終了日(`YYYY-MM-DD`、当日を含む) | `history` |
303
+ | `--id <PJR-ID...>` | 出力する項目を限定する(空白・カンマ区切りで複数可) | `history` |
304
+ | `--status-only` | 追加・削除・状態遷移だけを出力する | `history` |
305
+ | `--limit <count>` | 走査するコミット数の上限 | `history` |
306
+ | `--json` | イベントを JSON で出力する | `history` |
307
+
308
+ `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` を削除します。
309
+
310
+ `--registered` / `--completed` にはタイムゾーン付きの RFC 3339 値(`2026-08-09T14:08:51Z` または `2026-08-09T23:08:51+09:00`)を指定し、保存時に UTC へ正規化します。タイムゾーンを含まない値は解釈が実行環境に依存するため受け付けません。期限(`--due`)は瞬間ではなく暦日のため `YYYY-MM-DD` のままです。
311
+
312
+ `register update --topic <slug>` は個票のファイル名と Frontmatter の文書 ID を同時に変更し、`docs/ja` 配下の旧文書 ID 参照を更新してから生成ビューを再生成します。変更は `action: update` の event に文書 ID の変更として記録されます。形式は英小文字・数字・単一ハイフン区切りに限り、変更先ファイルが存在する場合は書き込み前に停止します。
313
+
314
+ 一覧・派生ビューの「登録日」「完了日」は、保存した日時を config の `run.register_date_timezone`(IANA タイムゾーン名、既定 `UTC`)へ変換して導出する表示値です。
315
+
316
+ `register migrate` は旧形式の登録簿データを現行形式へ移す一度限りの移行コマンドです。追跡対象だった `pjr-index.md` の表を個票 Frontmatter へ移し、旧日時を UTC へ変換し、個票内の `register_events` を `events/pjr-XXXX.yaml` へ分離します。イベントがまだない項目は、利用可能な Git 履歴を項目別イベントファイルへ変換します。event ID は commit・項目 ID・変更内容から決定的に生成するため、再実行で重複しません。
317
+
318
+ `register history` は `events/pjr-XXXX.yaml` を読み、個票単位の追加(`added`)と変更(`updated`)を発生順に出力します。event 導入前または未移行の期間だけ Git 履歴を読み、削除(`removed`)を含む従来の履歴と統合します。event は発生日時・actor・action・reason・遷移前後状態・変更フィールドを保持するため、複数遷移を1コミットへまとめても粒度を失いません。比較対象は登録項目一覧の列と `block_reason` です。
319
+
320
+ 各書き込みコマンドは現在値を個票へ、event を項目別イベントファイルへ反映します。同じ現在値になる操作の再実行では event を追加しません。`register build` は個票とイベントファイルの対応、event の schema、ID 一意性、時刻順、直前イベント参照、状態連鎖、最新 event と現在値の一致を検証します。
321
+
322
+ 登録項目を agent に実行させるには `exec run --register` を使います(`exec` の章を参照)。
323
+
324
+ `renumber` による ID 重複の復旧手順、登録の判断、type の選び方、状態遷移、個票の作成などの台帳運用は [登録簿運用ガイド](../guides/register-operation-guide.md) を参照します。
325
+
326
+ ## 7. exec
327
+
328
+ `exec` は schedule に基づいたタスクの実行、状態追跡、plan/result 生成、worktree 隔離実行を扱います。
329
+
330
+ | コマンド | 用途 | 例 |
331
+ | ---------------- | ------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------- |
332
+ | `exec where` | execution 関連パスを表示する | `specdojo exec where --project prj-0001` |
333
+ | `exec validate` | schedule と event を検証する | `specdojo exec validate --project prj-0001` |
334
+ | `exec refresh` | state、Ready、CPM、gantt-chart を再計算する | `specdojo exec refresh --project prj-0001` |
335
+ | `exec scheduler` | 次のタスクを自動選択して claim する(`--dry-run` で選択のみ) | `specdojo exec scheduler --project prj-0001 --by agent-1` |
336
+ | `exec claim` | タスクを `doing` にする | `specdojo exec claim --project prj-0001 --task <task-id> --by agent-1` |
337
+ | `exec complete` | タスクを `done` にする(actor の `doing` が1件なら `--task` 省略可) | `specdojo exec complete --project prj-0001 --by agent-1` |
338
+ | `exec reopen` | 誤って完了したタスクを `done` から `todo` に戻す | `specdojo exec reopen --project prj-0001 --task <task-id> --by indie --msg "completion criteria unmet"` |
339
+ | `exec block` | タスクを `blocked` にする | `specdojo exec block --project prj-0001 --task <task-id> --by agent-1 --msg "waiting"` |
340
+ | `exec unblock` | `blocked` を `doing` に戻す | `specdojo exec unblock --project prj-0001 --task <task-id> --by agent-1 --msg "resume"` |
341
+ | `exec release` | `doing` / `blocked` を `todo` に戻す | `specdojo exec release --project prj-0001 --task <task-id> --by agent-1` |
342
+ | `exec cancel` | `todo` を `cancelled` にする | `specdojo exec cancel --project prj-0001 --task <task-id> --by agent-1 --msg "scope removed"` |
343
+ | `exec note` | メモイベントを残す | `specdojo exec note --project prj-0001 --task <task-id> --by agent-1 --msg "memo"` |
344
+ | `exec link` | 外部参照イベントを残す | `specdojo exec link --project prj-0001 --task <task-id> --by agent-1 --ref pr=https://example.com/pr/1` |
345
+ | `exec estimate` | 見積もりイベントを残す | `specdojo exec estimate --project prj-0001 --task <task-id> --by agent-1 --meta duration_days=1` |
346
+ | `exec run` | plan を生成してエージェントを実行する | `specdojo exec run --project prj-0001 --task <task-id>` |
347
+ | `exec resume` | `doing`、または due な利用制限延期 task を既存 worktree で再開する | `specdojo exec resume --project prj-0001 --due` |
348
+ | `exec cycle` | 延期 task 再開・doc-index 再構築・古い track の再生成・状態再計算・`--auto` loop を単一ロック内で順次実行する | `specdojo exec cycle --project prj-0001 --loop` |
349
+ | `exec trial` | 同一planを複数agentで隔離試行し、比較・評価・採否を管理する | `specdojo exec trial run --project prj-0001 --plan <path> --agent agent-a agent-b` |
350
+ | `exec status` | 実行状態を表示する | `specdojo exec status --project prj-0001 --state blocked` |
351
+ | `exec scaffold` | 共通レビュー観点を継承するプロジェクト差分を生成する | `specdojo exec scaffold --project prj-0001` |
352
+ | `exec plan` | plan だけを生成する | `specdojo exec plan --project prj-0001 --task <task-id>` |
353
+ | `exec archive` | 完了済み plan を `done/` へ移動する | `specdojo exec archive --project prj-0001 --task <task-id>` |
354
+
355
+ `exec scaffold --project <project-id>` は、対象 project の `viewpoints_path` へ `extends: specdojo:pm-review-viewpoints` を持つ空の差分ファイルを生成します。共通正本は [[specdojo:pm-review-viewpoints|共通レビュー観点一覧]] であり、scaffold 時点の全量コピーは作りません。そのため、共通側の更新は次回の review plan 生成時に継承 project へ反映されます。既存ファイルは既定で保持し、`--force` の指定時だけ差分雛形で置き換えます。
356
+
357
+ プロジェクト差分の upsert、無効化、独自ロールの宣言規則は [[specdojo:review-guide|レビューガイド]] を参照してください。provider 設定の推奨入口は `config scaffold --provider <name>` です。従来の `exec scaffold --provider <name>` も互換入口として同じ設定一式を生成します。
358
+
359
+ 状態イベントの `--msg` は、イベント種別によって必須・省略可が分かれます。
360
+
361
+ | コマンド | `--msg` | 省略時に記録される固定メッセージ |
362
+ | ------------------------------------------------------ | ------- | --------------------------------------------------------------------------------- |
363
+ | `claim` / `complete` / `release` / `link` / `estimate` | 省略可 | `claim task` / `complete task` / `release task` / `link refs` / `update estimate` |
364
+ | `note` / `block` / `unblock` / `reopen` / `cancel` | 必須 | -(内容・理由・再開根拠をメッセージ自体が表すため) |
365
+
366
+ 主要オプション:
367
+
368
+ | オプション | 用途 | 対象 |
369
+ | ------------------------------- | ------------------------------------------------------------------------------------------------------ | ------------------------------------------------ |
370
+ | `--task <task-id>` | 対象タスクを指定する | 状態遷移系 / `run` / `plan` |
371
+ | `--by <actor>` | 実行 actor / agent の nickname を指定する(手動ターゲットの agent 選択も兼ねる) | 状態遷移系 / `run` / `resume` / `worktree agent` |
372
+ | `--edit-by <nickname>` | `--auto` バッチで edit タスクに使う agent nickname | `run --auto` / `resume` |
373
+ | `--review-by <nickname>` | `--auto` バッチで review タスクに使う agent nickname | `run --auto` / `resume` |
374
+ | `--strategy <name>` | 選択戦略を切り替える(`critical-first` 既定 / `fifo`) | `scheduler` / `run --auto` |
375
+ | `--auto` / `--loop` | Ready タスクを自動選択する / Ready がなくなるまで繰り返す | `run` |
376
+ | `--parallel <n>` | 同時に走らせる agent 数の上限を指定する | `run --auto` / `run --register --worktree` |
377
+ | `--worktree` | worktree に隔離して実行する | `run --task` / `run --register` |
378
+ | `--track-state` | claim / complete の状態イベントを記録する | `run --task` |
379
+ | `--register <PJR-ID>` | 登録簿の項目を実行する(空白・カンマ区切りで複数可。既定は in-place、`--worktree` で隔離) | `run` / `plan` |
380
+ | `--register-filter` | 登録簿項目を type / priority / status / limit の条件で決定論的に選ぶ | `run` |
381
+ | `--register-commit` | 成功したIDごとに、その実行で生じた変更を1コミットにまとめる(`--worktree` 時は常に commit のため無視) | `run --register` |
382
+ | `--on-failure <stop\|continue>` | 途中失敗時に残りのIDを停止するか継続するか(既定は `stop`) | `run --register` |
383
+ | `--resume` | run が止まった段(executor / reporter / 統合)を既存 worktree と checkpoint で再開する | `run --register --worktree` |
384
+ | `--force-restart` | 再開可能な run の成果があっても、worktree を破棄して項目全体を再実行する | `run --register --worktree` |
385
+ | `--executor-by <nickname>` | executor/reporter パイプラインの executor 段に使う agent nickname | `run --auto` / `resume` / `run --register` |
386
+ | `--reporter-by <nickname>` | executor/reporter パイプラインの reporter 段に使う agent nickname | `run --auto` / `resume` / `run --register` |
387
+ | `--due` | 再開時刻を迎えた利用制限延期 task を対象にする | `resume` |
388
+
389
+ agent の指定は roster nickname(`pm-members.yaml`)へ一本化します。手動ターゲット(`--task` / `--register` など)では `--by <nickname>`、`--auto` バッチでは mode 別に `--edit-by` / `--review-by` を使い、バッチ起動は `--auto` に一本化します。解決の優先順位は「単体指定(`--by`)> mode 別指定(`--edit-by` / `--review-by`)> 自動選択」です。
390
+
391
+ Schedule タスクの `agent_pipeline`(`sch-strategy-<track>.yaml` の phase 設定)と同じ executor/reporter 2段階(`stage_role: executor` が成果物を編集・検証し、`stage_role: reporter` が evidence から result を描画する)は、`--register` でも `--executor-by <nickname>` と `--reporter-by <nickname>` を **両方セットで** 指定すると使えます。register 項目は Schedule のような per-item のパイプライン宣言を持たないため、owner・role からの自動選択は行わず、この2フラグの明示指定のみで切り替わります。片方だけの指定はエラーになります。
392
+
393
+ `exec scheduler` の claim 保護と選択戦略、`--auto --loop --parallel` の枠管理は [Schedule実行運用ガイド](../guides/schedule-operation-guide.md)、`exec reopen` の実行条件は [exec運用ガイド](../guides/exec-operation-guide.md) を参照します。
394
+
395
+ 代表的な `exec run`:
396
+
397
+ ```bash
398
+ # カレントリポジトリで単発実行する
399
+ specdojo exec run --project prj-0001 --task <task-id>
400
+
401
+ # claim/complete まで記録する
402
+ specdojo exec run --project prj-0001 --task <task-id> --by agent-1 --track-state
403
+
404
+ # worktree 隔離で単発実行する
405
+ specdojo exec run --project prj-0001 --task <task-id> --worktree
406
+
407
+ # Ready タスクを自動実行する
408
+ specdojo exec run --project prj-0001 --auto --parallel 5
409
+
410
+ # Ready がなくなるまで連続実行する
411
+ specdojo exec run --project prj-0001 --auto --loop --parallel 5
412
+
413
+ # 登録簿の項目を実行する(開始で in-progress、成功で review、失敗で waiting へ遷移)
414
+ specdojo exec run --project prj-0001 --register PJR-0012
415
+
416
+ # 複数の項目を指定順に直列実行し、成功IDごとにcommitする
417
+ specdojo exec run --project prj-0001 --register PJR-0012 PJR-0013 --register-commit
418
+
419
+ # 途中で失敗しても残りの項目を続行する(既定は失敗時に停止)
420
+ specdojo exec run --project prj-0001 --register PJR-0012,PJR-0013 --on-failure continue
421
+
422
+ # 登録簿を flat な条件で絞り込み、ID 昇順に実行する
423
+ specdojo exec run --project prj-0001 --register-filter --register-types todo --register-priorities high --register-statuses open --register-limit 3
424
+
425
+ # 成果物を worktree に隔離して実行し、統合ブランチへ merge back する
426
+ specdojo exec run --project prj-0001 --register PJR-0012 --worktree
427
+
428
+ # worktree 隔離のまま複数項目を並列実行する
429
+ specdojo exec run --project prj-0001 --register PJR-0012 PJR-0013 --worktree --parallel 2
430
+
431
+ # executor/reporter パイプラインで実行する(両フラグ必須)
432
+ specdojo exec run --project prj-0001 --register PJR-0012 --executor-by claude-expert-executor --reporter-by claude-reporter --worktree
433
+
434
+ # 途中で止まった項目を、止まった段(executor、reporter、または統合)から再開する
435
+ specdojo exec run --project prj-0001 --register PJR-0012 --worktree --resume
436
+
437
+ # Job Definitionから期間ごとのRunを生成して実行する
438
+ specdojo exec run --project prj-0001 --job job-weekly-report --input period=2026-W32
439
+ ```
440
+
441
+ `--register` は指定した個票の項目を実行します。`--register-filter` は `--register-types` / `--register-priorities` / `--register-statuses` のカンマ区切り条件と、正の整数の `--register-limit` で項目を選びます。条件省略時は open かつ実行可能な type が対象です。いずれも実行対象になる type は `todo` / `issue` / `change-request` / `question` / `risk` で、`decision` / `note` は対象外です。既定は in-place の直列実行です。`--worktree` を付けると成果物の変更を worktree に隔離し、状態遷移(`start` / `review` / `waiting`)を直列化したうえで、成功時に merge back します。`--parallel <n>` は `--worktree` との併用時のみ指定でき、単独で指定するとエラーになります。
442
+
443
+ `--resume` は `--register --worktree` の pipeline 実行専用で、途中で止まった run を止まった段から再開します。対象 run は既存 worktree に残る最新の `pipeline-state.json` から特定し、再開段も state から決まります。executor が `running` のまま残っていれば、同じ plan/result と未コミット成果を保持した worktree 上で executor を再実行します。executor が成功済みで reporter が未完了なら、保存済みの `evidence.json` を使って reporter だけを再開します。親検証の記録が不足または失敗している場合は、現在の固定許可リストで親検証を更新してから reporter へ進みます。reporter も成功していて統合(commit → merge → worktree 撤去)だけが残っている場合は、agent を起動せずに統合段だけを再試行します。worktree や plan/result が無い、成功済み executor の evidence が欠損しているなど再開できない場合は、worktree を含め何も変更せずエラー終了します。再開可能な成果が残っている項目を `--resume` なしで再実行しようとした場合も、未統合の成果を守るために中断します。破棄して最初からやり直す場合は `--force-restart` を指定します。手順の使い分けは [exec運用ガイド](../guides/exec-operation-guide.md) を参照します。
444
+
445
+ `--by`(または owner 解決)を指定した場合は、従来どおり単一 agent が成果物編集と result 記入を1回の実行で完結します。`--executor-by` と `--reporter-by` を両方指定した場合は、`stage_role: executor` の agent が成果物を編集・検証し、その evidence(実行ログの要約・検証結果)を渡された `stage_role: reporter` の agent が result 本文を描画する2段階実行に切り替わります。`stage_role` が一致しない nickname を指定するとエラーになります。
446
+
447
+ register 実行の対応内容、状態追跡、commit の扱いは [登録簿運用ガイド](../guides/register-operation-guide.md)、実行フロー全体は [exec運用ガイド](../guides/exec-operation-guide.md) を参照します。
448
+
449
+ ### 7.1. agent比較trial
450
+
451
+ `exec trial`は、同一タスクの既存planを複数agentへ同じ内容で渡し、agent名を含む独立worktreeとbranchで試行します。Schedule eventとregister状態は変更しません。
452
+
453
+ | サブコマンド | 用途 |
454
+ | ------------ | --------------------------------------------------------------- |
455
+ | `run` | 2つ以上のagentで試行し、客観指標を中央の比較記録へ集約する |
456
+ | `status` | plan/promptハッシュとagent別指標を表示する |
457
+ | `rate` | 判断・文章・範囲遵守の人手評価(1〜5)と注記を記録する |
458
+ | `adopt` | 成功trialを現在branchへmergeし、残りのworktree/branchを破棄する |
459
+ | `discard` | 成果を採用せず全worktree/branchを破棄し、比較記録だけを残す |
460
+
461
+ ```bash
462
+ specdojo exec trial run \
463
+ --project prj-0001 \
464
+ --plan docs/ja/projects/prj-0001/execution/exec/plans/<task>-plan.md \
465
+ --base <commit-before-completed-work> \
466
+ --agent agent-a agent-b \
467
+ --reporter-by reporter-a \
468
+ --parallel 2
469
+
470
+ # executorとreporterを組で比較する場合
471
+ specdojo exec trial run \
472
+ --project prj-0001 \
473
+ --plan docs/ja/projects/prj-0001/execution/exec/plans/<task>-plan.md \
474
+ --base <commit-before-completed-work> \
475
+ --pair executor-a=reporter-a executor-b=reporter-b
476
+
477
+ specdojo exec trial status --project prj-0001 --comparison <comparison-id>
478
+ specdojo exec trial rate --project prj-0001 --comparison <comparison-id> --trial agent-a --judgment-quality 4 --writing-quality 4 --scope-adherence 5
479
+ specdojo exec trial adopt --project prj-0001 --comparison <comparison-id> --trial agent-a
480
+ ```
481
+
482
+ `run`はplan frontmatterの`task_id` / `mode` / `project_id`を要求します。`--base`はworktreeの起点となるcommit-ishで、省略時は従来どおりHEADです。指定値は完全なcommitへ解決され、実行開始時のHEAD(完了済み作業の参照結果)、baseがHEADの祖先か、plan内で参照されたリポジトリ相対パスが起点ツリーに存在するかという互換性確認とともに比較記録へ保存されます。plan自体が起点に存在しなくても、指定した現在のplan内容を全trialへ共通で渡します。
483
+
484
+ `--agent`と任意の`--reporter-by`を使うと、reporterなしまたは全trial共通reporterの従来方式になります。`--pair <executor>=<reporter>...`は2組以上を指定し、executorとreporterを一組として比較します。`--pair`は`--agent` / `--reporter-by`と併用できません。比較記録の`reporter_mode`には`none` / `shared` / `paired`のいずれかを保存します。各reporterについて構造化出力の成否、形式試行回数、形式再試行回数、`reported_blocked` / `invalid_output` / `invocation_failure` / `rate_limit`の失敗分類も保存します。
485
+
486
+ `pipeline.parent_validations`はtrialにも適用され、executor成功後・reporter起動前に各worktreeで実行されます。親検証結果は`source: runner`付きでevidenceへ保存し、失敗時はtrialを`failed`にします。比較記録と`trial status`はexecutor・親検証・全体の時間を分け、executorの検証報告総数と`passed` / `failed` / `not_run`、親検証の状態と件数を別々に表示します。採用前に親検証の成功とexecutorの未実施・未報告を確認してください。
487
+
488
+ 記録先は`execution_path/exec/trials/<comparison-id>/`です。agent選定への反映は自動化せず、人が複数比較を確認して`pm-members.yaml`を更新します。
489
+
490
+ ## 8. grade
491
+
492
+ `grade` は kata(rulebook / recipe / sample / template)または成果物を、review と同じ共通 viewpoint・category rubric で継続評価します。agent に直接ファイル探索やスコア計算をさせず、plan 生成と反映を分離します。
493
+
494
+ | コマンド | 用途 |
495
+ | ---------------- | ------------------------------------------------------ |
496
+ | `grade list` | 選択した文書のパスを1行1件で出力し、plan は保存しない |
497
+ | `grade plan` | 1文書ごとに executor / reporter の評価 plan を保存する |
498
+ | `grade apply` | reporter の JSON と executor の申告を検証して反映する |
499
+ | `grade validate` | サイドカーの内容ハッシュと finding 件数を検証する |
500
+ | `grade migrate` | インライン grade / finding をサイドカーへ一括移行する |
501
+
502
+ ```bash
503
+ specdojo grade plan --target kata --changed-only --project prj-0001
504
+ specdojo grade list --target kata --changed-only --project prj-0001
505
+ specdojo grade plan --target kata --verdict pass --min-score 96 --max-findings 1 --project prj-0001
506
+ specdojo grade plan --target kata --ungraded --project prj-0001
507
+ specdojo grade list --target deliverable --changed-only --project prj-0001
508
+ specdojo grade plan --target deliverable --changed-only --project prj-0001
509
+ # executor plan の自由記述を保存し、reporter plan と一緒に reporter へ渡す
510
+ specdojo grade apply --target kata --path <document.md> \
511
+ --analysis-from <executor-output.txt> --from <grade-result.json> --by <executor-nickname>
512
+ specdojo grade validate --target kata --project prj-0001
513
+ ```
514
+
515
+ `--target` は `kata` または `deliverable` です。`--path` は繰り返し指定でき、明示した Markdown 文書だけを対象にします。ただし、パス要素に `generated` を含む生成文書と `trash` を含む退避済み文書は自動探索から除外し、`--path` で明示した場合も入力エラーとして拒否します。`--changed-only` は grade result サイドカーの `content_hash` と現在の成果物ファイル全体の SHA-256 を比較します。`grade apply` はサイドカーだけを更新するため、評価結果の書き込み自体で成果物が変更扱いになることはありません。
516
+
517
+ 保存済みの判定結果では、`--verdict <pass|needs-work|fail>` で最新 verdict、`--min-score <score>` で総合 score が指定値以上、`--max-findings <count>` で全 severity の finding 合計が指定件数以下の文書に絞れます。score は 0 から 100 の整数で指定します。`--ungraded` は grade result サイドカーが存在しない文書だけ、`--incomplete` は同じ本文に対する設定済み段数の評価が未完了で連続失敗上限に達していない文書だけを選びます。複数の選択条件は AND で適用され、`--path` や `--changed-only` とも併用できます。保存済み grade を前提とする `--verdict`、`--min-score`、`--max-findings` のいずれかと `--ungraded` の併用は入力エラーです。`grade list` はこの選択規則を plan の生成や文書更新なしで利用するための機械可読な入口で、標準出力にはリポジトリ相対パスだけを辞書順で出力します。定期再評価の呼び出し側は変更済み、未評価、段未完了を別々に列挙して和集合を取ります。
518
+
519
+ 段の到達状況は `<execution_path>/grade/pipeline/` の文書別 JSON に保存します。`stage_completed`、`stage_failed`、`stage_total`、`consecutive_failures`、`max_failures` から再開段と上限到達を判定し、`content_hash` が現在本文と異なる古い state は再開に使いません。`grade state --target <target> --project <id> --path <document>` は現在本文に有効な state を JSON で返し、`--exhausted` は上限到達文書のパスを返します。state の更新は文書単位の実行 script が担い、pipeline 完了時にファイルを削除します。
520
+
521
+ `grade plan` は対象ごとに executor plan と reporter plan の2ファイルを生成し、既定では `<execution_path>/grade/generated/plans/<target>/` へ保存します。`generated/` 配下は再生成可能な派生生成物の置き場で、git 管理と文書索引の対象外です。`--out <directory>` で保存先を変更できます。ファイル名は対象パスから決定され、同じ対象の再生成は同じファイルを上書きするため履歴を増やしません。executor plan は評価対象を1件だけリポジトリ相対パスで示し、Kata の `rulebook` / `recipe` / `sample` / `template` 参照と逆参照から解決した対応文書も参考資料のパスとして列挙します。`--random-reference` を指定した場合は、同じ種別で `status: ready` の別文書から良い実例を1件無作為に選び、記載水準を比較するリファレンスとして記録します。Kata は同じ rulebook / recipe / sample / template 種別、成果物は同じ `specdojo.type` を候補範囲とします。実例は評価対象ではなく、`ready` も品質保証ではありません。対象・参考資料・実例の本文は plan に埋め込みません。再生成のたびに候補集合から選び直すため、同じ対象の plan でも実例だけが変わることがあります。`--random-reference` も `--reference` も指定しなければリファレンスは付けません。reporter plan は対象の固定 facts と GradeSubmission テンプレートだけを持ち、評価資料は持ちません。
522
+
523
+ 成果物の plan は、成果物カタログの `done_criteria` を `DC-001` から順に列挙し、条件文、担当 Role code、viewpoint を executor へ渡します。executor は各条件を `satisfied` / `unsatisfied` として score とは独立に申告し、reporter はその判定と不足理由を変更せず GradeSubmission へ写します。`grade apply --target deliverable` は過不足と忠実性を検証し、grade result サイドカーの要約と `<execution_path>/grade/criteria/` の詳細 YAML を同時に更新します。詳細は成果物ごとに1ファイルで、再評価では同じファイルを上書きします。
524
+
525
+ 再評価時は、grade result サイドカーの `findings[]` から `rule`、`severity`、`line`、`anchor`、`message` を前回の指摘として plan へ含めます。agent は各指摘が現在も未解消かを確認し、未解消なら前回の message を変更せず、前回と同等以上の severity で今回の finding に含めます。`grade apply` も同じ message の finding を未解消と扱い、提出された severity が前回より軽ければ前回値へ戻し、対応する viewpoint level を severity 上限まで補正します。前回の問題が解消され、別の軽微な問題だけが残る場合は、新しい finding の message に引き下げの根拠を含めます。前回の観点割り当てに判定を引きずられないよう各 viewpoint を現在の根拠から独立に評価し、前回指摘にない問題も検出します。前回の level、score、verdict や解消履歴は plan に引き継ぎません。適用結果は最新サイドカーへ上書きされ、成果物本文は変更しません。
526
+
527
+ executor は判定前に、plan が示す評価対象、すべての参考資料、選定された良い実例をファイル読み取りツールで全文読み、実行ログに各パスの読み取り操作を残します。参考資料は成果物間整合、良い実例は章ごとの具体性・根拠の密度・過不足を比較する材料であり、どちらも評価対象にはしません。実例の表現や欠点を機械的に転用せず、rubric と viewpoint を最終的な判定基準にします。いずれかのファイルを読み取れない場合は、内容を推測せず異常終了します。grade plan の Frontmatter と「このタスクで行うこと / 対象項目 / 進め方 / 完了手順 / 異常終了の条件」の章構成は exec plan に準拠します。
528
+
529
+ executor plan は JSON 契約を持ちません。各 viewpoint を `[VIEWPOINT <id>]` と `[END VIEWPOINT]` で囲み、`LEVEL: <0-4>` と、必要な `FINDING <severity> line=<line>: <message>` を申告します。marker 間の根拠と検討過程は自由記述です。この軽量な申告形式により、JSON を安定して生成できない agent でも分析を完了できます。
530
+
531
+ reporter は executor の最終応答を `<grade_executor_output>` として reporter plan と一緒に受け取り、GradeSubmission JSON だけを返します。対象文書や参考資料を再評価せず、executor の level、severity、line、message を追加・省略・変更しません。`grade apply --analysis-from <executor-output>` は reporter JSON と executor marker を機械照合し、不一致、欠落、追加を拒否してから既存の GradeSubmission 検証を実行します。判定主体は reporter ではなく executor なので、`--by <executor-nickname>` がプロジェクトの `pm-members.yaml` に存在する nickname を検証してサイドカーの `graded_by` へ記録します。
532
+
533
+ finding の忠実性照合では、message に限り、Unicode の正準等価(NFC)、連続・前後の空白、句読点周辺の空白、および `、。!?:;`(全角の `,.` を含む)と対応する ASCII 句読点を正規化します。これは reporter が内容を保ったまま起こす表記差だけを許容する境界です。英字の大小、英数字の全角・半角、括弧・ダッシュ、単語や文の言い換えは正規化しません。severity と line は常に完全一致が必要です。拒否時は、変更された severity、line、正規化後も異なる message の原文をエラーへ示します。
534
+
535
+ 移行期間中は `--analysis-from` を省略した従来の1段構成も受理します。既存の保存済み plan や GradeSubmission を適用するための互換経路であり、新しく生成した2段 plan では `--analysis-from` を指定します。旧 GradeSubmission の `graded_by` も入力互換性のため受理しますが、記録には使いません。
536
+
537
+ 複数対象は、生成された plan の組を順に処理し、executor 応答を保存して reporter へ引き渡し、1件の GradeSubmission を直ちに `grade apply --path <document> --analysis-from <executor-output>` で反映します。agent 起動は `agent run`、stage 間の応答受け渡しは呼び出し側が担い、`grade` は plan の生成と結果の検証・反映に限定されます。この単位で処理すると、後続文書が失敗しても適用済みの grade は保持されます。保存済み executor plan は `exec trial` などで同じ入力を複数 agent へ渡す用途にも利用できます。
538
+
539
+ ### 8.1. 文書単位の grade pipeline
540
+
541
+ 文書ごとに grade pipeline を実行する場合は、リポジトリルートから `tools/grade/run-per-document.sh` を実行します。`--stages 1` は codex 単段、既定の `--stages 3` は従来の3段構成です。`--target kata` では `--kind` に `rulebook` / `recipe` / `sample` / `template` のいずれか、または `all` を指定します。`--target deliverable` では成果物カタログの Markdown 成果物を対象にし、`--kind` は使いません。`--path` を繰り返すと明示した文書だけを処理できます。`--changed-only`、`--ungraded`、`--incomplete` は `grade list` の選択結果を利用し、複数指定時は各結果の和集合を処理します。既定 target は `kata`、既定 kind は `rulebook` です。
542
+
543
+ ```bash
544
+ # 対象と agent / reference の確認だけを行う
545
+ tools/grade/run-per-document.sh --run-id 20260901-rulebooks --limit 3 --dry-run
546
+
547
+ # rulebook を codex 単段で評価する。同じ run-id で再実行すると中断箇所から再開する
548
+ tools/grade/run-per-document.sh --run-id 20260901-rulebooks --stages 1 --kind rulebook
549
+
550
+ # 変更済み、未評価、または段未完了の4種別を最大5件再評価する
551
+ tools/grade/run-per-document.sh --run-id 20260908-recheck --kind all \
552
+ --stages 1 --changed-only --ungraded --incomplete --limit 15
553
+
554
+ # 変更済み、未評価、または段未完了の成果物を最大5件再評価する
555
+ tools/grade/run-per-document.sh --run-id 20260912-deliverables --target deliverable \
556
+ --stages 1 --changed-only --ungraded --incomplete --limit 10
557
+ ```
558
+
559
+ `--stages 1` では stage 1 の既定を `codex-expert-executor` / `gemma-reporter` / リファレンスなしとし、stage 2・3は実行しません。定期実行する `job-grade-kata` と `job-grade-deliverable` はこの構成を指定します。
560
+
561
+ 互換用の `--stages 3` では、各段の executor と reporter を個別に指定できます。1段目の比較リファレンスは `--kind` に応じて `docs/ja/specdojo/<種別ディレクトリ>/prj-overview-<kind>.md` を既定とします。たとえば `--kind recipe` では `docs/ja/specdojo/recipes/prj-overview-recipe.md` です。対応する既定文書が存在しない場合は警告し、1段目もリファレンスなしで続行します。`--stage-1-reference` の明示指定は既定値より優先しますが、選択した種別のディレクトリにある `prj-overview` 系 Markdown だけを受理し、異なる種別や `none` は入力エラーとします。2段目はリファレンスなし、3段目は `codex-expert-executor` によるリファレンスなしの確認が既定です。2段目が `pass`、score 96以上、finding 1件以下の3条件をすべて満たす場合だけ3段目を実行します。解決した構成は `--dry-run` の `stage=<n>` 行で確認できます。
562
+
563
+ Run 内の実行 state は既定で `logs/grade/runs/per-document/<run-id>/documents/` に文書・段ごとに保存し、保存先を変える場合は `--work-dir` で指定します。初回に選択した文書は同じ Run の `selection.txt` へ固定し、再開時に grade の更新で選択結果が変わっても、未完了の段を同じ対象で継続します。Run をまたぐ到達状況は前述の文書別 JSON に保存し、新しい Run は `stage_failed`、または `stage_completed + 1` から再開します。単段への切り替え時に、`grade state` が現在本文に有効な `stage_total: 3` の state を返した場合は既存評価を完了済みとみなし、単段の incomplete として再開せず state を削除します。`content_hash` が現在本文と異なる state は `grade state` が返さないため、この移行処理の対象になりません。`logs/` へ plan を置くのは、段ごとの plan が同じ文書 ID を持ち、`docs/` 配下では `index build` が重複 ID で失敗するためです。agent が rate limit を返した場合は終了コード75で中断し、その段を失敗回数には数えません。同じ引数と `--run-id` で再実行すると、完了済みの段を再適用せず未完了の段から続行します。設定が保存済み Run state と異なる場合は、別条件の結果を混在させず、新しい `--run-id` を要求します。
564
+
565
+ 各段の status、所要秒数、verdict、score、finding 件数、executor、reporter、reference、連続失敗回数は同ディレクトリの `results.tsv` で確認できます。通常の agent / apply 失敗はその段で文書処理を止め、成功済みの前段を残して次回同じ段から再試行します。既定の連続失敗上限は3回で、`--max-stage-failures` で変更できます。上限到達文書は処理対象から外れますが、`retry_exhausted` 行として `results.tsv` に含め、reporter が人手対応を促せるようにします。
566
+
567
+ `apply` は level 3 以下に finding を要求し、`blocker` は level 0、`major` は最大 level 2、`minor` は最大 level 3 に制限します。category score は viewpoint score(`level × 25`)の平均、総合 score は対象種別ごとの重み付き平均です。verdict は `blocker` があれば `fail`、`major` があるか総合 score が 70 未満なら `needs-work`、それ以外を `pass` とします。
568
+
569
+ 現行のインライン記録対象は Markdown です。YAML / JSON の kata・成果物はコメントと Frontmatter を同じ契約で保持できないため、`--path` で指定した場合は書き込まずエラーにします。非 Markdown の記録形式はサイドカー schema を導入する後続変更で扱います。
570
+
571
+ ## 9. exec worktree
572
+
573
+ `exec worktree` は、claim 済みタスクを段階ごとに確認しながら隔離実行するための分割コマンドです。
574
+
575
+ | サブコマンド | 用途 |
576
+ | ------------ | ----------------------------------------------------------------------------- |
577
+ | `prepare` | plan、result、claim event を checkpoint commit し、task worktree を作成する |
578
+ | `status` | task state、actor、worktree、差分、統合状態を表示する |
579
+ | `agent` | task worktree 内で agent command を1回実行する |
580
+ | `commit` | 対象 result と成果物変更を exec ブランチへ commit する |
581
+ | `merge` | exec ブランチを現在のブランチへ merge する |
582
+ | `remove` | 統合済み task worktree を削除する |
583
+ | `prune` | worktree のない exec ブランチを監査し、現在の HEAD に統合済みのものだけを削除 |
584
+
585
+ ```bash
586
+ specdojo exec worktree prepare --project prj-0001 --task <task-id>
587
+ cd <worktree-path>
588
+ specdojo exec worktree agent --project prj-0001 --task <task-id>
589
+ specdojo exec worktree commit --project prj-0001 --task <task-id>
590
+ cd <merge-target-worktree>
591
+ specdojo exec worktree merge --project prj-0001 --task <task-id>
592
+ specdojo exec worktree remove --project prj-0001 --task <task-id> --delete-branch
593
+
594
+ # 孤立ブランチを確認してから、安全に削除する
595
+ specdojo exec worktree prune --project prj-0001 --dry-run
596
+ specdojo exec worktree prune --project prj-0001
597
+ ```
598
+
599
+ `prepare` は root と tracked `package-lock.json` を持つ独立 package で `npm ci` を実行し、task worktree 内に書き込み可能な `node_modules` を準備します。過去の共有シンボリックリンクがある場合は、リンク先を変更せず実体ディレクトリへ置き換えます。install に失敗した場合、agent は起動されず task worktree が保持されます。
600
+
601
+ `prune` は登録済み worktree が使うブランチを対象外にし、孤立していても未統合のブランチは `kept (not merged)` として保持します。削除には `git branch -d` 相当だけを使います。
602
+
603
+ 詳細な安全条件は [exec worktree運用ガイド](../guides/exec-worktree-guide.md) を参照します。
604
+
605
+ ## 10. index
606
+
607
+ `index` は frontmatter の `id` とファイルパスのインデックスを扱います。
608
+
609
+ | コマンド | 用途 | 例 |
610
+ | --------------- | ------------------------------------------------- | ------------------------------------------------------ |
611
+ | `index build` | `.specdojo/doc-index.json` を生成する | `specdojo index build` |
612
+ | `index lookup` | ID からパスを返す | `specdojo index lookup specdojo:prj-overview-rulebook` |
613
+ | `index replace` | `[[id]]` を Markdown リンクまたは path に展開する | `specdojo index replace --format path <plan-path>` |
614
+
615
+ `exec run` は agent に plan を渡す直前に `index replace --format path --missing keep` 相当の処理を行います。
616
+
617
+ ## 11. watch / build
618
+
619
+ | コマンド | 用途 | 例 |
620
+ | -------- | ------------------------------------------- | ------------------------------------------------ |
621
+ | `watch` | ファイル変更を監視して対象 build を実行する | `specdojo watch --project prj-0001 --scope exec` |
622
+ | `build` | 全生成物または指定 scope を一括再生成する | `specdojo build --project prj-0001 --scope all` |
623
+
624
+ `dashboard build --project <id>` は `execution/generated/dashboard.md` を再生成します。通常の進捗集計に加え、`routines/generated/routine-runs.jsonl` から昨日の実行と本日の予定を、登録簿個票から着手候補のおすすめ順を、register / exec の event から解除待ちの理由と次の行動を表示します。解除待ちの理由は、制御文字を除いた 1 行へ整形し、表の区切り文字をエスケープしたうえで、長い値を省略記号付きで打ち切ります。
625
+
626
+ `--scope` は `exec`、`catalog`、`register`、`index`、`all` を指定します。
627
+
628
+ ## 12. job
629
+
630
+ `job`は再利用可能な`job-*.yaml`と、その定義からmaterializeされたJob Runを扱います。実行自体は`exec run --job`を使います。
631
+
632
+ | コマンド | 用途 | 例 |
633
+ | -------------- | ------------------------------------------ | ------------------------------------------ |
634
+ | `job list` | Job Definitionと最終Runを表示する | `specdojo job list --project prj-0001` |
635
+ | `job validate` | `job-*.yaml`を検証する | `specdojo job validate --project prj-0001` |
636
+ | `job where` | Job Definition・Run・stateのパスを表示する | `specdojo job where --project prj-0001` |
637
+
638
+ `exec run --job`の`--input <key=value...>`はJob入力を指定し、`--scheduled-at`はroutineやCIが論理実行枠を渡す場合に使います。入力定義の `enum` は string / integer / boolean の値、または list の各要素を制限し、integer の `minimum` / `maximum` は値域を制限します。command template では `{{project_id}}` で解決済みプロジェクトIDを、`{{specdojo}}` で現在のrunnerと同じCLI entryを、`{{job_run_id}}` で確定済みJob Run IDを参照できます。`job_run_id`は`run.idempotency_key`では参照できません。同じidempotency keyの完了済みRunは再実行せず、失敗済みRunは同じRun IDの次attemptとして実行します。Job Runは現在in-place実行に対応し、`--worktree`との併用は未対応です。
639
+
640
+ 委譲先のagentは`task.agent.executor`(および必要なら`task.agent.reporter`)にnicknameで指名します。両方を指名したRunはexecutor→reporterの2段で実行し、resultはreporterが書きます。`--by`は単一agent実行としての差し替え、`--executor-by` / `--reporter-by`は段ごとの差し替えとして、いずれも指名より優先します。`job validate`はnicknameの書式だけを検査するため、実在確認は`--dry-run`で行います。責務境界と記述規約は [Job定義標準](../standards/job-definition-standard.md) を参照します。
641
+
642
+ `task.mode: command`では、materialize済みの`task.command`をrunnerが直接実行します。終了コード、標準出力、標準エラーはcommand evidenceへ記録され、終了コードが0以外ならagentを起動せずRunをfailedにします。stdout / stderr はredact・64 KiB上限付きログへの参照と同じbounded内容がevidence本体にも入り、判断が必要なJobでは成功時に`task.analysis.agent`へ渡されます。analysis reporterは参照先ログや作業ツリーを追加で読まず、このevidence本体から判断します。commandのrunner実行を`--by` / `--executor-by`でagent実行へ差し替えることはできません。analysis agentだけは`--reporter-by`で差し替えられます。
643
+
644
+ ```bash
645
+ # 解決された runner command / analysis reporter を確認する(実行しない)
646
+ specdojo exec run --job job-grade-kata --project prj-0001 --input period=2026-W37 --dry-run
647
+ ```
648
+
649
+ ## 13. routine
650
+
651
+ `routine` は `rtn-*.yaml` の定義に基づき、schedule の依存グラフとは独立にタスクを定期実行します。CLI は常駐せず、外部スケジューラ(cron / CI の scheduled workflow)から `routine run --due` を冪等に呼び出します。
652
+
653
+ | コマンド | 用途 | 例 |
654
+ | ------------------ | ---------------------------------------------- | ----------------------------------------------- |
655
+ | `routine list` | 定義・due 状態・最終実行を表示する | `specdojo routine list --project prj-0001` |
656
+ | `routine validate` | `rtn-*.yaml` を検証する | `specdojo routine validate --project prj-0001` |
657
+ | `routine run` | due な routine を実行し、`last_run` を記録する | `specdojo routine run --project prj-0001 --due` |
658
+ | `routine where` | routine 関連パスを表示する | `specdojo routine where --project prj-0001` |
659
+
660
+ 主要オプション:
661
+
662
+ | オプション | 用途 |
663
+ | ----------- | ----------------------------------------------- |
664
+ | `--due` | due と判定された routine だけを対象にする |
665
+ | `--id <id>` | due 判定と無関係に特定の routine を即時実行する |
666
+ | `--dry-run` | 実行も `last_run` 記録も行わず、対象を表示する |
667
+
668
+ `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) を参照します。
669
+
670
+ 各 routine の実行完了時には、`routine-state.json` の最新状態とは別に、`routines/generated/routine-runs.jsonl` へ `routine_id`、`scheduled_for`、開始・終了時刻、結果、Job Run ID(`specdojo` action では空)を1実行1行で追記します。この履歴が dashboard の「routine 実行状況(昨日・本日)」の正本です。
671
+
672
+ ```bash
673
+ # due な routine をまとめて実行する(cron / CI から呼ぶ想定)
674
+ specdojo routine run --project prj-0001 --due
675
+
676
+ # 特定の routine を due 判定と無関係に即時実行する
677
+ specdojo routine run --project prj-0001 --id rtn-daily-register-sweep
678
+
679
+ # 実行内容を確認する(実行も last_run 記録もしない)
680
+ specdojo routine run --project prj-0001 --due --dry-run
681
+ ```
682
+
683
+ schedule / register / job / routine の使い分けの基準は [exec運用ガイド](../guides/exec-operation-guide.md) の `実行経路の使い分け` を参照します。
684
+
685
+ ## 14. agent
686
+
687
+ `agent` は、保存済みの plan を指定した1つの agent へ渡し、その標準出力を取得します。agent の選択は `pm-members.yaml` の nickname で一意に決まるため、実行のたびに担当が変わりません。決定論的な手順を shell script や CLI 側に置き、agent には判断だけを委ねるための最小の部品です。
688
+
689
+ | コマンド | 用途 |
690
+ | ----------- | ----------------------------------------------------------- |
691
+ | `agent run` | plan を stdin で agent へ渡し、標準出力をファイルへ保存する |
692
+
693
+ ```bash
694
+ specdojo agent run --plan <plan.md> --by <nickname> --out <response.txt>
695
+ specdojo agent run --plan <plan.md> --by <nickname> --dry-run
696
+ ```
697
+
698
+ `--plan` は agent へ標準入力で渡すファイルです。存在しない場合と内容が空の場合は、空のプロンプトを送らずにエラーにします。`--by` は `pm-members.yaml` の agent nickname で、同じ nickname の agent が複数ある場合、`type: agent` 以外、`disabled: true` の member は拒否します。`capabilities` や `proficiency` による間接的な絞り込みは行わないため、候補が複数になって担当が揺れることがありません。
699
+
700
+ `--out` を指定すると標準出力をそのファイルへ書き、親プロセスの標準出力には保存先だけを表示します。指定しない場合は agent の出力をそのまま端末へ流します。`--out` の親ディレクトリは必要に応じて作成します。`--dry-run` は解決したコマンドを表示するだけで agent を起動しません。
701
+
702
+ 終了コードは、成功が `0`、agent の失敗が `1`、rate limit の検出が `75` です。rate limit は通常の失敗と区別する必要があります。呼び出し側は、対象を評価済みとして記録せずに中断し、後で再開できます。検出条件と cooldown は `exec run` と同じ `exec-defaults.yaml` の設定を provider ごとに解決して使います。
703
+
704
+ `exec run` と違い、`agent run` は claim や result の記帳を行いません。状態遷移を伴う実行は `exec run` を使い、`agent run` は plan と応答だけを扱う用途に限定します。
705
+
706
+ ## 15. 関連ガイド
707
+
708
+ | 詳細 | 参照先 |
709
+ | ------------------------ | --------------------------------------------------------------------------- |
710
+ | CLI全体像と初期設定 | [遂行の技活用ガイド](../guides/waza-guide.md) |
711
+ | Schedule設計 | [Schedule設計ガイド](../guides/schedule-design-guide.md) |
712
+ | exec運用(経路の選び方) | [exec運用ガイド](../guides/exec-operation-guide.md) |
713
+ | Schedule実行運用 | [Schedule実行運用ガイド](../guides/schedule-operation-guide.md) |
714
+ | routine運用 | [routine運用ガイド](../guides/routine-operation-guide.md) |
715
+ | 登録簿運用 | [登録簿運用ガイド](../guides/register-operation-guide.md) |
716
+ | worktree隔離実行 | [exec worktree運用ガイド](../guides/exec-worktree-guide.md) |
717
+ | plan/result | [plan/resultライフサイクルガイド](../guides/plan-result-lifecycle-guide.md) |
718
+ | エージェント設定 | [exec設定ガイド](../guides/exec-config-guide.md) |