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
@@ -11,177 +11,142 @@ specdojo:
11
11
 
12
12
  Project Charter Writing Recipe
13
13
 
14
- 本書は、プロジェクト憲章を、PO が立ち上げ認可、権限委譲、予算枠、後続判断条件を判断できる内容に仕上げるための作り方である。本書では問い、深掘り、具体化、レビュー観点を扱う。
14
+ プロジェクト憲章を、承認責任者が立ち上げ認可・権限委譲・予算枠・後続判断条件を判断できる内容に仕上げるための作り方を示す。
15
15
 
16
16
  ## 1. このレシピの使い方
17
17
 
18
- - 最初に、プロジェクト概要から目的、必要性、期待効果、主要前提を抜き出す。
19
- - 次に、ステークホルダー登録簿から、承認者、実行責任者、利用者、影響受容者、AI Agent などの関係者を確認する。
20
- - 認可する範囲と、まだ認可しない範囲を分けて書く。
21
- - 最後に、PM などへ委譲する権限、PO 承認が必要な事項、予算枠、GO / Not GO 判断条件、未決事項をそろえる。
22
- - 目的・必要性・期待効果(Why)、今回認可する範囲と後続判断条件(What)、権限委譲・予算枠・GO / Not GO(How)を整理し、直接根拠、承認者、承認日、証跡リンクで追跡する(Trace)。成功判定や詳細スコープは後続文書へ委譲する。
18
+ - 憲章は、プロジェクト概要の目的・期待効果(Why)を引き継ぎ、今回認可する範囲と後続判断条件(What)を定め、権限委譲・予算枠・GO / Not GO(How)を決める。認可は承認者・承認日・証跡リンクでたどれるようにする(Trace)。
19
+ - 「作成前に集める情報」をメモでそろえてから、「全体の作成手順」の順に書く。
20
+ - 書き終えたら「レビュー観点」で読み直し、「仕上げチェック」で確かめる。
23
21
 
24
22
  ## 2. 作成前に集める情報
25
23
 
26
- | 項目 | 集める情報 |
27
- | ---------------- | ------------------------------------------------------------------ |
28
- | 目的と期待効果 | 何のために立ち上げるか、承認で期待する効果は何か |
29
- | 直接根拠 | プロジェクト概要、ステークホルダー登録簿など、認可判断に使う文書 |
30
- | 認可対象 | 立ち上げ、詳細計画、初期準備など、今回認める行為 |
31
- | 認可しない範囲 | 本格実行、外部公開、主要投資、主要変更など、後続判断に回す事項 |
32
- | 関係者 | PO、スポンサー、PM、利用者、影響受容者、支援者 |
33
- | 権限委譲 | 誰に、どの範囲の実行権限または判断権限を渡すか |
34
- | 予算枠 | 承認済み費用、追加支出の可否、外部サービス利用、未確定なら確定時期 |
35
- | 承認情報 | 承認者、承認日、証跡リンクの扱い、未承認時の記載方針 |
36
- | GO / Not GO 条件 | 本格実行や公開へ進む前に満たす条件と記録先 |
37
- | 未決事項 | 承認前または後続判断前に決める論点、担当、期限 |
24
+ | 項目 | 集める情報 | 取り出し元 |
25
+ | ------------------------ | ----------------------------------------------------------------------- | ---------------------- |
26
+ | 目的と期待効果 | 目的の 1 文、承認で期待する効果 | プロジェクト概要 |
27
+ | 関係者 | 承認責任者、実行責任者、協議先、影響受容者、AI Agent の関与 | ステークホルダー登録簿 |
28
+ | 認可する行為・しない行為 | 立ち上げ・詳細計画・初期準備と、本格実行・外部公開・主要投資・主要変更 | 承認責任者への確認 |
29
+ | 権限と予算枠 | 委譲する判断、留保する判断、承認済みの費用、追加支出の可否と確定時期 | 承認責任者への確認 |
30
+ | 承認の証跡 | 承認の意思と承認した文書の状態を示す記録(決定記録、Pull Request など) | 決定記録 |
31
+ | 未決の論点 | 後続判断までに決める論点と、その影響 | 確認の過程のメモ |
38
32
 
39
33
  ## 3. 全体の作成手順
40
34
 
41
- 1. H1 と冒頭文で、対象プロジェクト名、憲章の目的、認可しない範囲、承認責任者を明示する。
42
- 2. 認可対象を表にし、今回認可する範囲と認可しない範囲を分ける。
43
- 3. プロジェクト概要を根拠に、目的と期待効果を短く要約し、成功判定は成功基準文書へ委譲する。
44
- 4. ハイレベルスコープを概要レベルで書き、成果物群と後続文書の一覧は成果物カタログへ委譲する。
45
- 5. ステークホルダー登録簿から、認可判断に関係する初期ステークホルダーを要約する。
46
- 6. 権限委譲表を作り、委譲する事項と PO 承認が必要な事項を分ける。
47
- 7. 主要前提・制約に、公開適性、人間の判断責任、予算枠を含め、全量は前提・制約・依存関係文書へ委譲する。
48
- 8. GO / Not GO 判断条件と記録先を整理する。
49
- 9. 承認履歴と未決事項を記入し、未確定事項を確定済みのように書いていないか確認する。
35
+ 1. 認可対象を最初に書き、認めることと認めないことを分ける。ここが決まらないと、ほかの章の範囲が決まらない。
36
+ 2. プロジェクトの目的を、概要から 1〜2 文で要約する。
37
+ 3. ハイレベルスコープで、対象・対象外・未確定を分ける。
38
+ 4. 初期ステークホルダーを、登録簿から認可判断に関係する分だけ要約する。
39
+ 5. 権限委譲で、委譲する判断と承認責任者に留保する判断を分ける。
40
+ 6. 主要前提・制約に、予算枠・公開適性・人間の判断責任を書く。
41
+ 7. 本格実行開始の GO / Not GO 判断の観点と記録先を書く。
42
+ 8. 承認と未決事項を書く。
43
+ 9. 最後に H1 直下の冒頭文を書く。認可対象と権限委譲が決まってから書くと、本文の言い直しにならない。
50
44
 
