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
@@ -11,147 +11,149 @@ specdojo:
11
11
 
12
12
  Conceptual Data Flow Diagram Overview Writing Recipe
13
13
 
14
- 業務または運用の全体像を、プロセス領域のまとまりと、それらが読み書きするデータの関係として示すための作成手順です。今の方式(プロセスグループ別 CDFD を置く方式)と、系統の関係を描く方式(区分を代表ノードにし、各系統をユースケース別 CDFD で詳細化する方式)から選びます。
14
+ 業務または運用の全体像を、プロセス領域のまとまりと、それらが読み書きするデータの関係として描くための作り方を示す。
15
15
 
16
16
  ## 1. このレシピの使い方
17
17
 
18
- - 最初に、対象業務・運用の範囲と、プロセス領域・データストアの候補を粗く書き出します。
19
- - 次に、各章の問いに答えながら、目的、適用範囲、プロセス領域の表、データストア、概念データフロー(概要)、詳細 CDFD 一覧を具体化します。
20
- - 最後に、レビュー観点で「表と図の名称が対応し、受け渡しが図で読み取れるか」「領域単位の詳細を書きすぎていないか」を確認します。
21
-
22
- この成果物は、プロセスグループまたは区分とデータストアの名称を軸に、プロセス領域の表・データストア・図・詳細 CDFD 一覧の四点を対応させ、上位の業務目的を領域分割の理由として引き継ぎます。領域内の手順や実装方式は作り込まず、各要素の対応関係で判断を追跡できるようにします(Trace)。
18
+ - 全体概要は、上位の業務目的を領域分割の理由として引き継ぎ(Why)、領域・グループまたは区分・データストアの分け方を定め(What)、受け渡しを代表ノードとストアの線で示す(How)。領域 ID とグループ・区分・ストアの名称で、領域表・ストア一覧・図・詳細 CDFD 一覧をたどれるようにする(Trace)。
19
+ - 「作成前に集める情報」をメモでそろえてから、「全体の作成手順」の順に書く。
20
+ - 書き終えたら「レビュー観点」で読み直し、「仕上げチェック」で確かめる。
23
21
 
24
22
  ## 2. 作成前に集める情報
25
23
 
26
- | 項目 | 集める情報 |
27
- | ------------------ | --------------------------------------------------------------------------------------------------------------- |
28
- | 全体像 | 対象業務を構成するプロセス領域のまとまりと、読み書きするデータの関係 |
29
- | 対象範囲 | 開始点、終了点、対象業務、組織、システム境界 |
30
- | 対象外 | 補助操作、領域内の手順、実装詳細、別成果物が責任を持つ事項 |
31
- | 領域候補 | 固有の業務目的、主な担当、起点イベントを持つ責務のまとまり |
32
- | グループ・区分候補 | 業務の性質が近い領域のまとまり。系統の関係を描く方式では、系統・実行サイクル・調整役などの区分 |
33
- | 主な担当 | 各領域を主に担うロール、複数ロールが担う場合の管理責任、人間の最終判断者 |
34
- | 起点イベント | 各領域の開始を判定できる出来事 |
35
- | データストア | 各グループまたは区分が参照・更新する論理的な正本と、その内容。マスタ・構成かトランザクションかの区分 |
36
- | 保管先 | データストアの物理的な所在。実装が先にある場合は確定値、設計中は候補、概念段階では扱わない |
37
- | 主要な受け渡し | グループまたは区分とデータストアの間で移動する情報・物、区分間の実行要求、調整役の直接読み書きと CLI 経由の区別 |
38
- | 物理保管 | 現物(商品・現金など)を保管する場所(物の流れを図示する場合) |
39
- | 外部主体 | 対象範囲外から入力を渡す人・組織・システムと、結果を受け取る主体。対象範囲内の参加者は含めない |
40
- | 横断ユースケース | 今の方式では複数グループをまたぐ業務、系統の関係を描く方式では各系統の流れ |
41
- | 未決事項 | 境界、名称、責務、判断者、保管先が未確定な論点と、影響、決定者、決定時期 |
24
+ | 項目 | 集める情報 | 取り出し元 |
25
+ | -------------------- | ---------------------------------------------------------------------------- | ---------------------------------- |
26
+ | 対象範囲 | 開始点、終了点、対象業務、組織・システム境界、別成果物に任せる事項 | 業務の責任者への確認、上位の概要 |
27
+ | 業務成果と起点 | 開始から結果利用までの業務成果と、それぞれの開始を判定できる出来事 | 業務の担当者への聞き取り、業務記録 |
28
+ | 担当 | 各領域を主に担う役割、複数で担う場合の管理責任、人間の最終判断者 | 役割の定義(Role code の一覧など) |
29
+ | データの正本 | 各領域が参照・更新する台帳・文書・設定と、更新される契機、物理的な所在 | 既存の台帳・保管場所、実装 |
30
+ | 受け渡しと外部主体 | 領域とストアの間で動く情報・物、対象範囲外から入力を渡す主体と受け取る主体 | 業務の担当者への聞き取り |
31
+ | 構成方式と横断の流れ | 今の方式か系統の関係を描く方式か、複数グループをまたぐ業務または各系統の流れ | 業務の責任者への確認 |
42
32
 
