specdojo 0.8.0 → 0.9.1

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 (292) hide show
  1. package/.github/agents/specdojo-orchestrator.md +4 -1
  2. package/CHANGELOG.md +77 -0
  3. package/dist/catalog/catalog.js +16 -14
  4. package/dist/commands/agent.js +5 -3
  5. package/dist/commands/build.js +69 -10
  6. package/dist/commands/git.js +206 -0
  7. package/dist/commands/init.js +4 -2
  8. package/dist/commands/orchestrator.js +5 -77
  9. package/dist/commands/where.js +25 -0
  10. package/dist/dashboard/dashboard.js +5 -3
  11. package/dist/dashboard/routines.js +4 -7
  12. package/dist/dashboard/shared.js +2 -2
  13. package/dist/dashboard/timeline.js +14 -14
  14. package/dist/deliverable/trash.js +2 -1
  15. package/dist/docs/index-command.js +2 -2
  16. package/dist/docs/yaml-business-tables.js +243 -0
  17. package/dist/docs/yaml-interface-tables.js +106 -0
  18. package/dist/docs/yaml-pages-command.js +5 -3
  19. package/dist/docs/yaml-pages.js +146 -3
  20. package/dist/docs/yaml-table-shared.js +70 -0
  21. package/dist/docs/yaml-tables.js +39 -0
  22. package/dist/exec/agent-config.js +9 -0
  23. package/dist/exec/agent-protected-config.js +2 -0
  24. package/dist/exec/commands.js +31 -18
  25. package/dist/exec/events.js +34 -14
  26. package/dist/exec/evidence.js +13 -3
  27. package/dist/exec/opencode-permissions.js +117 -0
  28. package/dist/exec/parent-validation.js +56 -3
  29. package/dist/exec/plans-core.js +21 -2
  30. package/dist/exec/plans-generation.js +6 -7
  31. package/dist/exec/post-integration.js +162 -0
  32. package/dist/exec/queue-command.js +166 -0
  33. package/dist/exec/queue.js +285 -0
  34. package/dist/exec/register-foreign-wait.js +82 -0
  35. package/dist/exec/repo-integration-sync.js +17 -5
  36. package/dist/exec/repo-trace.js +2 -1
  37. package/dist/exec/reporter.js +2 -2
  38. package/dist/exec/results.js +24 -4
  39. package/dist/exec/review-kata.js +4 -1
  40. package/dist/exec/run/agent-pipeline.js +3 -2
  41. package/dist/exec/run/agent.js +12 -6
  42. package/dist/exec/run/change-scope.js +365 -0
  43. package/dist/exec/run/deferred-cleanup.js +31 -0
  44. package/dist/exec/run/in-place.js +5 -2
  45. package/dist/exec/run/job-lock.js +66 -0
  46. package/dist/exec/run/job-sequence.js +137 -0
  47. package/dist/exec/run/job.js +56 -19
  48. package/dist/exec/run/lifecycle-commands.js +1 -1
  49. package/dist/exec/run/lock.js +22 -1
  50. package/dist/exec/run/register-command.js +8 -5
  51. package/dist/exec/run/register-mode.js +68 -8
  52. package/dist/exec/run/register-resume.js +68 -14
  53. package/dist/exec/run/register-state.js +13 -8
  54. package/dist/exec/run/register-worktree.js +140 -125
  55. package/dist/exec/run/schedule-mode.js +75 -14
  56. package/dist/exec/run/schedule-prepare.js +3 -0
  57. package/dist/exec/run/schedule-task.js +88 -38
  58. package/dist/exec/run/shared.js +5 -0
  59. package/dist/exec/schedule/schedule.js +116 -4
  60. package/dist/exec/shared.js +2 -2
  61. package/dist/exec/smoke.js +190 -0
  62. package/dist/exec/strategy.js +13 -3
  63. package/dist/exec/task-repos.js +19 -4
  64. package/dist/exec/task-view.js +6 -4
  65. package/dist/exec/trial-commands.js +5 -2
  66. package/dist/exec/trial-core.js +6 -1
  67. package/dist/exec/validation-metrics.js +181 -0
  68. package/dist/exec/worktree-cleanup-lock.js +26 -0
  69. package/dist/exec/worktree-command.js +12 -2
  70. package/dist/exec/worktree-ops-commit.js +2 -2
  71. package/dist/exec/worktree.js +13 -2
  72. package/dist/grade/command-apply.js +3 -3
  73. package/dist/grade/command-inspect.js +5 -3
  74. package/dist/grade/command-plan.js +1 -1
  75. package/dist/grade/command-run.js +5 -1
  76. package/dist/grade/run.js +64 -8
  77. package/dist/job/definition.js +84 -8
  78. package/dist/job/job.js +79 -23
  79. package/dist/register/authoring-sources.js +22 -16
  80. package/dist/register/maintenance-commands.js +2 -2
  81. package/dist/register/register.js +31 -7
  82. package/dist/register/renumber.js +1 -3
  83. package/dist/routine/definition.js +9 -0
  84. package/dist/routine/routine.js +137 -43
  85. package/dist/routine/status.js +62 -0
  86. package/dist/schedule/schedule.js +38 -39
  87. package/dist/shared/agent-types.js +5 -0
  88. package/dist/shared/cross-process-lock.js +9 -1
  89. package/dist/shared/dist-freshness.js +8 -2
  90. package/dist/shared/git-environment.js +2 -1
  91. package/dist/shared/git.js +44 -1
  92. package/dist/shared/lefthook-scaffold.js +3 -0
  93. package/dist/shared/local-config.js +244 -0
  94. package/dist/shared/specdojo-config.js +34 -20
  95. package/dist/shared/specdojo-gitignore.js +1 -0
  96. package/dist/shared/text.js +17 -1
  97. package/dist/shared/where-alias.js +13 -0
  98. package/dist/specdojo.js +4 -0
  99. package/docs/ja/specdojo/defaults/pm-review-viewpoints.yaml +2 -0
  100. package/docs/ja/specdojo/guides/exec-config-guide.md +23 -4
  101. package/docs/ja/specdojo/guides/exec-operation-guide.md +44 -1
  102. package/docs/ja/specdojo/guides/job-sequence-guide.md +77 -0
  103. package/docs/ja/specdojo/guides/orchestrator-operation-guide.md +1 -1
  104. package/docs/ja/specdojo/guides/quick-start-guide.md +3 -3
  105. package/docs/ja/specdojo/guides/register-operation-guide.md +1 -1
  106. package/docs/ja/specdojo/guides/routine-operation-guide.md +11 -6
  107. package/docs/ja/specdojo/guides/schedule-design-guide.md +20 -17
  108. package/docs/ja/specdojo/guides/waza-guide.md +12 -8
  109. package/docs/ja/specdojo/recipes/bac-recipe.md +66 -49
  110. package/docs/ja/specdojo/recipes/bes-recipe.md +90 -54
  111. package/docs/ja/specdojo/recipes/bps-recipe.md +88 -139
  112. package/docs/ja/specdojo/recipes/br-recipe.md +40 -47
  113. package/docs/ja/specdojo/recipes/cdfd-overview-recipe.md +97 -109
  114. package/docs/ja/specdojo/recipes/cdfd-recipe.md +85 -146
  115. package/docs/ja/specdojo/recipes/cdfd-uc-recipe.md +91 -110
  116. package/docs/ja/specdojo/recipes/cnd-recipe.md +79 -69
  117. package/docs/ja/specdojo/recipes/cpd-recipe.md +78 -64
  118. package/docs/ja/specdojo/recipes/cxd-recipe.md +92 -75
  119. package/docs/ja/specdojo/recipes/ifd-recipe.md +79 -68
  120. package/docs/ja/specdojo/recipes/ifx-cmd-recipe.md +78 -105
  121. package/docs/ja/specdojo/recipes/ifx-index-recipe.md +105 -71
  122. package/docs/ja/specdojo/recipes/pm-communication-plan-recipe.md +60 -49
  123. package/docs/ja/specdojo/recipes/pm-members-recipe.md +50 -51
  124. package/docs/ja/specdojo/recipes/pm-organization-recipe.md +59 -51
  125. package/docs/ja/specdojo/recipes/pm-plan-recipe.md +69 -56
  126. package/docs/ja/specdojo/recipes/pm-quality-management-plan-recipe.md +37 -56
  127. package/docs/ja/specdojo/recipes/pm-raci-recipe.md +39 -53
  128. package/docs/ja/specdojo/recipes/pm-roles-recipe.md +52 -79
  129. package/docs/ja/specdojo/recipes/prj-assumptions-constraints-dependencies-recipe.md +64 -93
  130. package/docs/ja/specdojo/recipes/prj-charter-recipe.md +71 -106
  131. package/docs/ja/specdojo/recipes/prj-comparison-of-alternatives-recipe.md +78 -157
  132. package/docs/ja/specdojo/recipes/prj-issues-and-approach-recipe.md +62 -111
  133. package/docs/ja/specdojo/recipes/prj-scope-recipe.md +67 -123
  134. package/docs/ja/specdojo/recipes/prj-stakeholder-register-recipe.md +60 -96
  135. package/docs/ja/specdojo/recipes/prj-success-criteria-and-acceptance-criteria-recipe.md +61 -105
  136. package/docs/ja/specdojo/recipes/stsd-recipe.md +79 -109
  137. package/docs/ja/specdojo/recipes/sysd-critical-flows-recipe.md +78 -55
  138. package/docs/ja/specdojo/recipes/sysd-cross-cutting-policy-recipe.md +82 -73
  139. package/docs/ja/specdojo/recipes/sysd-index-recipe.md +78 -59
  140. package/docs/ja/specdojo/recipes/tsd-recipe.md +149 -129
  141. package/docs/ja/specdojo/references/command-reference.md +258 -118
  142. package/docs/ja/specdojo/references/deliverables-reference.md +21 -12
  143. package/docs/ja/specdojo/references/specdojo-config-reference.md +47 -10
  144. package/docs/ja/specdojo/rulebooks/atc-index-rulebook.md +101 -257
  145. package/docs/ja/specdojo/rulebooks/atc-rulebook.md +102 -228
  146. package/docs/ja/specdojo/rulebooks/bac-rulebook.md +19 -28
  147. package/docs/ja/specdojo/rulebooks/bdd-rulebook.md +16 -67
  148. package/docs/ja/specdojo/rulebooks/bds-rulebook.md +30 -51
  149. package/docs/ja/specdojo/rulebooks/bes-index-rulebook.md +41 -61
  150. package/docs/ja/specdojo/rulebooks/bes-rulebook.md +22 -50
  151. package/docs/ja/specdojo/rulebooks/bps-rulebook.md +24 -56
  152. package/docs/ja/specdojo/rulebooks/br-rulebook.md +13 -38
  153. package/docs/ja/specdojo/rulebooks/ccd-mermaid-rulebook.md +41 -76
  154. package/docs/ja/specdojo/rulebooks/cdfd-d2-rulebook.md +18 -93
  155. package/docs/ja/specdojo/rulebooks/cdfd-mermaid-rulebook.md +18 -52
  156. package/docs/ja/specdojo/rulebooks/cdfd-overview-rulebook.md +109 -147
  157. package/docs/ja/specdojo/rulebooks/cdfd-rulebook.md +80 -108
  158. package/docs/ja/specdojo/rulebooks/cdfd-uc-rulebook.md +21 -46
  159. package/docs/ja/specdojo/rulebooks/cdr-rulebook.md +144 -0
  160. package/docs/ja/specdojo/rulebooks/cdsd-rulebook.md +27 -48
  161. package/docs/ja/specdojo/rulebooks/cdt-rulebook.md +37 -50
  162. package/docs/ja/specdojo/rulebooks/clis-rulebook.md +52 -69
  163. package/docs/ja/specdojo/rulebooks/cnd-mermaid-rulebook.md +33 -86
  164. package/docs/ja/specdojo/rulebooks/cnd-rulebook.md +16 -32
  165. package/docs/ja/specdojo/rulebooks/cop-index-rulebook.md +45 -131
  166. package/docs/ja/specdojo/rulebooks/cop-rulebook.md +69 -275
  167. package/docs/ja/specdojo/rulebooks/cpd-mermaid-rulebook.md +20 -112
  168. package/docs/ja/specdojo/rulebooks/cpd-rulebook.md +23 -56
  169. package/docs/ja/specdojo/rulebooks/cxd-mermaid-rulebook.md +12 -145
  170. package/docs/ja/specdojo/rulebooks/cxd-rulebook.md +39 -47
  171. package/docs/ja/specdojo/rulebooks/dct-index-rulebook.md +37 -56
  172. package/docs/ja/specdojo/rulebooks/dct-rulebook.md +118 -175
  173. package/docs/ja/specdojo/rulebooks/dec-rulebook.md +5 -14
  174. package/docs/ja/specdojo/rulebooks/dmd-index-rulebook.md +22 -66
  175. package/docs/ja/specdojo/rulebooks/dmd-rulebook.md +36 -94
  176. package/docs/ja/specdojo/rulebooks/dss-rulebook.md +59 -81
  177. package/docs/ja/specdojo/rulebooks/etc-index-rulebook.md +31 -131
  178. package/docs/ja/specdojo/rulebooks/etc-rulebook.md +50 -104
  179. package/docs/ja/specdojo/rulebooks/gl-rulebook.md +51 -61
  180. package/docs/ja/specdojo/rulebooks/ifd-mermaid-rulebook.md +38 -45
  181. package/docs/ja/specdojo/rulebooks/ifx-api-rulebook.md +14 -20
  182. package/docs/ja/specdojo/rulebooks/ifx-cmd-rulebook.md +26 -38
  183. package/docs/ja/specdojo/rulebooks/ifx-file-rulebook.md +26 -107
  184. package/docs/ja/specdojo/rulebooks/ifx-index-rulebook.md +42 -49
  185. package/docs/ja/specdojo/rulebooks/ifx-msg-rulebook.md +14 -22
  186. package/docs/ja/specdojo/rulebooks/imp-business-rulebook.md +21 -44
  187. package/docs/ja/specdojo/rulebooks/imp-data-rulebook.md +41 -64
  188. package/docs/ja/specdojo/rulebooks/imp-interface-rulebook.md +14 -38
  189. package/docs/ja/specdojo/rulebooks/imp-operations-rulebook.md +34 -61
  190. package/docs/ja/specdojo/rulebooks/imp-test-rulebook.md +27 -50
  191. package/docs/ja/specdojo/rulebooks/itc-index-rulebook.md +70 -199
  192. package/docs/ja/specdojo/rulebooks/itc-rulebook.md +65 -153
  193. package/docs/ja/specdojo/rulebooks/mip-index-rulebook.md +74 -150
  194. package/docs/ja/specdojo/rulebooks/mm-rulebook.md +11 -23
  195. package/docs/ja/specdojo/rulebooks/mtp-rulebook.md +99 -176
  196. package/docs/ja/specdojo/rulebooks/nfr-availability-rulebook.md +35 -61
  197. package/docs/ja/specdojo/rulebooks/nfr-index-rulebook.md +75 -117
  198. package/docs/ja/specdojo/rulebooks/nfr-integrity-rulebook.md +31 -60
  199. package/docs/ja/specdojo/rulebooks/nfr-maintainability-rulebook.md +26 -81
  200. package/docs/ja/specdojo/rulebooks/nfr-operations-rulebook.md +32 -70
  201. package/docs/ja/specdojo/rulebooks/nfr-performance-rulebook.md +45 -87
  202. package/docs/ja/specdojo/rulebooks/nfr-reliability-rulebook.md +48 -101
  203. package/docs/ja/specdojo/rulebooks/nfr-security-safety-rulebook.md +44 -80
  204. package/docs/ja/specdojo/rulebooks/nfr-usability-rulebook.md +59 -127
  205. package/docs/ja/specdojo/rulebooks/opd-index-rulebook.md +31 -50
  206. package/docs/ja/specdojo/rulebooks/opd-rulebook.md +42 -109
  207. package/docs/ja/specdojo/rulebooks/opr-index-rulebook.md +29 -42
  208. package/docs/ja/specdojo/rulebooks/opr-rulebook.md +29 -87
  209. package/docs/ja/specdojo/rulebooks/otp-index-rulebook.md +62 -84
  210. package/docs/ja/specdojo/rulebooks/otp-rulebook.md +11 -61
  211. package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +91 -106
  212. package/docs/ja/specdojo/rulebooks/pm-change-request-log-rulebook.md +25 -34
  213. package/docs/ja/specdojo/rulebooks/pm-communication-plan-rulebook.md +30 -53
  214. package/docs/ja/specdojo/rulebooks/pm-issue-log-rulebook.md +23 -35
  215. package/docs/ja/specdojo/rulebooks/pm-members-rulebook.md +27 -45
  216. package/docs/ja/specdojo/rulebooks/pm-organization-rulebook.md +37 -45
  217. package/docs/ja/specdojo/rulebooks/pm-plan-rulebook.md +45 -46
  218. package/docs/ja/specdojo/rulebooks/pm-quality-management-plan-rulebook.md +37 -48
  219. package/docs/ja/specdojo/rulebooks/pm-raci-rulebook.md +25 -29
  220. package/docs/ja/specdojo/rulebooks/pm-risk-register-rulebook.md +28 -35
  221. package/docs/ja/specdojo/rulebooks/pm-roles-rulebook.md +36 -41
  222. package/docs/ja/specdojo/rulebooks/pr-rulebook.md +5 -18
  223. package/docs/ja/specdojo/rulebooks/prj-assumptions-constraints-dependencies-rulebook.md +16 -37
  224. package/docs/ja/specdojo/rulebooks/prj-charter-rulebook.md +23 -97
  225. package/docs/ja/specdojo/rulebooks/prj-comparison-of-alternatives-rulebook.md +39 -57
  226. package/docs/ja/specdojo/rulebooks/prj-issues-and-approach-rulebook.md +43 -116
  227. package/docs/ja/specdojo/rulebooks/prj-scope-rulebook.md +16 -51
  228. package/docs/ja/specdojo/rulebooks/prj-stakeholder-register-rulebook.md +47 -92
  229. package/docs/ja/specdojo/rulebooks/prj-success-criteria-and-acceptance-criteria-rulebook.md +25 -84
  230. package/docs/ja/specdojo/rulebooks/sac-rulebook.md +44 -107
  231. package/docs/ja/specdojo/rulebooks/sf-index-rulebook.md +39 -49
  232. package/docs/ja/specdojo/rulebooks/sf-rulebook.md +42 -49
  233. package/docs/ja/specdojo/rulebooks/sld-rulebook.md +64 -89
  234. package/docs/ja/specdojo/rulebooks/stc-index-rulebook.md +90 -189
  235. package/docs/ja/specdojo/rulebooks/stc-rulebook.md +45 -105
  236. package/docs/ja/specdojo/rulebooks/stsd-mermaid-rulebook.md +6 -12
  237. package/docs/ja/specdojo/rulebooks/stsd-rulebook.md +49 -68
  238. package/docs/ja/specdojo/rulebooks/sysd-critical-flows-rulebook.md +51 -60
  239. package/docs/ja/specdojo/rulebooks/sysd-cross-cutting-policy-rulebook.md +46 -50
  240. package/docs/ja/specdojo/rulebooks/sysd-index-rulebook.md +39 -64
  241. package/docs/ja/specdojo/rulebooks/sysd-rulebook.md +47 -60
  242. package/docs/ja/specdojo/rulebooks/trc-requirements-to-specs-rulebook.md +69 -70
  243. package/docs/ja/specdojo/rulebooks/trc-requirements-to-tests-rulebook.md +65 -72
  244. package/docs/ja/specdojo/rulebooks/tsd-index-rulebook.md +35 -46
  245. package/docs/ja/specdojo/rulebooks/tsd-rulebook.md +49 -66
  246. package/docs/ja/specdojo/rulebooks/tsp-index-rulebook.md +64 -139
  247. package/docs/ja/specdojo/rulebooks/uis-rulebook.md +41 -108
  248. package/docs/ja/specdojo/rulebooks/utc-index-rulebook.md +49 -144
  249. package/docs/ja/specdojo/rulebooks/utc-rulebook.md +67 -155
  250. package/docs/ja/specdojo/samples/bds-sample.md +58 -71
  251. package/docs/ja/specdojo/samples/bes-index-sample.md +20 -37
  252. package/docs/ja/specdojo/samples/bes-sample.md +43 -53
  253. package/docs/ja/specdojo/samples/bps-sample.md +42 -54
  254. package/docs/ja/specdojo/samples/br-sample.md +40 -52
  255. package/docs/ja/specdojo/samples/ccd-sample.md +0 -1
  256. package/docs/ja/specdojo/samples/cdr-sample.md +78 -0
  257. package/docs/ja/specdojo/samples/cdsd-sample.md +47 -63
  258. package/docs/ja/specdojo/samples/clis-sample.md +70 -77
  259. package/docs/ja/specdojo/samples/dec-sample.md +2 -3
  260. package/docs/ja/specdojo/samples/ifx-api-sample.yaml +0 -2
  261. package/docs/ja/specdojo/samples/ifx-msg-sample.yaml +0 -2
  262. package/docs/ja/specdojo/samples/job-sequence.yaml +67 -0
  263. package/docs/ja/specdojo/samples/mip-index-sample.md +98 -20
  264. package/docs/ja/specdojo/samples/pm-communication-plan-sample.md +26 -19
  265. package/docs/ja/specdojo/samples/pm-organization-sample.md +39 -50
  266. package/docs/ja/specdojo/samples/pm-plan-sample.md +61 -67
  267. package/docs/ja/specdojo/samples/pm-quality-management-plan-sample.md +31 -45
  268. package/docs/ja/specdojo/samples/pm-raci-sample.md +31 -37
  269. package/docs/ja/specdojo/samples/prj-assumptions-constraints-dependencies-sample.md +32 -48
  270. package/docs/ja/specdojo/samples/prj-charter-sample.md +42 -59
  271. package/docs/ja/specdojo/samples/prj-comparison-of-alternatives-sample.md +55 -61
  272. package/docs/ja/specdojo/samples/prj-success-criteria-and-acceptance-criteria-sample.md +30 -33
  273. package/docs/ja/specdojo/samples/sf-index-sample.md +13 -55
  274. package/docs/ja/specdojo/samples/sf-sample.md +73 -85
  275. package/docs/ja/specdojo/samples/sld-sample.md +60 -79
  276. package/docs/ja/specdojo/samples/uis-sample.md +98 -121
  277. package/docs/ja/specdojo/standards/job-definition-standard.md +24 -9
  278. package/docs/ja/specdojo/templates/cdr-template.md +58 -0
  279. package/docs/specdojo/schemas/v1/exec-common.schema.yaml +2 -1
  280. package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +42 -5
  281. package/docs/specdojo/schemas/v1/exec-evidence.schema.yaml +35 -0
  282. package/docs/specdojo/schemas/v1/job-run.schema.yaml +23 -0
  283. package/docs/specdojo/schemas/v1/job.schema.yaml +63 -2
  284. package/docs/specdojo/schemas/v1/sch-strategy.schema.yaml +2 -2
  285. package/package.json +9 -6
  286. package/templates/antigravity/orchestrator.md +4 -1
  287. package/templates/claude/agents/specdojo-orchestrator.md +4 -1
  288. package/templates/codex/agents/specdojo-orchestrator.toml +4 -1
  289. package/templates/codex/orchestrator.md +4 -1
  290. package/templates/init-exec-defaults.yaml +13 -0
  291. package/templates/lefthook/tools/specdojo-pre-commit.mjs +8 -0
  292. package/templates/opencode/agents/specdojo-orchestrator.md +5 -2
