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
@@ -8,84 +8,72 @@ specdojo:
8
8
 
9
9
  # 補充依頼確定
10
10
 
11
- 在庫が補充基準を下回ったことを受け、店主代表が補充対象と依頼数量を判断し、仕入グループへ渡す補充依頼を確定する。
11
+ 在庫の補充基準割れを受け、店主代表が補充対象と依頼数量を決め、確定した補充依頼を仕入グループへ渡す。
12
12
 
13
13
  ## 1. 概要
14
14
 
15
- - 業務目的: 人気商品の欠品を減らすため、現在庫と商品ごとの補充基準から仕入れが必要な商品と依頼数量を確定する。
15
+ - 業務目的: 単一店舗で人気商品の欠品を減らす。
16
16
  - プロセス領域: 在庫グループの補充判断(`P-06`)
17
- - 対象者: 店主代表は補充判断を承認し、開発担当と同行レビュー担当は判断条件と業務成果を後続設計・レビューに利用する。
17
+ - 対象者: 店主代表(判断)、開発担当と同行レビュー担当(後続設計・レビュー)
18
18
  - 主担当: 店主代表
19
- - 開始点: 販売または入荷を反映した現在庫が確定し、補充基準割れを検出した時点
20
- - 終了点: 補充依頼が仕入グループへ引き渡され、参照可能になった時点、または補充不要が記録された時点
21
- - 対象外: 仕入先の決定、発注内容の承認・送付、入荷検品、売場補充
22
-
23
- 本書は単一店舗の日常的な補充判断を扱う。発注から入荷、売場補充までのグループ横断順序は `cdfd-uc-replenishment`、仕入グループ内の処理は `cdfd-purchasing` を正本とする。
19
+ - 開始点: `T-01` の受領時点
20
+ - 終了点: 「出力」のいずれかが確定した時点
21
+ - 対象外: 仕入先の決定、発注の承認・送付、入荷検品、売場補充。グループ横断の順序は `cdfd-uc-replenishment`、仕入グループ内は `cdfd-purchasing` が正本
24
22
 
25
23
  ## 2. トリガー
26
24
 
27
- | トリガー ID | 出来事 | 発生元 | 受領情報 | 開始条件 | 不成立時の扱い |
28
- | ----------- | -------------------------- | ---------------- | -------------------------------- | ------------------------------------------------------ | -------------- |
29
- | `T-01` | 現在庫が補充基準を下回った | 在庫確認プロセス | 商品、現在庫、補充基準、確認時刻 | 在庫確認プロセスから対象商品と現在庫が引き渡されている | 起動しない |
30
-
31
- トリガーは在庫確認プロセスの判定結果であり、在庫記録の物理的な更新方式には依存しない。
25
+ | トリガー ID | 出来事 | 発生元 | 受領情報 | 開始条件 | 不成立時の扱い |
26
+ | ----------- | -------------------------- | ---------------- | -------------------------------- | -------------------------- | -------------- |
27
+ | `T-01` | 現在庫が補充基準を下回った | 在庫確認プロセス | 商品、現在庫、補充基準、確認時刻 | 対象商品と現在庫を受領済み | 起動しない |
32
28
 
33
29
  ## 3. 前提条件
34
30
 
35
- - 店主代表が補充要否と依頼数量を最終判断できる。家族利用者代表が検出した場合も、補充依頼の確定は店主代表が行う。
36
- - 数量に関する用語の関係は以下の通りとする。
37
- - 補充基準: 補充が必要か判定するための閾値。現在庫がこれを下回ると補充要となる。
38
- - 補充必要数: `br-reorder-point` が判定する、補充に必要な数量。算出方法は `br-reorder-point` を正本とする。
39
- - 依頼数量: 補充必要数を発注単位に合わせて調整し、仕入グループへ依頼する最終的な数量。
40
- - 発注単位: 仕入先が指定する、発注可能な最小の数量単位。
31
+ - 店主代表が補充要否と依頼数量を判断できる(家族利用者代表の検出時も確定は店主代表)。判断できない間は起動せず、トリガーを保留する。
32
+ - 依頼数量は、`br-reorder-point` が判定する補充必要数を発注単位(仕入先が定める最小の発注数量)に合わせた数量とする。
41
33
 
