specdojo 0.1.0 → 0.2.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 (531) hide show
  1. package/LICENSE +22 -0
  2. package/README.md +82 -38
  3. package/dist/agent-response.js +27 -0
  4. package/dist/agent.js +124 -0
  5. package/dist/build-command.js +149 -0
  6. package/dist/build-if-stale.js +35 -0
  7. package/dist/catalog-build.js +1079 -0
  8. package/dist/catalog-generate.js +226 -0
  9. package/dist/catalog-paths.js +31 -0
  10. package/dist/catalog-plan-generate.js +301 -0
  11. package/dist/catalog-plan-prompt.js +73 -0
  12. package/dist/catalog-plan.js +471 -0
  13. package/dist/catalog-scaffold.js +255 -0
  14. package/dist/catalog-types.js +4 -0
  15. package/dist/catalog.js +606 -0
  16. package/dist/dashboard.js +980 -0
  17. package/dist/deliverable-trash.js +148 -0
  18. package/dist/deliverable.js +97 -0
  19. package/dist/dist-freshness.js +150 -0
  20. package/dist/doc-index.js +424 -0
  21. package/dist/exec-agent-config.js +172 -0
  22. package/dist/exec-agent-git-state.js +136 -0
  23. package/dist/exec-agent-protected-config.js +276 -0
  24. package/dist/exec-events.js +250 -112
  25. package/dist/exec-evidence.js +317 -0
  26. package/dist/exec-format.js +45 -0
  27. package/dist/exec-limit.js +202 -0
  28. package/dist/exec-parent-validation.js +169 -0
  29. package/dist/exec-pipeline-state.js +160 -0
  30. package/dist/exec-plans.js +1016 -0
  31. package/dist/exec-project.js +25 -11
  32. package/dist/exec-protection-handoff.js +169 -0
  33. package/dist/exec-provider-scaffold.js +99 -0
  34. package/dist/exec-register-resume.js +196 -0
  35. package/dist/exec-register.js +281 -0
  36. package/dist/exec-reporter.js +329 -0
  37. package/dist/exec-results.js +510 -0
  38. package/dist/exec-run-lock.js +149 -0
  39. package/dist/exec-run.js +4953 -0
  40. package/dist/exec-schedule-calendar.js +86 -9
  41. package/dist/exec-schedule-cpm.js +30 -12
  42. package/dist/exec-schedule-gantt-chart-render.js +428 -0
  43. package/dist/exec-schedule-gantt-chart-scope.js +111 -0
  44. package/dist/exec-schedule-gantt-chart.js +2 -0
  45. package/dist/exec-schedule-hash.js +34 -25
  46. package/dist/exec-schedule-index.js +200 -67
  47. package/dist/exec-schedule-initial.js +100 -0
  48. package/dist/exec-schedule-progress.js +51 -26
  49. package/dist/exec-schedule-ready.js +71 -27
  50. package/dist/exec-schedule.js +171 -93
  51. package/dist/exec-shared.js +146 -25
  52. package/dist/exec-strategy.js +547 -0
  53. package/dist/exec-task-view.js +64 -0
  54. package/dist/exec-trial.js +895 -0
  55. package/dist/exec-worktree-command.js +426 -0
  56. package/dist/exec-worktree-ops.js +847 -0
  57. package/dist/exec-worktree.js +359 -0
  58. package/dist/exec.js +744 -192
  59. package/dist/frontmatter-namespace.js +48 -0
  60. package/dist/git-environment.js +23 -0
  61. package/dist/grade-result.js +137 -0
  62. package/dist/grade.js +2456 -0
  63. package/dist/index-command.js +103 -0
  64. package/dist/job.js +1081 -0
  65. package/dist/kata-command.js +303 -0
  66. package/dist/kata.js +187 -0
  67. package/dist/package-paths.js +15 -0
  68. package/dist/practice-id.js +24 -0
  69. package/dist/register-date.js +122 -0
  70. package/dist/register-events.js +363 -0
  71. package/dist/register-history.js +323 -0
  72. package/dist/register-item.js +455 -0
  73. package/dist/register-migrate-timestamps.js +176 -0
  74. package/dist/register.js +2199 -0
  75. package/dist/review-plan.js +199 -0
  76. package/dist/review-types.js +1 -0
  77. package/dist/role-types.js +1 -0
  78. package/dist/routine.js +814 -0
  79. package/dist/schedule-approach.js +252 -0
  80. package/dist/schedule-build.js +552 -0
  81. package/dist/schedule-phase-sets.js +73 -0
  82. package/dist/schedule-strategy-generate.js +812 -0
  83. package/dist/schedule-strategy-profiles.js +276 -0
  84. package/dist/schedule.js +420 -0
  85. package/dist/spawn-self.js +28 -0
  86. package/dist/specdojo-config.js +133 -39
  87. package/dist/specdojo.js +55 -7
  88. package/dist/template-frontmatter.js +89 -0
  89. package/dist/template-resolution.js +92 -0
  90. package/dist/timeline-build.js +334 -0
  91. package/dist/timeline.js +107 -0
  92. package/dist/watch.js +313 -0
  93. package/dist/yaml-pages-command.js +28 -0
  94. package/dist/yaml-pages.js +180 -0
  95. package/dist/yaml-schema-modeline.js +49 -0
  96. package/docs/ja/specdojo/defaults/pm-review-viewpoints.yaml +600 -0
  97. package/docs/ja/specdojo/exec-templates/xep-bootstrap-template.md +120 -0
  98. package/docs/ja/specdojo/exec-templates/xep-common-conventions-template.md +37 -0
  99. package/docs/ja/specdojo/exec-templates/xep-cross-deliverable-dedup-template.md +51 -0
  100. package/docs/ja/specdojo/exec-templates/xep-freeform-template.md +74 -0
  101. package/docs/ja/specdojo/exec-templates/xep-fully-guided-template.md +109 -0
  102. package/docs/ja/specdojo/exec-templates/xep-job-template.md +43 -0
  103. package/docs/ja/specdojo/exec-templates/xep-recipe-guided-template.md +82 -0
  104. package/docs/ja/specdojo/exec-templates/xep-recipe-maintenance-template.md +86 -0
  105. package/docs/ja/specdojo/exec-templates/xep-register-investigate-template.md +42 -0
  106. package/docs/ja/specdojo/exec-templates/xep-register-template.md +49 -0
  107. package/docs/ja/specdojo/exec-templates/xep-retrofit-template.md +98 -0
  108. package/docs/ja/specdojo/exec-templates/xep-rulebook-maintenance-template.md +86 -0
  109. package/docs/ja/specdojo/exec-templates/xep-sample-maintenance-template.md +86 -0
  110. package/docs/ja/specdojo/exec-templates/xep-template-maintenance-template.md +86 -0
  111. package/docs/ja/specdojo/exec-templates/xep-template.md +66 -0
  112. package/docs/ja/specdojo/exec-templates/xer-cross-deliverable-dedup-template.md +31 -0
  113. package/docs/ja/specdojo/exec-templates/xer-human-bootstrap-finalize-template.md +40 -0
  114. package/docs/ja/specdojo/exec-templates/xer-human-finalize-template.md +30 -0
  115. package/docs/ja/specdojo/exec-templates/xer-template.md +19 -0
  116. package/docs/ja/specdojo/exec-templates/xrp-freeform-template.md +70 -0
  117. package/docs/ja/specdojo/exec-templates/xrp-fully-guided-template.md +97 -0
  118. package/docs/ja/specdojo/exec-templates/xrp-recipe-guided-template.md +76 -0
  119. package/docs/ja/specdojo/exec-templates/xrp-recipe-maintenance-template.md +73 -0
  120. package/docs/ja/specdojo/exec-templates/xrp-retrofit-template.md +74 -0
  121. package/docs/ja/specdojo/exec-templates/xrp-rulebook-maintenance-template.md +74 -0
  122. package/docs/ja/specdojo/exec-templates/xrp-sample-maintenance-template.md +73 -0
  123. package/docs/ja/specdojo/exec-templates/xrp-template-maintenance-template.md +73 -0
  124. package/docs/ja/specdojo/exec-templates/xrp-template.md +67 -0
  125. package/docs/ja/specdojo/exec-templates/xrp-viewpoint-detail-template.md +7 -0
  126. package/docs/ja/specdojo/exec-templates/xrr-template.md +21 -0
  127. package/docs/ja/specdojo/exec-templates/xrr-viewpoint-detail-template.md +7 -0
  128. package/docs/ja/specdojo/guides/branch-workflow-guide.md +354 -0
  129. package/docs/ja/specdojo/guides/docs-editing-guide.md +327 -0
  130. package/docs/ja/specdojo/guides/docs-structure-guide.md +519 -0
  131. package/docs/ja/specdojo/guides/exec-config-guide.md +589 -0
  132. package/docs/ja/specdojo/guides/exec-operation-guide.md +440 -0
  133. package/docs/ja/specdojo/guides/exec-worktree-guide.md +318 -0
  134. package/docs/ja/specdojo/guides/kata-guide.md +89 -0
  135. package/docs/ja/specdojo/guides/orchestrator-operation-guide.md +127 -0
  136. package/docs/ja/specdojo/guides/plan-result-lifecycle-guide.md +228 -0
  137. package/docs/ja/specdojo/guides/practice-system-composition-guide.md +111 -0
  138. package/docs/ja/specdojo/guides/quick-start-guide.md +473 -0
  139. package/docs/ja/specdojo/guides/register-operation-guide.md +418 -0
  140. package/docs/ja/specdojo/guides/review-guide.md +428 -0
  141. package/docs/ja/specdojo/guides/routine-operation-guide.md +282 -0
  142. package/docs/ja/specdojo/guides/ryu-guide.md +230 -0
  143. package/docs/ja/specdojo/guides/schedule-design-guide.md +429 -0
  144. package/docs/ja/specdojo/guides/schedule-operation-guide.md +151 -0
  145. package/docs/ja/specdojo/guides/specdojo-overview-guide.md +257 -0
  146. package/docs/ja/specdojo/guides/timeline-design-guide.md +160 -0
  147. package/docs/ja/specdojo/guides/track-design-guide.md +215 -0
  148. package/docs/ja/specdojo/guides/use-case-guide.md +133 -0
  149. package/docs/ja/specdojo/guides/waza-guide.md +224 -0
  150. package/docs/ja/specdojo/index.md +33 -0
  151. package/docs/ja/specdojo/philosophy/needs-to-implementation-philosophy.md +212 -0
  152. package/docs/ja/specdojo/philosophy/specdojo-philosophy.md +242 -0
  153. package/docs/ja/specdojo/recipes/cdfd-overview-recipe.md +198 -0
  154. package/docs/ja/specdojo/recipes/cdfd-recipe.md +218 -0
  155. package/docs/ja/specdojo/recipes/cdfd-uc-recipe.md +198 -0
  156. package/docs/ja/specdojo/recipes/exec-human-finalize-recipe.md +100 -0
  157. package/docs/ja/specdojo/recipes/ifx-cmd-recipe.md +148 -0
  158. package/docs/ja/specdojo/recipes/pm-communication-plan-recipe.md +97 -0
  159. package/docs/ja/specdojo/recipes/pm-members-recipe.md +149 -0
  160. package/docs/ja/specdojo/recipes/pm-organization-recipe.md +96 -0
  161. package/docs/ja/specdojo/recipes/pm-plan-recipe.md +98 -0
  162. package/docs/ja/specdojo/recipes/pm-quality-management-plan-recipe.md +97 -0
  163. package/docs/ja/specdojo/recipes/pm-raci-recipe.md +96 -0
  164. package/docs/ja/specdojo/recipes/pm-roles-recipe.md +136 -0
  165. package/docs/ja/specdojo/recipes/prj-assumptions-constraints-dependencies-recipe.md +162 -0
  166. package/docs/ja/specdojo/recipes/prj-charter-recipe.md +187 -0
  167. package/docs/ja/specdojo/recipes/prj-comparison-of-alternatives-recipe.md +235 -0
  168. package/docs/ja/specdojo/recipes/prj-issues-and-approach-recipe.md +205 -0
  169. package/docs/ja/specdojo/recipes/prj-overview-recipe.md +289 -0
  170. package/docs/ja/specdojo/recipes/prj-scope-recipe.md +201 -0
  171. package/docs/ja/specdojo/recipes/prj-stakeholder-register-recipe.md +168 -0
  172. package/docs/ja/specdojo/recipes/prj-success-criteria-and-acceptance-criteria-recipe.md +179 -0
  173. package/docs/ja/specdojo/recipes/stsd-recipe.md +138 -0
  174. package/docs/ja/specdojo/references/command-reference.md +718 -0
  175. package/docs/ja/specdojo/references/deliverables-reference.md +407 -0
  176. package/docs/ja/specdojo/references/directory-layout-reference.md +280 -0
  177. package/docs/ja/specdojo/references/specdojo-config-reference.md +133 -0
  178. package/docs/ja/specdojo/rulebooks/atc-index-rulebook.md +372 -0
  179. package/docs/ja/specdojo/rulebooks/atc-rulebook.md +302 -0
  180. package/docs/ja/specdojo/rulebooks/bac-rulebook.md +331 -0
  181. package/docs/ja/specdojo/rulebooks/bdd-rulebook.md +134 -0
  182. package/docs/ja/specdojo/rulebooks/bds-rulebook.md +207 -0
  183. package/docs/ja/specdojo/rulebooks/bes-index-rulebook.md +102 -0
  184. package/docs/ja/specdojo/rulebooks/bes-rulebook.md +131 -0
  185. package/docs/ja/specdojo/rulebooks/bps-rulebook.md +269 -0
  186. package/docs/ja/specdojo/rulebooks/br-rulebook.md +187 -0
  187. package/docs/ja/specdojo/rulebooks/ccd-mermaid-rulebook.md +279 -0
  188. package/docs/ja/specdojo/rulebooks/cdfd-mermaid-rulebook.md +219 -0
  189. package/docs/ja/specdojo/rulebooks/cdfd-overview-rulebook.md +233 -0
  190. package/docs/ja/specdojo/rulebooks/cdfd-rulebook.md +182 -0
  191. package/docs/ja/specdojo/rulebooks/cdfd-uc-rulebook.md +171 -0
  192. package/docs/ja/specdojo/rulebooks/cdsd-rulebook.md +105 -0
  193. package/docs/ja/specdojo/rulebooks/cld-rulebook.md +195 -0
  194. package/docs/ja/specdojo/rulebooks/cnd-mermaid-rulebook.md +285 -0
  195. package/docs/ja/specdojo/rulebooks/cnd-rulebook.md +292 -0
  196. package/docs/ja/specdojo/rulebooks/cop-index-rulebook.md +171 -0
  197. package/docs/ja/specdojo/rulebooks/cop-rulebook.md +325 -0
  198. package/docs/ja/specdojo/rulebooks/cpd-mermaid-rulebook.md +266 -0
  199. package/docs/ja/specdojo/rulebooks/cpd-rulebook.md +294 -0
  200. package/docs/ja/specdojo/rulebooks/cstd-rulebook.md +21 -0
  201. package/docs/ja/specdojo/rulebooks/cxd-mermaid-rulebook.md +401 -0
  202. package/docs/ja/specdojo/rulebooks/cxd-rulebook.md +311 -0
  203. package/docs/ja/specdojo/rulebooks/dct-index-rulebook.md +158 -0
  204. package/docs/ja/specdojo/rulebooks/dct-rulebook.md +287 -0
  205. package/docs/ja/specdojo/rulebooks/dec-rulebook.md +62 -0
  206. package/docs/ja/specdojo/rulebooks/dmd-index-rulebook.md +100 -0
  207. package/docs/ja/specdojo/rulebooks/dmd-rulebook.md +298 -0
  208. package/docs/ja/specdojo/rulebooks/etc-index-rulebook.md +379 -0
  209. package/docs/ja/specdojo/rulebooks/etc-rulebook.md +310 -0
  210. package/docs/ja/specdojo/rulebooks/gl-rulebook.md +86 -0
  211. package/docs/ja/specdojo/rulebooks/ifd-mermaid-rulebook.md +297 -0
  212. package/docs/ja/specdojo/rulebooks/ifx-api-rulebook.md +79 -0
  213. package/docs/ja/specdojo/rulebooks/ifx-cmd-rulebook.md +213 -0
  214. package/docs/ja/specdojo/rulebooks/ifx-file-rulebook.md +311 -0
  215. package/docs/ja/specdojo/rulebooks/ifx-index-rulebook.md +94 -0
  216. package/docs/ja/specdojo/rulebooks/ifx-msg-rulebook.md +81 -0
  217. package/docs/ja/specdojo/rulebooks/imp-business-rulebook.md +117 -0
  218. package/docs/ja/specdojo/rulebooks/imp-data-rulebook.md +118 -0
  219. package/docs/ja/specdojo/rulebooks/imp-interface-rulebook.md +116 -0
  220. package/docs/ja/specdojo/rulebooks/imp-operations-rulebook.md +116 -0
  221. package/docs/ja/specdojo/rulebooks/imp-test-rulebook.md +116 -0
  222. package/docs/ja/specdojo/rulebooks/itc-index-rulebook.md +421 -0
  223. package/docs/ja/specdojo/rulebooks/itc-rulebook.md +307 -0
  224. package/docs/ja/specdojo/rulebooks/mip-index-rulebook.md +312 -0
  225. package/docs/ja/specdojo/rulebooks/mm-rulebook.md +63 -0
  226. package/docs/ja/specdojo/rulebooks/mtp-rulebook.md +353 -0
  227. package/docs/ja/specdojo/rulebooks/nfr-availability-rulebook.md +184 -0
  228. package/docs/ja/specdojo/rulebooks/nfr-index-rulebook.md +179 -0
  229. package/docs/ja/specdojo/rulebooks/nfr-integrity-rulebook.md +184 -0
  230. package/docs/ja/specdojo/rulebooks/nfr-maintainability-rulebook.md +183 -0
  231. package/docs/ja/specdojo/rulebooks/nfr-operations-rulebook.md +185 -0
  232. package/docs/ja/specdojo/rulebooks/nfr-performance-rulebook.md +185 -0
  233. package/docs/ja/specdojo/rulebooks/nfr-reliability-rulebook.md +186 -0
  234. package/docs/ja/specdojo/rulebooks/nfr-security-safety-rulebook.md +186 -0
  235. package/docs/ja/specdojo/rulebooks/nfr-usability-rulebook.md +184 -0
  236. package/docs/ja/specdojo/rulebooks/ntp-rulebook.md +61 -0
  237. package/docs/ja/specdojo/rulebooks/opd-index-rulebook.md +84 -0
  238. package/docs/ja/specdojo/rulebooks/opd-rulebook.md +357 -0
  239. package/docs/ja/specdojo/rulebooks/opr-index-rulebook.md +80 -0
  240. package/docs/ja/specdojo/rulebooks/opr-rulebook.md +484 -0
  241. package/docs/ja/specdojo/rulebooks/otp-index-rulebook.md +120 -0
  242. package/docs/ja/specdojo/rulebooks/otp-rulebook.md +293 -0
  243. package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +211 -0
  244. package/docs/ja/specdojo/rulebooks/pm-change-request-log-rulebook.md +94 -0
  245. package/docs/ja/specdojo/rulebooks/pm-communication-plan-rulebook.md +116 -0
  246. package/docs/ja/specdojo/rulebooks/pm-issue-log-rulebook.md +93 -0
  247. package/docs/ja/specdojo/rulebooks/pm-members-rulebook.md +190 -0
  248. package/docs/ja/specdojo/rulebooks/pm-organization-rulebook.md +108 -0
  249. package/docs/ja/specdojo/rulebooks/pm-plan-rulebook.md +122 -0
  250. package/docs/ja/specdojo/rulebooks/pm-quality-management-plan-rulebook.md +117 -0
  251. package/docs/ja/specdojo/rulebooks/pm-raci-rulebook.md +116 -0
  252. package/docs/ja/specdojo/rulebooks/pm-risk-register-rulebook.md +93 -0
  253. package/docs/ja/specdojo/rulebooks/pm-roles-rulebook.md +146 -0
  254. package/docs/ja/specdojo/rulebooks/pr-rulebook.md +65 -0
  255. package/docs/ja/specdojo/rulebooks/prj-assumptions-constraints-dependencies-rulebook.md +178 -0
  256. package/docs/ja/specdojo/rulebooks/prj-charter-rulebook.md +232 -0
  257. package/docs/ja/specdojo/rulebooks/prj-comparison-of-alternatives-rulebook.md +235 -0
  258. package/docs/ja/specdojo/rulebooks/prj-issues-and-approach-rulebook.md +242 -0
  259. package/docs/ja/specdojo/rulebooks/prj-overview-rulebook.md +187 -0
  260. package/docs/ja/specdojo/rulebooks/prj-scope-rulebook.md +201 -0
  261. package/docs/ja/specdojo/rulebooks/prj-stakeholder-register-rulebook.md +165 -0
  262. package/docs/ja/specdojo/rulebooks/prj-success-criteria-and-acceptance-criteria-rulebook.md +165 -0
  263. package/docs/ja/specdojo/rulebooks/sac-rulebook.md +202 -0
  264. package/docs/ja/specdojo/rulebooks/sch-rulebook.md +139 -0
  265. package/docs/ja/specdojo/rulebooks/sf-index-rulebook.md +63 -0
  266. package/docs/ja/specdojo/rulebooks/sf-rulebook.md +93 -0
  267. package/docs/ja/specdojo/rulebooks/sld-rulebook.md +93 -0
  268. package/docs/ja/specdojo/rulebooks/stc-index-rulebook.md +329 -0
  269. package/docs/ja/specdojo/rulebooks/stc-rulebook.md +297 -0
  270. package/docs/ja/specdojo/rulebooks/stsd-mermaid-rulebook.md +132 -0
  271. package/docs/ja/specdojo/rulebooks/stsd-rulebook.md +215 -0
  272. package/docs/ja/specdojo/rulebooks/sysd-critical-flows-rulebook.md +376 -0
  273. package/docs/ja/specdojo/rulebooks/sysd-cross-cutting-policy-rulebook.md +313 -0
  274. package/docs/ja/specdojo/rulebooks/sysd-index-rulebook.md +246 -0
  275. package/docs/ja/specdojo/rulebooks/sysd-rulebook.md +119 -0
  276. package/docs/ja/specdojo/rulebooks/tml-rulebook.md +188 -0
  277. package/docs/ja/specdojo/rulebooks/trc-requirements-to-specs-rulebook.md +114 -0
  278. package/docs/ja/specdojo/rulebooks/trc-requirements-to-tests-rulebook.md +117 -0
  279. package/docs/ja/specdojo/rulebooks/tsd-index-rulebook.md +101 -0
  280. package/docs/ja/specdojo/rulebooks/tsd-rulebook.md +103 -0
  281. package/docs/ja/specdojo/rulebooks/tsp-index-rulebook.md +396 -0
  282. package/docs/ja/specdojo/rulebooks/uis-rulebook.md +207 -0
  283. package/docs/ja/specdojo/rulebooks/utc-index-rulebook.md +387 -0
  284. package/docs/ja/specdojo/rulebooks/utc-rulebook.md +303 -0
  285. package/docs/ja/specdojo/samples/atc-index-sample.md +38 -0
  286. package/docs/ja/specdojo/samples/atc-sample.md +41 -0
  287. package/docs/ja/specdojo/samples/bac-sample.md +38 -0
  288. package/docs/ja/specdojo/samples/bdd-sample.yaml +71 -0
  289. package/docs/ja/specdojo/samples/bds-sample.md +38 -0
  290. package/docs/ja/specdojo/samples/bes-index-sample.md +38 -0
  291. package/docs/ja/specdojo/samples/bes-sample.md +38 -0
  292. package/docs/ja/specdojo/samples/bps-sample.md +38 -0
  293. package/docs/ja/specdojo/samples/br-sample.md +40 -0
  294. package/docs/ja/specdojo/samples/ccd-sample.md +38 -0
  295. package/docs/ja/specdojo/samples/cdfd-overview-sample.md +284 -0
  296. package/docs/ja/specdojo/samples/cdfd-sample.md +229 -0
  297. package/docs/ja/specdojo/samples/cdfd-uc-sample.md +146 -0
  298. package/docs/ja/specdojo/samples/cdsd-sample.md +38 -0
  299. package/docs/ja/specdojo/samples/cld-sample.md +38 -0
  300. package/docs/ja/specdojo/samples/cnd-sample.md +38 -0
  301. package/docs/ja/specdojo/samples/cop-index-sample.md +38 -0
  302. package/docs/ja/specdojo/samples/cop-sample.md +38 -0
  303. package/docs/ja/specdojo/samples/cpd-sample.md +38 -0
  304. package/docs/ja/specdojo/samples/cstd-sample.md +11 -0
  305. package/docs/ja/specdojo/samples/cxd-sample.md +38 -0
  306. package/docs/ja/specdojo/samples/dct-index-sample.yaml +39 -0
  307. package/docs/ja/specdojo/samples/dct-sample.yaml +91 -0
  308. package/docs/ja/specdojo/samples/dec-sample.md +39 -0
  309. package/docs/ja/specdojo/samples/dmd-index-sample.md +50 -0
  310. package/docs/ja/specdojo/samples/dmd-sample.md +74 -0
  311. package/docs/ja/specdojo/samples/etc-index-sample.md +38 -0
  312. package/docs/ja/specdojo/samples/etc-sample.md +38 -0
  313. package/docs/ja/specdojo/samples/gl-sample.yaml +37 -0
  314. package/docs/ja/specdojo/samples/ifd-sample.md +38 -0
  315. package/docs/ja/specdojo/samples/ifx-api-sample.yaml +102 -0
  316. package/docs/ja/specdojo/samples/ifx-cmd-sample.yaml +107 -0
  317. package/docs/ja/specdojo/samples/ifx-file-sample.md +38 -0
  318. package/docs/ja/specdojo/samples/ifx-msg-sample.yaml +89 -0
  319. package/docs/ja/specdojo/samples/imp-business-sample.md +66 -0
  320. package/docs/ja/specdojo/samples/imp-data-sample.md +60 -0
  321. package/docs/ja/specdojo/samples/imp-interface-sample.md +60 -0
  322. package/docs/ja/specdojo/samples/imp-operations-sample.md +60 -0
  323. package/docs/ja/specdojo/samples/imp-test-sample.md +60 -0
  324. package/docs/ja/specdojo/samples/itc-index-sample.md +38 -0
  325. package/docs/ja/specdojo/samples/itc-sample.md +38 -0
  326. package/docs/ja/specdojo/samples/mip-index-sample.md +38 -0
  327. package/docs/ja/specdojo/samples/mm-sample.md +35 -0
  328. package/docs/ja/specdojo/samples/mtp-sample.md +38 -0
  329. package/docs/ja/specdojo/samples/nfr-availability-sample.md +38 -0
  330. package/docs/ja/specdojo/samples/nfr-index-sample.md +38 -0
  331. package/docs/ja/specdojo/samples/nfr-integrity-sample.md +38 -0
  332. package/docs/ja/specdojo/samples/nfr-maintainability-sample.md +38 -0
  333. package/docs/ja/specdojo/samples/nfr-operations-sample.md +38 -0
  334. package/docs/ja/specdojo/samples/nfr-performance-sample.md +38 -0
  335. package/docs/ja/specdojo/samples/nfr-reliability-sample.md +38 -0
  336. package/docs/ja/specdojo/samples/nfr-security-safety-sample.md +38 -0
  337. package/docs/ja/specdojo/samples/nfr-usability-sample.md +38 -0
  338. package/docs/ja/specdojo/samples/ntp-sample.md +38 -0
  339. package/docs/ja/specdojo/samples/opd-access-control-sample.md +29 -0
  340. package/docs/ja/specdojo/samples/opd-incident-management-sample.md +31 -0
  341. package/docs/ja/specdojo/samples/opd-index-sample.md +41 -0
  342. package/docs/ja/specdojo/samples/opd-monitoring-sample.md +32 -0
  343. package/docs/ja/specdojo/samples/opd-sample.md +38 -0
  344. package/docs/ja/specdojo/samples/opr-access-control-sample.md +24 -0
  345. package/docs/ja/specdojo/samples/opr-backup-restore-sample.md +27 -0
  346. package/docs/ja/specdojo/samples/opr-batch-sample.md +23 -0
  347. package/docs/ja/specdojo/samples/opr-change-sample.md +24 -0
  348. package/docs/ja/specdojo/samples/opr-incident-sample.md +38 -0
  349. package/docs/ja/specdojo/samples/opr-index-sample.md +43 -0
  350. package/docs/ja/specdojo/samples/opr-monitoring-sample.md +27 -0
  351. package/docs/ja/specdojo/samples/opr-sample.md +38 -0
  352. package/docs/ja/specdojo/samples/opr-support-sample.md +23 -0
  353. package/docs/ja/specdojo/samples/otp-index-sample.md +66 -0
  354. package/docs/ja/specdojo/samples/otp-sample.md +68 -0
  355. package/docs/ja/specdojo/samples/pm-change-request-log-sample.md +47 -0
  356. package/docs/ja/specdojo/samples/pm-communication-plan-sample.md +46 -0
  357. package/docs/ja/specdojo/samples/pm-issue-log-sample.md +45 -0
  358. package/docs/ja/specdojo/samples/pm-members-sample.yaml +103 -0
  359. package/docs/ja/specdojo/samples/pm-organization-sample.md +46 -0
  360. package/docs/ja/specdojo/samples/pm-plan-sample.md +57 -0
  361. package/docs/ja/specdojo/samples/pm-quality-management-plan-sample.md +52 -0
  362. package/docs/ja/specdojo/samples/pm-raci-sample.md +57 -0
  363. package/docs/ja/specdojo/samples/pm-risk-register-sample.md +43 -0
  364. package/docs/ja/specdojo/samples/pm-roles-sample.yaml +41 -0
  365. package/docs/ja/specdojo/samples/pr-sample.md +39 -0
  366. package/docs/ja/specdojo/samples/prj-assumptions-constraints-dependencies-sample.md +57 -0
  367. package/docs/ja/specdojo/samples/prj-charter-sample.md +121 -0
  368. package/docs/ja/specdojo/samples/prj-comparison-of-alternatives-sample.md +105 -0
  369. package/docs/ja/specdojo/samples/prj-issues-and-approach-sample.md +78 -0
  370. package/docs/ja/specdojo/samples/prj-overview-sample.md +95 -0
  371. package/docs/ja/specdojo/samples/prj-scope-sample.md +71 -0
  372. package/docs/ja/specdojo/samples/prj-stakeholder-register-sample.md +60 -0
  373. package/docs/ja/specdojo/samples/prj-success-criteria-and-acceptance-criteria-sample.md +62 -0
  374. package/docs/ja/specdojo/samples/sac-sample.md +38 -0
  375. package/docs/ja/specdojo/samples/sf-index-sample.md +38 -0
  376. package/docs/ja/specdojo/samples/sf-sample.md +38 -0
  377. package/docs/ja/specdojo/samples/sld-sample.md +38 -0
  378. package/docs/ja/specdojo/samples/stc-index-sample.md +38 -0
  379. package/docs/ja/specdojo/samples/stc-sample.md +38 -0
  380. package/docs/ja/specdojo/samples/stsd-sample.md +58 -0
  381. package/docs/ja/specdojo/samples/sysd-critical-flows-sample.md +38 -0
  382. package/docs/ja/specdojo/samples/sysd-cross-cutting-policy-sample.md +38 -0
  383. package/docs/ja/specdojo/samples/sysd-index-sample.md +38 -0
  384. package/docs/ja/specdojo/samples/trc-requirements-to-specs-sample.md +56 -0
  385. package/docs/ja/specdojo/samples/trc-requirements-to-tests-sample.md +56 -0
  386. package/docs/ja/specdojo/samples/tsd-index-sample.md +29 -0
  387. package/docs/ja/specdojo/samples/tsd-sample.md +38 -0
  388. package/docs/ja/specdojo/samples/tsp-index-sample.md +38 -0
  389. package/docs/ja/specdojo/samples/uis-sample.md +38 -0
  390. package/docs/ja/specdojo/samples/utc-index-sample.md +38 -0
  391. package/docs/ja/specdojo/samples/utc-sample.md +38 -0
  392. package/docs/ja/specdojo/schemas/v1/guide-content.schema.yaml +20 -0
  393. package/docs/ja/specdojo/schemas/v1/philosophy-content.schema.yaml +21 -0
  394. package/docs/ja/specdojo/schemas/v1/reference-content.schema.yaml +21 -0
  395. package/docs/ja/specdojo/standards/document-metadata-standard.md +323 -0
  396. package/docs/ja/specdojo/standards/exec-human-finalize-standard.md +75 -0
  397. package/docs/ja/specdojo/standards/git-branching-standard.md +227 -0
  398. package/docs/ja/specdojo/standards/guide-authoring-standard.md +124 -0
  399. package/docs/ja/specdojo/standards/id-and-file-naming-standard.md +929 -0
  400. package/docs/ja/specdojo/standards/job-definition-standard.md +148 -0
  401. package/docs/ja/specdojo/standards/people-and-organization-definition-standard.md +431 -0
  402. package/docs/ja/specdojo/standards/philosophy-authoring-standard.md +113 -0
  403. package/docs/ja/specdojo/standards/recipe-authoring-standard.md +143 -0
  404. package/docs/ja/specdojo/standards/reference-authoring-standard.md +99 -0
  405. package/docs/ja/specdojo/standards/rulebook-authoring-standard.md +140 -0
  406. package/docs/ja/specdojo/standards/sample-authoring-standard.md +151 -0
  407. package/docs/ja/specdojo/standards/standard-authoring-standard.md +108 -0
  408. package/docs/ja/specdojo/standards/template-authoring-standard.md +101 -0
  409. package/docs/ja/specdojo/standards/test-document-scope-standard.md +176 -0
  410. package/docs/ja/specdojo/templates/cdfd-overview-template.md +199 -0
  411. package/docs/ja/specdojo/templates/cdfd-template.md +173 -0
  412. package/docs/ja/specdojo/templates/cdfd-uc-template.md +148 -0
  413. package/docs/ja/specdojo/templates/dct-architecture-template.yaml +136 -0
  414. package/docs/ja/specdojo/templates/dct-business-acceptance-criteria-template.yaml +34 -0
  415. package/docs/ja/specdojo/templates/dct-business-model-bes-template.yaml +75 -0
  416. package/docs/ja/specdojo/templates/dct-business-model-bps-template.yaml +49 -0
  417. package/docs/ja/specdojo/templates/dct-business-model-br-template.yaml +50 -0
  418. package/docs/ja/specdojo/templates/dct-data-flow-template.yaml +40 -0
  419. package/docs/ja/specdojo/templates/dct-data-model-bdd-template.yaml +46 -0
  420. package/docs/ja/specdojo/templates/dct-data-model-ccd-template.yaml +46 -0
  421. package/docs/ja/specdojo/templates/dct-data-model-cdsd-template.yaml +41 -0
  422. package/docs/ja/specdojo/templates/dct-data-model-cld-template.yaml +38 -0
  423. package/docs/ja/specdojo/templates/dct-data-model-sld-template.yaml +38 -0
  424. package/docs/ja/specdojo/templates/dct-data-model-stsd-template.yaml +46 -0
  425. package/docs/ja/specdojo/templates/dct-external-interface-specs-template.yaml +114 -0
  426. package/docs/ja/specdojo/templates/dct-glossary-template.yaml +35 -0
  427. package/docs/ja/specdojo/templates/dct-impact-analysis-template.yaml +138 -0
  428. package/docs/ja/specdojo/templates/dct-index-template.md +40 -0
  429. package/docs/ja/specdojo/templates/dct-migration-planning-template.yaml +148 -0
  430. package/docs/ja/specdojo/templates/dct-non-functional-requirements-template.yaml +222 -0
  431. package/docs/ja/specdojo/templates/dct-operations-template.yaml +108 -0
  432. package/docs/ja/specdojo/templates/dct-project-definition-template.yaml +210 -0
  433. package/docs/ja/specdojo/templates/dct-project-management-template.yaml +423 -0
  434. package/docs/ja/specdojo/templates/dct-system-acceptance-criteria-template.yaml +37 -0
  435. package/docs/ja/specdojo/templates/dct-system-design-template.yaml +82 -0
  436. package/docs/ja/specdojo/templates/dct-system-functions-template.yaml +58 -0
  437. package/docs/ja/specdojo/templates/dct-test-specs-template.yaml +261 -0
  438. package/docs/ja/specdojo/templates/dct-user-interface-model-template.yaml +60 -0
  439. package/docs/ja/specdojo/templates/ifx-cmd-template.yaml +88 -0
  440. package/docs/ja/specdojo/templates/opr-template.md +85 -0
  441. package/docs/ja/specdojo/templates/pjr-change-request-template.md +60 -0
  442. package/docs/ja/specdojo/templates/pjr-decision-template.md +61 -0
  443. package/docs/ja/specdojo/templates/pjr-index-template.md +49 -0
  444. package/docs/ja/specdojo/templates/pjr-issue-template.md +50 -0
  445. package/docs/ja/specdojo/templates/pjr-note-template.md +35 -0
  446. package/docs/ja/specdojo/templates/pjr-question-template.md +53 -0
  447. package/docs/ja/specdojo/templates/pjr-risk-template.md +49 -0
  448. package/docs/ja/specdojo/templates/pjr-todo-template.md +41 -0
  449. package/docs/ja/specdojo/templates/pjr-views-by-owner-template.md +22 -0
  450. package/docs/ja/specdojo/templates/pjr-views-by-priority-template.md +22 -0
  451. package/docs/ja/specdojo/templates/pjr-views-by-status-template.md +22 -0
  452. package/docs/ja/specdojo/templates/pm-change-request-log-template.md +20 -0
  453. package/docs/ja/specdojo/templates/pm-communication-plan-template.md +46 -0
  454. package/docs/ja/specdojo/templates/pm-decision-log-template.md +20 -0
  455. package/docs/ja/specdojo/templates/pm-issue-log-template.md +20 -0
  456. package/docs/ja/specdojo/templates/pm-members-template.yaml +105 -0
  457. package/docs/ja/specdojo/templates/pm-organization-template.md +44 -0
  458. package/docs/ja/specdojo/templates/pm-plan-template.md +52 -0
  459. package/docs/ja/specdojo/templates/pm-quality-management-plan-template.md +46 -0
  460. package/docs/ja/specdojo/templates/pm-raci-template.md +51 -0
  461. package/docs/ja/specdojo/templates/pm-risk-register-template.md +20 -0
  462. package/docs/ja/specdojo/templates/pm-roles-template.yaml +53 -0
  463. package/docs/ja/specdojo/templates/prj-assumptions-constraints-dependencies-template.md +59 -0
  464. package/docs/ja/specdojo/templates/prj-charter-template.md +116 -0
  465. package/docs/ja/specdojo/templates/prj-comparison-of-alternatives-template.md +116 -0
  466. package/docs/ja/specdojo/templates/prj-issues-and-approach-template.md +89 -0
  467. package/docs/ja/specdojo/templates/prj-overview-template.md +85 -0
  468. package/docs/ja/specdojo/templates/prj-scope-template.md +75 -0
  469. package/docs/ja/specdojo/templates/prj-stakeholder-register-template.md +64 -0
  470. package/docs/ja/specdojo/templates/prj-success-criteria-and-acceptance-criteria-template.md +60 -0
  471. package/docs/ja/specdojo/templates/stsd-template.md +57 -0
  472. package/docs/specdojo/schemas/v1/bdd.schema.yaml +230 -0
  473. package/docs/specdojo/schemas/v1/common-frontmatter.schema.yaml +77 -0
  474. package/docs/specdojo/schemas/v1/dct-index.schema.yaml +85 -0
  475. package/docs/specdojo/schemas/v1/dct-plan.schema.yaml +324 -0
  476. package/docs/specdojo/schemas/v1/dct.schema.yaml +368 -0
  477. package/docs/specdojo/schemas/v1/deliverable-frontmatter.schema.yaml +91 -0
  478. package/docs/specdojo/schemas/v1/esil.schema.yaml +142 -0
  479. package/docs/specdojo/schemas/v1/exec-common.schema.yaml +101 -0
  480. package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +272 -0
  481. package/docs/specdojo/schemas/v1/exec-evidence.schema.yaml +162 -0
  482. package/docs/specdojo/schemas/v1/exec-plan-frontmatter.schema.yaml +126 -0
  483. package/docs/specdojo/schemas/v1/exec-reporter-output.schema.yaml +151 -0
  484. package/docs/specdojo/schemas/v1/exec-result-frontmatter.schema.yaml +144 -0
  485. package/docs/specdojo/schemas/v1/grade-done-criteria.schema.yaml +79 -0
  486. package/docs/specdojo/schemas/v1/grade-pipeline-state.schema.yaml +60 -0
  487. package/docs/specdojo/schemas/v1/grade-result.schema.yaml +118 -0
  488. package/docs/specdojo/schemas/v1/guide-frontmatter.schema.yaml +19 -0
  489. package/docs/specdojo/schemas/v1/ifx-cmd.schema.yaml +293 -0
  490. package/docs/specdojo/schemas/v1/job-run.schema.yaml +90 -0
  491. package/docs/specdojo/schemas/v1/job.schema.yaml +198 -0
  492. package/docs/specdojo/schemas/v1/philosophy-frontmatter.schema.yaml +19 -0
  493. package/docs/specdojo/schemas/v1/pipeline-state.schema.yaml +56 -0
  494. package/docs/specdojo/schemas/v1/pm-members.schema.yaml +252 -0
  495. package/docs/specdojo/schemas/v1/pm-review-viewpoints.schema.yaml +387 -0
  496. package/docs/specdojo/schemas/v1/pm-roles.schema.yaml +106 -0
  497. package/docs/specdojo/schemas/v1/recipe-frontmatter.schema.yaml +27 -0
  498. package/docs/specdojo/schemas/v1/reference-frontmatter.schema.yaml +18 -0
  499. package/docs/specdojo/schemas/v1/register-events.schema.yaml +106 -0
  500. package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +204 -0
  501. package/docs/specdojo/schemas/v1/routine-run.schema.yaml +36 -0
  502. package/docs/specdojo/schemas/v1/routine.schema.yaml +87 -0
  503. package/docs/specdojo/schemas/v1/rulebook-frontmatter.schema.yaml +61 -0
  504. package/docs/specdojo/schemas/v1/sch-common.schema.yaml +258 -0
  505. package/docs/specdojo/schemas/v1/sch-defaults.schema.yaml +48 -0
  506. package/docs/specdojo/schemas/v1/sch-milestones.schema.yaml +64 -0
  507. package/docs/specdojo/schemas/v1/sch-strategy.schema.yaml +772 -0
  508. package/docs/specdojo/schemas/v1/sch-track.schema.yaml +66 -0
  509. package/docs/specdojo/schemas/v1/standard-frontmatter.schema.yaml +18 -0
  510. package/docs/specdojo/schemas/v1/tml-index.schema.yaml +103 -0
  511. package/package.json +120 -24
  512. package/templates/claude/README.md +46 -0
  513. package/templates/claude/agents/claude-expert-review-executor.md +14 -0
  514. package/templates/claude/agents/claude-review-executor.md +14 -0
  515. package/templates/claude/settings.edit.json +6 -0
  516. package/templates/claude/settings.report.json +6 -0
  517. package/templates/claude/settings.review.json +7 -0
  518. package/templates/codex/README.md +61 -0
  519. package/templates/codex/agents/codex-executor.toml +12 -0
  520. package/templates/codex/agents/codex-expert-executor.toml +12 -0
  521. package/templates/codex/agents/codex-expert-review-executor.toml +10 -0
  522. package/templates/codex/agents/codex-review-executor.toml +10 -0
  523. package/templates/copilot/README.md +41 -0
  524. package/templates/copilot/exec-defaults-snippet.yaml +28 -0
  525. package/templates/copilot/pm-members-snippet.yaml +44 -0
  526. package/templates/opencode/README.md +41 -0
  527. package/templates/opencode/agents/opencode-executor.md +59 -0
  528. package/templates/opencode/agents/opencode-reporter.md +26 -0
  529. package/templates/opencode/agents/opencode-review-executor.md +48 -0
  530. package/dist/exec-schedule-timeline-render.js +0 -201
  531. package/dist/exec-schedule-timeline.js +0 -2