@@ -11,40 +11,31 @@ specdojo:
11
11
 
12
12
  Success Criteria and Acceptance Criteria Writing Recipe
13
13
 
14
- 本書は、業務価値を起点として、プロジェクトの成功基準と受入条件を判定可能な形にする作り方です。本書では問い、深掘り、レビュー観点を扱います。
14
+ 業務価値を起点に、プロジェクトの成功と初期受入の可否を、承認者が証跡で判断できる条件に仕上げるための作り方を示す。
15
15
 
16
16
  ## 1. このレシピの使い方
17
17
 
18
- - 最初に、概要とスコープから対象利用者、利用場面、期待効果、対象外、判定期間を抜き出します。
19
- - 次に、利用者にとって実現したい状態を業務価値として短く定義します。
20
- - 業務価値ごとに、初期公開・初期リリース、短期、中長期の成功基準を置きます。
21
- - 初期受入の対象について、価値提供を開始できる状態を受入条件と証跡で定義します。
22
- - 最後に、確認者、承認者、否決時の再判定方法を明確にします。
23
- - 利用者と期待効果(Why)、業務価値・成功基準・受入条件(What)、測定・確認・承認・再判定(How)を整理し、各 ID と証跡で追跡します(Trace)。詳細な実装・個別テスト手順は後続成果物へ委譲します。
18
+ - 概要とスコープから対象利用者と期待効果(Why)を引き継ぎ、業務価値ごとの成功基準と受入条件(What)を定め、測定・確認・承認・再判定の進め方(How)を決める。各条件は業務価値 ID と証跡でたどれるようにする(Trace)。
24
19
 
