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
@@ -0,0 +1,67 @@
1
+ # yaml-language-server: $schema=../../../specdojo/schemas/v1/job.schema.yaml
2
+ id: job-sequence
3
+ name: 再開から検査までの順次実行
4
+ inputs:
5
+ resume_task:
6
+ type: string
7
+ required: true
8
+ track:
9
+ type: string
10
+ required: true
11
+ track_end_task:
12
+ type: string
13
+ required: true
14
+ schedule_state:
15
+ type: string
16
+ required: true
17
+ register_item:
18
+ type: string
19
+ required: true
20
+ register_ticket:
21
+ type: string
22
+ required: true
23
+ grade_path:
24
+ type: string
25
+ required: true
26
+ task:
27
+ mode: command
28
+ lock_wait_seconds: 3600
29
+ steps:
30
+ - id: resume
31
+ command: |
32
+ {{specdojo}} exec resume --project "{{project_id}}" --task "{{inputs.resume_task}}" --if-busy wait
33
+ {{specdojo}} exec refresh --project "{{project_id}}"
34
+ completion:
35
+ path: "{{inputs.schedule_state}}"
36
+ field: "tasks.{{inputs.resume_task}}.state"
37
+ succeeded: [done]
38
+ deferred: [todo, doing, blocked]
39
+ - id: auto-track
40
+ command: |
41
+ {{specdojo}} exec run --project "{{project_id}}" --auto --track "{{inputs.track}}" --loop --max-rounds 20 --if-busy wait
42
+ {{specdojo}} exec refresh --project "{{project_id}}"
43
+ completion:
44
+ path: "{{inputs.schedule_state}}"
45
+ field: "tasks.{{inputs.track_end_task}}.state"
46
+ succeeded: [done]
47
+ deferred: [todo, doing, blocked]
48
+ - id: register
49
+ command: >-
50
+ {{specdojo}} exec run --project "{{project_id}}"
51
+ --register "{{inputs.register_item}}" --worktree --if-busy wait
52
+ completion:
53
+ path: "{{inputs.register_ticket}}"
54
+ field: specdojo.item_status
55
+ succeeded: [review, closed]
56
+ deferred: [in-progress, waiting]
57
+ - id: grade
58
+ command: >-
59
+ {{specdojo}} grade run --project "{{project_id}}" --target deliverable
60
+ --path "{{inputs.grade_path}}" --run-id "{{job_run_id}}-grade" --if-busy wait
61
+ timeout_seconds: 7200
62
+ on_failure: continue
63
+ - id: docs-build
64
+ command: npm run docs:build
65
+ run:
66
+ idempotency_key: >-
67
+ {{job_id}}:{{scheduled_at}}:{{inputs.resume_task}}:{{inputs.track}}:{{inputs.track_end_task}}:{{inputs.schedule_state}}:{{inputs.register_item}}:{{inputs.register_ticket}}:{{inputs.grade_path}}
@@ -4,35 +4,113 @@ specdojo:
4
4
  type: project
5
5
  status: draft
6
6
  rulebook: specdojo:mip-index-rulebook
7
+ based_on: []
8
+ supersedes: []
7
9
  ---
8
10
 
9
- # 移行計画 サンプル
11
+ # 移行計画: 概要(駄菓子屋きぬや 販売管理システム)
10
12
 
11
- ## 1. 目的と適用範囲
13
+ ## 1. 移行の背景/目的
12
14
 
13
- 本書は、変更対象の移行方針と全体計画を定義し、切替リスクを管理するための最小サンプルである。
15
+ 駄菓子屋きぬやでは、販売・在庫・つけの記録をノートと店主の記憶に頼っており、記録漏れとつけ残高の確認の手間が生じている。本計画は、ノートの記録を店頭タブレットの販売管理システムへ移し、店主代表と家族利用者代表が同じ手順で販売・在庫・つけを記録できる状態にするまでの方針と判断点を定める。
14
16
 
15
- ## 2. 入力情報
17
+ 移行の成果は、つけ残高と現在庫を取りこぼさずにシステムへ移し、1 週間の並行記録の後にシステムの記録を正本として店舗運営を続けられることである。
16
18
 
17
- - 対象: 駄菓子屋の販売管理システム
18
- - 前提: プロジェクト文脈は handbook の共通方針に準拠する
19
- - 参照: `../rulebooks/mip-index-rulebook.md`
19
+ ## 2. 前提・制約
20
20
 
21
- ## 3. 記述内容
21
+ - 単一店舗・タブレット 1 台で運用する。移行作業もこの端末で行う。
22
+ - _ASSUMPTION_: 平日の午前は来店が少ないため、切替当日は午前に取り込みと動作確認を行い、下校時間に来店が増える午後から本番で利用する。閉店時間は変えない。
23
+ - 移行元は商品ノート、常連客ノート(顧客欄・つけ欄)、販売ノートの紙媒体である。電子データの移行元はない。
24
+ - 仕入先とのシステム連携、本格会計、過去の販売履歴の電子化は対象外とする。
25
+ - _UNDECIDED_: 切替日。店主代表が移行リハーサルの結果を見て決める。
22
26
 
23
- - 主な内容: 移行範囲、移行方式、体制、スケジュール、リスクと対策
24
- - 必須観点: 対象、条件、判定基準、責任者
27
+ ## 3. 移行方式と期間(方式/フェーズ/タイムライン)
25
28
 
26
- ## 4. 最小記述例
29
+ 並行移行とする。切替日から 1 週間はノートとシステムの両方に販売を記録し、ノートを正本として日次締めで突き合わせる。並行記録の差異が収まった時点で、システムの記録を正本に切り替える。
27
30
 
28
- | 項目 | 値 | 備考 |
29
- | ------------ | ---------------------------------------------------------- | ------------------------------------ |
30
- | ドキュメント | 移行計画 | 最小サンプル |
31
- | 目的 | 変更対象の移行方針と全体計画を定義し、切替リスクを管理する | specdojo:deliverables-reference 準拠 |
32
- | 主な内容 | 移行範囲、移行方式、体制、スケジュール、リスクと対策 | 要点のみ記載 |
31
+ | フェーズ | 期間 | 目的 | 成果物/完了条件 |
32
+ | ---------- | ------------------------ | ------------------------------------------------------------ | ---------------------------------------------------------------------------------------------- |
33
+ | 準備 | 切替日の 2 週間前から | 転記用の表に商品・顧客・つけ残高を書き写し、取り込みを試す | 転記用の表と元ノートの全件照合が済み、移行リハーサルで取り込みと照合が通っている |
34
+ | 最終棚卸 | 切替日の前日(閉店後) | 現在庫を数え直し、移行する在庫数を確定する | 全商品の現在庫を数えた結果を転記用の表へ記入し、店主代表が確認している |
35
+ | 移行・検証 | 切替日の午前 | 転記用の表を取り込み、件数と残高を元ノートと照合する | 商品・顧客の件数と、つけ残高の合計・顧客ごとの残高が元ノートと一致している |
36
+ | 並行記録 | 切替日の午後から 1 週間 | 販売をノートとシステムの両方に記録し、日次締めで突き合わせる | 各営業日の日次締めで、売上額とつけ残高合計の差異が 0 円であるか、差異の理由が記録されている |
37
+ | 正本切替 | 並行記録の最終日の閉店後 | システムの記録を正本にし、ノートへの記録をやめる | 店主代表が正本切替を承認し、以後の販売・つけの記録先をシステムだけにしたことを店番担当へ伝えた |
33
38
 
