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
@@ -21,69 +21,44 @@ Business Event Specification Documentation Rulebook
21
21
  - 一つの BES は、一つの業務上の出来事を扱います。確定・受付などの境界、時点、起点、条件、データのいずれかが一覧だけでは判定できない場合に詳細化します。
22
22
  - 冒頭には、この定義が解消する業務上の混同、対象範囲、定義を使えると判断する基準を簡潔に置きます。業務全体の目的は上位文書を正本とし、全文を再掲しません。
23
23
  - 人、システム、外部からの要求を同じイベントにまとめる場合は、同じ事実が成立する境界と、一回の要求から生じるイベントの単位を示します。対象外と適用未判定は区別します。
24
- - 確認できた事実と未決事項を分けます。未決事項には影響、判断者、確認担当、判断時期、記録先を添え、根拠や承認が揃うまで実装・公開可能な完成仕様と扱いません。
24
+ - 確認できた事実と未決事項を分け、未決の境界・条件・相関情報が定義の利用に与える影響を示します。
25
+ - **共通の運用**: 役割の割り当ては適用先のメンバー定義に、`status` の昇格と承認、改訂と廃止、未決事項の登録簿への引き継ぎは [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] に従います。文書の整形・lint はリポジトリの検証で扱い、業務の受入確認に含めません。
25
26
 
26
27
  ## 2. 位置づけと用語定義
27
28
 
28
- | 用語 | 本書での意味・責務 |
29
- | ----------------------- | ------------------------------------------------------------------------------------------------------------ |
30
- | 業務イベント一覧(BEL) | イベントの網羅性と個別仕様への入口を持つ上位の一覧。共通の対象範囲・用語は一覧を正本とする |
31
- | 業務イベント仕様(BES) | 一覧のうち解釈が分かれる一件について、発生した事実とその観測境界を詳細化する仕様 |
32
- | 業務プロセス仕様(BPS) | イベントを受けた後の手順、担当解決、通知、失敗時の回復などを定める仕様 |
33
- | 業務ルール(BR) | 選択、計算、可否判定の規則。BES には発生に必要な条件と参照だけを残す |
34
- | 相関情報 | 同じ要求・取引から生じた複数イベントを関連付ける業務上の識別情報。個別イベントや実行一回の識別子とは区別する |
35
-
36
- 状態の意味・遷移は状態定義、項目の構造・値・構文はデータモデル・schema・リファレンスを正本とします。BES は事実データの業務上の意味と必要になる条件を扱います。
37
-
38
- - **主要な関係者(Role code)と確認観点**:
39
- - **BA(ビジネスアナリスト / 主作成者)**: 業務上の事実境界、発生条件、事実データの正確性を定義し、改訂・廃止時の BEL・BPS への波及影響を整理する。
40
- - **PO(プロダクトオーナー / 承認者)**: 業務定義の確定、BES の置き換えおよび廃止(`deprecated` 移行)を最終判断・承認する。
41
- - **ARC(アーキテクト / 確認者)**: イベント相関境界、システム連携、BPS・データモデルとの構造整合性を確認する。
42
- - **DEV(開発者 / 利用者)**: イベント発行・購読の実装設計、外部インターフェースとの契約整合を確認する。
43
- - **QE(品質保証 / 確認者)**: 発生境界の検証可能性、事実データ・相関の確認例、受入条件(BAC/ATC)への追従を確認する。
44
- - **PM(プロジェクトマネージャー / 進行管理)**: 改訂・廃止に伴う関連成果物・実装・テストの更新タスク(PJR)を起票・管理する。
29
+ - 業務イベント一覧(BEL)は網羅性と個別仕様への入口を持ち、共通の対象範囲・用語の正本とします。BES は一覧で解釈が分かれる一件の事実と観測境界を詳細化します。
30
+ - イベントを受けた後の手順・担当解決・通知・回復は業務プロセス仕様(BPS)、選択・計算・可否判定の規則は業務ルール(BR)へ委ねます。状態の意味・遷移は状態定義、項目の構造・値・構文はデータモデル・schema・リファレンスを正本とします。
31
+ - 相関情報は、同じ要求・取引から生じた複数イベントを関連付ける業務上の識別情報です。個別イベントや実行一回の識別子とは区別します。
45
32
 
46
33
  ## 3. ファイル命名・ID規則
47
34
 
48
35
  - ファイル名は `bes-<event>.md` とし、`<event>` は出来事を区別できる英小文字のスラッグにします。
49
36
  - 文書 ID は `bes-<event>` を基本とし、プロジェクト配下ではそのプロジェクトの authority を付けます。命名・配置の共通規則は [[specdojo:docs-structure-guide|ドキュメント構成ガイド]] を正本とします。
50
- - イベント一覧が存在する場合は対応行から個別 BES へリンクし、BES からも一覧の対応イベントを識別できるようにします。一覧がなければ未解決の参照を wikilink にせず、文書 ID を仮置きして照合担当と時期を残します。
51
- - **改訂・廃止と変更管理手順**:
52
- - 置き換えによる大幅な改訂がある場合は、新 BES の `supersedes` に旧 BES の ID を列挙し、旧 BES を `status: deprecated` へ移行します。
53
- - BES の改訂・廃止時は、共通基準 [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] に従い、参照元となる BEL・BPS・実装・テストへの影響を追跡して同期更新します。
54
- - **業務イベント一覧(BEL)の追従**: 保守担当(BA)は BEL の該当行のリンクを新 BES へ付け替え、イベント名・概要・状態(非推奨・置換)を同期します。廃止時は該当行を非推奨表示または削除へ更新します。
55
- - **業務プロセス仕様(BPS)の追従**: 保守担当(BA / ARC)は旧 BES をトリガー・受領情報・発行イベントとして参照している全 BPS の処理ステップ・トリガー表を抽出し、新 BES への参照付け替え、あるいは迂回・代替経路の設計見直しを実施します。
56
- - **外部インターフェース・実装の追従**: DEV は旧 BES の事実データや相関情報に依存するイベント契約(API・メッセージ仕様)および発行・購読コードを特定し、追従修正または互換性を維持します。
57
- - **テスト・受入条件の追従**: QE は旧 BES の事実境界・発生条件を検証する業務受入条件(BAC)や受入テスト(ATC)を特定し、テストケースの更新とリグレッション確認を実施します。
58
- - 意思決定と承認は PO が担い、未決事項や波及タスクは PM が PJR 項目として起票・管理します。
37
+ - イベント一覧が存在する場合は対応行から個別 BES へリンクし、BES からも一覧の対応イベントを識別できるようにします。一覧がなければ、対応の未照合を未決事項に残します。
59
38
 
60
39
  ## 4. 推奨 Frontmatter 項目
61
40
 
62
41
  - メタ情報の構文と許容値は [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] と `docs/specdojo/schemas/v1/deliverable-frontmatter.schema.yaml` を正本とします。
