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,97 +11,78 @@ specdojo:
11
11
 
12
12
  Quality Management Plan Writing Recipe
13
13
 
14
- 利用者価値と成果物品質を、少数の品質ゲートと是正手順へまとめる作り方です。
14
+ 利用者価値と成果物品質を、少数の品質ゲートと是正の流れへまとめる作り方を示す。
15
15
 
16
16
  ## 1. このレシピの使い方
17
17
 
18
- - 成功基準から価値品質、rulebook・検証から成果物品質を抽出します。
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
- | 判定条件 | 成功基準ID、受入条件ID、検証結果 |
30
- | 証跡 | 試行記録、レビュー、費用・作業記録、ログ |
31
- | 責任 | 確認者、承認者、是正担当 |
32
- | 例外 | 未達時の対応、再判定、変更判断 |
33
- | 対象期間 | 適用開始・終了のイベント、初期受入・試用・後続観測の境界 |
22
+ | 項目 | 集める情報 | 取り出し元 |
23
+ | -------- | ------------------------------------------------ | ------------- |
24
+ | 守る価値 | どの条件 ID が誰のどの変化を判定するか | 成功基準 |
25
+ | 節目 | どの判断の前に確かめるか、適用の開始と終了 | 管理計画 |
26
+ | 公開対象 | 何を公開し、個人情報・非公開情報がどこに混ざるか | `PO` への確認 |
27
+ | 証跡 | 試行・検査・費用と作業時間の記録をどこに残すか | `QE` への確認 |
28
+ | 責任 | 誰が照合し、誰が判断し、誰が是正するか | RACI |
34
29
 
35
30
  ## 3. 全体の作成手順
36
31
 
37
- 1. 品質方針を価値品質と成果物品質に分け、適用開始・終了と人間・AI Agent の境界を示します。
38
- 2. 必要な判定時点だけを品質ゲートにします。
39
- 3. 各ゲートへ合格条件、方法・証跡、時期、責任を置きます。
40
- 4. レビュー対象ごとの主要観点、実施責任、出口条件、証跡、記録先を結びます。
41
- 5. 不適合区分と重大性の境界を定め、是正後の再判定条件・責任・記録先へ接続します。
42
- 6. 見直しと後続作業、未決事項と保留を整理し、成功基準や検証手順の再掲を削除します。
32
+ 1. 品質方針と適用範囲を先に書く。守る価値が決まらないと、ゲートの数が決まらない。
33
+ 2. 判断の前に要る時点だけを品質ゲートにする。
34
+ 3. 各ゲートの前に終えるレビューと証跡を書く。
35
+ 4. 不適合と是正を書く。
36
+ 5. 最後に見直し条件と未決事項を書く。途中で決めきれなかった点がここに集まる。
43
37
 
44
38
  ## 4. 各章の書き方
45
39
 
46
40
  ### 4.1. 品質方針と適用範囲
47
41
 
48
- - 利用者のどの変化を価値品質とし、どの成果物・技術条件がそれを支えますか。
49
- - いつからいつまで適用し、初期受入・公開後の試用・後続観測をどこで区切りますか。
50
- - AI Agent が支援する確認と、人間が担う価値・例外・公開の最終判断は何ですか。
42
+ - 問い: 利用者のどの変化を価値品質とするか。人間が最終判断する価値・例外・公開は何か。
43
+ - コツ: 成功基準の閾値は写さず参照に置き換える。終了日が決まらなければ終了のイベントを聞く。
51
44
 
52
45
  ### 4.2. 品質ゲート
53
46
 
54
- - 各ゲートはどの条件 ID と正本を参照し、どの時点で確認しますか。運用前に必要な比較基準値は採取できますか。
55
- - 誰がどの方法・証跡で確認し、誰が承認しますか。未達・証跡不足・未決条件をどう保留しますか。
56
- - 費用・負荷を扱うとき、現金支出、作業時間、継続運用負荷を別々の基準・記録で判断できますか。
47
+ - 問い: そのゲートがないと、どの判断を誤るか。証跡不足のときどう扱うか。
48
+ - コツ: 費用は「無償」で済ませず、現金支出と作業時間を別々に聞く。
57
49
 
58
50
  ### 4.3. レビューと証跡
