specdojo 0.8.0 → 0.9.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (292) hide show
  1. package/.github/agents/specdojo-orchestrator.md +4 -1
  2. package/CHANGELOG.md +77 -0
  3. package/dist/catalog/catalog.js +16 -14
  4. package/dist/commands/agent.js +5 -3
  5. package/dist/commands/build.js +69 -10
  6. package/dist/commands/git.js +206 -0
  7. package/dist/commands/init.js +4 -2
  8. package/dist/commands/orchestrator.js +5 -77
  9. package/dist/commands/where.js +25 -0
  10. package/dist/dashboard/dashboard.js +5 -3
  11. package/dist/dashboard/routines.js +4 -7
  12. package/dist/dashboard/shared.js +2 -2
  13. package/dist/dashboard/timeline.js +14 -14
  14. package/dist/deliverable/trash.js +2 -1
  15. package/dist/docs/index-command.js +2 -2
  16. package/dist/docs/yaml-business-tables.js +243 -0
  17. package/dist/docs/yaml-interface-tables.js +106 -0
  18. package/dist/docs/yaml-pages-command.js +5 -3
  19. package/dist/docs/yaml-pages.js +146 -3
  20. package/dist/docs/yaml-table-shared.js +70 -0
  21. package/dist/docs/yaml-tables.js +39 -0
  22. package/dist/exec/agent-config.js +9 -0
  23. package/dist/exec/agent-protected-config.js +2 -0
  24. package/dist/exec/commands.js +31 -18
  25. package/dist/exec/events.js +34 -14
  26. package/dist/exec/evidence.js +13 -3
  27. package/dist/exec/opencode-permissions.js +117 -0
  28. package/dist/exec/parent-validation.js +56 -3
  29. package/dist/exec/plans-core.js +21 -2
  30. package/dist/exec/plans-generation.js +6 -7
  31. package/dist/exec/post-integration.js +162 -0
  32. package/dist/exec/queue-command.js +166 -0
  33. package/dist/exec/queue.js +285 -0
  34. package/dist/exec/register-foreign-wait.js +82 -0
  35. package/dist/exec/repo-integration-sync.js +17 -5
  36. package/dist/exec/repo-trace.js +2 -1
  37. package/dist/exec/reporter.js +2 -2
  38. package/dist/exec/results.js +24 -4
  39. package/dist/exec/review-kata.js +4 -1
  40. package/dist/exec/run/agent-pipeline.js +3 -2
  41. package/dist/exec/run/agent.js +12 -6
  42. package/dist/exec/run/change-scope.js +365 -0
  43. package/dist/exec/run/deferred-cleanup.js +31 -0
  44. package/dist/exec/run/in-place.js +5 -2
  45. package/dist/exec/run/job-lock.js +66 -0
  46. package/dist/exec/run/job-sequence.js +137 -0
  47. package/dist/exec/run/job.js +56 -19
  48. package/dist/exec/run/lifecycle-commands.js +1 -1
  49. package/dist/exec/run/lock.js +22 -1
  50. package/dist/exec/run/register-command.js +8 -5
  51. package/dist/exec/run/register-mode.js +68 -8
  52. package/dist/exec/run/register-resume.js +68 -14
  53. package/dist/exec/run/register-state.js +13 -8
  54. package/dist/exec/run/register-worktree.js +140 -125
  55. package/dist/exec/run/schedule-mode.js +75 -14
  56. package/dist/exec/run/schedule-prepare.js +3 -0
  57. package/dist/exec/run/schedule-task.js +88 -38
  58. package/dist/exec/run/shared.js +5 -0
  59. package/dist/exec/schedule/schedule.js +116 -4
  60. package/dist/exec/shared.js +2 -2
  61. package/dist/exec/smoke.js +190 -0
  62. package/dist/exec/strategy.js +13 -3
  63. package/dist/exec/task-repos.js +19 -4
  64. package/dist/exec/task-view.js +6 -4
  65. package/dist/exec/trial-commands.js +5 -2
  66. package/dist/exec/trial-core.js +6 -1
  67. package/dist/exec/validation-metrics.js +181 -0
  68. package/dist/exec/worktree-cleanup-lock.js +26 -0
  69. package/dist/exec/worktree-command.js +12 -2
  70. package/dist/exec/worktree-ops-commit.js +2 -2
  71. package/dist/exec/worktree.js +13 -2
  72. package/dist/grade/command-apply.js +3 -3
  73. package/dist/grade/command-inspect.js +5 -3
  74. package/dist/grade/command-plan.js +1 -1
  75. package/dist/grade/command-run.js +5 -1
  76. package/dist/grade/run.js +64 -8
  77. package/dist/job/definition.js +84 -8
  78. package/dist/job/job.js +79 -23
  79. package/dist/register/authoring-sources.js +22 -16
  80. package/dist/register/maintenance-commands.js +2 -2
  81. package/dist/register/register.js +31 -7
  82. package/dist/register/renumber.js +1 -3
  83. package/dist/routine/definition.js +9 -0
  84. package/dist/routine/routine.js +137 -43
  85. package/dist/routine/status.js +62 -0
  86. package/dist/schedule/schedule.js +38 -39
  87. package/dist/shared/agent-types.js +5 -0
  88. package/dist/shared/cross-process-lock.js +9 -1
  89. package/dist/shared/dist-freshness.js +8 -2
  90. package/dist/shared/git-environment.js +2 -1
  91. package/dist/shared/git.js +44 -1
  92. package/dist/shared/lefthook-scaffold.js +3 -0
  93. package/dist/shared/local-config.js +244 -0
  94. package/dist/shared/specdojo-config.js +34 -20
  95. package/dist/shared/specdojo-gitignore.js +1 -0
  96. package/dist/shared/text.js +17 -1
  97. package/dist/shared/where-alias.js +13 -0
  98. package/dist/specdojo.js +4 -0
  99. package/docs/ja/specdojo/defaults/pm-review-viewpoints.yaml +2 -0
  100. package/docs/ja/specdojo/guides/exec-config-guide.md +23 -4
  101. package/docs/ja/specdojo/guides/exec-operation-guide.md +44 -1
  102. package/docs/ja/specdojo/guides/job-sequence-guide.md +77 -0
  103. package/docs/ja/specdojo/guides/orchestrator-operation-guide.md +1 -1
  104. package/docs/ja/specdojo/guides/quick-start-guide.md +3 -3
  105. package/docs/ja/specdojo/guides/register-operation-guide.md +1 -1
  106. package/docs/ja/specdojo/guides/routine-operation-guide.md +11 -6
  107. package/docs/ja/specdojo/guides/schedule-design-guide.md +20 -17
  108. package/docs/ja/specdojo/guides/waza-guide.md +12 -8
  109. package/docs/ja/specdojo/recipes/bac-recipe.md +66 -49
  110. package/docs/ja/specdojo/recipes/bes-recipe.md +90 -54
  111. package/docs/ja/specdojo/recipes/bps-recipe.md +88 -139
  112. package/docs/ja/specdojo/recipes/br-recipe.md +40 -47
  113. package/docs/ja/specdojo/recipes/cdfd-overview-recipe.md +97 -109
  114. package/docs/ja/specdojo/recipes/cdfd-recipe.md +85 -146
  115. package/docs/ja/specdojo/recipes/cdfd-uc-recipe.md +91 -110
  116. package/docs/ja/specdojo/recipes/cnd-recipe.md +79 -69
  117. package/docs/ja/specdojo/recipes/cpd-recipe.md +78 -64
  118. package/docs/ja/specdojo/recipes/cxd-recipe.md +92 -75
  119. package/docs/ja/specdojo/recipes/ifd-recipe.md +79 -68
  120. package/docs/ja/specdojo/recipes/ifx-cmd-recipe.md +78 -105
  121. package/docs/ja/specdojo/recipes/ifx-index-recipe.md +105 -71
  122. package/docs/ja/specdojo/recipes/pm-communication-plan-recipe.md +60 -49
  123. package/docs/ja/specdojo/recipes/pm-members-recipe.md +50 -51
  124. package/docs/ja/specdojo/recipes/pm-organization-recipe.md +59 -51
  125. package/docs/ja/specdojo/recipes/pm-plan-recipe.md +69 -56
  126. package/docs/ja/specdojo/recipes/pm-quality-management-plan-recipe.md +37 -56
  127. package/docs/ja/specdojo/recipes/pm-raci-recipe.md +39 -53
  128. package/docs/ja/specdojo/recipes/pm-roles-recipe.md +52 -79
  129. package/docs/ja/specdojo/recipes/prj-assumptions-constraints-dependencies-recipe.md +64 -93
  130. package/docs/ja/specdojo/recipes/prj-charter-recipe.md +71 -106
  131. package/docs/ja/specdojo/recipes/prj-comparison-of-alternatives-recipe.md +78 -157
  132. package/docs/ja/specdojo/recipes/prj-issues-and-approach-recipe.md +62 -111
  133. package/docs/ja/specdojo/recipes/prj-scope-recipe.md +67 -123
  134. package/docs/ja/specdojo/recipes/prj-stakeholder-register-recipe.md +60 -96
  135. package/docs/ja/specdojo/recipes/prj-success-criteria-and-acceptance-criteria-recipe.md +61 -105
  136. package/docs/ja/specdojo/recipes/stsd-recipe.md +79 -109
  137. package/docs/ja/specdojo/recipes/sysd-critical-flows-recipe.md +78 -55
  138. package/docs/ja/specdojo/recipes/sysd-cross-cutting-policy-recipe.md +82 -73
  139. package/docs/ja/specdojo/recipes/sysd-index-recipe.md +78 -59
  140. package/docs/ja/specdojo/recipes/tsd-recipe.md +149 -129
  141. package/docs/ja/specdojo/references/command-reference.md +258 -118
  142. package/docs/ja/specdojo/references/deliverables-reference.md +21 -12
  143. package/docs/ja/specdojo/references/specdojo-config-reference.md +47 -10
  144. package/docs/ja/specdojo/rulebooks/atc-index-rulebook.md +101 -257
  145. package/docs/ja/specdojo/rulebooks/atc-rulebook.md +102 -228
  146. package/docs/ja/specdojo/rulebooks/bac-rulebook.md +19 -28
  147. package/docs/ja/specdojo/rulebooks/bdd-rulebook.md +16 -67
  148. package/docs/ja/specdojo/rulebooks/bds-rulebook.md +30 -51
  149. package/docs/ja/specdojo/rulebooks/bes-index-rulebook.md +41 -61
  150. package/docs/ja/specdojo/rulebooks/bes-rulebook.md +22 -50
  151. package/docs/ja/specdojo/rulebooks/bps-rulebook.md +24 -56
  152. package/docs/ja/specdojo/rulebooks/br-rulebook.md +13 -38
  153. package/docs/ja/specdojo/rulebooks/ccd-mermaid-rulebook.md +41 -76
  154. package/docs/ja/specdojo/rulebooks/cdfd-d2-rulebook.md +18 -93
  155. package/docs/ja/specdojo/rulebooks/cdfd-mermaid-rulebook.md +18 -52
  156. package/docs/ja/specdojo/rulebooks/cdfd-overview-rulebook.md +109 -147
  157. package/docs/ja/specdojo/rulebooks/cdfd-rulebook.md +80 -108
  158. package/docs/ja/specdojo/rulebooks/cdfd-uc-rulebook.md +21 -46
  159. package/docs/ja/specdojo/rulebooks/cdr-rulebook.md +144 -0
  160. package/docs/ja/specdojo/rulebooks/cdsd-rulebook.md +27 -48
  161. package/docs/ja/specdojo/rulebooks/cdt-rulebook.md +37 -50
  162. package/docs/ja/specdojo/rulebooks/clis-rulebook.md +52 -69
  163. package/docs/ja/specdojo/rulebooks/cnd-mermaid-rulebook.md +33 -86
  164. package/docs/ja/specdojo/rulebooks/cnd-rulebook.md +16 -32
  165. package/docs/ja/specdojo/rulebooks/cop-index-rulebook.md +45 -131
  166. package/docs/ja/specdojo/rulebooks/cop-rulebook.md +69 -275
  167. package/docs/ja/specdojo/rulebooks/cpd-mermaid-rulebook.md +20 -112
  168. package/docs/ja/specdojo/rulebooks/cpd-rulebook.md +23 -56
  169. package/docs/ja/specdojo/rulebooks/cxd-mermaid-rulebook.md +12 -145
  170. package/docs/ja/specdojo/rulebooks/cxd-rulebook.md +39 -47
  171. package/docs/ja/specdojo/rulebooks/dct-index-rulebook.md +37 -56
  172. package/docs/ja/specdojo/rulebooks/dct-rulebook.md +118 -175
  173. package/docs/ja/specdojo/rulebooks/dec-rulebook.md +5 -14
  174. package/docs/ja/specdojo/rulebooks/dmd-index-rulebook.md +22 -66
  175. package/docs/ja/specdojo/rulebooks/dmd-rulebook.md +36 -94
  176. package/docs/ja/specdojo/rulebooks/dss-rulebook.md +59 -81
  177. package/docs/ja/specdojo/rulebooks/etc-index-rulebook.md +31 -131
  178. package/docs/ja/specdojo/rulebooks/etc-rulebook.md +50 -104
  179. package/docs/ja/specdojo/rulebooks/gl-rulebook.md +51 -61
  180. package/docs/ja/specdojo/rulebooks/ifd-mermaid-rulebook.md +38 -45
  181. package/docs/ja/specdojo/rulebooks/ifx-api-rulebook.md +14 -20
  182. package/docs/ja/specdojo/rulebooks/ifx-cmd-rulebook.md +26 -38
  183. package/docs/ja/specdojo/rulebooks/ifx-file-rulebook.md +26 -107
  184. package/docs/ja/specdojo/rulebooks/ifx-index-rulebook.md +42 -49
  185. package/docs/ja/specdojo/rulebooks/ifx-msg-rulebook.md +14 -22
  186. package/docs/ja/specdojo/rulebooks/imp-business-rulebook.md +21 -44
  187. package/docs/ja/specdojo/rulebooks/imp-data-rulebook.md +41 -64
  188. package/docs/ja/specdojo/rulebooks/imp-interface-rulebook.md +14 -38
  189. package/docs/ja/specdojo/rulebooks/imp-operations-rulebook.md +34 -61
  190. package/docs/ja/specdojo/rulebooks/imp-test-rulebook.md +27 -50
  191. package/docs/ja/specdojo/rulebooks/itc-index-rulebook.md +70 -199
  192. package/docs/ja/specdojo/rulebooks/itc-rulebook.md +65 -153
  193. package/docs/ja/specdojo/rulebooks/mip-index-rulebook.md +74 -150
  194. package/docs/ja/specdojo/rulebooks/mm-rulebook.md +11 -23
  195. package/docs/ja/specdojo/rulebooks/mtp-rulebook.md +99 -176
  196. package/docs/ja/specdojo/rulebooks/nfr-availability-rulebook.md +35 -61
  197. package/docs/ja/specdojo/rulebooks/nfr-index-rulebook.md +75 -117
  198. package/docs/ja/specdojo/rulebooks/nfr-integrity-rulebook.md +31 -60
  199. package/docs/ja/specdojo/rulebooks/nfr-maintainability-rulebook.md +26 -81
  200. package/docs/ja/specdojo/rulebooks/nfr-operations-rulebook.md +32 -70
  201. package/docs/ja/specdojo/rulebooks/nfr-performance-rulebook.md +45 -87
  202. package/docs/ja/specdojo/rulebooks/nfr-reliability-rulebook.md +48 -101
  203. package/docs/ja/specdojo/rulebooks/nfr-security-safety-rulebook.md +44 -80
  204. package/docs/ja/specdojo/rulebooks/nfr-usability-rulebook.md +59 -127
  205. package/docs/ja/specdojo/rulebooks/opd-index-rulebook.md +31 -50
  206. package/docs/ja/specdojo/rulebooks/opd-rulebook.md +42 -109
  207. package/docs/ja/specdojo/rulebooks/opr-index-rulebook.md +29 -42
  208. package/docs/ja/specdojo/rulebooks/opr-rulebook.md +29 -87
  209. package/docs/ja/specdojo/rulebooks/otp-index-rulebook.md +62 -84
  210. package/docs/ja/specdojo/rulebooks/otp-rulebook.md +11 -61
  211. package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +91 -106
  212. package/docs/ja/specdojo/rulebooks/pm-change-request-log-rulebook.md +25 -34
  213. package/docs/ja/specdojo/rulebooks/pm-communication-plan-rulebook.md +30 -53
  214. package/docs/ja/specdojo/rulebooks/pm-issue-log-rulebook.md +23 -35
  215. package/docs/ja/specdojo/rulebooks/pm-members-rulebook.md +27 -45
  216. package/docs/ja/specdojo/rulebooks/pm-organization-rulebook.md +37 -45
  217. package/docs/ja/specdojo/rulebooks/pm-plan-rulebook.md +45 -46
  218. package/docs/ja/specdojo/rulebooks/pm-quality-management-plan-rulebook.md +37 -48
  219. package/docs/ja/specdojo/rulebooks/pm-raci-rulebook.md +25 -29
  220. package/docs/ja/specdojo/rulebooks/pm-risk-register-rulebook.md +28 -35
  221. package/docs/ja/specdojo/rulebooks/pm-roles-rulebook.md +36 -41
  222. package/docs/ja/specdojo/rulebooks/pr-rulebook.md +5 -18
  223. package/docs/ja/specdojo/rulebooks/prj-assumptions-constraints-dependencies-rulebook.md +16 -37
  224. package/docs/ja/specdojo/rulebooks/prj-charter-rulebook.md +23 -97
  225. package/docs/ja/specdojo/rulebooks/prj-comparison-of-alternatives-rulebook.md +39 -57
  226. package/docs/ja/specdojo/rulebooks/prj-issues-and-approach-rulebook.md +43 -116
  227. package/docs/ja/specdojo/rulebooks/prj-scope-rulebook.md +16 -51
  228. package/docs/ja/specdojo/rulebooks/prj-stakeholder-register-rulebook.md +47 -92
  229. package/docs/ja/specdojo/rulebooks/prj-success-criteria-and-acceptance-criteria-rulebook.md +25 -84
  230. package/docs/ja/specdojo/rulebooks/sac-rulebook.md +44 -107
  231. package/docs/ja/specdojo/rulebooks/sf-index-rulebook.md +39 -49
  232. package/docs/ja/specdojo/rulebooks/sf-rulebook.md +42 -49
  233. package/docs/ja/specdojo/rulebooks/sld-rulebook.md +64 -89
  234. package/docs/ja/specdojo/rulebooks/stc-index-rulebook.md +90 -189
  235. package/docs/ja/specdojo/rulebooks/stc-rulebook.md +45 -105
  236. package/docs/ja/specdojo/rulebooks/stsd-mermaid-rulebook.md +6 -12
  237. package/docs/ja/specdojo/rulebooks/stsd-rulebook.md +49 -68
  238. package/docs/ja/specdojo/rulebooks/sysd-critical-flows-rulebook.md +51 -60
  239. package/docs/ja/specdojo/rulebooks/sysd-cross-cutting-policy-rulebook.md +46 -50
  240. package/docs/ja/specdojo/rulebooks/sysd-index-rulebook.md +39 -64
  241. package/docs/ja/specdojo/rulebooks/sysd-rulebook.md +47 -60
  242. package/docs/ja/specdojo/rulebooks/trc-requirements-to-specs-rulebook.md +69 -70
  243. package/docs/ja/specdojo/rulebooks/trc-requirements-to-tests-rulebook.md +65 -72
  244. package/docs/ja/specdojo/rulebooks/tsd-index-rulebook.md +35 -46
  245. package/docs/ja/specdojo/rulebooks/tsd-rulebook.md +49 -66
  246. package/docs/ja/specdojo/rulebooks/tsp-index-rulebook.md +64 -139
  247. package/docs/ja/specdojo/rulebooks/uis-rulebook.md +41 -108
  248. package/docs/ja/specdojo/rulebooks/utc-index-rulebook.md +49 -144
  249. package/docs/ja/specdojo/rulebooks/utc-rulebook.md +67 -155
  250. package/docs/ja/specdojo/samples/bds-sample.md +58 -71
  251. package/docs/ja/specdojo/samples/bes-index-sample.md +20 -37
  252. package/docs/ja/specdojo/samples/bes-sample.md +43 -53
  253. package/docs/ja/specdojo/samples/bps-sample.md +42 -54
  254. package/docs/ja/specdojo/samples/br-sample.md +40 -52
  255. package/docs/ja/specdojo/samples/ccd-sample.md +0 -1
  256. package/docs/ja/specdojo/samples/cdr-sample.md +78 -0
  257. package/docs/ja/specdojo/samples/cdsd-sample.md +47 -63
  258. package/docs/ja/specdojo/samples/clis-sample.md +70 -77
  259. package/docs/ja/specdojo/samples/dec-sample.md +2 -3
  260. package/docs/ja/specdojo/samples/ifx-api-sample.yaml +0 -2
  261. package/docs/ja/specdojo/samples/ifx-msg-sample.yaml +0 -2
  262. package/docs/ja/specdojo/samples/job-sequence.yaml +67 -0
  263. package/docs/ja/specdojo/samples/mip-index-sample.md +98 -20
  264. package/docs/ja/specdojo/samples/pm-communication-plan-sample.md +26 -19
  265. package/docs/ja/specdojo/samples/pm-organization-sample.md +39 -50
  266. package/docs/ja/specdojo/samples/pm-plan-sample.md +61 -67
  267. package/docs/ja/specdojo/samples/pm-quality-management-plan-sample.md +31 -45
  268. package/docs/ja/specdojo/samples/pm-raci-sample.md +31 -37
  269. package/docs/ja/specdojo/samples/prj-assumptions-constraints-dependencies-sample.md +32 -48
  270. package/docs/ja/specdojo/samples/prj-charter-sample.md +42 -59
  271. package/docs/ja/specdojo/samples/prj-comparison-of-alternatives-sample.md +55 -61
  272. package/docs/ja/specdojo/samples/prj-success-criteria-and-acceptance-criteria-sample.md +30 -33
  273. package/docs/ja/specdojo/samples/sf-index-sample.md +13 -55
  274. package/docs/ja/specdojo/samples/sf-sample.md +73 -85
  275. package/docs/ja/specdojo/samples/sld-sample.md +60 -79
  276. package/docs/ja/specdojo/samples/uis-sample.md +98 -121
  277. package/docs/ja/specdojo/standards/job-definition-standard.md +24 -9
  278. package/docs/ja/specdojo/templates/cdr-template.md +58 -0
  279. package/docs/specdojo/schemas/v1/exec-common.schema.yaml +2 -1
  280. package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +42 -5
  281. package/docs/specdojo/schemas/v1/exec-evidence.schema.yaml +35 -0
  282. package/docs/specdojo/schemas/v1/job-run.schema.yaml +23 -0
  283. package/docs/specdojo/schemas/v1/job.schema.yaml +63 -2
  284. package/docs/specdojo/schemas/v1/sch-strategy.schema.yaml +2 -2
  285. package/package.json +9 -6
  286. package/templates/antigravity/orchestrator.md +4 -1
  287. package/templates/claude/agents/specdojo-orchestrator.md +4 -1
  288. package/templates/codex/agents/specdojo-orchestrator.toml +4 -1
  289. package/templates/codex/orchestrator.md +4 -1
  290. package/templates/init-exec-defaults.yaml +13 -0
  291. package/templates/lefthook/tools/specdojo-pre-commit.mjs +8 -0
  292. package/templates/opencode/agents/specdojo-orchestrator.md +5 -2
