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
@@ -13,40 +13,59 @@ specdojo:
13
13
 
14
14
  ## 1. 品質方針と適用範囲
15
15
 
16
- 品質は、文書が整っていることではなく、店主と家族が販売・在庫・つけの記録を正しく続けられ、追加負担を許容できることを中心に判定する。文書・実装・公開物の品質は、その価値を安全に実現するための条件として扱う。
16
+ 店主代表と家族利用者代表が販売・在庫・つけの記録を同じ手順で続けられ、追加負担を許容できることを価値品質とする。文書・実装・公開物の整合、再現性、安全性は、その価値を支える成果物品質として確認する。
17
+
18
+ 本計画は、初期リリースの準備着手から、2週間の店頭試用終了時の継続判断と後続観測への引き継ぎ完了まで適用する。対象は単一店舗・タブレット1台の販売・在庫・つけ管理で、範囲と具体日は [[specdojo:pm-plan-sample|管理計画]] に従う。中長期の効果測定は後続計画で扱う。
19
+
20
+ 判定条件は [[specdojo:prj-success-criteria-and-acceptance-criteria-sample|成功基準と受入条件]](以下「成功条件」)の条件 ID で参照し、閾値・算出方法を本書で再定義しない。現金支出、準備・開発の作業時間、保守・引き継ぎ負荷は管理計画の M-03・M-04・M-06 で別々に確認し、日常操作の負担 SC-03 と混同しない。
17
21
 
18
22
  ## 2. 品質ゲート
19
23
 
20
- | ゲート | 品質観点 | 合格条件 | 方法・証跡 | 時期 | 確認者 / 承認者 |
21
- | ---------- | -------------------------- | -------------------------------------------------- | --------------------------------- | -------------- | --------------- |
22
- | 初期受入 | 基本業務を完了できる | 販売、在庫、つけ管理の受入条件をすべて満たす | シナリオ試験、結果記録 | リリース前 | QE / PO |
23
- | 短期利用 | 継続利用でき、負担が許容内 | 2週間記録を継続し、追加操作が1日10分以内 | 利用記録、利用者所感 | 試用終了時 | BA、QE / PO |
24
- | 技術・公開 | 安全に再現・公開できる | 必須検証が成功し、個人情報・秘密情報を含まない | lint、test、build、公開前レビュー | 変更時、公開前 | QE / PO |
25
- | 中期価値 | 記録が意思決定に役立つ | 売れ筋、在庫、つけ状況の把握に利用された事例がある | 利用事例、振り返り記録 | 運用定着後 | BA / PO |
24
+ `kinuya-` で始まる参照名と `execution/` 配下のパスは、未同梱の架空記録である。
26
25
 
27
- 中期価値ゲートは初期リリースの合否条件には含めず、継続判断に用いる。
26
+ | ゲート | 品質観点 | 合格条件 | 方法・証跡 | 時期 | 確認者 / 承認者 |
27
+ | ---------- | ---------------------------------------------- | ------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------ | -------------------------------------- | ------------------------------ |
28
+ | 技術・公開 | 対象版を再現し、安全に店頭利用・公開できる | AC-04 と `kinuya-verification-plan` の適用条件が合格し、「公開する画面・文書・記録」の出口条件を満たす | `DEV` の検証結果と公開対象の差分を照合する。証跡は `execution/reviews/release-1/result.md` | 主要変更後、初期受入前、公開対象変更時 | `DEV`、`QE` / 人間の `PO` |
29
+ | 初期受入 | 店主代表と家族利用者代表が主要業務を完了できる | SC-01・AC-01〜AC-04 がすべて合格し、技術・公開ゲートと管理計画の初期リリース前提が成立している | 利用者のシナリオ実施結果を条件別に照合する。証跡は `kinuya-acceptance-record` | 初期リリース・店頭試用開始前、是正後 | `BA`、`QE` / 人間の `PO` |
30
+ | 短期利用 | 日々の記録を負担なく継続できる | SC-02・SC-03 が合格し、M-06 の保守・引き継ぎ担当と負荷を確認できる | 営業日別の記録・追加操作時間を母数・欠測とともに照合する。証跡は `kinuya-trial-log` | 運用開始後2週間の試用終了時 | `BA`、`QE`、`PM` / 人間の `PO` |
31
+
32
+ 各条件は合格・未達・保留を区別する。未達、証跡不足・未決条件による保留は、いずれもゲートを通過させない。SC-04〜SC-06 は初期受入の合否に含めず、観測時期の前に合格扱いにしない。
28
33
 
29
34
  ## 3. レビューと証跡
30
35
 
31
- | レビュー | 主な観点 | 実施者 | 証跡 |
32
- | ---------------- | -------------------------------------- | -------------------- | ------------------ |
33
- | 利用者レビュー | 操作の理解、業務との一致、追加負担 | BA、店主、家族利用者 | 確認メモ、利用記録 |
34
- | 成果物レビュー | 目的・範囲・受入条件との整合、未決事項 | QE、関連ロール | レビュー結果 |
35
- | リリースレビュー | 品質ゲート、未解決事項、公開適性 | PM、QE | 決定記録 |
36
+ | 対象 | 主な観点 | 実施責任 | 出口条件 | 証跡 | 記録先 |
37
+ | -------------------------------- | ------------------------------------------------ | ------------------------------------- | ------------------------------------------------------------------------------------- | ---------------------------------------------------- | ---------------------------------------------- |
38
+ | 初期受入の操作と試用中の利用記録 | 操作の理解、業務との一致、追加負担 | `BA`(利用者代表が参加)、照合は `QE` | 対象段階の必須条件(初期受入は SC-01・AC-01〜AC-03、試用終了時は SC-02・SC-03)が合格 | 条件別の操作結果、質問・誤操作、営業日別の記録・時間 | `kinuya-acceptance-record`、`kinuya-trial-log` |
39
+ | 対象版の文書・実装・生成レポート | 目的・範囲・条件・操作メモとの整合、検証の再現性 | `QE`(`DEV` が検証結果を提示) | AC-04 と検証計画の適用条件が合格し、参照矛盾と未解決の重大指摘がない | 文書照合、差分、条件別検証結果、是正・再判定結果 | `execution/reviews/release-1/result.md` |
40
+ | 公開する画面・文書・記録 | 個人情報・秘密情報、権利、公開範囲 | `QE`(`PM` が公開対象を提示) | 全差分を確認済みで、個人情報・秘密情報の混入、権利未確認、未解消の重大指摘がない | 公開対象一覧、確認結果、除外・匿名化・許諾の記録 | `execution/reviews/release-1/result.md` |
36
41
 
37
- 証跡には、対象版、実施日、結果、未解決事項、再判定条件を残す。
42
+ 証跡には対象版、実施日、条件 ID、結果、未達条件・指摘、是正内容、再判定結果を残す。公開用の証跡には実在顧客の氏名・つけ残高を載せず、業務確認用の原記録と公開用の匿名化記録を分ける。
38
43
 
39
44
  ## 4. 不適合と是正
40
45
 