63
- - BES の `type` は `requirement`、`rulebook` は `specdojo:bes-rulebook` とします。作成中は `status: draft` を維持し、`ready` への昇格は人間が行います。
64
- - `supersedes` は置き換え対象の旧 BES の ID 配列を指定します。旧仕様との置換関係を明確にし、下流への影響確認が完了するまで旧 BES は `status: deprecated` として保持します。
65
- - `status` は `draft` / `ready` / `deprecated` とします。作成・改訂中は `draft` とし、PO の承認を経て `ready` へ昇格します。廃止時は直接削除せず `deprecated` に移行して移行期間を設けます。`deprecated` の BES を有効な BPS や新規文書から参照してはなりません。
66
- - `based_on` には実際に根拠とした先行成果物だけを記載します。依存として宣言されていない文書やプロジェクト共通文脈を、根拠に見せるために追加しません。
67
- - 業務承認を担う人間と承認条件は本文で識別します。未確認の個人名・担当割当を補完せず、実名または Member の確認を未決事項に残します。
42
+ - BES の `type` は `requirement`、`rulebook` は `specdojo:bes-rulebook` とします。
68
43
 
69
44
  ## 5. 本文要件
70
45
 
71
- 見出し順・表・記入欄の骨組みは template を正本とします。以下は各章の意味要件であり、任意の小節も該当する章の範囲に置きます。Markdown の `##`〜`####` には階層ごとに連番と末尾の `.` を付けます。
46
+ 見出し順・表・記入欄の骨組みは template を正本とします。以下は各章の意味要件であり、任意の小節も該当する章の範囲に置きます。
72
47
 
73
48
  | 記述対象 | 必須・任意 | 判定基準 |
74
49
  | -------------------------- | ------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------ |
75
50
  | 導入 | 必須 | 解消する混同、対象範囲、利用できると判断する基準、上位一覧との対応が分かる |
76
51
  | 「何が起きたか」の事実境界 | 必須 | 対象と確定した事実を過去形で示す。一回の発生単位、似ているが含めない出来事、対象業務の境界を区別できる |
77
52
  | 「いつ」の観測時点 | 必須 | 要求・受付・確定・後処理のどの時点か判定できる。繰り返し・一括要求がある場合は各イベントの発生時点を説明できる |
78
- | 「誰が/何が」の主体 | 必須 | 要求する主体と事実を成立させる主体を区別する。システム名は責務を定義し、業務承認者と混同しない |
53
+ | 「誰が/何が」の主体 | 必須 | 要求する主体と事実を成立させる主体を区別する。システム名は責務を定義する |
79
54
  | 「発生条件」の成立・不成立 | 必須 | 共通条件と起点別の差異を示す。候補なし・条件未充足など、発生しない場合を判定できる。判断ロジックは BR、状態は状態定義へ委ねる |
80
55
  | 「事実データ」の内容 | 必須 | 項目ごとの業務上の意味と必要になる条件を示す。一括・並列などでは相関情報の単位と照合先を示す。未来の処理結果を発生時点の事実にしない |
81
56
  | 発生判定・相関の確認例 | 境界や相関の解釈が分かれる場合に必須 | 同じ条件から発生有無・回数・同じ要求への帰属を判断できる。テスト実装や網羅的なケース集は持ち込まない |
82
- | 未決事項と承認条件 | 未決事項がある場合に必須 | 関連する章に、未決の内容、利用への影響、決定者、確認担当、時期、記録先を置く。解消済み・承認済みと誤認させない |
57
+ | 未決事項と承認条件 | 未決事項がある場合に必須 | 関連する章に論点と利用への影響を置き、当面の扱いと、確定時に見直す境界・条件・データを示す |
83
58
 
84
59
  ## 6. 記述ガイド
85
60
 
86
- 共通の業務範囲・用語は上位一覧を参照し、各 BES では個別の差分だけを具体化します。完成例を本文へ埋め込まず、以下では判断を分ける短い例だけを示します。
61
+ 共通の業務範囲・用語は上位一覧を参照し、各 BES では個別の差分だけを具体化します。
87
62
 
88
63
  ### 6.1. 導入
89
64
 
@@ -105,13 +80,13 @@ Business Event Specification Documentation Rulebook
105
80
 
106
81
  ### 6.4. 誰が/何が
107
82
 
108
- - 判断基準: 起点が複数なら、起点区分、要求者、成立させる主体、差異を表で並べます。承認者の責任は成立主体の責任と分けます。
109
- - 良い例: 「店番担当が確定を要求し、販売管理システムが確定を記録する。業務定義の承認は人間の店主代表が担う。」
83
+ - 判断基準: 起点が複数なら、起点区分、要求者、成立させる主体、差異を表で並べます。
84
+ - 良い例: 「店番担当が確定を要求し、販売管理システムが確定を記録する。」
110
85
  - 悪い例: 「担当またはシステム。」どちらが何をするか不明です。
111
86
 
112
87
  ### 6.5. 発生条件
113
88
 
114
- - 判断基準: 成立条件と不成立条件を対にして示します。根拠にない適用範囲は未決のまま、確認担当・判断者・時期・記録先を具体化します。
89
+ - 判断基準: 成立条件と不成立条件を対にして示します。根拠にない適用範囲は未決とし、利用への影響と当面の扱いを示します。
115
90
  - 良い例: 「受領金額が請求金額以上で、未確定の取引を確定した場合に発生する。金額確認だけでは発生しない。」
116
91
  - 悪い例: 「会計可能なら発生する。」判定根拠がなく、発生しない境界も分かりません。
117
92
 
@@ -123,14 +98,11 @@ Business Event Specification Documentation Rulebook
123
98
 
124
99
  ## 7. 禁止事項
125
100
 
126
- | 禁止する記述・扱い | 理由 |
127
- | ----------------------------------------------------------------------------------- | ------------------------------------------------------ |
128
- | 一覧にない適用範囲や未確認の担当を、合意済みとして追加する | 境界と承認責任を誤って確定するため |
129
- | 着手・通知・後処理・例外回復の詳細手順を BES に展開する | プロセス仕様の責務と重複するため |
130
- | BR の順位付け・計算式、状態遷移表を複製する | 正本の変更を追従できなくなるため |
131
- | 物理テーブル・カラム、SQL、実装クラス・関数、詳細 API、CLI 構文を正本として記載する | 概念上の事実と実装契約を混同するため |
132
- | 発生後にしか分からない最終件数・結果を、発生時点の確定データとする | 観測時点と事実が矛盾するため |
133
- | 相関情報を実行 ID や時刻で代用できると、根拠なしに断定する | 複数イベントの同一要求への帰属を誤るため |
134
- | 未決事項や承認未了を隠して完成・公開可能と表す | 下流が不確かな前提で設計・検証を始めるため |
135
- | `deprecated` の BES を有効な BPS や新規文書から参照する | 廃止・非推奨のイベント契約に依存して処理破綻を招くため |
136
- | BEL や BPS への波及影響・追従更新を確認せずに BES を改訂・廃止する | 業務プロセス間でのイベント受渡しの断絶を招くため |
101
+ | 禁止する記述・扱い | 理由 |
102
+ | ----------------------------------------------------------------------------------- | ---------------------------------------- |
103
+ | 一覧にない適用範囲を、合意済みとして追加する | イベントの対象境界を誤って確定するため |
104
+ | 着手・通知・後処理・例外回復の詳細手順を BES に展開する | プロセス仕様の責務と重複するため |
105
+ | BR の順位付け・計算式、状態遷移表を複製する | 正本の変更を追従できなくなるため |
106
+ | 物理テーブル・カラム、SQL、実装クラス・関数、詳細 API、CLI 構文を正本として記載する | 概念上の事実と実装契約を混同するため |
107
+ | 発生後にしか分からない最終件数・結果を、発生時点の確定データとする | 観測時点と事実が矛盾するため |
108
+ | 相関情報を実行 ID や時刻で代用できると、根拠なしに断定する | 複数イベントの同一要求への帰属を誤るため |
@@ -18,58 +18,35 @@ Business Process Specification (BPS) Documentation Rulebook
18
18
 