@@ -11,42 +11,31 @@ specdojo:
11
11
 
12
12
  Project Scope Writing Recipe
13
13
 
14
- 本ドキュメントは、プロジェクトスコープを「関係者が対象範囲と対象外を合意できる内容」に仕上げるための作り方です。
15
- 本書では問い、深掘り手順、具体化のコツ、レビュー観点を扱います。
14
+ プロジェクトスコープを、関係者が今回やることとやらないことを合意できる内容に仕上げるための作り方を示す。
16
15
 
17
16
  ## 1. このレシピの使い方
18
17
 
19
- - 最初に、プロジェクト概要や上位方針から「何を実現したいか」を短く抜き出す。
20
- - 次に、対象業務、対象システム、対象期間、スコープ外を分けて書く。
21
- - 最後に、境界の判断基準とスコープ変更方針を置き、迷ったときの扱いを決める。
22
- - 上位の目的・期待効果(Why)、対象業務・対象システム・対象期間・対象外(What)、境界判断と変更方針(How)を整理し、上位参照、対象項目、理由、変更記録で追跡する(Trace)。受入条件と設計・実装詳細は後続成果物へ委譲する。
18
+ - スコープは、プロジェクト概要の目的・期待効果(Why)を引き継ぎ、対象業務・対象システム・対象期間・スコープ外(What)を定め、任意で境界の判断基準と変更方針(How)を決める。各行は、上位の期待効果と境界の理由で、変更後は変更記録でもたどれるようにする(Trace)。
23
19
 