42
34
  ## 4. 入力
43
35
 
44
- | 入力 | 入手元 | 利用目的 | 必須 | 正本 |
45
- | ------------ | ------------------ | ------------------------------------------------ | ---- | ------------------ |
46
- | 対象商品 | 商品台帳 | 販売状態、継続取扱、補充基準、発注単位を確認する | ○ | 商品台帳 |
47
- | 現在庫 | 在庫記録 | 補充基準との差と補充必要数を確認する | ○ | 在庫記録 |
48
- | 未完了依頼 | 補充依頼 | 同じ商品への重複依頼を防ぐ | ○ | 補充依頼 |
49
- | 補充判断基準 | `br-reorder-point` | 補充要否と補充必要数を同じ規則で判定する | ○ | `br-reorder-point` |
50
-
51
- 商品台帳、在庫記録、補充依頼は論理的な正本名であり、保存先や物理項目は本書では定めない。
36
+ | 入力 | 入手元 | 利用目的 | 必須 | 正本 |
37
+ | ------------ | ------------------ | -------------------------------------- | ---- | ------------------ |
38
+ | 対象商品 | 商品台帳 | 販売状態、継続取扱、補充基準、発注単位 | ○ | 商品台帳 |
39
+ | 現在庫 | 在庫記録 | 補充基準との差と補充必要数 | ○ | 在庫記録 |
40
+ | 未完了依頼 | 補充依頼 | 同じ商品への重複依頼の防止 | ○ | 補充依頼 |
41
+ | 補充判断基準 | `br-reorder-point` | 要否と補充必要数の判定規則 | ○ | `br-reorder-point` |
52
42
 
53
43
  ## 5. 処理
54
44
 
55
- | ステップ ID | CDFD プロセス | 担当 | 入力 | 活動・判断 | 出力・完了条件 | 例外 |
56
- | ----------- | ------------- | -------- | -------------------------------------- | ------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------- | -------------- |
57
- | `S-01` | `P-06` | 店主代表 | 対象商品、現在庫 | 販売状態、継続取扱、発注単位を確認し、補充判断の対象可否を決める | 補充判断の対象または補充不要のいずれかが理由付きで確定している | `E-01` |
58
- | `S-02` | `P-06` | 店主代表 | 現在庫、補充基準、未完了依頼、発注単位 | `br-reorder-point` により補充要否と補充必要数を判定し、発注単位に合わせて依頼数量を算出する。未完了依頼との重複も確認する | 補充要否、依頼数量、重複有無を確認できる | `E-02`, `E-04` |
59
- | `S-03` | `P-06` | 店主代表 | 補充要の判定結果 | 補充対象と依頼数量を確認し、判断根拠を添えて補充依頼を承認(確定)する | 商品、依頼数量、判断根拠、承認者、承認時刻を持つ補充依頼が確定している | `E-03` |
60
- | `S-04` | `P-06` | 店主代表 | 確定した補充依頼 | 仕入グループへ確定した補充依頼を引き渡す(共有する) | 補充依頼が仕入グループへ引き渡され、参照可能な状態になる | `E-03` |
45
+ | ステップ ID | CDFD プロセス | 担当 | 入力 | 活動・判断 | 出力・完了条件 | 例外 |
46
+ | ----------- | ------------- | -------- | ---------------------------- | ------------------------------------------------------------------- | -------------------------------------------- | -------------- |
47
+ | `S-01` | `P-06` | 店主代表 | 対象商品、現在庫 | 販売状態と継続取扱から補充判断の対象かを決める | 対象または補充不要が理由付きで確定 | `E-01` |
48
+ | `S-02` | `P-06` | 店主代表 | 対象商品、現在庫、未完了依頼 | `br-reorder-point` で判定時点の要否と依頼数量を決め、重複を確認する | 補充要否、依頼数量、重複有無が確定 | `E-02`、`E-04` |
49
+ | `S-03` | `P-06` | 店主代表 | 補充要の判定結果 | 判断根拠を添えて補充依頼を承認する | 商品、数量、根拠、承認者、承認時刻付きで確定 | `E-03` |
50
+ | `S-04` | `P-06` | 店主代表 | 確定した補充依頼 | 仕入グループへ引き渡す | 仕入グループが参照できる | `E-05` |
61
51
 
