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
@@ -16,18 +16,17 @@ specdojo:
16
16
 
17
17
  Conceptual Data Flow Diagram Notation Rulebook for D2
18
18
 
19
- D2 の構文で CDFD のプロセス、イベント、データストア、外部主体、情報・物の流れを一貫して表すための記法ルールです。`specdojo:cdfd-overview-rulebook`、`specdojo:cdfd-rulebook`、`specdojo:cdfd-uc-rulebook` の `includes` から適用される共通部品です。対象プロダクトの `cdfd-overview` に「凡例(本プロダクト共通)」がある場合はその割り当てを正本とし、共通凡例がない場合は本 rulebook の形状・線種と既定の色・絵文字方針に従います。
19
+ D2 で CDFD のプロセス・イベント・データストア・外部主体・受け渡しを表す記法ルールです。全体概要・プロセスグループ別・ユースケース別 CDFD の主 rulebook の `includes` から適用します。プロダクト固有の割り当ては全体概要の「凡例(本プロダクト共通)」、共通凡例がなければ本書の既定凡例を使います。
20
20
 
21
21
  ## 1. 全体方針
22
22
 
23
- - D2 を使用し、方向は全体概要・詳細 CDFD を問わず `direction: down` を基本とします。配置のエンジンは文書サイトの既定と同じ ELK を前提とします。CDFD の矢印は情報・物・実行要求の受け渡しを表し、ユースケース別など包含元が明示した場合だけ業務上の順序も表します。プロセスは上から Orchestrator・Plan・Do・Check・Action の順(Onboarding がある図では Onboarding を Orchestrator の上)に並べます。並び順に逆らう戻りの矢印は `b -> a` ではなく `a <- b` と書き、ELK に並びを決めさせないようにします(矢印の向きは `b` から `a` のまま、配置上で `a` を上に保ちます)。`direction: right` は、横長での表現が適している場合に選択できます。以下では、プロセスグループ別とユースケース別を合わせて「詳細 CDFD」と呼びます。
24
-
25
- - 図が読みにくくなる原因は方向ではなく規模です。ノード数が多く一画面で関係を追いにくい場合は、方向を変えるのではなく、「凡例と可読性」の分割方針に従って図を分けます。分割の観点(全体概要はデータストアの区分、プロセスグループ別 CDFD は業務の性質が近いプロセス)とノード数の目安は包含元の rulebook が定めます。
23
+ - 方向は `direction: down`、配置エンジンは文書サイトと同じ ELK を基本とし、横長に適する場合は `direction: right` を選べます。矢印は情報・物・実行要求の受け渡しを示し、包含元が明示した場合だけ業務順序も示します。プロセスの並び順と戻りの矢印は「エッジ」に従います。以下、プロセスグループ別とユースケース別を「詳細 CDFD」と呼びます。
24
+ - 一画面で関係を追いにくい場合は「凡例と可読性」に従って分割します。分割単位とノード数の目安は包含元が定めます。
26
25
  - 全体概要とユースケース別 CDFD では、一つのプロセスグループを一つの代表ノードで表し、グループ内の領域や処理へ展開しません。ただし、ユースケース別 CDFD の包含元が系統の詳細をプロセス領域単位で描くと定めた場合は、その単位に従います。プロセスグループ別 CDFD では、一つのプロセスを一つのプロセスノードで表します。
27
26
  - 一つの記号へ一つの意味を割り当て、ノード形状だけでプロセス、イベント、データストア、外部主体を区別できるようにします。
28
-
29
27
  - 情報の流れと物の流れは線種(線の太さ)で区別し、すべてのエッジへ内容を表す名詞形のラベルを付けます。
30
- - 図の目的は業務上の合意であり、装飾や実装構造の再現ではありません。ノード形状で意味を区別することを基本とし、色は形状だけでは判別しにくい場合の視認性向上に、プロセス/イベント/データストア/外部主体という概念の大分類単位で付けます。色は `classes` で大分類ごとに定義して `class` で当て、ノード単位の `style` 個別指定は禁止します。業務上の区別が必要な場合は、大分類内を同系統色の濃淡・彩度で分けられます。物理名、詳細な操作は使用しません。
28
+ - 業務上の合意に必要な概念を形状で区別し、色は「見栄えを整える最小限スタイル」に従う補助表現とします。物理名や詳細な操作は使いません。
29
+ - **共通の運用**: 役割は適用先のメンバー定義に、`status`・承認・改訂と廃止・未決事項の引き継ぎは [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] に従います。整形・lint はリポジトリの検証で扱い、業務の受入確認に含めません。
31
30
 
