specdojo 0.8.0 → 0.9.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (284) hide show
  1. package/.github/agents/specdojo-orchestrator.md +4 -1
  2. package/CHANGELOG.md +64 -0
  3. package/dist/catalog/catalog.js +16 -14
  4. package/dist/commands/agent.js +5 -3
  5. package/dist/commands/build.js +69 -10
  6. package/dist/commands/git.js +206 -0
  7. package/dist/commands/init.js +4 -2
  8. package/dist/commands/where.js +25 -0
  9. package/dist/dashboard/dashboard.js +5 -3
  10. package/dist/dashboard/routines.js +4 -7
  11. package/dist/dashboard/timeline.js +14 -14
  12. package/dist/docs/index-command.js +2 -2
  13. package/dist/docs/yaml-business-tables.js +243 -0
  14. package/dist/docs/yaml-interface-tables.js +106 -0
  15. package/dist/docs/yaml-pages-command.js +5 -3
  16. package/dist/docs/yaml-pages.js +146 -3
  17. package/dist/docs/yaml-table-shared.js +70 -0
  18. package/dist/docs/yaml-tables.js +39 -0
  19. package/dist/exec/agent-config.js +9 -0
  20. package/dist/exec/agent-protected-config.js +2 -0
  21. package/dist/exec/commands.js +31 -18
  22. package/dist/exec/events.js +34 -14
  23. package/dist/exec/evidence.js +13 -3
  24. package/dist/exec/parent-validation.js +56 -3
  25. package/dist/exec/plans-core.js +21 -2
  26. package/dist/exec/plans-generation.js +6 -7
  27. package/dist/exec/post-integration.js +162 -0
  28. package/dist/exec/queue-command.js +166 -0
  29. package/dist/exec/queue.js +285 -0
  30. package/dist/exec/register-foreign-wait.js +84 -0
  31. package/dist/exec/repo-integration-sync.js +17 -5
  32. package/dist/exec/reporter.js +2 -2
  33. package/dist/exec/results.js +24 -4
  34. package/dist/exec/review-kata.js +4 -1
  35. package/dist/exec/run/agent-pipeline.js +3 -2
  36. package/dist/exec/run/agent.js +12 -6
  37. package/dist/exec/run/change-scope.js +365 -0
  38. package/dist/exec/run/deferred-cleanup.js +31 -0
  39. package/dist/exec/run/in-place.js +4 -1
  40. package/dist/exec/run/job-lock.js +66 -0
  41. package/dist/exec/run/job-sequence.js +137 -0
  42. package/dist/exec/run/job.js +56 -19
  43. package/dist/exec/run/lifecycle-commands.js +1 -1
  44. package/dist/exec/run/lock.js +22 -1
  45. package/dist/exec/run/register-command.js +8 -5
  46. package/dist/exec/run/register-mode.js +68 -8
  47. package/dist/exec/run/register-resume.js +68 -14
  48. package/dist/exec/run/register-state.js +13 -8
  49. package/dist/exec/run/register-worktree.js +140 -125
  50. package/dist/exec/run/schedule-mode.js +75 -14
  51. package/dist/exec/run/schedule-prepare.js +3 -0
  52. package/dist/exec/run/schedule-task.js +88 -38
  53. package/dist/exec/run/shared.js +5 -0
  54. package/dist/exec/schedule/schedule.js +116 -4
  55. package/dist/exec/shared.js +1 -1
  56. package/dist/exec/smoke.js +190 -0
  57. package/dist/exec/strategy.js +13 -3
  58. package/dist/exec/task-view.js +6 -4
  59. package/dist/exec/trial-commands.js +5 -2
  60. package/dist/exec/trial-core.js +6 -1
  61. package/dist/exec/validation-metrics.js +181 -0
  62. package/dist/exec/worktree-cleanup-lock.js +26 -0
  63. package/dist/exec/worktree-command.js +9 -1
  64. package/dist/exec/worktree-ops-commit.js +2 -2
  65. package/dist/exec/worktree.js +13 -2
  66. package/dist/grade/command-apply.js +3 -3
  67. package/dist/grade/command-inspect.js +5 -3
  68. package/dist/grade/command-plan.js +1 -1
  69. package/dist/grade/command-run.js +5 -1
  70. package/dist/grade/run.js +64 -8
  71. package/dist/job/definition.js +84 -8
  72. package/dist/job/job.js +79 -23
  73. package/dist/register/authoring-sources.js +22 -16
  74. package/dist/register/maintenance-commands.js +2 -2
  75. package/dist/register/register.js +31 -7
  76. package/dist/routine/definition.js +9 -0
  77. package/dist/routine/routine.js +137 -43
  78. package/dist/routine/status.js +62 -0
  79. package/dist/schedule/schedule.js +38 -39
  80. package/dist/shared/agent-types.js +5 -0
  81. package/dist/shared/cross-process-lock.js +9 -1
  82. package/dist/shared/dist-freshness.js +8 -2
  83. package/dist/shared/git-environment.js +2 -1
  84. package/dist/shared/git.js +44 -1
  85. package/dist/shared/lefthook-scaffold.js +3 -0
  86. package/dist/shared/local-config.js +244 -0
  87. package/dist/shared/specdojo-config.js +34 -20
  88. package/dist/shared/specdojo-gitignore.js +1 -0
  89. package/dist/shared/text.js +9 -1
  90. package/dist/shared/where-alias.js +13 -0
  91. package/dist/specdojo.js +4 -0
  92. package/docs/ja/specdojo/defaults/pm-review-viewpoints.yaml +2 -0
  93. package/docs/ja/specdojo/guides/exec-config-guide.md +23 -4
  94. package/docs/ja/specdojo/guides/exec-operation-guide.md +44 -1
  95. package/docs/ja/specdojo/guides/job-sequence-guide.md +77 -0
  96. package/docs/ja/specdojo/guides/quick-start-guide.md +3 -3
  97. package/docs/ja/specdojo/guides/register-operation-guide.md +1 -1
  98. package/docs/ja/specdojo/guides/routine-operation-guide.md +11 -6
  99. package/docs/ja/specdojo/guides/schedule-design-guide.md +20 -17
  100. package/docs/ja/specdojo/guides/waza-guide.md +12 -8
  101. package/docs/ja/specdojo/recipes/bac-recipe.md +66 -49
  102. package/docs/ja/specdojo/recipes/bes-recipe.md +90 -54
  103. package/docs/ja/specdojo/recipes/bps-recipe.md +88 -139
  104. package/docs/ja/specdojo/recipes/br-recipe.md +40 -47
  105. package/docs/ja/specdojo/recipes/cdfd-overview-recipe.md +97 -109
  106. package/docs/ja/specdojo/recipes/cdfd-recipe.md +85 -146
  107. package/docs/ja/specdojo/recipes/cdfd-uc-recipe.md +91 -110
  108. package/docs/ja/specdojo/recipes/cnd-recipe.md +79 -69
  109. package/docs/ja/specdojo/recipes/cpd-recipe.md +78 -64
  110. package/docs/ja/specdojo/recipes/cxd-recipe.md +92 -75
  111. package/docs/ja/specdojo/recipes/ifd-recipe.md +79 -68
  112. package/docs/ja/specdojo/recipes/ifx-cmd-recipe.md +78 -105
  113. package/docs/ja/specdojo/recipes/ifx-index-recipe.md +105 -71
  114. package/docs/ja/specdojo/recipes/pm-communication-plan-recipe.md +60 -49
  115. package/docs/ja/specdojo/recipes/pm-members-recipe.md +50 -51
  116. package/docs/ja/specdojo/recipes/pm-organization-recipe.md +59 -51
  117. package/docs/ja/specdojo/recipes/pm-plan-recipe.md +69 -56
  118. package/docs/ja/specdojo/recipes/pm-quality-management-plan-recipe.md +37 -56
  119. package/docs/ja/specdojo/recipes/pm-raci-recipe.md +39 -53
  120. package/docs/ja/specdojo/recipes/pm-roles-recipe.md +52 -79
  121. package/docs/ja/specdojo/recipes/prj-assumptions-constraints-dependencies-recipe.md +64 -93
  122. package/docs/ja/specdojo/recipes/prj-charter-recipe.md +71 -106
  123. package/docs/ja/specdojo/recipes/prj-comparison-of-alternatives-recipe.md +78 -157
  124. package/docs/ja/specdojo/recipes/prj-issues-and-approach-recipe.md +62 -111
  125. package/docs/ja/specdojo/recipes/prj-scope-recipe.md +67 -123
  126. package/docs/ja/specdojo/recipes/prj-stakeholder-register-recipe.md +60 -96
  127. package/docs/ja/specdojo/recipes/prj-success-criteria-and-acceptance-criteria-recipe.md +61 -105
  128. package/docs/ja/specdojo/recipes/stsd-recipe.md +79 -109
  129. package/docs/ja/specdojo/recipes/sysd-critical-flows-recipe.md +78 -55
  130. package/docs/ja/specdojo/recipes/sysd-cross-cutting-policy-recipe.md +82 -73
  131. package/docs/ja/specdojo/recipes/sysd-index-recipe.md +78 -59
  132. package/docs/ja/specdojo/recipes/tsd-recipe.md +149 -129
  133. package/docs/ja/specdojo/references/command-reference.md +257 -117
  134. package/docs/ja/specdojo/references/deliverables-reference.md +21 -12
  135. package/docs/ja/specdojo/references/specdojo-config-reference.md +37 -2
  136. package/docs/ja/specdojo/rulebooks/atc-index-rulebook.md +101 -257
  137. package/docs/ja/specdojo/rulebooks/atc-rulebook.md +102 -228
  138. package/docs/ja/specdojo/rulebooks/bac-rulebook.md +19 -28
  139. package/docs/ja/specdojo/rulebooks/bdd-rulebook.md +16 -67
  140. package/docs/ja/specdojo/rulebooks/bds-rulebook.md +30 -51
  141. package/docs/ja/specdojo/rulebooks/bes-index-rulebook.md +41 -61
  142. package/docs/ja/specdojo/rulebooks/bes-rulebook.md +22 -50
  143. package/docs/ja/specdojo/rulebooks/bps-rulebook.md +24 -56
  144. package/docs/ja/specdojo/rulebooks/br-rulebook.md +13 -38
  145. package/docs/ja/specdojo/rulebooks/ccd-mermaid-rulebook.md +41 -76
  146. package/docs/ja/specdojo/rulebooks/cdfd-d2-rulebook.md +18 -93
  147. package/docs/ja/specdojo/rulebooks/cdfd-mermaid-rulebook.md +18 -52
  148. package/docs/ja/specdojo/rulebooks/cdfd-overview-rulebook.md +109 -147
  149. package/docs/ja/specdojo/rulebooks/cdfd-rulebook.md +80 -108
  150. package/docs/ja/specdojo/rulebooks/cdfd-uc-rulebook.md +21 -46
  151. package/docs/ja/specdojo/rulebooks/cdr-rulebook.md +144 -0
  152. package/docs/ja/specdojo/rulebooks/cdsd-rulebook.md +27 -48
  153. package/docs/ja/specdojo/rulebooks/cdt-rulebook.md +37 -50
  154. package/docs/ja/specdojo/rulebooks/clis-rulebook.md +52 -69
  155. package/docs/ja/specdojo/rulebooks/cnd-mermaid-rulebook.md +33 -86
  156. package/docs/ja/specdojo/rulebooks/cnd-rulebook.md +16 -32
  157. package/docs/ja/specdojo/rulebooks/cop-index-rulebook.md +45 -131
  158. package/docs/ja/specdojo/rulebooks/cop-rulebook.md +69 -275
  159. package/docs/ja/specdojo/rulebooks/cpd-mermaid-rulebook.md +20 -112
  160. package/docs/ja/specdojo/rulebooks/cpd-rulebook.md +23 -56
  161. package/docs/ja/specdojo/rulebooks/cxd-mermaid-rulebook.md +12 -145
  162. package/docs/ja/specdojo/rulebooks/cxd-rulebook.md +39 -47
  163. package/docs/ja/specdojo/rulebooks/dct-index-rulebook.md +37 -56
  164. package/docs/ja/specdojo/rulebooks/dct-rulebook.md +118 -175
  165. package/docs/ja/specdojo/rulebooks/dec-rulebook.md +5 -14
  166. package/docs/ja/specdojo/rulebooks/dmd-index-rulebook.md +22 -66
  167. package/docs/ja/specdojo/rulebooks/dmd-rulebook.md +36 -94
  168. package/docs/ja/specdojo/rulebooks/dss-rulebook.md +59 -81
  169. package/docs/ja/specdojo/rulebooks/etc-index-rulebook.md +31 -131
  170. package/docs/ja/specdojo/rulebooks/etc-rulebook.md +50 -104
  171. package/docs/ja/specdojo/rulebooks/gl-rulebook.md +51 -61
  172. package/docs/ja/specdojo/rulebooks/ifd-mermaid-rulebook.md +38 -45
  173. package/docs/ja/specdojo/rulebooks/ifx-api-rulebook.md +14 -20
  174. package/docs/ja/specdojo/rulebooks/ifx-cmd-rulebook.md +26 -38
  175. package/docs/ja/specdojo/rulebooks/ifx-file-rulebook.md +26 -107
  176. package/docs/ja/specdojo/rulebooks/ifx-index-rulebook.md +42 -49
  177. package/docs/ja/specdojo/rulebooks/ifx-msg-rulebook.md +14 -22
  178. package/docs/ja/specdojo/rulebooks/imp-business-rulebook.md +21 -44
  179. package/docs/ja/specdojo/rulebooks/imp-data-rulebook.md +41 -64
  180. package/docs/ja/specdojo/rulebooks/imp-interface-rulebook.md +14 -38
  181. package/docs/ja/specdojo/rulebooks/imp-operations-rulebook.md +34 -61
  182. package/docs/ja/specdojo/rulebooks/imp-test-rulebook.md +27 -50
  183. package/docs/ja/specdojo/rulebooks/itc-index-rulebook.md +70 -199
  184. package/docs/ja/specdojo/rulebooks/itc-rulebook.md +65 -153
  185. package/docs/ja/specdojo/rulebooks/mip-index-rulebook.md +74 -150
  186. package/docs/ja/specdojo/rulebooks/mm-rulebook.md +11 -23
  187. package/docs/ja/specdojo/rulebooks/mtp-rulebook.md +99 -176
  188. package/docs/ja/specdojo/rulebooks/nfr-availability-rulebook.md +35 -61
  189. package/docs/ja/specdojo/rulebooks/nfr-index-rulebook.md +75 -117
  190. package/docs/ja/specdojo/rulebooks/nfr-integrity-rulebook.md +31 -60
  191. package/docs/ja/specdojo/rulebooks/nfr-maintainability-rulebook.md +26 -81
  192. package/docs/ja/specdojo/rulebooks/nfr-operations-rulebook.md +32 -70
  193. package/docs/ja/specdojo/rulebooks/nfr-performance-rulebook.md +45 -87
  194. package/docs/ja/specdojo/rulebooks/nfr-reliability-rulebook.md +48 -101
  195. package/docs/ja/specdojo/rulebooks/nfr-security-safety-rulebook.md +44 -80
  196. package/docs/ja/specdojo/rulebooks/nfr-usability-rulebook.md +59 -127
  197. package/docs/ja/specdojo/rulebooks/opd-index-rulebook.md +31 -50
  198. package/docs/ja/specdojo/rulebooks/opd-rulebook.md +42 -109
  199. package/docs/ja/specdojo/rulebooks/opr-index-rulebook.md +29 -42
  200. package/docs/ja/specdojo/rulebooks/opr-rulebook.md +29 -87
  201. package/docs/ja/specdojo/rulebooks/otp-index-rulebook.md +62 -84
  202. package/docs/ja/specdojo/rulebooks/otp-rulebook.md +11 -61
  203. package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +91 -106
  204. package/docs/ja/specdojo/rulebooks/pm-change-request-log-rulebook.md +25 -34
  205. package/docs/ja/specdojo/rulebooks/pm-communication-plan-rulebook.md +30 -53
  206. package/docs/ja/specdojo/rulebooks/pm-issue-log-rulebook.md +23 -35
  207. package/docs/ja/specdojo/rulebooks/pm-members-rulebook.md +27 -45
  208. package/docs/ja/specdojo/rulebooks/pm-organization-rulebook.md +37 -45
  209. package/docs/ja/specdojo/rulebooks/pm-plan-rulebook.md +45 -46
  210. package/docs/ja/specdojo/rulebooks/pm-quality-management-plan-rulebook.md +37 -48
  211. package/docs/ja/specdojo/rulebooks/pm-raci-rulebook.md +25 -29
  212. package/docs/ja/specdojo/rulebooks/pm-risk-register-rulebook.md +28 -35
  213. package/docs/ja/specdojo/rulebooks/pm-roles-rulebook.md +36 -41
  214. package/docs/ja/specdojo/rulebooks/pr-rulebook.md +5 -18
  215. package/docs/ja/specdojo/rulebooks/prj-assumptions-constraints-dependencies-rulebook.md +16 -37
  216. package/docs/ja/specdojo/rulebooks/prj-charter-rulebook.md +23 -97
  217. package/docs/ja/specdojo/rulebooks/prj-comparison-of-alternatives-rulebook.md +39 -57
  218. package/docs/ja/specdojo/rulebooks/prj-issues-and-approach-rulebook.md +43 -116
  219. package/docs/ja/specdojo/rulebooks/prj-scope-rulebook.md +16 -51
  220. package/docs/ja/specdojo/rulebooks/prj-stakeholder-register-rulebook.md +47 -92
  221. package/docs/ja/specdojo/rulebooks/prj-success-criteria-and-acceptance-criteria-rulebook.md +25 -84
  222. package/docs/ja/specdojo/rulebooks/sac-rulebook.md +44 -107
  223. package/docs/ja/specdojo/rulebooks/sf-index-rulebook.md +39 -49
  224. package/docs/ja/specdojo/rulebooks/sf-rulebook.md +42 -49
  225. package/docs/ja/specdojo/rulebooks/sld-rulebook.md +64 -89
  226. package/docs/ja/specdojo/rulebooks/stc-index-rulebook.md +90 -189
  227. package/docs/ja/specdojo/rulebooks/stc-rulebook.md +45 -105
  228. package/docs/ja/specdojo/rulebooks/stsd-mermaid-rulebook.md +6 -12
  229. package/docs/ja/specdojo/rulebooks/stsd-rulebook.md +49 -68
  230. package/docs/ja/specdojo/rulebooks/sysd-critical-flows-rulebook.md +51 -60
  231. package/docs/ja/specdojo/rulebooks/sysd-cross-cutting-policy-rulebook.md +46 -50
  232. package/docs/ja/specdojo/rulebooks/sysd-index-rulebook.md +39 -64
  233. package/docs/ja/specdojo/rulebooks/sysd-rulebook.md +47 -60
  234. package/docs/ja/specdojo/rulebooks/trc-requirements-to-specs-rulebook.md +69 -70
  235. package/docs/ja/specdojo/rulebooks/trc-requirements-to-tests-rulebook.md +65 -72
  236. package/docs/ja/specdojo/rulebooks/tsd-index-rulebook.md +35 -46
  237. package/docs/ja/specdojo/rulebooks/tsd-rulebook.md +49 -66
  238. package/docs/ja/specdojo/rulebooks/tsp-index-rulebook.md +64 -139
  239. package/docs/ja/specdojo/rulebooks/uis-rulebook.md +41 -108
  240. package/docs/ja/specdojo/rulebooks/utc-index-rulebook.md +49 -144
  241. package/docs/ja/specdojo/rulebooks/utc-rulebook.md +67 -155
  242. package/docs/ja/specdojo/samples/bds-sample.md +58 -71
  243. package/docs/ja/specdojo/samples/bes-index-sample.md +20 -37
  244. package/docs/ja/specdojo/samples/bes-sample.md +43 -53
  245. package/docs/ja/specdojo/samples/bps-sample.md +42 -54
  246. package/docs/ja/specdojo/samples/br-sample.md +40 -52
  247. package/docs/ja/specdojo/samples/ccd-sample.md +0 -1
  248. package/docs/ja/specdojo/samples/cdr-sample.md +78 -0
  249. package/docs/ja/specdojo/samples/cdsd-sample.md +47 -63
  250. package/docs/ja/specdojo/samples/clis-sample.md +70 -77
  251. package/docs/ja/specdojo/samples/dec-sample.md +2 -3
  252. package/docs/ja/specdojo/samples/ifx-api-sample.yaml +0 -2
  253. package/docs/ja/specdojo/samples/ifx-msg-sample.yaml +0 -2
  254. package/docs/ja/specdojo/samples/job-sequence.yaml +67 -0
  255. package/docs/ja/specdojo/samples/mip-index-sample.md +98 -20
  256. package/docs/ja/specdojo/samples/pm-communication-plan-sample.md +26 -19
  257. package/docs/ja/specdojo/samples/pm-organization-sample.md +39 -50
  258. package/docs/ja/specdojo/samples/pm-plan-sample.md +61 -67
  259. package/docs/ja/specdojo/samples/pm-quality-management-plan-sample.md +31 -45
  260. package/docs/ja/specdojo/samples/pm-raci-sample.md +31 -37
  261. package/docs/ja/specdojo/samples/prj-assumptions-constraints-dependencies-sample.md +32 -48
  262. package/docs/ja/specdojo/samples/prj-charter-sample.md +42 -59
  263. package/docs/ja/specdojo/samples/prj-comparison-of-alternatives-sample.md +55 -61
  264. package/docs/ja/specdojo/samples/prj-success-criteria-and-acceptance-criteria-sample.md +30 -33
  265. package/docs/ja/specdojo/samples/sf-index-sample.md +13 -55
  266. package/docs/ja/specdojo/samples/sf-sample.md +73 -85
  267. package/docs/ja/specdojo/samples/sld-sample.md +60 -79
  268. package/docs/ja/specdojo/samples/uis-sample.md +98 -121
  269. package/docs/ja/specdojo/standards/job-definition-standard.md +24 -9
  270. package/docs/ja/specdojo/templates/cdr-template.md +58 -0
  271. package/docs/specdojo/schemas/v1/exec-common.schema.yaml +2 -1
  272. package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +42 -5
  273. package/docs/specdojo/schemas/v1/exec-evidence.schema.yaml +35 -0
  274. package/docs/specdojo/schemas/v1/job-run.schema.yaml +23 -0
  275. package/docs/specdojo/schemas/v1/job.schema.yaml +63 -2
  276. package/docs/specdojo/schemas/v1/sch-strategy.schema.yaml +2 -2
  277. package/package.json +9 -6
  278. package/templates/antigravity/orchestrator.md +4 -1
  279. package/templates/claude/agents/specdojo-orchestrator.md +4 -1
  280. package/templates/codex/agents/specdojo-orchestrator.toml +4 -1
  281. package/templates/codex/orchestrator.md +4 -1
  282. package/templates/init-exec-defaults.yaml +13 -0
  283. package/templates/lefthook/tools/specdojo-pre-commit.mjs +8 -0
  284. package/templates/opencode/agents/specdojo-orchestrator.md +5 -2
