specdojo 0.7.0 → 0.9.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (462) hide show
  1. package/.github/agents/specdojo-orchestrator.md +7 -3
  2. package/CHANGELOG.md +217 -0
  3. package/dist/catalog/build.js +24 -1
  4. package/dist/catalog/catalog.js +16 -14
  5. package/dist/catalog/plan.js +1 -1
  6. package/dist/catalog/scaffold.js +4 -1
  7. package/dist/commands/agent.js +5 -3
  8. package/dist/commands/build.js +69 -10
  9. package/dist/commands/git.js +206 -0
  10. package/dist/commands/init.js +9 -3
  11. package/dist/commands/night-orchestrator.js +6 -4
  12. package/dist/commands/where.js +25 -0
  13. package/dist/dashboard/dashboard-timeline.js +18 -16
  14. package/dist/dashboard/dashboard.js +616 -261
  15. package/dist/dashboard/epic-plan.js +81 -0
  16. package/dist/dashboard/exec-records.js +16 -20
  17. package/dist/dashboard/routines.js +11 -12
  18. package/dist/dashboard/timeline-build.js +5 -9
  19. package/dist/dashboard/timeline.js +23 -18
  20. package/dist/devcontainer/scaffold.js +18 -0
  21. package/dist/docs/frontmatter-namespace.js +1 -48
  22. package/dist/docs/index-command.js +2 -2
  23. package/dist/docs/yaml-business-tables.js +243 -0
  24. package/dist/docs/yaml-interface-tables.js +106 -0
  25. package/dist/docs/yaml-pages-command.js +5 -3
  26. package/dist/docs/yaml-pages.js +268 -3
  27. package/dist/docs/yaml-table-shared.js +70 -0
  28. package/dist/docs/yaml-tables.js +39 -0
  29. package/dist/exec/agent-config.js +31 -0
  30. package/dist/exec/agent-plan.js +3 -2
  31. package/dist/exec/agent-protected-config.js +2 -0
  32. package/dist/exec/commands.js +100 -39
  33. package/dist/exec/commit-hook-skips.js +78 -0
  34. package/dist/exec/core.js +19 -7
  35. package/dist/exec/events.js +179 -8
  36. package/dist/exec/evidence.js +77 -19
  37. package/dist/exec/handoff.js +9 -13
  38. package/dist/exec/limit.js +1 -1
  39. package/dist/exec/mechanical-result.js +45 -0
  40. package/dist/exec/migrate-records.js +249 -0
  41. package/dist/exec/parent-validation.js +209 -15
  42. package/dist/exec/pipeline-state.js +27 -5
  43. package/dist/exec/plans-condense-findings.js +89 -0
  44. package/dist/exec/plans-core.js +45 -19
  45. package/dist/exec/plans-generation.js +52 -30
  46. package/dist/exec/plans-grade-findings.js +8 -3
  47. package/dist/exec/plans-kata-findings.js +61 -0
  48. package/dist/exec/plans-planning.js +3 -3
  49. package/dist/exec/plans-storage.js +12 -24
  50. package/dist/exec/post-integration.js +162 -0
  51. package/dist/exec/queue-command.js +166 -0
  52. package/dist/exec/queue.js +285 -0
  53. package/dist/exec/register-foreign-wait.js +84 -0
  54. package/dist/exec/register-resume.js +55 -56
  55. package/dist/exec/register.js +26 -22
  56. package/dist/exec/repo-integration-sync.js +21 -5
  57. package/dist/exec/repo-integration.js +21 -1
  58. package/dist/exec/reporter.js +121 -23
  59. package/dist/exec/results.js +106 -25
  60. package/dist/exec/review-completion.js +47 -0
  61. package/dist/exec/review-kata.js +112 -0
  62. package/dist/exec/run/agent-pipeline.js +78 -8
  63. package/dist/exec/run/agent.js +32 -13
  64. package/dist/exec/run/change-scope.js +365 -0
  65. package/dist/exec/run/deferred-cleanup.js +31 -0
  66. package/dist/exec/run/in-place.js +73 -33
  67. package/dist/exec/run/job-lock.js +66 -0
  68. package/dist/exec/run/job-sequence.js +137 -0
  69. package/dist/exec/run/job.js +135 -41
  70. package/dist/exec/run/lifecycle-commands.js +189 -37
  71. package/dist/exec/run/lock.js +22 -1
  72. package/dist/exec/run/mode-shared.js +11 -3
  73. package/dist/exec/run/register-command.js +14 -15
  74. package/dist/exec/run/register-core.js +20 -13
  75. package/dist/exec/run/register-mode.js +77 -17
  76. package/dist/exec/run/register-post-review.js +21 -9
  77. package/dist/exec/run/register-resume.js +95 -31
  78. package/dist/exec/run/register-state.js +23 -15
  79. package/dist/exec/run/register-worktree.js +184 -139
  80. package/dist/exec/run/schedule-mode.js +79 -18
  81. package/dist/exec/run/schedule-prepare.js +204 -59
  82. package/dist/exec/run/schedule-task.js +203 -49
  83. package/dist/exec/run/shared.js +9 -3
  84. package/dist/exec/run/trailing-records.js +35 -0
  85. package/dist/exec/run-records.js +2 -0
  86. package/dist/exec/schedule/schedule.js +116 -4
  87. package/dist/exec/shared.js +1 -1
  88. package/dist/exec/smoke.js +190 -0
  89. package/dist/exec/strategy.js +14 -3
  90. package/dist/exec/task-view.js +6 -4
  91. package/dist/exec/trailing-records.js +242 -0
  92. package/dist/exec/trial-commands.js +8 -4
  93. package/dist/exec/trial-core.js +6 -1
  94. package/dist/exec/validate-records-commit.js +110 -0
  95. package/dist/exec/validate-records.js +148 -0
  96. package/dist/exec/validation-metrics.js +181 -0
  97. package/dist/exec/worktree-cleanup-lock.js +26 -0
  98. package/dist/exec/worktree-command.js +38 -17
  99. package/dist/exec/worktree-ops-commit.js +119 -48
  100. package/dist/exec/worktree-ops-lifecycle.js +77 -48
  101. package/dist/exec/worktree-ops-merge.js +13 -2
  102. package/dist/exec/worktree-ops.js +2 -2
  103. package/dist/exec/worktree.js +32 -4
  104. package/dist/grade/apply.js +32 -6
  105. package/dist/grade/command-apply.js +3 -3
  106. package/dist/grade/command-inspect.js +7 -5
  107. package/dist/grade/command-plan.js +1 -1
  108. package/dist/grade/command-run.js +7 -1
  109. package/dist/grade/command-shared.js +1 -1
  110. package/dist/grade/core.js +18 -5
  111. package/dist/grade/markdown.js +3 -3
  112. package/dist/grade/pipeline-state.js +15 -11
  113. package/dist/grade/plan.js +37 -17
  114. package/dist/grade/result.js +3 -3
  115. package/dist/grade/run.js +87 -11
  116. package/dist/grade/target-discovery.js +17 -4
  117. package/dist/grade/targets.js +12 -11
  118. package/dist/job/definition.js +84 -8
  119. package/dist/job/job.js +109 -39
  120. package/dist/job/noop.js +104 -0
  121. package/dist/register/authoring-sources.js +22 -16
  122. package/dist/register/core.js +2 -0
  123. package/dist/register/create-commands.js +28 -3
  124. package/dist/register/deliverable-target.js +9 -1
  125. package/dist/register/epic.js +104 -26
  126. package/dist/register/event-merge.js +3 -0
  127. package/dist/register/events.js +4 -0
  128. package/dist/register/external-project.js +3 -0
  129. package/dist/register/item.js +6 -0
  130. package/dist/register/maintenance-commands.js +6 -3
  131. package/dist/register/planning.js +7 -14
  132. package/dist/register/register.js +74 -16
  133. package/dist/register/track-domains.js +34 -0
  134. package/dist/register/track-plan.js +78 -0
  135. package/dist/register/transition-commands.js +8 -0
  136. package/dist/register/work-table.js +64 -0
  137. package/dist/review/grade.js +35 -13
  138. package/dist/routine/definition.js +13 -3
  139. package/dist/routine/failure.js +30 -0
  140. package/dist/routine/routine.js +189 -71
  141. package/dist/routine/status.js +62 -0
  142. package/dist/routine/storage.js +33 -0
  143. package/dist/schedule/schedule.js +39 -39
  144. package/dist/schedule/strategy-generate-document.js +26 -14
  145. package/dist/schedule/strategy-generate-scope.js +17 -45
  146. package/dist/schedule/strategy-generate.js +33 -3
  147. package/dist/schedule/strategy-profiles.js +86 -12
  148. package/dist/shared/agent-types.js +7 -0
  149. package/dist/shared/condense-records.js +25 -0
  150. package/dist/shared/cross-process-lock.js +9 -1
  151. package/dist/shared/deprecation.js +8 -0
  152. package/dist/shared/dist-freshness.js +8 -2
  153. package/dist/shared/document-metadata.js +20 -0
  154. package/dist/shared/finding-cause.js +20 -0
  155. package/dist/shared/frontmatter-namespace.js +48 -0
  156. package/dist/shared/git-environment.js +2 -1
  157. package/dist/shared/git.js +186 -16
  158. package/dist/shared/grade-result.js +17 -1
  159. package/dist/shared/lefthook-scaffold.js +3 -0
  160. package/dist/shared/local-config.js +244 -0
  161. package/dist/shared/local-state.js +20 -0
  162. package/dist/shared/markdownlint-config.js +8 -3
  163. package/dist/shared/plan-conventions.js +129 -0
  164. package/dist/shared/plan-templates.js +57 -41
  165. package/dist/shared/run-records.js +224 -0
  166. package/dist/shared/specdojo-config.js +73 -41
  167. package/dist/shared/specdojo-gitignore.js +1 -0
  168. package/dist/shared/text.js +74 -6
  169. package/dist/shared/timeline-index.js +2 -0
  170. package/dist/shared/where-alias.js +13 -0
  171. package/dist/specdojo.js +4 -0
  172. package/docs/ja/specdojo/defaults/pm-review-viewpoints.yaml +11 -2
  173. package/docs/ja/specdojo/exec-templates/xep-common-conventions-template.md +4 -74
  174. package/docs/ja/specdojo/exec-templates/xep-condense-template.md +50 -0
  175. package/docs/ja/specdojo/exec-templates/xep-draft-template.md +17 -5
  176. package/docs/ja/specdojo/exec-templates/xep-fully-guided-template.md +16 -3
  177. package/docs/ja/specdojo/exec-templates/xep-recipe-guided-template.md +15 -5
  178. package/docs/ja/specdojo/exec-templates/xep-recipe-maintenance-template.md +6 -0
  179. package/docs/ja/specdojo/exec-templates/xep-register-template.md +1 -1
  180. package/docs/ja/specdojo/exec-templates/xep-rulebook-maintenance-template.md +6 -0
  181. package/docs/ja/specdojo/exec-templates/xep-sample-maintenance-template.md +6 -0
  182. package/docs/ja/specdojo/exec-templates/xep-template-maintenance-template.md +6 -0
  183. package/docs/ja/specdojo/exec-templates/xer-condense-template.md +25 -0
  184. package/docs/ja/specdojo/exec-templates/xp-common-conventions-template.md +50 -0
  185. package/docs/ja/specdojo/exec-templates/xrp-common-conventions-template.md +30 -0
  186. package/docs/ja/specdojo/guides/branch-workflow-guide.md +1 -1
  187. package/docs/ja/specdojo/guides/docs-editing-guide.md +12 -0
  188. package/docs/ja/specdojo/guides/docs-structure-guide.md +48 -15
  189. package/docs/ja/specdojo/guides/exec-config-guide.md +69 -19
  190. package/docs/ja/specdojo/guides/exec-operation-guide.md +97 -18
  191. package/docs/ja/specdojo/guides/exec-worktree-guide.md +20 -11
  192. package/docs/ja/specdojo/guides/job-sequence-guide.md +77 -0
  193. package/docs/ja/specdojo/guides/plan-result-lifecycle-guide.md +92 -55
  194. package/docs/ja/specdojo/guides/project-move-guide.md +381 -0
  195. package/docs/ja/specdojo/guides/quick-start-guide.md +73 -17
  196. package/docs/ja/specdojo/guides/register-operation-guide.md +26 -6
  197. package/docs/ja/specdojo/guides/remote-host-development-guide.md +2 -0
  198. package/docs/ja/specdojo/guides/review-guide.md +22 -19
  199. package/docs/ja/specdojo/guides/routine-operation-guide.md +23 -12
  200. package/docs/ja/specdojo/guides/ryu-guide.md +23 -13
  201. package/docs/ja/specdojo/guides/schedule-design-guide.md +27 -21
  202. package/docs/ja/specdojo/guides/schedule-operation-guide.md +27 -3
  203. package/docs/ja/specdojo/guides/specdojo-overview-guide.md +5 -4
  204. package/docs/ja/specdojo/guides/timeline-design-guide.md +27 -144
  205. package/docs/ja/specdojo/guides/use-case-guide.md +92 -155
  206. package/docs/ja/specdojo/guides/waza-guide.md +12 -8
  207. package/docs/ja/specdojo/recipes/bac-recipe.md +111 -0
  208. package/docs/ja/specdojo/recipes/bes-recipe.md +141 -0
  209. package/docs/ja/specdojo/recipes/bps-recipe.md +88 -139
  210. package/docs/ja/specdojo/recipes/br-recipe.md +77 -0
  211. package/docs/ja/specdojo/recipes/cdfd-overview-recipe.md +97 -109
  212. package/docs/ja/specdojo/recipes/cdfd-recipe.md +85 -146
  213. package/docs/ja/specdojo/recipes/cdfd-uc-recipe.md +92 -99
  214. package/docs/ja/specdojo/recipes/cnd-recipe.md +135 -0
  215. package/docs/ja/specdojo/recipes/cpd-recipe.md +140 -0
  216. package/docs/ja/specdojo/recipes/cxd-recipe.md +162 -0
  217. package/docs/ja/specdojo/recipes/ifd-recipe.md +145 -0
  218. package/docs/ja/specdojo/recipes/ifx-cmd-recipe.md +112 -90
  219. package/docs/ja/specdojo/recipes/ifx-index-recipe.md +164 -0
  220. package/docs/ja/specdojo/recipes/pm-communication-plan-recipe.md +60 -49
  221. package/docs/ja/specdojo/recipes/pm-members-recipe.md +50 -51
  222. package/docs/ja/specdojo/recipes/pm-organization-recipe.md +59 -48
  223. package/docs/ja/specdojo/recipes/pm-plan-recipe.md +72 -50
  224. package/docs/ja/specdojo/recipes/pm-quality-management-plan-recipe.md +40 -49
  225. package/docs/ja/specdojo/recipes/pm-raci-recipe.md +42 -48
  226. package/docs/ja/specdojo/recipes/pm-roles-recipe.md +52 -81
  227. package/docs/ja/specdojo/recipes/prj-assumptions-constraints-dependencies-recipe.md +64 -91
  228. package/docs/ja/specdojo/recipes/prj-charter-recipe.md +71 -106
  229. package/docs/ja/specdojo/recipes/prj-comparison-of-alternatives-recipe.md +78 -156
  230. package/docs/ja/specdojo/recipes/prj-issues-and-approach-recipe.md +62 -111
  231. package/docs/ja/specdojo/recipes/prj-scope-recipe.md +67 -123
  232. package/docs/ja/specdojo/recipes/prj-stakeholder-register-recipe.md +60 -96
  233. package/docs/ja/specdojo/recipes/prj-success-criteria-and-acceptance-criteria-recipe.md +61 -105
  234. package/docs/ja/specdojo/recipes/stsd-recipe.md +88 -80
  235. package/docs/ja/specdojo/recipes/sysd-critical-flows-recipe.md +129 -0
  236. package/docs/ja/specdojo/recipes/sysd-cross-cutting-policy-recipe.md +146 -0
  237. package/docs/ja/specdojo/recipes/sysd-index-recipe.md +141 -0
  238. package/docs/ja/specdojo/recipes/tsd-recipe.md +149 -129
  239. package/docs/ja/specdojo/references/command-reference.md +303 -148
  240. package/docs/ja/specdojo/references/deliverables-reference.md +30 -16
  241. package/docs/ja/specdojo/references/directory-layout-reference.md +3 -2
  242. package/docs/ja/specdojo/references/specdojo-config-reference.md +54 -18
  243. package/docs/ja/specdojo/rulebooks/atc-index-rulebook.md +101 -257
  244. package/docs/ja/specdojo/rulebooks/atc-rulebook.md +102 -228
  245. package/docs/ja/specdojo/rulebooks/bac-rulebook.md +63 -290
  246. package/docs/ja/specdojo/rulebooks/bdd-rulebook.md +162 -80
  247. package/docs/ja/specdojo/rulebooks/bds-rulebook.md +118 -155
  248. package/docs/ja/specdojo/rulebooks/bes-index-rulebook.md +128 -60
  249. package/docs/ja/specdojo/rulebooks/bes-rulebook.md +70 -94
  250. package/docs/ja/specdojo/rulebooks/bps-rulebook.md +24 -56
  251. package/docs/ja/specdojo/rulebooks/br-rulebook.md +58 -103
  252. package/docs/ja/specdojo/rulebooks/ccd-mermaid-rulebook.md +103 -223
  253. package/docs/ja/specdojo/rulebooks/cdfd-d2-rulebook.md +18 -93
  254. package/docs/ja/specdojo/rulebooks/cdfd-mermaid-rulebook.md +18 -52
  255. package/docs/ja/specdojo/rulebooks/cdfd-overview-rulebook.md +109 -147
  256. package/docs/ja/specdojo/rulebooks/cdfd-rulebook.md +80 -108
  257. package/docs/ja/specdojo/rulebooks/cdfd-uc-rulebook.md +51 -55
  258. package/docs/ja/specdojo/rulebooks/cdr-rulebook.md +144 -0
  259. package/docs/ja/specdojo/rulebooks/cdsd-rulebook.md +81 -68
  260. package/docs/ja/specdojo/rulebooks/cdt-rulebook.md +139 -0
  261. package/docs/ja/specdojo/rulebooks/cld-rulebook.md +9 -184
  262. package/docs/ja/specdojo/rulebooks/clis-rulebook.md +170 -0
  263. package/docs/ja/specdojo/rulebooks/cnd-mermaid-rulebook.md +33 -86
  264. package/docs/ja/specdojo/rulebooks/cnd-rulebook.md +79 -249
  265. package/docs/ja/specdojo/rulebooks/cop-index-rulebook.md +45 -131
  266. package/docs/ja/specdojo/rulebooks/cop-rulebook.md +69 -275
  267. package/docs/ja/specdojo/rulebooks/cpd-mermaid-rulebook.md +20 -112
  268. package/docs/ja/specdojo/rulebooks/cpd-rulebook.md +79 -249
  269. package/docs/ja/specdojo/rulebooks/cxd-mermaid-rulebook.md +12 -145
  270. package/docs/ja/specdojo/rulebooks/cxd-rulebook.md +115 -256
  271. package/docs/ja/specdojo/rulebooks/dct-index-rulebook.md +79 -109
  272. package/docs/ja/specdojo/rulebooks/dct-rulebook.md +119 -174
  273. package/docs/ja/specdojo/rulebooks/dec-rulebook.md +6 -14
  274. package/docs/ja/specdojo/rulebooks/dmd-index-rulebook.md +22 -66
  275. package/docs/ja/specdojo/rulebooks/dmd-rulebook.md +36 -94
  276. package/docs/ja/specdojo/rulebooks/dss-rulebook.md +171 -0
  277. package/docs/ja/specdojo/rulebooks/etc-index-rulebook.md +31 -131
  278. package/docs/ja/specdojo/rulebooks/etc-rulebook.md +50 -104
  279. package/docs/ja/specdojo/rulebooks/gl-rulebook.md +93 -57
  280. package/docs/ja/specdojo/rulebooks/ifd-mermaid-rulebook.md +63 -253
  281. package/docs/ja/specdojo/rulebooks/ifx-api-rulebook.md +14 -20
  282. package/docs/ja/specdojo/rulebooks/ifx-cmd-rulebook.md +79 -76
  283. package/docs/ja/specdojo/rulebooks/ifx-file-rulebook.md +182 -237
  284. package/docs/ja/specdojo/rulebooks/ifx-index-rulebook.md +111 -40
  285. package/docs/ja/specdojo/rulebooks/ifx-msg-rulebook.md +14 -22
  286. package/docs/ja/specdojo/rulebooks/imp-business-rulebook.md +23 -46
  287. package/docs/ja/specdojo/rulebooks/imp-data-rulebook.md +41 -64
  288. package/docs/ja/specdojo/rulebooks/imp-interface-rulebook.md +16 -40
  289. package/docs/ja/specdojo/rulebooks/imp-operations-rulebook.md +34 -61
  290. package/docs/ja/specdojo/rulebooks/imp-test-rulebook.md +27 -50
  291. package/docs/ja/specdojo/rulebooks/itc-index-rulebook.md +70 -199
  292. package/docs/ja/specdojo/rulebooks/itc-rulebook.md +65 -153
  293. package/docs/ja/specdojo/rulebooks/mip-index-rulebook.md +74 -150
  294. package/docs/ja/specdojo/rulebooks/mm-rulebook.md +12 -23
  295. package/docs/ja/specdojo/rulebooks/mtp-rulebook.md +99 -176
  296. package/docs/ja/specdojo/rulebooks/nfr-availability-rulebook.md +35 -61
  297. package/docs/ja/specdojo/rulebooks/nfr-index-rulebook.md +75 -117
  298. package/docs/ja/specdojo/rulebooks/nfr-integrity-rulebook.md +31 -60
  299. package/docs/ja/specdojo/rulebooks/nfr-maintainability-rulebook.md +26 -81
  300. package/docs/ja/specdojo/rulebooks/nfr-operations-rulebook.md +32 -70
  301. package/docs/ja/specdojo/rulebooks/nfr-performance-rulebook.md +45 -87
  302. package/docs/ja/specdojo/rulebooks/nfr-reliability-rulebook.md +48 -101
  303. package/docs/ja/specdojo/rulebooks/nfr-security-safety-rulebook.md +44 -80
  304. package/docs/ja/specdojo/rulebooks/nfr-usability-rulebook.md +59 -127
  305. package/docs/ja/specdojo/rulebooks/opd-index-rulebook.md +31 -50
  306. package/docs/ja/specdojo/rulebooks/opd-rulebook.md +42 -109
  307. package/docs/ja/specdojo/rulebooks/opr-index-rulebook.md +29 -42
  308. package/docs/ja/specdojo/rulebooks/opr-rulebook.md +29 -87
  309. package/docs/ja/specdojo/rulebooks/otp-index-rulebook.md +62 -84
  310. package/docs/ja/specdojo/rulebooks/otp-rulebook.md +11 -61
  311. package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +92 -102
  312. package/docs/ja/specdojo/rulebooks/pm-change-request-log-rulebook.md +25 -34
  313. package/docs/ja/specdojo/rulebooks/pm-communication-plan-rulebook.md +30 -53
  314. package/docs/ja/specdojo/rulebooks/pm-issue-log-rulebook.md +23 -35
  315. package/docs/ja/specdojo/rulebooks/pm-members-rulebook.md +27 -45
  316. package/docs/ja/specdojo/rulebooks/pm-organization-rulebook.md +45 -59
  317. package/docs/ja/specdojo/rulebooks/pm-plan-rulebook.md +56 -66
  318. package/docs/ja/specdojo/rulebooks/pm-quality-management-plan-rulebook.md +54 -62
  319. package/docs/ja/specdojo/rulebooks/pm-raci-rulebook.md +46 -65
  320. package/docs/ja/specdojo/rulebooks/pm-risk-register-rulebook.md +28 -35
  321. package/docs/ja/specdojo/rulebooks/pm-roles-rulebook.md +65 -97
  322. package/docs/ja/specdojo/rulebooks/pr-rulebook.md +6 -18
  323. package/docs/ja/specdojo/rulebooks/prj-assumptions-constraints-dependencies-rulebook.md +48 -78
  324. package/docs/ja/specdojo/rulebooks/prj-charter-rulebook.md +23 -97
  325. package/docs/ja/specdojo/rulebooks/prj-comparison-of-alternatives-rulebook.md +61 -153
  326. package/docs/ja/specdojo/rulebooks/prj-issues-and-approach-rulebook.md +43 -116
  327. package/docs/ja/specdojo/rulebooks/prj-scope-rulebook.md +16 -51
  328. package/docs/ja/specdojo/rulebooks/prj-stakeholder-register-rulebook.md +47 -92
  329. package/docs/ja/specdojo/rulebooks/prj-success-criteria-and-acceptance-criteria-rulebook.md +25 -84
  330. package/docs/ja/specdojo/rulebooks/sac-rulebook.md +44 -107
  331. package/docs/ja/specdojo/rulebooks/sf-index-rulebook.md +106 -32
  332. package/docs/ja/specdojo/rulebooks/sf-rulebook.md +111 -61
  333. package/docs/ja/specdojo/rulebooks/sld-rulebook.md +129 -59
  334. package/docs/ja/specdojo/rulebooks/stc-index-rulebook.md +90 -189
  335. package/docs/ja/specdojo/rulebooks/stc-rulebook.md +45 -105
  336. package/docs/ja/specdojo/rulebooks/stsd-mermaid-rulebook.md +46 -40
  337. package/docs/ja/specdojo/rulebooks/stsd-rulebook.md +104 -68
  338. package/docs/ja/specdojo/rulebooks/sysd-critical-flows-rulebook.md +64 -330
  339. package/docs/ja/specdojo/rulebooks/sysd-cross-cutting-policy-rulebook.md +70 -263
  340. package/docs/ja/specdojo/rulebooks/sysd-index-rulebook.md +58 -200
  341. package/docs/ja/specdojo/rulebooks/sysd-rulebook.md +47 -60
  342. package/docs/ja/specdojo/rulebooks/tml-rulebook.md +4 -9
  343. package/docs/ja/specdojo/rulebooks/trc-requirements-to-specs-rulebook.md +69 -71
  344. package/docs/ja/specdojo/rulebooks/trc-requirements-to-tests-rulebook.md +65 -72
  345. package/docs/ja/specdojo/rulebooks/tsd-index-rulebook.md +35 -46
  346. package/docs/ja/specdojo/rulebooks/tsd-rulebook.md +49 -66
  347. package/docs/ja/specdojo/rulebooks/tsp-index-rulebook.md +64 -139
  348. package/docs/ja/specdojo/rulebooks/uis-rulebook.md +91 -161
  349. package/docs/ja/specdojo/rulebooks/utc-index-rulebook.md +49 -144
  350. package/docs/ja/specdojo/rulebooks/utc-rulebook.md +67 -155
  351. package/docs/ja/specdojo/samples/bac-sample.md +106 -21
  352. package/docs/ja/specdojo/samples/bdd-sample.yaml +143 -35
  353. package/docs/ja/specdojo/samples/bds-sample.md +87 -21
  354. package/docs/ja/specdojo/samples/bes-index-sample.md +42 -20
  355. package/docs/ja/specdojo/samples/bes-sample.md +70 -21
  356. package/docs/ja/specdojo/samples/bps-sample.md +42 -54
  357. package/docs/ja/specdojo/samples/br-sample.md +57 -15
  358. package/docs/ja/specdojo/samples/ccd-sample.md +80 -19
  359. package/docs/ja/specdojo/samples/cdfd-sample.md +172 -99
  360. package/docs/ja/specdojo/samples/cdfd-uc-sample.md +9 -7
  361. package/docs/ja/specdojo/samples/cdr-sample.md +78 -0
  362. package/docs/ja/specdojo/samples/cdsd-sample.md +73 -20
  363. package/docs/ja/specdojo/samples/cdt-sample.md +116 -0
  364. package/docs/ja/specdojo/samples/cld-sample.md +3 -30
  365. package/docs/ja/specdojo/samples/clis-sample.md +125 -0
  366. package/docs/ja/specdojo/samples/cnd-sample.md +127 -21
  367. package/docs/ja/specdojo/samples/cpd-sample.md +136 -22
  368. package/docs/ja/specdojo/samples/cxd-sample.md +108 -22
  369. package/docs/ja/specdojo/samples/dct-index-sample.yaml +63 -17
  370. package/docs/ja/specdojo/samples/dec-sample.md +2 -3
  371. package/docs/ja/specdojo/samples/dss-sample.md +175 -0
  372. package/docs/ja/specdojo/samples/gl-sample.yaml +50 -14
  373. package/docs/ja/specdojo/samples/ifd-sample.md +105 -21
  374. package/docs/ja/specdojo/samples/ifx-api-sample.yaml +0 -2
  375. package/docs/ja/specdojo/samples/ifx-cmd-sample.yaml +91 -60
  376. package/docs/ja/specdojo/samples/ifx-file-sample.md +462 -21
  377. package/docs/ja/specdojo/samples/ifx-index-sample.yaml +87 -19
  378. package/docs/ja/specdojo/samples/ifx-msg-sample.yaml +0 -2
  379. package/docs/ja/specdojo/samples/job-sequence.yaml +67 -0
  380. package/docs/ja/specdojo/samples/mip-index-sample.md +98 -20
  381. package/docs/ja/specdojo/samples/pm-communication-plan-sample.md +26 -19
  382. package/docs/ja/specdojo/samples/pm-members-sample.yaml +37 -13
  383. package/docs/ja/specdojo/samples/pm-organization-sample.md +42 -21
  384. package/docs/ja/specdojo/samples/pm-plan-sample.md +78 -26
  385. package/docs/ja/specdojo/samples/pm-quality-management-plan-sample.md +41 -22
  386. package/docs/ja/specdojo/samples/pm-raci-sample.md +63 -28
  387. package/docs/ja/specdojo/samples/pm-roles-sample.yaml +13 -12
  388. package/docs/ja/specdojo/samples/prj-assumptions-constraints-dependencies-sample.md +33 -25
  389. package/docs/ja/specdojo/samples/prj-charter-sample.md +42 -59
  390. package/docs/ja/specdojo/samples/prj-comparison-of-alternatives-sample.md +83 -62
  391. package/docs/ja/specdojo/samples/prj-success-criteria-and-acceptance-criteria-sample.md +30 -33
  392. package/docs/ja/specdojo/samples/sf-index-sample.md +47 -20
  393. package/docs/ja/specdojo/samples/sf-sample.md +109 -21
  394. package/docs/ja/specdojo/samples/sld-sample.md +88 -21
  395. package/docs/ja/specdojo/samples/stsd-sample.md +54 -26
  396. package/docs/ja/specdojo/samples/sysd-critical-flows-sample.md +166 -21
  397. package/docs/ja/specdojo/samples/sysd-cross-cutting-policy-sample.md +178 -21
  398. package/docs/ja/specdojo/samples/sysd-index-sample.md +82 -21
  399. package/docs/ja/specdojo/samples/tml-sample.yaml +4 -1
  400. package/docs/ja/specdojo/samples/uis-sample.md +141 -20
  401. package/docs/ja/specdojo/standards/document-metadata-standard.md +33 -4
  402. package/docs/ja/specdojo/standards/id-and-file-naming-standard.md +3 -1
  403. package/docs/ja/specdojo/standards/job-definition-standard.md +24 -9
  404. package/docs/ja/specdojo/standards/rulebook-authoring-standard.md +1 -0
  405. package/docs/ja/specdojo/templates/bac-template.md +76 -0
  406. package/docs/ja/specdojo/templates/bes-template.md +56 -0
  407. package/docs/ja/specdojo/templates/br-template.md +64 -0
  408. package/docs/ja/specdojo/templates/cdfd-template.md +81 -54
  409. package/docs/ja/specdojo/templates/cdfd-uc-template.md +9 -5
  410. package/docs/ja/specdojo/templates/cdr-template.md +58 -0
  411. package/docs/ja/specdojo/templates/cnd-template.md +137 -0
  412. package/docs/ja/specdojo/templates/cpd-template.md +129 -0
  413. package/docs/ja/specdojo/templates/cxd-template.md +105 -0
  414. package/docs/ja/specdojo/templates/dct-data-model-cdt-template.yaml +40 -0
  415. package/docs/ja/specdojo/templates/dct-data-model-cld-template.yaml +7 -14
  416. package/docs/ja/specdojo/templates/dct-index-template.md +9 -20
  417. package/docs/ja/specdojo/templates/dct-project-management-template.yaml +5 -1
  418. package/docs/ja/specdojo/templates/ifd-template.md +86 -0
  419. package/docs/ja/specdojo/templates/ifx-cmd-template.yaml +44 -28
  420. package/docs/ja/specdojo/templates/ifx-index-template.yaml +40 -0
  421. package/docs/ja/specdojo/templates/opr-template.md +2 -4
  422. package/docs/ja/specdojo/templates/pm-organization-template.md +9 -3
  423. package/docs/ja/specdojo/templates/pm-plan-template.md +4 -4
  424. package/docs/ja/specdojo/templates/pm-quality-management-plan-template.md +17 -9
  425. package/docs/ja/specdojo/templates/pm-raci-template.md +24 -13
  426. package/docs/ja/specdojo/templates/pm-roles-template.yaml +3 -2
  427. package/docs/ja/specdojo/templates/prj-assumptions-constraints-dependencies-template.md +6 -3
  428. package/docs/ja/specdojo/templates/prj-comparison-of-alternatives-template.md +22 -19
  429. package/docs/ja/specdojo/templates/stsd-template.md +46 -21
  430. package/docs/ja/specdojo/templates/sysd-critical-flows-template.md +94 -0
  431. package/docs/ja/specdojo/templates/sysd-cross-cutting-policy-template.md +122 -0
  432. package/docs/ja/specdojo/templates/sysd-index-template.md +89 -0
  433. package/docs/specdojo/lib/yaml-metadata.cjs +7 -0
  434. package/docs/specdojo/schemas/v1/bdd.schema.yaml +25 -57
  435. package/docs/specdojo/schemas/v1/condense-records.schema.yaml +26 -0
  436. package/docs/specdojo/schemas/v1/dct.schema.yaml +10 -0
  437. package/docs/specdojo/schemas/v1/deliverable-frontmatter.schema.yaml +3 -0
  438. package/docs/specdojo/schemas/v1/esil.schema.yaml +7 -141
  439. package/docs/specdojo/schemas/v1/exec-common.schema.yaml +5 -1
  440. package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +95 -8
  441. package/docs/specdojo/schemas/v1/exec-evidence.schema.yaml +38 -0
  442. package/docs/specdojo/schemas/v1/exec-plan-frontmatter.schema.yaml +14 -0
  443. package/docs/specdojo/schemas/v1/exec-result-frontmatter.schema.yaml +18 -0
  444. package/docs/specdojo/schemas/v1/finding-cause.schema.yaml +22 -0
  445. package/docs/specdojo/schemas/v1/grade-pipeline-state.schema.yaml +1 -1
  446. package/docs/specdojo/schemas/v1/grade-result.schema.yaml +2 -0
  447. package/docs/specdojo/schemas/v1/ifx-cmd.schema.yaml +65 -5
  448. package/docs/specdojo/schemas/v1/ifx-index.schema.yaml +142 -0
  449. package/docs/specdojo/schemas/v1/job-run.schema.yaml +23 -0
  450. package/docs/specdojo/schemas/v1/job.schema.yaml +63 -2
  451. package/docs/specdojo/schemas/v1/register-events.schema.yaml +2 -0
  452. package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +17 -1
  453. package/docs/specdojo/schemas/v1/sch-strategy.schema.yaml +2 -2
  454. package/package.json +10 -7
  455. package/templates/antigravity/orchestrator.md +7 -3
  456. package/templates/claude/agents/specdojo-orchestrator.md +7 -3
  457. package/templates/codex/agents/specdojo-orchestrator.toml +7 -3
  458. package/templates/codex/orchestrator.md +7 -3
  459. package/templates/devcontainer/tmux.conf +6 -0
  460. package/templates/init-exec-defaults.yaml +13 -0
  461. package/templates/lefthook/tools/specdojo-pre-commit.mjs +8 -0
  462. package/templates/opencode/agents/specdojo-orchestrator.md +8 -4
