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
@@ -1,5 +1,20 @@
1
1
  $schema: "https://json-schema.org/draft/2020-12/schema"
2
2
  title: Deliverables Front Matter
3
+ $defs:
4
+ deliverableType:
5
+ type: string
6
+ enum:
7
+ - project # プロジェクトの管理文書
8
+ - requirement # システム機能・非機能要件・受入基準
9
+ - glossary # 用語集
10
+ - flow # 業務フロー・プロセス仕様
11
+ - rule # 業務ルール仕様
12
+ - data # データ仕様
13
+ - ui # 画面・帳票仕様
14
+ - api # API・外部 I/F 仕様
15
+ - architecture # アーキテクチャ設計
16
+ - test # テスト仕様・設計
17
+ - operations # 運用設計・手順
3
18
  # SpecDojo が所有する frontmatter は `specdojo:` 名前空間配下に置く。
4
19
  # トップレベルは第三者ツール(VitePress 等)のキーを許容するため制限しない。
5
20
  type: object
@@ -16,22 +31,12 @@ properties:
16
31
  - rulebook
17
32
  properties:
18
33
  type:
19
- type: string
20
- enum:
21
- # SpecDojo基盤文書(専用スキーマを持たないもの)
22
- - template # 文書テンプレート(雛形)
23
- - sample # 記述例
24
- # プロジェクト文書
25
- - project # プロジェクト文書全般
26
- # プロダクト仕様文書
27
- - flow # 業務フロー・プロセス仕様
28
- - rule # 業務ルール仕様
29
- - data # データ仕様
30
- - ui # 画面・帳票仕様
31
- - api # API・外部I/F仕様
32
- - architecture # アーキテクチャ設計
33
- - test # テスト仕様・設計
34
- - operations # 運用設計・手順
34
+ anyOf:
35
+ - $ref: "#/$defs/deliverableType"
36
+ - type: string
37
+ enum:
38
+ - template # テンプレート自身のメタ情報
39
+ - sample # 非推奨。rulebook を持つ sample は宣言された成果物 type に移行する。
35
40
  description: "仕様の種別(rulebook/guide/standard は各専用スキーマを使用)"
36
41
  rulebook:
37
42
  $ref: "./common-frontmatter.schema.yaml#/$defs/rulebookRef"
@@ -60,6 +65,9 @@ properties:
60
65
  item_type:
61
66
  $ref: "./register-item-frontmatter.schema.yaml#/$defs/ItemType"
62
67
  description: "プロジェクト登録項目の種別。pjr-*-template で使用する。"
68
+ track:
69
+ $ref: "./register-item-frontmatter.schema.yaml#/$defs/Track"
70
+ description: "epic が担う track。定義の検証は register コマンドが行う。"
63
71
  item_status:
64
72
  $ref: "./register-item-frontmatter.schema.yaml#/$defs/ItemStatus"
65
73
  description: "登録項目の処理状態。文書成熟度の status とは別の状態軸。"
@@ -48,10 +48,13 @@ $defs:
48
48
  type: string
49
49
  enum:
50
50
  [
51
+ "draft",
51
52
  "fully-guided",
52
53
  "recipe-guided",
53
54
  "freeform",
54
55
  "bootstrap",
56
+ "catalog-planning",
57
+ "strategy-planning",
55
58
  "rulebook-authoring",
56
59
  "recipe-authoring",
57
60
  "sample-authoring",
@@ -66,7 +69,8 @@ $defs:
66
69
  "bootstrap-finalize",
67
70
  ]
68
71
  description: >
69
- How the task is carried out. fully-guided/recipe-guided/freeform describe how strictly
72
+ How the task is carried out. catalog-planning and strategy-planning create a catalog
73
+ or schedule strategy from register-only domain:<id> / track:<id> targets. draft researches and drafts within delegated context; fully-guided refines existing deliverables using declared references. fully-guided/recipe-guided/freeform describe how strictly
70
74
  the agent follows reference materials (rulebook/recipe/sample/template) when working on
71
75
  a deliverable. bootstrap authors the deliverable and its full reference set
72
76
  (rulebook/recipe/sample/template) together in one task as a mutually consistent whole;
