specdojo 0.8.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 (284) hide show
  1. package/.github/agents/specdojo-orchestrator.md +4 -1
  2. package/CHANGELOG.md +64 -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/where.js +25 -0
  9. package/dist/dashboard/dashboard.js +5 -3
  10. package/dist/dashboard/routines.js +4 -7
  11. package/dist/dashboard/timeline.js +14 -14
  12. package/dist/docs/index-command.js +2 -2
  13. package/dist/docs/yaml-business-tables.js +243 -0
  14. package/dist/docs/yaml-interface-tables.js +106 -0
  15. package/dist/docs/yaml-pages-command.js +5 -3
  16. package/dist/docs/yaml-pages.js +146 -3
  17. package/dist/docs/yaml-table-shared.js +70 -0
  18. package/dist/docs/yaml-tables.js +39 -0
  19. package/dist/exec/agent-config.js +9 -0
  20. package/dist/exec/agent-protected-config.js +2 -0
  21. package/dist/exec/commands.js +31 -18
  22. package/dist/exec/events.js +34 -14
  23. package/dist/exec/evidence.js +13 -3
  24. package/dist/exec/parent-validation.js +56 -3
  25. package/dist/exec/plans-core.js +21 -2
  26. package/dist/exec/plans-generation.js +6 -7
  27. package/dist/exec/post-integration.js +162 -0
  28. package/dist/exec/queue-command.js +166 -0
  29. package/dist/exec/queue.js +285 -0
  30. package/dist/exec/register-foreign-wait.js +84 -0
  31. package/dist/exec/repo-integration-sync.js +17 -5
  32. package/dist/exec/reporter.js +2 -2
  33. package/dist/exec/results.js +24 -4
  34. package/dist/exec/review-kata.js +4 -1
  35. package/dist/exec/run/agent-pipeline.js +3 -2
  36. package/dist/exec/run/agent.js +12 -6
  37. package/dist/exec/run/change-scope.js +365 -0
  38. package/dist/exec/run/deferred-cleanup.js +31 -0
  39. package/dist/exec/run/in-place.js +4 -1
  40. package/dist/exec/run/job-lock.js +66 -0
  41. package/dist/exec/run/job-sequence.js +137 -0
  42. package/dist/exec/run/job.js +56 -19
  43. package/dist/exec/run/lifecycle-commands.js +1 -1
  44. package/dist/exec/run/lock.js +22 -1
  45. package/dist/exec/run/register-command.js +8 -5
  46. package/dist/exec/run/register-mode.js +68 -8
  47. package/dist/exec/run/register-resume.js +68 -14
  48. package/dist/exec/run/register-state.js +13 -8
  49. package/dist/exec/run/register-worktree.js +140 -125
  50. package/dist/exec/run/schedule-mode.js +75 -14
  51. package/dist/exec/run/schedule-prepare.js +3 -0
  52. package/dist/exec/run/schedule-task.js +88 -38
  53. package/dist/exec/run/shared.js +5 -0
  54. package/dist/exec/schedule/schedule.js +116 -4
  55. package/dist/exec/shared.js +1 -1
  56. package/dist/exec/smoke.js +190 -0
  57. package/dist/exec/strategy.js +13 -3
  58. package/dist/exec/task-view.js +6 -4
  59. package/dist/exec/trial-commands.js +5 -2
  60. package/dist/exec/trial-core.js +6 -1
  61. package/dist/exec/validation-metrics.js +181 -0
  62. package/dist/exec/worktree-cleanup-lock.js +26 -0
  63. package/dist/exec/worktree-command.js +9 -1
  64. package/dist/exec/worktree-ops-commit.js +2 -2
  65. package/dist/exec/worktree.js +13 -2
  66. package/dist/grade/command-apply.js +3 -3
  67. package/dist/grade/command-inspect.js +5 -3
  68. package/dist/grade/command-plan.js +1 -1
  69. package/dist/grade/command-run.js +5 -1
  70. package/dist/grade/run.js +64 -8
  71. package/dist/job/definition.js +84 -8
  72. package/dist/job/job.js +79 -23
  73. package/dist/register/authoring-sources.js +22 -16
  74. package/dist/register/maintenance-commands.js +2 -2
  75. package/dist/register/register.js +31 -7
  76. package/dist/routine/definition.js +9 -0
  77. package/dist/routine/routine.js +137 -43
  78. package/dist/routine/status.js +62 -0
  79. package/dist/schedule/schedule.js +38 -39
  80. package/dist/shared/agent-types.js +5 -0
  81. package/dist/shared/cross-process-lock.js +9 -1
  82. package/dist/shared/dist-freshness.js +8 -2
  83. package/dist/shared/git-environment.js +2 -1
  84. package/dist/shared/git.js +44 -1
  85. package/dist/shared/lefthook-scaffold.js +3 -0
  86. package/dist/shared/local-config.js +244 -0
  87. package/dist/shared/specdojo-config.js +34 -20
  88. package/dist/shared/specdojo-gitignore.js +1 -0
  89. package/dist/shared/text.js +9 -1
  90. package/dist/shared/where-alias.js +13 -0
  91. package/dist/specdojo.js +4 -0
  92. package/docs/ja/specdojo/defaults/pm-review-viewpoints.yaml +2 -0
  93. package/docs/ja/specdojo/guides/exec-config-guide.md +23 -4
  94. package/docs/ja/specdojo/guides/exec-operation-guide.md +44 -1
  95. package/docs/ja/specdojo/guides/job-sequence-guide.md +77 -0
  96. package/docs/ja/specdojo/guides/quick-start-guide.md +3 -3
  97. package/docs/ja/specdojo/guides/register-operation-guide.md +1 -1
  98. package/docs/ja/specdojo/guides/routine-operation-guide.md +11 -6
  99. package/docs/ja/specdojo/guides/schedule-design-guide.md +20 -17
  100. package/docs/ja/specdojo/guides/waza-guide.md +12 -8
  101. package/docs/ja/specdojo/recipes/bac-recipe.md +66 -49
  102. package/docs/ja/specdojo/recipes/bes-recipe.md +90 -54
  103. package/docs/ja/specdojo/recipes/bps-recipe.md +88 -139
  104. package/docs/ja/specdojo/recipes/br-recipe.md +40 -47
  105. package/docs/ja/specdojo/recipes/cdfd-overview-recipe.md +97 -109
  106. package/docs/ja/specdojo/recipes/cdfd-recipe.md +85 -146
  107. package/docs/ja/specdojo/recipes/cdfd-uc-recipe.md +91 -110
  108. package/docs/ja/specdojo/recipes/cnd-recipe.md +79 -69
  109. package/docs/ja/specdojo/recipes/cpd-recipe.md +78 -64
  110. package/docs/ja/specdojo/recipes/cxd-recipe.md +92 -75
  111. package/docs/ja/specdojo/recipes/ifd-recipe.md +79 -68
  112. package/docs/ja/specdojo/recipes/ifx-cmd-recipe.md +78 -105
  113. package/docs/ja/specdojo/recipes/ifx-index-recipe.md +105 -71
  114. package/docs/ja/specdojo/recipes/pm-communication-plan-recipe.md +60 -49
  115. package/docs/ja/specdojo/recipes/pm-members-recipe.md +50 -51
  116. package/docs/ja/specdojo/recipes/pm-organization-recipe.md +59 -51
  117. package/docs/ja/specdojo/recipes/pm-plan-recipe.md +69 -56
  118. package/docs/ja/specdojo/recipes/pm-quality-management-plan-recipe.md +37 -56
  119. package/docs/ja/specdojo/recipes/pm-raci-recipe.md +39 -53
  120. package/docs/ja/specdojo/recipes/pm-roles-recipe.md +52 -79
  121. package/docs/ja/specdojo/recipes/prj-assumptions-constraints-dependencies-recipe.md +64 -93
  122. package/docs/ja/specdojo/recipes/prj-charter-recipe.md +71 -106
  123. package/docs/ja/specdojo/recipes/prj-comparison-of-alternatives-recipe.md +78 -157
  124. package/docs/ja/specdojo/recipes/prj-issues-and-approach-recipe.md +62 -111
  125. package/docs/ja/specdojo/recipes/prj-scope-recipe.md +67 -123
  126. package/docs/ja/specdojo/recipes/prj-stakeholder-register-recipe.md +60 -96
  127. package/docs/ja/specdojo/recipes/prj-success-criteria-and-acceptance-criteria-recipe.md +61 -105
  128. package/docs/ja/specdojo/recipes/stsd-recipe.md +79 -109
  129. package/docs/ja/specdojo/recipes/sysd-critical-flows-recipe.md +78 -55
  130. package/docs/ja/specdojo/recipes/sysd-cross-cutting-policy-recipe.md +82 -73
  131. package/docs/ja/specdojo/recipes/sysd-index-recipe.md +78 -59
  132. package/docs/ja/specdojo/recipes/tsd-recipe.md +149 -129
  133. package/docs/ja/specdojo/references/command-reference.md +257 -117
  134. package/docs/ja/specdojo/references/deliverables-reference.md +21 -12
  135. package/docs/ja/specdojo/references/specdojo-config-reference.md +37 -2
  136. package/docs/ja/specdojo/rulebooks/atc-index-rulebook.md +101 -257
  137. package/docs/ja/specdojo/rulebooks/atc-rulebook.md +102 -228
  138. package/docs/ja/specdojo/rulebooks/bac-rulebook.md +19 -28
  139. package/docs/ja/specdojo/rulebooks/bdd-rulebook.md +16 -67
  140. package/docs/ja/specdojo/rulebooks/bds-rulebook.md +30 -51
  141. package/docs/ja/specdojo/rulebooks/bes-index-rulebook.md +41 -61
  142. package/docs/ja/specdojo/rulebooks/bes-rulebook.md +22 -50
  143. package/docs/ja/specdojo/rulebooks/bps-rulebook.md +24 -56
  144. package/docs/ja/specdojo/rulebooks/br-rulebook.md +13 -38
  145. package/docs/ja/specdojo/rulebooks/ccd-mermaid-rulebook.md +41 -76
  146. package/docs/ja/specdojo/rulebooks/cdfd-d2-rulebook.md +18 -93
  147. package/docs/ja/specdojo/rulebooks/cdfd-mermaid-rulebook.md +18 -52
  148. package/docs/ja/specdojo/rulebooks/cdfd-overview-rulebook.md +109 -147
  149. package/docs/ja/specdojo/rulebooks/cdfd-rulebook.md +80 -108
  150. package/docs/ja/specdojo/rulebooks/cdfd-uc-rulebook.md +21 -46
  151. package/docs/ja/specdojo/rulebooks/cdr-rulebook.md +144 -0
  152. package/docs/ja/specdojo/rulebooks/cdsd-rulebook.md +27 -48
  153. package/docs/ja/specdojo/rulebooks/cdt-rulebook.md +37 -50
  154. package/docs/ja/specdojo/rulebooks/clis-rulebook.md +52 -69
  155. package/docs/ja/specdojo/rulebooks/cnd-mermaid-rulebook.md +33 -86
  156. package/docs/ja/specdojo/rulebooks/cnd-rulebook.md +16 -32
  157. package/docs/ja/specdojo/rulebooks/cop-index-rulebook.md +45 -131
  158. package/docs/ja/specdojo/rulebooks/cop-rulebook.md +69 -275
  159. package/docs/ja/specdojo/rulebooks/cpd-mermaid-rulebook.md +20 -112
  160. package/docs/ja/specdojo/rulebooks/cpd-rulebook.md +23 -56
  161. package/docs/ja/specdojo/rulebooks/cxd-mermaid-rulebook.md +12 -145
  162. package/docs/ja/specdojo/rulebooks/cxd-rulebook.md +39 -47
  163. package/docs/ja/specdojo/rulebooks/dct-index-rulebook.md +37 -56
  164. package/docs/ja/specdojo/rulebooks/dct-rulebook.md +118 -175
  165. package/docs/ja/specdojo/rulebooks/dec-rulebook.md +5 -14
  166. package/docs/ja/specdojo/rulebooks/dmd-index-rulebook.md +22 -66
  167. package/docs/ja/specdojo/rulebooks/dmd-rulebook.md +36 -94
  168. package/docs/ja/specdojo/rulebooks/dss-rulebook.md +59 -81
  169. package/docs/ja/specdojo/rulebooks/etc-index-rulebook.md +31 -131
  170. package/docs/ja/specdojo/rulebooks/etc-rulebook.md +50 -104
  171. package/docs/ja/specdojo/rulebooks/gl-rulebook.md +51 -61
  172. package/docs/ja/specdojo/rulebooks/ifd-mermaid-rulebook.md +38 -45
  173. package/docs/ja/specdojo/rulebooks/ifx-api-rulebook.md +14 -20
  174. package/docs/ja/specdojo/rulebooks/ifx-cmd-rulebook.md +26 -38
  175. package/docs/ja/specdojo/rulebooks/ifx-file-rulebook.md +26 -107
  176. package/docs/ja/specdojo/rulebooks/ifx-index-rulebook.md +42 -49
  177. package/docs/ja/specdojo/rulebooks/ifx-msg-rulebook.md +14 -22
  178. package/docs/ja/specdojo/rulebooks/imp-business-rulebook.md +21 -44
  179. package/docs/ja/specdojo/rulebooks/imp-data-rulebook.md +41 -64
  180. package/docs/ja/specdojo/rulebooks/imp-interface-rulebook.md +14 -38
  181. package/docs/ja/specdojo/rulebooks/imp-operations-rulebook.md +34 -61
  182. package/docs/ja/specdojo/rulebooks/imp-test-rulebook.md +27 -50
  183. package/docs/ja/specdojo/rulebooks/itc-index-rulebook.md +70 -199
  184. package/docs/ja/specdojo/rulebooks/itc-rulebook.md +65 -153
  185. package/docs/ja/specdojo/rulebooks/mip-index-rulebook.md +74 -150
  186. package/docs/ja/specdojo/rulebooks/mm-rulebook.md +11 -23
  187. package/docs/ja/specdojo/rulebooks/mtp-rulebook.md +99 -176
  188. package/docs/ja/specdojo/rulebooks/nfr-availability-rulebook.md +35 -61
  189. package/docs/ja/specdojo/rulebooks/nfr-index-rulebook.md +75 -117
  190. package/docs/ja/specdojo/rulebooks/nfr-integrity-rulebook.md +31 -60
  191. package/docs/ja/specdojo/rulebooks/nfr-maintainability-rulebook.md +26 -81
  192. package/docs/ja/specdojo/rulebooks/nfr-operations-rulebook.md +32 -70
  193. package/docs/ja/specdojo/rulebooks/nfr-performance-rulebook.md +45 -87
  194. package/docs/ja/specdojo/rulebooks/nfr-reliability-rulebook.md +48 -101
  195. package/docs/ja/specdojo/rulebooks/nfr-security-safety-rulebook.md +44 -80
  196. package/docs/ja/specdojo/rulebooks/nfr-usability-rulebook.md +59 -127
  197. package/docs/ja/specdojo/rulebooks/opd-index-rulebook.md +31 -50
  198. package/docs/ja/specdojo/rulebooks/opd-rulebook.md +42 -109
  199. package/docs/ja/specdojo/rulebooks/opr-index-rulebook.md +29 -42
  200. package/docs/ja/specdojo/rulebooks/opr-rulebook.md +29 -87
  201. package/docs/ja/specdojo/rulebooks/otp-index-rulebook.md +62 -84
  202. package/docs/ja/specdojo/rulebooks/otp-rulebook.md +11 -61
  203. package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +91 -106
  204. package/docs/ja/specdojo/rulebooks/pm-change-request-log-rulebook.md +25 -34
  205. package/docs/ja/specdojo/rulebooks/pm-communication-plan-rulebook.md +30 -53
  206. package/docs/ja/specdojo/rulebooks/pm-issue-log-rulebook.md +23 -35
  207. package/docs/ja/specdojo/rulebooks/pm-members-rulebook.md +27 -45
  208. package/docs/ja/specdojo/rulebooks/pm-organization-rulebook.md +37 -45
  209. package/docs/ja/specdojo/rulebooks/pm-plan-rulebook.md +45 -46
  210. package/docs/ja/specdojo/rulebooks/pm-quality-management-plan-rulebook.md +37 -48
  211. package/docs/ja/specdojo/rulebooks/pm-raci-rulebook.md +25 -29
  212. package/docs/ja/specdojo/rulebooks/pm-risk-register-rulebook.md +28 -35
  213. package/docs/ja/specdojo/rulebooks/pm-roles-rulebook.md +36 -41
  214. package/docs/ja/specdojo/rulebooks/pr-rulebook.md +5 -18
  215. package/docs/ja/specdojo/rulebooks/prj-assumptions-constraints-dependencies-rulebook.md +16 -37
  216. package/docs/ja/specdojo/rulebooks/prj-charter-rulebook.md +23 -97
  217. package/docs/ja/specdojo/rulebooks/prj-comparison-of-alternatives-rulebook.md +39 -57
  218. package/docs/ja/specdojo/rulebooks/prj-issues-and-approach-rulebook.md +43 -116
  219. package/docs/ja/specdojo/rulebooks/prj-scope-rulebook.md +16 -51
  220. package/docs/ja/specdojo/rulebooks/prj-stakeholder-register-rulebook.md +47 -92
  221. package/docs/ja/specdojo/rulebooks/prj-success-criteria-and-acceptance-criteria-rulebook.md +25 -84
  222. package/docs/ja/specdojo/rulebooks/sac-rulebook.md +44 -107
  223. package/docs/ja/specdojo/rulebooks/sf-index-rulebook.md +39 -49
  224. package/docs/ja/specdojo/rulebooks/sf-rulebook.md +42 -49
  225. package/docs/ja/specdojo/rulebooks/sld-rulebook.md +64 -89
  226. package/docs/ja/specdojo/rulebooks/stc-index-rulebook.md +90 -189
  227. package/docs/ja/specdojo/rulebooks/stc-rulebook.md +45 -105
  228. package/docs/ja/specdojo/rulebooks/stsd-mermaid-rulebook.md +6 -12
  229. package/docs/ja/specdojo/rulebooks/stsd-rulebook.md +49 -68
  230. package/docs/ja/specdojo/rulebooks/sysd-critical-flows-rulebook.md +51 -60
  231. package/docs/ja/specdojo/rulebooks/sysd-cross-cutting-policy-rulebook.md +46 -50
  232. package/docs/ja/specdojo/rulebooks/sysd-index-rulebook.md +39 -64
  233. package/docs/ja/specdojo/rulebooks/sysd-rulebook.md +47 -60
  234. package/docs/ja/specdojo/rulebooks/trc-requirements-to-specs-rulebook.md +69 -70
  235. package/docs/ja/specdojo/rulebooks/trc-requirements-to-tests-rulebook.md +65 -72
  236. package/docs/ja/specdojo/rulebooks/tsd-index-rulebook.md +35 -46
  237. package/docs/ja/specdojo/rulebooks/tsd-rulebook.md +49 -66
  238. package/docs/ja/specdojo/rulebooks/tsp-index-rulebook.md +64 -139
  239. package/docs/ja/specdojo/rulebooks/uis-rulebook.md +41 -108
  240. package/docs/ja/specdojo/rulebooks/utc-index-rulebook.md +49 -144
  241. package/docs/ja/specdojo/rulebooks/utc-rulebook.md +67 -155
  242. package/docs/ja/specdojo/samples/bds-sample.md +58 -71
  243. package/docs/ja/specdojo/samples/bes-index-sample.md +20 -37
  244. package/docs/ja/specdojo/samples/bes-sample.md +43 -53
  245. package/docs/ja/specdojo/samples/bps-sample.md +42 -54
  246. package/docs/ja/specdojo/samples/br-sample.md +40 -52
  247. package/docs/ja/specdojo/samples/ccd-sample.md +0 -1
  248. package/docs/ja/specdojo/samples/cdr-sample.md +78 -0
  249. package/docs/ja/specdojo/samples/cdsd-sample.md +47 -63
  250. package/docs/ja/specdojo/samples/clis-sample.md +70 -77
  251. package/docs/ja/specdojo/samples/dec-sample.md +2 -3
  252. package/docs/ja/specdojo/samples/ifx-api-sample.yaml +0 -2
  253. package/docs/ja/specdojo/samples/ifx-msg-sample.yaml +0 -2
  254. package/docs/ja/specdojo/samples/job-sequence.yaml +67 -0
  255. package/docs/ja/specdojo/samples/mip-index-sample.md +98 -20
  256. package/docs/ja/specdojo/samples/pm-communication-plan-sample.md +26 -19
  257. package/docs/ja/specdojo/samples/pm-organization-sample.md +39 -50
  258. package/docs/ja/specdojo/samples/pm-plan-sample.md +61 -67
  259. package/docs/ja/specdojo/samples/pm-quality-management-plan-sample.md +31 -45
  260. package/docs/ja/specdojo/samples/pm-raci-sample.md +31 -37
  261. package/docs/ja/specdojo/samples/prj-assumptions-constraints-dependencies-sample.md +32 -48
  262. package/docs/ja/specdojo/samples/prj-charter-sample.md +42 -59
  263. package/docs/ja/specdojo/samples/prj-comparison-of-alternatives-sample.md +55 -61
  264. package/docs/ja/specdojo/samples/prj-success-criteria-and-acceptance-criteria-sample.md +30 -33
  265. package/docs/ja/specdojo/samples/sf-index-sample.md +13 -55
  266. package/docs/ja/specdojo/samples/sf-sample.md +73 -85
  267. package/docs/ja/specdojo/samples/sld-sample.md +60 -79
  268. package/docs/ja/specdojo/samples/uis-sample.md +98 -121
  269. package/docs/ja/specdojo/standards/job-definition-standard.md +24 -9
  270. package/docs/ja/specdojo/templates/cdr-template.md +58 -0
  271. package/docs/specdojo/schemas/v1/exec-common.schema.yaml +2 -1
  272. package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +42 -5
  273. package/docs/specdojo/schemas/v1/exec-evidence.schema.yaml +35 -0
  274. package/docs/specdojo/schemas/v1/job-run.schema.yaml +23 -0
  275. package/docs/specdojo/schemas/v1/job.schema.yaml +63 -2
  276. package/docs/specdojo/schemas/v1/sch-strategy.schema.yaml +2 -2
  277. package/package.json +9 -6
  278. package/templates/antigravity/orchestrator.md +4 -1
  279. package/templates/claude/agents/specdojo-orchestrator.md +4 -1
  280. package/templates/codex/agents/specdojo-orchestrator.toml +4 -1
  281. package/templates/codex/orchestrator.md +4 -1
  282. package/templates/init-exec-defaults.yaml +13 -0
  283. package/templates/lefthook/tools/specdojo-pre-commit.mjs +8 -0
  284. package/templates/opencode/agents/specdojo-orchestrator.md +5 -2