34
- ## 5. 未解決事項
39
+ ## 4. 移行対象一覧(スコープ/非対象)
35
40
 
36
- | 論点 | 処理方針 |
37
- | -------------- | ------------------------ |
38
- | 要件詳細の補強 | 実案件適用時に具体化する |
41
+ | 区分 | 対象 | 補足 |
42
+ | ------ | ---------------------------------------------------- | --------------------------------------------------------------------------------------- |
43
+ | 業務 | 店頭販売、つけ販売、つけ精算、在庫確認、日次締め | 並行記録の期間は、ノートとシステムの両方で行う |
44
+ | データ | 商品台帳(商品名、売価、補充基準、仕入先、発注単位) | 商品ノートから転記用の表へ書き写して取り込む |
45
+ | データ | 現在庫 | 切替日の前日に数えた最終棚卸の結果を移行する。入出庫の履歴は移さない |
46
+ | データ | 顧客台帳(常連客の氏名、連絡先、つけ上限)とつけ残高 | 常連客ノートから書き写す。つけ残高は顧客ごとの残高だけを移し、つけ販売の明細は移さない |
47
+ | 非対象 | 過去の販売ノート、仕入ノート、つけ販売の明細 | 紙のまま保管し、問い合わせ時に参照する。詳細の移行手順と照合方法は `dmd-index` で定める |
48
+ | 非対象 | 仕入先との連携、売上の会計処理 | 初期リリースの対象外であり、移行しない |
49
+
50
+ ## 5. 成功条件・受入基準
51
+
52
+ | 項目 | 基準 | 測定対象(対象データ/期間/業務) | 測定/証跡 | 判定者 | 失敗時の扱い(ロールバック/延期/代替手順) |
53
+ | -------------- | --------------------------------- | ----------------------------------------------------------------- | ---------------------------------------------- | -------- | ------------------------------------------------------------------------ |
54
+ | 業務停止時間 | 0 時間(開店時間を変えない) | 切替日の午前(取り込み・動作確認) | 移行作業の記録表に書いた開始・終了時刻 | 店主代表 | 午後の開店までに終わらなければ延期し、ノートだけで営業する |
55
+ | つけ残高の一致 | 顧客ごとの残高と合計の差異が 0 円 | 常連客ノートの全顧客(移行時点の残高) | 取り込み後に出力した残高一覧と元ノートの照合表 | 店主代表 | 差異のある顧客を直して取り込み直す。午前中に直らなければ延期する |
56
+ | 件数の一致 | 商品・顧客の件数差異が 0 件 | 商品台帳・顧客台帳(移行時点の全件) | 取り込み結果の件数と転記用の表の行数の照合表 | 開発担当 | 不足分を転記用の表へ追加して取り込み直す |
57
+ | 在庫数の一致 | 全商品で最終棚卸の数と一致 | 現在庫(切替日の前日に数えた数) | 取り込み後の在庫一覧と最終棚卸の記入表の照合表 | 店主代表 | 不一致の商品を直して取り込み直す |
58
+ | 並行記録の一致 | 売上額とつけ残高合計の差異が 0 円 | 並行記録の 1 週間の各営業日の日次締め(店頭販売・つけ販売・精算) | 日次締め記録の差異欄と、差異の理由のメモ | 店主代表 | 理由が分からない差異が残る日があれば並行記録を延ばし、正本切替を延期する |
59
+
60
+ GO/NO-GO(最低条件):
61
+
62
+ - 午後の開店前に、つけ残高・件数・在庫数の照合がすべて一致している。
63
+ - 店主代表と家族利用者代表が、移行後の端末で現金販売とつけ販売を 1 件ずつ記録できた。
64
+ - 正本切替は、並行記録の最終日の日次締めまで理由の分からない差異が残っていない。
65
+
66
+ ## 6. 体制・役割(GO判断含む)
67
+
68
+ | 役割 | 担当 | 責務 | 連絡/判断 |
69
+ | ----------------- | ---------------- | ---------------------------------------------------------------- | ------------------------------------------------------------------------ |
70
+ | GO 判断・正本切替 | 店主代表 | 照合結果を見て本番利用と正本切替を決める。最終棚卸の数を確認する | 延期と並行記録の延長も店主代表が決める |
71
+ | 移行実行 | 開発担当 | 転記用の表の取り込み、件数・残高・在庫数の照合表の作成 | 照合で差異が出たら店主代表へ伝え、直し方を相談する |
72
+ | 照合の確認 | 同行レビュー担当 | 照合表と元ノートを第三者の立場で読み合わせる | 読み合わせの結果を照合表に記入する |
73
+ | 並行記録の店番 | 家族利用者代表 | 並行記録の期間にノートとシステムの両方へ販売を記録する | 記録の食い違いに気付いたら、その場でメモを残し、日次締めで店主代表へ渡す |
74
+ | 技術支援 | 技術メンター | 取り込みの失敗や端末の不具合を切り分け、直し方を助言する | 午前中に直せない不具合は、延期を店主代表へ提案する |
75
+
76
+ ## 7. 移行リスクと対策
77
+
78
+ | リスク | 影響 | 対策 | 検知/判断 |
79
+ | ------------------------------------ | ---------------------------------------- | ------------------------------------------------------------ | -------------------------------------------------------------------------- |
80
+ | つけ残高の書き写し漏れ・誤記 | 常連客への請求の誤りと信用の低下 | 転記用の表と元ノートを同行レビュー担当が全件読み合わせる | 残高の照合表で差異がある顧客。店主代表が直し方と延期の要否を決める |
81
+ | 最終棚卸から切替までの販売の数え漏れ | 移行後の在庫数がずれ、補充の判断を誤る | 最終棚卸は前日の閉店後に行い、切替日の午前は販売しない | 在庫数の照合表。並行記録の日次締めで在庫差異が続く商品があれば数え直す |
82
+ | 並行記録の二重記録の負担 | 店番中の記録漏れと、差異の理由が残らない | 並行記録は 1 週間に限り、記録漏れはその場でメモを残す | 日次締めで理由の分からない差異が出たら、店主代表が並行記録の延長を判断する |
83
+ | 切替日の午前に作業が終わらない | 午後の開店で記録先が定まらない | 移行リハーサルで作業時間を測り、午前中に収まることを確かめる | 開店前に照合が終わっていなければ、店主代表が延期を決める |
84
+
85
+ ## 8. カットオーバー概要(当日タイムライン/判定点/ロールバック方針)
86
+
87
+ | 時刻(相対) | イベント | 完了条件 | 判定点 | 失敗時の扱い(ロールバック/延期/代替手順) |
88
+ | ---------------------- | -------------------------- | ----------------------------------------------- | ------ | ---------------------------------------------------------------------------- |
89
+ | T-1 日(閉店後) | 最終棚卸 | 全商品の現在庫を数えた結果を店主代表が確認した | GO1 | 延期(切替中止):数え終わらなければ切替日を延ばし、ノートで営業を続ける |
90
+ | T 当日(午前・開店前) | 転記用の表の取り込みと照合 | 件数・つけ残高・在庫数の照合がすべて一致した | GO2 | 代替手順:差異を直して取り込み直す(午前中に 1 回まで)。直らなければ延期 |
91
+ | T 当日(午前・開店前) | 動作確認 | 現金販売とつけ販売を 1 件ずつ記録し、取り消せた | GO3 | ロールバック:取り込んだデータを使わず、ノートだけで営業する |
92
+ | T 当日(午後・開店) | 本番利用と並行記録の開始 | 最初の販売をノートとシステムの両方に記録した | - | 代替手順:システムに記録できない販売はノートだけに記録し、日次締めで補記する |
93
+ | T+7 日(閉店後) | 正本切替 | 並行記録の最終日の日次締めで差異が残っていない | GO4 | 延期:並行記録を延ばし、ノートを正本のまま続ける |
94
+
95
+ ロールバック方針:
96
+
97
+ - 延期(切替中止):GO1・GO2 で失敗したら、切替を中止してノートだけで営業を続け、店主代表が切替日を決め直す。
98
+ - ロールバック(ノートへの復帰):GO3 で失敗したら、取り込んだデータを使わずノートで営業する。並行記録の期間中はノートが正本のため、システムを止めても記録は失われない。
99
+ - 当日の作業手順の詳細は `cop-index` に置く。
100
+
101
+ ## 9. 移行後ハイパーケア方針
102
+
103
+ | 項目 | 方針 |
104
+ | -------- | ----------------------------------------------------------------------------------------------------- |
105
+ | 期間 | 正本切替から 2 週間 |
106
+ | 体制 | 開発担当が閉店後の日次締めに立ち会い、店舗運営アドバイザーが店番の引継ぎで困った点を聞き取る |
107
+ | 対応範囲 | 記録の誤りの訂正、操作の分からない点の説明、端末の不具合の一次切り分け |
108
+ | 窓口/SLA | 店番中の困りごとは店主代表が受け、その日の閉店後までに開発担当が対応する |
109
+ | 旧ノート | 正本切替の後も、つけ残高の問い合わせに備えて店頭台帳保管棚に保管する。保管期間は `dmd-index` で定める |
110
+
111
+ 関連ドキュメント:
112
+
113
+ - `dmd-index`:データ移行設計(転記用の表、取り込み、照合の方法)
114
+ - `mtp-index`:移行リハーサル計画(作業時間の測定と照合の合否基準)
115
+ - `cop-index`:カットオーバー計画(切替日の作業手順と判定点)
116
+ - `otp-index`:運用切替計画(並行記録の運用と正本切替後の問い合わせ窓口)
@@ -13,34 +13,41 @@ specdojo:
13
13
 