@@ -108,6 +108,7 @@ $defs:
108
108
  lint-ts,
109
109
  lint-fm,
110
110
  lint-md,
111
+ lint-mermaid,
111
112
  build,
112
113
  format-check,
113
114
  ]
@@ -110,7 +110,7 @@ properties:
110
110
  minLength: 1
111
111
  minItems: 1
112
112
  description: >
113
- Doc ids of the documents this task targets. Existing documents are resolvable via the
113
+ Document IDs, or domain:<id> / track:<id> for register planning approaches. Existing documents are resolvable via the
114
114
  doc index. For deliverable work, the first entry is the target deliverable and subsequent
115
115
  entries are reference materials the approach may modify or confirm. For *-authoring
116
116
  register tasks, the entry is an intentionally not-yet-existing kata id; read-only
@@ -4,10 +4,18 @@ type: object
4
4
  additionalProperties: false
5
5
  required:
6
6
  - id
7
+ - type
8
+ - rulebook
7
9
  - title
8
10
  - locale
9
11
  - terms
10
12
  properties:
13
+ type:
14
+ type: string
15
+ const: glossary
16
+ rulebook:
17
+ type: string
18
+ pattern: "^((?:[a-z][a-z0-9-]*:)?[a-z0-9][a-z0-9-]*-rulebook|none)$"
11
19
  id:
12
20
  type: string
13
21
  pattern: "^([a-z0-9-]+:)?gl-[a-z0-9-]+$"
@@ -26,7 +26,7 @@ properties:
26
26
  minLength: 1
27
27
  type:
28
28
  type: string
29
- enum: ["command", "template"]
29
+ enum: ["api", "template"]
30
30
  status:
31
31
  type: string
32
32
  enum: ["draft", "ready", "deprecated"]
@@ -46,6 +46,10 @@ properties:
46
46
  metadata_template:
47
47
  type: object
48
48
  additionalProperties: true
49
+ properties:
50
+ type:
51
+ type: string
52
+ const: api
49
53
 
50
54
  command:
51
55
  type: object
@@ -81,8 +81,9 @@ $defs:
81
81
  required: [status, commit, merged_at]
82
82
  properties:
83
83
  status:
84
+ # branch-only is successful handling without a merge; commit and merged_at stay null.
84
85
  type: string
85
- enum: [pending, merged, unchanged, failed]
86
+ enum: [pending, merged, unchanged, branch-only, failed]
86
87
  # Merge commit on the integration target. Null for the project repository (the merge commit
87
88
  # contains this state) and for repositories that are not merged.
88
89
  commit:
@@ -33,6 +33,22 @@ $defs:
33
33
  - migrate
34
34
 
35
35
  RegisterEventChange:
36
+ allOf:
37
+ - if:
38
+ required: [field]
39
+ properties:
40
+ field:
41
+ const: type
42
+ then:
43
+ properties:
44
+ from:
45
+ anyOf:
46
+ - $ref: "./register-item-frontmatter.schema.yaml#/$defs/ItemType"
47
+ - enum: ["", "-", "_TODO_"]
48
+ to:
49
+ anyOf:
50
+ - $ref: "./register-item-frontmatter.schema.yaml#/$defs/ItemType"
51
+ - enum: ["", "-", "_TODO_"]
36
52
  type: object
37
53
  additionalProperties: false
38
54
  required:
@@ -47,7 +63,9 @@ $defs:
47
63
  - status
48
64
  - title
49
65
  - description
66
+ - input
50
67
  - type
68
+ - track
51
69
  - priority
52
70
  - difficulty
53
71
  - owner
@@ -62,7 +80,10 @@ $defs:
62
80
  - target_path
63
81
  - target_rulebook
64
82
  - derived_from
83
+ - depends_on
65
84
  - autopilot
85
+ - commit_type
86
+ - commit_scope
66
87
  from:
67
88
  type: string
68
89
  to:
@@ -99,6 +99,7 @@ properties:
99
99
  approach:
100
100
  enum:
101
101
  [
102
+ draft,
102
103
  fully-guided,
103
104
  recipe-guided,
104
105
  freeform,
@@ -107,6 +108,18 @@ properties:
107
108
  finalize,
108
109
  bootstrap-finalize,
109
110
  ]
111
+ - if:
112
+ required: [item_type]
113
+ properties:
114
+ item_type:
115
+ const: epic
116
+ then:
117
+ required: [track]
118
+ properties:
119
+ track: true
120
+ else:
121
+ properties:
122
+ track: false
110
123
  - type: object
111
124
  required:
112
125
  - rulebook
@@ -150,6 +163,10 @@ properties:
150
163
  $ref: "#/$defs/ItemType"
151
164
  description: "Classification of the register item (list column: 分類)."
152
165
 
166
+ track:
167
+ $ref: "#/$defs/Track"
168
+ description: "Track governed by this epic; checked against tml-index.yaml when present."
169
+
153
170
  item_status:
154
171
  $ref: "#/$defs/ItemStatus"
155
172
  description: "Processing status of the item (list column: ステータス)."
@@ -226,6 +243,19 @@ properties:
226
243
  same project and <project-id>:PJR-XXXX for an item in another project. Omit the key
227
244
  when the item was not derived from another register item.
228
245
 
246
+ depends_on:
247
+ type: array
248
+ items:
249
+ oneOf:
250
+ - $ref: "#/$defs/LocalRegisterItemRef"
251
+ - $ref: "#/$defs/QualifiedRegisterItemRef"
252
+ minItems: 1
253
+ uniqueItems: true
254
+ description: >
255
+ Predecessor register item IDs. Execution requires every predecessor to be done or
256
+ decided; rejected and deferred do not satisfy a dependency. References use the
257
+ same local or project-qualified syntax as derived_from. Cycles are forbidden.
258
+
229
259
  autopilot:
230
260
  type: string
231
261
  const: approved
@@ -233,12 +263,25 @@ properties:
233
263
  Human approval that the item's stated completion conditions may be executed by the
234
264
  night orchestrator. Omit the key to keep the item out of the approved queue.
235
265
 
266
+ commit_type:
267
+ $ref: "#/$defs/CommitType"
268
+ description: >
269
+ Conventional Commits type for commits generated from this item.
270
+ Omit the key to derive it from item_type and configuration.
271
+
272
+ commit_scope:
273
+ $ref: "#/$defs/CommitScope"
274
+ description: >
275
+ Conventional Commits scope for commits generated from this item.
276
+ Omit the key when no scope applies.
277
+
236
278
  approach:
237
279
  $ref: "#/$defs/Approach"
238
280
  description: >
239
281
  Execution approach. Authoring approaches use the target as the new kata id and
240
282
  sources as read-only exemplars. For compatibility, additional targets are also
241
- accepted as exemplar sources. Other approaches require one compatible document id.
283
+ accepted as exemplar sources. Planning approaches require one domain:<id> or track:<id>
284
+ target. Other approaches require one compatible document id.
242
285
 
243
286
  targets:
244
287
  type: array
@@ -247,7 +290,7 @@ properties:
247
290
  minLength: 1
248
291
  minItems: 1
249
292
  description: >
250
- Doc ids of documents this register item targets. Deliverable targets
293
+ Document IDs or planning units (domain:<id> for catalog-planning, track:<id> for strategy-planning). Deliverable targets
251
294
  used with an approach prefer the project catalog; target_path and target_rulebook or existing frontmatter allow catalog-less resolution so that
252
295
  not-yet-created deliverables can be selected; kata and standalone
253
296
  targets are resolved via the doc index. When present, exec plan
@@ -279,10 +322,15 @@ properties:
279
322
  key when the authoring task has no exemplar.
280
323
 
281
324
  $defs:
325
+ Track:
326
+ type: string
327
+ pattern: "^[a-z0-9][a-z0-9-]*$"
328
+
282
329
  ItemType:
283
330
  type: string
284
331
  enum:
285
332
  - todo
333
+ - epic
286
334
  - question
287
335
  - risk
288
336
  - issue
@@ -333,10 +381,13 @@ $defs:
333
381
  Approach:
334
382
  type: string
335
383
  enum:
384
+ - draft
336
385
  - fully-guided
