specdojo 0.6.0 → 0.8.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 (366) hide show
  1. package/.github/agents/specdojo-orchestrator.md +3 -2
  2. package/CHANGELOG.md +193 -0
  3. package/README.md +2 -2
  4. package/dist/catalog/build.js +24 -1
  5. package/dist/catalog/plan.js +1 -1
  6. package/dist/catalog/scaffold.js +4 -1
  7. package/dist/commands/agent.js +33 -0
  8. package/dist/commands/init.js +6 -1
  9. package/dist/commands/night-orchestrator.js +6 -4
  10. package/dist/commands/orchestrator.js +10 -1
  11. package/dist/dashboard/dashboard-timeline.js +18 -16
  12. package/dist/dashboard/dashboard.js +612 -259
  13. package/dist/dashboard/epic-plan.js +81 -0
  14. package/dist/dashboard/exec-records.js +16 -20
  15. package/dist/dashboard/routines.js +8 -6
  16. package/dist/dashboard/timeline-build.js +5 -9
  17. package/dist/dashboard/timeline.js +9 -4
  18. package/dist/devcontainer/command.js +18 -0
  19. package/dist/devcontainer/host-script.js +21 -0
  20. package/dist/devcontainer/scaffold.js +22 -3
  21. package/dist/docs/frontmatter-namespace.js +1 -48
  22. package/dist/docs/yaml-pages.js +125 -3
  23. package/dist/exec/agent-config.js +22 -0
  24. package/dist/exec/agent-plan.js +3 -2
  25. package/dist/exec/antigravity-session.js +154 -0
  26. package/dist/exec/commands.js +69 -21
  27. package/dist/exec/commit-hook-skips.js +78 -0
  28. package/dist/exec/core.js +19 -7
  29. package/dist/exec/events.js +159 -8
  30. package/dist/exec/evidence.js +64 -16
  31. package/dist/exec/handoff.js +9 -13
  32. package/dist/exec/limit.js +1 -1
  33. package/dist/exec/mechanical-result.js +45 -0
  34. package/dist/exec/migrate-records.js +249 -0
  35. package/dist/exec/parent-validation.js +160 -12
  36. package/dist/exec/pipeline-state.js +27 -5
  37. package/dist/exec/plan-markdownlint.js +89 -0
  38. package/dist/exec/plans-condense-findings.js +89 -0
  39. package/dist/exec/plans-core.js +24 -17
  40. package/dist/exec/plans-generation.js +52 -25
  41. package/dist/exec/plans-grade-findings.js +8 -3
  42. package/dist/exec/plans-kata-findings.js +61 -0
  43. package/dist/exec/plans-planning.js +3 -3
  44. package/dist/exec/plans-storage.js +12 -24
  45. package/dist/exec/register-resume.js +69 -42
  46. package/dist/exec/register.js +26 -22
  47. package/dist/exec/repo-integration-sync.js +8 -4
  48. package/dist/exec/repo-integration.js +21 -1
  49. package/dist/exec/reporter.js +121 -23
  50. package/dist/exec/results.js +85 -24
  51. package/dist/exec/review-completion.js +47 -0
  52. package/dist/exec/review-kata.js +109 -0
  53. package/dist/exec/run/agent-pipeline.js +75 -6
  54. package/dist/exec/run/agent.js +20 -7
  55. package/dist/exec/run/in-place.js +69 -32
  56. package/dist/exec/run/job.js +81 -24
  57. package/dist/exec/run/lifecycle-commands.js +264 -43
  58. package/dist/exec/run/mode-shared.js +11 -3
  59. package/dist/exec/run/register-command.js +12 -10
  60. package/dist/exec/run/register-core.js +20 -13
  61. package/dist/exec/run/register-mode.js +12 -12
  62. package/dist/exec/run/register-post-review.js +21 -9
  63. package/dist/exec/run/register-resume.js +28 -18
  64. package/dist/exec/run/register-state.js +10 -7
  65. package/dist/exec/run/register-worktree.js +60 -30
  66. package/dist/exec/run/schedule-mode.js +26 -6
  67. package/dist/exec/run/schedule-prepare.js +228 -45
  68. package/dist/exec/run/schedule-task.js +132 -25
  69. package/dist/exec/run/shared.js +4 -3
  70. package/dist/exec/run/trailing-records.js +35 -0
  71. package/dist/exec/run-records.js +2 -0
  72. package/dist/exec/strategy.js +1 -0
  73. package/dist/exec/trailing-records.js +242 -0
  74. package/dist/exec/trial-commands.js +3 -2
  75. package/dist/exec/validate-records-commit.js +110 -0
  76. package/dist/exec/validate-records.js +148 -0
  77. package/dist/exec/worktree-command.js +29 -16
  78. package/dist/exec/worktree-ops-commit.js +118 -59
  79. package/dist/exec/worktree-ops-lifecycle.js +77 -44
  80. package/dist/exec/worktree-ops-merge.js +13 -2
  81. package/dist/exec/worktree-ops.js +2 -2
  82. package/dist/exec/worktree.js +19 -2
  83. package/dist/grade/apply.js +32 -6
  84. package/dist/grade/command-inspect.js +2 -2
  85. package/dist/grade/command-run.js +2 -0
  86. package/dist/grade/command-shared.js +1 -1
  87. package/dist/grade/core.js +18 -5
  88. package/dist/grade/markdown.js +3 -3
  89. package/dist/grade/pipeline-state.js +15 -11
  90. package/dist/grade/plan.js +37 -17
  91. package/dist/grade/result.js +3 -3
  92. package/dist/grade/run.js +23 -3
  93. package/dist/grade/target-discovery.js +17 -4
  94. package/dist/grade/targets.js +12 -11
  95. package/dist/job/job.js +31 -17
  96. package/dist/job/noop.js +104 -0
  97. package/dist/register/core.js +2 -0
  98. package/dist/register/create-commands.js +28 -3
  99. package/dist/register/deliverable-target.js +9 -1
  100. package/dist/register/epic.js +104 -26
  101. package/dist/register/event-merge.js +3 -0
  102. package/dist/register/events.js +4 -0
  103. package/dist/register/external-project.js +3 -0
  104. package/dist/register/item.js +6 -0
  105. package/dist/register/maintenance-commands.js +4 -1
  106. package/dist/register/planning.js +7 -14
  107. package/dist/register/register.js +74 -32
  108. package/dist/register/track-domains.js +34 -0
  109. package/dist/register/track-plan.js +78 -0
  110. package/dist/register/transition-commands.js +8 -0
  111. package/dist/register/work-table.js +64 -0
  112. package/dist/review/grade.js +35 -13
  113. package/dist/routine/definition.js +4 -3
  114. package/dist/routine/failure.js +30 -0
  115. package/dist/routine/routine.js +56 -32
  116. package/dist/routine/storage.js +33 -0
  117. package/dist/schedule/schedule.js +1 -0
  118. package/dist/schedule/strategy-generate-document.js +26 -14
  119. package/dist/schedule/strategy-generate-scope.js +17 -45
  120. package/dist/schedule/strategy-generate.js +33 -3
  121. package/dist/schedule/strategy-profiles.js +86 -12
  122. package/dist/shared/agent-types.js +2 -0
  123. package/dist/shared/condense-records.js +25 -0
  124. package/dist/shared/deprecation.js +8 -0
  125. package/dist/shared/document-metadata.js +20 -0
  126. package/dist/shared/finding-cause.js +20 -0
  127. package/dist/shared/frontmatter-namespace.js +48 -0
  128. package/dist/shared/git.js +149 -15
  129. package/dist/shared/grade-result.js +17 -1
  130. package/dist/shared/local-state.js +20 -0
  131. package/dist/shared/markdownlint-config.js +8 -3
  132. package/dist/shared/plan-conventions.js +129 -0
  133. package/dist/shared/plan-templates.js +57 -41
  134. package/dist/shared/provider-scaffold.js +2 -0
  135. package/dist/shared/run-records.js +224 -0
  136. package/dist/shared/specdojo-config.js +39 -21
  137. package/dist/shared/specdojo-gitignore.js +1 -0
  138. package/dist/shared/text.js +65 -5
  139. package/dist/shared/timeline-index.js +2 -0
  140. package/docs/ja/specdojo/defaults/pm-review-viewpoints.yaml +11 -2
  141. package/docs/ja/specdojo/exec-templates/xep-common-conventions-template.md +4 -74
  142. package/docs/ja/specdojo/exec-templates/xep-condense-template.md +50 -0
  143. package/docs/ja/specdojo/exec-templates/xep-draft-template.md +17 -5
  144. package/docs/ja/specdojo/exec-templates/xep-fully-guided-template.md +16 -3
  145. package/docs/ja/specdojo/exec-templates/xep-recipe-guided-template.md +15 -5
  146. package/docs/ja/specdojo/exec-templates/xep-recipe-maintenance-template.md +6 -0
  147. package/docs/ja/specdojo/exec-templates/xep-register-template.md +1 -1
  148. package/docs/ja/specdojo/exec-templates/xep-rulebook-maintenance-template.md +6 -0
  149. package/docs/ja/specdojo/exec-templates/xep-sample-maintenance-template.md +6 -0
  150. package/docs/ja/specdojo/exec-templates/xep-template-maintenance-template.md +6 -0
  151. package/docs/ja/specdojo/exec-templates/xer-condense-template.md +25 -0
  152. package/docs/ja/specdojo/exec-templates/xp-common-conventions-template.md +50 -0
  153. package/docs/ja/specdojo/exec-templates/xrp-common-conventions-template.md +30 -0
  154. package/docs/ja/specdojo/guides/branch-workflow-guide.md +1 -1
  155. package/docs/ja/specdojo/guides/docs-editing-guide.md +48 -0
  156. package/docs/ja/specdojo/guides/docs-structure-guide.md +48 -15
  157. package/docs/ja/specdojo/guides/exec-config-guide.md +61 -28
  158. package/docs/ja/specdojo/guides/exec-operation-guide.md +61 -13
  159. package/docs/ja/specdojo/guides/exec-worktree-guide.md +20 -11
  160. package/docs/ja/specdojo/guides/orchestrator-operation-guide.md +4 -2
  161. package/docs/ja/specdojo/guides/plan-result-lifecycle-guide.md +92 -55
  162. package/docs/ja/specdojo/guides/project-move-guide.md +381 -0
  163. package/docs/ja/specdojo/guides/quick-start-guide.md +589 -807
  164. package/docs/ja/specdojo/guides/register-operation-guide.md +26 -4
  165. package/docs/ja/specdojo/guides/remote-host-development-guide.md +33 -4
  166. package/docs/ja/specdojo/guides/review-guide.md +22 -19
  167. package/docs/ja/specdojo/guides/routine-operation-guide.md +14 -8
  168. package/docs/ja/specdojo/guides/ryu-guide.md +23 -13
  169. package/docs/ja/specdojo/guides/schedule-design-guide.md +7 -4
  170. package/docs/ja/specdojo/guides/schedule-operation-guide.md +41 -3
  171. package/docs/ja/specdojo/guides/specdojo-overview-guide.md +5 -4
  172. package/docs/ja/specdojo/guides/timeline-design-guide.md +27 -144
  173. package/docs/ja/specdojo/guides/use-case-guide.md +471 -74
  174. package/docs/ja/specdojo/recipes/bac-recipe.md +94 -0
  175. package/docs/ja/specdojo/recipes/bes-recipe.md +105 -0
  176. package/docs/ja/specdojo/recipes/br-recipe.md +84 -0
  177. package/docs/ja/specdojo/recipes/cdfd-overview-recipe.md +88 -86
  178. package/docs/ja/specdojo/recipes/cdfd-uc-recipe.md +108 -122
  179. package/docs/ja/specdojo/recipes/cnd-recipe.md +125 -0
  180. package/docs/ja/specdojo/recipes/cpd-recipe.md +126 -0
  181. package/docs/ja/specdojo/recipes/cxd-recipe.md +145 -0
  182. package/docs/ja/specdojo/recipes/ifd-recipe.md +134 -0
  183. package/docs/ja/specdojo/recipes/ifx-cmd-recipe.md +135 -86
  184. package/docs/ja/specdojo/recipes/ifx-index-recipe.md +130 -0
  185. package/docs/ja/specdojo/recipes/pm-organization-recipe.md +29 -26
  186. package/docs/ja/specdojo/recipes/pm-plan-recipe.md +35 -26
  187. package/docs/ja/specdojo/recipes/pm-quality-management-plan-recipe.md +38 -28
  188. package/docs/ja/specdojo/recipes/pm-raci-recipe.md +39 -31
  189. package/docs/ja/specdojo/recipes/pm-roles-recipe.md +26 -28
  190. package/docs/ja/specdojo/recipes/prj-assumptions-constraints-dependencies-recipe.md +10 -8
  191. package/docs/ja/specdojo/recipes/prj-comparison-of-alternatives-recipe.md +18 -17
  192. package/docs/ja/specdojo/recipes/stsd-recipe.md +100 -62
  193. package/docs/ja/specdojo/recipes/sysd-critical-flows-recipe.md +106 -0
  194. package/docs/ja/specdojo/recipes/sysd-cross-cutting-policy-recipe.md +137 -0
  195. package/docs/ja/specdojo/recipes/sysd-index-recipe.md +122 -0
  196. package/docs/ja/specdojo/references/command-reference.md +146 -99
  197. package/docs/ja/specdojo/references/deliverables-reference.md +9 -4
  198. package/docs/ja/specdojo/references/directory-layout-reference.md +3 -2
  199. package/docs/ja/specdojo/references/specdojo-config-reference.md +17 -16
  200. package/docs/ja/specdojo/rulebooks/bac-rulebook.md +72 -290
  201. package/docs/ja/specdojo/rulebooks/bdd-rulebook.md +212 -79
  202. package/docs/ja/specdojo/rulebooks/bds-rulebook.md +138 -154
  203. package/docs/ja/specdojo/rulebooks/bes-index-rulebook.md +147 -59
  204. package/docs/ja/specdojo/rulebooks/bes-rulebook.md +100 -96
  205. package/docs/ja/specdojo/rulebooks/br-rulebook.md +88 -108
  206. package/docs/ja/specdojo/rulebooks/ccd-mermaid-rulebook.md +126 -211
  207. package/docs/ja/specdojo/rulebooks/cdfd-d2-rulebook.md +367 -0
  208. package/docs/ja/specdojo/rulebooks/cdfd-mermaid-rulebook.md +6 -5
  209. package/docs/ja/specdojo/rulebooks/cdfd-overview-rulebook.md +96 -100
  210. package/docs/ja/specdojo/rulebooks/cdfd-rulebook.md +38 -47
  211. package/docs/ja/specdojo/rulebooks/cdfd-uc-rulebook.md +132 -106
  212. package/docs/ja/specdojo/rulebooks/cdsd-rulebook.md +102 -68
  213. package/docs/ja/specdojo/rulebooks/cdt-rulebook.md +152 -0
  214. package/docs/ja/specdojo/rulebooks/cld-rulebook.md +9 -184
  215. package/docs/ja/specdojo/rulebooks/clis-rulebook.md +187 -0
  216. package/docs/ja/specdojo/rulebooks/cnd-rulebook.md +93 -247
  217. package/docs/ja/specdojo/rulebooks/cpd-rulebook.md +104 -241
  218. package/docs/ja/specdojo/rulebooks/cxd-rulebook.md +124 -257
  219. package/docs/ja/specdojo/rulebooks/dct-index-rulebook.md +87 -98
  220. package/docs/ja/specdojo/rulebooks/dct-rulebook.md +9 -7
  221. package/docs/ja/specdojo/rulebooks/dec-rulebook.md +2 -1
  222. package/docs/ja/specdojo/rulebooks/dss-rulebook.md +193 -0
  223. package/docs/ja/specdojo/rulebooks/gl-rulebook.md +100 -54
  224. package/docs/ja/specdojo/rulebooks/ifd-mermaid-rulebook.md +69 -252
  225. package/docs/ja/specdojo/rulebooks/ifx-cmd-rulebook.md +91 -76
  226. package/docs/ja/specdojo/rulebooks/ifx-file-rulebook.md +252 -226
  227. package/docs/ja/specdojo/rulebooks/ifx-index-rulebook.md +118 -40
  228. package/docs/ja/specdojo/rulebooks/imp-business-rulebook.md +11 -11
  229. package/docs/ja/specdojo/rulebooks/imp-data-rulebook.md +9 -9
  230. package/docs/ja/specdojo/rulebooks/imp-interface-rulebook.md +4 -4
  231. package/docs/ja/specdojo/rulebooks/imp-operations-rulebook.md +11 -11
  232. package/docs/ja/specdojo/rulebooks/imp-test-rulebook.md +11 -11
  233. package/docs/ja/specdojo/rulebooks/mm-rulebook.md +4 -3
  234. package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +34 -29
  235. package/docs/ja/specdojo/rulebooks/pm-change-request-log-rulebook.md +8 -8
  236. package/docs/ja/specdojo/rulebooks/pm-issue-log-rulebook.md +2 -2
  237. package/docs/ja/specdojo/rulebooks/pm-organization-rulebook.md +50 -56
  238. package/docs/ja/specdojo/rulebooks/pm-plan-rulebook.md +46 -55
  239. package/docs/ja/specdojo/rulebooks/pm-quality-management-plan-rulebook.md +57 -54
  240. package/docs/ja/specdojo/rulebooks/pm-raci-rulebook.md +50 -65
  241. package/docs/ja/specdojo/rulebooks/pm-risk-register-rulebook.md +2 -2
  242. package/docs/ja/specdojo/rulebooks/pm-roles-rulebook.md +70 -97
  243. package/docs/ja/specdojo/rulebooks/pr-rulebook.md +2 -1
  244. package/docs/ja/specdojo/rulebooks/prj-assumptions-constraints-dependencies-rulebook.md +47 -56
  245. package/docs/ja/specdojo/rulebooks/prj-comparison-of-alternatives-rulebook.md +61 -135
  246. package/docs/ja/specdojo/rulebooks/sf-index-rulebook.md +116 -32
  247. package/docs/ja/specdojo/rulebooks/sf-rulebook.md +118 -61
  248. package/docs/ja/specdojo/rulebooks/sld-rulebook.md +152 -57
  249. package/docs/ja/specdojo/rulebooks/stsd-mermaid-rulebook.md +51 -39
  250. package/docs/ja/specdojo/rulebooks/stsd-rulebook.md +101 -46
  251. package/docs/ja/specdojo/rulebooks/sysd-critical-flows-rulebook.md +72 -329
  252. package/docs/ja/specdojo/rulebooks/sysd-cross-cutting-policy-rulebook.md +74 -263
  253. package/docs/ja/specdojo/rulebooks/sysd-index-rulebook.md +78 -195
  254. package/docs/ja/specdojo/rulebooks/tml-rulebook.md +4 -9
  255. package/docs/ja/specdojo/rulebooks/trc-requirements-to-specs-rulebook.md +3 -4
  256. package/docs/ja/specdojo/rulebooks/trc-requirements-to-tests-rulebook.md +3 -3
  257. package/docs/ja/specdojo/rulebooks/uis-rulebook.md +140 -143
  258. package/docs/ja/specdojo/samples/bac-sample.md +106 -21
  259. package/docs/ja/specdojo/samples/bdd-sample.yaml +143 -35
  260. package/docs/ja/specdojo/samples/bds-sample.md +100 -21
  261. package/docs/ja/specdojo/samples/bes-index-sample.md +59 -20
  262. package/docs/ja/specdojo/samples/bes-sample.md +80 -21
  263. package/docs/ja/specdojo/samples/br-sample.md +68 -14
  264. package/docs/ja/specdojo/samples/ccd-sample.md +81 -19
  265. package/docs/ja/specdojo/samples/cdfd-overview-sample.md +248 -140
  266. package/docs/ja/specdojo/samples/cdfd-sample.md +172 -99
  267. package/docs/ja/specdojo/samples/cdfd-uc-sample.md +130 -97
  268. package/docs/ja/specdojo/samples/cdsd-sample.md +89 -20
  269. package/docs/ja/specdojo/samples/cdt-sample.md +116 -0
  270. package/docs/ja/specdojo/samples/cld-sample.md +3 -30
  271. package/docs/ja/specdojo/samples/clis-sample.md +132 -0
  272. package/docs/ja/specdojo/samples/cnd-sample.md +127 -21
  273. package/docs/ja/specdojo/samples/cpd-sample.md +136 -22
  274. package/docs/ja/specdojo/samples/cxd-sample.md +108 -22
  275. package/docs/ja/specdojo/samples/dct-index-sample.yaml +63 -17
  276. package/docs/ja/specdojo/samples/dss-sample.md +175 -0
  277. package/docs/ja/specdojo/samples/gl-sample.yaml +50 -14
  278. package/docs/ja/specdojo/samples/ifd-sample.md +105 -21
  279. package/docs/ja/specdojo/samples/ifx-cmd-sample.yaml +91 -60
  280. package/docs/ja/specdojo/samples/ifx-file-sample.md +462 -21
  281. package/docs/ja/specdojo/samples/ifx-index-sample.yaml +87 -19
  282. package/docs/ja/specdojo/samples/pm-members-sample.yaml +37 -13
  283. package/docs/ja/specdojo/samples/pm-organization-sample.md +52 -20
  284. package/docs/ja/specdojo/samples/pm-plan-sample.md +84 -26
  285. package/docs/ja/specdojo/samples/pm-quality-management-plan-sample.md +55 -22
  286. package/docs/ja/specdojo/samples/pm-raci-sample.md +69 -28
  287. package/docs/ja/specdojo/samples/pm-roles-sample.yaml +13 -12
  288. package/docs/ja/specdojo/samples/prj-assumptions-constraints-dependencies-sample.md +50 -26
  289. package/docs/ja/specdojo/samples/prj-comparison-of-alternatives-sample.md +89 -62
  290. package/docs/ja/specdojo/samples/sf-index-sample.md +89 -20
  291. package/docs/ja/specdojo/samples/sf-sample.md +121 -21
  292. package/docs/ja/specdojo/samples/sld-sample.md +107 -21
  293. package/docs/ja/specdojo/samples/stsd-sample.md +54 -26
  294. package/docs/ja/specdojo/samples/sysd-critical-flows-sample.md +166 -21
  295. package/docs/ja/specdojo/samples/sysd-cross-cutting-policy-sample.md +178 -21
  296. package/docs/ja/specdojo/samples/sysd-index-sample.md +82 -21
  297. package/docs/ja/specdojo/samples/tml-sample.yaml +4 -1
  298. package/docs/ja/specdojo/samples/uis-sample.md +164 -20
  299. package/docs/ja/specdojo/standards/document-metadata-standard.md +33 -4
  300. package/docs/ja/specdojo/standards/id-and-file-naming-standard.md +3 -1
  301. package/docs/ja/specdojo/standards/rulebook-authoring-standard.md +1 -0
  302. package/docs/ja/specdojo/templates/bac-template.md +76 -0
  303. package/docs/ja/specdojo/templates/bes-template.md +56 -0
  304. package/docs/ja/specdojo/templates/br-template.md +64 -0
  305. package/docs/ja/specdojo/templates/cdfd-overview-template.md +161 -83
  306. package/docs/ja/specdojo/templates/cdfd-template.md +81 -54
  307. package/docs/ja/specdojo/templates/cdfd-uc-template.md +130 -89
  308. package/docs/ja/specdojo/templates/cnd-template.md +137 -0
  309. package/docs/ja/specdojo/templates/cpd-template.md +129 -0
  310. package/docs/ja/specdojo/templates/cxd-template.md +105 -0
  311. package/docs/ja/specdojo/templates/dct-data-model-cdt-template.yaml +40 -0
  312. package/docs/ja/specdojo/templates/dct-data-model-cld-template.yaml +7 -14
  313. package/docs/ja/specdojo/templates/dct-index-template.md +9 -20
  314. package/docs/ja/specdojo/templates/dct-project-management-template.yaml +5 -1
  315. package/docs/ja/specdojo/templates/ifd-template.md +86 -0
  316. package/docs/ja/specdojo/templates/ifx-cmd-template.yaml +44 -28
  317. package/docs/ja/specdojo/templates/ifx-index-template.yaml +40 -0
  318. package/docs/ja/specdojo/templates/opr-template.md +2 -4
  319. package/docs/ja/specdojo/templates/pm-organization-template.md +9 -3
  320. package/docs/ja/specdojo/templates/pm-plan-template.md +4 -4
  321. package/docs/ja/specdojo/templates/pm-quality-management-plan-template.md +17 -9
  322. package/docs/ja/specdojo/templates/pm-raci-template.md +24 -13
  323. package/docs/ja/specdojo/templates/pm-roles-template.yaml +3 -2
  324. package/docs/ja/specdojo/templates/prj-assumptions-constraints-dependencies-template.md +6 -3
  325. package/docs/ja/specdojo/templates/prj-comparison-of-alternatives-template.md +22 -19
  326. package/docs/ja/specdojo/templates/stsd-template.md +46 -21
  327. package/docs/ja/specdojo/templates/sysd-critical-flows-template.md +94 -0
  328. package/docs/ja/specdojo/templates/sysd-cross-cutting-policy-template.md +122 -0
  329. package/docs/ja/specdojo/templates/sysd-index-template.md +89 -0
  330. package/docs/specdojo/lib/yaml-metadata.cjs +7 -0
  331. package/docs/specdojo/schemas/v1/bdd.schema.yaml +25 -57
  332. package/docs/specdojo/schemas/v1/condense-records.schema.yaml +26 -0
  333. package/docs/specdojo/schemas/v1/dct.schema.yaml +10 -0
  334. package/docs/specdojo/schemas/v1/deliverable-frontmatter.schema.yaml +3 -0
  335. package/docs/specdojo/schemas/v1/esil.schema.yaml +7 -141
  336. package/docs/specdojo/schemas/v1/exec-common.schema.yaml +3 -0
  337. package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +54 -3
  338. package/docs/specdojo/schemas/v1/exec-evidence.schema.yaml +3 -0
  339. package/docs/specdojo/schemas/v1/exec-plan-frontmatter.schema.yaml +14 -0
  340. package/docs/specdojo/schemas/v1/exec-result-frontmatter.schema.yaml +18 -0
  341. package/docs/specdojo/schemas/v1/finding-cause.schema.yaml +22 -0
  342. package/docs/specdojo/schemas/v1/grade-pipeline-state.schema.yaml +1 -1
  343. package/docs/specdojo/schemas/v1/grade-result.schema.yaml +2 -0
  344. package/docs/specdojo/schemas/v1/ifx-cmd.schema.yaml +65 -5
  345. package/docs/specdojo/schemas/v1/ifx-index.schema.yaml +142 -0
  346. package/docs/specdojo/schemas/v1/register-events.schema.yaml +2 -0
  347. package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +17 -1
  348. package/docs/specdojo/schemas/v1/specdojo-config.schema.yaml +1 -0
  349. package/package.json +6 -3
  350. package/templates/antigravity/README.md +19 -46
  351. package/templates/antigravity/exec-defaults-snippet.yaml +5 -6
  352. package/templates/antigravity/orchestrator.md +3 -2
  353. package/templates/antigravity/settings.edit.json +73 -0
  354. package/templates/antigravity/settings.orchestrator.json +15 -0
  355. package/templates/antigravity/settings.report.json +7 -0
  356. package/templates/antigravity/settings.review.json +7 -0
  357. package/templates/claude/agents/specdojo-orchestrator.md +3 -2
  358. package/templates/codex/agents/specdojo-orchestrator.toml +3 -2
  359. package/templates/codex/orchestrator.md +3 -2
  360. package/templates/devcontainer/remote-host/devcontainer-tmux.sh +217 -0
  361. package/templates/devcontainer/remote-host/specdojo-tmux.sh.sample +8 -96
  362. package/templates/devcontainer/remote-host/ssh-config.sample +3 -1
  363. package/templates/devcontainer/tmux.conf +6 -0
  364. package/templates/init-agent-members.yaml +1 -0
  365. package/templates/init-exec-defaults.yaml +1 -1
  366. package/templates/opencode/agents/specdojo-orchestrator.md +3 -2