19
19
  ## 1. 全体方針
20
20
 
21
- - 一文書は、概念データフローの一つのプロセス領域に属し、共通の起点と業務成果を持つ一連の流れを扱います。同じ領域に起点または業務成果が異なる流れがある場合は、BPS を分けます。
22
- - CDFD の個別プロセスは BPS の処理ステップとして具体化します。プロセス領域の境界、プロセス ID、主要な入出力、データストアの名称を変更する必要がある場合は、先に CDFD を更新します。
21
+ - 一文書は、CDFD の一つのプロセス領域に属し、共通の起点と業務成果を持つ流れを扱います。同じ領域でも起点または成果が異なる流れは別の BPS に分けます。
22
+ - CDFD の個別プロセスを処理ステップへ具体化します。領域の境界、プロセス ID、主要入出力、データストア名を変える場合は、先に CDFD を更新します。
23
23
  - 業務担当者が開始条件、判断、責任、完了条件を確認でき、設計者とテスト担当者が機能設計および受入シナリオの入力として利用できる粒度にします。
24
24
  - ビジネスルール、業務イベント、状態定義、データ定義は対応する仕様を正本とします。BPS には、その流れで参照する条件と利用目的だけを記載します。
25
- - 物理テーブル、SQL、クラス、関数、画面操作、詳細 API などの実装方式は扱いません。
26
25
  - 複数のプロセス領域またはプロセスグループをまたぐ順序と引き渡し条件はユースケース別 CDFD を正本とし、BPS では自文書が担う流れの入口と出口だけを記載します。
26
+ - **共通の運用**: 役割の割り当ては適用先のメンバー定義に、`status` の昇格と承認、改訂と廃止、未決事項の登録簿への引き継ぎは [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] に従います。文書の整形・lint・Frontmatter 検証はリポジトリの検証で扱い、業務の受入確認に含めません。
27
27
 
28
- ## 2. 位置づけと用語定義
28
+ ## 2. 位置づけ
29
29
 
30
- | 用語 | 定義 |
31
- | ------------ | ------------------------------------------------------------------------------------------------------------ |
32
- | BPS | 一つのプロセス領域に属する一連の流れについて、開始から業務成果の確定までを記述する業務プロセス仕様 |
33
- | プロセス領域 | 固有の業務目的、主な担当、起点イベントを持つ CDFD 上の責務のまとまり |
34
- | 流れ | 共通の起点と業務成果を持つ、複数の処理ステップのまとまり |
35
- | 処理ステップ | CDFD の個別プロセスを引き継ぎ、担当、入力、活動または判断、出力、完了条件を示す BPS 内の単位 |
36
- | トリガー | 業務プロセスの開始を判定できる出来事。時刻到来、依頼受付、状態変化、業務イベントなど |
37
- | 前提条件 | トリガー発生時に、処理を開始できるかを判定する条件 |
38
- | 業務成果 | 処理の完了により確定する記録、状態変化、通知、判断結果、または次の業務への引き渡し |
39
- | 主要例外 | 正常な業務成果または後続処理の起動を妨げ、停止、差戻し、代替経路、または人による判断を必要とする業務上の事象 |
40
-
41
- BPS は CDFD が定めるプロセス領域と流れを詳細化し、BES が定める業務イベント、BR が定める判断・計算、STSD が定める状態と遷移を利用します。参照先の定義を BPS 内へ複製せず、このプロセスでいつ、何のために利用するかを明らかにします。
30
+ BPS は CDFD のプロセス領域と流れを詳細化し、BES の業務イベント、BR の判断・計算、STSD の状態と遷移を利用します。各仕様をいつ、何のために使うかを示します。
42
31
 
43
32
  ## 3. ファイル命名・ID規則
44
33
 
45
- - ファイル名は `bps-<term>.md`、成果物 ID は拡張子を除いた `bps-<term>` とします。`<term>` は対象の流れまたは業務成果を表す英小文字・数字・ハイフンのスラッグです。
46
- - product 成果物の ID にはプロジェクト ID や authority を付けません。例: ファイル名 `bps-order-candidate-generation.md`、ID `bps-order-candidate-generation`。
34
+ - ファイル名は `bps-<term>.md`、product 成果物 ID はプロジェクト ID や authority を付けない `bps-<term>` とします。`<term>` は流れまたは業務成果を表す英小文字・数字・ハイフンのスラッグです(例: `bps-replenishment-request.md`)。
47
35
  - 番号や一時的な組織名、実装名を `<term>` に含めません。同じ業務上の責務を保つ限り、処理順や担当組織が変わっても ID を維持します。
48
- - 一つの BPS に複数の独立した起点または業務成果を混在させません。起点または成果が独立して変更・承認される場合は、別の `bps-<term>` に分けます。
49
- - 処理ステップ ID は文書内で一意な `S-01` 形式、主要例外 ID は `E-01` 形式とします。CDFD のプロセス ID がある場合は、処理表の「CDFD プロセス」列で対応させます。
36
+ - 起点または成果が独立して変更・承認される場合は、別の `bps-<term>` に分けます。
37
+ - トリガー ID は `T-01`、処理ステップ ID は `S-01`、主要例外 ID は `E-01` 形式で、それぞれ文書内で一意にします。CDFD の個別プロセス ID は処理表の「CDFD プロセス」列で対応させます。
50
38
 
51
39
  ## 4. 推奨 Frontmatter 項目
52
40
 
53
- Frontmatter の共通原則はドキュメントメタ情報標準、許可される項目と型は成果物 Frontmatter スキーマを正本とします。
54
-
55
- | 項目 | 説明 | 必須 |
56
- | ---------- | ------------------------------------------------------- | ---- |
57
- | id | プロジェクト修飾なしの `bps-<term>` | ○ |
58
- | type | 業務フロー・プロセス仕様を表す `flow` | ○ |
59
- | status | `draft` / `ready` / `deprecated` | ○ |
60
- | rulebook | `specdojo:bps-rulebook` | ○ |
61
- | part_of | 一覧または親成果物との所属関係 | 任意 |
62
- | based_on | 作成時に直接確認した、依存関係上許可される先行成果物 ID | 任意 |
63
- | supersedes | 置き換える旧 BPS の ID | 任意 |
64
- | relations | 要求の充足などを表す型付き参照 | 任意 |
41
+ 許可キー・必須項目・型制約はドキュメントメタ情報標準と `docs/specdojo/schemas/v1/deliverable-frontmatter.schema.yaml` を正本とします。
65
42
 
66
- - SpecDojo が所有する項目は `specdojo:` 配下に置きます。文書名は Frontmatter ではなく H1 に記載します。
67
- - `based_on` には、成果物カタログの `depends_on` の推移閉包に含まれ、実際に内容根拠として確認した ID だけを記載します。
68
- - 作成中は `status: draft` とします。完成条件と承認を満たした後の `ready` への昇格は、プロジェクトの責任分担と運用に従います。
43
+ - `id` は「ファイル命名・ID規則」に従います。
44
+ - `type` は `flow`、`rulebook` は `specdojo:bps-rulebook` とします。
45
+ - `based_on` は、成果物カタログの `depends_on` の推移閉包内で、直接の内容根拠として確認した先行成果物 ID に限ります。
69
46
 
