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,87 +11,98 @@ specdojo:
11
11
 
12
12
  Communication Plan Writing Recipe
13
13
 
14
- ステークホルダーの情報要求を、必要なコミュニケーション機会と証跡へ変換する作り方です。
14
+ 関係者の判断・確認の必要を、機会と記録先へ変える作り方を示す。
15
15
 
16
16
  ## 1. このレシピの使い方
17
17
 
18
- - ステークホルダー登録簿から必要な合意・確認だけを選びます。
19
- - 会議、報告、通知を一つの機会表へ統合します。
20
- - エスカレーションと情報取扱いを加え、重複を削除します。
21
- - 判断・情報要求(Why)、合意・確認する内容と時期(What)、機会・手段・責任(How)を整理し、ステークホルダー ID と証跡で対応を追跡します(Trace)。会議の進行詳細や関係者一覧は本書へ再掲しません。
18
+ - 登録簿の情報要求(Why)を、誰がいつ何を判断・確認するか(What)に変え、手段と責任(How)を決め、記録先とステークホルダー ID でたどれるようにする(Trace)。
22
19
 
23
20
  ## 2. 作成前に集める情報
24
21
 
25
- | 項目 | 集める情報 |
26
- | -------- | ------------------------------------------ |
27
- | 対象 | 判断者、当事者、利用者、協力者、実行ロール |
28
- | 情報要求 | 何を判断・確認・共有する必要があるか |
29
- | 契機 | 作業節目、代表試行、上限超過、公開、変更 |
30
- | 手段 | 登録簿、Pull Request、Issue、試行記録など |
31
- | 証跡 | 判断・確認結果を残す正本 |
32
- | 取扱い | 公開、限定共有、入力禁止の情報 |
22
+ | 項目 | 集める情報 | 取り出し元 |
23
+ | ------------ | ---------------------------------- | ---------------------- |
24
+ | 情報要求 | 誰が何を判断・確認する必要があるか | ステークホルダー登録簿 |
25
+ | 契機 | 判断ゲート、試行の節目、上限超過 | 管理計画 |
26
+ | 判断経路 | 条件ごとに最終判断する人 | PO への確認 |
27
+ | 扱えない情報 | 公開記録や AI Agent へ出せない情報 | 当事者・協働組織 |
33
28
 
34
29
  ## 3. 全体の作成手順
35
30
 
36
- 1. 対象とする主要な合意・確認を決めます。
37
- 2. 各機会について対象、内容、時期、手段、責任、証跡を書きます。
38
- 3. 同じ内容の会議・報告・通知を一行へ統合します。
39
- 4. 人間の判断が必要なエスカレーション条件を定義します。
40
- 5. 情報区分と取扱いを最小限で定義します。
41
- 6. 見直し条件と未決事項を記載します。
31
+ 1. 機会を最初に書く。機会が決まらないと、エスカレーションの条件と扱う情報が決まらない。
32
+ 2. エスカレーション、情報管理と公開、見直し条件と未決事項の順に書く。
33
+ 3. 最後に方針と適用範囲を書く。機会がそろうと、会議を持つかを根拠付きで言える。
42
34
 
43
35
  ## 4. 各章の書き方
44
36
 
45
37
  ### 4.1. 方針と適用範囲
46
38
 
47
- - 常設会議か非同期確認かを決めます。
48
- - 関係者名簿は再掲せず、対象IDまたはRole codeを使います。
49
- - AI Agentは伝達・整理を支援しても、合意主体にしません。
39
+ 問い:
40
+
41
+ - 会議でしか決まらない判断はあるか。
42
+ - 非同期の記録で足りないのはどんな場合か。
43
+
44
+ コツ: 関係者の一覧は登録簿から写さず、参照に置き換える。
50
45
 
51
46
  ### 4.2. コミュニケーション機会
52
47
 
53
- - 一行は一つの判断・確認機会にします。
54
- - 伝える内容より、相手が何を判断・確認するかを明確にします。
55
- - 結果を残す証跡を必ず置きます。
48
+ 問い:
49
+
50
+ - この機会がなければ、誰の判断が止まるか。
51
+ - 相手は何を見て判断するか。
52
+
53
+ コツ: 伝える内容から書くと報告の一覧になる。記録先を答えられない機会は目的が決まっていない。
56
54
 
57
55
  ### 4.3. エスカレーション
58
56
 
59
- - 当事者価値、費用・負荷、品質・安全、公開・権利を分けます。
60
- - 一次対応と最終判断者を区別します。
61
- - 「必要に応じて」だけで終わらせません。
57
+ 問い:
58
+
59
+ - どの条件で判断者が変わるか。
60
+ - 一次対応の人は何を持っていくか。
61
+
62
+ コツ: 緊急度で分けず、誰が決めるかで分ける。AI Agent の出力の疑義は漏れやすい。
62
63
 