14
14
  ## 1. 方針と適用範囲
15
15
 
16
- 店主、家族利用者、開発担当が、営業を妨げずに初期リリースと店頭試用を判断できるようにする。非同期の記録を基本とし、会議は利用者確認または意思決定が必要な場合だけ行う。役割や連絡先の一覧は各正本へ委譲する。
16
+ [[specdojo:pm-plan-sample|管理計画]] の判断ゲートと [[specdojo:prj-stakeholder-register-sample|ステークホルダー登録簿]] のコミュニケーション要件を、営業を妨げない確認・共有へ具体化する。Issue・Pull Request・チャットの非同期の記録を基本とし、対面は試用の準備と結果の聞き取りに限る。AI Agent は記録の整理と草案を支援し、合意・承認・公開は判断しない。
17
17
 
18
18
  ## 2. コミュニケーション機会
19
19
 
20
- | 対象・機会 | 伝える・確認する内容 | タイミング | 手段 | 責任 | 証跡 |
21
- | ---------------------- | ------------------------------------ | -------------------- | ----------------------- | ---- | ------------------ |
22
- | 店主への計画確認 | 対象範囲、試用日、費用・時間上限 | 着手前、重大変更時 | 対面または記録コメント | PM | 承認記録 |
23
- | 家族利用者との試用準備 | 操作方法、確認項目、困り事の伝え方 | 試用前 | 短時間の実演 | BA | 確認メモ |
24
- | 進捗共有 | 完了、次の作業、ブロック、必要な判断 | 節目または状態変化時 | Schedule と記録コメント | PM | Schedule、課題 |
25
- | 受入確認 | 受入条件、試験結果、未解決事項 | リリース前 | レビュー | QE | レビュー結果 |
26
- | 試用結果の確認 | 利用継続、追加負担、改善候補 | 試用終了時 | 店主・家族への聞き取り | BA | 試用結果、決定記録 |
20
+ | 対象・機会 | 伝える・確認する内容 | タイミング | 手段 | 責任 | 証跡 |
21
+ | -------------------------------------------------- | ----------------------------------------- | ---------------------------------------------------------------- | -------------------------- | ----- | ---------------------------- |
22
+ | `STH-SHOP-OWNER` への判断依頼 | 範囲・優先機能・UI の変更、費用・時間上限 | 準備着手前、管理計画の判断ゲート「重大変更・再開」に当たる変更時 | Issue(対面の結果も転記) | `PM` | Issue、変更要求ログの変更 ID |
23
+ | `STH-SHOP-OWNER` への進捗共有 | 完了、次の作業、ブロック、必要な判断 | 節目、ブロック発生時 | Schedule と Issue コメント | `PM` | `kinuya-schedule`、課題ログ |
24
+ | `STH-DEVELOPER` の実装結果の確認 | 機能範囲、テスト完了、設計と実装結果 | イテレーション末 | Pull Request、チャット | `DEV` | Pull Request |
25
+ | `STH-TECH-MENTOR` との設計相談 | データフローと画面構造案 | 週次 | チャット | `DEV` | Issue |
26
+ | `STH-FAMILY-USER` との試用準備 | 操作方法、確認項目、困り事の伝え方 | 試用前 | 簡易手順書と短時間の実演 | `BA` | Issue |
27
+ | `STH-SHOP-OWNER` の受入確認 | 受入条件、試験結果、未解決事項 | 初期リリース前 | Pull Request のレビュー | `QE` | `kinuya-acceptance-record` |
28
+ | `STH-SHOP-OWNER`・`STH-FAMILY-USER` の試用結果確認 | 継続可否、追加負担、改善候補 | 試用終了時 | 対面の聞き取り | `BA` | `kinuya-trial-log` |
27
29
 