70
47
  ## 5. 本文要件
71
48
 
72
- 見出し順、表の列、記入欄の骨組みは Frontmatter で宣言した template を正本とします。BPS は、骨組みを埋めた結果として次の意味要件を満たさなければなりません。
49
+ 見出し順・表の列・記入欄は Frontmatter で宣言した template を正本とし、次の意味要件を満たします。
73
50
 
74
51
  | 要件群 | 必須 | 目的と記載要件 |
75
52
  | ------------------ | -------- | -------------------------------------------------------------------------------------------------------------- |
@@ -80,15 +57,13 @@ Frontmatter の共通原則はドキュメントメタ情報標準、許可さ
80
57
  | 業務成果と引き渡し | ○ | 正常終了と条件付き終了の成果、受け手、確定条件、正本、後続処理を定義する |
81
58
  | 主要例外 | ○ | 業務成果または後続処理を変える例外について、検出条件、停止範囲、担当、処置、再開条件または代替成果を定義する |
82
59
  | 検証可能性 | ○ | 正常系・条件付き・例外系について、第三者が結果を判定できる入力条件、期待する業務成果、確認可能な記録を定義する |
83
- | 未決論点の追跡 | 条件付き | 調査または意思決定が未了の論点、影響、区分、決定者、決定時期を記載する。未決事項がある場合だけ扱う |
84
-
85
- 処理は操作の羅列ではなく、各ステップの業務目的と完了条件を含めます。検証条件はテストケースの実装ではなく、業務成果を受け入れられる条件を定義します。
60
+ | 未決論点の追跡 | 条件付き | 未決事項がある場合だけ、論点と影響する章・ステップ、当面の扱いを記載する |
86
61
 
87
62
  ## 6. 記述ガイド
88
63
 
89
64
  ### 6.1. 導入文と概要
90
65
 
91
- - 導入文は「在庫数更新を受け、補充が必要な商品について発注候補を確定する」のように、起点、対象、業務成果を一文で示します。
66
+ - 導入文は「現在庫が補充基準を下回ったことを受け、補充対象の商品と依頼数量を判断し、補充依頼を確定する」のように、起点、対象、業務成果を一文で示します。
92
67
  - 「概要」は、業務目的、対象者、対象範囲、対象外、主担当、開始点、終了点を箇条書きまたは表で示します。対象外には前後のプロセス、横断フロー、実装方式を明記します。
93
68
  - CDFD のプロセス領域名と対象の流れを示し、同じ領域にある他の流れとの境界を説明します。領域の分割そのものは BPS で変更しません。
94
69
 
@@ -102,7 +77,7 @@ Frontmatter の共通原則はドキュメントメタ情報標準、許可さ
102
77
 
103
78
  | 列 | 記載内容 |
104
79
  | -------------- | -------------------------------------- |
105
- | トリガー ID | 文書内で一意な `T-01` 形式 |
80
+ | トリガー ID | 「ファイル命名・ID規則」に従う識別子 |
106
81
  | 出来事 | 発生時点を判定できる業務上の出来事 |
107
82
  | 発生元 | 人、組織、外部主体、または業務イベント |
108
83
  | 受領情報 | 開始判断に使用する情報 |
@@ -126,7 +101,7 @@ Frontmatter の共通原則はドキュメントメタ情報標準、許可さ
126
101
 
127
102
  | 列 | 記載内容 |
128
103
  | -------------- | -------------------------------------------------- |
129
- | ステップ ID | 文書内で一意な `S-01` 形式 |
104
+ | ステップ ID | 「ファイル命名・ID規則」に従う識別子 |
130
105
  | CDFD プロセス | 対応する CDFD の個別プロセス ID |
131
106
  | 担当 | 実施または判断の責任主体 |
132
107
  | 入力 | このステップが使用する入力または直前ステップの成果 |
@@ -150,25 +125,19 @@ Frontmatter の共通原則はドキュメントメタ情報標準、許可さ
150
125
  ### 6.7. 検証・受入観点
151
126
 
152
127
  - 正常系、条件付き処理、主要例外について、入力条件、期待する業務成果、確認可能な記録を対応付けます。
153
- - 「正しく処理される」ではなく、「対象商品の発注候補が一件確定し、数量の根拠と判断に用いたルール ID を確認できる」のように判定可能な条件を記述します。
128
+ - 「正しく処理される」ではなく、「対象商品の補充依頼が一件確定し、依頼数量の根拠と判断に用いたルール ID を確認できる」のように判定可能な条件を記述します。
154
129
  - 業務受入条件やテスト仕様に詳細を委ねる場合も、BPS 自体の完了条件を空にせず、後続文書が確認すべき業務成果を残します。
155
130
 
156
131
  ### 6.8. 未決事項
157
132
 
158
- - 調査で解消する情報不足は `_TODO_`、意思決定待ちは `_UNDECIDED_`、仮置きする前提は `_ASSUMPTION_` として区別します。
159
- - 表は「論点」「影響する章・ステップ」「区分」「決定者」「決定時期」で構成し、本文中のラベルと対応させます。
160
- - `ready` へ昇格する前に `_TODO_` を解消します。`_UNDECIDED_` を残す場合は、業務成果の受入可否に影響しないことと決定の追跡先を確認します。
133
+ - 未決事項がある場合だけ章を置き、本文中の未確定ラベルに対応する論点と影響する章・ステップを示します。
134
+ - 影響には当面の開始可否、確定できない業務成果、決定後に直す条件を含めます。
161
135
 
162
136
  ### 6.9. 完成判定
163
137
 
164
- - Frontmatter に `id`、`type`、`status`、`rulebook` があり、ファイル名、ID、`type: flow` が本ルールと一致しています。
165
- - 対象が一つのプロセス領域に属する一連の流れであり、起点、業務成果、対象外を説明できます。
166
- - トリガー、前提条件、入力、全処理ステップ、出力、主要例外を開始から終了まで追跡でき、CDFD のプロセス ID と名称に矛盾がありません。
167
- - 各処理ステップに担当、入力、活動または判断、出力、完了条件があり、分岐先と例外の対応を確認できます。
168
- - BR、BES、BDD、CDSD、STSD などの参照先を正本として扱い、定義を複製していません。
169
- - 正常系、条件付き処理、主要例外の受入条件が第三者に判定可能で、確認可能な記録または業務成果を示しています。
170
- - 物理データ構造、詳細 API、画面操作、実装クラスなどの実装方式が混在していません。
171
- - `_TODO_` が残っていません。`_UNDECIDED_` がある場合は「未決事項」に決定者と決定時期があります。
138
+ - CDFD と領域・プロセス ID・名称・主要入出力・データストア名を照合し、「本文要件」の必須要件と条件付き要件を確認します。
139
+ - トリガーから全ステップの分岐・例外・再開先を順にたどり、開始から業務成果または代替成果まで途切れないことを確認します。
140
+ - 正常系・条件付き・主要例外の入力条件を当てはめ、成果と記録が「検証・受入観点」の期待結果に一致すれば合格とします。
172
141
 
173
142
  ## 7. 禁止事項
174
143
 
@@ -176,7 +145,6 @@ Frontmatter の共通原則はドキュメントメタ情報標準、許可さ
176
145
  - CDFD のプロセス領域、プロセス ID、データストア名を BPS だけで追加、削除、改名しません。
