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
@@ -17,24 +17,17 @@ specdojo:
17
17
 
18
18
  Quality Management Plan Documentation Rulebook
19
19
 
20
- 利用者価値と成果物品質を、少数の品質ゲート、証跡、是正方法で管理するためのルールです。成功基準、rulebook、検証手順を再掲せず、いつ何を確認するかを定義します。
20
+ 利用者価値と成果物品質を、少数の品質ゲート、証跡、是正方法で管理するためのルールです。
21
21
 
22
22
  ## 1. 全体方針
23
23
 
24
24
  - 品質は、利用者価値の成立と、それを支える成果物・技術条件の両方で判定します。
25
25
  - 小規模プロジェクトでは、代表試行、主要レビュー、公開前確認など必要なゲートだけを置きます。
26
+ - **共通の運用**: 役割の割り当ては適用先のメンバー定義に、`status`・承認・改訂と廃止・未決事項の引き継ぎは [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] に従います。文書の整形・lint・見出し・wikilink の検査はリポジトリの検証で扱い、業務の受入条件に含めません。
26
27
 
27
- ## 2. 位置づけと用語定義
28
+ ## 2. 位置づけ
28
29
 
29
- - 本計画は、管理計画の品質方針を判定時点・責任・証跡・是正へ具体化し、レビューと後続作業の計画に用います。
30
- - Role、Member、RACI の定義と委任方針は [[specdojo:people-and-organization-definition-standard|人と組織の定義標準]] を正本とします。
31
-
32
- | 用語 | 定義 |
33
- | ---------- | -------------------------------------------------------------- |
34
- | 品質ゲート | 所定の時点で、条件・証跡・判断者をそろえて合否を確認する仕組み |
35
- | 価値品質 | 利用者・業務・社会に期待する変化が成立したかを示す品質 |
36
- | 成果物品質 | 構造、整合、検証、公開適性など価値提供を支える品質 |
37
- | 不適合 | 品質ゲートの合格条件を満たさない状態 |
30
+ 本計画は、管理計画の品質方針を判定時点・責任・証跡・是正へ具体化し、レビューと後続作業の計画に用います。
38
31
 
39
32
  ## 3. ファイル命名・ID規則
40
33
 
@@ -46,76 +39,72 @@ Quality Management Plan Documentation Rulebook
46
39
 
47
40
  - 共通項目・型・許容値は [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] と同標準から参照する成果物 schema に従います。`rulebook` は本書の ID、種別は本書の `deliverable_type` に合わせます。
48
41
  - `based_on` には、管理計画など作成時に直接根拠とした先行成果物を記載します。カタログを利用する場合は `depends_on` の推移閉包内に限り、閉包外の根拠が必要なら依存関係の整備を先行させます。
49
- - 置き換え時の `supersedes` と状態変更はメタ情報標準に従います。
50
42
 
51
43
  ## 5. 本文要件
52
44
 
53
45
  見出し順・表・記入欄の骨組みは Frontmatter で宣言した template を正本とし、本書では各章が満たす意味要件を定めます。
54
46
 
55
- | 要件 | 必須条件 | 記載する判断・根拠 |
56
- | ------------------------------ | ------------------------ | ------------------------------------------------------------------------------ |
57
- | 品質方針と適用範囲 | 必須 | 価値品質と成果物品質、適用開始・終了、人間と AI Agent の判断境界 |
58
- | 品質ゲート | 必須 | ゲートごとの品質観点、条件 ID、確認方法と証跡、時期、確認・承認責任 |
59
- | レビューと証跡 | 必須 | 対象、主要観点、実施責任、合否を判定できる出口条件、証跡、記録先 |
60
- | 不適合と是正 | 必須 | 区分ごとの対応、再判定条件、再判定責任、記録先、重大不適合の通過制限 |
61
- | 見直し条件と未決事項(見直し) | 必須 | 見直し契機、影響する正本・後続作業、追従更新の責任 |
62
- | 見直し条件と未決事項(未決) | 未決事項がある場合に必須 | 未決論点、決定時期、判断者、決定まで保留する判定。なければ「なし」と明記できる |
47
+ | 要件 | 必須条件 | 記載する判断・根拠 |
48
+ | ------------------------------ | ------------------------ | -------------------------------------------------------------------- |
49
+ | 品質方針と適用範囲 | 必須 | 価値品質と成果物品質、対象範囲、適用開始・終了 |
50
+ | 品質ゲート | 必須 | ゲートごとの品質観点、条件 ID、確認方法と証跡、時期、確認・承認責任 |
51
+ | レビューと証跡 | 必須 | 対象、主要観点、実施責任、合否を判定できる出口条件、証跡、記録先 |
52
+ | 不適合と是正 | 必須 | 区分ごとの対応、再判定条件、再判定責任、記録先、重大不適合の通過制限 |
53
+ | 見直し条件と未決事項(見直し) | 必須 | 見直し契機、影響する正本・後続作業 |
54
+ | 見直し条件と未決事項(未決) | 未決事項がある場合に必須 | 未決論点と影響、未決中に保留する判定。なければ「なし」と明記できる |
63
55
 
64
56
  ## 6. 記述ガイド
65
57
 
66
- 共通のメタ情報・役割・値・構文は上位標準と schema を参照し、ここでは品質計画固有の判断基準と部分例を示します。責任を表す項目は、組織・ロール定義で採用された Role code を用い、RACI がある場合は該当する作業・判断の責任と整合させます。実行主体や兼務はメンバー定義へ委譲します。以下の Role code は例であり、未採用ロールの追加を要求しません。
58
+ 品質計画固有の判断基準と部分例を示します。
67
59
 
68
60
  ### 6.1. 品質方針と適用範囲
69
61
 
70
- - 判断基準は、利用者価値とそれを支える成果物品質、対象範囲・期間、判断主体を識別できることです。成功基準を根拠とし、技術検証だけで価値を判定しません。
62
+ - 判断基準は、利用者価値とそれを支える成果物品質、対象範囲・期間を識別できることです。成功基準を根拠とし、技術検証だけで価値を判定しません。
71
63
  - 適用開始・終了は日付または識別可能なイベントで示します。公開後の観測を含む場合は終了までの関係を示し、未確定の終了日は終了条件と見直し契機で代替できます。
