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,40 +11,29 @@ specdojo:
11
11
 
12
12
  Stakeholder Register Writing Recipe
13
13
 
14
- 本書は、ステークホルダー登録簿を、業務価値・利用者影響・合意対象が判断できる内容に仕上げるための作り方である。本書では問い、深掘り、具体化、レビュー観点を扱う。
14
+ ステークホルダー登録簿を、業務価値・利用者影響・合意対象が判断できる内容に仕上げるための作り方を示す。
15
15
 
16
16
  ## 1. このレシピの使い方
17
17
 
18
- - 最初に、プロジェクト概要から目的、利用者、期待効果、前提条件を抜き出す。
19
- - 次に、誰が判断し、誰が利用し、誰が協力し、誰が影響を受けるかを役割別に洗い出す。
20
- - 各関係者について、期待、懸念、必要な合意、情報要求を同じ ID でつなげる。
21
- - 最後に、影響度/関心度の根拠と、変更時に見直す条件を確認する。
22
- - プロジェクトの目的と利用者影響(Why)、判断者・利用者・協力者・影響受容者と合意対象(What)、関与方針と情報要求(How)を整理し、ステークホルダー ID、評価根拠、証跡要件で追跡する(Trace)。詳細な配信計画は後続文書へ委譲する。
18
+ - 登録簿は、プロジェクト概要の目的と利用者影響(Why)から関係者と合意対象(What)を識別し、関与方針と情報要求(How)を決める。各関係者は同じ `STH-<KEY>` で関係者一覧から証跡要件までたどれるようにする(Trace)。
23
19
 
24
20
  ## 2. 作成前に集める情報
25
21
 
26
- | 項目 | 集める情報 |
27
- | ---------------- | ------------------------------------------------------------------------------------------------- |
28
- | 目的と期待効果 | 誰のどの課題を改善し、どの状態を目指すか |
29
- | 利用者と利用場面 | 直接利用者、間接利用者、影響を受ける集団、利用する場面 |
30
- | 意思決定 | 方針、優先順位、公開・利用可否を判断する人または組織 |
31
- | 実行・協力 | 実行担当、運用担当、外部協力者と、それぞれの関わり方 |
32
- | 想定される懸念 | 利用負荷、変更影響、継続性、公開適性、合意遅延の要因 |
33
- | 合意対象 | 着手、範囲、変更、公開、利用開始で確認が必要な事項 |
34
- | 情報要求 | 誰が、何を、どの手段で確認・判断するか |
35
- | 更新条件 | 目的、範囲、体制、利用者影響、公開方針が変わる出来事 |
36
- | 実行主体の境界 | AI Agent やツールなど人間以外の実行主体が関与する場合、入力・制約・確認の責任を持つ人の役割は誰か |
22
+ | 項目 | 集める情報 | 取り出し元 |
23
+ | ---------------------- | --------------------------------------------------------- | -------------------------- |
24
+ | 目的と利用者 | 誰のどの課題を改善するか、直接・間接の利用者と利用場面 | プロジェクト概要 |
25
+ | 判断と合意の場面 | 着手・範囲・変更・公開・利用開始で、誰が何を決めるか | プロジェクト責任者への確認 |
26
+ | 実行・協力の体制 | 実行担当、運用担当、外部協力者と関わり方、採用済みの Role | 体制・メンバー定義 |
27
+ | 懸念 | 利用負荷、変更影響、継続性、公開適性、合意遅延の要因 | 各関係者への聞き取り |
28
+ | AI Agent・ツールの関与 | 入力・制約・生成結果の確認責任を持つ人の役割 | 実行担当への確認 |
37
29
 
38
30
  ## 3. 全体の作成手順
39
31
 
40
- 1. プロジェクトの目的と利用者を確認し、登録対象の識別基準を決める。
41
- 2. 意思決定者、実行担当、利用者、外部協力者、影響受容者を候補として列挙する。
42
- 3. 関係者一覧に、役割名・集団名を用いて一意の `STH-<KEY>` を付ける。
43
- 4. 各関係者の期待、懸念、必要な合意を整理し、影響度と関心度に根拠を添える。
44
- 5. 現状と目標を比べ、情報提供、相談、合意、巻き込みの対応方針を決める。
45
- 6. 情報要求、希望チャネル、証跡要件を整理し、詳細な配信計画は後続のコミュニケーション計画へ委譲する。
46
- 7. 変更時と定期確認時の見直し条件、責任者、承認者を定める。
47
- 8. 個人情報、推測の Role code、設計詳細、会議運営の重複がないことを確認する。
32
+ 1. 関係者一覧を先に書き、ID を決める。ID が決まらないと、ほかの表の行をつなげられない。
33
+ 2. 影響度/関心度分析で、期待・懸念・必要な合意と評価根拠を書く。
34
+ 3. エンゲージメント方針は High の関係者から書く。合意が要る相手の行動が決まると、残りは情報共有で足りるかを判断しやすい。
35
+ 4. コミュニケーション要件で、関係者が判断に使う情報と残す証跡を書く。
36
+ 5. 最後に見直し条件を書く。ほかの表がそろってから、どの変更でどの行が動くかを確かめる。
48
37
 