59
51
 
60
- - どの対象版を誰が、どの観点で確認しますか。
61
- - 出口条件はどの状態で合否が分かれ、それを裏付ける証跡はどの記録先に残りますか。三つを別々の欄に記入します。
62
- - 指摘から是正・再判定結果を辿れますか。生成物は生成元を直し、再生成結果を証跡にします。
52
+ - 問い: どの対象版を誰が確認するか。公開対象を全件確かめたことを何で示すか。
53
+ - コツ: 保存先が未定なら仮のパスを書かず未決事項へ回す。
63
54
 
64
55
  ### 4.4. 不適合と是正
65
56
 
66
- - 対応が異なる区分と重大性の境界は何ですか。重大な不適合ではどのゲートを止め、誰へ報告しますか。
67
- - 是正後のどの契機に何を再確認し、誰が再判定しますか。再判定条件と責任を別欄にします。
68
- - 発生済みの支障、将来の品質リスク、目的・スコープ・条件の変更を、誰がどの課題・リスク・変更記録へつなぎますか。
57
+ - 問い: どの不適合で作業や公開を止めるか。是正後に何を確かめ直すか。
58
+ - コツ: 区分は止めるゲートが異なるものに絞る。
69
59
 
70
60
  ### 4.5. 見直し条件と未決事項
71
61
 
72
- - 成功基準、公開範囲、構造、検証方法、体制、重大不適合の傾向の何が変わると見直しますか。
73
- - 管理計画、RACI、Schedule、証跡参照の更新先・担当・期限・確認者を誰が整理しますか。後続観測への引き継ぎ条件は何ですか。
74
- - 未決論点の正本、判断材料の担当、決定時期・人間の判断者、未決中の保留対象を特定できますか。
62
+ - 問い: 何が変わると合格条件を直すか。未決の間どの判定を保留するか。
63
+ - コツ: 未決事項に、決まったとき直す条件を添える。
75
64
 
76
65
  ## 5. 深掘り手順
77
66
 
78
- 1. 各ゲートがどの価値または受入条件を守るか確認します。
79
- 2. 同じ条件を持つ目標・メトリクス・検査を統合します。
80
- 3. 技術検証だけで終わるゲートに利用者価値との関係を付けます。
81
- 4. 使用されない指標を削除します。
67
+ 1. 各ゲートが守る条件 ID を確かめ、対応のないゲートを外す。
68
+ 2. 技術検証だけで閉じるゲートに利用者価値を付ける。
69
+ 3. どの判定にも使わない指標を外す。
82
70
 
83
71
  ## 6. 良い例 / 悪い例
84
72
 
85
- | 観点 | 良い例 | 悪い例 |
86
- | ---------- | ---------------------------------- | ---------------------- |
87
- | 価値品質 | 利用者が主要操作を完遂できる | lintが成功する |
88
- | 費用・負荷 | 支出と追加操作時間を別々に判定 | 無償なので低コスト |
89
- | 是正 | 未達IDを修正して同じゲートを再判定 | 問題ないことを確認する |
73
+ | 観点 | 良い例 | 悪い例 |
74
+ | -------- | ------------------------------------ | ---------------------- |
75
+ | 価値品質 | 利用者が主要操作を完遂できる | lint が成功する |
76
+ | 費用 | 支出と追加の作業時間を別々に判定する | 無償なので低コスト |
77
+ | 是正 | 未達 ID を直し同じゲートで再判定する | 問題ないことを確認する |
90
78
 
91
79
  ## 7. レビュー観点
92
80
 
93
- | 観点 | 確認内容 |
94
- | -------- | --------------------------------------------------------------------------------- |
95
- | 範囲 | 価値品質・成果物品質、適用期間、人間と AI Agent の境界が明確か |
96
- | 判定 | 条件 ID、時期、確認・承認責任、方法・証跡が接続し、未達と材料不足を通過させないか |
97
- | レビュー | 出口条件・証跡・記録先を個別に確認できるか |
98
- | 是正 | 重大性の境界、再判定条件・責任、報告・登録先が明確か |
99
- | 維持 | 見直し・未決・後続作業が担当と期限へ接続し、正本を重複させていないか |
81
+ | 観点 | 確認内容 |
82
+ | -------- | ------------------------------------------------- |
83
+ | 判断責任 | AI Agent に価値・例外・公開の判断を委ねていないか |
84
+ | 公開適性 | 公開対象に個人情報・非公開情報が残っていないか |
100
85
 