337
386
  - recipe-guided
338
387
  - freeform
339
388
  - bootstrap
389
+ - catalog-planning
390
+ - strategy-planning
340
391
  - rulebook-authoring
341
392
  - recipe-authoring
342
393
  - sample-authoring
@@ -349,7 +400,7 @@ $defs:
349
400
  - template-maintenance
350
401
  - finalize
351
402
  - bootstrap-finalize
352
- description: "Execution approach shared with src/shared/agent-types.ts."
403
+ description: "Execution approach shared with src/shared/agent-types.ts. catalog-planning and strategy-planning are register-only."
353
404
 
354
405
  Date:
355
406
  type: string
@@ -376,3 +427,24 @@ $defs:
376
427
  type: string
377
428
  pattern: "^[a-z][a-z0-9-]*:PJR-[0-9ABCDEFGHJKMNPQRSTVWXYZ]{4}$"
378
429
  description: "Project-qualified display id of a register item in another project."
430
+
431
+ CommitType:
432
+ type: string
433
+ enum:
434
+ - feat
435
+ - fix
436
+ - docs
437
+ - refactor
438
+ - test
439
+ - chore
440
+ - perf
441
+ - build
442
+ - ci
443
+ - style
444
+ - revert
445
+ description: "Conventional Commits type."
446
+
447
+ CommitScope:
448
+ type: string
449
+ pattern: "^[a-z0-9][a-z0-9-]*$"
450
+ description: "Conventional Commits scope."
@@ -11,11 +11,16 @@ properties:
11
11
  allOf:
12
12
  - $ref: "./common-frontmatter.schema.yaml"
13
13
  - type: object
14
+ required:
15
+ - deliverable_type
14
16
  properties:
15
17
  type:
16
18
  type: string
17
19
  const: rulebook
18
20
  description: "ドキュメント種別(rulebook 固定)"
21
+ deliverable_type:
22
+ $ref: "./deliverable-frontmatter.schema.yaml#/$defs/deliverableType"
23
+ description: "扱う成果物の type。Markdown 成果物・sample・生成物 Frontmatter 雛形との照合の正本。"
19
24
  target_format:
20
25
  type: string
21
26
  enum:
@@ -123,6 +123,7 @@ properties:
123
123
  type: string
124
124
  enum:
125
125
  - author-deliverable
126
+ - draft-with-context
126
127
  - bootstrap-kata-set
127
128
  - reflect-implementation
128
129
  - deduplicate-across-deliverables
@@ -50,6 +50,7 @@ $defs:
50
50
  lint-ts,
51
51
  lint-fm,
52
52
  lint-md,
53
+ lint-mermaid,
53
54
  build,
54
55
  format-check,
55
56
  ]
@@ -99,6 +100,10 @@ $defs:
99
100
  type: array
100
101
  items:
101
102
  $ref: "#/$defs/NonEmptyString"
103
+ commit_types:
104
+ description: >-
105
+ Mapping from register item types to Conventional Commits types for this project.
106
+ $ref: "#/$defs/CommitTypeMap"
102
107
  repos:
103
108
  description: >-
104
109
  Product repositories that tasks of this project may change. The project repository is
@@ -148,6 +153,20 @@ $defs:
148
153
  integration_branch:
149
154
  description: Branch exec integrates into. Omit to use the repository's current branch.
150
155
  $ref: "#/$defs/NonEmptyString"
156
+ branch_template:
157
+ description: Product work branch template; must contain id or topic. Expanded values must be valid Git branch names.
158
+ type: string
159
+ default: "exec/{project}-{id}"
160
+ allOf:
161
+ - pattern: '\{(?:id|topic)\}'
162
+ - pattern: '^(?:[^{}\u0000]|\{(?:id|project|topic|type|scope|title)\})*$'
163
+ - not:
164
+ pattern: '[\s\u0000-\u001f\u007f~^:?*\[\\]|\.\.|@\{|^[-/]|/$|//|\.$|(^|/)\.|\.lock(/|$)'
165
+ integration_strategy:
166
+ description: Local merge commit (default), fast-forward only, or retain the branch for product-side PR review.
167
+ type: string
168
+ enum: [merge, branch-only, ff]
169
+ default: merge
151
170
  setup:
152
171
  description: Whether exec installs dependencies and builds in the repository worktree.
153
172
  type: object
@@ -157,6 +176,23 @@ $defs:
157
176
  type: boolean
158
177
  build:
159
178
  type: boolean
179
+ commit_types:
180
+ description: >-
181
+ Mapping from register item types to Conventional Commits types for this repository.
182
+ $ref: "#/$defs/CommitTypeMap"
183
+ commit_subject_template:
184
+ description: >-
185
+ Product commit subject. Omit to retain exec(register <ID>): <title>.
186
+ $ref: "#/$defs/CommitMessageTemplate"
187
+ merge_message_template:
188
+ description: >-
189
+ Product merge message. Omit to retain exec(register <ID>): <title>. Refs is always appended.
190
+ $ref: "#/$defs/CommitMessageTemplate"
191
+ CommitMessageTemplate:
192
+ type: string
193
+ allOf:
194
+ - pattern: '\S'
195
+ - pattern: '^(?:[^{}\u0000]|\{(?:id|project|topic|type|scope|title|branch|target)\})*$'
160
196
  Run:
161
197
  type: object
162
198
  properties:
@@ -190,3 +226,10 @@ $defs:
190
226
  type: string
191
227
  register_date_timezone:
192
228
  type: string
229
+ CommitTypeMap:
230
+ type: object
231
+ description: >-
232
+ Mapping from register item type (e.g., todo, issue) to Conventional Commits type (e.g., feat, fix).
233
+ additionalProperties:
234
+ type: string
235
+ enum: [feat, fix, docs, refactor, test, chore, perf, build, ci, style, revert]
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "specdojo",
3
- "version": "0.4.7",
3
+ "version": "0.6.0",
4
4
  "description": "A dojo for Spec-Dō, the way of specification: decide with a register, write specs and designs with kata, and keep sharpening them with AI.",
5
5
  "license": "MIT",
6
6
  "author": "naoji3x",
@@ -90,9 +90,10 @@
90
90
  "docs:generate": "node --import tsx src/specdojo.ts build",
91
91
  "docs:dev": "npm run docs:generate && npm --prefix packages/docs-site run docs:dev",
92
92
  "docs:build:mermaid": "npm --prefix packages/docs-site run docs:build:mermaid",
93
- "docs:rebuild:mermaid": "rm -f public/mermaid/*.svg && npm run docs:build:mermaid",
93
+ "docs:rebuild:mermaid": "rm -f .vitepress/mermaid/*.svg && npm run docs:build:mermaid",
94
94
  "docs:build": "npm run docs:generate && npm --prefix packages/docs-site run docs:build",
95
95
  "lint:fm": "node packages/docs-lint/bin/specdojo-docs-lint.js remark \"docs/**/*.{md,mdx}\" --quiet --frail",
96
+ "lint:mermaid": "node tools/lint-mermaid.mjs",
96
97
  "validate:schema:job-run": "node packages/docs-lint/bin/specdojo-docs-lint.js yaml-schema --schema docs/specdojo/schemas/v1/job-run.schema.yaml --data \"docs/ja/**/execution/jobs/runs/*.json\" --allow-empty",
97
98
  "validate:schema:grade-pipeline": "node packages/docs-lint/bin/specdojo-docs-lint.js yaml-schema --schema docs/specdojo/schemas/v1/grade-pipeline-state.schema.yaml --data \"docs/ja/**/execution/grade/pipeline/*.json\" --allow-empty",
98
99
  "validate:schema:file": "node packages/docs-lint/bin/specdojo-docs-lint.js yaml-schema",
@@ -101,7 +102,7 @@
101
102
  "validate:schema:glossary": "node packages/docs-lint/bin/specdojo-docs-lint.js glossary-references",
102
103
  "validate:catalog": "tsx src/specdojo.ts catalog validate",
103
104
  "validate:history-links": "node packages/docs-lint/bin/specdojo-docs-lint.js history-links",