24
20
  ## 2. 作成前に集める情報
25
21
 
26
- 最初から正確に書こうとせず、以下を短いメモで集める。
27
-
28
- | 項目 | 集める情報 |
29
- | ------------------ | -------------------------------------------------------------------------------------- |
30
- | 背景と必要性 | なぜ取り組むか、放置すると何が悪化するか |
31
- | 対象利用者 | 誰が使うか、誰が影響を受けるか |
32
- | 対象業務 | どの業務、活動、利用場面を対象にするか |
33
- | 対象システム | どのシステム、成果物、実行ツール、管理データ、生成物、基盤、外部連携を含めるか |
34
- | 初期対象期間 | いつからいつまで、またはどのイベントまでを対象にするか。未確定なら _UNDECIDED_: で残す |
35
- | 明示的な対象外 | やらないこと、理由、後続で扱う条件 |
36
- | 境界で迷う項目 | 含めるか外すか判断が必要な候補 |
37
- | 変更時の決め方 | 提案入口、影響評価、承認者、記録先 |
38
- | 下流文書への委譲先 | 成功基準、前提・制約、課題、設計、実装、テストへ委譲する内容 |
22
+ | 項目 | 集める情報 | 取り出し元 |
23
+ | ---------------- | ------------------------------------------------------------ | ------------------------ |
24
+ | 目的と期待効果 | 取り組む理由、放置したときに悪化すること | プロジェクト概要 |
25
+ | 利用者と利用場面 | 誰が使い、誰の作業や判断が変わるか | プロジェクト概要、利用者 |
26
+ | 整備するもの | 作る・変える・運用するシステム、ツール、正本データ、生成物 | 既存の構成、実行責任者 |
27
+ | 期間の区切り | 初期対象の終わりを決める日付またはイベント | スケジュール、承認責任者 |
28
+ | 外す候補 | やらないことと理由、再検討する条件 | 関係者への確認 |
29
+ | 迷う候補 | 含めるか外すかで意見が分かれた項目と、そのときの判断のしかた | 確認の過程のメモ |
39
30
 