@@ -10,6 +10,7 @@ specdojo:
10
10
  template: specdojo:cdfd-uc-template
11
11
  includes:
12
12
  - specdojo:cdfd-mermaid-rulebook
13
+ - specdojo:cdfd-d2-rulebook
13
14
  based_on:
14
15
  - specdojo:rulebook-authoring-standard
15
16
  ---
@@ -18,155 +19,180 @@ specdojo:
18
19
 
19
20
  Conceptual Data Flow Diagram Use Case Documentation Rulebook
20
21
 
21
- 全体概要で選定した一つの横断ユースケースについて、複数のプロセスグループを通る順序、グループ間で引き渡す情報、引き渡し条件、条件不成立時の戻り先を、表と Mermaid 図で合意可能にするためのルールです。グループ内部のプロセスと状態遷移は、それぞれプロセスグループ別 CDFD と STSD を参照します。
22
+ 全体概要で選定した一つのユースケースまたは系統について、開始から終了までの流れと、受け渡す情報・物を表と概念データフロー図(Mermaid または D2)で示すためのルールです。状態の定義と遷移は STSD を正本とします。
22
23
 
23
24
  ## 1. 全体方針
24
25
 
25
- - 一文書は、全体概要の「詳細 CDFD 一覧」にある一つのケース ID とユースケースを詳細化します。単一のプロセスグループに閉じる業務には作成しません。
26
- - 「プロセス領域」を順序とグループ別責務の正本、「データストア」を引き渡しで使う上位一覧の部分集合、「引き渡し」を情報・条件・戻す条件の正本、図を開始から終了までの横断順序の正本として併用します。
27
- - 図の一つのプロセスノードは一つのプロセスグループを表します。グループ内部の領域やプロセスを再掲せず、対応する `cdfd-<group>` を参照します。
28
- - 引き渡し条件は、送り元の成果が受け側の開始に足りることを判定できる形にします。条件を満たさない場合の戻り先、戻す情報、再開条件も定めます。
29
- - 状態名・成立条件・遷移元・遷移先・イベント・遷移条件は STSD を正本とします。本書は状態の定義や遷移表を持たず、グループ間の引き渡しだけを扱います。
30
- - 人間が担う承認や最終判断を省略しません。AI Agent やシステムは支援主体として扱えても、責任分担の正本は対応する方針文書を参照します。
26
+ - 一文書は、全体概要の「詳細 CDFD 一覧」にある一つのケース ID と、そのユースケースまたは系統を詳細化します。描く単位と詳細化の境界は「描き方の選択」に従います。
27
+ - 開始から終了までの横断順序と受け渡しは「概念データフロー」の図だけを正本とします。「プロセス領域」は責務の正本であり、順序欄と章冒頭の通過順は図に一致させる対応表現です。不一致時は図を根拠に表・通過順を修正し、業務上の順序を変更するときは図を改訂してから追従させます。「データストア」は全体概要の一覧の部分集合とし、主要入力・主要出力の箇条書きや引き渡しを列挙する章は設けません。
28
+ - 渡す情報・物は図の線のラベルで表します。引き渡し条件のイベントや引き渡し ID は使いません。対象範囲の例外時の戻りは省略せず、線が多い場合は図を分けます。
29
+ - 詳細の図に Orchestrator(調整役)を置きません。調整は全体概要の「Orchestrator による PDCA の調整」などの指示の図へ委ねます。
30
+ - 目的はその業務が何のためにあるかを 1〜2 文、適用範囲は対象と対象外を 1 行ずつとします。人間と AI Agent の責任分担などの共通原則と凡例は、全体概要を参照し、本書で再定義しません。
31
+ - 状態名・成立条件・遷移元・遷移先・イベント・遷移条件は STSD を正本とします。本書は状態の定義や遷移表を持ちません。
31
32
 