51
45
  ## 4. 各章の書き方
52
46
 
53
- ### 4.1. 冒頭文と認可対象
47
+ ### 4.1. 認可対象
54
48
 
55
49
  問い:
56
50
 
57
- - この憲章は、何を立ち上げることを認めるのか。
58
- - どの活動は、まだ認可していないのか。
59
- - 誰が最終判断と説明責任を持つのか。
51
+ - 今回、何を始めてよいと認めるのか。
52
+ - 承認しても、まだ始めてはいけない活動は何か。
60
53
 
61
- 書き方:
54
+ コツ:
62
55
 
63
- - 「立ち上げ認可」「詳細計画策定」「初期準備」を基本の認可対象にする。
64
- - 本格実行、外部公開、主要投資、主要変更は、後続判断で扱う場合が多い。
65
- - 直接根拠は、本文の判断に実際に使った文書だけを列挙する。
56
+ - 承認責任者に「承認の直後に始めてよいこと」を聞くと、認可対象と認可しない範囲が一度に分かれる。
57
+ - 直接根拠には、本文の判断に実際に使った文書だけを挙げる。憲章の後に作る計画書を根拠に入れやすいので注意する。
66
58
 
67
59
  ### 4.2. プロジェクトの目的
68
60
 
69
61
  問い:
70
62
 
71
- - 放置すると何が困るのか。
72
- - 立ち上げることで、誰のどの状態を改善するのか。
73
- - PO はどの期待効果を見て承認、保留、差し戻しを判断するのか。
63
+ - 放置すると、誰が何に困るのか。
64
+ - 承認責任者は、どの期待効果を見て承認・保留を決めるのか。
74
65
 
75
- 書き方:
66
+ コツ:
76
67
 
77
- - 冒頭は 1〜2 文の要約に留め、背景、必要性、目的の詳細はプロジェクト概要への参照で示す。
78
- - 期待効果は、仕様共有、業務価値、透明性、継続性など、判断に使える観点へ分ける。
79
- - 数値目標、測定方法、中長期指標はプロジェクト概要の期待効果を正とし、憲章では再掲しない。
68
+ - 概要の本文や指標表を写したくなったら、概要への参照に置き換える。
69
+ - 期待効果は、仕様共有・業務価値・透明性・継続性など、承認の判断に使う観点へ分ける。
80
70
 
81
71
  ### 4.3. ハイレベルスコープ
82
72
 
83
73
  問い:
84
74
 
85
- - 立ち上げ時点で対象に含める活動領域は何か。
86
- - 明示的に対象外にするものは何か。
87
- - 詳細をどの後続文書へ委譲するか。
75
+ - 立ち上げ時点で含める活動と、明示的に外す活動は何か。
76
+ - 決めきれない範囲はどれか。
88
77
 
89
- 書き方:
78
+ コツ:
90
79
 
91
- - 憲章では対象、対象外、未確定の区分に留め、詳細スコープ、受入条件、設計詳細は後続文書へ委譲する。
92
- - 成果物群・後続文書の一覧は成果物カタログを、成功判定の観点と受入条件は成功基準文書を正として参照し、章として列挙しない。
93
- - 未確定の範囲を隠さず、未決事項または詳細化先へつなげる。
80
+ - 成果物の一覧や受入条件を書き始めたら、詳細化先への参照に戻す。
81
+ - 決めきれない範囲は隠さず未確定に置き、未決事項へつなげる。
94
82
 
95
83
  ### 4.4. 初期ステークホルダー
96
84
 
97
85
  問い:
98
86
 
99
- - 誰が承認し、誰が実行し、誰が利用または影響を受けるか。
100
- - AI Agent は支援者としてどの範囲に関わるか。
101
- - 公開文書に記載してよい識別方法になっているか。
87
+ - 誰が承認し、誰が実行し、誰が影響を受けるか。
88
+ - AI Agent は、どの範囲を支援するか。
102
89
 
103
- 書き方:
90
+ コツ:
104
91
 
105
- - ステークホルダー登録簿から、認可判断に関係する主要関係者だけを要約する。
106
- - 個人名や連絡先ではなく、役割名、集団名、Role code を用いる。
107
- - AI Agent を承認者または責任者にせず、人間の PO が最終判断することを明示する。
92
+ - 個人名や連絡先ではなく、役割名・集団名で書く。登録簿から写すと公開できない識別子が紛れやすい。
93
+ - AI Agent は草案作成と整合確認の支援者とし、承認者や責任者の欄に入れない。
108
94
 
109
95
  ### 4.5. 権限委譲と主要前提・制約
110
96
 
111
97
  問い:
112
98
 
113
- - PM や実行責任者へ、何を任せるのか。
114
- - PO が引き続き承認する事項は何か。
115
- - 予算枠、公開可否、ライセンス、主要変更はどの扱いか。
99
+ - 実行責任者に任せる判断と、承認責任者が持ち続ける判断はどれか。
100
+ - 予算はどこまで使えるか。追加支出を認めるか。
116
101
 
117
- 書き方:
102
+ コツ:
118
103
 