40
31
  ## 3. 全体の作成手順
41
32
 
42
- 1. H1 で対象プロジェクト名を明示する。
43
- 2. 対象業務で、活動領域、利用場面、利用者影響を書く。
44
- 3. 対象システムで、対象となるシステム、成果物、実行ツール、管理データ、生成物、基盤を粒度を揃えて並べ、責務境界を書く。
45
- 4. 対象期間で、初期対象、判断イベント、継続改善との切り分けを書く。
46
- 5. スコープ外で、やらないこと、理由、後続で扱う条件を書く。
47
- 6. 境界の判断基準で、迷ったときの優先順位を定義する。
48
- 7. スコープ変更方針で、提案入口、影響評価、承認者、記録先を定義する。
49
- 8. 最後に、設計詳細や受入条件を書きすぎていないか確認する。
33
+ 1. 対象外の候補を先に書き出す。外すものが決まると、対象業務の範囲が狭まり書きやすくなる。
34
+ 2. 対象業務を、利用者の作業や判断の単位で書く。
35
+ 3. 対象システムを、対象業務を支えるものに限って並べる。
36
+ 4. 対象期間で、初期対象と継続改善を分ける。
37
+ 5. スコープ外に、1 で出した候補を理由と再検討条件を添えて書く。
38
+ 6. 迷う候補が残った場合は境界の判断基準を、変更の決め方を合意した場合はスコープ変更方針を書く。どちらも任意の章で、なければ省く。
50
39
 