43
33
  ## 3. 全体の作成手順
44
34
 
45
- 1. 全体像として示す関係を 1〜2 文で書き、開始点、終了点、対象外を定義します。
46
- 2. 開始から結果利用までの業務成果を並べ、起点イベントと最終出力が異なるまとまりへ分け、各まとまりへ安定した領域 ID を付けます。
47
- 3. 一覧、検索、状態参照、検証、dry-run など、独立した業務成果を持たない候補を支援先の領域へ戻します。
48
- 4. 業務の性質が近い領域を、今の方式ではプロセスグループへ、系統の関係を描く方式では区分へまとめ、8 以下にします。各節には領域の表だけを置き、必要なら PDCA 列を追加します。受け渡しの正本は図とし、主要入力・主要出力の箇条書きは置きません。
49
- 5. 各グループまたは区分が参照・更新するデータストアを集め、更新契機でマスタ・構成データとトランザクションデータに区分し、一覧にします。保管先は確定度に応じて列を置くか省略します。
50
- 6. グループまたは区分を代表ノードにし、データストアとの関係と区分間の要求を名詞のラベル付きの線で描きます。16 ノードを超える場合は選択した方式で分けます。系統の関係を描く方式ではデータの種類で分け、区分の位置をそろえ、線のない区分を省きます。調整役の指示は別図にし、直接読み書きするストアだけを調整役につなぎます。
51
- 7. 今の方式ではプロセスグループ別 CDFD の表と、横断業務のユースケース別 CDFD の表を作ります。系統の関係を描く方式では、各系統の流れをユースケース別 CDFD の表に載せます。
52
- 8. 名称を使って領域表、データストア、図、詳細 CDFD 一覧を突き合わせ、重複、欠落、名称ゆれを解消します。
53
- 9. 確定できない論点は影響と決定時期を添えて未決事項へ分離します。
35
+ 1. 適用範囲を最初に書き、開始点・終了点・対象外を決める。範囲が決まらないと、領域の候補が増え続ける。
36
+ 2. 構成方式を選ぶ。代表ノードをプロセスグループにするか区分にするかで、以降の章の単位が変わる。
37
+ 3. 業務成果ごとに領域を切り、補助操作を支援先の領域へ戻してから、グループまたは区分にまとめる。
38
+ 4. 領域表から参照・更新するストアを集め、ストア一覧を作る。図に置く名称はここで決める。
39
+ 5. 代表ノードとストアを線でつなぎ、図を描く。
40
+ 6. 詳細 CDFD 一覧で、各グループまたは各系統の詳細化先を決める。
41
+ 7. 各章の冒頭文(領域数・グループ数、ストアの区分の意味、採用方式)を書く。表と図ができてから書くと数と名称がずれない。
42
+ 8. 最後に、H1 直下の導入文と目的を書く。領域分割が決まってから書くと、本文の言い直しにならない。
43
+ 9. 決めきれない論点は `_UNDECIDED_` を残し、未決事項に影響と合わせて置く。
54
44
 
55
45
  ## 4. 各章の書き方
56
46
 
57
- ### 4.1. 目的
47
+ ### 4.1. 導入文と目的
58
48
 
59
49
  問い:
60
50
 