119
- - 決裁者、実行責任者、協議先、証跡を表でそろえる。
120
- - 予算枠が未確定なら、追加支出の可否と確定タイミングを書く。
121
- - 公開適性、人間の判断責任、秘密情報を扱わない制約を明示する。
104
+ - 「PM に任せる」の 1 行で済ませず、判断ごとに決裁者と証跡を聞く。
105
+ - 金額が決まらない場合は、「追加支出なし」「外部支出は未承認」などの支出の扱いと、確定する時期を聞いて書く。
122
106
 
123
107
  ### 4.6. GO / Not GO 判断、承認、未決事項
124
108
 
125
109
  問い:
126
110
 
127
- - 本格実行や外部公開へ進む前に何を確認するか。
128
- - 判断結果はどこに記録するか。
129
- - 承認済みと言えるだけの承認者、日付、証跡があるか。
111
+ - 本格実行や外部公開の前に、何がそろえば進めてよいか。
112
+ - 承認の意思と承認した文書の状態を、どの記録で示せるか。
130
113
 
131
- 書き方:
114
+ コツ:
132
115
 
133
- - GO / Not GO 判断には、目的整合、公開適性、予算枠、体制、品質を含める。
134
- - 承認履歴は、未承認なら未承認と分かる状態で残す。版番号は管理せず、承認対象の文書状態は証跡リンクで特定する。
135
- - 証跡リンクには、承認の意思表示と承認対象の文書状態を特定できる記録(決定記録、Pull Request など)を書く。
136
- - 承認者、承認日、証跡リンクが未確定なら、正式認可済みと書かず _UNDECIDED_ を残す。
137
- - 未決事項は「論点、期限、担当、対応方針」をそろえ、放置しない。
116
+ - 未決事項のうち本格実行の前に解消が要るものは、GO / Not GO の合格条件へ移す。
117
+ - 承認の記録がまだなければ承認済みと書かず、_UNDECIDED_ を残す。
138
118
 
139
119
  ## 5. 深掘り手順
140
120
 
141
- 内容が浅い場合は、次の順で具体化する。
121
+ 内容が浅いときは、次の順で対応のない主張を探す。
142
122
 
143
- 1. プロジェクト概要の目的文を 1 文に要約し、憲章冒頭に置く。
144
- 2. 「今回認めること」と「まだ認めないこと」を左右に分けて列挙する。
145
- 3. 主要ステークホルダーについて、承認者、実行責任者、協議先、影響受容者へ分類する。
146
- 4. PM に委譲してよい判断と、PO が保持すべき判断を仕分ける。
147
- 5. 予算枠を、金額、追加支出なし、外部支出未承認、運用負担上限などの形で明文化する。
148
- 6. 本格実行や公開前に未決事項を解消する条件を GO / Not GO 判断に移す。
149
- 7. 詳細スコープ、設計、受入条件を書きすぎている箇所を後続文書へ戻す。
123
+ 1. 認可対象の各行が、目的のどの期待効果に応えるかを確かめ、対応のない行を外す。
124
+ 2. 権限委譲の各行が、どの認可対象を進める権限かを確かめる。
125
+ 3. 未決事項ごとに、認可と GO / Not GO のどちらに効くかを確かめる。
126
+ 4. 詳細スコープ・設計・受入条件を書きすぎた箇所を、詳細化先への参照に戻す。
150
127
 
151
128
  ## 6. 良い例 / 悪い例
152
129
 
153
130
  | 観点 | 良い例 | 悪い例 |
154
131
  | -------------- | ------------------------------------------------------ | ---------------------------------- |
155
132
  | 認可対象 | 「立ち上げ、詳細計画策定、初期準備を認可する」と書く | 「プロジェクトを進める」とだけ書く |
156
- | 目的の要約 | 1〜2 文で要約し、詳細はプロジェクト概要を正とする | 概要の本文や指標表を丸写しする |
157
- | 認可しない範囲 | 「外部公開と主要支出は別途 PO が判断する」と書く | 承認範囲を広く曖昧にする |
158
- | 権限委譲 | 決裁者、実行責任者、証跡を表で示す | 「PM に任せる」とだけ書く |
159
- | 予算枠 | 「追加支出は未承認。上限は詳細計画で PO が確定」と書く | 費用に触れない |
160
- | AI Agent | 「草案作成と整合確認を支援し、承認しない」と書く | AI Agent を判断者として扱う |
161
- | 承認 | 未承認なら _UNDECIDED_ とし、正式認可済みと書かない | 承認者未記載で承認済みとする |
133
+ | 認可しない範囲 | 「外部公開と主要支出は別途承認責任者が判断する」と書く | 承認範囲を広く曖昧にする |
134
+ | 権限委譲 | 判断ごとに決裁者、実行責任者、証跡を示す | 「PM に任せる」とだけ書く |
135
+ | 予算枠 | 「追加支出は未承認。上限は詳細計画で承認責任者が確定」 | 費用に触れない |
162
136
 
163
137
  ## 7. レビュー観点
164
138
 