63
64
  ### 4.4. 情報管理と公開
64
65
 
65
- - 公開可能情報と入力禁止情報を区別します。
66
- - 個人情報や秘密情報を公開記録とAgent入力へ含めません。
67
- - 生成ビューではなく正本を更新します。
66
+ 問い:
67
+
68
+ - 公開記録と AI Agent に出せない情報は何か。
69
+ - 当事者の発言や試行データは、どの範囲で使う同意があるか。
70
+
71
+ コツ: 生成ビューではなく生成元を直すと書く。
72
+
73
+ ### 4.5. 見直し条件と未決事項
74
+
75
+ 問い:
76
+
77
+ - どの変化で機会の表が合わなくなるか。
78
+ - 未決の論点は、どの機会の相手・時期・手段を変えるか。
79
+
80
+ コツ: 決める人と時期を聞いて書く。
68
81
 
69
82
  ## 5. 深掘り手順
70
83
 
71
- 1. そのコミュニケーションがなければ誰の判断が止まるか確認します。
72
- 2. 同じ対象・内容・時期の行を統合します。
73
- 3. 証跡のない会議や報告を削除します。
74
- 4. 日常課題を登録簿へ移します。
84
+ 1. 機会の各行が、どの情報要求に応えるかを確かめ、対応のない行を外す。
85
+ 2. 記録先のない会議や報告を外す。
86
+ 3. エスカレーションの各条件が、どの機会で見つかるかを確かめる。
75
87
 
76
88
  ## 6. 良い例 / 悪い例
77
89
 
78
- | 観点 | 良い例 | 悪い例 |
79
- | ---- | ---------------------------------------- | ------------------------ |
80
- | 機会 | 代表試行後に利用者が価値と負荷を確認する | 利用者会議を定期開催する |
81
- | 証跡 | 評価結果と採否を試行記録へ残す | 議論したことだけを書く |
82
- | 対象 | ステークホルダーIDまたはRole code | 個人名と連絡先 |
90
+ | 観点 | 良い例 | 悪い例 |
91
+ | ---------------- | ------------------------------------------------- | ---------------------------- |
92
+ | 機会 | 代表試行の後に、利用者が価値と負荷を確かめる | 利用者会議を定期開催する |
93
+ | 証跡 | 評価結果と採否を試行記録へ残す | 議論したことだけを書く |
94
+ | エスカレーション | 費用超過の見込みは、PM が縮小案を作り PO が決める | 重大な問題は速やかに報告する |
83
95
 
84
96
  ## 7. レビュー観点
85
97
 
86
- - ステークホルダーの必要な合意を漏らしていないか。
87
- - 会議・報告・チャネルが重複していないか。
88
- - 判断者と証跡が明確か。
89
- - 公開・非公開の境界が守られているか。
98
+ | 観点 | 確認内容 |
99
+ | ---------- | -------------------------------------------------- |
100
+ | 漏れ | どの機会にも対応しない情報要求がない |
101
+ | 重複 | 同じ相手・内容・時期の確認が複数行に分かれていない |
102
+ | 会議の要否 | 会議ごとに、非同期では決まらない理由を言える |
90
103
 
91
104
  ## 8. 仕上げチェック
92
105
 
93
- - コミュニケーション機会、エスカレーション、情報取扱いがある。
94
- - 目的のない定例会議がない。
95
- - 関係者一覧やRole code定義を再掲していない。
96
- - Agentに合意・承認を委ねていない。
97
- - 各コミュニケーション機会が、元の判断・情報要求と結果の証跡に対応している。
106
+ - 機会の各行が、情報要求と記録先の両方につながる。
107
+ - AI Agent に合意・承認を任せていない。
108
+ - 公開記録の情報が、どの情報区分に当たるかを言える。
@@ -11,74 +11,73 @@ specdojo:
11
11
 
12
12
  Project Human Member Roster Writing Recipe
13
13
 
14
- 人間の実行主体と Role code の対応を `pm-members.yaml` に整理し、agent の実行定義を保護設定へ混在させないための作成手順です。
14
+ 人間の実行主体と担える Role code を、履歴で変わらない nickname で名簿にする作り方を示す。
15
15
 
16
16
  ## 1. このレシピの使い方
17
17
 