72
- - AI Agent が支援する確認作業と、人間が担う価値・例外・公開可否の最終判断を明記します。上位計画へ委譲する場合も、該当する判断と参照先を特定します。
73
- - 良い例: 「代表試行開始から公開後価値ゲートの判定完了まで適用する。利用継続と負担を価値品質、再現性を成果物品質として確認する。AI Agent は検証記録を整理し、人間の `PO` が利用価値と公開可否を判断する」。
74
- - 悪い例: 「開発中の品質を高め、AI Agent が問題なしと判定する」。期間の境界と人間の判断責任を確認できません。
64
+ - 良い例: 「代表試行開始から公開後価値ゲートの判定完了まで適用する。利用継続と負担を価値品質、再現性を成果物品質として確認する」。
65
+ - 悪い例: 「開発中の品質を高める」。価値品質と期間の境界を確認できません。
75
66
 
76
67
  ### 6.2. 品質ゲート
77
68
 
78
69
  - 判断基準は、各ゲートから条件の正本、確認方法、証跡、時期、確認者と承認者を辿り、合否または保留を決められることです。初期受入と公開後の継続判断は適用時点を分けます。
79
- - 合格条件は文書 ID と条件 ID で参照します。数値を使う場合、算出方法・閾値・計測頻度を正本の該当箇所から確認できるようにします。未定義なら担当と決定期限を未決事項に置き、判定前に解消します。
80
- - 確認者は証跡に基づく品質確認、承認者は当該判断の承認を担います。品質確認と公開可否を分け、RACI の異なる判断を一つの承認責任で代替しません。
70
+ - 合格条件は文書 ID と条件 ID で参照し、算出方法・閾値・計測頻度を正本から確認できるようにします。条件を満たさなければ未達、証跡不足・条件未定義なら保留とし、いずれも通過させません。
71
+ - 「確認者 / 承認者」は証跡に基づく品質確認と当該ゲートの判断を区別して示します。
81
72
  - 費用・負荷を扱う場合は、現金支出、作業時間、継続運用負荷を別の基準・記録で確認します。
82
- - 良い例: 「初期受入は成功基準の SC-01・AC-01 に基づき試行終了時に判定する。`QE` が試行記録を確認し、人間の `PO` が受入を判断する。未達または証跡不足なら保留する」。数値や検証コマンドは正本に残します。
83
- - 悪い例: 「lint が通れば公開し、利用者の評価は後で確認する」。価値の合否と公開判断の根拠が欠けています。
73
+ - 良い例: 「初期受入は SC-01・AC-01 に基づき試行終了時に判定する。確認者が試行記録を条件別に照合し、全条件の合格で通過する」。
74
+ - 悪い例: 「lint が通れば受入とし、利用者の評価は後で確認する」。価値の合否を判定できません。
84
75
 
85
76
  ### 6.3. レビューと証跡
86
77
 
87
78
  - 判断基準は、対象版について誰が何を確認し、どの状態なら通過でき、どこに結果が残るかを再現できることです。レビュー種別は対象と対応が異なるものに絞ります。
88
79
  - 列名は「対象」「実施責任」に統一します。「出口条件」は合否を分ける状態、「証跡」は判定を裏付ける記録、「記録先」はその記録へ到達する文書 ID またはパスです。三者を独立した列で必須とし、証跡名だけで出口条件を代替しません。
89
80
  - 証跡には対象版、実施日、結果、未達条件・指摘と是正・再判定結果を追跡できる情報を残します。生成物の是正は生成元の正本を修正し、再生成して確認します。
90
- - 良い例: 「公開対象の差分を `QE` が確認する。出口条件は公開に関する重大指摘が未解消で残っていないこと、証跡は対象版と指摘別結果を持つ公開前レビュー記録、記録先は `execution/reviews/release-1/result.md` とする」。パスは例示であり、実際の保存先を指定します。
81
+ - 良い例: 「試行結果を確認者が照合する。出口条件は AC-01 の合格、証跡は対象版と条件別結果を持つ試行記録、記録先は `execution/reviews/trial-1/result.md` とする」。パスは例示であり、実際の保存先を指定します。
91
82
  - 悪い例: 「実施者: 関係者、出口条件・証跡: レビュー結果」。責任、通過条件、記録先を特定できません。
92
83
 
93
84
  ### 6.4. 不適合と是正
94
85
 
95
86
  - 判断基準は、不適合から是正、再判定、結果記録までを追跡できることです。軽微、価値、構造・検証、公開など対応差がある区分だけを置きます。
96
- - 「再判定条件」と「再判定責任」を独立した列に分けます。前者は是正後に再確認する条件 ID・ゲートと確認を再開する契機、後者は再確認を担う Role code です。公開・例外の承認が別に必要なら、その判断責任も区別します。
97
- - 計画ごとに、必須の価値・受入条件、検証の成立、公開安全性への影響から重大性の判定境界を示します。重大な不適合は担当 Role が PM(未採用なら管理責務を代替する採用 Role)へ報告し、管理担当が課題または変更要求へ登録します。是正完了または承認済み基準が認める期限付き例外の判断まで該当ゲートを通過させません。例外には理由、期限、人間の承認者、再判定条件を記録します。
98
- - 将来の品質上の懸念は、管理担当がリスク登録簿へ担当 Role・兆候・対策を付けて記録し、顕在化したら元の記録を参照して課題へ移します。
99
- - 記録先はレビュー記録・検証結果・登録簿の文書 ID またはパスで特定し、目的・スコープ・成功基準に影響する是正は変更要求と決定記録へ接続します。
87
+ - 「再判定条件」と「再判定責任」を独立した列に分けます。前者は是正後に再確認する条件 ID・ゲートと確認を再開する契機、後者は再確認を担う Role code です。
88
+ - 必須の価値・受入条件、検証の成立、公開安全性への影響から重大性の判定境界を示します。重大な不適合は是正完了、または管理計画が認める期限付き例外の成立まで該当ゲートを通過させません。例外には対象条件、理由、期限、再判定条件を残します。
89
+ - 記録先はレビュー記録・検証結果・登録簿の文書 ID またはパスで特定し、条件変更を伴う是正は変更要求・決定記録へ接続します。
100
90
  - 良い例: 「技術不適合は生成元を修正する。再判定条件は再生成後に未達の AC-02 と影響範囲の検証が成功すること、再判定責任は `QE` とし、対象版・結果を課題個票から辿れる検証記録に残す」。
101
91
  - 悪い例: 「対応: 修正、再判定: `QE`、記録先: 課題」。条件・確認契機と到達先が不明です。
102
92
 
103
93
  ### 6.5. 見直し条件と未決事項
104
94
 