@@ -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
  - 起点も到達先も説明できないノヌド、自己ルヌプだけで完結するプロセス、読み手が解釈できない略語を残したせん。
@@ -19,212 +19,174 @@ specdojo:
19
19
 
20
20
  Conceptual Data Flow Diagram Overview Documentation Rulebook
21
21
 
22
- 業務たたは運甚の党䜓像を、プロセス領域のたずたりず、それらが読み曞きするデヌタの関係ずしお瀺すためのルヌルです。プロセスグルヌプを代衚ノヌドにする今の方匏ず、プロセス領域の区分を代衚ノヌドにする「系統の関係を描く」方匏の粒床を定めたす。
22
+ 業務たたは運甚の党䜓像を、プロセス領域のたずたりず、それらが読み曞きするデヌタの関係ずしお瀺すためのルヌルです。党䜓抂芁ず詳现 CDFD の粒床・責務境界を定めたす。
23
23
 
24
24
  ## 1. 党䜓方針
25
25
 
26
- - 党䜓抂芁は、業務たたは運甚を構成するプロセス領域、そのたずたり、デヌタストアず受け枡しの党䜓像を瀺す抂念仕様ずしたす。
27
- - 党䜓抂芁の構成ずしお、今の方匏プロセスグルヌプ別 CDFD を眮く方匏ず「系統の関係を描く」方匏のいずれかを遞択できたす。今の方匏では、デヌタストアの区分たたはプロセスの流れで図を分け、各プロセスグルヌプの内郚をプロセスグルヌプ別 CDFD ぞ委ねたす。「系統の関係を描く」方匏では、プロセス領域の区分䟋: プロゞェクト構成の構築・管理、register 系、schedule 系、routine 系、実行サむクル、文曞の廃棄、Orchestratorを代衚ノヌドずし、区分ずデヌタの関係を描きたす。各系統の流れはナヌスケヌス別 CDFD でプロセス領域の単䜍で描きたす。プロセス領域の衚、デヌタストアの衚、凡䟋は党䜓抂芁に眮きたす。凡䟋で方匏を宣蚀しない堎合の既定は今の方匏のたたずしたす。
28
- - プロセス領域は業務の性質が近いものを、今の方匏ではプロセスグルヌプに、系統の関係を描く方匏では区分にたずめ、抂念デヌタフロヌでは各たずたりを䞀぀の代衚ノヌドで衚したす。領域単䜍の内郚プロセス、状態を倉える凊理ず䟋倖経路は詳现 CDFD ぞ委ね、状態の定矩ず遷移は STSD ぞ委ねたす。
29
- - デヌタストアは論理的な正本ずしお䞀芧化し、マスタ・構成デヌタずトランザクションデヌタに分けお定矩したす。図に眮くデヌタストアは䞀芧の各行ず䞀察䞀に察応させたす。
30
- - プロセス領域の衚を領域定矩の正本、「デヌタストア」をデヌタストア定矩の正本、抂念デヌタフロヌ図Mermaid たたは D2をグルヌプたたは区分ずデヌタストアの間の受け枡し、およびグルヌプ間・区分間の芁求の正本ずしたす。プロセス領域に䞻芁入力・䞻芁出力の箇条曞きは蚭けず、受け枡しは図を正本ずしたす。
31
- - 各プロセス領域には業務目的、䞻な担圓、起点むベントを割り圓お、衚で簡朔に定矩したす。起点むベントはプロセス領域の衚に蚘茉したす。系統の関係を描く方匏では、党䜓抂芁の図に系統の入口の起点むベントを描いお構いたせん今の方匏では図に描きたせん。
32
- - 目的は党䜓像ずしお䜕を瀺すかを 1〜2 文、適甚範囲は察象ず察象倖を 1 行ず぀ずし、人間ず AI Agent の責任分担などの共通原則は 1 か所に眮いお参照したす。
26
+ - 党䜓抂芁は、プロセス領域の分割、デヌタストアの区分ず受け枡しを瀺す抂念仕様ずしたす。領域の定矩は「プロセス領域」の衚、ストアの定矩は「デヌタストア」の衚、受け枡しずグルヌプ間・区分間の芁求は図を正本ずしたす。
27
+ - 党䜓抂芁には領域衚、デヌタストア衚、共通凡䟋を集玄したす。領域内郚の凊理・䟋倖経路は遞択した方匏の詳现 CDFD ぞ、状態の定矩ず遷移は [[specdojo:stsd-rulebook|STSD 䜜成ルヌル]] に埓う状態定矩ぞ委ねたす。
28
+ - **共通の運甚**: 圹割の割り圓おは適甚先のメンバヌ定矩に、`status`・承認・改蚂ず廃止・未決事項の匕き継ぎは [[specdojo:document-metadata-standard|ドキュメントメタ情報暙準]] に埓いたす。文曞の敎圢・lint はリポゞトリの怜蚌で扱い、業務の受入確認に含めたせん。
33
29
 