49
38
  ## 4. 各章の書き方
50
39
 
@@ -52,117 +41,92 @@ Stakeholder Register Writing Recipe
52
41
 
53
42
  問い:
54
43
 
55
- - 誰が目的、範囲、公開・利用可否を判断するか。
56
- - 誰が直接利用し、誰が間接的に影響を受けるか。
57
- - 誰が実行、運用、協力を担い、どの責任を持つか。
58
- - AI Agent やツールなど人間以外の実行主体が関与する場合、入力・制約・生成結果の確認責任を持つ人の役割は誰か。
44
+ - 誰が目的・範囲・公開や利用の可否を判断し、誰が直接利用し、誰が間接的に影響を受けるか。
45
+ - AI Agent やツールが関与する場合、その確認責任を持つのはどの人の役割か。
59
46
 
60
- 書き方:
47
+ コツ:
61
48
 
62
- - 個人名ではなく、役割名、組織名、集団名で書く。
63
- - ステークホルダーとタスク Role を分け、採用済みの Role だけを対応 Role code として書く。
64
- - AI Agent やツールなどの実行主体自体は単独のステークホルダーとして記載せず、入力・制約・確認の責任を持つ人の役割として記載する。
65
- - 同じ関係者を全章で同じ ID にする。
49
+ - 「ユーザー」と書きたくなったら、利用場面ごとに集団を分けられないかを聞く。
50
+ - 個人名で挙がった人は、その人が担う役割名に置き換える。概要に書かれた利用者は写さず、概要への参照に置き換える。
66
51
 
67
52
  ### 4.2. 影響度/関心度分析
68
53
 
69
54
  問い:
70
55
 
71
- - 方針、範囲、優先順位、利用可否を左右するのは誰か。
72
- - 成果または変更を継続して確認する必要があるのは誰か。
73
- - 期待が満たされないと、誰にどのような利用・継続上の影響が出るか。
56
+ - 期待が満たされないと、誰の利用や継続にどのような影響が出るか。
57
+ - その関係者と、何を決めなければ先へ進めないか。
74
58
 
75
- 書き方:
59
+ コツ:
76
60
 
77
- - `High` は、影響を与える根拠または継続確認が必要な根拠を必ず添える。
78
- - 期待、懸念、必要な合意を対応させ、「誰と何を決めるか」を明確にする。
79
- - 評価は人の重要度ではなく、プロジェクトへの影響と関与必要性で行う。
61
+ - 「重要だから High」になりやすい。その人が左右する判断(方針・範囲・公開可否など)を聞き、それを根拠に書く。
62
+ - 懸念は「期待が満たされない場合の困りごと」として聞くと具体になる。
80
63
 
81
64
  ### 4.3. エンゲージメント方針
82
65
 
83
66
  問い:
84
67
 
85
- - 現在の関与状態と、目標とする関与状態は何か。
86
- - 差分を埋めるために、情報提供、相談、合意、巻き込みのどれが必要か。
87
- - 誰がいつまでに行い、どこに証跡を残すか。
68
+ - 今の関与状態と目標の関与状態の差を、どの行動で埋めるか。
69
+ - その行動は、必要な合意を取る時点に間に合うか。
88
70
 
89
- 書き方:
71
+ コツ:
90
72
 
91
- - 「確認する」だけで終わらせず、対象情報、実施者、期限、証跡を記載する。
92
- - 外部関係者が未関与なら、現在の事実と将来の仮定を混ぜず、必要に応じて _ASSUMPTION_: を使う。
93
- - 合意を求める相手と、情報共有だけでよい相手を区別する。
73
+ - 期限は「週次」のような会議の頻度ではなく、初期公開前などの判断の節目で書く。会議の日時や頻度はコミュニケーション計画へ渡す。
74
+ - 外部関係者がまだ関与していなければ、現在の事実と将来の仮定を混ぜず、_ASSUMPTION_ を付ける。
94
75
 