61
- - どの業務または運用の全体像を示しますか。
62
- - その全体像を構成するプロセス領域のまとまりと、読み書きするデータの関係は何ですか。
51
+ - この文書は、どの業務または運用を扱うのか。
52
+ - 全体像として、どの領域のまとまりとデータの関係を示すのか。
53
+
54
+ コツ:
63
55
 
64
- 全体像として何を示すかを 1〜2 文で書きます。例えば「店舗運営の全体像として、仕入・販売・在庫・顧客・締めと、それらが読み書きするデータの関係を示す」とします。PO の承認や引き継ぎなどの作業、読み手の役割は目的に含めません。対象範囲と領域分割の PO 承認記録は、目的とは別に `ready` 昇格の完成判定で確認します。
56
+ - 導入文は対象を一文で定義するだけにし、効果や指標を並べたくなったら上位の概要への参照に置き換える。
57
+ - 目的に承認や引き継ぎの作業、読み手の役割を書き始めたら外す。
65
58
 
66
59
  ### 4.2. 適用範囲
67
60
 
68
61
  問い:
69
62
 
70
- - どの出来事から、どの成果または判断までを扱いますか。
71
- - 領域内部として選択した方式の詳細 CDFD へ委ねるものと、業務成果を持たないため補助操作として除外するものは何ですか。
72
- - 人間が責任を持つ判断と、AI Agent やシステムが支援できる処理の境界はどこですか。対応する責任分担文書はありますか。
73
- - 特定プロジェクトの実行計画・スケジュール上のフェーズ名を、前提知識のない読者への説明なく持ち込んでいませんか。
63
+ - どの出来事から、どの成果または判断までを扱うのか。
64
+ - 一覧・検索・検証などの補助操作と、領域内部の手順を、どこへ任せるのか。
65
+
66
+ コツ:
74
67
 
75
- 対象業務、開始点、終了点、対象外、補助操作の扱いを明示します。責任分担は対応する文書があれば参照し、なければ原則を一文で書きます。
68
+ - 責任分担は、対応する方針文書があれば参照し、なければ原則を一文で書く。
69
+ - 特定プロジェクトの計画上のフェーズ名を持ち込みやすい。前提知識のない読者に通じる言葉に直す。
76
70
 
77
71
  ### 4.3. プロセス領域
78
72
 
79
73
  問い:
80
74
 
81
- - 各領域には、他の領域と区別できる固有の起点イベントと業務成果がありますか。定義系の領域の起点を実行の契機で書いていませんか。
82
- - グループまたは区分の見出しと領域表から、そのまとまりの業務目的が読み取れますか。
83
- - 各領域は一つのグループまたは区分にだけ属していますか。PDCA を示す場合は任意の列にしていますか。
84
- - 主な担当を「全員」だけで終わらせず、管理責任のロールを示していますか。
75
+ - 各領域に、ほかと区別できる起点イベントと業務成果があるか。
76
+ - そのグループまたは区分の業務目的が、見出しと表から読み取れるか。
85
77
 
86
- グループまたは区分ごとに節を設け、領域 ID、プロセス領域、業務目的、主な担当、起点イベントの表だけを置きます。PDCA は任意の列です。受け渡しは図を正本とし、主要入力・主要出力の箇条書きは置きません。業務目的は手段名ではなく、対象者が利用する成果または維持したい状態で書きます。領域を分けるか迷う場合は、起点、最終出力、更新する正本の三点を比較します。領域内部の詳細は選択した方式の詳細 CDFD へ委ねます。
78
+ コツ:
79
+
80
+ - 分けるか迷ったら、起点、最終出力、更新する正本の三点を比べる。三点とも同じなら一つにする。
81
+ - 定義系の領域の起点を「時期が到来した」など実行の契機で書きやすい。定義系は「要件が判明した」で書く。
82
+ - 担当は役割の定義から取り、「全員」と書きたくなったら管理責任を持つ役割を聞く。
83
+ - 冒頭文の領域数とグループ数は、表を数えて書く。
87
84
 
88
85
  ### 4.4. データストア
89
86
 
90
87
  問い:
91
88
 