25
20
  ## 2. 作成前に集める情報
26
21
 
27
- | 項目 | 集める情報 |
28
- | ------------ | ------------------------------------------------------------- |
29
- | 対象と対象外 | 今回判定する成果物・状態と、判定しない範囲 |
30
- | 業務価値 | 対象利用者、利用場面、期待する効果または状態 |
31
- | 成功の状態 | 初期、短期、中長期の各段階で、どの状態なら成功か |
32
- | 受入対象 | 利用者が確認する作業、結果、品質、公開適性 |
33
- | 測定方法 | 観察、件数集計、費用・作業記録、文書照合、lint などの確認方法 |
34
- | 証跡 | 確認結果を後から追跡できるファイル、記録、ログ |
35
- | 判断体制 | 確認者、承認者、否決時に是正を担う役割 |
36
- | 未確定事項 | 閾値、期限、前提のうち、意思決定が未了のもの |
22
+ | 項目 | 集める情報 | 取り出し元 |
23
+ | ---------------- | ------------------------------------------------------------ | ---------------------------- |
24
+ | 対象と対象外 | 今回判定する成果物・状態と、判定しない範囲 | プロジェクトスコープ |
25
+ | 利用者と期待効果 | 対象利用者、利用場面、期待する変化 | プロジェクト概要 |
26
+ | 成功の状態 | 初期公開、短期、中長期のそれぞれで、どうなれば成功と言えるか | 承認者・代表利用者への確認 |
27
+ | 費用と負荷の上限 | 追加の現金支出、人の作業時間、運用負荷の上限と、その承認者 | 承認者・実行責任者への確認 |
28
+ | 測定と証跡 | 観察、件数集計、費用・作業記録などの確認方法と、残せる記録 | 実行責任者・品質担当への確認 |
29
+ | 決めきれない値 | 閾値、期限、前提のうち、決定が済んでいないもの | 確認の過程のメモ |
37
30
 