95
76
  ### 4.4. コミュニケーション要件
96
77
 
97
78
  問い:
98
79
 
99
- - 関係者は何を受け取れば、判断、利用、協力、影響確認ができるか。
100
- - どの手段なら内容を確認でき、必要な証跡を残せるか。
101
- - 詳細計画で追加管理すべき事項は何か。
80
+ - 関係者は何を受け取れば、判断・利用・協力ができるか。
81
+ - どの手段なら内容を確認でき、証跡を残せるか。
102
82
 
103
- 書き方:
83
+ コツ:
104
84
 
105
- - 情報要求は「進捗」だけでなく、優先順位、変更理由、利用手順など判断に必要な情報に分解する。
106
- - 会議の日時や配信頻度の詳細を重複管理しない。
107
- - 合意・報告の必要性と、証跡要件を同じ行に置く。
85
+ - 「進捗」と聞いたら、優先順位・変更理由・利用手順など、何の判断に使う情報かを聞き返す。
108
86
 
109
87
  ### 4.5. 見直し条件
110
88
 
111
89
  問い:
112
90
 
113
- - どの変更が、関係者、期待、影響度、合意対象を変えるか。
114
- - 誰が見直し、誰が承認し、どの証跡で追跡するか。
115
- - 定期確認では、どの未解決の合意や情報要求を確認するか。
91
+ - どの変更が、関係者・期待・影響度・合意対象を変えるか。
92
+ - 誰が見直し、誰が承認するか。
116
93
 
117
- 書き方:
94
+ コツ:
118
95
 
119
- - 目的、範囲、体制、公開・利用方針の変更を更新トリガーに含める。
120
- - 周期が未定なら _TODO_: として決める文書またはタイミングを残す。
121
- - 変更した表だけでなく、同じ ID を使う全章への影響を確認する。
96
+ - 承認者を空欄や「-」にしない。見直し責任者が自分で承認してよい場合は、その役割名を承認者に書く。
97
+ - 周期が決まっていなければ、_TODO_ を付けて決める時期を残す。
122
98
 
123
99
  ## 5. 深掘り手順
124
100
 
125
- 内容が浅い場合は、次の順で具体化する。
101
+ 内容が浅いときは、次の順で対応のない主張を探す。
126
102
 
127
- 1. 目的と期待効果から、利益を得る利用者と影響を受ける集団を洗い出す。
128
- 2. 方針、範囲、公開・利用可否の決定を列挙し、意思決定者を対応付ける。
129
- 3. 各関係者について「期待が満たされない場合の困りごと」を書き、懸念を具体化する。
130
- 4. 各懸念に対して、必要な合意または情報要求を対応付ける。
131
- 5. High の関係者を先に選び、関与方針、責任者、期限、証跡を埋める。
132
- 6. 変更イベントごとに、見直す行と承認者を確認する。
103
+ 1. 目的と期待効果から利益を得る集団・影響を受ける集団をたどり、一覧にない集団を足す。
104
+ 2. High の関係者ごとに、必要な合意がエンゲージメント方針の行動と期限で取れるかを確かめる(リリース前に要る合意を、リリース後の行動で埋めていないか)。
105
+ 3. 情報要求ごとに、どの判断に使うかを確かめ、使い道のない行を外す。
106
+ 4. 変更の出来事ごとに、動く行と承認者がいるかを確かめる。
133
107
 
134
108
  ## 6. 良い例 / 悪い例
135
109
 