@@ -0,0 +1,215 @@
1
+ ---
2
+ specdojo:
3
+ id: specdojo:track-design-guide
4
+ type: guide
5
+ status: ready
6
+ ---
7
+
8
+ # トラック設計ガイド
9
+
10
+ Track Design Guide
11
+
12
+ SpecDojoでは、関連する成果物の作成・更新と、それらを生み出す活動を作業系列ごとにまとめ、トラックとして管理します。
13
+
14
+ 以下に、SpecDojoが想定する標準的なトラック構成を示します。トラックはフェーズではなく、相互に並行・反復して実行できます。表の順序は代表的な依存関係を示す一例であり、実際の実行順を固定するものではありません。
15
+
16
+ **対象読者**
17
+
18
+ - プロジェクトの作業系列を設計し、成果物の着手順・並行・反復を計画するプロジェクト責任者、計画担当者
19
+ - 担当する作業がどのトラックに属し、どの成果物を入力とするかを確認する成果物作成者
20
+
21
+ **この文書で分かること**
22
+
23
+ - SpecDojo が想定する標準トラックの構成と、各トラックが扱う範囲
24
+ - トラックとドメイン(`dct-<domain>.yaml`)・成果物カテゴリの対応関係
25
+ - 開発の進め方に応じた実行順序の組み立て方と、入力元より先に後続トラックへ着手する場合の留意点
26
+
27
+ **次に読む文書**
28
+
29
+ - 各成果物の目的・推奨ファイル名・記述規則への導線は [成果物リファレンス](../references/deliverables-reference.md) を参照してください。
30
+ - トラックを実行タスクへ展開する方法は [Schedule設計ガイド](schedule-design-guide.md) を参照してください。
31
+
32
+ **この文書が扱わないこと**
33
+
34
+ - 個別成果物の目的、記述規則、Frontmatter 規約
35
+ - 文書の分類、ディレクトリ構成、ファイル名・ID の規則
36
+ - Schedule 上のタスク粒度、担当者、日付、依存関係の定義方法
37
+ - 要求・要件・仕様・設計・実装という記述内容の区別
38
+
39
+ ## 1. 標準トラック構成
40
+
41
+ | id | トラック | 概要 |
42
+ | ------------------------ | ---------------------- | ------------------------------------------------------------------------ |
43
+ | launch | 立ち上げトラック | プロジェクトの目的、範囲、前提および推進体制を定義する |
44
+ | business-specs | 業務仕様カテゴリ | プロダクトの業務仕様を定義する。ドメイン別トラックに分割する |
45
+ | current-state | 現状把握トラック | 現行の業務・システム・運用と、その課題・制約を明らかにする |
46
+ | external-interface-specs | 外部I/F仕様トラック | 外部システムとのインターフェース契約を定義する |
47
+ | impact-analysis | 影響調査トラック | 導入・変更が業務・システム・運用へ与える影響を明らかにする |
48
+ | architecture | アーキテクチャトラック | プロダクト全体の構造、実行基盤および技術選定を定義する |
49
+ | system-design | システム設計トラック | 実装の構造、重要フローおよび横断方針を設計する |
50
+ | quality-specs | 品質仕様カテゴリ | 品質基準、受入条件および検証方法を定義する。ドメイン別トラックに分割する |
51
+ | migration-planning | 移行計画トラック | データ移行、切替、リハーサルおよび運用移管を計画する |
52
+ | operations-design | 運用設計トラック | 恒常運用の方針、体制および手順を設計する |
53
+ | implementation | 実装トラック | 仕様・設計に基づき、業務・システムを実装する |
54
+ | testing | テストトラック | 要件・仕様・設計への適合性を検証する |
55
+ | migration | 移行トラック | 移行計画に基づき、本番環境へ移行する |
56
+ | operations | 運用トラック | 業務・システムを運用し、継続的に改善する |
57
+
58
+ プロダクトドキュメントは常に「現在の正」を表すため、標準トラックIDには `to-be` を付けません。変更前の状態だけはプロジェクト固有の比較基準として `current-state` で扱います。また、`specifications` はパスと機械識別子では `specs` と表記します。
59
+
60
+ `business-specs` と `quality-specs` は、扱うドメインが多く、ドメインごとに作成ワークフローと完了判断が異なるため、単一トラックではなく**カテゴリ**として扱い、スケジュール上の実体は**ドメイン別トラック**として管理します。
61
+
62
+ ### 1.1. 業務仕様・品質仕様のドメイン別トラック
63
+
64
+ トラックとスケジュール戦略(`sch-strategy-<track>.yaml`)は 1 対 1 で対応します。したがってドメイン別トラックにすることで、ドメイン固有のフェーズ構成・ゲート・横断整理(`cross_deliverable_passes`)を個別に定義できます。各ドメイン別トラックの `track` id はドメイン名と一致させます。
65
+
66
+ | カテゴリ | ドメイン別トラック id |
67
+ | ---------------- | --------------------------------------------------------------------------------------------------------- |
68
+ | `business-specs` | `data-flow`、`data-model`、`business-model`、`user-interface-model`、`system-functions`、`glossary` |
69
+ | `quality-specs` | `business-acceptance-criteria`、`non-functional-requirements`、`system-acceptance-criteria`、`test-specs` |
70
+
71
+ カテゴリ内の全ドメインを必ず個別トラックにする必要はありません。規模が小さく作成ワークフローが共通なドメインは 1 トラックへまとめてもよく、分割の判断基準は `ドメインの切り方` を参照します。以降の各表では、`business-specs` と `quality-specs` はカテゴリ(その配下のドメイン別トラック全体)を指す略記として用います。
72
+
73
+ ## 2. トラックとドメイン・成果物カテゴリの関係
74
+
75
+ 本章では、トラックがどのドメインの成果物カタログを対象とし、どの成果物カテゴリを扱うかを示します。個別成果物の目的・推奨ファイル名・記述規則への導線は [成果物リファレンス](../references/deliverables-reference.md) を参照してください。
76
+
77
+ ### 2.1. トラック・ドメイン・成果物の3層
78
+
79
+ トラック、ドメイン、成果物はそれぞれ扱う単位と正本が異なります。
80
+
81
+ | 層 | 単位 | 正本 |
82
+ | -------- | -------------------------------------- | ----------------------------------------------- |
83
+ | トラック | 関連する成果物と活動をまとめた作業系列 | 本書(標準構成)と `sch-strategy-<track>.yaml` |
84
+ | ドメイン | 成果物カタログの管理単位 | `dct-<domain>.yaml` |
85
+ | 成果物 | 個別のドキュメント・定義ファイル | 種別ごとの rulebook(一覧は成果物リファレンス) |
86
+
87
+ 3層は Schedule 定義で接続します。`sch-strategy-<track>.yaml` は `track` でトラックを宣言し、`scope.catalogs` で対象とする `dct-<domain>.yaml` を指定します。catalog の `local_ids` を省略した場合は対象 kind の全成果物、指定した場合はその成果物だけをトラックの作業対象にします。成果物の定義と配置は引き続き成果物カタログが管理し、Schedule の選択によって所属ドメインは変わりません。生成の流れは [Schedule設計ガイド](schedule-design-guide.md) を参照してください。
88
+
89
+ ### 2.2. トラック別の対応
90
+
91
+ 各トラックが対象とするドメインと成果物カテゴリの標準的な組み合わせは次のとおりです。成果物カテゴリは [成果物リファレンス](../references/deliverables-reference.md) の章タイトルに対応します。ドメイン名は例であり、実際の切り方はプロジェクトごとに決めます。
92
+
93
+ | id | 想定ドメインの例 | 主に扱う成果物カテゴリ | 関与の仕方 |
94
+ | ---------------------------- | ------------------------------------------ | ------------------------------------------------------------ | ---------- |
95
+ | launch | `project-definition`、`project-management` | 立ち上げ、プロジェクト定義、プロジェクトマネジメント | 定義する |
96
+ | data-flow | `data-flow` | 業務仕様(データフロー) | 定義する |
97
+ | data-model | `data-model` | 業務仕様(データモデル) | 定義する |
98
+ | business-model | `business-model` | 業務仕様(業務モデル) | 定義する |
99
+ | user-interface-model | `user-interface-model` | 業務仕様(UIモデル) | 定義する |
100
+ | system-functions | `system-functions` | 業務仕様(システム機能) | 定義する |
101
+ | glossary | `glossary` | 業務仕様(用語集) | 定義する |
102
+ | current-state | `current-state` | 現状定義(必要なプロダクト成果物カテゴリのスナップショット) | 定義する |
103
+ | external-interface-specs | `external-interface-specs` | 外部I/F仕様 | 定義する |
104
+ | impact-analysis | `impact-analysis` | 影響調査 | 定義する |
105
+ | architecture | `architecture` | アーキテクチャ | 定義する |
106
+ | system-design | `system-design` | システム設計 | 定義する |
107
+ | business-acceptance-criteria | `business-acceptance-criteria` | 業務受入条件 | 定義する |
108
+ | non-functional-requirements | `non-functional-requirements` | 非機能要件 | 定義する |
109
+ | system-acceptance-criteria | `system-acceptance-criteria` | システム受入条件 | 定義する |
110
+ | test-specs | `test-specs` | テスト仕様 | 定義する |
111
+ | migration-planning | `migration-planning` | 移行 | 定義する |
112
+ | operations-design | `operations` | 運用 | 定義する |
113
+ | implementation | `system-design` | システム設計(SSOTである定義ファイル・コードへの導線) | 実施する |
114
+ | testing | `test-specs` | テスト | 実施する |
115
+ | migration | `migration-planning` | 移行 | 実施する |
116
+ | operations | `operations` | 運用 | 実施する |
117
+
118
+ `関与の仕方` は、そのトラックが成果物を書き起こすのか、既存の成果物に従って作業するのかを表します。`定義する` トラックは成果物そのものが主な産物になります。`実施する` トラックは、対応する `定義する` トラックの成果物を入力として実行し、実行記録や更新結果を残します。テストは `quality-specs` で観点・条件を定義して `testing` で実施する、移行は `migration-planning` で計画して `migration` で実行する、というように対になります。
119
+
120
+ トレーサビリティは独立トラック・独立成果物ドメインとしません。各成果物が持つID参照を正本とし、要求から仕様・テストへの対応表やカバレッジは必要に応じて派生ビューとして生成します。
121
+
122
+ ### 2.3. ドメインの切り方
123
+
124
+ 同じ成果物カテゴリが複数のトラックに現れるため、ドメインとトラックは1対1にはなりません。切り分けでは次を目安にします。
125
+
126
+ - 1つのトラックが複数のドメインを対象にしてよい。`sch-strategy-<track>.yaml` の `scope.catalogs` には複数の成果物カタログを指定できます。
127
+ - ドメインごとに作成ワークフロー・ゲート・完了判断が異なる、または規模が大きい場合は、カテゴリを複数のドメイン別トラックに分割する。トラックとスケジュール戦略(`sch-strategy-<track>.yaml`)は 1 対 1 のため、ドメイン別トラックにするとドメイン固有のフェーズ構成・横断整理を個別に定義できます(`業務仕様・品質仕様のドメイン別トラック` を参照)。
128
+ - 1つのドメインを複数のトラックが参照してよい。例えば業務仕様の各ドメイン別トラックで作成した成果物は、`implementation` や `testing` では入力として参照します。
129
+ - 1つのドメインの成果物を複数トラックで分担または再修正してよい。各 strategy の `scope.catalogs[].local_ids` で作業対象を明示し、同じ成果物を複数トラックから選択する場合もあります。タスクと完了・レビュー状態は track を含む task ID ごとに独立して管理します。
130
+ - Timeline で当該ドメインを `catalog_status: primary` にしたトラックは、成果物カタログを定義・管理するトラックです。別トラックが同じ成果物を選択して修正しても、カタログの所属や定義責任は移りません。
131
+ - 現状とプロダクトの現在の正で同じ成果物種別を扱う場合は、`current-state` と `product` の配置ディレクトリで区別し、同一カタログに混在させないようにします。
132
+ - ドメインは成果物カタログの管理単位なので、担当者と完了判断がまとまる粒度で切ると、Schedule への展開が素直になります。
133
+
134
+ ## 3. トラックの標準的な実行順序
135
+
136
+ トラックはフェーズではないため、実行順序は開発の進め方によって変わります。ここでは代表的な2つの進め方について、どこから着手し、どこを並行させ、どこで区切るかの標準例を示します。実際の順序・日付・担当は `sch-track-<track>.yaml` が正本です。
137
+
138
+ 進め方によらず、トラック間には次の情報の流れがあります。この表は、どのトラックの成果物を入力として使うかを示すものであり、着手順を固定するものではありません。
139
+
140
+ | トラック | 主な入力元トラック | 受け取る情報 |
141
+ | -------------------- | ------------------------------------------------------------- | ---------------------------------- |
142
+ | すべて | `launch` | 対象範囲、推進体制、成果物カタログ |
143
+ | `impact-analysis` | `current-state`、`business-specs`、`external-interface-specs` | 現行の姿、導入・変更後の仕様 |
144
+ | `architecture` | `business-specs`、`external-interface-specs` | 業務仕様、外部との契約 |
145
+ | `system-design` | `business-specs`、`external-interface-specs`、`architecture` | 業務仕様、外部との契約、全体構造 |
146
+ | `quality-specs` | `business-specs`、`external-interface-specs` | 要件・仕様 |
147
+ | `migration-planning` | `impact-analysis`、`system-design` | 影響と対応方針、移行先の設計 |
148
+ | `operations-design` | `system-design` | 稼働後の業務・システム構成 |
149
+ | `implementation` | `system-design` | 設計 |
150
+ | `testing` | `quality-specs`、`implementation` | 観点・条件、検証対象 |
151
+ | `migration` | `migration-planning`、`testing` | 移行計画、検証結果 |
152
+ | `operations` | `operations-design`、`migration` | 運用設計、移行結果 |
153
+
154
+ `current-state` とプロダクト仕様の各トラックの間には固定の情報の流れを置きません。現行に引きずられた仕様を避けるためプロダクト仕様を先に検討することも、現行の制約を早く把握するため `current-state` を先に調べることもできます。
155
+
156
+ ### 3.1. アジャイル開発の場合
157
+
158
+ 対象範囲を小さく区切り、`business-specs` から `testing` までを1サイクルとして反復します。トラックは消えず、サイクルごとに扱う範囲だけが変わります。
159
+
160
+ | 段階 | 主に動くトラック | 扱う範囲 |
161
+ | ------------ | ------------------------------------------------------------------------------ | -------------------------------------------- |
162
+ | 立ち上げ | `launch` | プロジェクト全体。以降のサイクルで随時見直す |
163
+ | 各サイクル | `current-state`、`business-specs`、`external-interface-specs`、`quality-specs` | そのサイクルで扱う範囲に限定して調査・定義 |
164
+ | 各サイクル | `architecture`、`system-design`、`implementation`、`testing` | 同じ範囲を設計・実装・検証 |
165
+ | リリース前 | `impact-analysis`、`migration-planning`、`operations-design` | 既存への影響、移行方式、運用方式 |
166
+ | リリース以降 | `migration`、`operations` | 移行実施と恒常運用。以降のサイクルと並行する |
167
+
168
+ 進め方の要点は次のとおりです。
169
+
170
+ - `launch` は最小限の範囲で先に通し、確定しない前提は `_UNDECIDED_` として残したままサイクルを始めます。
171
+ - `quality-specs` はプロダクト仕様の各トラックと同じサイクル内で進め、受入条件を仕様と同時に定義します。後追いにすると手戻りが大きくなります。
172
+ - `current-state` と `impact-analysis` は全体を先に調べ切らず、サイクルで扱う範囲だけを対象にします。
173
+ - 反復は Schedule 側で表現します。`sch-strategy-<track>.yaml` の `cycles` と `iterations` の意味は [Schedule設計ガイド](schedule-design-guide.md) の `phase_setsの反復` を参照してください。
174
+ - リリース後もプロダクト仕様以降のサイクルは続くため、`operations` は他トラックと並行して動き続けます。
175
+
176
+ ### 3.2. ウォーターフォール開発の場合
177
+
178
+ トラックをおおむね直列に並べ、区切りに判断ゲートを置きます。同じ段階に置いたトラックは並行して進められます。
179
+
180
+ | 段階 | 並行するトラック | 段階末の判断材料 |
181
+ | -------------- | ------------------------------------------------------------- | -------------------------------------- |
182
+ | 立ち上げ | `launch` | 目的・範囲・体制が合意できているか |
183
+ | 要件・仕様 | `current-state`、`business-specs`、`external-interface-specs` | 現状とプロダクト仕様が固まったか |
184
+ | 影響調査 | `impact-analysis` | 影響と対応方針が明確になったか |
185
+ | 設計 | `architecture`、`system-design`、`quality-specs` | 実現方式と受入条件が定まったか |
186
+ | 移行・運用設計 | `migration-planning`、`operations-design` | 切替方式と運用方式が定まったか |
187
+ | 実装 | `implementation` | 設計どおりに構築できたか |
188
+ | テスト | `testing` | 受入条件を満たしたか |
189
+ | 移行 | `migration` | 本番切替が完了し、判定基準を満たしたか |
190
+ | 運用 | `operations` | 安定稼働の完了条件を満たしたか |
191
+
192
+ 進め方の要点は次のとおりです。
193
+
194
+ - 段階の境界に GO/NOT GO の判断を置く場合は、`要件・仕様`(目指す姿が固まった時点)、`影響調査`(実現性と対応範囲が見えた時点)、`設計`(負荷と工期が見積もれる時点)の3点が代表的な候補です。
195
+ - 段階を直列にしても、`current-state` とプロダクト仕様の各トラック、`system-design` と `quality-specs` のように同じ入力を使うトラックは並行させたほうが待ち時間を減らせます。
196
+ - 判断ゲートは Schedule 側の `phase_gates` や `group_milestones` として展開します。トラックの区切りとゲートを1対1にする必要はありません。
197
+ - 後段のトラックほど前段の成果物に依存するため、前段で残した `_TODO_` や `_UNDECIDED_` は段階末までに解消しておきます。
198
+
199
+ ### 3.3. 入力元より先に後続トラックへ着手する場合
200
+
201
+ `トラック間の情報の流れ` は依存の向きであって着手順ではありません。後続トラックから先に着手し、そこで分かったことをもとに入力元トラックの成果物を後から起こす進め方も選べます。既存プロダクトを扱う場合や、実現方式の不確実性が大きい場合はこちらが現実的です。
202
+
203
+ | 状況 | 先に着手するトラック | 後から起こすトラック |
204
+ | ------------------------------------------ | -------------------------------------------------- | --------------------------------- |
205
+ | 既存プロダクトに文書がない | `operations`、`implementation`(現物・実績の確認) | `current-state` |
206
+ | 実現方式に不確実性が大きい | `implementation`(試作) | `business-specs`、`system-design` |
207
+ | 期待する振る舞いのほうが先に合意できる | `quality-specs`(受入条件) | `business-specs` |
208
+ | 現場の運用実態から恒常運用の要件を固めたい | `operations` | `operations-design` |
209
+
210
+ 進め方の要点は次のとおりです。
211
+
212
+ - 後から起こす成果物も `dct-<domain>.yaml` に登録し、完了条件を持たせます。作らないと決めた場合は、その判断を記録に残します。
213
+ - 逆順で進めた区間は、最後に入力元と後続の整合を取る作業をタスクとして明示的に置きます。どちらを正本とするか決めないまま両方を更新すると、食い違いが残ります。
214
+ - Schedule の `depends_on` は実際の着手順に合わせて張ります。`トラック間の情報の流れ` をそのまま写すと、着手できないタスク順になります。
215
+ - 試作や現物確認を先に行う場合、その結果は入力にすぎません。後から起こす成果物は、確認結果をそのまま写すのではなく、目指す姿として書き直せているかを確認します。
@@ -0,0 +1,133 @@
1
+ ---
2
+ specdojo:
3
+ id: specdojo:use-case-guide
4
+ type: guide
5
+ status: ready
6
+ based_on:
7
+ - specdojo:specdojo-overview-guide
8
+ - specdojo:quick-start-guide
9
+ ---
10
+
11
+ # ユースケース別ガイド
12
+
13
+ Use Case Guide
14
+
15
+ 「やりたいこと」から、進め方の筋道と読むべき文書へ最短で入るためのガイドです。Quick Start の次に何をどの順で進めればよいかを、代表的なシナリオごとに示します。各ステップの詳細は既存の guide / reference へのリンクに委ねます。
16
+
17
+ **対象読者**
18
+
19
+ - Quick Start を終え、自分の状況に合わせて次に何をすればよいか知りたい利用者
20
+
21
+ **この文書で分かること**
22
+
23
+ - 代表的なシナリオごとの、ゴール・進め方の要点・主に使う文書
24
+
25
+ **次に読む文書**
26
+
27
+ - トピックからどの文書かを引く平坦な索引は [全体概要ガイド](specdojo-overview-guide.md) の `目的別の次の読み物`、コマンドの詳細は [CLIコマンドリファレンス](../references/command-reference.md) を参照してください。
28
+
29
+ ## 1. このガイドの使い方
30
+
31
+ 本ガイドは「シナリオ → 進め方 → 使う文書」の筋道を示すもので、文書やコマンドの正本ではありません。各シナリオは次の3点で構成します。
32
+
33
+ - ゴール: そのシナリオで達成したいこと
34
+ - 進め方: 大まかな手順の流れ
35
+ - 主に使う文書: 詳細を確認する guide / reference
36
+
37
+ 「この項目はどの文書か」を平坦に引きたい場合は [全体概要ガイド](specdojo-overview-guide.md) の `目的別の次の読み物` を、コマンドとオプションは [CLIコマンドリファレンス](../references/command-reference.md) を参照してください。まず一度通す体験は [Quick Startガイド](quick-start-guide.md) が最短です。
38
+
39
+ 次の早見図から、いまの状況に近いシナリオへ進めます。各ノードは以降の節の見出しに対応します。
40
+
41
+ ```mermaid
42
+ flowchart TD
43
+ Q{"いまの状況は?"}
44
+ Q -->|まだ何も無い| S11["新規プロジェクトを<br/>最短で立ち上げる"]
45
+ Q -->|目的・スコープが未確定| S12["課題整理から<br/>目的・スコープを固める"]
46
+ Q -->|既存プロダクト・文書なし| S13["既存プロダクトから<br/>着手する"]
47
+ Q -->|計画済みを実行したい| EXE{"どう実行する?"}
48
+ Q -->|運用・管理したい| MNG{"何を管理する?"}
49
+
50
+ EXE -->|agent に任せる| S21["agent に成果物を<br/>量産させる"]
51
+ EXE -->|変更を隔離したい| S22["worktree で<br/>隔離実行する"]
52
+ EXE -->|会話で操作したい| S23["対話(チャット)で<br/>運用する"]
53
+
54
+ MNG -->|品質を確定したい| S31["レビューを回して<br/>ready にする"]
55
+ MNG -->|計画外の対応・調査| S32["計画外の単発対応・<br/>調査を管理する"]
56
+ MNG -->|定期的に回す| S33["定期実行を組む"]
57
+ MNG -->|複数PJ・ブランチ| S34["複数プロジェクト・<br/>ブランチを並行する"]
58
+
59
+ classDef setup fill:#fff3bf,stroke:#f08c00,color:#000;
60
+ classDef exec fill:#d0ebff,stroke:#1c7ed6,color:#000;
61
+ classDef manage fill:#d3f9d8,stroke:#2f9e44,color:#000;
62
+ class S11,S12,S13 setup;
63
+ class S21,S22,S23 exec;
64
+ class S31,S32,S33,S34 manage;
65
+ ```
66
+
67
+ ## 2. 立ち上げと計画
68
+
69
+ ### 2.1. 新規プロジェクトを最短で立ち上げる
70
+
71
+ - ゴール: 設定から1タスク完了までを最短で通す。
72
+ - 進め方: `config init` → 成果物カタログ作成・検証・生成 → トラック戦略作成 → `schedule build` → `exec refresh` → 1タスクを claim / complete。
73
+ - 主に使う文書: [Quick Startガイド](quick-start-guide.md)、[遂行の技活用ガイド](waza-guide.md)。
74
+
75
+ ### 2.2. 課題整理から目的・スコープを固める
76
+
77
+ - ゴール: 目的・スコープ・対象成果物が未確定な状態を、記録しながら決めていく。
78
+ - 進め方: `issue` / `question` を登録し、調査のうえ `decision` で方針を確定し、`todo` で成果物カタログ作成につなげる。決定後は schedule 側で計画済み作業を管理する。
79
+ - 主に使う文書: [登録簿運用ガイド](register-operation-guide.md)、[Quick Startガイド](quick-start-guide.md) の `registerで課題と判断を整理する`。
80
+
81
+ ### 2.3. 既存プロダクト(文書なし)から着手する
82
+
83
+ - ゴール: ドキュメントが無い既存プロダクトを対象に、現物・実績から仕様を起こす。
84
+ - 進め方: 後続トラック(実装・運用の現物確認など)を先に着手し、そこで分かったことをもとに AS-IS 側の成果物を後から起こす。逆順区間は最後に整合を取るタスクを明示する。
85
+ - 主に使う文書: [トラック設計ガイド](track-design-guide.md) の `入力元より先に後続トラックへ着手する場合`、[成果物リファレンス](../references/deliverables-reference.md)。
86
+
87
+ ## 3. 作成と実行
88
+
89
+ ### 3.1. agentに成果物を量産させる
90
+
91
+ - ゴール: 計画済みタスクを agent に実行させ、レビューへ回す。
92
+ - 進め方: `pm-members.yaml` の agent と `.specdojo/exec-defaults.yaml` を用意し、`execution: agent` のフェーズで schedule を組む。`exec run --auto` で Ready 順に実行する。参照の深さは `approach` で切り替える。
93
+ - 主に使う文書: [exec設定ガイド](exec-config-guide.md)、[Schedule実行運用ガイド](schedule-operation-guide.md)、[実践の進め方ガイド](ryu-guide.md)。
94
+
95
+ ### 3.2. worktreeで隔離実行する
96
+
97
+ - ゴール: agent の変更を task 単位で隔離し、成功時だけ統合する。
98
+ - 進め方: 統合先ブランチにいることを確認し、`exec run --worktree`(または `--auto`)で実行する。段階ごとに確認する場合は分割コマンドを使う。
99
+ - 主に使う文書: [Quick Startガイド](quick-start-guide.md) の `(発展)worktreeで1タスクを隔離実行する`、[exec worktree運用ガイド](exec-worktree-guide.md)、[ブランチワークフローガイド](branch-workflow-guide.md)。
100
+
101
+ ### 3.3. 対話(チャット)で運用する
102
+
103
+ - ゴール: CLI を直接叩く代わりに、会話で計画・実行・状況確認を進める。
104
+ - 進め方: `npm run orch:sonnet` でオーケストレーターを起動し、やりたいことを自然文で伝える。状態を変える操作は提示・承認のうえ実行される。
105
+ - 主に使う文書: [オーケストレーター運用ガイド](orchestrator-operation-guide.md)、[遂行の技活用ガイド](waza-guide.md) の `代表フロー`。
106
+
107
+ ## 4. 管理・品質・運用
108
+
109
+ ### 4.1. レビューを回して成果物をreadyにする
110
+
111
+ - ゴール: 観点別レビューで完全性・整合性・妥当性を確認し、成果物を `ready` へ確定する。
112
+ - 進め方: `mode: review` のタスクで review plan / result を回し、指摘を扱う。`ready` への昇格は human が finalize タスクで行う。
113
+ - 主に使う文書: [レビューガイド](review-guide.md)、[exec運用ガイド](exec-operation-guide.md) の `humanタスクの実行`。
114
+
115
+ ### 4.2. 計画外の単発対応・調査を管理する
116
+
117
+ - ゴール: 進行中に発生した計画外の対応・調査・判断を、台帳として追跡する。
118
+ - 進め方: `register add` で登録し、agent 実行可能な type は `exec run --register` で対応する。成功後は人が確認して `register close` する。schedule の計画済み作業とは二重管理しない。
119
+ - 主に使う文書: [登録簿運用ガイド](register-operation-guide.md)、[exec運用ガイド](exec-operation-guide.md) の `実行経路の使い分け`。
120
+
121
+ ### 4.3. 定期実行を組む
122
+
123
+ - ゴール: 日次スイープや夜間バッチなど、時刻条件で繰り返す作業を自動化する。
124
+ - 進め方: `rtn-*.yaml` に register 実行または schedule 実行を定義し、外部スケジューラから `routine run --due` を冪等に呼ぶ。
125
+ - 主に使う文書: [routine運用ガイド](routine-operation-guide.md)。
126
+
127
+ 既存の未完了項目を繰り返し探索する場合は `job-register-sweep` / `job-exec-auto` を使います。期間ごとに新しい実行単位を作る週報や、前回成功時点以降の差分を処理する翻訳も、routineの`action.kind: job`とJob checkpointを使います。定義と実行方法は[Job実行設計](../../product/040-system-design/sysd-job-execution.md)を参照してください。
128
+
129
+ ### 4.4. 複数プロジェクト・ブランチを並行する
130
+
131
+ - ゴール: 複数の `prj-xxxx` や worktree を同じリポジトリで安全に並行運用する。
132
+ - 進め方: project `develop` を軸に feature / exec のブランチを分離し、統合方向と同期手順を守る。worktree のベース取り込みはベースブランチを明示する。
133
+ - 主に使う文書: [ブランチワークフローガイド](branch-workflow-guide.md)、[exec worktree運用ガイド](exec-worktree-guide.md)。
@@ -0,0 +1,224 @@
1
+ ---
2
+ specdojo:
3
+ id: specdojo:waza-guide
4
+ type: guide
5
+ status: ready
6
+ ---
7
+
8
+ # 遂行の技活用ガイド
9
+
10
+ Waza Guide
11
+
12
+ `specdojo` CLI の全体像、初期設定、代表的な実行フローを説明します。個別コマンドの詳細は [CLIコマンドリファレンス](../references/command-reference.md) を参照します。
13
+
14
+ SpecDojo は道場のメタファーとして、`specdojo` CLI のコマンド群を「Waza(遂行の技)」と呼びます。「Waza」は本ガイドで CLI 全体像を説明するための愛称・分類であり、CLI のコマンド名(`specdojo exec run` など)や frontmatter のフィールド名を変更するものではありません。実際のコマンド名・フィールド名は従来どおりです。
15
+
16
+ **対象読者**
17
+
18
+ - SpecDojo CLI を導入し、成果物の計画・生成・実行管理を始める利用者
19
+
20
+ **この文書で分かること**
21
+
22
+ - CLI の役割、標準ディレクトリ、初期設定、project の解決順序、代表的な実行フロー
23
+
24
+ **次に読む文書**
25
+
26
+ - 初期設定から1タスクの完了まで試す場合は [Quick Startガイド](quick-start-guide.md) を参照してください。
27
+ - 計画設計は [Schedule設計ガイド](schedule-design-guide.md)、コマンド詳細は [CLIコマンドリファレンス](../references/command-reference.md) を参照してください。
28
+
29
+ ## 1. CLIの役割
30
+
31
+ `specdojo` は Git リポジトリ内でプロジェクト実行管理を行う CLI です。主に次のファイル群を扱います。
32
+
33
+ | 対象 | 代表ファイル | 主なコマンド |
34
+ | -------------------------- | -------------------------- | -------------- |
35
+ | 成果物カタログ | `dct-*.yaml` | `catalog` |
36
+ | 成果物ファイル | `prj-charter.md` など | `deliverable` |
37
+ | Schedule | `sch-*.yaml` | `schedule` |
38
+ | 実行イベント | `exec/events/*.json` | `exec` |
39
+ | 実行生成物 | `generated/*` | `exec refresh` |
40
+ | プロジェクト登録簿 | `generated/pjr-index.md` | `register` |
41
+ | 定期実行定義 | `rtn-*.yaml` | `routine` |
42
+ | ドキュメントIDインデックス | `.specdojo/doc-index.json` | `index` |
43
+
44
+ ### 1.1. 生成系動詞の標準
45
+
46
+ 生成や実行を伴うコマンドは、出力の性質と副作用に応じて次の動詞を使います。
47
+
48
+ | 動詞 | 用途 | 再実行と上書きの原則 | 代表例 |
49
+ | ---------- | ------------------------------------------------------------ | ------------------------------------------------------------ | ------------------------------------------ |
50
+ | `scaffold` | 人が編集する正本や設定の初期雛形を作る | 既存ファイルを既定で保護し、上書きは `--force` で明示する | `catalog scaffold`、`deliverable scaffold` |
51
+ | `build` | 正本から再現可能な派生物を組み立てる | 同じ入力から繰り返し生成でき、派生物の置換を許容する | `catalog build`、`schedule build`、`build` |
52
+ | `refresh` | イベントやScheduleから変化する実行状態スナップショットを更新 | 実行履歴や正本を変更せず、現在状態を安全に再計算する | `exec refresh` |
53
+ | `run` | タスク、routine、agentなどの処理を実際に実行する | 状態遷移、外部プロセス起動、成果物編集などの副作用を許容する | `exec run`、`routine run` |
54
+
55
+ `scaffold` と `build` の違いは、生成後のファイルを人が正本として編集するか、入力から再生成できる派生物かです。`refresh` は build 可能な一般成果物ではなく、イベントを反映して時点ごとに変わる実行状態に限定します。`run` はファイル生成そのものではなく、処理の遂行を表します。
56
+
57
+ ## 2. 標準ディレクトリ構成
58
+
59
+ プロジェクト文書は `docs/ja/projects/<project-id>/` 配下に置きます。代表的な構成は次のとおりです。
60
+
61
+ ```text
62
+ repo-root/
63
+ ├─ .specdojo/
64
+ │ └─ specdojo.config.json
65
+ ├─ docs/
66
+ │ └─ ja/
67
+ │ ├─ specdojo/
68
+ │ │ ├─ guides/
69
+ │ │ ├─ rulebooks/
70
+ │ │ ├─ templates/
71
+ │ │ └─ exec-templates/
72
+ │ └─ projects/
73
+ │ └─ prj-0001/
74
+ │ ├─ 010-deliverables-catalog/
75
+ │ │ ├─ dct-index.yaml
76
+ │ │ ├─ dct-*.yaml
77
+ │ │ └─ generated/dct-index.md
78
+ │ ├─ 030-project-management/
79
+ │ ├─ schedule/
80
+ │ │ ├─ sch-milestones.yaml
81
+ │ │ ├─ sch-defaults.yaml
82
+ │ │ ├─ sch-strategy-<track>.yaml
83
+ │ │ └─ sch-track-<track>.yaml
84
+ │ ├─ routines/
85
+ │ │ └─ rtn-*.yaml
86
+ │ ├─ jobs/
87
+ │ │ └─ job-*.yaml
88
+ │ ├─ controls/
89
+ │ │ ├─ project-register/
90
+ │ │ └─ reviews/
91
+ │ └─ execution/
92
+ │ ├─ exec/
93
+ │ │ ├─ events/
94
+ │ │ ├─ plans/
95
+ │ │ ├─ results/
96
+ │ │ └─ .locks/
97
+ │ └─ generated/
98
+ └─ tools/
99
+ ```
100
+
101
+ 実際のパスは `.specdojo/specdojo.config.json` の project 設定で変更できます。ファイル単位の完全なディレクトリ構成は [ディレクトリレイアウトリファレンス](../references/directory-layout-reference.md) を参照してください。
102
+
103
+ ## 3. 初期設定
104
+
105
+ このリポジトリでは `npm install` 後に root package の `src/` がビルドされ、VS Code 統合ターミナルでは `node_modules/.bin` が `PATH` に追加されます。新しいターミナルを開けば、通常は `specdojo` を直接実行できます。
106
+
107
+ ```bash
108
+ npm install
109
+ specdojo config init
110
+ ```
111
+
112
+ VS Code 統合ターミナル以外では、必要に応じて次のように実行します。
113
+
114
+ ```bash
115
+ ./node_modules/.bin/specdojo config init
116
+ ```
117
+
118
+ ## 4. プロジェクト設定
119
+
120
+ `.specdojo/specdojo.config.json` は複数プロジェクトを扱うためのレジストリです。
121
+
122
+ ```json
123
+ {
124
+ "version": 1,
125
+ "current_project": "prj-0001",
126
+ "projects": {
127
+ "prj-0001": {
128
+ "base_path": "docs/ja/projects/prj-0001",
129
+ "catalog_path": "010-deliverables-catalog",
130
+ "schedule_path": "schedule",
131
+ "execution_path": "execution",
132
+ "project_register_path": "controls/project-register",
133
+ "routines_path": "routines",
134
+ "jobs_path": "jobs",
135
+ "members_path": "030-project-management/pm-members.yaml",
136
+ "viewpoints_path": "030-project-management/pm-review-viewpoints.yaml",
137
+ "project_context": ["prj-overview"],
138
+ "run": {
139
+ "exec_defaults": ".specdojo/exec-defaults.yaml"
140
+ }
141
+ }
142
+ }
143
+ }
144
+ ```
145
+
146
+ `base_path` を指定すると、`catalog_path`、`schedule_path`、`execution_path` などを `base_path` からの相対パスとして書けます。`run.exec_defaults` と `run.worktree_base` はリポジトリルート相対のまま扱います。`run.exec_defaults` が指すファイルの中身(エージェント、provider、権限、リトライ)は [exec設定ガイド](exec-config-guide.md) を参照します。
147
+
148
+ `project_context` は、`depends_on` と独立して成果物の edit / review plan に渡すプロジェクト共通文書の ID リストです。省略時は `["prj-overview"]`、空配列 `[]` は opt-out を表します。project context は plan の参照範囲にだけ作用し、schedule、`based_on`、commit scope は変更しません。
149
+
150
+ ## 5. プロジェクト解決順序
151
+
152
+ プロジェクトに紐づくコマンドは、次の順序で対象 project を解決します。
153
+
154
+ 1. `--project <id>`
155
+ 2. `SPECDOJO_PROJECT`
156
+ 3. `.specdojo/specdojo.config.json` の `current_project`
157
+ 4. `.specdojo/specdojo.config.json` の `projects` に定義された先頭 project
158
+
159
+ 通常は `current_project` を使います。ブランチや worktree ごとに `.specdojo/specdojo.config.json` を Git 管理すれば、`.env` のコピーは不要です。
160
+
161
+ ## 6. 代表フロー
162
+
163
+ 新規プロジェクトの基本フローは次のとおりです。
164
+
165
+ ```bash
166
+ # 1. 設定を作成する
167
+ specdojo config init
168
+
169
+ # 2. 未整理の課題・判断があれば登録簿で整理する
170
+ specdojo register scaffold --project prj-0001
171
+
172
+ # 3. 成果物カタログを作成・検証する
173
+ specdojo catalog scaffold --project prj-0001 --size small
174
+ specdojo catalog validate --project prj-0001
175
+
176
+ # 3.1 カタログが指す成果物ファイル本体を一括生成する
177
+ specdojo deliverable scaffold --project prj-0001
178
+ specdojo catalog build --project prj-0001
179
+
180
+ # 4. sch-strategy-launch.yaml を用意し、track schedule を生成する
181
+ specdojo schedule build --project prj-0001 --track launch --force
182
+
183
+ # 5. 実行状態、Ready、CPMを生成する
184
+ specdojo exec refresh --project prj-0001
185
+
186
+ # 6. pm-members.yaml と provider 設定を用意して Readyタスクを実行する
187
+ specdojo exec run --project prj-0001 --auto --parallel 5
188
+ ```
189
+
190
+ 全生成物をまとめて更新したい場合は `specdojo build` を使います。
191
+
192
+ ```bash
193
+ specdojo build --project prj-0001
194
+ ```
195
+
196
+ register から成果物カタログへ移す手順は [Quick Startガイド](quick-start-guide.md)、成果物カタログのどの情報が Schedule のどのタスクになるかは [Schedule設計ガイド](schedule-design-guide.md) の `成果物カタログとの責務分担`、agent の最小設定は [exec設定ガイド](exec-config-guide.md) を参照します。
197
+
198
+ ### 6.1. deliverable scaffold の生成方針
199
+
200
+ `catalog scaffold` は `--size` で選んだ成果物セットで `dct-*.yaml` を生成し、`deliverable scaffold` はその `dct-*.yaml` を辿って成果物ファイル本体(`prj-charter.md` など)を一括生成します。カタログ自体がサイズ別に生成済みのため、`deliverable scaffold` はプロジェクトのサイズ相当の成果物集合をまとめて材料化します。
201
+
202
+ 成果物ごとの生成方針は次のとおりです。
203
+
204
+ | 条件 | 生成内容 |
205
+ | ----------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
206
+ | rulebook が template の文書 ID を宣言 | 宣言 ID の `*-template.md` / `*-template.yaml` から生成する。同じ rulebook 系統は template を共有できる。`frontmatter_template` を平坦化し、カタログから確定できる予約済み生成時プレースホルダを置換する(`_TODO_` などの記入プレースホルダは残す) |
207
+ | `template: not-needed` / `undecided` / 項目省略 | `local_id` の命名規約では探索せず、カタログ情報から埋められる範囲で最小雛形を生成する(`id` / `type` / `status` / `rulebook` / `depends_on` 由来の `based_on` を持つ Frontmatter、`name` の H1、`overview` 本文、記入用の `_TODO_` 行) |
208
+ | すでにファイルが存在する | 上書きしない(`--force` を指定した場合のみ上書きする) |
209
+
210
+ template の要否と所在は rulebook frontmatter が正本です。`local_id` と同名の template が存在しても、rulebook が文書 ID を宣言していなければ使用しません。予約済み生成時プレースホルダは `_PROJECT_ID_`、`_LOCAL_ID_`、`_DELIVERABLE_NAME_`、`_DELIVERABLE_OVERVIEW_`、`_BASED_ON_` です。
211
+
212
+ `deliverable scaffold` は成果物本体を一度だけ材料化し、以後は人手で記入・編集します。そのため、冪等な再生成をまとめる `specdojo build` には含めません(`build` に含めると記入済みの本文を上書きしてしまうため)。プロジェクト初期化時に `catalog scaffold` → `catalog validate` の後で 1 回だけ実行します。
213
+
214
+ 対象を特定のカタログに絞る場合は `--dct <name>` を使います。オプションの詳細は [CLIコマンドリファレンス](../references/command-reference.md) を参照します。
215
+
216
+ ## 7. 定期実行と登録項目の実行
217
+
218
+ register は立ち上げ時の未整理事項と進行中の計画外事項を扱い、schedule は成果物カタログから展開した計画済み作業を扱います。Jobは入力ごとに新しい反復作業のRunを生成し、routineはこれらを時刻条件で起動します。コマンドの詳細は [CLIコマンドリファレンス](../references/command-reference.md) を、使い分けは [exec運用ガイド](exec-operation-guide.md) の `実行経路の使い分け` を参照します。
219
+
220
+ | 機能 | 概要 |
221
+ | --------------------- | --------------------------------------------------------------------------------------------------------------------------------- |
222
+ | `routine` | `rtn-*.yaml` の定義に基づき、時刻条件でタスクを定期実行する。外部スケジューラから `routine run --due` を冪等に呼び出す |
223
+ | `exec run --register` | 登録簿(`generated/pjr-index.md`)の項目を agent に実行させる。状態は register の遷移(in-progress / review / waiting)で追跡する |
224
+ | `exec run --job` | `job-*.yaml`から入力とcheckpointを解決し、一意なJob Runを生成してagentに実行させる |
@@ -0,0 +1,33 @@
1
+ # SpecDojo 実践体系
2
+
3
+ SpecDojo が提供する実践体系の入口です。ここには成果物そのものではなく、成果物を作成・検証・更新するための文書を置きます。
4
+
5
+ ## 1. 最初に読む文書
6
+
7
+ 全体像から読む場合は [全体概要ガイド](./guides/specdojo-overview-guide.md) から始めてください。まず一度手を動かす場合は [Quick Startガイド](./guides/quick-start-guide.md)、やりたいことから進め方を探す場合は [ユースケース別ガイド](./guides/use-case-guide.md)、目的から guide と reference を探す場合は、全体概要ガイドの `目的別の次の読み物` を参照します。
8
+
9
+ | 目的 | 参照先 |
10
+ | ---------------------------------------- | ------------------------------------------------------------ |
11
+ | SpecDojo 全体の構成と流れを知る | [全体概要ガイド](./guides/specdojo-overview-guide.md) |
12
+ | まず一度、最短で手を動かす | [Quick Startガイド](./guides/quick-start-guide.md) |
13
+ | やりたいことから進め方を探す | [ユースケース別ガイド](./guides/use-case-guide.md) |
14
+ | 成果物の種類、目的、書き方の正本を調べる | [成果物リファレンス](./references/deliverables-reference.md) |
15
+ | CLI のコマンドとオプションを調べる | [CLIコマンドリファレンス](./references/command-reference.md) |
16
+ | 文書の分類と配置を確認する | [ドキュメント構成ガイド](./guides/docs-structure-guide.md) |
17
+ | トラックの構成と実行順序を設計する | [トラック設計ガイド](./guides/track-design-guide.md) |
18
+
19
+ ## 2. 資料の配置
20
+
21
+ | ディレクトリ | 置いてある資料 |
22
+ | ----------------- | -------------------------------- |
23
+ | `philosophy/` | 規約の前提となる方針・概念 |
24
+ | `guides/` | 全体像、判断方法、操作手順 |
25
+ | `references/` | 成果物、コマンドなどの一覧・比較 |
26
+ | `standards/` | 文書種別を横断する共通規約 |
27
+ | `rulebooks/` | 成果物ごとの記述規則 |
28
+ | `recipes/` | 成果物を作成・更新する手順と判断 |
29
+ | `templates/` | 成果物の雛形 |
30
+ | `samples/` | 成果物の記述例 |
31
+ | `exec-templates/` | plan / result 生成用の内部雛形 |
32
+
33
+ 種別ごとに答える問いの違い、責務分担、exec plan からの参照方法は [実践の型活用ガイド](./guides/kata-guide.md) を参照します。