specdojo 0.8.0 → 0.9.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 (284) hide show
  1. package/.github/agents/specdojo-orchestrator.md +4 -1
  2. package/CHANGELOG.md +64 -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/where.js +25 -0
  9. package/dist/dashboard/dashboard.js +5 -3
  10. package/dist/dashboard/routines.js +4 -7
  11. package/dist/dashboard/timeline.js +14 -14
  12. package/dist/docs/index-command.js +2 -2
  13. package/dist/docs/yaml-business-tables.js +243 -0
  14. package/dist/docs/yaml-interface-tables.js +106 -0
  15. package/dist/docs/yaml-pages-command.js +5 -3
  16. package/dist/docs/yaml-pages.js +146 -3
  17. package/dist/docs/yaml-table-shared.js +70 -0
  18. package/dist/docs/yaml-tables.js +39 -0
  19. package/dist/exec/agent-config.js +9 -0
  20. package/dist/exec/agent-protected-config.js +2 -0
  21. package/dist/exec/commands.js +31 -18
  22. package/dist/exec/events.js +34 -14
  23. package/dist/exec/evidence.js +13 -3
  24. package/dist/exec/parent-validation.js +56 -3
  25. package/dist/exec/plans-core.js +21 -2
  26. package/dist/exec/plans-generation.js +6 -7
  27. package/dist/exec/post-integration.js +162 -0
  28. package/dist/exec/queue-command.js +166 -0
  29. package/dist/exec/queue.js +285 -0
  30. package/dist/exec/register-foreign-wait.js +84 -0
  31. package/dist/exec/repo-integration-sync.js +17 -5
  32. package/dist/exec/reporter.js +2 -2
  33. package/dist/exec/results.js +24 -4
  34. package/dist/exec/review-kata.js +4 -1
  35. package/dist/exec/run/agent-pipeline.js +3 -2
  36. package/dist/exec/run/agent.js +12 -6
  37. package/dist/exec/run/change-scope.js +365 -0
  38. package/dist/exec/run/deferred-cleanup.js +31 -0
  39. package/dist/exec/run/in-place.js +4 -1
  40. package/dist/exec/run/job-lock.js +66 -0
  41. package/dist/exec/run/job-sequence.js +137 -0
  42. package/dist/exec/run/job.js +56 -19
  43. package/dist/exec/run/lifecycle-commands.js +1 -1
  44. package/dist/exec/run/lock.js +22 -1
  45. package/dist/exec/run/register-command.js +8 -5
  46. package/dist/exec/run/register-mode.js +68 -8
  47. package/dist/exec/run/register-resume.js +68 -14
  48. package/dist/exec/run/register-state.js +13 -8
  49. package/dist/exec/run/register-worktree.js +140 -125
  50. package/dist/exec/run/schedule-mode.js +75 -14
  51. package/dist/exec/run/schedule-prepare.js +3 -0
  52. package/dist/exec/run/schedule-task.js +88 -38
  53. package/dist/exec/run/shared.js +5 -0
  54. package/dist/exec/schedule/schedule.js +116 -4
  55. package/dist/exec/shared.js +1 -1
  56. package/dist/exec/smoke.js +190 -0
  57. package/dist/exec/strategy.js +13 -3
  58. package/dist/exec/task-view.js +6 -4
  59. package/dist/exec/trial-commands.js +5 -2
  60. package/dist/exec/trial-core.js +6 -1
  61. package/dist/exec/validation-metrics.js +181 -0
  62. package/dist/exec/worktree-cleanup-lock.js +26 -0
  63. package/dist/exec/worktree-command.js +9 -1
  64. package/dist/exec/worktree-ops-commit.js +2 -2
  65. package/dist/exec/worktree.js +13 -2
  66. package/dist/grade/command-apply.js +3 -3
  67. package/dist/grade/command-inspect.js +5 -3
  68. package/dist/grade/command-plan.js +1 -1
  69. package/dist/grade/command-run.js +5 -1
  70. package/dist/grade/run.js +64 -8
  71. package/dist/job/definition.js +84 -8
  72. package/dist/job/job.js +79 -23
  73. package/dist/register/authoring-sources.js +22 -16
  74. package/dist/register/maintenance-commands.js +2 -2
  75. package/dist/register/register.js +31 -7
  76. package/dist/routine/definition.js +9 -0
  77. package/dist/routine/routine.js +137 -43
  78. package/dist/routine/status.js +62 -0
  79. package/dist/schedule/schedule.js +38 -39
  80. package/dist/shared/agent-types.js +5 -0
  81. package/dist/shared/cross-process-lock.js +9 -1
  82. package/dist/shared/dist-freshness.js +8 -2
  83. package/dist/shared/git-environment.js +2 -1
  84. package/dist/shared/git.js +44 -1
  85. package/dist/shared/lefthook-scaffold.js +3 -0
  86. package/dist/shared/local-config.js +244 -0
  87. package/dist/shared/specdojo-config.js +34 -20
  88. package/dist/shared/specdojo-gitignore.js +1 -0
  89. package/dist/shared/text.js +9 -1
  90. package/dist/shared/where-alias.js +13 -0
  91. package/dist/specdojo.js +4 -0
  92. package/docs/ja/specdojo/defaults/pm-review-viewpoints.yaml +2 -0
  93. package/docs/ja/specdojo/guides/exec-config-guide.md +23 -4
  94. package/docs/ja/specdojo/guides/exec-operation-guide.md +44 -1
  95. package/docs/ja/specdojo/guides/job-sequence-guide.md +77 -0
  96. package/docs/ja/specdojo/guides/quick-start-guide.md +3 -3
  97. package/docs/ja/specdojo/guides/register-operation-guide.md +1 -1
  98. package/docs/ja/specdojo/guides/routine-operation-guide.md +11 -6
  99. package/docs/ja/specdojo/guides/schedule-design-guide.md +20 -17
  100. package/docs/ja/specdojo/guides/waza-guide.md +12 -8
  101. package/docs/ja/specdojo/recipes/bac-recipe.md +66 -49
  102. package/docs/ja/specdojo/recipes/bes-recipe.md +90 -54
  103. package/docs/ja/specdojo/recipes/bps-recipe.md +88 -139
  104. package/docs/ja/specdojo/recipes/br-recipe.md +40 -47
  105. package/docs/ja/specdojo/recipes/cdfd-overview-recipe.md +97 -109
  106. package/docs/ja/specdojo/recipes/cdfd-recipe.md +85 -146
  107. package/docs/ja/specdojo/recipes/cdfd-uc-recipe.md +91 -110
  108. package/docs/ja/specdojo/recipes/cnd-recipe.md +79 -69
  109. package/docs/ja/specdojo/recipes/cpd-recipe.md +78 -64
  110. package/docs/ja/specdojo/recipes/cxd-recipe.md +92 -75
  111. package/docs/ja/specdojo/recipes/ifd-recipe.md +79 -68
  112. package/docs/ja/specdojo/recipes/ifx-cmd-recipe.md +78 -105
  113. package/docs/ja/specdojo/recipes/ifx-index-recipe.md +105 -71
  114. package/docs/ja/specdojo/recipes/pm-communication-plan-recipe.md +60 -49
  115. package/docs/ja/specdojo/recipes/pm-members-recipe.md +50 -51
  116. package/docs/ja/specdojo/recipes/pm-organization-recipe.md +59 -51
  117. package/docs/ja/specdojo/recipes/pm-plan-recipe.md +69 -56
  118. package/docs/ja/specdojo/recipes/pm-quality-management-plan-recipe.md +37 -56
  119. package/docs/ja/specdojo/recipes/pm-raci-recipe.md +39 -53
  120. package/docs/ja/specdojo/recipes/pm-roles-recipe.md +52 -79
  121. package/docs/ja/specdojo/recipes/prj-assumptions-constraints-dependencies-recipe.md +64 -93
  122. package/docs/ja/specdojo/recipes/prj-charter-recipe.md +71 -106
  123. package/docs/ja/specdojo/recipes/prj-comparison-of-alternatives-recipe.md +78 -157
  124. package/docs/ja/specdojo/recipes/prj-issues-and-approach-recipe.md +62 -111
  125. package/docs/ja/specdojo/recipes/prj-scope-recipe.md +67 -123
  126. package/docs/ja/specdojo/recipes/prj-stakeholder-register-recipe.md +60 -96
  127. package/docs/ja/specdojo/recipes/prj-success-criteria-and-acceptance-criteria-recipe.md +61 -105
  128. package/docs/ja/specdojo/recipes/stsd-recipe.md +79 -109
  129. package/docs/ja/specdojo/recipes/sysd-critical-flows-recipe.md +78 -55
  130. package/docs/ja/specdojo/recipes/sysd-cross-cutting-policy-recipe.md +82 -73
  131. package/docs/ja/specdojo/recipes/sysd-index-recipe.md +78 -59
  132. package/docs/ja/specdojo/recipes/tsd-recipe.md +149 -129
  133. package/docs/ja/specdojo/references/command-reference.md +257 -117
  134. package/docs/ja/specdojo/references/deliverables-reference.md +21 -12
  135. package/docs/ja/specdojo/references/specdojo-config-reference.md +37 -2
  136. package/docs/ja/specdojo/rulebooks/atc-index-rulebook.md +101 -257
  137. package/docs/ja/specdojo/rulebooks/atc-rulebook.md +102 -228
  138. package/docs/ja/specdojo/rulebooks/bac-rulebook.md +19 -28
  139. package/docs/ja/specdojo/rulebooks/bdd-rulebook.md +16 -67
  140. package/docs/ja/specdojo/rulebooks/bds-rulebook.md +30 -51
  141. package/docs/ja/specdojo/rulebooks/bes-index-rulebook.md +41 -61
  142. package/docs/ja/specdojo/rulebooks/bes-rulebook.md +22 -50
  143. package/docs/ja/specdojo/rulebooks/bps-rulebook.md +24 -56
  144. package/docs/ja/specdojo/rulebooks/br-rulebook.md +13 -38
  145. package/docs/ja/specdojo/rulebooks/ccd-mermaid-rulebook.md +41 -76
  146. package/docs/ja/specdojo/rulebooks/cdfd-d2-rulebook.md +18 -93
  147. package/docs/ja/specdojo/rulebooks/cdfd-mermaid-rulebook.md +18 -52
  148. package/docs/ja/specdojo/rulebooks/cdfd-overview-rulebook.md +109 -147
  149. package/docs/ja/specdojo/rulebooks/cdfd-rulebook.md +80 -108
  150. package/docs/ja/specdojo/rulebooks/cdfd-uc-rulebook.md +21 -46
  151. package/docs/ja/specdojo/rulebooks/cdr-rulebook.md +144 -0
  152. package/docs/ja/specdojo/rulebooks/cdsd-rulebook.md +27 -48
  153. package/docs/ja/specdojo/rulebooks/cdt-rulebook.md +37 -50
  154. package/docs/ja/specdojo/rulebooks/clis-rulebook.md +52 -69
  155. package/docs/ja/specdojo/rulebooks/cnd-mermaid-rulebook.md +33 -86
  156. package/docs/ja/specdojo/rulebooks/cnd-rulebook.md +16 -32
  157. package/docs/ja/specdojo/rulebooks/cop-index-rulebook.md +45 -131
  158. package/docs/ja/specdojo/rulebooks/cop-rulebook.md +69 -275
  159. package/docs/ja/specdojo/rulebooks/cpd-mermaid-rulebook.md +20 -112
  160. package/docs/ja/specdojo/rulebooks/cpd-rulebook.md +23 -56
  161. package/docs/ja/specdojo/rulebooks/cxd-mermaid-rulebook.md +12 -145
  162. package/docs/ja/specdojo/rulebooks/cxd-rulebook.md +39 -47
  163. package/docs/ja/specdojo/rulebooks/dct-index-rulebook.md +37 -56
  164. package/docs/ja/specdojo/rulebooks/dct-rulebook.md +118 -175
  165. package/docs/ja/specdojo/rulebooks/dec-rulebook.md +5 -14
  166. package/docs/ja/specdojo/rulebooks/dmd-index-rulebook.md +22 -66
  167. package/docs/ja/specdojo/rulebooks/dmd-rulebook.md +36 -94
  168. package/docs/ja/specdojo/rulebooks/dss-rulebook.md +59 -81
  169. package/docs/ja/specdojo/rulebooks/etc-index-rulebook.md +31 -131
  170. package/docs/ja/specdojo/rulebooks/etc-rulebook.md +50 -104
  171. package/docs/ja/specdojo/rulebooks/gl-rulebook.md +51 -61
  172. package/docs/ja/specdojo/rulebooks/ifd-mermaid-rulebook.md +38 -45
  173. package/docs/ja/specdojo/rulebooks/ifx-api-rulebook.md +14 -20
  174. package/docs/ja/specdojo/rulebooks/ifx-cmd-rulebook.md +26 -38
  175. package/docs/ja/specdojo/rulebooks/ifx-file-rulebook.md +26 -107
  176. package/docs/ja/specdojo/rulebooks/ifx-index-rulebook.md +42 -49
  177. package/docs/ja/specdojo/rulebooks/ifx-msg-rulebook.md +14 -22
  178. package/docs/ja/specdojo/rulebooks/imp-business-rulebook.md +21 -44
  179. package/docs/ja/specdojo/rulebooks/imp-data-rulebook.md +41 -64
  180. package/docs/ja/specdojo/rulebooks/imp-interface-rulebook.md +14 -38
  181. package/docs/ja/specdojo/rulebooks/imp-operations-rulebook.md +34 -61
  182. package/docs/ja/specdojo/rulebooks/imp-test-rulebook.md +27 -50
  183. package/docs/ja/specdojo/rulebooks/itc-index-rulebook.md +70 -199
  184. package/docs/ja/specdojo/rulebooks/itc-rulebook.md +65 -153
  185. package/docs/ja/specdojo/rulebooks/mip-index-rulebook.md +74 -150
  186. package/docs/ja/specdojo/rulebooks/mm-rulebook.md +11 -23
  187. package/docs/ja/specdojo/rulebooks/mtp-rulebook.md +99 -176
  188. package/docs/ja/specdojo/rulebooks/nfr-availability-rulebook.md +35 -61
  189. package/docs/ja/specdojo/rulebooks/nfr-index-rulebook.md +75 -117
  190. package/docs/ja/specdojo/rulebooks/nfr-integrity-rulebook.md +31 -60
  191. package/docs/ja/specdojo/rulebooks/nfr-maintainability-rulebook.md +26 -81
  192. package/docs/ja/specdojo/rulebooks/nfr-operations-rulebook.md +32 -70
  193. package/docs/ja/specdojo/rulebooks/nfr-performance-rulebook.md +45 -87
  194. package/docs/ja/specdojo/rulebooks/nfr-reliability-rulebook.md +48 -101
  195. package/docs/ja/specdojo/rulebooks/nfr-security-safety-rulebook.md +44 -80
  196. package/docs/ja/specdojo/rulebooks/nfr-usability-rulebook.md +59 -127
  197. package/docs/ja/specdojo/rulebooks/opd-index-rulebook.md +31 -50
  198. package/docs/ja/specdojo/rulebooks/opd-rulebook.md +42 -109
  199. package/docs/ja/specdojo/rulebooks/opr-index-rulebook.md +29 -42
  200. package/docs/ja/specdojo/rulebooks/opr-rulebook.md +29 -87
  201. package/docs/ja/specdojo/rulebooks/otp-index-rulebook.md +62 -84
  202. package/docs/ja/specdojo/rulebooks/otp-rulebook.md +11 -61
  203. package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +91 -106
  204. package/docs/ja/specdojo/rulebooks/pm-change-request-log-rulebook.md +25 -34
  205. package/docs/ja/specdojo/rulebooks/pm-communication-plan-rulebook.md +30 -53
  206. package/docs/ja/specdojo/rulebooks/pm-issue-log-rulebook.md +23 -35
  207. package/docs/ja/specdojo/rulebooks/pm-members-rulebook.md +27 -45
  208. package/docs/ja/specdojo/rulebooks/pm-organization-rulebook.md +37 -45
  209. package/docs/ja/specdojo/rulebooks/pm-plan-rulebook.md +45 -46
  210. package/docs/ja/specdojo/rulebooks/pm-quality-management-plan-rulebook.md +37 -48
  211. package/docs/ja/specdojo/rulebooks/pm-raci-rulebook.md +25 -29
  212. package/docs/ja/specdojo/rulebooks/pm-risk-register-rulebook.md +28 -35
  213. package/docs/ja/specdojo/rulebooks/pm-roles-rulebook.md +36 -41
  214. package/docs/ja/specdojo/rulebooks/pr-rulebook.md +5 -18
  215. package/docs/ja/specdojo/rulebooks/prj-assumptions-constraints-dependencies-rulebook.md +16 -37
  216. package/docs/ja/specdojo/rulebooks/prj-charter-rulebook.md +23 -97
  217. package/docs/ja/specdojo/rulebooks/prj-comparison-of-alternatives-rulebook.md +39 -57
  218. package/docs/ja/specdojo/rulebooks/prj-issues-and-approach-rulebook.md +43 -116
  219. package/docs/ja/specdojo/rulebooks/prj-scope-rulebook.md +16 -51
  220. package/docs/ja/specdojo/rulebooks/prj-stakeholder-register-rulebook.md +47 -92
  221. package/docs/ja/specdojo/rulebooks/prj-success-criteria-and-acceptance-criteria-rulebook.md +25 -84
  222. package/docs/ja/specdojo/rulebooks/sac-rulebook.md +44 -107
  223. package/docs/ja/specdojo/rulebooks/sf-index-rulebook.md +39 -49
  224. package/docs/ja/specdojo/rulebooks/sf-rulebook.md +42 -49
  225. package/docs/ja/specdojo/rulebooks/sld-rulebook.md +64 -89
  226. package/docs/ja/specdojo/rulebooks/stc-index-rulebook.md +90 -189
  227. package/docs/ja/specdojo/rulebooks/stc-rulebook.md +45 -105
  228. package/docs/ja/specdojo/rulebooks/stsd-mermaid-rulebook.md +6 -12
  229. package/docs/ja/specdojo/rulebooks/stsd-rulebook.md +49 -68
  230. package/docs/ja/specdojo/rulebooks/sysd-critical-flows-rulebook.md +51 -60
  231. package/docs/ja/specdojo/rulebooks/sysd-cross-cutting-policy-rulebook.md +46 -50
  232. package/docs/ja/specdojo/rulebooks/sysd-index-rulebook.md +39 -64
  233. package/docs/ja/specdojo/rulebooks/sysd-rulebook.md +47 -60
  234. package/docs/ja/specdojo/rulebooks/trc-requirements-to-specs-rulebook.md +69 -70
  235. package/docs/ja/specdojo/rulebooks/trc-requirements-to-tests-rulebook.md +65 -72
  236. package/docs/ja/specdojo/rulebooks/tsd-index-rulebook.md +35 -46
  237. package/docs/ja/specdojo/rulebooks/tsd-rulebook.md +49 -66
  238. package/docs/ja/specdojo/rulebooks/tsp-index-rulebook.md +64 -139
  239. package/docs/ja/specdojo/rulebooks/uis-rulebook.md +41 -108
  240. package/docs/ja/specdojo/rulebooks/utc-index-rulebook.md +49 -144
  241. package/docs/ja/specdojo/rulebooks/utc-rulebook.md +67 -155
  242. package/docs/ja/specdojo/samples/bds-sample.md +58 -71
  243. package/docs/ja/specdojo/samples/bes-index-sample.md +20 -37
  244. package/docs/ja/specdojo/samples/bes-sample.md +43 -53
  245. package/docs/ja/specdojo/samples/bps-sample.md +42 -54
  246. package/docs/ja/specdojo/samples/br-sample.md +40 -52
  247. package/docs/ja/specdojo/samples/ccd-sample.md +0 -1
  248. package/docs/ja/specdojo/samples/cdr-sample.md +78 -0
  249. package/docs/ja/specdojo/samples/cdsd-sample.md +47 -63
  250. package/docs/ja/specdojo/samples/clis-sample.md +70 -77
  251. package/docs/ja/specdojo/samples/dec-sample.md +2 -3
  252. package/docs/ja/specdojo/samples/ifx-api-sample.yaml +0 -2
  253. package/docs/ja/specdojo/samples/ifx-msg-sample.yaml +0 -2
  254. package/docs/ja/specdojo/samples/job-sequence.yaml +67 -0
  255. package/docs/ja/specdojo/samples/mip-index-sample.md +98 -20
  256. package/docs/ja/specdojo/samples/pm-communication-plan-sample.md +26 -19
  257. package/docs/ja/specdojo/samples/pm-organization-sample.md +39 -50
  258. package/docs/ja/specdojo/samples/pm-plan-sample.md +61 -67
  259. package/docs/ja/specdojo/samples/pm-quality-management-plan-sample.md +31 -45
  260. package/docs/ja/specdojo/samples/pm-raci-sample.md +31 -37
  261. package/docs/ja/specdojo/samples/prj-assumptions-constraints-dependencies-sample.md +32 -48
  262. package/docs/ja/specdojo/samples/prj-charter-sample.md +42 -59
  263. package/docs/ja/specdojo/samples/prj-comparison-of-alternatives-sample.md +55 -61
  264. package/docs/ja/specdojo/samples/prj-success-criteria-and-acceptance-criteria-sample.md +30 -33
  265. package/docs/ja/specdojo/samples/sf-index-sample.md +13 -55
  266. package/docs/ja/specdojo/samples/sf-sample.md +73 -85
  267. package/docs/ja/specdojo/samples/sld-sample.md +60 -79
  268. package/docs/ja/specdojo/samples/uis-sample.md +98 -121
  269. package/docs/ja/specdojo/standards/job-definition-standard.md +24 -9
  270. package/docs/ja/specdojo/templates/cdr-template.md +58 -0
  271. package/docs/specdojo/schemas/v1/exec-common.schema.yaml +2 -1
  272. package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +42 -5
  273. package/docs/specdojo/schemas/v1/exec-evidence.schema.yaml +35 -0
  274. package/docs/specdojo/schemas/v1/job-run.schema.yaml +23 -0
  275. package/docs/specdojo/schemas/v1/job.schema.yaml +63 -2
  276. package/docs/specdojo/schemas/v1/sch-strategy.schema.yaml +2 -2
  277. package/package.json +9 -6
  278. package/templates/antigravity/orchestrator.md +4 -1
  279. package/templates/claude/agents/specdojo-orchestrator.md +4 -1
  280. package/templates/codex/agents/specdojo-orchestrator.toml +4 -1
  281. package/templates/codex/orchestrator.md +4 -1
  282. package/templates/init-exec-defaults.yaml +13 -0
  283. package/templates/lefthook/tools/specdojo-pre-commit.mjs +8 -0
  284. package/templates/opencode/agents/specdojo-orchestrator.md +5 -2