136
- | 観点 | 良い例 | 悪い例 |
137
- | -------------- | ---------------------------------------------------------------- | ---------------------------------------- |
138
- | 関係者の識別 | 「将来の利用者」を利用場面と期待を添えて記載する | 「ユーザー」とだけ書く |
139
- | 影響度の根拠 | 「公開・利用可否を判断するため High」と書く | 「重要なので High」と書く |
140
- | 必要な合意 | 「初期公開の範囲と公開情報」と具体化する | 「いろいろ相談する」と書く |
141
- | 関与方針 | 「初期公開前に導入手順を公開し、Issue で不明点を収集する」と書く | 「利用者と連携する」と書く |
142
- | 情報要求 | 「変更理由と利用手順を公開文書で確認する」と書く | 「進捗を共有する」とだけ書く |
143
- | 見直し条件 | 「公開方針変更時に将来利用者の要件を見直す」と書く | 「必要に応じて更新する」と書く |
144
- | 実行主体の境界 | 「AI Agent活用担当」のように責任を持つ人の役割として記載する | 「AI Agent」を単独の関係者として記載する |
110
+ | 観点 | 良い例 | 悪い例 |
111
+ | ------------ | -------------------------------------------------------------- | ------------------------------------ |
112
+ | 関係者の識別 | 「将来の利用者」を利用場面と期待を添えて書く | 「ユーザー」とだけ書く |
113
+ | 影響度の根拠 | 「公開・利用可否を判断するため High」と書く | 「重要なので High」と書く |
114
+ | 必要な合意 | 「初期公開の範囲と公開情報」と具体化する | 「いろいろ相談する」と書く |
115
+ | 関与方針 | 「初期公開前に導入手順を公開し、Issue で不明点を集める」と書く | 「利用者と連携する」と書く |
116
+ | 見直し条件 | 「公開方針の変更時に将来利用者の要件を見直す」と書く | 「必要に応じて更新する」と書く |
117
+ | 実行主体 | 「AI Agent 活用担当」のように責任を持つ人の役割として書く | 「AI Agent」を単独の関係者として書く |
145
118
 
146
119
  ## 7. レビュー観点
147
120
 
148
- | 観点 | 確認内容 |
149
- | ---------------------- | --------------------------------------------------------------------------- |
150
- | 業務価値との対応 | プロジェクトの目的、利用者、期待効果から関係者を識別できているか |
151
- | 利用者影響 | 直接利用者、間接利用者、影響受容者の期待と懸念が分かるか |
152
- | 合意対象 | High の関係者について、誰と何を合意するかがあるか |
153
- | 評価根拠 | 影響度と関心度に、方針・利用・運用・合意への影響の根拠があるか |
154
- | 関与方針 | 現状、目標、行動、責任者、期限、証跡が対応しているか |
155
- | コミュニケーション統制 | 詳細計画と重複せず、情報要求と証跡要件を入力として渡せるか |
156
- | 公開適性 | 個人情報、非公開情報、未採用 Role code、根拠のない推測がないか |
157
- | 実行主体の境界 | AI Agent やツールなどの実行主体が、責任を持つ人の役割に対応付けられているか |
121
+ | 観点 | 確認内容 |
122
+ | ---------- | ---------------------------------------------------------------- |
123
+ | 業務価値 | 目的・利用者・期待効果から関係者を識別できているか |
124
+ | 利用者影響 | 直接利用者・間接利用者・影響受容者の期待と懸念が分かるか |
125
+ | 合意の時点 | 必要な合意を取る時点と、関与方針の行動・期限が食い違っていないか |
126
+ | 公開適性 | 個人情報、非公開情報、根拠のない推測がないか |
158
127
 
159
128
  ## 8. 仕上げチェック
160
129
 
161
- - 「全体の作成手順」で示した章立てがそろっている。
162
- - 各関係者が、関係者一覧から見直し条件まで同じ ID で追跡できる。
163
- - High の関係者に、期待、懸念、必要な合意、対応方針がある。
164
- - 利用者・影響受容者の利用場面または影響が読み取れる。
165
- - AI Agent やツールなどの実行主体を、責任を持つ人の役割に対応付けている(単独のステークホルダーとして扱っていない)。
166
- - 詳細な会議運営、設計詳細、個人情報を本文に含めていない。
167
- - 各必須表のカラムがすべて埋まっている。
168
- - 各ステークホルダーを、目的または利用者影響、必要な合意、関与方針、証跡要件へ同じ ID で追跡できる。
130
+ - 各関係者を、関係者一覧から必要な合意・関与方針・証跡要件まで同じ ID でたどれる。
131
+ - High の関係者に、期待・懸念・必要な合意・関与方針がある。
132
+ - 見直し条件の各行に、承認する役割が書かれている。
@@ -11,40 +11,31 @@ specdojo:
11
11
 
12
12
  Success Criteria and Acceptance Criteria Writing Recipe
13
13
 
14
- 本書は、業務価値を起点として、プロジェクトの成功基準と受入条件を判定可能な形にする作り方です。本書では問い、深掘り、レビュー観点を扱います。
14
+ 業務価値を起点に、プロジェクトの成功と初期受入の可否を、承認者が証跡で判断できる条件に仕上げるための作り方を示す。
15
15
 
16
16
  ## 1. このレシピの使い方
17
17
 