@@ -11,115 +11,125 @@ specdojo:
11
11
 
12
12
  C4 Container Diagram Writing Recipe
13
13
 
14
- 利用者が必要とする結果から、実行・配備単位、記録の保管単位、連携経路を選ぶ手順です。機能一覧を図に変換するだけで終わらせず、配置設計と結合検証へ渡せる境界を作ります。
14
+ 利用者が必要とする結果から、実行単位・ストア・連携経路を選ぶ作り方を示す。
15
15
 
16
16
  ## 1. このレシピの使い方
17
17
 
18
- - 上位のコンテキスト図から対象システムの目的と外部への委譲を引き継ぎ、内部のどの実行単位がその責務を担うかを書き出します。
19
- - 実行単位ごとの入出力と記録先をつなぎ、配置上の前提までを扱います。内部のクラス、API 構文、ホスト構築手順は詳細設計へ渡します。
20
- - 要素名と関係 ID を手掛かりに、図、定義、制約、未確定事項を対応させます。仮定は根拠のある仕様と分け、確認先を付けます。
18
+ - コンテナ図は、上位のコンテキスト図の利用目的と外部への委譲を引き継ぎ(Why)、それを担う実行単位・ストア・関係を定め(What)、配置の前提と結合で観測する結果までを扱う(How)。要素名と関係 ID で、図・定義・検証観点・仮定をたどれるようにする(Trace)。
21
19
 
