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
@@ -12,34 +12,26 @@ specdojo:
12
12
 
13
13
  Issue Log Documentation Rules
14
14
 
15
- 本ドキュメントは、`課題ログ` を一貫した粒度で作成するためのルールを定義する。
15
+ 顕在化した課題の優先度・期限・対応・状態を追跡する課題ログの記述基準を定める。
16
16
 
17
17
  ## 1. 全体方針
18
18
 
19
- - 発生課題の特定、優先度判断、対応状況を追跡可能に管理する。
20
- - 課題ごとにID、期限、担当、状態、次アクションを明確にする。
21
- - 曖昧表現を避け、未解決課題の判定が可能な記述にする。
19
+ - 顕在化した課題ごとに、未解決かどうかと次の対応を判定できる形で残す。
20
+ - **共通の運用**: 役割の割り当ては適用先のメンバー定義に、`status`・承認・改訂と廃止・未決事項の引き継ぎは [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] に従う。文書の整形・lint はリポジトリの検証で扱う。
22
21
 
23
- ## 2. 位置づけと用語定義(必要に応じて)
22
+ ## 2. 位置づけ
24
23
 
25
- - `pm-plan`: 全体管理方針。
26
- - `pm-risk-register`: 潜在リスクの管理。
27
- - `pm-issue-log`: 顕在化した課題の管理。
24
+ - プロジェクト登録簿を使うプロジェクトでは、課題 1 件を `item_type: issue` の個票に書き、`controls/generated/pm-issue-log.md` は `register build` が個票から生成する。生成物の Frontmatter は `rulebook: specdojo:pjr-rulebook` とし、直接編集しない([[specdojo:pjr-rulebook|プロジェクト登録簿 作成ルール]] に従う)。
25
+ - 本書の判断基準は、個票と、登録簿を使わない単独の課題ログの両方に適用する。
28
26
 
29
27
  ## 3. ファイル命名・ID規則
30
28
 
31
- - `id` は `<project-id>:pm-issue-log` を使用する。
32
- - ファイル名は `pm-issue-log-課題ログ.md` など一意にする。
29
+ - `id` は `<project-id>:pm-issue-log`、ファイル名は `pm-issue-log.md` とする。
30
+ - 課題 ID は登録簿では `PJR-XXXX`、単独のログでは `IS-NNN` とし、再利用しない。
33
31
 
34
32
  ## 4. 推奨 Frontmatter 項目
35
33
 
36
- | 項目 | 説明 | 必須 |
37
- | ---------- | -------------------------------- | ---- |
38
- | id | `<project-id>:pm-issue-log` | ○ |
39
- | type | `project` 固定 | ○ |
40
- | status | `draft` / `ready` / `deprecated` | ○ |
41
- | based_on | 根拠仕様ID(配列) | 任意 |
42
- | supersedes | 置換関係ID(配列) | 任意 |
34
+ - 許可キーと型は [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] を正本とし、`type` は `project` とする。
43
35
 
44
36
  ## 5. 本文構成(標準テンプレ)
45
37
 
@@ -56,39 +48,35 @@ Issue Log Documentation Rules
56
48
 
57
49
  ### 6.1. 概要
58
50
 
59
- - 管理対象、レビュー頻度、更新責任者を 1〜3 行で示す。
51
+ - 管理対象、レビュー頻度、記録単位を 1〜3 行で示す。
60
52
 
61
53
  ### 6.2. 課題ログ一覧
62
54
 
63
- - 課題ID、発生日、内容、優先度、対応策、担当、期限、ステータスを一覧化する。
64
-
65
- 推奨フォーマット(表):
66
-
67
- | 課題ID | 発生日 | 内容 | 優先度 | 対応策 | 担当 | 期限 | ステータス |
68
- | ------ | ------ | ---- | ------ | ------ | ---- | ---- | ---------- |
55
+ - 課題 ID、発生日、内容、優先度、対応策、担当、期限、ステータスを一覧にする。
56
+ - 優先度とステータスは登録簿の `priority`・`item_status` の値を使い、言い換えない。
69
57
 
70
58
  ### 6.3. 優先度と期限
71
59
 
72
- - 優先度基準、期限設定ルール、期限超過時対応を明記する。
60
+ - 優先度の基準、期限の決め方、期限超過時のエスカレーション先、優先度の変更を決める者を書く。
73
61
 
74
62
  ### 6.4. 対応計画
75
63
 
76
- - 対応策、依存事項、完了条件を明記する。
64
+ - 対応策、依存事項、完了条件を書く。完了条件は確認の手段と合格の基準で書く。
77
65
 
78
66
  ### 6.5. 進捗レビュー
79
67
 
80
- - レビュー周期、判定観点、更新ルールを明記する。
68
+ - レビュー周期、完了を判定する者と判定の観点、状態を更新する契機を書く。
81
69
 
82
70
  ### 6.6. 関連ドキュメント
83
71
 
84
- - `pm-risk-register`、`pm-change-request-log` への導線を記載する。
85
- - 関連がない場合でも `(本書のみ)` を明記する。
72
+ - 根拠、影響先、課題から起票したリスク・変更要求を文書 ID で示す。なければ `(本書のみ)` と書く。
86
73
 
87
74
  ## 7. 禁止事項
88
75
 
89
- | 禁止事項 | 理由 |
90
- | ---------------------------- | -------------------------- |
91
- | 課題IDなしで記録する | 追跡不能になるため |
92
- | 優先度・期限を未記載にする | 対応順序が判断できないため |
93
- | 状態更新ルールを未定義にする | 管理の一貫性が崩れるため |
94
- | 根拠のない完了判定を記載する | 品質低下を招くため |
76
+ | 禁止事項 | 理由 |
77
+ | ------------------------------------------ | -------------------------- |
78
+ | 課題IDなしで記録する | 追跡不能になるため |
79
+ | 優先度・期限を未記載にする | 対応順序が判断できないため |
80
+ | 根拠のない完了判定を記載する | 品質低下を招くため |
81
+ | 個人情報・認証情報を内容や対応策に書き写す | 公開範囲を超えて広がるため |
82
+ | 生成された `pm-issue-log.md` を直す | 再生成で修正が失われるため |
@@ -16,40 +16,32 @@ specdojo:
16
16
 
