specdojo 0.8.0 → 0.9.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (292) hide show
  1. package/.github/agents/specdojo-orchestrator.md +4 -1
  2. package/CHANGELOG.md +77 -0
  3. package/dist/catalog/catalog.js +16 -14
  4. package/dist/commands/agent.js +5 -3
  5. package/dist/commands/build.js +69 -10
  6. package/dist/commands/git.js +206 -0
  7. package/dist/commands/init.js +4 -2
  8. package/dist/commands/orchestrator.js +5 -77
  9. package/dist/commands/where.js +25 -0
  10. package/dist/dashboard/dashboard.js +5 -3
  11. package/dist/dashboard/routines.js +4 -7
  12. package/dist/dashboard/shared.js +2 -2
  13. package/dist/dashboard/timeline.js +14 -14
  14. package/dist/deliverable/trash.js +2 -1
  15. package/dist/docs/index-command.js +2 -2
  16. package/dist/docs/yaml-business-tables.js +243 -0
  17. package/dist/docs/yaml-interface-tables.js +106 -0
  18. package/dist/docs/yaml-pages-command.js +5 -3
  19. package/dist/docs/yaml-pages.js +146 -3
  20. package/dist/docs/yaml-table-shared.js +70 -0
  21. package/dist/docs/yaml-tables.js +39 -0
  22. package/dist/exec/agent-config.js +9 -0
  23. package/dist/exec/agent-protected-config.js +2 -0
  24. package/dist/exec/commands.js +31 -18
  25. package/dist/exec/events.js +34 -14
  26. package/dist/exec/evidence.js +13 -3
  27. package/dist/exec/opencode-permissions.js +117 -0
  28. package/dist/exec/parent-validation.js +56 -3
  29. package/dist/exec/plans-core.js +21 -2
  30. package/dist/exec/plans-generation.js +6 -7
  31. package/dist/exec/post-integration.js +162 -0
  32. package/dist/exec/queue-command.js +166 -0
  33. package/dist/exec/queue.js +285 -0
  34. package/dist/exec/register-foreign-wait.js +82 -0
  35. package/dist/exec/repo-integration-sync.js +17 -5
  36. package/dist/exec/repo-trace.js +2 -1
  37. package/dist/exec/reporter.js +2 -2
  38. package/dist/exec/results.js +24 -4
  39. package/dist/exec/review-kata.js +4 -1
  40. package/dist/exec/run/agent-pipeline.js +3 -2
  41. package/dist/exec/run/agent.js +12 -6
  42. package/dist/exec/run/change-scope.js +365 -0
  43. package/dist/exec/run/deferred-cleanup.js +31 -0
  44. package/dist/exec/run/in-place.js +5 -2
  45. package/dist/exec/run/job-lock.js +66 -0
  46. package/dist/exec/run/job-sequence.js +137 -0
  47. package/dist/exec/run/job.js +56 -19
  48. package/dist/exec/run/lifecycle-commands.js +1 -1
  49. package/dist/exec/run/lock.js +22 -1
  50. package/dist/exec/run/register-command.js +8 -5
  51. package/dist/exec/run/register-mode.js +68 -8
  52. package/dist/exec/run/register-resume.js +68 -14
  53. package/dist/exec/run/register-state.js +13 -8
  54. package/dist/exec/run/register-worktree.js +140 -125
  55. package/dist/exec/run/schedule-mode.js +75 -14
  56. package/dist/exec/run/schedule-prepare.js +3 -0
  57. package/dist/exec/run/schedule-task.js +88 -38
  58. package/dist/exec/run/shared.js +5 -0
  59. package/dist/exec/schedule/schedule.js +116 -4
  60. package/dist/exec/shared.js +2 -2
  61. package/dist/exec/smoke.js +190 -0
  62. package/dist/exec/strategy.js +13 -3
  63. package/dist/exec/task-repos.js +19 -4
  64. package/dist/exec/task-view.js +6 -4
  65. package/dist/exec/trial-commands.js +5 -2
  66. package/dist/exec/trial-core.js +6 -1
  67. package/dist/exec/validation-metrics.js +181 -0
  68. package/dist/exec/worktree-cleanup-lock.js +26 -0
  69. package/dist/exec/worktree-command.js +12 -2
  70. package/dist/exec/worktree-ops-commit.js +2 -2
  71. package/dist/exec/worktree.js +13 -2
  72. package/dist/grade/command-apply.js +3 -3
  73. package/dist/grade/command-inspect.js +5 -3
  74. package/dist/grade/command-plan.js +1 -1
  75. package/dist/grade/command-run.js +5 -1
  76. package/dist/grade/run.js +64 -8
  77. package/dist/job/definition.js +84 -8
  78. package/dist/job/job.js +79 -23
  79. package/dist/register/authoring-sources.js +22 -16
  80. package/dist/register/maintenance-commands.js +2 -2
  81. package/dist/register/register.js +31 -7
  82. package/dist/register/renumber.js +1 -3
  83. package/dist/routine/definition.js +9 -0
  84. package/dist/routine/routine.js +137 -43
  85. package/dist/routine/status.js +62 -0
  86. package/dist/schedule/schedule.js +38 -39
  87. package/dist/shared/agent-types.js +5 -0
  88. package/dist/shared/cross-process-lock.js +9 -1
  89. package/dist/shared/dist-freshness.js +8 -2
  90. package/dist/shared/git-environment.js +2 -1
  91. package/dist/shared/git.js +44 -1
  92. package/dist/shared/lefthook-scaffold.js +3 -0
  93. package/dist/shared/local-config.js +244 -0
  94. package/dist/shared/specdojo-config.js +34 -20
  95. package/dist/shared/specdojo-gitignore.js +1 -0
  96. package/dist/shared/text.js +17 -1
  97. package/dist/shared/where-alias.js +13 -0
  98. package/dist/specdojo.js +4 -0
  99. package/docs/ja/specdojo/defaults/pm-review-viewpoints.yaml +2 -0
  100. package/docs/ja/specdojo/guides/exec-config-guide.md +23 -4
  101. package/docs/ja/specdojo/guides/exec-operation-guide.md +44 -1
  102. package/docs/ja/specdojo/guides/job-sequence-guide.md +77 -0
  103. package/docs/ja/specdojo/guides/orchestrator-operation-guide.md +1 -1
  104. package/docs/ja/specdojo/guides/quick-start-guide.md +3 -3
  105. package/docs/ja/specdojo/guides/register-operation-guide.md +1 -1
  106. package/docs/ja/specdojo/guides/routine-operation-guide.md +11 -6
  107. package/docs/ja/specdojo/guides/schedule-design-guide.md +20 -17
  108. package/docs/ja/specdojo/guides/waza-guide.md +12 -8
  109. package/docs/ja/specdojo/recipes/bac-recipe.md +66 -49
  110. package/docs/ja/specdojo/recipes/bes-recipe.md +90 -54
  111. package/docs/ja/specdojo/recipes/bps-recipe.md +88 -139
  112. package/docs/ja/specdojo/recipes/br-recipe.md +40 -47
  113. package/docs/ja/specdojo/recipes/cdfd-overview-recipe.md +97 -109
  114. package/docs/ja/specdojo/recipes/cdfd-recipe.md +85 -146
  115. package/docs/ja/specdojo/recipes/cdfd-uc-recipe.md +91 -110
  116. package/docs/ja/specdojo/recipes/cnd-recipe.md +79 -69
  117. package/docs/ja/specdojo/recipes/cpd-recipe.md +78 -64
  118. package/docs/ja/specdojo/recipes/cxd-recipe.md +92 -75
  119. package/docs/ja/specdojo/recipes/ifd-recipe.md +79 -68
  120. package/docs/ja/specdojo/recipes/ifx-cmd-recipe.md +78 -105
  121. package/docs/ja/specdojo/recipes/ifx-index-recipe.md +105 -71
  122. package/docs/ja/specdojo/recipes/pm-communication-plan-recipe.md +60 -49
  123. package/docs/ja/specdojo/recipes/pm-members-recipe.md +50 -51
  124. package/docs/ja/specdojo/recipes/pm-organization-recipe.md +59 -51
  125. package/docs/ja/specdojo/recipes/pm-plan-recipe.md +69 -56
  126. package/docs/ja/specdojo/recipes/pm-quality-management-plan-recipe.md +37 -56
  127. package/docs/ja/specdojo/recipes/pm-raci-recipe.md +39 -53
  128. package/docs/ja/specdojo/recipes/pm-roles-recipe.md +52 -79
  129. package/docs/ja/specdojo/recipes/prj-assumptions-constraints-dependencies-recipe.md +64 -93
  130. package/docs/ja/specdojo/recipes/prj-charter-recipe.md +71 -106
  131. package/docs/ja/specdojo/recipes/prj-comparison-of-alternatives-recipe.md +78 -157
  132. package/docs/ja/specdojo/recipes/prj-issues-and-approach-recipe.md +62 -111
  133. package/docs/ja/specdojo/recipes/prj-scope-recipe.md +67 -123
  134. package/docs/ja/specdojo/recipes/prj-stakeholder-register-recipe.md +60 -96
  135. package/docs/ja/specdojo/recipes/prj-success-criteria-and-acceptance-criteria-recipe.md +61 -105
  136. package/docs/ja/specdojo/recipes/stsd-recipe.md +79 -109
  137. package/docs/ja/specdojo/recipes/sysd-critical-flows-recipe.md +78 -55
  138. package/docs/ja/specdojo/recipes/sysd-cross-cutting-policy-recipe.md +82 -73
  139. package/docs/ja/specdojo/recipes/sysd-index-recipe.md +78 -59
  140. package/docs/ja/specdojo/recipes/tsd-recipe.md +149 -129
  141. package/docs/ja/specdojo/references/command-reference.md +258 -118
  142. package/docs/ja/specdojo/references/deliverables-reference.md +21 -12
  143. package/docs/ja/specdojo/references/specdojo-config-reference.md +47 -10
  144. package/docs/ja/specdojo/rulebooks/atc-index-rulebook.md +101 -257
  145. package/docs/ja/specdojo/rulebooks/atc-rulebook.md +102 -228
  146. package/docs/ja/specdojo/rulebooks/bac-rulebook.md +19 -28
  147. package/docs/ja/specdojo/rulebooks/bdd-rulebook.md +16 -67
  148. package/docs/ja/specdojo/rulebooks/bds-rulebook.md +30 -51
  149. package/docs/ja/specdojo/rulebooks/bes-index-rulebook.md +41 -61
  150. package/docs/ja/specdojo/rulebooks/bes-rulebook.md +22 -50
  151. package/docs/ja/specdojo/rulebooks/bps-rulebook.md +24 -56
  152. package/docs/ja/specdojo/rulebooks/br-rulebook.md +13 -38
  153. package/docs/ja/specdojo/rulebooks/ccd-mermaid-rulebook.md +41 -76
  154. package/docs/ja/specdojo/rulebooks/cdfd-d2-rulebook.md +18 -93
  155. package/docs/ja/specdojo/rulebooks/cdfd-mermaid-rulebook.md +18 -52
  156. package/docs/ja/specdojo/rulebooks/cdfd-overview-rulebook.md +109 -147
  157. package/docs/ja/specdojo/rulebooks/cdfd-rulebook.md +80 -108
  158. package/docs/ja/specdojo/rulebooks/cdfd-uc-rulebook.md +21 -46
  159. package/docs/ja/specdojo/rulebooks/cdr-rulebook.md +144 -0
  160. package/docs/ja/specdojo/rulebooks/cdsd-rulebook.md +27 -48
  161. package/docs/ja/specdojo/rulebooks/cdt-rulebook.md +37 -50
  162. package/docs/ja/specdojo/rulebooks/clis-rulebook.md +52 -69
  163. package/docs/ja/specdojo/rulebooks/cnd-mermaid-rulebook.md +33 -86
  164. package/docs/ja/specdojo/rulebooks/cnd-rulebook.md +16 -32
  165. package/docs/ja/specdojo/rulebooks/cop-index-rulebook.md +45 -131
  166. package/docs/ja/specdojo/rulebooks/cop-rulebook.md +69 -275
  167. package/docs/ja/specdojo/rulebooks/cpd-mermaid-rulebook.md +20 -112
  168. package/docs/ja/specdojo/rulebooks/cpd-rulebook.md +23 -56
  169. package/docs/ja/specdojo/rulebooks/cxd-mermaid-rulebook.md +12 -145
  170. package/docs/ja/specdojo/rulebooks/cxd-rulebook.md +39 -47
  171. package/docs/ja/specdojo/rulebooks/dct-index-rulebook.md +37 -56
  172. package/docs/ja/specdojo/rulebooks/dct-rulebook.md +118 -175
  173. package/docs/ja/specdojo/rulebooks/dec-rulebook.md +5 -14
  174. package/docs/ja/specdojo/rulebooks/dmd-index-rulebook.md +22 -66
  175. package/docs/ja/specdojo/rulebooks/dmd-rulebook.md +36 -94
  176. package/docs/ja/specdojo/rulebooks/dss-rulebook.md +59 -81
  177. package/docs/ja/specdojo/rulebooks/etc-index-rulebook.md +31 -131
  178. package/docs/ja/specdojo/rulebooks/etc-rulebook.md +50 -104
  179. package/docs/ja/specdojo/rulebooks/gl-rulebook.md +51 -61
  180. package/docs/ja/specdojo/rulebooks/ifd-mermaid-rulebook.md +38 -45
  181. package/docs/ja/specdojo/rulebooks/ifx-api-rulebook.md +14 -20
  182. package/docs/ja/specdojo/rulebooks/ifx-cmd-rulebook.md +26 -38
  183. package/docs/ja/specdojo/rulebooks/ifx-file-rulebook.md +26 -107
  184. package/docs/ja/specdojo/rulebooks/ifx-index-rulebook.md +42 -49
  185. package/docs/ja/specdojo/rulebooks/ifx-msg-rulebook.md +14 -22
  186. package/docs/ja/specdojo/rulebooks/imp-business-rulebook.md +21 -44
  187. package/docs/ja/specdojo/rulebooks/imp-data-rulebook.md +41 -64
  188. package/docs/ja/specdojo/rulebooks/imp-interface-rulebook.md +14 -38
  189. package/docs/ja/specdojo/rulebooks/imp-operations-rulebook.md +34 -61
  190. package/docs/ja/specdojo/rulebooks/imp-test-rulebook.md +27 -50
  191. package/docs/ja/specdojo/rulebooks/itc-index-rulebook.md +70 -199
  192. package/docs/ja/specdojo/rulebooks/itc-rulebook.md +65 -153
  193. package/docs/ja/specdojo/rulebooks/mip-index-rulebook.md +74 -150
  194. package/docs/ja/specdojo/rulebooks/mm-rulebook.md +11 -23
  195. package/docs/ja/specdojo/rulebooks/mtp-rulebook.md +99 -176
  196. package/docs/ja/specdojo/rulebooks/nfr-availability-rulebook.md +35 -61
  197. package/docs/ja/specdojo/rulebooks/nfr-index-rulebook.md +75 -117
  198. package/docs/ja/specdojo/rulebooks/nfr-integrity-rulebook.md +31 -60
  199. package/docs/ja/specdojo/rulebooks/nfr-maintainability-rulebook.md +26 -81
  200. package/docs/ja/specdojo/rulebooks/nfr-operations-rulebook.md +32 -70
  201. package/docs/ja/specdojo/rulebooks/nfr-performance-rulebook.md +45 -87
  202. package/docs/ja/specdojo/rulebooks/nfr-reliability-rulebook.md +48 -101
  203. package/docs/ja/specdojo/rulebooks/nfr-security-safety-rulebook.md +44 -80
  204. package/docs/ja/specdojo/rulebooks/nfr-usability-rulebook.md +59 -127
  205. package/docs/ja/specdojo/rulebooks/opd-index-rulebook.md +31 -50
  206. package/docs/ja/specdojo/rulebooks/opd-rulebook.md +42 -109
  207. package/docs/ja/specdojo/rulebooks/opr-index-rulebook.md +29 -42
  208. package/docs/ja/specdojo/rulebooks/opr-rulebook.md +29 -87
  209. package/docs/ja/specdojo/rulebooks/otp-index-rulebook.md +62 -84
  210. package/docs/ja/specdojo/rulebooks/otp-rulebook.md +11 -61
  211. package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +91 -106
  212. package/docs/ja/specdojo/rulebooks/pm-change-request-log-rulebook.md +25 -34
  213. package/docs/ja/specdojo/rulebooks/pm-communication-plan-rulebook.md +30 -53
  214. package/docs/ja/specdojo/rulebooks/pm-issue-log-rulebook.md +23 -35
  215. package/docs/ja/specdojo/rulebooks/pm-members-rulebook.md +27 -45
  216. package/docs/ja/specdojo/rulebooks/pm-organization-rulebook.md +37 -45
  217. package/docs/ja/specdojo/rulebooks/pm-plan-rulebook.md +45 -46
  218. package/docs/ja/specdojo/rulebooks/pm-quality-management-plan-rulebook.md +37 -48
  219. package/docs/ja/specdojo/rulebooks/pm-raci-rulebook.md +25 -29
  220. package/docs/ja/specdojo/rulebooks/pm-risk-register-rulebook.md +28 -35
  221. package/docs/ja/specdojo/rulebooks/pm-roles-rulebook.md +36 -41
  222. package/docs/ja/specdojo/rulebooks/pr-rulebook.md +5 -18
  223. package/docs/ja/specdojo/rulebooks/prj-assumptions-constraints-dependencies-rulebook.md +16 -37
  224. package/docs/ja/specdojo/rulebooks/prj-charter-rulebook.md +23 -97
  225. package/docs/ja/specdojo/rulebooks/prj-comparison-of-alternatives-rulebook.md +39 -57
  226. package/docs/ja/specdojo/rulebooks/prj-issues-and-approach-rulebook.md +43 -116
  227. package/docs/ja/specdojo/rulebooks/prj-scope-rulebook.md +16 -51
  228. package/docs/ja/specdojo/rulebooks/prj-stakeholder-register-rulebook.md +47 -92
  229. package/docs/ja/specdojo/rulebooks/prj-success-criteria-and-acceptance-criteria-rulebook.md +25 -84
  230. package/docs/ja/specdojo/rulebooks/sac-rulebook.md +44 -107
  231. package/docs/ja/specdojo/rulebooks/sf-index-rulebook.md +39 -49
  232. package/docs/ja/specdojo/rulebooks/sf-rulebook.md +42 -49
  233. package/docs/ja/specdojo/rulebooks/sld-rulebook.md +64 -89
  234. package/docs/ja/specdojo/rulebooks/stc-index-rulebook.md +90 -189
  235. package/docs/ja/specdojo/rulebooks/stc-rulebook.md +45 -105
  236. package/docs/ja/specdojo/rulebooks/stsd-mermaid-rulebook.md +6 -12
  237. package/docs/ja/specdojo/rulebooks/stsd-rulebook.md +49 -68
  238. package/docs/ja/specdojo/rulebooks/sysd-critical-flows-rulebook.md +51 -60
  239. package/docs/ja/specdojo/rulebooks/sysd-cross-cutting-policy-rulebook.md +46 -50
  240. package/docs/ja/specdojo/rulebooks/sysd-index-rulebook.md +39 -64
  241. package/docs/ja/specdojo/rulebooks/sysd-rulebook.md +47 -60
  242. package/docs/ja/specdojo/rulebooks/trc-requirements-to-specs-rulebook.md +69 -70
  243. package/docs/ja/specdojo/rulebooks/trc-requirements-to-tests-rulebook.md +65 -72
  244. package/docs/ja/specdojo/rulebooks/tsd-index-rulebook.md +35 -46
  245. package/docs/ja/specdojo/rulebooks/tsd-rulebook.md +49 -66
  246. package/docs/ja/specdojo/rulebooks/tsp-index-rulebook.md +64 -139
  247. package/docs/ja/specdojo/rulebooks/uis-rulebook.md +41 -108
  248. package/docs/ja/specdojo/rulebooks/utc-index-rulebook.md +49 -144
  249. package/docs/ja/specdojo/rulebooks/utc-rulebook.md +67 -155
  250. package/docs/ja/specdojo/samples/bds-sample.md +58 -71
  251. package/docs/ja/specdojo/samples/bes-index-sample.md +20 -37
  252. package/docs/ja/specdojo/samples/bes-sample.md +43 -53
  253. package/docs/ja/specdojo/samples/bps-sample.md +42 -54
  254. package/docs/ja/specdojo/samples/br-sample.md +40 -52
  255. package/docs/ja/specdojo/samples/ccd-sample.md +0 -1
  256. package/docs/ja/specdojo/samples/cdr-sample.md +78 -0
  257. package/docs/ja/specdojo/samples/cdsd-sample.md +47 -63
  258. package/docs/ja/specdojo/samples/clis-sample.md +70 -77
  259. package/docs/ja/specdojo/samples/dec-sample.md +2 -3
  260. package/docs/ja/specdojo/samples/ifx-api-sample.yaml +0 -2
  261. package/docs/ja/specdojo/samples/ifx-msg-sample.yaml +0 -2
  262. package/docs/ja/specdojo/samples/job-sequence.yaml +67 -0
  263. package/docs/ja/specdojo/samples/mip-index-sample.md +98 -20
  264. package/docs/ja/specdojo/samples/pm-communication-plan-sample.md +26 -19
  265. package/docs/ja/specdojo/samples/pm-organization-sample.md +39 -50
  266. package/docs/ja/specdojo/samples/pm-plan-sample.md +61 -67
  267. package/docs/ja/specdojo/samples/pm-quality-management-plan-sample.md +31 -45
  268. package/docs/ja/specdojo/samples/pm-raci-sample.md +31 -37
  269. package/docs/ja/specdojo/samples/prj-assumptions-constraints-dependencies-sample.md +32 -48
  270. package/docs/ja/specdojo/samples/prj-charter-sample.md +42 -59
  271. package/docs/ja/specdojo/samples/prj-comparison-of-alternatives-sample.md +55 -61
  272. package/docs/ja/specdojo/samples/prj-success-criteria-and-acceptance-criteria-sample.md +30 -33
  273. package/docs/ja/specdojo/samples/sf-index-sample.md +13 -55
  274. package/docs/ja/specdojo/samples/sf-sample.md +73 -85
  275. package/docs/ja/specdojo/samples/sld-sample.md +60 -79
  276. package/docs/ja/specdojo/samples/uis-sample.md +98 -121
  277. package/docs/ja/specdojo/standards/job-definition-standard.md +24 -9
  278. package/docs/ja/specdojo/templates/cdr-template.md +58 -0
  279. package/docs/specdojo/schemas/v1/exec-common.schema.yaml +2 -1
  280. package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +42 -5
  281. package/docs/specdojo/schemas/v1/exec-evidence.schema.yaml +35 -0
  282. package/docs/specdojo/schemas/v1/job-run.schema.yaml +23 -0
  283. package/docs/specdojo/schemas/v1/job.schema.yaml +63 -2
  284. package/docs/specdojo/schemas/v1/sch-strategy.schema.yaml +2 -2
  285. package/package.json +9 -6
  286. package/templates/antigravity/orchestrator.md +4 -1
  287. package/templates/claude/agents/specdojo-orchestrator.md +4 -1
  288. package/templates/codex/agents/specdojo-orchestrator.toml +4 -1
  289. package/templates/codex/orchestrator.md +4 -1
  290. package/templates/init-exec-defaults.yaml +13 -0
  291. package/templates/lefthook/tools/specdojo-pre-commit.mjs +8 -0
  292. package/templates/opencode/agents/specdojo-orchestrator.md +5 -2
