specdojo 0.7.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 (462) hide show
  1. package/.github/agents/specdojo-orchestrator.md +7 -3
  2. package/CHANGELOG.md +217 -0
  3. package/dist/catalog/build.js +24 -1
  4. package/dist/catalog/catalog.js +16 -14
  5. package/dist/catalog/plan.js +1 -1
  6. package/dist/catalog/scaffold.js +4 -1
  7. package/dist/commands/agent.js +5 -3
  8. package/dist/commands/build.js +69 -10
  9. package/dist/commands/git.js +206 -0
  10. package/dist/commands/init.js +9 -3
  11. package/dist/commands/night-orchestrator.js +6 -4
  12. package/dist/commands/where.js +25 -0
  13. package/dist/dashboard/dashboard-timeline.js +18 -16
  14. package/dist/dashboard/dashboard.js +616 -261
  15. package/dist/dashboard/epic-plan.js +81 -0
  16. package/dist/dashboard/exec-records.js +16 -20
  17. package/dist/dashboard/routines.js +11 -12
  18. package/dist/dashboard/timeline-build.js +5 -9
  19. package/dist/dashboard/timeline.js +23 -18
  20. package/dist/devcontainer/scaffold.js +18 -0
  21. package/dist/docs/frontmatter-namespace.js +1 -48
  22. package/dist/docs/index-command.js +2 -2
  23. package/dist/docs/yaml-business-tables.js +243 -0
  24. package/dist/docs/yaml-interface-tables.js +106 -0
  25. package/dist/docs/yaml-pages-command.js +5 -3
  26. package/dist/docs/yaml-pages.js +268 -3
  27. package/dist/docs/yaml-table-shared.js +70 -0
  28. package/dist/docs/yaml-tables.js +39 -0
  29. package/dist/exec/agent-config.js +31 -0
  30. package/dist/exec/agent-plan.js +3 -2
  31. package/dist/exec/agent-protected-config.js +2 -0
  32. package/dist/exec/commands.js +100 -39
  33. package/dist/exec/commit-hook-skips.js +78 -0
  34. package/dist/exec/core.js +19 -7
  35. package/dist/exec/events.js +179 -8
  36. package/dist/exec/evidence.js +77 -19
  37. package/dist/exec/handoff.js +9 -13
  38. package/dist/exec/limit.js +1 -1
  39. package/dist/exec/mechanical-result.js +45 -0
  40. package/dist/exec/migrate-records.js +249 -0
  41. package/dist/exec/parent-validation.js +209 -15
  42. package/dist/exec/pipeline-state.js +27 -5
  43. package/dist/exec/plans-condense-findings.js +89 -0
  44. package/dist/exec/plans-core.js +45 -19
  45. package/dist/exec/plans-generation.js +52 -30
  46. package/dist/exec/plans-grade-findings.js +8 -3
  47. package/dist/exec/plans-kata-findings.js +61 -0
  48. package/dist/exec/plans-planning.js +3 -3
  49. package/dist/exec/plans-storage.js +12 -24
  50. package/dist/exec/post-integration.js +162 -0
  51. package/dist/exec/queue-command.js +166 -0
  52. package/dist/exec/queue.js +285 -0
  53. package/dist/exec/register-foreign-wait.js +84 -0
  54. package/dist/exec/register-resume.js +55 -56
  55. package/dist/exec/register.js +26 -22
  56. package/dist/exec/repo-integration-sync.js +21 -5
  57. package/dist/exec/repo-integration.js +21 -1
  58. package/dist/exec/reporter.js +121 -23
  59. package/dist/exec/results.js +106 -25
  60. package/dist/exec/review-completion.js +47 -0
  61. package/dist/exec/review-kata.js +112 -0
  62. package/dist/exec/run/agent-pipeline.js +78 -8
  63. package/dist/exec/run/agent.js +32 -13
  64. package/dist/exec/run/change-scope.js +365 -0
  65. package/dist/exec/run/deferred-cleanup.js +31 -0
  66. package/dist/exec/run/in-place.js +73 -33
  67. package/dist/exec/run/job-lock.js +66 -0
  68. package/dist/exec/run/job-sequence.js +137 -0
  69. package/dist/exec/run/job.js +135 -41
  70. package/dist/exec/run/lifecycle-commands.js +189 -37
  71. package/dist/exec/run/lock.js +22 -1
  72. package/dist/exec/run/mode-shared.js +11 -3
  73. package/dist/exec/run/register-command.js +14 -15
  74. package/dist/exec/run/register-core.js +20 -13
  75. package/dist/exec/run/register-mode.js +77 -17
  76. package/dist/exec/run/register-post-review.js +21 -9
  77. package/dist/exec/run/register-resume.js +95 -31
  78. package/dist/exec/run/register-state.js +23 -15
  79. package/dist/exec/run/register-worktree.js +184 -139
  80. package/dist/exec/run/schedule-mode.js +79 -18
  81. package/dist/exec/run/schedule-prepare.js +204 -59
  82. package/dist/exec/run/schedule-task.js +203 -49
  83. package/dist/exec/run/shared.js +9 -3
  84. package/dist/exec/run/trailing-records.js +35 -0
  85. package/dist/exec/run-records.js +2 -0
  86. package/dist/exec/schedule/schedule.js +116 -4
  87. package/dist/exec/shared.js +1 -1
  88. package/dist/exec/smoke.js +190 -0
  89. package/dist/exec/strategy.js +14 -3
  90. package/dist/exec/task-view.js +6 -4
  91. package/dist/exec/trailing-records.js +242 -0
  92. package/dist/exec/trial-commands.js +8 -4
  93. package/dist/exec/trial-core.js +6 -1
  94. package/dist/exec/validate-records-commit.js +110 -0
  95. package/dist/exec/validate-records.js +148 -0
  96. package/dist/exec/validation-metrics.js +181 -0
  97. package/dist/exec/worktree-cleanup-lock.js +26 -0
  98. package/dist/exec/worktree-command.js +38 -17
  99. package/dist/exec/worktree-ops-commit.js +119 -48
  100. package/dist/exec/worktree-ops-lifecycle.js +77 -48
  101. package/dist/exec/worktree-ops-merge.js +13 -2
  102. package/dist/exec/worktree-ops.js +2 -2
  103. package/dist/exec/worktree.js +32 -4
  104. package/dist/grade/apply.js +32 -6
  105. package/dist/grade/command-apply.js +3 -3
  106. package/dist/grade/command-inspect.js +7 -5
  107. package/dist/grade/command-plan.js +1 -1
  108. package/dist/grade/command-run.js +7 -1
  109. package/dist/grade/command-shared.js +1 -1
  110. package/dist/grade/core.js +18 -5
  111. package/dist/grade/markdown.js +3 -3
  112. package/dist/grade/pipeline-state.js +15 -11
  113. package/dist/grade/plan.js +37 -17
  114. package/dist/grade/result.js +3 -3
  115. package/dist/grade/run.js +87 -11
  116. package/dist/grade/target-discovery.js +17 -4
  117. package/dist/grade/targets.js +12 -11
  118. package/dist/job/definition.js +84 -8
  119. package/dist/job/job.js +109 -39
  120. package/dist/job/noop.js +104 -0
  121. package/dist/register/authoring-sources.js +22 -16
  122. package/dist/register/core.js +2 -0
  123. package/dist/register/create-commands.js +28 -3
  124. package/dist/register/deliverable-target.js +9 -1
  125. package/dist/register/epic.js +104 -26
  126. package/dist/register/event-merge.js +3 -0
  127. package/dist/register/events.js +4 -0
  128. package/dist/register/external-project.js +3 -0
  129. package/dist/register/item.js +6 -0
  130. package/dist/register/maintenance-commands.js +6 -3
  131. package/dist/register/planning.js +7 -14
  132. package/dist/register/register.js +74 -16
  133. package/dist/register/track-domains.js +34 -0
  134. package/dist/register/track-plan.js +78 -0
  135. package/dist/register/transition-commands.js +8 -0
  136. package/dist/register/work-table.js +64 -0
  137. package/dist/review/grade.js +35 -13
  138. package/dist/routine/definition.js +13 -3
  139. package/dist/routine/failure.js +30 -0
  140. package/dist/routine/routine.js +189 -71
  141. package/dist/routine/status.js +62 -0
  142. package/dist/routine/storage.js +33 -0
  143. package/dist/schedule/schedule.js +39 -39
  144. package/dist/schedule/strategy-generate-document.js +26 -14
  145. package/dist/schedule/strategy-generate-scope.js +17 -45
  146. package/dist/schedule/strategy-generate.js +33 -3
  147. package/dist/schedule/strategy-profiles.js +86 -12
  148. package/dist/shared/agent-types.js +7 -0
  149. package/dist/shared/condense-records.js +25 -0
  150. package/dist/shared/cross-process-lock.js +9 -1
  151. package/dist/shared/deprecation.js +8 -0
  152. package/dist/shared/dist-freshness.js +8 -2
  153. package/dist/shared/document-metadata.js +20 -0
  154. package/dist/shared/finding-cause.js +20 -0
  155. package/dist/shared/frontmatter-namespace.js +48 -0
  156. package/dist/shared/git-environment.js +2 -1
  157. package/dist/shared/git.js +186 -16
  158. package/dist/shared/grade-result.js +17 -1
  159. package/dist/shared/lefthook-scaffold.js +3 -0
  160. package/dist/shared/local-config.js +244 -0
  161. package/dist/shared/local-state.js +20 -0
  162. package/dist/shared/markdownlint-config.js +8 -3
  163. package/dist/shared/plan-conventions.js +129 -0
  164. package/dist/shared/plan-templates.js +57 -41
  165. package/dist/shared/run-records.js +224 -0
  166. package/dist/shared/specdojo-config.js +73 -41
  167. package/dist/shared/specdojo-gitignore.js +1 -0
  168. package/dist/shared/text.js +74 -6
  169. package/dist/shared/timeline-index.js +2 -0
  170. package/dist/shared/where-alias.js +13 -0
  171. package/dist/specdojo.js +4 -0
  172. package/docs/ja/specdojo/defaults/pm-review-viewpoints.yaml +11 -2
  173. package/docs/ja/specdojo/exec-templates/xep-common-conventions-template.md +4 -74
  174. package/docs/ja/specdojo/exec-templates/xep-condense-template.md +50 -0
  175. package/docs/ja/specdojo/exec-templates/xep-draft-template.md +17 -5
  176. package/docs/ja/specdojo/exec-templates/xep-fully-guided-template.md +16 -3
  177. package/docs/ja/specdojo/exec-templates/xep-recipe-guided-template.md +15 -5
  178. package/docs/ja/specdojo/exec-templates/xep-recipe-maintenance-template.md +6 -0
  179. package/docs/ja/specdojo/exec-templates/xep-register-template.md +1 -1
  180. package/docs/ja/specdojo/exec-templates/xep-rulebook-maintenance-template.md +6 -0
  181. package/docs/ja/specdojo/exec-templates/xep-sample-maintenance-template.md +6 -0
  182. package/docs/ja/specdojo/exec-templates/xep-template-maintenance-template.md +6 -0
  183. package/docs/ja/specdojo/exec-templates/xer-condense-template.md +25 -0
  184. package/docs/ja/specdojo/exec-templates/xp-common-conventions-template.md +50 -0
  185. package/docs/ja/specdojo/exec-templates/xrp-common-conventions-template.md +30 -0
  186. package/docs/ja/specdojo/guides/branch-workflow-guide.md +1 -1
  187. package/docs/ja/specdojo/guides/docs-editing-guide.md +12 -0
  188. package/docs/ja/specdojo/guides/docs-structure-guide.md +48 -15
  189. package/docs/ja/specdojo/guides/exec-config-guide.md +69 -19
  190. package/docs/ja/specdojo/guides/exec-operation-guide.md +97 -18
  191. package/docs/ja/specdojo/guides/exec-worktree-guide.md +20 -11
  192. package/docs/ja/specdojo/guides/job-sequence-guide.md +77 -0
  193. package/docs/ja/specdojo/guides/plan-result-lifecycle-guide.md +92 -55
  194. package/docs/ja/specdojo/guides/project-move-guide.md +381 -0
  195. package/docs/ja/specdojo/guides/quick-start-guide.md +73 -17
  196. package/docs/ja/specdojo/guides/register-operation-guide.md +26 -6
  197. package/docs/ja/specdojo/guides/remote-host-development-guide.md +2 -0
  198. package/docs/ja/specdojo/guides/review-guide.md +22 -19
  199. package/docs/ja/specdojo/guides/routine-operation-guide.md +23 -12
  200. package/docs/ja/specdojo/guides/ryu-guide.md +23 -13
  201. package/docs/ja/specdojo/guides/schedule-design-guide.md +27 -21
  202. package/docs/ja/specdojo/guides/schedule-operation-guide.md +27 -3
  203. package/docs/ja/specdojo/guides/specdojo-overview-guide.md +5 -4
  204. package/docs/ja/specdojo/guides/timeline-design-guide.md +27 -144
  205. package/docs/ja/specdojo/guides/use-case-guide.md +92 -155
  206. package/docs/ja/specdojo/guides/waza-guide.md +12 -8
  207. package/docs/ja/specdojo/recipes/bac-recipe.md +111 -0
  208. package/docs/ja/specdojo/recipes/bes-recipe.md +141 -0
  209. package/docs/ja/specdojo/recipes/bps-recipe.md +88 -139
  210. package/docs/ja/specdojo/recipes/br-recipe.md +77 -0
  211. package/docs/ja/specdojo/recipes/cdfd-overview-recipe.md +97 -109
  212. package/docs/ja/specdojo/recipes/cdfd-recipe.md +85 -146
  213. package/docs/ja/specdojo/recipes/cdfd-uc-recipe.md +92 -99
  214. package/docs/ja/specdojo/recipes/cnd-recipe.md +135 -0
  215. package/docs/ja/specdojo/recipes/cpd-recipe.md +140 -0
  216. package/docs/ja/specdojo/recipes/cxd-recipe.md +162 -0
  217. package/docs/ja/specdojo/recipes/ifd-recipe.md +145 -0
  218. package/docs/ja/specdojo/recipes/ifx-cmd-recipe.md +112 -90
  219. package/docs/ja/specdojo/recipes/ifx-index-recipe.md +164 -0
  220. package/docs/ja/specdojo/recipes/pm-communication-plan-recipe.md +60 -49
  221. package/docs/ja/specdojo/recipes/pm-members-recipe.md +50 -51
  222. package/docs/ja/specdojo/recipes/pm-organization-recipe.md +59 -48
  223. package/docs/ja/specdojo/recipes/pm-plan-recipe.md +72 -50
  224. package/docs/ja/specdojo/recipes/pm-quality-management-plan-recipe.md +40 -49
  225. package/docs/ja/specdojo/recipes/pm-raci-recipe.md +42 -48
  226. package/docs/ja/specdojo/recipes/pm-roles-recipe.md +52 -81
  227. package/docs/ja/specdojo/recipes/prj-assumptions-constraints-dependencies-recipe.md +64 -91
  228. package/docs/ja/specdojo/recipes/prj-charter-recipe.md +71 -106
  229. package/docs/ja/specdojo/recipes/prj-comparison-of-alternatives-recipe.md +78 -156
  230. package/docs/ja/specdojo/recipes/prj-issues-and-approach-recipe.md +62 -111
  231. package/docs/ja/specdojo/recipes/prj-scope-recipe.md +67 -123
  232. package/docs/ja/specdojo/recipes/prj-stakeholder-register-recipe.md +60 -96
  233. package/docs/ja/specdojo/recipes/prj-success-criteria-and-acceptance-criteria-recipe.md +61 -105
  234. package/docs/ja/specdojo/recipes/stsd-recipe.md +88 -80
  235. package/docs/ja/specdojo/recipes/sysd-critical-flows-recipe.md +129 -0
  236. package/docs/ja/specdojo/recipes/sysd-cross-cutting-policy-recipe.md +146 -0
  237. package/docs/ja/specdojo/recipes/sysd-index-recipe.md +141 -0
  238. package/docs/ja/specdojo/recipes/tsd-recipe.md +149 -129
  239. package/docs/ja/specdojo/references/command-reference.md +303 -148
  240. package/docs/ja/specdojo/references/deliverables-reference.md +30 -16
  241. package/docs/ja/specdojo/references/directory-layout-reference.md +3 -2
  242. package/docs/ja/specdojo/references/specdojo-config-reference.md +54 -18
  243. package/docs/ja/specdojo/rulebooks/atc-index-rulebook.md +101 -257
  244. package/docs/ja/specdojo/rulebooks/atc-rulebook.md +102 -228
  245. package/docs/ja/specdojo/rulebooks/bac-rulebook.md +63 -290
  246. package/docs/ja/specdojo/rulebooks/bdd-rulebook.md +162 -80
  247. package/docs/ja/specdojo/rulebooks/bds-rulebook.md +118 -155
  248. package/docs/ja/specdojo/rulebooks/bes-index-rulebook.md +128 -60
  249. package/docs/ja/specdojo/rulebooks/bes-rulebook.md +70 -94
  250. package/docs/ja/specdojo/rulebooks/bps-rulebook.md +24 -56
  251. package/docs/ja/specdojo/rulebooks/br-rulebook.md +58 -103
  252. package/docs/ja/specdojo/rulebooks/ccd-mermaid-rulebook.md +103 -223
  253. package/docs/ja/specdojo/rulebooks/cdfd-d2-rulebook.md +18 -93
  254. package/docs/ja/specdojo/rulebooks/cdfd-mermaid-rulebook.md +18 -52
  255. package/docs/ja/specdojo/rulebooks/cdfd-overview-rulebook.md +109 -147
  256. package/docs/ja/specdojo/rulebooks/cdfd-rulebook.md +80 -108
  257. package/docs/ja/specdojo/rulebooks/cdfd-uc-rulebook.md +51 -55
  258. package/docs/ja/specdojo/rulebooks/cdr-rulebook.md +144 -0
  259. package/docs/ja/specdojo/rulebooks/cdsd-rulebook.md +81 -68
  260. package/docs/ja/specdojo/rulebooks/cdt-rulebook.md +139 -0
  261. package/docs/ja/specdojo/rulebooks/cld-rulebook.md +9 -184
  262. package/docs/ja/specdojo/rulebooks/clis-rulebook.md +170 -0
  263. package/docs/ja/specdojo/rulebooks/cnd-mermaid-rulebook.md +33 -86
  264. package/docs/ja/specdojo/rulebooks/cnd-rulebook.md +79 -249
  265. package/docs/ja/specdojo/rulebooks/cop-index-rulebook.md +45 -131
  266. package/docs/ja/specdojo/rulebooks/cop-rulebook.md +69 -275
  267. package/docs/ja/specdojo/rulebooks/cpd-mermaid-rulebook.md +20 -112
  268. package/docs/ja/specdojo/rulebooks/cpd-rulebook.md +79 -249
  269. package/docs/ja/specdojo/rulebooks/cxd-mermaid-rulebook.md +12 -145
  270. package/docs/ja/specdojo/rulebooks/cxd-rulebook.md +115 -256
  271. package/docs/ja/specdojo/rulebooks/dct-index-rulebook.md +79 -109
  272. package/docs/ja/specdojo/rulebooks/dct-rulebook.md +119 -174
  273. package/docs/ja/specdojo/rulebooks/dec-rulebook.md +6 -14
  274. package/docs/ja/specdojo/rulebooks/dmd-index-rulebook.md +22 -66
  275. package/docs/ja/specdojo/rulebooks/dmd-rulebook.md +36 -94
  276. package/docs/ja/specdojo/rulebooks/dss-rulebook.md +171 -0
  277. package/docs/ja/specdojo/rulebooks/etc-index-rulebook.md +31 -131
  278. package/docs/ja/specdojo/rulebooks/etc-rulebook.md +50 -104
  279. package/docs/ja/specdojo/rulebooks/gl-rulebook.md +93 -57
  280. package/docs/ja/specdojo/rulebooks/ifd-mermaid-rulebook.md +63 -253
  281. package/docs/ja/specdojo/rulebooks/ifx-api-rulebook.md +14 -20
  282. package/docs/ja/specdojo/rulebooks/ifx-cmd-rulebook.md +79 -76
  283. package/docs/ja/specdojo/rulebooks/ifx-file-rulebook.md +182 -237
  284. package/docs/ja/specdojo/rulebooks/ifx-index-rulebook.md +111 -40
  285. package/docs/ja/specdojo/rulebooks/ifx-msg-rulebook.md +14 -22
  286. package/docs/ja/specdojo/rulebooks/imp-business-rulebook.md +23 -46
  287. package/docs/ja/specdojo/rulebooks/imp-data-rulebook.md +41 -64
  288. package/docs/ja/specdojo/rulebooks/imp-interface-rulebook.md +16 -40
  289. package/docs/ja/specdojo/rulebooks/imp-operations-rulebook.md +34 -61
  290. package/docs/ja/specdojo/rulebooks/imp-test-rulebook.md +27 -50
  291. package/docs/ja/specdojo/rulebooks/itc-index-rulebook.md +70 -199
  292. package/docs/ja/specdojo/rulebooks/itc-rulebook.md +65 -153
  293. package/docs/ja/specdojo/rulebooks/mip-index-rulebook.md +74 -150
  294. package/docs/ja/specdojo/rulebooks/mm-rulebook.md +12 -23
  295. package/docs/ja/specdojo/rulebooks/mtp-rulebook.md +99 -176
  296. package/docs/ja/specdojo/rulebooks/nfr-availability-rulebook.md +35 -61
  297. package/docs/ja/specdojo/rulebooks/nfr-index-rulebook.md +75 -117
  298. package/docs/ja/specdojo/rulebooks/nfr-integrity-rulebook.md +31 -60
  299. package/docs/ja/specdojo/rulebooks/nfr-maintainability-rulebook.md +26 -81
  300. package/docs/ja/specdojo/rulebooks/nfr-operations-rulebook.md +32 -70
  301. package/docs/ja/specdojo/rulebooks/nfr-performance-rulebook.md +45 -87
  302. package/docs/ja/specdojo/rulebooks/nfr-reliability-rulebook.md +48 -101
  303. package/docs/ja/specdojo/rulebooks/nfr-security-safety-rulebook.md +44 -80
  304. package/docs/ja/specdojo/rulebooks/nfr-usability-rulebook.md +59 -127
  305. package/docs/ja/specdojo/rulebooks/opd-index-rulebook.md +31 -50
  306. package/docs/ja/specdojo/rulebooks/opd-rulebook.md +42 -109
  307. package/docs/ja/specdojo/rulebooks/opr-index-rulebook.md +29 -42
  308. package/docs/ja/specdojo/rulebooks/opr-rulebook.md +29 -87
  309. package/docs/ja/specdojo/rulebooks/otp-index-rulebook.md +62 -84
  310. package/docs/ja/specdojo/rulebooks/otp-rulebook.md +11 -61
  311. package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +92 -102
  312. package/docs/ja/specdojo/rulebooks/pm-change-request-log-rulebook.md +25 -34
  313. package/docs/ja/specdojo/rulebooks/pm-communication-plan-rulebook.md +30 -53
  314. package/docs/ja/specdojo/rulebooks/pm-issue-log-rulebook.md +23 -35
  315. package/docs/ja/specdojo/rulebooks/pm-members-rulebook.md +27 -45
  316. package/docs/ja/specdojo/rulebooks/pm-organization-rulebook.md +45 -59
  317. package/docs/ja/specdojo/rulebooks/pm-plan-rulebook.md +56 -66
  318. package/docs/ja/specdojo/rulebooks/pm-quality-management-plan-rulebook.md +54 -62
  319. package/docs/ja/specdojo/rulebooks/pm-raci-rulebook.md +46 -65
  320. package/docs/ja/specdojo/rulebooks/pm-risk-register-rulebook.md +28 -35
  321. package/docs/ja/specdojo/rulebooks/pm-roles-rulebook.md +65 -97
  322. package/docs/ja/specdojo/rulebooks/pr-rulebook.md +6 -18
  323. package/docs/ja/specdojo/rulebooks/prj-assumptions-constraints-dependencies-rulebook.md +48 -78
  324. package/docs/ja/specdojo/rulebooks/prj-charter-rulebook.md +23 -97
  325. package/docs/ja/specdojo/rulebooks/prj-comparison-of-alternatives-rulebook.md +61 -153
  326. package/docs/ja/specdojo/rulebooks/prj-issues-and-approach-rulebook.md +43 -116
  327. package/docs/ja/specdojo/rulebooks/prj-scope-rulebook.md +16 -51
  328. package/docs/ja/specdojo/rulebooks/prj-stakeholder-register-rulebook.md +47 -92
  329. package/docs/ja/specdojo/rulebooks/prj-success-criteria-and-acceptance-criteria-rulebook.md +25 -84
  330. package/docs/ja/specdojo/rulebooks/sac-rulebook.md +44 -107
  331. package/docs/ja/specdojo/rulebooks/sf-index-rulebook.md +106 -32
  332. package/docs/ja/specdojo/rulebooks/sf-rulebook.md +111 -61
  333. package/docs/ja/specdojo/rulebooks/sld-rulebook.md +129 -59
  334. package/docs/ja/specdojo/rulebooks/stc-index-rulebook.md +90 -189
  335. package/docs/ja/specdojo/rulebooks/stc-rulebook.md +45 -105
  336. package/docs/ja/specdojo/rulebooks/stsd-mermaid-rulebook.md +46 -40
  337. package/docs/ja/specdojo/rulebooks/stsd-rulebook.md +104 -68
  338. package/docs/ja/specdojo/rulebooks/sysd-critical-flows-rulebook.md +64 -330
  339. package/docs/ja/specdojo/rulebooks/sysd-cross-cutting-policy-rulebook.md +70 -263
  340. package/docs/ja/specdojo/rulebooks/sysd-index-rulebook.md +58 -200
  341. package/docs/ja/specdojo/rulebooks/sysd-rulebook.md +47 -60
  342. package/docs/ja/specdojo/rulebooks/tml-rulebook.md +4 -9
  343. package/docs/ja/specdojo/rulebooks/trc-requirements-to-specs-rulebook.md +69 -71
  344. package/docs/ja/specdojo/rulebooks/trc-requirements-to-tests-rulebook.md +65 -72
  345. package/docs/ja/specdojo/rulebooks/tsd-index-rulebook.md +35 -46
  346. package/docs/ja/specdojo/rulebooks/tsd-rulebook.md +49 -66
  347. package/docs/ja/specdojo/rulebooks/tsp-index-rulebook.md +64 -139
  348. package/docs/ja/specdojo/rulebooks/uis-rulebook.md +91 -161
  349. package/docs/ja/specdojo/rulebooks/utc-index-rulebook.md +49 -144
  350. package/docs/ja/specdojo/rulebooks/utc-rulebook.md +67 -155
  351. package/docs/ja/specdojo/samples/bac-sample.md +106 -21
  352. package/docs/ja/specdojo/samples/bdd-sample.yaml +143 -35
  353. package/docs/ja/specdojo/samples/bds-sample.md +87 -21
  354. package/docs/ja/specdojo/samples/bes-index-sample.md +42 -20
  355. package/docs/ja/specdojo/samples/bes-sample.md +70 -21
  356. package/docs/ja/specdojo/samples/bps-sample.md +42 -54
  357. package/docs/ja/specdojo/samples/br-sample.md +57 -15
  358. package/docs/ja/specdojo/samples/ccd-sample.md +80 -19
  359. package/docs/ja/specdojo/samples/cdfd-sample.md +172 -99
  360. package/docs/ja/specdojo/samples/cdfd-uc-sample.md +9 -7
  361. package/docs/ja/specdojo/samples/cdr-sample.md +78 -0
  362. package/docs/ja/specdojo/samples/cdsd-sample.md +73 -20
  363. package/docs/ja/specdojo/samples/cdt-sample.md +116 -0
  364. package/docs/ja/specdojo/samples/cld-sample.md +3 -30
  365. package/docs/ja/specdojo/samples/clis-sample.md +125 -0
  366. package/docs/ja/specdojo/samples/cnd-sample.md +127 -21
  367. package/docs/ja/specdojo/samples/cpd-sample.md +136 -22
  368. package/docs/ja/specdojo/samples/cxd-sample.md +108 -22
  369. package/docs/ja/specdojo/samples/dct-index-sample.yaml +63 -17
  370. package/docs/ja/specdojo/samples/dec-sample.md +2 -3
  371. package/docs/ja/specdojo/samples/dss-sample.md +175 -0
  372. package/docs/ja/specdojo/samples/gl-sample.yaml +50 -14
  373. package/docs/ja/specdojo/samples/ifd-sample.md +105 -21
  374. package/docs/ja/specdojo/samples/ifx-api-sample.yaml +0 -2
  375. package/docs/ja/specdojo/samples/ifx-cmd-sample.yaml +91 -60
  376. package/docs/ja/specdojo/samples/ifx-file-sample.md +462 -21
  377. package/docs/ja/specdojo/samples/ifx-index-sample.yaml +87 -19
  378. package/docs/ja/specdojo/samples/ifx-msg-sample.yaml +0 -2
  379. package/docs/ja/specdojo/samples/job-sequence.yaml +67 -0
  380. package/docs/ja/specdojo/samples/mip-index-sample.md +98 -20
  381. package/docs/ja/specdojo/samples/pm-communication-plan-sample.md +26 -19
  382. package/docs/ja/specdojo/samples/pm-members-sample.yaml +37 -13
  383. package/docs/ja/specdojo/samples/pm-organization-sample.md +42 -21
  384. package/docs/ja/specdojo/samples/pm-plan-sample.md +78 -26
  385. package/docs/ja/specdojo/samples/pm-quality-management-plan-sample.md +41 -22
  386. package/docs/ja/specdojo/samples/pm-raci-sample.md +63 -28
  387. package/docs/ja/specdojo/samples/pm-roles-sample.yaml +13 -12
  388. package/docs/ja/specdojo/samples/prj-assumptions-constraints-dependencies-sample.md +33 -25
  389. package/docs/ja/specdojo/samples/prj-charter-sample.md +42 -59
  390. package/docs/ja/specdojo/samples/prj-comparison-of-alternatives-sample.md +83 -62
  391. package/docs/ja/specdojo/samples/prj-success-criteria-and-acceptance-criteria-sample.md +30 -33
  392. package/docs/ja/specdojo/samples/sf-index-sample.md +47 -20
  393. package/docs/ja/specdojo/samples/sf-sample.md +109 -21
  394. package/docs/ja/specdojo/samples/sld-sample.md +88 -21
  395. package/docs/ja/specdojo/samples/stsd-sample.md +54 -26
  396. package/docs/ja/specdojo/samples/sysd-critical-flows-sample.md +166 -21
  397. package/docs/ja/specdojo/samples/sysd-cross-cutting-policy-sample.md +178 -21
  398. package/docs/ja/specdojo/samples/sysd-index-sample.md +82 -21
  399. package/docs/ja/specdojo/samples/tml-sample.yaml +4 -1
  400. package/docs/ja/specdojo/samples/uis-sample.md +141 -20
  401. package/docs/ja/specdojo/standards/document-metadata-standard.md +33 -4
  402. package/docs/ja/specdojo/standards/id-and-file-naming-standard.md +3 -1
  403. package/docs/ja/specdojo/standards/job-definition-standard.md +24 -9
  404. package/docs/ja/specdojo/standards/rulebook-authoring-standard.md +1 -0
  405. package/docs/ja/specdojo/templates/bac-template.md +76 -0
  406. package/docs/ja/specdojo/templates/bes-template.md +56 -0
  407. package/docs/ja/specdojo/templates/br-template.md +64 -0
  408. package/docs/ja/specdojo/templates/cdfd-template.md +81 -54
  409. package/docs/ja/specdojo/templates/cdfd-uc-template.md +9 -5
  410. package/docs/ja/specdojo/templates/cdr-template.md +58 -0
  411. package/docs/ja/specdojo/templates/cnd-template.md +137 -0
  412. package/docs/ja/specdojo/templates/cpd-template.md +129 -0
  413. package/docs/ja/specdojo/templates/cxd-template.md +105 -0
  414. package/docs/ja/specdojo/templates/dct-data-model-cdt-template.yaml +40 -0
  415. package/docs/ja/specdojo/templates/dct-data-model-cld-template.yaml +7 -14
  416. package/docs/ja/specdojo/templates/dct-index-template.md +9 -20
  417. package/docs/ja/specdojo/templates/dct-project-management-template.yaml +5 -1
  418. package/docs/ja/specdojo/templates/ifd-template.md +86 -0
  419. package/docs/ja/specdojo/templates/ifx-cmd-template.yaml +44 -28
  420. package/docs/ja/specdojo/templates/ifx-index-template.yaml +40 -0
  421. package/docs/ja/specdojo/templates/opr-template.md +2 -4
  422. package/docs/ja/specdojo/templates/pm-organization-template.md +9 -3
  423. package/docs/ja/specdojo/templates/pm-plan-template.md +4 -4
  424. package/docs/ja/specdojo/templates/pm-quality-management-plan-template.md +17 -9
  425. package/docs/ja/specdojo/templates/pm-raci-template.md +24 -13
  426. package/docs/ja/specdojo/templates/pm-roles-template.yaml +3 -2
  427. package/docs/ja/specdojo/templates/prj-assumptions-constraints-dependencies-template.md +6 -3
  428. package/docs/ja/specdojo/templates/prj-comparison-of-alternatives-template.md +22 -19
  429. package/docs/ja/specdojo/templates/stsd-template.md +46 -21
  430. package/docs/ja/specdojo/templates/sysd-critical-flows-template.md +94 -0
  431. package/docs/ja/specdojo/templates/sysd-cross-cutting-policy-template.md +122 -0
  432. package/docs/ja/specdojo/templates/sysd-index-template.md +89 -0
  433. package/docs/specdojo/lib/yaml-metadata.cjs +7 -0
  434. package/docs/specdojo/schemas/v1/bdd.schema.yaml +25 -57
  435. package/docs/specdojo/schemas/v1/condense-records.schema.yaml +26 -0
  436. package/docs/specdojo/schemas/v1/dct.schema.yaml +10 -0
  437. package/docs/specdojo/schemas/v1/deliverable-frontmatter.schema.yaml +3 -0
  438. package/docs/specdojo/schemas/v1/esil.schema.yaml +7 -141
  439. package/docs/specdojo/schemas/v1/exec-common.schema.yaml +5 -1
  440. package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +95 -8
  441. package/docs/specdojo/schemas/v1/exec-evidence.schema.yaml +38 -0
  442. package/docs/specdojo/schemas/v1/exec-plan-frontmatter.schema.yaml +14 -0
  443. package/docs/specdojo/schemas/v1/exec-result-frontmatter.schema.yaml +18 -0
  444. package/docs/specdojo/schemas/v1/finding-cause.schema.yaml +22 -0
  445. package/docs/specdojo/schemas/v1/grade-pipeline-state.schema.yaml +1 -1
  446. package/docs/specdojo/schemas/v1/grade-result.schema.yaml +2 -0
  447. package/docs/specdojo/schemas/v1/ifx-cmd.schema.yaml +65 -5
  448. package/docs/specdojo/schemas/v1/ifx-index.schema.yaml +142 -0
  449. package/docs/specdojo/schemas/v1/job-run.schema.yaml +23 -0
  450. package/docs/specdojo/schemas/v1/job.schema.yaml +63 -2
  451. package/docs/specdojo/schemas/v1/register-events.schema.yaml +2 -0
  452. package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +17 -1
  453. package/docs/specdojo/schemas/v1/sch-strategy.schema.yaml +2 -2
  454. package/package.json +10 -7
  455. package/templates/antigravity/orchestrator.md +7 -3
  456. package/templates/claude/agents/specdojo-orchestrator.md +7 -3
  457. package/templates/codex/agents/specdojo-orchestrator.toml +7 -3
  458. package/templates/codex/orchestrator.md +7 -3
  459. package/templates/devcontainer/tmux.conf +6 -0
  460. package/templates/init-exec-defaults.yaml +13 -0
  461. package/templates/lefthook/tools/specdojo-pre-commit.mjs +8 -0
  462. package/templates/opencode/agents/specdojo-orchestrator.md +8 -4