28
30
  ## 3. エスカレーション
29
31
 
30
- | 条件 | 一次対応 | 最終判断 | 証跡 |
31
- | ------------------------------------ | ------------------------------- | -------- | ------------------ |
32
- | 利用者価値または受入条件が曖昧 | BA が事実と選択肢を整理する | PO | 確認メモ、決定記録 |
33
- | 費用・参加時間の上限を超える見込み | PM が縮小案と中止案を整理する | PO | 課題、決定記録 |
34
- | 品質、個人情報、公開適性に重大な懸念 | QE が対象を隔離し影響を整理する | PO | レビュー、決定記録 |
35
- | 範囲または試用日へ重大な影響 | PM が代替案と推奨案を整理する | PO | 変更要求、決定記録 |
32
+ | 条件 | 一次対応 | 最終判断 | 証跡 |
33
+ | ---------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------- | -------- | ------------ |
34
+ | 利用者価値または受入条件を登録簿・成功条件から判定できない | `BA` が事実と選択肢を整理する | `PO` | 課題ログ |
35
+ | 現金支出・作業時間が管理計画 M-03・M-04 の上限を超える見込み | `PM` が縮小案と中止案を整理する | `PO` | 変更要求ログ |
36
+ | 受入条件の未達、または検証できない Agent 出力 | `QE` が対象版と不足証跡を整理し、`PM` が是正を Schedule に置く | `PO` | 受入記録 |
37
+ | 顧客情報・認証情報が公開資料・一般共有チャネル・Agent 入力に出た、または公開物に権利・内部事情の懸念 | 発見者が共有を止め、`QE` が影響範囲を確認し、`PM` が判断材料を整理する | `PO` | 課題ログ |
38
+ | 範囲・上限・試用日の基準を変える要求 | `PM` が影響と代替案を整理する | `PO` | 変更要求ログ |
36
39
 
37
40
  ## 4. 情報管理と公開
38
41
 
39
- - 判断、課題、リスク、変更は、後から理由と次の行動を追える形で正本へ記録する。
40
- - 顧客の氏名、つけ残高、連絡先、認証情報は公開資料や一般共有チャネルへ記載しない。
41
- - 公開情報は匿名化し、店舗運営に不要な内部事情を含めない。
42
- - 口頭で決まった事項は、PM が決定記録または該当する正本へ反映する。
42
+ | 情報区分 | 取扱い | 記録先 |
43
+ | -------------------------------------- | ----------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
44
+ | 判断・課題・リスク・変更 | 理由と次の行動を付ける。口頭の決定は `PM` が転記する | [[specdojo:pm-issue-log-sample\|課題ログ]]、[[specdojo:pm-risk-register-sample\|リスク登録簿]]、[[specdojo:pm-change-request-log-sample\|変更要求ログ]] |
45
+ | 進捗・作業結果 | プロジェクト関係者で共有する | `kinuya-schedule`、Pull Request |
46
+ | 顧客の氏名・つけ残高・連絡先、認証情報 | 公開資料・一般共有チャネル・AI Agent の入力に含めない | プロジェクトの記録には残さない |
47
+ | 公開する事例・画面 | 匿名化し、店舗運営に不要な内部事情を除く。`PO` の公開判断を経て公開する | `kinuya-acceptance-record` の公開可否 |
43
48
 
44
49
  ## 5. 見直し条件と未決事項
45
50
 
46
- 参加者、試用方法、公開範囲、主な連絡手段が変わった場合に本計画を見直す。営業時間外の緊急連絡手段は、店頭試用の開始前に PO が決定する。
51
+ 参加者、判断ゲート、公開範囲、主な連絡手段が変わった場合に本計画を見直す。
52
+
53
+ - _UNDECIDED_: 営業時間外の緊急連絡手段。決まるまで営業時間外の停止連絡の伝達先が定まらない。店頭試用の開始前に `PO` が決定する。
@@ -2,7 +2,7 @@
2
2
  id: specdojo:pm-members-sample
3
3
  type: project
4
4
  status: draft
5
- title: メンバー名簿
5
+ title: "メンバー定義: 駄菓子屋きぬや 販売管理システム"
6
6
  rulebook: specdojo:pm-members-rulebook
7
7
  based_on:
8
8
  - specdojo:people-and-organization-definition-standard
@@ -14,21 +14,45 @@ project_id: prj-0001
14
14
  # agent 定義は repository 共通の .specdojo/agent-members.yaml に置く。
15
15
 
16
16
  members:
17
- - nickname: po
18
- display_name: Project Owner
17
+ - nickname: shop-owner
18
+ display_name: 店主代表
19
19
  email: null
20
- roles:
21
- - PO
22
- - PM
23
- - OPS
20
+ roles: [PO, OPS]
24
21
  type: human
25
- persona: final-decision-maker
26
22
  focus:
27
- - 目的、優先順位、公開可否の最終判断
28
- - 既存運用を変えすぎない範囲管理
29
- - agent 支援結果の承認判断
30
- scheduler_strategy: critical-first
31
- note: 人間の最終判断主体。小規模運用では管理と公開判断を兼務し、agent に承認責任を委ねない。
23
+ - 範囲、費用・参加時間上限、受入、公開・継続の最終判断
24
+ - 店頭運用と引き継ぎへの専門支援
25
+ note: 店舗の当事者として最終判断する。OPS の支援は PM が導入準備へ取り込み、初期は独立した owner にしない。
26
+ - nickname: developer
27
+ display_name: 開発担当
28
+ email: null
29
+ roles: [PM, BA, DEV]
30
+ type: human
31
+ focus:
32
+ - 作業順序・参加負荷の調整と業務・利用者確認
33
+ - 実装・データ設計と技術的な是正判断
34
+ note: 管理・業務確認・開発を兼務する。利用者の確認と QE の照合を受け、作業記録と判断記録を分ける。
35
+ - nickname: peer-reviewer
36
+ display_name: 同行レビュー担当
37
+ email: null
38
+ roles: [QE]
39
+ type: human
40
+ focus:
41
+ - 条件 ID と対象版・検証結果の照合
42
+ - 指摘の是正・再判定結果の確認
43
+ note: 開発担当の作業を第三者視点で確認し、受入・公開の判断材料を PO へ渡す。
44
+ - nickname: technical-mentor
45
+ display_name: 技術メンター
46
+ email: null
47
+ roles: [ARC]
48
+ type: human
49
+ note: DEV が主導する構成・設計に助言する。初期は独立した Schedule タスクの主責任を持たない。
50
+ - nickname: family-user-representative
51
+ display_name: 家族利用者代表
52
+ email: null
53
+ roles: [UX]
54
+ type: human
55
+ note: 家族の店番での操作・説明を確認し、BA へ専門支援として意見を渡す。内部 Role の承認責任は持たない。
32
56
 