62
- `S-01` または `S-02` で補充不要と判断した場合は `S-03` と `S-04` を起動せず、対象商品、判断根拠、確認時刻を補充不要記録として確定して終了する。
52
+ 補充不要と判断した場合は `S-03` と `S-04` を行わず、補充不要記録を確定して終了する。
63
53
 
64
54
  ## 6. 出力
65
55
 
66
- | 出力 | 受け手 | 確定条件 | 正本 | 後続処理 |
67
- | ------------ | ------------ | ---------------------------------------------------------------------- | -------- | ------------------------------ |
68
- | 補充依頼 | 仕入グループ | 商品、依頼数量、判断根拠、店主代表の承認、承認時刻を確認できる | 補充依頼 | `P-01-01` 発注内容確定 |
69
- | 補充不要記録 | 店主代表 | 対象商品、補充不要理由、確認時刻を確認でき、補充依頼が作成されていない | 在庫記録 | 次回の販売または入荷後に再判定 |
70
-
71
- 補充依頼は `cdfd-uc-replenishment` の引き渡し `H-01` で仕入グループへ渡す情報に対応する。
56
+ | 出力 | 受け手 | 確定条件 | 正本 | 後続処理 |
57
+ | ------------ | ------------ | ------------------------------------------ | -------- | ---------------------------------- |
58
+ | 補充依頼 | 仕入グループ | `S-03` の完了条件を満たす | 補充依頼 | `H-01` で `P-01-01` 発注内容確定へ |
59
+ | 補充不要記録 | 店主代表 | 対象商品、理由、確認時刻があり、依頼がない | 在庫記録 | 次回の販売・入荷後に再判定 |
60
+ | 重複不要記録 | 店主代表 | 対象商品、既存依頼、理由、確認時刻がある | 補充依頼 | 既存依頼の処理を続ける |
72
61
 
73
62
  ## 7. 例外・代替経路
74
63
 
75
- | 例外 ID | 対象ステップ | 検出条件 | 停止範囲 | 担当 | 処置 | 再開条件・代替成果 |
76
- | ------- | -------------- | ------------------------------------------------------------ | -------------------- | -------- | ---------------------------------------------------------------------- | ---------------------------------------------------------------------- |
77
- | `E-01` | `S-01` | 商品、現在庫、補充基準、発注単位のいずれかが不明 | 補充要否の判定以降 | 店主代表 | 不足項目と対象商品を記録し、商品台帳または在庫記録の確認を依頼する | 不足項目が補完され、同じ発注単位で確認できた後に `S-01` から再開する |
78
- | `E-02` | `S-02` | 同じ商品に未完了の補充依頼がある | 新しい補充依頼の確定 | 店主代表 | 既存依頼へ依頼数量を反映するか、新規依頼を作らないかを判断して記録する | 既存依頼を更新して再承認するか、重複不要の記録を代替成果として終了する |
79
- | `E-03` | `S-03`、`S-04` | 判断根拠を記録できない、または仕入グループへ引き渡しできない | 補充依頼の引き渡し | 店主代表 | 補充依頼を非確定・未受領状態のまま保留し、状況を記録する | 判断根拠を確認するか引き渡し可能になった後に再開する |
80
- | `E-04` | `S-02` | 未完了依頼を取得できない | 補充要否の判定以降 | 店主代表 | 処理を中断し、未完了依頼の取得失敗を記録する | 未完了依頼が取得可能になった後に `S-02` から再開する |
64
+ | 例外 ID | 対象ステップ | 検出条件 | 停止範囲 | 担当 | 処置 | 再開条件・代替成果 |
65
+ | ------- | ------------ | -------------------------- | -------------- | -------- | ---------------------------------------------- | -------------------------------- |
66
+ | `E-01` | `S-01` | 「入力」の必須項目が不明 | `S-01` 以降 | 店主代表 | 不足項目、対象商品、確認依頼先を保留記録に残す | 補完後に `S-01` から再開 |
67
+ | `E-02` | `S-02` | 同じ商品に未完了依頼がある | 新規依頼の確定 | 店主代表 | 既存依頼へ数量を反映するか決める | 再承認、または重複不要記録で終了 |
68
+ | `E-03` | `S-03` | 判断根拠を記録できない | 確定以降 | 店主代表 | 補充依頼を確定せず、状況を保留記録に残す | 根拠の確認後に `S-03` から再開 |
69
+ | `E-04` | `S-02` | 未完了依頼を取得できない | `S-02` 以降 | 店主代表 | 中断し、取得失敗を保留記録に残す | 取得後に `S-02` から再開 |
70
+ | `E-05` | `S-04` | 仕入グループへ引き渡せない | 引き渡し | 店主代表 | 確定済み・未受領のまま状況を保留記録に残す | 可能になり次第 `S-04` から再開 |
81
71
 