17
17
  Project Human Member Roster Documentation Rulebook
18
18
 
19
- `pm-members.yaml` を、人間の実行主体と対応 Role code を管理するプロジェクト成果物として作成・更新するためのルールです。実行可能な agent の定義は、リポジトリ共通の保護設定へ分離します。
19
+ `pm-members.yaml` に人間の実行主体と対応 Role code を定義する基準です。
20
20
 
21
21
  ## 1. 全体方針
22
22
 
23
- - `pm-members.yaml` には人間の member だけを記載し、`members[].type` は `human` とします。
24
- - 実行可能な agent は `.specdojo/agent-members.yaml` を正本とし、`pm-members.yaml` に複製しません。
25
- - Member は実行主体、Role code は責務を表します。Schedule の `owner` には member nickname を書きません。
26
- - `members[].roles` には `pm-roles.yaml` に存在する Role code だけを記載します。
27
- - 公開文書には、不要な個人名、私用メールアドレス、非公開組織情報、アクセス情報を記載しません。
28
- - 人間の最終承認、公開可否、説明責任は agent 定義へ移しません。
23
+ - 対象は project の人間名簿です。agent の実行定義は含めません。
24
+ - Role・Member・`owner` の区別と公開情報の扱いは [[specdojo:people-and-organization-definition-standard|人と組織の定義標準]] に従います。
25
+ - **共通の運用**: 役割の割り当ては適用先のメンバー定義に、`status`・承認・改訂と廃止・未決事項の引き継ぎは [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] に従います。文書の整形・lint はリポジトリの検証で扱います。
29
26
 
30
27
  ## 2. 位置づけと用語定義
31
28
 
32
- | 情報 | 正本 | 粒度 |
33
- | ----------------------------- | ------------------------------ | ---------- |
34
- | 人間の identity・連絡先・兼務 | `pm-members.yaml` | project |
35
- | agent の identity・選択属性 | `.specdojo/agent-members.yaml` | repository |
36
- | provider の起動コマンド | `.specdojo/exec-defaults.yaml` | repository |
37
- | Role code と責務 | `pm-roles.yaml` | project |
38
- | Schedule の主責任 | Schedule の `owner` | task |
39
-
40
- `loadMemberRoster` は人間名簿と agent 定義を schema 検証した後に合成します。合成後の nickname は一意でなければならず、`--by` と実行イベントはこの合成名簿を参照します。
29
+ | 情報 | 正本 |
30
+ | ----------------------------- | ------------------------------ |
31
+ | 人間の identity・連絡先・兼務 | project の `pm-members.yaml` |
32
+ | agent の identity・選択属性 | `.specdojo/agent-members.yaml` |
33
+ | provider の起動コマンド | `.specdojo/exec-defaults.yaml` |
41
34
 
42
35
  ## 3. ファイル命名・ID規則
43
36
 
44
- - ファイル名は `pm-members.yaml` とします。
45
- - 配置は `docs/ja/projects/<project-id>/030-project-management/pm-members.yaml` を推奨します。
37
+ - ファイル名は `pm-members.yaml`、推奨配置は `docs/ja/projects/<project-id>/030-project-management/` です。
46
38
  - `id` は `<project-id>:pm-members`、`project_id` は配置先 project ID と一致させます。
47
- - `members[].nickname` は英小文字または数字で始め、英小文字、数字、ハイフン、アンダースコアだけを使います。
48
- - 実行ログへ記録済みの nickname は変更せず、交代時は新しい member を追加します。
49
- - 同じ nickname を `.specdojo/agent-members.yaml` に定義しません。
39
+ - `members[].nickname` は1〜63文字、先頭は英小文字か数字、以降は英小文字・数字・`_`・`-` とします。
50
40
 
51
41
  ## 4. 推奨メタ項目
52
42
 
43
+ 許可キーと型は `docs/specdojo/schemas/v1/pm-members.schema.yaml` を正本とし、メタ項目はルートに置きます。
44
+
53
45
  | 項目 | 必須 | 内容 |
54
46
  | ------------ | ---- | -------------------------------- |
55
47
  | `id` | ○ | `<project-id>:pm-members` |
@@ -57,12 +49,11 @@ Project Human Member Roster Documentation Rulebook
57
49
  | `status` | ○ | `draft` / `ready` / `deprecated` |
58
50
  | `title` | ○ | 名簿の表示名 |
59
51
  | `rulebook` | ○ | `specdojo:pm-members-rulebook` |
60
- | `based_on` | 任意 | 根拠文書 ID |
61
- | `version` | ○ | 1 以上のデータ版 |
52
+ | `based_on` | 任意 | 根拠文書 ID の配列 |
53
+ | `supersedes` | 任意 | 置き換える旧文書 ID の配列 |
54
+ | `version` | ○ | 1 以上の整数 |
62
55
  | `project_id` | ○ | 対象 project ID |
63
56
 
64
- schema にないメタ項目は追加しません。成果物の `status` は作成中は `draft` とし、`ready` への変更は人間が判断します。
65
-
66
57
  ## 5. 本文要件
67
58
 
68
59
  | 要素 | 必須 | 内容 |
@@ -70,14 +61,14 @@ schema にないメタ項目は追加しません。成果物の `status` は作
70
61
  | `members` | ○ | 人間 member の配列 |
71
62
  | `rules` | 任意 | 名簿利用時の project 固有の運用ルール |
72
63
 
73
- `members[]` は次のフィールドを使用します。
64
+ `members[]` の必須性は対応 schema を優先します。上位の人と組織の定義標準では任意の `roles` も、本形式では必須です。
74
65
 
75
66
  | フィールド | 必須 | 内容 |
76
67
  | -------------------- | ---- | --------------------------------------------------------- |