177
146
  - BR の判断式、BES のイベント契約、BDD・CDSD のデータ定義、STSD の状態定義・遷移表を複製しません。
178
147
  - 処理ステップを画面のクリック順、CLI コマンド列、API 呼び出し順、クラスや関数の呼び出し順として記載しません。
179
- - 物理テーブル、物理カラム、SQL、詳細 API 項目、実装クラス、ログ文言、秘密情報を記載しません。
148
+ - 物理テーブル、物理カラム、SQL、詳細 API 項目、実装クラス、ログ文言を記載しません。
180
149
  - 担当、完了条件、分岐先、再開条件を空欄にしたり、「適切に処理する」「問題がなければ完了」のような判定不能な表現だけで済ませたりしません。
181
150
  - 正常な非起動条件を主要例外として扱ったり、業務成果を変えない内部エラーを網羅的に列挙したりしません。
182
- - 作成状況やレビュー状態を本文で管理しません。進捗と判断履歴は登録簿やレビュー結果で追跡します。
@@ -21,7 +21,7 @@ Business Rule Documentation Rulebook
21
21
  - 1 文書で一つの判断目的を扱い、適用条件、概念入力、判定、出力、例外を対応させる。
22
22
  - 業務価値は上位文書から引き継ぎ、本書の判断が守る価値と適用境界だけを記す。共通事項は上位の index または標準を正本とする。
23
23
  - 業務上の比較・計算の意味を定義し、設定値の列挙、構文、物理構造は対応する schema・リファレンスを参照する。実装コードを仕様の代替にしない。
24
- - 未決事項は共通ラベルで確定事項と区別し、承認なしに既定値や欠損時の扱いを補わない。
24
+ - **共通の運用**: 役割の割り当ては適用先のメンバー定義に、`status` の昇格と承認、改訂と廃止、未決事項の登録簿への引き継ぎは [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] に従う。文書の整形・lint はリポジトリの検証で扱い、成果物の業務の検証に含めない。
25
25
 
26
26
  ## 2. 位置づけ
27
27
 
@@ -29,14 +29,6 @@ BR は業務プロセスから呼び出される判断の正本である。BPS
29
29
 
30
30
  独立して承認・変更できる判断目的が複数ある場合は文書を分ける。同じ判断を完結させる入力検証・計算・例外は、条件数だけを理由に分割しない。
31
31
 
32
- - **主要な関係者(Role code)と確認観点**:
33
- - **BA(ビジネスアナリスト / 主作成者・問い合わせ対応)**: 業務上の判断目的・ルール・入出力・例外を記述し、改訂・廃止時の BPS への影響分析とルール解釈の問い合わせに対応する。
34
- - **PO(プロダクトオーナー / 承認者)**: 業務判断の妥当性、ルールの置き換えおよび廃止(`deprecated` 移行)を最終判断・承認する。
35
- - **ARC(アーキテクト / 確認者)**: システム制約、データモデル・外部スキーマとの整合性を確認する。
36
- - **DEV(開発者 / 利用者)**: ルールを実現するロジック・関数の実装、型制約との対応を確認する。
37
- - **QE(品質保証 / 確認者)**: 判定境界値の網羅性、検証可能性、業務受入条件(BAC)やテスト(UTC/ITC)への追従を確認する。
38
- - **PM(プロジェクトマネージャー / 進行管理)**: 改訂・廃止に伴う関連成果物・実装・テストの更新タスク(PJR)を起票・管理する。
39
-
40
32
  ## 3. ファイル命名・ID規則
41
33
 
42
34
  - ファイル名は判断の意味を表す `br-<subject>.md` を推奨する。連番や特定プロジェクトの管理番号を必須にしない。
@@ -49,32 +41,20 @@ BR は業務プロセスから呼び出される判断の正本である。BPS
49
41
 
50
42
  - `type` は業務の判断を表す `rule` とし、適用する主 rulebook を宣言する。
51
43
  - `based_on` は判断の根拠となる先行成果物を示す。依存先が未作成の場合は本文にも未確認の範囲を残し、内容を確認済みと扱わない。
52
- - `part_of` は親ルールへの所属がある場合だけ用いる。ルールの名称は H1 に置き、未承認の文書を `ready` にしない。
53
- - `supersedes` は置き換え対象の旧 BR の ID 配列を指定する。判断規則の大幅な変更時に新 BR を作成して指定し、旧 BR は `status: deprecated` へ移行する。
54
- - `status` は `draft` / `ready` / `deprecated` とする。作成・改訂中は `draft` とし、PO の承認を経て `ready` へ昇格する。廃止時は直接削除せず `deprecated` に移行して移行期間を設ける。
55
- - **ライフサイクル操作と波及影響の追跡規則**:
56
- - **更新・置き換え**: 判断規則の大幅改訂時は新 BR を作成し `supersedes` に旧 ID を設定する(PO 承認)。保守担当(BA)は BPS 側での参照更新案を作成する。
57
- - **廃止**: 当該ビジネスルールが不要となった場合、`status: deprecated` に移行し、廃止理由と代替(無条件実行、別ルール等)を明記する(PO 承認)。`deprecated` の BR を有効な BPS や新規文書から参照してはならない。
58
- - **問い合わせ対応**: ルールの解釈、例外発生時の扱い、境界値の妥当性に関する問い合わせ窓口は BA が担当し、仕様の曖昧さが見つかった場合は改訂またはメモ/将来課題へ記録する。
59
- - **波及影響の識別・追従規則**:
60
- BR の条件・出力変更時は、共通基準 [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] に従い、参照元となる BPS、実装、テストへの影響を追跡して同期更新する。
61
- - **参照元業務プロセス仕様(BPS)**: BA は当該 BR を「活動・判断」で参照している全処理ステップを抽出し、入力項目の過不足、判定結果の分岐、完了条件の整合性を更新する。
62
- - **実装コード**: DEV は当該 BR をロジックや計算式として実装している関数・ドメインモデルを特定し、追従修正を実施する。
63
- - **テスト仕様・受入条件**: QE は当該 BR を検証する業務受入条件(BAC)、単体・結合テスト(UTC / ITC)の判定例・境界値を更新し、再検証を行う。
64
- - **変更タスク管理**: PM は波及する関連文書・実装・テストの更新タスク(PJR 項目)を起票・追跡する。
44
+ - `part_of` は親ルールへの所属がある場合だけ用いる。
65
45
 
66
46
  ## 5. 本文要件
67
47
 
68
48
  内容要件は次のとおり。すべて必須とし、該当する例外や未決事項がなければ「なし」と明示する。見出し順・表・記入欄の骨組みは frontmatter で宣言した template を正本とする。
69
49
 