104
- "check": "npm run typecheck && npm run lint:ts && npm run check:src-imports && npm run lint:md && npm run lint:fm && npm run validate:schema && npm run validate:catalog && npm run validate:history-links && npm test",
105
+ "check": "npm run typecheck && npm run lint:ts && npm run check:src-imports && npm run lint:md && npm run lint:fm && npm run lint:mermaid && npm run validate:schema && npm run validate:catalog && npm run validate:history-links && npm test",
105
106
  "check:src-imports": "node tools/check-src-imports-in-dependencies.mjs",
106
107
  "dc:ps": "docker ps --format \"table {{.Names}}\\t{{.Image}}\\t{{.Status}}\"",
107
108
  "dc:name": "bash -lc 'docker ps --format \"{{.Names}}\\t{{.Image}}\" | awk \"\\$2 ~ /^vsc-specdojo/ {print \\$1; exit}\"'",
@@ -85,18 +85,21 @@ catalog へ進む段階になったら、`.specdojo/specdojo.config.json` へ `c
85
85
 
86
86
  type は次のように使い分ける。
87
87
 
88
- | type | 用途 | 終端状態 |
89
- | ---------------- | ------------------------------ | --------- |
90
- | `issue` | 解決すべき問題。原因調査を伴う | `done` |
91
- | `decision` | 選択肢から方針を決める | `decided` |
92
- | `todo` | 実施する作業 | `done` |
93
- | `question` | 判断を保留し、後で決める | `decided` |
94
- | `risk` | 将来の不確実性 | `done` |
95
- | `change-request` | 合意済み範囲の変更要求 | `done` |
96
- | `note` | 記録として残す観測・分析 | なし |
88
+ | type | 用途 | 終端状態 |
89
+ | ---------------- | ---------------------------------- | --------- |
90
+ | `issue` | 解決すべき問題。原因調査を伴う | `done` |
91
+ | `decision` | 選択肢から方針を決める | `decided` |
92
+ | `todo` | 実施する作業 | `done` |
93
+ | `question` | 判断を保留し、後で決める | `decided` |
94
+ | `risk` | 将来の不確実性 | `done` |
95
+ | `change-request` | 合意済み範囲の変更要求 | `done` |
96
+ | `note` | 記録として残す観測・分析 | なし |
97
+ | `epic` | track ごとの仕事の着手と完了の管理 | `done` |
97
98
 
98
99
  起票では `--title` と `--description` を具体的に書く。`--description` は一覧へ出るため、後から見て内容が分かる文にする。`--topic` を省くとタイトルの英数字の部分から導出される。タイトルが日本語の場合は、内容を表す英語の `--topic`(小文字・ハイフン区切り。例: `payment-scope`)を渡す。
99
100
 
101
+ 対話で得た前提・制約・調査や選定を任せる範囲は、起票時に `--input <text>` を繰り返して個票の `入力` へ記録する。完了条件とは分け、会話で確認できた事実と明示的な委任範囲だけを書く。更新時の `--input` は一覧置換なので、追記では既存分も含めて渡し、全削除は `--input -` とする。
102
+
100
103
  ```bash
101
104
  npx specdojo register add --project <project-id> \
102
105
  --type todo --title "<title>" --description "<description>" \
@@ -123,6 +126,10 @@ npx specdojo register close --project <project-id> --id <PJR-XXXX> \
123
126
 
124
127
  `decision` と `question` は `--status decided` を付ける。close の前に個票の `決定内容` / `承認` を埋める。
125
128
 
129
+ `epic` は `--track <track>` で担う track を指定して起票し、具体的な作業は `--from <epic-id>` を付けた子 todo に分解する。epic 自体は `exec run --register` で実行せず、夜間の実行でも飛ばされる。子項目の状態は `register build` が生成する epic ごとのビューで確かめ、子項目と schedule を材料に人が close を判断する。
130
+
131
+ 順番のある項目は `--depends-on <PJR-XXXX>`(繰り返し指定できる)で先に終わっているべき項目を記録する。起票の由来を表す `--from`(`derived_from`)とは別の意味で、どちらかで他方を兼ねない。先行の項目がすべて `done` / `decided` になるまで、`exec run --register` は止まり、夜間の実行では飛ばされる。状態は自動では `waiting` にならない。外すときは `--depends-on -` を指定する。後続の項目は一覧の `depends_on` 列と `generated/pjr-dependent-items.md` で確かめる。
132
+
126
133
  `note` は終端させず、`open` のまま新しい事実・知見を追記する。close / reject / defer の対象にしない。対応や判断が必要になった場合は、目的に合う別の type で起票し、note は参照元として残す(`pjr-rulebook` の type 別の扱い)。