18
- - 組織定義とロール定義から、人間が担う最終判断と使用可能な Role code を確認します。
19
- - 実行ログへ残す人間の nickname、公開可能な表示名、兼務を整理します。
20
- - agent の provider、能力、優先度、command は `.specdojo/agent-members.yaml` へ分離します。
21
- - 既存名簿に agent がある場合は、手編集より先に移行コマンドの dry-run を確認します。
18
+ - 名簿は、組織定義の最終判断の集約先(Why)を引き継ぎ、誰がどの Role を担えるか(What)を決め、`--by` と実行ログが nickname で人を指す(Trace)。agent の定義は名簿に持たない。
22
19
 
23
20
  ## 2. 作成前に集める情報
24
21
 
25
- | 項目 | 集める情報 |
26
- | ----------- | ------------------------------------------------------------ |
27
- | 組織定義 | 最終判断の集約先、公開方針、兼務方針 |
28
- | ロール定義 | `members[].roles` に使える Role code |
29
- | 人間 member | 安定 nickname、公開可能な表示名・連絡先、対応 Role code |
30
- | 実行ログ | 既に使われ、変更してはいけない nickname |
31
- | agent 定義 | 人間 nickname と重複しないことを確認するための nickname 一覧 |
32
- | 公開制約 | 個人情報、私用連絡先、非公開組織情報を含めない条件 |
22
+ | 項目 | 集める情報 | 取り出し元 |
23
+ | ------------ | ------------------------------------------------ | -------------------- |
24
+ | 最終判断 | 承認・受入・公開可否を誰に集めるか、兼務の方針 | 組織定義 |
25
+ | Role code | 名簿で使える Role code の一覧 | ロール定義 |
26
+ | 使用中の名前 | 実行ログに記録済みの nickname、agent の nickname | 実行ログ・agent 定義 |
27
+ | 公開の可否 | 表示名と連絡先を公開してよいか | 本人への確認 |
33
28
 
34
29
  ## 3. 全体の作成手順
35
30
 
36
- 1. `project_id`、成果物 ID、`based_on` を確定します。
37
- 2. 人間の実行主体だけを列挙し、`type: human` とします。
38
- 3. `pm-roles.yaml` と照合して各 member の `roles` を割り当てます。
39
- 4. 実行ログと `.specdojo/agent-members.yaml` を確認し、nickname の重複と改名を避けます。
40
- 5. 非公開の連絡先は `null` にし、最終判断範囲を `note` に簡潔に記載します。
41
- 6. schema 検証で agent 用フィールドや未定義キーが混入していないことを確認します。
31
+ 1. 最終判断を担う人を先に決める。ここが決まると兼務の範囲が決まる。
32
+ 2. 使用中の nickname を集めてから名前を決める。後から変えると履歴の参照先が切れる。
33
+ 3. 各人の Role code を割り当て、最後に `rules` へ project 固有の制約だけを書く。
42
34
 
43
- ## 4. 深掘りする問い
35
+ ## 4. 各章の書き方
44
36
 
45
- ### 4.1. 実行主体
37
+ ### 4.1. members
46
38
 
47
- - 人間として最終判断、受入、公開可否を担う主体は誰ですか。
48
- - 人物が交代しても意味が変わらない nickname になっていますか。
49
- - 兼務する Role code は責務正本と一致していますか。
50
- - 公開できない個人情報を推測で補っていませんか。
39
+ 問い:
51
40
 
52
- ### 4.2. agent との境界
41
+ - 承認・受入・公開可否を最後に決めるのは誰か。
42
+ - その人が交代しても、nickname の意味は変わらないか。
53
43
 
54
- - `type: agent`、`provider`、`command`、`mode`、`stage_role` が名簿に残っていませんか。
55
- - 人間 nickname が repository 共通の agent nickname と重複していませんか。
56
- - agent の追加・優先度変更を通常成果物の編集として扱っていませんか。
57
- - 既存 agent の移行には `specdojo config migrate-members --dry-run` を先に使いましたか。
44
+ コツ:
58
45
 
59
- ### 4.3. Role と履歴
46
+ - 個人名が要らなければ `po` のような役割の名前にする。本人に公開の可否を聞き、答えがなければ連絡先を空にする。
47
+ - 最終判断の範囲は `note` に 1 文で書き、組織定義を写さない。
60
48
 
61
- - `roles` は `pm-roles.yaml` に存在する値だけですか。
62
- - Schedule の `owner` と member nickname を混同していませんか。
63
- - 実行ログに記録済みの nickname を変更していませんか。
64
- - nickname を廃止する場合も履歴参照を維持できる記録がありますか。
49
+ ### 4.2. rules
65
50
 
66
- ## 5. レビュー観点
51
+ 問い:
67
52
 