32
31
  | 概念 | D2 表現 | 表示例 |
33
32
  | -------------------- | ------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------- |
@@ -43,12 +42,7 @@ D2 の構文で CDFD のプロセス、イベント、データストア、外
43
42
 
44
43
  ## 2. 位置づけと用語定義
45
44
 
46
- | 用語 | 定義 |
47
- | ------------ | ----------------------------------------------------------------------------- |
48
- | ノード ID | D2 コード内で要素を参照する識別子。短い英単語または英数字スネークケースを使う |
49
- | 表示ラベル | 図上で読み手に見せる名称。業務用語と領域 ID を必要に応じて併記する |
50
- | エッジラベル | 移動する情報・物、またはイベントから伝わる起動条件の名称 |
51
- | コンテナ | 関連するプロセスを囲む視覚上のまとまり。プロセスグループの表現には使わない |
45
+ コード内で要素を参照するノード ID と、図上に見せる表示ラベルを区別します。表示ラベルは業務用語に必要な領域 ID を併記し、エッジラベルは渡す情報・物・起動条件の名称とします。
52
46
 
53
47
  - ノード ID には日本語文字や記号を避け、`sales_record` や `sales_ledger` のような英数字・スネークケースを基本とします。
54
48
  - 表示ラベルは `"..."` で指定し、改行が必要な場合は `\n` を使います。
@@ -64,23 +58,11 @@ D2 の構文で CDFD のプロセス、イベント、データストア、外
64
58
 
65
59
  ## 4. 推奨 Frontmatter 項目
66
60
 
67
- - 本 rulebook は `specdojo:cdfd-overview-rulebook`、`specdojo:cdfd-rulebook`、`specdojo:cdfd-uc-rulebook` の `includes` から適用されるため、成果物 Frontmatter に記法 rulebook を重複記載しません。
68
- - 成果物の `rulebook` は、図種別に応じて構造を定義する上記いずれかの主 CDFD rulebook を指定します。例えばプロセスグループ別 CDFD は `rulebook: specdojo:cdfd-rulebook` とします。
69
- - 記法だけを別ファイルで適用する運用は行わず、主 CDFD rulebook と組み合わせます。
70
-
71
- プロセスグループ別 CDFD の記載例:
72
-
73
- ```yaml
74
- specdojo:
75
- id: cdfd-purchasing
76
- type: flow
77
- status: draft
78
- rulebook: specdojo:cdfd-rulebook
79
- ```
61
+ 成果物の `rulebook` は図種別を定める主 CDFD rulebook とし、本記法を重複記載しません。記法単独では適用しません。プロセスグループ別なら `rulebook: specdojo:cdfd-rulebook` とします。
80
62
 
81
63
  ## 5. 本文構成(標準テンプレ)
82
64
 
83
- D2 コードブロック内は、次の順序を基本とします。必須の判定は図種別で異なります。全体概要ではプロセスグループの代表ノード、データストア、情報の流れを必須とし、イベントはプロセス領域の表に記載して図に描きません。プロセスグループ別 CDFD では個別プロセス、イベント、データストア、情報・物の流れを必須とします。ユースケース別 CDFD では通常の流れ全体を通して、包含元の単位に従うプロセスノード、開始・終了のイベント、情報・物の流れを必須とします。分割図や任意の戻りの図への開始・終了の再掲は不要です。渡す情報・物は線のラベルで表し、引き渡し条件のイベントは置きません。データストアは対象ケースで参照・更新するものだけを置きます。外部主体と物理保管はいずれの図種別でも存在する場合だけ置きます。全図で図直後の注記を必須とし、共通凡例の有無に応じて参照先または本 rulebook の既定凡例を使う旨を示します。
65
+ コードは次表の順を基本とします。全体概要はグループ代表・データストア・情報の流れ、プロセスグループ別は個別プロセス・イベント・データストア・情報/物の流れを必須とします。外部主体・物理保管は存在する場合だけ置き、全図に直後の注記を付けます。ユースケース別のイベントも必須です。ユースケース別の開始・終了は通常の流れ全体で必須とし、分割図や任意の戻りの図への再掲は不要です。
84
66
 