22
20
  ## 2. 作成前に集める情報
23
21
 
24
- | 入力 | 集める情報・問い |
25
- | -------------- | ------------------------------------------------------------------------------ |
26
- | 利用目的・境界 | 誰が何を達成するか。上位図が対象に含める責務と外へ委ねる処理は何か |
27
- | 実行単位候補 | 別に起動・配備するアプリは何か。一つのアプリ内の機能を別単位と誤認していないか |
28
- | 記録と生成物 | どれが正本か。誰が更新し、誰がどの時点で読むか |
29
- | 外部依存 | 常時必要か、特定の操作時だけか。同じ端末にある別ツールも含めたか |
30
- | 配置前提 | ローカル・リモート、構築時・閲覧時を区別できるか。根拠のない配置案はどこか |
31
- | 詳細の更新先 | 連携契約、データ構造、内部構成、インフラをどの文書へ渡すか |
32
- | 合意と判断時点 | どの利用場面を誰と確認するか。下流が着手する前に、誰の判断を得る必要があるか |
22
+ | 項目 | 集める情報 | 取り出し元 |
23
+ | -------------- | ------------------------------------------------------------ | ------------------------------------ |
24
+ | 利用目的と境界 | 誰が何を達成するか、対象に含める責務と外へ委ねる処理 | 上位のコンテキスト図 |
25
+ | 実行単位の候補 | 別に起動・配備するアプリと、別にする理由 | 開発者への確認、起動・配備の手順 |
26
+ | 記録と生成物 | 正本、更新する主体、読む主体と時点 | 開発者への確認、リポジトリの構成 |
27
+ | 外部依存 | 常時必要か特定の操作時だけか、同じ端末にある別ツール | 上位のコンテキスト図、開発者への確認 |
28
+ | 配置の前提 | ローカル・リモート、構築時・閲覧時の区別と、根拠のない配置案 | 運用担当への確認 |
29
+ | 詳細の正本 | 連携契約、データ構造、内部構成、インフラを扱う文書 | 文書の一覧 |
33
30
 