41
- | 区分 | 対応 | 再判定 | 記録先 |
42
- | -------------------------------------- | ------------------------------------ | ------ | ------------------ |
43
- | 軽微(誤字、説明不足) | 通常更新で修正する | QE | レビュー結果 |
44
- | 利用価値(操作不能、負担の上限超過) | 原因を確認し、機能や手順を簡素化する | PO | 課題、決定記録 |
45
- | 技術(試験・build 失敗、データ不整合) | 影響範囲を含めて修正・再検証する | QE | 課題、検証結果 |
46
- | 公開・安全(個人情報や秘密情報の混入) | 対象を隔離し、削除または匿名化する | PO | 課題、レビュー結果 |
46
+ 重大な不適合は下表の「利用価値」「技術」「公開・安全」とする。軽微は必須条件・検証結果・公開安全性に影響しない誤字・補足不足に限り、条件に影響する説明不足は該当する重大区分へ分類する。重大な不適合は是正と再判定が済むまで該当ゲートを通過させず、影響する作業・利用・公開を止める。
47
+
48
+ | 区分 | 対応 | 再判定条件 | 再判定責任 | 記録先 |
49
+ | -------------------------------------------------- | ---------------------------------------------------------------- | -------------------------------------------------------------------------------- | ----------------------------------------- | ----------------------------------------------------------------------------- |
50
+ | 軽微(誤字、説明不足) | 該当文書の担当が正本を修正する | 修正版で指摘箇所と関連参照に同じ不整合が残っていない | `QE` | `execution/reviews/release-1/result.md` の指摘 ID |
51
+ | 利用価値(操作不能、負担超過) | 原因を調べ、操作・手順を簡素化する。範囲・条件変更は先に変更要求 | 未達の SC・AC を同じ測定方法で再確認し、該当ゲートを満たす。観測期間を省略しない | `QE` が照合、人間の `PO` が価値・継続判断 | [[specdojo:pm-issue-log-sample\|課題ログ]] の課題 ID から受入・試用記録へ接続 |
52
+ | 技術(検証失敗、データ不整合) | 生成元・実装の正本を修正し、生成レポートは再生成する | 再生成後、未達の AC-04 または検証条件と影響範囲の検証が成功する | `QE` | 課題ログの課題 ID、`execution/reviews/release-1/result.md` の再検証結果 |
53
+ | 公開・安全(個人情報・秘密情報の混入、権利未確認) | 該当公開を止め、除外・匿名化・許諾確認を行う | 是正済みの公開候補版で「公開する画面・文書・記録」の全対象が出口条件を満たす | `QE` が再確認、人間の `PO` が公開判断 | 課題ログの課題 ID、`execution/reviews/release-1/result.md` |
47
54
 
48
- 重大な不適合は課題または変更要求として登録し、是正完了まで該当ゲートを通過させない。
55
+ 本例は管理計画に合わせ、必須条件を免除する期限付き例外を設けない。基準を変える場合は変更要求を先に判断し、旧条件の未達結果を残して新条件で再判定する。
49
56
 
50
57
  ## 5. 見直し条件と未決事項
51
58
 
52
- 成功基準、対象業務、利用者、検証方法、公開範囲が変わった場合に本計画を見直す。中期価値を確認する利用期間と対象件数は、2週間の店頭試用後に PO が決定する。
59
+ ### 5.1. 見直しと後続作業
60
+
61
+ 成功条件、対象業務、利用者、端末・検証方法、公開範囲、体制、重大不適合の傾向が変わったら見直す。影響する条件 ID・証跡・再確認範囲を特定し、管理計画、RACI、`kinuya-schedule`、証跡参照を影響作業の開始前に追従させる。新条件は改訂の確定前に合格扱いにしない。
62
+
63
+ 試用終了時は、成功条件 SC-04〜SC-06 の測定方法・判定時期と採取済みの基準値を後続観測へ引き継ぎ、継続方針と引き継ぎ先の判断を `kinuya-trial-log` に残して本計画の適用を終える。SC-04・SC-05 の基準値の準備は管理計画の「運用前の準備」に従う。
64
+
65
+ ### 5.2. 未決事項と保留
66
+
67
+ | 論点 | 影響・未決中に保留する判定 |
68
+ | ------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- |
69
+ | `_UNDECIDED_:` 準備着手の上限と試用日(管理計画 U-01〜U-03) | 未承認の支出・時間割り当てと、具体日を前提とする初期リリース判定 |
70
+ | `_UNDECIDED_:` オフライン時の運用・受入範囲(成功条件の未解決事項) | 当該経路の実運用と、その未決を残した店頭試用開始 |
71
+ | `_UNDECIDED_:` 人気商品の対象範囲・除外条件(成功条件の未解決事項) | SC-04 の基準値採取と、それを前提とする試用開始。運用後の SC-04 の合否は初期受入に含めない |
@@ -5,6 +5,7 @@ specdojo:
5
5
  status: ready
6
6
  rulebook: specdojo:pm-raci-rulebook
7
7
  based_on:
8
+ - specdojo:people-and-organization-definition-standard
8
9
  - specdojo:pm-organization-sample
9
10
  - specdojo:pm-roles-sample
10
11
  - specdojo:pm-members-sample
@@ -14,44 +15,78 @@ specdojo:
14
15
 
15
16
  ## 1. 適用方針
16
17
 
17
- 初期リリースと店頭試用に必要な責任境界だけを示す。小規模な兼務体制のため `PO`、`PM`、`BA`、`DEV`、`QE` を使用し、各行の `A` は1ロールとする。AI Agent は `R` または `C` を支援できるが、`A` は担わない。
18
+ 単一店舗・タブレット1台の販売・在庫・つけ記録の初期リリースと店頭試用の責任境界を示す。EC、複数店舗、本格会計、仕入れ先連携は初期スコープ外とし、定型作業や生成ビューは行にしない。
18
19
 
19
- | 記号 | 意味 |
20
- | ---- | ------------------------ |
21
- | R | 実作業を担当する |
22
- | A | 最終承認または判断を行う |
23
- | C | 事前に相談・レビューする |
24
- | I | 結果の共有を受ける |
20
+ 列は [[specdojo:pm-organization-sample|組織定義]] の主導ロールとする。専門支援の `ARC`、`UX`、`OPS` は列を省き、助言はそれぞれ `DEV`、`BA`、`PM` が取り込む。独立タスク化するなら組織定義の見直しを先行させる。
21
+
22
+ 記号は [[specdojo:people-and-organization-definition-standard|人と組織の定義標準]] に従う。`A` と `R` を兼ねても作業結果と判断の証跡を分ける。AI Agent は `R`・`C` の作業を支援できるが、`A` の判断は人間が行う。
25
23
 
26
24
  ## 2. 成果物別 RACI
27
25
 
28
- | 成果物 | PO | PM | BA | DEV | QE |
29
- | ------------------------------------ | --- | --- | --- | --- | --- |
30
- | プロジェクト概要・スコープ・成功基準 | A | C | R | C | C |
31
- | 管理計画・組織定義・RACI | C | A/R | C | I | C |
32
- | 利用者要求・操作設計 | A | C | R | C | C |
33
- | 実装・データ設計 | C | I | C | A/R | C |
34
- | 品質計画・試験結果 | A | C | C | C | R |
35
- | リリース候補 | A | R | C | R | C |
26
+ | 成果物 | PO | PM | BA | DEV | QE |
27
+ | -------------------------------------- | --- | --- | --- | --- | --- |
28
+ | プロジェクト概要・スコープ・成功基準 | A | C | R | C | C |
29
+ | 組織定義・ロール定義・メンバー定義 | A | R | C | I | C |
30
+ | 管理計画・コミュニケーション計画・RACI | C | A/R | C | I | C |
31
+ | 利用者要求・操作設計 | A | C | R | C | C |
32
+ | 実装・データ設計 | C | I | C | A/R | C |
33
+ | 品質計画・試験結果 | A | C | C | C | R |
34
+ | リリース候補 | A | R | C | R | C |
35
+
36
+ 品質計画・試験結果の `A` は確認範囲と結果を、リリース候補の `A` は準備完了を確認する。利用開始の可否は次表で決める。
36
37
 