18
- - 最初に、概要とスコープから対象利用者、利用場面、期待効果、対象外、判定期間を抜き出します。
19
- - 次に、利用者にとって実現したい状態を業務価値として短く定義します。
20
- - 業務価値ごとに、初期公開・初期リリース、短期、中長期の成功基準を置きます。
21
- - 初期受入の対象について、価値提供を開始できる状態を受入条件と証跡で定義します。
22
- - 最後に、確認者、承認者、否決時の再判定方法を明確にします。
23
- - 利用者と期待効果(Why)、業務価値・成功基準・受入条件(What)、測定・確認・承認・再判定(How)を整理し、各 ID と証跡で追跡します(Trace)。詳細な実装・個別テスト手順は後続成果物へ委譲します。
18
+ - 概要とスコープから対象利用者と期待効果(Why)を引き継ぎ、業務価値ごとの成功基準と受入条件(What)を定め、測定・確認・承認・再判定の進め方(How)を決める。各条件は業務価値 ID と証跡でたどれるようにする(Trace)。
24
19
 
25
20
  ## 2. 作成前に集める情報
26
21
 
27
- | 項目 | 集める情報 |
28
- | ------------ | ------------------------------------------------------------- |
29
- | 対象と対象外 | 今回判定する成果物・状態と、判定しない範囲 |
30
- | 業務価値 | 対象利用者、利用場面、期待する効果または状態 |
31
- | 成功の状態 | 初期、短期、中長期の各段階で、どの状態なら成功か |
32
- | 受入対象 | 利用者が確認する作業、結果、品質、公開適性 |
33
- | 測定方法 | 観察、件数集計、費用・作業記録、文書照合、lint などの確認方法 |
34
- | 証跡 | 確認結果を後から追跡できるファイル、記録、ログ |
35
- | 判断体制 | 確認者、承認者、否決時に是正を担う役割 |
36
- | 未確定事項 | 閾値、期限、前提のうち、意思決定が未了のもの |
22
+ | 項目 | 集める情報 | 取り出し元 |
23
+ | ---------------- | ------------------------------------------------------------ | ---------------------------- |
24
+ | 対象と対象外 | 今回判定する成果物・状態と、判定しない範囲 | プロジェクトスコープ |
25
+ | 利用者と期待効果 | 対象利用者、利用場面、期待する変化 | プロジェクト概要 |
26
+ | 成功の状態 | 初期公開、短期、中長期のそれぞれで、どうなれば成功と言えるか | 承認者・代表利用者への確認 |
27
+ | 費用と負荷の上限 | 追加の現金支出、人の作業時間、運用負荷の上限と、その承認者 | 承認者・実行責任者への確認 |
28
+ | 測定と証跡 | 観察、件数集計、費用・作業記録などの確認方法と、残せる記録 | 実行責任者・品質担当への確認 |
29
+ | 決めきれない値 | 閾値、期限、前提のうち、決定が済んでいないもの | 確認の過程のメモ |
37
30
 
38
31
  ## 3. 全体の作成手順
39
32
 
40
- 1. 判定対象と対象外をスコープから転記せず、受入判断に必要な範囲へ要約する。
41
- 2. 利用者と利用場面に結び付く業務価値へ ID を付ける。
42
- 3. 各業務価値について、初期公開・初期リリース、短期、中長期のどの段階で成功を判定するか決める。
43
- 4. 各段階の成功した状態を一文で書き、判定基準、測定方法、判定時期、確認者を決める。
44
- 5. 初期受入に必要な条件を、利用者視点・技術的受入・品質・公開適性に分ける。
45
- 6. 各受入条件に合格基準、証跡、確認者、承認者を対応付ける。
46
- 7. 判定の実施順、否決時の是正、再判定の記録方法を定義する。
47
- 8. 未確定の閾値・期限には _UNDECIDED_: を付け、決定時期と担当を記載する。依存文書(スコープ等)が別ラベル(例: _TODO_:)で未決を示している場合も、本書では _UNDECIDED_: に書き換える。
33
+ 1. 業務価値を最初に定め、ID を付ける。成功基準も受入条件も業務価値に対応付けるため、ここが決まらないと条件の要否を判断できない。
34
+ 2. 判定対象と適用範囲で、初期受入に必須とする条件と、公開後に判定する成功基準の境目を決める。
35
+ 3. 成功基準を、公開後の段階まで含めて書く。
36
+ 4. 受入条件を、価値提供を始められる最小の状態に絞って書く。
37
+ 5. 判定手順と証跡で、確認の順と否決時の再判定を書く。
38
+ 6. 最後に例外条件と未解決事項を書く。条件を書く途中で出た決めきれない値を集めると、漏れが減る。
48
39
 