32
33
  ## 2. 位置づけと用語定義
33
34
 
34
- | 用語 | 定義 |
35
- | -------------------------- | --------------------------------------------------------------------------------------------------------- |
36
- | 全体概要 | プロセス領域、プロセスグループ、データストア、詳細 CDFD の割り当てを定める `cdfd-overview` |
37
- | ユースケース別 CDFD | 複数のプロセスグループをまたぐ一つの業務について、グループ間の順序と引き渡し条件だけを定める CDFD |
38
- | プロセスグループ代表ノード | 横断順序に参加する一つのプロセスグループを表す角丸長方形のノード。グループ内部のプロセスは含めない |
39
- | 引き渡し | 送り元グループの成果を、判定可能な条件の成立後に受け側グループの入力として渡す責任境界 |
40
- | 引き渡し条件 | 引き渡す情報の完全性、承認、記録の確定など、受け側グループを開始できることを判定する条件 |
41
- | 戻す条件 | 引き渡し条件の不成立または受け側で判明した不足により、情報や判断を送り元または先行グループへ返す条件 |
42
- | 例外時の戻り先 | 条件不成立時に補完・再判断を担い、再開条件を成立させるプロセスグループ |
43
- | 関連データストア | 引き渡し条件の判定または引き渡す情報の正本として必要な、全体概要と同じ名称・区分を持つデータストア |
44
- | グループ内部 | `cdfd-<group>` が正本とする、領域、個別プロセス、プロセス入出力、主要例外、データストアの具体的な読み書き |
35
+ | 用語 | 定義 |
36
+ | ---------------- | -------------------------------------------------------------------------- |
37
+ | 全体概要 | 領域のまとまり、データストア、詳細 CDFD の割り当てを定める `cdfd-overview` |
38
+ | ケース ID | 全体概要でユースケースまたは系統に割り当てられた `C-<nn>` 形式の識別子 |
39
+ | 起点イベント | 業務を始める、発生を判定できる出来事 |
40
+ | 関連データストア | 対象ケースで参照・更新する、全体概要と同じ名称・区分を持つ正本 |
41
+ | 例外時の戻り | 不足や不一致を、補完・再判断を担う参加単位へ返す業務上の流れ |
45
42
 