165
- | 観点 | 確認内容 |
166
- | -------- | ---------------------------------------------------------------- |
167
- | 目的整合 | プロジェクト概要の目的、必要性、期待効果と矛盾していないか |
168
- | 承認判断 | PO が承認、保留、差し戻しを判断できる認可対象と未決事項があるか |
169
- | 権限範囲 | 委譲する権限と PO 承認事項が分離されているか |
170
- | 予算枠 | 費用、追加支出、外部サービス利用、未確定時の確定方法が分かるか |
171
- | 承認記録 | 承認者、承認日、証跡リンク、未承認時の扱いが明示されているか |
172
- | 関係者 | ステークホルダー登録簿と整合し、個人情報や非公開情報がないか |
173
- | 公開適性 | 公開してよい情報だけで構成され、人間の説明責任を前提にしているか |
174
- | 責務分担 | 詳細スコープ、設計、受入条件、会議運営を書きすぎていないか |
175
- | 証跡 | 承認、GO / Not GO、主要変更の記録先があるか |
139
+ | 観点 | 確認内容 |
140
+ | ---------- | ---------------------------------------------------------------- |
141
+ | 目的整合 | 期待効果がプロジェクト概要の目的と食い違っていないか |
142
+ | 認可の境界 | 承認責任者が認可・保留・差し戻しを判断できる範囲になっているか |
143
+ | 権限範囲 | 委譲と留保が判断ごとに分かれ、決裁者と証跡があるか |
144
+ | 関係者 | 登録簿と整合し、個人情報や公開できない情報がないか |
145
+ | 委譲の境界 | 詳細スコープ・設計・受入条件を詳細化先へ委ね、書きすぎていないか |
176
146
 
177
147
  ## 8. 仕上げチェック
178
148
 
179
- - 「全体の作成手順」で示した章立てがそろっている。
180
- - 必須表のカラムがすべて埋まっている。
181
- - 直接根拠、認可対象、認可しない範囲、承認責任が書かれている。
182
- - 予算枠または未確定時の扱いが書かれている。
183
- - 承認者、承認日、証跡リンクが未確定なら、正式認可済みと書いていない。
184
- - AI Agent を承認者にせず、人間の PO が最終判断する前提になっている。
185
- - 正式認可済みと書く場合は、承認者、承認日、証跡リンクがある。
186
- - 公開不適切な情報、設計詳細、受入条件の過剰記載がない。
187
- - 各認可対象が目的・期待効果に対応し、権限・条件・承認証跡まで追跡できる。
149
+ - 認可対象の各行が目的の期待効果に対応し、権限委譲と承認の証跡までたどれる。
150
+ - 予算枠が、金額または支出の扱いと確定時期で書かれている。
151
+ - 承認の証跡がないのに、正式認可済みと書いていない。
152
+ - AI Agent を承認者や責任者にしていない。
@@ -11,48 +11,36 @@ specdojo:
11
11
 
12
12
  Comparison of Alternatives Writing Recipe
13
13
 
14
- 本ドキュメントは、代替案比較を「採択案、非採択案、技術的影響、見直し条件を説明できる内容」に仕上げるための作り方です。
15
- 本書では問い、深掘り手順、具体化のコツ、レビュー観点を扱います。
14
+ 代替案比較を、採択・非採択の理由と見直し条件を後から再現できる内容に仕上げるための作り方を示す。
16
15
 
17
16
  ## 1. このレシピの使い方
18
17
 
19
- - 最初に、スコープ、課題と解決アプローチ、前提・制約から、解くべき課題、必要能力、制約、評価条件を抜き出す。
20
- - 次に、意思決定を比較レイヤーへ分け、候補カテゴリと選定基準を決めてから具体候補を調査する。
21
- - 標準・方法論と製品・ツールを区別し、同じ意思決定を代替できる候補を各レイヤーで最低 2 案に広げる。
22
- - 最後に、採択、比較試行、保留、非採択、技術的影響、再評価条件を残し、判断の再現性を確保する。
23
- - 解くべき課題と必要能力(Why)、同じ意思決定と評価条件(What)、候補案・採択方針・軽減策(How)を整理し、決定 ID、課題 ID、評価理由、根拠資料、記録先で追跡する(Trace)。後続の設計詳細は比較結果から委譲する。
18
+ - 代替案比較は、課題と解決アプローチの課題・必要能力(Why)を引き継ぎ、決定 ID ごとに決めることと評価条件(What)を定め、候補案・採否・軽減策(How)を示す。採否は決定 ID・案 ID・課題 ID でたどれるようにする(Trace)。
19
+ - 「作成前に集める情報」をメモでそろえてから、「全体の作成手順」の順に書く。
20
+ - 書き終えたら「レビュー観点」で読み直し、「仕上げチェック」で確かめる。
24
21
 
25
22
  ## 2. 作成前に集める情報
26
23
 
27
- 最初から比較表を書かず、以下を短いメモで集める。
28
-
29
- | 項目 | 集める情報 |
30
- | -------------- | --------------------------------------------------------------- |
31
- | 比較目的 | 何を決めるための比較か、どの判断を支援するか |
32
- | 根拠資料 | スコープ、課題と解決アプローチ、前提・制約、関連する決定事項 |
33
- | 必要能力 | 課題を解くために必要な能力。特定の解決手段とは分けて集める |
34
- | 決定と順序 | 解決方式、購入 / 構築、製品など、先に決めることと後で決めること |
35
- | 代替案 | 同じ課題を解決できる一式の案 |
36
- | 比較レイヤー | 業務運用、解決方式、購入 / 構築、製品、開発方式など |
37
- | 候補カテゴリ | 非システム、汎用ツール、既存製品、個別構築など |
38
- | 候補選定根拠 | 公式資料で確認した責務、保管場所、対応環境、移行可能性 |
39
- | 評価軸 | 効果、コスト、期間、リスク、運用適合、技術実現性 |
40
- | 技術的成立条件 | 既存資産、外部依存、制約、後続成果物への影響 |
41
- | 採択判断者 | 最終判断を行う人間の責任ロール。通常は `PO` |
42
- | 再評価条件 | 方針を見直すトリガー、次に確認する指標、記録先 |
43
- | 正本・撤退条件 | 正しい情報源、同期方向、試行や外部ツールをやめる方法 |
24
+ 最初から比較表を書かず、次を短いメモで集める。
25
+
26
+ | 項目 | 集める情報 | 取り出し元 |
27
+ | ---------------- | ----------------------------------------------------------- | ------------------------------ |
28
+ | 課題と必要能力 | 解くべき課題の ID、課題を解くのに要る能力(手段とは分ける) | 課題と解決アプローチ |
29
+ | 範囲と対象外 | 比較に含める範囲、初期に優先する最小成立範囲、対象外 | スコープ |
30
+ | 制約と外部依存 | 予算・期間・端末・既存資産・判断責任の制約 | 前提・制約・依存関係 |
31
+ | 決めることと順序 | 先に決める判断と、その結果で要否が変わる判断 | 最終判断者への確認 |
32
+ | 候補と選定根拠 | 現行方式、外部の直接競合、責務・保管場所・移行可能性 | 公式資料、現場の担当者への確認 |
33
+ | 測れる値 | 操作時間、記録漏れ件数、費用など判定境界に使える実測値 | 現行運用の記録、試行 |
44
34
 