101
86
  ## 8. 仕上げチェック
102
87
 
103
- - 品質ゲート、レビュー、是正がそろっている。
104
- - 費用と人の負荷を必要に応じて分けている。
105
- - 生成物の直接編集を認めていない。
106
- - Agentに価値・例外・公開判断を委ねていない。
107
- - 各品質ゲートが、守る価値または品質リスク、合格条件、検査・是正方法、証跡に対応している。
88
+ - 各ゲートから、守る価値・合格条件・証跡の記録先までたどれる。
@@ -11,94 +11,80 @@ specdojo:
11
11
 
12
12
  RACI Writing Recipe
13
13
 
14
- 責任衝突が起きやすい主要成果物と主要判断だけを、二つのマトリクスへ整理する作り方です。
14
+ 責任衝突が起きやすい成果物と判断だけを選び、Schedule の担当まで整理する作り方を示す。
15
15
 
16
16
  ## 1. このレシピの使い方
17
17
 
18
- - 初期スコープから主要成果物と主要判断を選びます。
19
- - 成果物別と判断・プロセス別のRACIを作ります。
20
- - Schedule owner、member割り当てとの整合を確認します。
21
- - 責任衝突や判断停滞の回避(Why)、対象となる主要成果物・判断(What)、RACI と owner 方針(How)を扱い、行名・Role code・Schedule owner の対応で追跡します(Trace)。member 割り当ては再掲しません。
18
+ - 責任衝突や判断停滞を防ぐ理由(Why)から対象の成果物・判断(What)を選び、責任配置と担当(How)を決め、行名・Role code・Schedule の `owner` でたどれるようにする(Trace)。
22
19
 
23
20
  ## 2. 作成前に集める情報
24
21
 
25
- | 項目 | 集める情報 |
26
- | --------- | ------------------------------------------------------------------- |
27
- | Role code | 採用済みの責任語彙 |
28
- | 成果物 | 初期スコープ、管理計画、公開対象 |
29
- | 判断 | 価値、費用・負荷、変更、品質例外、公開 |
30
- | 実行 | WBS の明示 `owner`、Schedule のタスク種別・action、作業ごとの主担当 |
31
- | 割り当て | member、兼務、Agent支援の正本 |
22
+ | 項目 | 集める情報と取り出し元 |
23
+ | --------- | ----------------------------------------------------- |
24
+ | 採用 Role | 列に使う Role code(組織定義) |
25
+ | 対象 | 主要成果物・公開対象(初期スコープ) |
26
+ | 判断 | 価値・費用・変更・品質例外・公開の判断者(PM に聞く) |
27
+ | 実行 | 明示 `owner`、タスク種別(WBS・Schedule) |
32
28
 
33
29
  ## 3. 全体の作成手順
34
30
 
35
- 1. 責任衝突の可能性がある成果物・判断だけを選びます。
36
- 2. 使用するRole code列を必要最小限に絞ります。
37
- 3. 各行へ一つの`A`と一つ以上の`R`を置きます。
38
- 4. 相談が必要なRoleに`C`、結果共有だけのRoleに`I`を置きます。
39
- 5. 複数 `R` の担当範囲を注記し、WBS の明示 `owner` とタスク種別から Schedule の担当を照合します。
40
- 6. 不一致時の更新先と見直し条件を定め、生成ビューや通常手順の重複行を削除します。
31
+ 1. 対象の成果物と判断を先に選ぶ。カタログから始めると責任が埋もれる。
32
+ 2. 列の Role を必要な分だけ残す。
33
+ 3. 成果物別、判断・プロセス別の順に表を作る。承認者が先に決まると、プロセス行の判断を分けやすい。
34
+ 4. Schedule と照合する。不一致で表を直すため表の後に行う。
35
+ 5. 見直し条件を書く。
41
36
 
42
37
  ## 4. 各章の書き方
43
38
 
44
39
  ### 4.1. 適用方針
45
40
 
