specdojo 0.4.7 → 0.6.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 (312) hide show
  1. package/.github/agents/specdojo-orchestrator.md +16 -9
  2. package/CHANGELOG.md +106 -0
  3. package/dist/catalog/generate.js +144 -13
  4. package/dist/commands/init.js +4 -0
  5. package/dist/commands/night-orchestrator.js +33 -4
  6. package/dist/dashboard/dashboard.js +5 -6
  7. package/dist/dashboard/timeline-build.js +5 -1
  8. package/dist/dashboard/timeline.js +6 -3
  9. package/dist/deliverable/deliverable.js +77 -4
  10. package/dist/docs/yaml-pages.js +17 -17
  11. package/dist/exec/core.js +3 -0
  12. package/dist/exec/parent-validation.js +7 -0
  13. package/dist/exec/pipeline-state.js +5 -2
  14. package/dist/exec/plans-core.js +49 -3
  15. package/dist/exec/plans-generation.js +48 -8
  16. package/dist/exec/plans-grade-findings.js +16 -0
  17. package/dist/exec/plans-planning.js +43 -0
  18. package/dist/exec/plans-storage.js +6 -2
  19. package/dist/exec/product-branch-records.js +105 -0
  20. package/dist/exec/product-branches.js +52 -0
  21. package/dist/exec/register-product-message.js +50 -0
  22. package/dist/exec/register.js +22 -1
  23. package/dist/exec/repo-integration-sync.js +11 -0
  24. package/dist/exec/repo-integration.js +58 -6
  25. package/dist/exec/repo-trace.js +19 -4
  26. package/dist/exec/results.js +11 -5
  27. package/dist/exec/run/register-command.js +16 -0
  28. package/dist/exec/run/register-core.js +11 -0
  29. package/dist/exec/run/register-mode.js +19 -1
  30. package/dist/exec/run/register-resume.js +33 -1
  31. package/dist/exec/run/register-worktree.js +52 -8
  32. package/dist/exec/run/schedule-prepare.js +7 -3
  33. package/dist/exec/strategy.js +4 -1
  34. package/dist/exec/task-repos.js +92 -16
  35. package/dist/exec/worktree-command.js +2 -2
  36. package/dist/exec/worktree-ops-commit.js +7 -1
  37. package/dist/exec/worktree.js +3 -3
  38. package/dist/grade/apply.js +6 -2
  39. package/dist/grade/markdown.js +7 -2
  40. package/dist/grade/plan.js +6 -4
  41. package/dist/register/approach.js +19 -0
  42. package/dist/register/catalog-status.js +49 -0
  43. package/dist/register/core.js +8 -0
  44. package/dist/register/create-commands.js +86 -4
  45. package/dist/register/deliverable-target.js +24 -17
  46. package/dist/register/dependency.js +123 -0
  47. package/dist/register/derivation.js +2 -2
  48. package/dist/register/epic.js +42 -0
  49. package/dist/register/event-merge.js +9 -2
  50. package/dist/register/events.js +10 -0
  51. package/dist/register/external-project.js +6 -0
  52. package/dist/register/input.js +168 -0
  53. package/dist/register/item.js +71 -0
  54. package/dist/register/maintenance-commands.js +7 -1
  55. package/dist/register/planning.js +37 -0
  56. package/dist/register/register.js +7 -3
  57. package/dist/register/renumber.js +16 -4
  58. package/dist/register/update.js +6 -0
  59. package/dist/register/views.js +55 -4
  60. package/dist/schedule/approach.js +9 -0
  61. package/dist/schedule/schedule.js +3 -1
  62. package/dist/schedule/strategy-generate-scope.js +5 -1
  63. package/dist/schedule/strategy-generate.js +1 -0
  64. package/dist/schedule/strategy-profiles.js +22 -2
  65. package/dist/shared/agent-types.js +7 -1
  66. package/dist/shared/branch-template.js +26 -0
  67. package/dist/shared/commit-message-template.js +38 -0
  68. package/dist/shared/commit-types.js +15 -0
  69. package/dist/shared/grade-result.js +23 -5
  70. package/dist/shared/markdownlint-config.js +38 -0
  71. package/dist/shared/markdownlint-scaffold.js +2 -9
  72. package/dist/shared/specdojo-config.js +42 -4
  73. package/dist/shared/specdojo-gitignore.js +4 -0
  74. package/docs/ja/specdojo/exec-templates/xep-catalog-planning-template.md +24 -0
  75. package/docs/ja/specdojo/exec-templates/xep-draft-template.md +93 -0
  76. package/docs/ja/specdojo/exec-templates/xep-fully-guided-template.md +9 -2
  77. package/docs/ja/specdojo/exec-templates/xep-register-investigate-template.md +2 -0
  78. package/docs/ja/specdojo/exec-templates/xep-register-template.md +2 -0
  79. package/docs/ja/specdojo/exec-templates/xep-strategy-planning-template.md +24 -0
  80. package/docs/ja/specdojo/exec-templates/xer-human-bootstrap-finalize-template.md +2 -0
  81. package/docs/ja/specdojo/exec-templates/xer-human-draft-template.md +23 -0
  82. package/docs/ja/specdojo/exec-templates/xer-human-finalize-template.md +2 -0
  83. package/docs/ja/specdojo/exec-templates/xrp-fully-guided-template.md +7 -4
  84. package/docs/ja/specdojo/guides/docs-editing-guide.md +14 -1
  85. package/docs/ja/specdojo/guides/docs-structure-guide.md +10 -8
  86. package/docs/ja/specdojo/guides/exec-config-guide.md +3 -1
  87. package/docs/ja/specdojo/guides/exec-operation-guide.md +111 -16
  88. package/docs/ja/specdojo/guides/orchestrator-operation-guide.md +19 -1
  89. package/docs/ja/specdojo/guides/practice-system-composition-guide.md +2 -0
  90. package/docs/ja/specdojo/guides/quick-start-guide.md +37 -14
  91. package/docs/ja/specdojo/guides/register-operation-guide.md +58 -16
  92. package/docs/ja/specdojo/guides/remote-host-development-guide.md +1 -1
  93. package/docs/ja/specdojo/guides/ryu-guide.md +114 -23
  94. package/docs/ja/specdojo/guides/schedule-design-guide.md +31 -4
  95. package/docs/ja/specdojo/guides/specdojo-overview-guide.md +16 -16
  96. package/docs/ja/specdojo/guides/timeline-design-guide.md +37 -33
  97. package/docs/ja/specdojo/recipes/exec-human-finalize-recipe.md +1 -0
  98. package/docs/ja/specdojo/recipes/tsd-recipe.md +206 -0
  99. package/docs/ja/specdojo/references/command-reference.md +86 -15
  100. package/docs/ja/specdojo/references/specdojo-config-reference.md +81 -8
  101. package/docs/ja/specdojo/rulebooks/atc-index-rulebook.md +1 -0
  102. package/docs/ja/specdojo/rulebooks/atc-rulebook.md +1 -0
  103. package/docs/ja/specdojo/rulebooks/bac-rulebook.md +5 -4
  104. package/docs/ja/specdojo/rulebooks/bdd-rulebook.md +3 -2
  105. package/docs/ja/specdojo/rulebooks/bds-rulebook.md +4 -3
  106. package/docs/ja/specdojo/rulebooks/bes-index-rulebook.md +8 -7
  107. package/docs/ja/specdojo/rulebooks/bes-rulebook.md +4 -3
  108. package/docs/ja/specdojo/rulebooks/bps-rulebook.md +1 -0
  109. package/docs/ja/specdojo/rulebooks/br-rulebook.md +1 -0
  110. package/docs/ja/specdojo/rulebooks/ccd-mermaid-rulebook.md +1 -0
  111. package/docs/ja/specdojo/rulebooks/cdfd-mermaid-rulebook.md +1 -0
  112. package/docs/ja/specdojo/rulebooks/cdfd-overview-rulebook.md +1 -0
  113. package/docs/ja/specdojo/rulebooks/cdfd-rulebook.md +1 -0
  114. package/docs/ja/specdojo/rulebooks/cdfd-uc-rulebook.md +1 -0
  115. package/docs/ja/specdojo/rulebooks/cdsd-rulebook.md +3 -2
  116. package/docs/ja/specdojo/rulebooks/cld-rulebook.md +2 -1
  117. package/docs/ja/specdojo/rulebooks/cnd-mermaid-rulebook.md +1 -0
  118. package/docs/ja/specdojo/rulebooks/cnd-rulebook.md +1 -0
  119. package/docs/ja/specdojo/rulebooks/cop-index-rulebook.md +2 -1
  120. package/docs/ja/specdojo/rulebooks/cop-rulebook.md +3 -2
  121. package/docs/ja/specdojo/rulebooks/cpd-mermaid-rulebook.md +1 -0
  122. package/docs/ja/specdojo/rulebooks/cpd-rulebook.md +1 -0
  123. package/docs/ja/specdojo/rulebooks/cstd-rulebook.md +1 -0
  124. package/docs/ja/specdojo/rulebooks/cxd-mermaid-rulebook.md +1 -0
  125. package/docs/ja/specdojo/rulebooks/cxd-rulebook.md +1 -0
  126. package/docs/ja/specdojo/rulebooks/dct-index-rulebook.md +1 -0
  127. package/docs/ja/specdojo/rulebooks/dct-rulebook.md +9 -0
  128. package/docs/ja/specdojo/rulebooks/dec-rulebook.md +1 -0
  129. package/docs/ja/specdojo/rulebooks/dmd-index-rulebook.md +2 -1
  130. package/docs/ja/specdojo/rulebooks/dmd-rulebook.md +2 -1
  131. package/docs/ja/specdojo/rulebooks/etc-index-rulebook.md +1 -0
  132. package/docs/ja/specdojo/rulebooks/etc-rulebook.md +1 -0
  133. package/docs/ja/specdojo/rulebooks/gl-rulebook.md +9 -6
  134. package/docs/ja/specdojo/rulebooks/ifd-mermaid-rulebook.md +1 -0
  135. package/docs/ja/specdojo/rulebooks/ifx-api-rulebook.md +3 -1
  136. package/docs/ja/specdojo/rulebooks/ifx-cmd-rulebook.md +2 -1
  137. package/docs/ja/specdojo/rulebooks/ifx-file-rulebook.md +2 -1
  138. package/docs/ja/specdojo/rulebooks/ifx-index-rulebook.md +2 -0
  139. package/docs/ja/specdojo/rulebooks/ifx-msg-rulebook.md +4 -2
  140. package/docs/ja/specdojo/rulebooks/imp-business-rulebook.md +1 -0
  141. package/docs/ja/specdojo/rulebooks/imp-data-rulebook.md +1 -0
  142. package/docs/ja/specdojo/rulebooks/imp-interface-rulebook.md +1 -0
  143. package/docs/ja/specdojo/rulebooks/imp-operations-rulebook.md +1 -0
  144. package/docs/ja/specdojo/rulebooks/imp-test-rulebook.md +1 -0
  145. package/docs/ja/specdojo/rulebooks/itc-index-rulebook.md +1 -0
  146. package/docs/ja/specdojo/rulebooks/itc-rulebook.md +1 -0
  147. package/docs/ja/specdojo/rulebooks/mip-index-rulebook.md +2 -1
  148. package/docs/ja/specdojo/rulebooks/mm-rulebook.md +1 -0
  149. package/docs/ja/specdojo/rulebooks/mtp-rulebook.md +4 -3
  150. package/docs/ja/specdojo/rulebooks/nfr-availability-rulebook.md +9 -8
  151. package/docs/ja/specdojo/rulebooks/nfr-index-rulebook.md +10 -9
  152. package/docs/ja/specdojo/rulebooks/nfr-integrity-rulebook.md +9 -8
  153. package/docs/ja/specdojo/rulebooks/nfr-maintainability-rulebook.md +9 -8
  154. package/docs/ja/specdojo/rulebooks/nfr-operations-rulebook.md +9 -8
  155. package/docs/ja/specdojo/rulebooks/nfr-performance-rulebook.md +9 -8
  156. package/docs/ja/specdojo/rulebooks/nfr-reliability-rulebook.md +10 -9
  157. package/docs/ja/specdojo/rulebooks/nfr-security-safety-rulebook.md +9 -8
  158. package/docs/ja/specdojo/rulebooks/nfr-usability-rulebook.md +9 -8
  159. package/docs/ja/specdojo/rulebooks/ntp-rulebook.md +7 -6
  160. package/docs/ja/specdojo/rulebooks/opd-index-rulebook.md +1 -0
  161. package/docs/ja/specdojo/rulebooks/opd-rulebook.md +1 -0
  162. package/docs/ja/specdojo/rulebooks/opr-index-rulebook.md +1 -0
  163. package/docs/ja/specdojo/rulebooks/opr-rulebook.md +1 -0
  164. package/docs/ja/specdojo/rulebooks/otp-index-rulebook.md +2 -1
  165. package/docs/ja/specdojo/rulebooks/otp-rulebook.md +2 -1
  166. package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +54 -36
  167. package/docs/ja/specdojo/rulebooks/pm-change-request-log-rulebook.md +1 -0
  168. package/docs/ja/specdojo/rulebooks/pm-communication-plan-rulebook.md +1 -0
  169. package/docs/ja/specdojo/rulebooks/pm-issue-log-rulebook.md +1 -0
  170. package/docs/ja/specdojo/rulebooks/pm-members-rulebook.md +1 -0
  171. package/docs/ja/specdojo/rulebooks/pm-organization-rulebook.md +1 -0
  172. package/docs/ja/specdojo/rulebooks/pm-plan-rulebook.md +1 -0
  173. package/docs/ja/specdojo/rulebooks/pm-quality-management-plan-rulebook.md +1 -0
  174. package/docs/ja/specdojo/rulebooks/pm-raci-rulebook.md +1 -0
  175. package/docs/ja/specdojo/rulebooks/pm-risk-register-rulebook.md +1 -0
  176. package/docs/ja/specdojo/rulebooks/pm-roles-rulebook.md +1 -0
  177. package/docs/ja/specdojo/rulebooks/pr-rulebook.md +1 -0
  178. package/docs/ja/specdojo/rulebooks/prj-assumptions-constraints-dependencies-rulebook.md +1 -0
  179. package/docs/ja/specdojo/rulebooks/prj-charter-rulebook.md +1 -0
  180. package/docs/ja/specdojo/rulebooks/prj-comparison-of-alternatives-rulebook.md +1 -0
  181. package/docs/ja/specdojo/rulebooks/prj-issues-and-approach-rulebook.md +1 -0
  182. package/docs/ja/specdojo/rulebooks/prj-overview-rulebook.md +1 -0
  183. package/docs/ja/specdojo/rulebooks/prj-scope-rulebook.md +1 -0
  184. package/docs/ja/specdojo/rulebooks/prj-stakeholder-register-rulebook.md +1 -0
  185. package/docs/ja/specdojo/rulebooks/prj-success-criteria-and-acceptance-criteria-rulebook.md +1 -0
  186. package/docs/ja/specdojo/rulebooks/sac-rulebook.md +3 -2
  187. package/docs/ja/specdojo/rulebooks/sch-rulebook.md +4 -1
  188. package/docs/ja/specdojo/rulebooks/sf-index-rulebook.md +7 -6
  189. package/docs/ja/specdojo/rulebooks/sf-rulebook.md +4 -3
  190. package/docs/ja/specdojo/rulebooks/sld-rulebook.md +2 -1
  191. package/docs/ja/specdojo/rulebooks/stc-index-rulebook.md +1 -0
  192. package/docs/ja/specdojo/rulebooks/stc-rulebook.md +1 -0
  193. package/docs/ja/specdojo/rulebooks/stsd-mermaid-rulebook.md +1 -0
  194. package/docs/ja/specdojo/rulebooks/stsd-rulebook.md +1 -0
  195. package/docs/ja/specdojo/rulebooks/sysd-critical-flows-rulebook.md +2 -1
  196. package/docs/ja/specdojo/rulebooks/sysd-cross-cutting-policy-rulebook.md +9 -8
  197. package/docs/ja/specdojo/rulebooks/sysd-index-rulebook.md +2 -1
  198. package/docs/ja/specdojo/rulebooks/sysd-rulebook.md +1 -0
  199. package/docs/ja/specdojo/rulebooks/tml-rulebook.md +1 -0
  200. package/docs/ja/specdojo/rulebooks/trc-requirements-to-specs-rulebook.md +1 -0
  201. package/docs/ja/specdojo/rulebooks/trc-requirements-to-tests-rulebook.md +1 -0
  202. package/docs/ja/specdojo/rulebooks/tsd-index-rulebook.md +80 -61
  203. package/docs/ja/specdojo/rulebooks/tsd-rulebook.md +111 -63
  204. package/docs/ja/specdojo/rulebooks/tsp-index-rulebook.md +1 -0
  205. package/docs/ja/specdojo/rulebooks/uis-rulebook.md +3 -2
  206. package/docs/ja/specdojo/rulebooks/utc-index-rulebook.md +1 -0
  207. package/docs/ja/specdojo/rulebooks/utc-rulebook.md +1 -0
  208. package/docs/ja/specdojo/samples/atc-index-sample.md +1 -1
  209. package/docs/ja/specdojo/samples/atc-sample.md +1 -1
  210. package/docs/ja/specdojo/samples/bac-sample.md +1 -1
  211. package/docs/ja/specdojo/samples/bdd-sample.yaml +1 -1
  212. package/docs/ja/specdojo/samples/bds-sample.md +1 -1
  213. package/docs/ja/specdojo/samples/bes-index-sample.md +1 -1
  214. package/docs/ja/specdojo/samples/bes-sample.md +1 -1
  215. package/docs/ja/specdojo/samples/ccd-sample.md +1 -1
  216. package/docs/ja/specdojo/samples/cdfd-sample.md +1 -1
  217. package/docs/ja/specdojo/samples/cdfd-uc-sample.md +1 -1
  218. package/docs/ja/specdojo/samples/cdsd-sample.md +1 -1
  219. package/docs/ja/specdojo/samples/cld-sample.md +1 -1
  220. package/docs/ja/specdojo/samples/cnd-sample.md +1 -1
  221. package/docs/ja/specdojo/samples/cop-index-sample.md +1 -1
  222. package/docs/ja/specdojo/samples/cop-sample.md +1 -1
  223. package/docs/ja/specdojo/samples/cpd-sample.md +1 -1
  224. package/docs/ja/specdojo/samples/cstd-sample.md +1 -1
  225. package/docs/ja/specdojo/samples/cxd-sample.md +1 -1
  226. package/docs/ja/specdojo/samples/dct-sample.yaml +5 -1
  227. package/docs/ja/specdojo/samples/dmd-index-sample.md +1 -1
  228. package/docs/ja/specdojo/samples/dmd-sample.md +1 -1
  229. package/docs/ja/specdojo/samples/etc-index-sample.md +1 -1
  230. package/docs/ja/specdojo/samples/etc-sample.md +1 -1
  231. package/docs/ja/specdojo/samples/gl-sample.yaml +2 -0
  232. package/docs/ja/specdojo/samples/ifd-sample.md +1 -1
  233. package/docs/ja/specdojo/samples/ifx-api-sample.yaml +1 -0
  234. package/docs/ja/specdojo/samples/ifx-cmd-sample.yaml +1 -1
  235. package/docs/ja/specdojo/samples/ifx-file-sample.md +1 -1
  236. package/docs/ja/specdojo/samples/ifx-index-sample.yaml +1 -0
  237. package/docs/ja/specdojo/samples/ifx-msg-sample.yaml +2 -1
  238. package/docs/ja/specdojo/samples/itc-index-sample.md +1 -1
  239. package/docs/ja/specdojo/samples/itc-sample.md +1 -1
  240. package/docs/ja/specdojo/samples/mtp-sample.md +1 -1
  241. package/docs/ja/specdojo/samples/nfr-availability-sample.md +1 -1
  242. package/docs/ja/specdojo/samples/nfr-index-sample.md +1 -1
  243. package/docs/ja/specdojo/samples/nfr-integrity-sample.md +1 -1
  244. package/docs/ja/specdojo/samples/nfr-maintainability-sample.md +1 -1
  245. package/docs/ja/specdojo/samples/nfr-operations-sample.md +1 -1
  246. package/docs/ja/specdojo/samples/nfr-performance-sample.md +1 -1
  247. package/docs/ja/specdojo/samples/nfr-reliability-sample.md +1 -1
  248. package/docs/ja/specdojo/samples/nfr-security-safety-sample.md +1 -1
  249. package/docs/ja/specdojo/samples/nfr-usability-sample.md +1 -1
  250. package/docs/ja/specdojo/samples/ntp-sample.md +1 -1
  251. package/docs/ja/specdojo/samples/opd-sample.md +1 -1
  252. package/docs/ja/specdojo/samples/opr-sample.md +1 -1
  253. package/docs/ja/specdojo/samples/otp-index-sample.md +1 -1
  254. package/docs/ja/specdojo/samples/otp-sample.md +1 -1
  255. package/docs/ja/specdojo/samples/prj-stakeholder-register-sample.md +1 -1
  256. package/docs/ja/specdojo/samples/sac-sample.md +1 -1
  257. package/docs/ja/specdojo/samples/sf-index-sample.md +1 -1
  258. package/docs/ja/specdojo/samples/sf-sample.md +1 -1
  259. package/docs/ja/specdojo/samples/sld-sample.md +1 -1
  260. package/docs/ja/specdojo/samples/stc-index-sample.md +1 -1
  261. package/docs/ja/specdojo/samples/stc-sample.md +1 -1
  262. package/docs/ja/specdojo/samples/stsd-sample.md +1 -1
  263. package/docs/ja/specdojo/samples/sysd-critical-flows-sample.md +1 -1
  264. package/docs/ja/specdojo/samples/sysd-cross-cutting-policy-sample.md +1 -1
  265. package/docs/ja/specdojo/samples/sysd-index-sample.md +1 -1
  266. package/docs/ja/specdojo/samples/tsd-index-sample.md +22 -16
  267. package/docs/ja/specdojo/samples/tsd-sample.md +241 -21
  268. package/docs/ja/specdojo/samples/tsp-index-sample.md +1 -1
  269. package/docs/ja/specdojo/samples/uis-sample.md +1 -1
  270. package/docs/ja/specdojo/samples/utc-index-sample.md +1 -1
  271. package/docs/ja/specdojo/samples/utc-sample.md +1 -1
  272. package/docs/ja/specdojo/standards/document-metadata-standard.md +44 -3
  273. package/docs/ja/specdojo/standards/exec-human-finalize-standard.md +1 -0
  274. package/docs/ja/specdojo/standards/guide-authoring-standard.md +2 -1
  275. package/docs/ja/specdojo/standards/id-and-file-naming-standard.md +2 -0
  276. package/docs/ja/specdojo/standards/philosophy-authoring-standard.md +1 -0
  277. package/docs/ja/specdojo/standards/recipe-authoring-standard.md +2 -1
  278. package/docs/ja/specdojo/standards/rulebook-authoring-standard.md +18 -12
  279. package/docs/ja/specdojo/standards/sample-authoring-standard.md +1 -0
  280. package/docs/ja/specdojo/standards/standard-authoring-standard.md +2 -1
  281. package/docs/ja/specdojo/templates/ifx-cmd-template.yaml +1 -1
  282. package/docs/ja/specdojo/templates/pjr-change-request-template.md +10 -4
  283. package/docs/ja/specdojo/templates/pjr-dependent-items-template.md +22 -0
  284. package/docs/ja/specdojo/templates/pjr-epic-items-template.md +22 -0
  285. package/docs/ja/specdojo/templates/pjr-epic-template.md +44 -0
  286. package/docs/ja/specdojo/templates/pjr-index-template.md +4 -2
  287. package/docs/ja/specdojo/templates/pjr-issue-template.md +10 -4
  288. package/docs/ja/specdojo/templates/pjr-question-template.md +11 -5
  289. package/docs/ja/specdojo/templates/pjr-risk-template.md +10 -4
  290. package/docs/ja/specdojo/templates/pjr-todo-template.md +10 -4
  291. package/docs/specdojo/schemas/v1/bdd.schema.yaml +1 -1
  292. package/docs/specdojo/schemas/v1/dct.schema.yaml +9 -0
  293. package/docs/specdojo/schemas/v1/deliverable-frontmatter.schema.yaml +24 -16
  294. package/docs/specdojo/schemas/v1/exec-common.schema.yaml +5 -1
  295. package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +1 -0
  296. package/docs/specdojo/schemas/v1/exec-plan-frontmatter.schema.yaml +1 -1
  297. package/docs/specdojo/schemas/v1/gl.schema.yaml +8 -0
  298. package/docs/specdojo/schemas/v1/ifx-cmd.schema.yaml +5 -1
  299. package/docs/specdojo/schemas/v1/pipeline-state.schema.yaml +2 -1
  300. package/docs/specdojo/schemas/v1/register-events.schema.yaml +21 -0
  301. package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +75 -3
  302. package/docs/specdojo/schemas/v1/rulebook-frontmatter.schema.yaml +5 -0
  303. package/docs/specdojo/schemas/v1/sch-strategy.schema.yaml +1 -0
  304. package/docs/specdojo/schemas/v1/specdojo-config.schema.yaml +43 -0
  305. package/package.json +4 -3
  306. package/templates/antigravity/orchestrator.md +16 -9
  307. package/templates/claude/agents/specdojo-orchestrator.md +16 -9
  308. package/templates/codex/agents/specdojo-orchestrator.toml +16 -9
  309. package/templates/codex/orchestrator.md +16 -9
  310. package/templates/copilot/README.md +2 -1
  311. package/templates/devcontainer/remote-host/specdojo-tmux.sh.sample +14 -8
  312. package/templates/opencode/agents/specdojo-orchestrator.md +16 -9