82
72
  ## 8. 検証・受入観点
83
73
 
84
- | 観点 | 入力条件 | 期待する業務成果 | 確認可能な記録 |
85
- | -------------- | -------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------- | -------------------------- |
86
- | 補充が必要 | 販売中の商品で、現在庫が補充基準を下回る | 店主代表が承認した補充依頼が一件確定し、仕入グループが商品と依頼数量を確認できる | 補充依頼、承認記録 |
87
- | 補充が不要 | 現在庫が補充基準以上、または販売停止・終売である | 補充依頼を作らず、対象商品と補充不要理由が記録される | 在庫記録の補充不要記録 |
88
- | 既存依頼と重複 | 同じ商品に未完了の補充依頼がある | 二重の補充依頼を作らず、既存依頼の更新または重複不要の判断を確認できる | 既存補充依頼、重複確認記録 |
89
- | 重複確認不能 | 未完了依頼を取得できない状態である | 処理を中断し、二重の補充依頼を作らずに未完了依頼の取得失敗が記録される | 保留記録 |
90
- | 判断情報が不足 | 商品、現在庫、補充基準、発注単位のいずれかが不明 | 補充依頼を確定せず、不足項目、確認担当、再開対象の商品が記録される | 保留記録 |
91
- | 確定・引渡失敗 | 判断根拠が記録できない、または引き渡しできない状態である | 補充依頼を非確定・未受領状態のまま保留し、保留記録から状況を確認できる。再開後に承認・受領された補充依頼を確認できる | 保留記録、補充依頼 |
74
+ | 観点 | 入力条件 | 期待する業務成果 | 確認可能な記録 |
75
+ | -------------- | -------------------------------------- | -------------------------------------------- | ---------------------- |
76
+ | 補充が必要 | 販売中、基準割れ、未完了依頼なし | 承認済みの補充依頼が一件、仕入グループに渡る | 補充依頼 |
77
+ | 補充が不要 | 販売停止・終売、または判定時に基準以上 | 補充依頼がなく、補充不要理由が残る | 補充不要記録 |
78
+ | 既存依頼と重複 | `E-02` の検出条件 | 新規依頼なし。再承認か重複不要記録がある | 補充依頼、重複不要記録 |
79
+ | 保留と再開 | `E-01`、`E-03`〜`E-05` の検出条件 | 処置の記録が残り、再開後に補充依頼へ至る | 保留記録、補充依頼 |
@@ -2,39 +2,81 @@
2
2
  specdojo:
3
3
  id: specdojo:br-sample
4
4
  type: rule
5
- status: draft
5
+ status: ready
6
6
  rulebook: specdojo:br-rulebook
7
7
  ---
8
8
 
9
- <!-- markdownlint-disable MD025 -->
10
-
11
- # 在庫不足判定
12
-
13
- <!-- markdownlint-enable MD025 -->
9
+ # 駄菓子屋きぬや 在庫不足判定
14
10
 