@@ -0,0 +1,111 @@
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
+ - 業務受入条件は、上位の目的から誰の困りごとを解くか(Why)を引き継ぎ、業務が成立した状態(What)を決め、そこへ至る前提と業務行為(How)を逆算する。期待結果は根拠・シナリオ ID・証跡でたどれるようにする(Trace)。
19
+ - 「作成前に集める情報」をメモでそろえてから、「全体の作成手順」の順に書く。
20
+
21
+ ## 2. 作成前に集める情報
22
+
23
+ | 項目 | 集める情報 | 取り出し元 |
24
+ | -------------- | -------------------------------------------------- | ---------------------------- |
25
+ | 利用者と価値 | 誰のどの負担・誤判断・引き継ぎ漏れを減らすか | プロジェクトの受入条件 |
26
+ | 業務の境界 | 何が起点で、どの記録や引き継ぎまでで終わるか | 業務プロセス仕様 |
27
+ | 確定済みの判断 | 不足・拒否・途中変更をどう扱うと決まっているか | 業務プロセス仕様、業務ルール |
28
+ | 前提 | 必要な状態・入力・権限と、不足すると止まること | 業務プロセス仕様 |
29
+ | 確認者と証跡 | 誰がいつ何を照合して合否を決め、誰が合意するか | 業務担当者の代表への確認 |
30
+ | 未決の論点 | 期待値を決める材料がない場面と、受入を止めるか否か | 確認の過程のメモ |
31
+
32
+ ## 3. 全体の作成手順
33
+
34
+ 1. 概要の受入対象と価値を最初に書く。業務の終わりが決まらないと、シナリオの範囲が決まらない。
35
+ 2. 正常完了のシナリオを一つ書く。終了状態を先に決め、開始状態と業務行為を逆算する。
36
+ 3. 期待結果ごとに、誰がいつどの記録で確かめるかを書く。
37
+ 4. 不足・拒否・途中変更・再開で結果が変わる場面を足す。
38
+ 5. 根拠で期待値を決められない場面をメモ / 将来課題へ移す。
39
+ 6. 最後に価値とシナリオ ID の対応を見直す。書いた後のほうが、確認漏れの価値に気づきやすい。
40
+
41
+ ## 4. 各章の書き方
42
+
43
+ ### 4.1. 概要
44
+
45
+ 問い:
46
+
47
+ - この受入に合格すると、誰が次にどの業務を進められるか。
48
+ - 隣の業務の判断まで引き受けていないか。
49
+
50
+ コツ:
51
+
52
+ - 画面名から書くと、手段が受入対象になりやすい。困りごとを一つ選び、開始点と終了点を先に決める。
53
+ - 上位の目的や受入条件の本文は、写さず参照に置き換える。
54
+
55
+ ### 4.2. 受入条件
56
+
57
+ 問い:
58
+
59
+ - その前提でその行為を行うと、何が変わり、何が変わらないか。
60
+ - 別の人も同じ証跡から合否を判断できるか。
61
+
62
+ コツ:
63
+
64
+ - 業務担当者に「確定したと誰がどの記録で分かるか」を聞くと、操作の列挙から観測できる結果へ移れる。
65
+ - 数値には単位と確認時点を付ける。
66
+
67
+ ### 4.3. メモ / 将来課題
68
+
69
+ 問い:
70
+
71
+ - どのシナリオの期待値が未確定で、誰の判断があれば再開できるか。
72
+ - その論点は現行の受入を止めるか、将来の拡張か。
73
+
74
+ コツ:
75
+
76
+ - 既定値で期待結果を埋めたくなったら、論点として残す。
77
+ - 受入を止める論点は、当面どの経路を保留するかを聞いて書く。
78
+
79
+ ## 5. 深掘り手順
80
+
81
+ 内容が浅いときは、次の順で対応のない主張を探す。
82
+
83
+ 1. 概要の価値からシナリオをたどり、確認されない価値と、根拠に結び付かないシナリオを探す。
84
+ 2. 正常シナリオの前提を一つずつ外し、業務を進めてよいか、結果を確定してよいかを問う。
85
+ 3. 途中で入力や対象が変わる場面を置き、前の記録を使えるかを確かめる。
86
+ 4. 停止後に次の担当が受け取る情報をたどり、再開に要る状態と証跡を特定する。
87
+
88
+ ## 6. 良い例 / 悪い例
89
+
90
+ | 観点 | 良い例 | 悪い例 |
91
+ | -------- | ---------------------------------------------------- | ------------------------------ |
92
+ | 受入対象 | 家族が店番しても販売と在庫を記録して引き継げる | 販売画面を作る |
93
+ | 根拠 | 業務仕様で決まった入力不足の扱いをシナリオで確かめる | 書き手が不足時の既定値を決める |
94
+ | 操作 | 家族利用者代表が販売を確定する | ボタンと画面遷移を列挙する |
95
+ | 停止 | 販売を確定せず、不足情報を担当者へ渡す | エラーを表示する |
96
+ | 判定 | 数量 2 の販売の確定後、在庫が 5 から 3 へ減ると照合 | 在庫が正しい |
97
+ | 未決 | 記録不能時の販売継続は未決とし、その経路の受入を保留 | 例外は後で追加 |
98
+
99
+ ## 7. レビュー観点
100
+
101
+ | 観点 | 確認内容 |
102
+ | ---------- | ------------------------------------------------------ |
103
+ | 業務価値 | 各シナリオの必要性を利用者の困りごとから説明できるか |
104
+ | 例外と継承 | 止める判断と、次の担当の行為を区別できるか |
105
+ | 責務境界 | 新しい判断規則や実装方式を受入条件の中で決めていないか |
106
+
107
+ ## 8. 仕上げチェック
108
+
109
+ - 概要の各価値がシナリオ ID で確認され、各シナリオが根拠へたどれる。
110
+ - 未決の値を確定済みの期待結果へ混ぜていない。
111
+ - 条件を合意できる状態と、受入を試行して合格した実績を区別している。
@@ -0,0 +1,141 @@
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
+ - 業務イベント仕様は、一覧から防ぎたい混同(Why)を引き継ぎ、一回の事実の境界・時点・条件・データ(What)を定め、要求者と成立させる主体(How)を分ける。主張は上位一覧・状態定義・データモデルでたどる(Trace)。
19
+
20
+ ## 2. 作成前に集める情報
21
+
22
+ | 項目 | 集める情報 | 取り出し元 |
23
+ | ---------------- | ---------------------------------------------- | -------------------- |
24
+ | 防ぎたい混同 | 誰が何を誤って数え、引き継ぐか | 業務目的、利用者 |
25
+ | 対応するイベント | 対応する行と、共通の対象範囲・用語 | 業務イベント一覧 |
26
+ | 似た出来事・起点 | 取り違えやすい要求・受付・後処理と、起点の種類 | 業務の担当者 |
27
+ | 判断の根拠 | 成立直前の状態と、条件の正本 | 状態定義、業務ルール |
28
+ | 識別情報 | 対象・取引・要求・実行を区別する情報 | データモデル |
29
+ | 承認する人 | 業務定義を承認する人と判断時期 | 業務の承認者 |
30
+
31
+ ## 3. 全体の作成手順
32
+
33
+ 1. 防ぐ混同を一文でメモする。これがないと一回の単位が決まらない。
34
+ 2. 成立と不成立の場面を並べてから「何が起きたか」を書く。
35
+ 3. 「いつ」「誰が/何が」「発生条件」「事実データ」の順に書く。前の章の境界が後の章の範囲になる。
36
+ 4. 解釈が分かれた場面を確認例にする。
37
+ 5. 導入は最後に書く。境界が決まる前に書くと本文の言い直しになる。
38
+
39
+ ## 4. 各章の書き方
40
+
41
+ ### 4.1. 導入
42
+
43
+ 問い:
44
+
45
+ - この定義がないと、誰が何を取り違えるか。
46
+ - 何を判定できれば、この定義を使えたと言えるか。
47
+
48
+ コツ:
49
+
50
+ - 業務の目的や用語は、写さず上位一覧への参照に置き換える。
51
+ - 一覧に対応する行がなければ、推測で結び付けず未照合と書く。
52
+
53
+ ### 4.2. 何が起きたか
54
+
55
+ 問い:
56
+
57
+ - 同じ要求で二件確定したら、一回か二回か。
58
+ - まだ判定していない業務はどれか。
59
+
60
+ コツ:
61
+
62
+ - 「販売処理」のような名詞で止まったら、成立した事実を過去形にする。
63
+ - 承認する人と時期が未定の業務は、対象外にしない。
64
+
65
+ ### 4.3. いつ
66
+
67
+ 問い:
68
+
69
+ - 成立したと言える最初の観測点はどこか。
70
+ - 同じ排他区間の別の処理も、同じ出来事か。
71
+
72
+ コツ:
73
+
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
+ - 一括要求は二件並べると、要求と対象の混同に気づく。
109
+
110
+ ## 5. 深掘り手順
111
+
112
+ 浅いときは、次の順で対応のない主張を探す。
113
+
114
+ 1. 各境界が導入のどの混同を防ぐかを確かめ、対応のない境界を外す。
115
+ 2. 発生条件の各行を、状態定義・業務ルールのどこで判定するか確かめる。
116
+ 3. 事実データの各項目が使われる判定を確かめ、使われない項目を外す。
117
+ 4. 根拠が参照範囲にない主張は、確認済みの範囲まで書く。
118
+
119
+ ## 6. 良い例 / 悪い例
120
+
121
+ | 観点 | 良い例 | 悪い例 |
122
+ | -------- | -------------------------------------------------- | ---------------------- |
123
+ | 発生単位 | 複数明細の一取引でも確定は一回 | 複数の場合も扱う |
124
+ | 観測時点 | 確定記録の成立時。印字完了は後処理 | 正常に終了した時 |
125
+ | 発生条件 | 未確定の取引を確定した場合。合計表示では発生しない | 条件が揃えば発生する |
126
+ | 相関情報 | 取引番号で確定と明細を対応付ける | 同じ実行 ID でよいはず |
127
+
128
+ ## 7. レビュー観点
129
+
130
+ | 観点 | 確認内容 |
131
+ | ---------------- | ------------------------------------------------------ |
132
+ | 業務価値 | 混同と発生境界が対応するか |
133
+ | 技術への引き渡し | 状態定義・データモデルと照合でき、未確認部分が分かるか |
134
+ | 確認可能性 | 同じ場面から発生有無・回数・相関を判断できるか |
135
+
136
+ ## 8. 仕上げチェック
137
+
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
+ - 個人情報、秘密情報、非公開の組織情報を含めていない。
@@ -0,0 +1,77 @@
1
+ ---
2
+ specdojo:
3
+ id: specdojo:br-recipe
4
+ type: recipe
5
+ status: ready
6
+ rulebook: specdojo:br-rulebook
7
+ sample: specdojo:br-sample
8
+ ---
9
+
10
+ # ビジネスルール 作成レシピ
11
+
12
+ Business Rule Writing Recipe
13
+
14
+ 業務担当者の判断を、誰が適用しても同じ結果になる条件に具体化する作り方を示す。
15
+
16
+ ## 1. このレシピの使い方
17
+
18
+ - 業務プロセスから判断が要る理由(Why)を引き継ぎ、入力と結果の対応(What)、適用順と例外時の扱い(How)を決める。条件・判定例・未決事項は ID で結ぶ(Trace)。
19
+
20
+ ## 2. 作成前に集める情報
21
+
22
+ | 項目 | 集める情報 | 取り出し元 |
23
+ | ---------- | -------------------------------------- | ------------------------ |
24
+ | 利用場面 | 誰がどの業務で判断し、誤ると何が困るか | 業務プロセス、業務担当者 |
25
+ | 判断材料 | 使う項目、単位、比較時点 | 概念データ、業務担当者 |
26
+ | 代表例 | 実際の判断事例と、その結果になった理由 | 業務担当者への聞き取り |
27
+ | 未決の論点 | 決まらない判断と、止まる作業 | 聞き取りのメモ |
28
+
29
+ ## 3. 全体の作成手順
30
+
31
+ 1. 代表例の入力と結果を対にして書く。条件から書くと根拠のない条件が混ざる。
32
+ 2. その結果になる理由を条件にし、等号・同順位・未設定の例へ広げて適用順を決める。
33
+ 3. 条件が使う項目を入力に、受け取る相手の次の行動を出力に書く。
34
+ 4. 入力不備と参照失敗で業務が続くかを決め、決めきれない判断はメモ / 将来課題へ送る。
35
+ 5. 概要は最後に書く。規則が決まると対象外を切りやすい。
36
+
37
+ ## 4. 各章の書き方
38
+
39
+ | 章 | 書き手が答える問い | コツ |
40
+ | ------------------- | -------------------------------------------- | -------------------------------------------- |
41
+ | 概要 | 誤ると誰が困るか。前後の業務と重ならないか | 上位の目的は写さず参照に置き換える |
42
+ | 入力 | 一つ欠けても判断できるか。いつの値か | 項目を一つずつ隠して聞き、仮のゼロを見つける |
43
+ | ルール(判定/計算) | なぜその結果か。同時に成り立てばどちらが先か | 境界の直前・一致・直後を並べて聞く |
44
+ | 出力 | 受け取った人は次に何を選ぶか | 利用先が使わない途中の値は外す |
45
+ | 例外 / 異常系 | 誤った値で続けると何が起きるか | 止める・代替値で続けるの両案を示して選ばせる |
46
+ | メモ / 将来課題 | 誰の判断か、どの証拠があれば確定するか | 範囲を変える論点と確認作業の不足を分ける |
47
+
48
+ ## 5. 深掘り手順
49
+
50
+ 次の順で対応のない主張を探す。
51
+
52
+ 1. 各条件が概要のどの困りごとに応えるかを確かめ、対応のない条件を外す。
53
+ 2. 判定例の期待値を導く条件を確かめる。文字列の順位は、大小文字や数字を含む例で決着が変わらないかを問う。
54
+ 3. 一項目だけ欠ける場合と全件で計算できない場合を分け、同じ代替規則にする根拠を聞く。
55
+ 4. 決められない期待値は、選択肢ごとに変わる下流の作業を添えて未決へ戻す。
56
+
57
+ ## 6. 良い例 / 悪い例
58
+
59
+ | 観点 | 良い例 | 悪い例 |
60
+ | ------------ | ---------------------------------------------------- | ------------------------ |
61
+ | 入力の不足 | 「予約数がないと販売可能数を出せないため判定しない」 | 「空欄はたぶんゼロ」 |
62
+ | 部分的な欠損 | 「最早開始日だけ欠けるタスクの順位は未決とする」 | 「欠けたら末尾に置く」 |
63
+ | 利用先 | 「不足判定を在庫確認担当へ返し、発注は担当が決める」 | 「不足なら自動発注する」 |
64
+
65
+ ## 7. レビュー観点
66
+
67
+ | 観点 | 確認する問い |
68
+ | ------ | ------------------------------------------------ |
69
+ | 用語 | 業務担当者がふだんの言葉で条件を読めるか |
70
+ | 再現性 | 二人が同じ代表例に別の期待値を付ける余地はないか |
71
+ | 引継ぎ | 結果と例外から、受け取った人が次の業務を選べるか |
72
+
73
+ ## 8. 仕上げチェック
74
+
75
+ - 入力の各項目を、条件か例外のどれかが使っている。
76
+ - 出力の各結果が、条件か例外のどれかから生じる。
77
+ - 未決事項ごとに、影響する条件か判定例を ID で指せる。