77
68
  | `nickname` | ○ | CLI と履歴で使う安定識別子 |
78
69
  | `display_name` | ○ | 公開可能な表示名 |
79
- | `email` | 任意 | 公開可能な連絡先。不要または非公開なら `null` |
80
- | `roles` | ○ | 対応可能な Role code の配列 |
70
+ | `email` | 任意 | 公開可能な連絡先または `null` |
71
+ | `roles` | ○ | `pm-roles.yaml` に存在する Role code の重複なし配列 |
81
72
  | `type` | ○ | `human` 固定 |
82
73
  | `persona` | 任意 | 作業姿勢を示す短いラベル |
83
74
  | `focus` | 任意 | 重視する観点の配列 |
@@ -89,31 +80,22 @@ schema にないメタ項目は追加しません。成果物の `status` は作
89
80
  ### 6.1. 人間 member
90
81
 
91
82
  - 個人名を必要としない場合は、`po` や `store-owner` のような役割ベースの nickname と表示名を使います。
92
- - `roles` は兼務を表し、責務定義そのものは `pm-roles.yaml` に委ねます。
93
- - 最終判断、公開可否、説明責任を担う範囲は `note` に短く記載します。
83
+ - 兼務は `roles: [PO, BA]` のように記載します。
94
84
  - 連絡先を公開できない場合は推測で補わず `email: null` とします。
95
85
 
96
86
  ### 6.2. 合成名簿との整合
97
87
 
98
- - nickname が `.specdojo/agent-members.yaml` と重複しないことを確認します。
99
- - `--by` に人間または agent の nickname を指定する場合、合成名簿に一意に存在する値を使います。
88
+ - 人間名簿と agent 定義の合成後、全 nickname が一意であり、`--by`・実行イベントが登録値を使うことを照合します。
100
89
  - `pm-members.yaml` に `type: agent` が残る場合は、`specdojo config migrate-members --dry-run` で移行内容を確認します。
101
- - agent の追加・優先度・能力変更は、保護設定を変更できる人間または orchestrator が行います。
102
90
 
103
91
  ### 6.3. 運用ルール
104
92
 
105
- - `rules` には `owner`、`roles`、`--by` の使い分けを判定可能な文として記載します。
106
- - project 固有の公開制約や交代時の扱いだけを記載し、共通 schema を再掲しません。
107
- - agent の provider、モデル、起動 command は記載しません。
108
- - 名簿の変更理由は project の変更管理記録に残します。
93
+ - `rules` は project 固有の公開制約や交代時の扱いに限定し、共通標準・schema を再掲しません。
109
94
 
110
95
  ## 7. 禁止事項
111
96
 
112
- | 禁止事項 | 理由 |
113
- | ------------------------------------------------------ | ---------------------------------------- |
114
- | `type: agent` の member を記載する | 保護設定との責務境界が崩れるため |
115
- | `provider`、`command`、`mode`、`stage_role` を記載する | agent 実行設定を成果物から変更できるため |
116
- | Schedule の `owner` に nickname や人名を書く | 責務と実行主体を混同するため |
117
- | 未定義の Role code を `roles` に書く | ロール正本との整合が失われるため |
118
- | 実行ログ記録後の nickname を変更する | 履歴の参照先が不明になるため |
119
- | 秘密情報、私用連絡先、非公開組織情報を記載する | 公開適性と安全性を損なうため |
97
+ | 禁止事項 | 理由 |
98
+ | ---------------------------------------------------------------- | ---------------------------------------- |
99
+ | `type: agent` の member を記載する | 保護設定との責務境界が崩れるため |
100
+ | `provider`、`command`、`mode`、`stage_role` を記載する | agent 実行設定を成果物から変更できるため |
101
+ | 実行ログ記録後の nickname を変更する(交代時は新 member を追加) | 履歴の参照先が不明になるため |
@@ -16,88 +16,80 @@ specdojo:
16
16
 
17
17
  Organization Definition Documentation Rulebook
18
18
 
19
- プロジェクトの目的に必要な意思決定・実行・確認の分担方針を定義するルールです。組織定義には、体制の設計根拠、Role code の採用判断、使用可能な `owner` と見直し条件を残します。
19
+ プロジェクトの目的に必要な分担方針、Role code の採用判断、使用可能な `owner` と見直し条件を定義します。
20
20
 
21
21
  ## 1. 全体方針
22
22
 
23
- - プロジェクト規模、関係者、判断の複雑さに合う最小体制を定義します。
24
- - 組織図や役職の網羅ではなく、価値判断、実行、品質確認、公開・運用の責任境界を示します。
25
- - 共通のロール定義は上位標準を参照し、対象プロジェクトで採用するかどうかの判断は組織定義に残します。
26
- - 小規模では兼務を認めますが、Role code の採用と専任者の配置を分け、最終判断と実作業の責任を読み分けられるようにします。
27
- - AI Agent は実行支援者とし、最終承認、当事者価値、公開可否、説明責任を人間に残します。
28
- - 参加者や責務が増えた場合に、軽量体制から分担体制へ拡張する条件を示します。
23
+ - 規模・関係者・判断の複雑さに合う最小体制とし、価値判断、実行、品質確認、公開・運用の責任境界を示します。
24
+ - ロールの採用と専任配置を分け、兼務時も最終判断と実作業を区別します。
25
+ - 参加者や責務の増加に応じて、分担体制へ拡張する条件を示します。
26
+ - **共通の運用**: 役割の割り当ては適用先のメンバー定義に、`status`・承認・改訂と廃止・未決事項の引き継ぎは [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] に従います。文書の整形・lint はリポジトリの検証で扱い、業務の受入確認に含めません。
29
27
 
30
28
  ## 2. 位置づけ
31
29
 