@@ -10,6 +10,9 @@ _PHASE_DESCRIPTION_
10
10
 
11
11
  - `name`: _DELIVERABLE_NAME_
12
12
  - `depends_on`: _DELIVERABLE_DEPENDS_ON_
13
+ - `based_on`(対象成果物の frontmatter): _DELIVERABLE_BASED_ON_
14
+ - 個票の `入力`: _REGISTER_INPUT_
15
+ - カタログの `brief`: _DELIVERABLE_BRIEF_
13
16
  - `overview`: _DELIVERABLE_OVERVIEW_
14
17
  - `path`: `_DELIVERABLE_PATH_`
15
18
  - `rulebook`: `_RULEBOOK_REF_`(`_MISSING_` は `undecided`、`not-needed`、または未整備)
@@ -43,20 +46,20 @@ _DONE_CRITERIA_ROWS_
43
46
 
44
47
  ## 5. 進め方
45
48
 
46
- fully-guided のタスクは、rulebook / recipe / sample / template に従って成果物を作成・更新することを求めた。rulebook の必須要素・禁止事項、recipe の問い、sample の粒度・文体、template の章構成との整合は grade が評価済みである。review はこれらを照合し直さず、評価結果の finding として扱う。
49
+ fully-guided のタスクは、宣言された文書だけを参照し、rulebook / recipe / sample に沿って既存成果物を磨き込むことを求めた。下書きや調査による新しい値の選定は draft の役割である。磨き込みでは template を読み込まない。rulebook の必須要素・禁止事項、recipe の問い、sample の形式との整合は grade が評価済みである。review はこれらを照合し直さず、評価結果の finding として扱う。
47
50
 