@@ -11,36 +11,31 @@ specdojo:
11
11
 
12
12
  Assumptions, Constraints and Dependencies Writing Recipe
13
13
 
14
- 本書は、変化があったときに判断・対応できる前提・制約・依存関係を作るための手順である。本書では問い、具体化手順、レビュー観点を扱う。
14
+ 前提・制約・依存関係を、条件が変わったときに所有者が影響を確かめ、判断者へつなげられる内容に仕上げるための作り方を示す。
15
15
 
16
16
  ## 1. このレシピの使い方
17
17
 
18
- - 最初に、スコープから「成立しないと何が困るか」「守らなければならない境界」「他者または先行成果物に求める条件」を抜き出す。
19
- - 次に、候補からスコープなど上位文書で確定済みの決定事項を除き、残った条件だけを前提、制約、依存関係のいずれか一つに分類し、影響と変化時の対応を対にして書く。除いた境界は該当章の冒頭で参照先を明示して委譲する。
20
- - 最後に、未確定事項を断定せず、確認先または決定時期を _TODO_: / _UNDECIDED_: / _ASSUMPTION_: で明示する。
21
- - 守る成果や境界(Why)、前提・制約・依存(What)、確認・監視・変化時対応(How)を整理し、項目 ID、`based_on`、根拠、影響、対応の同じ行で追跡する(Trace)。上位文書で確定済みの境界や詳細設計は再掲しない。
18
+ - 本書は、スコープ・憲章が定めた守る成果と境界(Why)を引き継ぎ、それを実行するために置く条件・守る限界・受ける提供(What)を定め、確認・変化時の対応と判断者(How)を決める。各条件は項目 ID の同じ行で根拠から対応までたどれるようにする(Trace)。
19
+ - 「作成前に集める情報」をメモでそろえてから、「全体の作成手順」の順に書く。
20
+ - 書き終えたら「レビュー観点」で読み直し、「仕上げチェック」で確かめる。
22
21
 