32
- - Role、Member、Task owner、Executor、RACI の共通定義と整合性ルールは、[[specdojo:people-and-organization-definition-standard|人と組織の定義標準]] を正本とします。
33
- - 組織定義は、プロジェクト固有の採用・未採用 Role code、使用可能な `owner`、体制の設計根拠を管理し、Schedule と RACI のロール適合を確認する起点とします。
34
- - `pm-roles.yaml` は採用ロールの機械可読な定義、メンバー定義は実行主体と兼務、RACI は成果物・プロセス別の責任分担を扱います。これらの内容を組織定義に複製しません。
30
+ 共通定義と整合性ルールは [[specdojo:people-and-organization-definition-standard|人と組織の定義標準]] を正本とします。組織定義はプロジェクト固有の採用判断を残し、Schedule と RACI のロール適合を確認する起点です。採用結果の機械可読な定義は `pm-roles.yaml`、実行主体と兼務はメンバー定義、成果物・プロセス別の分担は RACI で扱います。
35
31
 
36
32
  ## 3. ファイル命名・ID規則
37
33
 
38
34
  - 配置は `docs/ja/projects/<project-id>/030-project-management/pm-organization.md` を推奨します。
39
35
  - ID は `<project-id>:pm-organization`、ファイル名は `pm-organization.md` とします。
40
- - 共通の命名規則は [[specdojo:docs-structure-guide|ドキュメント構成ガイド]]、Role code などの値・構文は人と組織の定義標準と各 YAML の schema を参照します。
36
+ - 共通の命名規則は [[specdojo:docs-structure-guide|ドキュメント構成ガイド]] に従います。
41
37
 
42
38
  ## 4. 推奨 Frontmatter 項目
43
39
 
44
40
  - 共通項目の必須・任意、型・許容値は [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] と同標準から参照する成果物 schema に従います。
45
41
  - `rulebook` には本書の ID を指定し、成果物の種別は本書の `deliverable_type` に合わせます。
46
- - `based_on` には採用判断の根拠となる先行成果物を指定します。依存関係に含まれない文書は本文で参照し、置き換え時の `supersedes` はメタ情報標準に従います。
42
+ - `based_on` には採用判断の根拠となる先行成果物を指定し、依存関係に含まれない文書は本文で参照します。
47
43
 
48
44
  ## 5. 本文要件
49
45
 
50
46
  以下はすべて必須です。見出し順・表・記入欄の骨組みは Frontmatter で宣言した template を正本とします。
51
47
 
52
- | 要件 | 記載する判断・根拠 |
53
- | ------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
54
- | 体制の設計 | 規模と目的に必要な責任領域、最終判断、実行・確認、兼務方針、人間と AI Agent の境界 |
55
- | ロールの採用判断 | 上位標準の各標準ロールとプロジェクト独自ロールについて、採用・未採用の Role code、判断理由、プロジェクトでの扱い。未採用の場合は責務の代替先または対象外の理由。未採用がなければ「なし」と明記 |
56
- | 使用可能な `owner` | Schedule で使用できる Role code の集合を明示。採用ロールの範囲内とし、RACI の列も採用判断およびロール定義と整合させる |
57
- | 正本への参照 | 人と組織の定義標準、ロール定義、メンバー定義、RACI などの正本と責務境界。未作成の文書は作成予定または省略理由を明記 |
58
- | 体制の見直し | 開始を判定できるトリガー、確認事項、更新先、判断者の Role code。変更時の追従確認と未決事項の管理先 |
48
+ | 要件 | 記載する判断・根拠 |
49
+ | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------ |
50
+ | 体制の設計 | 規模と目的に必要な責任領域、最終判断、実行・確認、兼務方針、人間と AI Agent の境界 |
51
+ | ロールの採用判断 | 各標準ロールと独自ロールの採用・未採用、理由、プロジェクトでの扱い。未採用は代替先または対象外の理由を示し、未採用がなければ「なし」と明記 |
52
+ | 使用可能な `owner` | Schedule に使える採用ロールの集合。RACI の列とロール定義との整合 |
53
+ | 正本への参照 | 関連定義との責務境界。未作成の文書は作成予定または省略理由 |
54
+ | 体制の見直し | 開始トリガー、確認事項、更新先、判断者の Role code、追従確認。未決事項がある場合は論点と体制への影響 |
59
55
 
60
56
  ## 6. 記述ガイド
61
57
 
62
- 共通定義・値・構文を再掲せず、人と組織の定義標準、メタ情報標準、各 schema を参照します。以下の例は個々の判断の書き方を示します。
58
+ 以下の判断基準と例に従います。Role code の値・構文は人と組織の定義標準と各 YAML の schema を参照します。
63
59
 
64
60
  ### 6.1. 組織モデル
65
61
 
66
- - 判断基準は、目的に必要な責任領域に漏れがなく、最終判断と実行・確認を区別できることです。当事者・利用者の価値確認と内部の管理責任も分けます。
67
- - 推奨表の列は「責任領域」「設計方針」「最終判断」「実行・確認」です。成果物・プロセス単位の割り当ては RACI を参照し、その割り当てと矛盾する責任者を書きません。
68
- - 良い例: 「初期は人間が複数ロールを兼務し、AI Agent は草案と検証を支援する。費用・受入・公開の最終判断は人間の `PO` が行う」。
69
- - 悪い例: 「小規模なので責任は全員で持ち、公開可否は Agent が決める」。判断者と実行支援の境界を確認できません。
62
+ - 判断基準は、目的に必要な責任領域に漏れがなく、当事者・利用者の価値確認と内部の管理責任を区別できることです。
63
+ - 推奨表の列は「責任領域」「設計方針」「最終判断」「実行・確認」です。責任者は RACI と整合させます。
64
+ - 良い例: 「店主の操作確認を `BA` が受け止め、`PO` が受入を判断する。初期は兼務する」。
65
+ - 悪い例: 「小規模なので責任は全員で持つ」。判断者と実行・確認の分担が分かりません。
70
66
 
71
67
  ### 6.2. ロール・owner方針
72
68
 