46
- 全体概要は横断ユースケースの業務目的、ケース ID、参加グループを選定します。ユースケース別 CDFD はその選定を変えずにグループ間の順序と引き渡しを具体化し、各グループの内部はプロセスグループ別 CDFD へ委ねます。
43
+ 全体概要がケースの業務目的と対象範囲を選定し、本書がその流れを具体化します。領域の分割、名称、担当、起点イベントは全体概要を正本とします。構造・必須項目・禁止事項の判断は本 rulebook に従い、骨組みや作成手順と矛盾する場合もこの内容要件を優先します。
47
44
 
48
45
  ## 3. ファイル命名・ID規則
49
46
 
50
47
  - 対象プロダクトの業務仕様配下にあるデータフローディレクトリへ配置します。
51
- - ファイル名と成果物 ID は `cdfd-uc-<topic>` とし、ファイル名だけ `.md` を付けます。`<topic>` は全体概要のユースケースを表す英小文字・数字・ハイフンのスラッグです。
48
+ - ファイル名と成果物 ID は `cdfd-uc-<topic>` とし、ファイル名だけ `.md` を付けます。`<topic>` は全体概要のユースケースまたは系統を表す英小文字・数字・ハイフンのスラッグです。
52
49
  - product 成果物の ID にプロジェクト ID や authority を付けません。例: ファイル名 `cdfd-uc-replenishment.md`、ID `cdfd-uc-replenishment`。
53
- - ケース ID は全体概要の `C-<nn>` 形式をそのまま引き継ぎ、新しい ID を採番したり別のユースケースの ID を流用したりしません。
54
- - 引き渡し ID は文書内で一意な `H-<nn>` 形式とし、正常順序に沿って採番します。同じ引き渡しには、引き渡し表、図、例外時の戻り先で同じ ID を使います。
55
- - プロセスグループ名、領域 ID、データストア名は全体概要と一致させます。プロセスグループ別 CDFD の参照先は `cdfd-<group>` 形式とします。
50
+ - ケース ID は全体概要の `C-<nn>` を引き継ぎ、新しい ID の採番や別ケースの ID の流用はしません。
51
+ - 領域 ID、プロセスグループ名・区分名、データストア名は全体概要と一致させます。図を分けても同じ対象に同じ ID・名称を使い、接続のための独自 ID は付けません。
56
52
 
57
53
  ## 4. 推奨 Frontmatter 項目
58
54
 
59
- | 項目 | 説明 | 必須 |
60
- | ---------- | ----------------------------------------------------- | ---- |
61
- | id | プロジェクト修飾なしの `cdfd-uc-<topic>` | ○ |
62
- | type | `flow` | ○ |
63
- | status | `draft` / `ready` / `deprecated` | ○ |
64
- | rulebook | `specdojo:cdfd-uc-rulebook` | ○ |
65
- | based_on | 全体概要など、依存関係上許可された直接の内容根拠の ID | 任意 |
66
- | supersedes | 置き換える旧ユースケース別 CDFD の ID | 任意 |
67
-
55
+ - 共通の必須項目、値・構文・構造は [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] と同標準が参照するスキーマに従い、本書では再定義しません。成果物種別は本 rulebook の `deliverable_type` に従います。
68
56
  - `based_on` に全体概要を記載する場合も product 成果物 ID を使用し、成果物カタログの `depends_on` の推移閉包に含まれる根拠だけを列挙します。
69
- - ケース ID、ユースケース名、対象者、開始・終了条件は本文で定義し、未定義の Frontmatter 項目を追加しません。
70
- - 作成途中の `status` は `draft` とし、完成判定と所定の承認を満たした後の昇格は定められた承認者が行います。
57
+ - status が `deprecated` の文書を `based_on` と本文の参照先にしません。有効な全体概要や後継文書へ参照を更新します。
58
+ - ケース ID、ユースケース名、開始・終了は本文で定義し、未定義の Frontmatter 項目を追加しません。
59
+ - 作成・改訂中は `status: draft` を維持します。人間による `ready` 昇格の承認者・証跡と確認手順は「完成判定」に従います。
71
60
 
72
61
  ## 5. 本文要件
73
62
 
74
- 見出し順・表・記入欄の骨組みは template を正本とします。本章は各章の目的と必須・任意を定めます。
63
+ 見出し順・表・記入欄の骨組みは template を正本とし、本章では重複させず、必要な判断情報を定めます。
75
64
 
76
- | 番号 | 見出し | 必須 | 内容 |
77
- | ---- | ---------------- | -------- | ------------------------------------------------------------------------------------------------------------- |
78
- | 冒頭 | 導入文 | ○ | ケース ID、ユースケース、横断目的を一文で定義 |
79
- | 1 | 目的 | ○ | 対象者と、横断順序・責任境界・設計入力の利用場面 |
80
- | 2 | 適用範囲 | ○ | ケース ID、開始イベント、終了条件、参加グループ、組織・システム境界、対象外、責任分担 |
81
- | 3 | プロセス領域 | ○ | グループごとの節。説明文、主要入力・主要出力・データストアの箇条書き、横断上の役割の表 |
82
- | 4 | データストア | ○ | 全体概要と同じ名称・区分を持つ、引き渡す情報または条件判定に使うデータストアの部分集合 |
83
- | 5 | 概念データフロー | ○ | 開始イベント、グループ代表ノード、引き渡し条件、関連データストア、終了条件だけを示す Mermaid 図と図直後の注記 |
84
- | 6 | 引き渡し | ○ | 引き渡し ID、送り元、受け側、引き渡す情報、引き渡し条件、戻す条件 |
85
- | 7 | 例外時の戻り先 | ○ | 対象引き渡し、条件不成立、戻り先グループ、戻す情報、再開条件 |
86
- | 8 | 未決事項 | 条件付き | 横断境界、引き渡し条件、戻り先、判断者が未確定な論点。未決事項がある場合だけ設ける |
65
+ - **業務の識別と境界(必須)**: 導入文でケース ID と業務名、目的で業務の存在理由と成果、適用範囲で対象と対象外を示します。共通の責任分担は全体概要へ委ねます。
66
+ - **責務と正本の利用(必須)**: プロセス領域で参加単位の責務と詳細化の境界を、データストアで全体概要から選んだ正本の用途を示します。各節は役割表または利用の表とし、入出力の列挙に展開しません。
67
+ - **流れの合意(必須)**: 概念データフローで開始・終了、参加単位、関連データストア、情報・物の受け渡しを示します。各図に業務の言葉による題と説明 1 文を付けます。
68
+ - **判断待ちの可視化(条件付き)**: 境界、名称、責務、判断者に未確定の論点がある場合だけ、未決事項を最終章に置きます。
87
69
 
88
- 「未決事項」を設ける場合は最終章とします。図を分割する場合は「概念データフロー」に `5.1.`、`5.2.` の節を設け、引き渡し ID を接続キーにします。
70
+ 「引き渡し」「例外時の戻り先」の章は設けません。図を分ける場合は「概念データフロー」に `5.1.`、`5.2.` の節を設けます。対象範囲に例外時の戻りがある場合は、同章内の図で漏れなく示します。戻りがない場合だけ、その図を省略します。
89
71
 
90
72
  ## 6. 記述ガイド
91
73
 
92
- ### 6.1. 導入文と目的
74
+ ### 6.1. 描き方の選択
75
+
76
+ 全体概要で採用された方式から、次のどちらかを選びます。以下では、表の一行と図の一つのプロセスノードが表す対象を「参加単位」と呼びます。
77
+
78
+ | 観点 | 通常の横断ユースケース | 系統の関係を描く方式の詳細 |
79
+ | ------------ | -------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------- |
80
+ | 対象 | 二つ以上のプロセスグループを横断する一つの業務。単一グループに閉じる業務には作成しない | 全体概要で選定した一つの系統と、通過する共用領域 |
81
+ | 参加単位 | 一つのプロセスグループを一つの代表ノードにし、名称と含む領域 ID を併記 | 一つのプロセス領域を一つのノードにし、`P-xx 領域名` を表示 |
82
+ | 表のまとまり | 全体概要のプロセスグループごと | 全体概要の区分ごと。PDCA の段階で区分を置き換えない |
83
+ | 詳細化の境界 | グループ内部の領域・プロセス・主要例外は有効な `cdfd-<group>` へ委ねる | 対象系統と共用領域の流れを領域単位で示し、非推奨のグループ別 CDFD へ依存しない |
84
+ | 入口 | ケースの開始イベントを描く | 系統の入口の起点イベントを描き、文言を全体概要の「プロセス領域」の表と一致させる |
85
+
86
+ どちらの方式でも、複数の系統(ユースケース)が共通して通るプロセス領域(領域のまとまりを含む)の内部は、全体概要またはその領域の詳細文書の 1 か所だけで描きます。ほかの詳細文書では、その領域を 1 つのノードとして置き、領域との受け渡しの線だけを描きます。領域のまとまりを 1 ノードにする場合も、全体概要の名称と含む領域 ID を併記します。内部を描く文書を役割表の「参照先」に示し、内部のプロセス・データストアの読み書き・例外時の戻りを重複して展開しません。その領域から外へ返す例外の情報は、受け渡しとして省略せず描きます。
87
+
88
+ 良い例: 共用する実行・評価・完了を 1 ノードにまとめ、内部の正本を参照する。悪い例: 系統ごとに共用領域の内部を描き直す。
89
+
90
+ ### 6.2. 導入文と目的
91
+
92
+ - 導入文は、全体概要で選んだケース ID と業務名を一文で明示します。作成手順では、ケースを選んだ直後、目的を書く前に導入文を置きます。recipe の章別ガイドに導入文の項目がない場合も、この手順を適用します。
93
+ - 目的は、そのユースケースまたは系統が何のためにあるかを 1〜2 文で記述します。
94
+ - BA・QE・承認者など、読み手ごとの承認・設計・確認作業を目的に書きません。
95
+
96
+ 良い例: 導入文は「ケース `C-02`『欠品から補充まで』の流れを示す」、目的は「欠品した商品を補充し、売場で販売できるようにする」。悪い例: ケースを特定せず、目的を「BA が承認し、QE が検証するため」とする。
97
+
98
+ ### 6.3. 適用範囲
93
99
 