@@ -11,95 +11,131 @@ specdojo:
11
11
 
12
12
  Business Event Specification Writing Recipe
13
13
 
14
- 起点が違っても同じ出来事と呼べるか、どの時点の何を事実として残すかを具体化するための手順です。業務上の混同を減らし、別の担当者も発生有無とデータの意味を判断できる記述へつなげます。
14
+ 起点が違っても同じ出来事か、どの時点の何を事実とするかを判断できる記述の作り方を示す。
15
15
 
16
16
  ## 1. このレシピの使い方
17
17
 
18
- - 上位の業務目的とイベント一覧から、誰が何を取り違えて困るのかを一つ選びます。その混同を解消する事実の境界を本書で定めます。
19
- - 成立と不成立の場面を並べてから、何が起きたか、いつ、誰が/何が、発生条件、事実データの五章を書きます。処理後の手順や実装方式は委譲先へ分けます。
20
- - 各主張を、上位イベント・状態定義・データモデルのどれで確認できるかたどります。確認できない境界は推測で埋めず、判断者と確認時期を添えて残します。
18
+ - 業務イベント仕様は、一覧から防ぎたい混同(Why)を引き継ぎ、一回の事実の境界・時点・条件・データ(What)を定め、要求者と成立させる主体(How)を分ける。主張は上位一覧・状態定義・データモデルでたどる(Trace)。
21
19
 