45
35
  ## 3. 全体の作成手順
46
36
 
47
- 1. H1 で比較対象の成果物名またはプロジェクト名を明示する。
48
- 2. 比較目的と前提条件で、決定 ID、判断順序、比較レイヤー、扱わない範囲を書く。
49
- 3. 前段文書から課題・制約・必要能力を抽出し、レイヤーごとの候補カテゴリと選定基準を定める。
50
- 4. 公式資料を調査し、現行方式、外部の直接競合、採用しない案を含む具体候補へ絞る。
51
- 5. 比較対象案で、同じ意思決定に属する候補を、ID、責務、強み、制約を揃えて並べる。
52
- 6. 評価軸と評価基準を比較レイヤーごとに定義し、同一レイヤー内では固定する。
53
- 7. 比較結果で、採択、一部採択、比較試行、保留、非採択と再評価条件を説明する。
54
- 8. 製品・サービスはデータの正本、移行、ロックイン、撤退方法を含めて技術的影響を示す。
55
- 9. リスクとトレードオフ、最終判断者、再評価条件、記録先を明示する。
37
+ 1. 比較目的と前提条件で、決定 ID と判断順序を先に決める。上位の判断(解決方式、購入 / 構築)が決まらないと、製品を比べる必要があるかが決まらない。
38
+ 2. 候補カテゴリと選定基準を定めてから、比較対象案を調べる。具体名から始めると、知っている製品だけが並ぶ。
39
+ 3. 評価軸と評価基準を、候補の評価より先に固定する。候補を見てから軸を選ぶと、結論に合わせた軸になる。
40
+ 4. 比較結果と採択理由を書き、技術的実現性と影響、比較試行の完了条件を添える。
41
+ 5. リスクとトレードオフに、採択案の不利な点と軽減策を書く。
42
+ 6. 決定と見直しに、採否の要約、最終判断者、再評価トリガー、記録先を書く。
43
+ 7. 最後に H1 直下の冒頭文を書く。採否が決まってから書くと、本文の言い直しにならない。
56
44
 
57
45
  ## 4. 各章の書き方
58
46
 
@@ -60,176 +48,110 @@ Comparison of Alternatives Writing Recipe
60
48
 
61
49
  問い:
62
50
 
63
- - この比較で、どの判断を支援するのか。
64
- - 業務運用、解決方式、購入 / 構築、製品、開発方式のどの比較レイヤーを扱うのか。
65
- - 対象プロジェクトの業務課題・利用者課題を直接解く判断になっているか。
66
- - 複数の判断がある場合、どれを先に決め、後続判断へ何を引き継ぐのか。
67
- - 比較対象に含める範囲と、含めない範囲は何か。
68
- - 根拠資料から引き継ぐ課題、必要能力、制約、評価条件は何か。
69
- - 根拠資料が示す対象外範囲や、初期段階で優先する最小成立範囲は、前提条件に引き継いでいるか。
51
+ - この比較で、どの判断を支援し、何を決めないのか。
52
+ - 複数の判断がある場合、どれを先に決め、後の判断へ何を引き継ぐのか。
70
53
 
71
- 書き方:
54
+ コツ:
72
55
 
73
- - 比較目的は 1〜2 文で書き、設計詳細や実装方式の説明に寄せすぎない。
74
- - 根拠資料は、直接判断に使う文書に絞る。
75
- - 未確定事項は _TODO_ / _UNDECIDED_ / _ASSUMPTION_ で明示する。
76
- - 対象外とする範囲や、全体を一度に完成させきれない場合の扱いがあれば、前提条件で明示する。
77
- - 複数レイヤーには `D-01` のような決定 ID を付け、各決定で扱わない範囲も書く。
56
+ - 最終判断者に「この比較が終わったら次に何を決めるか」を聞くと、判断の順序と決めないことが一度に分かれる。
57
+ - 課題や範囲の本文を写したくなったら、課題と解決アプローチ・スコープへの参照に置き換える。
78
58
 
79
59
  ### 4.2. 比較対象案
80
60
 
81
61
  問い:
82
62
 
83
- - 同じ目的を達成しうる案が最低 2 案あるか。
84
- - 各案の対象範囲は同じ粒度で説明できているか。
85
- - 各案は単独でも目的達成への道筋を説明できるか。
63
+ - 各案は、単独でも同じ課題を解く一式の案になっているか。
86
64
  - 現行案と根拠の異なる、採択しない可能性がある有力な外部案を含めたか。