68
- | 観点 | 確認内容 |
69
- | ---------------- | ------------------------------------------------------------- |
70
- | schema | `pm-members.schema.yaml` に適合し、人間だけを含む |
71
- | Role code | `members[].roles` がロール定義と一致する |
72
- | nickname | project 内と agent 定義との合成後に一意で、履歴上安定している |
73
- | 責任境界 | 人間の最終判断と agent の実行支援が混在していない |
74
- | 公開適性 | 私用連絡先、秘密情報、非公開組織情報を含まない |
75
- | トレーサビリティ | 組織定義、ロール定義、変更記録から割り当て理由を追える |
53
+ - この project だけの公開制約や交代時の扱いは何か。
76
54
 
77
- ## 6. 完了チェック
55
+ コツ:
78
56
 
79
- - `members[]` はすべて `type: human` です。
80
- - nickname、`display_name`、`roles` が全 member にあります。
81
- - agent 用の選択属性と起動設定は含まれていません。
82
- - `pm-members.schema.yaml` の検証を通過します。
83
- - agent 定義と合成したとき nickname が重複しません。
84
- - 最終判断と公開可否を担う人間の範囲が読み取れます。
57
+ - 共通の標準や agent の起動設定を書き足したくなったら、正本への参照に置き換える。
58
+
59
+ ## 5. 深掘り手順
60
+
61
+ 1. 各 member の Role code から、組織定義の最終判断へたどれるかを確かめる。
62
+ 2. `rules` の各行が、この project 固有の制約かを確かめ、共通の内容を外す。
63
+
64
+ ## 6. 良い例 / 悪い例
65
+
66
+ | 観点 | 良い例 | 悪い例 |
67
+ | -------- | -------------------------------------- | ------------------------------ |
68
+ | nickname | 交代時は新しい member を足す | 記録済みの nickname を改名する |
69
+ | 連絡先 | 公開の確認がなければ `email: null` | 推測した私用アドレスを書く |
70
+ | `rules` | 「公開文書に個人名を書かない」だけ書く | agent の起動設定を写す |
71
+
72
+ ## 7. レビュー観点
73
+
74
+ | 観点 | 確認内容 |
75
+ | ---------- | ------------------------------------------------ |
76
+ | 責任の所在 | 最終判断を担う人間が名簿から読み取れるか |
77
+ | 一意性 | agent 定義と合わせても nickname が重ならないか |
78
+ | 公開適性 | 個人名・私用連絡先・非公開の組織情報を含まないか |
79
+
80
+ ## 8. 仕上げチェック
81
+
82
+ - 各 member の Role code が、組織定義の最終判断の範囲と食い違っていない。
83
+ - `rules` に共通の標準や agent の設定の再掲がない。
@@ -11,89 +11,97 @@ specdojo:
11
11
 
12
12
  Organization Definition Writing Recipe
13
13
 
14
- 目的達成に必要な意思決定・実行・確認の分担を、最小体制として設計する作り方です。
14
+ 判断・実行・確認の分担を最小体制で設計する作り方を示す。
15
15
 
16
16
  ## 1. このレシピの使い方
17
17
 
18
- - 目的、関係者、主要判断から必要な責任領域を抽出します。
19
- - 兼務可能な最小組織モデルを定めます。
20
- - 採用判断をロール定義へ渡し、Member 割り当てと成果物別の責任を各正本へ接続します。
21
- - プロジェクトの目的と主要判断(Why)、必要な責任領域と最終判断先(What)、最小組織モデルと owner 方針(How)を扱い、採用判断・正本の対応・見直し条件で追跡します(Trace)。共通の責務説明と Member 割り当ては各正本へ委譲します。
18
+ - 組織定義は、概要の目的と主要判断(Why)を引き継ぎ、責任領域と採用ロール(What)、兼務と見直しの方針(How)を決める。採用判断は `owner` と正本への参照でたどる(Trace)。
22
19
 
23
20
  ## 2. 作成前に集める情報
24
21
 
25
- | 項目 | 集める情報 |
26
- | -------- | -------------------------------------------------------------------- |
27
- | 規模 | 参加者数、外部関係者、継続運用の有無 |
28
- | 判断 | 当事者価値、優先順位、費用・負荷、品質、公開 |
29
- | 実行 | 仕様化、開発、検証、運用、AI支援 |
30
- | 正本 | ロール定義、メンバー定義、RACI、ステークホルダー登録簿 |
31
- | 拡張条件 | 滞留、参加者増加、外部責任、専門性の必要性 |
32
- | 採用判断 | 標準ロールごとの採用可否、未採用時の代替先、独自ロールを検討する理由 |
22
+ | 項目 | 集める情報 | 取り出し元 |
23
+ | -------------- | ------------------------------------------- | ---------------------- |
24
+ | 目的と主要判断 | 価値、優先順位、費用、受入、公開の判断 | プロジェクト概要 |
25
+ | 規模と関係者 | 参加者数、外部関係者、継続運用の有無 | ステークホルダー登録簿 |
26
+ | 担い手と兆し | 作業の担い手、AI Agent の関与、滞留する判断 | 最終判断者への確認 |
33
27
 