70
- | 扱う内容 | 成立条件 |
71
- | ------------------- | ------------------------------------------------------------------------------------------------------------------------ |
72
- | 概要 | 判断の目的、利用者、適用する業務場面、前提、対象外が分かる |
73
- | 入力 | 判定に使う全入力について概念項目、利用目的、適用条件、欠損時の扱いが分かる。派生ビュー等を使う経路も含む |
74
- | ルール(判定/計算) | 適用順、条件、結果、境界値が対応する。複数条件の優先順位、同順位・欠損時の扱いを定め、代表的な判定例を置く |
75
- | 出力 | 正常な結果の意味、単位または区分、利用先が分かる。「対象なし」と判定不能を区別する |
76
- | 例外 / 異常系 | 状況、判定を続けるか、結果の有無、回復のために誰が何をするかが分かる |
77
- | メモ / 将来課題 | 未決事項ごとに決定を依頼する相手、判断時点、下流への影響、必要な根拠を記す。未決事項がある場合は承認可能となる条件も示す |
50
+ | 扱う内容 | 成立条件 |
51
+ | ------------------- | -------------------------------------------------------------------------------------------------------------- |
52
+ | 概要 | 判断の目的、利用者、適用する業務場面、前提、対象外が分かる |
53
+ | 入力 | 判定に使う全入力について概念項目、利用目的、適用条件、欠損時の扱いが分かる。派生ビュー等を使う経路も含む |
54
+ | ルール(判定/計算) | 適用順、条件、結果、境界値が対応する。複数条件の優先順位、同順位・欠損時の扱いを定め、代表的な判定例を置く |
55
+ | 出力 | 正常な結果の意味、単位または区分、利用先が分かる。「対象なし」と判定不能を区別する |
56
+ | 例外 / 異常系 | 状況、判定を続けるか、結果の有無、回復のために誰が何をするかが分かる |
57
+ | メモ / 将来課題 | 未決事項の論点、下流への影響、当面の扱い、確定に必要な根拠を記し、決定後に反映する入力・規則・判定例を特定する |
78
58
 
79
59
  ## 6. 記述ガイド
80
60
 
@@ -114,17 +94,12 @@ BR は業務プロセスから呼び出される判断の正本である。BPS
114
94
 
115
95
  ### 6.6. メモ / 将来課題
116
96
 
117
- - 判断基準: 作成済みの仕様で判断できる範囲と、承認前に解消すべき論点を区別できること。意思決定の未了は `_UNDECIDED_`、確認作業の不足は `_TODO_`、仮説は `_ASSUMPTION_` で示す。
118
- - レポート引き継ぎ手順: 永続的なリスク、問題、変更要求、および決定事項は本文のラベルだけで放置せず、担当 Role code(BA / PM / ARC 等)と転送先レコード(PJR リスク登録簿 `pm-risk-register`、課題管理簿 `pm-issue-log`、変更要求ログ `pm-change-request-log`、決定記録 `pm-decision-log`、または PJR 登録項目)を明記し、PJR の共通管理手順に従って正式に起票・引き継ぎを行う。
119
- - 良い例: 「`_UNDECIDED_`: 季節別の発注点を採用するか、店主代表へ判断を依頼する。導入承認前に決める(担当: BA、転送先: `pm-decision-log`)。未決の間は季節別判定の実装・受入条件を確定できない」。
120
- - 悪い例: 「将来検討する」。依頼先、期限となる判断時点、下流の制約、引き継ぎ先レコードを追跡できない。
97
+ - 判断基準: 現行仕様で判断できる範囲と、未決のため確定できない入力・規則・判定例を区別できること。
98
+ - 良い例: 「`_UNDECIDED_`: 季節別の発注点を採用するか。採用判断と季節別の設定値を根拠に、入力の適用条件・不足判定・判定例へ反映する。未決の間は季節別判定の実装・受入条件を確定できない」。
99
+ - 悪い例: 「将来検討する」。論点、下流への影響、確定に必要な根拠が分からない。
121
100
 
122
101
  ## 7. 禁止事項
123
102
 
124
103
  - 業務プロセスの手順、画面操作、物理テーブル、SQL、実装クラスを BR の判断規則として持ち込まない。
125
- - schema やリファレンスにある値・構文・構造の一覧を転記して別の正本を作らない。
126
104
  - 複数の BR に同じ規則を複写しない。独立した判断は責務を分け、文書 ID で参照する。
127
105
  - 不明な既定値、欠損時の順位、例外時の継続可否を推測で確定しない。未決事項を通常の判定例の期待値として扱わない。
128
- - 未定義の略語や、根拠のない「適切に」「必要に応じて」で判定条件を代替しない。
129
- - `deprecated` の BR を有効な BPS や新規文書から参照しない。
130
- - 参照元 BPS、実装コード、テスト仕様への波及影響を確認・追従せずに BR を改訂または廃止しない。
@@ -21,30 +21,15 @@ Mermaid の `classDiagram` で主キーと関連を表し、業務データ辞
21
21
 
22
22
  ## 1. 全体方針
23
23
 
24
- - BA・業務担当者が対象概念と関連の意味を合意し、ARC・DEV が設計の入力、QE が整合性検証の入力として使えることを必須とします。
25
- - クラスの属性は主キー(PK)のみとし、そのほかの属性は BDD に委ねます。型・可視性・メソッドなどの実装詳細は対象外です。
24
+ - 対象概念と関連の意味を業務の言葉で合意でき、設計と整合性検証の入力として使えることを必須とします。
25
+ - クラスの属性は主キー(PK)のみとし、そのほかの属性は BDD に委ねます。
26
26
  - 図は関係種別・役割名・多重度を示し、本文はその業務上の根拠と成立条件を補います。線を文章でなぞるだけの説明は置きません。
27
27
  - 対象領域と、初期状態・確定後など図が扱う時点を定めます。同じ関係でも状態によって必要数が異なる場合は、適用条件を本文で区別します。
28
+ - **共通の運用**: 役割の割り当ては適用先のメンバー定義に、`status` の昇格と承認、改訂と廃止、未決事項の登録簿への引き継ぎは [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] に従い、本書と成果物で言い直しません。文書の整形・lint はリポジトリの検証で扱い、成果物の業務の検証に含めません。
28
29
 
29
- ## 2. 位置づけと用語定義
30
+ ## 2. 位置づけ
30
31
 
31
- ### 2.1. 成果物としての位置づけ
32
-
33
- CCD は業務仕様のデータモデルを扱い、BDD はエンティティの属性の業務的意味を扱います。BDD の記述責務は [[specdojo:bdd-rulebook|業務データ辞書 作成ルール]] に従い、値・型・構造の詳細は BDD が参照する schema・型定義・リファレンスを正本とします。
34
-
35
- メタ情報とリンクの共通規約は [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]]、配置・命名の共通事項は [[specdojo:docs-structure-guide|ドキュメント構成ガイド]] を正本とし、本書では CCD 固有の判断だけを定めます。
36
-
37
- ### 2.2. 用語定義
38
-
39
- | 用語 | 定義 |
40
- | -------------------------- | -------------------------------------------------------------------------------------------- |
41
- | エンティティ(概念クラス) | 業務上管理すべき独立した概念のまとまり。CCD ではクラスとして表現する |
42
- | 主キー(PK) | エンティティの各インスタンスを一意に識別する属性。CCD に記載する唯一の属性 |
43
- | 継承関係(is-a) | 上位概念(汎化)と下位概念(特化)の階層関係。下位は上位の性質を引き継ぐ |
44
- | 親子関係(part-of) | 業務上の所有・構造。子は親のまとまりに属して成立する。物理ファイルの削除連動とは別に判断する |
45
- | 参照関係(reference) | 対象を別の管理単位として追跡し、所属の変更と対象の廃棄を分けて判断できる関係 |
46
- | 役割名(関係名) | 接続線が表す業務上の関係の意味(例: `構成する`、`参照する`、`種類`) |
47
- | 多重度 | 関連するエンティティのインスタンス数の制約(例: `1`、`0..1`、`1..*`、`0..*`) |
32
+ CCD は業務仕様のデータモデルを扱い、属性の業務的意味は BDD([[specdojo:bdd-rulebook|業務データ辞書 作成ルール]])、値・型・構造の詳細は BDD が参照する schema・型定義・リファレンスを正本とします。配置・命名の共通事項は [[specdojo:docs-structure-guide|ドキュメント構成ガイド]] に従います。
48
33
 