34
31
  ## 3. 全体の作成手順
35
32
 
36
- 1. 「概要」に上位図の対象、分割の目的、本図の対象外を書きます。新たな提供経路を加える場合は中核責務との関係も説明し、今回合意したい範囲と確認者を整理します。
37
- 2. 「要素と境界の定義」に実行単位候補を並べ、個別に起動・配備する理由を一言ずつ付けます。理由が機能名だけなら元のアプリへ戻します。
38
- 3. 正本・生成物・共有先を区別し、保持する情報と直接アクセスする主体を整理します。ファイルを保存する場所と版管理ツールを分けます。
39
- 4. 利用者の操作から保存・外部依頼・結果確認までをたどり、関係表を作ります。関係 ID、起点、終点、目的、方式、成立する時点、詳細の正本を整理し、上位図の利用目的・外部依存ごとに担当コンテナか対象外の理由を確認します。
40
- 5. 「C4コンテナ図(Mermaid)」へ要素と関係を描きます。短いラベルにしても構築時だけの接続や任意依存の条件が残るか確かめます。
41
- 6. 「技術前提・制約と検証観点」に配置設計の前提と結合対象を置きます。経路ごとの正常な結果を決めてから、読取不能・外部停止・応答欠落で区別する状態を関係 ID に結びます。
42
- 7. 根拠不足の配置・経路は「メモ / 将来課題」へ移します。影響、担当、解消条件、引き継ぎ先を整理し、配置・接続・公開の判断を妨げる論点は ARC から PM へ渡して、PJR の転送先と判断時点を対応させます。
43
- 8. BA・DEV・QE・OPS へ担当する利用場面や技術前提の確認を依頼し、結果と残る論点を集めます。ARC が PO の判断に必要な材料をまとめ、公開する範囲と承認対象の対応を OPS と確認します。
33
+ 1. 概要に、分解する対象と分割の目的を先に書く。目的がないと、分割を止める所が決まらない。
34
+ 2. 要素と境界の定義で、実行単位の候補ごとに別に起動・配備する理由を付ける。理由が機能名だけなら元のアプリへ戻す。
35
+ 3. ストアを正本と生成物に分け、更新する主体と読む主体を書く。
36
+ 4. 利用者の操作から保存・外部への依頼・結果の確認までをたどって関係を書き、上位図の利用目的・外部依存ごとに担当するコンテナか描かない理由を決める。
37
+ 5. 定義と関係が決まってから C4コンテナ図を描く。図から書くと、根拠のない線が残りやすい。
38
+ 6. 技術前提・制約と検証観点では、経路ごとの正常な結果を先に決め、その後で読取不能・外部停止・応答欠落で区別する状態を書く。
39
+ 7. 根拠の足りない配置・経路をメモ / 将来課題へ移す。
44
40
 
45
41
  ## 4. 各章の書き方
46
42
 
47
43
  ### 4.1. 概要
48
44
 
49
- - 上位図のどのシステムを分解しますか。
50
- - 分割により、配置や接続について誰が何を判断できますか。
51
- - サイトなどの派生した提供経路を含める場合、上位図との範囲の違いを説明できますか。
52
- - 合意したい範囲と利用場面を、どの Role code の確認者へ渡しますか。図を使う Person と設計の確認者を取り違えていませんか。
45
+ 問い:
53
46
 