34
28
  ## 3. 全体の作成手順
35
29
 
36
- 1. 必要な責任領域と最終判断を整理します。
37
- 2. 実行・確認を誰が兼務できるか決めます。
38
- 3. 人間とAI Agentの境界を明記します。
39
- 4. 各標準ロールと独自ロールの採用・未採用、判断理由、未採用時の代替先を整理し、Schedule の `owner` に使える集合を明示します。
40
- 5. 情報ごとの正本を一表で示します。
41
- 6. 体制を拡張する見直し条件を定めます。
30
+ 1. 組織モデルを最初に書く。最終判断の置き場が決まらないと、採否を決められない。
31
+ 2. ロール・owner方針で、標準ロールの採否と `owner` を決める。
32
+ 3. 正本と責任境界で、本書で決めることと他に任せることを分ける。
33
+ 4. 見直し条件を書く。兼務が崩れる兆しは組織モデルで見えている。
42
34
 
43
35
  ## 4. 各章の書き方
44
36
 
45
37
  ### 4.1. 組織モデル
46
38
 
47
- - 価値判断、実行、品質確認、公開・運用のどの責任領域が目的達成に必要ですか。
48
- - 当事者・利用者の確認を誰が受け止め、内部 Role のどの人間が最終判断しますか。
49
- - 兼務しても作業と判断を分けられますか。具体的な兼務先はメンバー定義で確認します。
39
+ 問い:
40
+
41
+ - 価値・計画・品質・公開を、それぞれ誰が最終判断するか。
42
+ - 当事者の確認を、どのロールが受け止めるか。
43
+
44
+ コツ:
45
+
46
+ - 「誰がやるか」より先に「どの判断が要るか」を聞くと、人数に引きずられない。
50
47
 
51
48
  ### 4.2. ロール・owner方針
52
49
 
53
- - 各標準ロールと独自ロールについて、採用・未採用を何を根拠に選びますか。未採用の責務は誰が代替するか、対象外の理由は何ですか。
54
- - 採用は専任配置と別に判断できていますか。専門支援だけのロールを含め、使用可能な `owner` の集合はどれですか。
55
- - RACI の採用列・省略列と、ロール定義へ転記する採用集合が一致しますか。未採用がなければその旨を残します。
50
+ 問い:
51
+
52
+ - 採用しないロールの責務を、誰が代わりに担うか。
53
+ - Schedule の `owner` に、どのロールを使うか。
54
+
55
+ コツ:
56
+
57
+ - 採用と専任配置を分けて聞く。兼務者だけのロールを未採用にしやすい。
56
58
 
57
59
  ### 4.3. 正本と責任境界
58
60
 
59
- - 共通定義、採用判断、機械可読な採用結果、実行主体、詳細責任の更新先はどこですか。
60
- - 名簿で必要な人間の責任領域をカバーでき、未作成の文書には作成時期または省略理由がありますか。
61
- - 一覧・一般責務を再掲せず、参照先と本書で扱う判断を区別できていますか。
61
+ 問い:
62
+
63
+ - 採用結果・実行主体・成果物別の分担を、どこで更新するか。
64
+ - まだない定義をいつ作るか。
65
+
66
+ コツ:
67
+
68
+ - 一覧や名簿は写さず参照に置き換え、採用判断だけを残す。
62
69
 
63
70
  ### 4.4. 見直し条件
64
71
 
65
- - 作業・判断の滞留、参加者、範囲、公開・運用責任の何が変わると見直しを始めますか。
66
- - 新しい Role を増やす前に既存責任を再配分できますか。採用変更を誰が判断しますか。
67
- - ロール定義、メンバー定義、RACI、WBS・Schedule の追従を誰が管理・確認し、未決事項をどの管理記録へ渡しますか。
72
+ 問い:
73
+
74
+ - 何が起きたら体制の見直しを始めるか。
75
+ - 誰が判断し、どの定義を追従させるか。
76
+
77
+ コツ:
78
+
79
+ - 「忙しくなったら」でなく、承認の滞留など観測できる出来事で聞く。
68
80
 
69
81
  ## 5. 深掘り手順
70
82
 