38
31
  ## 3. 全体の作成手順
39
32
 
40
- 1. 判定対象と対象外をスコープから転記せず、受入判断に必要な範囲へ要約する。
41
- 2. 利用者と利用場面に結び付く業務価値へ ID を付ける。
42
- 3. 各業務価値について、初期公開・初期リリース、短期、中長期のどの段階で成功を判定するか決める。
43
- 4. 各段階の成功した状態を一文で書き、判定基準、測定方法、判定時期、確認者を決める。
44
- 5. 初期受入に必要な条件を、利用者視点・技術的受入・品質・公開適性に分ける。
45
- 6. 各受入条件に合格基準、証跡、確認者、承認者を対応付ける。
46
- 7. 判定の実施順、否決時の是正、再判定の記録方法を定義する。
47
- 8. 未確定の閾値・期限には _UNDECIDED_: を付け、決定時期と担当を記載する。依存文書(スコープ等)が別ラベル(例: _TODO_:)で未決を示している場合も、本書では _UNDECIDED_: に書き換える。
33
+ 1. 業務価値を最初に定め、ID を付ける。成功基準も受入条件も業務価値に対応付けるため、ここが決まらないと条件の要否を判断できない。
34
+ 2. 判定対象と適用範囲で、初期受入に必須とする条件と、公開後に判定する成功基準の境目を決める。
35
+ 3. 成功基準を、公開後の段階まで含めて書く。
36
+ 4. 受入条件を、価値提供を始められる最小の状態に絞って書く。
37
+ 5. 判定手順と証跡で、確認の順と否決時の再判定を書く。
38
+ 6. 最後に例外条件と未解決事項を書く。条件を書く途中で出た決めきれない値を集めると、漏れが減る。
48
39
 
49
40
  ## 4. 各章の書き方
50
41
 
@@ -52,128 +43,93 @@ Success Criteria and Acceptance Criteria Writing Recipe
52
43
 
53
44
  問い:
54
45
 
55
- - 初期公開・初期リリース、短期、中長期の何を判断するのか。
56
- - どの成功基準と受入条件が初期 GO / Not GO の必須条件か。
57
- - 誰がこの判定結果を使うのか。
58
- - 当該プロジェクトだけでは因果を判定できない成果や、他文書へ委譲する詳細は何か。
46
+ - 初期公開の GO / Not GO を、どの条件のすべてで判断するのか。
47
+ - 当該プロジェクトだけでは因果を判定できない成果はどれか。
59
48
 
60
- 書き方:
49
+ コツ:
61
50
 
62
- - 対象・対象外をともに一文以上で明示する。
63
- - 初期受入の必須条件と、後続時期に判定する成功基準を区別する。
64
- - 業務価値は、利用者、利用場面、期待する状態を含む短文にする。
65
- - 「品質を上げる」のような抽象的な価値ではなく、「利用者が同じ根拠で判断できる」のように状態を書く。
51
+ - スコープの対象・対象外を写したくなったら、スコープへの参照に置き換え、受入判断に要る境目だけを書く。
52
+ - 「品質を上げる」のような抽象語が出たら、「利用者が同じ根拠で判断できる」のように、利用者に生じる状態へ言い換える。
66
53
 
67
54
  ### 4.2. 成功基準
68
55
 
69
56
  問い:
70
57
 
71
58
  - どの業務価値が実現すれば、プロジェクトが成功したと言えるか。
72
- - 初期公開・初期リリース、短期、中長期の成果を分けられているか。
73
- - 公開後にしか測定できない成果について、判定時期と測定責任を決めているか。
74
- - 閾値がある場合、対象・単位・母数・比較対象を説明できるか。
75
- - 低コストや費用負担の軽減を価値に置く場合、現金支出、作業時間、継続運用負荷を分けているか。
76
- - 既存資産、寄付、無償枠をどう扱い、人の無償労働への負荷転嫁をどう防ぐか。
59
+ - 公開後にしか測れない成果を、いつ誰が確かめるか。
77
60
 
78
- 書き方:
61
+ コツ:
79
62
 
80
- - 一行は一つの成功状態に限定する。
81
- - 定性条件でも、誰が何を確認すればよいかを測定方法に書く。
82
- - 初期公開時に測れない利用実績や中長期成果も成功基準として記述し、初期受入の合否から分離する。
83
- - 成果物完成、機能数、lint 合格だけで成功を表さず、利用者、業務、事業または社会に生じる変化を書く。
84
- - 外部要因を受ける成果は単独の因果と断定せず、利用前後の変化と寄与を確認する。
85
- - 低コストを条件にする場合は、現金支出だけでなく人の作業時間と継続運用負荷も判定し、既存資産、寄付、無償枠の扱いを明記する。
63
+ - 承認者に「公開から半年後、何が起きていれば続ける価値があったと言えるか」を聞くと、短期と中長期の成功の状態が出てくる。
64
+ - 「低コスト」を聞いたら、現金支出だけで答えが終わらないよう、作業時間と運用負荷、既存資産や寄付の扱いも続けて聞く。無償の作業を前提にした成功に気付ける。
65
+ - 閾値が出たら、何を数えるか、母数と比較対象は何かを、その場で聞き返す。
86
66
 
87
67
  ### 4.3. 受入条件
88
68
 
89
69
  問い:
90
70
 
91
71
  - 利用者は何を行い、どの結果なら受け入れられるか。
92
- - 初期公開・初期リリースで、価値提供を開始できる最小状態は何か。
93
- - 技術的確認は、どの業務価値を支えるために必要か。
94
- - 合格の証拠を第三者が後から確認できるか。
72
+ - 技術的な確認は、どの業務価値を支えるために要るのか。
95
73
 
96
- 書き方:
74
+ コツ:
97
75
 