54
- 「販売の入力、記録、印字の配備単位を示す」のように目的を絞ります。「業務に必要なすべての構成」では分割を止める基準がありません。
47
+ - 上位図のどのシステムを分解し、分割によって誰が配置や接続の何を判断できるか。
48
+ - サイトなどの派生した提供経路を含める場合、上位図との範囲の違いは何か。
49
+
50
+ コツ:
51
+
52
+ - 上位図の目的や利用者の説明は写さず、上位図への参照に置き換える。
53
+ - 目的を判断したいことに絞ると、分割を止める基準になる。
55
54
 
56
55
  ### 4.2. C4コンテナ図(Mermaid)
57
56
 
58
- - 各アプリは別に実行・配備されますか。内部処理を別コンテナにしていませんか。
59
- - 読み手は線から依頼・参照の向きと情報の意味を説明できますか。
60
- - 構築時の読取を、閲覧中のネットワーク接続と誤解しませんか。
61
- - 上位図の各利用目的・外部依存から経路をたどれますか。描かなかった経路にはどのような対象外の理由がありますか。
57
+ 問い:
58
+
59
+ - 読み手は線から、依頼・参照の向きと、その線が成立する時点を説明できるか。
60
+ - 上位図の各利用目的・外部依存から経路をたどれるか。
62
61
 
63
- 「公開文書の参照(構築時)」までラベルに残し、矢印が依頼と情報移動のどちらを表すか、応答を同じ線に含めるかを注記します。「データ連携」だけでは、必要なネットワークと実行時点を選べません。
62
+ コツ:
63
+
64
+ - ラベルを縮めると「構築時」「印刷時だけ」などの条件が落ちやすい。
65
+ - 方式が分からない接続は線で補わず、メモ / 将来課題へ移す。
64
66
 
65
67
  ### 4.3. 要素と境界の定義
66
68
 
67
- - 境界、Person、Container、Data Store、External Software System、Relationship の順に、図だけで決まらない条件を掘り下げます。
68
- - コンテナの責務は誰の結果につながりますか。入力を受ける単位と、永続記録を持つ単位を説明できますか。
69
- - ストアは正本ですか、生成物ですか。更新者は一人だけですか、複数ですか。不明な排他制御を保証していませんか。
70
- - 同一端末にある外部ツールの管理主体と失敗影響は区別できますか。
71
- - 図のノード・線と定義行を双方向にたどると、名前・端点・ラベル・境界内外が食い違う箇所はありませんか。関係 ID から詳細の正本へ進めますか。
69
+ 問い:
70
+
71
+ - 各コンテナの責務は、誰のどの結果につながるか。
72
+ - ストアは正本か生成物か。直接更新するのは誰か。
73
+
74
+ コツ:
72
75
 
73
- 「販売処理は取引を記録し、印刷基盤は紙面への出力を担う」と責務を分けます。「同じ端末なので一つのアプリ」では境界の判断材料が不足します。
76
+ - 同じ端末にある外部ツールは、同じアプリにまとめやすい。管理する主体と、止まったときの影響を聞いて分ける。
77
+ - ファイルの保存場所、版管理の仕組み、共有サービスを聞き分け、更新する主体が複数なら排他制御の有無を開発者に聞く。
74
78
 
75
79
  ### 4.4. 技術前提・制約と検証観点
76
80
 
77
- - 配置設計者が必要とする、書込先、外部実行環境、閲覧先は識別できますか。
78
- - 経路が正常に成立したとき、入力に対してどの保存内容・生成物・返却結果を照合できますか。
79
- - 接続を止めたとき、失われる結果と残る記録を何で観測しますか。
80
- - 実行成功と人間の承認を混同する経路はありませんか。
81
+ 問い:
81
82
 
82
- 関係 ID を添えて「保存した控えと紙面が一致するかを確認し、印字失敗でも販売の記録と印字結果を別々に確認する」と書きます。「結合テストをする」だけでは観測対象が決まりません。未確認の期待結果は検証設計への論点に分け、復旧保証や具体的な再試行回数を推測で埋めません。
83
+ - 経路が正常に成立したとき、入力に対してどの保存内容・生成物・返却結果を照合できるか。
84
+ - 接続を止めたとき、失われる結果と残る記録は何か。
85
+
86
+ コツ:
87
+
88
+ - 書込先・外部の実行環境・閲覧先は、配置を設計する人に「何が未定だと困るか」を聞いて集める。
89
+ - 実行の成功と人の承認を同じ結果として書きやすい。分けて観測する対象を決める。
83
90
 
84
91
  ### 4.5. メモ / 将来課題
85
92
 
86
- - 未確認の技術名、接続方式、配備先はどれですか。
87
- - その不確実さで配置・テストの何が決められませんか。
88
- - 誰が何を確認すれば仮定を更新でき、どの詳細文書へ反映しますか。
89
- - 判断を妨げる論点を PM へ渡した後、PJR のどの記録で追えますか。誰が、いつまでに、またはどの下流作業の着手前に判断しますか。
90
- - 境界を変更・廃止した場合、上位図・コンポーネント図・インフラ構成図と、DEV の連携実装・QE の結合対象のどこへ影響しますか。
93
+ 問い:
94
+
95
+ - 未確認の技術名・接続方式・配備先はどれで、そのために配置や結合確認の何が決められないか。
96
+ - 誰が何を確認すれば、仮定を更新できるか。
91
97
 
92
- _ASSUMPTION_: とした配備案には確認条件を付けます。「ARC が配備案を整理し、PM が登録した課題を配備設計の着手前に PO が判断する」まで具体化し、実際の転送先を残します。「配備先未定」だけでは、検討を引き継げません。
98
+ コツ:
99
+
100
+ - 解消条件は「配信先が公開範囲を満たすかを運用担当が確かめる」のように、誰が何を確かめるかの形で聞く。
93
101
 
94
102
  ## 5. 深掘り手順
95
103
 
96
- 1. 一つの利用結果から逆にたどり、必要な処理と保持記録を探します。対応する結果のないコンテナ候補を除きます。
97
- 2. 上位図の利用目的・外部依存から各関係を「いつ」「誰が起動」「何を渡す」で読み直し、取り残した経路を探します。不明な方式は線を増やして補わず、論点として分けます。
98
- 3. 正本の更新から閲覧・共有までをたどり、正常な結果を照合する記録、再生成が必要な箇所、障害の影響が止まる境界を特定します。根拠へ戻れない期待結果は確認担当へ渡します。
104
+ 内容が浅いときは、次の順で対応のない主張を探す。
105
+
106
+ 1. 一つの利用結果から逆にたどり、対応する結果のないコンテナ候補を外す。
107
+ 2. 各関係を「いつ」「誰が起動し」「何を渡すか」で読み直し、上位図から取り残した経路を探す。
108
+ 3. 正本の更新から閲覧・共有までをたどり、正常な結果を照合する記録と、障害の影響が止まる境界を確かめる。根拠へ戻れない期待結果はメモ / 将来課題へ移す。
99
109
 
100
110
  ## 6. 良い例 / 悪い例
101
111
 