33
57
  rules:
34
58
  - Schedule の owner には pm-roles.yaml に記載された Role code を使用し、member nickname は書かない。
@@ -13,35 +13,56 @@ specdojo:
13
13
 
14
14
  ## 1. 組織モデル
15
15
 
16
- 店主を人間の最終判断者とし、家族利用者、開発担当、必要に応じた AI Agent が協働する小規模な兼務体制とする。専任部署を前提にせず、次の責任領域が欠けないことを優先する。
16
+ 単一店舗・タブレット1台で販売、在庫、つけの記録を続けるため、専門部署を設けない兼務体制とし、店主代表が人間の `PO` を担う。
17
17
 
18
- | 責任領域 | 設計方針 | 最終判断 | 実行・確認 |
19
- | ---------- | ---------------------------------------- | -------- | -------------- |
20
- | 価値・業務 | 店舗課題、優先順位、利用継続を判断する | PO | BA、家族利用者 |
21
- | 計画・調整 | 作業順序、課題、費用・時間上限を管理する | PM | PM |
22
- | 実現・品質 | 実装、検証、是正、公開適性を分けて扱う | PO | DEV、QE |
18
+ | 責任領域 | 設計方針 | 最終判断 | 実行・確認 |
19
+ | ---------------- | ------------------------------------------------ | -------- | -------------------------------------------- |
20
+ | 価値・範囲 | 日々の記録を優先し、機能の追加と優先順位を決める | `PO` | `PM`(判断案の整理)、`BA`(業務観点の相談) |
21
+ | 業務・利用者確認 | 店主以外も同じ手順で販売・在庫・つけを扱えるか | `PO` | `BA` |
22
+ | 費用・参加負荷 | 費用と参加時間の上限を決め、超過する計画を見直す | `PO` | `PM` |
23
+ | 計画・調整 | 作業順序、進捗、課題・リスクを管理する | `PM` | `PM` |
24
+ | 実現・設計 | 実装・データ設計と技術的な是正 | `DEV` | `DEV` |
25
+ | 品質・受入 | 品質計画と試験結果から店頭試用の受入を決める | `PO` | `QE` |
26
+ | 公開・継続 | 導入準備、障害時の引き継ぎ、利用継続の可否 | `PO` | `PM`、`DEV` |
23
27
 
24
- AI Agent は草案、整理、実装、検証を支援できるが、費用、受入、公開、継続の最終判断は行わない。
28
+ 家族利用者は `BA` の操作確認で意見を出し、内部 Role の承認責任は持たない。兼務しても作業結果と承認の記録は分ける。AI Agent は草案、整理、実装、検証を支援し、最終判断は対応する Role の人間が行う。
25
29
 
26
30
  ## 2. ロール・owner方針
27
31
 
28
- - 使用可能な Role code は `pm-roles.yaml` を正本とする。
29
- - 人間の実行主体と兼務割り当ては `pm-members.yaml`、agent は `.specdojo/agent-members.yaml` を正本とする。
30
- - Schedule の `owner` には Role code だけを使用し、個人名や agent 名は使用しない。
31
- - 小規模運用では1人が複数ロールを兼務できるが、判断責任と作業責任は RACI 上で区別する。
32
+ | Role code | 採用/未採用 | `owner` 使用可否 | 判断理由・プロジェクトでの扱い |
33
+ | --------- | ------------ | ---------------- | -------------------------------------------------------------------- |
34
+ | `PO` | 採用 | 可 | 目的、上限、受入、公開・継続を店主代表が判断する |
35
+ | `PM` | 採用 | 可 | 店頭試用までの作業順序と参加負荷を管理する。初期は兼務 |
36
+ | `BA` | 採用 | 可 | 販売・在庫・つけの業務と、家族の店番時の確認を扱う |
37
+ | `DEV` | 採用 | 可 | 実装・データ設計と修正を主導する |
38
+ | `QE` | 採用 | 可 | 記録漏れや残高誤りを実装とは別の観点で検証する |
39
+ | `ARC` | 採用 | 不可 | 構成・データ管理方針の専門支援。設計作業は `DEV` が主導する |
40
+ | `UX` | 採用 | 不可 | 画面文言と操作説明の専門支援。利用者確認は `BA` が主導する |
41
+ | `OPS` | 採用 | 不可 | 導入・障害時対応・引き継ぎの専門支援。リリース準備は `PM` が主導する |
32
42
 
33
- ## 3. 正本と責任境界
43
+ 未採用の標準ロールと独自ロールはなし。使用可能な `owner` は「可」の5ロールで、初期 RACI の列もこの5ロールとする。専門支援3ロールの意見は主導ロールが作業結果へ取り込む。
34
44
 
35
- | 情報 | 正本 |
36
- | ---------------------- | ------------------------------ |
37
- | Role code と責務 | `pm-roles.yaml` |
38
- | 人間の実行主体と兼務 | `pm-members.yaml` |
39
- | agent の実行主体 | `.specdojo/agent-members.yaml` |
40
- | 成果物・判断の責任 | `pm-raci.md` |
41
- | 関係者の関心・情報要求 | ステークホルダー登録簿 |
45
+ ## 3. 正本と責任境界
42
46
 
43
- 本書には人物一覧や詳細な RACI を複製しない。
47
+ | 情報 | 正本 | 本書で扱うこと |
48
+ | -------------------------------------- | ---------------------------------------------------------------------------- | ---------------------------------- |
49
+ | Role・Member・`owner`・RACI の共通定義 | [[specdojo:people-and-organization-definition-standard\|人と組織の定義標準]] | 店舗規模に応じた適用判断 |
50
+ | 採用ロールの機械可読な定義 | [[specdojo:pm-roles-sample\|ロール定義]] | 8ロールの採用結果との整合 |
51
+ | 人間の実行主体と兼務 | [[specdojo:pm-members-sample\|メンバー定義]] | 責任領域の欠落と負荷集中 |
52
+ | agent の実行主体 | `.specdojo/agent-members.yaml`(利用する repository で整備) | 支援範囲と人間の判断責任の境界 |
53
+ | 成果物・主要判断の責任 | [[specdojo:pm-raci-sample\|RACI]] | 組織モデルとの整合 |
54
+ | 関係者の関心・情報要求 | [[specdojo:prj-stakeholder-register-sample\|ステークホルダー登録簿]] | 内部 Role と利用者による確認の区別 |
44
55
 