73
- - 判断基準は、各ロールの採用可否と根拠が分かり、Schedule の `owner` と RACI の列を照合できることです。ロール定義への参照だけで採用判断を済ませません。
74
- - 推奨表の列は「Role code」「採用/未採用」「判断理由・プロジェクトでの扱い」「未採用時の代替方針」です。共通の正式名称・責務は転載せず、使用可能な `owner` はこの表から特定できるように明示します。
75
- - 良い例: 「`PO` と `BA` を採用し、使用可能な `owner` は `PO`、`BA` とする。`PM` は未採用とし、計画・進捗管理は `PO` が担う」。他の標準ロールも採用可否を記載し、実行主体の兼務割り当てはメンバー定義で管理します。
76
- - 悪い例: 「`PM` は専任者がいないので未採用だが、Schedule の `owner` に使う」。採用と配置を混同し、未採用ロールを使用しています。
69
+ - 判断基準は、採用可否の根拠と使用可能な `owner` を特定し、Schedule と RACI の列を照合できることです。
70
+ - 推奨表の列は「Role code」「採用/未採用」「判断理由・プロジェクトでの扱い」「未採用時の代替方針」です。共通の正式名称・責務は転載しません。
71
+ - 良い例: 「`PO` と `BA` を採用し、`owner` に使う。`PM` は未採用とし、計画・進捗管理は `PO` が担う」。他の標準ロールも採否を記載します。
72
+ - 悪い例: 「`PM` は専任者がいないので未採用だが、`owner` に使う」。採用と配置を混同しています。
77
73
 
78
74
  ### 6.3. 正本と責任境界
79
75
 
80
- - 判断基準は、情報の更新先が一意に分かり、本書に残す採用判断を外部へ委譲していないことです。
81
- - 推奨表の列は「情報」「正本」「本書で扱うこと」です。採用判断と使用可能な `owner` は本書、採用ロールの定義はロール定義、実行主体はメンバー定義、詳細な責任割り当ては RACI に分けます。
82
- - 良い例: 「共通定義は人と組織の定義標準を参照し、本書で採用を決める。ロール定義にはその採用結果を反映する」。参照先が存在する場合は文書 ID でリンクします。
83
- - 悪い例: 「使用できるロールはロール定義を参照」とだけ書く、またはメンバー名簿・詳細な RACI を本文にも複製する。前者は採用根拠が欠け、後者は更新先が分散します。
76
+ - 判断基準は、情報の更新先が一意で、本書の採用判断を外部へ委譲していないことです。
77
+ - 推奨表の列は「情報」「正本」「本書で扱うこと」です。「位置づけ」の責務境界に従います。
78
+ - 良い例: 「本書で採用を決め、ロール定義に採用結果を反映する」。
79
+ - 悪い例: 「使用できるロールはロール定義を参照」とだけ書く、または名簿・詳細 RACI を複製する。採用根拠が欠けるか、更新先が分散します。
84
80
 
85
81
  ### 6.4. 見直し条件
86
82
 
87
- - 判断基準は、体制変更を開始する状態と、その後の更新・確認をタスク化できることです。目的・スコープ、関係者、参加者、作業滞留、公開・運用責任の変化からプロジェクトに必要な条件を選び、新しい Role code を増やす前に既存責任の再配分を検討します。
88
- - 推奨表の列は「トリガー」「確認すること」「更新先」「判断者」です。PM(未採用なら管理責務を代替する採用ロール)が追従タスクを管理し、PO が採用変更を判断する方針を示します。
89
- - 採用変更・置き換え・廃止時は、メタ情報標準の「文書の改訂・廃止とライフサイクル変更管理」に従い、ロール定義、メンバー定義、RACI、WBS、Schedule の影響箇所と担当 Role code を特定します。未決事項・リスク・課題・変更要求・決定は PJR または対応する管理簿へ分け、担当と転送先を記録します。
90
- - 良い例: 「兼務による承認待ちで Schedule の期限を超えた場合、管理担当が役割再配分を検討し、PO が採否を判断する。変更対象の RACI と Schedule の更新を確認する」。
83
+ - 判断基準は、目的・スコープ、関係者、参加者、作業滞留、公開・運用責任の変化から、体制変更の開始条件を判定できることです。ロール追加の前に既存責任の再配分を検討します。
84
+ - 推奨表の列は「トリガー」「確認すること」「更新先」「判断者」です。追従先はロール定義、メンバー定義、RACI、WBS、Schedule とし、採用変更の影響箇所を確認します。
85
+ - 良い例: 「兼務による承認待ちで Schedule の期限を超えたら、役割再配分を検討する。変更対象の RACI と Schedule に担当不在や使用不可ロールが残らないことを確認する」。
91
86
  - 悪い例: 「忙しくなったら体制を強化する」。開始条件、更新先、判断者が分かりません。
92
87
 
93
88
  ## 7. 禁止事項
94
89
 
95
- | 禁止事項 | 理由 |
96
- | ----------------------------------------------------------------------------------------- | -------------------------------------------------------- |
97
- | 採用・未採用 Role code と使用可能な `owner` を省略し、ロール定義への参照だけで済ませる | プロジェクト固有の採用判断と適合確認の根拠が失われるため |
98
- | 共通のロール定義、メンバー名簿、詳細な RACI を再掲する | 正本が分散するため |
99
- | 未採用・未定義の Role code を Schedule の `owner` や RACI 列に使う | 採用判断と責任語彙が不整合になるため |
100
- | member nickname、人名、agent 名を Schedule の `owner` にする | 責任語彙と実行主体を混同するため |
101
- | 兼務を理由に最終判断者を曖昧にする、または Agent に最終承認・当事者価値・公開可否を委ねる | 人間の判断責任と説明責任が不明になるため |
102
- | 必要性を示さず Role code や階層を増やす | 小規模運用の負荷を増やすため |
103
- | 個人情報、秘密情報、アクセス情報を記載する | 公開適性に反するため |
90
+ | 禁止事項 | 理由 |
91
+ | -------------------------------------------------------------------------------------- | -------------------------------------------------------- |
92
+ | 採用・未採用 Role code と使用可能な `owner` を省略し、ロール定義への参照だけで済ませる | プロジェクト固有の採用判断と適合確認の根拠が失われるため |
93
+ | 共通のロール定義、メンバー名簿、詳細な RACI を再掲する | 正本が分散するため |
94
+ | 未採用・未定義の Role code を Schedule の `owner` や RACI 列に使う | 採用判断と責任語彙が不整合になるため |
95
+ | 必要性を示さず Role code や階層を増やす | 小規模運用の負荷を増やすため |
@@ -21,94 +21,93 @@ Project Management Plan Documentation Rulebook
21
21
 