22
20
  ## 2. 作成前に集める情報
23
21
 
24
- | 入力 | 確かめる問い |
25
- | ---------------- | -------------------------------------------------------------------------- |
26
- | 業務目的と利用者 | 定義が曖昧だと、誰が何を誤って数えたり引き継いだりするか |
27
- | 上位イベント一覧 | どの出来事を詳細化するか。共通の対象範囲と個別の差分は何か |
28
- | 似た出来事 | 要求、受付、確定、着手、処理完了を区別する必要があるか |
29
- | 起点と主体 | 人の指名、自動判断、一括要求などで成立する事実が変わるか |
30
- | 状態と業務ルール | 成立直前の状態をどこで判定するか。条件と判断ロジックの正本は何か |
31
- | データモデル | 対象、取引、要求、実行をどう区別するか。既存の識別情報で相関を説明できるか |
32
- | 承認と未決事項 | 誰が業務定義を承認するか。確認担当、判断期限、記録先が決まっているか |
22
+ | 項目 | 集める情報 | 取り出し元 |
23
+ | ---------------- | ---------------------------------------------- | -------------------- |
24
+ | 防ぎたい混同 | 誰が何を誤って数え、引き継ぐか | 業務目的、利用者 |
25
+ | 対応するイベント | 対応する行と、共通の対象範囲・用語 | 業務イベント一覧 |
26
+ | 似た出来事・起点 | 取り違えやすい要求・受付・後処理と、起点の種類 | 業務の担当者 |
27
+ | 判断の根拠 | 成立直前の状態と、条件の正本 | 状態定義、業務ルール |
28
+ | 識別情報 | 対象・取引・要求・実行を区別する情報 | データモデル |
29
+ | 承認する人 | 業務定義を承認する人と判断時期 | 業務の承認者 |
33
30
 