46
- - どの成果物・判断で業務・技術・品質の責任衝突が起こり得ますか。対象外とする範囲と理由は何ですか。
47
- - 兼務と AI Agent 支援を使っても、人間の最終判断を区別できますか。
48
- - 採用済み Role のうち、どれを列に使い、どれをどの理由で省きますか。記号の意味は共通定義へ委譲します。
41
+ - 問い: どの成果物・判断で責任がぶつかり得るか。外す範囲の理由は何か。
42
+ - コツ: PM に「誰の判断を待って作業が止まったか」を聞く。採用 Role の一覧は写さず参照に置き換える。
49
43
 
50
44
  ### 4.2. 成果物別RACI
51
45
 
52
- - 主要成果物と管理文書を、作成・内容承認の責任が同じ単位でまとめられますか。
53
- - 同じ正本から生成するビューを重ねず、各成果物 ID から行を一意に辿れますか。
54
- - 誰が作成し、どの Role の人間が内容を承認しますか。複数の作業担当なら担当範囲を注記します。
46
+ - 問い: 誰が作成し、どの Role の人間が内容を承認するか。
47
+ - コツ: 作業担当が複数なら、分担をその場で聞いて注記する。後から Schedule を見て選ぶと根拠が残らない。
55
48
 
56
49
  ### 4.3. 判断・プロセス別RACI
57
50
 
58
- - 価値・費用・変更・品質例外・公開で、判断者や判断材料が異なるものはどれですか。
59
- - 成果物行の承認とプロセス行の判断が重なる場合、それぞれ何を判断しますか。
60
- - 当事者確認と必要な技術・品質相談を、どの採用 Role を介して受けますか。
51
+ - 問い: 判断者が異なる判断はどれか。成果物行の承認と重なるとき、それぞれ何を判断するか。
52
+ - コツ: 「作成フローの運営」は内容の承認も含むと読まれやすいため、順序・進捗の判断と分ける。
61
53
 
62
54
  ### 4.4. Schedule・実行主体との対応
63
55
 
64
- - WBS に明示 `owner` はありますか。あれば引き継ぎを先に確認し、未指定の作成作業は `R` から担当を展開します。複数なら action に最も近い担当を注記で特定し、一意でなければ分割します。`A/R` は作業担当も兼ねます。
65
- - 対象は作成作業ですか、別タスクに分けた承認・レビュー・外部待ちですか。後者では対応する `A` / `C` と照合し、通知だけの `I` を担当にしません。
66
- - WBS・Schedule、実行主体・兼務の正本はどこですか。不一致は責任配置の変更かタスク定義・生成処理の誤りかを調べ、修正先を決めます。
56
+ - 問い: WBS に明示の `owner` はあるか。なければ、どの `R` から担当を展開するか。
57
+ - コツ: 担当が一意に決まらなければ、タスクの分割を WBS の担当者に相談する。
67
58
 
68
59
  ### 4.5. 見直し条件
69
60
 
70
- - スコープ、成果物、採用 Role、判断ゲート、担当・兼務の何が変わると見直しますか。
71
- - 誰が影響する RACI 行、正本、WBS・Schedule の追従担当と期限を整理しますか。
72
- - 未決の担当変更・リスク・課題は、どの管理記録へ Role と転送先を付けて渡しますか。
61
+ - 問い: 何が変わると見直し、どの行と Schedule が追従するか。
62
+ - コツ: 判断が止まった場面を聞くと、契機を具体的に書ける。
73
63
 
74
64
  ## 5. 深掘り手順
75
65
 
76
- 1. 各行の`A`が本当に最終判断者か確認します。
77
- 2. `C`と`I`を必要最小限に減らします。
78
- 3. 同じ責任配置の行をグループ化します。
79
- 4. 各行が成果物または主要判断に使われるか確認し、目的のない行を削除します。未計画の主要判断は後続タスクへ渡します。
66
+ 内容が浅いときは、次の順で対応のない主張を探す。
67
+
68
+ 1. 各行が防ぐ責任衝突・判断停滞を確かめ、目的のない行を外す。
69
+ 2. 各行の `A` が実際の最終判断者かを確かめる。
70
+ 3. `C`・`I` がどの判断に効くかを確かめ、効かないものを外す。
71
+ 4. Schedule の各 `owner` がどの行から来たかをたどる。
80
72
 