48
51
  参照ファイル(rulebook frontmatter から解決。`_MISSING_` の項目は未宣言・未整備):
49
52
 
50
53
  - rulebook: `_RULEBOOK_REF_`
51
54
  - recipe: `_RECIPE_REF_`
52
55
  - sample: `_SAMPLE_REF_`
53
- - template: `_TEMPLATE_REF_`
56
+ - 併せて適用する rulebook(記法など): _RULEBOOK_INCLUDES_
54
57
 
55
- 1. フェーズ説明と完了条件が求めた作成・更新が、対象成果物に行われたかを確認する。
58
+ 1. フェーズ説明と完了条件が求めた磨き込みが、対象成果物に行われたかを確認する。
56
59
  2. 実践の型の欠落(`_MISSING_`)や内容の薄さがある場合は、実行記録にその扱いが残っているかを確認する。実践の型そのものの整備が必要な場合は、改善指示に残す。
57
60
  3. finding が残っている場合は、このタスクの完了を妨げるかを判断する。rulebook の必須要素の欠落や禁止事項への抵触など、完了条件に直結する finding は完了を妨げる。
58
61
 
59
- 確認に用いてよい文書は、この plan に記載されたものに限る。具体的には、評価結果、対象成果物、本セクションの参照ファイル、`depends_on` 成果物、プロジェクトコンテキスト、実行記録である。plan に列挙されていない他のプロジェクト文書を独自に探索・参照しない。
62
+ 確認に用いてよい文書は、宣言された文書だけに限る。具体的には、評価結果、対象成果物、本セクションの参照ファイル、`depends_on` 成果物、対象成果物の frontmatter の `based_on`、プロジェクトコンテキスト(`project_context`)、個票の `入力`、カタログの `brief`、実行記録である。`入力` と `brief` は値が無いときは載せない。これらに宣言されていない他のプロジェクト文書や外部の情報を独自に探索・参照しない。
60
63
 