23
22
  ## 2. 作成前に集める情報
24
23
 
25
- | 項目 | 集める情報 |
26
- | ---------------- | ------------------------------------------------------------------ |
27
- | スコープと対象外 | 対象範囲、意図的に含めないもの、境界判断の原則 |
28
- | 成立条件 | 人、情報、環境、先行成果物、意思決定など、欠けると進行できないもの |
29
- | 守るべき限界 | 公開範囲、責務境界、互換性、費用、期日、技術選択に関する制限 |
30
- | 依存先 | 外部組織、サービス、先行成果物、承認、提供物、判断イベント |
31
- | 影響 | 変化した場合に影響するスコープ、期日、品質、運用、公開適性 |
32
- | 確認と判断 | 状態を確認する方法、変化のトリガー、所有者、最終判断者 |
24
+ | 項目 | 集める情報 | 取り出し元 |
25
+ | ---------------- | ---------------------------------------------------------- | ------------------------------ |
26
+ | 境界 | 対象外、境界の判断基準、すでに監視・記録先を持つ判断 | スコープ、憲章 |
27
+ | 結論だけの制約 | 予算枠・公開情報など、結論はあるが監視の仕組みがない条件 | 憲章の主要前提・制約 |
28
+ | 成立条件 | 欠けると進めない人・情報・環境・先行成果物 | 計画担当・実行担当への聞き取り |
29
+ | 受ける提供・判断 | 依存先、受け取る物、受け取れたと分かる記録、決定待ちの論点 | 依存先の担当、登録簿の決定記録 |
30
+ | 変化の知らせ | 変化を最初に知る人と、その記録 | 所有者候補への聞き取り |
33
31
 