81
73
  ## 6. 良い例 / 悪い例
82
74
 
83
- | 観点 | 良い例 | 悪い例 |
84
- | ---- | ------------------------------------------------------------------ | --------------------------- |
85
- | 対象 | 主要成果物と公開判断へ絞る | 全カタログ行を転記する |
86
- | 責任 | 一行に`A`を一つ置く | `A`を複数置く |
87
- | 実行 | 作成は WBS の明示担当を先に照合し、別の承認タスクは `A` と照合する | 全タスクを `R` に書き換える |
75
+ | 観点 | 良い例 | 悪い例 |
76
+ | ---------- | --------------------------------------------- | ----------------------------------- |
77
+ | 判断の行名 | 「初期公開の可否」のように判断を名指す | 「プロジェクト運営」とだけ書く |
78
+ | 承認タスク | 別タスクにした承認を、その行の `A` と照合する | 承認タスクも作成者の `R` にそろえる |
79
+ | AI Agent | 支援として注記し、`A` は人間の Role に置く | AI Agent を承認者の列に入れる |
88
80
 
89
81
  ## 7. レビュー観点
90
82
 
91
- | 観点 | 確認内容 |
92
- | ---- | ---------------------------------------------------------------------- |
93
- | 責任 | 各行の `A` と作業ごとの主担当を識別できるか |
94
- | 採用 | 列が採用済み Role に対応し、省略理由と専門支援の取り込み先が分かるか |
95
- | 展開 | WBS の明示担当、作成と承認・レビューの種別から Schedule と照合できるか |
96
- | 範囲 | 業務・技術・品質の主要責任を辿れ、重複する行を増やしていないか |
83
+ | 観点 | 確認内容 |
84
+ | -------- | ------------------------------------------------------------- |
85
+ | 判断範囲 | 成果物行とプロセス行で、同じ判断を二つの `A` が持っていないか |
97
86
 
98
87
  ## 8. 仕上げチェック
99
88
 
100
- - 成果物別、判断・プロセス別の二表がある。
101
- - 省略範囲と見直し条件が明確である。
102
- - member・Agent割り当てを再掲していない。
103
- - Agentに`A`を割り当てていない。
104
- - 各行の採用理由、`A` / `R`、Schedule owner または判断記録先の対応を追跡できる。
89
+ - 各行の採用理由、`A`・`R`、Schedule の `owner` をたどれる。
90
+ - メンバーの割り当てを写していない。
@@ -11,124 +11,97 @@ specdojo:
11
11
 
12
12
  Project Role Definition Writing Recipe
13
13
 
14
- 本ドキュメントは、ロール定義を「PO が全 Role code とプロジェクト固有メモを承認できる内容」に仕上げるための作り方です。本書では問い、深掘り手順、レビュー観点を扱います。
14
+ ロール定義を、PO が全 Role code とプロジェクト固有メモを承認・保留・差し戻しできる内容に仕上げるための作り方を示す。
15
15
 
16
16
  ## 1. このレシピの使い方
17
17
 
18
- - 最初に、組織定義から採用する責務語彙、最終判断の集約先、公開方針を確認する。
19
- - 次に、`pm-roles.yaml` に列挙する Role code を、Schedule の `owner` や RACI の列として使える粒度で整理する。
20
- - 最後に、member nickname、agent 名、個人名、兼務割り当てを混ぜず、プロジェクト固有メモだけを残す。
21
- - 準拠先と採用根拠をメタ項目へ接続し、対応 schema で出力を検証する。
22
- - 組織上必要な責任領域(Why)、採用する Role code(What)、プロジェクト固有の責務強調(How)を扱い、`based_on` と下流の Role code 参照で追跡する(Trace)。割り当てや一般責務は各正本へ委譲する。
18
+ - ロール定義は、組織定義の採用判断(Why)を引き継ぎ、採用する Role code の集合(What)を転記し、プロジェクト固有の扱い(How)だけを `project_note` に添える。採用根拠は `based_on`、下流の利用は Schedule・RACI・メンバー定義の Role code 参照でたどる(Trace)。
19
+ - 「作成前に集める情報」をメモでそろえてから、「全体の作成手順」の順に書く。
23
20
 