61
64
  本タスクの実行に必要な fully-guided の確認方針は、このセクションで完結する。approach 全体の定義(他 approach との対比や edit への適用)を確認したい場合のみ、参考として [[specdojo:ryu-guide]] を参照する。
62
65
 
@@ -336,7 +336,20 @@ npm install --save-dev @specdojo/docs-site
336
336
  npx specdojo-docs-site build .
337
337
  ```
338
338
 
339
- 開発サーバは `npx specdojo-docs-site dev .` で起動します。`build` と `dev` は、利用リポジトリに存在しない package 同梱の kata・guide・reference を、gitignore 済みの `specdojo-kata-staging/` へ一時的に複製して `/ja/specdojo/` で配信します。eject 済みの文書は利用リポジトリ側を優先するため、サイト表示のために `kata install --all` を実行する必要はありません。
339
+ 開発サーバは `npx specdojo-docs-site dev .` で起動します。`build` と `dev` は、利用リポジトリの `docs/` と package 同梱の kata・guide・reference を `.vitepress/kata-staging/docs/` に重ねた閲覧用ツリーを作り、`/ja/specdojo/` で配信します。eject 済みの文書は利用リポジトリ側を優先し、`dev` 中の編集・追加・削除も同期するため、サイト表示のために `kata install --all` を実行する必要はありません。ページ走査のルートをこのツリーに限定し、`.vitepress/dist` や cache、利用者の設定ファイルはページに含めません。
340
+
341
+ Mermaid SVG の生成だけを行う場合は `npx specdojo-docs-site mermaid .` を使います。SVG と manifest は `.vitepress/mermaid/`、サイトの build 結果は `.vitepress/dist/`、cache は `.vitepress/cache/` に置きます。図の公開 URL は `/mermaid/<hash>.svg` を維持し、利用者の `public/` のファイルも従来どおり配信します。
342
+
343
+ `specdojo config init` は `.gitignore` の既存の内容を保持して、次の生成ディレクトリだけを除外します。既存のリポジトリでは再実行するか、手動で追記してください。`.vitepress/` 全体を除外せず、利用者の設定ファイルは Git 管理対象に残します。
344
+
345
+ ```text
346
+ /.vitepress/dist/
347
+ /.vitepress/cache/
348
+ /.vitepress/mermaid/
349
+ /.vitepress/kata-staging/
350
+ ```
351
+
352
+ 旧配置の `public/mermaid/` と `specdojo-kata-staging/` は自動で削除しません。移行時は内容を確認し、不要な生成物だけを手動で片付けてください。
340
353
 
341
354
  ### 6.1. Mermaid 図を組み立てる
342
355
 
@@ -527,13 +527,15 @@ app1-specdojo-worktrees/
527
527
 
528
528
  統合は次の順序で行います。
529
529
 
530
- 1. 全リポジトリで commit 対象を commit し、merge できるかを事前に検査する。1つでも統合できないリポジトリがあれば、どのリポジトリも統合しない。
531
- 2. 宣言順にプロダクトの exec branch を統合先ブランチへ merge commit で統合する。プロダクト側の commit と merge commit には `Refs: <project-id>:<item-id>` を付ける(register 項目の場合)。
532
- 3. 統合後のプロダクトの trace key と commit snapshot を、プロジェクト側の result 本文へ記録する。
530
+ 1. 全リポジトリで commit 対象を commit し、merge するリポジトリでは merge 可否、`branch-only` では exec worktree に未 commit の変更が無いことを事前に検査する。1つでも検査に失敗したリポジトリがあれば、どのリポジトリも統合しない。
531
+ 2. 宣言順にプロダクトを処理する。`repos[].integration_strategy` が `merge`(既定)の場合は exec branch を統合先ブランチへ merge commit で統合し、`branch-only` の場合は merge せず exec branch を保持する。プロダクト側の commit と merge commit には `Refs: <project-id>:<item-id>` を付ける(register 項目の場合)。
532
+ 3. プロダクトの trace key、exec branch 名、状態、統合先の commit snapshot を、プロジェクト側の result 本文へ記録する(register 項目の場合)。`branch-only` は未統合と明示し、統合先の snapshot と PR は `not applicable` とする。
533
533
  4. プロジェクトの exec branch を `app1-specdojo/` の統合先ブランチへ統合する。
534
- 5. 全リポジトリの統合後に、全リポジトリの worktree と exec branch をまとめて撤去する。
534
+ 5. 処理成功後に全リポジトリの worktree を撤去する。`merge` の exec branch とプロジェクトの exec branch は削除し、`branch-only` の exec branch は変更の有無によらず残す。
535
535
 
536
- ソースを先に統合することで、プロダクトの統合を SpecDojo 側の統合成否から切り離します。プロジェクト側の記帳(`review` への遷移と result)は、プロダクトがすべて統合された後にだけ統合先へ入ります。
536
+ ソースを先に処理することで、プロダクトの処理を SpecDojo 側の統合成否から切り離します。プロジェクト側の記帳(`review` への遷移と result)は、全プロダクトが merge 済み・変更なし・`branch-only` の保持のいずれかになった後に統合先へ入ります。`review` は SpecDojo のタスク成果を確認する段階であり、プロダクト側の PR が merge 済みであることを意味しません。
537
+
538
+ PR レビューを必須にするプロダクトは、[[specdojo:specdojo-config-reference|設定リファレンス]] の `repos` で `"integration_strategy": "branch-only"` を選びます。統合先への merge 可否や統合先 checkout の未 commit 変更は、そのリポジトリの事前検査を妨げません。runner は push と PR 作成(`gh` を含む)を実装せず、利用者が必要な承認のもと、保持された branch を push してプロダクト側で PR を作ります。squash merge では `Refs:` を commit メッセージに残してください。未統合の branch は `exec worktree prune` でも削除しません。同じ項目を新規実行する際に保持済み branch があると停止するため、既存 run を再開するか、プロダクト側の作業を終えて branch を退避・削除します。
537
539
 
538
540
  ### 10.7. 複数リポジトリの統合の失敗と再開
539
541
 
@@ -545,10 +547,10 @@ app1-specdojo-worktrees/
545
547
  | n 番目のプロダクトの統合 | 1〜n-1 番目のプロダクトだけ統合済み | 項目を `waiting` とし、統合済みのプロダクトを飛ばして n 番目から再開する |
546
548
  | プロジェクトの統合 | 全プロダクトが統合済み、プロジェクトは未統合 | 項目を `waiting` とし、プロダクトを再統合せずプロジェクトの統合だけ再開する |
547
549
 
548
- - リポジトリ別の状態(`pending` / `merged` / `unchanged` / `failed`)は、run の `pipeline-state.json` の `stages.integrate.repos` に記録します。失敗の詳細は同じ run の `integrate.log` に残ります。
550
+ - リポジトリ別の状態(`pending` / `merged` / `unchanged` / `branch-only` / `failed`)は、run の `pipeline-state.json` の `stages.integrate.repos` に記録します。失敗の詳細は同じ run の `integrate.log` に残ります。
549
551
  - `block_reason` には、失敗したリポジトリ、統合済みのリポジトリ、未統合のリポジトリを記録します。
550
552
  - 失敗後も全リポジトリの worktree と exec branch を保持します。原因を解消した後、`exec run --register <item-id> --worktree --resume` で統合段から再開します。agent は再実行しません。
551
- - 再開の前に、runner は未統合のリポジトリにだけ統合先の最新を取り込みます。`stages.integrate.repos` で統合済み(`merged` / `unchanged`)のプロダクトは取り込まず、exec branch に merge commit を作りません。
553
+ - 再開の前に、runner は未統合のリポジトリにだけ統合先の最新を取り込みます。`stages.integrate.repos` で統合済み(`merged` / `unchanged`)または方式が `branch-only` のプロダクトは取り込まず、exec branch に merge commit を作りません。
552
554
  - 再開時は、統合先へ取り込み済みのプロダクトを merge し直さず、最初の統合で作った merge commit を result の trace 表へ記録します。
553
555
 
554
- 一部のリポジトリだけが統合済みの状態は完了ではないため、`review` へ進めません。統合を打ち切る場合、統合済みのプロダクトの変更を残すか revert するかは、通常の統合後の判断として人が決めます。自動的に履歴を巻き戻しません。
556
+ `branch-only` の保持はそのリポジトリの処理完了とします。これを除き、一部のリポジトリだけが統合済みの状態は完了ではないため、`review` へ進めません。統合を打ち切る場合、統合済みのプロダクトの変更を残すか revert するかは、通常の統合後の判断として人が決めます。自動的に履歴を巻き戻しません。
@@ -334,6 +334,8 @@ routing:
334
334
 
335
335
  `lint-ts`(`npm run lint:ts`)、`lint-fm`(`npm run lint:fm`)、`lint-md`(`npm run lint:md`)は、executor が残した ESLint・frontmatter・Markdown の lint エラーを agent の段階で検出します。指定しない場合、これらのエラーは統合後の `npm run check` まで持ち越されます(PJR-K1Z5)。
336
336
 
337
+ `lint-mermaid`(`npm run lint:mermaid`)は、Markdown の Mermaid の図の構文エラーを統合前に検出します。markdownlint と remark は図の中身を検査しないため、図の構文エラーは `docs:build` まで分かりません。利用するリポジトリに `lint:mermaid` script と、検査に使う Mermaid の依存が必要です。
338
+
337
339
  `build`(`npm run build`)と `format-check`(`npm run format:check`)は、別リポジトリ構成でプロダクトリポジトリのビルド確認とコード整形確認を親 runner で実行するために使います。agent の sandbox 内で npm を実行できない環境でも、統合前にビルドと整形の検査を自動化できます(PJR-NS8Y)。
338
340
 
339
341
  `specdojo.config.json` の project に `repos` を宣言した別リポジトリ構成では、`pipeline.parent_validations` の要素に `{ id, repo }` を書き、検証を実行するリポジトリを割り当てられます(PJR-V96B)。ID だけの要素はプロジェクトリポジトリで実行します。`repo` には、プロジェクトリポジトリを表す `project` か、`repos` で宣言したプロダクトリポジトリの名前を書きます。
@@ -555,7 +557,7 @@ executor の出力は、そのまま reporter へ渡さずに run 単位の evid
555
557
  - 親検証は失敗時だけ出力を保存し、成功時は要約だけを記録します。失敗ログは `parent-validation-output` として `log_refs` から参照します。同じ run の resume や統合段の再検証では attempt 番号を増やして新しいログを追加し、以前の失敗ログを上書きしません。親検証の要約は 1,000 文字以内で先頭と末尾を残すため、末尾に出る失敗ケース名と件数を evidence から確認できます。
556
558
  - evidence ディレクトリは Git の管理対象です。成功して統合された run のログは履歴に残り、失敗中の worktree では未コミットのまま保持されます。`--force-restart` などで worktree を破棄すると未コミットログも失われるため、必要な調査を先に行います。既知パターンは保存前に秘匿しますが、未知形式の秘密が残る可能性を考慮し、ログを外部共有する前に内容を確認します。
557
559
  - executor が構造化した最終報告を返す場合は、標準出力に `<specdojo_executor_evidence>` タグで JSON(`final_message`・`validations`・省略可能な `completion_status`・`handoff`)を出します。`validations[].status` は `passed` / `failed` / `not_run` / `not_applicable` / `requires_human` のいずれかです。`not_applicable` はリポジトリが検査の適用条件を満たさない場合に使い、`reason` へ理由を必ず記録します。`requires_human` は、実 agent CLI の起動、利用枠や課金を伴う操作、認証情報やホスト側の操作など、agent の sandbox から実行できない確認だけに使います。実行できるが省略した検証には使わず、`not_run` として記録します。タグが無い場合は標準出力の残りを最終メッセージとして扱います。
558
- - `pipeline.parent_validations` には `validate-schema`(`npm run validate:schema`)、`typecheck`(`npm run typecheck`)、`test-unit`(`npm run test:unit`)、`test-integration`(`npm run test:integration`)、`lint-ts`(`npm run lint:ts`)、`lint-fm`(`npm run lint:fm`)、`lint-md`(`npm run lint:md`)、`build`(`npm run build`)、`format-check`(`npm run format:check`)を指定できます。親 runner は executor の成功後・reporter の起動前に、指定順で固定 argv の検証を実行します。
560
+ - `pipeline.parent_validations` には `validate-schema`(`npm run validate:schema`)、`typecheck`(`npm run typecheck`)、`test-unit`(`npm run test:unit`)、`test-integration`(`npm run test:integration`)、`lint-ts`(`npm run lint:ts`)、`lint-fm`(`npm run lint:fm`)、`lint-md`(`npm run lint:md`)、`lint-mermaid`(`npm run lint:mermaid`)、`build`(`npm run build`)、`format-check`(`npm run format:check`)を指定できます。親 runner は executor の成功後・reporter の起動前に、指定順で固定 argv の検証を実行します。
559
561
  - executor prompt には設定済み ID と対応コマンドを明示します。executor はそのコマンドや対象限定版を sandbox 内で実行せず、executor evidence の validations にも含めなくてよいものとします。親 runner の結果は `source: runner` と許可リスト `id` 付きで同じ `validations` 配列へ保存します。executor が同じ検査を `not_run` または `not_applicable` として含めた場合も、同じリポジトリで実行された親 runner の結果を正とします。これにより sandbox 内で成立しない検証を親へ移した場合も二重実行せず、executor の重複報告で run を止めません。
560
562
  - result の `changed_files` のパスは evidence の `changes` から、execution の evidence、project register とその派生ビュー、当該 result という runner 管理記録を除いて runner が機械生成します。除外後の変更一覧だけを reporter へ渡し、edit の変更説明は evidence のパスと対にして受け取ります。runner はパスで突き合わせるため、説明の順序は問いません。説明が不足したパスには Git の変更メタデータ(追加・変更・削除・名前の変更、行数)を記録し、変更ファイルが多い場合(50 件超)はディレクトリごとに集約して記録します。evidence にないパスの説明は捨てます。`outcome` と `block_reason` は stage の状態・終了コード・保護機構が保存した理由・executor / 親 runner の検証から機械生成します。reporter の JSON Schema は文章項目と対応づけ用のパスだけを受け付け、いずれかの検証が failed または `not_run` なら、reporter の文章にかかわらず機械判定は blocked です。ただし、executor が `not_run` または `not_applicable` と記録したコマンドを、親 runner が同じリポジトリで同じコマンドとして実行し成功していれば、親 runner の結果を正として executor の報告を無視します。さらに、`npm run <name>` に対応する script がない、`npx <package>` の package が `dependencies` / `devDependencies` にない、検査の対象となる種類の変更ファイルがない、または SpecDojo サブコマンドの設定上の適用条件を満たさないことを runner が機械的に確定できる場合、その `not_run` は block せず、edit result の申し送りへ「適用外の検証(runner の判定)」として追記します。変更ファイル種別で判定する対応は共通規約の検査表を正本とし、`validate:schema:file` は `*.yaml` / `*.yml`、Prettier は `*.md` / `*.ts` / `*.js` / `*.json` / `*.yaml` / `*.yml`、markdownlint は `*.md` の変更がある場合だけ適用対象とします。rename は変更前後の両方を見て、プロダクトリポジトリのコマンドはそのリポジトリの変更だけで判定します。`typecheck` など、この対応に含まれない検査の判定は変更しません。SpecDojo の起動形は `specdojo <subcommand>`、`npx specdojo <subcommand>`、ソース/配布済み CLI の直接起動を認識し、`catalog validate` は対象 project の `catalog_path` で判定します。対象 project は、コマンドの `--project <id>`、run の対象 project(runner が execution path に一致する project を設定から特定したもの)、`current_project` の順に決めます。別の project が `catalog_path` を持っていても、run の対象 project に `catalog_path` がなければ適用外です。対象 project に `catalog_path` があっても、executor の変更(runner 管理記録を除き、rename は変更前後の両方を見ます)が `docs/ja/projects/` 配下に及ばない run では、plan の共通規約の検証表と同じく適用外とし、executor の `not_applicable` も受理します。変更が及ぶ run では従来どおり適用対象です。また、`<repo>:<path>` を引数に含むコマンド、`--prefix <repo>` 付きのコマンド、または `$SPECDOJO_REPO_<NAME>` / `${SPECDOJO_REPO_<NAME>}` を含むコマンドは、対象 project が `repos` で宣言したそのプロダクトリポジトリの `package.json` で script と依存を判定します(`--prefix` はリポジトリ名か設定の `path` と一致するものを対象にします)。設定が読めない、対象 project を特定できない、または適用条件を未定義のサブコマンドは機械的な救済をせず、通常の `not_run` として扱います。executor の failed は親 runner の成功や適用外判定で打ち消しません。`npm run check` のように npm script を `&&` でつないだだけの合成コマンドを executor が `not_run` とした場合は、対象リポジトリの `package.json` の script を展開し、構成する各コマンドが同じリポジトリの親検証か executor 自身の検証で通っていれば満たされたものとして扱います。`npm test` は、`npm run test:unit` と `npm run test:integration` の両方が通っていれば満たされたものとします。構成するコマンドの script の中身と同じコマンドを executor が直接実行して通した場合も満たします(`tsx` の起動の書き方の違いはそろえて比べます)。任意のシェルを含む script は展開しません。理由付きの `not_applicable` は block の理由にせず、runner が edit result の申し送りへ「適用外の検証: `<コマンド>`(<理由>)」として機械的に追記します。ただし、理由がない場合、変更ファイル種別を含む適用条件を満たした `npm run <name>` の script が存在する場合、または同条件を満たした `npx <package>` の package が `dependencies` / `devDependencies` に存在する場合は誤申告として blocked にします。SpecDojo サブコマンドは package の有無だけでは反証せず、既知の適用条件を設定から判定します。適用条件が未定義なら理由付きの agent の申告に従います。`specdojo index build`(`npx specdojo index build`・`node --import tsx src/specdojo.ts index build` などの起動形を含みます)は runner が担う検証です。出力先の `.specdojo/doc-index.json` は agent が書き込めず、index は worktree の準備と統合の前に runner が再生成するため、executor への指示では実行も記録もしないよう伝えます。executor が `not_run` / `not_applicable` と記録しても block の理由にせず、`not_run` の場合は edit result の申し送りへ「runner が担う検証: `<コマンド>`(<理由>)」として追記します。runner の再生成が失敗した場合は worktree の準備で run が止まるか、runner の検証の失敗として block するため、満たしたものとは扱いません。executor の failed は救済せず、ほかの SpecDojo サブコマンドの `not_run` の扱いも変えません。executor の `requires_human` は block の理由にせず、runner が edit result の申し送りへ「人の確認が必要: `<コマンド>`(<要約>)」として機械的に追記します。項目は review へ進み、人が確認してから close します。
561
563
  - `completion_status` は作業の完了状態を示す省略可能な欄で、値は `complete` / `incomplete` です。欄のない既存の報告は `complete` として扱います。値が指定されていてこの 2 値に合わない場合は、安全側に倒して `incomplete` として保存します。executor は計画の作業を終えられなかった場合、`incomplete` とし、理由を `final_message`、残作業を `handoff` に書きます。終了コード 0 や親検証の成功では未完了の申告を上書きしません。`exec run --register` は親検証・reporter を起動する前に停止し、項目を `waiting` にして、秘匿処理・文字数制限を適用した `final_message` の要旨を `block_reason` に記録します。worktree 実行では変更と evidence を残し、統合しません。pipeline の executor は `blocked`、evidence の `stage.status` と `exit_code` は実際のプロセス結果のままとします。`--resume --resume-from executor`(または `--resume`)で再開でき、前回の理由と `handoff`、途中の変更を executor に引き継ぎます。完了を申告し直し、必要な検証を通過してから review・統合へ進みます。
@@ -17,7 +17,7 @@ Exec Operation Guide
17
17
 
18
18
  **この文書で分かること**
19
19
 
20
- - 実行経路の選び方、状態遷移、blocked 復帰、再実行、human タスクの扱い、register から approach を使って成果物・kata を作る・直す手順
20
+ - 実行経路の選び方、状態遷移、blocked 復帰、再実行、human タスクの扱い、register から approach を使って成果物・kata を作る・直す手順、文脈を渡して段階的に作成する流れ
21
21
 
22
22
  **次に読む文書**
23
23
 
@@ -43,25 +43,26 @@ exec が扱う関心事、タスクの出どころによる実行経路の選び
43
43
 
44
44
  ### 1.2. 実行経路の使い分け
45
45
 
46
- agent にタスクを実行させる経路は、実行対象の出どころによって schedule 実行と register 実行の 2 つがあります。routine はそれらを時刻条件で発火させるトリガー層で、それ自体は実行機構を持ちません。「何を実行するか」(schedule / register)と「いつ実行するか」(人が起動する / routine が定期起動する)は独立に選べます。
46
+ agent にタスクを実行させる経路には、業務の起点・着手承認・完了判断を担う register と、成果物カタログに基づく途中の進み具合を担う schedule があります。両者は同格の 2 経路ではなく、register を親、schedule を子とする階層関係にあります。routine はそれらを時刻条件で発火させるトリガー層で、それ自体は実行機構を持ちません。「何を実行するか」(register の項目 / schedule のタスク)と「いつ実行するか」(人が起動する / routine が定期起動する)は独立に選べます。
47
47
 
48
- | 観点 | schedule 実行 | register 実行 | routine(トリガー層) |
49
- | ------------ | ----------------------------------------- | ------------------------------------------------- | ---------------------------------------- |
50
- | 実行対象 | `sch-track-*.yaml` のタスク(依存グラフ) | `generated/pjr-index.md` の項目 | `rtn-*.yaml` の定義(実体は左の 2 経路) |
51
- | 代表コマンド | `exec run --task` / `exec run --auto` | `exec run --register` | `routine run --due` |
52
- | 起動 | 人、または routine(`job-exec-auto`) | 人、または routine(`job-register-sweep`) | 外部スケジューラ(cron / CI) |
53
- | 状態追跡 | exec events(claim / complete / block) | register の遷移(in-progress / review / waiting) | `last_run` の記録のみ |
54
- | 隔離 | worktree(`--worktree` / `--auto`) | `run.register_execution` または CLI で選択 | -(実行経路へ委譲) |
55
- | 終端の扱い | `complete` event(human finalize で確定) | 人が確認して `register close` | -(発火の記録のみ) |
56
- | 典型用途 | 計画された成果物の作成・レビュー・確定 | 立ち上げ時の課題・判断、進行中の計画外対応・調査 | 日次スイープ・夜間バッチなどの定期実行 |
48
+ | 観点 | register 実行(親: 起点・承認・完了) | schedule 実行(子: 途中の進捗・依存実行) | routine(トリガー層) |
49
+ | ------------ | --------------------------------------------------------------------------- | ----------------------------------------- | ---------------------------------------- |
50
+ | 役割 | 業務の起点、着手承認、完了判断、単発の調査・対応 | 成果物の依存関係に基づく進捗管理・実行 | 定期起動・スケジューリング |
51
+ | 実行対象 | `generated/pjr-index.md` の項目(todo / issue / change-request 等) | `sch-track-*.yaml` のタスク(依存グラフ) | `rtn-*.yaml` の定義(実体は左の 2 経路) |
52
+ | 代表コマンド | `exec run --register` | `exec run --task` / `exec run --auto` | `routine run --due` |
53
+ | 起動 | 人、または routine(`job-register-sweep`) | 人、または routine(`job-exec-auto`) | 外部スケジューラ(cron / CI) |
54
+ | 状態追跡 | register の遷移(in-progress / review / waiting) | exec events(claim / complete / block) | `last_run` の記録のみ |
55
+ | 隔離 | `run.register_execution` または CLI で選択 | worktree(`--worktree` / `--auto`) | -(実行経路へ委譲) |
56
+ | 終端の扱い | 人が確認して `register close`(epic も人が判断) | `complete` event(human finalize で確定) | -(発火の記録のみ) |
57
+ | 典型用途 | 課題・判断、track の epic 起票、カタログ・strategy 計画、計画外の対応・調査 | 計画された成果物群の作成・レビュー・確定 | 日次スイープ・夜間バッチなどの定期実行 |
57
58
 
58
59
  迷った場合は次で判断します。
59
60
 
60
- - 成果物カタログと依存関係に基づく計画済みの作業は schedule 実行を使う(`exec run --auto` / `--task`。手順は [Schedule実行運用ガイド](schedule-operation-guide.md))。
61
- - 立ち上げ時の未整理な課題・判断、または進行中に発生した計画外の単発対応・調査で、台帳として追跡したいものは register を使う(`register add` で登録し、agent 実行可能な type は `exec run --register`。手順は [登録簿運用ガイド](register-operation-guide.md))。
62
- - 上記のどちらかを決まった時刻条件で繰り返したい場合は routine を使う(`rtn-*.yaml` を定義して外部スケジューラから `routine run --due` を呼ぶ。手順は [routine運用ガイド](routine-operation-guide.md))。
61
+ - 業務の起点・着手承認・完了判断、未整理な課題や判断、単発の対応・調査、およびカタログや strategy の計画は register を使う(`register add` で登録し、agent 実行可能な type は `exec run --register`。まとまった仕事は track ごとに `epic` を起票する。手順は [登録簿運用ガイド](register-operation-guide.md))。
62
+ - `epic` のもとで成果物カタログと依存関係を展開し、途中の進み具合を管理しながら進める作業は schedule 実行を使う(`exec run --auto` / `--task`。手順は [Schedule実行運用ガイド](schedule-operation-guide.md))。
63
+ - 上記のいずれかを決まった時刻条件で繰り返したい場合は routine を使う(`rtn-*.yaml` を定義して外部スケジューラから `routine run --due` を呼ぶ。手順は [routine運用ガイド](routine-operation-guide.md))。
63
64
 
64
- register 実行は exec events を記録しないため、schedule の Ready・CPM・phase gate には影響しません。立ち上げ時の個票で目的・スコープ・対象成果物を決定したら、カタログ作成の個票を完了し、以後の計画済み作業を schedule のタスクとして管理します。
65
+ register 実行は exec events を記録しないため、schedule の Ready・CPM・phase gate には影響しません。まとまった仕事は track ごとに `epic` を起票し、その子 todo でカタログ作成(`catalog-planning`)や strategy 作成(`strategy-planning`)を進めて schedule へ展開します。途中の進み具合は schedule が持ち、トラック完了時に人が `epic` の完了を判断して close します。
65
66
 
66
67
  登録の判断、type の選び方、個票の作成などの台帳運用は [登録簿運用ガイド](register-operation-guide.md) を参照します。
67
68
 
@@ -652,7 +653,7 @@ specdojo:
652
653
  #### 4.3.1. 成果物を対象にする場合
653
654
 
654
655
  - **対象(`targets`)**: 成果物カタログ(DCT)に定義されている成果物の文書 ID(doc id)を指定します(例: `prj-0001:cxd-specdojo`、`specdojo:exec-config-guide`)。プロダクト成果物の場合は `local_id` の canonical 形式(`<project-id>:<local_id>`)も受け付けます。まだ文書ファイルが作成されていない成果物であっても、カタログに定義されていればカタログで解決され、起票・実行できます。
655
- - **進め方(`approach`)**: 成果物を作成・修正する進め方(`fully-guided`、`recipe-guided`、`freeform`、`bootstrap`、`retrofit`、`cross-deliverable-dedup` など)から目的に応じて選びます。
656
+ - **進め方(`approach`)**: 成果物を作成・修正する進め方(`draft`(文脈を調べて下書き)、`fully-guided`(既存成果物の磨き込み)、`recipe-guided`、`freeform`、`bootstrap`、`retrofit`、`cross-deliverable-dedup` など)から目的に応じて選びます。
656
657
 
657
658
  #### 4.3.2. kata(実践の型)を対象にする場合
658
659
 
@@ -710,3 +711,97 @@ specdojo register close \
710
711
  --id <PJR-ID> \
711
712
  --conclusion "設定ガイドを改訂し検証を通過"
712
713
  ```