92
- - 各データストアは、何の正本かが分かる名称ですか。生成物の場合は生成元、退避先の場合は退避対象が主な内容に書かれていますか。
93
- - 区分は更新契機で判定していますか。定義から生成される生成物を、生成元と同じ区分にしていませんか。
94
- - 保管先の列を置く場合、確定度に合った書き方(確定値、`_UNDECIDED_`、列の省略)になっていますか。保管先を共有・包含する場合は、論理境界と共有相手を注記していますか。
95
- - リポジトリ基盤や開発環境の設定など、業務データでないものを除外していますか。
89
+ - 各ストアは、何の正本かが名称から分かるか。
90
+ - 承認された変更で更新されるか、業務活動のたびに更新されるか。
91
+
92
+ コツ:
96
93
 
97
- マスタ・構成データとトランザクションデータの 2 表に分けます。図に置くデータストアはこの一覧の行と一対一にするため、図で使いたい名称をここで確定します。
94
+ - 定義から生成される生成物は、更新の契機が違うため生成元と別の区分になりやすい。生成元を主な内容に書く。
95
+ - 保管先は、実装があれば確定値を、設計中なら候補と `_UNDECIDED_` を書き、概念段階では列ごと外す。推測でパスを書かない。
96
+ - 一つの保管先を複数のストアで共有するときは、どこまでがこのストアかと共有相手を注記する。
97
+ - 冒頭文では区分の意味、パスの略記、扱わないもの(リポジトリ基盤・開発環境の設定など)を各一文で書く。
98
98
 
99
99
  ### 4.5. 概念データフロー(概要)
100
100
 
101
101
  問い:
102
102
 
103
- - 今の方式と、系統の関係を描く方式のどちらを使いますか。凡例または章冒頭で宣言していますか。
104
- - 代表ノードはグループまたは区分ごとに一つで、名称と含む領域 ID をラベルにしていますか。`subgraph` で囲んでいませんか。
105
- - データストアは一覧の各行と一対一で名称が一致していますか。同じストアを複数図に再掲する場合も同じ名称ですか。
106
- - 線のラベルは、何がどこからどこへ渡るか分かる名詞ですか。区分から区分への「対応要求」「実行要求」なども名詞のラベルで描いていますか。
107
- - 対象範囲内の参加者を外部主体にしていませんか。外部主体は対象範囲外の入力元・出力先だけですか。
108
- - 16 ノードを超える場合、選択した方式で分割していますか。今の方式ではデータストアの区分または使い方の流れで分け、名称を統一していますか。
109
- - 系統の関係を描く方式では、データの種類で分けた図の間で区分の位置がそろっていますか。受け渡しの線のない区分をその図から省き、各区分をいずれかの図に出していますか。配置制御の非表示の線を受け渡しとして数えていませんか。
110
- - 系統の関係を描く方式では、調整役(Orchestrator)をデータの図から外し、必要なら指示の図を別に設けていますか。調整役からストアへの線は直接の読み書きだけですか。CLI 経由のものはデータの図で該当区分からの線になっていますか。
111
- - 図の題は業務の言葉で付けていますか。図の説明は、図から読み取れることを 1 文で書き、作図の約束は凡例に任せていますか。
103
+ - 線のラベルから、何がどこからどこへ渡るかが分かるか。
104
+ - 対象範囲の外にいるのは誰か。
112
105
 
113
- 系統の関係を描く方式では、例えば「PDCA のプロセスとデータの関係」「プロセスを実行する設定・構成情報の流れ」「Orchestrator による PDCA の調整」の 3 図にします。実行要求をトランザクションの図だけに限定する規則は設けず、調整役の指示は指示の図に描きます。グループや区分の内部は詳細 CDFD へ委ねます。物の流れがある場合は物理保管も図の要素として扱い、線種は採用した記法の凡例に従います。
106
+ コツ:
107
+
108
+ - 冒頭文で採用方式と示す関係を宣言してから描くと、分割の切り口がぶれない。
109
+ - 店主など対象範囲内の参加者を外部主体に描きやすい。参加者は領域の担当とし、参加者から直接受け取る入力を図から省いたときは、図の直後に省いたことを一文で書く。
110
+ - ノードが多くなったら、今の方式はストアの区分か使い方の流れで、系統の関係を描く方式はデータの種類で分ける。調整役(Orchestrator)の指示はデータの図に混ぜず、別の図にする。
111
+ - 図の説明に作図の約束を書き始めたら、凡例へ移す。
114
112
 