37
38
  ## 3. 判断・プロセス別 RACI
38
39
 
39
- | 判断・プロセス | PO | PM | BA | DEV | QE |
40
- | -------------------------- | --- | --- | --- | --- | --- |
41
- | 価値、範囲、優先順位の判断 | A | R | C | C | C |
42
- | 費用・参加時間上限の判断 | A | R | C | C | C |
43
- | 作業順序、課題・リスク管理 | C | A/R | C | C | C |
44
- | 利用者確認 | A | C | R | C | C |
45
- | 受入・品質ゲート判定 | A | C | C | C | R |
46
- | 変更要求・リリース判断 | A | R | C | C | C |
40
+ | 判断・プロセス | PO | PM | BA | DEV | QE |
41
+ | ------------------------------ | --- | --- | --- | --- | --- |
42
+ | 価値、範囲、優先順位の判断 | A | R | C | C | C |
43
+ | 費用・参加時間上限の判断 | A | R | C | C | C |
44
+ | 作業順序、課題・リスク管理 | C | A/R | C | C | C |
45
+ | 利用者確認 | A | C | R | C | C |
46
+ | 受入・品質ゲート判定 | A | C | C | C | R |
47
+ | 品質未達・例外要求への対応判断 | A | C | C | C | R |
48
+ | 変更要求の採否 | A | R | C | C | C |
49
+ | リリース・試用後の継続判断 | A | R | C | C | C |
50
+
51
+ - 作業順序、課題・リスク管理の `A` は進捗と調整を判断し、成果物の内容承認は各成果物行の `A` に残す。
52
+ - 利用者確認では `BA` が店主・家族利用者の操作結果と意見を集め、内部 Role だけで代替しない。
53
+ - 品質未達では `QE` が不足する証跡と是正案を整理し、`PO` が保留と再判定を判断する。[[specdojo:pm-plan-sample|管理計画]] の判断ゲートどおり必須条件は免除せず、範囲・基準の変更は変更要求を先に通す。
47
54
 
48
55
  ## 4. Schedule・実行主体との対応
49
56
 
50
- - Schedule の `owner` は、その作業を主導する `R` の Role code と一致させる。
51
- - 人間の実行主体と兼務は `pm-members.yaml`、agent は `.specdojo/agent-members.yaml` で管理し、本書へ個人名や agent 名を記載しない。
52
- - 成果物を統合・分割した場合も、各作業の `A` が不明にならないようにする。
53
- - 同じ実行主体が `A` と `R` を兼ねる場合も、判断と作業の証跡を分ける。
57
+ ### 4.1. 主担当と照合先
58
+
59
+ 個別タスクの正本は管理計画が示す `kinuya-schedule`(未同梱の架空記録)、照合は人と組織の定義標準の「Schedule への担当展開」に従う。割り当て先は人間が [[specdojo:pm-members-sample|メンバー定義]]、agent が `.specdojo/agent-members.yaml` を正本とし、本書へ複製しない。
60
+
61
+ | 対象作業 | 主担当・`owner` | 対応する行と照合内容 |
62
+ | -------------------------------------- | --------------- | ------------------------------------------ |
63
+ | 利用者要求・操作設計を作成する | `BA` | 成果物行の `R`。`UX` の助言を取り込む |
64
+ | 実装・データ設計を承認する | `DEV` | 成果物行の `A/R`。作業結果と承認を別記録 |
65
+ | リリース候補の導入・引き継ぎを準備する | `PM` | 複数 `R` のうち導入・復旧・引き継ぎの準備 |
66
+ | リリース候補の対象版を組み立てる | `DEV` | 複数 `R` のうち組み立てと技術的な是正 |
67
+ | リリース可否を承認する | `PO` | 判断行の `A`。準備作業とは別の承認タスク |
68
+ | 利用者要求・操作設計を技術レビューする | `DEV` | 成果物行の `C`。作成とは別のレビュータスク |
69
+
70
+ ### 4.2. 不一致時の更新先
71
+
72
+ `PM` は action、WBS の明示 `owner`、作成か承認・レビューかで修正先を決め、Schedule の現在値で主担当を選び直さない。
73
+
74
+ | 不一致の原因・具体例 | 更新する正本 |
75
+ | ------------------------------------------------------ | ------------------------------------------------------------------------- |
76
+ | 操作設計の作成タスクが `DEV` | タスク定義の正本(WBS の明示 `owner` か `kinuya-schedule`)を `BA` に直す |
77
+ | WBS の明示 `owner` は `BA`、展開結果が `DEV` | 生成元・展開処理を直して再生成する。生成ビューは直接編集しない |
78
+ | 合意した責任変更(専門支援の独立タスク化など)が未反映 | 組織定義を確かめ、本書を直してから WBS・Schedule へ反映する |
79
+
80
+ 原因や責任が未決の間は、担当変更を前提とする作業を保留する。
54
81
 
55
82
  ## 5. 見直し条件
56
83
 
57
- 採用 Role code、成果物区分、Schedule の owner、主要判断、兼務の継続可能性が変わった場合に見直す。
84
+ | トリガー | 確認すること |
85
+ | ----------------------------------------- | ---------------------------------------------------------------------------- |
86
+ | 初期スコープ、成果物の統合・分割・廃止 | 各成果物から一つの行と `A`・主担当へ辿れるか、旧参照と後続タスクの付け替え先 |
87
+ | 採用 Role、専門支援の独立タスク化 | 組織定義と列・相談先の整合、WBS・Schedule の追従箇所 |
88
+ | Schedule の担当変更・WBS 導入・タスク分割 | action と主担当の一致。直し方は「不一致時の更新先」に従う |
89
+ | 判断ゲートの変更、品質判定の滞留 | 判断行の `A` と材料を準備する `R`、相談先、判断期限への影響 |
90
+ | 参加・離脱・兼務負荷・AI Agent 支援の変化 | 未完了タスクを引き受けられるか、人間の判断と作業の記録を分けられるか |
91
+
92
+ 各行の `A` と主担当が明確で、組織・ロール・メンバー定義、WBS・Schedule、[[specdojo:pm-communication-plan-sample|コミュニケーション計画]] と整合し、引き継ぎ漏れがなければ見直しを終える。経緯や状態は本表へ蓄積しない。
@@ -2,7 +2,7 @@
2
2
  id: specdojo:pm-roles-sample
3
3
  type: project
4
4
  status: ready
5
- title: ロール一覧
5
+ title: "ロール定義: 駄菓子屋きぬや 販売管理システム"
6
6
  rulebook: specdojo:pm-roles-rulebook
7
7
  based_on:
8
8
  - specdojo:people-and-organization-definition-standard
@@ -10,32 +10,33 @@ based_on:
10
10
  version: 1
11
11
  project_id: prj-0001
12
12
 
13
- # ロール一覧。Role code の共通定義・責務は specdojo:people-and-organization-definition-standard を参照する。
14
- # 兼務の割り当ては pm-members.yaml の roles フィールドで管理する。
15
- # ロール採用の方針・根拠は pm-organization.md を参照する。
13
+ # 単一店舗・タブレット1台での初期リリースと店頭試用に用いる、採用済み8ロールの一覧。
14
+ # 採用判断・Schedule の owner 使用可否・見直し条件の正本: [[specdojo:pm-organization-sample|組織定義]]。
15
+ # 人間の実行主体と兼務: [[specdojo:pm-members-sample|メンバー定義]]。agent は利用先の .specdojo/agent-members.yaml で管理する。
16
+ # 成果物・主要判断の責任分担: [[specdojo:pm-raci-sample|RACI]]。共通責務は based_on の上位標準を参照する。
16
17
 
17
18
  roles:
18
19
  - code: PO
19
20
  name: Project Owner
20
- project_note: 初期リリースの目的、優先順位、公開可否を最終判断し、店頭運用を変えすぎない方針を承認する。
21
+ project_note: 店頭運用を大きく変えない範囲で販売・在庫・つけの記録を優先し、人間が範囲・費用・参加時間の上限、受入、公開・継続を最終判断する。
21
22
  - code: PM
22
23
  name: Project Manager
23
- project_note: 計画・進捗・課題・リスク管理を担う。週次管理が継続的に滞る場合に専任化を検討する。
24
+ project_note: 店頭試用までの作業順序と参加負荷を週次で確認する。兼務による期限超過は課題化し、分担変更と追従タスクを整理して、上限変更は PO に判断を求める。
24
25
  - code: BA
25
26
  name: Business Analyst
26
- project_note: 販売・在庫・つけ管理の業務整理と、店主・家族店番の利用者視点を反映した受入条件整理を担う。
27
+ project_note: 店主以外の家族も同じ手順で販売・在庫・つけを確認できるよう、利用者確認を主導し、操作説明への UX の助言を受入条件へ反映する。
27
28
  - code: ARC
28
29
  name: Architect
29
- project_note: 店頭タブレット 1 台での利用を前提に、構成方針、データ管理方針、成果物間の整合を整理する。
30
+ project_note: タブレット1台の構成・データ管理方針を専門支援として検討し、DEV が主導する設計へ助言する。初期は独立タスクの主責任を持たない。
30
31
  - code: DEV
31
32
  name: Developer
32
- project_note: 実装・設定・技術的変更作業を担う。実装タスクが継続増加した場合に専任化を検討する。
33
+ project_note: 販売・在庫・つけの実装・データ設計と技術的な是正を主導し、店頭試用で見つかった記録漏れや残高誤りの修正結果を QE の再確認へ渡す。
33
34
  - code: QE
34
35
  name: Quality Engineer
35
- project_note: 欠品削減、つけ残高の記録漏れ防止、店頭操作の受入確認観点を管理する。
36
+ project_note: 人気商品の欠品、つけの記録漏れ・残高誤り、家族の店番時の操作を実装作業と分けて確認し、試験結果と未解消事項を PO の受入判断へ渡す。
36
37
  - code: UX
37
38
  name: UX / Documentation Designer
38
- project_note: 家族店番向け説明や画面文言改善を担う。利用者導線の改善が増えた場合に専任化を検討する。
39
+ project_note: 店主・家族向けの画面文言と操作説明を専門支援として検討し、BA が主導する利用者確認へ助言する。独立タスク化は組織定義の見直し後とする。
39
40
  - code: OPS
40
41
  name: Operations / Release Manager
41
- project_note: リリース・公開・配布・変更管理を担う。公開可否の最終判断は人間の PO に残す。
42
+ project_note: 導入・障害時対応・引き継ぎを専門支援として準備し、PM が主導するリリース準備へ取り込む。初期は独立した Schedule タスクの主責任を持たず、公開・継続の最終判断は人間の PO に残す。
@@ -6,52 +6,60 @@ specdojo:
6
6
  rulebook: specdojo:prj-assumptions-constraints-dependencies-rulebook
7
7
  based_on:
8
8
  - specdojo:prj-scope-sample
9
+ - specdojo:prj-charter-sample
9
10
  supersedes: []
10
11
  ---
11
12
 
12
13
  # 前提・制約・依存関係: 駄菓子屋きぬや 販売管理システム
13
14
 
14
- 本書は、単一店舗での販売・在庫・つけ管理を初期対象とする際の、前提、制約、依存を示す最小の完成例である。スコープで確定済みの境界(対象業務、スコープ外、境界の判断基準)は再掲せず、[[specdojo:prj-scope-sample|プロジェクトスコープ]] を正とする。本書は、スコープに現れない成立条件と依存だけを扱う。
15
+ 初期リリース準備から店頭試用までに、作業の開始・保留・再判断に使う前提、制約、依存を整理する。
15
16
 
16
17
  ## 1. 前提条件
17
18
 
18
- 初期対象の範囲(店頭販売、店頭在庫、つけ管理への限定、単一店舗運用)は [[specdojo:prj-scope-sample|プロジェクトスコープ]] の対象業務とスコープ外で定義済みであり、本書では再掲しない。本章では、スコープに現れない運用上の成立条件だけを扱う。
19
+ 対象業務と単一店舗の境界は [[specdojo:prj-scope-sample|プロジェクトスコープ]] の「対象業務」「スコープ外」を正とし、ここでは実行時に確認が要る条件だけを登録する。
19
20
 