34
31
  ## 3. 全体の作成手順
35
32
 
36
- 1. 解消する混同と対象業務を一文にし、読者が発生有無・回数を判定できることを利用の基準にします。
37
- 2. 「何が起きたか」に、一回分の事実と含めない出来事を書きます。適用範囲が不明なら、確認できた業務と未判定の業務を分けます。
38
- 3. 「いつ」に、成立を観測できる時点を書きます。要求から後処理までを時系列に並べ、どこで初めて事実になるかを選びます。
39
- 4. 「誰が/何が」に、要求者と成立させる主体を並べます。起点が異なっても境界が同じかを比較します。
40
- 5. 「発生条件」に、共通条件、起点別の差分、不成立条件を書きます。正本にある判断ロジックをコピーせず、何を満たした事実なのかへ絞ります。
41
- 6. 「事実データ」に、その時点で分かる情報だけを置きます。一括要求は二件以上を紙上で並べ、要求と個別対象を混同しない相関情報を探します。
42
- 7. 発生・相関の確認例から判断を説明します。未決事項には判断者、確認担当、時期、記録先を付け、承認前に引き渡せる範囲を明示します。
33
+ 1. 防ぐ混同を一文でメモする。これがないと一回の単位が決まらない。
34
+ 2. 成立と不成立の場面を並べてから「何が起きたか」を書く。
35
+ 3. 「いつ」「誰が/何が」「発生条件」「事実データ」の順に書く。前の章の境界が後の章の範囲になる。
36
+ 4. 解釈が分かれた場面を確認例にする。
37
+ 5. 導入は最後に書く。境界が決まる前に書くと本文の言い直しになる。
43
38
 
44
39
  ## 4. 各章の書き方
45
40
 
46
- ### 4.1. 何が起きたか
41
+ ### 4.1. 導入
47
42
 
48
- 問いは「誰のどの混同を防ぐ事実か」「同じ要求で二件確定したら一回か二回か」です。名詞だけでなく、対象と成立した事実を一文にします。
43
+ 問い:
49
44
 
50
- 良い例は「一取引の会計が確定した。複数明細でも一回」。避けたい例は「販売処理」で、事実と処理を区別できません。
45
+ - この定義がないと、誰が何を取り違えるか。
46
+ - 何を判定できれば、この定義を使えたと言えるか。
51
47
 
52
- ### 4.2. いつ
48
+ コツ:
53
49
 
54
- 問いは「成立したと言える最初の観測点はどこか」「同じ排他区間で行う別の処理も同じ出来事なのか」です。処理の近さと業務上の同一性を分けて考えます。
50
+ - 業務の目的や用語は、写さず上位一覧への参照に置き換える。
51
+ - 一覧に対応する行がなければ、推測で結び付けず未照合と書く。
55
52
 
56
- 良い例は「会計確定を記録した時点」。避けたい例は「会計中」で、発生前後を分けられません。
53
+ ### 4.2. 何が起きたか
57
54
 
58
- ### 4.3. 誰が/何が
55
+ 問い:
59
56
 
60
- 問いは「要求者と確定する主体は同じか」「人の判断とシステムの記録の責任はどこで分かれるか」です。名称を役割、構成要素、実際の担当者のどれとして使うか確かめます。
57
+ - 同じ要求で二件確定したら、一回か二回か。
58
+ - まだ判定していない業務はどれか。
61
59
 
62
- 良い例は「店番担当が要求し、販売管理システムが確定を記録する」。避けたい例は「担当が実行する」で、何を担当したかが分かりません。
60
+ コツ:
63
61
 
64
- ### 4.4. 発生条件
62
+ - 「販売処理」のような名詞で止まったら、成立した事実を過去形にする。
63
+ - 承認する人と時期が未定の業務は、対象外にしない。
65
64
 
66
- 問いは「直前まで同じでも、何が欠けたら発生しないか」「今の依存文書だけで全業務への適用を判断できるか」です。成立する例の条件を一つだけ外して、不成立の境界を探します。
65
+ ### 4.3. いつ
67
66
 
68
- 良い例は「未確定の取引で受領を確認して確定した場合。合計表示だけでは発生しない」。避けたい例は「条件が揃えば発生する」で、確認すべき条件が隠れます。
67
+ 問い:
69
68
 
70
- ### 4.5. 事実データ
69
+ - 成立したと言える最初の観測点はどこか。
70
+ - 同じ排他区間の別の処理も、同じ出来事か。
71
71
 