34
32
  ## 3. 全体の作成手順
35
33
 
36
- 1. 直接参照したスコープ・上位成果物を `based_on` に限定して記載する。
37
- 2. 候補のうち、スコープで確定済みの境界・対象外は登録せず、該当章の冒頭で参照先を明示して委譲する。
38
- 3. 自分たちが成立すると置く仮説と、他者から受ける提供・判断を分け、前者を前提条件へ書く。根拠、影響、確認方法、変化時の対応を補う。
39
- 4. 守るべき限界を制約事項として書き、適用範囲と逸脱条件を明確にする。
40
- 5. 他者・外部・先行成果物から受ける条件を依存関係として書き、成立条件を定める。意思決定待ちの依存は、プロジェクト登録簿へ登録して本書から項目 ID を参照する。
41
- 6. 変化の種別ごとに、最初に確認することと対応方針をまとめる。
42
- 7. 監視・変更管理に、見直す契機と変更記録に残す情報を置く。
43
- 8. 既存の項目 ID を保持し、新規行を種別ごとに採番する。分類変更は新旧 ID を変更記録で結び、各行の根拠、所有者、対応を照合する。
34
+ 1. 候補を挙げ、スコープ・憲章ですでに決まっている境界を先に外す。外さずに分類を始めると、上位文書の言い直しが行に残る。
35
+ 2. 残った候補を、自分たちが成り立つと置く仮説(前提条件)、守る限界(制約事項)、他者から受ける提供・判断(依存関係)に分ける。迷う候補は「誰が提供を止められるか」で分ける。
36
+ 3. 前提条件・制約事項・依存関係を、それぞれ根拠・影響・確認方法・対応と対にして書く。
37
+ 4. 変化の種別ごとに、最初に確かめることと次の判断者を影響評価と対応方針へまとめる。
38
+ 5. 最後に監視・変更管理と冒頭文を書く。登録した条件が決まってからだと、見直しの契機を条件から逆算できる。
44
39
 