85
67
  | 順序 | 区分 | 必須 | 内容 |
86
68
  | ---- | -------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
@@ -107,81 +89,30 @@ D2 コードブロック内は、次の順序を基本とします。必須の
107
89
 
108
90
  ```d2
109
91
  direction: down
110
-
111
92
  classes: {
112
93
  process: {
113
94
  shape: rectangle
114
95
  style.border-radius: 8
115
96
  }
116
- event: {
117
- shape: hexagon
118
- }
119
- store: {
120
- shape: cylinder
121
- }
122
- actor: {
123
- shape: rectangle
124
- }
125
97
  }
126
-
127
98
  sales_area: "販売領域" {
128
- sales_record: "P-01-01 販売記録\n(担当: 店員)" {
129
- class: process
130
- }
131
- }
132
- purchase_request: "顧客が商品の購入を要求した" {
133
- class: event
134
- }
135
- customer: "顧客" {
136
- class: actor
137
- }
138
- sales_ledger: "販売記録簿" {
139
- class: store
99
+ sales_record: "P-01-01 販売記録\n(担当: 店員)" { class: process }
140
100
  }
141
101
  ```
142
102
 
143
103
  ### 6.2. 絵文字アイコン(任意)
144
104
 
145
- 絵文字は人間の視認性向上には有効ですが、表示差や幅崩れが起きる環境もあるため、次のルールで運用します。
146
-
147
- - 絵文字は任意です(なくても成立します)。
148
- - 絵文字は表示ラベルのみに付け、ノード ID には付けません。
149
- - 1ノードにつき1個までとし、表示ラベルの先頭に付けます。
150
- - 絵文字だけに頼らず、必ずプロセス名・データストア名などのテキストも併記します。
105
+ 表示差・幅崩れを考慮し、絵文字は任意とします。表示ラベルの先頭に一つまで付け、名称のテキストを併記します。ノード ID には付けません。
151
106
 
152
107
  ```d2
153
108
  direction: down
154
-
155
109
  classes: {
156
110
  process: {
157
111
  shape: rectangle
158
112
  style.border-radius: 8
159
113
  }
160
- event: {
161
- shape: hexagon
162
- }
163
- store: {
164
- shape: cylinder
165
- }
166
- actor: {
167
- shape: rectangle
168
- }
169
- }
170
-
171
- sales_area: "販売領域" {
172
- sales_record: "📋 P-01-01 販売記録\n(担当: 店員)" {
173
- class: process
174
- }
175
- }
176
- purchase_request: "⚡ 顧客が商品の購入を要求した" {
177
- class: event
178
- }
179
- customer: "🏢 顧客" {
180
- class: actor
181
- }
182
- sales_ledger: "🗄️ 販売記録簿" {
183
- class: store
184
114
  }
115
+ sales_record: "📋 P-01-01 販売記録\n(担当: 店員)" { class: process }
185
116
  ```
186
117
 
187
118
  禁止例(絵文字がノード ID に付いている、または表示ラベルに無い):
@@ -238,22 +169,17 @@ sales_record -> sales_ledger: "販売情報"
238
169
 
239
170
  ### 6.4. 凡例と可読性
240
171
 
241
- - 各図の直後に凡例の適用元を注記します。対象プロダクトの `cdfd-overview` に「凡例(本プロダクト共通)」がある場合はその章を参照し、ない場合は「ノード形状・線種・色・絵文字は `specdojo:cdfd-d2-rulebook` の既定凡例に従う」と記述します。いずれの場合も、図で使用した線種、図から省略した入出力と理由、別図と共有するノードを併記します。
242
- - 共通凡例がある場合、ノード形状、色、絵文字のプロダクト固有の割り当ては共通凡例を正本とし、図ごとに再掲しません。共通凡例にない割り当ては使用しません。共通凡例がない場合は、本 rulebook の対応表と「見栄えを整える最小限スタイル」を既定凡例とし、図ごとの独自割り当てを追加しません。
172
+ - 図直後に、共通凡例の参照先、使用線種、省略した入出力と理由、別図と共有するノードを示します。共通凡例がなければ「ノード形状・線種・色・絵文字は `specdojo:cdfd-d2-rulebook` の既定凡例に従う」と書きます。
173
+ - 共通凡例の割り当てを再掲せず、未定義の割り当ても使いません。共通凡例がなければ本書の対応表と「見栄えを整える最小限スタイル」を使い、図ごとの独自割り当ては追加しません。
243
174
  - 物の流れを使わない場合は「`->` は情報・実行要求の流れ。本図は物の流れを対象外とする」と記述します。
