specdojo 0.7.0 → 0.8.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 (337) hide show
  1. package/.github/agents/specdojo-orchestrator.md +3 -2
  2. package/CHANGELOG.md +153 -0
  3. package/dist/catalog/build.js +24 -1
  4. package/dist/catalog/plan.js +1 -1
  5. package/dist/catalog/scaffold.js +4 -1
  6. package/dist/commands/init.js +5 -1
  7. package/dist/commands/night-orchestrator.js +6 -4
  8. package/dist/dashboard/dashboard-timeline.js +18 -16
  9. package/dist/dashboard/dashboard.js +612 -259
  10. package/dist/dashboard/epic-plan.js +81 -0
  11. package/dist/dashboard/exec-records.js +16 -20
  12. package/dist/dashboard/routines.js +8 -6
  13. package/dist/dashboard/timeline-build.js +5 -9
  14. package/dist/dashboard/timeline.js +9 -4
  15. package/dist/devcontainer/scaffold.js +18 -0
  16. package/dist/docs/frontmatter-namespace.js +1 -48
  17. package/dist/docs/yaml-pages.js +125 -3
  18. package/dist/exec/agent-config.js +22 -0
  19. package/dist/exec/agent-plan.js +3 -2
  20. package/dist/exec/commands.js +69 -21
  21. package/dist/exec/commit-hook-skips.js +78 -0
  22. package/dist/exec/core.js +19 -7
  23. package/dist/exec/events.js +159 -8
  24. package/dist/exec/evidence.js +64 -16
  25. package/dist/exec/handoff.js +9 -13
  26. package/dist/exec/limit.js +1 -1
  27. package/dist/exec/mechanical-result.js +45 -0
  28. package/dist/exec/migrate-records.js +249 -0
  29. package/dist/exec/parent-validation.js +153 -12
  30. package/dist/exec/pipeline-state.js +27 -5
  31. package/dist/exec/plans-condense-findings.js +89 -0
  32. package/dist/exec/plans-core.js +24 -17
  33. package/dist/exec/plans-generation.js +48 -25
  34. package/dist/exec/plans-grade-findings.js +8 -3
  35. package/dist/exec/plans-kata-findings.js +61 -0
  36. package/dist/exec/plans-planning.js +3 -3
  37. package/dist/exec/plans-storage.js +12 -24
  38. package/dist/exec/register-resume.js +55 -56
  39. package/dist/exec/register.js +26 -22
  40. package/dist/exec/repo-integration-sync.js +8 -4
  41. package/dist/exec/repo-integration.js +21 -1
  42. package/dist/exec/reporter.js +121 -23
  43. package/dist/exec/results.js +85 -24
  44. package/dist/exec/review-completion.js +47 -0
  45. package/dist/exec/review-kata.js +109 -0
  46. package/dist/exec/run/agent-pipeline.js +75 -6
  47. package/dist/exec/run/agent.js +20 -7
  48. package/dist/exec/run/in-place.js +69 -32
  49. package/dist/exec/run/job.js +81 -24
  50. package/dist/exec/run/lifecycle-commands.js +188 -36
  51. package/dist/exec/run/mode-shared.js +11 -3
  52. package/dist/exec/run/register-command.js +6 -10
  53. package/dist/exec/run/register-core.js +20 -13
  54. package/dist/exec/run/register-mode.js +12 -12
  55. package/dist/exec/run/register-post-review.js +21 -9
  56. package/dist/exec/run/register-resume.js +28 -18
  57. package/dist/exec/run/register-state.js +10 -7
  58. package/dist/exec/run/register-worktree.js +60 -30
  59. package/dist/exec/run/schedule-mode.js +4 -4
  60. package/dist/exec/run/schedule-prepare.js +201 -59
  61. package/dist/exec/run/schedule-task.js +129 -25
  62. package/dist/exec/run/shared.js +4 -3
  63. package/dist/exec/run/trailing-records.js +35 -0
  64. package/dist/exec/run-records.js +2 -0
  65. package/dist/exec/strategy.js +1 -0
  66. package/dist/exec/trailing-records.js +242 -0
  67. package/dist/exec/trial-commands.js +3 -2
  68. package/dist/exec/validate-records-commit.js +110 -0
  69. package/dist/exec/validate-records.js +148 -0
  70. package/dist/exec/worktree-command.js +29 -16
  71. package/dist/exec/worktree-ops-commit.js +119 -48
  72. package/dist/exec/worktree-ops-lifecycle.js +77 -48
  73. package/dist/exec/worktree-ops-merge.js +13 -2
  74. package/dist/exec/worktree-ops.js +2 -2
  75. package/dist/exec/worktree.js +19 -2
  76. package/dist/grade/apply.js +32 -6
  77. package/dist/grade/command-inspect.js +2 -2
  78. package/dist/grade/command-run.js +2 -0
  79. package/dist/grade/command-shared.js +1 -1
  80. package/dist/grade/core.js +18 -5
  81. package/dist/grade/markdown.js +3 -3
  82. package/dist/grade/pipeline-state.js +15 -11
  83. package/dist/grade/plan.js +37 -17
  84. package/dist/grade/result.js +3 -3
  85. package/dist/grade/run.js +23 -3
  86. package/dist/grade/target-discovery.js +17 -4
  87. package/dist/grade/targets.js +12 -11
  88. package/dist/job/job.js +31 -17
  89. package/dist/job/noop.js +104 -0
  90. package/dist/register/core.js +2 -0
  91. package/dist/register/create-commands.js +28 -3
  92. package/dist/register/deliverable-target.js +9 -1
  93. package/dist/register/epic.js +104 -26
  94. package/dist/register/event-merge.js +3 -0
  95. package/dist/register/events.js +4 -0
  96. package/dist/register/external-project.js +3 -0
  97. package/dist/register/item.js +6 -0
  98. package/dist/register/maintenance-commands.js +4 -1
  99. package/dist/register/planning.js +7 -14
  100. package/dist/register/register.js +43 -9
  101. package/dist/register/track-domains.js +34 -0
  102. package/dist/register/track-plan.js +78 -0
  103. package/dist/register/transition-commands.js +8 -0
  104. package/dist/register/work-table.js +64 -0
  105. package/dist/review/grade.js +35 -13
  106. package/dist/routine/definition.js +4 -3
  107. package/dist/routine/failure.js +30 -0
  108. package/dist/routine/routine.js +56 -32
  109. package/dist/routine/storage.js +33 -0
  110. package/dist/schedule/schedule.js +1 -0
  111. package/dist/schedule/strategy-generate-document.js +26 -14
  112. package/dist/schedule/strategy-generate-scope.js +17 -45
  113. package/dist/schedule/strategy-generate.js +33 -3
  114. package/dist/schedule/strategy-profiles.js +86 -12
  115. package/dist/shared/agent-types.js +2 -0
  116. package/dist/shared/condense-records.js +25 -0
  117. package/dist/shared/deprecation.js +8 -0
  118. package/dist/shared/document-metadata.js +20 -0
  119. package/dist/shared/finding-cause.js +20 -0
  120. package/dist/shared/frontmatter-namespace.js +48 -0
  121. package/dist/shared/git.js +142 -15
  122. package/dist/shared/grade-result.js +17 -1
  123. package/dist/shared/local-state.js +20 -0
  124. package/dist/shared/markdownlint-config.js +8 -3
  125. package/dist/shared/plan-conventions.js +129 -0
  126. package/dist/shared/plan-templates.js +57 -41
  127. package/dist/shared/run-records.js +224 -0
  128. package/dist/shared/specdojo-config.js +39 -21
  129. package/dist/shared/text.js +65 -5
  130. package/dist/shared/timeline-index.js +2 -0
  131. package/docs/ja/specdojo/defaults/pm-review-viewpoints.yaml +9 -2
  132. package/docs/ja/specdojo/exec-templates/xep-common-conventions-template.md +4 -74
  133. package/docs/ja/specdojo/exec-templates/xep-condense-template.md +50 -0
  134. package/docs/ja/specdojo/exec-templates/xep-draft-template.md +17 -5
  135. package/docs/ja/specdojo/exec-templates/xep-fully-guided-template.md +16 -3
  136. package/docs/ja/specdojo/exec-templates/xep-recipe-guided-template.md +15 -5
  137. package/docs/ja/specdojo/exec-templates/xep-recipe-maintenance-template.md +6 -0
  138. package/docs/ja/specdojo/exec-templates/xep-register-template.md +1 -1
  139. package/docs/ja/specdojo/exec-templates/xep-rulebook-maintenance-template.md +6 -0
  140. package/docs/ja/specdojo/exec-templates/xep-sample-maintenance-template.md +6 -0
  141. package/docs/ja/specdojo/exec-templates/xep-template-maintenance-template.md +6 -0
  142. package/docs/ja/specdojo/exec-templates/xer-condense-template.md +25 -0
  143. package/docs/ja/specdojo/exec-templates/xp-common-conventions-template.md +50 -0
  144. package/docs/ja/specdojo/exec-templates/xrp-common-conventions-template.md +30 -0
  145. package/docs/ja/specdojo/guides/branch-workflow-guide.md +1 -1
  146. package/docs/ja/specdojo/guides/docs-editing-guide.md +12 -0
  147. package/docs/ja/specdojo/guides/docs-structure-guide.md +48 -15
  148. package/docs/ja/specdojo/guides/exec-config-guide.md +47 -16
  149. package/docs/ja/specdojo/guides/exec-operation-guide.md +53 -17
  150. package/docs/ja/specdojo/guides/exec-worktree-guide.md +20 -11
  151. package/docs/ja/specdojo/guides/plan-result-lifecycle-guide.md +92 -55
  152. package/docs/ja/specdojo/guides/project-move-guide.md +381 -0
  153. package/docs/ja/specdojo/guides/quick-start-guide.md +70 -14
  154. package/docs/ja/specdojo/guides/register-operation-guide.md +25 -5
  155. package/docs/ja/specdojo/guides/remote-host-development-guide.md +2 -0
  156. package/docs/ja/specdojo/guides/review-guide.md +22 -19
  157. package/docs/ja/specdojo/guides/routine-operation-guide.md +14 -8
  158. package/docs/ja/specdojo/guides/ryu-guide.md +23 -13
  159. package/docs/ja/specdojo/guides/schedule-design-guide.md +7 -4
  160. package/docs/ja/specdojo/guides/schedule-operation-guide.md +27 -3
  161. package/docs/ja/specdojo/guides/specdojo-overview-guide.md +5 -4
  162. package/docs/ja/specdojo/guides/timeline-design-guide.md +27 -144
  163. package/docs/ja/specdojo/guides/use-case-guide.md +92 -155
  164. package/docs/ja/specdojo/recipes/bac-recipe.md +94 -0
  165. package/docs/ja/specdojo/recipes/bes-recipe.md +105 -0
  166. package/docs/ja/specdojo/recipes/br-recipe.md +84 -0
  167. package/docs/ja/specdojo/recipes/cdfd-uc-recipe.md +36 -24
  168. package/docs/ja/specdojo/recipes/cnd-recipe.md +125 -0
  169. package/docs/ja/specdojo/recipes/cpd-recipe.md +126 -0
  170. package/docs/ja/specdojo/recipes/cxd-recipe.md +145 -0
  171. package/docs/ja/specdojo/recipes/ifd-recipe.md +134 -0
  172. package/docs/ja/specdojo/recipes/ifx-cmd-recipe.md +135 -86
  173. package/docs/ja/specdojo/recipes/ifx-index-recipe.md +130 -0
  174. package/docs/ja/specdojo/recipes/pm-organization-recipe.md +29 -26
  175. package/docs/ja/specdojo/recipes/pm-plan-recipe.md +35 -26
  176. package/docs/ja/specdojo/recipes/pm-quality-management-plan-recipe.md +38 -28
  177. package/docs/ja/specdojo/recipes/pm-raci-recipe.md +39 -31
  178. package/docs/ja/specdojo/recipes/pm-roles-recipe.md +26 -28
  179. package/docs/ja/specdojo/recipes/prj-assumptions-constraints-dependencies-recipe.md +10 -8
  180. package/docs/ja/specdojo/recipes/prj-comparison-of-alternatives-recipe.md +18 -17
  181. package/docs/ja/specdojo/recipes/stsd-recipe.md +100 -62
  182. package/docs/ja/specdojo/recipes/sysd-critical-flows-recipe.md +106 -0
  183. package/docs/ja/specdojo/recipes/sysd-cross-cutting-policy-recipe.md +137 -0
  184. package/docs/ja/specdojo/recipes/sysd-index-recipe.md +122 -0
  185. package/docs/ja/specdojo/references/command-reference.md +79 -64
  186. package/docs/ja/specdojo/references/deliverables-reference.md +9 -4
  187. package/docs/ja/specdojo/references/directory-layout-reference.md +3 -2
  188. package/docs/ja/specdojo/references/specdojo-config-reference.md +17 -16
  189. package/docs/ja/specdojo/rulebooks/bac-rulebook.md +72 -290
  190. package/docs/ja/specdojo/rulebooks/bdd-rulebook.md +212 -79
  191. package/docs/ja/specdojo/rulebooks/bds-rulebook.md +138 -154
  192. package/docs/ja/specdojo/rulebooks/bes-index-rulebook.md +147 -59
  193. package/docs/ja/specdojo/rulebooks/bes-rulebook.md +100 -96
  194. package/docs/ja/specdojo/rulebooks/br-rulebook.md +88 -108
  195. package/docs/ja/specdojo/rulebooks/ccd-mermaid-rulebook.md +126 -211
  196. package/docs/ja/specdojo/rulebooks/cdfd-uc-rulebook.md +56 -35
  197. package/docs/ja/specdojo/rulebooks/cdsd-rulebook.md +102 -68
  198. package/docs/ja/specdojo/rulebooks/cdt-rulebook.md +152 -0
  199. package/docs/ja/specdojo/rulebooks/cld-rulebook.md +9 -184
  200. package/docs/ja/specdojo/rulebooks/clis-rulebook.md +187 -0
  201. package/docs/ja/specdojo/rulebooks/cnd-rulebook.md +93 -247
  202. package/docs/ja/specdojo/rulebooks/cpd-rulebook.md +104 -241
  203. package/docs/ja/specdojo/rulebooks/cxd-rulebook.md +124 -257
  204. package/docs/ja/specdojo/rulebooks/dct-index-rulebook.md +87 -98
  205. package/docs/ja/specdojo/rulebooks/dct-rulebook.md +9 -7
  206. package/docs/ja/specdojo/rulebooks/dec-rulebook.md +2 -1
  207. package/docs/ja/specdojo/rulebooks/dss-rulebook.md +193 -0
  208. package/docs/ja/specdojo/rulebooks/gl-rulebook.md +100 -54
  209. package/docs/ja/specdojo/rulebooks/ifd-mermaid-rulebook.md +69 -252
  210. package/docs/ja/specdojo/rulebooks/ifx-cmd-rulebook.md +91 -76
  211. package/docs/ja/specdojo/rulebooks/ifx-file-rulebook.md +252 -226
  212. package/docs/ja/specdojo/rulebooks/ifx-index-rulebook.md +118 -40
  213. package/docs/ja/specdojo/rulebooks/imp-business-rulebook.md +11 -11
  214. package/docs/ja/specdojo/rulebooks/imp-data-rulebook.md +9 -9
  215. package/docs/ja/specdojo/rulebooks/imp-interface-rulebook.md +4 -4
  216. package/docs/ja/specdojo/rulebooks/imp-operations-rulebook.md +11 -11
  217. package/docs/ja/specdojo/rulebooks/imp-test-rulebook.md +11 -11
  218. package/docs/ja/specdojo/rulebooks/mm-rulebook.md +4 -3
  219. package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +34 -29
  220. package/docs/ja/specdojo/rulebooks/pm-change-request-log-rulebook.md +8 -8
  221. package/docs/ja/specdojo/rulebooks/pm-issue-log-rulebook.md +2 -2
  222. package/docs/ja/specdojo/rulebooks/pm-organization-rulebook.md +50 -56
  223. package/docs/ja/specdojo/rulebooks/pm-plan-rulebook.md +46 -55
  224. package/docs/ja/specdojo/rulebooks/pm-quality-management-plan-rulebook.md +57 -54
  225. package/docs/ja/specdojo/rulebooks/pm-raci-rulebook.md +50 -65
  226. package/docs/ja/specdojo/rulebooks/pm-risk-register-rulebook.md +2 -2
  227. package/docs/ja/specdojo/rulebooks/pm-roles-rulebook.md +70 -97
  228. package/docs/ja/specdojo/rulebooks/pr-rulebook.md +2 -1
  229. package/docs/ja/specdojo/rulebooks/prj-assumptions-constraints-dependencies-rulebook.md +47 -56
  230. package/docs/ja/specdojo/rulebooks/prj-comparison-of-alternatives-rulebook.md +61 -135
  231. package/docs/ja/specdojo/rulebooks/sf-index-rulebook.md +116 -32
  232. package/docs/ja/specdojo/rulebooks/sf-rulebook.md +118 -61
  233. package/docs/ja/specdojo/rulebooks/sld-rulebook.md +152 -57
  234. package/docs/ja/specdojo/rulebooks/stsd-mermaid-rulebook.md +51 -39
  235. package/docs/ja/specdojo/rulebooks/stsd-rulebook.md +101 -46
  236. package/docs/ja/specdojo/rulebooks/sysd-critical-flows-rulebook.md +72 -329
  237. package/docs/ja/specdojo/rulebooks/sysd-cross-cutting-policy-rulebook.md +74 -263
  238. package/docs/ja/specdojo/rulebooks/sysd-index-rulebook.md +78 -195
  239. package/docs/ja/specdojo/rulebooks/tml-rulebook.md +4 -9
  240. package/docs/ja/specdojo/rulebooks/trc-requirements-to-specs-rulebook.md +3 -4
  241. package/docs/ja/specdojo/rulebooks/trc-requirements-to-tests-rulebook.md +3 -3
  242. package/docs/ja/specdojo/rulebooks/uis-rulebook.md +140 -143
  243. package/docs/ja/specdojo/samples/bac-sample.md +106 -21
  244. package/docs/ja/specdojo/samples/bdd-sample.yaml +143 -35
  245. package/docs/ja/specdojo/samples/bds-sample.md +100 -21
  246. package/docs/ja/specdojo/samples/bes-index-sample.md +59 -20
  247. package/docs/ja/specdojo/samples/bes-sample.md +80 -21
  248. package/docs/ja/specdojo/samples/br-sample.md +68 -14
  249. package/docs/ja/specdojo/samples/ccd-sample.md +81 -19
  250. package/docs/ja/specdojo/samples/cdfd-sample.md +172 -99
  251. package/docs/ja/specdojo/samples/cdfd-uc-sample.md +9 -7
  252. package/docs/ja/specdojo/samples/cdsd-sample.md +89 -20
  253. package/docs/ja/specdojo/samples/cdt-sample.md +116 -0
  254. package/docs/ja/specdojo/samples/cld-sample.md +3 -30
  255. package/docs/ja/specdojo/samples/clis-sample.md +132 -0
  256. package/docs/ja/specdojo/samples/cnd-sample.md +127 -21
  257. package/docs/ja/specdojo/samples/cpd-sample.md +136 -22
  258. package/docs/ja/specdojo/samples/cxd-sample.md +108 -22
  259. package/docs/ja/specdojo/samples/dct-index-sample.yaml +63 -17
  260. package/docs/ja/specdojo/samples/dss-sample.md +175 -0
  261. package/docs/ja/specdojo/samples/gl-sample.yaml +50 -14
  262. package/docs/ja/specdojo/samples/ifd-sample.md +105 -21
  263. package/docs/ja/specdojo/samples/ifx-cmd-sample.yaml +91 -60
  264. package/docs/ja/specdojo/samples/ifx-file-sample.md +462 -21
  265. package/docs/ja/specdojo/samples/ifx-index-sample.yaml +87 -19
  266. package/docs/ja/specdojo/samples/pm-members-sample.yaml +37 -13
  267. package/docs/ja/specdojo/samples/pm-organization-sample.md +52 -20
  268. package/docs/ja/specdojo/samples/pm-plan-sample.md +84 -26
  269. package/docs/ja/specdojo/samples/pm-quality-management-plan-sample.md +55 -22
  270. package/docs/ja/specdojo/samples/pm-raci-sample.md +69 -28
  271. package/docs/ja/specdojo/samples/pm-roles-sample.yaml +13 -12
  272. package/docs/ja/specdojo/samples/prj-assumptions-constraints-dependencies-sample.md +50 -26
  273. package/docs/ja/specdojo/samples/prj-comparison-of-alternatives-sample.md +89 -62
  274. package/docs/ja/specdojo/samples/sf-index-sample.md +89 -20
  275. package/docs/ja/specdojo/samples/sf-sample.md +121 -21
  276. package/docs/ja/specdojo/samples/sld-sample.md +107 -21
  277. package/docs/ja/specdojo/samples/stsd-sample.md +54 -26
  278. package/docs/ja/specdojo/samples/sysd-critical-flows-sample.md +166 -21
  279. package/docs/ja/specdojo/samples/sysd-cross-cutting-policy-sample.md +178 -21
  280. package/docs/ja/specdojo/samples/sysd-index-sample.md +82 -21
  281. package/docs/ja/specdojo/samples/tml-sample.yaml +4 -1
  282. package/docs/ja/specdojo/samples/uis-sample.md +164 -20
  283. package/docs/ja/specdojo/standards/document-metadata-standard.md +33 -4
  284. package/docs/ja/specdojo/standards/id-and-file-naming-standard.md +3 -1
  285. package/docs/ja/specdojo/standards/rulebook-authoring-standard.md +1 -0
  286. package/docs/ja/specdojo/templates/bac-template.md +76 -0
  287. package/docs/ja/specdojo/templates/bes-template.md +56 -0
  288. package/docs/ja/specdojo/templates/br-template.md +64 -0
  289. package/docs/ja/specdojo/templates/cdfd-template.md +81 -54
  290. package/docs/ja/specdojo/templates/cdfd-uc-template.md +9 -5
  291. package/docs/ja/specdojo/templates/cnd-template.md +137 -0
  292. package/docs/ja/specdojo/templates/cpd-template.md +129 -0
  293. package/docs/ja/specdojo/templates/cxd-template.md +105 -0
  294. package/docs/ja/specdojo/templates/dct-data-model-cdt-template.yaml +40 -0
  295. package/docs/ja/specdojo/templates/dct-data-model-cld-template.yaml +7 -14
  296. package/docs/ja/specdojo/templates/dct-index-template.md +9 -20
  297. package/docs/ja/specdojo/templates/dct-project-management-template.yaml +5 -1
  298. package/docs/ja/specdojo/templates/ifd-template.md +86 -0
  299. package/docs/ja/specdojo/templates/ifx-cmd-template.yaml +44 -28
  300. package/docs/ja/specdojo/templates/ifx-index-template.yaml +40 -0
  301. package/docs/ja/specdojo/templates/opr-template.md +2 -4
  302. package/docs/ja/specdojo/templates/pm-organization-template.md +9 -3
  303. package/docs/ja/specdojo/templates/pm-plan-template.md +4 -4
  304. package/docs/ja/specdojo/templates/pm-quality-management-plan-template.md +17 -9
  305. package/docs/ja/specdojo/templates/pm-raci-template.md +24 -13
  306. package/docs/ja/specdojo/templates/pm-roles-template.yaml +3 -2
  307. package/docs/ja/specdojo/templates/prj-assumptions-constraints-dependencies-template.md +6 -3
  308. package/docs/ja/specdojo/templates/prj-comparison-of-alternatives-template.md +22 -19
  309. package/docs/ja/specdojo/templates/stsd-template.md +46 -21
  310. package/docs/ja/specdojo/templates/sysd-critical-flows-template.md +94 -0
  311. package/docs/ja/specdojo/templates/sysd-cross-cutting-policy-template.md +122 -0
  312. package/docs/ja/specdojo/templates/sysd-index-template.md +89 -0
  313. package/docs/specdojo/lib/yaml-metadata.cjs +7 -0
  314. package/docs/specdojo/schemas/v1/bdd.schema.yaml +25 -57
  315. package/docs/specdojo/schemas/v1/condense-records.schema.yaml +26 -0
  316. package/docs/specdojo/schemas/v1/dct.schema.yaml +10 -0
  317. package/docs/specdojo/schemas/v1/deliverable-frontmatter.schema.yaml +3 -0
  318. package/docs/specdojo/schemas/v1/esil.schema.yaml +7 -141
  319. package/docs/specdojo/schemas/v1/exec-common.schema.yaml +3 -0
  320. package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +53 -3
  321. package/docs/specdojo/schemas/v1/exec-evidence.schema.yaml +3 -0
  322. package/docs/specdojo/schemas/v1/exec-plan-frontmatter.schema.yaml +14 -0
  323. package/docs/specdojo/schemas/v1/exec-result-frontmatter.schema.yaml +18 -0
  324. package/docs/specdojo/schemas/v1/finding-cause.schema.yaml +22 -0
  325. package/docs/specdojo/schemas/v1/grade-pipeline-state.schema.yaml +1 -1
  326. package/docs/specdojo/schemas/v1/grade-result.schema.yaml +2 -0
  327. package/docs/specdojo/schemas/v1/ifx-cmd.schema.yaml +65 -5
  328. package/docs/specdojo/schemas/v1/ifx-index.schema.yaml +142 -0
  329. package/docs/specdojo/schemas/v1/register-events.schema.yaml +2 -0
  330. package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +17 -1
  331. package/package.json +2 -2
  332. package/templates/antigravity/orchestrator.md +3 -2
  333. package/templates/claude/agents/specdojo-orchestrator.md +3 -2
  334. package/templates/codex/agents/specdojo-orchestrator.toml +3 -2
  335. package/templates/codex/orchestrator.md +3 -2
  336. package/templates/devcontainer/tmux.conf +6 -0
  337. package/templates/opencode/agents/specdojo-orchestrator.md +3 -2