71
- 1. その責任領域がどの価値・判断に必要か確認します。
72
- 2. 専任化せず兼務できる領域を特定します。
73
- 3. 一人へ集中している判断と作業を分けます。
74
- 4. 一覧・定義の重複を削除します。
83
+ 浅いときは次の順で対応のない主張を探す。
84
+
85
+ 1. 責任領域ごとに応える主要判断を確かめ、対応のない行を外す。
86
+ 2. 採用ロールごとに、担う責任領域を確かめる。
87
+ 3. 見直し条件ごとに、崩れる兼務の前提を確かめる。
75
88
 
76
89
  ## 6. 良い例 / 悪い例
77
90
 
78
- | 観点 | 良い例 | 悪い例 |
79
- | ----- | ------------------------------------ | -------------------------- |
80
- | 体制 | 小規模兼務で開始し、滞留時に分担する | すべてのRoleへ専任者を置く |
81
- | Agent | 草案・検証を支援し、人間が判断する | Agentを承認者にする |
82
- | 正本 | member割当はYAMLへ委譲する | 本文にも同じ一覧を書く |
91
+ | 観点 | 良い例 | 悪い例 |
92
+ | ---- | ---------------------------------- | ---------------------------- |
93
+ | 体制 | 兼務で始め、承認が滞ったら分担する | すべてのロールに専任者を置く |
94
+ | 兼務 | 作業と最終判断を別のロールで書く | 「全員で責任を持つ」 |
83
95
 
84
96
  ## 7. レビュー観点
85
97
 
86
- | 観点 | 確認内容 |
87
- | ---- | ------------------------------------------------------------------- |
88
- | 目的 | 必要な責任領域と人間の最終判断を説明できるか |
89
- | 採用 | 各ロールの採否・理由・代替先と使用可能な `owner` が明示されているか |
90
- | 正本 | 共通定義や名簿を再掲せず、採用結果・割り当て・RACI と照合できるか |
91
- | 維持 | 見直し開始条件、判断者、追従先と確認担当が決まっているか |
98
+ | 観点 | 確認内容 |
99
+ | ---------- | ------------------------------------------------------ |
100
+ | 目的整合 | 責任領域が概要の主要判断に対応しているか |
101
+ | 採用の根拠 | 採否を責任領域で説明でき、未採用の責務に担い手がいるか |
92
102
 
93
103
  ## 8. 仕上げチェック
94
104
 
95
- - 組織モデル、owner方針、正本、見直し条件がある。
96
- - Role codeと実行主体を混同していない。
97
- - 個人情報・連絡先を記載していない。
98
- - Agentに最終判断を委ねていない。
99
- - 各責任領域が目的または主要判断に対応し、owner 方針と委譲先を追跡できる。
105
+ - 責任領域の各行から採用ロールと `owner` までたどれる。
106
+ - 個人名・連絡先を書いていない。
107
+ - AI Agent に最終判断を任せていない。
@@ -11,97 +11,110 @@ specdojo:
11
11
 
12
12
  Project Management Plan Writing Recipe
13
13
 
14
- 価値検証に必要な管理・判断・証跡だけを、一つの軽量な管理計画へまとめる作り方です。
14
+ 価値検証に要る管理・判断・証跡だけを、軽量な管理計画へまとめる作り方を示す。
15
15
 
16
16
  ## 1. このレシピの使い方
17
17
 
18
- - 概要、スコープ、成功基準から管理すべき価値と上限を抜き出します。
19
- - 管理領域を一表へ統合し、判断ゲートと正本を接続します。
20
- - 個別計画、RACI、Schedule、登録簿との重複を削除して仕上げます。
21
- - 検証する価値と逸脱リスク(Why)、管理基準・上限・判断ゲート(What)、確認契機・逸脱時対応・責任(How)を整理し、成功基準 ID と各正本の証跡で追跡します(Trace)。個別計画の詳細は参照先へ委譲します。
18
+ - 成功基準の価値と逸脱リスク(Why)から、管理基準・上限・判断ゲート(What)と確認契機・逸脱時対応・責任(How)を決め、各管理行を条件 ID と正本の記録でたどる(Trace)。
22
19
 
23
20
  ## 2. 作成前に集める情報
24
21
 