72
- 問いは「各項目は何を区別するために必要か」「最後にしか分からない件数を最初の事実にしていないか」「実行 ID で同じ要求をたどれる根拠はあるか」です。データモデルの項目名を先に決めず、意味と単位から対応を確認します。
72
+ コツ:
73
73
 
74
- 良い例は「取引番号で確定と明細を対応付ける」。避けたい例は「時刻が近いので同じ要求」とする推定です。
74
+ - 処理が近いことと、業務上同じ出来事であることを分ける。
75
+
76
+ ### 4.4. 誰が/何が
77
+
78
+ 問い:
79
+
80
+ - 要求者と事実を成立させる主体は同じか。
81
+ - 人の判断とシステムの記録は、どこで分かれるか。
82
+
83
+ コツ:
84
+
85
+ - 名称が役割・構成要素・担当者のどれかを聞く。混ざると章ごとに意味が変わる。
86
+
87
+ ### 4.5. 発生条件
88
+
89
+ 問い:
90
+
91
+ - 直前まで同じでも、何が欠けたら発生しないか。
92
+ - 今の参照文書だけで、全業務への適用を判断できるか。
93
+
94
+ コツ:
95
+
96
+ - 判断ロジックは写さず業務ルールを参照し、満たした事実だけを書く。
97
+
98
+ ### 4.6. 事実データ
99
+
100
+ 問い:
101
+
102
+ - 各項目は何を区別するために要るか。
103
+ - 最後にしか分からない件数を、最初の事実にしていないか。
104
+
105
+ コツ:
106
+
107
+ - 項目名より先に、意味と単位でデータモデルとの対応を確かめる。
108
+ - 一括要求は二件並べると、要求と対象の混同に気づく。
75
109
 
76
110
  ## 5. 深掘り手順
77
111
 
78
- 1. 事実の境界で意見が分かれたら、同じ操作でも発生しない例を一つ示し、何を観測できていないか確認します。
79
- 2. 自動・一括で説明が崩れたら、二つの要求にそれぞれ複数の対象を置き、要求、対象、実行の対応を書き出します。既存モデルで対応できなければ未決事項にします。
80
- 3. 根拠が参照範囲にないときは、必要な文書 ID と依存追加の必要性を記録します。確認済みの範囲まで書き、未確認の業務を恒久的に除外する結論は出しません。
112
+ 浅いときは、次の順で対応のない主張を探す。
113
+
114
+ 1. 各境界が導入のどの混同を防ぐかを確かめ、対応のない境界を外す。
115
+ 2. 発生条件の各行を、状態定義・業務ルールのどこで判定するか確かめる。
116
+ 3. 事実データの各項目が使われる判定を確かめ、使われない項目を外す。
117
+ 4. 根拠が参照範囲にない主張は、確認済みの範囲まで書く。
81
118
 
82
119
  ## 6. 良い例 / 悪い例
83
120
 
84
- | 観点 | 良い例 | 悪い例 | 判断の違い |
85
- | -------- | ---------------------------------------------------------------- | ---------------------------- | ------------------------------ |
86
- | 発生単位 | 一取引に複数明細があっても確定は一回 | 複数の場合も扱う | 数える単位を決められるか |
87
- | 観測時点 | 確定記録の成立時。印字完了は後処理 | 正常に終了した時 | 何の終了かが分かるか |
88
- | 未決事項 | 判断者と確認担当を分け、設計着手前に判断結果をレビュー結果へ記録 | 後で確認する | 誰がいつ何を決めるかたどれるか |
89
- | 相関情報 | 同じ要求の二件は同じ相関情報、別要求では区別する | 同じ実行 ID を使えばよいはず | 根拠のある単位で関連付けるか |
121
+ | 観点 | 良い例 | 悪い例 |
122
+ | -------- | -------------------------------------------------- | ---------------------- |
123
+ | 発生単位 | 複数明細の一取引でも確定は一回 | 複数の場合も扱う |
124
+ | 観測時点 | 確定記録の成立時。印字完了は後処理 | 正常に終了した時 |
125
+ | 発生条件 | 未確定の取引を確定した場合。合計表示では発生しない | 条件が揃えば発生する |
126
+ | 相関情報 | 取引番号で確定と明細を対応付ける | 同じ実行 ID でよいはず |
90
127
 
91
128
  ## 7. レビュー観点
92
129
 
93
- | 観点 | 確認する問い | 主な確認者 |
94
- | ---------------- | ------------------------------------------------------ | ---------- |
95
- | 業務価値 | 解消したい混同と、定義した発生境界が対応するか | BA |
96
- | 業務承認 | 対象範囲と未決事項を判断する人間を識別できるか | PO |
97
- | 技術への引き渡し | 状態定義とデータモデルに照合でき、未確認部分が分かるか | ARC |
98
- | 確認可能性 | 同じ場面から発生有無・回数・相関を判断できるか | QE |
130
+ | 観点 | 確認内容 |
131
+ | ---------------- | ------------------------------------------------------ |
132
+ | 業務価値 | 混同と発生境界が対応するか |
133
+ | 技術への引き渡し | 状態定義・データモデルと照合でき、未確認部分が分かるか |
134
+ | 確認可能性 | 同じ場面から発生有無・回数・相関を判断できるか |
99
135
 
100
136
  ## 8. 仕上げチェック
101
137
 
102
- - 用いた主体名と識別情報の意味が、五章の間で変わっていないことを確認します。
103
- - 発生条件を満たさない例と、成立後の処理が失敗する例を混同していないことを確認します。
104
- - 確認できた範囲と未判定の範囲を区別し、判断者・時期・記録先のない論点を残していないことを確認します。
105
- - 本文に残した情報が発生時点で観測でき、後処理の手順や正本の項目定義を重複していないことを確認します。
138
+ - 主体名と識別情報の意味が、章の間で変わっていない。
139
+ - 発生しない例と、成立後の処理の失敗を混同していない。
140
+ - 導入で上位一覧の対応イベントが分かるか、未照合と書いている。
141
+ - まだない文書は ID の仮置きにし、確認する人と時期を添えている。
@@ -11,48 +11,32 @@ specdojo:
11
11
 
12
12
  Business Process Specification Writing Recipe
13
13
 
14
- 一つのプロセス領域に属し、共通の起点から一つの業務成果へ至る流れを、業務担当者が合意でき、設計者とテスト担当者が後続作業へ利用できる粒度へ具体化する手順です。
14
+ 共通の起点から一つの業務成果へ至る流れを、業務担当者が合意でき、設計者とテスト担当者が後続作業に使える内容に仕上げるための作り方を示す。
15
15
 
16
16
  ## 1. このレシピの使い方
17
17
 
18
- - 最初に CDFD から対象領域、個別プロセス、主要な入出力、データストアを抜き出し、一つの起点と業務成果に流れを限定します。
19
- - 次に、業務担当者への聞き取りからトリガー、前提条件、担当、判断、例外を集め、開始から終了までを処理ステップとして並べます。
20
- - その後、各ステップの入力、出力、完了条件を補い、BR、BES、STSD、データ定義へ委ねる情報を分離します。
21
- - 最後に、正常系、条件付き処理、主要例外を業務成果と確認記録までたどり、第三者が受入可否を判定できるかを確認します。
22
-
23
- この成果物は、プロセス領域が担う業務目的を Why、開始条件と確定する業務成果を What、担当・処理・例外対応を How、トリガー ID・ステップ ID・例外 ID・参照先の対応を Trace として整理します。判断式、イベント契約、状態定義、データ項目定義は複製せず、利用箇所から参照します。
18
+ - BPS は、CDFD のプロセス領域が担う業務目的(Why)を引き継ぎ、起点と確定する業務成果(What)を定め、担当・処理・例外対応(How)を決める。トリガー ID・ステップ ID・例外 ID と CDFD プロセス ID・参照仕様 ID で対応をたどれるようにする(Trace)。
24
19
 