@@ -16,102 +16,87 @@ specdojo:
16
16
 
17
17
  RACI Documentation Rulebook
18
18
 
19
- 主要成果物と主要判断の責任境界を、最小限のマトリクスで示すためのルールです。成果物カタログ全体やRole codeの定義を複製せず、責任衝突の可能性がある対象へ絞ります。
19
+ 主要成果物と主要判断の責任境界を、最小限のマトリクスで示すためのルールです。責任衝突や判断停滞を防ぎ、作業の計画化と担当の照合に使える粒度へ絞ります。
20
20
 
21
21
  ## 1. 全体方針
22
22
 
23
- - RACI は、誰が作業し、誰が最終責任を持つかを明確にするために使います。
24
- - 全成果物を網羅せず、主要成果物、価値判断、変更、公開など責任境界が重要な対象へ絞ります。
25
- - 成果物別と判断・プロセス別の二表を基本とし、重複する行は統合します。
26
- - 各行の `A` は一つの Role code に限定し、主たる実作業者に `R` を置きます。
27
- - Role code はロール定義、実行主体・兼務はメンバー定義、Schedule owner はScheduleを正本とします。
28
- - Agent は `R` または `C` を支援できますが、`A` は担いません。
23
+ - 標準運用以上で、作成・判断・相談・共有の責任境界が必要な対象に適用します。最小運用で作成を省略できる条件は、[[specdojo:people-and-organization-definition-standard|人と組織の定義標準]] の「ファイル別の責務」に従います。
24
+ - 全成果物を列挙せず、主要成果物、価値判断、変更、品質例外、公開など責任衝突があり得る対象を選びます。
25
+ - 業務・技術・品質の各観点で、対象範囲内の作業責任、最終判断、必要な相談先を確認できることを網羅条件とします。該当しない観点は省略理由を記載し、確認のためだけに行や未採用 Role を増やしません。
26
+ - 共通の用語・担当展開規則は上位標準を正本とし、本書では RACI 固有の判断基準を定めます。実装・schema・リファレンスが定める値・構文・構造は再掲しません。
29
27
 