25
- | 項目 | 集める情報 |
26
- | ---------- | --------------------------------------------------------------------------- |
27
- | 価値と判定 | 成功基準 ID、受入条件 ID、判定時期 |
28
- | 境界 | スコープ内外、主要な変更条件 |
29
- | 費用・負荷 | 現金支出、作業時間、継続運用負荷の上限 |
30
- | 実行管理 | Schedule、依存、主要成果物、登録簿 |
31
- | 判断 | 公開、例外、主要変更、継続・停止の判断者 |
32
- | 正本 | 組織、RACI、品質、コミュニケーション、記録の参照先 |
33
- | 依存関係 | 概要・スコープ・成功基準・組織定義へのカタログ依存と、直接根拠にする文書 ID |
22
+ | 項目 | 集める情報 | 取り出し元 |
23
+ | ---------- | -------------------------------------- | -------------------- |
24
+ | 価値と判定 | 成功基準 ID、受入条件 ID、判定時期 | 成功基準 |
25
+ | 境界 | スコープ内外、管理を厚くする条件 | スコープ |
26
+ | 費用・負荷 | 現金支出、作業時間、継続運用負荷の上限 | 成功基準、承認責任者 |
27
+ | 判断者 | 公開・例外・変更・停止の最終判断者 | 組織定義、RACI |
28
+ | 記録先 | 課題・リスク・変更・品質・費用の記録先 | 登録簿、Schedule |
34
29
 
35
30
  ## 3. 全体の作成手順
36
31
 
37
- 1. カタログを使う場合は概要・スコープ・成功基準と、直接根拠にする組織定義への依存を確認し、不足を先行作業にします。根拠 ID と依存の対応が確認できてから管理目的を価値と期間で一文にします。
38
- 2. 軽量プロファイルを基本とし、拡張が必要な条件を決めます。
39
- 3. 管理対象ごとに価値・リスクの根拠 ID、基準・上限、確認契機、逸脱時対応、責任、証跡の正本と記録識別子を一表へ書きます。
40
- 4. 人間の判断が必要なゲートだけを定義します。
41
- 5. Schedule、RACI、費用記録、品質証跡、登録簿の正本を示します。
42
- 6. 未決事項へ決定時期と判断者を付けます。
43
- 7. 他文書の一覧や詳細手順を削除します。
32
+ 1. 管理目的を価値と期間で 1 文にする。これがないと網羅目的の行が増える。
33
+ 2. 統合管理表は、一般的な PM 項目ではなく条件 ID ごとの行から書く。
34
+ 3. 判断ゲートは、逸脱時対応のうち人間の判断が要るものから作る。
35
+ 4. 未決事項は、決めきれない上限や判断者を最後に集める。
44
36
 
45
37
  ## 4. 各章の書き方
46
38
 
47
39
  ### 4.1. 管理目的と適用方針
48
40
 
49
- - どの価値を、いつからいつまで検証しますか。運用前に集める比較基準値も前提作業へ置けていますか。
50
- - 人間が最終判断する事項と AI Agent が支援する作業は何ですか。
51
- - 軽量・拡張のどちらを選び、契約・監査・組織規模の何が変わると拡張しますか。
41
+ 問い:
42
+
43
+ - どの価値を、いつからいつまで検証するのか。
44
+ - 契約・監査・組織規模の何が変わると管理を厚くするか。
45
+
46
+ コツ:
47
+
48
+ - 比較基準値の収集は前提作業に置く。
52
49
 
53
50
  ### 4.2. 統合管理方針
54
51
 
55
- - 各行はどの価値・リスク・条件 ID を守りますか。基準と証跡の該当記録を行から一意に辿れますか。
56
- - 誰が、いつ逸脱を検知し、どの行動へ移りますか。構成の版・承認済み基準や技術依存の変更も確認します。
57
- - 現金支出、準備・開発時間、継続運用負荷を区別でき、同じ基準・証跡だけを重ねた行を統合できていますか。
52
+ 問い:
53
+
54
+ - この行は、どの条件 ID の何を守るのか。
55
+ - 誰が、いつ逸脱に気づき、次に何をするのか。
56
+
57
+ コツ:
58
+
59
+ - 費用を聞くと現金支出だけが返る。準備時間と日々の操作時間を別に聞く。
60
+ - 数値や測定手順は成功基準から写さず、条件 ID で参照する。
58
61
 
59
62
  ### 4.3. 判断ゲートとエスカレーション
60
63
 
61
- - ゲートに適用する成功基準・受入条件 ID は何ですか。初期受入と後続の観測を区別します。
62
- - 未達・材料不足・上限超過なら何を保留し、誰が是正・再判定を起案しますか。
63
- - 人間の最終判断者と判断記録先を、材料の整理担当から区別できていますか。
64
+ 問い:
65
+
66
+ - 未達や材料不足なら何を保留し、誰が再判定を起案するのか。
67
+ - 初期受入と後続の観測を同じゲートで判定してよいか。
68
+
69
+ コツ:
70
+
71
+ - 材料を整理する Role と最終判断する Role を別に聞く。
64
72
 