15
11
  ## 1. 概要
16
12
 
17
- 販売可能な在庫が発注点を下回っているかを判定する。
13
+ - 判断: 在庫確認の対象商品について、予約分を差し引いた販売可能数が発注点を下回るかを判定する。店主代表以外が店番しても、同じ在庫から同じ判定を得て人気商品の欠品に気付けるようにする。
14
+ - 利用者・場面: 店主代表または家族利用者代表が在庫を確認するとき、商品ごとの在庫数・予約数・発注点がそろった時点で使う。
15
+ - 前提: 単一店舗の商品 1 種類について、同じ確認時点の個数を比べる。値は学習用である。
16
+ - 対象外: 発注点の決め方、発注量、仕入れ先、発注承認、在庫の更新、販売の可否。
18
17
 
19
18
  ## 2. 入力
20
19
 
21
- - 在庫: 在庫数と予約数を、有効在庫の算出に使用する。
22
- - 商品: 発注点を、不足判定のしきい値として使用する。
20
+ | 入力 | 概念データ・項目 | 利用目的 | 適用条件・欠損時の扱い |
21
+ | -------- | ---------------- | -------------------------------- | ------------------------------------------ |
22
+ | 対象商品 | 商品識別 | 入力と結果を同じ商品へ対応付ける | 必須 |
23
+ | 在庫 | 在庫数(個) | 販売可能数の起点 | 必須。予約分を含む総数 |
24
+ | 予約 | 予約数(個) | 予約済みの個数を除く | 必須。予約なしは 0 を明示する |
25
+ | 商品 | 発注点(個) | 不足とみなす境界 | 必須。0 も有効な値で、未設定の代用にしない |
23
26
 
24
27
  ## 3. ルール(判定/計算)
25
28
 
26
- 1. 有効在庫を `在庫数 − 予約数` で算出する。
27
- 2. 有効在庫が発注点を下回る場合は在庫不足と判定する。
29
+ ### 3.1. 判定規則
30
+
31
+ #### 3.1.1. R-01 入力の確認
32
+
33
+ 「例外 / 異常系」の順で入力を確認し、不備があれば以後の計算を行わない。
34
+
35
+ #### 3.1.2. R-02 販売可能数の算出
36
+
37
+ 販売可能数を「在庫数 − 予約数」で算出する。予約数が在庫数を超えても負の値を 0 に丸めず、入力不備とも扱わずに判定へ使う。予約の調整は対象外である。
38
+
39
+ #### 3.1.3. R-03 不足判定
40
+
41
+ 販売可能数が発注点より小さければ「不足」、等しいか大きければ「不足なし」とする。
42
+
43
+ ### 3.2. 判定例
44
+
45
+ 商品識別は `ITEM-A` とする。`E-` の行は判定値を返さない。
46
+
47
+ | 例 | 入力・前提(在庫数 / 予約数 / 発注点、単位: 個) | 適用規則 | 期待結果 |
48
+ | --- | ------------------------------------------------ | -------------- | ------------------------------------------ |
49
+ | 1 | 12 / 3 / 10 | `R-02`、`R-03` | 販売可能数 9、不足 |
50
+ | 2 | 13 / 3 / 10 | `R-02`、`R-03` | 販売可能数 10、不足なし(境界一致) |
51
+ | 3 | 0 / 0 / 0 | `R-02`、`R-03` | 販売可能数 0、不足なし |
52
+ | 4 | 2 / 4 / 0 | `R-02`、`R-03` | 販売可能数 −2、不足(予約超過) |
53
+ | 5 | 8 / 未設定 / 10 | `R-01` | `E-01` |
54
+ | 6 | 8 / 0.5 / 10 | `R-01` | `E-02` |
55
+ | 7 | −1 / 0 / 10 | `R-01` | `E-03` |
56
+ | 8 | −1 / 未設定 / 10 | `R-01` | `E-01` が先。`E-03` は修正後の再判定で示す |
57
+ | 9 | 商品識別が未設定、8 / 0 / 10 | `R-01` | `E-01`。結果を商品へ関連付けられない |
28
58
 