51
40
  ## 4. 各章の書き方
52
41
 
@@ -54,148 +43,103 @@ Project Scope Writing Recipe
54
43
 
55
44
  問い:
56
45
 
57
- - どの業務、活動、利用場面を対象にするか。
58
- - 誰が使うか、誰の負担や判断が変わるか。
59
- - 対象にすることで、どの業務価値に近づくか。
60
- - 何を運用・管理できる状態にしたいか。
61
-
62
- 書き方:
63
-
64
- - 機能名だけでなく、利用者が行う作業や判断で書く。
65
- - 「対象利用者」「利用場面」「利用者影響」を読み取れる粒度にする。
66
- - 業務アプリケーション以外のプロジェクトでは、文書整備、公開準備、運用基盤整備などを活動領域として書く。
46
+ - 対象にすると、誰のどの作業や判断が変わるか。
47
+ - 作るだけでなく、運用・管理できる状態にしたいものは何か。
67
48
 
68
- 良い例:
49
+ コツ:
69
50
 
70
- - 単一店舗の店頭販売、店頭在庫、常連顧客のつけ管理を対象にし、店主代表以外が店番する場合でも同じ手順で確認できる状態を目指す。
71
-
72
- 悪い例:
73
-
74
- - 販売管理機能を作る。
51
+ - 機能名を書き始めたら、利用者に「その機能で何をするか」を聞いて作業の言葉に直す。
52
+ - 背景や期待効果を概要から写したくなったら、写さず概要への参照に置き換える。
75
53
 