25
20
  ## 2. 作成前に集める情報
26
21
 
27
- | 項目 | 集める情報 |
28
- | ---------- | ------------------------------------------------------------------------------------------- |
29
- | 対象領域 | CDFD のプロセス領域 ID・名称・業務目的・主担当・起点イベント |
30
- | 対象の流れ | 共通の起点から一つの業務成果へ至る個別プロセスと、その開始・終了 |
31
- | 利用者 | 流れを実施・承認する役割と、成果を設計・テスト・後続業務へ利用する役割 |
32
- | トリガー | 発生時点を観測できる出来事、発生元、受領情報、開始条件 |
33
- | 前提条件 | 開始前に yes / no で確認する業務条件と、不成立時の扱い |
34
- | 入力と正本 | 業務上の入力名、入手元、利用目的、必須性、正本 |
35
- | 処理と責任 | CDFD の個別プロセス、各活動・判断の担当、順序、分岐、完了条件 |
36
- | 業務成果 | 確定する記録、状態変化、通知、判断結果、受け手、後続処理 |
37
- | 参照仕様 | 判断を定める BR、イベントを定める BES、状態を定める STSD、項目の意味を定めるデータ仕様の ID |
38
- | 主要例外 | 正常な成果または後続起動を妨げる事象、停止範囲、処置、再開条件、代替成果 |
39
- | 受入根拠 | 正常・条件付き・例外の各経路で結果を確認できる記録 |
40
- | 未決事項 | 調査不足、意思決定待ち、仮置き前提と、その影響・決定者・決定時期 |
22
+ | 項目 | 集める情報 | 取り出し元 |
23
+ | ------------ | ------------------------------------------------------------ | ------------------------------ |
24
+ | 領域と流れ | プロセス領域、個別プロセス ID、主要入出力、データストア名 | CDFD |
25
+ | 前後の境界 | 前後のプロセスと、領域をまたぐ順序・引き渡し | ユースケース別 CDFD |
26
+ | 起点と判断 | 始まる出来事、開始前に確かめること、判断する人、迷うケース | 業務担当者への聞き取り |
27
+ | 参照する定義 | 判断に使うルール、発行・受領するイベント、状態、データの意味 | BR、BES、STSD、データ仕様 |
28
+ | 成果と受け手 | 確定する記録・通知と、それを使う人・後続処理 | 業務担当者、後続プロセスの担当 |
29
+ | 止まる場面 | 成果を確定できない・後続へ渡せない場面と、その後の扱い | 業務担当者への聞き取り |
41
30
 
42
31
  ## 3. 全体の作成手順
43
32
 
44
- 1. CDFD から一つのプロセス領域を選び、領域 ID、名称、個別プロセス、主要入出力、データストアを控えます。
45
- 2. 起点と業務成果の組を列挙し、独立して変更・承認される組が複数あれば文書を分けます。
46
- 3. 選んだ流れについて、業務目的、対象者、主担当、開始点、終了点、対象外を定めます。
47
- 4. 開始を観測できる出来事をトリガーとして記載し、発生元、受領情報、開始条件、不成立時の扱いを対応させます。
48
- 5. 開始前に確認する前提条件を yes / no で書き、不成立時に非起動、差戻し、例外のどれに進むかを決めます。
49
- 6. 流れで使用する入力を業務上の論理名で整理し、入手元、利用目的、必須性、正本を特定します。
50
- 7. 正常な順序に沿って処理ステップを並べ、各行に CDFD プロセス、担当、入力、活動または判断、出力、完了条件を記載します。
51
- 8. 判断式、イベント契約、状態定義、データ項目定義を参照先へ移し、この流れでの利用目的と結果だけを残します。
52
- 9. 分岐ごとに合流先または終了先を確認し、正常終了と条件付き終了の業務成果を受け手、確定条件、正本、後続処理とともに整理します。
53
- 10. 業務成果または後続起動を変える主要例外を選び、検出条件、停止範囲、担当、処置、再開条件または代替成果を記載します。
54
- 11. 正常系、条件付き処理、主要例外ごとに、入力条件、期待する業務成果、確認可能な記録を対応させます。
55
- 12. トリガー ID、ステップ ID、例外 ID、プロセス ID、参照仕様 ID を照合し、開始から終了までの欠落、名称ゆれ、責任の空白を解消します。
33
+ 1. CDFD から起点と業務成果の組を挙げ、独立して変わる組が複数あれば文書を分ける。分けると決めた時点で、業務成果を表す名前を付ける。後で分けると ID と参照を付け替えることになる。
34
+ 2. 出力(業務成果)を先に書く。終わりが決まらないと、処理の範囲と例外の線引きが決まらない。
35
+ 3. トリガーと前提条件を書き、不成立のときの行き先を決める。
36
+ 4. 処理を正常な順に並べ、各ステップに入力・出力・完了条件を付ける。入力の表は処理が使うものから作る。
37
+ 5. 例外・代替経路を書く。処理を並べた後でないと、検出するステップと再開位置が決まらない。
38
+ 6. 検証・受入観点を、出力と例外の各経路から作る。
39
+ 7. 最後に導入文と概要を書く。成果と境界が決まってから書くと、本文の言い直しにならない。
56
40
 
57
41
  ## 4. 各章の書き方
58
42
 
@@ -60,154 +44,119 @@ Business Process Specification Writing Recipe
60
44
 
61
45
  問い:
62
46
 
63
- - 何が起きたら始まり、誰または何を対象にし、何が確定したら終わりますか。
64
- - この流れが必要な理由と、扱わない場合に損なわれる業務価値は何ですか。
65
- - 対象は CDFD の一つのプロセス領域に収まっていますか。
66
- - 主担当、実施者、成果を利用する役割を区別できますか。
67
- - 前後のプロセス、横断順序、実装方式のどこから先を対象外にしますか。
68
-
69
- 導入文は起点、対象、業務成果を一文で結びます。概要では目的と境界を固定し、「在庫管理を行う」のように複数の起点と成果を含む広い表現を避けます。
47
+ - 何が起きたら始まり、何が確定したら終わるか。
48
+ - 前後のどのプロセスから先を扱わないか。
70
49
 
71
- ### 4.2. トリガー
72
-
73
- 問い:
50
+ コツ:
74
51
 
75
- - 出来事の発生時点を、記録または人の確認から特定できますか。
76
- - 発生元と受領情報から、開始対象を一意に特定できますか。
77
- - 開始条件を yes / no で判定できますか。
78
- - 条件不成立は正常な非起動、差戻し、主要例外のどれですか。
79
- - 複数トリガーは同じ業務成果へ収束しますか。
52
+ - 「在庫管理を行う」のように書けてしまうなら、起点と成果が複数混ざっている。
53
+ - 業務目的は CDFD を正本とし、写さず参照に置き換える。
80
54
 
81
- 「在庫が少ないとき」のような状態だけでなく、「在庫確認で現在庫が補充基準を下回ったと判定された」のように観測できる出来事として書きます。成果が異なるトリガーは同じ表へ追加せず、流れを分けます。
82
-
83
- ### 4.3. 前提条件
55
+ ### 4.2. トリガーと前提条件
84
56
 
85
57
  問い:
86
58
 
87
- - トリガー発生後、処理を始める前に確認すべき販売状態、権限、正本、重複の有無は何ですか。
88
- - 条件の真偽を確認する情報源はありますか。
89
- - 不成立時に処理を開始しないのか、差し戻すのか、例外へ進むのかが明確ですか。
90
- - 前提条件と最初の処理ステップで同じ判断を二重に定義していませんか。
59
+ - 始まった時点を、どの記録または誰の確認から特定できるか。
60
+ - 始める前に何を確かめ、成り立たないときは起動しない・差し戻す・例外のどれにするか。
61
+
62
+ コツ:
91
63
 