29
59
  ## 4. 出力
30
60
 
31
- - 不足フラグ: 在庫不足の場合は `true`、それ以外は `false`。
61
+ | 出力 | 意味・単位または区分 | 利用先 |
62
+ | ---------- | --------------------------------------- | -------------------------- |
63
+ | 対象商品 | 入力の商品識別 | 在庫を確認した人による照合 |
64
+ | 販売可能数 | 予約分を除いた個数。負数もあり得る | 不足理由の確認 |
65
+ | 不足判定 | 「不足 / 不足なし」。発注の確定ではない | 店主代表による補充検討 |
66
+ | 入力不備 | 例外 ID と該当する項目名 | 入力した担当者による修正 |
67
+
68
+ 入力不備のときは例外 ID と項目名だけを返し、判定不能を「不足なし」と扱わない。
32
69
 
33
70
  ## 5. 例外 / 異常系
34
71
 
35
- - 在庫数、予約数、発注点のいずれかが未設定の場合は判定せず、入力不備として通知する。
36
- - 在庫数、予約数、発注点のいずれかが負数の場合は判定せず、値の矛盾として通知する。
72
+ | ID | 状況 | 扱い | 利用者の次の手 |
73
+ | ------ | -------------------------- | -------------------------------- | ------------------------------------ |
74
+ | `E-01` | 必須項目のいずれかが未設定 | 未設定の項目名を返す | 入力する。発注点は店主代表へ確認する |
75
+ | `E-02` | 個数のいずれかが整数でない | 項目名を返す。換算や丸めはしない | 個数で入力し直す |
76
+ | `E-03` | 個数のいずれかが負数 | 負数の項目名を返す | 記録を確かめて直す |
77
+
78
+ いずれも判定せず、在庫確認担当が直して再判定する。不備が複数の種類にわたる場合は `E-01` → `E-02` → `E-03` の順で最初の種類を返し、その種類の項目はすべて示す。呼出元が入力を取得できなければ、値を推測して本ルールを呼び出さない。
37
79
 
38
80
  ## 6. メモ / 将来課題
39
81
 
40
- - 将来、季節要因に応じて発注点を動的に変更する。
82
+ 未決事項はない。季節別の発注点の設定方法は将来の別ルールで扱う。
@@ -2,37 +2,98 @@
2
2
  specdojo:
3
3
  id: specdojo:ccd-sample
4
4
  type: data
5
- status: draft
5
+ status: ready
6
6
  rulebook: specdojo:ccd-mermaid-rulebook
7
+ based_on:
8
+ - specdojo:bdd-sample
7
9
  ---
8
10
 
9
- # [概念クラス図](../rulebooks/ccd-mermaid-rulebook.md) サンプル
11
+ # 概念クラス図 サンプル
10
12
 
11
13
  ## 1. 目的と適用範囲
12
14
 
13
- 本書は、業務上のエンティティ関係を図で定義するための最小サンプルである。
15
+ 駄菓子屋きぬやの店主代表と開発担当が、販売した商品と購入者を同じ単位で追跡できるよう、商品・顧客・売上記録・売上明細の識別と関連を定義する。技術メンターは設計時の管理単位の確認に、同行レビュー担当はキーと関連の整合性確認に用いる。
14
16
 
15
- ## 2. 入力情報
17
+ ### 1.1. 対象領域と扱う時点
16
18
 
17
- - 対象: 駄菓子屋の販売管理システム
18
- - 前提: プロジェクト文脈は handbook の共通方針に準拠する
19
- - 参照: `../rulebooks/ccd-mermaid-rulebook.md`
19
+ - 単一店舗の店頭販売を対象とし、確定済みの売上記録を扱う。入力途中・取消済みの取引は含めない。会計確定までの操作は [[specdojo:clis-sample|販売管理 CLI 仕様]] を参照する。
20
+ - 商品は販売する種類の単位で管理し、一個ずつの現物とは区別する。商品・売上記録・売上明細の業務上の意味は [[specdojo:bdd-sample|業務データ辞書(駄菓子屋の販売管理)]] に従う。
21
+ - 在庫、発注、つけ残高の集計、決済サービスの応答は対象外とする。購入者との関連は扱うが、代金回収の履歴は本図に含めない。
20
22
 