45
56
  ## 4. 見直し条件
46
57
 
47
- 参加者の増減、兼務による滞留、新しい責任領域、公開・運用責任の発生時に見直す。見直し時も、人間の PO に最終判断を残し、必要な責務から先に分離する。
58
+ `PM` が週次の進捗確認と変更要求の受付時に確認する。Role や専任者を増やす前に、兼務の割り当てと作業順序の変更で足りるかを検討する。
59
+
60
+ | トリガー | 確認すること | 更新先 | 判断者 |
61
+ | -------------------------------------------------- | ---------------------------------------------------------- | ---------------------------------------------------------------- | -------------------------------------------- |
62
+ | 参加・離脱・交代の申出 | 担当できなくなる責任と引き継ぎ先 | メンバー定義、RACI、Schedule。責任境界が変われば本書・ロール定義 | 再配置は `PM`、採用・`owner` 使用可否は `PO` |
63
+ | 兼務による作業・承認待ちで Schedule の期限を超えた | 止まったのが実作業か承認か、分担で解消できるか | メンバー定義、RACI、Schedule。分離する場合は本書 | 作業順序は `PM`、費用・参加時間上限は `PO` |
64
+ | スコープ変更、成果物追加、専門支援の独立タスク化 | 業務・設計・確認範囲への影響、既存ロールで主導できるか | 本書、ロール定義、メンバー定義、RACI、WBS、Schedule | `PO` |
65
+ | 店頭試用・公開の候補、運用範囲の変更 | 導入・復旧・引き継ぎの実施担当と人間の承認者に欠落がないか | 本書、RACI、メンバー定義、Schedule、ステークホルダー登録簿 | `PO` |
66
+ | AI Agent の追加・削除、支援権限の変更 | 承認を委ねていないか、人間へ引き継げるか | agent 定義、本書、RACI、Schedule | `PO` |
67
+
68
+ 採用・使用可否を変えたら、`QE` が使用不可ロールの `owner`、採用外の RACI 列、引き継ぎ先のないタスクが残っていないことを確かめて見直しを閉じる。
@@ -15,43 +15,95 @@ specdojo:
15
15
 
16
16
  ## 1. 管理目的と適用方針
17
17
 
18
- 販売・在庫・つけ管理の初期リリースと2週間の店頭試用を、店主と家族が無理なく判断・実行できるように管理する。小規模案件向けの軽量運用とし、詳細は各正本へ委譲する。AI Agent は草案や検証を支援できるが、費用、範囲、受入、公開の最終判断は人間の PO が行う。
18
+ 店主代表と家族利用者代表が同じ手順で販売・在庫・つけを記録・確認でき、日々の記録を無理なく続けられることを検証する。管理対象は初期リリースの準備から2週間の店頭試用終了までとし、中長期の効果測定は運用前に基準値を準備し、運用後の観測・比較を継続判断で後続作業へ引き継ぐ。
19
+
20
+ 価値と単一店舗・タブレット1台の前提は [[specdojo:prj-overview-sample|プロジェクト概要]]、対象業務と期間は [[specdojo:prj-scope-sample|プロジェクトスコープ]]、判定条件は [[specdojo:prj-success-criteria-and-acceptance-criteria-sample|成功基準と受入条件]](以下「成功条件」)、費用・参加負荷と見直し条件は [[specdojo:pm-organization-sample|組織定義]] を正本とし、成功条件の数値・測定方法を本書で再定義しない。
21
+
22
+ 兼務体制で判断待ちと参加負荷を把握できるよう、統合表と判断ゲートによる軽量プロファイルを採用する。外部契約、有償運用、複数店舗化の提案時は、`PM` が費用・技術依存・責任への影響を整理し、人間の `PO` が個別計画を足す拡張プロファイルへの移行を判断する。
19
23
 
20
24
  ## 2. 統合管理方針
21
25
 
22
- | 管理対象 | 基準・上限 | 確認契機 | 逸脱時対応 | 責任 |
23
- | ------------------ | -------------------------------------------------------------- | ---------------------------------- | ----------------------------------------- | ---- |
24
- | スコープ | 初期対象は販売・在庫・つけ管理。EC、会計連携、複数店舗は対象外 | 追加要望の発生時 | 変更要求として影響を整理する | PM |
25
- | スケジュール | 初期リリース後に2週間の店頭試用を行う | 節目または後続作業へ影響する遅延時 | 優先順位と試用日を再計画する | PM |
26
- | 現金支出 | PO が着手前に承認した上限内 | 有償サービスの追加前 | 無償代替、範囲縮小、中止を比較する | PO |
27
- | 参加者の時間 | 店舗営業や学業を圧迫しない。日常操作の追加負担は1日10分以内 | 試用準備時と試用中 | 機能または確認手順を減らす | PM |
28
- | 品質 | 初期受入条件と短期成功基準を満たす | リリース前と試用終了時 | 是正後に再判定する | QE |
29
- | 課題・リスク・変更 | 判断者、期限、次の行動を記録する | 発生または顕在化時 | PO 判断が必要な事項をエスカレーションする | PM |
26
+ 記録先は「正本・報告・見直し」を正とし、証跡の列は識別方法だけを示す。
27
+
28
+ | 管理 ID・対象 | 根拠・基準・上限 | 確認契機 | 逸脱時対応 | 責任 | 証跡の識別 |
29
+ | ------------------------- | ----------------------------------------------------------------------- | ---------------------------------------------- | ------------------------------------------------------------------ | ----- | ---------------------------------------------------- |
30
+ | M-01 スコープ | スコープの「境界の判断基準」内で BV-01・BV-02 を優先 | 追加・削除要望の受付時 | `PM` が延期・除外とセットで変更要求を起案。承認前に追加しない | `PM` | 変更 ID・対象範囲・条件 ID・決定 |
31
+ | M-02 スケジュール | 準備・受入確認の後に2週間の店頭試用。具体日は U-03 の決定後に基準化する | 週次、節目、遅延・依存変更時 | 再計画する。承認済みの日付の変更は `PO` へ上げる | `PM` | タスク ID・基準日・依存先・進捗 |
32
+ | M-03 現金支出 | U-01 の上限内。未決中は支出を伴う作業を始めない | 購入・有償サービス追加前、見込み更新時 | 無償代替・縮小・中止を、時間への転嫁と併せて `PO` へ判断依頼 | `PM` | M-03・支出日・金額・承認記録 |
33
+ | M-04 準備・開発の作業時間 | U-02 の参加者別上限内。店舗営業・学業の時間を前提にしない | 見積もり時、週次、超過見込み時 | 縮小案を示す。現金支出の削減で負荷を許容しない | `PM` | M-04・参加者・作業 ID・見積もりと実績 |
34
+ | M-05 日常操作の継続負荷 | SC-03 を満たす。記録継続は SC-02 で確認 | 試用中の各営業日、試用終了時 | `PM` が機能・手順の縮小を起案。未達は継続ゲートへ | `PM` | SC-02・SC-03・営業日・確認者・追加操作時間 |
35
+ | M-06 保守・引き継ぎ負荷 | 担当と所要時間見込みを `PO` が作業前に確認できること | 障害対応・店番交代の準備時、試用終了時 | 未割当なら作業を保留し、分担・手順縮小・利用停止の案を示す | `PM` | M-06・担当・作業日・時間・課題 ID。M-05 に合算しない |
36
+ | M-07 品質 | SC-01・AC-01〜AC-04 を初期受入、SC-02・SC-03 を試用継続の必須条件とする | 各判断ゲート前、是正後 | 「判断ゲートとエスカレーション」の未達時の対応 | `QE` | 条件 ID・対象版・確認日・確認者・結果 |
37
+ | M-08 構成管理 | AC-04。承認済みの範囲・条件・操作メモと受入対象の版を照合できること | 基準の承認・変更時、候補版の提示時 | `DEV` が不一致を特定し `QE` が再確認。未照合の版を受入済みにしない | `PM` | 基準 ID・文書 ID と版・対象版・変更 ID |
38
+ | M-09 技術制約・外部依存 | 概要の「前提条件」。端末・接続・外部サービスの変更を影響評価できること | 依存追加、端末・接続条件変更、通信不能の検知時 | `DEV` が技術メンターの助言を含め整理。範囲・費用の変更は `PO` へ | `DEV` | 依存 ID・変更日・影響条件 ID・課題/変更 ID |
39
+ | M-10 課題・リスク・変更 | 各事項に担当 Role、期限、次の行動、影響する管理 ID・条件 ID があること | 発生、兆候検知、顕在化、状態変更時 | 各管理簿へ分け、判断待ちを Schedule の依存にする | `PM` | 課題・リスク・変更 ID と判断者・理由・判断日 |
30
40
 