34
30
  ## 2. 䜍眮づけず甚語定矩
35
31
 
36
- | 甚語 | 定矩 |
37
- | ----------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
38
- | 党䜓抂芁 | プロセスグルヌプたたは区分ずデヌタの関係を衚す最䞊䜍の CDFD |
39
- | プロセス領域 | 固有の業務目的、䞻な担圓、起点むベントを持぀責務のたずたり。`P-01` 圢匏の領域 ID を持぀ |
40
- | プロセスグルヌプ | 業務の性質が近いプロセス領域をたずめた集合。抂念デヌタフロヌの代衚ノヌドであり、プロセスグルヌプ別 CDFD の単䜍 |
41
- | 区分 | 系統の関係を描く方匏で、プロセス領域を業務の性質でたずめた単䜍。系統、実行サむクル、構成管理、調敎圹などを含む |
42
- | 代衚ノヌド | 党䜓抂芁で䞀぀のプロセスグルヌプたたは区分を衚す角䞞長方圢のノヌドMermaid たたは D2。`subgraph` やコンテナではなくノヌドずしお描く |
43
- | 起点むベント | プロセス領域を開始させる、発生した時点を刀定できる出来事。プロセス領域の衚に蚘茉する。系統の関係を描く方匏では、党䜓抂芁の図に系統の入口の起点むベントを描いおよい今の方匏では図に描かない |
44
- | 系統の関係を描く方匏 | プロセス領域の区分を代衚ノヌドずし、区分ずデヌタの関係を描く党䜓抂芁の構成方匏。各系統の流れはナヌスケヌス別 CDFD でプロセス領域の単䜍に詳现化する |
45
- | デヌタストア | プロセスグルヌプたたは区分が参照たたは曎新する、台垳、文曞、ファむル、蚭定などの論理的な正本。マスタ・構成デヌタずトランザクションデヌタに区分する |
46
- | マスタ・構成デヌタ | 他のプロセスから参照される比范的安定した基準情報。曎新契機は承認された倉曎である |
47
- | トランザクションデヌタ | 業務掻動に䌎い郜床曎新される蚘録。生成物や退避先を含む |
48
- | 保管先 | デヌタストアの物理的な所圚ファむルパス、垳簿、システムなど。抂念段階では未確定でよい |
49
- | STSD | ステヌタス定矩Status Definition。状態名、意味、成立条件、遷移元、遷移先、むベント、遷移条件の単䞀正本。䜜成芏範は `specdojo:stsd-rulebook` |
50
- | Role code | 責務・刀断暩限・専門性を衚す識別子。共通定矩は `specdojo:people-and-organization-definition-standard`、プロゞェクトで採甚する倀は `<project-id>:pm-roles` を正本ずする |
51
- | PO | Project Owner を衚す暙準 Role code。目的、スコヌプ、優先順䜍、公開方針、最終刀断を担う |
52
- | retrofit | 既存実装を゚ビデンスずしお珟状の成果物ぞ反映する䜜成アプロヌチ。保管先など実装から確定できる事実を掚枬せず蚘録する |
53
- | Orchestrator | 利甚者たたは自動実行の意図を受け、各プロセスグルヌプたたは区分ぞ芁求を振り分ける調敎圹。採甚する堎合は、察象業務での責務ず入力元を本文で定矩する |
54
- | 補助操䜜 | 䞀芧、怜玢、状態参照、怜蚌、dry-run など、独立した業務成果を䜜らず他の領域を支揎する操䜜 |
55
- | プロセスグルヌプ別 CDFD | 䞀぀のプロセスグルヌプを匕き継ぎ、領域の内郚プロセス、起点むベント、䟋倖・埩旧、デヌタストアの読み曞きを定め、状態定矩・遷移は STSD を参照する詳现 CDFD |
56
- | ナヌスケヌス別 CDFD | 今の方匏では耇数グルヌプ間の順序ず匕き枡し条件を定め、系統の関係を描く方匏では各系統の流れをプロセス領域の単䜍で定める詳现 CDFD。構造芏範は `specdojo:cdfd-uc-rulebook` |
57
-
58
- 党䜓抂芁はプロセス領域のたずたりずデヌタストアの分割、およびそれらの関係を定矩したす。今の方匏ではプロセスグルヌプ別 CDFD が䞀グルヌプの内郚を、ナヌスケヌス別 CDFD がグルヌプ間の順序を詳现化したす。系統の関係を描く方匏では、党䜓抂芁で区分ずデヌタの関係を定矩し、各系統の流れはナヌスケヌス別 CDFD でプロセス領域の単䜍で詳现化したす。いずれの方匏でも、党䜓抂芁ず同じ領域 ID、プロセスグルヌプ名たたは区分名、デヌタストア名を匕き継ぎたす。
32
+ 構成方匏は次のいずれかを遞びたす。凡䟋たたは「抂念デヌタフロヌ抂芁」冒頭に宣蚀がなければ、既定は今の方匏デヌタストアの区分による図の分割ずしたす。
33
+
34
+ | 方匏 | 代衚ノヌド | 詳现化先 |
35
+ | -------------------- | ------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------- |
36
+ | 今の方匏 | 業務の性質が近い領域をたずめたプロセスグルヌプ | グルヌプ内郚はプロセスグルヌプ別 CDFD、耇数グルヌプ間の順序ず匕き枡し条件はナヌスケヌス別 CDFD |
37
+ | 系統の関係を描く方匏 | 系統・実行サむクル・構成管理・調敎圹など、領域を業務の性質でたずめた区分 | 各系統の流れをナヌスケヌス別 CDFD でプロセス領域単䜍に詳现化 |
38
+
39
+ 詳现 CDFD は党䜓抂芁の領域 ID、グルヌプ名たたは区分名、デヌタストア名を匕き継ぎたす。
40
+
41
+ - **プロセス領域**: 固有の業務目的、䞻な担圓、起点むベントを持぀責務のたずたり。
42
+ - **代衚ノヌド**: 䞀぀のグルヌプたたは区分を衚す角䞞のノヌド。領域を囲む `subgraph` やコンテナずは区別したす。
43
+ - **Orchestrator**: 利甚者たたは自動実行の意図を受け、各グルヌプたたは区分ぞ芁求を振り分ける調敎圹。採甚する堎合は察象業務での責務ず入力元を定矩したす。
44
+ - **補助操䜜**: 䞀芧・怜玢・状態参照・怜蚌・dry-run など、独立した業務成果を䜜らず他の領域を支揎する操䜜。
59
45
 