76
54
  ### 4.2. 対象システム
77
55
 
78
56
  問い:
79
57
 
80
- - 対象となるシステム、成果物、文書体系、基盤は何か。
81
- - プロジェクトが整備・変更する実行ツールや CLI、正本データ、生成物は何か。
82
- - 生成物の正本はどれで、直接編集してよいか。
83
- - 外部連携や公開基盤はどこまで含めるか。
84
- - 対象業務と対象システムの粒度は揃っているか。
85
- - 後続の設計文書へ委譲すべき詳細を書いていないか。
58
+ - プロジェクトが整備・変更するツール、正本データ、生成物は何か。
59
+ - 外部サービスのうち、プロジェクトが担うのは設定・接続・利用のどこまでか。
86
60
 
87
- 書き方:
61
+ コツ:
88
62
 
89
- - 表形式で「対象」「内容」「境界」を分け、プロジェクトが担う範囲と担わない範囲を示す。
90
- - 業務機能、文書体系、補助ツール、公開基盤など異なる性質の対象は、同じ粒度の大項目として扱う。
91
- - 正本データと生成物は、編集方法や責務が異なる場合に別の行へ分ける。
92
- - 外部ツール本体を開発しない場合は、設定・接続・利用のみを対象とするなど責務境界を書く。
93
- - UI、API、DB、テストケースの詳細は書かない。
63
+ - 業務機能と文書体系、補助ツールが混ざると粒度がずれやすい。並べた後で、同じ大きさの項目かを見直す。
64
+ - 生成物は、生成元の正本と直接編集してよいかを聞くと、責務の境界が決まる。
65
+ - 画面・API・DB の名前が出てきたら、設計の話なので書かない。
94
66
 