87
- - 業務方式、製品、開発方式など抽象度の異なる候補を混在させていないか。
88
- - 具体候補より先に、候補カテゴリと選定基準を定めたか。
89
- - 「代表的」「標準」と呼ぶ根拠があるか。ない場合は比較候補と表現しているか。
90
-
91
- 書き方:
92
-
93
- - 案 ID は `ALT-01` のように安定した形式にし、複数レイヤーを扱う場合はレイヤーを識別できる prefix を使う。
94
- - 案名は手段だけでなく、優先する方針が分かる名前にする。
95
- - 対象範囲には、成果物、活動、機能、運用範囲を混在させすぎない。
96
- - 前段文書の案 ID を再掲する場合も、それだけで候補を閉じず、外部調査で得た候補を追加する。
97
- - 相互に組み合わせる要素は、業務運用を含む一式の解決案へまとめる。
98
- - 購入 / 構築の比較と具体製品の比較を分け、上位判断で必要性が残った場合だけ製品比較へ進む。
99
- - 開発戦略や作業管理は、プロジェクト運営そのものが比較目的の場合だけ主レイヤーにする。
100
- - 候補カテゴリは、非システム対応 / 汎用ツール / 既存製品 / 個別構築など、課題解決への道筋が異なる単位で分ける。
101
- - 公式資料から責務、データ保管、対応環境、移行可能性を確認し、市場占有率を調べていない候補を市場代表と断定しない。
65
+
66
+ コツ:
67
+
68
+ - 前段文書の案を並べ直すだけで終わりやすい。カテゴリ(非システム、汎用ツール、既存製品、個別構築など)ごとに 1 つ以上探す。
69
+ - 画面・データ・ツールなど組み合わせて使う部品を別案に分けたくなったら、業務運用を含む一式の案にまとめる。
70
+ - 市場占有率を調べていない候補は「代表」「標準」と呼ばず、比較候補と書く。
102
71
 
103
72
  ### 4.3. 評価軸と評価基準
104
73
 
105
74
  問い:
106
75
 
107
- - 評価軸は案ごとに変わっていないか。
108
- - 業務価値、意思決定、技術制約、リスクの観点が揃っているか。
109
- - 利用者適合、業務継続、データ移行、保守、将来変更を評価できるか。
110
- - `High` / `Middle` / `Low` の判定理由を説明できるか。
111
- - 評価軸は、根拠資料の課題 ID や業務価値のどの項目に対応するか説明できるか。
76
+ - 各評価軸は、どの課題 ID・制約から来ているか。
77
+ - `High` / `Middle` / `Low` の境界を、測定値または観察できる状態で言えるか。
112
78
 
113
- 書き方:
79
+ コツ:
114
80
 
115
- - 効果、コスト、期間、リスク、運用適合、技術実現性を最低ラインにし、比較目的に応じて適応性、追跡性、AI 適合、成熟度を追加する。
116
- - 重みを使う場合は、重みの理由を備考に書く。
117
- - 低いほどよい軸は、備考で判定方向を明示する。
118
- - 評価軸の説明には、根拠資料の課題 ID や業務価値との対応を添え、評価が業務価値から離れないようにする。
119
- - レイヤーが異なれば評価軸を分けてよいが、同一レイヤーの候補には同じ軸と判定方向を使う。
120
- - 製品・サービスには、業務適合、データ移行、ロックイン、可逆性、成熟度を必要に応じて加える。
81
+ - 軸を省く・ほかの軸へ統合するときは、その場で観点名と理由、統合先と判定条件を書く。別章に書いたことを理由にすると、省いた妥当性を確かめられない。
82
+ - 「低いほどよい」軸(コスト・期間など)は、判定基準の列に有利な方向を書き込む。
83
+ - 値が確かめられない軸は未判定のまま残し、確かめる作業を比較試行へ回す。
121
84
 
122
85
  ### 4.4. 比較結果と採択理由
123
86
 
124
87
  問い:
125
88
 
126
- - 採択案は、どの評価軸で優位なのか。
127
- - 非採択案や一部採択案の理由は、再評価時に使える粒度か。
128
- - 比較試行と正式採用を区別し、試行の入力、評価軸、終了条件が決まっているか。
129
- - 技術的実現性と後続成果物への影響が読み取れるか。
89
+ - 採択案は、どの評価軸で他案より優れているのか。
90
+ - 比較試行を行う場合、同じ入力・測定項目・完了条件・撤退の基準は決まっているか。
130
91
 
131
- 書き方:
92
+ コツ:
132
93
 
133
- - 比較結果表の直後に、採択案と組み合わせ方を 1 文で書く。
134
- - 採択理由は評価軸に対応させ、同じ理由を複数の表と段落へ重複させない。
135
- - 技術的実現性と影響は、決定または案ごとの表にまとめて埋もれないようにする。
136
- - 比較試行では同じ入力と完了条件を使い、採用・撤退の判定と記録先を先に決める。
137
- - 製品・サービスを採択する場合は、データの正本、移行方法、利用停止時の取り出し方を書く。
94
+ - 採択理由を表の後の段落と決定の要約に重ねて書きやすい。理由は比較結果に 1 回だけ書き、ほかは参照する。
95
+ - 製品・サービスを採る場合は、データの正本、移行方法、利用停止時の取り出し方を担当者に聞いて書く。
138
96
 
139
97
  ### 4.5. リスクとトレードオフ
140
98
 
141
99
  問い:
142
100
 
143
101
  - 採択によって先送りする範囲、受容する負荷、失う選択肢は何か。