24
21
  ## 2. 作成前に集める情報
25
22
 
26
- | 項目 | 集める情報 |
27
- | -------------------- | ------------------------------------------------------------ |
28
- | 組織定義 | 採用する責務語彙、最終判断の集約先、見直し条件 |
29
- | プロジェクト ID | `project_id` と `id` に使う値 |
30
- | 採用 Role code | Schedule の `owner` と RACI の列に使う Role code |
31
- | Role name | 各 Role code の正式名称 |
32
- | プロジェクト固有メモ | 当該プロジェクトで強調する責務、専任化条件、公開判断上の注意 |
33
- | 下流文書 | `pm-members.yaml`、Schedule、RACI が参照する Role code |
34
- | schema | `pm-roles.yaml` に許可されるメタ項目、Role code、型制約 |
35
- | 公開制約 | 個人情報、連絡先、非公開組織情報を含めない条件 |
23
+ | 項目 | 集める情報 | 取り出し元 |
24
+ | ---------------------- | ------------------------------------------------------ | ---------------------------- |
25
+ | 採用集合 | 採用・未採用の Role code、使用可能な `owner`、採用理由 | 組織定義 |
26
+ | 正式名称 | 各 Role code の正式名称 | 人と組織の定義標準 |
27
+ | 下流の参照値 | 実際に使われている Role code と、その使い手 | Schedule、RACI、メンバー定義 |
28
+ | プロジェクト固有の扱い | 強調する責務、専任化を検討する条件、公開判断上の注意 | PO・PM への確認 |
29
+ | 識別情報 | `project_id`、名称、版 | 配置先プロジェクト |
36
30
 
37
31
  ## 3. 全体の作成手順
38
32
 
39
- 1. 対象プロジェクトと一覧の名称・版を確認し、メタ項目へ反映する。成果物自身の `rulebook` も指定して準拠先を保持する。
40
- 2. 採用判断の根拠となる組織定義を読み、カタログを使う場合は依存の範囲を確認して `based_on` へ接続する。
41
- 3. 組織定義の採用集合を `roles` へ転記し、`code` と上位標準の正式な `name` を対応付ける。
42
- 4. PO の判断に必要な固有の扱いだけを `project_note` に短く添える。
43
- 5. 実行主体・兼務の説明はメンバー定義へ移し、下流参照と採用集合の差分を確認する。
44
- 6. `docs/specdojo/schemas/v1/pm-roles.schema.yaml` で検証し、コードの重複・採用集合・正式名称は別途照合する。
45
- 7. PO に、採用変更の理由、未決事項、下流への追従結果と公開判断に必要な材料を提示する。
33
+ 1. 組織定義を読み、採用集合を確かめてから `based_on` へ接続する。採用集合が決まらないと、`roles` の範囲が決まらない。
34
+ 2. 下流の参照値を洗い出し、採用集合との差分を先に見つける。転記の後で見つけると、どちらを直すかの判断が遅れる。
35
+ 3. 採用集合を `roles` へ転記し、`code` と正式名称を対応付ける。
36
+ 4. PO の判断に要る固有の扱いだけを `project_note` に添える。
37
+ 5. 最後にメタ項目を整える。採用根拠が決まってからだと、`based_on` を未確認の文書で埋めずに済む。
46
38
 
47
- ## 4. 各要素の書き方
39
+ ## 4. 各章の書き方
48
40
 
49
- ### 4.1. メタ項目
41
+ ### 4.1. メタ項目と根拠
50
42
 
51
43
  問い:
52
44
 
53
- - 対象プロジェクト、一覧の名称、現在の版をメタ項目から識別できるか。
54
- - `rulebook` は成果物の準拠先を示し、カタログ側だけの宣言で済ませていないか。
55
- - `based_on` は確認した採用根拠を指し、カタログ利用時は依存から辿れるか。
45
+ - `based_on` の各 ID は、採用集合を実際に確かめた文書か。
46
+ - 準拠先を、成果物自身から識別できるか。
56
47
 
57
- 書き方:
48
+ コツ:
58
49
 