115
113
  ### 4.6. 詳細 CDFD 一覧
116
114
 
117
115
  問い:
118
116
 
119
- - 選択した方式に応じた詳細 CDFD の役割分担を示していますか。状態の定義と遷移は STSD を正本にしていますか。
120
- - 今の方式では、プロセスグループ別 CDFD の表に全グループが 1 行ずつあり、各領域がちょうど一つの行に属していますか。ユースケース別 CDFD は複数グループを横断する順序と引き渡し条件だけを扱っていますか。
121
- - 系統の関係を描く方式では、各系統の流れをユースケース別 CDFD でプロセス領域の単位に詳細化していますか。プロセスグループ別 CDFD の表は省略するか、移行期・非推奨の記録として扱っていますか。
122
- - 「未作成」などの作成状況を本文に書いていませんか。
117
+ - 各領域の内部は、どの詳細 CDFD が扱うのか。
118
+ - 複数グループをまたぐ業務、または各系統の流れは、どこで詳細化するのか。
119
+
120
+ コツ:
123
121
 
124
- 作成状況は登録簿で追跡し、本文には ID だけを書きます。今の方式で単一グループに閉じる業務はグループ別 CDFD で扱い、ユースケース別 CDFD は横断業務が必要になった時点で追加します。
122
+ - 単一グループに閉じる業務はグループ別の詳細 CDFD に任せ、横断のユースケース別 CDFD は必要になってから足す。
123
+ - 「未作成」などの作成状況を書きたくなったら、登録簿で追跡し、本文には ID だけを書く。
125
124
 
126
125
  ### 4.7. 凡例(本プロダクト共通)(任意)
127
126
 
128
127
  問い:
129
128
 
130
- - 本プロダクトに複数の詳細 CDFD があり、共通のノード形状・色・絵文字を使いますか。
131
- - 全体概要と詳細 CDFD の各図が、この章の定義を再掲せず参照する形になっていますか。
132
- - サンプル図には、採用する記法(Mermaid または D2)の rulebook が定義する全ノード種別が一つずつ含まれていますか。
129
+ - 複数の詳細 CDFD が、同じ形状・色・絵文字を使うか。
130
+ - 各図は、凡例を再掲せずに参照できるか。
131
+
132
+ コツ:
133
133
 
134
- 詳細 CDFD が複数あり、色・絵文字の割り当てを毎回説明し直すと負担になる場合に設けます。単一の CDFD しかない場合は省略します。
134
+ - 詳細 CDFD が一つだけなら章を設けない。
135
135
 
136
136
  ### 4.8. 未決事項(条件付き)
137
137
 
138
138
  問い:
139
139
 
140
- - 境界、名称、責務、判断者、保管先のいずれかに未確定の論点がありますか。
141
- - 本文中の `_UNDECIDED_` は、表の論点と対応していますか。
140
+ - 境界、名称、責務、判断者、保管先のうち、決めきれないものはどれか。
141
+ - 決まると、どの領域・ストア・図・詳細化先が変わるか。
142
142
 
143
- 未決事項がある場合だけ最終章として設け、論点、影響、決定者、決定時期、状態の表にします。確定した論点は本文へ反映して表から削除します。
143
+ コツ:
144
+
145
+ - 本文の `_UNDECIDED_` から論点を拾うと、表との対応が漏れない。決まった論点は本文へ反映して表から外す。
144
146
 
145
147
  ## 5. 深掘り手順
146
148
 