102
- | 観点 | 良い例 | 悪い例・問題 |
103
- | ---------- | -------------------------------------------------------- | -------------------------------------------------------------- |
104
- | 分割理由 | 画面はブラウザで動き、処理サービスはサーバーで動く | 登録・検索・削除をそれぞれコンテナにする。機能と実行単位の混同 |
105
- | ストア | 文書の正本はファイル群、閲覧用 HTML は生成物とする | すべてを「DB」とし、更新元と派生物を区別しない |
106
- | 外部依存 | 印刷時だけ印刷基盤へ依頼する | 印刷基盤の停止で全参照も停止すると根拠なく断定する |
107
- | 未確定配置 | ローカル構築を仮定し、配信先と公開範囲の確認を担当へ渡す | 候補のホストを既存構成のように描く |
112
+ | 観点 | 良い例 | 悪い例 |
113
+ | ------------ | -------------------------------------------------------------- | ---------------------------------------------- |
114
+ | 分割の目的 | 「販売の入力、記録、印字の配備単位を示す」 | 「業務に必要なすべての構成」 |
115
+ | 分割の理由 | 画面はブラウザで動き、処理サービスはサーバーで動く | 登録・検索・削除をそれぞれコンテナにする |
116
+ | ストア | 文書の正本はファイル群、閲覧用 HTML は生成物とする | すべてを「DB」とし、更新元と派生物を区別しない |
117
+ | 関係のラベル | 「公開文書の参照(構築時)」 | 「データ連携」 |
118
+ | 外部依存 | 印刷時だけ印刷基盤へ依頼する | 印刷基盤の停止で全参照も止まると断定する |
119
+ | 検証観点 | 控えと紙面の一致と、印字失敗時に残る販売の記録を分けて確かめる | 「結合テストをする」 |
120
+ | 未確定の配置 | ローカル構築を仮定し、配信先の確認を運用担当へ渡す | 候補のホストを既存構成のように描く |
108
121
 
109
122
  ## 7. レビュー観点
110
123
 
111
- | 観点 | 確認する内容 | 主な確認者 |
112
- | ------------ | ------------------------------------------------------------ | ---------- |
113
- | 価値・範囲 | 利用者が得る結果と上位図の境界を分割後も保っているか | BA / PO |
114
- | 配置入力 | 各実行単位、保持単位、必要な接続と仮定を区別できるか | ARC / DEV |
115
- | 結合入力 | 主要経路と外部失敗の観測対象を関係 ID で追えるか | QE |
116
- | 詳細との分担 | 構文・schema・物理配置の更新先が識別できるか | ARC |
117
- | 判断と公開 | 未決事項の影響・判断時点と、承認範囲・公開対象を照合できるか | PO / OPS |
124
+ | 観点 | 確認内容 |
125
+ | ------------ | -------------------------------------------------------- |
126
+ | 価値と範囲 | 利用者が得る結果が、分割後も上位図の境界からはみ出ないか |
127
+ | 配置への入力 | 実行単位、保持単位、必要な接続と仮定を分けて読み取れるか |
128
+ | 結合への入力 | 主要な経路と外部の失敗で観測する対象を関係 ID で追えるか |
129
+ | 詳細との分担 | 構文・データ構造・物理配置を書かず、更新先が分かるか |
118
130
 
119
131
  ## 8. 仕上げチェック
120
132
 
121
- - 図と表の要素名・関係ラベルをそろえ、説明を重複させず責務・条件を残しましたか。
122
- - 正本、構築時の入力、閲覧用生成物を区別し、実行時点の違いを説明しましたか。
123
- - 未確認の配置と経路を仮定として分け、影響・担当・解消条件・転送先・判断時点を追える形にしましたか。
124
- - 記法・メタ情報の検査結果と描画の確認結果を集め、内容のレビュー結果と併せて残る指摘を識別しましたか。
125
- - 主要判断と公開可否を、人間が判断する境界として残し、承認・保留の記録と公開対象を照合できるようにしましたか。
133
+ - 各コンテナが一つ以上の利用結果につながっている。
134
+ - 正本、構築時の入力、閲覧用の生成物が区別され、関係が成立する時点が図と定義で食い違っていない。
135
+ - 仮定と確定事項が分かれ、各仮定に誰が何を確かめるかがある。
@@ -11,116 +11,130 @@ specdojo:
11
11
 
12
12
  C4 Component Diagram Writing Recipe
13
13
 
14
- 上位コンテナの責務を内部のまとまりへ分け、依存方向と確認すべき境界を見つける手順です。機能名を並べただけの図から、実装と結合設計の判断に使える構成へ具体化します。
14
+ 上位コンテナの責務を内部のまとまりへ分け、機能名を並べただけの図から、実装と結合設計の判断に使える構成へ具体化する作り方を示す。
15
15
 
16
16
  ## 1. このレシピの使い方
17
17
 
18
- - 上位図から、対象コンテナの目的と利用者へ返す結果を取り出します。目的の全文は繰り返さず、分割の理由として使います。
19
- - 内部の責務、利用者と外部依存への接点、保存する正本を整理し、責任が重なる箇所を分けます。別プロセス化やクラス設計はここで決めません。
20
- - コンポーネント名と関係 ID を軸に、分割の理由、情報の受け渡し、失敗時の観測点をつなぎます。未確認の依存は確認先とともに引き継ぎます。
18
+ - CPD は、上位図と上位の要求から分割の理由(Why)を引き継ぎ、コンポーネントの責務と境界で受け渡す情報(What)を定め、依存方向と失敗時の観測点(How)を示す。これらをコンポーネント名と関係 ID でたどれるようにする(Trace)。
21
19
 
22
20
  ## 2. 作成前に集める情報
23
21
 
24
- | 情報 | 書き出す問い |
25
- | ---------- | ---------------------------------------------------------------------------------------- |
26
- | 上位の境界 | 分解する実行単位はどれか。外部のまま残す利用者・ストア・他システムは何か |
27
- | 必要な成果 | 利用者は何に困り、どの結果を確認して次へ進むか。期待価値と成功基準の上位参照はどこか |
28
- | 責務の候補 | 入力の解釈、判断の適用、記録、外部依頼のうち別々に変更・確認したいものは何か |
29
- | 内容の根拠 | 設計上の決定と実装確認済みの事実を分けられるか。未確認なのに具体化した配置はないか |
30
- | 結合の論点 | 相手が不在・拒否・応答欠落のとき、どの結果が不明になるか |
31
- | 詳細化先 | 値・構文・構造・復旧条件を更新する正本と担当はどこか |
32
- | 確認と合意 | 構成・実装・結合・業務を誰にいつ確認してもらうか。最終合意と公開可否の判断者は誰か |
33
- | 公開と保守 | 誰にどの媒体で見せるか。公開前に確認する情報と、境界・契約が変わったときの相談先はどこか |
22
+ | 項目 | 集める情報 | 取り出し元・聞く相手 |
23
+ | ---------- | ---------------------------------------------------------------------- | ----------------------- |
24
+ | 上位の境界 | 展開するコンテナ、外部のまま残す利用者・ストア・他システム | 上位のコンテナ図 |
25
+ | 必要な成果 | 利用者が確認して次へ進む結果、期待価値・成功基準の記述箇所 | 上位の要求・目的、BA |
26
+ | 代表の依頼 | 入力から結果の確認までの流れと、結果を作る側・記録する側 | 業務の流れ、BA・DEV |
27
+ | 責務の候補 | 入力の解釈・判断・記録・外部依頼のうち、別々に変更・確認したいもの | 実装担当(DEV)への確認 |
28
+ | 確定度 | 設計上の決定と実装で確かめた構成の区別、未確認の配置 | 実装担当(DEV)への確認 |
29
+ | 結合の論点 | 相手の不在・拒否・応答欠落で不明になる結果、依存する共通機構の保証範囲 | 外部 IF の仕様、ARC・QE |
34
30
 
35
31
  ## 3. 全体の作成手順
36
32
 