714
+
715
+ ### 4.7. 文脈を渡して段階的に作成する手順
716
+
717
+ 成果物をゼロから作成する場合や、技術スタックの選定などの調査を伴う場合は、成果物の雛形作成から文脈の記入、下書き(`draft`)、磨き込み(`fully-guided`)、人間の確定(`finalize`)へと段階的に個票を分けて進めます。
718
+
719
+ #### 4.7.1. 5つの段階と役割分担
720
+
721
+ 成果物作成の流れは、次の 5 段階で役割を分担します。
722
+
723
+ | 段階 | 実行主体 | approach | 役割と進め方 |
724
+ | ----------------------- | -------- | -------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
725
+ | 1. 雛形作成(scaffold) | CLI / 人 | - | `deliverable scaffold` で成果物のファイル雛形を生成する |
726
+ | 2. 文脈の記入 | 人 | - | 成果物内に `_CONTEXT_:` を記入、または個票の `入力`(`--input`)で前提・制約・調査委任の指示を渡す |
727
+ | 3. 下書き(draft) | agent | `draft` | 文脈で任された範囲を調査・選定して下書きする。選定値を提案として示し、出典と選定理由を result に記録する。反映した `_CONTEXT_:` は削除して result に写す |
728
+ | 4. 磨き込み(refine) | agent | `fully-guided` | 既存成果物を実践の型(rulebook / recipe / sample)に照らして構造・用語・整合性を磨き込む(磨き込み専用)。新たな調査や外部情報の追加は行わない |
729
+ | 5. 確定(finalize) | 人 | `finalize` | `done_criteria` や未反映の文脈指示(`_CONTEXT_:` の残り)がないことを確認し、成果物の `status` を `ready` へ昇格する |
730
+
731
+ #### 4.7.2. 個票の分割と `depends_on` による連携
732
+
733
+ この流れをプロジェクト登録簿(register)で進める場合は、`draft`、`fully-guided`、`finalize` の各段階を個票(`todo`)として起票し、`depends_on` で先行タスクに依存させて順に実行します。
734
+
735
+ たとえば、フロントエンドの技術スタック詳細定義(TSD)を「静的サイトで主流の技術スタックで書く」と指示して段階的に作成する場合の手順は次のとおりです。
736
+
737
+ ```bash
738
+ # 1. 雛形を作成する
739
+ # カタログにある成果物を 1 件だけ指定して作成する場合:
740
+ specdojo deliverable scaffold \
741
+ --project prj-0001 \
742
+ --target prj-0001:tsd-frontend-site
743
+
744
+ # カタログにない成果物を雛形にする場合は --target-path と --target-rulebook を指定する:
745
+ specdojo deliverable scaffold \
746
+ --project prj-0001 \
747
+ --target prj-0001:tsd-custom-tool \
748
+ --target-path docs/ja/projects/prj-0001/architecture/tsd-custom-tool.md \
749
+ --target-rulebook specdojo:tsd-rulebook
750
+ ```
751
+
752
+ `deliverable scaffold` は `--target <doc-id>` で成果物を 1 つだけ指定して雛形を作成できます。カタログにない成果物は、`--target-path` と `--target-rulebook` を添えて作成します(PJR-S23T)。また、`specdojo:tsd-rulebook` のように template を持たない(`template: not-needed` と宣言された)rulebook であっても、最小構成の雛形(frontmatter、見出し、本文の `_TODO_`)が生成されます。その際、雛形 frontmatter の `type` は rulebook の `deliverable_type`(TSD の場合は `architecture`)が自動設定されるため(未宣言なら `project`)、`docs-lint` の `frontmatter-deliverable-type` 検証をそのまま通過できます(PJR-YKYK)。
753
+
754
+ ```bash
755
+ # 2. 成果物に文脈を記入する(または個票の --input で渡す)
756
+ # 生成された docs/.../tsd-frontend-site.md の先頭章などに次のように記入する:
757
+ # _CONTEXT_: 静的サイトで主流の技術スタック(Astro 等)を調査し、採用理由・全体構成・導入手順を下書きしてください。
758
+
759
+ # 3. 下書き(draft)の個票を起票する(対話から得た前提は --input でも渡せる)
760
+ specdojo register add \
761
+ --project prj-0001 \
762
+ --type todo \
763
+ --title "フロントエンドTSDの下書き(draft)" \
764
+ --topic tsd-frontend-draft \
765
+ --difficulty medium \
766
+ --approach draft \
767
+ --target prj-0001:tsd-frontend-site \
768
+ --input "静的サイトで主流の技術スタック(Astro 等)を調査して選定する" \
769
+ --owner DEV
770
+
771
+ # 4. 磨き込み(fully-guided)の個票を起票し、draft 個票に依存させる
772
+ specdojo register add \
773
+ --project prj-0001 \
774
+ --type todo \
775
+ --title "フロントエンドTSDの磨き込み(fully-guided)" \
776
+ --topic tsd-frontend-refine \
777
+ --difficulty medium \
778
+ --approach fully-guided \
779
+ --target prj-0001:tsd-frontend-site \
780
+ --depends-on <DRAFT-PJR-ID> \
781
+ --owner DEV
782
+
783
+ # 5. 確定(finalize)の個票を起票し、fully-guided 個票に依存させる
784
+ specdojo register add \
785
+ --project prj-0001 \
786
+ --type todo \
787
+ --title "フロントエンドTSDの確定(finalize)" \
788
+ --topic tsd-frontend-finalize \
789
+ --difficulty easy \
790
+ --approach finalize \
791
+ --target prj-0001:tsd-frontend-site \
792
+ --depends-on <REFINE-PJR-ID> \
793
+ --owner PO
794
+ ```
795
+
796
+ #### 4.7.3. 順次実行と引き継ぎ
797
+
798
+ 起票した個票は、`depends_on` の順序に従って実行します。
799
+
800
+ 1. **下書き(draft)の実行**:
801
+ `exec run --register <DRAFT-PJR-ID> --worktree` を実行します。agent は成果物内の `_CONTEXT_:` や個票の `入力` を読み取り、技術スタックを調べて下書きします。反映した `_CONTEXT_:` は削除され、元の指示と選定理由は draft の result に記録されます。実行完了後に内容を確認し、`register close` します。
802
+ 2. **磨き込み(fully-guided)の実行**:
803
+ draft が完了したら、後続の `exec run --register <REFINE-PJR-ID> --worktree` を実行します。agent は draft で作成された草案を rulebook や recipe に適合するように磨き込みます。この段では外部調査を行わず、既存の草案の構造・記述を整理します。実行完了後に内容を確認し、`register close` します。
804
+ 3. **人間による確定(finalize)**:
805
+ 人が成果物を確認し、`done_criteria` を満たしていること、未反映の `_CONTEXT_:` が残っていないことをチェックします。問題がなければ `status` を `ready` へ昇格し、個票を close します。
806
+
807
+ 夜間や自動でまとめて実行する場合は、本ガイドの「2. 実行の列の組み方」と同様に、これらを 1 本の列に並べて順に流します。先行タスクが成功して統合されることで、後続タスクがその成果物を引き継いで実行されます。
@@ -17,7 +17,7 @@ Orchestrator Operation Guide
17
17
 