20
- | ID | 内容 | 根拠 | 影響 | 監視・確認方法 | 変化のトリガー | 所有者 | 対応方針 |
21
- | ------- | --------------------------------------------------------------------------------------------------------- | -------------------------------------- | -------------------------------------------------------------------------- | ---------------------------------------------------------------------------- | -------------------------------------------------------------------- | -------- | -------------------------------------------------------------------------------- |
22
- | ACD-A01 | 店舗の運用体制を大きく変えず、現行の販売手順に近い操作を前提とする。 | 店主代表の習熟負荷を抑える初期運用方針 | 現行と大きく異なる操作を採用すると、店主代表が定着前に利用をやめてしまう。 | 新機能を追加する際に、店主代表が従来の操作と比べて迷わず使えるかを確認する。 | 店主代表からの申し出、または新機能追加で操作が複雑になる兆候が出た。 | 店主代表 | 操作を簡素化する代替案を検討し、乖離が大きい機能は対象外または次フェーズへ回す。 |
23
- | ACD-A02 | 店頭の通信環境が不安定な場合があることを前提とし、記録のオフライン対応は _ASSUMPTION_: 未確定として扱う。 | 共通サンプル文脈の未確定事項 | 通信断時に記録操作ができないと、販売・在庫記録が抜け落ちる。 | 営業中に通信断が発生した際、記録が滞留せず後から反映できるかを確認する。 | 通信環境の仕様が確定した、または通信断が頻発する。 | 開発担当 | オフライン時の記録方式を検討し、方針確定後に本項目を更新する。 |
21
+ | ID | 内容 | 根拠 | 影響 | 監視・確認方法 | 変化のトリガー | 所有者 | 対応方針 |
22
+ | ------- | ------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------ | -------------------------------------------------------------- | ------------------------------------------------------------------------------------------------- | ---------------------------------------------------- | ----------------- | ------------------------------------------------------------------------------------- |
23
+ | ACD-A01 | _ASSUMPTION_: 運用体制を大きく変えず現行手順に近い操作なら、店主代表と家族利用者代表が記録を継続できる | スコープの「境界の判断基準」が示す操作の単純化 | 外れれば操作手順の再設計と再説明が要り、受入・試用開始が遅れる | 開発担当が操作確認時に支援・迷いを記録する。試用中は成功条件の SC-02・SC-03 を参照する | 必須操作を続けられない、または負担が許容範囲を超えた | 開発担当(`PM`) | 操作の簡素化を提案し、店主代表が優先順位を判断する。範囲変更は変更要求にする |
24
+ | ACD-A02 | _ASSUMPTION_: 店頭では通信断が起き得る。頻度と記録への影響は未確認 | [[specdojo:prj-charter-sample\|プロジェクト憲章]] の「未決事項」にオフライン時の扱いが残る | 未記録・重複記録を照合できず、販売・在庫・つけ残高がずれる | 開発担当が試用準備時に接続を確かめ、試用中の通信断を `kinuya-technical-dependency-log` に記録する | 記録操作が通信断で止まった、または接続条件が変わった | 開発担当(`DEV`) | 発生した支障は課題にし ACD-D03 の判断材料へ渡す。未検証のオフライン記録を前提にしない |
24
25
 
25
26
  ## 2. 制約事項
26
27
 
27
- 対象範囲・対象外に関する制約は [[specdojo:prj-scope-sample|プロジェクトスコープ]] のスコープ外と境界の判断基準を正とする。本章では、スコープに現れない運用上の制約だけを扱う。
28
+ 対象外と業務判断の境界はスコープの「対象システム」「スコープ外」「境界の判断基準」へ委譲する(旧 ACD-C01 は廃止し、ID を再利用しない)。以下は [[specdojo:prj-charter-sample|プロジェクト憲章]] の「主要前提・制約」の支出・公開情報に、監視と逸脱時の対応を補ったものである。
28
29
 
29
- | ID | 内容 | 適用範囲 | 影響 | 監視・確認方法 | 逸脱のトリガー | 所有者 | 対応方針 |
30
- | ------- | ------------------------------------------------------------------------------------------------ | ---------------------- | ------------------------------------------------------------ | -------------------------------------------------------------------- | -------------------------------------------------------- | -------- | ------------------------------------------------------------ |
31
- | ACD-C01 | 店主代表の業務判断をシステムが代替しない。 | 販売、在庫、つけ管理 | 自動判断に依存すると、現場の例外に対応できない。 | 画面・操作メモが記録と確認の支援に留まることを確認する。 | システムが仕入れやつけの最終判断を確定する設計になった。 | 店主代表 | 判断を提示・確認する操作へ戻す。 |
32
- | ACD-C02 | 初期リリースの費用上限は _UNDECIDED_: であり、上限確定までは有償の外部サービス連携を追加しない。 | 導入コスト、運用コスト | 上限を超える連携を先行導入すると、予算超過や後戻りが生じる。 | 新規の外部サービス連携を検討する際に、費用上限の確定状況を確認する。 | 費用上限が未確定のまま有償連携の導入を決定しようとした。 | 店主代表 | 費用上限の確定を優先し、確定前の有償連携は次フェーズへ回す。 |
30
+ | ID | 内容 | 適用範囲 | 影響 | 監視・確認方法 | 逸脱のトリガー | 所有者 | 対応方針 |
31
+ | ------- | ------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------ | ------------------------------------------ | ---------------------------------------------------------------------------------- | ------------------------------------------------ | ---------------- | -------------------------------------------------------------------------------------- |
32
+ | ACD-C02 | 費用上限は _UNDECIDED_: [[specdojo:pm-plan-sample\|プロジェクト管理計画]] の U-01 で店主代表が承認する。承認前に外部支出を開始しない | 機材購入、有償利用、外部契約 | 未承認の支出と継続費用で計画を維持できない | 開発担当が購入・契約の前に `kinuya-cost-and-effort-log` の上限・承認証跡を照合する | 承認証跡がないまま着手しようとした | 開発担当(`PM`) | 着手を保留し、必要額と無償代替を店主代表へ示す。実施済みなら課題にして是正案を報告する |
33
+ | ACD-C03 | 公開する説明資料・操作例に、実顧客の個人情報、秘密情報、非公開の店舗情報を含めない | 公開文書、画面画像、添付データ | 情報が漏れ、公開を継続できない | 開発担当が公開候補を点検し、同行レビュー担当が架空データへの置換を再確認する | 実データの混入、または公開可否を判断できない情報 | 開発担当(`PM`) | 公開を保留して分離し、置換と影響確認の後、店主代表が公開・再開を判断する |
33
34
 
34
35
  ## 3. 依存関係
35
36
 
36
- プロジェクトスコープは本書の根拠文書であり、文書自体をプロジェクトの依存先としては扱わない。
37
+ スコープと憲章は本書の根拠であり、それだけで依存先にしない。受入判定は [[specdojo:prj-success-criteria-and-acceptance-criteria-sample|成功基準と受入条件]](以下「成功条件」)を正とする。
37
38
 