98
- - 条件は「対象 + 操作または確認 + 期待結果」で書く。
99
- - 公開後の利用件数や中長期成果を初期受入の必須条件にしない。
100
- - 技術的受入は種別を明記し、利用者の受入条件と混在させない。
101
- - 承認者には最終判断を担う人間の役割を置く。AI Agent を承認者にしない。
76
+ - 公開後の利用件数を受入条件に入れたくなったら、成功基準へ移す。
77
+ - 確認者と承認者を一人の役割にまとめがちなので、「誰が証跡を見るか」と「誰が受け入れを決めるか」を分けて聞く。
102
78
 
103
79
  ### 4.4. 判定手順と証跡
104
80
 
105
81
  問い:
106
82
 
107
83
  - どの条件を、誰が、どの順で確認するか。
108
- - 否決時に、何を直し、どの条件を再確認するか。
109
- - 判定結果と未決事項をどこに残すか。
84
+ - 否決したとき、何を直し、どの条件を確かめ直すか。
110
85
 
111
- 書き方:
86
+ コツ:
112
87
 
113
- - 手順は確認者の順に番号付きで書く。
114
- - 証跡は「確認結果」のような抽象名だけで終わらせず、記録内容を示す。
115
- - 再判定時は、対象の受入条件 ID と予定を記録する。
88
+ - 費用と作業時間の上限は、試行の後では決めにくい。試行の前に承認する手順として置く。
89
+ - 証跡を「確認結果」とだけ書きそうになったら、確認日、確認者、条件 ID、母数など、記録に残す中身を聞く。
116
90
 
117
91
  ### 4.5. 例外条件と未解決事項
118
92
 
119
93
  問い:
120
94
 
121
- - 今回の受入範囲から除くが、後で判断が必要なことは何か。
122
- - 閾値または運用前提が未確定でも、受入を進められるか。
123
- - 決定しない場合に誰が影響を受けるか。
95
+ - 決めきれない値があっても、初期受入を進められるか。
96
+ - 保留したとき、どの条件の判定に効くか。
124
97
 
125
- 書き方:
98
+ コツ:
126
99
 
127
- - 未確定は _UNDECIDED_: で明示し、決定する時期と責任者を添える。
128
- - スコープなど依存文書の未決事項を転記する場合、元のラベル(例: _TODO_:)をそのまま残さず、本ルールブックの _UNDECIDED_: に統一する。
129
- - 例外は「受け入れる」だけで終わらせず、再判定する条件を記載する。
100
+ - スコープなどの上位成果物の未決事項は写さず、本書の判定に効く分だけを _UNDECIDED_: で書く。上位成果物が _TODO_: と書いていても、本書では _UNDECIDED_: にそろえる。
130
101
 
131
102
  ## 5. 深掘り手順
132
103
 
133
- 1. 対象利用者を、実際に判定する人と成果を利用する人に分ける。
134
- 2. 各利用場面で「できるようになること」を一文で書く。
135
- 3. その価値を、初期公開・初期リリース、短期、中長期のどこで確認するか決める。
136
- 4. 観察、件数、利用前後比較、文書照合、lint から、段階に合う測定方法を選ぶ。
137
- 5. 証跡に、確認日、確認者、対象条件 ID、判定対象と母数を残せるか確認する。
138
- 6. 業務価値に直接結び付かない条件は、必要性を説明できる技術的受入へ分類する。
139
- 7. 後続時期の成功基準を初回受入の合否から分離し、測定時期と責任者を残す。
104
+ 内容が浅いときは、次の順で対応のない主張を探す。
105
+
106
+ 1. 成功基準と受入条件の各行が、どの業務価値に応えるかを確かめ、対応のない行を外すか技術的受入へ移す。
107
+ 2. 業務価値ごとに、初期公開・短期・中長期のどこで成功を確かめるかを確かめ、抜けている段階を足す。
108
+ 3. 各条件の測定方法と証跡で、第三者が後から同じ判定を再現できるかを確かめる。
109
+ 4. 受入条件に混じった公開後の成果や実装詳細を、成功基準や後続成果物へ戻す。
140
110
 
141
111
  ## 6. 良い例 / 悪い例
142
112
 
143
- | 観点 | 良い例 | 悪い例 |
144
- | ------------------ | ------------------------------------------------------------------------------- | ------------------------------------- |
145
- | 業務価値 | 店主と家族が同じ手順で在庫を確認できる | システムを便利にする |
146
- | 初期成功基準 | 店主と家族が販売・在庫・つけ確認の必須タスクをすべて完了できる | 必要な機能が90%完成している |
147
- | 短期成功基準 | 営業日の90%以上で販売・在庫・つけの記録が残っている | 日々の記録が定着している |
148
- | 中長期成功基準 | 人気商品の欠品回数が運用前1か月比で50%減少する | 店舗運営が改善する |
149
- | 受入条件 | 商品、数量、支払方法を入力して確定すると販売記録が1件作成される | 販売機能が正しく動く |
150
- | 証跡 | 確認日、確認者、条件 ID を含む受入確認記録 | 確認したことを記録する |
151
- | 未解決事項 | _UNDECIDED_: オフライン時の記録方法を初期運用開始前に店主代表が決定する | オフライン時は後で決める |
152
- | 未解決事項のラベル | スコープの _TODO_: 初回公開日を _UNDECIDED_: に書き換え、決定時期と担当を添える | スコープの _TODO_: をそのまま転記する |
113
+ | 観点 | 良い例 | 悪い例 |
114
+ | -------------- | ----------------------------------------------------------------- | --------------------------- |
115
+ | 業務価値 | 店主と家族が同じ手順で在庫を確認できる | システムを便利にする |
116
+ | 初期成功基準 | 店主と家族が販売・在庫・つけ確認の必須タスクをすべて完了できる | 必要な機能が90%完成している |
117
+ | 中長期成功基準 | 人気商品の欠品回数が運用前1か月比で50%減少する | 店舗運営が改善する |
118
+ | 受入条件 | 商品、数量、支払方法を入力して確定すると販売記録が1件作成される | 販売機能が正しく動く |
119
+ | 未解決事項 | _UNDECIDED_: オフライン時の記録方法を初期運用開始前に店主が決める | オフライン時は後で決める |
153
120
 
154
121
  ## 7. レビュー観点
155
122
 
156
- | 観点 | 確認内容 |
157
- | ---------------- | ------------------------------------------------------------------------------------- |
158
- | 業務価値との対応 | 全ての成功基準・受入条件に業務価値 ID がある |
159
- | 利用者視点 | 対象利用者、利用場面、期待結果を読み取れる |
160
- | 判定段階 | 初期公開・初期リリース、短期、中長期を区別し、判定時期と責任者がある |
161
- | 初期受入との分離 | 公開後の利用実績と中長期成果を、初期受入の合否へ混在させていない |
162
- | 検証可能性 | 測定方法、合格基準、証跡が具体的である |
163
- | 費用と負荷 | 低コストを価値に置く場合、現金支出、作業時間、継続運用負荷を分けている |
164
- | 責任の明確性 | 確認者と人間の承認者が明記されている |
165
- | 技術的受入 | 技術的条件が種別で分離され、業務価値との関係がある |
166
- | 対象範囲 | スコープ内・対象外と矛盾しない |
167
- | 公開適性 | 個人情報、非公開情報、機密情報がない |
168
- | ラベル整合性 | 未確定事項が _UNDECIDED_: に統一され、依存文書の _TODO_: 等を転記したままにしていない |
123
+ | 観点 | 確認内容 |
124
+ | ---------------- | -------------------------------------------------------------------- |
125
+ | 業務価値との対応 | 各条件が対象利用者のどの期待効果に応えるかを説明できるか |
126
+ | 初期受入との分離 | 公開後の利用実績や中長期の成果が、初期受入の合否に混じっていないか |
127
+ | 費用と負荷 | 低コストを価値に置く場合、人の作業時間と運用負荷を見落としていないか |
128
+ | 対象範囲 | スコープの対象・対象外と食い違っていないか |
169
129
 
170
130
  ## 8. 仕上げチェック
171
131
 