21
- ## 3. 記述内容
23
+ ### 1.2. 識別と辞書の境界
22
24
 
23
- - 主な内容: 商品・在庫・発注・店舗などの概念と属性、関連(継承/親子/参照) など
24
- - 必須観点: 対象、条件、判定基準、責任者
25
+ 図には主キーを示し、販売単価・数量などの定義の正本は販売管理の辞書とその参照先とする。顧客台帳と商品の特殊化については、既存辞書で確認できた対応と未照合の範囲を「参照業務データ辞書」に示す。
25
26
 
26
- ## 4. 最小記述例
27
+ ## 2. 概念クラス図
27
28
 
28
- | 項目 | 値 | 備考 |
29
- | ------------ | ------------------------------------------------------------------- | ------------------------------------ |
30
- | ドキュメント | [概念クラス図](../rulebooks/ccd-mermaid-rulebook.md) | 最小サンプル |
31
- | 目的 | 業務上のエンティティ関係を図で定義する | specdojo:deliverables-reference 準拠 |
32
- | 主な内容 | 商品・在庫・発注・店舗などの概念と属性、関連(継承/親子/参照) など | 要点のみ記載 |
29
+ ```mermaid
30
+ classDiagram
31
+
32
+ class 商品 {
33
+ 商品ID: PK
34
+ }
35
+
36
+ class お菓子 {}
37
+
38
+ class 玩具 {}
39
+
40
+ class 顧客 {
41
+ 顧客ID: PK
42
+ }
43
+
44
+ class 売上記録 {
45
+ 売上ID: PK
46
+ }
47
+
48
+ class 売上明細 {
49
+ 売上ID: PK
50
+ 明細番号: PK
51
+ }
52
+
53
+ 商品 <|-- お菓子 : 種類
54
+ 商品 <|-- 玩具 : 種類
55
+ 売上記録 "1" *-- "1..*" 売上明細 : 構成する
56
+ 売上明細 "0..*" --> "1" 商品 : 対象商品
57
+ 売上記録 "0..*" --> "0..1" 顧客 : 購入者
58
+ ```
59
+
60
+ お菓子と玩具は商品の下位概念であり、商品IDを継承する。同じ商品の別レコードを作る意味ではなく、独立した主キーは追加しない。特殊化の辞書定義は未照合である。
61
+
62
+ ## 3. 関連定義と多重度の根拠
63
+
64
+ ### 3.1. 関連ごとの成立条件
65
+
66
+ 多重度は図の起点側・先側の順に示す。
67
+
68
+ | 関連(起点 - 先) | 関係種別 | 多重度 | 役割名 | 業務上の理由・根拠 |
69
+ | ------------------- | -------- | ---------------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
70
+ | 商品 - お菓子 | 継承 | — | 種類 | お菓子は販売対象の商品として識別・参照される種類であり、売上明細との関連も引き継ぐ。商品の構成部品ではない。 |
71
+ | 商品 - 玩具 | 継承 | — | 種類 | 玩具も商品として販売・追跡する種類であり、商品と別の識別単位を設けない。お菓子と玩具の分類境界は辞書整備時に確認する。 |
72
+ | 売上記録 - 売上明細 | 親子 | `1` 対 `1..*` | 構成する | 明細は必ず一つの売上記録に属し、単独で管理しない。確定済み売上には一行以上必要で、複数商品の購入では複数行になる。入力途中の明細0件は対象時点の外にある。 |
73
+ | 売上明細 - 商品 | 参照 | `0..*` 対 `1` | 対象商品 | 明細一行の販売対象は必ず一つの商品。同じ商品は複数の販売・明細に現れ、未販売の商品も管理するため、商品に対応する明細は0件以上となる。商品は売上とは別の管理単位として残す。 |
74
+ | 売上記録 - 顧客 | 参照 | `0..*` 対 `0..1` | 購入者 | 一回の販売で特定する購入者は一人まで。一見客の現金販売では特定しない。顧客は購入前に登録でき、繰り返し購入できるため、対応する売上は0件以上となる。つけ販売の必須条件は次節で限定する。 |
75
+
76
+ ### 3.2. 図だけでは表せない整合性条件
77
+
78
+ - 売上明細は売上IDと明細番号の組で一意にする。明細番号は別の売上で再利用でき、商品IDだけで明細をまとめない。同じ商品を複数行で販売しても各行を識別できる。
79
+ - 売上明細の参照先商品と、購入者を指定した売上の参照先顧客が存在することを確認する。過去の販売を追跡できるよう、商品の名称・価格の変更によって参照先の識別を変えない。親子の線は業務上の所属を表し、保存ファイルの削除連動は定めない。
80
+ - 売上と顧客の任意関連は全販売に対する許容範囲である。[[specdojo:bdd-sample|業務データ辞書(駄菓子屋の販売管理)]] の売上記録に従い、つけ販売では請求先の顧客を必須とする。購入者未指定を現金販売と読み替えない。
81
+
82
+ ## 4. 参照業務データ辞書
83
+
84
+ 作成済み辞書と照合したキーの対応を示す。「未定義」は既存辞書に該当する概念がない状態、「未作成」は参照予定の辞書自体がない状態を表す。
85
+
86
+ | エンティティ | 主キーの対応 | 参照先業務データ辞書 |
87
+ | ------------ | -------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------- |
88
+ | 商品 | 商品ID → `product_id`。店舗で管理する商品の範囲で一意 | [[specdojo:bdd-sample\|業務データ辞書(駄菓子屋の販売管理)]] の商品 |
89
+ | お菓子・玩具 | 商品の `product_id` を継承。商品全体と同じ識別範囲を使い、種類ごとに同じIDを別商品へ割り当てない | [[specdojo:bdd-sample\|業務データ辞書(駄菓子屋の販売管理)]] の商品キーのみ照合済み。下位概念は未定義 |
90
+ | 顧客 | 顧客ID → 売上記録の参照項目 `customer_id`。顧客台帳内で一意とする想定だが、台帳のキーは未照合 | 予定 ID `specdojo:bdd-customer`(未作成)。既存の [[specdojo:bdd-sample\|販売管理の辞書]] では顧客台帳は対象外 |
91
+ | 売上記録 | 売上ID → `sale_id`。店舗の販売全体で一意 | [[specdojo:bdd-sample\|業務データ辞書(駄菓子屋の販売管理)]] の売上記録 |
92
+ | 売上明細 | 売上ID・明細番号 → `sale_id`・`line_number` の複合主キー。明細番号単独の一意性は一回の販売内に限る | [[specdojo:bdd-sample\|業務データ辞書(駄菓子屋の販売管理)]] の売上明細 |
33
93
 
34
94
  ## 5. 未解決事項
35
95
 
36
- | 論点 | 処理方針 |
37
- | -------------- | ------------------------ |
38
- | 要件詳細の補強 | 実案件適用時に具体化する |
96
+ | 論点 | 影響・現在の扱い | 解消責務・確認条件 |
97
+ | ---------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
98
+ | 商品の特殊化の辞書定義 | 商品キーとの対応は確認済みだが、お菓子・玩具の分類境界は既存辞書で未定義。図の継承は維持し、分類の網羅性・排他性は断定しない | 開発担当が辞書への定義追加案を作成し、店主代表が分類境界を確認する。技術メンターが継承するキーと関連を照合できた時点で解消する |
99
+ | 顧客台帳との照合 | _ASSUMPTION_: 予定辞書 `specdojo:bdd-customer` で顧客IDを台帳内の一意キーとする。売上側の参照名は確認済みだが、参照先のキー・識別範囲は未照合。顧客関連を確定済みとは扱わない | 開発担当が顧客辞書を整備し、店主代表が購入者の特定単位を確認する。技術メンターが `customer_id` の対応・一意性・参照先の存在条件と、つけ販売時の必須条件を照合した時点で解消する |