specdojo 0.7.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 (337) hide show
  1. package/.github/agents/specdojo-orchestrator.md +3 -2
  2. package/CHANGELOG.md +153 -0
  3. package/dist/catalog/build.js +24 -1
  4. package/dist/catalog/plan.js +1 -1
  5. package/dist/catalog/scaffold.js +4 -1
  6. package/dist/commands/init.js +5 -1
  7. package/dist/commands/night-orchestrator.js +6 -4
  8. package/dist/dashboard/dashboard-timeline.js +18 -16
  9. package/dist/dashboard/dashboard.js +612 -259
  10. package/dist/dashboard/epic-plan.js +81 -0
  11. package/dist/dashboard/exec-records.js +16 -20
  12. package/dist/dashboard/routines.js +8 -6
  13. package/dist/dashboard/timeline-build.js +5 -9
  14. package/dist/dashboard/timeline.js +9 -4
  15. package/dist/devcontainer/scaffold.js +18 -0
  16. package/dist/docs/frontmatter-namespace.js +1 -48
  17. package/dist/docs/yaml-pages.js +125 -3
  18. package/dist/exec/agent-config.js +22 -0
  19. package/dist/exec/agent-plan.js +3 -2
  20. package/dist/exec/commands.js +69 -21
  21. package/dist/exec/commit-hook-skips.js +78 -0
  22. package/dist/exec/core.js +19 -7
  23. package/dist/exec/events.js +159 -8
  24. package/dist/exec/evidence.js +64 -16
  25. package/dist/exec/handoff.js +9 -13
  26. package/dist/exec/limit.js +1 -1
  27. package/dist/exec/mechanical-result.js +45 -0
  28. package/dist/exec/migrate-records.js +249 -0
  29. package/dist/exec/parent-validation.js +153 -12
  30. package/dist/exec/pipeline-state.js +27 -5
  31. package/dist/exec/plans-condense-findings.js +89 -0
  32. package/dist/exec/plans-core.js +24 -17
  33. package/dist/exec/plans-generation.js +48 -25
  34. package/dist/exec/plans-grade-findings.js +8 -3
  35. package/dist/exec/plans-kata-findings.js +61 -0
  36. package/dist/exec/plans-planning.js +3 -3
  37. package/dist/exec/plans-storage.js +12 -24
  38. package/dist/exec/register-resume.js +55 -56
  39. package/dist/exec/register.js +26 -22
  40. package/dist/exec/repo-integration-sync.js +8 -4
  41. package/dist/exec/repo-integration.js +21 -1
  42. package/dist/exec/reporter.js +121 -23
  43. package/dist/exec/results.js +85 -24
  44. package/dist/exec/review-completion.js +47 -0
  45. package/dist/exec/review-kata.js +109 -0
  46. package/dist/exec/run/agent-pipeline.js +75 -6
  47. package/dist/exec/run/agent.js +20 -7
  48. package/dist/exec/run/in-place.js +69 -32
  49. package/dist/exec/run/job.js +81 -24
  50. package/dist/exec/run/lifecycle-commands.js +188 -36
  51. package/dist/exec/run/mode-shared.js +11 -3
  52. package/dist/exec/run/register-command.js +6 -10
  53. package/dist/exec/run/register-core.js +20 -13
  54. package/dist/exec/run/register-mode.js +12 -12
  55. package/dist/exec/run/register-post-review.js +21 -9
  56. package/dist/exec/run/register-resume.js +28 -18
  57. package/dist/exec/run/register-state.js +10 -7
  58. package/dist/exec/run/register-worktree.js +60 -30
  59. package/dist/exec/run/schedule-mode.js +4 -4
  60. package/dist/exec/run/schedule-prepare.js +201 -59
  61. package/dist/exec/run/schedule-task.js +129 -25
  62. package/dist/exec/run/shared.js +4 -3
  63. package/dist/exec/run/trailing-records.js +35 -0
  64. package/dist/exec/run-records.js +2 -0
  65. package/dist/exec/strategy.js +1 -0
  66. package/dist/exec/trailing-records.js +242 -0
  67. package/dist/exec/trial-commands.js +3 -2
  68. package/dist/exec/validate-records-commit.js +110 -0
  69. package/dist/exec/validate-records.js +148 -0
  70. package/dist/exec/worktree-command.js +29 -16
  71. package/dist/exec/worktree-ops-commit.js +119 -48
  72. package/dist/exec/worktree-ops-lifecycle.js +77 -48
  73. package/dist/exec/worktree-ops-merge.js +13 -2
  74. package/dist/exec/worktree-ops.js +2 -2
  75. package/dist/exec/worktree.js +19 -2
  76. package/dist/grade/apply.js +32 -6
  77. package/dist/grade/command-inspect.js +2 -2
  78. package/dist/grade/command-run.js +2 -0
  79. package/dist/grade/command-shared.js +1 -1
  80. package/dist/grade/core.js +18 -5
  81. package/dist/grade/markdown.js +3 -3
  82. package/dist/grade/pipeline-state.js +15 -11
  83. package/dist/grade/plan.js +37 -17
  84. package/dist/grade/result.js +3 -3
  85. package/dist/grade/run.js +23 -3
  86. package/dist/grade/target-discovery.js +17 -4
  87. package/dist/grade/targets.js +12 -11
  88. package/dist/job/job.js +31 -17
  89. package/dist/job/noop.js +104 -0
  90. package/dist/register/core.js +2 -0
  91. package/dist/register/create-commands.js +28 -3
  92. package/dist/register/deliverable-target.js +9 -1
  93. package/dist/register/epic.js +104 -26
  94. package/dist/register/event-merge.js +3 -0
  95. package/dist/register/events.js +4 -0
  96. package/dist/register/external-project.js +3 -0
  97. package/dist/register/item.js +6 -0
  98. package/dist/register/maintenance-commands.js +4 -1
  99. package/dist/register/planning.js +7 -14
  100. package/dist/register/register.js +43 -9
  101. package/dist/register/track-domains.js +34 -0
  102. package/dist/register/track-plan.js +78 -0
  103. package/dist/register/transition-commands.js +8 -0
  104. package/dist/register/work-table.js +64 -0
  105. package/dist/review/grade.js +35 -13
  106. package/dist/routine/definition.js +4 -3
  107. package/dist/routine/failure.js +30 -0
  108. package/dist/routine/routine.js +56 -32
  109. package/dist/routine/storage.js +33 -0
  110. package/dist/schedule/schedule.js +1 -0
  111. package/dist/schedule/strategy-generate-document.js +26 -14
  112. package/dist/schedule/strategy-generate-scope.js +17 -45
  113. package/dist/schedule/strategy-generate.js +33 -3
  114. package/dist/schedule/strategy-profiles.js +86 -12
  115. package/dist/shared/agent-types.js +2 -0
  116. package/dist/shared/condense-records.js +25 -0
  117. package/dist/shared/deprecation.js +8 -0
  118. package/dist/shared/document-metadata.js +20 -0
  119. package/dist/shared/finding-cause.js +20 -0
  120. package/dist/shared/frontmatter-namespace.js +48 -0
  121. package/dist/shared/git.js +142 -15
  122. package/dist/shared/grade-result.js +17 -1
  123. package/dist/shared/local-state.js +20 -0
  124. package/dist/shared/markdownlint-config.js +8 -3
  125. package/dist/shared/plan-conventions.js +129 -0
  126. package/dist/shared/plan-templates.js +57 -41
  127. package/dist/shared/run-records.js +224 -0
  128. package/dist/shared/specdojo-config.js +39 -21
  129. package/dist/shared/text.js +65 -5
  130. package/dist/shared/timeline-index.js +2 -0
  131. package/docs/ja/specdojo/defaults/pm-review-viewpoints.yaml +9 -2
  132. package/docs/ja/specdojo/exec-templates/xep-common-conventions-template.md +4 -74
  133. package/docs/ja/specdojo/exec-templates/xep-condense-template.md +50 -0
  134. package/docs/ja/specdojo/exec-templates/xep-draft-template.md +17 -5
  135. package/docs/ja/specdojo/exec-templates/xep-fully-guided-template.md +16 -3
  136. package/docs/ja/specdojo/exec-templates/xep-recipe-guided-template.md +15 -5
  137. package/docs/ja/specdojo/exec-templates/xep-recipe-maintenance-template.md +6 -0
  138. package/docs/ja/specdojo/exec-templates/xep-register-template.md +1 -1
  139. package/docs/ja/specdojo/exec-templates/xep-rulebook-maintenance-template.md +6 -0
  140. package/docs/ja/specdojo/exec-templates/xep-sample-maintenance-template.md +6 -0
  141. package/docs/ja/specdojo/exec-templates/xep-template-maintenance-template.md +6 -0
  142. package/docs/ja/specdojo/exec-templates/xer-condense-template.md +25 -0
  143. package/docs/ja/specdojo/exec-templates/xp-common-conventions-template.md +50 -0
  144. package/docs/ja/specdojo/exec-templates/xrp-common-conventions-template.md +30 -0
  145. package/docs/ja/specdojo/guides/branch-workflow-guide.md +1 -1
  146. package/docs/ja/specdojo/guides/docs-editing-guide.md +12 -0
  147. package/docs/ja/specdojo/guides/docs-structure-guide.md +48 -15
  148. package/docs/ja/specdojo/guides/exec-config-guide.md +47 -16
  149. package/docs/ja/specdojo/guides/exec-operation-guide.md +53 -17
  150. package/docs/ja/specdojo/guides/exec-worktree-guide.md +20 -11
  151. package/docs/ja/specdojo/guides/plan-result-lifecycle-guide.md +92 -55
  152. package/docs/ja/specdojo/guides/project-move-guide.md +381 -0
  153. package/docs/ja/specdojo/guides/quick-start-guide.md +70 -14
  154. package/docs/ja/specdojo/guides/register-operation-guide.md +25 -5
  155. package/docs/ja/specdojo/guides/remote-host-development-guide.md +2 -0
  156. package/docs/ja/specdojo/guides/review-guide.md +22 -19
  157. package/docs/ja/specdojo/guides/routine-operation-guide.md +14 -8
  158. package/docs/ja/specdojo/guides/ryu-guide.md +23 -13
  159. package/docs/ja/specdojo/guides/schedule-design-guide.md +7 -4
  160. package/docs/ja/specdojo/guides/schedule-operation-guide.md +27 -3
  161. package/docs/ja/specdojo/guides/specdojo-overview-guide.md +5 -4
  162. package/docs/ja/specdojo/guides/timeline-design-guide.md +27 -144
  163. package/docs/ja/specdojo/guides/use-case-guide.md +92 -155
  164. package/docs/ja/specdojo/recipes/bac-recipe.md +94 -0
  165. package/docs/ja/specdojo/recipes/bes-recipe.md +105 -0
  166. package/docs/ja/specdojo/recipes/br-recipe.md +84 -0
  167. package/docs/ja/specdojo/recipes/cdfd-uc-recipe.md +36 -24
  168. package/docs/ja/specdojo/recipes/cnd-recipe.md +125 -0
  169. package/docs/ja/specdojo/recipes/cpd-recipe.md +126 -0
  170. package/docs/ja/specdojo/recipes/cxd-recipe.md +145 -0
  171. package/docs/ja/specdojo/recipes/ifd-recipe.md +134 -0
  172. package/docs/ja/specdojo/recipes/ifx-cmd-recipe.md +135 -86
  173. package/docs/ja/specdojo/recipes/ifx-index-recipe.md +130 -0
  174. package/docs/ja/specdojo/recipes/pm-organization-recipe.md +29 -26
  175. package/docs/ja/specdojo/recipes/pm-plan-recipe.md +35 -26
  176. package/docs/ja/specdojo/recipes/pm-quality-management-plan-recipe.md +38 -28
  177. package/docs/ja/specdojo/recipes/pm-raci-recipe.md +39 -31
  178. package/docs/ja/specdojo/recipes/pm-roles-recipe.md +26 -28
  179. package/docs/ja/specdojo/recipes/prj-assumptions-constraints-dependencies-recipe.md +10 -8
  180. package/docs/ja/specdojo/recipes/prj-comparison-of-alternatives-recipe.md +18 -17
  181. package/docs/ja/specdojo/recipes/stsd-recipe.md +100 -62
  182. package/docs/ja/specdojo/recipes/sysd-critical-flows-recipe.md +106 -0
  183. package/docs/ja/specdojo/recipes/sysd-cross-cutting-policy-recipe.md +137 -0
  184. package/docs/ja/specdojo/recipes/sysd-index-recipe.md +122 -0
  185. package/docs/ja/specdojo/references/command-reference.md +79 -64
  186. package/docs/ja/specdojo/references/deliverables-reference.md +9 -4
  187. package/docs/ja/specdojo/references/directory-layout-reference.md +3 -2
  188. package/docs/ja/specdojo/references/specdojo-config-reference.md +17 -16
  189. package/docs/ja/specdojo/rulebooks/bac-rulebook.md +72 -290
  190. package/docs/ja/specdojo/rulebooks/bdd-rulebook.md +212 -79
  191. package/docs/ja/specdojo/rulebooks/bds-rulebook.md +138 -154
  192. package/docs/ja/specdojo/rulebooks/bes-index-rulebook.md +147 -59
  193. package/docs/ja/specdojo/rulebooks/bes-rulebook.md +100 -96
  194. package/docs/ja/specdojo/rulebooks/br-rulebook.md +88 -108
  195. package/docs/ja/specdojo/rulebooks/ccd-mermaid-rulebook.md +126 -211
  196. package/docs/ja/specdojo/rulebooks/cdfd-uc-rulebook.md +56 -35
  197. package/docs/ja/specdojo/rulebooks/cdsd-rulebook.md +102 -68
  198. package/docs/ja/specdojo/rulebooks/cdt-rulebook.md +152 -0
  199. package/docs/ja/specdojo/rulebooks/cld-rulebook.md +9 -184
  200. package/docs/ja/specdojo/rulebooks/clis-rulebook.md +187 -0
  201. package/docs/ja/specdojo/rulebooks/cnd-rulebook.md +93 -247
  202. package/docs/ja/specdojo/rulebooks/cpd-rulebook.md +104 -241
  203. package/docs/ja/specdojo/rulebooks/cxd-rulebook.md +124 -257
  204. package/docs/ja/specdojo/rulebooks/dct-index-rulebook.md +87 -98
  205. package/docs/ja/specdojo/rulebooks/dct-rulebook.md +9 -7
  206. package/docs/ja/specdojo/rulebooks/dec-rulebook.md +2 -1
  207. package/docs/ja/specdojo/rulebooks/dss-rulebook.md +193 -0
  208. package/docs/ja/specdojo/rulebooks/gl-rulebook.md +100 -54
  209. package/docs/ja/specdojo/rulebooks/ifd-mermaid-rulebook.md +69 -252
  210. package/docs/ja/specdojo/rulebooks/ifx-cmd-rulebook.md +91 -76
  211. package/docs/ja/specdojo/rulebooks/ifx-file-rulebook.md +252 -226
  212. package/docs/ja/specdojo/rulebooks/ifx-index-rulebook.md +118 -40
  213. package/docs/ja/specdojo/rulebooks/imp-business-rulebook.md +11 -11
  214. package/docs/ja/specdojo/rulebooks/imp-data-rulebook.md +9 -9
  215. package/docs/ja/specdojo/rulebooks/imp-interface-rulebook.md +4 -4
  216. package/docs/ja/specdojo/rulebooks/imp-operations-rulebook.md +11 -11
  217. package/docs/ja/specdojo/rulebooks/imp-test-rulebook.md +11 -11
  218. package/docs/ja/specdojo/rulebooks/mm-rulebook.md +4 -3
  219. package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +34 -29
  220. package/docs/ja/specdojo/rulebooks/pm-change-request-log-rulebook.md +8 -8
  221. package/docs/ja/specdojo/rulebooks/pm-issue-log-rulebook.md +2 -2
  222. package/docs/ja/specdojo/rulebooks/pm-organization-rulebook.md +50 -56
  223. package/docs/ja/specdojo/rulebooks/pm-plan-rulebook.md +46 -55
  224. package/docs/ja/specdojo/rulebooks/pm-quality-management-plan-rulebook.md +57 -54
  225. package/docs/ja/specdojo/rulebooks/pm-raci-rulebook.md +50 -65
  226. package/docs/ja/specdojo/rulebooks/pm-risk-register-rulebook.md +2 -2
  227. package/docs/ja/specdojo/rulebooks/pm-roles-rulebook.md +70 -97
  228. package/docs/ja/specdojo/rulebooks/pr-rulebook.md +2 -1
  229. package/docs/ja/specdojo/rulebooks/prj-assumptions-constraints-dependencies-rulebook.md +47 -56
  230. package/docs/ja/specdojo/rulebooks/prj-comparison-of-alternatives-rulebook.md +61 -135
  231. package/docs/ja/specdojo/rulebooks/sf-index-rulebook.md +116 -32
  232. package/docs/ja/specdojo/rulebooks/sf-rulebook.md +118 -61
  233. package/docs/ja/specdojo/rulebooks/sld-rulebook.md +152 -57
  234. package/docs/ja/specdojo/rulebooks/stsd-mermaid-rulebook.md +51 -39
  235. package/docs/ja/specdojo/rulebooks/stsd-rulebook.md +101 -46
  236. package/docs/ja/specdojo/rulebooks/sysd-critical-flows-rulebook.md +72 -329
  237. package/docs/ja/specdojo/rulebooks/sysd-cross-cutting-policy-rulebook.md +74 -263
  238. package/docs/ja/specdojo/rulebooks/sysd-index-rulebook.md +78 -195
  239. package/docs/ja/specdojo/rulebooks/tml-rulebook.md +4 -9
  240. package/docs/ja/specdojo/rulebooks/trc-requirements-to-specs-rulebook.md +3 -4
  241. package/docs/ja/specdojo/rulebooks/trc-requirements-to-tests-rulebook.md +3 -3
  242. package/docs/ja/specdojo/rulebooks/uis-rulebook.md +140 -143
  243. package/docs/ja/specdojo/samples/bac-sample.md +106 -21
  244. package/docs/ja/specdojo/samples/bdd-sample.yaml +143 -35
  245. package/docs/ja/specdojo/samples/bds-sample.md +100 -21
  246. package/docs/ja/specdojo/samples/bes-index-sample.md +59 -20
  247. package/docs/ja/specdojo/samples/bes-sample.md +80 -21
  248. package/docs/ja/specdojo/samples/br-sample.md +68 -14
  249. package/docs/ja/specdojo/samples/ccd-sample.md +81 -19
  250. package/docs/ja/specdojo/samples/cdfd-sample.md +172 -99
  251. package/docs/ja/specdojo/samples/cdfd-uc-sample.md +9 -7
  252. package/docs/ja/specdojo/samples/cdsd-sample.md +89 -20
  253. package/docs/ja/specdojo/samples/cdt-sample.md +116 -0
  254. package/docs/ja/specdojo/samples/cld-sample.md +3 -30
  255. package/docs/ja/specdojo/samples/clis-sample.md +132 -0
  256. package/docs/ja/specdojo/samples/cnd-sample.md +127 -21
  257. package/docs/ja/specdojo/samples/cpd-sample.md +136 -22
  258. package/docs/ja/specdojo/samples/cxd-sample.md +108 -22
  259. package/docs/ja/specdojo/samples/dct-index-sample.yaml +63 -17
  260. package/docs/ja/specdojo/samples/dss-sample.md +175 -0
  261. package/docs/ja/specdojo/samples/gl-sample.yaml +50 -14
  262. package/docs/ja/specdojo/samples/ifd-sample.md +105 -21
  263. package/docs/ja/specdojo/samples/ifx-cmd-sample.yaml +91 -60
  264. package/docs/ja/specdojo/samples/ifx-file-sample.md +462 -21
  265. package/docs/ja/specdojo/samples/ifx-index-sample.yaml +87 -19
  266. package/docs/ja/specdojo/samples/pm-members-sample.yaml +37 -13
  267. package/docs/ja/specdojo/samples/pm-organization-sample.md +52 -20
  268. package/docs/ja/specdojo/samples/pm-plan-sample.md +84 -26
  269. package/docs/ja/specdojo/samples/pm-quality-management-plan-sample.md +55 -22
  270. package/docs/ja/specdojo/samples/pm-raci-sample.md +69 -28
  271. package/docs/ja/specdojo/samples/pm-roles-sample.yaml +13 -12
  272. package/docs/ja/specdojo/samples/prj-assumptions-constraints-dependencies-sample.md +50 -26
  273. package/docs/ja/specdojo/samples/prj-comparison-of-alternatives-sample.md +89 -62
  274. package/docs/ja/specdojo/samples/sf-index-sample.md +89 -20
  275. package/docs/ja/specdojo/samples/sf-sample.md +121 -21
  276. package/docs/ja/specdojo/samples/sld-sample.md +107 -21
  277. package/docs/ja/specdojo/samples/stsd-sample.md +54 -26
  278. package/docs/ja/specdojo/samples/sysd-critical-flows-sample.md +166 -21
  279. package/docs/ja/specdojo/samples/sysd-cross-cutting-policy-sample.md +178 -21
  280. package/docs/ja/specdojo/samples/sysd-index-sample.md +82 -21
  281. package/docs/ja/specdojo/samples/tml-sample.yaml +4 -1
  282. package/docs/ja/specdojo/samples/uis-sample.md +164 -20
  283. package/docs/ja/specdojo/standards/document-metadata-standard.md +33 -4
  284. package/docs/ja/specdojo/standards/id-and-file-naming-standard.md +3 -1
  285. package/docs/ja/specdojo/standards/rulebook-authoring-standard.md +1 -0
  286. package/docs/ja/specdojo/templates/bac-template.md +76 -0
  287. package/docs/ja/specdojo/templates/bes-template.md +56 -0
  288. package/docs/ja/specdojo/templates/br-template.md +64 -0
  289. package/docs/ja/specdojo/templates/cdfd-template.md +81 -54
  290. package/docs/ja/specdojo/templates/cdfd-uc-template.md +9 -5
  291. package/docs/ja/specdojo/templates/cnd-template.md +137 -0
  292. package/docs/ja/specdojo/templates/cpd-template.md +129 -0
  293. package/docs/ja/specdojo/templates/cxd-template.md +105 -0
  294. package/docs/ja/specdojo/templates/dct-data-model-cdt-template.yaml +40 -0
  295. package/docs/ja/specdojo/templates/dct-data-model-cld-template.yaml +7 -14
  296. package/docs/ja/specdojo/templates/dct-index-template.md +9 -20
  297. package/docs/ja/specdojo/templates/dct-project-management-template.yaml +5 -1
  298. package/docs/ja/specdojo/templates/ifd-template.md +86 -0
  299. package/docs/ja/specdojo/templates/ifx-cmd-template.yaml +44 -28
  300. package/docs/ja/specdojo/templates/ifx-index-template.yaml +40 -0
  301. package/docs/ja/specdojo/templates/opr-template.md +2 -4
  302. package/docs/ja/specdojo/templates/pm-organization-template.md +9 -3
  303. package/docs/ja/specdojo/templates/pm-plan-template.md +4 -4
  304. package/docs/ja/specdojo/templates/pm-quality-management-plan-template.md +17 -9
  305. package/docs/ja/specdojo/templates/pm-raci-template.md +24 -13
  306. package/docs/ja/specdojo/templates/pm-roles-template.yaml +3 -2
  307. package/docs/ja/specdojo/templates/prj-assumptions-constraints-dependencies-template.md +6 -3
  308. package/docs/ja/specdojo/templates/prj-comparison-of-alternatives-template.md +22 -19
  309. package/docs/ja/specdojo/templates/stsd-template.md +46 -21
  310. package/docs/ja/specdojo/templates/sysd-critical-flows-template.md +94 -0
  311. package/docs/ja/specdojo/templates/sysd-cross-cutting-policy-template.md +122 -0
  312. package/docs/ja/specdojo/templates/sysd-index-template.md +89 -0
  313. package/docs/specdojo/lib/yaml-metadata.cjs +7 -0
  314. package/docs/specdojo/schemas/v1/bdd.schema.yaml +25 -57
  315. package/docs/specdojo/schemas/v1/condense-records.schema.yaml +26 -0
  316. package/docs/specdojo/schemas/v1/dct.schema.yaml +10 -0
  317. package/docs/specdojo/schemas/v1/deliverable-frontmatter.schema.yaml +3 -0
  318. package/docs/specdojo/schemas/v1/esil.schema.yaml +7 -141
  319. package/docs/specdojo/schemas/v1/exec-common.schema.yaml +3 -0
  320. package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +53 -3
  321. package/docs/specdojo/schemas/v1/exec-evidence.schema.yaml +3 -0
  322. package/docs/specdojo/schemas/v1/exec-plan-frontmatter.schema.yaml +14 -0
  323. package/docs/specdojo/schemas/v1/exec-result-frontmatter.schema.yaml +18 -0
  324. package/docs/specdojo/schemas/v1/finding-cause.schema.yaml +22 -0
  325. package/docs/specdojo/schemas/v1/grade-pipeline-state.schema.yaml +1 -1
  326. package/docs/specdojo/schemas/v1/grade-result.schema.yaml +2 -0
  327. package/docs/specdojo/schemas/v1/ifx-cmd.schema.yaml +65 -5
  328. package/docs/specdojo/schemas/v1/ifx-index.schema.yaml +142 -0
  329. package/docs/specdojo/schemas/v1/register-events.schema.yaml +2 -0
  330. package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +17 -1
  331. package/package.json +2 -2
  332. package/templates/antigravity/orchestrator.md +3 -2
  333. package/templates/claude/agents/specdojo-orchestrator.md +3 -2
  334. package/templates/codex/agents/specdojo-orchestrator.toml +3 -2
  335. package/templates/codex/orchestrator.md +3 -2
  336. package/templates/devcontainer/tmux.conf +6 -0
  337. package/templates/opencode/agents/specdojo-orchestrator.md +3 -2