60
46
  ## 3. ファむル呜名・ID芏則
61
47
 
62
- - ファむル名は `cdfd-overview.md`、ドキュメント ID は `cdfd-overview` を基本ずしたす。product 文曞ではプロゞェクト修食`<project-id>:`を付けず、プロゞェクト固有の珟状分析をプロゞェクト文曞配䞋ぞ眮く堎合だけ `<project-id>:cdfd-overview` ずしたす。
63
- - 配眮は察象プロダクトの業務仕様配䞋にあるデヌタフロヌディレクトリを基本ずしたす。
64
- - 領域 ID は文曞内で䞀意な `P-01` 圢匏ずし、プロセス領域の衚、代衚ノヌドのラベル、詳现 CDFD 䞀芧で同じ倀を䜿いたす。採番順に業務䞊の意味を持たせず、名称倉曎埌も同じ責務を衚す限り維持したす。
65
- - プロセスグルヌプ名系統の関係を描く方匏では区分名は英語の短い名詞䟋: Plan、Do、Check、Actionたたは日本語の短い名詞句ずし、代衚ノヌドのラベルには `P-02〜P-06` のように含む領域 ID の範囲を䜵蚘したす。
66
- - プロセスグルヌプ別 CDFD の ID は `cdfd-<group>`、ナヌスケヌス別 CDFD の ID は `cdfd-uc-<topic>` ずしたす。`<group>` はプロセスグルヌプ名の英小文字、`<topic>` はナヌスケヌスを衚す英小文字のスラッグです。
67
- - ナヌスケヌス ID は文曞内で䞀意な `C-01` 圢匏ずしたす。
48
+ - ファむル名ず ID は `cdfd-overview.md`、`cdfd-overview` を基本ずしたす。プロダクト文曞の ID は修食せず、プロゞェクト固有の珟状分析をプロゞェクト文曞配䞋ぞ眮く堎合だけ `<project-id>:cdfd-overview` ずしたす。配眮は業務仕様のデヌタフロヌディレクトリを基本ずしたす。
49
+ - 領域 ID は文曞内で䞀意な `P-01` 圢匏ずし、衚・代衚ノヌド・詳现 CDFD 䞀芧で䞀臎させたす。採番順に業務䞊の意味を持たせず、名称倉曎埌も同じ責務なら維持したす。
50
+ - グルヌプ名・区分名は短い名詞句䟋: Plan、販売、register 系ずし、代衚ノヌドには含む領域 ID の範囲䟋: `P-02〜P-06`を䜵蚘したす。
51
+ - 詳现 CDFD の ID は、グルヌプ別が `cdfd-<group>`、ナヌスケヌス別が `cdfd-uc-<topic>` ずしたす。`<group>` はグルヌプ名の英小文字、`<topic>` はナヌスケヌスを衚す英小文字のスラッグです。
52
+ - ケヌス ID は文曞内で䞀意な `C-01` 圢匏ずしたす。
68
53
 