@@ -13,7 +13,7 @@ specdojo:
13
13
 
14
14
  # 代替案比較: 駄菓子屋きぬや 販売管理システム
15
15
 
16
- 販売・在庫・つけの記録を店主代表以外の店番でも継続できるよう、解決方式を比較する。人間の `PO` が方式と試行対象を判断し、`PM` が未決事項と後続作業を計画へ渡すための完成例である。
16
+ 販売・在庫・つけの記録を店主代表以外の店番でも継続できるよう、解決方式を比較し、試行対象と見直し条件を決める。
17
17
 
18
18
  ## 1. 比較目的と前提条件
19
19
 
@@ -23,11 +23,11 @@ specdojo:
23
23
 
24
24
  根拠資料:
25
25
 
26
- - [[specdojo:prj-scope-sample|プロジェクトスコープ]]: 販売・在庫・つけと簡易一覧を初期対象とし、EC、本格会計、仕入れ先連携、複数店舗管理を除外する。
27
- - [[specdojo:prj-issues-and-approach-sample|プロジェクト課題と解決アプローチ]]: P-01 は記録不統一、P-02 は残高確認の負荷、P-03 は在庫過不足。記録手段と日次確認・引き継ぎを一式で比較する。
28
- - [[specdojo:prj-assumptions-constraints-dependencies-sample|前提・制約・依存関係]]: タブレット1台、現行手順に近い操作、費用承認、通信断時の方針決定を成立条件とする。
26
+ - [[specdojo:prj-scope-sample|プロジェクトスコープ]]: 初期対象は販売・在庫・つけと簡易一覧。EC・会計・仕入れ先連携・複数店舗は対象外。
27
+ - [[specdojo:prj-issues-and-approach-sample|プロジェクト課題と解決アプローチ]]: P-01 記録不統一、P-02 残高確認の負荷、P-03 在庫過不足。
28
+ - [[specdojo:prj-assumptions-constraints-dependencies-sample|前提・制約・依存関係]]: タブレット1台、現行手順に近い操作、費用承認、通信断時の方針決定。
29
29
 