59
- - 名称・版・プロジェクトの記入値を、配置先と採用判断の文書に照らして確かめる。
60
- - 準拠先を成果物自身に残し、schema 検証でメタ項目の漏れや入力誤りを見つける。
61
- - 採用理由の本文は組織定義を正本とし、ここでは根拠 ID で接続する。
50
+ - 同じディレクトリの文書をまとめて `based_on` に入れたくなったら、採用判断に使った文書だけに絞る。
51
+ - 採用理由の本文は組織定義から写さず、ID での参照に置き換える。
62
52
 
63
53
  ### 4.2. `roles`
64
54
 
65
55
  問い:
66
56
 
67
- - 組織定義の採用集合を、専門支援だけの Role も含めて転記できているか。
68
- - 重複した Role code や表記ゆれはないか。
69
- - 専任 member がいない Role code でも、責務語彙として必要なら残せているか。
57
+ - 専任 member がいない Role code を、未採用と取り違えて落としていないか。
58
+ - 下流で使われているのに採用集合にない Role code はないか。
70
59
 
71
- 書き方:
60
+ コツ:
72
61
 
73
- - 組織定義の採用行だけを抜き出し、上位標準の定義順で照合すると漏れを見つけやすい。
74
- - 専任者の不在と未採用を取り違えず、使用可能な `owner` の部分集合とも区別する。
75
- - 下流の Role 参照に差分があれば、採用判断か参照元のどちらを直すか決めてから転記を確定する。
62
+ - 「今いる人」から Role を数えると、兼務中のロールが抜けやすい。PO・PM に「誰もいなくても語彙として要るロールはどれか」と聞く。
63
+ - Role code を変えたり除いたりするときは、使っている下流の文書と使い手を先に聞き、責務の移り先を決めてから変える。
76
64
 
77
65
  ### 4.3. `roles[].project_note`
78
66
 
79
67
  問い:
80
68
 
81
- - PO が承認判断するために必要なプロジェクト固有の扱いが分かるか。
82
- - 専任化を検討する条件や公開判断上の注意が必要か。
83
- - member nickname、agent 名、個人名、兼務割り当てを書いていないか。
84
- - 未決事項がある場合、_UNDECIDED_: または _TODO_: で明示しているか。
69
+ - PO が承認・保留を決めるのに、このメモがないと何が判断できないか。
70
+ - このプロジェクトに固有の扱いか、どのプロジェクトにも当てはまる一般責務か。
85
71
 
86
- 書き方:
72
+ コツ:
87
73
 
88
- - 1 Role につき 1 行を目安にする。
89
- - 一般的な責務の長い再掲ではなく、当該プロジェクトでの使い方を書く。
90
- - 割り当てが必要な場合は `pm-members.yaml` に委譲する。
91
- - 未決事項は推測で確定させず、_UNDECIDED_:(判断未了)または _TODO_:(後で確認・追記が必要)から書き始め、判断時点や判断者が分かる形で残す。
74
+ - 担当者の名前や agent 名を書きたくなったら、メンバー定義へ移す。メモに書くと、割り当ての変更のたびに一覧を直すことになる。
75
+ - 「必要に応じて」と書きそうになったら、PO に「何が起きたら専任化を考えるか」を聞き、その条件を書く。
76
+ - 決めきれない点は推測で埋めず、判断する人と時期を PO に確かめる。
92
77
 
93
78
  ## 5. 深掘り手順
94
79
 
95
- 1. 組織定義の「採用ロールと owner 語彙」から、Role code の採用方針を抜き出す。
96
- 2. Schedule、RACI、member 定義で参照される可能性がある責務語彙を洗い出す。
97
- 3. 標準 Role code で代替できない独自コードが出ていないか確認する。
98
- 4. 各 Role の `project_note` を、責務強調、専任化条件、公開判断上の注意に分類する。
99
- 5. 実行主体や兼務割り当てに該当する記述を `pm-members.yaml` 側へ移す。
100
- 6. PO の最終判断、公開可否、説明責任が agent や member nickname に移っていないことを確認する。
80
+ 内容が浅いときは、次の順で対応のない主張を探す。
81
+
82
+ 1. `roles` の各 Role code が、組織定義の採用判断のどれに対応するかを確かめ、対応のないコードを外す。
83
+ 2. 下流の各参照値が `roles` にあるかを確かめ、未定義のコードを見つける。
84
+ 3. 各 `project_note` が、PO のどの判断に使われるかを確かめ、判断に使われないメモを削る。
101
85
 