38
- | ID | 依存先・条件 | 必要となる理由 | 受領・成立条件 | 変化のトリガー | 所有者 | 対応方針 |
39
- | ------- | -------------------------------------- | -------------------------------------------------------------------- | -------------------------------------------------------------- | ------------------------------------------------------------------ | -------- | ---------------------------------------------------------------------------- |
40
- | ACD-D01 | 店頭で使用するタブレット 1 台 | 販売・在庫・つけの記録を店頭で行うため。 | 営業時間中に、店主代表または家族利用者代表が利用できる。 | 端末を利用できない、または台数を変更する。 | 開発担当 | 代替記録手順を確認し、端末条件が変わる場合は対象範囲を見直す。 |
41
- | ACD-D02 | 技術メンターによる設計・実装方針の助言 | 開発担当が一人で判断せず、設計・実装上の技術的な課題を解決するため。 | 開発期間中、必要なタイミングで技術メンターの助言を受けられる。 | 技術メンターの都合がつかない、または助言を受けられない期間が続く。 | 開発担当 | 助言なしで判断できる範囲を見極め、優先度の低い判断は次回の助言まで保留する。 |
39
+ | ID | 依存先・条件 | 必要となる理由 | 受領・成立条件 | 変化のトリガー | 所有者 | 対応方針 |
40
+ | ------- | -------------------------------------------------------- | -------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------- | ----------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
41
+ | ACD-D01 | 店頭で使うタブレット1台の継続提供 | 記録に使う。利用不能なら店頭試用を継続できない | 開発担当が試用開始前に対象版で記録・確認操作を行い、以後は店番担当が営業開始前に確かめる。結果を `kinuya-technical-dependency-log` に残す | 端末の利用不能、交換、台数・接続条件の変更 | 開発担当(`DEV`) | 復旧見込みを確かめ、代替端末は対象版で再確認する。店主代表が再開を判断するまで該当経路の試用を保留する |
42
+ | ACD-D02 | 技術メンターから受ける設計・実装方針への助言 | 不整合や回復不能につながる判断を確かめる。待つ間は設計を確定できない | 開発担当が設計確定前に回答を受領し、確認日・助言内容・採否理由を `kinuya-technical-dependency-log` に記録する。未回答なら成立扱いにしない | 助言を受けられない、または前提が変わった | 開発担当(`DEV`) | 回答期限と保留対象を Schedule に残す。期日に響く場合は店主代表へ順序変更・延期案を示す |
43
+ | ACD-D03 | 店主代表によるオフライン時の運用方針の決定(`PJR-KN01`) | 通信断時の記録の扱いを確定する。未決の経路は受入条件をそろえられない | 開発担当が初期運用開始前に `PJR-KN01` の判断証跡と成功条件の「例外条件と未解決事項」を照合する。方針・追加受入条件・確認結果がそろうまで未成立 | 方針の決定・変更、または追加した受入条件の未達 | 開発担当(`PM`) | 初期受入の対象外とする扱いは決定済み。記録方法は _UNDECIDED_: 開発担当が代替案を示し、店主代表が初期運用開始前に判断する。部分決定で解消しない |
44
+ | ACD-D04 | 対象版・操作メモを特定した初期受入判定 | 試用開始できる品質かを確かめる。証跡不足なら開始を判断できない | 成功条件の SC-01・AC-01〜AC-04 を正とする。初期リリースゲート前に同行レビュー担当が `kinuya-acceptance-record` の対象版・条件 ID・確認結果を照合する | 対象版・操作メモ・受入条件の変更、不合格、証跡欠落 | 開発担当(`PM`) | 不足する条件と証跡を特定し、是正・再確認を先行作業にする。SC-02 以降の将来測定を初期受入の証拠に使わない |
42
45
 
43
- 意思決定待ちの依存が生じた場合は、プロジェクト登録簿(`pjr-index.md`)へ登録し、本書からは登録項目 ID を参照する。現時点で決定待ちの依存はない。
46
+ `PJR-KN01` と `kinuya-*` の記録は未同梱の架空の参照名で、記録先は [[specdojo:pm-plan-sample|プロジェクト管理計画]] に従う。
44
47
 
45
48
  ## 4. 影響評価と対応方針
46
49
 
47
- | 変化の種別 | 主な影響領域 | 最初に確認すること | 一次対応・判断 | 対応方針 |
48
- | ---------------- | ------------------------------------------------ | ---------------------------------------------------------- | ---------------------------------------------------------------------------- | ---------------------------------------------------------------------------- |
49
- | 前提が崩れた | 店頭での操作手順、通信環境、店主代表の定着 | どの操作または通信条件が前提と外れたか | 店主代表が支障の有無を確認し、開発担当が操作または記録方式の見直し案を出す。 | 操作手順や記録方式を見直し、乖離が大きい機能は対象外または次フェーズへ回す。 |
50
- | 制約に抵触した | 初期リリースの範囲、利用者負荷、導入・運用コスト | 追加対象が日々の記録に不可欠か、費用上限内に収まるか | 店主代表が業務上の必要性と費用を確認し、開発担当が対象外として整理する。 | 不可欠でなければ次フェーズへ移し、費用上限が未確定の項目は確定を待つ。 |
51
- | 依存先が変化した | 店頭利用、設計・実装の意思決定 | 端末を利用できるか、または技術メンターの助言を受けられるか | 開発担当が代替手段を確認し、店主代表が運用継続可否を判断する。 | 代替手段を確認し、必要なら初期運用の開始条件や実装方針を見直す。 |
50
+ | 変化の種別 | 主な影響領域 | 最初に確認すること | 一次対応・判断 | 対応方針 |
51
+ | ---------------- | -------------------------------------- | ----------------------------------------------------- | ---------------------------------------------------------------- | ---------------------------------------------------------------------------- |
52
+ | 前提が崩れた | 受入日程、記録品質、操作確認の有効性 | ACD-A01・A02 の変化が及んだ操作確認・記録 | 開発担当が影響作業を調べ、家族利用者代表へ店番への支障を確かめる | 確認日程・操作手順を見直して軽減する。受入・試用開始日は店主代表が再判断する |
53
+ | 制約に抵触した | 支出、公開適性、後戻り作業 | ACD-C02・C03 の抵触が実施済みか、影響する契約・公開物 | 開発担当が対象行為を止め、是正を課題にする | 原因を除き、承認証跡または再レビューをそろえる。再開は店主代表が判断する |
54
+ | 依存先が変化した | 設計の確定、受入、店頭試用の開始・継続 | ACD-D01〜D04 の未成立部分と影響する対象版・条件 ID | 所有者が不足材料と回復見込みを特定し、開発担当が代替案をまとめる | 代替策で軽減するか、順序・期日・範囲を店主代表が再判断する |
52
55
 
53
56
  ## 5. 監視・変更管理
54
57
 
55
- - 営業日の販売・在庫・つけの記録状況を確認し、スコープ変更や関連文書の改訂が起きたときに見直す。
56
- - 変更記録には、項目 ID、変化内容、影響範囲、一次対応者、判断者、対応状況を残す。記録先はプロジェクト登録簿(`pjr-index.md`)を第一候補とする。
57
- - 店主代表は業務判断を行い、開発担当は文書整合と手順見直しを支援する。
58
+ 週次の進捗確認に加え、スコープ・憲章・受入条件の改訂、参加不可の申出、通信断・端末交換、支出・公開の提案、助言・決定の受領、判断ゲートの準備開始時に本書を見直す。変更記録には項目 ID、変化内容、影響する作業・条件 ID、判断者、対応状況、再確認時期を残し、追従作業を項目 ID で `kinuya-schedule` に結ぶ。
59
+
60
+ | 検知したこと | 記録先 | 報告・判断 |
61
+ | -------------------------------------------------- | -------------------------------------------------------------------------------------------- | ------------------------------------------------------------------ |
62
+ | 通信断による未記録、端末利用不能など発生済みの支障 | [[specdojo:pm-issue-log-sample\|課題ログ]](ACD 項目 ID・是正期限を付ける) | 所有者が開発担当へ報告し、開始・継続に響けば店主代表が判断する |
63
+ | 確認参加者の不足、助言遅延など将来の不確実な影響 | [[specdojo:pm-risk-register-sample\|リスク登録簿]](顕在化したら元の ID を付けて課題へ移す) | 開発担当が週次と兆候検知時に店主代表へ報告する |
64
+ | 対象範囲、費用・時間上限、期日の変更案 | [[specdojo:pm-change-request-log-sample\|変更要求ログ]] | 開発担当が起案し、店主代表が承認・却下・保留する |
65
+ | 未決事項の解消、延期・再開の判断 | 該当する PJR・課題・変更要求に判断理由と証跡を付記する | 開発担当が本書と Schedule の追従を確かめ、店主代表へ完了を報告する |
@@ -12,7 +12,7 @@ specdojo:
12
12
 
13
13
  # プロジェクト憲章: 駄菓子屋きぬや 販売管理システム
14
14
 