244
-
245
175
  - 図を分ける観点とノード数の目安は包含元の rulebook に従います(全体概要はトランザクションデータの図とマスタ・構成データの図、プロセスグループ別 CDFD は業務の性質が近いプロセス単位、ユースケース別 CDFD は連続する業務の範囲)。分けた図の間で同じプロセス ID・名称を維持します。ユースケース別 CDFD では、共有する参加単位・データストアの名称と領域 ID で接続を追跡し、引き渡し ID は付けません。
246
176
  - ノードの表示ラベルは1行あたり全角20字(半角40字)程度を目安にし、超える場合は `\n` で改行して2行程度に収めます。エッジラベルは改行に頼らず短い名詞句に収めます。
247
177
 
248
178
  ### 6.5. 見栄えを整える最小限スタイル(任意)
249
179
 
250
- - ノード形状による意味区別を優先し、色は形状だけでは見分けにくい場合の補助として使います。
251
- - 色を付ける場合は `classes` のみを使用し、ノード単位の `style` による個別指定はしません。
252
-
253
- - 色は必ずプロセス/イベント/データストア/外部主体という概念の大分類単位で色相(Hue)を統一し、異なる大分類の間で色相を混同しません。
254
- - 大分類の中に業務上意味のあるサブ分類がある場合(例: データストアにおけるマスタ・構成データとトランザクションデータの違い)は、大分類の色相を保ったまま、濃淡・彩度を変えた同系統色でサブ分類を塗り分けられます。サブ分類の色分けを行う場合は、本プロダクト共通の凡例にサブ分類の名称と対応する色を定義し、「凡例と可読性」の方針で参照します。
255
- - サブ分類の色分けは、業務上の判断(変更頻度、更新契機、参照される側か更新される側かなど)で区別できる場合にだけ使います。区別基準を説明できないサブ分類の塗り分けはしません。
256
- - 色を使わなくても意味が読み取れる図では、無理に色を付けません。
180
+ - 形状で意味を読めれば色は不要です。色を付ける場合は `classes` と `class` に限り、ノード単位の `style` 指定はしません。
181
+ - プロセス/イベント/データストア/外部主体ごとに色相を統一し、大分類間で混同しません。
182
+ - 大分類内は、変更頻度・更新契機・参照側/更新側などの業務上の区別を説明できる場合だけ、同系統色の濃淡・彩度で分けられます。サブ分類名と色は共通凡例に定義します。
257
183
 
258
184
  ```d2
259
185
  direction: down
@@ -353,7 +279,7 @@ sales_ledger: "販売記録簿" {
353
279
  }
354
280
  ```
355
281
 
356
- 凡例には「円柱(薄い緑 `#e8f5e9` / `#43a047`)はマスタ・構成データ、円柱(中間の緑 `#c8e6c9` / `#2e7d32`)はトランザクションデータ、大角丸四角形(トランザクションデータと同色 `#c8e6c9` / `#2e7d32`)は物理保管」のように、大分類の形状の意味に加えてサブ分類の色の意味を明記します。
282
+ この例の凡例では形状に加え、薄い緑(`#e8f5e9` / `#43a047`)をマスタ・構成データ、中間の緑(`#c8e6c9` / `#2e7d32`)をトランザクションデータ、同色の大角丸四角形を物理保管と定義します。
357
283
 
358
284
  ## 7. 禁止事項
359
285
 