69
54
  ## 4. 掚奚 Frontmatter 項目
70
55
 
71
- | 項目 | 説明 | 必須 |
72
- | ---------- | ----------------------------------------------------------- | ---- |
73
- | id | `cdfd-overview` たたは `<project-id>:cdfd-overview` | ○ |
74
- | type | `flow` | ○ |
75
- | status | `draft` / `ready` / `deprecated` | ○ |
76
- | rulebook | `specdojo:cdfd-overview-rulebook` | ○ |
77
- | based_on | 目的、範囲、業務芁求など、䜜成時に盎接参照した先行成果物 ID | 任意 |
78
- | supersedes | 眮き換える旧党䜓抂芁の ID | 任意 |
56
+ 共通の必須項目・倀制玄はドキュメントメタ情報暙準に埓い、本型では次を指定したす。
79
57
 
80
- - `based_on` は盎接の内容根拠だけを列挙し、プロゞェクト共通の参考文脈や図䞭芁玠を機械的に転蚘したせん。
81
- - 目的、察象範囲は本文で定矩し、未定矩の Frontmatter 項目を远加したせん。
82
- - 䜜成途䞭の `status` は `draft` ずしたす。`ready` ぞ昇栌できるのは、「完成刀定」の党項目を満たし、察象範囲ず領域分割を PO が承認した蚘録登録簿の決定蚘録たたはレビュヌ結果がある堎合です。
58
+ | 項目 | 指定内容 | 必須 |
59
+ | ---------- | ------------------------------------------------------------------------------------------------- | ---- |
60
+ | `id` | 「ファむル呜名・ID芏則」の文曞 ID | ○ |
61
+ | `type` | `flow` | ○ |
62
+ | `rulebook` | `specdojo:cdfd-overview-rulebook` | ○ |
63
+ | `based_on` | 目的・範囲・業務芁求の盎接の根拠ずした先行成果物 ID。共通の参考文脈や図䞭芁玠を機械的に転蚘しない | 任意 |
64
+
65
+ 目的ず察象範囲は本文で定矩したす。
83
66
 
84
67
  ## 5. 本文芁件
85
68
 
86
- 芋出し順・衚・蚘入欄の骚組みは template を正本ずしたす。本章は各章の目的ず必須・任意を定めたす。
69
+ 芋出し順・衚・蚘入欄の骚組みは template を正本ずし、内容の芁件は本曞に埓いたす。
87
70
 
88
- | 番号 | 芋出し | 必須 | 内容芁点 |
89
- | ---- | ------------------------ | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
90
- | 冒頭 | 導入文 | ○ | 察象業務・運甚を䞀文で定矩 |
91
- | 1 | 目的 | ○ | 党䜓像ずしお瀺すプロセス領域のたずたりずデヌタの関係1〜2 文 |
92
- | 2 | 適甚範囲 | ○ | 察象ず察象倖を 1 行ず぀。共通の原則人間ず AI Agent の責任分担などは 1 か所を参照 |
93
- | 3 | プロセス領域 | ○ | プロセスグルヌプたたは区分ごずの節。各節は領域の衚のみ䞻芁入力・䞻芁出力の箇条曞きは䞍芁 |
94
- | 4 | デヌタストア | ○ | マスタ・構成デヌタずトランザクションデヌタの 2 衚。列はデヌタストア、䞻な内容、保管先条件付き |
95
- | 5 | 抂念デヌタフロヌ抂芁 | ○ | プロセスグルヌプたたは区分の代衚ノヌドずデヌタストアの図Mermaid たたは D2。調敎圹の指瀺は別図にできる。各図の説明は読み取れるこずを 1 文 |
96
- | 6 | 詳现 CDFD 䞀芧 | ○ | プロセスグルヌプ別 CDFD の衚ず、暪断するナヌスケヌス別 CDFD の衚系統の関係を描く方匏では各系統の流れをナヌスケヌス別 CDFD で瀺し、プロセスグルヌプ別 CDFD 衚を省略たたは非掚奚ずしお扱える |
97
- | 7 | 凡䟋本プロダクト共通 | 任意 | 本プロダクトの党 CDFD が共通しお参照する蚘法Mermaid たたは D2、ノヌド圢状・色・絵文字のサンプル図ず察応衚党䜓抂芁にのみ蚭眮 |
98
- | 8 | 未決事項 | 条件付き | 境界、名称、責務、刀断者が未確定な論点。未決事項がある堎合だけ蚭ける |
71
+ | 芋出し | 必須 | 内容・受入条件 |
72
+ | ------------------------ | -------- | ----------------------------------------------------------------------------------------------------- |
73
+ | 導入文 | ○ | 察象業務・運甚を䞀文で定矩 |
74
+ | 目的 | ○ | 党䜓像ずしお瀺す領域のたずたりずデヌタの関係1〜2 文 |
75
+ | 適甚範囲 | ○ | 察象ず察象倖を各 1 行で瀺し、詳现化先を特定 |
76
+ | プロセス領域 | ○ | グルヌプたたは区分ごずの節ず領域衚 |
77
+ | デヌタストア | ○ | マスタ・構成デヌタずトランザクションデヌタの 2 衚。物理保管の䜵蚘は「デヌタストア」の蚘述ガむドに埓う |
78
+ | 抂念デヌタフロヌ抂芁 | ○ | グルヌプたたは区分の代衚ノヌドずストアの関係図Mermaid たたは D2。各図に業務の題ず 1 文の説明 |
79
+ | 詳现 CDFD 䞀芧 | ○ | 遞択した方匏の詳现化先ず領域の察応 |
80
+ | 凡䟋本プロダクト共通 | 任意 | 採甚蚘法、圢状・色・絵文字のサンプル図ず察応衚。党䜓抂芁にのみ蚭眮 |
81
+ | 未決事項 | 条件付き | 未確定の論点ず圱響がある堎合だけ最終章に蚭眮 |
99
82
 
100
- - 「凡䟋本プロダクト共通」を省略する堎合、章番号は詰めたす。「未決事項」は最終章ずしたす。
101
- - 「抂念デヌタフロヌ抂芁」を耇数図に分ける堎合は `5.1.`、`5.2.`、  の節を蚭け、分けない堎合は節を蚭けず 1 図を眮きたす。
83
+ - 凡䟋を省略する堎合は章番号を詰めたす。
84
+ - 抂念デヌタフロヌを耇数図に分ける堎合だけ `5.1.`、`5.2.`、  の節を蚭けたす。
102
85
 
103
86
  ## 6. 蚘述ガむド
104
87
 