92
- 条件と不成立時の扱いを一組で記述します。処理中に初めて判明する事象は、前提条件ではなく該当ステップと主要例外へ置きます。
64
+ - 業務担当者に「始めたつもりで、実は始めなかった場面」を聞くと、正常な非起動と例外が分かれる。
65
+ - 処理の途中で初めて分かる事象は前提条件に入れやすい。該当ステップと例外へ回す。
93
66
 
94
- ### 4.4. 入力
67
+ ### 4.3. 入力と処理
95
68
 
96
69
  問い:
97
70
 
98
- - 各入力はどのステップの判断または活動に使われますか。
99
- - 入手元と正本を区別でき、同じ論理名を CDFD と関連仕様で使っていますか。
100
- - 必須入力が欠けた場合の非起動または例外を特定できますか。
101
- - 物理テーブル、画面項目、API 項目ではなく業務上の情報として記述していますか。
71
+ - 各ステップの完了を、誰が何を見て判断するか。
72
+ - 分岐した後、どこへ合流し、どこで終わるか。
73
+
74
+ コツ:
102
75
 
103
- 参照仕様の定義を写さず、BPS ではその入力をいつ、何のために利用するかを示します。条件付き入力には利用条件と欠落時の扱いを添えます。
76
+ - 担当が 2 人出てきたら、承認や引き渡しでステップを分ける。
77
+ - 画面やシステムの操作を話されたら「それで何が決まるか」を聞き、業務の判断へ戻す。
78
+ - ルールの式やデータの意味を書き始めたら、参照仕様の ID と、この流れで使う結果だけに戻す。
104
79
 
105
- ### 4.5. 処理
80
+ ### 4.4. 出力
106
81
 
107
82
  問い:
108
83
 
109
- - 各ステップは一人または一つの責任主体が完了を判断できる単位ですか。
110
- - CDFD のどの個別プロセスを具体化しているかを示せますか。
111
- - 入力から活動または判断を経て、次へ渡す出力と完了条件へつながりますか。
112
- - 分岐条件と、分岐後の合流先または終了先をたどれますか。
113
- - BR を参照する判断では、ルール ID と判断結果だけを残していますか。
84
+ - 正常終了と条件付き終了で、それぞれ何が確定するか。
85
+ - 誰が受け取り、次にどの処理が始まるか。
114
86
 
115
- 画面操作やシステム内部の呼び出し順ではなく、業務上の活動と判断を書きます。複数主体の承認や引き渡しは別ステップとし、完了条件は記録や成果から yes / no で判定できる文にします。
87
+ コツ:
116
88
 
117
- ### 4.6. 出力
89
+ - 「処理完了」と書きたくなったら、何の記録が残るかを聞く。
90
+ - 後続処理がない成果は「なし」と書く。空けると暗黙の連鎖に読まれる。
91
+
92
+ ### 4.5. 例外・代替経路
118
93
 
119
94
  問い:
120
95
 
121
- - 正常終了と条件付き終了で確定する業務成果をすべて挙げていますか。
122
- - 受け手は誰で、何がそろえば確定と判断できますか。
123
- - 成果の正本と、起動する後続処理を特定できますか。
124
- - 状態変化またはイベント発行を参照仕様へ接続し、定義を複製していませんか。
96
+ - 業務成果または後続処理を変える事象は何か。
97
+ - 何を確定させずに止め、何がそろえばどこから再開するか。
98
+
99
+ コツ:
125
100
 
126
- 「処理完了」ではなく、確定する記録、状態変化、通知、判断結果、または引き渡しを名詞で示します。後続処理がない場合も「なし」と明記し、暗黙の連鎖を残しません。
101
+ - 業務担当者に「確定できずに困った場面」を聞く。内部エラーやログの一覧から作らない。
102
+ - 例外が見つからないこともある。その場合は、正常系・条件付き処理・入力不足・出力確定失敗を確かめた範囲と、成果を変える例外がないという結論を書く。例外を作り出さない。
127
103
 
128
- ### 4.7. 例外・代替経路
104
+ ### 4.6. 検証・受入観点
129
105
 
130
106
  問い:
131
107
 
132
- - その事象は正常な非起動ではなく、業務成果または後続処理を変えますか。
133
- - どのステップで、どの条件から検出できますか。
134
- - 何を確定または起動してはならないかを停止範囲として示せますか。
135
- - 誰が何を処置し、どの事実がそろえばどこから再開できますか。
136
- - 再開しない場合に確定する代替成果を示せますか。
108
+ - 正常系と条件付き処理、主要例外がある場合はその経路で、何を入れたら何が確定するか。
109
+ - その結果を、どの記録で確かめられるか。
137
110
 
138
- 内部エラーやログを網羅せず、業務判断を要する主要例外へ絞ります。例外がない場合は、確認した正常系、条件付き処理、入力不足、出力確定失敗の範囲と、業務成果を変える例外がないという結論を記述します。
111
+ コツ:
139
112
 
140
- ### 4.8. 検証・受入観点
113
+ - 出力の各成果と例外の各行から 1 行ずつ作ると、確かめ漏れが出にくい。
114
+ - 主要例外がない BPS では、例外の経路の代わりに、例外がないと結論した範囲を確かめる行を置く。
141
115
 
142
- 問い:
116
+ ### 4.7. 未決事項
143
117
 
144
- - 正常系、条件付き処理、主要例外を少なくとも一つずつ確認できますか。
145
- - 入力条件と期待する業務成果の組から、結果を一意に判定できますか。
146
- - 確認可能な記録は、出力の正本または例外時の保留・差戻し記録と一致しますか。
147
- - 後続のテスト担当者が、画面や実装方式を仮定せず受入シナリオを設計できますか。
118
+ 問い:
148
119
 
149
- 「正しく処理される」ではなく、件数、確定項目、非作成、保留内容など観測できる結果を書きます。テスト手順や操作列ではなく、受け入れられる業務成果を定義します。
120
+ - 決まらないと、どのステップの開始や成果の確定が止まるか。
121
+ - 決まるまで、どう扱うか。
150
122
 
151
- ### 4.9. 未決事項(任意)
123
+ コツ:
152
124
 
153
- - 調査で確定できる不足情報は _TODO_:、意思決定待ちは _UNDECIDED_:、仮置き前提は _ASSUMPTION_: とします。
154
- - 論点ごとに影響する章またはステップ、区分、決定者、決定時期を記載します。
155
- - 未決事項がない場合は章を省略し、空表や「なし」だけの章を残しません。
125
+ - 本文に未確定の目印を置いた箇所から論点を拾うと、漏れが出にくい。
156
126
 
157
127
  ## 5. 深掘り手順
158
128
 
159
- 1. 終了点の業務成果から逆向きにたどり、その成果を確定する最後のステップ、必要な判断、入力を確認します。
160
- 2. トリガーから順方向にたどり、各ステップの出力が次のステップの入力になるかを確認します。
161
- 3. 各ステップで担当を外した場合に完了判断が曖昧にならないかを確認し、責任主体が複数ならステップを分けます。
162
- 4. 分岐条件を一つずつ反転し、合流、正常終了、例外、非起動のいずれにも到達しない経路を探します。
163
- 5. BR、BES、STSD、データ仕様と同じ定義文を探し、参照 ID と利用目的へ置き換えます。
164
- 6. 主要例外ごとに、検出前に確定した記録、停止する後続、再開位置、代替成果を順に確認します。
165
- 7. 正常系、条件付き処理、主要例外の各経路について、入力条件から確認可能な記録までを一行で説明できるか確認します。
166
- 8. CDFD のプロセス ID、入出力、データストア名と照合し、BPS だけで追加・削除・改名した要素を解消します。
129
+ 内容が浅いときは、次の順で対応のない主張を探す。
130
+
131
+ 1. 業務成果から逆向きに、その成果を確定するステップ・判断・入力をたどり、どの成果にも効かないステップを外す。
132
+ 2. トリガーから順に、各ステップの出力が次の入力になるかをたどり、途切れる箇所を探す。
133
+ 3. 分岐条件を一つずつ反転し、合流・終了・例外・非起動のどこにも届かない経路を探す。
134
+ 4. CDFD のプロセス ID・入出力・データストア名と照らし、BPS だけで足した・消した・名前を変えた要素を探す。
167
135
 