94
- - 導入文は「ケース `C-02` の欠品から補充まで」のように、全体概要のケース ID とユースケース名を明示し、どのグループ間の引き渡しを定めるかを一文で示します。
95
- - 目的は、誰が横断順序を承認し、誰がグループ間の入出力を設計へ使い、誰が重複・欠落を確認するかを利用結果と結び付けます。
96
- - 上位の業務目的を長く書き写さず、グループ境界の合意によって防ぐ欠落や手戻りを示します。
100
+ - 対象はケース ID、参加単位、開始イベント、終了時の成果、必要な組織・システム境界を 1 行(1 文)で示します。
101
+ - 対象外は操作手順、補助操作、実装詳細などを 1 行(1 文)で示し、詳細化の境界は「描き方の選択」に従います。状態の定義と遷移は STSD を正本とします。
102
+ - 人間と AI Agent の責任分担などの共通原則は、全体概要を参照します。
97
103
 
98
- ### 6.2. 適用範囲
104
+ 良い例: 対象を「在庫の補充基準割れから販売の商品引受けまで」、対象外を「内部の発注手順・状態遷移は各正本へ委ねる」と分ける。悪い例: 「補充に関する全業務」とだけ書き、内部処理との境界を決めない。
99
105
 
100
- - 全体概要からケース ID、ユースケース名、横断するプロセスグループを引き継ぎます。グループを追加・削除・改名する必要がある場合は、先に全体概要を変更します。
101
- - 開始イベントは最初のグループが動き始める出来事、終了条件は最後のグループが受け取った成果を利用可能と判断できる状態として記述します。
102
- - 対象外には、グループ内部の領域・プロセス・主要例外、補助操作、実装詳細、状態の定義・遷移を明記し、対応する `cdfd-<group>` と STSD へ委ねます。
103
- - 人間と AI Agent の責任分担は本文で再定義せず、対応する方針文書を参照します。参照先がない場合は、人間が承認と最終判断を担う原則だけを記載します。
106
+ ### 6.4. プロセス領域
104
107
 
105
- ### 6.3. プロセス領域
108
+ - 章冒頭にケース ID、図に従う正常系の通過順、全体概要との正本関係を簡潔に示します。条件付きの計画連携・補完だけを担う参加単位は、常に通る主経路と区別し、順序欄に「計画連携時」「補完時」など図に対応する参加場面を示します。
109
+ - 全体概要と同じまとまりごとに節(`3.1.`、`3.2.`、…)を設け、見出しは「グループ名または区分名(含む領域 ID)」とします。各節には役割の表だけを置き、入力・出力やデータストアの箇条書きは置きません。
110
+ - 表の列は次のとおりです。同じ参加単位が再登場する場合は別の行にして役割を区別します。
106
111
 
107
- - 章の冒頭で、ケース ID、参加グループ数、正常系の通過順、全体概要との正本関係を示します。
108
- - 正常系で通過するプロセスグループごとに節(`3.1.`、`3.2.`、…)を設け、見出しは「グループ名(含む領域 ID の範囲)」とします。同じグループが正常系で再登場する場合は別の節とし、その理由を説明します。
109
- - 各節は、そのグループが前段から何を受け取り次段へ何を渡すかを示す 1〜3 文の説明、`**主要入力**`・`**主要出力**`・`**データストア**` の箇条書き、横断上の役割を示す表の順で構成します。
110
- - 表は「順序」「プロセスグループ」「含む領域」「横断上の役割」「参照先」の 5 列とし、一節に一行を記載します。グループ名と領域 ID は全体概要から引き継ぎ、参照先は `cdfd-<group>` 形式とします。
111
- - 内部プロセス、内部例外、担当は書き写しません。未作成の参照先も安定した ID をバッククォートで示し、作成状況は登録簿で追跡します。
112
+ | 列 | 記載内容 |
113
+ | ---------------------- | ---------------------------------------------------------------------------------------------------- |
114
+ | 順序 | 図から転記する正常系の通過順または条件付きの参加場面。表の独自判断で順番を定めない |
115
+ | プロセスグループ・区分 | 全体概要で領域をまとめている名称 |
116
+ | 含む領域 | 全体概要と同じ領域 ID。領域単位の行では領域名も併記し、「プロセス領域」という列名にしてよい |
117
+ | PDCA(任意) | 全体概要にある Plan、Do、Check、Action、全体などの位置付け。「プロセスグループ・区分」とは別の分類軸 |
118
+ | 横断上の役割 | このケースで担う業務上の責務 |
119
+ | 参照先 | 全体概要または有効な詳細文書。未作成の文書は ID をインラインコードで仮置き |
112
120
 
113
- ### 6.4. データストア
121
+ 良い例: 図の在庫→仕入→販売に合わせて順序欄を 1・2・3 とする。悪い例: 図が在庫→仕入→販売でも、表の節順だけで仕入を 1 とする。
114
122
 
115
- - 全体概要の「データストア」と同じ「マスタ・構成データ」「トランザクションデータ」の節に分け、引き渡す情報または引き渡し条件の判定に使う行だけを掲載します。該当する行がない区分は節ごと省略します。
116
- - 表の列は「データストア」「関連引き渡し」「横断上の利用」とします。関連引き渡しには `H-<nn>` を記載し、どの情報または条件の正本かを利用内容で説明します。
117
- - 名称と区分は全体概要から変更しません。新しいデータストアまたは区分変更が必要なら先に全体概要を変更し、本章だけへ追加しません。
118
- - 各行は概念データフローの同名ノードに対応させます。図に置かないデータストアや、本章に行のないデータストアノードを残しません。
123
+ ### 6.5. データストア
119
124
 
120
- ### 6.5. 概念データフロー
125
+ - 全体概要と同じ「マスタ・構成データ」「トランザクションデータ」の節に分け、対象ケースで参照・更新する行だけを同じ名称・区分で示します。該当行がない区分は節ごと省略します。
126
+ - 表は「データストア」「関連する参加単位」「横断上の利用」の列とします。関連は参加単位の名称または領域 ID で示します。
127
+ - 各行を図の同名ノードへ対応させます。物理保管は全体概要の区分に従い、保管先の詳細や物理項目へ展開しません。
121
128
 
122
- - Mermaid のノード、エッジ、形状、線種は Frontmatter の `includes` で指定した記法ルールに従います。
123
- - プロセスノードは「プロセス領域」の各表の一行に対応する代表ノードとし、ラベルにグループ名と含む領域 ID を記載します。内部プロセス ID や処理名は描きません。
124
- - 開始イベント、引き渡し条件、終了条件をイベントノードとして置き、引き渡し ID と情報名をエッジラベルまたはイベントラベルで追跡可能にします。
125
- - データストアは、引き渡し条件の判定または引き渡す情報の正本として必要なものだけを、全体概要と同じ名称・区分で置きます。個別プロセスの読み書きや項目は描きません。
126
- - 図直後に、全体概要に「凡例(本プロダクト共通)」がある場合はその参照、ない場合は `specdojo:cdfd-mermaid-rulebook` の既定凡例に従う旨を記載します。併せて、使用した線種、内部プロセスを省略したこと、図に置いたデータストアの選定理由を示します。
127
- - 一図で順序を追えない場合は連続する引き渡し単位で分割し、前図の終了側と後図の開始側へ同じ引き渡し ID を記載します。
129
+ 良い例: 全体概要の「商品台帳」を同じ区分で選び、「在庫が補充基準を参照する」と用途を示す。悪い例: 商品台帳の全カラムや保存パスを転載する。
128
130
 
129
- ### 6.6. 引き渡し
131
+ ### 6.6. 概念データフロー
130
132
 
131
- - 一行を一つのグループ間引き渡しとし、「引き渡し ID」「送り元グループ」「受け側グループ」「引き渡す情報」「引き渡し条件」「戻す条件」の 6 列を使用します。
132
- - 引き渡す情報は「補充依頼」「承認済みの評価結果」のような業務上の名詞で記述し、ファイル形式や API 項目へ展開しません。
133
- - 引き渡し条件は、必要情報、承認、記録確認などの成立を第三者が yes / no で判定できる形にします。「処理が終わった」「問題がない」だけで終わらせません。
134
- - 戻す条件は、どの不足または不一致で受け側が開始できないかを示します。戻しが発生しない引き渡しは、その根拠を記載し、空欄にしません。
133
+ - ノード、線種、色、絵文字は全体概要の「凡例(本プロダクト共通)」で選択された記法ルール([[specdojo:cdfd-mermaid-rulebook|Mermaid 記法ルール]] または [[specdojo:cdfd-d2-rulebook|D2 記法ルール]])に従います。記法の宣言がなければ Mermaid とし、sample と template は D2 の例とします。参加単位・方向・イベントの要件が記法部品と異なる場合は本書を優先し、Mermaid も `flowchart TB` で縦に描きます。
134
+ - ノードのラベルに絵文字を付けるか付けないかは、全体概要の凡例の方針に合わせ、文書内の全図と系統間でそろえます。付ける場合は凡例の割り当てに従い、同じ対象には同じ絵文字を使います。詳細文書だけで追加・削除・変更しません。
135
+ - 正常系を上から下へ並べます。D2 は `direction: down` とし、戻りの線は上にあるノードを左辺にした `a <- b` で書きます。
136
+ - プロセスノードを役割表の行へ対応させ、通常の流れ全体を通して開始イベントと終了の出来事を描きます。分割図や戻りの図へ開始・終了を再掲する必要はありません。イベントは一つのノードに一つの出来事とし、発生を判定できる短い文にします。長い場合は改行し、原文を言い換えません。全体概要の起点イベントが複数の出来事を列挙している場合は、各出来事の文言を保ってノードを分けます。
137
+ - 参加単位どうし、または参加単位とデータストアを直接結び、渡す情報・物を名詞のラベルにします。必要な承認は「承認済みの補充依頼」のように成果の性質として表し、引き渡し条件を判定するイベントは置きません。
138
+ - Orchestrator とその調整要求・応答は描かず、全体概要の指示の図を参照します。対象範囲内の担当ロールを外部主体として追加しません。
139
+ - 図の題は「欠品から売場補充まで」「起票から完了記録まで」のように業務の言葉で付けます。説明は、その図から読み取れる流れや関係を 1 文で書きます。凡例への参照は別の短い注記にし、凡例を再定義しません。
140
+ - 分割の目安は、一図の受け渡しの線が 15 本を超える場合、または一ノードに入出力の線が合計 10 本以上集まる場合とし、連続する業務の段ごとに図を分けます。線は情報・物・起動・完了・戻り・再提示を各 1 本として数え、配置制御用の非表示線や凡例の線は含めません。目安以内でも線の交差やラベルの密集で接続を追いにくければ分けます。
141
+ - 分割後も必要な線を省略せず、接続する参加単位・データストアを同じ ID・名称で再掲します。図ごとに共有ノードと、別図・参照先へ委ねる範囲を短く注記し、開始から終了までの接続を追えるようにします。
135
142
 