95
67
  ### 4.3. 対象期間
96
68
 
97
69
  問い:
98
70
 
99
- - 初期対象はいつからいつまでか。
100
- - 日付が未確定なら、どのイベントまでを対象にするか。
101
- - 初回公開、初期リリース、運用定着、継続改善をどう分けるか。
102
- - どのスケジュール文書を期間判断の根拠にするか。
71
+ - 初期対象はどの日付、または何が起きたら終わるか。
72
+ - 継続改善のうち、今回の範囲に含めるものはあるか。
103
73
 
104
- 書き方:
74
+ コツ:
105
75
 
106
- - 日付が未確定な場合は、イベント基準で定義する。
107
- - 継続改善を含める場合は、初期スコープと継続改善フェーズを分ける。
108
- - 未決事項は _UNDECIDED_: を優先し、決める文書またはタイミングを添える。実施待ちの作業を残す場合のみ _TODO_: を使い分ける。
76
+ - 日付が出ないときは「初回公開まで」のようにイベントで聞く。決まっていなければ _UNDECIDED_ を残し、決める時期を添える。
109
77
 
110
78
  ### 4.4. スコープ外
111
79
 
112
80
  問い:
113
81
 
114
- - 今回やらないことは何か。
115
- - 外した理由は、責務境界、コスト、効果、公開適性、期間のどれか。
116
- - 利用者に影響がある対象外項目は、後続でいつ再検討するか。
117
- - 対象外を書かないことで誤解される項目はないか。
82
+ - 今回やらないことは何で、なぜ外すのか。
83
+ - 外したことで困る利用者がいる項目は、いつ再検討するか。
118
84
 
119
- 書き方:
85
+ コツ:
120
86
 
121
- - 「対象(Out)」「理由」「補足」の表にすると、やらない理由と扱いが明確になる。
122
- - スコープ外は弱い表現にせず、今回含めないことを明示する。
123
- - 「将来やるかもしれない」だけで終わらせず、再検討条件を添える。
87
+ - 「必要なら考える」は対象外になっていない。含めないと言い切り、再検討の条件を添える。
88
+ - 書かないと「含まれる」と誤解されやすい項目を、関係者に聞いて拾う。
124
89
 
125
- ### 4.5. 境界の判断基準
90
+ ### 4.5. 境界の判断基準(任意)
126
91
 
127
92
  問い:
128
93
 
129
94
  - 含めるか外すかで迷ったとき、何を優先するか。
130
- - 業務価値、利用者影響、公開適性、保守容易性のどれを重く見るか。
131
- - 特定の技術、手法、個別要望に引っ張られたとき、どう判断するか。
95
+ - 個別の要望や特定の技術に引っ張られたとき、何で判断するか。
132
96
 
133
- 書き方:
97
+ コツ:
134
98
 
135
- - 2〜5 件程度の優先順位付き箇条書きにする。
136
- - 判断基準は、後続のスコープ変更や優先度判断に再利用できる表現にする。
99
+ - 迷う候補で実際に判断した理由から書くと、後の変更判断にも使える原則になる。
137
100
 
138
- ### 4.6. スコープ変更方針
101
+ ### 4.6. スコープ変更方針(任意)
139
102
 
140
103
  問い:
141
104
 
142
- - 誰が変更を提案できるか。
143
- - どこに記録するか。
144
- - 何を確認してから判断するか。
145
- - 誰が承認するか。
146
- - 変更により影響を受ける成果物は何か。
105
+ - 誰がどこに変更を提案し、誰が決めるか。
106
+ - 初期リリース前に足すとき、何を外すか延期するか。
147
107
 
148
- 書き方:
108
+ コツ:
149
109
 
150
- - 「変更入口」「影響評価」「承認者」「記録先」の表にすると、最低限の運用が揃う。
151
- - 初期リリース前に追加する場合は、同時に外すものや延期するものを示す。
152
- - 判断理由を DEC、課題一覧、Issue、PR、変更要求ログのいずれかに残す。
110
+ - 「関係者で相談する」で止めず、決める人と判断理由を残す場所を聞く。
153
111
 
154
112
  ## 5. 深掘り手順
155
113
 
156
- 内容が浅いと感じる場合は、次の順で深掘りする。
114
+ 内容が浅いときは、次の順で対応のない主張を探す。
157
115
 