49
40
  ## 4. 各章の書き方
50
41
 
@@ -52,128 +43,93 @@ Success Criteria and Acceptance Criteria Writing Recipe
52
43
 
53
44
  問い:
54
45
 
55
- - 初期公開・初期リリース、短期、中長期の何を判断するのか。
56
- - どの成功基準と受入条件が初期 GO / Not GO の必須条件か。
57
- - 誰がこの判定結果を使うのか。
58
- - 当該プロジェクトだけでは因果を判定できない成果や、他文書へ委譲する詳細は何か。
46
+ - 初期公開の GO / Not GO を、どの条件のすべてで判断するのか。
47
+ - 当該プロジェクトだけでは因果を判定できない成果はどれか。
59
48
 
60
- 書き方:
49
+ コツ:
61
50
 
62
- - 対象・対象外をともに一文以上で明示する。
63
- - 初期受入の必須条件と、後続時期に判定する成功基準を区別する。
64
- - 業務価値は、利用者、利用場面、期待する状態を含む短文にする。
65
- - 「品質を上げる」のような抽象的な価値ではなく、「利用者が同じ根拠で判断できる」のように状態を書く。
51
+ - スコープの対象・対象外を写したくなったら、スコープへの参照に置き換え、受入判断に要る境目だけを書く。
52
+ - 「品質を上げる」のような抽象語が出たら、「利用者が同じ根拠で判断できる」のように、利用者に生じる状態へ言い換える。
66
53
 
67
54
  ### 4.2. 成功基準
68
55
 
69
56
  問い:
70
57
 
71
58
  - どの業務価値が実現すれば、プロジェクトが成功したと言えるか。
72
- - 初期公開・初期リリース、短期、中長期の成果を分けられているか。
73
- - 公開後にしか測定できない成果について、判定時期と測定責任を決めているか。
74
- - 閾値がある場合、対象・単位・母数・比較対象を説明できるか。
75
- - 低コストや費用負担の軽減を価値に置く場合、現金支出、作業時間、継続運用負荷を分けているか。
76
- - 既存資産、寄付、無償枠をどう扱い、人の無償労働への負荷転嫁をどう防ぐか。
59
+ - 公開後にしか測れない成果を、いつ誰が確かめるか。
77
60
 
78
- 書き方:
61
+ コツ:
79
62
 
80
- - 一行は一つの成功状態に限定する。
81
- - 定性条件でも、誰が何を確認すればよいかを測定方法に書く。
82
- - 初期公開時に測れない利用実績や中長期成果も成功基準として記述し、初期受入の合否から分離する。
83
- - 成果物完成、機能数、lint 合格だけで成功を表さず、利用者、業務、事業または社会に生じる変化を書く。
84
- - 外部要因を受ける成果は単独の因果と断定せず、利用前後の変化と寄与を確認する。
85
- - 低コストを条件にする場合は、現金支出だけでなく人の作業時間と継続運用負荷も判定し、既存資産、寄付、無償枠の扱いを明記する。
63
+ - 承認者に「公開から半年後、何が起きていれば続ける価値があったと言えるか」を聞くと、短期と中長期の成功の状態が出てくる。
64
+ - 「低コスト」を聞いたら、現金支出だけで答えが終わらないよう、作業時間と運用負荷、既存資産や寄付の扱いも続けて聞く。無償の作業を前提にした成功に気付ける。
65
+ - 閾値が出たら、何を数えるか、母数と比較対象は何かを、その場で聞き返す。
86
66
 
87
67
  ### 4.3. 受入条件
88
68
 
89
69
  問い:
90
70
 
91
71
  - 利用者は何を行い、どの結果なら受け入れられるか。
92
- - 初期公開・初期リリースで、価値提供を開始できる最小状態は何か。
93
- - 技術的確認は、どの業務価値を支えるために必要か。
94
- - 合格の証拠を第三者が後から確認できるか。
72
+ - 技術的な確認は、どの業務価値を支えるために要るのか。
95
73
 
96
- 書き方:
74
+ コツ:
97
75
 
98
- - 条件は「対象 + 操作または確認 + 期待結果」で書く。
99
- - 公開後の利用件数や中長期成果を初期受入の必須条件にしない。
100
- - 技術的受入は種別を明記し、利用者の受入条件と混在させない。
101
- - 承認者には最終判断を担う人間の役割を置く。AI Agent を承認者にしない。
76
+ - 公開後の利用件数を受入条件に入れたくなったら、成功基準へ移す。
77
+ - 確認者と承認者を一人の役割にまとめがちなので、「誰が証跡を見るか」と「誰が受け入れを決めるか」を分けて聞く。
102
78
 