172
- - 「全体の作成手順」で示した章立てと必須表がそろっている。
173
- - 業務価値、成功基準、受入条件、証跡、確認者、承認者を対応付けた。
174
- - 閾値には測定対象、単位、母数または比較対象を示した。
175
- - 初期公開・初期リリース、短期、中長期の成功基準と、初期受入条件を分離した。
176
- - 対象外、未決事項、否決時の再判定方法を明示した。
177
- - 未確定事項のラベルが _UNDECIDED_: に統一され、依存文書(スコープ等)の _TODO_: などをそのまま転記していない。
178
- - 実装詳細、個別テスト手順、AI Agent による最終判断を書いていない。
179
- - 各業務価値を、利用者・期待効果、段階別成功基準、受入条件、測定方法、証跡、判断者へ ID で追跡できる。
132
+ - 各業務価値から、成功基準・受入条件・証跡・判断する役割までたどれる。
133
+ - 閾値に、測定対象・単位・母数または比較対象がある。
134
+ - 未確定の値が _UNDECIDED_: にそろい、上位成果物の _TODO_: を写したままにしていない。
135
+ - AI Agent を承認者にしていない。
@@ -11,166 +11,136 @@ specdojo:
11
11
 
12
12
  Status Definition Authoring Recipe
13
13
 
14
- 一つの業務対象について、状態の意味・成立条件と状態間の遷移を矛盾なく一文書へまとめる手順です。
14
+ 一つの業務対象について、状態で判断をそろえたい理由から、状態と遷移を説明できる内容に仕上げるための作り方を示す。
15
15
 
16
16
  ## 1. このレシピの使い方
17
17
 
18
- - 状態で判断をそろえたい業務課題を起点に、対象の開始から終了または継続管理に至るまでを聞き取り、状態候補と状態変更イベントを同時に集めます。
19
- - 状態一覧を先に仮置きし、遷移図を描いた後で到達不能・出口なし・重複状態を見つけて一覧へ戻します。
20
- - 各図と直下の遷移表を遷移 ID で一行ずつ照合し、最後に関連フローや用語との名称一致を確認します。
21
- - 実装値は状態の安定識別に必要な範囲だけ扱い、実装条件式や操作手順は後続設計へ委ねます。
18
+ - STSD は、状態で判断をそろえたい業務課題(Why)を「目的」で引き継ぎ、一つの対象の状態と遷移(What)を「状態一覧」と「状態遷移」で定め、現在状態の決め方と遷移の条件・判断者(How)を「状態の判定」と遷移表で示す。状態値と遷移 ID で、図・遷移表・関連文書・レビュー指摘から同じ状態と遷移をたどれるようにする(Trace)。実装条件式や操作手順は後続設計へ委ねる。
22
19
 
23
20
  ## 2. 作成前に集める情報
24
21
 
25
- | 入力 | 確認する内容 |
26
- | ---------------- | ---------------------------------------------------------------------------------------------------------------------- |
27
- | 対象と業務境界 | 状態を持つ一つの対象、開始・終了または継続管理の業務境界。同じ対象の TO-BE 文書と並ぶ場合だけ AS-IS / TO-BE を区別する |
28
- | 状態管理の目的 | 対象の何を管理する状態か、誰がその状態で何を判断するか、解決する業務課題 |
29
- | 状態候補 | 現場の正式名称・通称、その状態と判断する事実 |
30
- | 状態変更イベント | 誰が何をした、または何が起きたとき状態が変わるか |
31
- | 分岐条件 | 同じイベントから遷移先が分かれる場合の判定条件 |
32
- | 管理場所 | 現在状態と変更結果を確認する帳簿、台帳、記録、物の保管先 |
33
- | 判定規則と互換 | 正本と派生記録の区別、現在状態を一意に決める規則、旧状態値・旧イベント・未設定や欠損記録の扱い |
34
- | 関連文書 | 用語集、業務データ辞書、状態を変えるプロセスを示す CDFD |
22
+ | 項目 | 集める情報 | 取り出し元 |
23
+ | ---------------- | -------------------------------------------------------------- | ------------------------ |
24
+ | 対象と業務境界 | 状態を持つ一つの対象、状態変更が始まる業務と対象外の業務 | 関連 CDFD、業務分析担当 |
25
+ | 状態で行う判断 | 誰がその状態を見て、次に何をするかを決めるか | 現場の担当者への聞き取り |
26
+ | 状態候補 | 現場で「いま何の状態か」と答える名称・通称と、そう判断する事実 | 現場の担当者への聞き取り |
27
+ | 状態変更イベント | 誰が何をした、または何が起きたときに状態が変わるか | 関連 CDFD、現場の担当者 |
28
+ | 管理場所と正本 | 現在状態を確かめる記録と、派生して作る一覧・集計 | 帳簿・台帳・記録の現物 |
29
+ | 旧記録の扱い | 旧状態値・旧イベント・未設定の記録があるか | 既存の記録、移行の担当者 |
35
30
 
36
31
  ## 3. 全体の作成手順
37
32
 
38
- 1. 対象を一つに限定し、H1 直下に頭書き、「目的」に対象の何を状態で管理し、誰が何を判断するか、「適用範囲」に対象・業務境界・到達点を記載します。終了点を置かない場合は、管理を続ける状態と理由も「適用範囲」へ記載します。
39
- 2. 「状態の判定」に正本の管理場所、現在状態を一意に決める規則、互換の扱いを整理します。
40
- 3. 現場で「いま何の状態か」と答える際の名称を集め、意味または成立条件が同じ候補を統合します。
41
- 4. 「状態一覧」の各状態へ値、正式名称、通称、意味、成立条件、管理場所を記入し、判定規則と合わせて現在状態を特定できるか確認します。
42
- 5. 「状態遷移」で開始点から状態を並べ、矢印に `T-<nn> イベント / 条件` のラベルを付けて Mermaid の状態遷移図を描きます。新規文書では `T-01` から割り当てます。初回の確定前(`status: draft`)は、遷移の追加・削除・並べ替えに合わせて図と表の順に `T-01` から欠番なく振り直してかまいません。分割時も文書全体で通し番号にします。振り直すときは図のラベル・遷移表・本文中の遷移 ID への参照を同時に更新し、振り直したことと旧 ID・新 ID の対応(削除した遷移は削除した旨)を STSD 本文ではなく作業の記録へ残します。一度確定(`status: ready`)した後は既存 ID を保ち、削除した ID は欠番として再利用せず、追加する遷移には過去に未使用の ID を使います。
43
- 6. 各図のすぐ下に、その図の遷移 ID・遷移元・遷移先・イベント・条件・補足を一行ずつ記載した遷移表を置きます。分割時も図と表を一組として作成します。
44
- 7. 状態一覧・図・遷移表を照合し、孤立状態、到達不能状態、継続管理の理由を説明できない出口なしの状態、条件の重複を解消します。
45
- 8. 関連文書と状態名・イベント名・管理場所を照合し、未決事項だけを今後の検討メモへ残します。
46
-
47
- 成果物は頭書きに続けて「目的」「適用範囲」「状態の判定」「状態一覧」「状態遷移」の順に章を設け、未決事項がある場合だけ「今後の検討メモ」を加えます。スコープは現行を既定として省略し、同じ対象の TO-BE 文書と並ぶ場合だけ AS-IS / TO-BE を明記して文書を分けます。
33
+ 1. 対象を一つに決め、「目的」と「適用範囲」を書く。対象が決まらないと、状態候補の粒度と終了点の要否が決まらない。
34
+ 2. 状態候補と状態変更イベントを同時に聞き取り、意味か成立条件が同じ候補を統合して「状態一覧」を仮置きする。名称とイベントを別々に集めると、つながらない状態が残る。
35
+ 3. 「状態の判定」に正本の記録と現在状態を一つに決める規則を書く。成立条件だけでは判定が分かれる箇所が、ここで見つかる。
36
+ 4. 「状態遷移」で正常系の図と直下の遷移表を作り、その後に例外分岐と戻りを加える。正常系を先に描くと、例外がどの状態から外れるかが見える。
37
+ 5. 図から到達できない状態、出口のない状態、区別できない状態を探し、「状態一覧」へ戻して直す。
38
+ 6. 関連文書と状態名・イベント名を突き合わせ、残った未決事項だけを「今後の検討メモ」へ置く。
39
+ 7. 最後に H1 直下の頭書きを書く。対象と到達点が決まってから書くと、本文の言い直しにならない。
48
40
 
49
41
  ## 4. 各章の書き方
50
42
 
51
- ### 4.1. 頭書き
43
+ ### 4.1. 頭書きと目的
52
44
 
53
45
  問い:
54
46
 