168
136
  ## 6. 良い例 / 悪い例
169
137
 
170
- | 観点 | 良い例 | 悪い例 |
171
- | ---------- | -------------------------------------------------------------------- | ------------------------------------ |
172
- | 文書境界 | 在庫基準割れの検出から補充依頼の確定までを扱う | 在庫管理と仕入と販売をすべて扱う |
173
- | トリガー | 現在庫が補充基準を下回ったと在庫確認で判定された | 補充が必要になった |
174
- | 前提条件 | 商品が販売中でない場合は補充不要として記録し、処理を開始しない | 商品を確認して問題がなければ開始する |
175
- | 入力 | 現在庫を在庫記録から取得し、補充要否の判断に使う | 在庫テーブルの数量列を読む |
176
- | 処理 | 店主代表が判断根拠を確認し、商品と数量を持つ補充依頼を承認する | 登録ボタンを押して API を呼ぶ |
177
- | 完了条件 | 商品、数量、判断根拠、承認者、承認時刻を持つ補充依頼が確定している | 問題なく完了している |
178
- | 主要例外 | 補充基準を取得できない場合は依頼を確定せず、補完後に判定から再開する | エラー時は適切に再試行する |
179
- | 受入観点 | 未完了依頼がある場合は新規依頼を作らず、重複確認記録を確認できる | 重複が正しく処理される |
180
- | 参照の境界 | `br-reorder-point` の判定結果を使い、計算式は参照先を正本とする | 発注点の計算式を本文へ再掲する |
138
+ | 観点 | 良い例 | 悪い例 |
139
+ | -------- | -------------------------------------------------------------------- | ------------------------------------ |
140
+ | 文書境界 | 在庫基準割れの検出から補充依頼の確定までを扱う | 在庫管理と仕入と販売をすべて扱う |
141
+ | トリガー | 現在庫が補充基準を下回ったと在庫確認で判定された | 補充が必要になった |
142
+ | 前提条件 | 商品が販売中でない場合は補充不要として記録し、処理を開始しない | 商品を確認して問題がなければ開始する |
143
+ | 処理 | 店主代表が判断根拠を確認し、商品と数量を持つ補充依頼を承認する | 登録ボタンを押して API を呼ぶ |
144
+ | 主要例外 | 補充基準を取得できない場合は依頼を確定せず、補完後に判定から再開する | エラー時は適切に再試行する |
145
+ | 受入観点 | 未完了依頼がある場合は新規依頼を作らず、重複確認記録を確認できる | 重複が正しく処理される |
181
146
 
182
147
  ## 7. レビュー観点
183
148
 
184
- | 観点 | 確認内容 | 主な確認者 |
185
- | ---------- | ---------------------------------------------------------------------------------------- | -------------------------- |
186
- | 業務目的 | 起点から業務成果までが一つの価値と責任境界を持ち、対象外を説明できる | 店主代表、業務分析担当 |
187
- | CDFD 整合 | プロセス領域、プロセス ID、主要入出力、データストア名が CDFD と矛盾しない | 業務分析担当 |
188
- | 開始条件 | トリガーと前提条件を記録から yes / no で判定でき、不成立時の扱いが明確である | 店主代表、品質確認担当 |
189
- | 責任と完了 | 各ステップに一つの責任主体、入力、活動または判断、出力、判定可能な完了条件がある | 業務分析担当 |
190
- | 正本の分離 | 判断、イベント、状態、データ定義を複製せず、参照 ID とこの流れでの利用目的からたどれる | アーキテクト、業務分析担当 |
191
- | 例外 | 主要例外の検出条件、停止範囲、担当、処置、再開条件または代替成果を説明できる | 品質確認担当、店主代表 |
192
- | 検証可能性 | 正常・条件付き・例外の入力条件、期待成果、確認記録から受入可否を第三者が判定できる | 品質確認担当 |
193
- | 実装非依存 | 画面操作、物理データ構造、詳細 API、クラス、内部エラーを業務プロセスとして記述していない | アーキテクト |
194
-
195
- 「業務分析担当」「品質確認担当」「アーキテクト」は、対象プロジェクトのロール定義または責任分担文書で正式な担当へ対応付けます。
149
+ | 観点 | 確認内容 |
150
+ | ------------ | ------------------------------------------------------------------------ |
151
+ | 業務目的 | 起点から業務成果までが一つの価値に対応し、扱わない範囲を説明できるか |
152
+ | 開始の判定 | 業務担当者が、記録を見て始めるかどうかを判定できるか |
153
+ | 責任と完了 | 各ステップで、誰が何を見て完了と判断するかが分かるか |
154
+ | 例外の線引き | 業務判断を要する事象だけを扱い、例外がない場合はその結論の範囲が分かるか |
155
+ | 受入の判定 | テスト担当者が、画面や実装を仮定せずに受入シナリオを作れるか |
196
156
 
197
157
  ## 8. 仕上げチェック
198
158
 
199
- - 一文書が一つのプロセス領域に属し、共通の起点と一つの業務成果を持つ流れだけを扱っている。
200
- - 導入文から起点、対象、業務成果を一文で説明できる。
201
- - 業務目的、対象者、主担当、開始点、終了点、対象外があり、前後のプロセスと横断順序の境界を説明できる。
202
- - 各トリガーに発生元、受領情報、開始条件、不成立時の扱いがある。
203
- - 前提条件が yes / no で判定でき、不成立時の非起動、差戻し、例外を特定できる。
204
- - 各入力に入手元、利用目的、必須性、正本があり、欠落時の扱いをたどれる。
205
- - 全処理ステップに CDFD プロセス、担当、入力、活動または判断、出力、完了条件、例外の対応がある。
206
- - 分岐から合流先または終了先をたどれ、正常終了と条件付き終了の業務成果が出力にある。
207
- - BR、BES、STSD、データ仕様を正本として参照し、その定義を複製していない。
208
- - 主要例外に検出条件、停止範囲、担当、処置、再開条件または代替成果がある。
209
- - 正常系、条件付き処理、主要例外の受入観点に、入力条件、期待する業務成果、確認可能な記録がある。
210
- - CDFD とプロセス ID、主要入出力、データストア名が一致し、BPS だけの追加・削除・改名がない。
211
- - 画面操作、SQL、物理カラム、詳細 API、クラス、ログ文言を業務仕様へ持ち込んでいない。
212
- - _TODO_ が残っていない。未決事項がある場合は区分、影響、決定者、決定時期がある。
213
- - 個人情報、秘密情報、非公開の組織情報など、公開範囲に不適切な内容を含めていない。
159
+ - 導入文の起点・業務成果と、トリガー・出力の内容が一致している。
160
+ - トリガーから業務成果または代替成果まで、どの分岐でも途切れない。
161
+ - 出力の各成果と、主要例外がある場合は各例外が、受入観点のいずれかの行で確かめられる。主要例外がない場合は、確かめた範囲と結論がある。
162
+ - 個人情報、秘密情報、非公開の組織情報を含めていない。