45
40
  ## 4. 各章の書き方
46
41
 
@@ -48,117 +43,93 @@ Assumptions, Constraints and Dependencies Writing Recipe
48
43
 
49
44
  問い:
50
45
 
51
- - 何が真または利用可能であることを前提にしているか。
52
- - その前提が崩れると、誰の作業またはどの成果物に影響するか。
53
- - どの記録・確認で変化を検知できるか。
46
+ - 何が成り立たないと計画が止まり、それはどの記録で確かめられるか。
47
+ - 崩れたとき、誰のどの作業が止まるか。
54
48
 
55
- 書き方:
49
+ コツ:
56
50
 
57
- - 「〜できる」「〜である」という成立条件を一文にし、根拠と影響を分離する。
58
- - 単なる希望や目標は前提にしない。確認できない場合は仮置きであることを明示する。
59
- - スコープで定義済みの境界は前提として再掲せず、章冒頭でスコープの該当章へ委譲する。
60
- - 端末、リポジトリ、作業環境、外部ツールなど、継続的な提供が必要な基盤は「依存関係」へ分類する。
61
- - 例: 「現行手順に近い操作なら記録を継続できる」を仮説にし、操作確認の記録と、成立しなかった場合の手順見直しを結ぶ。
51
+ - 「誰が止められるか」と聞き、相手が自分たち以外なら依存関係へ移す。端末・リポジトリ・作業環境は前提に入れやすいので注意する。
52
+ - 確かめられない仮説は断定せず、仮置きと確認先を残す。
62
53
 