103
79
  ### 4.4. 判定手順と証跡
104
80
 
105
81
  問い:
106
82
 
107
83
  - どの条件を、誰が、どの順で確認するか。
108
- - 否決時に、何を直し、どの条件を再確認するか。
109
- - 判定結果と未決事項をどこに残すか。
84
+ - 否決したとき、何を直し、どの条件を確かめ直すか。
110
85
 
111
- 書き方:
86
+ コツ:
112
87
 
113
- - 手順は確認者の順に番号付きで書く。
114
- - 証跡は「確認結果」のような抽象名だけで終わらせず、記録内容を示す。
115
- - 再判定時は、対象の受入条件 ID と予定を記録する。
88
+ - 費用と作業時間の上限は、試行の後では決めにくい。試行の前に承認する手順として置く。
89
+ - 証跡を「確認結果」とだけ書きそうになったら、確認日、確認者、条件 ID、母数など、記録に残す中身を聞く。
116
90
 
117
91
  ### 4.5. 例外条件と未解決事項
118
92
 
119
93
  問い:
120
94
 
121
- - 今回の受入範囲から除くが、後で判断が必要なことは何か。
122
- - 閾値または運用前提が未確定でも、受入を進められるか。
123
- - 決定しない場合に誰が影響を受けるか。
95
+ - 決めきれない値があっても、初期受入を進められるか。
96
+ - 保留したとき、どの条件の判定に効くか。
124
97
 
125
- 書き方:
98
+ コツ:
126
99
 
127
- - 未確定は _UNDECIDED_: で明示し、決定する時期と責任者を添える。
128
- - スコープなど依存文書の未決事項を転記する場合、元のラベル(例: _TODO_:)をそのまま残さず、本ルールブックの _UNDECIDED_: に統一する。
129
- - 例外は「受け入れる」だけで終わらせず、再判定する条件を記載する。
100
+ - スコープなどの上位成果物の未決事項は写さず、本書の判定に効く分だけを _UNDECIDED_: で書く。上位成果物が _TODO_: と書いていても、本書では _UNDECIDED_: にそろえる。
130
101
 
131
102
  ## 5. 深掘り手順
132
103
 
133
- 1. 対象利用者を、実際に判定する人と成果を利用する人に分ける。
134
- 2. 各利用場面で「できるようになること」を一文で書く。
135
- 3. その価値を、初期公開・初期リリース、短期、中長期のどこで確認するか決める。
136
- 4. 観察、件数、利用前後比較、文書照合、lint から、段階に合う測定方法を選ぶ。
137
- 5. 証跡に、確認日、確認者、対象条件 ID、判定対象と母数を残せるか確認する。
138
- 6. 業務価値に直接結び付かない条件は、必要性を説明できる技術的受入へ分類する。
139
- 7. 後続時期の成功基準を初回受入の合否から分離し、測定時期と責任者を残す。
104
+ 内容が浅いときは、次の順で対応のない主張を探す。
105
+
106
+ 1. 成功基準と受入条件の各行が、どの業務価値に応えるかを確かめ、対応のない行を外すか技術的受入へ移す。
107
+ 2. 業務価値ごとに、初期公開・短期・中長期のどこで成功を確かめるかを確かめ、抜けている段階を足す。
108
+ 3. 各条件の測定方法と証跡で、第三者が後から同じ判定を再現できるかを確かめる。
109
+ 4. 受入条件に混じった公開後の成果や実装詳細を、成功基準や後続成果物へ戻す。
140
110
 
141
111
  ## 6. 良い例 / 悪い例
142
112
 