@@ -45,7 +45,6 @@ Use Case Guide
45
45
  - [LP を作る](#case-lp)
46
46
  - [Next.js の Web サービスを作る](#case-nextjs)
47
47
  - [Unity のゲームを作る](#case-unity)
48
- - [共通運用と品質管理を確認する](#common-operations)
49
48
 
50
49
  ```mermaid
51
50
  flowchart TD
@@ -53,19 +52,19 @@ flowchart TD
53
52
  Q -->|ランディングページ| C1["ケース1: ランディングページ(LP)<br/>静的サイト・訴求・問い合わせ"]
54
53
  Q -->|Webサービス・SaaS| C2["ケース2: Next.js Webサービス<br/>認証・API・DB連携フルスタック"]
55
54
  Q -->|ゲーム開発| C3["ケース3: Unityゲーム<br/>2D/3D・C#ロジック・ステート管理"]
56
- Q -->|共通の運用・品質管理| C4["共通運用と品質管理<br/>レビュー・隔離実行・ルーチン"]
57
55
 
58
56
  C1 --> D1["1. 最初の相談と確認事項<br/>2. 成果物定義とカタログ<br/>3. register / schedule 進行<br/>4. プレビュー確認と運用"]
59
57
  C2 --> D2["1. 要件・技術スタック確認<br/>2. データモデル・API仕様<br/>3. 文書の schedule と実装 todo<br/>4. テスト検証と運用"]
60
58
  C3 --> D3["1. ゲームルール・役割分担<br/>2. システム・ステート設計<br/>3. C#スクリプト隔離実行<br/>4. Playモード確認と調整"]
61
- C4 --> D4["・register(課題・判断・調査)<br/>・review(grade照合)と人の確定<br/>・worktree(安全な隔離実行)<br/>・routine(定期実行・日次巡回)"]
62
59
 
63
60
  classDef caseNode fill:#e7f5ff,stroke:#1971c2,color:#000;
64
61
  classDef detailNode fill:#f8f9fa,stroke:#adb5bd,color:#000;
65
- class C1,C2,C3,C4 caseNode;
66
- class D1,D2,D3,D4 detailNode;
62
+ class C1,C2,C3 caseNode;
63
+ class D1,D2,D3 detailNode;
67
64
  ```
68
65
 
66
+ どのケースでも、計画外の課題・判断の管理(register)、レビューと人の確定、worktree による隔離実行、routine による定期実行を使います。これらは「[プロダクト開発に共通する運用と品質管理](#common-operations)」にまとめています。
67
+
69
68
  <a id="common-setup"></a>
70
69
 
71
70
  ### 1.1. 各ケースに共通する準備
@@ -150,42 +149,29 @@ human の確定タスクは [共通のレビュー手順](#review-and-finalize)
150
149
 
151
150
  利用者がオーケストレーターに LP 作成の相談を開始します。オーケストレーターは必要な情報をヒアリングし、利用者の承認を得て進めます。
152
151
 
153
- **利用者**:
154
-
155
- > 新サービスの告知用ランディングページを作りたいです。どんな構成で進めればよいでしょうか?
156
-
157
- **オーケストレーター**:
158
-
159
- > ランディングページの作成ですね。仕様を整理し、スムーズに AI へ実装を委譲できるように進めましょう。
160
- >
161
- > まず、以下の点についてご希望や前提を確認させてください:
162
- >
163
- > 1. **主なセクション**: Hero(トップ訴求)、特徴・強み、料金プラン、FAQ、問い合わせ/事前登録フォームなどを想定しますが、含めたい内容はありますか?
164
- > 2. **技術スタック**: 高速な静的生成に向く Astro + Tailwind CSS、Next.js、シンプルな HTML/CSS などの選択肢があります。ご希望はありますか?
165
- > 3. **公開先(ホスティング)**: Cloudflare Pages、GitHub Pages、Vercel などの候補があります。
166
- > 4. **担当者と目標期限**: プロジェクト管理の記録(個票)に残す担当者ニックネームと目標期日をお知らせください。
167
- >
168
- > ご回答をもとに、技術選定の判断(decision)とプロジェクト定義(todo)の起票案を作成してご提示します。
169
-
170
- **利用者**:
171
-
172
- > 1. セクションは Hero、特徴3つ、料金プラン表、FAQ、問い合わせフォームでお願いします。
173
- > 2. 技術は Astro + Tailwind CSS で進めたいです。
174
- > 3. 公開先は Cloudflare Pages を想定しています。
175
- > 4. 担当は alice、期限は 2026-12-15 でお願いします。
152
+ ```chat
153
+ 利用者: 新サービスの告知用ランディングページを作りたいです。どんな構成で進めればよいでしょうか?
176
154
 
177
- **オーケストレーター**:
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)の起票案を作成してご提示します。
178
162
 
179
- > 承知しました。以下の内容で登録簿へ起票してよろしいでしょうか?
180
- >
181
- > - **decision**: `Astro + Tailwind CSS と Cloudflare Pages による LP 構成の採択`(担当: alice, 期限: 2026-12-15)
182
- > - **todo**: `プロジェクト定義書と LP 画面仕様書の作成`(担当: alice, 期限: 2026-12-15)
183
- >
184
- > 承認いただければ、起票コマンドを実行します。
163
+ 利用者: 1. セクションは Hero、特徴3つ、料金プラン表、FAQ、問い合わせフォームでお願いします。
164
+ 2. 技術は Astro + Tailwind CSS で進めたいです。
165
+ 3. 公開先は Cloudflare Pages を想定しています。
166
+ 4. 担当は alice、期限は 2026-12-15 でお願いします。
185
167
 
186
- **利用者**:
168
+ オーケストレーター: 承知しました。以下の内容で登録簿へ起票してよろしいでしょうか?
169
+ - **decision**: `Astro + Tailwind CSS と Cloudflare Pages による LP 構成の採択`(担当: alice, 期限: 2026-12-15)
170
+ - **todo**: `プロジェクト定義書と LP 画面仕様書の作成`(担当: alice, 期限: 2026-12-15)
171
+ 承認いただければ、起票コマンドを実行します。
187
172
 
188
- > はい、承認します。実行してください。
173
+ 利用者: はい、承認します。実行してください。
174
+ ```
189
175
 
190
176
  ### 2.3. 必要な成果物と作成順序
191
177
 
@@ -200,41 +186,31 @@ LP 作成で推奨される成果物と作成順序は次のとおりです。
200
186
 
201
187
  [文書と実装の進行経路](#document-and-product-flow)に沿って、UI 仕様書等を register または文書の schedule で作成・レビューします。フォームは送信先、個人情報の扱い、成功・失敗時の表示を確認し、未決なら question / decision に残します。
202
188
 
203
- **利用者**:
204
-
205
- > 画面仕様書を確定しました。コンポーネントの実装を進めてください。
206
-
207
- **オーケストレーター**:
208
-
209
- > 確定した仕様書と、接続済みの `lp-site` を確認します。まず Hero の文言と PC・スマホ表示を実装する todo を提案します。対象は Hero のコンポーネントと関連スタイル、完了条件は仕様どおりの表示と合意済みの検証の成功です。フォームは送信方式の決定後に別の todo にします。担当 alice、期限 2026-12-15 を引き継いでよいですか?
210
-
211
- **利用者**:
189
+ ```chat
190
+ 利用者: 画面仕様書を確定しました。コンポーネントの実装を進めてください。
212
191
 
213
- > はい。その範囲で起票し、worktree で実行してください。
192
+ オーケストレーター: 確定した仕様書と、接続済みの `lp-site` を確認します。まず Hero の文言と PC・スマホ表示を実装する todo を提案します。対象は Hero のコンポーネントと関連スタイル、完了条件は仕様どおりの表示と合意済みの検証の成功です。フォームは送信方式の決定後に別の todo にします。担当 alice、期限 2026-12-15 を引き継いでよいですか?
214
193
 
215
- **オーケストレーター**:
194
+ 利用者: はい。その範囲で起票し、worktree で実行してください。
216
195
 
217
- > 起票結果の PJR-ID を指定して実行します。executor が実装・検証結果を報告し、runner が設定済みの親検証と commit・統合を担当します。統合先は承認済み設定に従います。完了後に差分・検証記録とプレビューを確認していただきます。
196
+ オーケストレーター: 起票結果の PJR-ID を指定して実行します。executor が実装・検証結果を報告し、runner が設定済みの親検証と commit・統合を担当します。統合先は承認済み設定に従います。完了後に差分・検証記録とプレビューを確認していただきます。
197
+ ```
218
198
 
219
199
  #### 2.4.1. 実行後の確認対話
220
200
 
221
- **オーケストレーター**:
222
-
223
- > Hero の差分と検証記録を提示します。PC・スマホ表示と文言を確認し、受け入れ可能か判断してください。フォームの送信確認は後続 todo の範囲です。
224
-
225
- **利用者**:
201
+ ```chat
202
+ オーケストレーター: Hero の差分と検証記録を提示します。PC・スマホ表示と文言を確認し、受け入れ可能か判断してください。フォームの送信確認は後続 todo の範囲です。
226
203
 
227
- > スマホでは見出しが長すぎます。文言を短くしてから、残りのセクションへ進めてください。
204
+ 利用者: スマホでは見出しが長すぎます。文言を短くしてから、残りのセクションへ進めてください。
228
205
 
229
- **オーケストレーター**:
230
-
231
- > 文言の修正案と対象仕様書への反映を提案し、合意した変更を記録して再検証します。受け入れ確認後に次の todo へ進みます。
206
+ オーケストレーター: 文言の修正案と対象仕様書への反映を提案し、合意した変更を記録して再検証します。受け入れ確認後に次の todo へ進みます。
207
+ ```
232
208
 
233
209
  ### 2.5. 完成確認と変更・運用への流れ
234
210
 
235
211
  - **手元での確認**: プロダクトで用意したプレビュー手順(`dev` script があれば `npm run dev`)で PC・スマートフォンの表示、フォームの入力検証・送信結果を確認します。公開は利用者が内容と公開先を確認してから行います。
236
212
  - **変更の管理**: コピー文言の変更やデザイン調整の要望が出た場合は、勝手にコードを直さず `register add --type todo` で起票して履歴を残します。
237
- - **運用の自動化**: デッドリンクの検査やライブラリのセキュリティ更新は、[[specdojo:routine-operation-guide|routine 運用ガイド]] に従って必要な検査ジョブと外部スケジューラを用意します。共通の変更管理・レビューは [第 5 章](#common-operations)を参照してください。
213
+ - **運用の自動化**: デッドリンクの検査やライブラリのセキュリティ更新は、[[specdojo:routine-operation-guide|routine 運用ガイド]] に従って必要な検査ジョブと外部スケジューラを用意します。共通の変更管理・レビューは 「[プロダクト開発に共通する運用と品質管理](#common-operations)」を参照してください。
238
214
 
239
215
  ### 2.6. コマンドと設定差分(折りたたみ)
240
216
 
@@ -287,44 +263,30 @@ LP 向けの用途別ひな型を先に整備する方針です。本ガイド
287
263
 
288
264
  ### 3.2. 最初の相談と確認・判断事項
289
265
 
290
- **利用者**:
291
-
292
- > Next.js でユーザー認証とデータ管理機能がある Web サービスを開発したいです。仕様決めから実装までの流れを案内してください。
293
-
294
- **オーケストレーター**:
295
-
296
- > フルスタック Web サービスの構築ですね。セキュリティやデータ整合性が重要になりますので、段階を踏んで仕様を固めましょう。
297
- >
298
- > 以下の事項について、現時点の想定をお聞かせいただけますか?
299
- >
300
- > 1. **主要な機能要件**: ユーザー登録・ログイン、ダッシュボード表示、データの一覧・登録・編集・削除などを想定していますが、他に必要な機能はありますか?
301
- > 2. **認証と DB の技術スタック**: NextAuth (Auth.js) / Supabase / Clerk などの認証方式や、Prisma / Drizzle などの ORM、DB(PostgreSQL / SQLite 等)のご希望はありますか?
302
- > 3. **デプロイ先環境**: Vercel、Cloudflare(OpenNext)、AWS などの想定はありますか?
303
- > 4. **担当者と期限**: プロジェクト管理上の担当者ニックネームと目標完了日をお知らせください。
304
- >
305
- > ご提示いただいた条件をもとに、アーキテクチャ検討の decision と要件定義の todo を提案します。
306
-
307
- **利用者**:
308
-
309
- > 1. 機能はユーザー登録・ログイン、プロジェクト一覧と作成、アイテムの CRUD 管理です。
310
- > 2. 認証は NextAuth.js、ORM は Prisma、DB は PostgreSQL を使いたいです。
311
- > 3. デプロイ先は Vercel を予定しています。
312
- > 4. 担当は bob、期限は 2026-12-31 でお願いします。
313
-
314
- **オーケストレーター**:
315
-
316
- > ありがとうございます。内容を整理しました。
317
- >
318
- > 以下の起票を行ってよろしいでしょうか?
319
- >
320
- > - **decision**: `NextAuth.js + Prisma (PostgreSQL) による認証・DB 基盤の採択`(担当: bob, 期限: 2026-12-31)
321
- > - **todo**: `データモデル設計書(CCD/CDSD)と API インターフェース仕様書の作成`(担当: bob, 期限: 2026-12-31)
322
- >
323
- > 承認をいただければ起票します。
324
-
325
- **利用者**:
326
-
327
- > はい、承認します。
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
+ ```
328
290
 
329
291
  ### 3.3. 必要な成果物と作成順序
330
292
 
@@ -344,27 +306,21 @@ Next.js アプリケーションでは、フロントエンドとバックエン
344
306
  - **Phase 2(バックエンド・API 実装)**: データアクセス層、Server Actions / API ルートの実装、単体テスト。
345
307
  - **Phase 3(フロントエンド実装)**: 画面コンポーネント、フォームバリデーション、データ取得フック。
346
308
 
347
- **利用者**:
348
-
349
- > データモデルと API 仕様を確定しました。最初はプロジェクト一覧 API の実装をお願いします。
309
+ ```chat
310
+ 利用者: データモデルと API 仕様を確定しました。最初はプロジェクト一覧 API の実装をお願いします。
350
311
 
351
- **オーケストレーター**:
312
+ オーケストレーター: `saas-app` の接続、認証基盤と開発 DB の準備を確認します。今回の todo は一覧 API と権限検査、関連テストを対象にします。bob、2026-12-31 のまま進めてよいですか? 本番 DB の変更は別途判断します。
352
313
 
353
- > `saas-app` の接続、認証基盤と開発 DB の準備を確認します。今回の todo は一覧 API と権限検査、関連テストを対象にします。bob、2026-12-31 のまま進めてよいですか? 本番 DB の変更は別途判断します。
314
+ 利用者: はい。その範囲で起票して実行してください。
354
315
 
355
- **利用者**:
356
-
357
- > はい。その範囲で起票して実行してください。
358
-
359
- **オーケストレーター**:
360
-
361
- > 採番された todo を `exec run --register` の対象にし、worktree で実行します。`typecheck` やテストは、プロダクト側に script・依存関係・DB 等が用意され、実行設定に組み込まれているものを実行します。未準備の検証は完了扱いにせず、準備方法を記録します。
316
+ オーケストレーター: 採番された todo を `exec run --register` の対象にし、worktree で実行します。`typecheck` やテストは、プロダクト側に script・依存関係・DB 等が用意され、実行設定に組み込まれているものを実行します。未準備の検証は完了扱いにせず、準備方法を記録します。
317
+ ```
362
318
 
363
319
  ### 3.5. 完成確認と変更・運用への流れ
364
320
 
365
321
  - **結合テストと検証**: 合意した開発 DB とテストデータを用意し、ログイン、データ作成、他ユーザーのデータへのアクセス拒否、ログアウトを確認します。E2E テストが準備済みなら実行し、利用者が受け入れと公開可否を判断します。
366
322
  - **セキュリティチェック**: 依存関係・静的解析・秘密情報の検査を候補に、公開先や契約条件に合う手段を選びます。CI やリポジトリ設定の変更案は利用者に提示し、承認された手段を準備します。
367
- - **不具合や改善のトリアージ**: 開発中に発生した不具合は `register add --type issue` で起票し、AI に原因調査と修正を行わせます。詳細は [[specdojo:register-operation-guide|登録簿運用ガイド]] と [第 5 章](#common-operations)を参照してください。
323
+ - **不具合や改善のトリアージ**: 開発中に発生した不具合は `register add --type issue` で起票し、AI に原因調査と修正を行わせます。詳細は [[specdojo:register-operation-guide|登録簿運用ガイド]] と 「[プロダクト開発に共通する運用と品質管理](#common-operations)」を参照してください。
368
324
 
369
325
  ### 3.6. コマンドと設定差分(折りたたみ)
370
326
 
@@ -419,42 +375,29 @@ npx specdojo exec run --project prj-0001 --register "<APIの起票結果のPJR-I
419
375
 
420
376
  ゲーム開発では、アセットやバイナリの扱い、エディタでの手作業と AI が行うスクリプト実装の分担を最初に明確にする必要があります。
421
377
 
422
- **利用者**:
423
-
424
- > Unity で 2D アクションゲームを制作したいです。仕様設計を行い、C# スクリプトの実装を AI に任せながら進めたいです。
378
+ ```chat
379
+ 利用者: Unity で 2D アクションゲームを制作したいです。仕様設計を行い、C# スクリプトの実装を AI に任せながら進めたいです。
425
380
 
426
- **オーケストレーター**:
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 を起票します。
427
388
 
428
- > Unity ゲームの開発ですね。エディタでの Scene/Prefab 構築と、AI が担当する C# スクリプトやデータ設計の役割分担を整理して進めましょう。
429
- >
430
- > 以下の事項について確認させてください:
431
- >
432
- > 1. **ゲームのコアルール**: ジャンル、基本アクション(移動・ジャンプ・攻撃等)、クリア・ゲームオーバー条件を教えてください。
433
- > 2. **AI の担当範囲**: AI に任せるのは C# ロジック(プレイヤー操作、敵ステートマシン、スコア管理など)とパラメータ定義(ScriptableObject)でしょうか? Scene への Prefab 配置やスプライト描画は人間が担当する想定で合っていますか?
434
- > 3. **バージョンとパッケージ**: Unity バージョン(例: 2022.3 LTS)や、新しい Input System パッケージの使用有無を教えてください。
435
- > 4. **担当者と期限**: 記録に残す担当者ニックネームと目標マイルストーン期限をお知らせください。
436
- >
437
- > ご確認いただければ、役割分担と基本アーキテクチャの decision、およびゲーム仕様設計の todo を起票します。
389
+ 利用者: 1. 2D 横スクロールアクションで、移動・ジャンプと敵の踏みつけ、コイン収集でゴールを目指します。
390
+ 2. はい、AI には C# スクリプトと ScriptableObject の作成を任せ、Scene 配置やアニメーション設定、Sprite の配置は私がエディタで行います。
391
+ 3. Unity 2022.3 LTS で、Input System パッケージを使用します。
392
+ 4. 担当は carol、プロトタイプ完成期限は 2027-01-31 でお願いします。
438
393
 
439
- **利用者**:
394
+ オーケストレーター: 方針を把握しました。エディタ作業と AI スクリプト生成の境界を明確にした上で、以下を起票してよろしいでしょうか?
395
+ - **decision**: `Input System 採用と AI・人間作業境界の合意`(担当: carol, 期限: 2027-01-31)
396
+ - **todo**: `ゲームシステム設計書(ステートマシン・パラメータ定義)の作成`(担当: carol, 期限: 2027-01-31)
397
+ 承認いただければ実行します。
440
398
 
441
- > 1. 2D 横スクロールアクションで、移動・ジャンプと敵の踏みつけ、コイン収集でゴールを目指します。
442
- > 2. はい、AI には C# スクリプトと ScriptableObject の作成を任せ、Scene 配置やアニメーション設定、Sprite の配置は私がエディタで行います。
443
- > 3. Unity 2022.3 LTS で、Input System パッケージを使用します。
444
- > 4. 担当は carol、プロトタイプ完成期限は 2027-01-31 でお願いします。
445
-
446
- **オーケストレーター**:
447
-
448
- > 方針を把握しました。エディタ作業と AI スクリプト生成の境界を明確にした上で、以下を起票してよろしいでしょうか?
449
- >
450
- > - **decision**: `Input System 採用と AI・人間作業境界の合意`(担当: carol, 期限: 2027-01-31)
451
- > - **todo**: `ゲームシステム設計書(ステートマシン・パラメータ定義)の作成`(担当: carol, 期限: 2027-01-31)
452
- >
453
- > 承認いただければ実行します。
454
-
455
- **利用者**:
456
-
457
- > 承認します。起票してください。
399
+ 利用者: 承認します。起票してください。
400
+ ```
458
401
 
459
402
  ### 4.3. 必要な成果物と作成順序
460
403
 
@@ -474,27 +417,21 @@ Unity 開発では、ロジックとエディタ設定が乖離しないよう
474
417
  - **Enemy State Machine 実装**: 状態遷移パターンに基づき、検知範囲内のプレイヤーを追従するスクリプト。
475
418
  - **Game Manager & UI 連動**: イベント駆動でコイン取得数やライフ残量を更新する仕組み。
476
419
 
477
- **利用者**:
420
+ ```chat
421
+ 利用者: 入力仕様とプレイヤーの状態遷移を確定しました。移動とジャンプから実装してください。
478
422
 
479
- > 入力仕様とプレイヤーの状態遷移を確定しました。移動とジャンプから実装してください。
423
+ オーケストレーター: `unity-game` の Player Controller と関連テストを対象にした todo を提案します。Scene、Prefab、入力アセットとの接続は carol さんが行う合意とし、担当 carol、期限 2027-01-31 を引き継いでよいですか?
480
424
 
481
- **オーケストレーター**:
425
+ 利用者: はい。スクリプトの実装を起票して実行してください。エディタで接続して確認します。
482
426
 
483
- > `unity-game` の Player Controller と関連テストを対象にした todo を提案します。Scene、Prefab、入力アセットとの接続は carol さんが行う合意とし、担当 carol、期限 2027-01-31 を引き継いでよいですか?
484
-
485
- **利用者**:
486
-
487
- > はい。スクリプトの実装を起票して実行してください。エディタで接続して確認します。
488
-
489
- **オーケストレーター**:
490
-
491
- > 採番された todo を指定して worktree で実行します。executor は C# と関連テストを編集し、用意された検証を実行します。Unity のライセンスやバッチ実行環境が必要な検査、Play モードの操作確認は実行可能な環境で行い、未確認の項目を結果に残します。runner が commit と承認済み設定に沿った統合を行います。
427
+ オーケストレーター: 採番された todo を指定して worktree で実行します。executor は C# と関連テストを編集し、用意された検証を実行します。Unity のライセンスやバッチ実行環境が必要な検査、Play モードの操作確認は実行可能な環境で行い、未確認の項目を結果に残します。runner が commit と承認済み設定に沿った統合を行います。
428
+ ```
492
429
 
493
430
  ### 4.5. 完成確認と変更・運用への流れ
494
431
 
495
432
  - **Unity エディタでの結合確認**: AI が作成した C# スクリプトを Prefab や GameObject にアタッチし、エディタの Play モードで操作感や当たり判定を確認します。
496
433
  - **単体テストの実行**: ロジック部分(ステート遷移やダメージ計算)は、Unity Test Framework と実行環境を準備した上で EditMode / PlayMode テストを実行します。人が Play モードで操作感・クリア条件を確認し、受け入れと配布可否を判断します。
497
- - **パラメータ調整とバグ報告**: ジャンプ力や移動速度の微調整は ScriptableObject 上で行います。挙動の不具合が見つかった場合は `register add --type issue` でログや期待値を添えて起票し、合意した範囲で修正と再確認を行います。共通の運用は [第 5 章](#common-operations)を参照してください。
434
+ - **パラメータ調整とバグ報告**: ジャンプ力や移動速度の微調整は ScriptableObject 上で行います。挙動の不具合が見つかった場合は `register add --type issue` でログや期待値を添えて起票し、合意した範囲で修正と再確認を行います。共通の運用は 「[プロダクト開発に共通する運用と品質管理](#common-operations)」を参照してください。
498
435
 
499
436
  ### 4.6. コマンドと設定差分(折りたたみ)
500
437
 
@@ -0,0 +1,94 @@
1
+ ---
2
+ specdojo:
3
+ id: specdojo:bac-recipe
4
+ type: recipe
5
+ status: ready
6
+ rulebook: specdojo:bac-rulebook
7
+ sample: specdojo:bac-sample
8
+ ---
9
+
10
+ # 業務受入条件 作成レシピ
11
+
12
+ Business Acceptance Criteria Writing Recipe
13
+
14
+ 業務仕様から利用者が受け入れられる状態を取り出し、前提・行為・結果・証跡へ具体化する作成手順です。正常完了だけでなく、判断を止める場面と次の担当へ渡す情報を掘り下げます。
15
+
16
+ ## 1. このレシピの使い方
17
+
18
+ - 上位の業務目的から、誰が何をできずに困っているかを引き継ぎ、受入で守る価値を絞る。
19
+ - 業務が成立したと言える状態を先に書き、その状態へ至る前提と行為を逆算する。実装方式と詳細なテスト操作は後続の担当へ渡す。
20
+ - 業務仕様の判断とシナリオ ID、確認する証跡を結ぶ。根拠がない期待値は新たに決めず、判断依頼として残す。
21
+
22
+ ## 2. 作成前に集める情報
23
+
24
+ | 項目 | 集める情報・問い |
25
+ | -------------- | ------------------------------------------------------------------------------------------ |
26
+ | 利用者と価値 | 誰のどの負担・誤判断・引き継ぎ漏れを減らすか。どの場面でその価値を確認するか |
27
+ | 業務の境界 | 何が起点で、どの記録や引き継ぎまでできれば終わるか |
28
+ | 確定済みの根拠 | BPS・業務ルール・プロジェクト受入条件のどの判断を確認するか |
29
+ | 前提 | 必要な状態、入力、判断権限は何か。不足すると何が止まるか |
30
+ | 証跡と関係者 | 誰がいつ何を照合し、誰が業務的妥当性を承認するか |
31
+ | 未決事項 | 期待値を決める材料はそろっているか。誰の判断をいつまでに得るか。現行の受入を止めるか |
32
+ | 改訂時の影響 | 根拠の変更・廃止はどのシナリオへ及ぶか。旧 ID や期待値を参照する仕様・設計・テストはどれか |
33
+
34
+ ## 3. 全体の作成手順
35
+
36
+ 1. 概要に受入対象、価値、利用場面、範囲と対象外を書く。価値ごとに確認する場面を選び、確認者と承認者が合意する内容をそろえる。
37
+ 2. 受入条件に、代表的な正常完了を一つ書く。開始状態を前提、担当者の業務行為を操作、終了状態を期待結果へ分け、根拠と ID を添える。
38
+ 3. 期待結果の各項目に、確認時点・確認者・証跡を対応させて判定方法を書く。確認できない結果は観測可能な記録か状態へ具体化する。
39
+ 4. 不足・拒否・途中変更などで結果が変わる場面を加える。同じ行為と観測点で入力だけが違う場合はケース表で差分を示す。
40
+ 5. 概要の価値とシナリオ ID を結び、確認できない価値や根拠のないシナリオを見つける。未確定の期待値はメモ / 将来課題へ移し、影響、判断依頼先、解消時点、追跡先を整理する。
41
+ 6. 改訂では旧 ID・条件の参照元を検索し、変更する期待結果、判定方法、後続テストを洗い出す。未決の業務判断は入力元へ戻し、BA の影響整理を QE・ARC・PO の確認と PM の追従作業管理へ渡す。
42
+
43
+ ## 4. 各章の書き方
44
+
45
+ ### 4.1. 概要
46
+
47
+ - 問い: この受入に合格すると、誰が次にどの業務を進められるか。隣の業務の判断まで引き受けていないか。
48
+ - 具体化: 利用者の困りごとを一つ選び、開始点と終了点を先に決める。価値を確認するシナリオ ID を添え、対象外の業務を別文書で扱うならその参照先を示す。
49
+ - 良い例: 「家族が店番しても販売・在庫を記録して引き継げる」。悪い例: 「販売画面を作る」。手段だけで受入の価値を表していない。
50
+
51
+ ### 4.2. 受入条件
52
+
53
+ - 問い: その前提でその行為を行ったとき、何が変わり、何が変わらないか。別の人も同じ証跡から合否を判断できるか。
54
+ - 具体化: 一つの記録を照合する場面から始め、正常、入力不足、停止後の再開で異なる結果を探す。必要な数値には単位と確認時点を添える。期待結果を一項目ずつ読み、確認者・確認時点・観測先・照合対象に抜けがないか確かめる。
55
+ - 良い例: 「数量 2 の販売後に在庫が 5 から 3 へ減ることを確定後の記録で照合する」。悪い例: 「在庫が正しい」。確認する差分を特定できない。
56
+
57
+ ### 4.3. メモ / 将来課題
58
+
59
+ - 問い: どのシナリオの期待値が未確定で、誰の判断があれば何を再開できるか。現行の受入、期限、依存先へどの影響が及ぶか。
60
+ - 具体化: 確認・追記作業は `_TODO_`、意思決定待ちは `_UNDECIDED_` で区別し、解消条件を添える。現行の受入や追従作業に影響する論点は、BA が影響を整理して PM へ PJR 登録候補として渡し、登録後は個票への参照で追跡する。将来拡張は追加条件を考え、未決がなければ「なし」で閉じる。
61
+ - 良い例: 「記録不能時の販売継続は店主代表が当該シナリオ作成前に判断する。BA が販売停止への影響を整理して PM へ渡し、登録後は個票を追跡する」。悪い例: 「例外は後で追加」。影響と判断の追跡先が分からない。
62
+
63
+ ## 5. 深掘り手順
64
+
65
+ 1. 概要の価値からシナリオをたどり、確認されない価値と、価値・根拠に結び付かないシナリオを探す。
66
+ 2. 正常シナリオの前提を一つずつ外し、業務を進めてよいか、結果を確定してよいかを問う。担当者の権限や入力の不足で止める範囲を掘り下げる。
67
+ 3. 行為の途中で入力や対象が変わる場面を置き、以前の記録をそのまま利用できるかを確認する。
68
+ 4. 停止後に次の担当が受け取る情報をたどり、再開に必要な状態と証跡を特定する。根拠で判断できないものは未決事項へ戻す。
69
+
70
+ ## 6. 良い例 / 悪い例
71
+
72
+ | 観点 | 良い例 | 悪い例 | 良し悪しを分ける点 |
73
+ | ---- | -------------------------------------------- | ------------------------------ | ------------------------------------ |
74
+ | 根拠 | 業務仕様の入力不足の扱いをシナリオで確認する | 書き手が不足時の既定値を決める | 決定済みの判断を受入へ変換しているか |
75
+ | 操作 | 家族利用者代表が販売を確定する | ボタンと画面遷移を列挙する | 業務行為として読めるか |
76
+ | 停止 | 販売を確定せず、不足情報を担当者へ渡す | エラーを表示する | 未確定の範囲と次の手が分かるか |
77
+ | 判定 | 確定後の販売記録と在庫差分を照合する | 動けば合格とする | 証跡から再現可能か |
78
+
79
+ ## 7. レビュー観点
80
+
81
+ | 観点 | 確認する問い |
82
+ | ---------- | -------------------------------------------------------------------------------------------------------------------- |
83
+ | 業務価値 | 各シナリオの必要性を利用者の課題または根拠の判断から説明できるか |
84
+ | 観測可能性 | 前提・操作と期待結果がつながり、確認時点と証跡を特定できるか |
85
+ | 例外と継承 | 止める判断・記録と、次の担当の行為を区別できるか |
86
+ | 責務境界 | 新しい承認規則や実装方式を受入条件の中で決めていないか |
87
+ | 合意と継承 | BA の整理した範囲を QE が検証へ、ARC が設計へ引き継げるか。PO が判断する合意対象と PM が追跡する残作業を特定できるか |
88
+
89
+ ## 8. 仕上げチェック
90
+
91
+ - シナリオ ID と根拠をたどれ、同じ意味のケースを重ねていない。改訂時は旧参照と期待値の更新先を特定できる。
92
+ - 共有前提と例外の前提が両立し、未決の値を確定済みの期待結果へ混ぜていない。
93
+ - 構文・保存構造・詳細テスト操作を整理し、必要な観測点、確認者、承認待ちの影響を残している。
94
+ - 条件を合意できる状態と試行済みの合格実績を区別し、準備作業や未決事項を解消済みとして扱っていない。
@@ -0,0 +1,105 @@
1
+ ---
2
+ specdojo:
3
+ id: specdojo:bes-recipe
4
+ type: recipe
5
+ status: ready
6
+ rulebook: specdojo:bes-rulebook
7
+ sample: specdojo:bes-sample
8
+ ---
9
+
10
+ # 業務イベント仕様 作成レシピ
11
+
12
+ Business Event Specification Writing Recipe
13
+
14
+ 起点が違っても同じ出来事と呼べるか、どの時点の何を事実として残すかを具体化するための手順です。業務上の混同を減らし、別の担当者も発生有無とデータの意味を判断できる記述へつなげます。
15
+
16
+ ## 1. このレシピの使い方
17
+
18
+ - 上位の業務目的とイベント一覧から、誰が何を取り違えて困るのかを一つ選びます。その混同を解消する事実の境界を本書で定めます。
19
+ - 成立と不成立の場面を並べてから、何が起きたか、いつ、誰が/何が、発生条件、事実データの五章を書きます。処理後の手順や実装方式は委譲先へ分けます。
20
+ - 各主張を、上位イベント・状態定義・データモデルのどれで確認できるかたどります。確認できない境界は推測で埋めず、判断者と確認時期を添えて残します。
21
+
22
+ ## 2. 作成前に集める情報
23
+
24
+ | 入力 | 確かめる問い |
25
+ | ---------------- | -------------------------------------------------------------------------- |
26
+ | 業務目的と利用者 | 定義が曖昧だと、誰が何を誤って数えたり引き継いだりするか |
27
+ | 上位イベント一覧 | どの出来事を詳細化するか。共通の対象範囲と個別の差分は何か |
28
+ | 似た出来事 | 要求、受付、確定、着手、処理完了を区別する必要があるか |
29
+ | 起点と主体 | 人の指名、自動判断、一括要求などで成立する事実が変わるか |
30
+ | 状態と業務ルール | 成立直前の状態をどこで判定するか。条件と判断ロジックの正本は何か |
31
+ | データモデル | 対象、取引、要求、実行をどう区別するか。既存の識別情報で相関を説明できるか |
32
+ | 承認と未決事項 | 誰が業務定義を承認するか。確認担当、判断期限、記録先が決まっているか |
33
+
34
+ ## 3. 全体の作成手順
35
+
36
+ 1. 解消する混同と対象業務を一文にし、読者が発生有無・回数を判定できることを利用の基準にします。
37
+ 2. 「何が起きたか」に、一回分の事実と含めない出来事を書きます。適用範囲が不明なら、確認できた業務と未判定の業務を分けます。
38
+ 3. 「いつ」に、成立を観測できる時点を書きます。要求から後処理までを時系列に並べ、どこで初めて事実になるかを選びます。
39
+ 4. 「誰が/何が」に、要求者と成立させる主体を並べます。起点が異なっても境界が同じかを比較します。
40
+ 5. 「発生条件」に、共通条件、起点別の差分、不成立条件を書きます。正本にある判断ロジックをコピーせず、何を満たした事実なのかへ絞ります。
41
+ 6. 「事実データ」に、その時点で分かる情報だけを置きます。一括要求は二件以上を紙上で並べ、要求と個別対象を混同しない相関情報を探します。
42
+ 7. 発生・相関の確認例から判断を説明します。未決事項には判断者、確認担当、時期、記録先を付け、承認前に引き渡せる範囲を明示します。
43
+
44
+ ## 4. 各章の書き方
45
+
46
+ ### 4.1. 何が起きたか
47
+
48
+ 問いは「誰のどの混同を防ぐ事実か」「同じ要求で二件確定したら一回か二回か」です。名詞だけでなく、対象と成立した事実を一文にします。
49
+
50
+ 良い例は「一取引の会計が確定した。複数明細でも一回」。避けたい例は「販売処理」で、事実と処理を区別できません。
51
+
52
+ ### 4.2. いつ
53
+
54
+ 問いは「成立したと言える最初の観測点はどこか」「同じ排他区間で行う別の処理も同じ出来事なのか」です。処理の近さと業務上の同一性を分けて考えます。
55
+
56
+ 良い例は「会計確定を記録した時点」。避けたい例は「会計中」で、発生前後を分けられません。
57
+
58
+ ### 4.3. 誰が/何が
59
+
60
+ 問いは「要求者と確定する主体は同じか」「人の判断とシステムの記録の責任はどこで分かれるか」です。名称を役割、構成要素、実際の担当者のどれとして使うか確かめます。
61
+
62
+ 良い例は「店番担当が要求し、販売管理システムが確定を記録する」。避けたい例は「担当が実行する」で、何を担当したかが分かりません。
63
+
64
+ ### 4.4. 発生条件
65
+
66
+ 問いは「直前まで同じでも、何が欠けたら発生しないか」「今の依存文書だけで全業務への適用を判断できるか」です。成立する例の条件を一つだけ外して、不成立の境界を探します。
67
+
68
+ 良い例は「未確定の取引で受領を確認して確定した場合。合計表示だけでは発生しない」。避けたい例は「条件が揃えば発生する」で、確認すべき条件が隠れます。
69
+
70
+ ### 4.5. 事実データ
71
+
72
+ 問いは「各項目は何を区別するために必要か」「最後にしか分からない件数を最初の事実にしていないか」「実行 ID で同じ要求をたどれる根拠はあるか」です。データモデルの項目名を先に決めず、意味と単位から対応を確認します。
73
+
74
+ 良い例は「取引番号で確定と明細を対応付ける」。避けたい例は「時刻が近いので同じ要求」とする推定です。
75
+
76
+ ## 5. 深掘り手順
77
+
78
+ 1. 事実の境界で意見が分かれたら、同じ操作でも発生しない例を一つ示し、何を観測できていないか確認します。
79
+ 2. 自動・一括で説明が崩れたら、二つの要求にそれぞれ複数の対象を置き、要求、対象、実行の対応を書き出します。既存モデルで対応できなければ未決事項にします。
80
+ 3. 根拠が参照範囲にないときは、必要な文書 ID と依存追加の必要性を記録します。確認済みの範囲まで書き、未確認の業務を恒久的に除外する結論は出しません。
81
+
82
+ ## 6. 良い例 / 悪い例
83
+
84
+ | 観点 | 良い例 | 悪い例 | 判断の違い |
85
+ | -------- | ---------------------------------------------------------------- | ---------------------------- | ------------------------------ |
86
+ | 発生単位 | 一取引に複数明細があっても確定は一回 | 複数の場合も扱う | 数える単位を決められるか |
87
+ | 観測時点 | 確定記録の成立時。印字完了は後処理 | 正常に終了した時 | 何の終了かが分かるか |
88
+ | 未決事項 | 判断者と確認担当を分け、設計着手前に判断結果をレビュー結果へ記録 | 後で確認する | 誰がいつ何を決めるかたどれるか |
89
+ | 相関情報 | 同じ要求の二件は同じ相関情報、別要求では区別する | 同じ実行 ID を使えばよいはず | 根拠のある単位で関連付けるか |
90
+
91
+ ## 7. レビュー観点
92
+
93
+ | 観点 | 確認する問い | 主な確認者 |
94
+ | ---------------- | ------------------------------------------------------ | ---------- |
95
+ | 業務価値 | 解消したい混同と、定義した発生境界が対応するか | BA |
96
+ | 業務承認 | 対象範囲と未決事項を判断する人間を識別できるか | PO |
97
+ | 技術への引き渡し | 状態定義とデータモデルに照合でき、未確認部分が分かるか | ARC |
98
+ | 確認可能性 | 同じ場面から発生有無・回数・相関を判断できるか | QE |
99
+
100
+ ## 8. 仕上げチェック
101
+
102
+ - 用いた主体名と識別情報の意味が、五章の間で変わっていないことを確認します。
103
+ - 発生条件を満たさない例と、成立後の処理が失敗する例を混同していないことを確認します。
104
+ - 確認できた範囲と未判定の範囲を区別し、判断者・時期・記録先のない論点を残していないことを確認します。
105
+ - 本文に残した情報が発生時点で観測でき、後処理の手順や正本の項目定義を重複していないことを確認します。