30
28
  ## 2. 位置づけと用語定義
31
29
 
32
- | 記号 | 意味 | 定義 |
33
- | ---- | ----------- | ---------------------------------- |
34
- | R | Responsible | 主たる実作業を担う |
35
- | A | Accountable | 最終責任を持ち、承認または判断する |
36
- | C | Consulted | 作業前・判断前に相談または確認する |
37
- | I | Informed | 結果または変更の共有を受ける |
30
+ `R` / `A` / `C` / `I`、Role、Member、Task owner の意味は、[[specdojo:people-and-organization-definition-standard|人と組織の定義標準]] に従います。主担当とは、対象作業を主導する一つの `R` の Role code です。行に複数の `R` がある場合の識別方法は「Schedule・実行主体との対応」で定めます。
31
+
32
+ 採用 Role は組織定義、Role code と責務はロール定義、実行主体・兼務はメンバー定義を正本とします。RACI は責任配置、Schedule は個別タスクの `owner` を管理し、人物・Agent の一覧や成果物カタログを複製しません。
38
33
 
39
34
  ## 3. ファイル命名・ID規則
40
35
 
41
36
  - 配置は `docs/ja/projects/<project-id>/030-project-management/pm-raci.md` を推奨します。
42
37
  - ID は `<project-id>:pm-raci`、ファイル名は `pm-raci.md` とします。