144
- - 起きうる失敗と軽減策は対になっているか。
145
- - PM や後続作業がリスク登録簿へ転記できる粒度か。
102
+ - 軽減策を、誰が、何を確かめて終えるのか。
146
103
 
147
- 書き方:
104
+ コツ:
148
105
 
149
- - 区分は `リスク` / `トレードオフ` など少数に揃える。
150
- - 軽減策は「確認する」だけで終えず、何を残すか、誰が判断するかまで書く。
151
- - 技術詳細に踏み込む場合は、後続の設計成果物へ委譲する。
152
- - 軽減策や記録先の具体名称(計画書、登録簿等)は、根拠資料で存在が確認できる仕組みに限定する。根拠資料に存在しない計画書名・台帳名を新設せず、確認できない場合は「後続の品質確認」「成果物カタログと後続作業」のように確認済みの仕組みに言い換える。
106
+ - 軽減策を「注意する」「確認する」で止めず、実施者と完了の判定(差分 0 件など)まで聞く。
107
+ - 計画書・台帳の名前は、根拠資料で実在を確かめたものだけを書く。確かめられないときは「後続の品質確認」のように、確認済みの仕組みで言う。
153
108
 
154
109
  ### 4.6. 決定と見直し
155
110
 
156
111
  問い:
157
112
 
158
- - 現時点の採択方針は一文で言えるか。
159
- - 採択案の最終判断者が人間の責任ロールとして明記されているか。
160
- - どの条件で再評価し、どこに判断理由を残すか。
113
+ - 現時点の採否を、決定 ID ごとに 1 文で言えるか。
114
+ - どの期間・測定値・依存の変化で、比較をやり直すのか。
161
115
 
162
- 書き方:
116
+ コツ:
163
117
 
164
- - `PO` が最終判断し、AI Agent は比較分析の支援に留めることを明記する。
165
- - 再評価条件は、時間、指標、利用者フィードバック、依存変更など具体的なトリガーにする。
166
- - 方針変更時の記録先を、決定記録、変更要求ログ、プロジェクト登録簿などから選ぶ。
118
+ - 再評価トリガーを「特定製品が出たら採用」にしやすい。候補カテゴリ単位の条件に言い換える。
119
+ - AI Agent は比較分析の支援に留め、最終判断者の欄に入れない。
167
120
 
168
121
  ## 5. 深掘り手順
169
122
 
170
- 内容が浅いと感じる場合は、次の順で深掘りする。
123
+ 内容が浅いときは、次の順で対応のない主張を探す。
171
124
 
172
- 1. 比較目的を「何を決めるためか」に言い換える。
173
- 2. 前段文書から、課題、必要能力、制約、評価条件を抽出する。
174
- 3. 比較レイヤーごとに候補カテゴリと選定基準を定める。
175
- 4. 現行案から独立して、既存標準、方式、製品、ツールの公式資料を調査する。
176
- 5. 同じ意思決定を代替できる具体候補に絞り、標準・方法論と製品を区別する。
177
- 6. 評価軸を業務価値、費用、期間、リスク、運用、技術に分類する。
178
- 7. 評価軸を根拠資料の課題 ID や業務価値に対応付ける。
179
- 8. `High` / `Middle` / `Low` の根拠を 1 行ずつ補う。
180
- 9. 採択案の不利条件をトレードオフとして書く。
181
- 10. 採択・試行・保留・非採択の条件と、最終判断者、記録先、撤退方法を明示する。
125
+ 1. 各評価軸が、どの課題 ID・制約に結び付くかを確かめ、結び付かない軸を外す。
126
+ 2. 各案の判定が、どの軸の評価から導かれるかを確かめ、軸に現れない採択理由を見つける。
127
+ 3. 軽減策ごとに、どのリスクを抑えるかと完了の判定を確かめる。
128
+ 4. 再評価トリガーごとに、どの判定を覆すかを確かめる。
129
+ 5. 詳細設計・製品仕様を書きすぎた箇所を、後続成果物への参照に戻す。
182
130
 
183
131
  ## 6. 良い例 / 悪い例
184
132
 
185
- | 観点 | 良い例 | 悪い例 |
186
- | ------------ | ---------------------------------------------------------------- | -------------------------------------------------------------- |
187
- | 比較目的 | 販売・在庫・つけの記録を継続できる解決方式を選ぶ | どれがよいか考える |
188
- | 代替案 | 紙運用改善、既存サービス、個別構築を解決案として比較 | 画面、データ、開発ツールを別案として並べ、すべて採択する |
189
- | 比較レイヤー | 購入 / 構築を先に判断し、必要な場合だけ製品を比較 | 販売管理方式と開発タスク管理ツールを同じ表で採点 |
190
- | 候補選定 | カテゴリと基準を定め、各カテゴリの具体候補を公式資料で確認 | 知っている製品だけを代表例として比較 |
191
- | 評価軸 | 効果、コスト、期間、リスク、運用適合、技術実現性を同じ基準で評価 | 案ごとに都合のよい観点だけを書く |
192
- | 採択理由 | 業務適合と記録継続を重視し、ALT-04 を採択する | ALT-04 がよさそうだから |
193
- | 技術影響 | タブレット 1 台で試行でき、ノート移行と紙への切り戻しを要する | 実現性や影響の根拠を書かずに結論だけ述べる |
194
- | 見直し条件 | 2 週間の試行で記録漏れが許容値を超えた場合、採択案を見直す | 必要なら見直す |
195
- | 試行 | 同じ販売・つけ記録を 2 候補で試し、操作時間と記録漏れを測る | 導入してから使いやすそうか判断する |
196
- | 軽減策の根拠 | 後続の品質確認で対応する(根拠資料にある仕組みを指す) | 品質管理計画で対応する(根拠資料に存在しない計画名を断定する) |
133
+ | 観点 | 良い例 | 悪い例 |
134
+ | ------------ | ----------------------------------------------------------- | -------------------------------------------------------- |
135
+ | 代替案 | 紙運用改善、既存サービス、個別構築を解決案として比較する | 画面、データ、開発ツールを別案として並べ、すべて採択する |
136
+ | 比較レイヤー | 購入 / 構築を先に判断し、必要な場合だけ製品を比較する | 販売管理方式と開発タスク管理ツールを同じ表で採点する |
137
+ | 軸の省略 | 「リスクは業務適合へ統合し、通信断時の記録保持で判定する」 | 「リスクは別章に書いたので評価しない」 |
138
+ | 試行 | 同じ販売・つけ記録を 2 候補で試し、操作時間と記録漏れを測る | 導入してから使いやすそうか判断する |
139
+ | 見直し条件 | 2 週間の試行で記録漏れが許容値を超えたら採択案を見直す | 必要なら見直す |
197
140
 
