specdojo 0.6.0 → 0.8.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 (366) hide show
  1. package/.github/agents/specdojo-orchestrator.md +3 -2
  2. package/CHANGELOG.md +193 -0
  3. package/README.md +2 -2
  4. package/dist/catalog/build.js +24 -1
  5. package/dist/catalog/plan.js +1 -1
  6. package/dist/catalog/scaffold.js +4 -1
  7. package/dist/commands/agent.js +33 -0
  8. package/dist/commands/init.js +6 -1
  9. package/dist/commands/night-orchestrator.js +6 -4
  10. package/dist/commands/orchestrator.js +10 -1
  11. package/dist/dashboard/dashboard-timeline.js +18 -16
  12. package/dist/dashboard/dashboard.js +612 -259
  13. package/dist/dashboard/epic-plan.js +81 -0
  14. package/dist/dashboard/exec-records.js +16 -20
  15. package/dist/dashboard/routines.js +8 -6
  16. package/dist/dashboard/timeline-build.js +5 -9
  17. package/dist/dashboard/timeline.js +9 -4
  18. package/dist/devcontainer/command.js +18 -0
  19. package/dist/devcontainer/host-script.js +21 -0
  20. package/dist/devcontainer/scaffold.js +22 -3
  21. package/dist/docs/frontmatter-namespace.js +1 -48
  22. package/dist/docs/yaml-pages.js +125 -3
  23. package/dist/exec/agent-config.js +22 -0
  24. package/dist/exec/agent-plan.js +3 -2
  25. package/dist/exec/antigravity-session.js +154 -0
  26. package/dist/exec/commands.js +69 -21
  27. package/dist/exec/commit-hook-skips.js +78 -0
  28. package/dist/exec/core.js +19 -7
  29. package/dist/exec/events.js +159 -8
  30. package/dist/exec/evidence.js +64 -16
  31. package/dist/exec/handoff.js +9 -13
  32. package/dist/exec/limit.js +1 -1
  33. package/dist/exec/mechanical-result.js +45 -0
  34. package/dist/exec/migrate-records.js +249 -0
  35. package/dist/exec/parent-validation.js +160 -12
  36. package/dist/exec/pipeline-state.js +27 -5
  37. package/dist/exec/plan-markdownlint.js +89 -0
  38. package/dist/exec/plans-condense-findings.js +89 -0
  39. package/dist/exec/plans-core.js +24 -17
  40. package/dist/exec/plans-generation.js +52 -25
  41. package/dist/exec/plans-grade-findings.js +8 -3
  42. package/dist/exec/plans-kata-findings.js +61 -0
  43. package/dist/exec/plans-planning.js +3 -3
  44. package/dist/exec/plans-storage.js +12 -24
  45. package/dist/exec/register-resume.js +69 -42
  46. package/dist/exec/register.js +26 -22
  47. package/dist/exec/repo-integration-sync.js +8 -4
  48. package/dist/exec/repo-integration.js +21 -1
  49. package/dist/exec/reporter.js +121 -23
  50. package/dist/exec/results.js +85 -24
  51. package/dist/exec/review-completion.js +47 -0
  52. package/dist/exec/review-kata.js +109 -0
  53. package/dist/exec/run/agent-pipeline.js +75 -6
  54. package/dist/exec/run/agent.js +20 -7
  55. package/dist/exec/run/in-place.js +69 -32
  56. package/dist/exec/run/job.js +81 -24
  57. package/dist/exec/run/lifecycle-commands.js +264 -43
  58. package/dist/exec/run/mode-shared.js +11 -3
  59. package/dist/exec/run/register-command.js +12 -10
  60. package/dist/exec/run/register-core.js +20 -13
  61. package/dist/exec/run/register-mode.js +12 -12
  62. package/dist/exec/run/register-post-review.js +21 -9
  63. package/dist/exec/run/register-resume.js +28 -18
  64. package/dist/exec/run/register-state.js +10 -7
  65. package/dist/exec/run/register-worktree.js +60 -30
  66. package/dist/exec/run/schedule-mode.js +26 -6
  67. package/dist/exec/run/schedule-prepare.js +228 -45
  68. package/dist/exec/run/schedule-task.js +132 -25
  69. package/dist/exec/run/shared.js +4 -3
  70. package/dist/exec/run/trailing-records.js +35 -0
  71. package/dist/exec/run-records.js +2 -0
  72. package/dist/exec/strategy.js +1 -0
  73. package/dist/exec/trailing-records.js +242 -0
  74. package/dist/exec/trial-commands.js +3 -2
  75. package/dist/exec/validate-records-commit.js +110 -0
  76. package/dist/exec/validate-records.js +148 -0
  77. package/dist/exec/worktree-command.js +29 -16
  78. package/dist/exec/worktree-ops-commit.js +118 -59
  79. package/dist/exec/worktree-ops-lifecycle.js +77 -44
  80. package/dist/exec/worktree-ops-merge.js +13 -2
  81. package/dist/exec/worktree-ops.js +2 -2
  82. package/dist/exec/worktree.js +19 -2
  83. package/dist/grade/apply.js +32 -6
  84. package/dist/grade/command-inspect.js +2 -2
  85. package/dist/grade/command-run.js +2 -0
  86. package/dist/grade/command-shared.js +1 -1
  87. package/dist/grade/core.js +18 -5
  88. package/dist/grade/markdown.js +3 -3
  89. package/dist/grade/pipeline-state.js +15 -11
  90. package/dist/grade/plan.js +37 -17
  91. package/dist/grade/result.js +3 -3
  92. package/dist/grade/run.js +23 -3
  93. package/dist/grade/target-discovery.js +17 -4
  94. package/dist/grade/targets.js +12 -11
  95. package/dist/job/job.js +31 -17
  96. package/dist/job/noop.js +104 -0
  97. package/dist/register/core.js +2 -0
  98. package/dist/register/create-commands.js +28 -3
  99. package/dist/register/deliverable-target.js +9 -1
  100. package/dist/register/epic.js +104 -26
  101. package/dist/register/event-merge.js +3 -0
  102. package/dist/register/events.js +4 -0
  103. package/dist/register/external-project.js +3 -0
  104. package/dist/register/item.js +6 -0
  105. package/dist/register/maintenance-commands.js +4 -1
  106. package/dist/register/planning.js +7 -14
  107. package/dist/register/register.js +74 -32
  108. package/dist/register/track-domains.js +34 -0
  109. package/dist/register/track-plan.js +78 -0
  110. package/dist/register/transition-commands.js +8 -0
  111. package/dist/register/work-table.js +64 -0
  112. package/dist/review/grade.js +35 -13
  113. package/dist/routine/definition.js +4 -3
  114. package/dist/routine/failure.js +30 -0
  115. package/dist/routine/routine.js +56 -32
  116. package/dist/routine/storage.js +33 -0
  117. package/dist/schedule/schedule.js +1 -0
  118. package/dist/schedule/strategy-generate-document.js +26 -14
  119. package/dist/schedule/strategy-generate-scope.js +17 -45
  120. package/dist/schedule/strategy-generate.js +33 -3
  121. package/dist/schedule/strategy-profiles.js +86 -12
  122. package/dist/shared/agent-types.js +2 -0
  123. package/dist/shared/condense-records.js +25 -0
  124. package/dist/shared/deprecation.js +8 -0
  125. package/dist/shared/document-metadata.js +20 -0
  126. package/dist/shared/finding-cause.js +20 -0
  127. package/dist/shared/frontmatter-namespace.js +48 -0
  128. package/dist/shared/git.js +149 -15
  129. package/dist/shared/grade-result.js +17 -1
  130. package/dist/shared/local-state.js +20 -0
  131. package/dist/shared/markdownlint-config.js +8 -3
  132. package/dist/shared/plan-conventions.js +129 -0
  133. package/dist/shared/plan-templates.js +57 -41
  134. package/dist/shared/provider-scaffold.js +2 -0
  135. package/dist/shared/run-records.js +224 -0
  136. package/dist/shared/specdojo-config.js +39 -21
  137. package/dist/shared/specdojo-gitignore.js +1 -0
  138. package/dist/shared/text.js +65 -5
  139. package/dist/shared/timeline-index.js +2 -0
  140. package/docs/ja/specdojo/defaults/pm-review-viewpoints.yaml +11 -2
  141. package/docs/ja/specdojo/exec-templates/xep-common-conventions-template.md +4 -74
  142. package/docs/ja/specdojo/exec-templates/xep-condense-template.md +50 -0
  143. package/docs/ja/specdojo/exec-templates/xep-draft-template.md +17 -5
  144. package/docs/ja/specdojo/exec-templates/xep-fully-guided-template.md +16 -3
  145. package/docs/ja/specdojo/exec-templates/xep-recipe-guided-template.md +15 -5
  146. package/docs/ja/specdojo/exec-templates/xep-recipe-maintenance-template.md +6 -0
  147. package/docs/ja/specdojo/exec-templates/xep-register-template.md +1 -1
  148. package/docs/ja/specdojo/exec-templates/xep-rulebook-maintenance-template.md +6 -0
  149. package/docs/ja/specdojo/exec-templates/xep-sample-maintenance-template.md +6 -0
  150. package/docs/ja/specdojo/exec-templates/xep-template-maintenance-template.md +6 -0
  151. package/docs/ja/specdojo/exec-templates/xer-condense-template.md +25 -0
  152. package/docs/ja/specdojo/exec-templates/xp-common-conventions-template.md +50 -0
  153. package/docs/ja/specdojo/exec-templates/xrp-common-conventions-template.md +30 -0
  154. package/docs/ja/specdojo/guides/branch-workflow-guide.md +1 -1
  155. package/docs/ja/specdojo/guides/docs-editing-guide.md +48 -0
  156. package/docs/ja/specdojo/guides/docs-structure-guide.md +48 -15
  157. package/docs/ja/specdojo/guides/exec-config-guide.md +61 -28
  158. package/docs/ja/specdojo/guides/exec-operation-guide.md +61 -13
  159. package/docs/ja/specdojo/guides/exec-worktree-guide.md +20 -11
  160. package/docs/ja/specdojo/guides/orchestrator-operation-guide.md +4 -2
  161. package/docs/ja/specdojo/guides/plan-result-lifecycle-guide.md +92 -55
  162. package/docs/ja/specdojo/guides/project-move-guide.md +381 -0
  163. package/docs/ja/specdojo/guides/quick-start-guide.md +589 -807
  164. package/docs/ja/specdojo/guides/register-operation-guide.md +26 -4
  165. package/docs/ja/specdojo/guides/remote-host-development-guide.md +33 -4
  166. package/docs/ja/specdojo/guides/review-guide.md +22 -19
  167. package/docs/ja/specdojo/guides/routine-operation-guide.md +14 -8
  168. package/docs/ja/specdojo/guides/ryu-guide.md +23 -13
  169. package/docs/ja/specdojo/guides/schedule-design-guide.md +7 -4
  170. package/docs/ja/specdojo/guides/schedule-operation-guide.md +41 -3
  171. package/docs/ja/specdojo/guides/specdojo-overview-guide.md +5 -4
  172. package/docs/ja/specdojo/guides/timeline-design-guide.md +27 -144
  173. package/docs/ja/specdojo/guides/use-case-guide.md +471 -74
  174. package/docs/ja/specdojo/recipes/bac-recipe.md +94 -0
  175. package/docs/ja/specdojo/recipes/bes-recipe.md +105 -0
  176. package/docs/ja/specdojo/recipes/br-recipe.md +84 -0
  177. package/docs/ja/specdojo/recipes/cdfd-overview-recipe.md +88 -86
  178. package/docs/ja/specdojo/recipes/cdfd-uc-recipe.md +108 -122
  179. package/docs/ja/specdojo/recipes/cnd-recipe.md +125 -0
  180. package/docs/ja/specdojo/recipes/cpd-recipe.md +126 -0
  181. package/docs/ja/specdojo/recipes/cxd-recipe.md +145 -0
  182. package/docs/ja/specdojo/recipes/ifd-recipe.md +134 -0
  183. package/docs/ja/specdojo/recipes/ifx-cmd-recipe.md +135 -86
  184. package/docs/ja/specdojo/recipes/ifx-index-recipe.md +130 -0
  185. package/docs/ja/specdojo/recipes/pm-organization-recipe.md +29 -26
  186. package/docs/ja/specdojo/recipes/pm-plan-recipe.md +35 -26
  187. package/docs/ja/specdojo/recipes/pm-quality-management-plan-recipe.md +38 -28
  188. package/docs/ja/specdojo/recipes/pm-raci-recipe.md +39 -31
  189. package/docs/ja/specdojo/recipes/pm-roles-recipe.md +26 -28
  190. package/docs/ja/specdojo/recipes/prj-assumptions-constraints-dependencies-recipe.md +10 -8
  191. package/docs/ja/specdojo/recipes/prj-comparison-of-alternatives-recipe.md +18 -17
  192. package/docs/ja/specdojo/recipes/stsd-recipe.md +100 -62
  193. package/docs/ja/specdojo/recipes/sysd-critical-flows-recipe.md +106 -0
  194. package/docs/ja/specdojo/recipes/sysd-cross-cutting-policy-recipe.md +137 -0
  195. package/docs/ja/specdojo/recipes/sysd-index-recipe.md +122 -0
  196. package/docs/ja/specdojo/references/command-reference.md +146 -99
  197. package/docs/ja/specdojo/references/deliverables-reference.md +9 -4
  198. package/docs/ja/specdojo/references/directory-layout-reference.md +3 -2
  199. package/docs/ja/specdojo/references/specdojo-config-reference.md +17 -16
  200. package/docs/ja/specdojo/rulebooks/bac-rulebook.md +72 -290
  201. package/docs/ja/specdojo/rulebooks/bdd-rulebook.md +212 -79
  202. package/docs/ja/specdojo/rulebooks/bds-rulebook.md +138 -154
  203. package/docs/ja/specdojo/rulebooks/bes-index-rulebook.md +147 -59
  204. package/docs/ja/specdojo/rulebooks/bes-rulebook.md +100 -96
  205. package/docs/ja/specdojo/rulebooks/br-rulebook.md +88 -108
  206. package/docs/ja/specdojo/rulebooks/ccd-mermaid-rulebook.md +126 -211
  207. package/docs/ja/specdojo/rulebooks/cdfd-d2-rulebook.md +367 -0
  208. package/docs/ja/specdojo/rulebooks/cdfd-mermaid-rulebook.md +6 -5
  209. package/docs/ja/specdojo/rulebooks/cdfd-overview-rulebook.md +96 -100
  210. package/docs/ja/specdojo/rulebooks/cdfd-rulebook.md +38 -47
  211. package/docs/ja/specdojo/rulebooks/cdfd-uc-rulebook.md +132 -106
  212. package/docs/ja/specdojo/rulebooks/cdsd-rulebook.md +102 -68
  213. package/docs/ja/specdojo/rulebooks/cdt-rulebook.md +152 -0
  214. package/docs/ja/specdojo/rulebooks/cld-rulebook.md +9 -184
  215. package/docs/ja/specdojo/rulebooks/clis-rulebook.md +187 -0
  216. package/docs/ja/specdojo/rulebooks/cnd-rulebook.md +93 -247
  217. package/docs/ja/specdojo/rulebooks/cpd-rulebook.md +104 -241
  218. package/docs/ja/specdojo/rulebooks/cxd-rulebook.md +124 -257
  219. package/docs/ja/specdojo/rulebooks/dct-index-rulebook.md +87 -98
  220. package/docs/ja/specdojo/rulebooks/dct-rulebook.md +9 -7
  221. package/docs/ja/specdojo/rulebooks/dec-rulebook.md +2 -1
  222. package/docs/ja/specdojo/rulebooks/dss-rulebook.md +193 -0
  223. package/docs/ja/specdojo/rulebooks/gl-rulebook.md +100 -54
  224. package/docs/ja/specdojo/rulebooks/ifd-mermaid-rulebook.md +69 -252
  225. package/docs/ja/specdojo/rulebooks/ifx-cmd-rulebook.md +91 -76
  226. package/docs/ja/specdojo/rulebooks/ifx-file-rulebook.md +252 -226
  227. package/docs/ja/specdojo/rulebooks/ifx-index-rulebook.md +118 -40
  228. package/docs/ja/specdojo/rulebooks/imp-business-rulebook.md +11 -11
  229. package/docs/ja/specdojo/rulebooks/imp-data-rulebook.md +9 -9
  230. package/docs/ja/specdojo/rulebooks/imp-interface-rulebook.md +4 -4
  231. package/docs/ja/specdojo/rulebooks/imp-operations-rulebook.md +11 -11
  232. package/docs/ja/specdojo/rulebooks/imp-test-rulebook.md +11 -11
  233. package/docs/ja/specdojo/rulebooks/mm-rulebook.md +4 -3
  234. package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +34 -29
  235. package/docs/ja/specdojo/rulebooks/pm-change-request-log-rulebook.md +8 -8
  236. package/docs/ja/specdojo/rulebooks/pm-issue-log-rulebook.md +2 -2
  237. package/docs/ja/specdojo/rulebooks/pm-organization-rulebook.md +50 -56
  238. package/docs/ja/specdojo/rulebooks/pm-plan-rulebook.md +46 -55
  239. package/docs/ja/specdojo/rulebooks/pm-quality-management-plan-rulebook.md +57 -54
  240. package/docs/ja/specdojo/rulebooks/pm-raci-rulebook.md +50 -65
  241. package/docs/ja/specdojo/rulebooks/pm-risk-register-rulebook.md +2 -2
  242. package/docs/ja/specdojo/rulebooks/pm-roles-rulebook.md +70 -97
  243. package/docs/ja/specdojo/rulebooks/pr-rulebook.md +2 -1
  244. package/docs/ja/specdojo/rulebooks/prj-assumptions-constraints-dependencies-rulebook.md +47 -56
  245. package/docs/ja/specdojo/rulebooks/prj-comparison-of-alternatives-rulebook.md +61 -135
  246. package/docs/ja/specdojo/rulebooks/sf-index-rulebook.md +116 -32
  247. package/docs/ja/specdojo/rulebooks/sf-rulebook.md +118 -61
  248. package/docs/ja/specdojo/rulebooks/sld-rulebook.md +152 -57
  249. package/docs/ja/specdojo/rulebooks/stsd-mermaid-rulebook.md +51 -39
  250. package/docs/ja/specdojo/rulebooks/stsd-rulebook.md +101 -46
  251. package/docs/ja/specdojo/rulebooks/sysd-critical-flows-rulebook.md +72 -329
  252. package/docs/ja/specdojo/rulebooks/sysd-cross-cutting-policy-rulebook.md +74 -263
  253. package/docs/ja/specdojo/rulebooks/sysd-index-rulebook.md +78 -195
  254. package/docs/ja/specdojo/rulebooks/tml-rulebook.md +4 -9
  255. package/docs/ja/specdojo/rulebooks/trc-requirements-to-specs-rulebook.md +3 -4
  256. package/docs/ja/specdojo/rulebooks/trc-requirements-to-tests-rulebook.md +3 -3
  257. package/docs/ja/specdojo/rulebooks/uis-rulebook.md +140 -143
  258. package/docs/ja/specdojo/samples/bac-sample.md +106 -21
  259. package/docs/ja/specdojo/samples/bdd-sample.yaml +143 -35
  260. package/docs/ja/specdojo/samples/bds-sample.md +100 -21
  261. package/docs/ja/specdojo/samples/bes-index-sample.md +59 -20
  262. package/docs/ja/specdojo/samples/bes-sample.md +80 -21
  263. package/docs/ja/specdojo/samples/br-sample.md +68 -14
  264. package/docs/ja/specdojo/samples/ccd-sample.md +81 -19
  265. package/docs/ja/specdojo/samples/cdfd-overview-sample.md +248 -140
  266. package/docs/ja/specdojo/samples/cdfd-sample.md +172 -99
  267. package/docs/ja/specdojo/samples/cdfd-uc-sample.md +130 -97
  268. package/docs/ja/specdojo/samples/cdsd-sample.md +89 -20
  269. package/docs/ja/specdojo/samples/cdt-sample.md +116 -0
  270. package/docs/ja/specdojo/samples/cld-sample.md +3 -30
  271. package/docs/ja/specdojo/samples/clis-sample.md +132 -0
  272. package/docs/ja/specdojo/samples/cnd-sample.md +127 -21
  273. package/docs/ja/specdojo/samples/cpd-sample.md +136 -22
  274. package/docs/ja/specdojo/samples/cxd-sample.md +108 -22
  275. package/docs/ja/specdojo/samples/dct-index-sample.yaml +63 -17
  276. package/docs/ja/specdojo/samples/dss-sample.md +175 -0
  277. package/docs/ja/specdojo/samples/gl-sample.yaml +50 -14
  278. package/docs/ja/specdojo/samples/ifd-sample.md +105 -21
  279. package/docs/ja/specdojo/samples/ifx-cmd-sample.yaml +91 -60
  280. package/docs/ja/specdojo/samples/ifx-file-sample.md +462 -21
  281. package/docs/ja/specdojo/samples/ifx-index-sample.yaml +87 -19
  282. package/docs/ja/specdojo/samples/pm-members-sample.yaml +37 -13
  283. package/docs/ja/specdojo/samples/pm-organization-sample.md +52 -20
  284. package/docs/ja/specdojo/samples/pm-plan-sample.md +84 -26
  285. package/docs/ja/specdojo/samples/pm-quality-management-plan-sample.md +55 -22
  286. package/docs/ja/specdojo/samples/pm-raci-sample.md +69 -28
  287. package/docs/ja/specdojo/samples/pm-roles-sample.yaml +13 -12
  288. package/docs/ja/specdojo/samples/prj-assumptions-constraints-dependencies-sample.md +50 -26
  289. package/docs/ja/specdojo/samples/prj-comparison-of-alternatives-sample.md +89 -62
  290. package/docs/ja/specdojo/samples/sf-index-sample.md +89 -20
  291. package/docs/ja/specdojo/samples/sf-sample.md +121 -21
  292. package/docs/ja/specdojo/samples/sld-sample.md +107 -21
  293. package/docs/ja/specdojo/samples/stsd-sample.md +54 -26
  294. package/docs/ja/specdojo/samples/sysd-critical-flows-sample.md +166 -21
  295. package/docs/ja/specdojo/samples/sysd-cross-cutting-policy-sample.md +178 -21
  296. package/docs/ja/specdojo/samples/sysd-index-sample.md +82 -21
  297. package/docs/ja/specdojo/samples/tml-sample.yaml +4 -1
  298. package/docs/ja/specdojo/samples/uis-sample.md +164 -20
  299. package/docs/ja/specdojo/standards/document-metadata-standard.md +33 -4
  300. package/docs/ja/specdojo/standards/id-and-file-naming-standard.md +3 -1
  301. package/docs/ja/specdojo/standards/rulebook-authoring-standard.md +1 -0
  302. package/docs/ja/specdojo/templates/bac-template.md +76 -0
  303. package/docs/ja/specdojo/templates/bes-template.md +56 -0
  304. package/docs/ja/specdojo/templates/br-template.md +64 -0
  305. package/docs/ja/specdojo/templates/cdfd-overview-template.md +161 -83
  306. package/docs/ja/specdojo/templates/cdfd-template.md +81 -54
  307. package/docs/ja/specdojo/templates/cdfd-uc-template.md +130 -89
  308. package/docs/ja/specdojo/templates/cnd-template.md +137 -0
  309. package/docs/ja/specdojo/templates/cpd-template.md +129 -0
  310. package/docs/ja/specdojo/templates/cxd-template.md +105 -0
  311. package/docs/ja/specdojo/templates/dct-data-model-cdt-template.yaml +40 -0
  312. package/docs/ja/specdojo/templates/dct-data-model-cld-template.yaml +7 -14
  313. package/docs/ja/specdojo/templates/dct-index-template.md +9 -20
  314. package/docs/ja/specdojo/templates/dct-project-management-template.yaml +5 -1
  315. package/docs/ja/specdojo/templates/ifd-template.md +86 -0
  316. package/docs/ja/specdojo/templates/ifx-cmd-template.yaml +44 -28
  317. package/docs/ja/specdojo/templates/ifx-index-template.yaml +40 -0
  318. package/docs/ja/specdojo/templates/opr-template.md +2 -4
  319. package/docs/ja/specdojo/templates/pm-organization-template.md +9 -3
  320. package/docs/ja/specdojo/templates/pm-plan-template.md +4 -4
  321. package/docs/ja/specdojo/templates/pm-quality-management-plan-template.md +17 -9
  322. package/docs/ja/specdojo/templates/pm-raci-template.md +24 -13
  323. package/docs/ja/specdojo/templates/pm-roles-template.yaml +3 -2
  324. package/docs/ja/specdojo/templates/prj-assumptions-constraints-dependencies-template.md +6 -3
  325. package/docs/ja/specdojo/templates/prj-comparison-of-alternatives-template.md +22 -19
  326. package/docs/ja/specdojo/templates/stsd-template.md +46 -21
  327. package/docs/ja/specdojo/templates/sysd-critical-flows-template.md +94 -0
  328. package/docs/ja/specdojo/templates/sysd-cross-cutting-policy-template.md +122 -0
  329. package/docs/ja/specdojo/templates/sysd-index-template.md +89 -0
  330. package/docs/specdojo/lib/yaml-metadata.cjs +7 -0
  331. package/docs/specdojo/schemas/v1/bdd.schema.yaml +25 -57
  332. package/docs/specdojo/schemas/v1/condense-records.schema.yaml +26 -0
  333. package/docs/specdojo/schemas/v1/dct.schema.yaml +10 -0
  334. package/docs/specdojo/schemas/v1/deliverable-frontmatter.schema.yaml +3 -0
  335. package/docs/specdojo/schemas/v1/esil.schema.yaml +7 -141
  336. package/docs/specdojo/schemas/v1/exec-common.schema.yaml +3 -0
  337. package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +54 -3
  338. package/docs/specdojo/schemas/v1/exec-evidence.schema.yaml +3 -0
  339. package/docs/specdojo/schemas/v1/exec-plan-frontmatter.schema.yaml +14 -0
  340. package/docs/specdojo/schemas/v1/exec-result-frontmatter.schema.yaml +18 -0
  341. package/docs/specdojo/schemas/v1/finding-cause.schema.yaml +22 -0
  342. package/docs/specdojo/schemas/v1/grade-pipeline-state.schema.yaml +1 -1
  343. package/docs/specdojo/schemas/v1/grade-result.schema.yaml +2 -0
  344. package/docs/specdojo/schemas/v1/ifx-cmd.schema.yaml +65 -5
  345. package/docs/specdojo/schemas/v1/ifx-index.schema.yaml +142 -0
  346. package/docs/specdojo/schemas/v1/register-events.schema.yaml +2 -0
  347. package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +17 -1
  348. package/docs/specdojo/schemas/v1/specdojo-config.schema.yaml +1 -0
  349. package/package.json +6 -3
  350. package/templates/antigravity/README.md +19 -46
  351. package/templates/antigravity/exec-defaults-snippet.yaml +5 -6
  352. package/templates/antigravity/orchestrator.md +3 -2
  353. package/templates/antigravity/settings.edit.json +73 -0
  354. package/templates/antigravity/settings.orchestrator.json +15 -0
  355. package/templates/antigravity/settings.report.json +7 -0
  356. package/templates/antigravity/settings.review.json +7 -0
  357. package/templates/claude/agents/specdojo-orchestrator.md +3 -2
  358. package/templates/codex/agents/specdojo-orchestrator.toml +3 -2
  359. package/templates/codex/orchestrator.md +3 -2
  360. package/templates/devcontainer/remote-host/devcontainer-tmux.sh +217 -0
  361. package/templates/devcontainer/remote-host/specdojo-tmux.sh.sample +8 -96
  362. package/templates/devcontainer/remote-host/ssh-config.sample +3 -1
  363. package/templates/devcontainer/tmux.conf +6 -0
  364. package/templates/init-agent-members.yaml +1 -0
  365. package/templates/init-exec-defaults.yaml +1 -1
  366. package/templates/opencode/agents/specdojo-orchestrator.md +3 -2