22
22
  ## 1. 全体方針
23
23
 
24
- - 管理計画は、何を管理し、どの逸脱を、誰が、どの証跡で判断するかを示します。
25
- - プロジェクト概要、スコープ、成功基準を直接の根拠とし、作業完了ではなく期待価値の検証を管理目的にします。これらの先行成果物を成果物カタログの依存関係に含め、Schedule・scaffold に展開できる状態にします。
26
- - 小規模プロジェクトでは一つの統合表を基本とし、規模・契約・監査要件がある場合だけ個別計画へ展開します。
27
- - 品質、コミュニケーション、組織、RACI、Schedule、登録簿は各正本へ委譲し、本書に一覧や詳細手順を複製しません。
28
- - 現金支出、人の作業時間、継続運用負荷を区別し、人への負荷転嫁をコスト削減とみなしません。
29
- - AI Agent は整理・更新・検証を支援できますが、優先順位、例外、公開、GO / Not GO の最終判断は人間が担います。
24
+ - 管理対象ごとに、期待価値・リスク、逸脱の基準、対応、責任、証跡を結び付けます。
25
+ - プロジェクト概要、スコープ、成功基準を直接の根拠とし、期待価値の検証を管理目的にします。
26
+ - 個別計画や管理台帳の詳細は各正本へ委譲します。
27
+ - **共通の運用**: 役割の割り当ては適用先のメンバー定義に、`status`・承認・改訂と廃止・未決事項の引き継ぎは [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] に従います。文書の整形・lint はリポジトリの検証で扱い、業務の受入確認に含めません。
30
28
 
31
29
  ## 2. 位置づけ
32
30
 
33
31
  - 本計画は横断的な管理基準と判断の接続を担い、個別計画・管理記録の更新先を示します。
34
- - Role、Member、Task owner、RACI の共通定義は [[specdojo:people-and-organization-definition-standard|人と組織の定義標準]] を正本とし、プロジェクト固有の採用判断は組織定義に従います。
35
- - 必要最小限の統合表と判断ゲートで管理する方式を軽量プロファイル、契約・監査・組織規模に応じて個別計画や詳細手順を追加する方式を拡張プロファイルとします。
32
+ - 小規模では統合表と判断ゲートによる軽量プロファイルを基本とし、契約・監査・組織規模に応じて個別計画を追加する拡張プロファイルを選びます。
36
33
 
37
34
  ## 3. ファイル命名・ID規則
38
35
 
39
36
  - 配置は `docs/ja/projects/<project-id>/030-project-management/pm-plan.md` を推奨します。
40
37
  - ID は `<project-id>:pm-plan`、ファイル名は `pm-plan.md` とします。
41
- - 共通の命名規則は [[specdojo:docs-structure-guide|ドキュメント構成ガイド]]、Role code などの識別規則は人と組織の定義標準と各 YAML の schema を参照します。
38
+ - 共通の命名規則は [[specdojo:docs-structure-guide|ドキュメント構成ガイド]] に従います。
42
39
 
43
40
  ## 4. 推奨 Frontmatter 項目
44
41
 
45
- - 共通項目・型・許容値は [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] と同標準から参照する成果物 schema に従います。`rulebook` には本書の ID を指定し、種別は本書の `deliverable_type` に合わせます。
46
- - 本系統では `based_on` を必須とし、概要、スコープ、成功基準の文書 ID を含めます。組織定義など、管理方針の直接根拠として使った先行成果物も記載します。本文のリンクだけで根拠宣言を代替しません。
47
- - カタログを利用する場合、`based_on` の参照先は `depends_on` の推移閉包に含めます。閉包外なら依存関係の整備を先行作業とし、根拠参照を省略したり閉包外の ID を追加したりして適合扱いにしません。
48
- - 置き換え時の `supersedes` と状態変更はメタ情報標準に従います。
42
+ - 共通項目・型・許容値はメタ情報標準と成果物 schema に従います。`rulebook` は本書の ID、種別は本書の `deliverable_type` に合わせます。
43
+ - `based_on` は必須とし、概要・スコープ・成功基準と、組織定義など直接根拠にした先行成果物の ID を記載します。
44
+ - カタログ利用時は参照先を `depends_on` の推移閉包に含め、不足する依存関係の整備を先行作業にします。根拠宣言の省略や閉包外の ID 追加で代替しません。
49
45
 
50
46
  ## 5. 本文要件
51
47
 
52
48
  見出し順・表・記入欄の骨組みは Frontmatter で宣言した template を正本とします。本書は次の意味要件を定めます。
53
49
 