136
- ### 6.7. 例外時の戻り先
143
+ 良い例: 仕入から販売へ「入荷数量・受入結果」を渡す線を描き、題を「欠品から売場補充まで」とする。悪い例: 「処理フロー」とだけ題を付け、受け渡しの線に情報名を付けない。
137
144
 
138
- - 表は「対象引き渡し」「条件不成立」「戻り先グループ」「戻す情報」「再開条件」の 5 列とし、すべての引き渡し ID を一度以上確認します。
139
- - 戻り先は補完・再判断の責任を持つ参加グループから選びます。グループ内部のどのプロセスへ戻すかは、対応するプロセスグループ別 CDFD に委ねます。
140
- - 再開条件は、修正済み情報の再提示、承認の成立、正本の読み返し確認など、同じ引き渡しを再評価できる条件にします。
141
- - 受け側の内部だけで完結する例外、ログ、再試行は記載しません。横断順序またはグループ間責任が変わるものだけを扱います。
145
+ ### 6.7. 例外時の戻りの図
146
+
147
+ - 対象範囲に、不足や不一致を補完・再判断する参加単位へ返す流れがある場合は、「概念データフロー」に「例外時の戻り」の図を追加し、重要度で絞らずにすべて描きます。共通して通る領域の内部だけは「描き方の選択」で定めた 1 か所の正本へ委ねます。すべての受け渡しを網羅する表は作りません。
148
+ - 補完・再判断を担う参加単位へ戻る線に「不足項目」「記録と受入品の差異」などの戻す情報を付けます。通常の図と同じ名称・領域 ID を使います。
149
+ - 再提示を示す場合も「修正・承認済みの補充依頼」のような情報の線で表し、戻す条件・再開条件の列や条件イベントは設けません。内部の再試行、ログ、操作手順は描きません。
150
+ - 線が多い場合は「概念データフロー」の分割の目安に従い、戻り先または業務の段ごとに図を分けます。各図の題には「補充依頼の補完」のように戻す対象を示し、同じ名称・領域 ID の共有ノードで戻りと再提示を追えるようにします。読みやすさのために必要な戻りを削りません。
151
+
152
+ 良い例: 仕入が不足項目を在庫へ返し、在庫が修正・再承認済みの補充依頼を再提示する。悪い例: 「エラー」を行き先なしで描く、または線が増えたので戻りを削る。
142
153
 
143
154
  ### 6.8. 未決事項
144
155
 
145
- - 横断境界、引き渡し条件、戻り先、判断者のいずれかが未確定な場合だけ設けます。ない場合は章ごと省略します。
146
- - 表は「論点」「影響するケース・引き渡し」「決定者」「決定時期」の 4 列とし、本文中の `_UNDECIDED_` と対応させます。
147
- - 調査で埋める不足は `_TODO_`、意思決定待ちは `_UNDECIDED_`、仮置きする前提は `_ASSUMPTION_` として区別します。
156
+ - 境界、名称、責務、判断者のいずれかが未確定な場合だけ設け、ない場合は章ごと省略します。
157
+ - 各論点は本文中の `_UNDECIDED_` と対応させ、影響するケース・参加単位、決定者、決定時期を示します。解決済みの論点や論点のない空表は残しません。
158
+
159
+ 良い例: 「共用領域の内部の正本が未確定。`C-01`〜`C-03` に影響し、BA・ARC が系統間の整合確認時に決定」と示す。悪い例: 「詳細は後で検討」とだけ書く。
148
160
 
149
161
  ### 6.9. 完成判定
150
162
 
151
- - 全体概要のケース ID、ユースケース名、業務目的、参加グループと矛盾せず、二つ以上のプロセスグループを横断しています。
152
- - 正常系の全参加グループが「プロセス領域」の節と図へ同じ順序・名称・領域 ID で登場し、各節が説明文、三つの箇条書き、役割表の順で構成されています。
153
- - 隣接するグループ間に引き渡し ID があり、引き渡す情報、引き渡し条件、戻す条件が空欄なく定義されています。
154
- - 図の各プロセスノードが一つのプロセスグループを表し、内部領域・内部プロセス・グループ内例外を再掲していません。
155
- - 関連データストアの名称・区分が全体概要と一致し、引き渡し条件に不要なデータストアや物理項目がありません。
156
- - 「データストア」は全体概要の部分集合で、各行が引き渡し ID と図の同名ノードに対応しています。
157
- - 例外時の戻り先から、条件不成立、戻す情報、補完責任、再開条件を説明できます。
158
- - 状態定義、遷移表、状態遷移図を持たず、必要な STSD と各 `cdfd-<group>` を参照しています。
159
- - `_TODO_` が残っていません。`_UNDECIDED_` は「未決事項」と対応しています。
163
+ 本節だけを `ready` 昇格のチェックリストの正本とします。内容の確認は次の全項目で行い、その後に人間の承認と証跡を確認します。
164
+
165
+ - ケース ID、業務名、目的、対象範囲、領域 ID・名称が全体概要と一致し、「描き方の選択」で決めた参加単位と詳細化の境界を守っています。
166
+ - 複数の系統が共通して通る領域の内部を描く文書が 1 か所に定まり、ほかの詳細文書ではその領域を 1 ノードと受け渡しの線で示し、内部の正本を参照しています。
167
+ - 「目的」が業務の存在理由・成果を 1〜2 文で示し、読み手の役割を含みません。「適用範囲」は対象と対象外が 1 行ずつで、共通原則は全体概要を参照しています。
168
+ - 「プロセス領域」の各節は役割表だけで構成され、全体概要のグループ・区分と一致しています。PDCA の値を示す場合は独立した任意の列にしています。
169
+ - 図を正本として、役割表の順序欄と章冒頭の通過順が一致しています。全参加単位の名称・領域 ID が表と図で対応し、主経路と条件付きの経路を区別して開始から終了まで上から下へ追えます。開始・終了のイベントは一ノード一出来事の短い文で、入口の文言は選んだ方式の規定に従っています。
170
+ - 渡す情報・物を線のラベルから読み取れ、引き渡し ID や条件のイベント、「引き渡し」「例外時の戻り先」の章がありません。
171
+ - Orchestrator は図に含まれず、その調整は全体概要の指示の図へ委ねられています。
172
+ - 図には業務の言葉による題と、読み取れることを示す説明 1 文があり、凡例は全体概要を参照しています。図を分けた場合も共有ノードと接続が追えます。
173
+ - ノードの絵文字の有無・割り当てが全体概要の凡例に合い、文書内の全図と系統間でそろっています。
174
+ - 関連データストアは全体概要と同じ名称・区分で、表の各行と図のノードが対応しています。
175
+ - 対象範囲の例外時の戻りを重要度で省略せず、戻す情報と補完・再判断の責任を持つ参加単位を読み取れます。戻りがない場合だけ戻りの図を省略しています。線数・集中の目安や読みやすさに応じて図を分け、分割後も必要な線を追えます。
176
+ - `based_on` と本文に `deprecated` の文書への参照がありません。状態定義・遷移を複製せず、有効な STSD や詳細文書を参照しています。
177
+
178
+ 承認者と証跡は次の手順で確認します。
179
+
180
+ 1. 対象プロジェクトの責任分担文書(RACI)の成果物確定・公開判断に対応する行から `A` の Role code を特定し、メンバー定義でそのロールを担う人間を確認します。RACI を管理しない場合は、ロール定義の承認権限とメンバー定義を参照します。対応関係は [[specdojo:people-and-organization-definition-standard|人と組織の定義標準]] に従い、承認者を特定できない場合は昇格せず未決事項へ記録します。
181
+ 2. 対応する登録簿個票の「対応結果」または対応タスクの result に、対象文書 ID・承認対象の版(コミット等)・承認者・承認日・承認判断を記録します。同じ記録から、完成判定に用いたレビュー結果と検査証跡、承認者の根拠にした責任分担・ロール定義とメンバー定義を文書 ID または証跡の保管先で参照できるようにします。両方の記録がある場合は判断の正本を一方に定め、他方はその参照とします。
182
+ 3. 公開前に、記録の版が昇格対象と一致し、完成判定を満たし、未解決指摘・未決事項の扱いを承認者が判断済みであることを確認します。証跡の欠落や版の不一致があれば `draft` を維持し、確認できた場合だけ人間が `ready` へ変更します。検査の成功だけで承認済みと判定しません。
183
+
184
+ 改訂・廃止の影響追跡は [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] に従います。BA は全体概要の詳細 CDFD 一覧、接続する系統の CDFD、状態を委ねる STSD、関連する BPS・受入条件への影響を確認し、ARC は境界と参照整合、QE は完成判定の再検証、PM は追従タスクの管理を担います。廃止・置き換えの最終判断は同標準の PO の責務に従います。
185
+
186
+ 良い例: 承認記録から対象版、権限を持つ人間、レビュー結果と検査証跡をたどれる。悪い例: 「検査が通った」「承認済み」とだけ書いて `ready` にする。
160
187
 
161
188
  ## 7. 禁止事項
162
189
 
163
- - 単一グループに閉じる業務へユースケース別 CDFD を作成したり、全体概要にないケースを先に詳細化したりしません。
164
- - product 成果物 ID を `<project-id>:cdfd-uc-<topic>` にしたり、`cdfd-<group>` と同じ命名で作成したりしません。
165
- - ケース ID を採番し直したり、引き渡し ID を図・引き渡し表・例外時の戻り先で不一致にしたりしません。
166
- - グループ内部の領域、個別プロセス、プロセス入出力、主要例外、操作手順を再掲しません。
167
- - プロセスグループ別 CDFD と異なる責務をグループ代表ノードへ割り当てたり、全体概要と異なる領域 ID・データストア名・区分を使ったりしません。
168
- - 状態名・成立条件を定義したり、遷移元・遷移先・遷移条件の表や状態遷移図を複製したりしません。
169
- - 引き渡し条件や再開条件を「完了した」「適切になった」「問題がなくなった」のような判定不能な表現だけで記述しません。
170
- - 物理テーブル、カラム、SQL、実装クラス、詳細 API、画面操作を概念フローへ記載しません。
171
- - 受け側グループ、戻り先グループ、引き渡す情報のいずれかがない矢印や表行を残しません。
172
- - 作成状況やレビュー状態を成果物本文へ記載せず、登録簿で追跡します。
190
+ - プロセス領域に主要入力・主要出力・データストアの箇条書きを置く、または図をなぞる長文の注記を書く。
191
+ - 詳細 CDFD に独自の凡例を再掲・重複定義する。
192
+ - 共通して通る領域の内部を複数の詳細文書へ重複して描く、必要な例外時の戻りを重要度や線の多さを理由に省略する、または全体概要の凡例と異なる絵文字の有無・割り当てにする。
193
+ - 全体概要にないケースや領域分割を作る、または「描き方の選択」の粒度・詳細化の境界を越えて内部処理を再掲する。
194
+ - 全体概要と異なるグループ名・区分名・領域 ID・データストア名を使う、または PDCA の値をグループ・区分の列に入れる。
195
+ - 引き渡し ID を採番する、引き渡し条件のイベントを図に置く、引き渡し・戻す条件・再開条件の表を設ける。
196
+ - Orchestrator の調整を詳細の図に複製する、または対象範囲内の担当者を外部主体にする。
197
+ - `deprecated` の文書を `based_on` または本文から参照する。
198
+ - 状態定義・遷移表・状態遷移図を複製する、または物理テーブル、カラム、SQL、実装クラス、詳細 API、画面操作を記載する。
@@ -4,103 +4,137 @@ specdojo:
4
4
  type: rulebook
