specdojo 0.8.0 → 0.9.1

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