54
- | 要件 | 必須条件 | 記載する判断・根拠 |
55
- | ------------------ | ------------------------ | ---------------------------------------------------------------------------------------------------------------------------------- |
56
- | 管理範囲の選定 | 必須 | 期待価値、対象期間、適用プロファイルと拡張条件、人間と AI Agent の判断・実行境界 |
57
- | 管理対象単位の追跡 | 必須 | 価値・リスクまたは条件 ID と、基準・上限、確認契機、逸脱時対応、責任、証跡の正本を対応付ける |
58
- | 判断の成立条件 | 必須 | 継続・公開・変更・停止などの条件、判断材料、起案者、人間の最終判断者、証跡。未達・材料不足時の扱いを含む |
59
- | 更新・報告の接続 | 必須 | 情報ごとの正本、報告契機、確認者、見直しトリガーと追従先。個別計画や台帳へ委譲する責務を識別する |
60
- | 未決の扱い | 未決事項がある場合に必須 | 未決の状態、決定時期、判断者。別の正本で追跡する場合は対象の論点・記録を参照し、決定情報を複製しない。なければ「なし」と明記できる |
50
+ | 要件 | 必須条件 | 記載する判断・根拠 |
51
+ | ------------------ | ------------------------ | ---------------------------------------------------------------------------------------------------------------------------- |
52
+ | 管理範囲の選定 | 必須 | 期待価値、対象期間、適用プロファイルと拡張条件 |
53
+ | 管理対象単位の追跡 | 必須 | 価値・リスクまたは条件 ID と、基準・上限、確認契機、逸脱時対応、責任、証跡の正本を対応付ける |
54
+ | 判断の成立条件 | 必須 | 継続・公開・変更・停止などの条件、判断材料、起案者、最終判断者、証跡。未達・材料不足時の扱いを含む |
55
+ | 更新・報告の接続 | 必須 | 情報ごとの正本、報告契機、確認者、見直しトリガーと追従先。個別計画や台帳へ委譲する責務を識別する |
56
+ | 未決の扱い | 未決事項がある場合に必須 | 論点・現状、当面の扱い、決定によって変わる管理行・ゲート。別の正本にある論点は参照し、未決事項がなければ「なし」と明記できる |
61
57
 
62
58
  ## 6. 記述ガイド
63
59
 
64
- 共通のメタ情報、役割、値・構文は上位標準と schema を参照し、ここでは計画固有の判断基準と部分例を示します。
65
-
66
60
  ### 6.1. 管理目的と適用方針
67
61
 
68
62
  - 判断基準は、管理範囲と期間を価値・スコープ・成功基準へ結び付け、管理の厚さを選んだ理由を説明できることです。
69
- - 軽量・拡張の選択と拡張条件、人間と AI Agent の判断・実行境界を簡潔に示します。
70
- - 良い例: 「初期公開から2週間の試行で SC-01 の価値を検証する。軽量運用とし、外部契約が生じた場合は個別計画を追加する。Agent は整理・検証を支援し、公開は人間の `PO` が判断する」。
71
- - 悪い例: 「一般的な PM 項目をすべて管理し、完了したら Agent が公開する」。価値、期間、管理範囲の選定理由、人間の判断境界が分かりません。
63
+ - 良い例: 「初期公開から2週間で SC-01 の価値を検証する。軽量運用とし、外部契約が生じた場合は個別計画を追加する」。
64
+ - 悪い例: 「一般的な PM 項目をすべて管理する」。価値、期間、範囲の選定理由が不明です。
72
65
 
73
66
  ### 6.2. 統合管理方針
74
67
 
75
- - 判断基準は、各行から「守る価値・回避するリスク → 基準・上限 → 確認・逸脱対応 → 責任 → 証跡」を一続きで追跡し、適合・逸脱を判定できることです。
76
- - 表の列の意味は、管理対象が追跡単位、根拠が価値・リスクの文書 ID と該当箇所または条件 ID、基準・上限が判定条件、確認契機が観測時点、逸脱時対応が次の行動、責任が担当 Role code、証跡・正本が記録先と確認する記録の識別方法です。これらを各行で保持するか、行の結合 ID から一意に辿れるようにし、文書全体への参照だけで済ませません。
77
- - スコープ、Schedule、費用・負荷、品質、課題・リスク・変更について適用を判断し、実際に管理する対象だけを行にします。費用・負荷は現金支出、準備・開発などの作業時間、日常操作・保守などの継続運用負荷を別の行または別の基準・記録で管理し、一方の削減を他方の削減とみなしません。
78
- - 構成管理は、管理対象の版・承認済み基準・変更履歴を何で識別するか、変更時に誰が確認し、どこへ記録するかを示します。技術管理は、技術制約・外部依存の変更を検知する契機、影響確認と判断を担う Role code、記録先を示します。個別方針へ委譲する場合も、この確認・対応と委譲先を行から追跡できるようにし、設計や操作手順の詳細を再掲しません。
68
+ - 判断基準は、各行から根拠・判定条件・逸脱対応・責任・証跡を一続きで追跡できることです。標準列は次のとおりとし、行の結合 ID から一意に辿れる場合は列を統合できます。文書全体への参照だけで済ませません。
69
+
70
+ | 列 | 内容 |
71
+ | ---------- | --------------------------------------------- |
72
+ | 管理対象 | 追跡単位 |
73
+ | 根拠 | 価値・リスクの文書 ID と該当箇所または条件 ID |
74
+ | 基準・上限 | 適合・逸脱の判定条件 |
75
+ | 確認契機 | 観測時点 |
76
+ | 逸脱時対応 | 次の行動 |
77
+ | 責任 | 担当 Role code |
78
+ | 証跡・正本 | 記録先と記録の識別方法 |
79
+
80
+ - スコープ、Schedule、費用・負荷、品質、課題・リスク・変更から適用対象を選びます。現金支出、準備・開発の作業時間、日常操作・保守の継続運用負荷は別の行または基準・記録で管理し、負荷転嫁を削減とみなしません。
81
+ - 構成管理は対象版・承認済み基準・変更履歴の識別方法、確認者、記録先を示します。技術管理は技術制約・外部依存の変更検知契機、影響確認・判断を担う Role code、記録先を示します。個別方針へ委譲しても行から確認・対応を追跡できるようにします。
79
82
  - 良い例: 「継続運用負荷」の根拠を成功基準文書の SC-03、基準を同条件の上限内、確認契機を試行中の営業日、超過時対応を `PM` による手順縮小案の起案、証跡を SC-03・確認日・確認者で識別する操作時間記録とします。数値・測定手順の正本は成功基準に残します。
80
83
  - 悪い例: 「参加者の時間を無理のない範囲にし、必要に応じて確認する」。準備時間と日常負荷が混ざり、根拠、判定条件、証跡を照合できません。
81
84
 
82
85
  ### 6.3. 判断ゲートとエスカレーション
83
86
 