5
5
  deliverable_type: data
6
6
  status: draft
7
- recipe: undecided
7
+ recipe: not-needed
8
8
  sample: specdojo:cdsd-sample
9
- template: undecided
9
+ template: not-needed
10
10
  ---
11
11
 
12
12
  # 概念データストア定義 作成ルール
13
13
 
14
14
  Conceptual Data Stores Definition (CDSD) Documentation Rules
15
15
 
16
- 本ドキュメントは、業務分析・要求定義・システム設計のために **概念データストア定義を記述する標準ルール** です。
17
- 業務で扱うデータストア(帳簿・台帳・記録など)を一覧で定義します。各データストアの役割・粒度・用途・更新タイミングなどを明確に記載し、データの流れや管理単位を俯瞰できるようにします。
16
+ 業務で継続的に保持・参照する情報の集合について、管理単位・用途・更新責務を定義する基準を定めます。
17
+ BA が業務上の境界を合意し、ARC・DEV が設計へ接続し、QE が整合性確認の対象を識別できる一覧を作ります。
18
18
 
19
- ## 0. 概要
19
+ ## 1. 全体方針
20
20
 
21
- 概念データストアとは、業務上継続的に保持・参照される情報の集合(帳簿・台帳・記録)を表す。DB やファイル形式などの物理構造ではなく、「業務単位としての情報管理のまとまり」を定義する。
21
+ - **適用範囲**: 業務分析・要求定義から設計への引き渡しで利用する `cdsd-*.md` を対象とします。帳簿・台帳に加え、定義、実行記録、派生ビュー、人が確定する報告記録も業務上の管理対象なら含めます。
22
+ - **入力**: 成果物カタログの対象範囲・依存・受入条件、上位の目的、関連する BDD・プロセス仕様を確認します。主要な管理単位の採否と用途を、それらの根拠に対応付けます。
23
+ - **記載レベル**: 一覧の各行は独立した管理単位とします。ファイルが複数あることだけで分割せず、正本区分、粒度、更新責務が異なる場合は区別します。
24
+ - **対象外**: 全項目の型・許容値、保存形式、コマンド構文、状態遷移、復旧操作の詳細は、それぞれの schema・型定義・リファレンス・状態定義・運用手順を参照します。概念上の管理境界を判断するための説明だけを残します。
22
25
 
23
- ## 1. メタデータ
26
+ ## 2. 位置づけと用語定義
24
27
 
25
- | 項目 | 説明 | 必須 |
26
- | ---- | -------------------------------------- | ---- |
27
- | id | 概念データストア一覧ID (cdsl-xxx-xxxx) | ○ |
28
- | type | `data` 固定 | ○ |
28
+ - **概念データストア**: 業務上ひとまとまりとして保持・参照する情報です。物理的な保管場所や DB テーブルと一対一とは限りません。
29
+ - **隣接仕様との分担**: BDD は項目の業務的意味、CCD は概念間の関連、プロセス仕様・CDFD は情報の生成・利用の流れ、保管場所一覧は物理的・論理的な場所を扱います。CDSD はこれらを管理単位と更新責務でつなぎます。
30
+ - **共通事項の正本**: メタ情報・改訂と廃止は [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]]、配置は [[specdojo:docs-structure-guide|ドキュメント構成ガイド]] に従います。共通方針は上位文書を参照し、各 CDSD へ再掲しません。
29
31
 
30
- | title | 概念データストア一覧名 | ○ |
31
- | status | `draft`/`ready`/`deprecated` | ○ |
32
- | supersedes | 置き換え関係(古仕様→新仕様) | 任意 |
32
+ | Role code | 作成・確認・利用の責務 |
33
+ | --------- | ------------------------------------------------------------------------------------------------------------------------------------ |
34
+ | BA | 主作成者・業務確認者として、対象者の課題、管理境界、名称、用途と上位根拠の対応を整理する。業務担当者による確認が必要な箇所を特定する |
35
+ | ARC | 正本・派生物の区別、生成元、外部依存と後続設計への引き渡しを確認する |
36
+ | DEV | 保存単位と正本の参照先、schema・型・生成処理への変更影響を確認する |
37
+ | QE | 対象の網羅、必須情報、検証対象と合否条件を照合する |
38
+ | PM | 未決事項の担当・依存順・判断時期を計画へ接続し、課題・リスク等を報告する |
39
+ | OPS | 公開前確認、継続更新・再生成・問い合わせの導線を確認する |
40
+ | PO | 管理境界と用途を最終合意し、公開範囲・確定・置き換えを人間として承認する |
33
41
 
34
- ### 1.1 ID規約
42
+ 業務担当者や「運用担当」などの呼称を使う場合は、適用先の組織定義の Role code に対応付けます。実担当者・兼務は組織・メンバー定義を参照します。
35
43
 
36
- - 概念データストア一覧IDは正規表現 `^cdsl-[a-z0-9-]+$` に合致する一意IDを用いる。
37
- - `type: data` は業務ドメイン仕様であることを示す。画面やAPI仕様(`ui`/`api`)とは別ドキュメントで管理する。
44
+ ## 3. ファイル命名・ID規則
38
45
 
39
- ## 2. 記述ルール
46
+ - ファイル名は `cdsd-<term>.md` とし、`<term>` は対象業務領域を表す kebab-case とします。プロセス群など、読者が管理境界を合意できる単位でまとめます。
47
+ - プロジェクト成果物の文書 ID は `<project-id>:cdsd-<term>` とします。例は `prj-0001:cdsd-execution` です。文書内のデータストアは名称で一意に対応付け、同名で異なる管理単位を混在させません。
48
+ - 配置はカタログの `base_path` と成果物の `path` から解決します。業務仕様のデータモデル配下を基本とし、既存カタログのパスを推測で変更しません。
40
49
 
41
- - 仕様間(BDD/SLL/CCD/用語集)で名称の整合性を保つ。
50
+ ## 4. 推奨 Frontmatter 項目
42
51
 
43
- ### 2.1 データストア名の命名規則
52
+ 許可キー・必須項目・型はドキュメントメタ情報標準と `docs/specdojo/schemas/v1/deliverable-frontmatter.schema.yaml` を正本とし、メタ情報は `specdojo:` 配下に置きます。
44
53
 
45
- - **日本語の単数形**を基本とする(例:売上台帳、在庫台帳)
46
- - 略語のみや実装名(SalesTbl など)は禁止
54
+ - `type` は `data`、`rulebook` は `specdojo:cdsd-rulebook` とします。表示名は対象領域が分かる H1 に置き、`title` を併記する場合は H1 と意味を一致させます。
55
+ - `based_on` には実際に読んで直接の根拠とした作成済み文書を記録します。カタログがある場合は `depends_on` の推移閉包内に限定します。単なる関連先や未作成文書を追加しません。
56
+ - `status` の確定判断、`supersedes` による置き換えは共通規約に従います。agent は `draft` のまま編集し、人間の PO による承認へ渡します。
47
57
 
48
- - 「〜台帳」「〜帳簿」「〜一覧表」など、業務慣用名称はそのまま使用してよい
58
+ ## 5. 本文要件
49
59
 
50
- ### 2.2 標準列の定義
60
+ 次の構成を標準とし、見出しは `## 1.` から連番、小節も階層ごとの連番にします。表はヘッダー・区切り行・データ行を連続させ、途中に空行を入れません。
51
61
 
52
- | 列名 | 説明 |
53
- | ------------------ | ------------------------------------------------------ |
54
- | **データストア名** | 業務での名称。日本語単数形。慣用的名称はそのまま使用可 |
62
+ | 章 | 必須 | 内容・受入条件 |
63
+ | -------------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
64
+ | 概要 | 必須 | 対象者、利用場面、業務課題と放置時の影響、期待する判断結果、対象・対象外とその根拠を示す。上位文書で説明済みの内容は参照する |
65
+ | 概念データストア一覧 | 必須 | 対象の全管理単位を標準6列で定義し、カタログの対象範囲と照合できること |
66
+ | 正本区分と更新責務 | 必須 | 一覧の全行について、正本か派生・参照情報か、生成元、更新契機、利用制約、担当 Role code を識別できること |
67
+ | 関連仕様と検証 | 必須 | 各管理単位から、根拠となる辞書・プロセス・制約の正本、検証対象と確認手順を辿れること |
68
+ | 確認事項と変更影響 | 条件付き | 未決・欠落・矛盾、または改訂・廃止がある場合に、影響、担当、判断者、期限または判断時期、次アクションと追跡先を示す。なければ「なし」または省略とする |
55
69
 
56
- | **対応プロセス** | 調達/販売/会計など複数可(複数の場合は「、」区切り) |
57
- | **主な内容** | 記録項目の代表例を名詞句で簡潔に |
58
- | **更新タイミング** | 発生イベント・日次・月次などの処理基準 |
59
- | **粒度** | データの最小記録単位(例:仕入取引毎/商品×在庫時点) |
60
- | **主な用途** | 管理・分析・会計などの目的 |
70
+ ### 5.1. 一覧の標準列
61
71
 
62
- ※ 列順は **データストア名 → 対応プロセス → 主な内容 → 更新タイミング → 粒度 → 主な用途** の順に統一する。
72
+ 列順は次の順に固定します。関連仕様への参照や補足は別表・本文に置けますが、データストア名で対応付けます。
63
73
 
64
- ### 2.3 更新タイミングの標準語彙(改訂)
74
+ | 列名 | 内容・判断条件 |
75
+ | -------------- | --------------------------------------------------------------------------------------------- |
76
+ | データストア名 | BDD・用語集と対応する業務名称。日本語の単数形を基本とし、慣用名・正式名称は定義先を示して使う |
77
+ | 対応プロセス | 生成・更新・利用する業務プロセス。複数なら「、」で区切る |
78
+ | 主な内容 | 管理対象が分かる代表情報を名詞句で示す。全フィールドを列挙しない |
79
+ | 更新タイミング | 発生イベントまたは周期と、その適用条件を示す |
80
+ | 粒度 | 最小記録単位と識別の文脈。履歴と集計など複数の単位を混同しない |
81
+ | 主な用途 | 誰のどの業務判断・確認に使うかを示す。概要の目的に対応すること |
65
82
 
66
- 使用可能なカテゴリ:
83
+ 更新タイミングは「イベント(会計確定時)」「日次(閉店時)」「月次(締め)」「年次(決算)」「随時(定義変更時)」のように契機を具体化します。複数契機は併記でき、業種固有のイベントをこの例に限定しません。
67
84
 