30
- _ASSUMPTION_: 本比較の期間評価では、準備着手の承認から2週間以内に試行候補を用意できることを目安とする。初期リリース日を確定したものではない。現金支出・参加者別作業時間の上限と具体日は [[specdojo:pm-plan-sample|プロジェクト管理計画]] の U-01〜U-03 で判断し、未承認の支出・作業を開始しない。
30
+ _ASSUMPTION_: 期間評価の目安は準備着手の承認から2週間とする(初期リリース日ではない)。支出・作業時間の上限と具体日は [[specdojo:pm-plan-sample|プロジェクト管理計画]] の U-01〜U-03 で決まるまで、未承認の支出・作業を始めない。
31
31
 
32
32
  | 候補カテゴリ | 候補に含める基準 |
33
33
  | ------------------ | ---------------------------------------------------------------- |
@@ -36,45 +36,43 @@ _ASSUMPTION_: 本比較の期間評価では、準備着手の承認から2週
36
36
  | 既存製品・サービス | 販売・在庫を既存機能で扱い、つけ管理を含む一式の運用を構成できる |
37
37
  | 個別構築 | 店舗固有の手順と初期対象に合わせた最小機能を構築できる |
38
38
 
39
- 外部候補は、[Google スプレッドシートの公式ヘルプ](https://support.google.com/docs/answer/6000292?co=GENIE.Platform%3DAndroid&hl=ja) でタブレットでの編集と書き出し、[Square の公式ヘルプ](https://squareup.com/help/jp/ja/article/8331-set-up-inventory-tracking) で販売に伴う在庫更新と商品情報の入出力を確認し、ALT-02・ALT-03 に含めた(資料確認日: 2026-11-13)。これはカテゴリの成立根拠であり、市場代表・店舗適合の証明ではない。端末の OS、費用、つけ管理、保管先・権限、全記録の取り出しは個別確認を残す。既存サービス案が残った時点で別レイヤーの製品比較へ進む。
39
+ ALT-02・ALT-03 は [Google スプレッドシート](https://support.google.com/docs/answer/6000292) と [Square](https://squareup.com/help/jp/ja/article/8331-set-up-inventory-tracking) の公式ヘルプ(確認日: 2026-11-13)で編集・書き出しと販売連動の在庫更新を確かめて加えた。市場代表・店舗適合の証明ではない。製品比較は既存サービス案が残った場合に別レイヤーで行う。
40
40
 
41
41
  ## 2. 比較対象案
42
42
 
43
43
  ### 2.1. D-01: 業務・システム解決方式
44
44
 
45
- | 案ID | 案 | カテゴリ | 課題解決への道筋 | 主な構成要素 | 対象範囲 |
46
- | ------ | -------------------------------- | ------------------ | ---------------------------------------------------- | ---------------------------------------------- | -------------------- |
47
- | ALT-01 | 紙帳票と手順の標準化 | 非システム対応 | 帳票と日次確認を統一し、店番交代時のばらつきを減らす | 統一帳票、操作メモ、手計算による残高・在庫確認 | 初期対象の記録と一覧 |
48
- | ALT-02 | 共有表計算による簡易管理 | 汎用デジタルツール | 共有表への記録と数式集計で残高・在庫を確認する | 販売・在庫・つけ台帳、入力規則、日次確認 | 初期対象の記録と一覧 |
49
- | ALT-03 | 既存 POS・在庫管理サービスの利用 | 既存製品・サービス | 既存の販売・在庫機能とつけの補助手段で一式を構成する | POS、在庫、つけ補助台帳、照合・引き継ぎ | 初期対象の記録と一覧 |
50
- | ALT-04 | 最小販売管理システムの個別構築 | 個別構築 | 店舗の記録項目と操作に合わせて一元化する | 販売登録、在庫、つけ残高、簡易一覧、日次確認 | 初期対象の記録と一覧 |
45
+ 全案が初期対象の記録と一覧を扱い、日次確認・引き継ぎ(前段の A-03)を含む。ALT-01・ALT-04 は前段の A-02・A-01 に当たる。
51
46
 
52
- ALT-01・ALT-04 は前段の A-02・A-01 に対応し、全案に A-03 の日次確認・引き継ぎを含める。ALT-02・ALT-03 を追加し、前段の採用方針だけで候補を閉じない。
47
+ | 案ID | 案 | カテゴリ | 課題解決への道筋 | 主な構成要素 |
48
+ | ------ | -------------------------------- | ------------------ | ---------------------------------------------------- | ------------------------------------ |
49
+ | ALT-01 | 紙帳票と手順の標準化 | 非システム対応 | 帳票と日次確認を統一し、店番交代時のばらつきを減らす | 統一帳票、操作メモ、手計算による確認 |
50
+ | ALT-02 | 共有表計算による簡易管理 | 汎用デジタルツール | 共有表への記録と数式集計で残高・在庫を確認する | 販売・在庫・つけ台帳、入力規則 |
51
+ | ALT-03 | 既存 POS・在庫管理サービスの利用 | 既存製品・サービス | 既存の販売・在庫機能とつけの補助手段で一式を構成する | POS、在庫、つけ補助台帳、照合 |
52
+ | ALT-04 | 最小販売管理システムの個別構築 | 個別構築 | 店舗の記録項目と操作に合わせて一元化する | 販売登録、在庫、つけ残高、簡易一覧 |
53
53
 
54
54
  ## 3. 評価軸と評価基準
55
55
 
56
- D-01 の全案に次の軸を適用する。`High` / `Middle` / `Low` は採択に有利な順で、費用・期間・リスク・負荷は小さい方を高くする。判定材料がない場合は「未判定」とし、中間評価で代用しない。
56
+ `High` / `Middle` / `Low` は採択に有利な順。材料がなければ「未判定」とし、中間評価で代用しない。
57
57
 
58
- | 評価軸 | 判定基準(High / Middle / Low) | 根拠となる課題・制約 |
59
- | ------------------ | -------------------------------------------------------------------------------------------------------------------- | ---------------------------------- |
60
- | 効果 | 記録統一・残高検索・在庫低下把握の3能力を同じ記録から提供 / 2能力 / 1能力以下 | P-01〜P-03 |
61
- | コスト | 現金支出・参加者別作業時間がともに承認上限の80%以内 / ともに上限内だが一方が80%超 / 一方でも上限超。上限未決は未判定 | ACD-C02、管理計画 U-01・U-02 |
62
- | 期間 | 試行候補の準備が7日以内 / 8〜14日 / 14日超。上限承認と参加可能日の確認後の見積もりを使う | 比較上の2週間の目安、管理計画 U-03 |
63
- | リスク | 誤記録・停止・移行漏れの全経路で照合・回復を検証済み / 対策と担当・確認条件があるが未検証 / 対策のない経路がある | P-01・P-02、ACD-A02・D03 |
64
- | 業務適合 | 両利用者が必須タスクを支援なしで完了 / 支援付きで完了 / 一つでも完了不能。操作性もこの軸で判定する | P-01、現行手順とタブレット1台 |
65
- | 技術実現性 | 端末・移行・外部依存の成立を確認済み / 実現経路はあるが検証待ち / 成立しない依存がある | ACD-D01〜D04 |
66
- | データ移行・可逆性 | 元ノートとの全件照合と取り出し・紙への復元を検証済み / 方法を定義し検証待ち / 残高・履歴を復元する方法がない | P-02、既存ノート |
67
- | 運用・保守性 | 引き継ぎ・項目変更・回復を後任が単独で完了 / 手順はあるが支援を要する / 担当・手順を用意できない | P-01、小規模体制 |
58
+ | 評価軸 | 判定基準(High / Middle / Low) | 根拠となる課題・制約 |
59
+ | ------------------ | ------------------------------------------------------------------------------------------------------------ | ----------------------------- |
60
+ | 効果 | 記録統一・残高検索・在庫低下把握の3能力を同じ記録から提供 / 2能力 / 1能力以下 | P-01〜P-03 |
61
+ | コスト | 現金支出・作業時間がともに承認上限の80%以内 / ともに上限内だが一方が80%超 / 一方でも上限超。上限未決は未判定 | ACD-C02、U-01・U-02 |
62
+ | 期間 | 試行候補の準備が7日以内 / 8〜14日 / 14日超。上限承認後に見積もる | 2週間の目安、U-03 |
63
+ | リスク | 誤記録・停止・移行漏れの全経路で照合・回復を検証済み / 対策と確認条件があるが未検証 / 対策のない経路がある | P-01・P-02、ACD-A02・D03 |
64
+ | 業務適合 | 両利用者が必須タスクを支援なしで完了 / 支援付きで完了 / 一つでも完了不能(操作性を含む) | P-01、現行手順とタブレット1台 |
65
+ | 技術実現性 | 端末・移行・外部依存の成立を確認済み / 実現経路はあるが検証待ち / 成立しない依存がある | ACD-D01〜D04 |
66
+ | データ移行・可逆性 | 元ノートとの全件照合と取り出し・紙への復元を検証済み / 方法を定義し検証待ち / 残高・履歴を復元する方法がない | P-02、既存ノート |
67
+ | 運用・保守性 | 引き継ぎ・項目変更・回復を後任が単独で完了 / 手順はあるが支援を要する / 担当・手順を用意できない | P-01、小規模体制 |
68
68
 
69
- 「業務適合」は利用者の手順・体制への適合を指し、継続運用と保守の負荷は「運用・保守性」にまとめる。
70
-
71
- 重み付け・加重合計は用いない。効果・業務適合に `Low` がある案は主方式から外し、残る案を効果、業務適合、リスクの順で比較して試行対象を選ぶ。正式採用は全軸が `Middle` 以上、未判定なし、受入・試用条件合格を必要とする。総合評価は、このゲートの充足状況で示す。
69
+ 重み付け・加重合計は用いない。効果・業務適合が `Low` の案は主方式から外し、残りを効果、業務適合、リスクの順で比べて試行対象を選ぶ。正式採用は全軸が `Middle` 以上、未判定なし、受入・試用条件の合格を要する。総合評価はこのゲートの充足状況で示す。
72
70
 
73
71
  ## 4. 比較結果と採択理由
74
72
 
75
73
  ### 4.1. D-01: 業務・システム解決方式
76
74
 
77
- 本例の机上確認・模擬操作の結果は学習用の架空記録であり、実店舗での検証証跡ではない。効果は記録・一覧の対応、業務適合は両利用者による販売記録・在庫確認・残高確認の計6タスク、運用・保守性は引き継ぎ・項目変更・回復の確認結果から判定した。費用・日程の承認と実機受入は未了として扱う。
75
+ 結果は学習用の架空記録。業務適合は両利用者の販売・在庫・残高確認の計6タスクで判定した。
78
76
 
79
77
  | 案ID | 効果 | コスト | 期間 | リスク | 業務適合 | 技術実現性 | データ移行・可逆性 | 運用・保守性 | 総合評価 | 判定 |
80
78
  | ------ | ------ | ------ | ------ | ------ | -------- | ---------- | ------------------ | ------------ | ------------------ | -------- |
@@ -83,50 +81,46 @@ D-01 の全案に次の軸を適用する。`High` / `Middle` / `Low` は採択
83
81
  | ALT-03 | 未判定 | 未判定 | 未判定 | Low | 未判定 | Middle | 未判定 | 未判定 | 材料不足 | 保留 |
84
82
  | ALT-04 | High | 未判定 | 未判定 | Middle | High | Middle | Middle | Middle | 正式採用ゲート待ち | 比較試行 |
85
83
 
86
- ALT-04 を優先試行対象とし、ALT-01 の統一帳票を切り戻し候補として一部採択する。方式の選択と実運用の承認を分け、未決の費用・時間上限とオフライン方針を解消してから該当作業へ進む。
87
-
88
- | 案ID | 評価根拠と採否理由 | 再評価に必要な材料 |
89
- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------ |
90
- | ALT-01 | 3能力中、記録統一だけを提供し検索・在庫低下把握は手集計。模擬操作は6/6を自力完了。現行の紙で開始できるが、集計・変更は支援を要する | 検索・集計の負荷を軽減し、効果を2能力以上へ改善できた場合 |
91
- | ALT-02 | 記録統一と残高検索の2能力を提供。セル操作で1タスクを完了できず、数式の修正も後任単独では完了できなかった。保守性は手順の有効性と支援付きの完了を未確認のため未判定とする | 入力・保守手順と支援担当を用意し、両利用者と後任の同じ課題の完了可否・必要な支援を確認できた場合 |
92
- | ALT-03 | 公式資料で販売・在庫の実現経路は確認したが、つけ補助台帳との不一致に対策がない。店舗全体の効果・適合、料金、全記録の移行・撤退は未確認 | 費用上限確定後、つけ・照合・取り出しを含む一式の具体候補を確認した場合 |
93
- | ALT-04 | 記録と一覧の設計で3能力を提供し、操作模型では6/6を自力完了。保守は開発担当の支援を要する。リスク対策と移行・撤退方法は定義済みだが、実機では未検証 | 上限・日程承認後、実機と受入・試用結果で仮説を再判定する |
84
+ | 案ID | 評価根拠と採否理由 | 再評価に必要な材料 |
85
+ | ------ | ------------------------------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------- |
86
+ | ALT-01 | 記録統一だけを提供し、検索・在庫低下把握は手集計。6/6を自力完了 | 検索・集計を改善し効果を2能力以上にできた場合 |
87
+ | ALT-02 | 2能力を提供。1タスクを完了できず業務適合 `Low`。後任は数式修正を単独で完了できなかったが、手順と支援の有効性が未確認で保守性は未判定 | 入力・保守手順と支援担当を用意し、両利用者と後任が完了できた場合 |
88
+ | ALT-03 | つけ補助台帳との不一致に対策がない。効果・適合、料金は未確認 | 費用上限確定後、つけ・照合・取り出しを含む具体候補を確認した場合 |
89
+ | ALT-04 | 設計上3能力を提供し、操作模型で6/6を自力完了。保守は開発担当の支援を要する | 上限・日程承認後の実機・受入・試用の結果 |
94
90
 
95
91
  ### 4.2. 技術的実現性と影響
96
92
 
97
- | 案ID | 技術的実現性・外部依存 | 正本・移行・停止時の扱いと後続作業 |
98
- | ------ | ---------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
99
- | ALT-01 | 現行の紙を使えるが、統一帳票への残高移行の検証は残る | 統一帳票を正本にする。既存残高を照合して転記し、変更時は帳票を保存して新方式と照合する |
100
- | ALT-02 | 表計算で構成可能。端末 OS、共有権限と利用条件は実機確認待ち | 共有表を正本にする案。ノートとの照合後に一本化し、停止時は全記録を書き出して紙へ復元する検証が必要 |
101
- | ALT-03 | 販売・在庫は既存機能を利用可能。つけ補完、端末・接続と契約条件は未確認 | サービスとつけ補助台帳の正本境界・照合方法を製品比較で定義するまで採用しない。商品情報の出力だけで残高・履歴の撤退可能性を保証しない |
102
- | ALT-04 | 最小機能の構築経路はあるが、ACD-D01〜D04 の確認・判断が残る | 本稼働時はシステム記録を正本にする案。ノート残高を全件照合して移行する。停止時は記録を出力して紙へ復元し、二重入力の照合を検証する。構造・実装詳細は後続設計へ委譲する |
93
+ | 案ID | 技術的実現性・外部依存 | 正本・移行・停止時の扱い |
94
+ | ------ | ----------------------------------------- | ------------------------------------------------------------------------------------------------------------------------ |
95
+ | ALT-01 | 現行の紙を使える | 統一帳票を正本とし、既存残高を照合して転記する(未検証) |
96
+ | ALT-02 | 端末 OS、共有権限、利用条件は実機確認待ち | 共有表を正本とする。停止時は全記録を書き出して紙へ復元する(未検証) |
97
+ | ALT-03 | つけ補完、端末・接続、契約は未確認 | 正本境界・照合を製品比較で定めるまで採用しない。商品情報の出力だけで撤退可能とみなさない |
98
+ | ALT-04 | ACD-D01〜D04 の確認が残る | システム記録を正本とし、ノート残高を全件照合して移行する。停止時は出力して紙へ復元する(未検証)。構造・実装は後続設計へ |
103
99
 
104
100
  ### 4.3. 比較試行の完了条件
105
101
 
106
- - 入力と範囲: ALT-04 と ALT-01 に同じ架空の販売10件、入荷・在庫確認、つけ残高5件を用いる。`DEV` が候補版と操作メモをそろえ、`QE` が欠落・重複・残高差分と取り出し結果を照合する。
107
- - 完了と判定: 全件一致、欠落・重複0件、両利用者が必須タスクを完了した時点で机上評価を更新する。未達は是正後に再確認し、期間・承認上限内に解消できなければ `PO` が試行中止または範囲縮小を判断する。通信断・紙への切り戻しは ACD-D03 の運用方針と追加受入条件が決まるまで実運用しない。
108
- - 正式採用と記録: [[specdojo:prj-success-criteria-and-acceptance-criteria-sample|成功基準と受入条件]] の初期受入と2週間の試用継続条件を各段階で満たすことを確認する。`QE` は `kinuya-acceptance-record`、`BA` は `kinuya-trial-log` に D-01・案 ID・条件 ID・対象版・結果を残し、`PO` が採用・停止を判断する。成功条件の数値・測定方法は参照先を正とする。
102
+ - 入力と範囲: ALT-04 と ALT-01 に同じ架空の販売10件、入荷・在庫確認、つけ残高5件を用いる。
103
+ - 完了条件: 全件一致・欠落重複0件・両利用者の必須タスク完了で机上評価を更新する。期間・上限内に未達を解消できなければ中止または範囲縮小を判断する。通信断・紙への切り戻しは ACD-D03 の方針が決まるまで実運用しない。
104
+ - 正式採用と記録先: [[specdojo:prj-success-criteria-and-acceptance-criteria-sample|成功基準と受入条件]] の初期受入と2週間の試用継続条件を満たすこと。案 ID・条件 ID・対象版・結果を試行記録 `kinuya-trial-log`(未同梱の架空記録)に残す。
109
105
 
110
106
  ## 5. リスクとトレードオフ
111
107
 
112
- | 区分・対象 | 内容 | 軽減策・担当・完了条件 |
113
- | -------------------- | -------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
114
- | トレードオフ・ALT-01 | 検索・集計の手作業を受容する | `BA` が確認時間を試用記録へ残し、記録継続への影響を `PO` が判断する。主方式への転用は効果軸の再評価を条件とする |
115
- | リスク・ALT-02 | 誤入力・数式破損で残高を誤る | `DEV` が入力制限と保護・復元手順を用意し、`QE` が破損後の復元と元記録の一致を確認するまで採択を再検討しない |
116
- | リスク・ALT-03 | サービスとつけ補助台帳の不一致、取り出し不能 | `DEV` が候補製品の正本境界・照合・全記録出力を確認し、`QE` が差分0件と紙への復元を確認するまで製品選定を保留する |
117
- | トレードオフ・ALT-04 | 個別構築で設計・保守負荷を受容し、高度分析・外部連携を延期する | `PM` が初期対象に絞った作業と保守の見積もりを提示し、参加者別上限内・担当合意済みを準備着手の条件とする |
118
- | リスク・全案 | 記録停止・移行漏れでつけ残高を失う | `DEV` が移行・停止時の照合手順と ALT-01 の帳票控えの別保管を用意し、`QE` が復元後に元ノート全件と残高差分0件を確認する。通信断の扱いは ACD-D03 の判断に従う |
108
+ | 区分・対象 | 内容 | 軽減策・担当・完了条件 |
109
+ | -------------------- | ------------------------------------------------ | -------------------------------------------------------------------------------------------------------- |
110
+ | トレードオフ・ALT-01 | 検索・集計の手作業を受容する | `BA` が確認時間を試行記録へ残す |
111
+ | リスク・ALT-02 | 誤入力・数式破損で残高を誤る | `DEV` が入力制限と復元手順を用意し、`QE` が復元後の一致を確かめるまで再検討しない |
112
+ | リスク・ALT-03 | つけ補助台帳との不一致、取り出し不能 | `DEV` が全記録出力を確認し、`QE` が差分0件と紙への復元を確かめるまで製品選定を保留する |
113
+ | トレードオフ・ALT-04 | 設計・保守負荷を受容し、高度分析・外部連携を延期 | `PM` が作業と保守を見積もり、上限内・担当合意済みを準備着手の条件とする |
114
+ | リスク・全案 | 記録停止・移行漏れでつけ残高を失う | `DEV` が照合手順と ALT-01 の帳票控えの別保管を用意し、`QE` が復元後の元ノート全件で残高差分0件を確かめる |
119
115
 
120
116
  ## 6. 決定と見直し
121
117
 
122
- D-01 の現時点の判定は「比較結果と採択理由」のとおり。最終判断は人間の `PO` が行い、AI Agent は調査・比較分析・検証を支援する。`BA` は業務影響、`ARC` は技術制約、`DEV` は実装・移行、`QE` は条件と証跡を確認し、`PM` が後続作業を管理する。
123
-
124
- `PM` は上限・日程の決定、試行準備、初期受入、店頭試用、継続判断の順で `kinuya-schedule` に担当 Role・依存先・見積もり・期限・確認担当を置く。オフライン方針の判断待ちは既存の `PJR-KN01` へ接続する。`kinuya-` の記録名と `PJR-KN01` は管理計画・前提条件で用いる未同梱の架空記録であり、整備・承認済みの証跡ではない。
118
+ D-01 は ALT-04 を優先試行対象とし、ALT-01 の統一帳票を切り戻し候補として一部採択する(理由は「比較結果と採択理由」)。方式の選択と実運用の承認は分け、最終判断は `PO` が行う。
125
119
 
126
- | 見直し契機・管理区分 | 記録先と次の判断 |
127
- | ----------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
128
- | 試行・受入での不合格、2週間の記録継続・操作負担条件の未達(課題) | `PM` が [[specdojo:pm-issue-log-sample\|課題ログ]] に D-01・案 ID・是正担当・再確認期限を残し、`PO` が縮小・延期・停止を判断する |
129
- | 移行漏れ、端末・通信障害、保守担当不在の兆候(リスク) | `PM` が [[specdojo:pm-risk-register-sample\|リスク登録簿]] に対象案・兆候・軽減策を登録し、顕在化時は元の ID を付けて課題へ移す |
130
- | 承認上限、範囲、利用者・端末、外部依存の変更(変更要求) | `PM` が [[specdojo:pm-change-request-log-sample\|変更要求ログ]] に評価結果・影響・移行撤退方法を残し、該当カテゴリの全案を再比較する。特定製品を自動採用しない |
120
+ | 見直し契機 | 再評価 |
121
+ | --------------------------------------------- | -------------------------------------------------------- |
122
+ | 試行・受入の不合格、2週間の試用継続条件の未達 | 縮小・延期・停止を判断する |
123
+ | 移行漏れ、端末・通信障害、保守担当不在の兆候 | 対象案のリスク評価と軽減策を見直す |
124
+ | 承認上限、範囲、利用者・端末、外部依存の変更 | 該当カテゴリの全案を再比較する。特定製品を自動採用しない |
131
125
 
132
- 未決事項の判断は管理計画 U-01〜U-03 と `PJR-KN01`、採否・再評価の理由と判断者・判断日は該当する課題・変更要求へ付記し、独立した台帳へ二重転記しない。変更後は `PM` がスコープ、成功条件、設計・検証、Schedule への追従を計画し、次の影響作業の開始前に `QE` が整合を確認する。
126
+ 判断理由・影響範囲・移行と撤退の方法は決定記録に残す。
@@ -14,49 +14,46 @@ specdojo:
14
14
 
15
15
  ## 1. 判定対象と適用範囲
16
16
 
17
- 本書は、店頭販売、在庫、つけ管理の最小運用について、初期リリースの受入、運用開始後の短期的な定着、中長期の店舗運営への効果を判定する完成例である。EC、複数店舗管理、本格会計連携は対象外とする。
17
+ 店頭販売、在庫、つけ管理の最小運用を対象とし、EC、複数店舗管理、本格会計連携、費用低減は対象外とする。初期リリースの受入は SC-01 と AC-01〜AC-04 のすべてを必須とし、SC-02〜SC-06 は合否に含めない。確認者の「両代表」は店主代表と家族利用者代表を指す。
18
18
 
19
- 初期リリースの受入可否は SC-01 と AC-01〜AC-04 のすべてを必須条件として判断する。SC-02〜SC-06 はリリース後に評価し、初期受入の合否には含めない。
20
-
21
- 本例では、費用低減を業務価値や成功条件に含めない。SC-03 の操作負担は人の追加作業時間として判定し、導入費用や現金支出とは混同しない。
22
-
23
- | 業務価値 ID | 業務価値 | 主な判定段階 |
24
- | ----------- | -------------------------------------------------------------------------------------- | ------------------ |
25
- | BV-01 | 店主代表と家族利用者代表が、迷わず同じ手順で販売・在庫・つけ残高を記録・確認できる | 初期リリース |
26
- | BV-02 | 店主代表と家族利用者代表が、日々の記録を負担なく継続できる | 運用開始後の短期 |
27
- | BV-03 | 販売・在庫・つけの記録を仕入れ判断と引き継ぎに活用し、店主不在時も店舗運営を継続できる | 運用開始後の中長期 |
19
+ | 業務価値 ID | 業務価値 | 主な判定段階 |
20
+ | ----------- | -------------------------------------------------------- | ------------ |
21
+ | BV-01 | 店主と家族が同じ手順で販売・在庫・つけを記録・確認できる | 初期リリース |
22
+ | BV-02 | 日々の記録を負担なく継続できる | 短期 |
23
+ | BV-03 | 記録を仕入れと引き継ぎに使い、店主不在でも運営できる | 中長期 |
28
24
 
29
25
  ## 2. 成功基準
30
26
 
31
- | ID | 対応する業務価値 | 条件 | 判定基準 | 測定方法 | 判定時期 | 確認者 |
32
- | ----- | ---------------- | ---------------------------------- | -------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------- | ------------------ | ------------------------ |
33
- | SC-01 | BV-01 | 主要操作を迷わず完了できる | 店主代表と家族利用者代表が、販売記録、在庫確認、つけ残高確認の必須タスクをすべて完了し、重大な行き詰まりがない | 操作説明なしで代表シナリオを実施し、完了、所要時間、質問、支援、誤操作を記録する | 初期リリース受入時 | 店主代表、家族利用者代表 |
34
- | SC-02 | BV-02 | 日々の記録を継続できる | 初期運用の営業日の90%以上で、販売・在庫・つけの記録が残っている | 営業日ごとに3種の記録有無を確認し、営業日数を母数として集計する | 運用開始後2週間 | 店主代表 |
35
- | SC-03 | BV-02 | 記録・確認の負担を許容範囲に保てる | 1営業日の販売・在庫・つけの記録・確認にかかる追加操作時間が合計10分以内である | 初期運用期間に記録・確認の所要時間を営業日ごとに測定する | 運用開始後2週間 | 店主代表 |
36
- | SC-04 | BV-03 | 人気商品の欠品を減らせる | 対象商品の月間欠品回数が、運用開始前1か月のベースラインから50%以上減少する | 対象商品を固定し、運用前後の欠品発生を日次記録から月単位で比較する | 運用開始後6か月 | 店主代表 |
37
- | SC-05 | BV-03 | 在庫の無駄を減らせる | 廃棄・値引き・長期滞留による在庫の無駄が、運用開始前の年間換算値から20%以上減少する | 数量と金額を月次集計し、12か月実績を同じ定義のベースラインと比較する | 運用開始後12か月 | 店主代表 |
38
- | SC-06 | BV-03 | 店主不在時も店舗運営を継続できる | 店主不在の店番日の90%以上で、家族利用者代表が販売・在庫・つけの必須記録と引き継ぎを完了できる | 店主不在の店番日を母数として、必須記録と引き継ぎ結果を確認する | 運用開始後6か月 | 店主代表、家族利用者代表 |
27
+ | ID | 対応する業務価値 | 条件 | 判定基準 | 測定方法 | 判定時期 | 確認者 |
28
+ | ----- | ---------------- | -------------------------- | ------------------------------------------------------- | ---------------------------------------------------------------- | ------------------ | -------- |
29
+ | SC-01 | BV-01 | 主要操作を迷わず完了できる | 販売記録・在庫確認・つけ残高確認を両代表が完了する | 説明なしで代表シナリオを行い、所要時間・質問・支援・誤操作を記録 | 初期リリース受入時 | 両代表 |
30
+ | SC-02 | BV-02 | 記録を継続できる | 営業日の90%以上で販売・在庫・つけの記録が残る | 3種の記録有無を営業日ごとに集計 | 運用開始後2週間 | 店主代表 |
31
+ | SC-03 | BV-02 | 負担が小さい | 1営業日の追加操作時間が合計10分以内 | 記録・確認の所要時間を営業日ごとに測定 | 運用開始後2週間 | 店主代表 |
32
+ | SC-04 | BV-03 | 人気商品の欠品を減らせる | 対象商品の月間欠品回数が運用前1か月比で50%以上減る | 日次記録の欠品を月単位で比較 | 運用開始後6か月 | 店主代表 |
33
+ | SC-05 | BV-03 | 在庫の無駄を減らせる | 廃棄・値引き・長期滞留が年間換算で運用前から20%以上減る | 数量と金額の12か月実績を同じ定義のベースラインと比較 | 運用開始後12か月 | 店主代表 |
34
+ | SC-06 | BV-03 | 店主不在でも運営できる | 不在の店番日の90%以上で必須記録と引き継ぎを完了 | 不在日ごとに記録と引き継ぎを確認 | 運用開始後6か月 | 両代表 |
39
35
 
40
36
  ## 3. 受入条件
41
37
 
42
- | ID | 対応する業務価値 | 種別 | 条件 | 合格基準 | 証跡 | 確認者 | 承認者 |
43
- | ----- | ---------------- | ---------- | -------------------------------- | ------------------------------------------------------------------------------------------------- | ---------------------------------------- | ------------------------ | -------- |
44
- | AC-01 | BV-01 | 利用者視点 | 販売を記録できる | 商品、数量、支払方法を入力して販売を確定すると、販売記録が1件作成される | 販売記録、確認日、確認者、操作結果 | 店主代表、家族利用者代表 | 店主代表 |
45
- | AC-02 | BV-01 | 利用者視点 | 在庫とつけ残高を確認できる | 商品を指定して在庫数を確認でき、常連顧客を指定してつけ残高を確認できる | 在庫一覧、つけ残高確認結果 | 店主代表、家族利用者代表 | 店主代表 |
46
- | AC-03 | BV-01 | 利用者視点 | 主要操作で重大な行き詰まりがない | SC-01 の代表シナリオで、利用者が自力で回復できず必須タスクを継続できない事象が0件である | タスク一覧、所要時間、質問、支援、誤操作 | 店主代表、家族利用者代表 | 店主代表 |
47
- | AC-04 | BV-01〜BV-03 | 技術的受入 | 受入対象と確認結果を追跡できる | スコープ、成功基準、受入条件、操作メモが矛盾せず、各確認結果に条件 ID、確認日、確認者を記録できる | 文書照合記録、受入確認記録 | 開発担当 | 店主代表 |
38
+ | ID | 対応する業務価値 | 種別 | 条件 | 合格基準 | 証跡 | 確認者 | 承認者 |
39
+ | ----- | ---------------- | ---------- | -------------------------------- | --------------------------------------------------------------------------- | -------------------------- | -------- | -------- |
40
+ | AC-01 | BV-01 | 利用者視点 | 販売を記録できる | 商品・数量・支払方法を確定すると販売記録が1件できる | 販売記録、操作結果 | 両代表 | 店主代表 |
41
+ | AC-02 | BV-01 | 利用者視点 | 在庫とつけ残高を確認できる | 商品の在庫数と常連顧客のつけ残高を表示できる | 在庫一覧、つけ残高画面 | 両代表 | 店主代表 |
42
+ | AC-03 | BV-01 | 利用者視点 | 主要操作で重大な行き詰まりがない | SC-01 の代表シナリオで自力で回復できない事象が0件 | SC-01 の測定記録 | 両代表 | 店主代表 |
43
+ | AC-04 | BV-01〜BV-03 | 技術的受入 | 確認結果を追跡できる | スコープ・本書・操作メモが矛盾せず、結果ごとに条件 ID・確認日・確認者が残る | 文書照合記録、受入確認記録 | 開発担当 | 店主代表 |
48
44
 
49
45
  ## 4. 判定手順と証跡
50
46
 
51
- 1. 店主代表と家族利用者代表が SC-01 と AC-01〜AC-03 の代表シナリオを実施し、条件 ID、確認日、操作結果、必要な支援を記録する。
52
- 2. 開発担当が AC-04 の文書整合と証跡を確認する。
53
- 3. 未達の条件がある場合は、利用者への影響、是正内容、担当、再確認する条件 ID、再確認日を受入確認記録へ追記する。
54
- 4. 店主代表が SC-01 と AC-01〜AC-04 の結果を確認し、初期リリースの受入可否を判断する。
55
- 5. 運用開始後は、店主代表が SC-02〜SC-06 を所定の時期に判定し、未達の場合は運用または改善方針を見直す。
47
+ 確認者・承認者は各表に従い、結果は受入確認記録へ残す。
48
+
49
+ 1. 初期リリース受入時に SC-01・AC-01〜AC-03 の代表シナリオと AC-04 の文書照合を行う。
50
+ 2. 未達なら影響、是正内容、再確認の条件 ID と日を追記して再確認する。
51
+ 3. 承認者が必須条件の結果を照合し、受入可否を判断する。
52
+ 4. 運用開始後は SC-02〜SC-06 を判定時期に判定し、未達なら運用か改善方針を見直す。
56
53
 
57
54
  ## 5. 例外条件と未解決事項
58
55
 
59
- | 論点 | 扱い | 解決期限 / 判断タイミング | 責任者 |
60
- | ---------------------- | ----------------------------------------------------------------------- | ------------------------- | ------------------ |
61
- | 人気商品の対象範囲 | _UNDECIDED_: 欠品回数を測定する対象商品と除外条件を固定する | ベースライン測定開始前 | 店主代表 |
62
- | オフライン時の記録方法 | _UNDECIDED_: 初期受入の対象外とし、運用方針を決定後に受入条件を追加する | 初期運用開始前 | 店主代表、開発担当 |
56
+ | 論点 | 判定への影響 | 当面の扱い |
57
+ | ---------------------- | ------------------------------ | ----------------------------------------------------------------- |
58
+ | 人気商品の対象範囲 | SC-04 の測定。初期受入は進める | _UNDECIDED_: ベースライン測定開始前に対象商品と除外条件を固定する |
59
+ | オフライン時の記録方法 | 初期受入の対象外 | _UNDECIDED_: 初期運用開始前に運用方針を決め、受入条件を追加する |
@@ -12,44 +12,14 @@ specdojo:
12
12
 
13
13
  ## 1. 目的と対象範囲
14
14
 
15
- 販売・在庫・つけ・締めの業務ごとにシステムが担う記録と確認の範囲を確定し、店主代表がスコープを承認でき、業務からの漏れと機能の重なりを一覧で判断できるようにする。これは [[specdojo:prj-overview-sample|プロジェクト概要]] の「まず記録する」方針と、店番が交代しても同じ手順で記録を続ける目標に対応する。
16
-
17
- ### 1.1. 対象の境界
15
+ 店番が交代しても同じ手順で記録を続けるため([[specdojo:prj-overview-sample|プロジェクト概要]] の「まず記録する」方針)、販売・在庫・つけ・締めでシステムが担う記録と確認の範囲を確定する。店主代表はスコープと人間に残す判断、DEV は機能分割と実装範囲、QE はテスト対象の洗い出しに使い、業務からの漏れと機能の重なりを一覧で判断する。
18
16
 
19
17
  | 区分 | 範囲 |
20
18
  | ------ | -------------------------------------------------------------------------------------------------------------------------------------------- |
21
19
  | 対象 | 単一店舗の店頭タブレットで行う販売・つけ・在庫・締めの記録と確認。業務プロセス領域 `P-02`〜`P-10` のうち、システムが記録・算出・提示する部分 |
22
20
  | 対象外 | 仕入先への発注(`P-01`)、補充・つけ上限・売価の最終判断、キャッシュレス決済、本格会計、EC、複数店舗、個別機能の入出力・振る舞いの詳細 |
23
21
 
24
- 販売・在庫・つけの日々の記録を先行し、補充依頼支援と月次集計の導入時期は `Q-03` で決める。一覧に載せた全機能を初期リリースに含むとはみなさない。通信不能時の営業継続方針はプロジェクト概要の未決事項に従い、本一覧でオフライン販売を保証しない。
25
-
26
- ### 1.2. 読者・確認責任・公開範囲
27
-
28
- | Role | 本一覧の利用・確認責任 |
29
- | ---- | ---------------------------------------------------------------------------------------------------- |
30
- | BA | 一覧を保守し、店主代表・家族利用者代表と業務の漏れと人間に残す判断を確認する |
31
- | DEV | 機能分割と画面・データ設計、実装範囲を確認する。ARC の専門支援を受けて販売・在庫の責務境界を照合する |
32
- | QE | 機能 ID をテスト対象に対応付け、参照と未決事項の欠落を確認する |
33
- | PM | 参照先の整備と追従作業を成果物カタログ・Schedule に接続し、判断待ちを管理する |
34
- | PO | 人間の店主代表がスコープ、導入順序と公開可否を最終判断する |
35
-
36
- 採用ロールと兼務は [[specdojo:pm-organization-sample|組織定義]]・[[specdojo:pm-members-sample|メンバー定義]]、作業と承認の分担は [[specdojo:pm-raci-sample|RACI]] を正本とする。初期の技術作業は DEV が主導し、ARC を独立した Schedule タスクの主担当にはしない。
37
-
38
- 公開対象は店舗内の運用者と開発・レビュー担当とする。本例には実顧客の情報、認証情報、非公開の接続先を含めない。外部公開する場合は BA が匿名化した版を用意し、PO が公開範囲を確認する。
39
-
40
- ### 1.3. 一覧の完成判定
41
-
42
- 次表は内容レビューの合格条件であり、確認済みの結果ではない。確認結果と未充足の条件は `kinuya-sf-review`(本例に未同梱の架空レビュー記録)へ残す。
43
-
44
- | 確認担当 | 判定条件 | 確認する証跡 |
45
- | ----------------- | -------------------------------------------------------------------------------------------------- | ---------------------------------------------------------- |
46
- | BA | `P-01`〜`P-10` の全10領域について、機能への割当てまたはシステム化しない理由がある | 概念データフロー図の領域表と本書「機能構成」・主一覧の対応 |
47
- | DEV(ARC が支援) | 9件の機能 ID が一意で4領域の略号と一致し、販売・入荷から在庫への受け渡しと人間の判断が区別できる | 主一覧と表後の責務境界、個別機能仕様・画面仕様の照合結果 |
48
- | QE | 主一覧の必須6列が埋まり、実在参照は解決でき、仮置きの参照は `Q-01`・`Q-03` で追跡されている | 文書・参照の検査記録、機能 ID と後続テスト対象の対応 |
49
- | PM | 未決事項ごとに担当、判断時点、追跡先と保留する作業が特定されている | 未決事項と、整備後の成果物カタログ・Schedule・課題記録 |
50
- | PO | 各担当の確認結果から対象範囲・人間の判断・公開範囲を確認でき、承認範囲に未合意の責務が残っていない | レビュー記録と承認対象の範囲、除外した範囲の追従先 |
51
-
52
- 文書検査の成功だけでは承認しない。`Q-01`〜`Q-03` が承認対象に影響する間は `draft` を維持し、PO が対象範囲を承認するまで当該範囲の設計・受入を保留する。機能自体の正常・例外・回復の試験条件は個別仕様と後続のテスト仕様で定義する。
22
+ 一覧に載せた全機能を初期リリースに含むとはみなさない(導入順序は「未決事項」の `Q-03`)。本一覧でオフライン販売を保証しない。
53
23
 
54
24
  ## 2. 機能構成
55
25
 
@@ -78,30 +48,18 @@ specdojo:
78
48
  | `SF-CLS-01` | 日次締め照合 | 当日の販売・入荷・在庫・つけの記録を突き合わせ、差異を提示して締めの確定を記録する | `P-09` / `bps-daily-closing` | `uis-closing` | 一覧行で要約 |
79
49
  | `SF-CLS-02` | 月次集計報告 | 月次の売上・欠品回数・つけ残高を集計し、見直しの判断材料として提示する | `P-10` / `bps-monthly-review` | `uis-closing` | 一覧行で要約 |
80
50
 
81
- - `uis-credit-sale` はつけ販売とつけ精算(`SF-CRD-01`・`SF-CRD-03`)にまたがる。`uis-inventory` は在庫の 3 機能にまたがる。
82
- - `uis-closing` は日次締めと月次集計にまたがる。画面の数を機能数とせず、業務上の責務で行を分ける。
83
- - `SF-POS-01`・`SF-CRD-01` と `SF-INV-02` は、販売の払出数量と入荷数量を `SF-INV-01` へ渡す。在庫の算出・反映は在庫確認、現金販売の完了通知は店頭商品販売が担い、在庫未反映・結果不明を販売完了とは通知しない。詳細な回復条件は [[specdojo:sf-sample|商品販売機能仕様]] を正とする。
84
- - つけ上限超過時の販売可否、補充依頼の承認、締めの確定は店主代表に残す。システムは判断材料と判断結果を記録し、上限超過を自動承認する機能は数えない(`Q-02`)。
85
- - 個別仕様の完成例は店頭商品販売を参照し、在庫確認は作成候補とする。カタログ登録が未確認のため、作成判断と登録を `Q-03` で追跡する。その他は一覧行の要約を正とし、詳細化が必要になった時点でカタログへ登録してから作成する。
86
-
87
- 画面配置・入力形式は画面仕様、入出力・振る舞い・機能の受入条件は個別仕様、値・物理構造はデータの正本・schema へ委ねる。通常利用の接点は GUI とし、別の操作例である販売管理 CLI をこの一覧の利用接点には含めない。
51
+ - 画面は機能ごとに行を分ける。`uis-credit-sale` はつけ販売とつけ精算、`uis-inventory` は在庫の 3 機能、`uis-closing` は日次締めと月次集計にまたがる。
52
+ - `SF-POS-01`・`SF-CRD-01` の払出数量と `SF-INV-02` の入荷数量は `SF-INV-01` へ渡し、在庫の算出・反映は在庫確認が担う。在庫未反映・結果不明を販売完了とは通知しない(回復条件は [[specdojo:sf-sample|商品販売機能仕様]] を正とする)。
53
+ - 「人間に残す判断」は機能として数えず、システムは判断材料と結果を記録する。上限超過の扱いは `Q-02`。
54
+ - 個別仕様は店頭商品販売だけが完成例で、在庫確認は作成候補(`Q-03`)、その他は一覧行の要約を正とする。
55
+ - 通常利用の接点は GUI とし、販売管理 CLI は含めない。
88
56
 
89
57
  ## 4. 未決事項
90
58
 
91
- ### 4.1. 未照合・未決の対応
92
-
93
- 主一覧のリンクがない仕様 ID と以下の `kinuya-` で始まる参照名は、本例に未同梱の架空文書・記録である。追跡先は整備時の記録名を示す。PM が初回の範囲レビュー前に用意し、後続作業の担当・順序・期限は `kinuya-schedule` へ接続する。
94
-
95
- | ID | 論点と影響範囲 | 担当 / 判断者 | 判断時点・次アクション | 追跡先・承認への影響 |
96
- | ------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------- |
97
- | `Q-01` | _TODO_: 補充依頼確定以外の BPS と販売登録画面以外の画面仕様は未作成。全9機能の業務・接点対応は領域単位の暫定であり、商品販売機能仕様の上位一覧参照も未接続 | BA / PO(技術照合は DEV、ARC が支援) | 各 BPS・画面の作成時かつ当該機能の設計着手前に、概要と処理ステップを照合する。販売機能の上位一覧参照も接続する | `kinuya-issue-log/SF-01`。対応が未照合の機能の責務承認と設計着手を保留 |
98
- | `Q-02` | _UNDECIDED_: つけ上限を超える販売を店主代表の承認で許すか、システムで拒否するかが未決であり、`SF-CRD-01` の責務境界が確定しない | BA / PO | つけ販売の画面設計前に PO が運用方針を決定し、BA が BPS・本書の概要・人間に残す判断を更新する | `kinuya-issue-log/SF-02`。上限超過経路の設計・受入を保留 |
99
- | `Q-03` | _TODO_: 本一覧を管理する `kinuya-function-catalog` は未同梱であり、個別仕様の登録と導入順序が未確認。`sf-inventory` は候補で、補充依頼支援・月次集計の初期導入は未決 | PM・BA / PO(技術確認は DEV) | 初回の範囲レビュー前に PM がカタログと追跡先を整備し、BA が全機能の依存・個別仕様の要否を確認する。PO が初期と後続の範囲を分ける | `kinuya-issue-log/SF-03`。登録前の個別仕様作成と、導入範囲の承認を保留 |
100
-
101
- ### 4.2. 再照合と申し送り
102
-
103
- 上流 BPS・画面の作成や改訂、機能の追加・廃止・統合、個別仕様の追加を受けて BA が該当機能 ID を再照合する。販売・在庫の境界変更では DEV が ARC の支援を受けて画面・データ設計・schema・実装への影響を、QE がテスト対象と受入条件への影響を特定する。OPS の運用手順への助言は PM が取り込む。影響しない参照先にも非該当の理由をレビュー記録へ残す。
104
-
105
- 判断待ちで後続作業が止まる場合は、BA が機能 ID、影響する成果物・タスクと再開条件を PM へ渡す。PM は課題を `kinuya-issue-log`、範囲変更を `kinuya-change-request-log`、追従作業を `kinuya-schedule` で追跡し、本書には対応する参照を残す。
59
+ リンクのない仕様 ID は本例に未同梱の架空文書である。
106
60
 
107
- 廃止・統合時も機能 ID は再利用せず、旧 ID、理由、後継機能と参照元の付替え先をレビュー記録へ残す。文書の置き換え・廃止は [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] に従う。公開後の参照切れは BA、技術境界の矛盾は DEV・ARC、計画への影響は PM、スコープ・公開範囲の変更は PO に引き継ぐ。
61
+ | ID | 論点 | 影響と当面の扱い |
62
+ | ------ | ----------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------- |
63
+ | `Q-01` | _TODO_: 補充依頼確定以外の BPS と販売登録画面以外の画面仕様が未作成で、全9機能の業務・接点の対応は領域単位の暫定である | 各 BPS・画面の作成時に概要と処理ステップを照合する。照合までは当該機能の責務を確定扱いにせず、設計着手を保留する |
64
+ | `Q-02` | _UNDECIDED_: つけ上限を超える販売を店主代表の承認で許すか、システムで拒否するか | `SF-CRD-01` の責務境界が確定しない。決まるまで上限超過経路の設計・受入を保留する |
65
+ | `Q-03` | _TODO_: 個別仕様の成果物カタログ登録と導入順序が未確認。`sf-inventory` は候補で、補充依頼支援・月次集計の初期導入は未決 | 登録前の個別仕様は作成せず一覧行の要約を正とする。初期と後続の範囲が分かれるまで導入範囲を確定しない |