147
- 1. 各領域の目的から逆向きにたどり、その領域が応える利用者の判断または業務課題を確認します。
148
- 2. 各領域の起点イベントを見て、定義系の領域が実行の契機で書かれていないか、同じグループ内で同文になっていないかを確認します。
149
- 3. 図の出力の線から順向きにたどり、他グループ・区分または外部主体が利用するか、データストアに残るかを確認します。
150
- 4. 同じデータストアを更新する複数グループを並べ、更新責務が重複していないか確認します。
151
- 5. 図の線を一本ずつたどり、領域表の業務目的とストアの主な内容に照らして、欠けた受け渡しや不要な線を修正します。
152
- 6. 「データストア」の各行がいずれかの図に登場し、再掲時も名称が一致するか確認します。保管先が重なる場合は論理境界と共有相手の注記を確認します。
153
- 7. コマンド名、画面名、ファイル名を隠しても目的と受け渡しを説明できるか確認し、説明できない行を概念粒度へ戻します。
154
- 8. 補助操作を除外したことで必要な検証入力が失われていないか確認し、独立領域ではなく支援先の入力として残します。
149
+ 内容が浅いときは、次の順で対応のない主張を探す。
150
+
151
+ 1. 各領域の業務目的から逆にたどり、応える利用者の判断または業務課題がない領域を外すかまとめる。
152
+ 2. 図の出力の線を順にたどり、他のグループ・区分・外部主体が使うか、ストアに残るかを確かめる。行き先のない線を外す。
153
+ 3. 同じストアを更新するグループを並べ、更新の責務が重なっていないかを確かめる。
154
+ 4. ストア一覧のうち、図のどの線にも現れない行を探し、受け渡しの欠けか不要なストアかを決める。
155
+ 5. コマンド名・画面名・ファイル名を隠しても目的と受け渡しを説明できるかを確かめ、説明できない行を概念の粒度へ戻す。
156
+ 6. 補助操作を外したことで、必要な検証の入力が消えていないかを確かめ、支援先の入力として残す。
155
157
 
156
158
  ## 6. 良い例 / 悪い例
157
159
 
@@ -159,11 +161,9 @@ Conceptual Data Flow Diagram Overview Writing Recipe
159
161
  | ------------ | ----------------------------------------------------------------------------------------------- | -------------------------------------------------------- |
160
162
  | 業務目的 | 現金販売を記録し、商品を顧客へ渡す | 販売登録画面を実行する |
161
163
  | 起点イベント | 定期実行定義は「定期的に確認・実行する事項が判明した」 | 定期実行定義に「指定された時期が到来した」(実行の契機) |
162
- | グループ粒度 | 店頭販売とつけ販売を「販売」グループにまとめ、値引きや取消の手順は詳細 CDFD へ委ねる | 全体概要に値引き、取消、再入力を別ノードで並べる |
163
- | 入出力 | 入力は購入依頼と支払、売価、つけ上限。出力は販売記録とつけ販売の記録 | 入力はフォーム、出力は JSON |
164
- | データストア | 販売取引の正本である「販売記録」と、その生成物である「日次締め記録」を分ける | `sales-table`。または販売記録と締め記録を一つにまとめる |
165
- | 区分 | 定期実行定義(定義)はマスタ・構成、実行記録(活動の記録)はトランザクション | 定義と記録を同じ区分にする |
166
- | 保管先 | 実装があるのでパスを書く。設計中は `_UNDECIDED_`。概念段階は列を省略 | 未定なのに推測でパスを書く |
164
+ | グループ粒度 | 店頭販売とつけ販売を「販売」グループにまとめ、値引きや取消の手順は詳細 CDFD へ任せる | 全体概要に値引き、取消、再入力を別ノードで並べる |
165
+ | 受け渡し | 購入依頼と支払、売価、つけ上限を受け、販売記録とつけ販売の記録を残す | 入力はフォーム、出力は JSON |
166
+ | データストア | 販売取引の正本「販売記録」と、その生成物「日次締め記録」を分ける | `sales-table`。または販売記録と締め記録を一つにまとめる |
167
167
  | 補助操作 | 商品検索は販売の入力確認として扱う | 商品検索を独立したプロセス領域にする |
168
168
  | 図の要素 | 顧客と仕入先を外部主体、店主を各領域の担当として内側に置く | 店主を外部主体として描く |
169
169
  | ノード数 | 代表ノード 6 とデータストア 15 の計 21 なのでデータの種類で分け、調整役がいれば指示を別図にする | 21 ノードを 1 図に並べる |
@@ -171,30 +171,18 @@ Conceptual Data Flow Diagram Overview Writing Recipe
171
171
 
172
172
  ## 7. レビュー観点
173
173
 