84
- - 判断基準は、適用する条件 ID、材料、最終判断者、判定記録が結び付き、未達と材料不足を合格扱いにしないことです。公開、主要変更、例外、継続・停止など、人間の判断が必要なゲートを選びます。
87
+ - 判断基準は、条件 ID、材料、最終判断者、判定記録が結び付き、未達と材料不足を合格扱いにしないことです。
85
88
  - 成功基準・受入条件を複製せず、文書 ID と条件 ID を参照します。是正・再判定、保留・停止、例外判断を求める条件を定め、例外は上位の受入方針で認める範囲に限ります。
86
- - 良い例: 「初期受入は成功基準の正本にある SC-01 と AC-01〜AC-04 を必須とし、未達または証跡不足なら保留する。`QE` が再確認結果を整理し、人間の `PO` が受入可否を判断して条件 ID ごとの結果とともに記録する」。
89
+ - 良い例: 「初期受入は成功基準の SC-01 と AC-01〜AC-04 を必須とし、未達・証跡不足なら保留する。是正後に `QE` が再確認結果を整理し、判断ゲートの最終判断者が条件 ID ごとの結果と判定を記録する」。
87
90
  - 悪い例: 「初期成功基準を満たしたら公開し、問題があれば必要に応じて相談する」。参照条件、不足時の処理、判断者を特定できません。
88
91
 
89
92
  ### 6.4. 正本・報告・見直し
90
93
 
91
94
  - 判断基準は、情報ごとの更新先と確認者が一意に分かり、見直し時の追従作業をタスク化できることです。正本が未整備なら、整備時期・担当または省略理由と責任を確認する代替先を示します。
92
- - Schedule は作業順序・Task owner・進捗、RACI は成果物・主要判断の責任、ロール定義は責務、メンバー定義は実行主体を扱います。RACI を採用する体制では正本として明示し、Task owner だけで承認責任を代替しません。最小運用での RACI 省略条件は人と組織の定義標準に従います。
93
- - 判断・逸脱・作業節目などの報告契機と確認者を定め、品質・コミュニケーションの詳細は各計画を参照します。課題・リスク・変更要求・決定は PJR または対応する管理簿へ分け、本文に個票を持ちません。
94
- - 目的、スコープ、成功基準、体制、外部条件が変わった場合、管理担当が影響する個別計画・RACI・Schedule・証跡への参照と担当 Role code を特定し、更新順序・期限・確認担当を追従タスクにします。計画の置き換え・廃止はメタ情報標準の「文書の改訂・廃止とライフサイクル変更管理」に従います。
95
+ - Schedule と責任の正本を接続し、作業担当だけで判断責任を代替しません。RACI の採用・省略条件は [[specdojo:people-and-organization-definition-standard|人と組織の定義標準]] に従います。
96
+ - 判断・逸脱・作業節目の報告契機と確認者を定め、品質・コミュニケーションの詳細は各計画を参照します。
97
+ - 目的、スコープ、成功基準、体制、外部条件の変更時は、影響する個別計画・RACI・Schedule・証跡と担当 Role code を特定し、更新順序・期限・確認担当を追従タスクにします。
95
98
  - 良い例: 「承認担当の交代時は、`PM` が RACI・メンバー定義・Schedule の影響箇所を特定し、更新担当と期限を設定する。`QE` が判断ゲートの最終判断者との整合を確認する」。
96
99
  - 悪い例: 「担当は Schedule を参照し、変更時は関係文書を見直す」。成果物責任の正本、更新先、確認担当が不明です。
97
100
 
98
101
  ### 6.5. 未決事項
99
102
 
100
- - 判断基準は、未決の論点、決定時期、判断者を追跡でき、未決の上限や担当を確定済みとして着手・判定しないことです。現状に `_UNDECIDED_:` を付けます。
101
- - 既に他文書・管理簿で追跡している場合、本書では未決状態と参照先の論点・記録を示し、決定時期・判断者は参照先を正本にできます。期限を過ぎた事項は課題または判断事項として登録簿へ移し、担当 Role code と転送先を残します。
102
- - 良い例: 「`_UNDECIDED_:` 試行準備の作業時間上限。試行着手前に人間の `PO` が決定し、未決の間は着手を保留する」。
103
- - 悪い例: 「費用・時間上限は後で決める」。未決状態、期限、判断者、未決の間の扱いを確認できません。
103
+ - 判断基準は、未決の論点と影響を示し、未決の上限や担当を確定済みとして着手・判定しないことです。他文書に正本があれば該当論点を参照します。
104
+ - 良い例: 「`_UNDECIDED_:` 試行準備の作業時間上限。未決中は着手を保留し、決定後に費用・負荷の管理行と準備着手ゲートへ反映する」。
105
+ - 悪い例: 「費用・時間上限は後で決める」。当面の扱いと変更先が不明です。
104
106
 
105
107
  ## 7. 禁止事項
106
108
 
107
- | 禁止事項 | 理由 |
108
- | ------------------------------------------------------ | -------------------------------- |
109
- | 個別計画、RACI、Role code 一覧、登録簿の内容を再掲する | 正本が分散し、更新量が増えるため |
110
- | 管理対象を網羅目的で増やし、基準や逸脱時対応を置かない | 実行時の判断に使えないため |
111
- | 現金支出だけを費用とし、人の作業・運用負荷を除外する | 負荷転嫁を見逃すため |
112
- | 成功基準を本文へ複製する | 判定条件の正本が分散するため |
113
- | Agent に例外、公開、GO / Not GO の最終判断を委ねる | 人間の説明責任を代替するため |
114
- | 個人情報、認証情報、秘密情報、実装詳細を記載する | 公開適性と文書責務に反するため |
109
+ | 禁止事項 | 理由 |
110
+ | ------------------------------------------------------ | ---------------------------- |
111
+ | 管理対象を網羅目的で増やし、基準や逸脱時対応を置かない | 実行時の判断に使えないため |
112
+ | 現金支出だけを費用とし、人の作業・運用負荷を除外する | 負荷転嫁を見逃すため |
113
+ | 成功基準を本文へ複製する | 判定条件の正本が分散するため |