55
- - 何の状態と遷移を定義する文書か、対象を一つの業務用語で答えられますか。
56
- - 読み手が H1 と頭書きだけで、この文書の主題を識別できますか。
57
- - 利用目的や範囲の詳細を後続の章へ分け、1〜2 行にまとめられますか。
47
+ - 状態は対象の何を管理するのか(進み具合、利用可否など)。
48
+ - 誰がその状態を見て、どの業務の要否を判断するのか。
49
+
50
+ コツ:
58
51
 
59
- 「商品の納品から販売または返品までの状態と遷移を定義する」のように、H1 直下へ記載します。頭書きには見出しを設けません。
52
+ - 「状態を区別しないと、どの判断がそろわないか」と聞くと、管理する内容と判断が一度に出る。
53
+ - 上位の概要や CDFD に書かれた背景は写さず、参照に置き換える。
60
54
 
61
- ### 4.2. 目的
55
+ ### 4.2. 適用範囲
62
56
 
63
57
  問い:
64
58
 
65
- - 状態は対象の何を管理しますか。進み具合、利用可否など、区別したい業務上の意味を答えられますか。
66
- - 誰がその状態を見て、次に行える業務や対応の要否を判断しますか。
67
- - 状態を区別しないと、どの判断が揃わず、業務にどのような支障が出ますか。
59
+ - どの開始イベントから、どこまでの業務で状態変更を扱うのか。
60
+ - 完了・中止の後も、差し戻しや記録更新のために状態を管理し続けるのか。
61
+
62
+ コツ:
68
63
 
69
- 「商品の受入から販売・返品までの進み具合と販売可否を管理する。店主代表が、売場へ補充できるか、仕入先への返品が必要かを判断するために使う」のように、管理する内容と状態による業務判断を 1〜3 文で結び付けます。文書の承認者や実装・テストへの利用方法は目的に含めません。
64
+ - 「完了した後に戻すことはあるか」を聞くと、終了点を置くかどうかが決まる。記録を保存するだけなら継続の理由にならない。
70
65
 
71
- ### 4.3. 適用範囲
66
+ ### 4.3. 状態の判定
72
67
 
73
68
  問い:
74
69
 
75
- - 状態を持つ対象を一つの業務用語で特定できますか。
76
- - どの開始イベントから、どの業務範囲で状態変更を扱い、どこから先を対象外にしますか。
77
- - 業務上の完了・中止後も、差し戻し、状態確認、記録更新のために状態管理を続けますか。
78
- - 終了点を置かない場合、業務上の到達点と管理を続ける状態・理由を説明できますか。
70
+ - 現在状態を確かめる正本はどの記録で、どれが派生した一覧か。
71
+ - 旧状態値や未設定の記録を、どう読み取るのか。
79
72
 
80
- 「適用範囲」へ、対象、状態変更を起こす業務範囲、到達点を箇条書きで記載します。終了点を置くかは、ライフサイクルを閉じる業務イベントと条件の有無から判断します。置かない場合は継続管理の理由、出力遷移のない継続状態もここへ記載し、記録の保存だけを理由にしません。対象が一状態だけなら、状態変化がない根拠も記載します。
73
+ コツ:
81
74
 
82
- ### 4.4. 状態の判定
75
+ - 同じ対象の記録を二人が別々に判定し、同じ状態になるか確かめる。分かれた箇所へ順序や優先関係を補う。
76
+ - 根拠のない読み替えや初期値は仮定せず、未決事項へ回す。
77
+
78
+ ### 4.4. 状態一覧
83
79
 
84
80
  問い:
85
81
 
86
- - 現在状態を確認する正本はどの記録ですか。履歴や集約記録を併用する場合、どれが正本でどれが派生物ですか。
87
- - 同じ対象の記録から、現在状態を一つに決められますか。イベントをたどる場合の順序と初期値、導出状態がある場合の条件と再判定の契機、成立条件が重なる場合の優先関係は明らかですか。
88
- - 旧状態値・旧イベント、未設定・欠損記録をどう読み取りますか。過去の記録の読み替えと、現在発行する遷移を混同していませんか。
82
+ - その状態になると、誰の判断や管理責任が変わるのか。
83
+ - 隣の状態と、どの事実で区別できるのか。
89
84
 
90
- 同じ対象の記録を二人が別々に判定し、同じ状態へ至るか確かめます。判定が分かれた箇所へ順序や優先関係を補い、状態固有の成立条件は「状態一覧」にまとめます。互換の扱いが不要ならその旨を示し、根拠がない読み替えや初期値は仮定せず、未決事項へ残します。
85
+ コツ:
91
86
 
92
- ### 4.5. 状態一覧
87
+ - 単なる処理待ちを状態にしたくなったら、判断や責任が変わるかを確かめ、変わらなければ前の状態に含める。
88
+ - 二つの候補が同時に成り立つなら、統合するか「状態の判定」に優先関係を書く。
93
89
 
94
- 問い:
90
+ ### 4.5. 状態遷移
95
91
 
96
- - 状態名は業務上の名詞句で、実装フラグや処理名になっていませんか。
97
- - 成立条件と「状態の判定」の規則から第三者が現在状態を一つに判定できますか。
98
- - 通称が正式名称と違う場合、その対応を一行で確認できますか。
99
- - 管理場所から現在状態の根拠を確認できますか。
92
+ 問い:
100
93
 
101
- 候補が同時に成立する場合は、状態を統合するか「状態の判定」に優先関係を記載します。単なる処理待ちを状態にする場合は、業務判断や管理責任が変わることを確認します。
94
+ - 例外の経路は、復帰・終了・人間の判断のどこへ進むのか。
95
+ - 分岐の条件は、記録や判断から yes / no で決められるのか。
102
96
 
103
- ### 4.6. 状態遷移
97
+ コツ:
104
98
 
105
- 問い:
99
+ - 補足には、判断者・証跡・例外時の扱いなど、図から読めない根拠だけを書く。
100
+ - 承認者や共通条件など、運用ガイドなどの上位成果物を正とする内容は写さず、参照に置き換える。
106
101
 
107
- - 開始点から主要な終了点または継続状態まで矢印をたどれますか。
108
- - 状態一覧の全状態が図にあり、図の業務状態が一覧にありますか。
109
- - 各矢印のラベルが `T-<nn> イベント / 条件` となり、同じ分岐元の条件を区別できますか。
110
- - 例外経路から復帰、終了、または人間の判断へ進めますか。
111
- - 各図のすぐ下の遷移表と、図の全矢印が遷移 ID・遷移元・遷移先・イベント・条件で一対一に対応していますか。
112
- - 初回の確定前か、一度確定した後かを確認し、遷移 ID の採番方法を選んでいますか。
113
- - 遷移 ID を振り直した場合、作業の記録から旧 ID のレビュー指摘と対応する遷移を追えますか。
114
- - 業務状態の遷移元・遷移先は状態一覧と同じ名称ですか。初期点は「開始」、終了点は「終了」とし、状態一覧へ追加していませんか。
115
- - 条件は記録や業務判断から yes / no で判定できますか。
116
- - 図だけでは分からない判断者、証跡、例外時の扱いを補足していますか。
102
+ ### 4.6. 今後の検討メモ
117
103
 
118
- まず正常系を描き、その後に例外分岐と戻りを加えます。`stateDiagram-v2` を使い、状態一覧に値がある場合は `状態名<br>値`、値が `-` なら状態名だけを表示します。無条件の矢印も `T-<nn> イベント / イベント発生時` として、開始・終了を含む全遷移を直下の表へ対応付けます。遷移の詳細は表を正本として図と同時に更新し、補足には判断者や証跡など図から読み取れない判定根拠だけを加えます。
104
+ 問い:
119
105
 
120
- 図を分ける場合は、業務フェーズや通常系・例外系ごとに遷移を振り分け、分割理由・扱う遷移 ID の範囲・共有状態を各図の前で説明します。共有状態は同じ表示名と `state_id` にそろえ、図のすぐ下へその図の遷移表を置いてから次の図へ進みます。全図を共有状態でつないで到達性を確認し、一つの遷移を複数の図表へ重複させません。共通条件は適用する遷移 ID とともに図の前へまとめ、表から参照します。
106
+ - 決まっていない例外状態・条件・用語・責任境界はどれか。
107
+ - 決まるまで、どの遷移をどう扱うのか。
121
108
 