@@ -12,122 +12,519 @@ specdojo:
12
12
 
13
13
  Use Case Guide
14
14
 
15
- 「やりたいこと」から、進め方の筋道と読むべき文書へ最短で入るためのガイドです。Quick Start の次に何をどの順で進めればよいかを、代表的なシナリオごとに示します。各ステップの詳細は既存の guide / reference へのリンクに委ねます。
15
+ 「作りたいプロダクト」に合わせて、SpecDojo とオーケストレーターを活用した開発の進め方を示すガイドです。ランディングページ(LP)、Next.js の Web サービス、Unity のゲームという 3 つの代表的なプロダクトを入口とし、相談から仕様策定、AI による成果物作成・検証、変更・運用までの対話フローを具体的に案内します。
16
16
 
17
17
  **対象読者**
18
18
 
19
- - Quick Start を終え、自分の状況に合わせて次に何をすればよいか知りたい利用者
19
+ - [[specdojo:quick-start-guide|Quick Start ガイド]] を終え、自分の作りたいプロダクト(LP、Web サービス、ゲーム等)に応じた実践的な開発フローを知りたい開発者・プロジェクト管理者
20
20
 
21
21
  **この文書で分かること**
22
22
 
23
- - 代表的なシナリオごとの、ゴール・進め方の要点・主に使う文書
23
+ - LP・Next.js Web サービス・Unity ゲームの各ケースにおける完成イメージと前提条件
24
+ - オーケストレーターとの具体的な相談・確認・提案・承認・実行の対話フロー
25
+ - 必要な成果物(仕様書・設計書・カタログ)の作成順序と register / schedule による進行
26
+ - 各ケースでの完成確認・テスト・運用ルーチンの流れ
27
+ - プロダクト開発全般に共通する品質管理・レビュー・隔離実行・ブランチ運用
24
28
 