65
73
  ### 4.4. 正本・報告・見直し
66
74
 
67
- - 情報ごとの更新先と報告を確認する Role は誰ですか。未整備の正本には整備担当・時期を付けます。
68
- - 判断・逸脱・作業節目のどれを報告契機にしますか。作業担当と成果物の承認責任を混同していませんか。
69
- - 変更時の影響先、更新順序、担当・期限・確認担当をどの追従タスクへ渡しますか。
75
+ 問い:
76
+
77
+ - 判断・逸脱・作業節目のどれを報告の契機にするのか。
78
+ - 目的や体制が変わったら、どの文書をどの順で直すのか。
79
+
80
+ コツ:
81
+
82
+ - Schedule の作業担当を承認者と取り違えやすい。承認者は別に聞く。
70
83
 
71
84
  ### 4.5. 未決事項
72
85
 
73
- - どの論点が未決で、決定まで何を保留しますか。
74
- - 決定時期と人間の判断者は誰ですか。他の正本にあれば該当論点を参照します。
75
- - 期限超過時に誰が管理簿へ移し、担当 Role と転送先を追跡しますか。
86
+ 問い:
87
+
88
+ - 決まるまで、何の着手や判定を止めるのか。
89
+ - 決まったら、どの管理行・ゲートが変わるのか。
90
+
91
+ コツ:
92
+
93
+ - 別の正本で追う論点は写さず参照に置き換える。
76
94
 
77
95
  ## 5. 深掘り手順
78
96
 
79
- 1. 管理項目がどの価値または制約を守るか確認します。
80
- 2. 基準のない管理項目は削除するか基準を定めます。
81
- 3. 同じ責任・証跡を持つ行を統合します。
82
- 4. 個別計画へ委譲できる説明を削除します。
97
+ 内容が浅いときは、次の順で対応のない主張を探す。
98
+
99
+ 1. 管理行ごとに応える条件 ID を確かめ、対応のない行を外す。
100
+ 2. 判断ゲートの各条件が材料を受ける管理行を確かめる。
101
+ 3. 個別計画・RACI・Schedule・登録簿と重なる説明を参照に戻す。
83
102
 
84
103
  ## 6. 良い例 / 悪い例
85
104
 
86
- | 観点 | 良い例 | 悪い例 |
87
- | -------- | -------------------------------- | ---------------------------- |
88
- | 管理目的 | SC-01〜SC-03の代表試行を管理する | 一般的なPM項目を管理する |
89
- | コスト | 現金支出と作業時間を別上限で確認 | 金額予算はないので管理しない |
90
- | 正本 | 課題・リスクは登録簿を正とする | 本文にも同じ一覧を持つ |
105
+ | 観点 | 良い例 | 悪い例 |
106
+ | -------- | ---------------------------------- | ---------------------------- |
107
+ | 管理目的 | SC-01〜SC-03 の代表試行を管理する | 一般的な PM 項目を管理する |
108
+ | コスト | 現金支出と作業時間を別の上限で確認 | 金額予算はないので管理しない |
91
109
 
92
110
  ## 7. レビュー観点
93
111
 
94
- | 観点 | 確認内容 |
95
- | ---- | ---------------------------------------------------------------------------- |
96
- | 根拠 | 価値・スコープ・成功基準と管理行が対応し、カタログ依存から直接根拠を辿れるか |
97
- | 委譲 | 個別計画、RACI、Schedule、登録簿を再掲せず、更新先と確認者を示せるか |
98
- | 判定 | 条件 ID、不足時の保留、人間の最終判断者、証跡が接続しているか |
99
- | 負荷 | 現金支出、作業時間、継続運用負荷を別々に判断できるか |
112
+ | 観点 | 確認内容 |
113
+ | ------ | ------------------------------------------ |
114
+ | 判断者 | 継続・保留・停止の判断に使う記録が分かるか |
115
+ | 作業者 | 自分の確認契機と逸脱時の行動が分かるか |
100
116
 
101
117
  ## 8. 仕上げチェック
102
118
 
103
- - 統合管理表、判断ゲート、正本がそろっている。
104
- - 未決事項に決定時期と判断者がある。
105
- - Agentに最終判断を委ねていない。
106
- - 必要性のない章・表・関連文書一覧を残していない。
107
- - 各管理対象について、価値またはリスク、基準・上限、確認契機、逸脱時対応、証跡が一続きで追跡できる。
119
+ - 各管理行から、条件 ID、逸脱時の行動、記録先までたどれる。
120
+ - AI Agent に最終判断を委ねていない。