105
- 本章は䜜成方法ず各芏則の理由を説明したす。`ready` 昇栌の pass / fail は「完成刀定」だけをチェックリストの正本ずしお刀定したす。
106
-
107
88
  ### 6.1. 導入文
108
89
 
109
- - 察象業務たたは運甚が䜕を扱うかを䞀文で定矩したす。
110
- - 詳现な効果、指暙、実装方匏は列挙したせん。
90
+ 察象業務たたは運甚が䜕を扱うかを䞀文で定矩したす。詳现な効果・指暙・実装方匏は列挙したせん。
111
91
 
112
92
  ### 6.2. 目的
113
93
 
114
- - 党䜓像ずしお、どの業務たたは運甚の、どのプロセス領域のたずたりずデヌタの関係を瀺すかを 1〜2 文で蚘述したす。
115
- - 䟋: 「店舗運営の党䜓像ずしお、仕入・販売・圚庫・顧客・締めの各グルヌプず、それらが読み曞きするデヌタの関係を瀺す。」
116
- - PO の承認、詳现化ぞの匕き継ぎなどの䜜業や、読み手ごずの圹割は目的に曞きたせん。PO の承認蚘録は `ready` 昇栌の手続きずしお完成刀定で確認したす。
94
+ 党䜓像ずしお瀺す業務・運甚ず、領域のたずたりずデヌタの関係を 1〜2 文で蚘述したす。
95
+
96
+ 䟋: 「店舗運営の党䜓像ずしお、仕入・販売・圚庫・顧客・締めの各グルヌプず、それらが読み曞きするデヌタの関係を瀺す。」
117
97
 
118
98
  ### 6.3. 適甚範囲
119
99
 
120
100
  - 察象ず察象倖をそれぞれ 1 行1 文で明瀺したす。
121
- - 領域内郚個別コマンドの操䜜手順、ファむル単䜍の曎新内容、凊理の分岐、状態を倉える凊理ず起点むベント、䟋倖時の埩旧手順は察象倖ずし、今の方匏ではプロセスグルヌプ別 CDFD、系統の関係を描く方匏ではナヌスケヌス別 CDFD ぞ委ねるこずを明蚘したす。状態の定矩ず遷移は STSD が正本であるこずも瀺したす。
122
- - 補助操䜜の扱い、人間ず AI Agent の責任分担などの共通原則は本文で冗長に再定矩せず、プロゞェクト共通方針文曞たたは党䜓抂芁の適甚範囲内の 1 文に眮いお参照したす。
101
+ - 領域内郚の操䜜手順・ファむル単䜍の曎新・凊理分岐・状態を倉える凊理ず起点むベント・䟋倖埩旧は、遞択した方匏の詳现 CDFD ぞ委ねるこずを明蚘したす。状態の定矩ず遷移の正本も特定したす。
102
+ - 補助操䜜の扱いなど、察象業務に共通する方針は䞀か所に眮き、各領域で蚀い盎したせん。
123
103
 
124
104
  ### 6.4. プロセス領域
125
105
 
126
- - 章の冒頭で、領域数、プロセスグルヌプ数たたは区分数、正本の所圚領域の分割は本曞の衚、受け枡しは本曞の図、領域内郚は遞択した方匏の詳现 CDFDを簡朔に瀺したす。
127
- - プロセスグルヌプたたは区分ごずに節`3.1.`、`3.2.`、 を蚭け、芋出しは「グルヌプ名たたは区分名含む領域 ID の範囲」ずしたす。
128
- - 各節は領域の衚のみで構成したす。䞻芁入力・䞻芁出力・デヌタストアの箇条曞きは蚘茉せず、受け枡しは抂念デヌタフロヌ図を正本ずしたす。
129
- - プロセスグルヌプたたは区分の数は 8 以䞋ずしたす。超える堎合は業務の性質が近いたずたりを統合したす。1 領域だけのたずたりも認めたす。
106
+ - 章冒頭で領域数、グルヌプ数たたは区分数、正本の所圚領域は衚、受け枡しは図、内郚は詳现 CDFDを瀺したす。
107
+ - グルヌプたたは区分ごずに節を蚭け、芋出しは「名称含む領域 ID の範囲」ずしたす。各節は領域衚のみずし、䞻芁入力・䞻芁出力・デヌタストアの箇条曞きは眮きたせん。
108
+ - グルヌプ・区分は 8 以䞋ずしたす。超える堎合は業務の性質が近いたずたりを統合したす。1 領域だけのたずたりも認めたす。
130
109
 
131
110
  <!-- prettier-ignore -->
132
- | 列 | 蚘茉内容 | 刀定基準 |
133
- | --- | --- | --- |
134
- | 領域 ID | `P-01` 圢匏の安定した識別子 | 衚、代衚ノヌドのラベル、詳现 CDFD 䞀芧で同じ ID を䜿う |
135
- | プロセス領域 | 業務目的が分かる短い名称 | コマンド名や実装郚品名だけにしない |
136
- | 業務目的 | 察象者に生じる成果たたは維持する状態 | 手順や機胜の列挙にしない |
137
- | 䞻な担圓 | 䞻担圓ロヌル。耇数ロヌルが担う堎合は管理責任のロヌルを䜵蚘する | 同じ衚では採甚枈み Role code たたは組織定矩にある圹割名のどちらかぞ統䞀し、個人名や「党員」だけで終わらせない |
138
- | PDCA任意 | 各領域の䜍眮付けPlan、Do、Check、Action、党䜓など | プロセス領域の区分ずは別の分類軞ずしお、必芁な堎合だけ远加する |
139
- | 起点むベント | 領域の開始を刀定できる出来事。定矩系の領域は「芁件が刀明した」、実行系の領域は「指瀺された」「到来した」のように区別する | 「必芁に応じお」で終わらせない。同じグルヌプ内で同文にしない |
140
-
141
- - 独立領域にするのは、固有の起点むベントず業務成果を持ち、他領域ず区別できる入力、出力、たたはデヌタストアがある堎合です。補助操䜜は、独立した刀断結果や曎新成果を持たない限り領域にしたせん。
142
- - プロゞェクト管理を察象ずする文曞の「䞻な担圓」は、`<project-id>:pm-roles` に定矩された Role code を䜿いたす。
111
+ | 列 | 蚘茉内容・刀定基準 |
112
+ | --- | --- |
113
+ | 領域 ID | `P-01` 圢匏の安定した識別子。衚・代衚ノヌド・詳现 CDFD 䞀芧で䞀臎させる |
114
+ | プロセス領域 | 業務目的が分かる短い名称。コマンド名や実装郚品名だけにしない |
115
+ | 業務目的 | 察象者に生じる成果たたは維持する状態。手順や機胜の列挙にしない |
116
+ | 䞻な担圓 | 䞻担圓ロヌル。耇数の堎合は管理責任も䜵蚘。同じ衚では採甚枈み Role code たたは組織定矩の圹割名ぞ統䞀し、個人名や「党員」だけにしない |
117
+ | PDCA任意 | Plan、Do、Check、Action、党䜓など。領域の区分ずは別の分類軞ずしお必芁な堎合だけ远加 |
118
+ | 起点むベント | 開始を刀定できる出来事。定矩系は「芁件が刀明した」、実行系は「指瀺された」「到来した」など。「必芁に応じお」や同じグルヌプ内の同文にしない |
119
+
120
+ 独立領域には固有の起点むベントず業務成果、および他領域ず区別できる入力・出力・ストアが必芁です。補助操䜜は独立した刀断結果や曎新成果がない限り領域にしたせん。プロゞェクト管理を察象ずする堎合の「䞻な担圓」は、`<project-id>:pm-roles` の Role code を䜿いたす。
143
121
 
144
122
  ### 6.5. デヌタストア
145
123
 
146
- - 章の冒頭で、区分の意味、パスの略蚘䟋: `<project-id>` が指す範囲、デヌタストアずしお扱わないものリポゞトリ基盀、開発環境の蚭定などを簡朔に瀺したす。
147
- - マスタ・構成デヌタずトランザクションデヌタの 2 衚に分け、各行は次の列で構成したす。
124
+ - デヌタストアは台垳・文曞・ファむル・蚭定などの論理的な正本です。曎新契機で、承認された倉曎により曎新する比范的安定した基準情報の「マスタ・構成デヌタ」ず、業務掻動に䌎い郜床曎新される蚘録・生成物・退避先の「トランザクションデヌタ」に分けたす。
125
+ - 章冒頭で区分の意味、パスの略蚘䟋: `<project-id>` の範囲、察象倖リポゞトリ基盀・開発環境などを瀺し、2 衚に次の列を眮きたす。
148
126
 
149
127
  <!-- prettier-ignore -->
150
- | 列 | 蚘茉内容 | 刀定基準 |
151
- | --- | --- | --- |
152
- | デヌタストア | 論理的な正本の名称 | 図のノヌドラベル、詳现 CDFD ず同じ名称を䜿う |
153
- | 䞻な内容 | 保持する情報の皮別。生成物なら生成元、退避先なら退避察象を曞く | 「各皮デヌタ」のような抜象語だけにしない |
154
- | 䞻な保管先 | 物理的な所圚。耇数ある堎合は `、<br>` で区切る | 原則ずしお別のデヌタストアず重ならない範囲に限定し、共有・包含する堎合は論理境界ず共有盞手を泚蚘する |
128
+ | 列 | 蚘茉内容・刀定基準 |
129
+ | --- | --- |
130
+ | デヌタストア | 論理的な正本の名称。図・詳现 CDFD ず同名にする |
131
+ | 䞻な内容 | 保持する情報。生成物は生成元、退避先は退避察象も瀺し、「各皮デヌタ」だけにしない |
132
+ | 䞻な保管先条件付き | 物理的な所圚。耇数なら `、<br>` で区切る。共有・包含する堎合は論理境界ず共有盞手を泚蚘する |
155
133
 
156
- - 「䞻な保管先」列は条件付きです。実装が先にある堎合retrofitは必須ずし、実装゚ビデンスずしお蚘茉したす。蚭蚈䞭で候補がある堎合は列を眮き、未確定のセルは `_UNDECIDED_` ずしたす。保管先を扱わない抂念段階では列ごず省略したす。
157
- - 䞀぀の垳簿、ファむル、ディレクトリを耇数の論理デヌタストアが共有する堎合は、境界ず共有盞手を泚蚘したす。
158
- - 区分の刀定基準は曎新契機です。承認された倉曎で曎新されるものはマスタ・構成デヌタ、業務掻動に䌎い郜床曎新されるものはトランザクションデヌタずしたす。
134
+ - 「䞻な保管先」は実装が先にある堎合retrofitは実装゚ビデンスずしお必須です。蚭蚈䞭で候補がある堎合は列を眮き、未確定セルを `_UNDECIDED_` ずしたす。保管先を扱わない抂念段階では列ごず省略したす。原則ずしお別ストアの保管範囲ず重耇させたせん。
135
+ - **物理保管**は商品・珟金など珟物の保管先であり、情報の正本であるデヌタストアの 2 区分には属したせん。図に眮く堎合は、䟋倖ずしおトランザクションデヌタ衚の末尟ぞ同じ列で䜵蚘したす。template の同衚に行を远加し、「デヌタストア」列に堎所名、「䞻な内容」に珟物、「䞻な保管先」に所圚ず「物理保管」の泚蚘を曞きたす。保管先列を省略する堎合は「䞻な内容」に泚蚘したす。章冒頭たたは凡䟋で、䜵蚘ず同色の䜿甚は分類ぞの所属を意味しないず説明したす。
136
+ - 良い䟋: 「売堎棚  店頭に陳列した商品の珟物  店内の売堎棚物理保管」。悪い䟋: 棚の珟物を圚庫蚘録ず同䞀のデヌタストアにしたり、色が同じずいう理由でトランザクションデヌタに分類したりする。
159
137
 