105
- - 判断基準は、計画を見直す契機と追従責任が明確で、未決事項を確定済みとして合格扱いしないことです。成功基準、公開範囲、成果物構造、検証方法、体制、重大不適合の傾向の変化を確認します。
106
- - 未決事項は `_UNDECIDED_:` とし、決定時期、判断者、未決の間は保留するゲートを添えます。他の正本で管理する論点は該当記録を参照し、品質課題の個票は登録簿やレビュー記録へ委譲します。
107
- - 計画の改訂・置き換え・廃止はメタ情報標準の「文書の改訂・廃止とライフサイクル変更管理」に従います。`PM` または兼務する採用ロールが管理計画・RACI・Schedule・証跡参照の追従先と担当 Role code・期限を整理し、`QE` または品質確認を担う採用ロールが判定条件への影響を確認します。
108
- - 良い例: 「`_UNDECIDED_:` 試行記録の形式は試行開始前に `QE` が提案し、人間の `PO` が決定する。未決の間は代表試行ゲートを保留する。決定で確認工数が変われば `PM` が Schedule を更新する」。
109
- - 悪い例: 「手順は後で決め、変更時は見直す」。期限、判断者、ゲートと後続作業への影響を確認できません。
95
+ - 判断基準は、見直しの契機と判定条件への影響を追えることです。成功基準、公開範囲、成果物構造、検証方法、体制、重大不適合の傾向の変化を確認します。
96
+ - 追従対象は管理計画・RACI・Schedule・証跡参照とし、影響する条件 ID・証跡・再確認範囲を特定します。
97
+ - 未決事項は「論点」「影響・未決中に保留する判定」を示し、決定時に直す条件・証跡を特定します。
98
+ - 良い例: 「`_UNDECIDED_:` 試行記録の形式。未決の間は代表試行ゲートを保留する。決定後は証跡参照を更新し、確認工数が変われば Schedule に反映する」。
99
+ - 悪い例: 「手順は後で決め、変更時は見直す」。ゲートと後続作業への影響を確認できません。
110
100
 
111
101
  ## 7. 禁止事項
112
102
 
113
- | 禁止事項 | 理由 |
114
- | ---------------------------------------------------------- | ---------------------------------- |
115
- | 成功基準、rulebook、schema、検証手順の詳細を本文へ複製する | 判定条件の正本が分散するため |
116
- | 品質目標、メトリクス、検査基準へ同じ条件を重複記載する | 更新量と不整合が増えるため |
117
- | 技術検証だけで利用者価値の品質を代替する | プロジェクト成功を判定できないため |
118
- | 現金支出だけを確認し、人の負荷を除外する | 負荷転嫁を見逃すため |
119
- | 生成物を直接修正して不適合を解消する | 再生成時に修正が失われるため |
120
- | 証跡名や Role code だけで出口条件・再判定条件を代替する | 合否と責任を別々に確認できないため |
121
- | AI Agent に価値、例外、公開可否の最終判断を委ねる | 人間の判断責任を代替するため |
103
+ | 禁止事項 | 理由 |
104
+ | ------------------------------------------------------- | ---------------------------------- |
105
+ | 成功基準の閾値・算出方法を品質ゲートで再定義する | 判定条件の正本が分散するため |
106
+ | 品質目標、メトリクス、検査基準へ同じ条件を重複記載する | 更新量と不整合が増えるため |
107
+ | 技術検証だけで利用者価値の品質を代替する | プロジェクト成功を判定できないため |
108
+ | 現金支出だけを確認し、人の負荷を除外する | 負荷転嫁を見逃すため |
109
+ | 生成物を直接修正して不適合を解消する | 再生成時に修正が失われるため |
110
+ | 証跡名や Role code だけで出口条件・再判定条件を代替する | 合否と責任を別々に確認できないため |
@@ -16,77 +16,75 @@ specdojo:
16
16
 
17
17
  RACI Documentation Rulebook
18
18
 
19
- 主要成果物と主要判断の責任境界を、最小限のマトリクスで示すためのルールです。責任衝突や判断停滞を防ぎ、作業の計画化と担当の照合に使える粒度へ絞ります。
19
+ 成果物・判断の責任境界を示し、責任衝突・判断停滞を防ぐ基準です。
20
20
 
21
21
  ## 1. 全体方針
22
22
 
23
- - 標準運用以上で、作成・判断・相談・共有の責任境界が必要な対象に適用します。最小運用で作成を省略できる条件は、[[specdojo:people-and-organization-definition-standard|人と組織の定義標準]] の「ファイル別の責務」に従います。
24
- - 全成果物を列挙せず、主要成果物、価値判断、変更、品質例外、公開など責任衝突があり得る対象を選びます。
25
- - 業務・技術・品質の各観点で、対象範囲内の作業責任、最終判断、必要な相談先を確認できることを網羅条件とします。該当しない観点は省略理由を記載し、確認のためだけに行や未採用 Role を増やしません。
26
- - 共通の用語・担当展開規則は上位標準を正本とし、本書では RACI 固有の判断基準を定めます。実装・schema・リファレンスが定める値・構文・構造は再掲しません。
23
+ - 標準運用以上の責任境界を扱います。最小運用での省略条件は、[[specdojo:people-and-organization-definition-standard|人と組織の定義標準]] の「ファイル別の責務」に従います。
24
+ - 全成果物を列挙せず、主要成果物、価値、変更、品質例外、公開など責任衝突があり得る対象を選びます。
25
+ - 業務・技術・品質の作業責任、最終判断、必要な相談先を確認できることを網羅条件とします。該当しない観点は省略理由を示し、確認のためだけに行や未採用 Role を増やしません。
26
+ - **共通の運用**: 役割の割り当ては適用先のメンバー定義、`status` の昇格と承認、改訂と廃止、未決事項の登録簿への引き継ぎは [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] に従います。文書の整形・lint はリポジトリの検証で扱い、業務の受入条件に含めません。
27
27
 
28
28
  ## 2. 位置づけと用語定義
29
29
 
30
- `R` / `A` / `C` / `I`、Role、Member、Task owner の意味は、[[specdojo:people-and-organization-definition-standard|人と組織の定義標準]] に従います。主担当とは、対象作業を主導する一つの `R` の Role code です。行に複数の `R` がある場合の識別方法は「Schedule・実行主体との対応」で定めます。
30
+ 記号・用語は [[specdojo:people-and-organization-definition-standard|人と組織の定義標準]] に従います。
31
31
 
32
- 採用 Role は組織定義、Role code と責務はロール定義、実行主体・兼務はメンバー定義を正本とします。RACI は責任配置、Schedule は個別タスクの `owner` を管理し、人物・Agent の一覧や成果物カタログを複製しません。
32
+ 採用 Role は組織定義、Role code と責務はロール定義を正本とします。RACI は責任配置、Schedule は個別タスクの `owner` を管理します。
33
33
 