18
18
  **この文書で分かること**
19
19
 
20
- - オーケストレーターの位置づけ、起動用スクリプト、対話フロー、承認と安全の扱い、設定ファイルの構成
20
+ - オーケストレーターの位置づけ、起動用スクリプト、VS Code からの使い方、対話フロー、承認と安全の扱い、設定ファイルの構成
21
21
 
22
22
  **次に読む文書**
23
23
 
@@ -109,6 +109,24 @@ npx specdojo config scaffold --provider antigravity --global
109
109
 
110
110
  分離環境が必要な場合は、追加の任意手順として `devcontainer scaffold` を利用できます。既存の `.devcontainer/` は上書きされず、provider の設定ディレクトリは名前付きボリュームへ保存されます。詳細は [CLIコマンドリファレンス](../references/command-reference.md) の `devcontainer` を参照してください。
111
111
 
112
+ ### 2.2. VS Code から使う
113
+
114
+ VS Code の各種 AI 拡張機能からオーケストレーターを利用することもできます。拡張機能ごとの起動手順は次のとおりです。
115
+
116
+ - **GitHub Copilot Chat**:
117
+ `npx specdojo config scaffold --provider copilot` を実行して設定を配置した後、VS Code の Copilot Chat パネルで agent の選択肢から `specdojo-orchestrator` を選びます(`.github/agents/specdojo-orchestrator.md` が読み込まれます)。
118
+ - **Claude Code 拡張**:
119
+ 設定(settings)の `agent` キーに `specdojo-orchestrator` を設定すると、セッションがオーケストレーターとして開始されます。共有の `.claude/settings.json` に書くとそのリポジトリを利用する全員のすべてのセッションが対象になるため、各自のローカル設定である `.claude/settings.local.json` に記述することを推奨します。
120
+
121
+ ```json
122
+ {
123
+ "agent": "specdojo-orchestrator"
124
+ }
125
+ ```
126
+
127
+ - **Codex 拡張**:
128
+ Codex の VS Code 拡張(`Codex – OpenAI's coding agent`)で名前付きの agent の定義を選ぶ仕組みは、公式の文書では確かめられていません(2026-10 時点で未確認)。そのため、会話開始時に SSOT である `.agents/specdojo-orchestrator.agent.md` の本文を最初の指示(プロンプト)として渡して対話を開始します。
129
+
112
130
  ## 3. 対話の進め方