31
41
  ## 3. 判断ゲートとエスカレーション
32
42
 
33
- | ゲート | 判断条件 | 判断材料 | 起案・整理 | 最終判断 | 証跡 |
34
- | -------------- | ---------------------------------------- | --------------------------- | ---------- | -------- | ---------------------- |
35
- | 初期リリース | 初期成功基準と受入条件を満たす | 試験結果、未解決事項 | QE、PM | PO | レビュー結果、決定記録 |
36
- | 店頭試用の継続 | 記録継続と日常負担が許容範囲内 | 2週間の利用記録、利用者所感 | BA、PM | PO | 試用結果、決定記録 |
37
- | 重大変更 | 範囲、費用、試用日、利用者価値へ影響する | 影響、代替案、推奨案 | PM | PO | 変更要求、決定記録 |
43
+ 各条件の合否・測定方法は成功条件を正とする。SC-02〜SC-06 は初期受入の合否に混ぜず、測定期間が来る前に合格扱いにしない。
44
+
45
+ | ゲート | 判断条件 | 判断材料 | 起案・整理 | 最終判断 | 証跡 |
46
+ | -------------------------- | ------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------- | ----------------------------------- | ----------- | ----------------------------------------- |
47
+ | 準備着手 | U-01・U-02 が決定済みで見込みが上限内。U-03 の候補日と担当の参加可能日が整合する | 上限承認、参加者別見積もり、Schedule の依存・候補日 | `PM` | 人間の `PO` | 上限の承認記録と Schedule の候補日 |
48
+ | 初期リリース・店頭試用開始 | SC-01・AC-01〜AC-04 が全て合格。M-03・M-04 が上限内で、実運用前の未決事項が解消し、SC-04・SC-05 の照合が完了 | 条件 ID ごとの受入結果、対象版、支出・作業記録、基準値の照合記録 | `QE`、`PM` | 人間の `PO` | 受入記録の合否、公開可否、根拠、判断日 |
49
+ | 店頭試用後の継続 | SC-02・SC-03 が合格し、保守・引き継ぎを引き受けられる。SC-04〜SC-06 は後続観測を割り当てる | 営業日別記録、追加操作時間、保守実績、利用者所感 | `BA`、`PM`(`QE` が条件結果を照合) | 人間の `PO` | 試用記録の継続/停止判断と改善の課題 ID |
50
+ | 重大変更・再開 | M-01〜M-09 の基準変更の影響・代替案・再確認条件がそろう。再開は是正の証跡がそろう | 変更要求、縮小/延期/中止案、影響条件と対象版、再計画 | `PM` | 人間の `PO` | 変更 ID・判断者・理由・判断日と追従タスク |
38
51
 
39
- 品質・費用・個人情報に重大な懸念がある場合、担当ロールは作業を止め、PM が PO の判断材料を整理する。
52
+ | 場面 | 対応 |
53
+ | -------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
54
+ | 必須条件の未達・証跡不足 | `QE` が不足材料・是正・再確認日を記録し、`PO` がゲートを保留して再判定する。免除の例外は設けない |
55
+ | 範囲・基準の変更が必要 | 変更要求の承認を先に得る。旧条件の未達結果も保持する |
56
+ | 上限超過見込み、主要操作不能、記録の不整合、個人情報・公開適性の重大な懸念 | 担当が作業・利用を止めて `PM` へ報告し、`PM` が代替案と期限を整理して、次の支出・利用・公開より前に `PO` へ判断を求める |
40
57
 
41
58
  ## 4. 正本・報告・見直し
42
59
 