15
- 本書は、駄菓子屋きぬや 販売管理システム構築プロジェクトの立ち上げを正式に認可し、開発担当に要件整理、詳細計画、初期準備を進める権限を委譲するための憲章である。店主代表が PO として、目的、優先順位、公開の扱い、予算の境界を最終判断する。本書の承認は、本格実行開始、外部公開、追加支出、主要スコープ変更を承認するものではない。
15
+ 本書は、駄菓子屋きぬや 販売管理システム構築の立ち上げを認可し、開発担当に要件整理、詳細計画、初期準備の権限を委譲する。承認責任者は店主代表(`PO`)であり、本格実行開始と外部公開は本書では承認しない。
16
16
 
17
17
  ## 1. 認可対象
18
18
 
@@ -22,15 +22,13 @@ specdojo:
22
22
  | プロジェクト ID | `prj-0001` |
23
23
  | 認可対象 | 立ち上げ、詳細計画策定、初期準備 |
24
24
  | 認可しない範囲 | 本格実行開始、外部公開、追加支出、主要スコープ変更 |
25
- | 直接根拠 | [プロジェクト概要サンプル](prj-overview-sample.md)、[ステークホルダー登録簿サンプル](prj-stakeholder-register-sample.md) |
25
+ | 直接根拠 | [[specdojo:prj-overview-sample\|プロジェクト概要]]、[[specdojo:prj-stakeholder-register-sample\|ステークホルダー登録簿]] |
26
26
  | 承認責任 | 店主代表(`PO`) |
27
- | 認可条件 | 承認日と証跡リンクが確認できるまで、正式な認可済み扱いにしない |
27
+ | 認可条件 | 「承認」の表に承認日と証跡リンクが記録されるまで、立ち上げ認可は未承認として扱う |
28
28
 
29
29
  ## 2. プロジェクトの目的
30
30
 
31
- プロジェクトの目的は、店主代表が無理なく使える仕組みで日々の販売、在庫、つけ残高を記録し、家族利用者が店番する場合も同じ手順で確認できる状態を作ることである。背景、必要性、目的の詳細は [プロジェクト概要サンプル](prj-overview-sample.md) を正とする。
32
-
33
- 認可判断における期待効果は次の観点で確認する。数値目標、測定方法、中長期指標は [プロジェクト概要サンプル](prj-overview-sample.md) の期待効果を正とし、本書では再掲しない。
31
+ 目的は、店主代表が無理なく使える仕組みで販売、在庫、つけ残高を記録し、家族利用者が店番するときも同じ手順で確認できる状態を作ることである。背景、数値目標、測定方法は [[specdojo:prj-overview-sample|プロジェクト概要]] を正とする。
34
32
 
35
33
  | 観点 | 認可判断で確認する期待効果 |
36
34
  | -------- | ------------------------------------------ |
@@ -39,69 +37,57 @@ specdojo:
39
37
  | 残高確認 | つけ残高を短時間で確認できる |
40
38
  | 手順統一 | 店主代表と家族利用者が同じ操作手順で使える |
41
39
 
42
- 成功判定の観点と受入条件は `prj-success-criteria-and-acceptance-criteria` を正とする。
40
+ 成功判定の観点と受入条件は [[specdojo:prj-success-criteria-and-acceptance-criteria-sample|成功基準と受入条件]] を正とする。
43
41
 
44
42
  ## 3. ハイレベルスコープ
45
43
 
46
- | 区分 | 内容 | 詳細化先 |
47
- | ------ | -------------------------------------------------------- | ----------- |
48
- | 対象 | 単一店舗の店頭販売、在庫管理、常連客のつけ管理 | `prj-scope` |
49
- | 対象 | 店主代表と家族利用者が使うタブレット前提の記録・確認手順 | `prj-scope` |
50
- | 対象 | 初期リリースに必要な要件整理、計画、受入確認の準備 | `prj-scope` |
51
- | 対象外 | EC、複数店舗管理、本格会計連携、仕入れ先とのシステム連携 | `prj-scope` |
52
- | 未確定 | オフライン時の扱い、リリース目標日、費用上限の最終値 | 未決事項 |
44
+ | 区分 | 内容 | 詳細化先 |
45
+ | ------ | ------------------------------------------------------------------------------------ | --------------------------------------------- |
46
+ | 対象 | 単一店舗の店頭販売、在庫、つけの記録・確認と、初期リリースの要件整理・計画・受入準備 | [[specdojo:prj-scope-sample\|スコープ]] |
47
+ | 対象 | AI Agent による草案作成、整理、検証の支援。承認と最終判断は人間が行う | [[specdojo:pm-organization-sample\|組織定義]] |
48
+ | 対象外 | EC、複数店舗管理、本格会計連携、仕入れ先とのシステム連携 | [[specdojo:prj-scope-sample\|スコープ]] |
49
+ | 未確定 | オフライン時の扱い、リリース目標日、費用上限 | 「未決事項」 |
53
50
 
54
- 成果物群と、憲章承認後に作成・詳細化する文書の一覧は、成果物カタログ(`dct-index`)を正とする。
51
+ 成果物群と憲章承認後に作成する文書は [[specdojo:dct-index-sample|成果物カタログ索引]] を正とする。
55
52
 
56
53
  ## 4. 初期ステークホルダー
57
54
 
58
- | ID | 関係者 | 関与区分 | 対応 Role code | 認可判断における主な責任 |
59
- | ----------------------- | -------------- | -------------------------------- | -------------- | ------------------------------------------------ |
60
- | `STH-OWNER` | 店主代表 | スポンサー / 意思決定者 / 利用者 | `PO` | 目的、優先順位、予算枠、リリース可否を判断する |
61
- | `STH-FAMILY-USER` | 家族利用者代表 | 利用者 | `BA` | 店番時の操作性と引継ぎ方法を確認する |
62
- | `STH-DEVELOPMENT` | 開発担当 | 実行担当者 | `PM` | 合意した対象範囲に従い、計画と変更影響を共有する |
63
- | `STH-REGULAR-CUSTOMERS` | 常連客 | 影響受容者 | なし | つけ残高や販売方法の変更から影響を受ける |
64
- | `STH-SUPPLIER` | 仕入れ先 | 外部協力者 | なし | 初期リリースでは現行連絡を継続する |
65
-
66
- 詳細は [ステークホルダー登録簿サンプル](prj-stakeholder-register-sample.md) を参照する。
55
+ | ID | 関係者 | 関与区分 | 対応 Role code | 認可判断における主な責任 |
56
+ | ----------------- | ------------ | ----------------------- | -------------- | ---------------------------------------------- |
57
+ | `STH-SHOP-OWNER` | 店主代表 | スポンサー / 意思決定者 | `PO` | 目的、優先順位、予算枠、リリース可否を判断する |
58
+ | `STH-DEVELOPER` | 開発担当 | 実行担当者 | `DEV` | 認可範囲で計画を作り、変更影響を店主に示す |
59
+ | `STH-TECH-MENTOR` | 技術メンター | 外部協力者 | - | 設計方針を助言する |
60
+ | `STH-FAMILY-USER` | 家族利用者 | 利用者 / 影響受容者 | - | 店番時の操作性と引継ぎ方法を確認する |
67
61
 
68
62
  ## 5. 権限委譲
69
63
 