25
29
  **次に読む文書**
26
30
 
27
- - トピックからどの文書かを引く平坦な索引は [全体概要ガイド](specdojo-overview-guide.md) の `目的別の次の読み物`、コマンドの詳細は [CLIコマンドリファレンス](../references/command-reference.md) を参照してください。
31
+ - 共通の初期設定と基本操作の一巡体験は [[specdojo:quick-start-guide|Quick Start ガイド]] を参照してください。
32
+ - オーケストレーターの詳しい動作原理や安全設計は [[specdojo:orchestrator-operation-guide|オーケストレーター運用ガイド]] を参照してください。
33
+ - トピックからどの文書かを引く索引は [[specdojo:specdojo-overview-guide|全体概要ガイド]] の `目的別の次の読み物`、コマンドとオプションの詳細は [[specdojo:command-reference|CLI コマンドリファレンス]] を参照してください。
28
34
 
29
- ## 1. このガイドの使い方
35
+ ## 1. このガイドの使い方とケースの選び方
30
36
 
31
- 本ガイドは「シナリオ → 進め方 → 使う文書」の筋道を示すもので、文書やコマンドの正本ではありません。各シナリオは次の3点で構成します。
37
+ [[specdojo:quick-start-guide|Quick Start ガイド]] が共通操作を一巡する入門体験であるのに対し、本ガイドは「作りたいプロダクトの種類」に応じた仕様定義・成果物構成・対話の進め方に焦点を当てます。
32
38
 