68
- - イベント:発注時、納品時、販売時、支払い時
69
- - 必要に応じて **「イベントA・イベントB時」形式で複数指定可**
85
+ ### 5.2. 正本区分と更新責務
70
86
 
71
- - 日次処理:日次(閉店時)
72
- - 月次処理:月次(締め)
73
- - 年次処理:年次(決算)
74
- - 随時:随時、変更時、追加時
87
+ - 正本は何を確定する情報かを示します。派生・参照情報は生成元の文書 ID または管理単位、再生成の契機と基準時点を示します。人が確定する報告記録は、その判断の範囲を明示します。
88
+ - 更新担当と確認担当を Role code で示し、参照だけのプロセスと更新するプロセスを区別します。直接編集・再生成・追記などの業務上の制約は、その理由または正本への参照を添えます。
89
+ - 保存・引き渡し単位が境界判断に必要なら、対象ファイル群や運用手順への参照を付けます。詳細なパス規則や実装内部構造は転記しません。更新失敗・不整合時の問い合わせ先と訂正・復旧手順の参照も対応付けます。
75
90
 
76
- ### 2.4 物理名の扱い(補足追加)
91
+ ### 5.3. 関連仕様への追跡
77
92
 
78
- - 概念データストアでは物理名は **原則記載しない**
79
- - 記載する場合は列名を **`physicalName`** とし、**lowerCamelCase** を用いる
93
+ - 関連 BDD・CCD・用語集・プロセス仕様・CDFD、該当する保管場所一覧(SLL)を文書 ID で特定します。名称・内容・粒度・入出力・管理場所のうち何を照合するかを対応付けます。関連文書がない種別を形式的に作成する必要はありません。
94
+ - schema・型・実装・リファレンスが正本の場合は、BDD 等の参照先を辿れるようにし、外部システムを含む入力元・出力先と更新制約を確認します。構造の詳細を CDSD 独自の定義として複製しません。
95
+ - 既存文書は project 修飾 ID のリンクで示します。未作成文書は ID をコード表記し、欠ける根拠、現時点で判断できる範囲、解消担当を「確認事項と変更影響」に残します。依存未整備を対象行の黙示的な除外理由にしません。
80
96
 
81
- ## 3. サンプル
97
+ ### 5.4. 検証と受入条件
82
98
 
83
- ### 3.1 メタデータ(front-matter YAML)
99
+ BA が対象行を作成し、ARC・DEV が正本区分と依存を確認した後に QE が照合します。各データストアを作成・確認の作業単位とし、PM は依存順と確認時期を計画に記録します。
84
100
 
85
- ```yaml
86
- ---
87
- id: cdsl-main
88
- type: data
89
- title: 概念データストア一覧(main)
90
- status: draft
91
- supersedes: []
92
- ---
93
- ```
94
-
95
- ### 3.2 概念データストア一覧(表)
96
-
97
- | データストア名 | 対応プロセス | 主な内容 | 更新タイミング | 粒度 | 主な用途 |
98
- | -------------- | ------------ | ------------------------------------------------------------ | ------------------------------------ | -------------- | -------------------------------------------- |
99
- | 商品一覧表 | 調達 | 商品名、仕入単価、販売価格、分類(お菓子/玩具など) | 随時(新商品追加・価格変更時) | 商品マスタ単位 | 商品情報の統一、仕入・販売・会計の基礎データ |
100
- | 仕入台帳 | 調達 | 発注日、仕入先、商品名、数量、仕入単価、合計金額、支払状況 | イベント(発注時・納品時) | 仕入取引毎 | 仕入履歴と支払い管理、原価把握 |
101
- | 在庫台帳 | 調達、販売 | 商品名、入庫数、出庫数、現在庫数、賞味期限 | イベント(納品時・販売時・補充時) | 商品×在庫時点 | 欠品防止、再発注判断、廃棄ロス管理 |
102
- | 売上台帳 | 会計 | 日付、販売金額、販売数量、売れ筋商品、販売方法(現金/つけ) | 日次(閉店時) | 日次集計 | 売上把握、販売分析、仕入見直し |
103
- | つけ帳 | 販売、会計 | お客様名、購入日、商品名・金額、支払期日、支払状況 | イベント(購入時・支払い時) | つけ取引毎 | つけ払い(後払い)の記録と回収管理 |
104
- | レジ記録 | 販売、会計 | 日付、入金(売上)、出金(仕入・経費)、残高 | 日次(閉店時)/イベント(支払い時) | レジ取引毎 | 現金の入出金管理、レジ締め・差額確認 |
105
- | 支払管理表 | 会計 | 支払先、支払日、金額、支払方法、ステータス | イベント(請求書受領時・支払い時) | 支払取引毎 | 仕入や経費の支払い状況管理 |
106
- | 会計帳簿 | 会計 | 日次売上、つけ払い入金、経費、仕入原価、利益計算 | 月次(締め)/年次(決算) | 月次/年次集計 | 会計全体の記録、税務・申告対応用 |
101
+ | 確認 | 合格条件・証跡 |
102
+ | --------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
103
+ | BA: 業務範囲と用途 | カタログの対象と一覧の対応に欠落・重複がなく、標準6列が埋まり、用途が概要の課題・期待価値へつながる |
104
+ | ARC・DEV: 境界と依存 | 一覧と更新責務の対象集合が一致し、正本・生成元・担当・制約と、参照する BDD 等の定義が矛盾しない |
105
+ | QE: 整形・メタ情報 | リポジトリに導入された Prettier・Markdown lint・Frontmatter schema 検査で対象ファイルのエラーがない。コマンド・対象・結果を実行記録へ残す |
106
+ | QE・OPS: データと運用 | 管理単位ごとに検証対象、適用 schema または手動確認基準、確認コマンド・手順、期待結果、失敗時の対応を参照できる |
107
+
108
+ 本リポジトリでは `npx prettier --write <対象.md>`、`npm run lint:md`、`npm run lint:fm` を使います。成功は終了コード 0 と対象の違反なしです。他のリポジトリでは導入済みの対応コマンドを用い、pipeline で親検証に設定されたものは runner の結果を証跡とします。
109
+
110
+ CDSD 本文は標準6列・行の網羅・参照対応を手動照合します。参照先データの schema 検証はその正本で定める手順を用い、CDSD の Frontmatter 検証とは分けます。検証対象・期待結果の詳細は正本を参照し、実行記録に対象と結果を残します。失敗時は担当へ差し戻して修正・再確認し、未解決を合格として扱いません。
111
+
112
+ ### 5.5. 未決事項・変更・公開判断
113
+
114
+ - BA は確認不足・欠落・矛盾とその業務影響を整理し、PM へ報告します。計画済み作業の進捗は Schedule で追跡し、既発問題は課題、未発生の懸念はリスク、承認が必要な差分は変更要求、採用方針と理由は決定記録の PJR 転記候補として分けます。担当 Role code、報告先・判断者、判断時期、次アクション、転記先レコードを記録します。
115
+ - 改訂・廃止ではドキュメントメタ情報標準の変更管理に従います。BA は名称・用途・粒度の変更を BDD・CCD・用語集・プロセス仕様・SLL と照合し、ARC・DEV は schema・型・生成処理・コマンドへの影響を特定します。QE は参照元の受入条件と既存成果物を再確認し、PM は非互換変更の移行対象・順序・期限・担当を追跡します。
116
+ - 本 rulebook の変更時は、Frontmatter で宣言する関連 Kata と適用済み CDSD を照合し、本文要件・標準列・禁止事項の差分と同期対象を実行記録に残します。段階的な整備では未同期箇所・担当・次の作業を明記し、矛盾時は rulebook を正とします。要否判断を見直す場合も BA・ARC が理由と影響を提示し、人間の PO が合意します。
117
+ - 公開・`ready` 化の前に、BA・ARC・QE の受入確認と OPS の公開前確認を完了します。公開対象と閲覧範囲、個人情報・非公開情報の有無、未決事項・未解決指摘と影響を提示し、人間の PO が承認・保留・差し戻しを判断します。本 rulebook 自体の確定には関連 Kata の同期確認も必要です。公開後の問い合わせは BA、再生成・運用上の問題は OPS が受け、仕様変更が必要なら PM へつなぎます。
118
+
119
+ ## 6. 記述ガイド
120
+
121
+ 章ごとの判断は次の基準で行います。共通事項は上位文書を正本とし、良い例の短文は判断点だけを示すものです。
122
+
123
+ | 対象章 | 判断の基準 | 良い例 | 悪い例 |
124
+ | -------------------- | -------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------- |
125
+ | 概要 | 対象者・放置時の影響・期待する判断と、境界の理由が分かる | 「担当交代時の更新漏れを防ぐため、BA が販売記録の更新責務を確認する。在庫は別領域の定義を参照する」 | 「データを一覧にする」のみ、または対象を根拠なく省く |
126
+ | 概念データストア一覧 | 代表情報・更新契機・最小単位・用途を区別できる | 「売上台帳/販売、会計/販売日・金額/イベント(会計確定時)/販売取引毎/店主の売上確認」 | 「SalesTbl/販売/全項目/随時/データ毎/管理」 |
127
+ | 正本区分と更新責務 | 更新元と参照先、担当と許可される扱いが分かる | 「売上集計は売上台帳から日次再生成。OPS が生成し、BA が元帳との一致を確認。集計の直接訂正はしない」 | 「システムが適切に更新する」 |
128
+ | 関連仕様と検証 | 参照先・比較内容・合否を辿れる | 「売上台帳に対応する BDD の文書 ID と検証手順を示し、取引粒度の一致と検証エラー0件を確認する」 | 「BDD 等と整合すること」のみ |
129
+ | 確認事項と変更影響 | 誰がいつ何を決め、その結果どこを直すかが分かる | 「粒度変更による集計影響を BA が課題化し PM へ報告。次回レビューで PO が範囲を判断し、ARC が生成元との対応を再確認する」 | 「詳細は後日」、未決のまま確定する |
130
+
131
+ 業務名称と正式な識別子の対応が必要なら、名称の初出で短く補足するか正本を参照します。物理名を独立して示す必要がある場合だけ任意の `physicalName` 列を標準6列の後ろに追加し、既存の正本の表記を使います。CDSD のために綴りや命名規則を変換しません。
132
+
133
+ ## 7. 禁止事項
134
+
135
+ - 略語・物理名だけで管理対象を表し、業務上の意味や定義先を示さないこと。
136
+ - カタログの対象を未記載のまま除外したり、未決の粒度・更新責務を確定済みとして扱ったりすること。
137
+ - 全項目・型・許容値・状態遷移・コマンド構文・詳細パスを正本から複製し、二重管理すること。
138
+ - 派生・参照情報を正本と混同し、生成元や更新担当の不明なまま後続設計へ渡すこと。
139
+ - 表を空行で分断すること、存在しない文書へのリンクや未確認の検証成功を記載すること。
140
+ - agent に公開可否・`ready` 昇格・置き換えの最終承認を委ねること。