158
- 1. **対象利用者** を具体化する。
159
- 2. **利用場面** を業務や活動の単位で書く。
160
- 3. **対象外にすべき候補** を先に列挙する。
161
- 4. **対象業務と対象システムの対応** を確認する。
162
- 5. **初期対象と継続改善** を分ける。
163
- 6. **迷ったときの判断順序** を 2〜5 件に絞る。
164
- 7. **変更時の承認者と記録先** を決める。
116
+ 1. 対象業務の各行が、概要のどの期待効果に応えるかを確かめ、対応のない行を外すかスコープ外へ移す。
117
+ 2. 対象システムの各行が、どの対象業務を支えるかを確かめる。
118
+ 3. スコープ外の各行に、外す理由と再検討条件があるかを確かめる。
119
+ 4. 受入条件・設計・実装の詳細を書いた箇所を見つけ、後続の成果物へ移す。
165
120
 
166
121
  ## 6. 良い例 / 悪い例
167
122
 
168
- | 観点 | 良い例 | 悪い例 |
169
- | ------------ | --------------------------------------------------------------------- | ---------------------------- |
170
- | 対象業務 | 店主代表以外が店番する場合でも販売・在庫・つけ残高を確認できる状態 | 販売管理を改善する |
171
- | 対象システム | 販売登録、管理データ、生成レポートを分け、編集・責務の境界を示す | 画面名、API、DBを混在させる |
172
- | 対象期間 | 初期リリースから2週間の記録継続確認までを対象にする | できるだけ早く公開する |
173
- | スコープ外 | EC は店頭販売の記録継続を優先するため対象外とし、次フェーズで検討する | 必要なら EC も考える |
174
- | 境界判断 | 日々使う業務を優先し、高度な分析は記録安定後に扱う | 便利そうなものは入れる |
175
- | 変更方針 | 提案入口、影響評価、承認者、記録先を表で示す | 関係者で相談して柔軟に決める |
123
+ | 観点 | 良い例 | 悪い例 |
124
+ | ------------ | --------------------------------------------------------------------- | --------------------------- |
125
+ | 対象業務 | 店主代表以外が店番する場合でも販売・在庫・つけ残高を確認できる状態 | 販売管理を改善する |
126
+ | 対象システム | 販売登録、管理データ、生成レポートを分け、編集・責務の境界を示す | 画面名、API、DBを混在させる |
127
+ | 対象期間 | 初期リリースから2週間の記録継続確認までを対象にする | できるだけ早く公開する |
128
+ | スコープ外 | EC は店頭販売の記録継続を優先するため対象外とし、次フェーズで検討する | 必要なら EC も考える |
129
+ | 境界判断 | 日々使う業務を優先し、高度な分析は記録安定後に扱う | 便利そうなものは入れる |
176
130
 
177
131
  ## 7. レビュー観点
178
132
 
179
- 作成後は、次の観点で確認する。
180
-
181
- | 観点 | 確認内容 |
182
- | ---------------- | ------------------------------------------------------------------ |
183
- | 業務価値との対応 | プロジェクト概要の背景、必要性、期待効果とスコープが対応しているか |
184
- | 利用者影響 | 対象利用者、利用場面、影響範囲が読み取れるか |
185
- | 対象範囲 | 対象業務、対象システム、対象期間が判断可能な粒度か |
186
- | システム境界 | 実行ツール、正本データ、生成物、外部サービスの責務を区別できるか |
187
- | 対象外 | やらないこと、理由、再検討条件が明示されているか |
188
- | 境界判断 | 迷ったときに使える優先順位や判断原則があるか |
189
- | 変更運用 | 変更入口、影響評価、承認者、記録先があるか |
190
- | 責務分担 | 受入条件、設計詳細、実装詳細を書きすぎていないか |
191
- | 公開適性 | 個人情報、非公開情報、機密情報が含まれていないか |
133
+ | 観点 | 確認内容 |
134
+ | ------------ | -------------------------------------------------------------- |
135
+ | 業務価値 | 対象業務が概要の期待効果に対応し、利用者への影響が読み取れるか |
136
+ | システム境界 | ツール、正本データ、生成物、外部サービスの責務を区別できるか |
137
+ | 境界の合意 | 関係者が、迷う候補を含めるか外すかをこの文書だけで判断できるか |
192
138
 
193
139
  ## 8. 仕上げチェック
194
140
 
195
- - 「全体の作成手順」で示した章立てがそろっている。
196
- - 対象業務、対象システム、対象期間、スコープ外がすべて記述されている。
197
- - 未確定の日付やイベントは _UNDECIDED_: を優先し、決定タイミングが添えられている。
198
- - スコープ外に理由と補足がある。
199
- - 境界の判断基準とスコープ変更方針が、後続の判断に使える。
200
- - 成功基準、受入条件、設計詳細、実装詳細を書きすぎていない。
201
- - 各対象・対象外を上位の目的または期待効果、境界理由、再検討条件、変更記録へ追跡できる。
141
+ - 対象業務・対象システムの各行が、概要の期待効果と境界の理由へたどれる。変更した行は、変更記録にもたどれる。
142
+ - 未確定の期間に _UNDECIDED_ と決める時期がある。
143
+ - 境界の判断基準・スコープ変更方針は、書いた場合だけ、後の判断に使える原則と決める人があるかを確かめる。
144
+ - 受入条件・設計・実装の詳細を書いていない。
145
+ - 個人情報、公開できない情報、機密情報を含めていない。
@@ -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
+ - 見直し条件の各行に、承認する役割が書かれている。