49
34
  ## 3. ファイル命名・ID規則
50
35
 
@@ -54,25 +39,20 @@ CCD は業務仕様のデータモデルを扱い、BDD はエンティティの
54
39
 
55
40
  ## 4. 推奨 Frontmatter 項目
56
41
 
57
- 必須項目・許可キー・型はドキュメントメタ情報標準と `docs/specdojo/schemas/v1/deliverable-frontmatter.schema.yaml` に従い、`specdojo:` 配下に記述します。
58
-
59
42
  - `type` は `data`、`rulebook` は `specdojo:ccd-mermaid-rulebook` とします。
60
- - `based_on` には、実際に読み直接の根拠とした作成済み辞書を記録します。カタログがある場合は `depends_on` の推移閉包内に限定し、未作成辞書や単なる参照候補を追加しません。直接の根拠がなければ省略できます。
61
- - 成果物の依存はカタログの `depends_on` に置き、CCD の Frontmatter には追加しません。`based_on` を依存一覧の代用にしません。
43
+ - `based_on` には、実際に読み直接の根拠とした作成済み辞書を記録します。カタログがある場合は `depends_on` の推移閉包内に限定し、未作成辞書や単なる参照候補を追加しません。直接の根拠がなければ省略できます。成果物の依存はカタログの `depends_on` に置き、`based_on` を依存一覧の代用にしません。
62
44
 
63
45
  ## 5. 本文要件
64
46
 
65
47
  CCD 成果物(`ccd-<term>.md`)は以下の章構成を標準とします。
66
48
 
67
- | 章番号 | 章タイトル | 必須 | 内容・受入条件 |
68
- | ------ | ---------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------ |
69
- | 1 | 目的と適用範囲 | 必須 | 利用目的、対象領域・対象外、扱う時点を示す。領域の境界や規則は正本へ参照できること |
70
- | 2 | 概念クラス図 | 必須 | Mermaid `classDiagram` に概念・主キー・関連を示す。継承したキーや抽象概念など、図だけでは誤解する点は短く補足すること |
71
- | 3 | 関連定義と多重度の根拠 | 必須 | 図中の全関連を表で網羅し、両端の必要数、関係種別、役割名を業務上の理由から説明できること |
72
- | 4 | 参照業務データ辞書 | 必須 | 全エンティティと辞書の対応、主キーの対応名・識別範囲を示す。未作成・未照合を区別すること |
73
- | 5 | 未解決事項 | 条件付き | 未作成辞書・根拠不足・文書間矛盾がある場合は必須。影響、現在の扱い、解消責務・確認条件を示す。なければ省略または「なし」とする |
74
-
75
- 各章の見出しは `## 1.` から連番とし、小節にも階層ごとの連番を付けます。
49
+ | 章番号 | 章タイトル | 必須 | 内容・受入条件 |
50
+ | ------ | ---------------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------- |
51
+ | 1 | 目的と適用範囲 | 必須 | 利用目的、対象領域・対象外、扱う時点を示す。領域の境界や規則は正本へ参照できること |
52
+ | 2 | 概念クラス図 | 必須 | Mermaid `classDiagram` に概念・主キー・関連を示す。継承したキーや抽象概念など、図だけでは誤解する点は短く補足すること |
53
+ | 3 | 関連定義と多重度の根拠 | 必須 | 図中の全関連を表で網羅し、両端の必要数、関係種別、役割名を業務上の理由から説明できること |
54
+ | 4 | 参照業務データ辞書 | 必須 | 全エンティティと辞書の対応、主キーの対応名・識別範囲を示す。未作成・未照合を区別すること |
55
+ | 5 | 未解決事項 | 条件付き | 未作成辞書・根拠不足・文書間矛盾がある場合は必須。論点、影響と当面の扱い、解消時に直す箇所を示す。なければ省略または「なし」とする |
76
56
 
77
57
  ## 6. 記述ガイド
78
58
 
@@ -100,7 +80,7 @@ CCD 成果物(`ccd-<term>.md`)は以下の章構成を標準とします。
100
80
 
101
81
  #### 6.2.2. 関係種別と役割名
102
82
 
103
- 次の三種を使い分けます。全線に短い日本語の役割名を付け、親子・参照の両端には引用符付きの多重度を必須とします。継承には多重度を付けません。
83
+ 次の三種を使い分けます。全線に短い日本語の役割名を付け、親子・参照の両端には引用符付きの多重度を付けます。
104
84
 
105
85
  | 関係種別・記法 | 選ぶ基準 | 良い例 | 悪い例 |
106
86
  | ------------------ | ---------------------------------------- | ---------------------------------------- | -------------------------------------------------- |
@@ -110,6 +90,17 @@ CCD 成果物(`ccd-<term>.md`)は以下の章構成を標準とします。
110
90
 
111
91
  同じクラス間の複数の関連や自己関連は、役割名で意味を区別します。例えば登録項目の「起票元をたどる」と「先行項目の完了を必要とする」は別の関連です。「関連」「リンク」だけのラベルや、起票元から実行順序を推測する表現では区別できません。
112
92
 
93
+ #### 6.2.3. 図の向き
94
+
95
+ - 既定は上→下とし、`direction` を書かないか `direction TB` とします。継承・親子では親を上、子を下に置きます。
96
+ - 関連の連なりが長く、横に並べた方が読みやすい場合だけ `direction LR` とし、その理由を図の直後の本文に書きます。
97
+ - 線の交差や重なりで読めない場合は、向きを変える前にクラスの宣言や関連の順番を並べ替えます。
98
+
99
+ | 判断の基準 | 良い例 | 悪い例 |
100
+ | ---------------------- | -------------------------------------------------------------------- | ---------------------------------------------- |
101
+ | 既定の向きにそろえる | `direction` を書かず、商品の下にお菓子・玩具を置く | 理由を書かずに `direction LR` とする |
102
+ | 例外の理由を本文に示す | 「工程の連なりが長く縦では収まらないため LR とする」と図の直後に書く | 図ごとに向きが異なり、読み手が理由をたどれない |
103
+
113
104
  ### 6.3. 関連定義と多重度の根拠
114
105
 
115
106
  関連表は次のカラムを持ちます。起点・先が同じ関連も、役割名ごとに一行を設けます。
@@ -132,64 +123,38 @@ CCD 成果物(`ccd-<term>.md`)は以下の章構成を標準とします。
132
123
 
133
124
  ### 6.4. 参照業務データ辞書
134
125
 
135
- - 対応表は「エンティティ」「主キーの対応」「参照先業務データ辞書」を持ちます。キーを継承する下位概念はまとめて記載できますが、図の全クラスを照合できることを必須とします。
126
+ - 対応表は「エンティティ」「主キーの対応」「参照先業務データ辞書」を持ちます。キーを継承する下位概念はまとめて記載でき、図の全クラスを照合できることを必須とします。
136
127
  - キーの対応には BDD のフィールド名と、全体・project 内・親の内部など識別範囲を示します。図の日本語名と辞書の物理名が異なる場合に対応を省きません。