63
54
  ### 4.2. 制約事項
64
55
 
65
56
  問い:
66
57
 
67
- - 必ず守るべき限界は何か。
68
- - どの成果物・利用場面・期間に適用するか。
69
- - 何が起きたら逸脱として扱うか。
58
+ - どの行為が起きたら、限界を越えたと判定するか。
59
+ - その限界は、どの作業・期間に掛かるか。
70
60
 
71
- 書き方:
61
+ コツ:
72
62
 
73
- - 「〜しない」「〜に限定する」のように、禁止または限界を判定可能に書く。
74
- - 技術制約は製品名だけで固定せず、再利用性、公開適性、運用責任などの意図を添える。
75
- - 上位文書が結論だけを示す制約を運用化する場合は、展開元の文書・章と監視・対応を添える。既に監視・記録先がある事項は参照へまとめる。
76
- - 詳細な設計方法や受入条件は、対応する後続成果物に委譲する。
63
+ - 憲章が結論だけを示す制約は、展開元の章を書き、監視と逸脱時の対応を足す。憲章がすでに監視・記録先を持つ判断は、写さず参照に置き換える。
64
+ - 製品名で書きたくなったら、守りたい意図(費用・外部依存・公開適性)を聞き直す。
77
65
 
78
66
  ### 4.3. 依存関係