33
- - ゴール: そのシナリオで達成したいこと
34
- - 進め方: 大まかな手順の流れ
35
- - 主に使う文書: 詳細を確認する guide / reference
39
+ 開発者はオーケストレーターと対話しながら進めます。オーケストレーターは担当者・期限・技術採択などの重要事項を勝手に確定せず、不足事項の確認、選択肢の提案、利用者の承認を経てから登録・実行します。
36
40
 
37
- 「この項目はどの文書か」を平坦に引きたい場合は [全体概要ガイド](specdojo-overview-guide.md) の `目的別の次の読み物` を、コマンドとオプションは [CLIコマンドリファレンス](../references/command-reference.md) を参照してください。まず一度通す体験は [Quick Startガイド](quick-start-guide.md) が最短です。
41
+ 以下の対話に登場する担当者(alice、bob、carol)、期限、技術採択は、流れを説明するための架空の合意例です。実際のプロジェクトでは確認した内容に置き換え、未確定の事項は質問や調査項目として残します。
38
42
 
39
- 次の早見図から、いまの状況に近いシナリオへ進めます。各ノードは以降の節の見出しに対応します。
43
+ 次の早見図とリンクから、該当するプロダクトのケースへ進んでください。
44
+
45
+ - [LP を作る](#case-lp)
46
+ - [Next.js の Web サービスを作る](#case-nextjs)
47
+ - [Unity のゲームを作る](#case-unity)
40
48
 
41
49
  ```mermaid
42
50
  flowchart TD
43
- Q{"いまの状況は?"}
44
- Q -->|まだ何も無い| S11["新規プロジェクトを<br/>最短で立ち上げる"]
45
- Q -->|目的・スコープが未確定| S12["課題整理から<br/>目的・スコープを固める"]
46
- Q -->|既存プロダクト・文書なし| S13["既存プロダクトから<br/>着手する"]
47
- Q -->|計画済みを実行したい| EXE{"どう実行する?"}
48
- Q -->|運用・管理したい| MNG{"何を管理する?"}
51
+ Q{"何を作りたいですか?"}
52
+ Q -->|ランディングページ| C1["ケース1: ランディングページ(LP)<br/>静的サイト・訴求・問い合わせ"]
53
+ Q -->|Webサービス・SaaS| C2["ケース2: Next.js Webサービス<br/>認証・API・DB連携フルスタック"]
54
+ Q -->|ゲーム開発| C3["ケース3: Unityゲーム<br/>2D/3D・C#ロジック・ステート管理"]
55
+
56
+ C1 --> D1["1. 最初の相談と確認事項<br/>2. 成果物定義とカタログ<br/>3. register / schedule 進行<br/>4. プレビュー確認と運用"]
57
+ C2 --> D2["1. 要件・技術スタック確認<br/>2. データモデル・API仕様<br/>3. 文書の schedule と実装 todo<br/>4. テスト検証と運用"]
58
+ C3 --> D3["1. ゲームルール・役割分担<br/>2. システム・ステート設計<br/>3. C#スクリプト隔離実行<br/>4. Playモード確認と調整"]
59
+
60
+ classDef caseNode fill:#e7f5ff,stroke:#1971c2,color:#000;
61
+ classDef detailNode fill:#f8f9fa,stroke:#adb5bd,color:#000;
62
+ class C1,C2,C3 caseNode;
63
+ class D1,D2,D3 detailNode;
64
+ ```
65
+
66
+ どのケースでも、計画外の課題・判断の管理(register)、レビューと人の確定、worktree による隔離実行、routine による定期実行を使います。これらは「[プロダクト開発に共通する運用と品質管理](#common-operations)」にまとめています。
67
+
68
+ <a id="common-setup"></a>
69
+
70
+ ### 1.1. 各ケースに共通する準備
71
+
72
+ 共通の導入は [[specdojo:quick-start-guide|Quick Start ガイド]] の「準備」とプロダクト接続の手順を使います。以下は、その準備を終えた後の対話です。
73
+
74
+ - プロダクトは既存リポジトリ、または各フレームワークの公式生成ツールや Unity Hub で作ります。生成時のバージョンと追加設定を記録します。
75
+ - 両方のリポジトリに初期 commit があり、SpecDojo 側は作業用の `develop` ブランチ、プロダクト側は合意した統合先ブランチが存在することを確認します。
76
+ - プロダクトの接続先・統合方法・worktree の準備方法を合意し、利用者が承認した設定を SpecDojo 側の `develop` へ commit してから exec を開始します。設定を変更する手順は Quick Start と [[specdojo:specdojo-config-reference|設定リファレンス]] に従います。
77
+ - 利用する agent と、プロダクトで実行できる検証・依存導入・ビルド手順を確認します。未導入のテストや CI は、準備作業を合意してから追加します。
78
+
79
+ 本ガイドの project ID `prj-0001` は例です。利用者の project ID に置き換えてください。コマンドは SpecDojo 側のリポジトリで実行し、`<…>` は作成済みの ID 等に置き換えます。
80
+
81
+ <details>
82
+ <summary>プロダクト接続の設定差分の例</summary>
83
+
84
+ 既存の `projects.prj-0001` に以下の `repos` を追加する例です。設定全体を置き換えません。配列の各要素に `name` と `path` を宣言します。パスは実在するプロダクトリポジトリを指す必要があります。
85
+
86
+ ```json
87
+ {
88
+ "repos": [
89
+ {
90
+ "name": "lp-site",
91
+ "path": "../lp-site",
92
+ "integration_branch": "develop",
93
+ "integration_strategy": "ff",
94
+ "branch_template": "feature/{topic}",
95
+ "setup": { "install": true, "build": false }
96
+ }
97
+ ]
98
+ }
99
+ ```
100
+
101
+ これは LP の合意例です。Next.js では `saas-app` / `../saas-app`、Unity では `unity-game` / `../unity-game` のように変更し、統合方法と `setup` も個別に判断します。`install: true` は追跡済みの `package-lock.json` に対する `npm ci` です。Unity では LFS とエディタ・テスト環境の準備を別に確認し、Node.js の依存導入が不要なら `install: false` とします。詳しくは [[specdojo:exec-worktree-guide|exec worktree 運用ガイド]] を参照してください。
102
+
103
+ </details>
104
+
105
+ <a id="document-and-product-flow"></a>
106
+
107
+ ### 1.2. 文書の計画とプロダクトの実装をつなぐ
108
+
109
+ 各ケースでは、まず register に相談から生じた判断・調査・文書作成を記録します。継続的に管理する文書が増えたら、成果物カタログ(`dct-*.yaml`)に文書の ID・パス・完了条件を宣言し、strategy から schedule に展開します。仕様書が `ready` になっただけでは、Hero や API の実装タスクは生成されません。
110
+
111
+ - **文書作成の経路**: カタログと `sch-strategy-<track>.yaml` を準備し、`schedule build` で文書の作成・レビュー・確定を計画します。既に register で作成した文書の todo と同じ作業を重複して実行しないよう、対象と進捗を整理します。
112
+ - **実装の経路**: 確定した文書を入力に、宣言済みのプロダクトリポジトリの変更範囲・完了条件・検証方法を持つ todo を register に起票し、その採番結果を指定して実行します。
113
+
114
+ 成果物文書の ID は各文書の frontmatter を正本とします。`dct-*.yaml` はカタログのファイル名であり、UI 仕様書やデータモデル仕様書そのものの ID ではありません。以下に挙げる未作成文書の名前は作成候補です。
115
+
116
+ 起票後は、個票の完了条件に対象パス、受け入れ条件、実行する検証を具体化し、文書の参照先と担当・期限を確認してから実行します。依存する判断や準備が未完了なら先に解消します。
117
+
118
+ <details>
119
+ <summary>文書の schedule を作成・実行する例</summary>
120
+
121
+ `lp` track のカタログ、strategy、担当と依存関係、agent 設定が準備済みの場合の例です。Next.js や Unity では、実際に定義した track を指定します。
122
+
123
+ ```bash
124
+ npx specdojo schedule build --project prj-0001 --track lp --dry-run
125
+ # 生成内容を確認してから書き込む
126
+ npx specdojo schedule build --project prj-0001 --track lp
127
+ npx specdojo exec refresh --project prj-0001
128
+ npx specdojo exec status --project prj-0001 --state todo
129
+ # refresh の出力と execution/generated/ready.json で Ready を確認した agent タスクを指定
130
+ npx specdojo exec run --project prj-0001 --task "<生成済みのtask ID>" --worktree
131
+ ```
132
+
133
+ human の確定タスクは [共通のレビュー手順](#review-and-finalize)に従います。設計は [[specdojo:schedule-design-guide|Schedule 設計ガイド]]、実行は [[specdojo:schedule-operation-guide|Schedule 実行運用ガイド]] を参照してください。
134
+
135
+ </details>
136
+
137
+ <a id="case-lp"></a>
138
+
139
+ ## 2. ケース1: ランディングページ(LP)の作成
140
+
141
+ ### 2.1. 完成イメージと前提
142
+
143
+ - **完成イメージ**: サービスや製品の価値を分かりやすく伝え、問い合わせや事前登録の獲得を目的とした高速・レスポンシブなランディングページ。
144
+ - **前提**:
145
+ - プロダクトリポジトリ(例: `../lp-site`)と SpecDojo プロジェクトリポジトリ(例: `../lp-specdojo`)を並べた Detached Unit 構成。
146
+ - 採用する生成ツールが要求する Node.js 環境と、[共通の準備](#common-setup)が整っていること。
147
+
148
+ ### 2.2. 最初の相談と確認・判断事項
149
+
150
+ 利用者がオーケストレーターに LP 作成の相談を開始します。オーケストレーターは必要な情報をヒアリングし、利用者の承認を得て進めます。
151
+
152
+ ```chat
153
+ 利用者: 新サービスの告知用ランディングページを作りたいです。どんな構成で進めればよいでしょうか?
154
+
155
+ オーケストレーター: ランディングページの作成ですね。仕様を整理し、スムーズに AI へ実装を委譲できるように進めましょう。
156
+ まず、以下の点についてご希望や前提を確認させてください:
157
+ 1. **主なセクション**: Hero(トップ訴求)、特徴・強み、料金プラン、FAQ、問い合わせ/事前登録フォームなどを想定しますが、含めたい内容はありますか?
158
+ 2. **技術スタック**: 高速な静的生成に向く Astro + Tailwind CSS、Next.js、シンプルな HTML/CSS などの選択肢があります。ご希望はありますか?
159
+ 3. **公開先(ホスティング)**: Cloudflare Pages、GitHub Pages、Vercel などの候補があります。
160
+ 4. **担当者と目標期限**: プロジェクト管理の記録(個票)に残す担当者ニックネームと目標期日をお知らせください。
161
+ ご回答をもとに、技術選定の判断(decision)とプロジェクト定義(todo)の起票案を作成してご提示します。
49
162
 
50
- EXE -->|agent に任せる| S21["agent に成果物を<br/>量産させる"]
51
- EXE -->|変更を隔離したい| S22["worktree で<br/>隔離実行する"]
52
- EXE -->|会話で操作したい| S23["対話(チャット)で<br/>運用する"]
163
+ 利用者: 1. セクションは Hero、特徴3つ、料金プラン表、FAQ、問い合わせフォームでお願いします。
164
+ 2. 技術は Astro + Tailwind CSS で進めたいです。
165
+ 3. 公開先は Cloudflare Pages を想定しています。
166
+ 4. 担当は alice、期限は 2026-12-15 でお願いします。
53
167
 
54
- MNG -->|品質を確定したい| S31["レビューを回して<br/>ready にする"]
55
- MNG -->|計画外の対応・調査| S32["計画外の単発対応・<br/>調査を管理する"]
56
- MNG -->|定期的に回す| S33["定期実行を組む"]
57
- MNG -->|複数PJ・ブランチ| S34["複数プロジェクト・<br/>ブランチを並行する"]
168
+ オーケストレーター: 承知しました。以下の内容で登録簿へ起票してよろしいでしょうか?
169
+ - **decision**: `Astro + Tailwind CSS と Cloudflare Pages による LP 構成の採択`(担当: alice, 期限: 2026-12-15)
170
+ - **todo**: `プロジェクト定義書と LP 画面仕様書の作成`(担当: alice, 期限: 2026-12-15)
171
+ 承認いただければ、起票コマンドを実行します。
58
172
 
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;
173
+ 利用者: はい、承認します。実行してください。
65
174
  ```
66
175
 
67
- ## 2. 立ち上げと計画
176
+ ### 2.3. 必要な成果物と作成順序
177
+
178
+ LP 作成で推奨される成果物と作成順序は次のとおりです。
179
+
180
+ 1. **プロジェクト定義・スコープ(`prj-scope` / `prj-charter`)**: 目的、ターゲット層、コンバージョン目標(CVR)の定義。
181
+ 2. **UI 仕様書**: 各セクションのワイヤーフレーム、文言案、レスポンシブ表示(PC/スマホ)仕様。
182
+ 3. **システム設計・デプロイ仕様**: Astro プロジェクト構成、Tailwind 設定、Cloudflare Pages デプロイ手順。
183
+ 4. **成果物カタログ(`dct-*.yaml`)**: 管理する文書の ID・パス・完了条件を宣言し、文書の schedule に接続する定義。
184
+
185
+ ### 2.4. register・schedule による進行
186
+
187
+ [文書と実装の進行経路](#document-and-product-flow)に沿って、UI 仕様書等を register または文書の schedule で作成・レビューします。フォームは送信先、個人情報の扱い、成功・失敗時の表示を確認し、未決なら question / decision に残します。
188
+
189
+ ```chat
190
+ 利用者: 画面仕様書を確定しました。コンポーネントの実装を進めてください。
191
+
192
+ オーケストレーター: 確定した仕様書と、接続済みの `lp-site` を確認します。まず Hero の文言と PC・スマホ表示を実装する todo を提案します。対象は Hero のコンポーネントと関連スタイル、完了条件は仕様どおりの表示と合意済みの検証の成功です。フォームは送信方式の決定後に別の todo にします。担当 alice、期限 2026-12-15 を引き継いでよいですか?
193
+
194
+ 利用者: はい。その範囲で起票し、worktree で実行してください。
195
+
196
+ オーケストレーター: 起票結果の PJR-ID を指定して実行します。executor が実装・検証結果を報告し、runner が設定済みの親検証と commit・統合を担当します。統合先は承認済み設定に従います。完了後に差分・検証記録とプレビューを確認していただきます。
197
+ ```
198
+
199
+ #### 2.4.1. 実行後の確認対話
200
+
201
+ ```chat
202
+ オーケストレーター: Hero の差分と検証記録を提示します。PC・スマホ表示と文言を確認し、受け入れ可能か判断してください。フォームの送信確認は後続 todo の範囲です。
203
+
204
+ 利用者: スマホでは見出しが長すぎます。文言を短くしてから、残りのセクションへ進めてください。
205
+
206
+ オーケストレーター: 文言の修正案と対象仕様書への反映を提案し、合意した変更を記録して再検証します。受け入れ確認後に次の todo へ進みます。
207
+ ```
208
+
209
+ ### 2.5. 完成確認と変更・運用への流れ
210
+
211
+ - **手元での確認**: プロダクトで用意したプレビュー手順(`dev` script があれば `npm run dev`)で PC・スマートフォンの表示、フォームの入力検証・送信結果を確認します。公開は利用者が内容と公開先を確認してから行います。
212
+ - **変更の管理**: コピー文言の変更やデザイン調整の要望が出た場合は、勝手にコードを直さず `register add --type todo` で起票して履歴を残します。
213
+ - **運用の自動化**: デッドリンクの検査やライブラリのセキュリティ更新は、[[specdojo:routine-operation-guide|routine 運用ガイド]] に従って必要な検査ジョブと外部スケジューラを用意します。共通の変更管理・レビューは 「[プロダクト開発に共通する運用と品質管理](#common-operations)」を参照してください。
214
+
215
+ ### 2.6. コマンドと設定差分(折りたたみ)
216
+
217
+ <details>
218
+ <summary>LP プロジェクトのコマンドと設定例を展開する</summary>
219
+
220
+ [共通の準備](#common-setup)を終えた後、2.2 の合意を記録する例です。
221
+
222
+ ```bash
223
+ npx specdojo register add --project prj-0001 --type decision \
224
+ --title "LP の構成と公開先を決める" --topic lp-stack \
225
+ --description "Astro と Tailwind CSS、Cloudflare Pages を使う構成の採否と理由を記録する" \
226
+ --input "Hero、特徴3つ、料金、FAQ、問い合わせを掲載する。送信方式は別途確認する" \
227
+ --owner alice --due 2026-12-15 --by specdojo-orchestrator --commit
228
+ npx specdojo register add --project prj-0001 --type todo \
229
+ --title "LP 画面仕様書とスコープを作る" --topic lp-ui-spec \
230
+ --description "対象読者、訴求、PC・スマホの画面構成と受け入れ条件を文書化する" \
231
+ --input "合意した LP 構成を前提にする。フォーム送信先と個人情報の扱いは確認して記録する" \
232
+ --owner alice --due 2026-12-15 --by specdojo-orchestrator --commit
233
+ ```
234
+
235
+ decision は起票だけで採択済みになりません。承認者・判断理由を個票に記録して状態を進めます。文書の完成後、2.4 の合意に基づき実装用の別 todo を作ります。入力に書く文書パスは、作成済みの実際のパスに置き換えます。
236
+
237
+ ```bash
238
+ npx specdojo register add --project prj-0001 --type todo \
239
+ --title "Hero セクションを実装する" --topic lp-hero \
240
+ --description "lp-site の Hero と関連スタイルを変更し、確定仕様どおりの文言と PC・スマホ表示を検証する" \
241
+ --input "確定仕様書: <作成済みのLP画面仕様書のパス>。変更対象は lp-site。実行できる検証は個票の完了条件に列挙する" \
242
+ --owner alice --due 2026-12-15 --by specdojo-orchestrator --commit
243
+ # 起票された個票の完了条件・対象パス・検証方法を確認してから実行する
244
+ npx specdojo exec run --project prj-0001 --register "<Heroの起票結果のPJR-ID>" --worktree
245
+ ```
246
+
247
+ </details>
248
+
249
+ ### 2.7. 用途別ひな型について
250
+
251
+ LP 向けの用途別ひな型を先に整備する方針です。本ガイドは、利用可能なスターターを前提とせず、公式生成ツールで作ったプロダクトと SpecDojo を接続する手順を示しています。ひな型の公開後に実物を確認し、複製・初期化・対話開始・動作確認の手順を追記します。
252
+
253
+ <a id="case-nextjs"></a>
254
+
255
+ ## 3. ケース2: Next.js の Web サービスの作成
256
+
257
+ ### 3.1. 完成イメージと前提
258
+
259
+ - **完成イメージ**: ユーザー認証、ダッシュボード、データベース連携、CRUD API を備えたフルスタックの Web サービス(SaaS や業務アプリ)。
260
+ - **前提**:
261
+ - プロダクトリポジトリ(例: `../saas-app`)と SpecDojo リポジトリ(例: `../saas-specdojo`)の Detached Unit 構成。
262
+ - 採用する Next.js 等のバージョンが要求する Node.js 環境、合意した DB の開発環境、および [共通の準備](#common-setup)。
263
+
264
+ ### 3.2. 最初の相談と確認・判断事項
265
+
266
+ ```chat
267
+ 利用者: Next.js でユーザー認証とデータ管理機能がある Web サービスを開発したいです。仕様決めから実装までの流れを案内してください。
268
+
269
+ オーケストレーター: フルスタック Web サービスの構築ですね。セキュリティやデータ整合性が重要になりますので、段階を踏んで仕様を固めましょう。
270
+ 以下の事項について、現時点の想定をお聞かせいただけますか?
271
+ 1. **主要な機能要件**: ユーザー登録・ログイン、ダッシュボード表示、データの一覧・登録・編集・削除などを想定していますが、他に必要な機能はありますか?
272
+ 2. **認証と DB の技術スタック**: NextAuth (Auth.js) / Supabase / Clerk などの認証方式や、Prisma / Drizzle などの ORM、DB(PostgreSQL / SQLite 等)のご希望はありますか?
273
+ 3. **デプロイ先環境**: Vercel、Cloudflare(OpenNext)、AWS などの想定はありますか?
274
+ 4. **担当者と期限**: プロジェクト管理上の担当者ニックネームと目標完了日をお知らせください。
275
+ ご提示いただいた条件をもとに、アーキテクチャ検討の decision と要件定義の todo を提案します。
276
+
277
+ 利用者: 1. 機能はユーザー登録・ログイン、プロジェクト一覧と作成、アイテムの CRUD 管理です。
278
+ 2. 認証は NextAuth.js、ORM は Prisma、DB は PostgreSQL を使いたいです。
279
+ 3. デプロイ先は Vercel を予定しています。
280
+ 4. 担当は bob、期限は 2026-12-31 でお願いします。
281
+
282
+ オーケストレーター: ありがとうございます。内容を整理しました。
283
+ 以下の起票を行ってよろしいでしょうか?
284
+ - **decision**: `NextAuth.js + Prisma (PostgreSQL) による認証・DB 基盤の採択`(担当: bob, 期限: 2026-12-31)
285
+ - **todo**: `データモデル設計書(CCD/CDSD)と API インターフェース仕様書の作成`(担当: bob, 期限: 2026-12-31)
286
+ 承認をいただければ起票します。
287
+
288
+ 利用者: はい、承認します。
289
+ ```
290
+
291
+ ### 3.3. 必要な成果物と作成順序
292
+
293
+ Next.js アプリケーションでは、フロントエンドとバックエンドの境界を明確にするため、以下の順序で成果物を作成します。
294
+
295
+ 1. **システム要件・スコープ定義(`prj-scope`)**: 機能要件、ユーザーロール(一般・管理者など)、権限設計。
296
+ 2. **データモデル仕様書(CCD / CDSD)**: エンティティ(User, Account, Item 等)の関連、テーブル定義、インデックス。
297
+ 3. **外部インターフェース・API 仕様書**: Route Handlers / Server Actions の入出力型、エラーハンドリング。
298
+ 4. **UI 仕様書**: 画面遷移図、各ページのコンポーネント構造、フォームバリデーション。
299
+ 5. **非機能要件・セキュリティ設計書**: CSRF/CORS 対策、セッション管理、レート制限。
300
+
301
+ ### 3.4. register・schedule による進行
302
+
303
+ 文書は [共通の経路](#document-and-product-flow)で作成します。カタログと strategy に文書間の依存関係を定義し、実装では以下の順序を候補に todo を分けます。
304
+
305
+ - **Phase 1(基盤構築)**: Prisma スキーマ作成、DB マイグレーションスクリプト、NextAuth 認証設定。
306
+ - **Phase 2(バックエンド・API 実装)**: データアクセス層、Server Actions / API ルートの実装、単体テスト。
307
+ - **Phase 3(フロントエンド実装)**: 画面コンポーネント、フォームバリデーション、データ取得フック。
308
+
309
+ ```chat
310
+ 利用者: データモデルと API 仕様を確定しました。最初はプロジェクト一覧 API の実装をお願いします。
311
+
312
+ オーケストレーター: `saas-app` の接続、認証基盤と開発 DB の準備を確認します。今回の todo は一覧 API と権限検査、関連テストを対象にします。bob、2026-12-31 のまま進めてよいですか? 本番 DB の変更は別途判断します。
313
+
314
+ 利用者: はい。その範囲で起票して実行してください。
315
+
316
+ オーケストレーター: 採番された todo を `exec run --register` の対象にし、worktree で実行します。`typecheck` やテストは、プロダクト側に script・依存関係・DB 等が用意され、実行設定に組み込まれているものを実行します。未準備の検証は完了扱いにせず、準備方法を記録します。
317
+ ```
318
+
319
+ ### 3.5. 完成確認と変更・運用への流れ
320
+
321
+ - **結合テストと検証**: 合意した開発 DB とテストデータを用意し、ログイン、データ作成、他ユーザーのデータへのアクセス拒否、ログアウトを確認します。E2E テストが準備済みなら実行し、利用者が受け入れと公開可否を判断します。
322
+ - **セキュリティチェック**: 依存関係・静的解析・秘密情報の検査を候補に、公開先や契約条件に合う手段を選びます。CI やリポジトリ設定の変更案は利用者に提示し、承認された手段を準備します。
323
+ - **不具合や改善のトリアージ**: 開発中に発生した不具合は `register add --type issue` で起票し、AI に原因調査と修正を行わせます。詳細は [[specdojo:register-operation-guide|登録簿運用ガイド]] と 「[プロダクト開発に共通する運用と品質管理](#common-operations)」を参照してください。
324
+
325
+ ### 3.6. コマンドと設定差分(折りたたみ)
326
+
327
+ <details>
328
+ <summary>Next.js プロジェクトのコマンドと設定例を展開する</summary>
329
+
330
+ 3.2 の合意を一度だけ起票する例です。Next.js 等の生成と追加パッケージの導入は、採用バージョンの公式手順で行い、[共通の準備](#common-setup)を済ませておきます。
331
+
332
+ ```bash
333
+ npx specdojo register add --project prj-0001 --type decision \
334
+ --title "Web サービスの認証と DB 基盤を決める" --topic saas-auth-db \
335
+ --description "NextAuth.js、Prisma と PostgreSQL、Vercel の採否・構成と選定理由を記録する" \
336
+ --input "ユーザー登録、プロジェクト一覧・作成、アイテム CRUD を提供するという合意例" \
337
+ --owner bob --due 2026-12-31 --by specdojo-orchestrator --commit
338
+ npx specdojo register add --project prj-0001 --type todo \
339
+ --title "データモデルと API の仕様書を作る" --topic saas-data-api-spec \
340
+ --description "エンティティ、所有権・権限、API の入出力と失敗時の挙動を文書化する" \
341
+ --input "3.2 で合意した機能を対象に、未決事項を確認する。UI と非機能仕様の後続作業も整理する" \
342
+ --owner bob --due 2026-12-31 --by specdojo-orchestrator --commit
343
+ ```
344
+
345
+ 文書の確認後、3.4 の合意範囲を実装 todo に記録します。
346
+
347
+ ```bash
348
+ npx specdojo register add --project prj-0001 --type todo \
349
+ --title "プロジェクト一覧 API を実装する" --topic saas-project-list-api \
350
+ --description "saas-app の一覧 API と権限検査を実装し、準備済みの開発 DB で正常系とアクセス拒否を検証する" \
351
+ --input "確定仕様書: <作成済みのデータモデルとAPI仕様書のパス>。本番 DB は変更しない。実行する検証と対象パスを完了条件に明記する" \
352
+ --owner bob --due 2026-12-31 --by specdojo-orchestrator --commit
353
+ npx specdojo exec run --project prj-0001 --register "<APIの起票結果のPJR-ID>" --worktree
354
+ ```
355
+
356
+ </details>
357
+
358
+ ### 3.7. 用途別ひな型について
359
+
360
+ 用途別ひな型は LP に続いて Next.js + Cloudflare を整備する方針です。3.2 の Vercel は利用者が選んだ架空の合意例であり、ひな型の提供方針とは分けて考えます。現在の手順は公式生成ツールと個別設定を使います。ひな型の公開後に、実際の生成・追加設定・SpecDojo 設定を確認し、複製・初期化と動作確認を追記します。
361
+
362
+ <a id="case-unity"></a>
363
+
364
+ ## 4. ケース3: Unity のゲーム開発
365
+
366
+ ### 4.1. 完成イメージと前提
367
+
368
+ - **完成イメージ**: プレイヤー操作、敵キャラクター、ステート管理、スコア表示、シーン遷移を備えた 2D/3D アクションゲーム。
369
+ - **前提**:
370
+ - プロダクトリポジトリ(Unity プロジェクト `../unity-game`)に **Git LFS**(Large File Storage)が導入されていること。
371
+ - SpecDojo プロジェクトリポジトリ(`../unity-game-specdojo`)との Detached Unit 構成。
372
+ - Unity Hub と採用バージョンのエディタ・ビルド環境、および [共通の準備](#common-setup)が整っていること。
373
+
374
+ ### 4.2. 最初の相談と確認・判断事項
375
+
376
+ ゲーム開発では、アセットやバイナリの扱い、エディタでの手作業と AI が行うスクリプト実装の分担を最初に明確にする必要があります。
377
+
378
+ ```chat
379
+ 利用者: Unity で 2D アクションゲームを制作したいです。仕様設計を行い、C# スクリプトの実装を AI に任せながら進めたいです。
380
+
381
+ オーケストレーター: Unity ゲームの開発ですね。エディタでの Scene/Prefab 構築と、AI が担当する C# スクリプトやデータ設計の役割分担を整理して進めましょう。
382
+ 以下の事項について確認させてください:
383
+ 1. **ゲームのコアルール**: ジャンル、基本アクション(移動・ジャンプ・攻撃等)、クリア・ゲームオーバー条件を教えてください。
384
+ 2. **AI の担当範囲**: AI に任せるのは C# ロジック(プレイヤー操作、敵ステートマシン、スコア管理など)とパラメータ定義(ScriptableObject)でしょうか? Scene への Prefab 配置やスプライト描画は人間が担当する想定で合っていますか?
385
+ 3. **バージョンとパッケージ**: Unity バージョン(例: 2022.3 LTS)や、新しい Input System パッケージの使用有無を教えてください。
386
+ 4. **担当者と期限**: 記録に残す担当者ニックネームと目標マイルストーン期限をお知らせください。
387
+ ご確認いただければ、役割分担と基本アーキテクチャの decision、およびゲーム仕様設計の todo を起票します。
388
+
389
+ 利用者: 1. 2D 横スクロールアクションで、移動・ジャンプと敵の踏みつけ、コイン収集でゴールを目指します。
390
+ 2. はい、AI には C# スクリプトと ScriptableObject の作成を任せ、Scene 配置やアニメーション設定、Sprite の配置は私がエディタで行います。
391
+ 3. Unity 2022.3 LTS で、Input System パッケージを使用します。
392
+ 4. 担当は carol、プロトタイプ完成期限は 2027-01-31 でお願いします。
393
+
394
+ オーケストレーター: 方針を把握しました。エディタ作業と AI スクリプト生成の境界を明確にした上で、以下を起票してよろしいでしょうか?
395
+ - **decision**: `Input System 採用と AI・人間作業境界の合意`(担当: carol, 期限: 2027-01-31)
396
+ - **todo**: `ゲームシステム設計書(ステートマシン・パラメータ定義)の作成`(担当: carol, 期限: 2027-01-31)
397
+ 承認いただければ実行します。
398
+
399
+ 利用者: 承認します。起票してください。
400
+ ```
401
+
402
+ ### 4.3. 必要な成果物と作成順序
403
+
404
+ Unity 開発では、ロジックとエディタ設定が乖離しないよう、以下の成果物を順に整備します。
405
+
406
+ 1. **ゲーム概要・スコープ(`prj-overview` / `prj-scope`)**: ゲームコンセプト、ルール、対象プラットフォーム(PC / モバイル等)。
407
+ 2. **システム設計・ステート遷移仕様**: プレイヤー状態(Idle, Run, Jump, Fall)、敵ステートマシン(Patrol, Chase, Attack)、ゲームループ(Title, Playing, GameOver, StageClear)。
408
+ 3. **データモデル・パラメータ仕様**: 移動速度、ジャンプ力、敵 HP などを管理する ScriptableObject の型定義とデフォルト値。
409
+ 4. **外部インターフェース・入力仕様**: Input Actions のマッピング(Move, Jump, Pause 等)。
410
+ 5. **テスト仕様書**: Unity Test Framework(UTF)の EditMode / PlayMode テスト観点。
411
+
412
+ ### 4.4. register・schedule による進行
413
+
414
+ 仕様書は [文書の schedule](#document-and-product-flow)で作成・レビューし、実装は `unity-game` の変更を行う register の todo として分けます。候補は次のとおりです。
415
+
416
+ - **Player Controller 実装**: Input System からの入力を受け取り、Rigidbody2D を制御するスクリプト。
417
+ - **Enemy State Machine 実装**: 状態遷移パターンに基づき、検知範囲内のプレイヤーを追従するスクリプト。
418
+ - **Game Manager & UI 連動**: イベント駆動でコイン取得数やライフ残量を更新する仕組み。
419
+
420
+ ```chat
421
+ 利用者: 入力仕様とプレイヤーの状態遷移を確定しました。移動とジャンプから実装してください。
422
+
423
+ オーケストレーター: `unity-game` の Player Controller と関連テストを対象にした todo を提案します。Scene、Prefab、入力アセットとの接続は carol さんが行う合意とし、担当 carol、期限 2027-01-31 を引き継いでよいですか?
424
+
425
+ 利用者: はい。スクリプトの実装を起票して実行してください。エディタで接続して確認します。
426
+
427
+ オーケストレーター: 採番された todo を指定して worktree で実行します。executor は C# と関連テストを編集し、用意された検証を実行します。Unity のライセンスやバッチ実行環境が必要な検査、Play モードの操作確認は実行可能な環境で行い、未確認の項目を結果に残します。runner が commit と承認済み設定に沿った統合を行います。
428
+ ```
429
+
430
+ ### 4.5. 完成確認と変更・運用への流れ
431
+
432
+ - **Unity エディタでの結合確認**: AI が作成した C# スクリプトを Prefab や GameObject にアタッチし、エディタの Play モードで操作感や当たり判定を確認します。
433
+ - **単体テストの実行**: ロジック部分(ステート遷移やダメージ計算)は、Unity Test Framework と実行環境を準備した上で EditMode / PlayMode テストを実行します。人が Play モードで操作感・クリア条件を確認し、受け入れと配布可否を判断します。
434
+ - **パラメータ調整とバグ報告**: ジャンプ力や移動速度の微調整は ScriptableObject 上で行います。挙動の不具合が見つかった場合は `register add --type issue` でログや期待値を添えて起票し、合意した範囲で修正と再確認を行います。共通の運用は 「[プロダクト開発に共通する運用と品質管理](#common-operations)」を参照してください。
435
+
436
+ ### 4.6. コマンドと設定差分(折りたたみ)
437
+
438
+ <details>
439
+ <summary>Unity プロジェクトの Git LFS とリポジトリ設定例を展開する</summary>
440
+
441
+ Unity Hub で作成したプロジェクトに `.gitignore` と必要な LFS 対象を設定し、アセットと `.meta` の管理方針を決めます。初期 commit と統合先ブランチを用意した上で、[共通の準備](#common-setup)に従って接続します。Unity のライセンス・LFS・テストの準備は利用環境で確認します。
442
+
443
+ ```bash
444
+ npx specdojo register add --project prj-0001 --type decision \
445
+ --title "入力方式と AI・人間の作業境界を決める" --topic unity-input-roles \
446
+ --description "Input System 採用と、C#・データ定義を AI、Scene 等のエディタ作業を人が担う分担を記録する" \
447
+ --input "Unity 2022.3 LTS で 2D 横スクロールの移動・ジャンプ・踏みつけ・コイン収集を試作するという合意例" \
448
+ --owner carol --due 2027-01-31 --by specdojo-orchestrator --commit
449
+ npx specdojo register add --project prj-0001 --type todo \
450
+ --title "ゲームシステム設計書を作る" --topic unity-system-spec \
451
+ --description "状態遷移、パラメータ、入力との接続、テスト観点とエディタ確認手順を文書化する" \
452
+ --input "AI とエディタ作業の境界は 4.2 の合意に従う。未決のルールは確認する" \
453
+ --owner carol --due 2027-01-31 --by specdojo-orchestrator --commit
454
+ ```
455
+
456
+ 4.4 の合意後に、スクリプト実装用の todo を起票します。
457
+
458
+ ```bash
459
+ npx specdojo register add --project prj-0001 --type todo \
460
+ --title "プレイヤーの移動とジャンプを実装する" --topic unity-player-controller \
461
+ --description "unity-game の Player Controller と関連テストを作り、確定仕様に沿った状態遷移を検証する" \
462
+ --input "確定仕様書: <作成済みの入力・状態遷移仕様書のパス>。Scene と Prefab の接続は carol が確認する。対象パスと検証方法を完了条件に記載する" \
463
+ --owner carol --due 2027-01-31 --by specdojo-orchestrator --commit
464
+ npx specdojo exec run --project prj-0001 --register "<Player Controllerの起票結果のPJR-ID>" --worktree
465
+ ```
466
+
467
+ </details>
468
+
469
+ ### 4.7. 用途別ひな型について
470
+
471
+ Unity スターターの採用・提供は確定していません。本ケースは Unity Hub で作成した通常のプロジェクトを使います。用途別ひな型が利用可能になった場合も、Git LFS、アセット管理、エディタとの役割分担を実物で確認してから手順に取り入れます。
472
+
473
+ <a id="common-operations"></a>
68
474
 
69
- ### 2.1. 新規プロジェクトを最短で立ち上げる
475
+ ## 5. プロダクト開発に共通する運用と品質管理
70
476
 
71
- - ゴール: 設定から1タスク完了までを最短で通す。
72
- - 進め方: `specdojo init` → `register add` → 個票へ完了条件を記入 → `exec run --register --worktree` → 変更と動作を確認 → `register close`。成果物を計画的に増やす場合は、その後に成果物カタログと Schedule へ広げる。
73
- - 主に使う文書: [Quick Startガイド](quick-start-guide.md)、[遂行の技活用ガイド](waza-guide.md)。
477
+ どのプロダクトを作る場合でも、SpecDojo における課題管理、品質保証、隔離実行、ブランチ運用の原則は共通です。各ケースの詳細と併せて以下のガイドを参照してください。
74
478
 
75
- ### 2.2. 課題整理から目的・スコープを固める
479
+ ### 5.1. 計画外の課題・判断・調査を管理する(register)
76
480
 
77
- - ゴール: 目的・スコープ・対象成果物が未確定な状態を、記録しながら決めていく。
78
- - 進め方: `issue` / `question` を登録し、調査のうえ `decision` で方針を確定し、`todo` で成果物カタログ作成につなげる。決定後は schedule 側で計画済み作業を管理する。
79
- - 主に使う文書: [Quick Startガイド](quick-start-guide.md) の `registerをユースケース別に使う`、[登録簿運用ガイド](register-operation-guide.md)。
481
+ 開発中に発生する不具合、技術的な迷い、計画外のタスクは、コードに直接手を入れる前に register へ登録します。
80
482
 
81
- ### 2.3. 既存プロダクト(文書なし)から着手する
483
+ | 種別 (`type`) | 用途 | 例 |
484
+ | ------------- | ---------------------------------------- | ---------------------------------------------- |
485
+ | `issue` | 発生した不具合や課題の調査・修正 | スマホ表示でメニューが閉じない、DB接続エラー |
486
+ | `decision` | 技術スタック・アーキテクチャの採択・決定 | 認証ライブラリの比較選定、ホスティング先の決定 |
487
+ | `todo` | 単発の作業・ドキュメント作成 | FAQ 項目の追加、ライセンス表記の更新 |
488
+ | `question` | 仕様や前提に関する問い合わせ・確認 | サードパーティ API の利用規約・料金制限の確認 |
82
489
 
83
- - ゴール: ドキュメントが無い既存プロダクトを対象に、現物・実績から仕様を起こす。
84
- - 進め方: 後続トラック(実装・運用の現物確認など)を先に着手し、そこで分かったことをもとに AS-IS 側の成果物を後から起こす。逆順区間は最後に整合を取るタスクを明示する。
85
- - 主に使う文書: [トラック設計ガイド](track-design-guide.md) の `入力元より先に後続トラックへ着手する場合`、[成果物リファレンス](../references/deliverables-reference.md)。
490
+ 詳しい状態遷移や起票手順は [[specdojo:register-operation-guide|登録簿運用ガイド]] を参照してください。
86
491
 
87
- ## 3. 作成と実行
492
+ <a id="review-and-finalize"></a>
88
493
 
89
- ### 3.1. agentに成果物を量産させる
494
+ ### 5.2. レビューを回して成果物を ready に確定する
90
495
 
91
- - ゴール: 計画済みタスクを agent に実行させ、レビューへ回す。
92
- - 進め方: `.specdojo/agent-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)。
496
+ 成果物(仕様書や設計書)の品質は、AI による `grade` 評価と、人間による最終確認を組み合わせて担保します。
94
497
 
95
- ### 3.2. worktreeで隔離実行する
498
+ 1. **品質評価(grade)**: 対象の rulebook と評価観点に従って品質を評価します。構文・リンク等の機械検証も別途行います。
499
+ 2. **レビュータスク(mode: review)**: grade の結果を事実として参照し、変更内容や完了条件が満たされているかを確認します。
500
+ 3. **人間による確定(finalize)**: `ready` 化の条件を確認し、最終承認と公開可否を人が判断します。通常の編集 executor は独自に `ready` へ昇格させません。human タスクは result を入口に確認・確定します。[[specdojo:exec-operation-guide|exec 運用ガイド]] には、登録済み agent を `--by` で明示して human タスクを実行する経路もありますが、操作を委ねることと人の最終判断を区別します。
96
501
 
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)。
502
+ 詳細は [[specdojo:review-guide|レビューガイド]] を参照してください。
100
503
 
101
- ### 3.3. 対話(チャット)で運用する
504
+ ### 5.3. worktree で作業を安全に隔離・統合する
102
505
 
103
- - ゴール: CLI を直接叩く代わりに、会話で計画・実行・状況確認を進める。
104
- - 進め方: `npm run orch:sonnet` でオーケストレーターを起動し、やりたいことを自然文で伝える。状態を変える操作は提示・承認のうえ実行される。
105
- - 主に使う文書: [オーケストレーター運用ガイド](orchestrator-operation-guide.md)、[遂行の技活用ガイド](waza-guide.md) の `代表フロー`。
506
+ AI エージェントに実装作業を委譲する際は、作業中の手元環境を汚さないために Git worktree を使った隔離実行(`--worktree`)を基本とします。
106
507
 
107
- ## 4. 管理・品質・運用
508
+ - タスクごとに専用のブランチと独立したディレクトリが作成されます。
509
+ - executor は成果物の編集・検証を担当し、runner が設定済みの親検証と commit・統合を行います。実行できる検証は、各リポジトリに script・依存関係・実行環境が準備されたものに限ります。
510
+ - 統合先と方法は承認済みの設定に従います。`branch-only` なら作業ブランチを保持し、PR レビューへ渡します。失敗時は結果と残された worktree を確認して修正・再開します。
108
511
 
109
- ### 4.1. レビューを回して成果物をreadyにする
512
+ 詳細は [[specdojo:exec-worktree-guide|exec worktree運用ガイド]] を参照してください。
110
513
 
111
- - ゴール: grade の品質評価とタスクの完了判断を分け、確認済みの成果物を `ready` へ確定する。
112
- - 進め方: grade が観点ごとの品質を評価し、`mode: review` のタスクはその結果を事実として変更内容・実行記録・完了条件を照合する。`ready` への昇格は human が finalize タスクで行う。
113
- - 主に使う文書: [レビューガイド](review-guide.md)、[exec運用ガイド](exec-operation-guide.md) の `humanタスクの実行`。
514
+ ### 5.4. routine による定期実行と日次巡回
114
515
 
115
- ### 4.2. 計画外の単発対応・調査を管理する
516
+ 定期的な運用作業(日次スイープ、依存関係の脆弱性検査、期限切れタスクの確認)は routine 機能で自動化します。
116
517
 
117
- - ゴール: 進行中に発生した計画外の対応・調査・判断を、台帳として追跡する。
118
- - 進め方: `register add` で登録し、agent 実行可能な type は `exec run --register` で対応する。成功後は人が確認して `register close` する。schedule の計画済み作業とは二重管理しない。
119
- - 主に使う文書: [登録簿運用ガイド](register-operation-guide.md)、[exec運用ガイド](exec-operation-guide.md) の `実行経路の使い分け`。
518
+ - `rtn-*.yaml` に実行対象のジョブを定義します。
519
+ - GitHub Actions や cron などの外部スケジューラから `npx specdojo routine run --due` を定期的に呼び出します。
120
520
 
121
- ### 4.3. 定期実行を組む
521
+ 詳細は [[specdojo:routine-operation-guide|routine運用ガイド]] を参照してください。
122
522
 
123
- - ゴール: 日次スイープや夜間バッチなど、時刻条件で繰り返す作業を自動化する。
124
- - 進め方: `rtn-*.yaml` に register 実行または schedule 実行を定義し、外部スケジューラから `routine run --due` を冪等に呼ぶ。
125
- - 主に使う文書: [routine運用ガイド](routine-operation-guide.md)。
523
+ ### 5.5. 複数プロジェクト・ブランチの並行運用
126
524
 
127
- 既存の未完了項目を繰り返し探索する場合は `job-register-sweep` / `job-exec-auto` を使います。期間ごとに新しい実行単位を作る週報や、前回成功時点以降の差分を処理する翻訳も、routineの`action.kind: job`とJob checkpointを使います。定義と実行方法は[Job実行設計](../../product/040-system-design/sysd-job-execution.md)を参照してください。
525
+ 複数のプロジェクト(例: `prj-0001` と `prj-0002`)や、複数の機能開発ブランチを同時に進める場合は、ブランチ運用のルールを統一します。
128
526
 
129
- ### 4.4. 複数プロジェクト・ブランチを並行する
527
+ - **統合軸の分離**: SpecDojo 側の project の統合軸と、`repos` に宣言した各プロダクトの統合先を区別し、タスクごとの作業ブランチを隔離します。
528
+ - **競合の防止**: 共有ファイル(CHANGELOG や設定ファイル)の衝突を避けるため、実行の列(キュー)を整えて順次マージします。
130
529
 
131
- - ゴール: 複数の `prj-xxxx` や worktree を同じリポジトリで安全に並行運用する。
132
- - 進め方: project `develop` を軸に feature / exec のブランチを分離し、統合方向と同期手順を守る。worktree のベース取り込みはベースブランチを明示する。
133
- - 主に使う文書: [ブランチワークフローガイド](branch-workflow-guide.md)、[exec worktree運用ガイド](exec-worktree-guide.md)。
530
+ 詳細は [[specdojo:branch-workflow-guide|ブランチワークフローガイド]] を参照してください。