102
86
  ## 6. 良い例 / 悪い例
103
87
 
104
- | 観点 | 良い例 | 悪い例 |
105
- | -------------------- | ---------------------------------------------------------- | --------------------------------- |
106
- | Role code | `code: PM` | `code: project-manager-agent` |
107
- | 実行主体との分離 | 実行主体の割り当ては `pm-members.yaml` で管理する | `PM は pm-agent が担当する` |
108
- | プロジェクト固有メモ | 小規模運用では専任化せず、滞留時に見直す | 必要に応じて対応する |
109
- | 公開可否 | 公開判断は PO に残す | agent が公開可否を判断する |
110
- | 下流入力 | `roles[].code` を Schedule の `owner` に使う | `owner` に member nickname を使う |
111
- | 準拠先 | 成果物自身に `rulebook: specdojo:pm-roles-rulebook` を残す | カタログにあるので成果物から省く |
88
+ | 観点 | 良い例 | 悪い例 |
89
+ | ---------- | ------------------------------------------------------------- | ---------------------------------- |
90
+ | 公開判断 | 公開可否の最終判断は PO に残す | agent が公開可否を判断する |
91
+ | 下流の参照 | `roles[].code` を Schedule の `owner` に使う | `owner` に member nickname を使う |
92
+ | 準拠先 | 成果物自身に `rulebook` を残す | カタログにあるので成果物から省く |
93
+ | 専任化 | 「実装タスクが継続して増えたら DEV の専任化を検討する」と書く | 「必要に応じて体制を見直す」と書く |
112
94
 
113
95
  ## 7. レビュー観点
114
96
 
115
- | 観点 | 確認内容 |
116
- | ---------------------- | --------------------------------------------------------------------------------- |
117
- | 目的・スコープとの整合 | 組織定義で採用した責務語彙と矛盾していないか |
118
- | 承認判断 | PO が全 Role code と `project_note` を承認、保留、差し戻しできるか |
119
- | 未決事項の明示 | `project_note` の未決事項が _UNDECIDED_: / _TODO_: で識別でき、放置されていないか |
120
- | owner 語彙 | Schedule の `owner` に使う値が `roles[].code` として定義されているか |
121
- | スキーマ適合 | 必須メタ項目、`roles` 配列、Role code の列挙が YAML スキーマに沿っているか |
122
- | 公開可否 | 個人情報、連絡先、非公開情報、agent への最終判断委任が含まれていないか |
123
- | 下流入力 | `pm-members.yaml`、Schedule、RACI が参照できる安定した Role code になっているか |
97
+ | 観点 | 確認内容 |
98
+ | ---------- | ------------------------------------------------------------------------- |
99
+ | 採用の対応 | 各 Role code が組織定義の採用判断に対応し、未採用のコードが紛れていないか |
100
+ | 下流の接続 | Schedule、RACI、メンバー定義が使う値がすべて `roles[].code` にあるか |
101
+ | 委譲の境界 | 一般責務・採用理由・実行主体の割り当てを、各正本へ委ねているか |
124
102
 
125
103
  ## 8. 仕上げチェック
126
104
 
127
- - 「全体の作成手順」で示した構成と必須項目がそろっている。
128
- - `roles[].code` に必要な Role code が過不足・重複なく入っている。
129
- - `roles[].project_note` はプロジェクト固有メモに限定され、具体的な member 割り当てを含まない。
130
- - `roles[].project_note` の未決事項は _UNDECIDED_: または _TODO_: で明示され、放置されていない。
131
- - `pm-organization.md` の採用方針と矛盾していない。
132
- - `pm-members.yaml` の `members[].roles` から参照できる Role code 語彙になっている。
133
- - 公開してよい情報だけで構成され、最終判断と説明責任が人間の PO に残っている。
134
- - 各 Role code の採用根拠と下流利用を、`based_on` と既存の参照値から追跡できる。
105
+ - 各 Role code の採用根拠を `based_on` から、下流での利用を参照値からたどれる。
106
+ - `project_note` に担当者・agent 名・兼務の割り当てがない。
107
+ - 公開してよい情報だけで構成され、最終判断が PO に残っている。