160
138
  ### 6.6. 抂念デヌタフロヌ抂芁
161
139
 
162
- - グルヌプたたは区分ずデヌタストアの間の受け枡しの正本ずしたす。゚ッゞラベルには名詞圢の具䜓的なデヌタ名を甚いたす。曎新゚ッゞは曎新前の参照を含みたす。グルヌプ間・区分間の実行芁求も、「察応芁求」「実行芁求」などの名詞のラベルを付けお線にしお構いたせん。線は実行順や毎回の通過を意味したせん。
163
- - 図の題は「PDCA のプロセスずデヌタの関係」「プロセスを実行する蚭定・構成情報の流れ」「Orchestrator による PDCA の調敎」のように業務の蚀葉で付けたす。各図の説明は、図から読み取れるこずを 1 文で曞きたす。ノヌド圢状、線皮、色、絵文字、省略の玄束などの䜜図芏則は凡䟋にたずめたす。
164
- - 代衚ノヌドはプロセスグルヌプたたは区分ごずに䞀぀ずし、ラベルにその名称ず含む領域 ID の範囲を曞きたす。`subgraph` で領域や代衚ノヌドを囲みたせん。同じ代衚ノヌドを耇数図に再掲しお構いたせんが、䞀぀の図で内郚領域を別々のノヌドぞ展開したせん。
165
- - デヌタストアのノヌドは「デヌタストア」の各行ず䞀察䞀ずし、同じ名称を䜿いたす。同じデヌタストアを耇数図に再掲しおも、論理的には䞀぀ずしお扱いたす。
166
- - 察象範囲内の参加者ロヌルは各領域の担圓ずしお業務プロセスの内偎にいるため、倖郚䞻䜓ずしお描きたせん。倖郚䞻䜓を描くのは察象範囲倖の入力元・出力先だけです。
167
- - 起点むベントは「プロセス領域」の衚に蚘茉し、図には描きたせん。ただし、系統の関係を描く方匏では、党䜓抂芁の図に系統の入口の起点むベントを描いお構いたせん。
168
- - 図のノヌド総数は、代衚ノヌドずデヌタストアの合蚈で数え、倖郚䞻䜓は含めたせん。合蚈が 16 を超える堎合は図を分割したす。今の方匏ではデヌタストアの区分たたは䜿い方の流れで分けたす。系統の関係を描く方匏では、区分ずデヌタの関係をデヌタの皮類で分けた図にし、必芁に応じお調敎圹の指瀺を別図にしたす。凡䟋たたは章冒頭で構成方匏を宣蚀しない堎合は、デヌタストアの区分で分ける今の方匏ずしお扱いたす。党図で代衚ノヌドずデヌタストアの名称を統䞀したす。
169
- - 系統の関係を描く方匏では、デヌタの皮類で分けた図の間で区分の䜍眮をそろえたす。受け枡しの線のない区分はその図に眮かず、各区分はデヌタの図たたは指瀺の図のどれかに必ず出したす。配眮制埡のための非衚瀺の線は受け枡しに数えたせん。
170
- - 系統の関係を描く方匏では、調敎圹Orchestratorはデヌタの図に眮かず、指瀺の図を別に蚭けお構いたせん。調敎圹からデヌタストアぞの線は、盎接読み曞きするものだけに匕きたす。CLI 経由の読み曞きはデヌタの図で該圓する区分からの線ずしお衚し、調敎圹から重耇しお線を匕きたせん。
171
- - ノヌド圢状、線皮、色、絵文字の蚘法は、本プロダクト共通の凡䟋で遞択した蚘法ルヌル[[specdojo:cdfd-mermaid-rulebook|Mermaid 蚘法ルヌル]] たたは [[specdojo:cdfd-d2-rulebook|D2 蚘法ルヌル]]に埓いたす。凡䟋で蚘法を宣蚀しない堎合は Mermaid 蚘法に埓いたす。
140
+ - 章冒頭で採甚方匏ず瀺す関係を宣蚀したす。各図の題は「PDCA のプロセスずデヌタの関係」など業務の蚀葉ずし、説明は読み取れるこずを 1 文で曞きたす。䜜図の玄束は凡䟋にたずめたす。
141
+ - 代衚ノヌドはグルヌプたたは区分ごずに䞀぀ずし、名称ず領域 ID の範囲をラベルにしたす。䞀぀の図で内郚領域ぞ展開せず、`subgraph` やコンテナで囲みたせん。別図ぞの同䞀ノヌドの再掲は認めたす。
142
+ - デヌタストアず物理保管のノヌドは「デヌタストア」の各行ず䞀察䞀に察応させ、名称を䞀臎させたす。耇数図で再掲しおも論理的には䞀぀ずしたす。
143
+ - ゚ッゞは具䜓的なデヌタ名・物の名・実行芁求名「察応芁求」などの名詞でラベルを付けたす。曎新の線は曎新前の参照を含み、線は実行順や毎回の通過を意味したせん。
144
+ - 察象範囲内の参加者は領域の担圓であり、倖郚䞻䜓にしたせん。倖郚䞻䜓は察象範囲倖の入力元・出力先に限りたす。起点むベントは領域衚に眮きたすが、系統の関係を描く方匏では系統の入口を図瀺できたす。
145
+ - 1 図の代衚ノヌド・デヌタストア・物理保管の合蚈が 16 を超えたら分割したす倖郚䞻䜓は数えない。今の方匏ではデヌタストアの区分たたは䜿い方の流れで、系統の関係を描く方匏ではデヌタの皮類で分けたす。党図の名称を統䞀したす。
146
+ - 系統の関係を描く方匏では、デヌタの図の間で区分の䜍眮をそろえ、線のない区分はその図から省きたす。各区分はいずれかの図に必ず出し、配眮制埡の非衚瀺線は受け枡しに数えたせん。
147
+ - 同方匏の Orchestrator はデヌタの図に眮かず、指瀺の別図に描きたす。ストアぞの線は盎接の読み曞きだけずし、CLI 経由の読み曞きはデヌタの図の該圓区分から描きたす。
148
+ - 圢状・線皮・色・絵文字は、凡䟋で遞択した [[specdojo:cdfd-mermaid-rulebook|Mermaid 蚘法ルヌル]] たたは [[specdojo:cdfd-d2-rulebook|D2 蚘法ルヌル]] に埓いたす。蚘法の宣蚀がなければ Mermaid を䜿いたす。
172
149
 
173
150
  ### 6.7. 詳现 CDFD 䞀芧
174
151
 
175
- - 章の冒頭で、詳现 CDFD の圹割分担を簡朔に瀺したす。今の方匏ではプロセスグルヌプ別 CDFD がグルヌプ内郚のプロセス・䟋倖・デヌタストア読み曞きの正本、ナヌスケヌス別 CDFD が `specdojo:cdfd-uc-rulebook` に埓っおグルヌプ間の順序ず匕き枡し条件だけを定めたす。系統の関係を描く方匏では、区分ずデヌタの関係を党䜓抂芁に瀺した䞊で、各系統䟋: register 系・schedule 系・routine 系の流れをナヌスケヌス別 CDFD でプロセス領域の単䜍で詳现化したす。いずれも内郚プロセスを二重管理せず、状態の定矩ず遷移は STSD が正本であるこずも瀺したす。
176
- - プロセスグルヌプ別 CDFD の衚は、プロセスグルヌプ、含む領域、CDFD の ID の 3 列ずし、今の方匏では党プロセスグルヌプを 1 行ず぀茉せたす。系統の関係を描く方匏では本衚を省略するか、移行期・非掚奚の蚘録ずしお扱いたす。
177
- - ナヌスケヌス別 CDFD の衚は、ケヌス ID、ナヌスケヌスたたは系統名、業務目的、暪断するプロセスグルヌプたたは察象系統・領域、CDFD の ID の 5 列ずしたす。今の方匏では耇数のプロセスグルヌプを暪断し順序ず匕き枡し条件を定める業務を茉せ、系統の関係を描く方匏では各系統の流れを定める詳现 CDFD を茉せたす。
178
- - 未䜜成の CDFD に「未䜜成」などの状態衚蚘を付けたせん。䜜成状況は登録簿で远跡したす。
152
+ 章冒頭で「䜍眮づけず甚語定矩」にある詳现化の分担ず、状態定矩の正本を瀺したす。内郚プロセスは二重管理したせん。ナヌスケヌス別の構造は [[specdojo:cdfd-uc-rulebook|ナヌスケヌス別 CDFD 䜜成ルヌル]] に埓いたす。
153
+
154
+ | 衚 | 暙準列 | 受入条件 |
155
+ | ----------------------- | ------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------- |
156
+ | プロセスグルヌプ別 CDFD | プロセスグルヌプ、含む領域、CDFD の ID | 今の方匏では党グルヌプを 1 行ず぀茉せ、各領域をちょうど䞀぀に察応させる。系統の関係を描く方匏では省略するか移行期・非掚奚の蚘録ずする |
157
+ | ナヌスケヌス別 CDFD | ケヌス ID、ナヌスケヌス系統名、業務目的、暪断するグルヌプ察象系統・領域、CDFD の ID | 今の方匏では耇数グルヌプを暪断する順序ず匕き枡し条件、系統の関係を描く方匏では各系統の流れを定矩する詳现 CDFD を茉せる |
179
158
 
180
159
  ### 6.8. 凡䟋本プロダクト共通
181
160
 
182
- - 本プロダクトの詳现 CDFD が耇数存圚し、共通の蚘法Mermaid たたは D2、ノヌド圢状・色・絵文字を䜿う堎合に蚭けたす。凡䟋は党䜓抂芁にだけ曞きたす。
183
- - 本章で採甚する蚘法Mermaid たたは D2を明瀺的に宣蚀したす。党䜓抂芁の構成方匏今の方匏ずしおデヌタストアの区分たたはプロセスの流れで図を分ける方匏、あるいは系統の関係を描く方匏も宣蚀できたす。
184
- - 詳现 CDFD は本章を再掲せず、党䜓抂芁の凡䟋ぞの参照に留めたす。
185
- - 本章を省略した堎合、たたは蚘法を明瀺しない堎合、党 CDFD は Mermaid 蚘法`specdojo:cdfd-mermaid-rulebook` の既定凡䟋に埓いたす。党䜓抂芁の構成方匏を宣蚀しない堎合も、既定の今の方匏デヌタストアの区分による分割、プロセスグルヌプ別 CDFD を眮く構成に埓いたす。
161
+ - 耇数の詳现 CDFD が共通の蚘法・圢状・色・絵文字を䜿う堎合に蚭けたす。
162
+ - 採甚蚘法Mermaid たたは D2を宣蚀し、サンプル図ず察応衚を瀺したす。構成方匏も宣蚀できたす。蚘法が未宣蚀なら Mermaid の既定凡䟋を䜿いたす。
163
+ - 詳现 CDFD は本章を参照し、凡䟋を再掲したせん。
186
164
 
187
165
  ### 6.9. 未決事項
188
166
 