@@ -361,7 +287,6 @@ sales_ledger: "販売記録簿" {
361
287
  - プロセスとデータストア、イベントと外部主体など、異なる概念へ同じノード形状を使用しません。
362
288
  - 全体概要にプロセスグループ内の領域や処理を複数ノードで展開したり、プロセスグループをコンテナで表したり、プロセスグループ別 CDFD に他グループの内部処理を作り込んだりしません。
363
289
  - 物理テーブル、物理カラム、実装クラス、関数、詳細 API、コマンドオプションをノードやエッジへ記載しません。
364
- - 独自形状の追加、根拠のないノード単位の色付け、ノード単位の `style` による個別指定は行いません。色は概念の大分類単位、または大分類内の同系統色によるサブ分類単位の `classes` としてのみ使用します。
365
- - 大分類間で色相を混同する、または区別基準を説明できないままサブ分類の色を増やすことはしません。
290
+ - 独自形状、根拠のないノード単位の色付け、大分類間での色相の混同、区別基準のないサブ分類を追加しません。スタイルは「見栄えを整える最小限スタイル」に従います。
366
291
  - 起点も到達先も説明できないノード、自己ループだけで完結するプロセス、読み手が解釈できない略語を残しません。
367
292
  - 外部ファイルのインポート(import)、および layers・scenarios・steps による複数ページ出力を使いません(1 ブロック 1 SVG 出力の描画仕様に従います)。
@@ -16,18 +16,17 @@ specdojo:
16
16
 
17
17
  Conceptual Data Flow Diagram Notation Rulebook for Mermaid
18
18
 
19
- Mermaid の `flowchart` 構文で CDFD のプロセス、イベント、データストア、外部主体、情報・物の流れを一貫して表すための記法ルールです。`specdojo:cdfd-overview-rulebook`、`specdojo:cdfd-rulebook`、`specdojo:cdfd-uc-rulebook` の `includes` から適用される共通部品です。対象プロダクトの `cdfd-overview` に「凡例(本プロダクト共通)」がある場合はその割り当てを正本とし、共通凡例がない場合は本 rulebook の形状・線種と既定の色・絵文字方針に従います。
19
+ Mermaid の `flowchart` で CDFD のプロセス・イベント・データストア・外部主体・受け渡しを表す記法ルールです。全体概要・プロセスグループ別・ユースケース別 CDFD の主 rulebook の `includes` から適用します。プロダクト固有の割り当ては全体概要の「凡例(本プロダクト共通)」、共通凡例がなければ本書の既定凡例を使います。
20
20
 
21
21
  ## 1. 全体方針
22
22
 
23
23
  - Mermaid の `flowchart` を使用し、方向は全体概要・プロセスグループ別・ユースケース別 CDFD を問わず `LR` を基本とします。CDFD の矢印は情報・物・実行要求の受け渡しを表し、ユースケース別など包含元が明示した場合だけ業務上の順序も表します。`TB` は、対象が階層構造(組織・分類など)を表す場合にだけ使用します。以下では、プロセスグループ別とユースケース別を合わせて「詳細 CDFD」と呼びます。
24
-
25
- - 図が読みにくくなる原因は方向ではなく規模です。ノード数が多く一画面で関係を追いにくい場合は、方向を変えるのではなく、「凡例と可読性」の分割方針に従って図を分けます。分割の観点(全体概要はデータストアの区分、プロセスグループ別 CDFD は業務の性質が近いプロセス)とノード数の目安は包含元の rulebook が定めます。
24
+ - 一画面で関係を追いにくい場合は「凡例と可読性」に従って分割します。分割単位とノード数の目安は包含元が定めます。
26
25
  - 全体概要とユースケース別 CDFD では、一つのプロセスグループを一つの代表ノードで表し、グループ内の領域や処理へ展開しません。プロセスグループ別 CDFD では、一つのプロセスを一つのプロセスノードで表します。
27
26
  - 一つの記号へ一つの意味を割り当て、ノード形状だけでプロセス、イベント、データストア、外部主体を区別できるようにします。
28
-
29
27
  - 情報の流れと物の流れは線種で区別し、すべてのエッジへ内容を表す名詞形のラベルを付けます。
30
- - 図の目的は業務上の合意であり、装飾や実装構造の再現ではありません。ノード形状で意味を区別することを基本とし、色は形状だけでは判別しにくい場合の視認性向上に、プロセス/イベント/データストア/外部主体という概念の大分類単位で付けます。業務上の区別が必要な場合は、大分類内を同系統色の濃淡・彩度で分けられます。物理名、詳細な操作は使用しません。
28
+ - 業務上の合意に必要な概念を形状で区別し、色は「見栄えを整える最小限スタイル」に従う補助表現とします。物理名や詳細な操作は使いません。
29
+ - **共通の運用**: 役割は適用先のメンバー定義に、`status`・承認・改訂と廃止・未決事項の引き継ぎは [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] に従います。整形・lint はリポジトリの検証で扱い、業務の受入確認に含めません。
31
30
 
32
31
  | 概念 | Mermaid 表現 | 表示例 |
33
32
  | -------------------- | ------------------------------------------------------------------------------------ | ------------------------------------------------ |
@@ -43,12 +42,7 @@ Mermaid の `flowchart` 構文で CDFD のプロセス、イベント、デー
43
42
 
44
43
  ## 2. 位置づけと用語定義
45
44
 
46
- | 用語 | 定義 |
47
- | ------------ | -------------------------------------------------------------------------- |
48
- | ノード ID | Mermaid コード内で要素を参照する識別子。短い日本語または英数字を使う |
49
- | 表示ラベル | 図上で読み手に見せる名称。業務用語と領域 ID を必要に応じて併記する |
50
- | エッジラベル | 移動する情報・物、またはイベントから伝わる起動条件の名称 |
51
- | サブグラフ | 関連するプロセスを囲む視覚上のまとまり。プロセスグループの表現には使わない |
45
+ コード内で要素を参照するノード ID と、図上に見せる表示ラベルを区別します。表示ラベルは業務用語に必要な領域 ID を併記し、エッジラベルは渡す情報・物・起動条件の名称とします。
52
46
 
53
47
  - ノード ID と表示ラベルは同じ名称を基本とし、空白、記号、補足を含む表示が必要な場合だけ分けます。
54
48
  - 担当を表示する場合は、プロセスの表示ラベル末尾へ `<br>(担当: ロール)` を付けます。
@@ -58,28 +52,16 @@ Mermaid の `flowchart` 構文で CDFD のプロセス、イベント、デー
58
52
 
59
53
  - 本 rulebook は独立した成果物を生成せず、`cdfd-*.md` 内の Mermaid コードブロックへ適用します。
60
54
  - Mermaid コードブロックに独立した文書 ID は付けず、包含する CDFD の ID とプロセス ID で追跡します。
61
- - ノード ID は一つのコードブロック内で一意にし、同じ対象には表と図で同じ領域 ID または名称を使用します。
55
+ - ノード ID は短い日本語または英数字で、ブロック内で一意にし、同じ対象には表と図で同じ領域 ID または名称を使用します。
62
56
  - 複数図に分ける場合は、包含する CDFD 本文の見出しで図の観点を識別します。
63
57
 
64
58
  ## 4. 推奨 Frontmatter 項目
65
59
 
66
- - 本 rulebook は `specdojo:cdfd-overview-rulebook`、`specdojo:cdfd-rulebook`、`specdojo:cdfd-uc-rulebook` の `includes` から適用されるため、成果物 Frontmatter に記法 rulebook を重複記載しません。
67
- - 成果物の `rulebook` は、図種別に応じて構造を定義する上記いずれかの主 CDFD rulebook を指定します。例えばプロセスグループ別 CDFD は `rulebook: specdojo:cdfd-rulebook` とします。
68
- - 記法だけを別ファイルで適用する運用は行わず、主 CDFD rulebook と組み合わせます。
69
-
70
- プロセスグループ別 CDFD の記載例:
71
-
72
- ```yaml
73
- specdojo:
74
- id: cdfd-purchasing
75
- type: flow
76
- status: draft
77
- rulebook: specdojo:cdfd-rulebook
78
- ```
60
+ 成果物の `rulebook` は図種別を定める主 CDFD rulebook とし、本記法を重複記載しません。記法単独では適用しません。プロセスグループ別なら `rulebook: specdojo:cdfd-rulebook` とします。
79
61
 
80
62
  ## 5. 本文構成(標準テンプレ)
81
63
 
82
- Mermaid コードブロック内は、次の順序を基本とします。必須の判定は図種別で異なります。全体概要ではプロセスグループの代表ノード、データストア、情報の流れを必須とし、イベントはプロセス領域の表に記載して図に描きません。プロセスグループ別 CDFD では個別プロセス、イベント、データストア、情報・物の流れを必須とします。ユースケース別 CDFD ではプロセスグループの代表ノード、開始・引き渡し・終了のイベント、情報・物の流れを必須とし、データストアは引き渡し条件の判定に必要な場合だけ置きます。外部主体と物理保管はいずれの図種別でも存在する場合だけ置きます。全図で図直後の注記を必須とし、共通凡例の有無に応じて参照先または本 rulebook の既定凡例を使う旨を示します。
64
+ コードは次表の順を基本とします。全体概要はグループ代表・データストア・情報の流れ、プロセスグループ別は個別プロセス・イベント・データストア・情報/物の流れを必須とします。外部主体・物理保管は存在する場合だけ置き、全図に直後の注記を付けます。ユースケース別のイベントも必須です。
83
65
 
84
66
  | 順序 | 区分 | 必須 | 内容 |
85
67
  | ---- | -------------- | -------- | ------------------------------------------------------------------------------------------------------ |
@@ -115,21 +97,11 @@ flowchart LR
115
97
 
116
98
  ### 6.2. 絵文字アイコン(任意)
117
99
 
118
- 絵文字は人間の視認性向上には有効ですが、表示差や幅崩れが起きる環境もあるため、次のルールで運用します。
119
-
120
- - 絵文字は任意です(なくても成立します)。
121
- - 絵文字は表示ラベルのみに付け、ノード ID には付けません。
122
- - 1ノードにつき1個までとし、表示ラベルの先頭に付けます。
123
- - 絵文字だけに頼らず、必ずプロセス名・データストア名などのテキストも併記します。
100
+ 表示差・幅崩れを考慮し、絵文字は任意とします。表示ラベルの先頭に一つまで付け、名称のテキストを併記します。ノード ID には付けません。
124
101
 
125
102
  ```mermaid
126
103
  flowchart LR
127
- subgraph 販売領域["販売領域"]
128
- 販売記録("📋 P-01-01 販売記録<br>(担当: 店員)")
129
- end
130
- 購入要求{{"⚡ 顧客が商品の購入を要求した"}}
131
- 顧客["🏢 顧客"]
132
- 販売記録簿[("🗄️ 販売記録簿")]
104
+ 販売記録("📋 P-01-01 販売記録<br>(担当: 店員)")
133
105
  ```
134
106
 
135
107
  禁止例(絵文字がノード ID に付いている、または表示ラベルに無い):
@@ -154,22 +126,17 @@ flowchart LR
154
126
 
155
127
  ### 6.4. 凡例と可読性
156
128
 
157
- - 各図の直後に凡例の適用元を注記します。対象プロダクトの `cdfd-overview` に「凡例(本プロダクト共通)」がある場合はその章を参照し、ない場合は「ノード形状・線種・色・絵文字は `specdojo:cdfd-mermaid-rulebook` の既定凡例に従う」と記述します。いずれの場合も、図で使用した線種、図から省略した入出力と理由、別図と共有するノードを併記します。
158
- - 共通凡例がある場合、ノード形状、色、絵文字のプロダクト固有の割り当ては共通凡例を正本とし、図ごとに再掲しません。共通凡例にない割り当ては使用しません。共通凡例がない場合は、本 rulebook の対応表と「見栄えを整える最小限スタイル」を既定凡例とし、図ごとの独自割り当てを追加しません。
129
+ - 図直後に、共通凡例の参照先、使用線種、省略した入出力と理由、別図と共有するノードを示します。共通凡例がなければ「ノード形状・線種・色・絵文字は `specdojo:cdfd-mermaid-rulebook` の既定凡例に従う」と書きます。
130
+ - 共通凡例の割り当てを再掲せず、未定義の割り当ても使いません。共通凡例がなければ本書の対応表と「見栄えを整える最小限スタイル」を使い、図ごとの独自割り当ては追加しません。
159
131
  - 物の流れを使わない場合は「`-->` は情報・実行要求の流れ。本図は物の流れを対象外とする」と記述します。
160
-
161
132
  - 図を分ける観点とノード数の目安は包含元の rulebook に従います(全体概要はトランザクションデータの図とマスタ・構成データの図、プロセスグループ別 CDFD は業務の性質が近いプロセス単位、ユースケース別 CDFD は連続する引き渡し単位)。分けた図の間で同じプロセス ID・名称または引き渡し ID を維持します。
162
- - ノードの表示ラベルは1行あたり全角20字(半角40字)程度を目安にし、超える場合は `<br>` で改行して2行程度に収めます。LR ではラベルの行の長さがそのままノード幅となり横方向の占有幅に直結するため、特にイベント・データストアで長い説明文になりやすい箇所に注意します。エッジラベルは改行に頼らず短い名詞句に収めます。
133
+ - 表示ラベルは一行あたり全角20字(半角40字)程度、長ければ `<br>` で二行程度に収めます。LR では行の長さがノード幅になるため、イベント・データストアの長文を避けます。エッジラベルは改行せず短い名詞句にします。
163
134
 
164
135
  ### 6.5. 見栄えを整える最小限スタイル(任意)
165
136
 
166
- - ノード形状による意味区別を優先し、色は形状だけでは見分けにくい場合の補助として使います。
167
- - 色を付ける場合は `classDef` のみを使用し、`style` によるノード単位の個別指定はしません。
168
-
169
- - 色は必ずプロセス/イベント/データストア/外部主体という概念の大分類単位で色相(Hue)を統一し、異なる大分類の間で色相を混同しません。
170
- - 大分類の中に業務上意味のあるサブ分類がある場合(例: データストアにおけるマスタ・構成データとトランザクションデータの違い)は、大分類の色相を保ったまま、濃淡・彩度を変えた同系統色でサブ分類を塗り分けられます。サブ分類の色分けを行う場合は、本プロダクト共通の凡例にサブ分類の名称と対応する色を定義し、「凡例と可読性」の方針で参照します。
171
- - サブ分類の色分けは、業務上の判断(変更頻度、更新契機、参照される側か更新される側かなど)で区別できる場合にだけ使います。区別基準を説明できないサブ分類の塗り分けはしません。
172
- - 色を使わなくても意味が読み取れる図では、無理に色を付けません。
137
+ - 形状で意味を読めれば色は不要です。色を付ける場合は `classDef` に限り、ノード単位の `style` 指定はしません。
138
+ - プロセス/イベント/データストア/外部主体ごとに色相を統一し、大分類間で混同しません。
139
+ - 大分類内は、変更頻度・更新契機・参照側/更新側などの業務上の区別を説明できる場合だけ、同系統色の濃淡・彩度で分けられます。サブ分類名と色は共通凡例に定義します。
173
140
 
174
141
  ```mermaid
175
142
  flowchart LR
@@ -208,7 +175,7 @@ flowchart LR
208
175
  class 販売記録簿 storeTransaction
209
176
  ```
210
177
 
211
- 凡例には「円柱(薄い緑 `#e8f5e9` / `#43a047`)はマスタ・構成データ、円柱(中間の緑 `#c8e6c9` / `#2e7d32`)はトランザクションデータ、スタジアム形(トランザクションデータと同色 `#c8e6c9` / `#2e7d32`)は物理保管」のように、大分類の形状の意味に加えてサブ分類の色の意味を明記します。
178
+ この例の凡例では形状に加え、薄い緑(`#e8f5e9` / `#43a047`)をマスタ・構成データ、中間の緑(`#c8e6c9` / `#2e7d32`)をトランザクションデータ、同色のスタジアム形を物理保管と定義します。
212
179
 
213
180
  ## 7. 禁止事項
214
181
 
@@ -216,6 +183,5 @@ flowchart LR
216
183
  - プロセスとデータストア、イベントと外部主体など、異なる概念へ同じノード形状を使用しません。
217
184
  - 全体概要にプロセスグループ内の領域や処理を複数ノードで展開したり、プロセスグループを `subgraph` で表したり、プロセスグループ別 CDFD に他グループの内部処理を作り込んだりしません。
218
185
  - 物理テーブル、物理カラム、実装クラス、関数、詳細 API、コマンドオプションをノードやエッジへ記載しません。
219
- - 独自形状の追加、根拠のないノード単位の色付け、`style` による個別指定は行いません。色は概念の大分類単位、または大分類内の同系統色によるサブ分類単位の `classDef` としてのみ使用します。
220
- - 大分類間で色相を混同する、または区別基準を説明できないままサブ分類の色を増やすことはしません。
186
+ - 独自形状、根拠のないノード単位の色付け、大分類間での色相の混同、区別基準のないサブ分類を追加しません。スタイルは「見栄えを整える最小限スタイル」に従います。
221
187
  - 起点も到達先も説明できないノード、自己ループだけで完結するプロセス、読み手が解釈できない略語を残しません。