127
134
 
128
135
  ## 実践の型(kata)の扱い
@@ -92,18 +92,21 @@ catalog へ進む段階になったら、`.specdojo/specdojo.config.json` へ `c
92
92
 
93
93
  type は次のように使い分ける。
94
94
 
95
- | type | 用途 | 終端状態 |
96
- | ---------------- | ------------------------------ | --------- |
97
- | `issue` | 解決すべき問題。原因調査を伴う | `done` |
98
- | `decision` | 選択肢から方針を決める | `decided` |
99
- | `todo` | 実施する作業 | `done` |
100
- | `question` | 判断を保留し、後で決める | `decided` |
101
- | `risk` | 将来の不確実性 | `done` |
102
- | `change-request` | 合意済み範囲の変更要求 | `done` |
103
- | `note` | 記録として残す観測・分析 | なし |
95
+ | type | 用途 | 終端状態 |
96
+ | ---------------- | ---------------------------------- | --------- |
97
+ | `issue` | 解決すべき問題。原因調査を伴う | `done` |
98
+ | `decision` | 選択肢から方針を決める | `decided` |
99
+ | `todo` | 実施する作業 | `done` |
100
+ | `question` | 判断を保留し、後で決める | `decided` |
101
+ | `risk` | 将来の不確実性 | `done` |
102
+ | `change-request` | 合意済み範囲の変更要求 | `done` |
103
+ | `note` | 記録として残す観測・分析 | なし |
104
+ | `epic` | track ごとの仕事の着手と完了の管理 | `done` |
104
105
 
105
106
  起票では `--title` と `--description` を具体的に書く。`--description` は一覧へ出るため、後から見て内容が分かる文にする。`--topic` を省くとタイトルの英数字の部分から導出される。タイトルが日本語の場合は、内容を表す英語の `--topic`(小文字・ハイフン区切り。例: `payment-scope`)を渡す。
106
107
 
108
+ 対話で得た前提・制約・調査や選定を任せる範囲は、起票時に `--input <text>` を繰り返して個票の `入力` へ記録する。完了条件とは分け、会話で確認できた事実と明示的な委任範囲だけを書く。更新時の `--input` は一覧置換なので、追記では既存分も含めて渡し、全削除は `--input -` とする。
109
+
107
110
  ```bash
108
111
  npx specdojo register add --project <project-id> \
109
112
  --type todo --title "<title>" --description "<description>" \
@@ -130,6 +133,10 @@ npx specdojo register close --project <project-id> --id <PJR-XXXX> \
130
133
 
131
134
  `decision` と `question` は `--status decided` を付ける。close の前に個票の `決定内容` / `承認` を埋める。
132
135
 
136
+ `epic` は `--track <track>` で担う track を指定して起票し、具体的な作業は `--from <epic-id>` を付けた子 todo に分解する。epic 自体は `exec run --register` で実行せず、夜間の実行でも飛ばされる。子項目の状態は `register build` が生成する epic ごとのビューで確かめ、子項目と schedule を材料に人が close を判断する。
137
+
138
+ 順番のある項目は `--depends-on <PJR-XXXX>`(繰り返し指定できる)で先に終わっているべき項目を記録する。起票の由来を表す `--from`(`derived_from`)とは別の意味で、どちらかで他方を兼ねない。先行の項目がすべて `done` / `decided` になるまで、`exec run --register` は止まり、夜間の実行では飛ばされる。状態は自動では `waiting` にならない。外すときは `--depends-on -` を指定する。後続の項目は一覧の `depends_on` 列と `generated/pjr-dependent-items.md` で確かめる。
139
+
133
140
  `note` は終端させず、`open` のまま新しい事実・知見を追記する。close / reject / defer の対象にしない。対応や判断が必要になった場合は、目的に合う別の type で起票し、note は参照元として残す(`pjr-rulebook` の type 別の扱い)。