137
128
  - 作成済み辞書は project 修飾 ID のリンク、未作成辞書は予定 ID のコード表記と「未作成」で示します。未作成・未読の辞書を確認済みの根拠にはしません。
138
129
 
139
130
  | 判断の基準 | 良い例 | 悪い例 |
140
131
  | ------------------------ | --------------------------------------------------------------- | ----------------------------------------------- |
141
132
  | 識別範囲を追跡できる | 「成果物定義は project の識別子と `local_id` で識別する」 | `local_id` が全 project で一意と読み取れる記載 |
142
- | 未作成を未照合として扱う | 予定 ID に「未作成」を添え、未解決事項に照合担当と条件を残す | 存在しない辞書へリンクし、属性の一致を断定する |
133
+ | 未作成を未照合として扱う | 予定 ID に「未作成」を添え、未解決事項に照合の条件を残す | 存在しない辞書へリンクし、属性の一致を断定する |
143
134
  | 定義の正本を一つに保つ | 対応名だけを示し、属性の意味・許容値は BDD とその参照先に委ねる | schema のキー一覧・構文・制約を対応表に複写する |
144
135
 
145
136
  ### 6.5. 未解決事項
146
137
 
147
- | 判断の基準 | 良い例 | 悪い例 |
148
- | ---------------------------- | ------------------------------------------------------------------ | ---------------------------------------------------------------- |
149
- | 不足根拠と影響を限定する | 「未作成辞書とのキー対応は未照合。図には主キー以外を追加しない」 | 不足を隠して「すべて整合」とする |
150
- | 次に誰が何を確認するかを示す | 「辞書作成後に BA が名称・識別範囲・関連を照合する」 | 「後で確認」のみ |
151
- | 矛盾・未確認・乖離を区別する | 文書 ID と相反する記述を示し、現時点で採用する根拠と確認責務を記す | 調査対象がコマンド入口だけなのに実装全体との一致・乖離を断定する |
152
-
153
- 未確定の前提・判断はドキュメントメタ情報標準の共通ラベルで区別します。解消した論点は本文へ反映し、未解決事項として残し続けません。
154
-
155
- ### 6.6. 検証と改訂時の確認
156
-
157
- 成果物を作成・改訂した際は、機械検証(静的検査)と手動照合の両方で判定します。
158
-
159
- #### 6.6.1. 静的検査の手順とコマンド
160
-
161
- 作成先リポジトリに設定された Markdown・Frontmatter・Mermaid の静的検査を実施します。SpecDojo 同梱リポジトリでの実行コマンド例を以下に示します。移行先リポジトリに同等の検証コマンドが定義されている場合は、その設定に従い相当するコマンドを実行できます。
162
-
163
- ```bash
164
- # Markdown 構文・スタイルの検査
165
- npm run lint:md
166
-
167
- # Frontmatter の構造・メタデータ検査
168
- npm run lint:fm
138
+ | 判断の基準 | 良い例 | 悪い例 |
139
+ | ---------------------------- | -------------------------------------------------------------------- | ---------------------------------------------------------------- |
140
+ | 不足根拠と影響を限定する | 「未作成辞書とのキー対応は未照合。図には主キー以外を追加しない」 | 不足を隠して「すべて整合」とする |
141
+ | 解消時に直す箇所を示す | 「辞書作成後に名称・識別範囲を照合し、対応表と関連表を直す」 | 「後で確認」のみ |
142
+ | 矛盾・未確認・乖離を区別する | 文書 ID と相反する記述を示し、現時点で採用する根拠と確認の条件を記す | 調査対象がコマンド入口だけなのに実装全体との一致・乖離を断定する |
169
143
 
170
- # Mermaid 構文の検査
171
- npm run lint:mermaid
172
- ```
144
+ 未確定の前提・判断は共通ラベル(`_ASSUMPTION_`・`_UNDECIDED_`)で区別します。解消した論点は本文へ反映し、未解決事項として残し続けません。
173
145
 
174
- - **期待結果**: 各静的検査がエラーなく終了コード 0 で完了すること。個別ファイルを対象とする場合は、各ツールにファイルパスを渡して実行します。
175
- - **検証の限界**: 構文検査の合格だけで、キーや多重度の業務上の妥当性を確認済みとしません。以下の手動照合とあわせて合否を判定します。
146
+ ### 6.6. 整合性の照合と改訂時の確認
176
147
 
177
- #### 6.6.2. 整合性の手動照合と改訂時の確認
148
+ キーや多重度の業務上の妥当性は、構文検査ではなく次の照合で判定します。
178
149
 
179
150
  - 図の全クラスと辞書対応表、全関連と根拠表を突き合わせ、名前・向き・種別・役割名・多重度が一致することを確認します。多重度は両方向から読み、最小数と上限を業務条件に照らします。
180
151
  - BDD のキー・識別範囲、業務フローや業務規則の変更時は、該当するクラスと関連の根拠を再確認します。実装との照合を行う場合は、確認した範囲と不足根拠を分けて記録します。
181
- - 公開前に BA・ARC が業務上の根拠と辞書との対応、QE が検証可能性を確認します。人間の PO が未解決事項の影響も含めて公開可否を最終判断し、agent は `ready` への昇格を行いません。
182
152
 
183
153
  ## 7. 禁止事項
184
154
 
185
- 以下の記述は概念クラス図のルールに反するため **禁止** します。
186
-
187
- - **主キー以外の属性の記述**: 名称・金額・日付・状態などの一般属性を含めること(業務データ辞書 bdd を参照すること)。
188
- - **メソッドの記述**: `calculateTotal()`、`updateStatus()` などの操作・メソッド定義を含めること(例外なく全面禁止)。
189
- - **型・可視性の記述**: `+`, `-`, `#` や `string`, `number` などの言語・実装依存の型定義。
190
- - **実装・技術的要素の記述**: `created_at`、`updated_at`、`is_deleted` 等のシステム管理カラムや DTO のクラス化、schema・リファレンスの値・構文・構造詳細の再掲。
191
- - **関係線ラベルの省略・曖昧語**: ラベル未記載、または「関係」「リンク」などの意味不明なラベル。
192
- - **多重度の省略**: 親子関係・参照関係において多重度を記載しないこと。
193
- - **継承関係への多重度付与**: 継承関係(is-a)に多重度を付けること。
194
- - **継承記法の配置逆転**: `親 <|-- 子` の方向を誤り、子を親として描画すること。
195
- - **過剰な継承階層**: 3 階層以上の過度な継承関係を作ること。
155
+ - **主キー以外の属性**: 名称・金額・日付・状態などの一般属性(BDD に委ねる)。
156
+ - **メソッド・型・可視性**: `calculateTotal()` などの操作、`+`・`-`・`#` や `string`・`number` などの実装依存の記法。
157
+ - **実装・技術的要素**: `created_at`・`is_deleted` 等のシステム管理カラム、DTO のクラス化、schema・リファレンスの値・構文・構造の再掲。
158
+ - **ラベルの省略・曖昧語**: 役割名の未記載、「関係」「リンク」だけのラベル。
159
+ - **多重度の誤り**: 親子・参照での省略、継承への付与。
160
+ - **継承の逆転・過剰な階層**: `親 <|-- 子` の向きを誤ること、3 階層以上の継承。