143
- | 観点 | 良い例 | 悪い例 |
144
- | ------------------ | ------------------------------------------------------------------------------- | ------------------------------------- |
145
- | 業務価値 | 店主と家族が同じ手順で在庫を確認できる | システムを便利にする |
146
- | 初期成功基準 | 店主と家族が販売・在庫・つけ確認の必須タスクをすべて完了できる | 必要な機能が90%完成している |
147
- | 短期成功基準 | 営業日の90%以上で販売・在庫・つけの記録が残っている | 日々の記録が定着している |
148
- | 中長期成功基準 | 人気商品の欠品回数が運用前1か月比で50%減少する | 店舗運営が改善する |
149
- | 受入条件 | 商品、数量、支払方法を入力して確定すると販売記録が1件作成される | 販売機能が正しく動く |
150
- | 証跡 | 確認日、確認者、条件 ID を含む受入確認記録 | 確認したことを記録する |
151
- | 未解決事項 | _UNDECIDED_: オフライン時の記録方法を初期運用開始前に店主代表が決定する | オフライン時は後で決める |
152
- | 未解決事項のラベル | スコープの _TODO_: 初回公開日を _UNDECIDED_: に書き換え、決定時期と担当を添える | スコープの _TODO_: をそのまま転記する |
113
+ | 観点 | 良い例 | 悪い例 |
114
+ | -------------- | ----------------------------------------------------------------- | --------------------------- |
115
+ | 業務価値 | 店主と家族が同じ手順で在庫を確認できる | システムを便利にする |
116
+ | 初期成功基準 | 店主と家族が販売・在庫・つけ確認の必須タスクをすべて完了できる | 必要な機能が90%完成している |
117
+ | 中長期成功基準 | 人気商品の欠品回数が運用前1か月比で50%減少する | 店舗運営が改善する |
118
+ | 受入条件 | 商品、数量、支払方法を入力して確定すると販売記録が1件作成される | 販売機能が正しく動く |
119
+ | 未解決事項 | _UNDECIDED_: オフライン時の記録方法を初期運用開始前に店主が決める | オフライン時は後で決める |
153
120
 
154
121
  ## 7. レビュー観点
155
122
 
156
- | 観点 | 確認内容 |
157
- | ---------------- | ------------------------------------------------------------------------------------- |
158
- | 業務価値との対応 | 全ての成功基準・受入条件に業務価値 ID がある |
159
- | 利用者視点 | 対象利用者、利用場面、期待結果を読み取れる |
160
- | 判定段階 | 初期公開・初期リリース、短期、中長期を区別し、判定時期と責任者がある |
161
- | 初期受入との分離 | 公開後の利用実績と中長期成果を、初期受入の合否へ混在させていない |
162
- | 検証可能性 | 測定方法、合格基準、証跡が具体的である |
163
- | 費用と負荷 | 低コストを価値に置く場合、現金支出、作業時間、継続運用負荷を分けている |
164
- | 責任の明確性 | 確認者と人間の承認者が明記されている |
165
- | 技術的受入 | 技術的条件が種別で分離され、業務価値との関係がある |
166
- | 対象範囲 | スコープ内・対象外と矛盾しない |
167
- | 公開適性 | 個人情報、非公開情報、機密情報がない |
168
- | ラベル整合性 | 未確定事項が _UNDECIDED_: に統一され、依存文書の _TODO_: 等を転記したままにしていない |
123
+ | 観点 | 確認内容 |
124
+ | ---------------- | -------------------------------------------------------------------- |
125
+ | 業務価値との対応 | 各条件が対象利用者のどの期待効果に応えるかを説明できるか |
126
+ | 初期受入との分離 | 公開後の利用実績や中長期の成果が、初期受入の合否に混じっていないか |
127
+ | 費用と負荷 | 低コストを価値に置く場合、人の作業時間と運用負荷を見落としていないか |
128
+ | 対象範囲 | スコープの対象・対象外と食い違っていないか |
169
129
 
170
130
  ## 8. 仕上げチェック
171
131
 
172
- - 「全体の作成手順」で示した章立てと必須表がそろっている。
173
- - 業務価値、成功基準、受入条件、証跡、確認者、承認者を対応付けた。
174
- - 閾値には測定対象、単位、母数または比較対象を示した。
175
- - 初期公開・初期リリース、短期、中長期の成功基準と、初期受入条件を分離した。
176
- - 対象外、未決事項、否決時の再判定方法を明示した。
177
- - 未確定事項のラベルが _UNDECIDED_: に統一され、依存文書(スコープ等)の _TODO_: などをそのまま転記していない。
178
- - 実装詳細、個別テスト手順、AI Agent による最終判断を書いていない。
179
- - 各業務価値を、利用者・期待効果、段階別成功基準、受入条件、測定方法、証跡、判断者へ ID で追跡できる。
132
+ - 各業務価値から、成功基準・受入条件・証跡・判断する役割までたどれる。
133
+ - 閾値に、測定対象・単位・母数または比較対象がある。
134
+ - 未確定の値が _UNDECIDED_: にそろい、上位成果物の _TODO_: を写したままにしていない。
135
+ - AI Agent を承認者にしていない。