79
67
 
80
68
  問い:
81
69
 
82
- - 誰または何から、どの情報・提供物・判断を受ける必要があるか。
83
- - 受け取れたと判断する条件と、変化を知る契機は何か。
84
- - 依存先が変わった場合に、どの文書または判断を見直すか。
70
+ - 誰から何を受け取れたら成立とし、誰がいつどの記録で確かめるか。
71
+ - 決定のうち、どこまで決まり、どこが未決か。
85
72
 
86
- 書き方:
73
+ コツ:
87
74
 
88
- - 依存先を「外部サービス」だけに限定せず、先行成果物や承認も記載する。
89
- - 依存先名だけで終わらせず、必要な理由と成立条件を添える。
90
- - 誰が、いつ、どの証跡で成立を確認するかを「受領・成立条件」へ書く。成果物の受入は対象 ID・品質ゲート・証跡へ接続し、部分決定と未決部分を分ける。
91
- - 意思決定待ちの依存はプロジェクト登録簿へ登録し、本書からは登録項目 ID を参照する。
92
- - 期限や責任者が未確定なら、推測で埋めず決定先を残す。
75
+ - 依存先の担当に「受け取ったと言える記録は何か」を聞く。名前だけの依存は成立を判定できない。
76
+ - 本書の根拠として読んだだけの文書を依存先に入れやすいので注意する。
93
77
 
94
78
  ### 4.4. 影響評価と対応方針
95
79
 
96
80
  問い:
97
81
 
98
- - 前提・制約・依存が変化した場合、どれ(スコープ、期日、品質、公開適性、運用責任)に影響するか。
99
- - 最初に確認すべき範囲とその根拠は何か。
100
- - 一次対応を担うロールと、最終判断者は誰か。
82
+ - 変化したとき、最初に確かめる範囲はどこか。
83
+ - 一次対応を担う所有者と、最終判断者はそれぞれ誰か。
101
84
 
102
- 書き方:
85
+ コツ:
103
86
 
104
- - 影響は「困る」「遅れる」ではなく、スコープ、期日、費用、品質、公開適性など該当する領域名で記載する。
105
- - 対応方針には「除去、軽減、受容、再判断」のいずれを行うかを示し、次に判断する人を記載する。
106
- - 最終判断者を未確認のロールで補わない。未確定なら _TODO_: として記録先を示す。
87
+ - 「遅れる」「困る」で止まったら、どの成果物・作業・判断に響くかを聞き直す。
88
+ - 判断者が決まっていなければロールで補わず、決定先を残す。
107
89
 
108
90
  ### 4.5. 監視・変更管理
109
91
 
110
92
  問い:
111
93
 
112
- - 本書をいつ、どのような契機で見直すか。
113
- - 変更時に残すべき情報(項目 ID、変化内容、影響範囲、判断者など)は何か。
114
- - どの役割が構造整合を確認し、どの部分を人間の責任者が最終判断するか。
94
+ - 本書を見直す具体的な出来事は何か。
95
+ - 変化を検知したら、どの記録へ残し、どの計画・作業へ追従させるか。
115
96
 
116
- 書き方:
97
+ コツ:
117
98
 
118
- - 「定期的に確認する」ではなく、「スコープまたは実践の型一式が変わったとき」「新たな機密情報検出時」などの具体的な契機を記載する。
119
- - 変更記録には項目 ID、変化内容、影響範囲、判断者、対応状況、再確認時期を結ぶ。既存の ID は並べ替え・廃止後も再利用せず、変更の前後を追跡する。
120
- - 発生済みの支障・将来の不確実性・計画変更案・決定を各管理記録へ分け、PM が報告先と転送先を管理する。ARC は参照・技術制約、QE は受入・検証への追従を確認する。
121
- - 文書構造の整合確認は `ARC` 、公開可否やスコープ変更などの最終判断は人間の責任者が行うと明示する。
99
+ - 登録した各行の変化のトリガーを集めると、見直しの契機の漏れが見つかる。
100
+ - 発生済みの支障・将来の不確実性・計画変更・決定を一つの記録に混ぜやすいので、記録先を分けて聞く。
122
101
 
123
102
  ## 5. 深掘り手順
124
103
 
125
- 1. スコープ外を読み、境界を越えたときの制約候補を抽出する。
126
- 2. 対象を成立させるために必要な人、情報、環境、先行成果物を列挙する。
127
- 3. 各候補に「変化したら何が止まるか」を問い、影響がないもの、またはスコープで確定済みのものは登録しない。
128
- 4. 変化を最初に知る方法と、一次対応を担う所有者を決める。
129
- 5. 未確認の事実は、確認先とともに未確定として残す。
104
+ 内容が浅いときは、次の順で対応のない主張を探す。
105
+
106
+ 1. 各行が、スコープ・憲章のどの守る成果または境界に応えるかを確かめ、対応のない行と、上位文書で決まった境界の言い直しを外す。
107
+ 2. 各行の対応方針が、その行の影響を減らすかを確かめる。
108
+ 3. 影響評価と対応方針の各行が、どの項目 ID の変化から来るかを確かめる。
109
+ 4. 監視・変更管理の契機に、登録した各行のトリガーが入っているかを確かめる。
130
110
 