43
- - 列には採用済み Role code、行には成果物 ID または明確な判断・プロセス名を使います。
38
+ - 行の対象は成果物 ID または判断・プロセス名で特定します。複数成果物をまとめる場合も、各成果物から対象行を一意に照合できる名称または参照を残します。
44
39
 
45
40
  ## 4. 推奨 Frontmatter 項目
46
41
 
47
- | 項目 | 説明 | 必須 |
48
- | ---------- | -------------------------------- | ---- |
49
- | id | `<project-id>:pm-raci` | ○ |
50
- | type | `project` | ○ |
51
- | status | `draft` / `ready` / `deprecated` | ○ |
52
- | rulebook | `specdojo:pm-raci-rulebook` | ○ |
53
- | based_on | 組織定義、ロール定義などの ID | 任意 |
54
- | supersedes | 置き換え対象の旧文書 ID | 任意 |
55
-
56
- ## 5. 本文構成(標準テンプレ)
57
-
58
- | 番号 | 見出し | 必須 | 内容 |
59
- | ---- | -------------------------- | ---- | -------------------------------------------- |
60
- | 1 | 適用方針 | ○ | 対象範囲、記号、Role code、兼務・Agentの扱い |
61
- | 2 | 成果物別 RACI | ○ | 主要成果物の責任マトリクス |
62
- | 3 | 判断・プロセス別 RACI | ○ | 価値判断、変更、品質、公開等の責任マトリクス |
63
- | 4 | Schedule・実行主体との対応 | ○ | `R`、Schedule owner、member割り当ての関係 |
64
- | 5 | 見直し条件 | ○ | 更新トリガーと確認内容 |
42
+ 共通項目の必須性・値・構造は、[[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] と成果物 Frontmatter schema に従います。`rulebook` には本書の ID を指定し、`based_on` を使う場合は、成果物の依存関係に含まれる組織定義など実際の根拠を指定します。
43
+
44
+ ## 5. 本文要件
45
+
46
+ 見出し順・表・記入欄の骨組みは Frontmatter で宣言した template を正本とします。以下は内容の必須要件であり、完成例は sample で扱います。
47
+
48
+ - 対象範囲、省略範囲と理由、採用 Role の参照、兼務・Agent 支援の扱いを必須とし、責任の確認範囲を判断できるようにします。記号の説明は上位標準への参照とプロジェクト固有の補足で足ります。
49
+ - 成果物の責任配置と判断・プロセスの責任配置を二表で示すことを必須とします。同じ責任境界の行は統合でき、各行には一つの `A` と一つ以上の `R` を置きます。`A/R` の兼任は可とし、`C` / `I` は相談・共有が必要な場合に記載します。
50
+ - 個別タスクの担当を照合するため、主担当の識別、Schedule と割り当て先の正本への参照、不一致時の更新先を必須とします。
51
+ - 継続して責任を保つため、見直しのトリガーと確認対象を必須とします。未決事項・リスク・変更要求の詳細や状態は管理記録へ分離します。
65
52
 
66
53
  ## 6. 記述ガイド
67
54
 
68
55
  ### 6.1. 適用方針
69
56
 
70
- - 対象とする主要成果物・判断と、省略する対象を示します。
71
- - `R` / `A` / `C` / `I` の意味を簡潔に示し、プロジェクト固有の補足だけを書きます。
72
- - 使用する列は採用済み Role code に絞り、省略理由を示します。
57
+ - 判断基準: 初期スコープと組織定義に照らし、業務上の確認・合意、技術上の実現・変更、品質の検証・判定をどの行で扱うか確認します。列は採用済み Role code から必要なものを選び、採用済みでも省く列には理由を示します。
58
+ - 雛形などの `_ROLE_CODE_` は列の例であり、採用 Role に置換して必要数に増減します。固定の Role 一式を必須列として読み替えません。
59
+ - 良い例: 「初期公開を対象とし、業務合意・実装・品質判定を扱う。次期拡張は対象外」と限定し、組織定義を参照する。
60
+ - 悪い例: 「全作業を対象」とだけ書き、未採用 Role を含む列をそのまま使う。
73
61
 
74
62
  ### 6.2. 成果物別 RACI
75
63
 
76
- | 成果物 | PO | PM | BA | ARC | QE |
77
- | ------ | --- | --- | --- | --- | --- |
78
-
79
- - 初期スコープの主要成果物、管理計画、公開対象など責任衝突があり得る単位へ絞ります。
80
- - 生成ビューは正本と責任が同じ場合に独立行を作りません。
81
-
82
- - 各行に一つの `A` と一つ以上の `R` があることを確認します。
64
+ - 判断基準: 初期スコープの主要成果物、管理計画、公開対象を、作成・最終判断の責任が同じ単位でまとめます。主担当や `A` が異なる成果物は分け、生成ビューは正本と責任が同じなら独立行にしません。
65
+ - 相談・共有の関与がないセルは空欄または `—` とし、表内で統一します。
66
+ - 良い例: 同じ責任配置の管理文書を対象 ID でまとめ、技術担当が主導する設計文書は別行にする。
67
+ - 悪い例: カタログ全体を転記する、または担当の異なる戦略文書まで一括して管理担当の `R` に含める。
83
68
 
84
69
  ### 6.3. 判断・プロセス別 RACI
85
70
 
86
- | 判断・プロセス | PO | PM | BA | ARC | QE |
87
- | -------------- | --- | --- | --- | --- | --- |
88
-
89
- - 当事者価値、費用・負荷、変更、品質例外、公開など最終判断者が異なる対象を分けます。
90
- - 成果物作成と成果物内容の最終判断を混同しません。
91
- - 通常の作業手順を網羅せず、責任境界が必要なプロセスだけを置きます。
71
+ - 判断基準: 当事者価値、費用・負荷、変更、品質例外、公開など、最終判断者が異なる対象を分けます。成果物行とプロセス行が重なる場合は、各 `A` が判断する範囲を明記します。必要な業務確認者・技術相談先・品質確認者は採用 Role を介して追跡できるようにします。
72
+ - 良い例: 「作成フローの運営」の `A` は順序・進捗を判断し、内容の承認は各成果物行の `A` が行うと区別する。
73
+ - 悪い例: 「成果物作成」の `A` が成果物ごとの内容の承認まで行うように読める、または品質例外と公開判断を担当の確認なしに一行へまとめる。
92
74
 
93
75
  ### 6.4. Schedule・実行主体との対応
94
76
 
95
- - Schedule owner は成果物行またはプロセス行の主たる `R` と一致させます。
96
- - 実際のmember・兼務はメンバー定義で割り当て、RACIへ個人名を記載しません。
97
- - 不一致がある場合にどの正本を更新するかを示します。
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 の責任配置かタスク定義の正本か、修正先を明記します。生成ビューは直接更新しません。
82
+ - 良い例: 複数 `R` の行に「要件整理は業務担当、構成設計は技術担当」と採用 Role code で注記し、承認タスクは対応する `A` と照合する。
83
+ - 悪い例: 複数 `R` の主担当を注記せず、Schedule に現在入っている `owner` を理由に後付けで選ぶ。
98
84
 
99
85
  ### 6.5. 見直し条件
100
86
 
101
- | トリガー | 確認すること |
102
- | -------- | ------------ |
103
-
104
- - スコープ、採用Role code、主要成果物、判断ゲート、Schedule ownerが変わった場合に見直します。
105
- - 兼務で作業・判断が滞留した場合は、まず責任分担とエスカレーションを見直します。
106
- - RACIの行追加は、責任衝突を防ぐ必要がある場合だけ行います。
87
+ - 判断基準: スコープ、採用 Role、主要成果物の統合・分割・廃止、判断ゲート、Schedule の担当、兼務の継続可能性の変化をトリガーとし、影響する行・参照・担当を特定します。
88
+ - 改訂・廃止は [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] の「文書の改訂・廃止とライフサイクル変更管理」に従います。PM 責務を担う採用 Role は、RACI と組織・ロール・メンバー定義、WBS・Schedule、コミュニケーション計画への波及を確認し、更新タスクと担当を管理します。
89
+ - 良い例: 品質判定の滞留を契機に、相談先とエスカレーションを見直し、課題・リスク・変更要求・決定は種別に応じたプロジェクト登録簿(PJR)等の管理記録へ担当 Role と参照を付けて引き継ぐ。
90
+ - 悪い例: 「必要時に見直す」とだけ書く、または判断履歴や課題の状態を RACI の行へ蓄積する。
107
91
 
108
92
  ## 7. 禁止事項
109
93
 
110
- | 禁止事項 | 理由 |
111
- | ------------------------------------------------ | -------------------------------- |
112
- | 成果物カタログ全体や生成ビューを機械的に列挙する | 保守量が増え、主要責任が埋もれる |
113
- | 未採用Role code、member、人名、agent名を列に使う | 正本と責任語彙が一致しないため |
114
- | `A`を省略する、または一行に複数置く | 最終責任が不明になるため |
115
- | Agentに`A`を割り当てる | 人間の説明責任を代替するため |
116
- | Schedule ownerと主たる`R`を矛盾させる | 実作業責任を追跡できないため |
117
- | 兼務を理由に責任境界を統合する | 判断と作業の区別が失われるため |
94
+ | 禁止事項 | 理由 |
95
+ | ----------------------------------------------------- | -------------------------------------- |
96
+ | 成果物カタログ全体や生成ビューを機械的に列挙する | 保守量が増え、主要責任が埋もれる |
97
+ | 未採用 Role、Member、人名、Agent 名を列に使う | 正本と責任語彙が一致しないため |
98
+ | `A` の欠落・複数配置、`R` の欠落を許す | 最終責任または作業責任が不明になるため |
99
+ | 複数 `R` の担当範囲と主担当を識別不能なままにする | 個別タスクの担当を照合できないため |
100
+ | Agent に `A` を割り当てる | 人間の説明責任を代替するため |
101
+ | WBS の優先順やタスク種別を無視して `owner` を変更する | 上位標準と責任配置の対応が失われるため |
102
+ | 兼務を理由に責任境界を統合する | 判断と作業の区別が失われるため |
@@ -28,14 +28,14 @@ Risk Register Documentation Rules
28
28
 
29
29
  ## 3. ファイル命名・ID規則
30
30
 
31
- - `id` は `pm-risk-register` を使用する。
31
+ - `id` は `<project-id>:pm-risk-register` を使用する。
32
32
  - ファイル名は `pm-risk-register-リスク登録簿.md` など一意にする。
33
33
 
34
34
  ## 4. 推奨 Frontmatter 項目
35
35
 
36
36
  | 項目 | 説明 | 必須 |
37
37
  | ---------- | -------------------------------- | ---- |
38
- | id | `pm-risk-register` | ○ |
38
+ | id | `<project-id>:pm-risk-register` | ○ |
39
39
  | type | `project` 固定 | ○ |
40
40
  | status | `draft` / `ready` / `deprecated` | ○ |
41
41
  | based_on | 根拠仕様ID(配列) | 任意 |
@@ -12,137 +12,110 @@ specdojo:
12
12
  - specdojo:people-and-organization-definition-standard
13
13
  ---
14
14
 
15
- # プロジェクトロール定義 作成ルール
15
+ # ロール定義 作成ルール
16
16
 
17
17
  Project Role Definition Documentation Rulebook
18
18
 
19
- 本ドキュメントは、`pm-roles.yaml` を一貫した構造で作成・更新するためのルールを定義する。`pm-roles.yaml` は、プロジェクトで使用する全 Role code の machine-readable な一覧であり、Schedule の `owner` や RACI の列として使用できる責務語彙を定義する。人間の実行主体と兼務の割り当ては `pm-members.yaml`、agent は `.specdojo/agent-members.yaml` の `members[].roles` で管理する。
19
+ `pm-roles.yaml` に、組織定義で採用した Role code を機械可読な一覧として記録するためのルールです。Schedule、RACI、メンバー定義が同じ責務語彙を参照でき、PO がプロジェクト固有の扱いを承認できる内容にします。
20
20
 
21
21
  ## 1. 全体方針
22
22
 
23
- - `pm-roles.yaml` には、プロジェクトで使用する全 Role code を記載する。現時点で専任 member が存在しない Role code も、Schedule の `owner` 語彙として必要なら含める。
23
+ - 専任者の配置と Role code の採用を分けます。専任 Member がいなくても、責務語彙として使うロールは一覧に残します。
24
+ - 共通の責務や規模別の採用パターンは上位標準を参照し、プロジェクト固有の扱いだけを短く補足します。
24
25
 
25
- - 標準 Role code は `PO`, `PM`, `BA`, `ARC`, `DEV`, `QE`, `UX`, `OPS` を基本セットとし、プロジェクト内で採用する責務語彙をこの集合から選ぶ。
26
- - Role code の共通定義・責務・規模別パターンは上位標準を参照し、本ファイルに再掲しない。
27
- - 兼務の割り当て、member nickname、agent 名、個人名は `pm-members.yaml` と `.specdojo/agent-members.yaml` で管理し、本ファイルに記載しない。
28
- - ロール採用の方針・根拠、最終判断の集約先、見直し条件は `pm-organization.md` を参照し、本ファイルに重複して記載しない。
29
- - `pm-roles.yaml` の `roles[].code` は、Schedule の `owner` および `pm-members.yaml` の `members[].roles` で使用できる Role code の語彙一覧として機能する。
30
- - PO が全 Role code とプロジェクト固有メモを承認できるよう、各 `project_note` は公開可能な内容だけで簡潔に記載する。
31
- - AI Agent が作成・検証を支援する場合でも、最終判断、公開可否、説明責任は人間の PO に残す前提で記載する。
26
+ ## 2. 位置づけ
32
27
 
33
- ## 2. 位置づけと用語定義
28
+ 共通用語と標準ロールの定義は [[specdojo:people-and-organization-definition-standard|人と組織の定義標準]] を正本とします。情報の更新先は次のように分けます。
34
29
 
35
- `pm-roles.yaml` は、ロール定義の YAML 成果物として次の位置に置かれる。
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` / 責任分担の列として参照する |
36
36
 
37
- | 文書 | 役割 | 正本とする内容 |
38
- | -------------------- | ---------------------------------------------- | -------------------------------------- |
39
- | `pm-organization.md` | ロール・メンバー構成の方針と設計根拠を記述する | 採用方針、最終判断の集約先、見直し条件 |
37
+ ## 3. ファイル命名・ID規則
40
38
 
41
- | `pm-roles.yaml` | 採用した Role code を machine-readable な YAML として一覧化する | `owner` 語彙、Role code 名、プロジェクト固有メモ |
42
- | `pm-members.yaml` | 人間の実行主体と対応する Role code を管理する | member nickname、人間、兼務割り当て |
43
- | `.specdojo/agent-members.yaml` | agent と対応する Role code を管理する | agent nickname、選択属性、兼務割り当て |
44
- | `pm-raci.md` | 必要時の責任分担を記述する | 成果物・プロセスごとの責任分担 |
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|ドキュメント構成ガイド]] に従います。
45
42
 
46
- 用語は次のように使い分ける。
43
+ ## 4. 推奨メタ項目
47
44
 
48
- | 用語 | 意味 | `pm-roles.yaml` での扱い |
49
- | ------------ | ------------------------------------------------------ | ---------------------------------------- |
50
- | Role code | 責務・判断権限・専門性を表す短い識別子 | `roles[].code` に列挙する |
51
- | Role name | Role code の正式名称 | `roles[].name` に記載する |
52
- | Project note | 当該プロジェクトでの扱い、専任化条件、公開判断上の注意 | `roles[].project_note` に 1 行で記載する |
45
+ 独立 YAML のため、メタ項目は先頭のトップレベルに置きます。許可キー・必須性・型・値制約は `docs/specdojo/schemas/v1/pm-roles.schema.yaml`、メタ情報の意味は [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] を正本とします。
53
46
 
54
- ## 3. ファイル命名・ID規則
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` | 任意。採用判断の根拠となる先行成果物 / 置き換え対象を示すこと。適用範囲とライフサイクル管理はメタ情報標準に従う |
55
53
 
56
- - ファイル名は `pm-roles.yaml` を推奨する。
57
- - 配置先は `pm-organization.md`、`pm-members.yaml`、`pm-raci.md` と同じ組織定義ディレクトリに置く。
58
- - 推奨パス: `docs/ja/projects/<project-id>/030-project-management/pm-roles.yaml`
59
- - `project_id` は配置先プロジェクト ID と一致させる。例: `prj-0001`
60
- - `id` は `<project-id>:pm-roles` 形式を推奨する。例: `prj-0001:pm-roles`
61
- - `roles[].code` は標準 Role code の表記に合わせ、大文字の短いコードにする。例: `PO`, `PM`, `BA`
54
+ ## 5. 本文要件
62
55
 
63
- ## 4. 推奨メタ項目
56
+ メタ項目以外の本文キーは次の役割を担います。YAML の骨組みは Frontmatter で宣言した template、構造・型の詳細は対応 schema を正本とします。
64
57
 
65
- YAML 成果物のため、Markdown Frontmatter ではなく YAML 先頭のメタ項目として記載する。
66
- 機械検証は `docs/specdojo/schemas/v1/pm-roles.schema.yaml` を正本とする。
58
+ | キー | 必須・任意 | 目的・内容要件 |
59
+ | ---------------------- | ---------- | ------------------------------------------------------------------------------------------------------ |
60
+ | `roles` | 必須 | 採用した全 Role code の配列。`PO` を必ず含め、各コードを一意にする。組織定義で採用した集合と一致させる |
61
+ | `roles[].code` | 必須 | 下流の `owner`、RACI、メンバー定義を接続する識別子 |
62
+ | `roles[].name` | 必須 | 上位標準の正式名称により、コードが表す責務を識別する |
63
+ | `roles[].project_note` | 任意 | PO の判断に必要なプロジェクト固有の扱いを短く示す。補足がなければ省略する |
67
64
 
68
- | 項目 | 説明 | 必須 |
69
- | -------- | ---------------------------------------- | ---- |
70
- | `id` | `<project-id>:pm-roles` 形式の成果物 ID | ○ |
71
- | `type` | `project` 固定 | ○ |
72
- | `status` | `draft` / `ready` / `deprecated` | ○ |
73
- | `title` | ドキュメント名。表示ページの見出しになる | ○ |
65
+ ## 6. 記述ガイド
74
66
 
75
- | `rulebook` | `specdojo:pm-roles-rulebook` 固定 | ○ |
76
- | `based_on` | 根拠ドキュメント ID の配列 | 任意 |
77
- | `version` | データバージョン。初期値は `1` | ○ |
78
- | `project_id` | プロジェクト ID | ○ |
67
+ ### 6.1. メタ項目と根拠
79
68
 
80
- schema に定義されていないメタ項目は `pm-roles.yaml` には追加しない。
69
+ `based_on` は、実際に確認した採用判断の根拠を指します。カタログの依存関係がある場合は、その推移閉包内の先行成果物に限定します。新規作成は `draft` とし、`ready` への昇格は人間が判断します。
81
70
 
82
- ## 5. 本文構成(標準テンプレ)
71
+ | 判断点 | 良い例 | 悪い例 |
72
+ | ---------- | ------------------------------------------ | ---------------------------------------- |
73
+ | 根拠の選択 | 採用方針を確認した組織定義の ID を指定する | 同じディレクトリの文書を未確認で列挙する |
74
+ | 準拠先 | 成果物の `rulebook` に本書の ID を指定する | 計画側に記載済みとして成果物から省く |
83
75
 
84
- `pm-roles.yaml` は次のルート構造を標準とする。
76
+ ### 6.2. `roles` の採用範囲
85
77
 
86
- | 要素 | 必須 | 内容 |
87
- | ------------ | ---- | -------------------- |
88
- | `id` | ○ | 成果物 ID |
89
- | `type` | ○ | 成果物種別 |
90
- | `status` | ○ | 成果物状態 |
91
- | `title` | ○ | ドキュメント名 |
92
- | `rulebook` | ○ | 参照する rulebook ID |
93
- | `based_on` | 任意 | 根拠 ID 配列 |
94
- | `version` | ○ | データバージョン |
95
- | `project_id` | ○ | プロジェクト ID |
96
- | `roles` | ○ | 全 Role の配列 |
78
+ 組織定義の採用結果と、Schedule・RACI・メンバー定義の参照値を照合します。差分があれば一覧だけを追加・削除せず、採用判断と下流の使い方のどちらを改訂するかを先に確認します。記載順は上位標準の定義順を推奨します。
97
79
 
98
- `roles[]` は次のフィールドを標準とする。
80
+ | 判断点 | 良い例 | 悪い例 |
81
+ | ------------ | -------------------------------------------- | -------------------------------------------- |
82
+ | 最小構成 | 最終判断を担う `PO` を含む採用集合を転記する | 実作業だけを見て `BA` と `QE` だけを列挙する |
83
+ | 兼務時の扱い | 採用済みの `PM` を管理タスクの語彙として残す | 専任者がいないという理由だけで `PM` を除く |
99
84
 
100
- | フィールド | 必須 | 内容 |
101
- | -------------- | ---- | --------------------------------------------------------------------- |
102
- | `code` | ○ | Role code。標準 Role code を使う |
103
- | `name` | ○ | Role の正式名称 |
104
- | `project_note` | 任意 | プロジェクト固有の扱い、専任化条件、公開判断上の注意を 1 行で記述する |
85
+ ### 6.3. `roles[].code` と `roles[].name`
105
86
 
106
- ## 6. 記述ガイド
87
+ `code` は schema の標準コード `PO`、`PM`、`BA`、`ARC`、`DEV`、`QE`、`UX`、`OPS` に限定します。`name` は人と組織の定義標準の正式名称と対応させ、担当者や職位で置き換えません。
107
88
 
108
- ### 6.1. `roles`
89
+ | 判断点 | 良い例 | 悪い例 |
90
+ | -------- | ----------------------------------- | ------------------------------------ |
91
+ | 識別子 | `code: PM` を下流でも同じ表記で使う | `code: project-manager-agent` を使う |
92
+ | 正式名称 | `name: Project Manager` | `name: 開発部長` |
109
93
 
110
- - `roles` にはプロジェクトで使用する全 Role code を過不足なく記載する。
111
- - 記載順は標準ロールの定義順(`PO`, `PM`, `BA`, `ARC`, `DEV`, `QE`, `UX`, `OPS`)に揃えることを推奨する。
112
- - 標準 Role code のみを使用し、プロジェクト固有の独自コードを追加しない。
113
- - `roles[].code` は重複させない。
114
- - 専任 member がいない Role code でも、Schedule の `owner`、RACI、レビュー観点、下流文書で責務語彙として使う場合は残す。
94
+ ### 6.4. `roles[].project_note`
115
95
 
116
- ### 6.2. `roles[].code`
96
+ プロジェクト固有の責務強調、専任化を検討する条件、公開判断上の注意を 1 行で記述します。標準の一般責務と採用理由は各正本に委ねます。未決事項は `_UNDECIDED_:`、確認・追記待ちは `_TODO_:` で識別し、判断者・判断時点を示します。
117
97
 
118
- - `code` には標準 Role code のみを使用する。
119
- - プロジェクト固有の独自 Role code を定義しない。
120
- - 小文字、member nickname、agent 名、個人名、stakeholder ID を `code` にしない。
121
- - Schedule の `owner` や RACI の列で使う値と同じ表記にする。
98
+ | 判断点 | 良い例 | 悪い例 |
99
+ | ---------------- | ----------------------------------------------------- | ---------------------------------- |
100
+ | 判断できる条件 | 週次管理の滞留が続く場合、PO が PM の専任化を判断する | 必要に応じて管理する |
101
+ | 固有性 | 店頭の欠品と記録漏れを受入確認で重視する | 上位標準の品質責務を全文転記する |
102
+ | 実行主体との分離 | 実行主体はメンバー定義で管理する | PM は特定の個人や agent が担当する |
122
103
 
123
- ### 6.3. `roles[].name`
104
+ ### 6.5. 変更時の追従と完了判断
124
105
 
125
- - `name` には Role code の正式名称を記載する。
126
- - 略称だけ、プロジェクト固有の担当者名、組織内の職位名に置き換えない。
127
- - Role code と対応が分かる一般的な英語名を使う。
106
+ 改訂・廃止はメタ情報標準の「文書の改訂・廃止とライフサイクル変更管理」に従います。PM は組織定義、WBS・Schedule の `owner`、RACI、人間・Agent のメンバー定義、レビュー観点の参照を調べ、波及更新をタスク化します。ARC は参照・schema との整合、QE は機械検証と採用集合・コード重複・名称対応の照合を確認し、人間の PO が採用変更と公開可否を判断します。
128
107
 
129
- ### 6.4. `roles[].project_note`
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` の重複なし、組織定義の採用集合との差分なし、上位標準のコードと正式名称の組との差分なしを別途照合する。
130
109
 
131
- - プロジェクト固有の責務強調、専任化を検討する条件、公開判断上の注意を 1 行で記述する。
132
- - 標準に記載済みの一般的な責務を長く再掲しない。
133
- - member nickname、agent 名、個人名、具体的な兼務割り当ては書かない。
134
- - PO が承認、保留、差し戻しを判断できるよう、未決事項がある場合は _UNDECIDED_: または _TODO_: として残す。
135
- - 公開文書として再利用できる粒度にし、個別組織の内部事情や非公開運用を含めない。
136
- - 記載すべき内容がない場合は省略してよい。
110
+ | 判断点 | 良い例 | 悪い例 |
111
+ | ---------- | ---------------------------------------------------------------------------------------- | ------------------------------------------- |
112
+ | 変更完了 | 採用変更と参照元の追従を確認し、未決事項は担当 Role code と転送先を付けて PJR に引き継ぐ | YAML の構文が通ったことだけで変更完了にする |
113
+ | ロール削除 | 使用中の参照値と責務の移管先を確認してから除く | 専任者の離脱に合わせてコードだけを消す |
137
114
 
138
115
  ## 7. 禁止事項
139
116
 
140
- | 禁止事項 | 理由 |
141
- | -------------------------------------------------------------------------- | --------------------------------------------------- |
142
- | 標準にない独自 Role code を追加する | Schedule、RACI、member 定義との接続が壊れるため |
143
- | `roles[].code` に member nickname、agent 名、個人名、stakeholder ID を書く | Role と実行主体が混同されるため |
144
- | 兼務の割り当てや実行主体を本ファイルに記載する | member 名簿の責務であり重複管理になるため |
145
- | ロール採用の根拠・方針・見直し条件を長く記載する | `pm-organization.md` の責務であり重複管理になるため |
146
- | 公開できない個人情報、連絡先、非公開組織情報、アクセス情報を記載する | PO の公開可否判断と説明責任を損なうため |
147
- | AI Agent に最終承認、公開可否、説明責任を持たせる記述を置く | 人間の PO が最終判断を担う前提に反するため |
148
- | schema にない任意メタ項目を追加する | 機械検証と下流処理の互換性が壊れるため |
117
+ | 禁止事項 | 理由 |
118
+ | --------------------------------------------------------------------- | ------------------------------------------------ |
119
+ | schema にないキーを追加し、採用理由や兼務割り当てを独自構造で管理する | 機械処理の互換性と正本の責任境界を損なうため |
120
+ | 個人情報、連絡先、非公開組織情報、アクセス情報を固有メモに含める | 公開可能なロール定義として再利用できなくなるため |
121
+ | AI Agent に最終承認・公開可否・説明責任を持たせる | 人間の PO が最終判断を担う前提に反するため |
@@ -30,13 +30,14 @@ Progress Report Documentation Rulebook
30
30
 
31
31
  - 推奨: `pr-<yyyy-mm-dd>-<nn>.md`
32
32
  - 日付はISO形式、連番は2桁ゼロ埋めを推奨する。
33
+ - 文書 ID は `<project-id>:pr-<yyyy-mm-dd>-<nn>` 形式とする(例: `prj-0001:pr-2026-03-01-01`)。
33
34
 
34
35
  ## 4. 推奨 Frontmatter 項目
35
36
 
36
37
  | 項目 | 説明 | 必須 |
37
38
 
38
39
  | ------ | -------------------------------- | ---- |
39
- | id | `pr-<yyyy-mm-dd>-<nn>` | ○ |
40
+ | id | `<project-id>:pr-<yyyy-mm-dd>-<nn>` | ○ |
40
41
 
41
42
  | type | `project` | ○ |
42
43
  | status | `draft` / `ready` / `deprecated` | ○ |
@@ -17,7 +17,7 @@ specdojo:
17
17
 
18
18
  Assumptions, Constraints and Dependencies Documentation Rulebook
19
19
 
20
- 本書は、プロジェクトの成立条件、守るべき境界、外部または先行成果物への依存を、変更時に判断できる形で整理する規約である。構造・必須項目・禁止事項は本書を正とし、作り方は recipe、粒度は sample、記入の骨組みは template を参照する。
20
+ 本書は、プロジェクトの成立条件、守るべき境界、外部または先行成果物への依存を、変更時に判断できる形で整理する規約である。各項目から計画への影響、確認責任、変更時の記録先を追跡できることを目的とする。
21
21
 
22
22
  ## 1. 全体方針
23
23
 
@@ -33,8 +33,6 @@ Assumptions, Constraints and Dependencies Documentation Rulebook
33
33
 
34
34
  ### 2.1. 位置づけ
35
35
 
36
- 本書はスコープで定めた境界を受け、実行上の成立条件と変更時の判断材料を明示する。前提・制約・依存が変化した結果としてリスク、変更要求、計画へ影響を伝える。
37
-
38
36
  ```mermaid
39
37
  flowchart LR
40
38
  SCOPE["プロジェクトスコープ"]
@@ -50,64 +48,42 @@ flowchart LR
50
48
 
51
49
  ### 2.2. 用語定義
52
50
 
53
- | 用語 | 定義 |
54
- | -------- | -------------------------------------------------------------------------------------------- |
55
- | 前提条件 | プロジェクトの計画または進行が成立するものとして置く条件。崩れた場合の影響と確認方法を伴う。 |
56
- | 制約事項 | 予算、期限、公開範囲、技術選択、責務境界など、逸脱してはならない限界。 |
57
- | 依存関係 | 外部組織、サービス、先行成果物、意思決定などが提供または確定することを必要とする関係。 |
58
- | トリガー | 前提の崩壊、制約の逸脱、依存先の変化を検知して見直しを始める条件。 |
59
- | 所有者 | 項目の状態確認と一次対応を担うロールまたは責任者。最終判断者とは区別する。 |
51
+ | 用語 | 定義 |
52
+ | -------- | -------------------------------------------------------------------------- |
53
+ | トリガー | 前提の崩壊、制約の逸脱、依存先の変化を検知して見直しを始める条件。 |
54
+ | 所有者 | 項目の状態確認と一次対応を担うロールまたは責任者。最終判断者とは区別する。 |
60
55
 
61
56
  ## 3. ファイル命名・ID規則
62
57
 
63
- ### 3.1. 配置
64
-
65
- - 成果物は `docs/ja/projects/<project-id>/020-project-definition/prj-assumptions-constraints-dependencies.md` に配置する。
66
- - rulebook は `docs/ja/specdojo/rulebooks/prj-assumptions-constraints-dependencies-rulebook.md` に配置する。
67
- - recipe、sample、template は、それぞれ `docs/ja/specdojo/recipes/`、`samples/`、`templates/` の同じ prefix を持つファイルに配置する。
68
-
69
- ### 3.2. ドキュメント ID
58
+ ### 3.1. 成果物の配置と文書 ID
70
59
 
71
- - 成果物 ID: `<project-id>:prj-assumptions-constraints-dependencies`
72
- - rulebook ID: `specdojo:prj-assumptions-constraints-dependencies-rulebook`
73
- - 実践の型 ID: `specdojo:prj-assumptions-constraints-dependencies-recipe`、`specdojo:prj-assumptions-constraints-dependencies-sample`、`specdojo:prj-assumptions-constraints-dependencies-template`
60
+ - 配置・命名の共通規則は [[specdojo:docs-structure-guide|ドキュメント構成ガイド]] に従う。
61
+ - 本系統の成果物は `020-project-definition/prj-assumptions-constraints-dependencies.md` に配置し、文書 ID を `<project-id>:prj-assumptions-constraints-dependencies` とする。
62
+ - 文書 ID と、表の行を識別する項目 ID は区別する。別文書から行を追跡するときは、文書 ID と項目 ID の組で識別する。
74
63
 
75
- ### 3.3. ファイル名
64
+ ### 3.2. 項目 ID
76
65
 
77
- - 成果物: `prj-assumptions-constraints-dependencies.md`
78
- - 実践の型: `prj-assumptions-constraints-dependencies-{rulebook,recipe,sample,template}.md`
79
- - 日本語の表示名を使う場合も、ID とファイル名は一意で検索可能な英小文字・ハイフン区切りを維持する。
66
+ - 各登録行の必須キーは、前提条件では `ACD-A01`、制約事項では `ACD-C01`、依存関係では `ACD-D01` から始める。接頭辞に続く正の整数を種別ごとに既採番の最大値から順に増やし、2 桁未満はゼロ埋めする。100 件目以降は桁を増やす。
67
+ - 項目 ID は文書内で一意とし、採番後は内容の修正や並べ替えで変更しない。廃止した ID を別の条件に再利用しない。
68
+ - 種別を変更する場合は、旧項目を廃止して変更先の種別で新規採番し、変更記録に新旧 ID の対応と理由を残す。変更記録や登録簿でも同じ項目 ID を追跡キーに使う。
80
69
 
81
70
  ## 4. 推奨 Frontmatter 項目
82
71
 
83
- ### 4.1. 設定内容
84
-
85
- | 項目 | 説明 | 必須 |
86
- | ---------- | ------------------------------------------------------------ | ---- |
87
- | id | `<project-id>:prj-assumptions-constraints-dependencies` | ○ |
88
- | type | `project` | ○ |
89
- | status | `draft` / `ready` / `deprecated` | ○ |
90
- | rulebook | `specdojo:prj-assumptions-constraints-dependencies-rulebook` | ○ |
91
- | based_on | 直接参照した上位成果物の ID 配列 | 任意 |
92
- | supersedes | 置き換える旧成果物の ID 配列 | 任意 |
93
-
94
- ### 4.2. 推奨ルール
95
-
96
- - `based_on` には、内容の根拠として直接参照した文書だけを記載する。
97
- - 未確定事項は _TODO_:、意思決定待ちは _UNDECIDED_:、仮置きの前提は _ASSUMPTION_: で明示する。
98
- - H1 には成果物の表示名を置き、frontmatter に `title` を重複して持たせない。
72
+ - 共通項目の必須性、値・構文、未確定事項の目印は [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] を正とし、構造は `deliverable-frontmatter.schema.yaml` に従う。
73
+ - 本系統では `rulebook` に `specdojo:prj-assumptions-constraints-dependencies-rulebook` を必須で指定する。成果物の `type` は本書の `deliverable_type` に従う。
74
+ - `based_on` には、根拠として直接参照したスコープ・憲章などの上位成果物を記載する。計画や技術資料などへの影響先の参照と混同しない。
99
75
 
100
- ## 5. 本文構成(標準テンプレ)
76
+ ## 5. 本文要件
101
77
 
102
- 本文は以下の見出しを順序どおりに置く。
78
+ 次の各章を表の順序で必須とする。前提条件・制約事項・依存関係は項目 ID ごとに管理し、登録対象がない章も省略せず、該当なしの理由と追加時の条件を記載する。
103
79
 
104
- | 番号 | 見出し | 必須 | 内容 |
105
- | ---- | ------------------ | ---- | ------------------------------------------ |
106
- | 1 | 前提条件 | ○ | 成立条件、根拠、影響、監視、変化時の対応 |
107
- | 2 | 制約事項 | ○ | 守るべき限界、適用範囲、逸脱の検知、対応 |
108
- | 3 | 依存関係 | ○ | 依存先、必要な理由、成立条件、変化時の対応 |
109
- | 4 | 影響評価と対応方針 | ○ | 前提・制約・依存の変化に共通する評価と対応 |
110
- | 5 | 監視・変更管理 | ○ | 見直す契機、記録する情報、判断責任の扱い |
80
+ | 章 | 目的と必須の判断材料 |
81
+ | ------------------ | -------------------------------------------------------------------- |
82
+ | 前提条件 | 計画の成立に置く条件の根拠、崩れた場合の影響、確認と対応を示す。 |
83
+ | 制約事項 | 守るべき限界と適用範囲、逸脱の検知と対応を示す。 |
84
+ | 依存関係 | 他者から受ける条件、必要となる理由、成立の判定と変化時の対応を示す。 |
85
+ | 影響評価と対応方針 | 変化が後続成果物・計画に及ぼす影響、一次対応と最終判断の分担を示す。 |
86
+ | 監視・変更管理 | 見直し契機、変更記録の内容と記録先、追従更新と報告の責任を示す。 |
111
87
 
112
88
  ## 6. 記述ガイド
113
89
 
@@ -116,9 +92,10 @@ flowchart LR
116
92
  - 前提には、なぜその条件を置くかを示す根拠と、崩れた場合の影響を記載する。
117
93
  - 確認方法は「誰が何を見れば変化を検知できるか」が分かる表現にする。
118
94
  - 根拠が不足する場合は事実として断定せず、_ASSUMPTION_: または _TODO_: として確認先を残す。
119
- - スコープで定義済みの境界に該当する前提は再掲せず、章冒頭でスコープの該当章へ委譲する。追加する前提がない場合は、その旨と追加時の記載条件を明記する(章は省略しない)。
95
+ - スコープで定義済みの境界に該当する前提は、章冒頭でスコープの該当章へ委譲する。委譲先に条件が実在することを確認し、参照だけで未定義の条件を補ったことにしない。
96
+ - リポジトリ、端末、作業環境、外部ツールなど、外部から継続的に提供される基盤の可用性は「依存関係」として扱う。人の参加見込みを前提とする場合も、特定の助言・承認・成果物を受け取る条件は依存関係として分ける。
120
97
 
121
- - リポジトリ、作業環境、外部ツールなど、外部から継続的に提供される基盤の可用性は、前提条件ではなく依存関係(6.3.)として扱う。
98
+ 良い例: 「代表試行への協力者を確保できる」に、募集の根拠、試行前の確認者、未確保時の延期判断を添える。悪い例: 「店頭で使う端末を利用できる」を前提に登録する、またはスコープで確定済みの単一店舗運用を再掲する。
122
99
 
123
100
  推奨表:
124
101
 
@@ -130,7 +107,9 @@ flowchart LR
130
107
  - 制約には、適用範囲と、逸脱したと判断する条件を記載する。
131
108
  - 技術制約は、特定製品名の列挙ではなく、選択の自由度、互換性、公開適性、運用上の限界として書く。
132
109
  - 公開情報の制約は、個人情報・機密情報・非公開情報を扱わない方針と、検知時の除去または判断手順を併記する。
133
- - スコープの対象外・境界の判断基準と同内容の制約は再掲しない。本章では、上位文書に現れない運用上の制約だけを扱う。
110
+ - スコープの対象外・境界の判断基準と同内容の制約は再掲しない。本章では、追加の運用制約、または「全体方針」に従って監視・対応を補う制約を扱う。
111
+
112
+ 良い例: 「承認済み予算枠がない間は追加支出を開始しない」に、発注前の承認証跡確認と、未承認時に人間の責任者へ判断を求める対応を添える。悪い例: 「予算に注意する」とだけ書き、適用範囲と逸脱条件を示さない。
134
113
 
135
114
  推奨表:
136
115
 
@@ -140,14 +119,20 @@ flowchart LR
140
119
  ### 6.3. 依存関係
141
120
 
142
121
  - 依存先は、外部サービスだけでなく、先行成果物、承認、意思決定、提供物も含めて明示する。
143
- - 依存が満たされた状態を、受領物、確認条件、期限または判断イベントで書く。
122
+ - 「受領・成立条件」には、成立したと判定する状態と、誰が何の証跡をいつ確認するかの両方を記載する。期限または判断イベントを示し、検証手順が別文書にある場合はその正本を参照する。
123
+ - 成果物の作成・受入を依存とする場合は、対象成果物 ID、適用する受入条件・品質ゲート、証跡の正本を参照できるようにする。単に本書の根拠として読んだ文書は、その理由だけで依存先にしない。
144
124
  - 依存先の詳細な契約条件や実装方式は、必要な管理・設計成果物へ委譲する。
145
125
  - 意思決定待ちの依存は、プロジェクト登録簿の項目として登録し、本書からは登録項目 ID を参照する。決定後に本書へ影響がある場合は該当項目へ反映する。
126
+ - 複数の判断を含む依存では、決定記録で確定した部分と未決部分を分離する。一部の決定だけで依存全体を成立済みとしない。
127
+
128
+ 良い例: 店頭端末を依存先とし、「営業時間中に利用者代表が記録できることを、営業開始前の動作確認で確かめる」と書く。悪い例: 「端末がある」「承認済み」とだけ書き、利用可能性や承認対象を確かめる証跡を示さない。
146
129
 
147
130
  推奨表:
148
131
 
149
- | ID | 内容または依存先 | 影響・必要な理由 | 確認方法または成立条件 | トリガー | 所有者 | 対応方針 |
150
- | --- | ---------------- | ---------------- | ---------------------- | -------- | ------ | -------- |
132
+ | ID | 依存先・条件 | 必要となる理由 | 受領・成立条件 | 変化のトリガー | 所有者 | 対応方針 |
133
+ | --- | ------------ | -------------- | -------------- | -------------- | ------ | -------- |
134
+
135
+ 表の各列は必須の意味を表す。「依存先・条件」は受ける提供物・判断・継続提供を、「必要となる理由」はそれが必要な作業と不成立時の影響を示す。
151
136
 
152
137
  ### 6.4. 影響評価と対応方針
153
138
 
@@ -155,6 +140,8 @@ flowchart LR
155
140
  - 対応方針には、除去、軽減、受容、再判断のいずれを行うかと、次に判断する人を記載する。
156
141
  - 一次対応を担うロールと最終判断者を区別し、人間の判断が必要な範囲を明示する。
157
142
 
143
+ 良い例: 「依存先の受入が遅れたら、所有者が影響する成果物と作業を特定し、PM が順序・期日の変更案をまとめ、人間の責任者が開始可否を判断する」と書く。悪い例: 「遅れたら調整する」とだけ書き、影響先と次の判断者を示さない。
144
+
158
145
  推奨表:
159
146
 
160
147
  | 変化の種別 | 主な影響領域 | 最初に確認すること | 一次対応・判断 | 対応方針 |
@@ -163,8 +150,12 @@ flowchart LR
163
150
  ### 6.5. 監視・変更管理
164
151
 
165
152
  - 「定期的に確認する」ではなく、スコープまたは実践の型一式が変わったときなど、具体的な見直しの契機を記載する。
166
- - 変更記録には、項目 ID、変化内容、影響範囲、判断者、対応状況を残す。記録先はプロジェクト登録簿を第一候補とし、未定なら _TODO_: とする。
153
+ - 変更記録には、項目 ID、変化内容、影響範囲、判断者、対応状況、再確認時期を残す。記録先はプロジェクト登録簿を第一候補とし、未定なら _TODO_: とする。
154
+ - 発生済みの支障は課題、将来の不確実な影響はリスク、承認済み範囲・計画の変更提案は変更要求、判断結果は決定記録へ接続する。PM が記録先・報告先を明示し、関連する Schedule の作業や PJR 項目から項目 ID を追跡できるようにする。
167
155
  - 文書構造・配置・命名・技術制約・参照資料の整合確認を担うロールと、公開可否やスコープ変更などの最終判断を行う人間の責任者を区別して明示する。
156
+ - 改訂・廃止時の共通手順は [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] の「文書の改訂・廃止とライフサイクル変更管理」に従う。本系統では PM が計画・Schedule・PJR の追従作業を管理し、ARC が参照と技術制約、QE が受入条件・検証への影響を確認する。
157
+
158
+ 良い例: 「端末の利用不能を検知したら、所有者が対象 ID と影響作業を課題に記録し、PM が代替策と再確認時期を報告する。開始条件が変わる場合は変更要求として人間の責任者へ上げる」と書く。悪い例: 「必要に応じて更新する」とだけ書き、記録先と判断責任を示さない。
168
159
 
169
160
  ## 7. 禁止事項
170
161