34
34
  ## 3. ファイル命名・ID規則
35
35
 
36
36
  - 配置は `docs/ja/projects/<project-id>/030-project-management/pm-raci.md` を推奨します。
37
37
  - ID は `<project-id>:pm-raci`、ファイル名は `pm-raci.md` とします。
38
- - 行の対象は成果物 ID または判断・プロセス名で特定します。複数成果物をまとめる場合も、各成果物から対象行を一意に照合できる名称または参照を残します。
38
+ - 行は成果物 ID または判断・プロセス名で特定し、統合した行も各成果物から一意に照合できるようにします。
39
39
 
40
40
  ## 4. 推奨 Frontmatter 項目
41
41
 
42
- 共通項目の必須性・値・構造は、[[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] と成果物 Frontmatter schema に従います。`rulebook` には本書の ID を指定し、`based_on` を使う場合は、成果物の依存関係に含まれる組織定義など実際の根拠を指定します。
42
+ 共通項目は [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] と成果物 Frontmatter schema に従います。`rulebook` は本書の ID、`based_on` を使う場合は依存関係に含まれる組織定義など実際の根拠を指定します。
43
43
 
44
44
  ## 5. 本文要件
45
45
 
46
- 見出し順・表・記入欄の骨組みは Frontmatter で宣言した template を正本とします。以下は内容の必須要件であり、完成例は sample で扱います。
46
+ 骨組みは宣言した template、完成例は sample を正本とし、次を必須とします。
47
47
 
48
- - 対象範囲、省略範囲と理由、採用 Role の参照、兼務・Agent 支援の扱いを必須とし、責任の確認範囲を判断できるようにします。記号の説明は上位標準への参照とプロジェクト固有の補足で足ります。
49
- - 成果物の責任配置と判断・プロセスの責任配置を二表で示すことを必須とします。同じ責任境界の行は統合でき、各行には一つの `A` と一つ以上の `R` を置きます。`A/R` の兼任は可とし、`C` / `I` は相談・共有が必要な場合に記載します。
50
- - 個別タスクの担当を照合するため、主担当の識別、Schedule と割り当て先の正本への参照、不一致時の更新先を必須とします。
51
- - 継続して責任を保つため、見直しのトリガーと確認対象を必須とします。未決事項・リスク・変更要求の詳細や状態は管理記録へ分離します。
48
+ - 責任の確認範囲: 対象範囲、省略範囲と理由、採用 Role の参照、兼務・Agent 支援の扱い。
49
+ - 責任配置: 成果物別と判断・プロセス別の二表。各行は一つの `A` と一つ以上の `R` を持ち、`A/R` の兼任は可、`C` / `I` は必要時に記載します。
50
+ - 担当照合: 主担当の識別、Schedule と割り当て先の正本への参照、不一致時の更新先。
51
+ - 責任の継続: 見直しのトリガーと確認対象。
52
52
 
53
53
  ## 6. 記述ガイド
54
54
 
55
55
  ### 6.1. 適用方針
56
56
 
57
- - 判断基準: 初期スコープと組織定義に照らし、業務上の確認・合意、技術上の実現・変更、品質の検証・判定をどの行で扱うか確認します。列は採用済み Role code から必要なものを選び、採用済みでも省く列には理由を示します。
58
- - 雛形などの `_ROLE_CODE_` は列の例であり、採用 Role に置換して必要数に増減します。固定の Role 一式を必須列として読み替えません。
57
+ - 判断基準: 初期スコープと組織定義から、業務の合意、技術の実現・変更、品質の検証・判定を扱う行を確認します。列は必要な採用 Role code とし、省く列は理由を示します。
58
+ - 雛形の `_ROLE_CODE_` は採用 Role に置換して増減する例であり、固定の必須列ではありません。
59
59
  - 良い例: 「初期公開を対象とし、業務合意・実装・品質判定を扱う。次期拡張は対象外」と限定し、組織定義を参照する。
60
60
  - 悪い例: 「全作業を対象」とだけ書き、未採用 Role を含む列をそのまま使う。
61
61
 
62
62
  ### 6.2. 成果物別 RACI
63
63
 
64
- - 判断基準: 初期スコープの主要成果物、管理計画、公開対象を、作成・最終判断の責任が同じ単位でまとめます。主担当や `A` が異なる成果物は分け、生成ビューは正本と責任が同じなら独立行にしません。
64
+ - 判断基準: 主要成果物、管理計画、公開対象を責任が同じ単位でまとめます。主担当や `A` が異なる成果物は分け、正本と同じ責任の生成ビューは独立行にしません。
65
65
  - 相談・共有の関与がないセルは空欄または `—` とし、表内で統一します。
66
66
  - 良い例: 同じ責任配置の管理文書を対象 ID でまとめ、技術担当が主導する設計文書は別行にする。
67
67
  - 悪い例: カタログ全体を転記する、または担当の異なる戦略文書まで一括して管理担当の `R` に含める。
68
68
 
69
69
  ### 6.3. 判断・プロセス別 RACI
70
70
 
71
- - 判断基準: 当事者価値、費用・負荷、変更、品質例外、公開など、最終判断者が異なる対象を分けます。成果物行とプロセス行が重なる場合は、各 `A` が判断する範囲を明記します。必要な業務確認者・技術相談先・品質確認者は採用 Role を介して追跡できるようにします。
71
+ - 判断基準: 当事者価値、費用・負荷、変更、品質例外、公開など最終判断者が異なる対象を分けます。成果物行と重なる場合は各 `A` の判断範囲を明記し、業務・技術・品質の確認者・相談先を採用 Role から追跡可能にします。
72
72
  - 良い例: 「作成フローの運営」の `A` は順序・進捗を判断し、内容の承認は各成果物行の `A` が行うと区別する。
73
- - 悪い例: 「成果物作成」の `A` が成果物ごとの内容の承認まで行うように読める、または品質例外と公開判断を担当の確認なしに一行へまとめる。
73
+ - 悪い例: 「成果物作成」の `A` が各成果物の内容も承認すると読める、または品質例外と公開判断を担当の確認なしにまとめる。
74
74
 
75
75
  ### 6.4. Schedule・実行主体との対応
76
76
 
77
- - `R` が一つならその Role を主担当とし、`A/R` も `R` として扱います。
78
- - 複数 `R` の行は、行に付随する注記で対象作業ごとに一つの主担当 Role code と担当範囲を明記します。
79
- - 主担当は Schedule タスクの action フィールドが表す作業に最も近い `R` とし、一意に決められない場合は責任境界を確認してタスクを分割します。
80
- - Schedule の `owner` の優先順と例外は、[[specdojo:people-and-organization-definition-standard|人と組織の定義標準]] の「Schedule への担当展開」に従います。照合時は WBS の明示 `owner` を先に確認し、作成作業の主担当と、承認・レビュー・外部待ちの別 Task / Milestone を区別します。後者では対象に応じた `A` / `C` を許容し、全タスクを `R` へ一律に合わせません。
81
- - 対応する WBS・Schedule または生成元の戦略・設定と、実行主体を割り当てる正本を文書 ID で参照します。不一致は上位標準と対象作業から原因を判断し、RACI の責任配置かタスク定義の正本か、修正先を明記します。生成ビューは直接更新しません。
77
+ - 主担当は対象作業を主導する一つの `R`(`A/R` を含む)です。複数 `R` の行には、作業ごとの主担当 Role code と担当範囲を注記します。
78
+ - 主担当はタスクの action に最も近い `R` とし、一意に決まらなければ責任境界を確認してタスクを分割します。
79
+ - 担当照合は [[specdojo:people-and-organization-definition-standard|人と組織の定義標準]] の「Schedule への担当展開」に従います。WBS の明示 `owner` を先に確認し、作成作業と、`A` / `C` を許容する承認・レビュー・外部待ちの別 Task / Milestone を区別します。
80
+ - WBS・Schedule の正本(生成する場合は戦略・設定)と割り当て先を文書 ID で参照します。不一致の原因から、RACI の責任配置かタスク定義の正本か、修正先を明記します。
82
81
  - 良い例: 複数 `R` の行に「要件整理は業務担当、構成設計は技術担当」と採用 Role code で注記し、承認タスクは対応する `A` と照合する。
83
82
  - 悪い例: 複数 `R` の主担当を注記せず、Schedule に現在入っている `owner` を理由に後付けで選ぶ。
84
83
 
85
84
  ### 6.5. 見直し条件
86
85
 
87
- - 判断基準: スコープ、採用 Role、主要成果物の統合・分割・廃止、判断ゲート、Schedule の担当、兼務の継続可能性の変化をトリガーとし、影響する行・参照・担当を特定します。
88
- - 改訂・廃止は [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] の「文書の改訂・廃止とライフサイクル変更管理」に従います。PM 責務を担う採用 Role は、RACI と組織・ロール・メンバー定義、WBS・Schedule、コミュニケーション計画への波及を確認し、更新タスクと担当を管理します。
89
- - 良い例: 品質判定の滞留を契機に、相談先とエスカレーションを見直し、課題・リスク・変更要求・決定は種別に応じたプロジェクト登録簿(PJR)等の管理記録へ担当 Role と参照を付けて引き継ぐ。
86
+ - 判断基準: スコープ、採用 Role、主要成果物の統合・分割・廃止、判断ゲート、Schedule の担当、兼務の継続可能性の変化から、影響する行・参照・担当を特定します。組織・ロール・メンバー定義、WBS・Schedule、コミュニケーション計画との整合を確認します。
87
+ - 良い例: 品質判定の滞留時に、判断待ちの責任境界と影響タスク、当面の扱いを示し、相談先とエスカレーションを見直す。
90
88
  - 悪い例: 「必要時に見直す」とだけ書く、または判断履歴や課題の状態を RACI の行へ蓄積する。
91
89
 
92
90
  ## 7. 禁止事項
@@ -94,9 +92,7 @@ RACI Documentation Rulebook
94
92
  | 禁止事項 | 理由 |
95
93
  | ----------------------------------------------------- | -------------------------------------- |
96
94
  | 成果物カタログ全体や生成ビューを機械的に列挙する | 保守量が増え、主要責任が埋もれる |
97
- | 未採用 Role、Member、人名、Agent 名を列に使う | 正本と責任語彙が一致しないため |
98
95
  | `A` の欠落・複数配置、`R` の欠落を許す | 最終責任または作業責任が不明になるため |
99
96
  | 複数 `R` の担当範囲と主担当を識別不能なままにする | 個別タスクの担当を照合できないため |
100
- | Agent に `A` を割り当てる | 人間の説明責任を代替するため |
101
97
  | WBS の優先順やタスク種別を無視して `owner` を変更する | 上位標準と責任配置の対応が失われるため |
102
98
  | 兼務を理由に責任境界を統合する | 判断と作業の区別が失われるため |
@@ -12,34 +12,27 @@ specdojo:
12
12
 
13
13
  Risk Register Documentation Rules
14
14
 
15
- 本ドキュメントは、`リスク登録簿` を一貫した粒度で作成するためのルールを定義する。
15
+ 顕在化前のリスクを評価・対応・監視し、納期や品質への影響を事前に抑えるためのリスク登録簿の記述基準を定める。
16
16
 
17
17
  ## 1. 全体方針
18
18
 
19
- - 識別済みリスクの評価、対応、監視を追跡可能に管理する。
20
- - リスクごとに発生確率、影響度、優先度、対応策、責任者を明記する。
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: risk` の個票に書き、`controls/generated/pm-risk-register.md` は `register build` が個票から生成する。生成物の Frontmatter は `rulebook: specdojo:pjr-rulebook` とし、直接編集しない([[specdojo:pjr-rulebook|プロジェクト登録簿 作成ルール]] に従う)。
25
+ - 本書の判断基準は、個票と、登録簿を使わない単独のリスク登録簿の両方に適用する。
26
+ - リスクが顕在化したら `pm-issue-log` 側の課題として、スコープや計画の変更が要るなら `pm-change-request-log` 側の変更要求として起票し、関連ドキュメントで結ぶ。
28
27
 
29
28
  ## 3. ファイル命名・ID規則
30
29
 
31
- - `id` は `<project-id>:pm-risk-register` を使用する。
32
- - ファイル名は `pm-risk-register-リスク登録簿.md` など一意にする。
30
+ - `id` は `<project-id>:pm-risk-register`、ファイル名は `pm-risk-register.md` とする。
31
+ - リスク ID は登録簿では `PJR-XXXX`、単独の登録簿では `RK-NNN` とし、再利用しない。
33
32
 
34
33
  ## 4. 推奨 Frontmatter 項目
35
34
 
36
- | 項目 | 説明 | 必須 |
37
- | ---------- | -------------------------------- | ---- |
38
- | id | `<project-id>:pm-risk-register` | ○ |
39
- | type | `project` 固定 | ○ |
40
- | status | `draft` / `ready` / `deprecated` | ○ |
41
- | based_on | 根拠仕様ID(配列) | 任意 |
42
- | supersedes | 置換関係ID(配列) | 任意 |
35
+ - 許可キーと型は [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] を正本とし、`type` は `project` とする。
43
36
 
44
37
  ## 5. 本文構成(標準テンプレ)
45
38
 
@@ -56,39 +49,39 @@ Risk Register Documentation Rules
56
49
 
57
50
  ### 6.1. 概要
58
51
 
59
- - 管理対象、見直し頻度、責任者を 1〜3 行で示す。
52
+ - 管理対象、見直し頻度、記録単位を 1〜3 行で示す。
60
53
 
61
54
  ### 6.2. リスク登録簿一覧
62
55
 
63
- - リスクID、内容、発生確率、影響度、優先度、対応策、担当、ステータスを一覧化する。
64
-
65
- 推奨フォーマット(表):
66
-
67
- | リスクID | 内容 | 発生確率 | 影響度 | 優先度 | 対応策 | 担当 | ステータス |
68
- | -------- | ---- | -------- | ------ | ------ | ------ | ---- | ---------- |
56
+ - リスクID、内容、発生確率、影響度、優先度、対応策、担当、ステータスを一覧にする。
57
+ - 優先度とステータスは登録簿の `priority`・`item_status` の値を使い、言い換えない。
69
58
 
70
59
  ### 6.3. 評価基準
71
60
 
72
- - 評価スケール、優先度算定ルール、再評価条件を記載する。
61
+ - 発生確率と影響度の段階ごとの判定条件と、その組み合わせから優先度を決める対応表を書く。
62
+ - 再評価の条件と、評価を変える判断をする者を書く。
73
63
 
74
64
  ### 6.4. 対応計画
75
65
 
76
- - 回避、低減、受容、移転の方針と具体対応を記載する。
66
+ - 回避・低減・受容・移転のどれを採るかと、具体の対応、期限、完了条件を書く。完了条件は確認の手段と合格の基準で書く。
67
+ - 受容する場合は、受容を判断した者と、許容する残存影響を書く。
77
68
 
78
69
  ### 6.5. モニタリング
79
70
 
80
- - 監視周期、トリガー、状態更新ルールを記載する。
71
+ - 監視周期、顕在化を判定するトリガー、状態を更新する契機を書く。
72
+ - 見直しが行われなかったときの連絡先を書く。
81
73
 
82
74
  ### 6.6. 関連ドキュメント
83
75
 
84
- - `pm-issue-log`、`pm-change-request-log` への導線を記載する。
85
- - 関連がない場合でも `(本書のみ)` を明記する。
76
+ - 根拠、影響を受ける成果物、リスクから起票した課題・変更要求を文書 ID で示す。なければ `(本書のみ)` と書く。
86
77
 
87
78
  ## 7. 禁止事項
88
79
 
89
- | 禁止事項 | 理由 |
90
- | ------------------------------ | ---------------------- |
91
- | リスクIDなしで記録する | 追跡不能になるため |
92
- | 評価基準なしで優先度を決める | 判断が恣意的になるため |
93
- | 対応責任者を未記載にする | 対応遅延が発生するため |
94
- | モニタリング周期を未定義にする | 兆候を見落とすため |
80
+ | 禁止事項 | 理由 |
81
+ | -------------------------------------------- | -------------------------------- |
82
+ | リスクIDなしで記録する | 追跡不能になるため |
83
+ | 評価基準なしで優先度を決める | 判断が恣意的になるため |
84
+ | 対応責任者を未記載にする | 対応遅延が発生するため |
85
+ | モニタリング周期を未定義にする | 兆候を見落とすため |
86
+ | 顕在化したリスクを課題として起票せず放置する | 対応が課題ログで追跡されないため |
87
+ | 生成された `pm-risk-register.md` を直す | 再生成で修正が失われるため |
@@ -16,66 +16,63 @@ specdojo:
16
16
 
17
17
  Project Role Definition Documentation Rulebook
18
18
 
19
- `pm-roles.yaml` に、組織定義で採用した Role code を機械可読な一覧として記録するためのルールです。Schedule、RACI、メンバー定義が同じ責務語彙を参照でき、PO がプロジェクト固有の扱いを承認できる内容にします。
19
+ `pm-roles.yaml` に、組織定義で採用した Role code を機械可読な一覧として記録し、Schedule、RACI、メンバー定義を同じ責務語彙で接続するためのルールです。
20
20
 
21
21
  ## 1. 全体方針
22
22
 
23
- - 専任者の配置と Role code の採用を分けます。専任 Member がいなくても、責務語彙として使うロールは一覧に残します。
23
+ - 専任者の有無と Role code の採用を分け、責務語彙として必要なロールは一覧に残します。
24
24
  - 共通の責務や規模別の採用パターンは上位標準を参照し、プロジェクト固有の扱いだけを短く補足します。
25
+ - **共通の運用**: 役割の割り当ては適用先のメンバー定義に、`status`・承認・改訂と廃止・未決事項の引き継ぎは [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] に従います。文書の整形・lint はリポジトリの検証で扱い、業務の受入確認に含めません。
25
26
 
26
27
  ## 2. 位置づけ
27
28
 
28
- 共通用語と標準ロールの定義は [[specdojo:people-and-organization-definition-standard|人と組織の定義標準]] を正本とします。情報の更新先は次のように分けます。
29
+ 共通用語と標準ロールは [[specdojo:people-and-organization-definition-standard|人と組織の定義標準]] を正本とします。
29
30
 
30
- | 管理先 | 担う情報・接続 |
31
- | -------------------------------------------------- | --------------------------------------------------------------------------------------- |
32
- | `pm-organization.md` | 採用・未採用 Role code、使用可能な `owner`、採用理由、見直し条件の正本 |
33
- | `pm-roles.yaml` | 採用結果の機械可読な転記先。Role code、正式名称、プロジェクト固有メモを保持する |
34
- | `pm-members.yaml` / `.specdojo/agent-members.yaml` | 人間 / agent の実行主体と対応ロール・兼務の割り当て |
35
- | Schedule / `pm-raci.md` | 組織定義の方針に従い、ロール定義のコードをタスクの `owner` / 責任分担の列として参照する |
31
+ | 管理先 | 担う情報・接続 |
32
+ | -------------------------------------------------- | ------------------------------------------------------------------ |
33
+ | `pm-organization.md` | 採用・未採用コード、使用可能な `owner`、採用理由、見直し条件の正本 |
34
+ | `pm-roles.yaml` | 採用コード・正式名称・固有メモの機械可読な転記先 |
35
+ | `pm-members.yaml` / `.specdojo/agent-members.yaml` | 人間 / agent の実行主体・対応ロール・兼務 |
36
+ | Schedule / `pm-raci.md` | コードを `owner` / 責任分担の列として参照 |
36
37
 
37
38
  ## 3. ファイル命名・ID規則
38
39
 
39
- - 配置は `docs/ja/projects/<project-id>/030-project-management/pm-roles.yaml` を推奨します。
40
- - ファイル名は `pm-roles.yaml`、ID は `<project-id>:pm-roles` とし、`project_id` を配置先プロジェクトに合わせます。
41
- - 組織定義・人間のメンバー定義と同じ管理ディレクトリに置きます。共通の命名・配置規則は [[specdojo:docs-structure-guide|ドキュメント構成ガイド]] に従います。
40
+ - 組織定義・メンバー定義と同じ `docs/ja/projects/<project-id>/030-project-management/pm-roles.yaml` に置くことを推奨します。
41
+ - ID は `<project-id>:pm-roles`、`project_id` は配置先プロジェクトに合わせます。
42
+ - 共通規則は [[specdojo:docs-structure-guide|ドキュメント構成ガイド]] に従います。
42
43
 
43
44
  ## 4. 推奨メタ項目
44
45
 
45
- 独立 YAML のため、メタ項目は先頭のトップレベルに置きます。許可キー・必須性・型・値制約は `docs/specdojo/schemas/v1/pm-roles.schema.yaml`、メタ情報の意味は [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] を正本とします。
46
+ メタ項目は YAML 先頭のトップレベルに置きます。許可キー・必須性・型・値制約は `docs/specdojo/schemas/v1/pm-roles.schema.yaml` を正本とします。
46
47
 
47
- | 項目 | この成果物で確認する内容 |
48
- | ----------------------------- | --------------------------------------------------------------------------------------------------------------- |
49
- | `id` / `project_id` / `title` | 必須。対象プロジェクトと一覧の名称を識別できること |
50
- | `type` / `status` / `version` | 必須。成果物種別は `project`。状態は `draft` / `ready` / `deprecated` を使い分け、データの版を示すこと |
51
- | `rulebook` | 必須。準拠先として `specdojo:pm-roles-rulebook` を指定すること |
52
- | `based_on` / `supersedes` | 任意。採用判断の根拠となる先行成果物 / 置き換え対象を示すこと。適用範囲とライフサイクル管理はメタ情報標準に従う |
48
+ - `id` / `project_id` / `title` / `type` / `status` / `version` / `rulebook` は必須です。
49
+ - `type` は `project`、`rulebook` は `specdojo:pm-roles-rulebook`、`status` の値域は `draft` / `ready` / `deprecated` です。
50
+ - `based_on` / `supersedes` は任意です。
53
51
 
54
52
  ## 5. 本文要件
55
53
 
56
- メタ項目以外の本文キーは次の役割を担います。YAML の骨組みは Frontmatter で宣言した template、構造・型の詳細は対応 schema を正本とします。
54
+ 骨組みは Frontmatter の template、構造・型は対応 schema を正本とします。
57
55
 
58
- | キー | 必須・任意 | 目的・内容要件 |
59
- | ---------------------- | ---------- | ------------------------------------------------------------------------------------------------------ |
60
- | `roles` | 必須 | 採用した全 Role code の配列。`PO` を必ず含め、各コードを一意にする。組織定義で採用した集合と一致させる |
61
- | `roles[].code` | 必須 | 下流の `owner`、RACI、メンバー定義を接続する識別子 |
62
- | `roles[].name` | 必須 | 上位標準の正式名称により、コードが表す責務を識別する |
63
- | `roles[].project_note` | 任意 | PO の判断に必要なプロジェクト固有の扱いを短く示す。補足がなければ省略する |
56
+ | キー | 必須・任意 | 目的・内容要件 |
57
+ | ---------------------- | ---------- | ----------------------------------------------------------------------- |
58
+ | `roles` | 必須 | 採用全コードの配列。`PO` を含み、コードは一意。組織定義の採用集合と一致 |
59
+ | `roles[].code` | 必須 | 下流の `owner`・RACI・メンバー定義を接続する識別子 |
60
+ | `roles[].name` | 必須 | 上位標準の正式名称で責務を識別 |
61
+ | `roles[].project_note` | 任意 | プロジェクト固有の扱い。補足がなければ省略する |
64
62
 
65
63
  ## 6. 記述ガイド
66
64
 
67
65
  ### 6.1. メタ項目と根拠
68
66
 
69
- `based_on` は、実際に確認した採用判断の根拠を指します。カタログの依存関係がある場合は、その推移閉包内の先行成果物に限定します。新規作成は `draft` とし、`ready` への昇格は人間が判断します。
67
+ カタログ利用時、`based_on` は依存の推移閉包内に限定します。
70
68
 
71
69
  | 判断点 | 良い例 | 悪い例 |
72
70
  | ---------- | ------------------------------------------ | ---------------------------------------- |
73
71
  | 根拠の選択 | 採用方針を確認した組織定義の ID を指定する | 同じディレクトリの文書を未確認で列挙する |
74
- | 準拠先 | 成果物の `rulebook` に本書の ID を指定する | 計画側に記載済みとして成果物から省く |
75
72
 
76
73
  ### 6.2. `roles` の採用範囲
77
74
 
78
- 組織定義の採用結果と、Schedule・RACI・メンバー定義の参照値を照合します。差分があれば一覧だけを追加・削除せず、採用判断と下流の使い方のどちらを改訂するかを先に確認します。記載順は上位標準の定義順を推奨します。
75
+ 採用集合と使用可能な `owner` の部分集合を取り違えず、記載順は上位標準の定義順を推奨します。
79
76
 
80
77
  | 判断点 | 良い例 | 悪い例 |
81
78
  | ------------ | -------------------------------------------- | -------------------------------------------- |
@@ -93,7 +90,7 @@ Project Role Definition Documentation Rulebook
93
90
 
94
91
  ### 6.4. `roles[].project_note`
95
92
 
96
- プロジェクト固有の責務強調、専任化を検討する条件、公開判断上の注意を 1 行で記述します。標準の一般責務と採用理由は各正本に委ねます。未決事項は `_UNDECIDED_:`、確認・追記待ちは `_TODO_:` で識別し、判断者・判断時点を示します。
93
+ 責務の重点や専任化の条件など、固有の扱いを 1 行で記述します。一般責務と採用理由は各正本に委ねます。未決事項は `_UNDECIDED_:`、確認・追記待ちは `_TODO_:` で識別し、論点と採用範囲・下流参照への影響を示します。
97
94
 
98
95
  | 判断点 | 良い例 | 悪い例 |
99
96
  | ---------------- | ----------------------------------------------------- | ---------------------------------- |
@@ -103,19 +100,17 @@ Project Role Definition Documentation Rulebook
103
100
 
104
101
  ### 6.5. 変更時の追従と完了判断
105
102
 
106
- 改訂・廃止はメタ情報標準の「文書の改訂・廃止とライフサイクル変更管理」に従います。PM は組織定義、WBS・Schedule の `owner`、RACI、人間・Agent のメンバー定義、レビュー観点の参照を調べ、波及更新をタスク化します。ARC は参照・schema との整合、QE は機械検証と採用集合・コード重複・名称対応の照合を確認し、人間の PO が採用変更と公開可否を判断します。
103
+ 受入確認は次の順で行います。
107
104
 
108
- 機械検証は `pm-roles.schema.yaml` を入力 schema とする。SpecDojo 開発リポジトリでは `npm run validate:schema:file -- --schema docs/specdojo/schemas/v1/pm-roles.schema.yaml --data <対象ファイル>` の終了コード 0 を確認する。schema の配列要素全体の一意性だけではコード重複を検出できないため、QE は `roles[].code` の重複なし、組織定義の採用集合との差分なし、上位標準のコードと正式名称の組との差分なしを別途照合する。
105
+ 1. `pm-roles.schema.yaml` で検証します。SpecDojo 開発リポジトリでは `npm run validate:schema:file -- --schema docs/specdojo/schemas/v1/pm-roles.schema.yaml --data <対象ファイル>` の終了コード 0 を確認します。
106
+ 2. schema の配列要素全体の一意性ではコード重複を検出しきれないため、コードの重複なし、組織定義の採用集合との差分なし、上位標準のコードと正式名称の組との差分なしを別途照合します。
107
+ 3. WBS・Schedule の `owner`、RACI、人間・agent のメンバー定義、レビュー観点の参照を照合し、未定義コードがないことを確認します。採用判断と下流参照に差分があれば修正先を確かめ、ロール削除時は責務の移管先も確認します。
109
108
 
110
- | 判断点 | 良い例 | 悪い例 |
111
- | ---------- | ---------------------------------------------------------------------------------------- | ------------------------------------------- |
112
- | 変更完了 | 採用変更と参照元の追従を確認し、未決事項は担当 Role code と転送先を付けて PJR に引き継ぐ | YAML の構文が通ったことだけで変更完了にする |
113
- | ロール削除 | 使用中の参照値と責務の移管先を確認してから除く | 専任者の離脱に合わせてコードだけを消す |
109
+ | 判断点 | 良い例 | 悪い例 |
110
+ | ---------- | -------------------------------------------------- | ------------------------------------------- |
111
+ | 変更完了 | 採用集合・名称・下流参照の照合結果がすべて一致する | YAML の構文が通ったことだけで変更完了にする |
112
+ | ロール削除 | 使用中の参照値と責務の移管先を確認してから除く | 専任者の離脱に合わせてコードだけを消す |
114
113
 
115
114
  ## 7. 禁止事項
116
115
 
117
- | 禁止事項 | 理由 |
118
- | --------------------------------------------------------------------- | ------------------------------------------------ |
119
- | schema にないキーを追加し、採用理由や兼務割り当てを独自構造で管理する | 機械処理の互換性と正本の責任境界を損なうため |
120
- | 個人情報、連絡先、非公開組織情報、アクセス情報を固有メモに含める | 公開可能なロール定義として再利用できなくなるため |
121
- | AI Agent に最終承認・公開可否・説明責任を持たせる | 人間の PO が最終判断を担う前提に反するため |
116
+ - schema にないキーで採用理由や兼務割り当てを管理しません。機械処理の互換性と正本の責任境界を損なうためです。
@@ -13,15 +13,14 @@ specdojo:
13
13
 
14
14
  Progress Report Documentation Rulebook
15
15
 
16
- 本ドキュメントは、進捗報告(`pr-<yyyy-mm-dd>-<nn>`)を統一形式で記述するためのルールを定義する。
17
-
18
16
  ## 1. 全体方針
19
17
 
20
18
  - 報告期間の進捗、リスク、次アクションを定点観測できる形で記録する。
21
19
  - 完了事項と未完了事項を区別して報告する。
22
20
  - 判断に必要な数値・根拠を明示する。
21
+ - 共通の運用: Frontmatter の項目(`specdojo.type` は `project`)、`status` の昇格と承認、改訂と廃止は [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] に従い、本書と成果物で言い直さない。
23
22
 
24
- ## 2. 位置づけと用語定義(必要に応じて)
23
+ ## 2. 位置づけ
25
24
 
26
25
  - 進捗報告は定期レビューの基礎資料として扱う。
27
26
  - 議事録、課題ログ、変更要求ログと整合を取る。
@@ -32,17 +31,7 @@ Progress Report Documentation Rulebook
32
31
  - 日付はISO形式、連番は2桁ゼロ埋めを推奨する。
33
32
  - 文書 ID は `<project-id>:pr-<yyyy-mm-dd>-<nn>` 形式とする(例: `prj-0001:pr-2026-03-01-01`)。
34
33
 
35
- ## 4. 推奨 Frontmatter 項目
36
-
37
- | 項目 | 説明 | 必須 |
38
-
39
- | ------ | -------------------------------- | ---- |
40
- | id | `<project-id>:pr-<yyyy-mm-dd>-<nn>` | ○ |
41
-
42
- | type | `project` | ○ |
43
- | status | `draft` / `ready` / `deprecated` | ○ |
44
-
45
- ## 5. 本文構成(標準テンプレ)
34
+ ## 4. 本文構成(標準テンプレ)
46
35
 
47
36
  | 番号 | 見出し | 必須 |
48
37
  | ---- | ------------ | ---- |
@@ -52,16 +41,14 @@ Progress Report Documentation Rulebook
52
41
  | 4 | リスク・課題 | ○ |
53
42
  | 5 | 次期予定 | ○ |
54
43
 
55
- ## 6. 記述ガイド
44
+ ## 5. 記述ガイド
56
45
 
57
46
  - 完了事項は成果物IDまたはタスクIDと紐づける。
58
-
59
47
  - リスク・課題は影響度と対応方針を明記する。
60
48
  - 次期予定は担当者と期日を設定する。
61
49
 
62
- ## 7. 禁止事項
50
+ ## 6. 禁止事項
63
51
 
64
52
  - 進捗率のみで根拠なく報告しない。
65
53
  - リスクを抽象語のみで記載しない。
66
-
67
54
  - 予定に期限や責任者を欠いたまま確定しない。