134
141
 
135
142
  ## 実践の型(kata)の扱い
@@ -92,18 +92,21 @@ catalog へ進む段階になったら、`.specdojo/specdojo.config.json` へ `c
92
92
 
93
93
  type は次のように使い分ける。
94
94
 
95
- | type | 用途 | 終端状態 |
96
- | ---------------- | ------------------------------ | --------- |
97
- | `issue` | 解決すべき問題。原因調査を伴う | `done` |
98
- | `decision` | 選択肢から方針を決める | `decided` |
99
- | `todo` | 実施する作業 | `done` |
100
- | `question` | 判断を保留し、後で決める | `decided` |
101
- | `risk` | 将来の不確実性 | `done` |
102
- | `change-request` | 合意済み範囲の変更要求 | `done` |
103
- | `note` | 記録として残す観測・分析 | なし |
95
+ | type | 用途 | 終端状態 |
96
+ | ---------------- | ---------------------------------- | --------- |
97
+ | `issue` | 解決すべき問題。原因調査を伴う | `done` |
98
+ | `decision` | 選択肢から方針を決める | `decided` |
99
+ | `todo` | 実施する作業 | `done` |
100
+ | `question` | 判断を保留し、後で決める | `decided` |
101
+ | `risk` | 将来の不確実性 | `done` |
102
+ | `change-request` | 合意済み範囲の変更要求 | `done` |
103
+ | `note` | 記録として残す観測・分析 | なし |
104
+ | `epic` | track ごとの仕事の着手と完了の管理 | `done` |
104
105
 
105
106
  起票では `--title` と `--description` を具体的に書く。`--description` は一覧へ出るため、後から見て内容が分かる文にする。`--topic` を省くとタイトルの英数字の部分から導出される。タイトルが日本語の場合は、内容を表す英語の `--topic`(小文字・ハイフン区切り。例: `payment-scope`)を渡す。
106
107
 
108
+ 対話で得た前提・制約・調査や選定を任せる範囲は、起票時に `--input <text>` を繰り返して個票の `入力` へ記録する。完了条件とは分け、会話で確認できた事実と明示的な委任範囲だけを書く。更新時の `--input` は一覧置換なので、追記では既存分も含めて渡し、全削除は `--input -` とする。
109
+
107
110
  ```bash
108
111
  npx specdojo register add --project <project-id> \
109
112
  --type todo --title "<title>" --description "<description>" \
@@ -130,6 +133,10 @@ npx specdojo register close --project <project-id> --id <PJR-XXXX> \
130
133
 
131
134
  `decision` と `question` は `--status decided` を付ける。close の前に個票の `決定内容` / `承認` を埋める。
132
135
 
136
+ `epic` は `--track <track>` で担う track を指定して起票し、具体的な作業は `--from <epic-id>` を付けた子 todo に分解する。epic 自体は `exec run --register` で実行せず、夜間の実行でも飛ばされる。子項目の状態は `register build` が生成する epic ごとのビューで確かめ、子項目と schedule を材料に人が close を判断する。
137
+
138
+ 順番のある項目は `--depends-on <PJR-XXXX>`(繰り返し指定できる)で先に終わっているべき項目を記録する。起票の由来を表す `--from`(`derived_from`)とは別の意味で、どちらかで他方を兼ねない。先行の項目がすべて `done` / `decided` になるまで、`exec run --register` は止まり、夜間の実行では飛ばされる。状態は自動では `waiting` にならない。外すときは `--depends-on -` を指定する。後続の項目は一覧の `depends_on` 列と `generated/pjr-dependent-items.md` で確かめる。
139
+
133
140
  `note` は終端させず、`open` のまま新しい事実・知見を追記する。close / reject / defer の対象にしない。対応や判断が必要になった場合は、目的に合う別の type で起票し、note は参照元として残す(`pjr-rulebook` の type 別の扱い)。
134
141
 
135
142
  ## 実践の型(kata)の扱い