43
- | 情報 | 正本 | 更新・報告契機 | 主な確認者 |
44
- | ------------------------ | ---------------------- | ---------------------- | ---------- |
45
- | 目的・範囲・成功条件 | プロジェクト定義成果物 | 基準変更時 | PO、PM |
46
- | 作業順序・担当 | Schedule | 節目、遅延、依存変更時 | PM |
47
- | 課題・リスク・変更・決定 | プロジェクト登録簿 | 発生時、状態変更時 | PM、PO |
48
- | 品質結果 | レビュー・試験記録 | 各判断ゲート前 | QE、PO |
49
- | 費用・参加時間 | 支出・作業記録 | 上限接近時、試用終了時 | PM、PO |
60
+ ### 4.1. 更新先と報告
61
+
62
+ `kinuya-` で始まる記録は未同梱の架空記録とする。未整備なら整備を先行タスクとし、口頭合意でゲートを通さない。
63
+
64
+ | 情報 | 正本と整備 | 更新・報告契機 | 主な確認者 |
65
+ | ---------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------ | ------------------------- |
66
+ | 目的・範囲・条件 | 「管理目的と適用方針」の正本 | 基準変更時、ゲート前に `BA` が提示 | `PO`、`QE` |
67
+ | 作業順序・Task owner・進捗 | `kinuya-schedule`(`PM`)。U-03 決定後に基準日を確定 | 週次、節目、遅延・依存変更時 | `PM` |
68
+ | 成果物・主要判断の責任 | [[specdojo:pm-raci-sample\|RACI]] | 成果物追加、承認責任変更時 | `PM`、`PO` |
69
+ | Role・実行主体・兼務 | [[specdojo:pm-roles-sample\|ロール定義]]、[[specdojo:pm-members-sample\|メンバー定義]] | 参加・離脱・交代、兼務負荷変化時 | `PM`、`PO` |
70
+ | 課題・リスク・変更・決定 | [[specdojo:pm-issue-log-sample\|課題ログ]]、[[specdojo:pm-risk-register-sample\|リスク登録簿]]、[[specdojo:pm-change-request-log-sample\|変更要求ログ]]。決定は該当記録に付記 | 発生・状態変更時、判断期限前 | `PM`、判断する人間の Role |
71
+ | 品質・受入・試用結果 | [[specdojo:pm-quality-management-plan-sample\|品質管理計画]]、`kinuya-acceptance-record`(`QE`)、`kinuya-trial-log`(`BA`) | 確認・是正時、ゲート前 | `QE`、`PO` |
72
+ | 現金支出・作業時間・継続負荷 | `kinuya-cost-and-effort-log`(`PM`)。M-03・M-04・M-06 を別区分にする | 支出・作業発生時、上限接近時、試用終了時 | `PM`、`PO` |
73
+ | 基準と対象版・技術依存 | `kinuya-baseline-log`(`PM`)、`kinuya-technical-dependency-log`(`DEV`) | 基準承認、候補版提示、依存・端末条件変更時 | `QE`、`DEV` |
74
+ | 共有・判断依頼 | [[specdojo:pm-communication-plan-sample\|コミュニケーション計画]] | 節目・判断待ち・停止時 | `PM`、`PO` |
75
+
76
+ 承認責任は Schedule の `owner` でなく RACI を正とする。
77
+
78
+ ### 4.2. 運用前の準備
79
+
80
+ `PM` は次の作業を `kinuya-schedule` に置く。在庫の無駄の定義は概要の「期待効果」と SC-05 に従う。
81
+
82
+ | 条件 | 先行作業と依存 | 作業時間の仮見積もり | 完了の証跡(`kinuya-trial-log`) |
83
+ | ----- | ------------------------------------------------------------------------------------------------- | ---------------------- | ---------------------------------------------------------------------------- |
84
+ | SC-04 | `PO` が対象商品を確定 → `BA` が運用開始前1か月の日次欠品を採取 → `QE` が照合 | `BA` 4時間、`QE` 1時間 | 対象商品・営業日別の記録、欠測の確認結果、照合日・確認者 |
85
+ | SC-05 | `BA` が運用開始前1か月の廃棄・値引き・長期滞留の数量・金額を採取 → 月次集計と年換算 → `QE` が照合 | `BA` 4時間、`QE` 1時間 | 対象月の原記録、月次集計、年換算値と算定根拠、欠測の確認結果、照合日・確認者 |
86
+
87
+ _ASSUMPTION_: 時間は初期見積もりで、1か月の採取期間とは別に扱う。`PM` の依存・リスク整備は両条件で計1時間とし、M-04 の見積もりに含める。既存記録で対象月を確認できなければ、採取期間を確保して U-03 の候補日を組み直す。
88
+
89
+ `PM` は比較期間を失うリスクを条件 ID ごとに登録し、採取担当・期間の事前確保と週次の欠測確認で軽減する。基準値がそろわなければ `PO` が試用開始の延期か測定条件の変更を判断する。
90
+
91
+ ### 4.3. 変更時の追従
92
+
93
+ 目的、範囲、条件、上限、体制、外部条件が変わったら、`PM` が変更 ID に影響先を結び、担当・期限・確認担当付きの追従タスクを次の順で作る。追従は影響する作業の開始前に終える。
50
94
 
51
- 本計画は、価値仮説、初期範囲、成功基準、費用・時間上限、体制のいずれかが変わったときに見直す。
95
+ | 変更の例 | 更新順序と担当 | 完了の確認 |
96
+ | ---------------------------------- | -------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------- |
97
+ | 在庫機能の追加や条件変更 | `PO` の範囲判断 → `BA` のスコープ・成功条件 → `DEV` の設計・実装影響 → `QE` の品質計画・試験 → `PM` の基準・Schedule | `QE` が条件 ID・対象版の再確認を照合し、`PO` が再判定 |
98
+ | 承認担当の交代、兼務での滞留 | `PM` が組織定義の見直しを起案 → `PO` が採用・使用可否を判断 → `PM` がロール・メンバー定義、RACI、Schedule を更新 | `QE` がゲートの判断者、RACI、引き継ぎ先を照合 |
99
+ | 上限・試用日・端末や接続条件の変更 | `DEV` が技術依存、`BA` が利用者影響、`PM` が費用・負荷を評価 → `PO` が判断 → 各正本と Schedule・基準へ反映 | `QE` が影響条件の再確認と旧版参照の解消を照合 |
52
100
 
53
101
  ## 5. 未決事項
54
102
 
55
- | 論点 | 決定期限 | 判断者 |
56
- | ------------------------------------ | ------------------ | ------ |
57
- | 現金支出と試用準備時間の具体的な上限 | 初期リリース着手前 | PO |
103
+ | 論点 | 当面の扱い | 決定で変わる管理行・ゲート |
104
+ | ------------------------------------- | -------------------------------------------------------------------------------------------------- | ------------------------------------------ |
105
+ | U-01 現金支出上限 | _UNDECIDED_: `PM` が見込みと無償代替を提示する。支出を伴う着手を保留 | M-03、準備着手 |
106
+ | U-02 準備・開発の参加者別作業時間上限 | _UNDECIDED_: `PM` が見積もりを提示する。SC-03 で代替せず、未承認の割り当てを保留 | M-04、準備着手 |
107
+ | U-03 初期リリース・店頭試用の具体日 | _UNDECIDED_: 準備着手前に候補を合意し、初期リリース前に確定する。U-01・U-02 の決定後に基準日を記録 | M-02、準備着手、初期リリース・店頭試用開始 |
108
+ | オフライン時の運用・受入範囲 | _UNDECIDED_: 成功条件の「例外条件と未解決事項」が正本。未決中は当該経路の実運用を保留 | M-09、初期リリース・店頭試用開始 |
109
+ | 人気商品の対象範囲・除外条件 | _UNDECIDED_: 成功条件の「例外条件と未解決事項」が正本。`BA` が測定対象案を提示する | 「運用前の準備」の SC-04 |