113
131
 
114
132
  オーケストレーターは「提案 → 承認 → 実行」を基本とします。
@@ -64,6 +64,8 @@ package の探索では `node_modules` 全体を再帰走査せず、resolver
64
64
 
65
65
  template は記述する部分を _TODO_ などのプレースホルダとして配置した雛形で、内容が埋まった完成例である sample と役割を分担します。
66
66
 
67
+ sample は成果物として成り立つ完成例であり、template の `type: template` と異なり、見本にする成果物の type を持ちます。`type` と sample の識別の原則は [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] を正本とします。
68
+
67
69
  ここでいう `reference` は文書種別です。exec plan が実行時に参照する実践の型(rulebook / recipe / sample / template)とは別の役割として扱います。
68
70
 
69
71
  ## 3. 種別間の関係と成果物への紐付け
@@ -27,7 +27,7 @@ SpecDojo CLI の初期設定から始め、register で課題と判断を整理
27
27
  - register のtypeと状態遷移は [登録簿運用ガイド](register-operation-guide.md) を参照してください。
28
28
  - Scheduleの自動・手動実行は [Schedule実行運用ガイド](schedule-operation-guide.md)、agent設定は [exec設定ガイド](exec-config-guide.md) を参照してください。
29
29
 
30
- 各コマンドには、設定済みのオーケストレーター(`specdojo-orchestrator`)へチャットで指示する場合の文言を `# チャット:` として併記します。オーケストレーターは指示を対応する `specdojo` サブコマンドへ変換し、状態を変える操作は実行前に内容を提示して承認を求めます。導入先での設定と起動方法は [オーケストレーター運用ガイド](orchestrator-operation-guide.md) を参照してください。`<project-id>` などのプレースホルダは実際の値に読み替えてください。
30
+ 各コマンドには、設定済みのオーケストレーター(`specdojo-orchestrator`)へチャットで指示する場合の文言を `# チャット:` として併記します。オーケストレーターは指示を対応する `specdojo` サブコマンドへ変換し、状態を変える操作は実行前に内容を提示して承認を求めます。オーケストレーターはターミナル(`npm run orch:<provider>`)だけでなく、VS Code の各種拡張機能(Copilot Chat、Claude Code、Codex)からも利用できます。導入先での設定と起動方法は [オーケストレーター運用ガイド](orchestrator-operation-guide.md)(VS Code からの利用は [VS Code から使う](orchestrator-operation-guide.md#22-vs-code-から使う) 節)を参照してください。`<project-id>` などのプレースホルダは実際の値に読み替えてください。
31
31
 
32
32
  ## 1. 10分で体験する — 仕様の判断台帳
33
33
 
@@ -336,6 +336,15 @@ npx specdojo config init
336
336
 
337
337
  `specdojo config init` は `.specdojo/specdojo.config.json` が存在しない場合に雛形を作成し、既存ファイルは上書きしません。雛形は register だけを使える最小構成であり、project パスはリポジトリルートを基準とし、`run.worktree_base` はディレクトリ名から作る `../<リポジトリ名>-worktrees` を指します。例えば `app1-specdojo/` では `../app1-specdojo-worktrees` です。作成された設定を開き、対象プロジェクトの ID と各パスを実際の名前に合わせてください。catalog、schedule、exec へ進むときに追加するキーと既定値は [[specdojo:specdojo-config-reference|SpecDojo設定リファレンス]] で確認できます。
338
338
 
339
+ 通常の `init` と `config init` は、markdownlint の設定がなければリポジトリ直下に
340
+ `.markdownlint.yaml` も作ります。日本語の長い行などを許容するため、MD013・MD024・MD033・MD036・MD041・MD060
341
+ を無効にし、ほかの記法検査は維持します。既存の設定は上書きしません。既存の利用リポジトリでも
342
+ `npx specdojo config init --dry-run` で確認してから `npx specdojo config init` を再実行すると、
343
+ 不足する設定を追加できます。設定がないままでも、exec の result の commit 前検査は同じ基本規則を使います。
344
+ 既存設定で MD013 が有効ならその指定を優先するため、長い行を許容する場合は利用側の設定で
345
+ `MD013: false` を指定してください。CLI2 と hook の設定の関係は
346
+ [[specdojo:command-reference|CLIコマンドリファレンス]] を参照してください。
347
+
339
348
  プロダクト文書は `app1/docs/ja/product/`、プロジェクト文書は `app1-specdojo/docs/ja/projects/` に置きます。同梱の SpecDojo の型(Kata)は `app1-specdojo/docs/ja/specdojo/<種類>s/`、このリポジトリで新しく作る kata はその下の `<kata_authority>/` から解決します。現行実装では1つの項目で両リポジトリを自動統合できないため、プロダクト文書や実装も変更する項目は分けるか、人が統合を管理します。詳細は [ドキュメント構成ガイド](docs-structure-guide.md) の `別リポジトリ構成` を参照してください。
340
349
 
341
350
  成果物と実装を常に同じ変更・履歴として扱う場合に限り、**同一リポジトリ構成**としてプロダクトリポジトリのルートで同じ初期化手順を実行できます。CLI は構成を強制しません。
@@ -363,8 +372,11 @@ npm install
363
372
  markdownlint で検査します。対象 project の `project_register_path` 配下を変更した場合は
364
373
  `register build`、`catalog_path` 配下を変更した場合は `catalog validate` も実行します。
365
374
  `catalog_path` がない構成には catalog の検査を生成せず、時間のかかるテストも pre-commit には
366
- 含めません。SpecDojo の文書が通る `.markdownlint.jsonc` と、provider の agent 定義を検査から外す
367
- `.markdownlintignore` も生成します。既存の markdownlint 設定と ignore は `--force` を付けても保持します。
375
+ 含めません。設定がなければ、同じ基本規則の `.markdownlintrc` と VS Code 向けの
376
+ `.markdownlint-cli2.yaml`、provider の agent 定義を検査から外す `.markdownlintignore` も生成します。
377
+ `init --lefthook` / `--slidev` もこの配置を使います。既存の `.markdownlint.yaml` などの設定と ignore は
378
+ `--force` を付けても保持します。CLI2 の overrides を使う場合は
379
+ [[specdojo:command-reference|CLIコマンドリファレンス]] の手順で既存設定を `.markdownlintrc` に移してください。
368
380
  `lefthook.yml` と `tools/` の既存ファイルは `--force` なしでは上書きしません。
369
381
  必要な npm script と devDependencies は書き込み前に表示し、同名の既存項目は `--force` を付けても
370
382
  保持します。linked worktree または `node_modules` がない環境では installer が安全に skip するため、
@@ -794,16 +806,17 @@ npx specdojo register add \
794
806
 
795
807
  どちらも別 project への起票では `--commit` が必須です。別リポジトリでは、相手に SpecDojo 0.4.2 以上と対象 project の統合ブランチが必要です。push は行わず、close などの状態遷移は対象 project の作業ツリーで行います。
796
808
 
797
- ### 3.14. issueからdecision、todo、成果物カタログへ進む
809
+ ### 3.14. issueからdecision、epic、成果物カタログ・Scheduleへ進む
798
810
 
799
- プロジェクト立ち上げ時に、問題、判断、実施作業がまだ混在している場合は、次の順で具体化します。この流れは register の履歴を、発展手順の成果物カタログと Schedule へつなぐ橋渡しです。
811
+ プロジェクト立ち上げ時に、問題、判断、実施作業がまだ混在している場合は、次の順で具体化します。register が起点と完了の判断を持ち、途中の進み具合は schedule が持ちます。
800
812
 
801
813
  ```text
802
814
  issue(何が問題か)
803
815
  -> decision(何を対象とするか)
804
- -> todo(成果物カタログを作成する)
805
- -> dct-<domain>.yaml
806
- -> schedule
816
+ -> epic(track の仕事を起票する)
817
+ -> 子 todo(成果物カタログや strategy を作成する)
818
+ -> schedule(成果物タスクの実行と進捗)
819
+ -> epic を完了する(人が判断)
807
820
  ```
808
821
 
809
822
  ```bash
@@ -821,22 +834,32 @@ npx specdojo register add \
821
834
  --title "初期スコープと対象成果物を決定する" \
822
835
  --topic decide-initial-scope
823
836
 
824
- # チャット:「高優先度の todo『プロジェクト定義の成果物カタログを作成する』を起票して」
837
+ # チャット:「launch トラックの epic を起票して」
838
+ npx specdojo register add \
839
+ --project <project-id> \
840
+ --type epic \
841
+ --track launch \
842
+ --title "プロジェクト定義の仕様整備" \
843
+ --topic project-definition
844
+
845
+ # チャット:「epic から子 todo『成果物カタログを作成する』を起票して」
825
846
  npx specdojo register add \
826
847
  --project <project-id> \
827
848
  --type todo \
828
- --priority high \
849
+ --from <epic-id> \
829
850
  --title "プロジェクト定義の成果物カタログを作成する" \
830
- --topic create-project-definition-catalog
851
+ --topic create-project-definition-catalog \
852
+ --approach catalog-planning \
853
+ --target domain:project-definition
831
854
  ```
832
855
 
833
- issue の調査結果を decision の選択肢へ、decision の結論を todo の完了条件へ引き継ぎます。decision は人が確定します。issue と todo は provider 未設定でも `exec plan --project <project-id> --register <PJR-ID>` で計画を確認でき、agent 設定後は `exec run --project <project-id> --register <PJR-ID> --worktree` で実行できます。
856
+ issue の調査結果を decision の選択肢へ、decision の結論を track の `epic` とその子 todo へ引き継ぎます。decision は人が確定します。issue や子 todo は provider 未設定でも `exec plan --project <project-id> --register <PJR-ID>` で計画を確認でき、agent 設定後は `exec run --project <project-id> --register <PJR-ID> --worktree` で実行できます(`epic` 自体は実行対象外です)。
834
857
 
835
- すべての登録項目には type 別の個票が作られ、個票 Frontmatter が構造化フィールドの正本になります。個票内の `_TODO_` を解消してから `register close` すると、個票の文書状態も `ready` になります。成果物カタログ作成の todo は、次章で `dct-<domain>.yaml` を作成・検証した後に完了させます。登録簿は立ち上げ時の課題・判断・作業履歴、成果物カタログは合意後の管理対象成果物の正本です。同じ計画済み作業を register と schedule の両方で継続管理しません。
858
+ すべての登録項目には type 別の個票が作られ、個票 Frontmatter が構造化フィールドの正本になります。個票内の `_TODO_` を解消してから `register close` すると、個票の文書状態も `ready` になります。成果物カタログ作成の todo は、次章で `dct-<domain>.yaml` を作成・検証した後に完了させます。todo の完了により `catalog_status` が `primary` と導出され、strategy 作成と Schedule への展開(`schedule build --track launch`)が可能になります。成果物タスクの途中の進捗は schedule の依存グラフで管理し、登録簿に個々の成果物タスクを二重管理しません。トラック完了時に人が `epic` を close します。
836
859
 
837
860
  ## 4. 発展: 成果物カタログからscheduleへ展開する
838
861
 
839
- この経路では、成果物カタログ(`dct-<domain>.yaml`)とトラック戦略(`sch-strategy-<track>.yaml`)から Schedule を生成し、依存関係に従ってタスクを実行します。
862
+ この経路では、epic の子 todo から成果物カタログ(`dct-<domain>.yaml`)とトラック戦略(`sch-strategy-<track>.yaml`)を作成して Schedule を生成し、依存関係に従ってタスクを実行します。
840
863
 
841
864
  ### 4.1. 成果物カタログを作成する
842
865