174
- | 観点 | 確認内容 | 主な確認者 |
175
- | ---------- | ---------------------------------------------------------------------------------------------------------------------------------------- | ---------- |
176
- | 業務価値 | 各領域の目的が、対象者の課題、判断、期待する業務成果のどれに応えるか説明できる | BA |
177
- | 対象境界 | 領域、プロセスグループ、補助操作、領域内部、人間の最終判断、外部主体の境界を承認できる | PO |
178
- | 詳細化入力 | 各グループまたは区分の受け渡し、データストア、詳細化先を識別できる | ARC |
179
- | 網羅性 | 各領域が一つのグループまたは区分に属し、選択した方式の詳細 CDFD へ対応し、受け渡しに欠落がない | QE |
180
- | 用語整合 | 領域、グループ、データストアの名称が表、一覧、図、詳細 CDFD 一覧で一致する | BA、QE |
181
- | 粒度 | 全体概要がグループまたは区分単位の受け渡しに留まり、領域単位の入出力、手順、状態、例外、実装詳細を詳細化先へ委譲する | BA、ARC |
182
- | 可読性 | グループまたは区分が 8 以下で、16 ノードを超える場合は選択した方式で分割され、系統の関係を描く方式では区分の位置と指示の別図が適切である | BA、ARC |
174
+ | 観点 | 確認内容 |
175
+ | ---------- | ---------------------------------------------------------------------------------------- |
176
+ | 業務価値 | 各領域の目的が、対象者のどの課題・判断・業務成果に応えるかを説明できるか |
177
+ | 対象境界 | 領域、補助操作、領域内部、人間の最終判断、外部主体の境界を、業務の責任者が判断できるか |
178
+ | 詳細化入力 | 各グループまたは区分の受け渡し、ストア、詳細化先を、詳細 CDFD の書き手が引き継げるか |
179
+ | 用語整合 | 領域、グループ・区分、ストアの名称が、領域表・ストア一覧・図・詳細 CDFD 一覧で一致するか |
180
+ | 粒度 | 領域単位の入出力、手順、状態、例外、実装の詳細を書きすぎていないか |
183
181
 
184
182
  ## 8. 仕上げチェック
185
183
 
186
- 最終的な完成判定は [[specdojo:cdfd-overview-rulebook|作成ルール]] の完成判定を正本とし、ここでは作成中の整合を確かめます。
187
-
188
- - 目的は全体像として何を示すかを 1〜2 文で書き、対象範囲、対象外、責任分担は適用範囲に書いた。
189
- - 各領域に ID、業務目的、担当、起点イベントがあり、各グループまたは区分の節は領域表だけにした。PDCA 列は必要な場合だけ追加した。
190
- - グループまたは区分が 8 以下である。
191
- - データストアをマスタ・構成とトランザクションに分け、保管先列を確定度に合った扱いにした。
192
- - 代表ノード、領域表、データストア、詳細 CDFD 一覧の名称と ID が対応し、`subgraph` を使っていない。
193
- - 受け渡しの全線に名詞のラベルがあり、区分間の実行要求も内容を読み取れる。
194
- - 16 ノードを超える場合は選択した方式で分割した。系統の関係を描く方式ではデータの図で区分の位置をそろえ、線のない区分を省き、各区分はいずれかの図に出した。
195
- - 系統の関係を描く方式では、調整役はデータの図に置かず、必要な指示の図に置いた。直接読み書きするストアだけにつなぎ、CLI 経由の読み書きはデータの図の該当区分から描いた。
196
- - 図の題は業務の言葉で、図の説明は読み取れることを 1 文で書き、作図の約束を凡例にまとめた。
197
- - 対象範囲内の参加者を外部主体にせず、補助操作を独立領域にしていない。
198
- - 詳細 CDFD 一覧は選択した方式に従い、作成状況を書いていない。領域内部の詳細と状態定義はそれぞれの正本へ委ねた。
199
- - 未決事項は `_UNDECIDED_` で区別し、影響、決定者、決定時期、状態を記載した。未決事項がなければ章を設けていない。
200
- - 作業メモを HTML コメントで本文に残していない。
184
+ - 各章の冒頭文の数・区分・方式が、表と図の実際と一致している。
185
+ - 各領域が一つのグループまたは区分に属し、詳細 CDFD 一覧のいずれかの詳細化先へたどれる。
186
+ - ストア一覧の各行が、いずれかの図に同じ名称で現れる。
187
+ - 対象範囲内の参加者を外部主体にしておらず、参加者からの入力を省いた図には注記がある。
188
+ - 決めきれない論点は `_UNDECIDED_` のまま残し、確定したと書いていない。