198
141
  ## 7. レビュー観点
199
142
 
200
- 作成後は、次の観点で確認する。
201
-
202
- | 観点 | 確認内容 |
203
- | -------------------- | ---------------------------------------------------------------------------------------------------- |
204
- | 比較目的の明確性 | 何を決めるための比較かが最初に分かるか |
205
- | 根拠資料との整合 | スコープ、課題と解決アプローチ、前提・制約と矛盾していないか |
206
- | 候補案の妥当性 | 最低 2 案あり、同じ目的を解ける案として並んでいるか |
207
- | 外部候補の網羅 | 前段文書の案の再掲だけでなく、既存標準・方式・製品を調査しているか |
208
- | 候補選定の再現性 | 候補カテゴリ、選定基準、公式資料が示され、特定製品へ恣意的に絞っていないか |
209
- | 比較レイヤーの統一 | 業務方式、製品、開発方式など抽象度が異なる候補を同じ表に混在させていないか |
210
- | 評価軸の一貫性 | 案ごとに評価軸や判定基準を変えていないか。根拠資料の課題 ID・業務価値に対応しているか |
211
- | 採択理由の説明可能性 | 採択、一部採択、非採択の理由が評価軸で説明されているか |
212
- | 技術的実現性 | 外部依存、既存資産、後続成果物への影響が読み取れるか |
213
- | 正本と可逆性 | 製品・サービスのデータ正本、移行、試行・採用からの撤退方法が読み取れるか |
214
- | 軽減策の実在性 | 軽減策や記録先が根拠資料で確認できる仕組みに基づいているか。未確認の計画書名・台帳名を作っていないか |
215
- | 人間の判断責任 | 採択案の最終判断者が `PO` など人間の責任ロールになっているか |
216
- | 再評価可能性 | 見直し条件と記録先が明記されているか |
143
+ | 観点 | 確認内容 |
144
+ | ------------ | ------------------------------------------------------------------------------ |
145
+ | 課題との対応 | 比較目的と評価軸が、課題と解決アプローチ・スコープの課題・範囲と食い違わないか |
146
+ | 候補の公平さ | 前段文書の案の再掲に留まらず、カテゴリごとに有力な外部案を調べているか |
147
+ | 判定の再現性 | 第三者が同じ判定境界で同じ判定にたどり着けるか |
148
+ | 正本と可逆性 | 製品・サービスを採る場合、データの正本と撤退方法が読み取れるか |
149
+ | 委譲の境界 | 詳細設計・製品仕様を後続成果物へ委ね、採否を左右する差異だけを残しているか |
217
150
 
218
151
  ## 8. 仕上げチェック
219
152
 
220
- - 「全体の作成手順」で示した章立てと必須表がそろっている。
221
- - 比較対象案が最低 2 案ある。
222
- - 各案が単独で目的達成への道筋を説明でき、同じ比較レイヤーにある。
223
- - 前段文書の候補案を名称変更して再掲するだけでなく、有力な外部案を調査している。
224
- - 候補カテゴリと選定基準を先に定め、根拠なく製品を代表・標準扱いしていない。
225
- - 業務運用、解決方式、購入 / 構築、製品、開発方式を必要に応じて分離している。
226
- - 開発戦略や作業管理を、業務課題と無関係に主比較へ持ち込んでいない。
227
- - 評価軸と評価基準が案ごとに固定されている。
228
- - 採択案、非採択案、一部採択案の理由が記載されている。
229
- - 評価軸が根拠資料の課題 ID や業務価値に対応している。
230
- - 技術的実現性と後続成果物への影響が比較されている。
231
- - 比較試行の条件と、製品・サービスのデータ移行・撤退方法が明確である。
232
- - リスクとトレードオフに軽減策がある。
233
- - 軽減策・記録先が根拠資料で確認できる仕組みに基づいている。
234
- - 採択案の最終判断者と再評価条件が明記されている。
235
- - 各採否を、解くべき課題、評価条件、評価結果、判断理由、再評価記録へ決定 ID から追跡できる。
153
+ - 各案の判定が評価軸の評価から導かれ、各評価軸が課題 ID・制約にたどれる。
154
+ - 省いた・統合した評価軸に、理由または統合先と判定条件が書かれている。
155
+ - 未確認の値を、確認済みの高評価にしていない。
156
+ - AI Agent を最終判断者にしていない。
157
+ - 個人名・個人の連絡先・公開できない組織情報がなく、役割名・集団名で書かれている。