122
- ### 4.7. 今後の検討メモ
109
+ コツ:
123
110
 
124
- - 未決の例外状態、条件、用語、責任境界だけを記載します。
125
- - 影響する状態名または遷移 ID、決定者、決定時期を添えます。
126
- - 調査・追記・修正が必要な事項は `_TODO_:`、意思決定待ちは `_UNDECIDED_:`、仮置き前提は `_ASSUMPTION_:` を付けて区別します。
111
+ - 「今後検討」だけで終えず、影響する状態または遷移 ID と、決まるまでの扱いを聞いて書く。
127
112
 
128
113
  ## 5. 深掘り手順
129
114
 
130
- 1. 各状態について「その直前は何か」「何が起きてこの状態になるか」を逆向きに確認します。
131
- 2. 各状態について「次に何へ進むか」「進めない場合はどうなるか」を順方向に確認します。
132
- 3. 同じ成立条件を持つ状態を探し、意味の違いを説明できなければ統合します。
133
- 4. 同じイベントから複数の矢印が出る箇所で条件を一つずつ反転し、重複や漏れを探します。
134
- 5. 管理場所を一つずつ確認し、状態変更の証跡が残らない遷移へ記録方法または判断者を補います。
135
- 6. 関連 CDFD の状態変更プロセスを一つずつたどり、対応する STSD とイベントを特定します。
115
+ 内容が浅いときは、次の順で対応のない主張を探す。
116
+
117
+ 1. 各状態について「その直前は何か」「何が起きてこの状態になるか」を逆向きにたどり、入口のない状態を探す。
118
+ 2. 各状態について「次に何へ進むか」「進めないときはどうなるか」を順向きにたどり、出口の理由を説明できない状態を探す。
119
+ 3. 同じイベントから分かれる矢印で条件を一つずつ反転し、重なりと漏れを探す。
120
+ 4. 各状態が「目的」のどの判断に使われるかを確かめ、使われない状態を統合する。
121
+ 5. 関連 CDFD の状態変更プロセスを一つずつたどり、対応する遷移のないプロセスを探す。
136
122
 
137
123
  ## 6. 良い例 / 悪い例
138
124
 
139
- | 観点 | 良い例 | 悪い例 |
140
- | -------- | ------------------------------------------------------------------ | ------------------------------------------ |
141
- | 対象 | 商品の入荷から販売・返品までを一文書で扱う | 商品と発注の状態を同じ一覧へ混在させる |
142
- | 状態名 | 販売可能 | `is_sellable` |
143
- | 成立条件 | 検品結果が合格で在庫数量へ反映された | 検品が終わったら |
144
- | 目的 | 商品の販売可否を管理し、店主が補充・返品の要否を判断する | 開発担当が設計し、品質確認担当がテストする |
145
- | 判定 | 正本の記録を業務の発生順にたどり、最後に成立した遷移先で判定する | 見た目で判断する |
146
- | 遷移 | `T-02 検品完了 / 数量・品質が合格` | 次へ進む |
147
- | 分岐 | 合格と、数量違いまたは品質不良を別条件にする | 成功 / それ以外 |
148
- | 管理場所 | 仕入記録で受入、在庫記録で販売可能を確認する | システムで管理する |
149
- | 図の分割 | 「状態遷移」で通常系の図と直下の表、例外系の図と直下の表を順に置く | 図を先に並べ、全遷移の表を別章へ置く |
125
+ | 観点 | 良い例 | 悪い例 |
126
+ | -------- | -------------------------------------------------------------- | -------------------------------------- |
127
+ | 対象 | 商品の入荷から販売・返品までを一文書で扱う | 商品と発注の状態を同じ一覧へ混在させる |
128
+ | 分岐 | 合格と、数量違いまたは品質不良を別の条件にする | 成功 / それ以外 |
129
+ | 処理待ち | 検品待ちは、検品者が受入可否の判断を負うため独立した状態にする | 画面の処理中表示をそのまま状態にする |
130
+ | 補足 | 返品の判断者を店主代表とし、仕入記録に返品理由を残す | 図と同じ経路を文章で順に説明する |
150
131
 
151
132
  ## 7. レビュー観点
152
133
 
153
- | 観点 | 確認内容 | 主な確認者 |
154
- | ------------ | --------------------------------------------------------------------------------------------- | ---------------------- |
155
- | 業務妥当性 | 状態と遷移が現場の判断・例外を表し、対象のライフサイクルを説明できる | 業務分析担当、店主代表 |
156
- | 目的との対応 | 状態が管理する内容と、その状態による業務上の判断が結び付いている | 業務分析担当、店主代表 |
157
- | 一意性 | 正本・判定規則・互換の扱いと成立条件から現在状態を一意に判定できる | 業務分析担当 |
158
- | 図表整合 | 各図と直下の遷移表の ID・遷移元・遷移先・イベント・条件が一致し、業務状態が状態一覧と対応する | 品質確認担当 |
159
- | 設計入力 | 状態値、イベント、条件、管理場所を後続設計へ引き渡せる | 技術メンター |
160
- | テスト可能性 | 初期、正常、例外、終了の経路と分岐条件から状態遷移テストを設計できる | 品質確認担当 |
161
- | 用語整合 | 状態名・通称・イベント名が関連文書と一致する | 業務分析担当 |
134
+ | 観点 | 確認内容 |
135
+ | ------------ | -------------------------------------------------------------------- |
136
+ | 目的との対応 | 各状態と遷移が、「目的」に書いた誰のどの判断に使われるか |
137
+ | 業務妥当性 | 現場の判断と例外を表し、対象の開始から到達点までを説明できるか |
138
+ | テスト可能性 | 初期・正常・例外・到達点の経路と分岐条件から状態遷移テストを組めるか |
139
+ | 委譲の境界 | 実装条件式・画面操作・詳細 API を後続設計へ委ね、書きすぎていないか |
162
140
 
163
141
  ## 8. 仕上げチェック
164
142
 
165
- - 一文書が一つの対象を扱い、現行を既定としてスコープを省略している。同じ対象の TO-BE 文書と並ぶ場合だけ AS-IS / TO-BE を明記して文書を分けている。
166
- - 頭書きは H1 直下の 1〜2 行に収まり、「目的」は状態が管理する内容と誰が何を判断するか、「適用範囲」は対象・業務境界・到達点、「状態の判定」は正本・判定規則・互換の扱いに分かれている。
167
- - 状態一覧の全行に値、状態名、通称、意味、成立条件、管理場所がある。コードや通称がない欄は `-` で示し、値は `-` を除いて文書内で一意になっている。
168
- - 状態一覧と状態遷移図の業務状態が過不足なく一致している。
169
- - 「状態遷移」で各図のすぐ下にその図の遷移表があり、図と表の間に説明文や別の図を挟んでいない。全遷移のラベルが `T-<nn> イベント / 条件` で、直下の表と一対一に一致し、分割時も文書全体で重複や欠落がない。
170
- - 開始から正常系・例外系の終了状態または継続状態までをたどれ、終了点を置かない理由と継続管理する状態を「適用範囲」で説明できる。
171
- - 条件分岐が相互に区別でき、判定不能な「適切」「問題なし」を使っていない。
172
- - 状態名、通称、イベント名、管理場所が用語集・業務データ辞書・関連 CDFD と矛盾しない。
173
- - 実装条件式、SQL、詳細 API、画面操作を状態定義として記載していない。
174
- - 今後の検討メモの `_TODO_:` を解消し、残る `_UNDECIDED_:`・`_ASSUMPTION_:` には影響する状態または遷移 ID、決定者、決定時期がある。
175
- - 公開対象の本文・図表に個人情報・非公開情報を含めていないことを確認し、公開可否の最終判断と説明責任を人間の PO が担うことを確認している。
176
- - 公開対象と人間の承認者を特定し、`ready` への昇格条件として内容確認、未解決指摘の扱いの合意、公開前確認をそろえている。作成中は `draft` を保ち、昇格は人間の承認後に人間が行う。
143
+ - 各状態が、「目的」に書いた判断のどれかに使われている。
144
+ - 例外の経路ごとに、復帰・終了・人間の判断のどこへ進むかを説明できる。
145
+ - 分岐の条件に「適切」「問題なし」など、判定できない語を使っていない。
146
+ - 未決事項ごとに、影響する状態または遷移 ID と決まるまでの扱いがある。