37
- 1. 「概要」に対象コンテナと上位図との対応、分割が必要な理由、今回扱わない範囲を書きます。上位の業務課題・成功基準の参照先を選び、確認者・合意者と公開範囲を整理します。
38
- 2. 一つの代表依頼について、入力から結果の確認までをたどり、誰が結果を作り、誰が記録するかをメモします。
39
- 3. 責務の候補を比較し、異なる変更理由・失敗結果を持つまとまりを分けます。名前だけ違って入出力が同じ候補は統合します。
40
- 4. 「要素と境界の定義」で各まとまりの責務と入出力、論理配置を言葉にし、利用先を決めます。分割・共通化の採用理由を上位の目的または技術制約へ結び付けます。
41
- 5. 「C4コンポーネント図(Mermaid)」に主要な依頼・依存を描き、関係 ID で授受情報と詳細化先へ接続します。
42
- 6. 「技術前提・制約と検証観点」で成功と失敗の観測点を選び、「メモ / 将来課題」に未確認箇所の担当・判断者、判断時点と解消条件を残します。
43
- 7. 図の要素・関係を定義表から逆引きし、差異と省略理由を確かめます。リポジトリの検査設定から対象と期待結果を整理し、構文・描画・参照の確認結果を実行記録へ残します。
44
- 8. 構成上の確認結果と業務・公開判断の材料を分けて合意者へ渡します。改訂なら、変更した関係から後続設計・実装・検証・作業順への影響をたどり、更新先を決めます。
33
+ 1. 代表の依頼を一つ選び、入力から結果の確認までをたどってメモする。分割の候補は、この流れで結果を作る側と記録する側から見つける。
34
+ 2. 「要素と境界の定義」を先に書く。責務と入出力が決まらないと、図の矢印の意味が決まらない。
35
+ 3. 「C4コンポーネント図(Mermaid)」に、主要な依頼と依存を関係 ID 付きで描く。
36
+ 4. 「技術前提・制約と検証観点」で、関係ごとの成功と失敗の観測点を書く。
37
+ 5. 確かめられなかった配置や保証を「メモ / 将来課題」へ移す。
38
+ 6. 最後に「概要」を書く。分割と未確認の範囲が決まってから書くと、対象外と確定度を言い切れる。
45
39
 
46
40
  ## 4. 各章の書き方
47
41
 
48
42
  ### 4.1. 概要
49
43
 
50
- 対象のコンテナ名を伏せても、分割によって何を判断したいか説明できますか。利用者の課題と成功基準をどの上位記述から引き継ぎますか。構成案と実装の確認済み構成を区別していますか。
44
+ 問い:
51
45
 
52
- 確認対象から逆に、構成・実装・結合・業務それぞれの確認者と時点を探します。最終合意者と公開する相手・媒体・範囲を概要にまとめ、役割割当てや合意記録の参照へつなぎます。上位に成功基準が見つからないときは、BA への確認事項にします。
46
+ - この分割で、後続の設計・実装は何を判断できるようになるか。今回扱わない範囲は何か。
47
+ - 期待価値・成功基準は、どの上位記述から引き継ぐか。
53
48
 
54
- 良い例は「交代時に未印字を引き継ぐという上位の成功基準に対応し、保存と印字の責任境界を結合設計へ渡す」です。「販売を管理する」だけでは分割の用途を判断できません。
49
+ コツ:
50
+
51
+ - 上位の目的や成功基準は写さず、参照に置き換える。上位に見つからなければ BA に聞き、答えが出るまで論点に残す。
52
+ - 構成案と確かめた構成を混ぜやすい。DEV に「どこまでコードで確かめたか」を聞き、残りは _ASSUMPTION_: にする。
55
53
 
56
54
  ### 4.2. C4コンポーネント図(Mermaid)
57
55
 
58
- 矢印は利用する側から利用される側へ向いていますか。応答を逆依存として足していませんか。上位で外側だった要素を内部へ移していませんか。
56
+ 問い:
57
+
58
+ - 矢印は利用する側から利用される側へ向いているか。応答を逆向きの依存として足していないか。
59
+ - 主要経路を省くと、どの判断が変わるか。
59
60
 
60
- 一つの正常な依頼と外部応答が欠ける依頼をたどり、確認が必要な経路を選びます。全呼び出しを増やす前に、主要経路を省いて判断が変わるかを考え、選んだ理由と省いた範囲を短く添えます。
61
+ コツ:
61
62
 
62
- 良い例は「保存後の印字依頼を主要経路とし、画面内操作は別コンテナの責務として省く」です。「読みやすくするため矢印を減らした」だけでは、欠けた経路の影響を確かめられません。
63
+ - 正常な依頼と外部応答が欠ける依頼の二本をたどると、描く経路と省く経路を選べる。
64
+ - 同じ端末で動くという理由で、上位図の外側の要素を内側へ移しやすい。
63
65
 
64
66
  ### 4.3. 要素と境界の定義
65
67
 
66
- その責務を削ると誰が結果を作れなくなりますか。二つの要素が同じ記録の更新判断を持っていませんか。論理配置をソースパスと混同していませんか。
68
+ 問い:
67
69
 
68
- まず対象コンテナ境界と利用者の接点、次にコンポーネントと論理配置、ストアと外部依存、最後に関係と詳細の正本を整理します。Person・ストア・外部依存が見当たらない場合は、直接の接点が別要素なのか、本当に非該当なのかを上位図から確認します。
70
+ - その責務を削ると、誰が結果を作れなくなるか。
71
+ - 二つの要素が同じ記録の更新判断を持っていないか。
69
72
 
70
- 入出力は「確認済み販売明細」「保存結果」のように意味で表し、判断する側と記録する側の分界を明らかにします。共通化の候補には、分けたままの場合と比べてどの判断の重複を減らせるかを問い、採用理由を残します。関係ごとに値・構文・構造を管理する正本を探し、未作成なら仮参照と確認先を残します。
73
+ コツ:
71
74
 
72
- 良い例は「商品参照と販売記録の保存接点を共通化し、販売可否の判断は会計側に残す」です。「共通処理がすべて判断する」では更新責任を追えません。
75
+ - 入出力は「確認済み販売明細」「保存結果」のように意味で書くと、判断する側と記録する側の分界が見える。
76
+ - 共通化の候補には「分けたままだと、どの判断が重複するか」を聞く。同名の関数があるだけでは共通化の理由にならない。
77
+ - 値・構文・構造は写さず、管理する文書への参照に置き換える。未作成なら仮の参照と確認先を残す。
73
78
 
74
79
  ### 4.4. 技術前提・制約と検証観点
75
80
 
76
- 相手の失敗が起点の成功を取り消す条件は確認済みですか。応答欠落で成功・未実施のどちらかに即断していませんか。正本を変更せず再生成できる派生物は何ですか。
81
+ 技術前提の問い:
82
+
83
+ - どの共通機構・外部依存に頼るか。排他・原子性・再試行の保証は確かめたか。
84
+
85
+ 検証観点の問い:
77
86
 
78
- 各境界で「与える条件 → 観測する結果」を一組ずつ考え、確認できない期待値は詳細契約へ引き継ぎます。
87
+ - 各境界で、どの条件を与えると何を観測すれば成功・失敗を区別できるか。
79
88
 
80
- 良い例は「`REL-08` の応答欠落時に、保存済み販売と印字の結果不明を別々に観測する」です。「異常系を確認する」では、どの関係で何を見ればよいか決まりません。
89
+ コツ:
90
+
91
+ - 応答欠落を、成功・未実施のどちらかに即断しやすい。結果不明として別に観測する。
92
+ - 確かめられない期待値は、詳細の契約へ引き継ぐ。
81
93
 
82
94
  ### 4.5. メモ / 将来課題
83
95
 