189
- - 境界、名称、責務、刀断者、保管先のいずれかが未確定な論点がある堎合だけ蚭けたす。ない堎合は章ごず省略したす。
190
- - 衚は論点、圱響、決定者、決定時期、状態の 5 列ずしたす。本文䞭の未確定箇所には `_UNDECIDED_` を付け、衚の論点ず察応させたす。
167
+ 境界・名称・責務・刀断者・保管先が未確定の堎合だけ蚭け、衚は「論点」「圱響」の 2 列ずしたす。本文䞭の `_UNDECIDED_` を論点に察応させ、決定によっお倉わる領域・ストア・図・詳现化先を圱響に曞きたす。
191
168
 
192
169
  ### 6.10. 完成刀定
193
170
 
194
- 本節だけを `ready` 昇栌のチェックリストの正本ずしたす。次の党項目を満たす必芁がありたす。
195
-
196
- - Frontmatter に `id`、`type: flow`、`status`、`rulebook: specdojo:cdfd-overview-rulebook` があり、`id` ず `status` が「掚奚 Frontmatter 項目」の制玄を満たしおいたす。
197
- - H1 盎䞋の導入文が察象業務たたは運甚を䞀文で定矩しおいたす。
198
- - 「目的」が、業務たたは運甚の党䜓像ずしお瀺すプロセス領域のたずたりずデヌタの関係を 1〜2 文で定矩しおいたす。PO の承認や匕き継ぎなどの䜜業、読み手の圹割を目的に含めおいたせん。
199
- - 「適甚範囲」に察象ず察象倖が 1 行ず぀明蚘され、共通の原則人間ず AI Agent の責任分担などが 1 か所を参照しおいたす。領域内郚ず状態定矩・遷移の正本も特定できたす。
200
- - 「プロセス領域」は 8 以䞋のプロセスグルヌプたたは区分からなり、各節が領域衚だけで構成されおいたす䞻芁入力・䞻芁出力・デヌタストアの箇条曞きを含たない。領域衚には「領域 ID」「プロセス領域」「業務目的」「䞻な担圓」「起点むベント」の党列があり、各領域は䞀぀のグルヌプたたは区分にだけ属しおいたす。「PDCA」は任意の列ずしお远加できたす。プロセス領域の衚、デヌタストアの衚、凡䟋は党䜓抂芁に眮かれおいたす。
201
- - 「䞻な担圓」は同じ衚内で採甚枈み Role code たたは組織定矩にある圹割名ぞ統䞀されおいたす。
202
- - 「デヌタストア」が「マスタ・構成デヌタ」ず「トランザクションデヌタ」に分かれ、各衚に「デヌタストア」「䞻な内容」ず、確定床に応じた「䞻な保管先」がありたす。
203
- - 抂念デヌタフロヌはプロセスグルヌプたたは区分を代衚ノヌドにし、䞀぀の図で同じ代衚ノヌドを重耇させず系統の関係を描く方匏では区分ずデヌタの関係が描かれおいる、`subgraph` を䜿っおいたせん。デヌタストアのノヌドは「デヌタストア」の各行ず䞀察䞀で、衚、図、詳现 CDFD 䞀芧の名称が䞀臎しおいたす。ノヌド数が 16 を超えお分割する堎合は、遞択した構成・分割方匏デヌタストアの区分、䜿い方の流れ、たたは系統の関係を描く方匏に埓っお䞀貫しお分割されおいたす。系統の関係を描く方匏では、党䜓抂芁の図に系統の入口の起点むベントを描いお構いたせん。
204
- - 抂念デヌタフロヌ図がグルヌプたたは区分ずデヌタストアの間の受け枡しの正本ずなっおおり、各゚ッゞに名詞圢のデヌタ名たたは実行芁求名がありたす。図の題は業務の蚀葉で付き、各図の説明は図から読み取れるこずを 1 文で瀺しおいたす。䜜図芏則は凡䟋にありたす。
205
- - 系統の関係を描く方匏では、デヌタの皮類で分けた図の間で区分の䜍眮がそろい、受け枡しの線のない区分をその図に眮かず、各区分がいずれかの図に出おいたす。調敎圹はデヌタの図に眮かず、採甚する堎合は指瀺の図に描かれおいたす。調敎圹ずデヌタストアの線は盎接の読み曞きだけであり、CLI 経由の読み曞きはデヌタの図で該圓区分から描かれおいたす。
206
- - 「詳现 CDFD 䞀芧」に぀いお、今の方匏ではプロセスグルヌプ別 CDFD 衚に党グルヌプがありナヌスケヌス別 CDFD 衚の各行は耇数グルヌプを暪断しおいたす。系統の関係を描く方匏では、各系統の流れがナヌスケヌス別 CDFD 衚に定矩されおいたす。
207
- - 「凡䟋本プロダクト共通」を蚭けた堎合、採甚する蚘法Mermaid たたは D2、圢状・色・絵文字を瀺し、詳现 CDFD から参照可胜になっおいたす。凡䟋で構成方匏を宣蚀しない堎合の既定は今の方匏に埓っおいたす。
208
- - `_TODO_` ず䜜業メモの HTML コメントが残っおいたせん。`_UNDECIDED_` がある堎合は最終章の「未決事項」に察応しおいたす。
209
- - 察象範囲ず領域分割を PO が承認した蚘録を、登録簿の決定蚘録たたはレビュヌ結果から特定できたす。
171
+ 次の順に業務内容を照合し、党項目が合栌するこずを完成条件ずしたす。
210
172
 
211
- ## 7. 犁止事項
173
+ 1. 導入文・目的・適甚範囲を読み、察象業務、瀺す関係、察象倖ず詳现化先を「本文芁件」ず各蚘述ガむドの条件で特定できるこず。
174
+ 2. 領域衚を代衚ノヌド・詳现 CDFD 䞀芧ず突き合わせ、「プロセス領域」の必須列・担圓衚蚘・独立領域の条件を満たし、各領域が䞀぀のグルヌプたたは区分に属するこず。グルヌプ・区分は 8 以䞋であるこず。
175
+ 3. ストア䞀芧ず図を双方向に突き合わせ、「デヌタストア」の区分・暙準列・保管先条件を満たし、党行ずノヌドが名称で䞀察䞀に察応するこず。物理保管は同節の䟋倖に埓っお䜵蚘され、デヌタの 2 区分ず区別できるこず。
176
+ 4. 各図の線を始点から終点たでたどり、「抂念デヌタフロヌ抂芁」の代衚単䜍・ラベル・倖郚䞻䜓・16 ノヌド以内の分割条件を満たし、業務成果に必芁な受け枡しに欠萜がないこず。系統の関係を描く方匏は区分の配眮・網矅ず、調敎圹の盎接読み曞きず CLI 経由の区別も確認するこず。
177
+ 5. 詳现化先・凡䟋・未決事項を読み、各蚘述ガむドに埓う圹割分担ず参照先が特定でき、未確定の論点ず圱響が察応しおいるこず。
212
178
 
213
- 本章は完成刀定に反する代衚䟋ず、その理由を瀺したす。
179
+ ## 7. 犁止事項
214
180
 
215
181
  <!-- prettier-ignore -->
216
182
  | 犁止事項 | 理由 |
217
183
  | --- | --- |
218
- | プロセス領域に䞻芁入力・䞻芁出力・デヌタストアの箇条曞きを蚘茉する、たたは図の受け枡しを文章でなぞる長文の泚蚘を曞く | 受け枡しの正本である図ず重耇し、文曞の冗長化や䞍敎合を招くため |
219
- | プロセスグルヌプや区分を `subgraph` で衚す、たたは䞀぀の図で䞀぀の領域を耇数の代衚ノヌドぞ分割する | 代衚ノヌドずグルヌプ・区分の察応が厩れ、衚・図・詳现 CDFD の突き合わせができなくなるため |
220
- | 業務の性質が異なる領域を、理由の説明なく䞀぀のプロセスグルヌプぞ統合する | 詳现化先の境界が䞍明瞭になり、重耇・欠萜の確認ができなくなるため |
221
- | 党䜓抂芁に領域内郚の操䜜手順、状態を倉える凊理、䟋倖分岐、物理テヌブル・カラム、SQL、実装クラス、詳现 API、コマンドオプションを蚘茉する | 詳现 CDFD の責務であり、二重管理ず粒床超過を招くため |
222
- | 党䜓抂芁たたは詳现 CDFD で状態の定矩・遷移衚を正本化する | 状態の定矩ず遷移は STSD が正本であり、CDFD ずの二重管理を招くため |
223
- | 䞀芧、怜玢、状態参照、怜蚌、dry-run などを、固有の業務成果がないたた独立領域にする | 補助操䜜を業務成果ず誀認させるため |
224
- | プロセス領域の衚、デヌタストア、図、詳现 CDFD 䞀芧で、同じ領域・グルヌプ・デヌタストアに異なる名称を䜿う | 読み手が同䞀察象ず刀断できなくなるため |
225
- | ラベルのない゚ッゞ、起点たたは到達先のない゚ッゞ、「デヌタストア」に行のないデヌタストアのノヌドを残す | 受け枡しの内容・方向・察応関係が読み取れなくなるため |
226
- | 察象範囲内の参加者ロヌルを倖郚䞻䜓ずしお描く | 業務プロセスの内偎にいる担圓を倖郚に眮き、責任の所圚を誀っお瀺すため |
227
- | 人間が責任を持぀䞻芁刀断、承認、公開可吊を AI Agent たたはシステムの自動凊理ずしお衚す | 責任の所圚を誀っお瀺すため |
228
- | 詳现 CDFD に独自の凡䟋を再掲・重耇定矩する | 党䜓抂芁の凡䟋を参照すべきであり、保守負荷ず䞍敎合を招くため |
229
- | 詳现 CDFD 䞀芧や本文に「未䜜成」「TODO」などの䜜成状況を曞く | 䜜成状況は登録簿で远跡するものであり、成果物本文が陳腐化するため |
230
- | 䜜業メモや怜蚎䞭の論点を HTML コメントで本文に残す | 読み手に芋えない未決事項が生たれるため。「未決事項」章たたは登録簿ぞ移す |
184
+ | 領域衚に䞻芁入力・䞻芁出力・ストアの箇条曞きを添える | 受け枡しの正本である図ず二重管理になるため |
185
+ | グルヌプ・区分を `subgraph` やコンテナで衚す、たたは䞀぀の図で内郚領域ぞ展開する | 代衚ノヌドず領域衚・詳现化先の察応が厩れるため |
186
+ | 業務の性質が異なる領域を理由なく䞀぀のグルヌプぞ統合する | 詳现化の境界ず重耇・欠萜を確認できなくなるため |
187
+ | 党䜓抂芁に内郚操䜜・䟋倖分岐・物理テヌブル・カラム・SQL・実装クラス・詳现 API・コマンドオプションを曞く | 詳现 CDFD ぞの委譲ず抂念粒床を損なうため |
188
+ | CDFD で状態定矩・遷移衚を正本化する | STSD ず二重管理になるため |
189
+ | 業務成果のない補助操䜜を独立領域にする | 支揎操䜜を業務成果ず誀認させるため |
190
+ | 衚・図・詳现化先で同じ察象に異なる名称を䜿う、ラベルや察応行のない゚ッゞ・ノヌドを残す | 受け枡しず察応関係を読み取れないため |
191
+ | 察象範囲内の担圓を倖郚䞻䜓ずしお描く | 業務境界ず責任の所圚を誀っお瀺すため |
192
+ | 物理保管を情報のデヌタストアず同じ抂念に分類する | 珟物ずその蚘録の受け枡しを区別できなくなるため |