131
111
  ## 6. 良い例 / 悪い例
132
112
 
133
- | 観点 | 良い例 | 悪い例 |
134
- | -------- | ------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------ |
135
- | 重複排除 | スコープ外で確定済みの境界は、章冒頭の参照で委譲する | スコープの対象外を言い換えて前提・制約として再掲する |
136
- | 運用化 | 憲章などが結論だけを示す制約に、監視方法・トリガー・所有者を添えて展開し、展開元を明記する | 憲章などがすでに継続監視・記録先を持つ判断ゲートを、要約して重複登録する |
137
- | 分類 | 「現行手順に近い操作なら継続できる」を仮説として操作確認で検証する | スコープで確定済みの単一店舗運用を前提に再登録する |
138
- | 分類 | 「作業環境の継続利用」を依存関係として記載する | 「作業環境を継続利用できる」を前提条件として書く |
139
- | 制約 | 「個人情報を公開資料に含めない」と逸脱時の対応を併記する | 「情報管理に注意する」とだけ書く |
140
- | 依存 | 受入対象版・条件 ID と、QE がゲート前に照合する判定記録を示す | 根拠として読んだだけの文書を依存先に登録する |
141
- | トリガー | 「対象外の機能を初期対象へ追加しようとした」と書く | 「必要に応じて確認する」と書く |
142
- | 未確定 | 「_TODO_: 公開判断の記録先を決定する」と書く | 未確認の責任者や期限を断定する |
113
+ | 観点 | 良い例 | 悪い例 |
114
+ | -------- | ------------------------------------------------------------------------ | ------------------------------------------ |
115
+ | 分類 | 「代表試行への協力者を確保できる」を前提にし、未確保時の延期判断を添える | 「店頭で使う端末を利用できる」を前提に書く |
116
+ | 依存 | 端末を依存先にし、営業開始前の動作確認とその記録先を書く | 「端末がある」とだけ書く |
117
+ | 重複排除 | 対象外の境界は章冒頭でスコープへ委ねる | スコープの対象外を言い換えて制約に書く |
118
+ | 制約 | 「承認済み予算枠がない間は発注しない」と、発注前の確認を書く | 「予算に注意する」とだけ書く |
119
+ | 部分決定 | 決定済みの部分と未決の部分を分け、未決の当面の扱いを書く | 一部の決定だけで依存を成立済みとする |
120
+ | トリガー | 「対象外の機能を初期対象へ足そうとした」と書く | 「必要に応じて確認する」と書く |
143
121
 
144
122
  ## 7. レビュー観点
145
123
 
146
- | 観点 | 確認内容 |
147
- | ------------ | ---------------------------------------------------------------------------------------------------------------------------------- |
148
- | 重複排除 | スコープなど上位文書の決定事項を再掲せず、参照で委譲しているか。上位文書がすでに継続監視・記録先を持つ事項を重複登録していないか。 |
149
- | 分類 | 各行が前提、制約、依存のいずれか一つに分類されているか。リポジトリ・作業環境など継続提供が必要な基盤を前提条件に含めていないか。 |
150
- | 根拠 | 内容がスコープまたは直接参照した成果物と矛盾しないか。 |
151
- | 変化への備え | 影響、確認方法、トリガー、所有者、対応方針があるか。 |
152
- | 技術制約 | 特定製品への過度な依存、実装詳細、責務外の設計が混入していないか。 |
153
- | 下流入力 | 業務、受入、計画・統制の担当者が、必要な条件と未確定事項を識別できるか。 |
154
- | 公開適性 | 個人情報、機密情報、非公開情報を含めていないか。 |
124
+ | 観点 | 確認内容 |
125
+ | ------------ | ---------------------------------------------------------------- |
126
+ | 根拠 | 各行がスコープ・憲章と食い違わず、守る成果か境界に対応しているか |
127
+ | 変化への備え | 所有者が変化を知る手段と、次の判断者へつなぐ対応があるか |
128
+ | 下流入力 | 計画・受入の担当者が、待つべき条件と未決の論点を見分けられるか |
129
+ | 責務の境界 | 計画・設計・実装の詳細やリスクの管理を本書に書き込んでいないか |
155
130
 
156
131
  ## 8. 仕上げチェック
157
132
 
158
- - 「全体の作成手順」で示した章立てと必須表がそろっている。
159
- - スコープなど上位文書の決定事項を再掲せず、委譲する場合は章冒頭に参照がある。
160
- - 各項目に影響と変化時の対応が対で記載されている。
161
- - 前提、制約、依存の各章があり、種別を混在させていない。
162
- - 未確定事項を推測で埋めず、確認先または決定時期を明示している。
163
- - 技術設計、実装詳細、最終判断の代替を書き込んでいない。
164
- - 各項目について、守る成果または境界、成立条件、影響、確認・対応方法を同じ ID から追跡できる。
133
+ - 未確認の事実・責任者・期限を断定せず、確認先または決定時期を残している。
134
+ - 個人情報、秘密情報、非公開の組織情報を含めていない。
135
+ - 影響評価と対応方針・監視・変更管理から、変化した条件の項目 ID へたどれる。
@@ -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 を承認者や責任者にしていない。