84
- 未確認事項を確定するにはどの根拠が必要ですか。調査する担当と採否を判断する人を分けられますか。いつまでに判断できなければ、どの後続作業や合意を保留しますか。
96
+ 問い:
97
+
98
+ - 未確認事項を確定するには、どの根拠が要るか。
99
+ - 確定しないまま進むと、どの要素・関係と後続の作業が止まるか。
85
100
 
86
- 未確認の主張を仮定・判断待ち・確認作業に分け、共通ラベルで確定事項と区別します。対象要素・関係から影響先をたどり、未発生の懸念か、発生済みの阻害か、変更提案か、決定済みかを整理します。継続追跡する論点は PM へ渡す PJR の参照、未起票なら登録候補の理由・起票担当・判断時点につなぎます。
101
+ コツ:
87
102
 
88
- 良い例は「印字応答欠落の回復条件を ARC が整理し QE が観測点を確認する。人間の PO が実装着手前に採否を判断し、未解消なら印字経路を保留する。PM へ PJR 登録候補として渡す」です。「保存を検討」では、次の作業と判断者が決まりません。
103
+ - 未確認の主張を仮定・判断待ち・確認作業に分けると、当面の扱いと解消条件を書ける。
104
+ - 対象の要素名・関係 ID を必ず添える。添えないと影響先をたどれない。
89
105
 
90
106
  ## 5. 深掘り手順
91
107
 
92
- 1. 出力から入力へ戻り、その出力が必要な利用場面と、作成する責務を確認します。利用されない出力のためだけの分割は見直します。
93
- 2. 外部依頼の直前と直後で止まった場合を比べ、残る記録と結果不明を区別できるか考えます。
94
- 3. 共通機構を外した場合に複数の責務へ同じ判断が散らばるかを確かめます。単に同名関数があるという理由では共通化しません。
95
- 4. 分割・共通化の採用理由を上位の目的または技術制約まで戻って確かめます。根拠を辿れない候補は仮定と確認事項へ戻します。
96
- 5. 一つの変更を仮定し、上位の境界、内部の責務、関係 ID、詳細契約、結合観測点、作業順のどこが変わるかたどります。更新または更新不要の理由と担当を変更記録へ残し、再描画・再検証する範囲を選びます。
108
+ 内容が浅いときは、次の順で対応のない主張を探す。
109
+
110
+ 1. 各出力が、どの利用場面と上位の成功基準に応えるかを確かめ、使われない出力のためだけの分割を外す。
111
+ 2. 外部依頼の直前と直後で止まった場合を比べ、残る記録と結果不明を区別できない関係を探す。
112
+ 3. 共通機構を外したとき、複数の責務へ同じ判断が散らばるかを確かめる。散らばらない共通化は外す。
113
+ 4. 一つの変更(境界・責務・外部契約)を仮定し、関係 ID から上位図・詳細契約・観測点・作業順への影響をたどる。たどれない関係は定義を補う。
97
114
 
98
115
  ## 6. 良い例 / 悪い例
99
116
 
100
- | 観点 | 良い例 | 悪い例 |
101
- | ---------- | -------------------------------------------------------------------------------- | -------------------------------------- |
102
- | 分割の理由 | 印字失敗と販売確定を分けて確認するため、印字連携を独立した責務にする | コマンドがあるので同じ数の部品を作る |
103
- | 依存の意味 | 会計処理が保存済み控えの印字を依頼し、発行結果を受ける | 会計と印字が相互に処理する |
104
- | 確定度 | 同一プロセス内の論理配置案。実装対応は DEV が確認する | 未調査のソースパスを実装済みとして書く |
105
- | 障害の分界 | 印字応答欠落時は販売結果と紙面の確認を分ける | エラーなら全部やり直す |
106
- | 公開判断 | OPS が公開先に応じて本文・図・ラベル・参照先を確認し、残る懸念を人間の PO へ渡す | lint が通ったので公開できる |
107
- | 改訂の影響 | 保存責務の統合で変わる関係を起点に、データ設計と結合観測点の更新担当を決める | 図だけ差し替えて更新を終える |
117
+ | 観点 | 良い例 | 悪い例 |
118
+ | ---------- | ------------------------------------------------------------------------ | -------------------------------------- |
119
+ | 分割の用途 | 「交代時の未印字引き継ぎに応え、保存と印字の責任境界を結合設計へ渡す」 | 「販売を管理する」 |
120
+ | 分割の理由 | 印字失敗と販売確定を分けて確かめるため、印字連携を独立させる | コマンドの数だけ部品を作る |
121
+ | 依存の意味 | 会計処理が保存済み控えの印字を依頼し、発行結果を受ける | 会計と印字が相互に処理する |
122
+ | 共通化 | 商品参照と販売記録の保存接点を共通化し、販売可否の判断は会計側に残す | 共通処理がすべて判断する |
123
+ | 確定度 | 同一プロセス内の論理配置案とし、実装対応は DEV が確かめる | 未調査のソースパスを実装済みとして書く |
124
+ | 観測点 | `REL-08` の応答欠落で、保存済み販売と印字の結果不明を別々に観測する | 「異常系を確認する」 |
125
+ | 未確認事項 | 印字応答欠落の回復条件が定まるまで自動再送を認めず、印字経路の受入を保留 | 「保存を検討」 |
108
126
 
109
127
  ## 7. レビュー観点
110
128
 
111
- | 観点 | 確認する問い |
112
- | ------------ | -------------------------------------------------------------------------- |
113
- | 目的と分割 | 各責務の必要性を上位コンテナの結果へ結び付けられるか |
114
- | 更新責任 | 同じ結果を二つの部品が別々に確定しないか |
115
- | 境界の観測 | 外部不在・拒否・応答欠落で、起点が確認すべき結果を区別できるか |
116
- | 詳細への委譲 | 値や構文を変えたとき、本図にも同じ変更が必要な重複を作っていないか |
117
- | 合意の材料 | 技術・業務の確認結果と残る論点から、判断者が承認・保留・差し戻しを選べるか |
118
- | 追従の範囲 | 上位境界・外部契約の変更から、図・定義表と後続設計の更新先を辿れるか |
129
+ | 観点 | 確認内容 |
130
+ | ---------- | ------------------------------------------------------------------ |
131
+ | 目的と分割 | 各責務の必要性を、上位コンテナが返す結果へ結び付けられるか |
132
+ | 更新責任 | 同じ結果を二つの要素が別々に確定していないか |
133
+ | 境界の観測 | 外部の不在・拒否・応答欠落で、起点が確かめる結果を区別できるか |
134
+ | 委譲の境界 | 値・構文・構造を写さず、変更が詳細の文書だけで済む形になっているか |
119
135
 
120
136
  ## 8. 仕上げチェック
121
137
 
122
- - 図から定義表、定義表から図へ照合し、全要素・関係 ID の対応と省略理由を確認したか。
123
- - 実装未確認の配置、外部連携の保証、未決の業務判断を仮定や論点として区別したか。
124
- - 引き継ぎ先・担当・判断者と判断時点が特定でき、未解消時に進められる作業と保留する作業を説明できるか。
125
- - メタ情報・参照・構文と描画の確認記録を辿れ、ラベル欠け・重なり・境界の誤読を解消したか。
126
- - 公開する本文・図・ラベル・参照先に残る非公開情報の懸念を OPS と確認し、人間の PO が公開先と可否を判断する材料を用意したか。
138
+ - 図で省いた経路ごとに、省いても判断が変わらない理由を書いている。
139
+ - 実装で確かめていない配置や外部の保証を、確定事項として書いていない。
140
+ - 未確認事項ごとに、影響する要素・関係 ID と当面の扱いが分かる。