70
- | 項目 | 決裁者 | 実行責任者 | 協議先 | 証跡 |
71
- | ------------ | ---------------- | ---------------- | -------------- | -------------------- |
72
- | 立ち上げ認可 | 店主代表(`PO`) | 開発担当(`PM`) | 家族利用者代表 | 本書の承認履歴 |
73
- | 詳細計画策定 | 店主代表(`PO`) | 開発担当(`PM`) | 家族利用者代表 | `pm-plan`、議事録 |
74
- | 本格実行開始 | 店主代表(`PO`) | 開発担当(`PM`) | 家族利用者代表 | GO / Not GO 決定記録 |
75
-
76
- 次の事項は店主代表(`PO`)の承認を必要とする。
64
+ | 項目 | 決裁者 | 実行責任者 | 協議先 | 証跡 |
65
+ | ------------ | ---------------- | ----------------- | ---------- | -------------------- |
66
+ | 立ち上げ認可 | 店主代表(`PO`) | 開発担当(`DEV`) | 家族利用者 | 「承認」の表 |
67
+ | 詳細計画策定 | 店主代表(`PO`) | 開発担当(`DEV`) | 家族利用者 | 計画の承認記録 |
68
+ | 本格実行開始 | 店主代表(`PO`) | 開発担当(`DEV`) | 家族利用者 | GO / Not GO 決定記録 |
77
69
 
78
- - 初期対象範囲の変更
79
- - 費用上限の確定または増額
80
- - 外部サービス利用や機材購入
81
- - 公開可否または公開対象の変更
82
- - 本格実行開始の判断
70
+ 店主代表に留保する判断は、初期対象範囲の変更、費用上限の確定・増額と外部サービス・機材への支出、公開可否と公開対象、ライセンス方針の確定、本格実行開始とする。
83
71
 
84
72
  ## 6. 主要前提・制約
85
73
 
86
- 前提・制約の全量は `prj-assumptions-constraints-dependencies` を正とし、本書では認可判断に直結する事項だけを示す。
87
-
88
- | 区分 | 内容 | 詳細化先 |
89
- | ---- | -------------------------------------------------------------------------------------- | ------------------------------------------ |
90
- | 前提 | 店主代表が業務の最終判断を行い、システムは記録と確認を支援する | `prj-assumptions-constraints-dependencies` |
91
- | 制約 | 費用上限は _UNDECIDED_: 詳細計画策定時に店主代表が承認する。承認前の外部支出は行わない | 未決事項 |
92
- | 制約 | 顧客情報は必要最小限にし、公開サンプルには個人情報を含めない | `prj-assumptions-constraints-dependencies` |
74
+ | 区分 | 内容 | 詳細化先 |
75
+ | ---- | ---------------------------------------------------------------------------- | ------------------------------------------------------------------------ |
76
+ | 前提 | 業務の最終判断は店主代表が行い、システムは記録と確認を支援する | [[specdojo:prj-assumptions-constraints-dependencies-sample\|前提・制約]] |
77
+ | 制約 | 費用上限は _UNDECIDED_。確定するまで外部支出を行わない | 「未決事項」 |
78
+ | 制約 | 顧客情報は最小限にし、公開文書に個人情報、秘密情報、非公開組織情報を含めない | [[specdojo:prj-assumptions-constraints-dependencies-sample\|前提・制約]] |
93
79
 
94
80
  ## 7. 本格実行開始の GO / Not GO 判断
95
81
 
96
- 本書の承認後、次の観点が確認できるまで、本格実行開始と外部公開の最終判断は保留する。
82
+ 合格条件を満たさない観点が残る間は、本格実行開始と外部公開を保留する。
97
83
 
98
- | 判断観点 | 確認内容 | 記録先 |
99
- | -------- | ---------------------------------------------------------------- | ----------------------------- |
100
- | 目的整合 | 成果物体系、公開対象、優先順位がプロジェクトの目的と矛盾しない | `pm-plan` / 決定記録 |
101
- | 公開適性 | 公開してよい情報だけで構成され、公開範囲が承認されている | 決定記録 / Pull Request |
102
- | 予算枠 | 追加支出、外部サービス利用、運用負担の上限が承認されている | 決定記録 |
103
- | 体制 | PO、PM、BA の責任範囲が確認できる | `pm-organization` / `pm-raci` |
104
- | 品質 | 初期公開に必要な rulebook、recipe、sample、template が整っている | `pm-quality-management-plan` |
84
+ | 判断観点 | 確認内容 | 合格条件 | 記録先 |
85
+ | -------- | ----------------------------------------------- | ----------------------------------------------------- | ------------------------------------------------------------ |
86
+ | 目的整合 | 優先機能と公開対象 | すべてが概要の目的に対応し、店主代表が確認済み | [[specdojo:pm-plan-sample\|管理計画]]、決定記録 |
87
+ | 公開適性 | 公開する文書 | 公開禁止の情報を含まず、公開範囲が承認済み | 決定記録、Pull Request |
88
+ | 予算枠 | 支出と運用負担 | 費用上限が承認済みで、計画の支出が上限内 | 決定記録 |
89
+ | 体制 | 責任の割り当て | 各作業の責任者が 1 人に決まり、承認の決裁者が店主代表 | [[specdojo:pm-raci-sample\|RACI]] |
90
+ | 品質 | 初期公開する rulebook、recipe、sample、template | 品質管理計画の初期公開条件をすべて満たす | [[specdojo:pm-quality-management-plan-sample\|品質管理計画]] |
105
91
 
106
92
  ## 8. 承認
107
93
 
@@ -109,13 +95,10 @@ specdojo:
109
95
  | ----------- | ---------------- | ---------------------------------------------- | ----------- |
110
96
  | _UNDECIDED_ | 店主代表(`PO`) | 立ち上げ認可、詳細計画策定と初期準備の権限委譲 | _UNDECIDED_ |
111
97
 
112
- 本書はドラフトであり、承認日と証跡リンクが確定するまでは正式な立ち上げ認可文書として扱わない。
113
-
114
98
  ## 9. 未決事項
115
99
 
116
- | 論点 | 期限 | 担当 | 対応方針 |
117
- | ------------------ | ----------- | ---------------- | --------------------------------------------------------------- |
118
- | 初回承認日 | _UNDECIDED_ | 店主代表(`PO`) | 憲章初版の承認時に記録する |
119
- | 費用上限 | _UNDECIDED_ | 店主代表(`PO`) | 詳細計画策定時に外部支出と機材購入の要否を確認する |
120
- | リリース目標日 | _UNDECIDED_ | 開発担当(`PM`) | スコープと見積もりを確認したうえで店主代表と合意する |
121
- | オフライン時の扱い | _UNDECIDED_ | 開発担当(`PM`) | 初期スコープに含めるか、対象外にするかを `prj-scope` で整理する |
100
+ | 論点 | 影響 | 当面の扱い |
101
+ | ------------------ | ------------------------------ | ---------------------------------------------------- |
102
+ | 費用上限 | 詳細計画と予算枠を判定できない | 詳細計画の承認前に確定する |
103
+ | リリース目標日 | マイルストーンを置けない | 見積もりの後、GO / Not GO の前に店主代表と合意する |
104
+ | オフライン時の扱い | 対象範囲と見積もりが変わる | 詳細計画の承認前に、スコープで対象か対象外かを決める |