specdojo 0.6.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 (366) hide show
  1. package/.github/agents/specdojo-orchestrator.md +3 -2
  2. package/CHANGELOG.md +193 -0
  3. package/README.md +2 -2
  4. package/dist/catalog/build.js +24 -1
  5. package/dist/catalog/plan.js +1 -1
  6. package/dist/catalog/scaffold.js +4 -1
  7. package/dist/commands/agent.js +33 -0
  8. package/dist/commands/init.js +6 -1
  9. package/dist/commands/night-orchestrator.js +6 -4
  10. package/dist/commands/orchestrator.js +10 -1
  11. package/dist/dashboard/dashboard-timeline.js +18 -16
  12. package/dist/dashboard/dashboard.js +612 -259
  13. package/dist/dashboard/epic-plan.js +81 -0
  14. package/dist/dashboard/exec-records.js +16 -20
  15. package/dist/dashboard/routines.js +8 -6
  16. package/dist/dashboard/timeline-build.js +5 -9
  17. package/dist/dashboard/timeline.js +9 -4
  18. package/dist/devcontainer/command.js +18 -0
  19. package/dist/devcontainer/host-script.js +21 -0
  20. package/dist/devcontainer/scaffold.js +22 -3
  21. package/dist/docs/frontmatter-namespace.js +1 -48
  22. package/dist/docs/yaml-pages.js +125 -3
  23. package/dist/exec/agent-config.js +22 -0
  24. package/dist/exec/agent-plan.js +3 -2
  25. package/dist/exec/antigravity-session.js +154 -0
  26. package/dist/exec/commands.js +69 -21
  27. package/dist/exec/commit-hook-skips.js +78 -0
  28. package/dist/exec/core.js +19 -7
  29. package/dist/exec/events.js +159 -8
  30. package/dist/exec/evidence.js +64 -16
  31. package/dist/exec/handoff.js +9 -13
  32. package/dist/exec/limit.js +1 -1
  33. package/dist/exec/mechanical-result.js +45 -0
  34. package/dist/exec/migrate-records.js +249 -0
  35. package/dist/exec/parent-validation.js +160 -12
  36. package/dist/exec/pipeline-state.js +27 -5
  37. package/dist/exec/plan-markdownlint.js +89 -0
  38. package/dist/exec/plans-condense-findings.js +89 -0
  39. package/dist/exec/plans-core.js +24 -17
  40. package/dist/exec/plans-generation.js +52 -25
  41. package/dist/exec/plans-grade-findings.js +8 -3
  42. package/dist/exec/plans-kata-findings.js +61 -0
  43. package/dist/exec/plans-planning.js +3 -3
  44. package/dist/exec/plans-storage.js +12 -24
  45. package/dist/exec/register-resume.js +69 -42
  46. package/dist/exec/register.js +26 -22
  47. package/dist/exec/repo-integration-sync.js +8 -4
  48. package/dist/exec/repo-integration.js +21 -1
  49. package/dist/exec/reporter.js +121 -23
  50. package/dist/exec/results.js +85 -24
  51. package/dist/exec/review-completion.js +47 -0
  52. package/dist/exec/review-kata.js +109 -0
  53. package/dist/exec/run/agent-pipeline.js +75 -6
  54. package/dist/exec/run/agent.js +20 -7
  55. package/dist/exec/run/in-place.js +69 -32
  56. package/dist/exec/run/job.js +81 -24
  57. package/dist/exec/run/lifecycle-commands.js +264 -43
  58. package/dist/exec/run/mode-shared.js +11 -3
  59. package/dist/exec/run/register-command.js +12 -10
  60. package/dist/exec/run/register-core.js +20 -13
  61. package/dist/exec/run/register-mode.js +12 -12
  62. package/dist/exec/run/register-post-review.js +21 -9
  63. package/dist/exec/run/register-resume.js +28 -18
  64. package/dist/exec/run/register-state.js +10 -7
  65. package/dist/exec/run/register-worktree.js +60 -30
  66. package/dist/exec/run/schedule-mode.js +26 -6
  67. package/dist/exec/run/schedule-prepare.js +228 -45
  68. package/dist/exec/run/schedule-task.js +132 -25
  69. package/dist/exec/run/shared.js +4 -3
  70. package/dist/exec/run/trailing-records.js +35 -0
  71. package/dist/exec/run-records.js +2 -0
  72. package/dist/exec/strategy.js +1 -0
  73. package/dist/exec/trailing-records.js +242 -0
  74. package/dist/exec/trial-commands.js +3 -2
  75. package/dist/exec/validate-records-commit.js +110 -0
  76. package/dist/exec/validate-records.js +148 -0
  77. package/dist/exec/worktree-command.js +29 -16
  78. package/dist/exec/worktree-ops-commit.js +118 -59
  79. package/dist/exec/worktree-ops-lifecycle.js +77 -44
  80. package/dist/exec/worktree-ops-merge.js +13 -2
  81. package/dist/exec/worktree-ops.js +2 -2
  82. package/dist/exec/worktree.js +19 -2
  83. package/dist/grade/apply.js +32 -6
  84. package/dist/grade/command-inspect.js +2 -2
  85. package/dist/grade/command-run.js +2 -0
  86. package/dist/grade/command-shared.js +1 -1
  87. package/dist/grade/core.js +18 -5
  88. package/dist/grade/markdown.js +3 -3
  89. package/dist/grade/pipeline-state.js +15 -11
  90. package/dist/grade/plan.js +37 -17
  91. package/dist/grade/result.js +3 -3
  92. package/dist/grade/run.js +23 -3
  93. package/dist/grade/target-discovery.js +17 -4
  94. package/dist/grade/targets.js +12 -11
  95. package/dist/job/job.js +31 -17
  96. package/dist/job/noop.js +104 -0
  97. package/dist/register/core.js +2 -0
  98. package/dist/register/create-commands.js +28 -3
  99. package/dist/register/deliverable-target.js +9 -1
  100. package/dist/register/epic.js +104 -26
  101. package/dist/register/event-merge.js +3 -0
  102. package/dist/register/events.js +4 -0
  103. package/dist/register/external-project.js +3 -0
  104. package/dist/register/item.js +6 -0
  105. package/dist/register/maintenance-commands.js +4 -1
  106. package/dist/register/planning.js +7 -14
  107. package/dist/register/register.js +74 -32
  108. package/dist/register/track-domains.js +34 -0
  109. package/dist/register/track-plan.js +78 -0
  110. package/dist/register/transition-commands.js +8 -0
  111. package/dist/register/work-table.js +64 -0
  112. package/dist/review/grade.js +35 -13
  113. package/dist/routine/definition.js +4 -3
  114. package/dist/routine/failure.js +30 -0
  115. package/dist/routine/routine.js +56 -32
  116. package/dist/routine/storage.js +33 -0
  117. package/dist/schedule/schedule.js +1 -0
  118. package/dist/schedule/strategy-generate-document.js +26 -14
  119. package/dist/schedule/strategy-generate-scope.js +17 -45
  120. package/dist/schedule/strategy-generate.js +33 -3
  121. package/dist/schedule/strategy-profiles.js +86 -12
  122. package/dist/shared/agent-types.js +2 -0
  123. package/dist/shared/condense-records.js +25 -0
  124. package/dist/shared/deprecation.js +8 -0
  125. package/dist/shared/document-metadata.js +20 -0
  126. package/dist/shared/finding-cause.js +20 -0
  127. package/dist/shared/frontmatter-namespace.js +48 -0
  128. package/dist/shared/git.js +149 -15
  129. package/dist/shared/grade-result.js +17 -1
  130. package/dist/shared/local-state.js +20 -0
  131. package/dist/shared/markdownlint-config.js +8 -3
  132. package/dist/shared/plan-conventions.js +129 -0
  133. package/dist/shared/plan-templates.js +57 -41
  134. package/dist/shared/provider-scaffold.js +2 -0
  135. package/dist/shared/run-records.js +224 -0
  136. package/dist/shared/specdojo-config.js +39 -21
  137. package/dist/shared/specdojo-gitignore.js +1 -0
  138. package/dist/shared/text.js +65 -5
  139. package/dist/shared/timeline-index.js +2 -0
  140. package/docs/ja/specdojo/defaults/pm-review-viewpoints.yaml +11 -2
  141. package/docs/ja/specdojo/exec-templates/xep-common-conventions-template.md +4 -74
  142. package/docs/ja/specdojo/exec-templates/xep-condense-template.md +50 -0
  143. package/docs/ja/specdojo/exec-templates/xep-draft-template.md +17 -5
  144. package/docs/ja/specdojo/exec-templates/xep-fully-guided-template.md +16 -3
  145. package/docs/ja/specdojo/exec-templates/xep-recipe-guided-template.md +15 -5
  146. package/docs/ja/specdojo/exec-templates/xep-recipe-maintenance-template.md +6 -0
  147. package/docs/ja/specdojo/exec-templates/xep-register-template.md +1 -1
  148. package/docs/ja/specdojo/exec-templates/xep-rulebook-maintenance-template.md +6 -0
  149. package/docs/ja/specdojo/exec-templates/xep-sample-maintenance-template.md +6 -0
  150. package/docs/ja/specdojo/exec-templates/xep-template-maintenance-template.md +6 -0
  151. package/docs/ja/specdojo/exec-templates/xer-condense-template.md +25 -0
  152. package/docs/ja/specdojo/exec-templates/xp-common-conventions-template.md +50 -0
  153. package/docs/ja/specdojo/exec-templates/xrp-common-conventions-template.md +30 -0
  154. package/docs/ja/specdojo/guides/branch-workflow-guide.md +1 -1
  155. package/docs/ja/specdojo/guides/docs-editing-guide.md +48 -0
  156. package/docs/ja/specdojo/guides/docs-structure-guide.md +48 -15
  157. package/docs/ja/specdojo/guides/exec-config-guide.md +61 -28
  158. package/docs/ja/specdojo/guides/exec-operation-guide.md +61 -13
  159. package/docs/ja/specdojo/guides/exec-worktree-guide.md +20 -11
  160. package/docs/ja/specdojo/guides/orchestrator-operation-guide.md +4 -2
  161. package/docs/ja/specdojo/guides/plan-result-lifecycle-guide.md +92 -55
  162. package/docs/ja/specdojo/guides/project-move-guide.md +381 -0
  163. package/docs/ja/specdojo/guides/quick-start-guide.md +589 -807
  164. package/docs/ja/specdojo/guides/register-operation-guide.md +26 -4
  165. package/docs/ja/specdojo/guides/remote-host-development-guide.md +33 -4
  166. package/docs/ja/specdojo/guides/review-guide.md +22 -19
  167. package/docs/ja/specdojo/guides/routine-operation-guide.md +14 -8
  168. package/docs/ja/specdojo/guides/ryu-guide.md +23 -13
  169. package/docs/ja/specdojo/guides/schedule-design-guide.md +7 -4
  170. package/docs/ja/specdojo/guides/schedule-operation-guide.md +41 -3
  171. package/docs/ja/specdojo/guides/specdojo-overview-guide.md +5 -4
  172. package/docs/ja/specdojo/guides/timeline-design-guide.md +27 -144
  173. package/docs/ja/specdojo/guides/use-case-guide.md +471 -74
  174. package/docs/ja/specdojo/recipes/bac-recipe.md +94 -0
  175. package/docs/ja/specdojo/recipes/bes-recipe.md +105 -0
  176. package/docs/ja/specdojo/recipes/br-recipe.md +84 -0
  177. package/docs/ja/specdojo/recipes/cdfd-overview-recipe.md +88 -86
  178. package/docs/ja/specdojo/recipes/cdfd-uc-recipe.md +108 -122
  179. package/docs/ja/specdojo/recipes/cnd-recipe.md +125 -0
  180. package/docs/ja/specdojo/recipes/cpd-recipe.md +126 -0
  181. package/docs/ja/specdojo/recipes/cxd-recipe.md +145 -0
  182. package/docs/ja/specdojo/recipes/ifd-recipe.md +134 -0
  183. package/docs/ja/specdojo/recipes/ifx-cmd-recipe.md +135 -86
  184. package/docs/ja/specdojo/recipes/ifx-index-recipe.md +130 -0
  185. package/docs/ja/specdojo/recipes/pm-organization-recipe.md +29 -26
  186. package/docs/ja/specdojo/recipes/pm-plan-recipe.md +35 -26
  187. package/docs/ja/specdojo/recipes/pm-quality-management-plan-recipe.md +38 -28
  188. package/docs/ja/specdojo/recipes/pm-raci-recipe.md +39 -31
  189. package/docs/ja/specdojo/recipes/pm-roles-recipe.md +26 -28
  190. package/docs/ja/specdojo/recipes/prj-assumptions-constraints-dependencies-recipe.md +10 -8
  191. package/docs/ja/specdojo/recipes/prj-comparison-of-alternatives-recipe.md +18 -17
  192. package/docs/ja/specdojo/recipes/stsd-recipe.md +100 -62
  193. package/docs/ja/specdojo/recipes/sysd-critical-flows-recipe.md +106 -0
  194. package/docs/ja/specdojo/recipes/sysd-cross-cutting-policy-recipe.md +137 -0
  195. package/docs/ja/specdojo/recipes/sysd-index-recipe.md +122 -0
  196. package/docs/ja/specdojo/references/command-reference.md +146 -99
  197. package/docs/ja/specdojo/references/deliverables-reference.md +9 -4
  198. package/docs/ja/specdojo/references/directory-layout-reference.md +3 -2
  199. package/docs/ja/specdojo/references/specdojo-config-reference.md +17 -16
  200. package/docs/ja/specdojo/rulebooks/bac-rulebook.md +72 -290
  201. package/docs/ja/specdojo/rulebooks/bdd-rulebook.md +212 -79
  202. package/docs/ja/specdojo/rulebooks/bds-rulebook.md +138 -154
  203. package/docs/ja/specdojo/rulebooks/bes-index-rulebook.md +147 -59
  204. package/docs/ja/specdojo/rulebooks/bes-rulebook.md +100 -96
  205. package/docs/ja/specdojo/rulebooks/br-rulebook.md +88 -108
  206. package/docs/ja/specdojo/rulebooks/ccd-mermaid-rulebook.md +126 -211
  207. package/docs/ja/specdojo/rulebooks/cdfd-d2-rulebook.md +367 -0
  208. package/docs/ja/specdojo/rulebooks/cdfd-mermaid-rulebook.md +6 -5
  209. package/docs/ja/specdojo/rulebooks/cdfd-overview-rulebook.md +96 -100
  210. package/docs/ja/specdojo/rulebooks/cdfd-rulebook.md +38 -47
  211. package/docs/ja/specdojo/rulebooks/cdfd-uc-rulebook.md +132 -106
  212. package/docs/ja/specdojo/rulebooks/cdsd-rulebook.md +102 -68
  213. package/docs/ja/specdojo/rulebooks/cdt-rulebook.md +152 -0
  214. package/docs/ja/specdojo/rulebooks/cld-rulebook.md +9 -184
  215. package/docs/ja/specdojo/rulebooks/clis-rulebook.md +187 -0
  216. package/docs/ja/specdojo/rulebooks/cnd-rulebook.md +93 -247
  217. package/docs/ja/specdojo/rulebooks/cpd-rulebook.md +104 -241
  218. package/docs/ja/specdojo/rulebooks/cxd-rulebook.md +124 -257
  219. package/docs/ja/specdojo/rulebooks/dct-index-rulebook.md +87 -98
  220. package/docs/ja/specdojo/rulebooks/dct-rulebook.md +9 -7
  221. package/docs/ja/specdojo/rulebooks/dec-rulebook.md +2 -1
  222. package/docs/ja/specdojo/rulebooks/dss-rulebook.md +193 -0
  223. package/docs/ja/specdojo/rulebooks/gl-rulebook.md +100 -54
  224. package/docs/ja/specdojo/rulebooks/ifd-mermaid-rulebook.md +69 -252
  225. package/docs/ja/specdojo/rulebooks/ifx-cmd-rulebook.md +91 -76
  226. package/docs/ja/specdojo/rulebooks/ifx-file-rulebook.md +252 -226
  227. package/docs/ja/specdojo/rulebooks/ifx-index-rulebook.md +118 -40
  228. package/docs/ja/specdojo/rulebooks/imp-business-rulebook.md +11 -11
  229. package/docs/ja/specdojo/rulebooks/imp-data-rulebook.md +9 -9
  230. package/docs/ja/specdojo/rulebooks/imp-interface-rulebook.md +4 -4
  231. package/docs/ja/specdojo/rulebooks/imp-operations-rulebook.md +11 -11
  232. package/docs/ja/specdojo/rulebooks/imp-test-rulebook.md +11 -11
  233. package/docs/ja/specdojo/rulebooks/mm-rulebook.md +4 -3
  234. package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +34 -29
  235. package/docs/ja/specdojo/rulebooks/pm-change-request-log-rulebook.md +8 -8
  236. package/docs/ja/specdojo/rulebooks/pm-issue-log-rulebook.md +2 -2
  237. package/docs/ja/specdojo/rulebooks/pm-organization-rulebook.md +50 -56
  238. package/docs/ja/specdojo/rulebooks/pm-plan-rulebook.md +46 -55
  239. package/docs/ja/specdojo/rulebooks/pm-quality-management-plan-rulebook.md +57 -54
  240. package/docs/ja/specdojo/rulebooks/pm-raci-rulebook.md +50 -65
  241. package/docs/ja/specdojo/rulebooks/pm-risk-register-rulebook.md +2 -2
  242. package/docs/ja/specdojo/rulebooks/pm-roles-rulebook.md +70 -97
  243. package/docs/ja/specdojo/rulebooks/pr-rulebook.md +2 -1
  244. package/docs/ja/specdojo/rulebooks/prj-assumptions-constraints-dependencies-rulebook.md +47 -56
  245. package/docs/ja/specdojo/rulebooks/prj-comparison-of-alternatives-rulebook.md +61 -135
  246. package/docs/ja/specdojo/rulebooks/sf-index-rulebook.md +116 -32
  247. package/docs/ja/specdojo/rulebooks/sf-rulebook.md +118 -61
  248. package/docs/ja/specdojo/rulebooks/sld-rulebook.md +152 -57
  249. package/docs/ja/specdojo/rulebooks/stsd-mermaid-rulebook.md +51 -39
  250. package/docs/ja/specdojo/rulebooks/stsd-rulebook.md +101 -46
  251. package/docs/ja/specdojo/rulebooks/sysd-critical-flows-rulebook.md +72 -329
  252. package/docs/ja/specdojo/rulebooks/sysd-cross-cutting-policy-rulebook.md +74 -263
  253. package/docs/ja/specdojo/rulebooks/sysd-index-rulebook.md +78 -195
  254. package/docs/ja/specdojo/rulebooks/tml-rulebook.md +4 -9
  255. package/docs/ja/specdojo/rulebooks/trc-requirements-to-specs-rulebook.md +3 -4
  256. package/docs/ja/specdojo/rulebooks/trc-requirements-to-tests-rulebook.md +3 -3
  257. package/docs/ja/specdojo/rulebooks/uis-rulebook.md +140 -143
  258. package/docs/ja/specdojo/samples/bac-sample.md +106 -21
  259. package/docs/ja/specdojo/samples/bdd-sample.yaml +143 -35
  260. package/docs/ja/specdojo/samples/bds-sample.md +100 -21
  261. package/docs/ja/specdojo/samples/bes-index-sample.md +59 -20
  262. package/docs/ja/specdojo/samples/bes-sample.md +80 -21
  263. package/docs/ja/specdojo/samples/br-sample.md +68 -14
  264. package/docs/ja/specdojo/samples/ccd-sample.md +81 -19
  265. package/docs/ja/specdojo/samples/cdfd-overview-sample.md +248 -140
  266. package/docs/ja/specdojo/samples/cdfd-sample.md +172 -99
  267. package/docs/ja/specdojo/samples/cdfd-uc-sample.md +130 -97
  268. package/docs/ja/specdojo/samples/cdsd-sample.md +89 -20
  269. package/docs/ja/specdojo/samples/cdt-sample.md +116 -0
  270. package/docs/ja/specdojo/samples/cld-sample.md +3 -30
  271. package/docs/ja/specdojo/samples/clis-sample.md +132 -0
  272. package/docs/ja/specdojo/samples/cnd-sample.md +127 -21
  273. package/docs/ja/specdojo/samples/cpd-sample.md +136 -22
  274. package/docs/ja/specdojo/samples/cxd-sample.md +108 -22
  275. package/docs/ja/specdojo/samples/dct-index-sample.yaml +63 -17
  276. package/docs/ja/specdojo/samples/dss-sample.md +175 -0
  277. package/docs/ja/specdojo/samples/gl-sample.yaml +50 -14
  278. package/docs/ja/specdojo/samples/ifd-sample.md +105 -21
  279. package/docs/ja/specdojo/samples/ifx-cmd-sample.yaml +91 -60
  280. package/docs/ja/specdojo/samples/ifx-file-sample.md +462 -21
  281. package/docs/ja/specdojo/samples/ifx-index-sample.yaml +87 -19
  282. package/docs/ja/specdojo/samples/pm-members-sample.yaml +37 -13
  283. package/docs/ja/specdojo/samples/pm-organization-sample.md +52 -20
  284. package/docs/ja/specdojo/samples/pm-plan-sample.md +84 -26
  285. package/docs/ja/specdojo/samples/pm-quality-management-plan-sample.md +55 -22
  286. package/docs/ja/specdojo/samples/pm-raci-sample.md +69 -28
  287. package/docs/ja/specdojo/samples/pm-roles-sample.yaml +13 -12
  288. package/docs/ja/specdojo/samples/prj-assumptions-constraints-dependencies-sample.md +50 -26
  289. package/docs/ja/specdojo/samples/prj-comparison-of-alternatives-sample.md +89 -62
  290. package/docs/ja/specdojo/samples/sf-index-sample.md +89 -20
  291. package/docs/ja/specdojo/samples/sf-sample.md +121 -21
  292. package/docs/ja/specdojo/samples/sld-sample.md +107 -21
  293. package/docs/ja/specdojo/samples/stsd-sample.md +54 -26
  294. package/docs/ja/specdojo/samples/sysd-critical-flows-sample.md +166 -21
  295. package/docs/ja/specdojo/samples/sysd-cross-cutting-policy-sample.md +178 -21
  296. package/docs/ja/specdojo/samples/sysd-index-sample.md +82 -21
  297. package/docs/ja/specdojo/samples/tml-sample.yaml +4 -1
  298. package/docs/ja/specdojo/samples/uis-sample.md +164 -20
  299. package/docs/ja/specdojo/standards/document-metadata-standard.md +33 -4
  300. package/docs/ja/specdojo/standards/id-and-file-naming-standard.md +3 -1
  301. package/docs/ja/specdojo/standards/rulebook-authoring-standard.md +1 -0
  302. package/docs/ja/specdojo/templates/bac-template.md +76 -0
  303. package/docs/ja/specdojo/templates/bes-template.md +56 -0
  304. package/docs/ja/specdojo/templates/br-template.md +64 -0
  305. package/docs/ja/specdojo/templates/cdfd-overview-template.md +161 -83
  306. package/docs/ja/specdojo/templates/cdfd-template.md +81 -54
  307. package/docs/ja/specdojo/templates/cdfd-uc-template.md +130 -89
  308. package/docs/ja/specdojo/templates/cnd-template.md +137 -0
  309. package/docs/ja/specdojo/templates/cpd-template.md +129 -0
  310. package/docs/ja/specdojo/templates/cxd-template.md +105 -0
  311. package/docs/ja/specdojo/templates/dct-data-model-cdt-template.yaml +40 -0
  312. package/docs/ja/specdojo/templates/dct-data-model-cld-template.yaml +7 -14
  313. package/docs/ja/specdojo/templates/dct-index-template.md +9 -20
  314. package/docs/ja/specdojo/templates/dct-project-management-template.yaml +5 -1
  315. package/docs/ja/specdojo/templates/ifd-template.md +86 -0
  316. package/docs/ja/specdojo/templates/ifx-cmd-template.yaml +44 -28
  317. package/docs/ja/specdojo/templates/ifx-index-template.yaml +40 -0
  318. package/docs/ja/specdojo/templates/opr-template.md +2 -4
  319. package/docs/ja/specdojo/templates/pm-organization-template.md +9 -3
  320. package/docs/ja/specdojo/templates/pm-plan-template.md +4 -4
  321. package/docs/ja/specdojo/templates/pm-quality-management-plan-template.md +17 -9
  322. package/docs/ja/specdojo/templates/pm-raci-template.md +24 -13
  323. package/docs/ja/specdojo/templates/pm-roles-template.yaml +3 -2
  324. package/docs/ja/specdojo/templates/prj-assumptions-constraints-dependencies-template.md +6 -3
  325. package/docs/ja/specdojo/templates/prj-comparison-of-alternatives-template.md +22 -19
  326. package/docs/ja/specdojo/templates/stsd-template.md +46 -21
  327. package/docs/ja/specdojo/templates/sysd-critical-flows-template.md +94 -0
  328. package/docs/ja/specdojo/templates/sysd-cross-cutting-policy-template.md +122 -0
  329. package/docs/ja/specdojo/templates/sysd-index-template.md +89 -0
  330. package/docs/specdojo/lib/yaml-metadata.cjs +7 -0
  331. package/docs/specdojo/schemas/v1/bdd.schema.yaml +25 -57
  332. package/docs/specdojo/schemas/v1/condense-records.schema.yaml +26 -0
  333. package/docs/specdojo/schemas/v1/dct.schema.yaml +10 -0
  334. package/docs/specdojo/schemas/v1/deliverable-frontmatter.schema.yaml +3 -0
  335. package/docs/specdojo/schemas/v1/esil.schema.yaml +7 -141
  336. package/docs/specdojo/schemas/v1/exec-common.schema.yaml +3 -0
  337. package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +54 -3
  338. package/docs/specdojo/schemas/v1/exec-evidence.schema.yaml +3 -0
  339. package/docs/specdojo/schemas/v1/exec-plan-frontmatter.schema.yaml +14 -0
  340. package/docs/specdojo/schemas/v1/exec-result-frontmatter.schema.yaml +18 -0
  341. package/docs/specdojo/schemas/v1/finding-cause.schema.yaml +22 -0
  342. package/docs/specdojo/schemas/v1/grade-pipeline-state.schema.yaml +1 -1
  343. package/docs/specdojo/schemas/v1/grade-result.schema.yaml +2 -0
  344. package/docs/specdojo/schemas/v1/ifx-cmd.schema.yaml +65 -5
  345. package/docs/specdojo/schemas/v1/ifx-index.schema.yaml +142 -0
  346. package/docs/specdojo/schemas/v1/register-events.schema.yaml +2 -0
  347. package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +17 -1
  348. package/docs/specdojo/schemas/v1/specdojo-config.schema.yaml +1 -0
  349. package/package.json +6 -3
  350. package/templates/antigravity/README.md +19 -46
  351. package/templates/antigravity/exec-defaults-snippet.yaml +5 -6
  352. package/templates/antigravity/orchestrator.md +3 -2
  353. package/templates/antigravity/settings.edit.json +73 -0
  354. package/templates/antigravity/settings.orchestrator.json +15 -0
  355. package/templates/antigravity/settings.report.json +7 -0
  356. package/templates/antigravity/settings.review.json +7 -0
  357. package/templates/claude/agents/specdojo-orchestrator.md +3 -2
  358. package/templates/codex/agents/specdojo-orchestrator.toml +3 -2
  359. package/templates/codex/orchestrator.md +3 -2
  360. package/templates/devcontainer/remote-host/devcontainer-tmux.sh +217 -0
  361. package/templates/devcontainer/remote-host/specdojo-tmux.sh.sample +8 -96
  362. package/templates/devcontainer/remote-host/ssh-config.sample +3 -1
  363. package/templates/devcontainer/tmux.conf +6 -0
  364. package/templates/init-agent-members.yaml +1 -0
  365. package/templates/init-exec-defaults.yaml +1 -1
  366. package/templates/opencode/agents/specdojo-orchestrator.md +3 -2
@@ -16,94 +16,88 @@ specdojo:
16
16
 
17
17
  Organization Definition Documentation Rulebook
18
18
 
19
- プロジェクトの目的に必要な意思決定・実行・確認の分担方針を定義するルールです。Role code やmember一覧を再掲せず、体制の設計根拠と正本だけを示します。
19
+ プロジェクトの目的に必要な意思決定・実行・確認の分担方針を定義するルールです。組織定義には、体制の設計根拠、Role code の採用判断、使用可能な `owner` と見直し条件を残します。
20
20
 
21
21
  ## 1. 全体方針
22
22
 
23
23
  - プロジェクト規模、関係者、判断の複雑さに合う最小体制を定義します。
24
24
  - 組織図や役職の網羅ではなく、価値判断、実行、品質確認、公開・運用の責任境界を示します。
25
- - Role code はロール定義、実行主体と兼務はメンバー定義、成果物・プロセス責任は RACI を正本とします。
26
- - 小規模では兼務を認めますが、最終判断と実作業の責任を概念上は分けます。
27
- - AI Agent は実行支援者であり、最終承認、当事者価値、公開可否、説明責任を担いません。
25
+ - 共通のロール定義は上位標準を参照し、対象プロジェクトで採用するかどうかの判断は組織定義に残します。
26
+ - 小規模では兼務を認めますが、Role code の採用と専任者の配置を分け、最終判断と実作業の責任を読み分けられるようにします。
27
+ - AI Agent は実行支援者とし、最終承認、当事者価値、公開可否、説明責任を人間に残します。
28
28
  - 参加者や責務が増えた場合に、軽量体制から分担体制へ拡張する条件を示します。
29
29
 
30
- ## 2. 位置づけと用語定義
30
+ ## 2. 位置づけ
31
31
 
32
- | 用語 | 定義 |
33
- | ---------- | ------------------------------------------------------ |
34
- | 組織モデル | 意思決定、実行、確認をどの責任領域へ分けるかという設計 |
35
- | Role code | Schedule owner や RACI で使う責任語彙 |
36
- | 実行主体 | 実際に作業する人、チーム、または支援する Agent |
37
- | 兼務 | 一つの実行主体が複数の Role code を担うこと |
32
+ - Role、Member、Task owner、Executor、RACI の共通定義と整合性ルールは、[[specdojo:people-and-organization-definition-standard|人と組織の定義標準]] を正本とします。
33
+ - 組織定義は、プロジェクト固有の採用・未採用 Role code、使用可能な `owner`、体制の設計根拠を管理し、Schedule と RACI のロール適合を確認する起点とします。
34
+ - `pm-roles.yaml` は採用ロールの機械可読な定義、メンバー定義は実行主体と兼務、RACI は成果物・プロセス別の責任分担を扱います。これらの内容を組織定義に複製しません。
38
35
 
39
36
  ## 3. ファイル命名・ID規則
40
37
 
41
38
  - 配置は `docs/ja/projects/<project-id>/030-project-management/pm-organization.md` を推奨します。
42
39
  - ID は `<project-id>:pm-organization`、ファイル名は `pm-organization.md` とします。
43
- - Role code、member nickname、Schedule owner の形式は組織関連標準と各YAML正本に従います。
40
+ - 共通の命名規則は [[specdojo:docs-structure-guide|ドキュメント構成ガイド]]、Role code などの値・構文は人と組織の定義標準と各 YAML の schema を参照します。
44
41
 
45
42
  ## 4. 推奨 Frontmatter 項目
46
43
 
47
- | 項目 | 説明 | 必須 |
48
- | ---------- | ---------------------------------------- | ---- |
49
- | id | `<project-id>:pm-organization` | ○ |
50
- | type | `project` | ○ |
51
- | status | `draft` / `ready` / `deprecated` | ○ |
52
- | rulebook | `specdojo:pm-organization-rulebook` | ○ |
53
- | based_on | 概要、スコープ、ステークホルダーなどのID | 任意 |
54
- | supersedes | 置き換え対象の旧文書 ID | 任意 |
44
+ - 共通項目の必須・任意、型・許容値は [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] と同標準から参照する成果物 schema に従います。
45
+ - `rulebook` には本書の ID を指定し、成果物の種別は本書の `deliverable_type` に合わせます。
46
+ - `based_on` には採用判断の根拠となる先行成果物を指定します。依存関係に含まれない文書は本文で参照し、置き換え時の `supersedes` はメタ情報標準に従います。
55
47
 
56
- ## 5. 本文構成(標準テンプレ)
48
+ ## 5. 本文要件
57
49
 
58
- | 番号 | 見出し | 必須 | 内容 |
59
- | ---- | ----------------- | ---- | --------------------------------------------- |
60
- | 1 | 組織モデル | ○ | 規模、責任領域、兼務、人と AI の境界 |
61
- | 2 | ロール・owner方針 | ○ | Role code の利用範囲、owner、実行主体との区別 |
62
- | 3 | 正本と責任境界 | ○ | 情報ごとの正本と本書の責務 |
63
- | 4 | 見直し条件 | ○ | 体制を変更・拡張するトリガーと判断者 |
50
+ 以下はすべて必須です。見出し順・表・記入欄の骨組みは Frontmatter で宣言した template を正本とします。
51
+
52
+ | 要件 | 記載する判断・根拠 |
53
+ | ------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
54
+ | 体制の設計 | 規模と目的に必要な責任領域、最終判断、実行・確認、兼務方針、人間と AI Agent の境界 |
55
+ | ロールの採用判断 | 上位標準の各標準ロールとプロジェクト独自ロールについて、採用・未採用の Role code、判断理由、プロジェクトでの扱い。未採用の場合は責務の代替先または対象外の理由。未採用がなければ「なし」と明記 |
56
+ | 使用可能な `owner` | Schedule で使用できる Role code の集合を明示。採用ロールの範囲内とし、RACI の列も採用判断およびロール定義と整合させる |
57
+ | 正本への参照 | 人と組織の定義標準、ロール定義、メンバー定義、RACI などの正本と責務境界。未作成の文書は作成予定または省略理由を明記 |
58
+ | 体制の見直し | 開始を判定できるトリガー、確認事項、更新先、判断者の Role code。変更時の追従確認と未決事項の管理先 |
64
59
 
65
60
  ## 6. 記述ガイド
66
61
 
67
- ### 6.1. 組織モデル
62
+ 共通定義・値・構文を再掲せず、人と組織の定義標準、メタ情報標準、各 schema を参照します。以下の例は個々の判断の書き方を示します。
68
63
 
69
- | 責任領域 | 設計方針 | 最終判断 | 実行・確認 |
70
- | -------- | -------- | -------- | ---------- |
64
+ ### 6.1. 組織モデル
71
65
 
72
- - 目的達成に必要な責任領域だけを示し、全Role codeを列挙しません。
73
- - 当事者・利用者による価値確認と、プロジェクト内部の管理責任を区別します。
74
- - 兼務する場合も、最終判断と実行・確認を読み分けられるようにします。
66
+ - 判断基準は、目的に必要な責任領域に漏れがなく、最終判断と実行・確認を区別できることです。当事者・利用者の価値確認と内部の管理責任も分けます。
67
+ - 推奨表の列は「責任領域」「設計方針」「最終判断」「実行・確認」です。成果物・プロセス単位の割り当ては RACI を参照し、その割り当てと矛盾する責任者を書きません。
68
+ - 良い例: 「初期は人間が複数ロールを兼務し、AI Agent は草案と検証を支援する。費用・受入・公開の最終判断は人間の `PO` が行う」。
69
+ - 悪い例: 「小規模なので責任は全員で持ち、公開可否は Agent が決める」。判断者と実行支援の境界を確認できません。
75
70
 
76
71
  ### 6.2. ロール・owner方針
77
72
 
78
- - Schedule owner と RACI 列には、ロール定義に存在する Role code だけを使います。
79
- - Role code の採用は専任memberの配置を意味しないことを明記します。
80
- - 実行主体、兼務、Agent利用はメンバー定義へ委譲します。
73
+ - 判断基準は、各ロールの採用可否と根拠が分かり、Schedule の `owner` と RACI の列を照合できることです。ロール定義への参照だけで採用判断を済ませません。
74
+ - 推奨表の列は「Role code」「採用/未採用」「判断理由・プロジェクトでの扱い」「未採用時の代替方針」です。共通の正式名称・責務は転載せず、使用可能な `owner` はこの表から特定できるように明示します。
75
+ - 良い例: 「`PO` と `BA` を採用し、使用可能な `owner` は `PO`、`BA` とする。`PM` は未採用とし、計画・進捗管理は `PO` が担う」。他の標準ロールも採用可否を記載し、実行主体の兼務割り当てはメンバー定義で管理します。
76
+ - 悪い例: 「`PM` は専任者がいないので未採用だが、Schedule の `owner` に使う」。採用と配置を混同し、未採用ロールを使用しています。
81
77
 
82
78
  ### 6.3. 正本と責任境界
83
79
 
84
- | 情報 | 正本 | 本書で扱うこと |
85
- | ---- | ---- | -------------- |
86
-
87
- - ロール語彙、実行主体、責任分担、関係者の正本を分けます。
88
- - 正本の内容を要約・複製せず、組織設計上の使い分けだけを書きます。
89
- - Scheduleや個別成果物の責任割り当ては本書に持ち込みません。
80
+ - 判断基準は、情報の更新先が一意に分かり、本書に残す採用判断を外部へ委譲していないことです。
81
+ - 推奨表の列は「情報」「正本」「本書で扱うこと」です。採用判断と使用可能な `owner` は本書、採用ロールの定義はロール定義、実行主体はメンバー定義、詳細な責任割り当ては RACI に分けます。
82
+ - 良い例: 「共通定義は人と組織の定義標準を参照し、本書で採用を決める。ロール定義にはその採用結果を反映する」。参照先が存在する場合は文書 ID でリンクします。
83
+ - 悪い例: 「使用できるロールはロール定義を参照」とだけ書く、またはメンバー名簿・詳細な RACI を本文にも複製する。前者は採用根拠が欠け、後者は更新先が分散します。
90
84
 
91
85
  ### 6.4. 見直し条件
92
86
 
93
- | トリガー | 確認すること | 更新先 | 判断者 |
94
- | -------- | ------------ | ------ | ------ |
95
-
96
- - 目的・スコープ、関係者、参加者、作業滞留、公開・運用責任の変化を扱います。
97
- - 新しいRole codeを増やす前に、既存責任の再配分で対応できるか確認します。
98
- - 体制変更はロール、メンバー、RACI、Scheduleの必要な正本だけへ反映します。
87
+ - 判断基準は、体制変更を開始する状態と、その後の更新・確認をタスク化できることです。目的・スコープ、関係者、参加者、作業滞留、公開・運用責任の変化からプロジェクトに必要な条件を選び、新しい Role code を増やす前に既存責任の再配分を検討します。
88
+ - 推奨表の列は「トリガー」「確認すること」「更新先」「判断者」です。PM(未採用なら管理責務を代替する採用ロール)が追従タスクを管理し、PO が採用変更を判断する方針を示します。
89
+ - 採用変更・置き換え・廃止時は、メタ情報標準の「文書の改訂・廃止とライフサイクル変更管理」に従い、ロール定義、メンバー定義、RACI、WBS、Schedule の影響箇所と担当 Role code を特定します。未決事項・リスク・課題・変更要求・決定は PJR または対応する管理簿へ分け、担当と転送先を記録します。
90
+ - 良い例: 「兼務による承認待ちで Schedule の期限を超えた場合、管理担当が役割再配分を検討し、PO が採否を判断する。変更対象の RACI と Schedule の更新を確認する」。
91
+ - 悪い例: 「忙しくなったら体制を強化する」。開始条件、更新先、判断者が分かりません。
99
92
 
100
93
  ## 7. 禁止事項
101
94
 
102
- | 禁止事項 | 理由 |
103
- | ---------------------------------------------------- | -------------------------------- |
104
- | Role code、member、RACIの一覧を再掲する | 正本が分散するため |
105
- | member nickname、人名、agent名をSchedule ownerにする | 責任語彙と実行主体を混同するため |
106
- | 兼務を理由に最終判断者を曖昧にする | 説明責任が不明になるため |
107
- | Agentに最終承認、当事者価値、公開可否を委ねる | 人間の判断責任を代替するため |
108
- | 必要性を示さずRole codeや階層を増やす | 小規模運用の負荷を増やすため |
109
- | 個人情報、秘密情報、アクセス情報を記載する | 公開適性に反するため |
95
+ | 禁止事項 | 理由 |
96
+ | ----------------------------------------------------------------------------------------- | -------------------------------------------------------- |
97
+ | 採用・未採用 Role code と使用可能な `owner` を省略し、ロール定義への参照だけで済ませる | プロジェクト固有の採用判断と適合確認の根拠が失われるため |
98
+ | 共通のロール定義、メンバー名簿、詳細な RACI を再掲する | 正本が分散するため |
99
+ | 未採用・未定義の Role code を Schedule の `owner` や RACI 列に使う | 採用判断と責任語彙が不整合になるため |
100
+ | member nickname、人名、agent 名を Schedule の `owner` にする | 責任語彙と実行主体を混同するため |
101
+ | 兼務を理由に最終判断者を曖昧にする、または Agent に最終承認・当事者価値・公開可否を委ねる | 人間の判断責任と説明責任が不明になるため |
102
+ | 必要性を示さず Role code や階層を増やす | 小規模運用の負荷を増やすため |
103
+ | 個人情報、秘密情報、アクセス情報を記載する | 公開適性に反するため |
@@ -10,6 +10,7 @@ specdojo:
10
10
  template: specdojo:pm-plan-template
11
11
  based_on:
12
12
  - specdojo:people-and-organization-definition-standard
13
+ - specdojo:document-metadata-standard
13
14
  ---
14
15
 
15
16
  # プロジェクト管理計画 作成ルール
@@ -21,95 +22,85 @@ Project Management Plan Documentation Rulebook
21
22
  ## 1. 全体方針
22
23
 
23
24
  - 管理計画は、何を管理し、どの逸脱を、誰が、どの証跡で判断するかを示します。
24
-
25
- - プロジェクト概要、スコープ、成功基準を直接の根拠とし、作業完了ではなく期待価値の検証を管理目的にします。
25
+ - プロジェクト概要、スコープ、成功基準を直接の根拠とし、作業完了ではなく期待価値の検証を管理目的にします。これらの先行成果物を成果物カタログの依存関係に含め、Schedule・scaffold に展開できる状態にします。
26
26
  - 小規模プロジェクトでは一つの統合表を基本とし、規模・契約・監査要件がある場合だけ個別計画へ展開します。
27
27
  - 品質、コミュニケーション、組織、RACI、Schedule、登録簿は各正本へ委譲し、本書に一覧や詳細手順を複製しません。
28
28
  - 現金支出、人の作業時間、継続運用負荷を区別し、人への負荷転嫁をコスト削減とみなしません。
29
29
  - AI Agent は整理・更新・検証を支援できますが、優先順位、例外、公開、GO / Not GO の最終判断は人間が担います。
30
30
 
31
- ## 2. 位置づけと用語定義
31
+ ## 2. 位置づけ
32
32
 
33
- | 用語 | 定義 |
34
- | ---------------- | ------------------------------------------------------------------------ |
35
- | 統合管理方針 | スコープ、Schedule、費用・負荷、品質、課題・リスク・変更を一表で扱う方針 |
36
- | 判断ゲート | 継続、公開、変更、停止などを人間が判断する時点と条件 |
37
- | 正本 | 状態、責任、判断根拠を最終的に確認する文書、YAML、登録簿、または記録 |
38
- | 軽量プロファイル | 必要最小限の統合表と判断ゲートで管理する方式 |
39
- | 拡張プロファイル | 契約、監査、組織規模に応じ、個別計画や詳細手順を追加する方式 |
33
+ - 本計画は横断的な管理基準と判断の接続を担い、個別計画・管理記録の更新先を示します。
34
+ - Role、Member、Task owner、RACI の共通定義は [[specdojo:people-and-organization-definition-standard|人と組織の定義標準]] を正本とし、プロジェクト固有の採用判断は組織定義に従います。
35
+ - 必要最小限の統合表と判断ゲートで管理する方式を軽量プロファイル、契約・監査・組織規模に応じて個別計画や詳細手順を追加する方式を拡張プロファイルとします。
40
36
 
41
37
  ## 3. ファイル命名・ID規則
42
38
 
43
39
  - 配置は `docs/ja/projects/<project-id>/030-project-management/pm-plan.md` を推奨します。
44
40
  - ID は `<project-id>:pm-plan`、ファイル名は `pm-plan.md` とします。
45
- - Role code、member、Schedule owner の識別規則は組織・ロールの正本に従います。
41
+ - 共通の命名規則は [[specdojo:docs-structure-guide|ドキュメント構成ガイド]]、Role code などの識別規則は人と組織の定義標準と各 YAML の schema を参照します。
46
42
 
47
43
  ## 4. 推奨 Frontmatter 項目
48
44
 
49
- | 項目 | 説明 | 必須 |
50
- | -------- | -------------------------------- | ---- |
51
- | id | `<project-id>:pm-plan` | ○ |
52
- | type | `project` | ○ |
53
- | status | `draft` / `ready` / `deprecated` | ○ |
54
- | rulebook | `specdojo:pm-plan-rulebook` | ○ |
45
+ - 共通項目・型・許容値は [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] と同標準から参照する成果物 schema に従います。`rulebook` には本書の ID を指定し、種別は本書の `deliverable_type` に合わせます。
46
+ - 本系統では `based_on` を必須とし、概要、スコープ、成功基準の文書 ID を含めます。組織定義など、管理方針の直接根拠として使った先行成果物も記載します。本文のリンクだけで根拠宣言を代替しません。
47
+ - カタログを利用する場合、`based_on` の参照先は `depends_on` の推移閉包に含めます。閉包外なら依存関係の整備を先行作業とし、根拠参照を省略したり閉包外の ID を追加したりして適合扱いにしません。
48
+ - 置き換え時の `supersedes` と状態変更はメタ情報標準に従います。
55
49
 
56
- | based_on | 概要、スコープ、成功基準、組織定義など直接根拠となる ID | 任意 |
57
- | supersedes | 置き換え対象の旧文書 ID | 任意 |
50
+ ## 5. 本文要件
58
51
 
59
- ## 5. 本文構成(標準テンプレ)
52
+ 見出し順・表・記入欄の骨組みは Frontmatter で宣言した template を正本とします。本書は次の意味要件を定めます。
60
53
 
61
- | 番号 | 見出し | 必須 | 内容 |
62
- | ---- | ---------------------------- | ---- | ------------------------------------------------------ |
63
- | 1 | 管理目的と適用方針 | ○ | 価値、対象期間、軽量・拡張プロファイル、人と AI の境界 |
64
- | 2 | 統合管理方針 | ○ | 管理対象、基準・上限、確認契機、逸脱時対応、責任 |
65
- | 3 | 判断ゲートとエスカレーション | ○ | 判断条件、材料、起案者、最終判断者、証跡 |
66
- | 4 | 正本・報告・見直し | ○ | 情報別の正本、報告契機、見直しトリガー |
67
- | 5 | 未決事項 | 任意 | 未決論点、決定時期、判断者 |
54
+ | 要件 | 必須条件 | 記載する判断・根拠 |
55
+ | ------------------ | ------------------------ | ---------------------------------------------------------------------------------------------------------------------------------- |
56
+ | 管理範囲の選定 | 必須 | 期待価値、対象期間、適用プロファイルと拡張条件、人間と AI Agent の判断・実行境界 |
57
+ | 管理対象単位の追跡 | 必須 | 価値・リスクまたは条件 ID と、基準・上限、確認契機、逸脱時対応、責任、証跡の正本を対応付ける |
58
+ | 判断の成立条件 | 必須 | 継続・公開・変更・停止などの条件、判断材料、起案者、人間の最終判断者、証跡。未達・材料不足時の扱いを含む |
59
+ | 更新・報告の接続 | 必須 | 情報ごとの正本、報告契機、確認者、見直しトリガーと追従先。個別計画や台帳へ委譲する責務を識別する |
60
+ | 未決の扱い | 未決事項がある場合に必須 | 未決の状態、決定時期、判断者。別の正本で追跡する場合は対象の論点・記録を参照し、決定情報を複製しない。なければ「なし」と明記できる |
68
61
 
69
62
  ## 6. 記述ガイド
70
63
 
64
+ 共通のメタ情報、役割、値・構文は上位標準と schema を参照し、ここでは計画固有の判断基準と部分例を示します。
65
+
71
66
  ### 6.1. 管理目的と適用方針
72
67
 
73
- - 概要・スコープ・成功基準から、管理対象となる価値と期間を要約します。
74
- - 軽量プロファイルか拡張プロファイルかを明記し、拡張する条件を示します。
75
- - 人間と AI Agent の判断・実行境界を 1〜3 文で示します。
68
+ - 判断基準は、管理範囲と期間を価値・スコープ・成功基準へ結び付け、管理の厚さを選んだ理由を説明できることです。
69
+ - 軽量・拡張の選択と拡張条件、人間と AI Agent の判断・実行境界を簡潔に示します。
70
+ - 良い例: 「初期公開から2週間の試行で SC-01 の価値を検証する。軽量運用とし、外部契約が生じた場合は個別計画を追加する。Agent は整理・検証を支援し、公開は人間の `PO` が判断する」。
71
+ - 悪い例: 「一般的な PM 項目をすべて管理し、完了したら Agent が公開する」。価値、期間、管理範囲の選定理由、人間の判断境界が分かりません。
76
72
 
77
73
  ### 6.2. 統合管理方針
78
74
 
79
- 管理領域ごとに別章を作らず、次の一表へ統合します。品質やコミュニケーションの詳細は個別計画へ委譲します。
80
-
81
- | 管理対象 | 基準・上限 | 確認契機 | 逸脱時対応 | 責任 |
82
- | -------- | ---------- | -------- | ---------- | ---- |
83
-
84
- - スコープ、Schedule、費用・負荷、品質、課題・リスク・変更のうち、実際に管理する対象だけを行にします。
85
-
86
- - 費用を扱う場合は、現金支出、作業時間、継続運用負荷を分けます。
87
- - 課題・リスク・変更・決定は登録簿へ記録し、本文に個票を持ちません。
75
+ - 判断基準は、各行から「守る価値・回避するリスク → 基準・上限 → 確認・逸脱対応 → 責任 → 証跡」を一続きで追跡し、適合・逸脱を判定できることです。
76
+ - 表の列の意味は、管理対象が追跡単位、根拠が価値・リスクの文書 ID と該当箇所または条件 ID、基準・上限が判定条件、確認契機が観測時点、逸脱時対応が次の行動、責任が担当 Role code、証跡・正本が記録先と確認する記録の識別方法です。これらを各行で保持するか、行の結合 ID から一意に辿れるようにし、文書全体への参照だけで済ませません。
77
+ - スコープ、Schedule、費用・負荷、品質、課題・リスク・変更について適用を判断し、実際に管理する対象だけを行にします。費用・負荷は現金支出、準備・開発などの作業時間、日常操作・保守などの継続運用負荷を別の行または別の基準・記録で管理し、一方の削減を他方の削減とみなしません。
78
+ - 構成管理は、管理対象の版・承認済み基準・変更履歴を何で識別するか、変更時に誰が確認し、どこへ記録するかを示します。技術管理は、技術制約・外部依存の変更を検知する契機、影響確認と判断を担う Role code、記録先を示します。個別方針へ委譲する場合も、この確認・対応と委譲先を行から追跡できるようにし、設計や操作手順の詳細を再掲しません。
79
+ - 良い例: 「継続運用負荷」の根拠を成功基準文書の SC-03、基準を同条件の上限内、確認契機を試行中の営業日、超過時対応を `PM` による手順縮小案の起案、証跡を SC-03・確認日・確認者で識別する操作時間記録とします。数値・測定手順の正本は成功基準に残します。
80
+ - 悪い例: 「参加者の時間を無理のない範囲にし、必要に応じて確認する」。準備時間と日常負荷が混ざり、根拠、判定条件、証跡を照合できません。
88
81
 
89
82
  ### 6.3. 判断ゲートとエスカレーション
90
83
 
91
- | ゲート | 判断条件 | 判断材料 | 起案・整理 | 最終判断 | 証跡 |
92
- | ------ | -------- | -------- | ---------- | -------- | ---- |
93
-
94
- - 公開、主要変更、例外、継続・停止など、人間の判断が必要なゲートだけを記載します。
95
-
96
- - 成功基準を再掲せず、参照する条件 ID と不足時の扱いを示します。
97
- - 「必要に応じて」ではなく、エスカレーションする条件を判定可能にします。
84
+ - 判断基準は、適用する条件 ID、材料、最終判断者、判定記録が結び付き、未達と材料不足を合格扱いにしないことです。公開、主要変更、例外、継続・停止など、人間の判断が必要なゲートを選びます。
85
+ - 成功基準・受入条件を複製せず、文書 ID と条件 ID を参照します。是正・再判定、保留・停止、例外判断を求める条件を定め、例外は上位の受入方針で認める範囲に限ります。
86
+ - 良い例: 「初期受入は成功基準の正本にある SC-01 と AC-01〜AC-04 を必須とし、未達または証跡不足なら保留する。`QE` が再確認結果を整理し、人間の `PO` が受入可否を判断して条件 ID ごとの結果とともに記録する」。
87
+ - 悪い例: 「初期成功基準を満たしたら公開し、問題があれば必要に応じて相談する」。参照条件、不足時の処理、判断者を特定できません。
98
88
 
99
89
  ### 6.4. 正本・報告・見直し
100
90
 
101
- | 情報 | 正本 | 更新・報告契機 | 主な確認者 |
102
- | ---- | ---- | -------------- | ---------- |
103
-
104
- - Schedule、RACI、費用・作業記録、品質証跡、登録簿などの正本を示します。
105
- - 定期報告を必須にせず、判断・逸脱・作業節目など必要な契機を定めます。
106
- - 目的、スコープ、成功基準、体制、外部条件が変わった場合の見直し先を示します。
91
+ - 判断基準は、情報ごとの更新先と確認者が一意に分かり、見直し時の追従作業をタスク化できることです。正本が未整備なら、整備時期・担当または省略理由と責任を確認する代替先を示します。
92
+ - Schedule は作業順序・Task owner・進捗、RACI は成果物・主要判断の責任、ロール定義は責務、メンバー定義は実行主体を扱います。RACI を採用する体制では正本として明示し、Task owner だけで承認責任を代替しません。最小運用での RACI 省略条件は人と組織の定義標準に従います。
93
+ - 判断・逸脱・作業節目などの報告契機と確認者を定め、品質・コミュニケーションの詳細は各計画を参照します。課題・リスク・変更要求・決定は PJR または対応する管理簿へ分け、本文に個票を持ちません。
94
+ - 目的、スコープ、成功基準、体制、外部条件が変わった場合、管理担当が影響する個別計画・RACI・Schedule・証跡への参照と担当 Role code を特定し、更新順序・期限・確認担当を追従タスクにします。計画の置き換え・廃止はメタ情報標準の「文書の改訂・廃止とライフサイクル変更管理」に従います。
95
+ - 良い例: 「承認担当の交代時は、`PM` が RACI・メンバー定義・Schedule の影響箇所を特定し、更新担当と期限を設定する。`QE` が判断ゲートの最終判断者との整合を確認する」。
96
+ - 悪い例: 「担当は Schedule を参照し、変更時は関係文書を見直す」。成果物責任の正本、更新先、確認担当が不明です。
107
97
 
108
98
  ### 6.5. 未決事項
109
99
 
110
- - 未決事項は _UNDECIDED_: とし、決定時期と判断者を添えます。
111
- - 期限を過ぎた未決事項は、課題または判断事項として登録簿へ移します。
112
- - 継続的に追跡する事項を本文へ残さず、正本となる管理記録へ委譲します。
100
+ - 判断基準は、未決の論点、決定時期、判断者を追跡でき、未決の上限や担当を確定済みとして着手・判定しないことです。現状に `_UNDECIDED_:` を付けます。
101
+ - 既に他文書・管理簿で追跡している場合、本書では未決状態と参照先の論点・記録を示し、決定時期・判断者は参照先を正本にできます。期限を過ぎた事項は課題または判断事項として登録簿へ移し、担当 Role code と転送先を残します。
102
+ - 良い例: 「`_UNDECIDED_:` 試行準備の作業時間上限。試行着手前に人間の `PO` が決定し、未決の間は着手を保留する」。
103
+ - 悪い例: 「費用・時間上限は後で決める」。未決状態、期限、判断者、未決の間の扱いを確認できません。
113
104
 
114
105
  ## 7. 禁止事項
115
106
 
@@ -10,6 +10,7 @@ specdojo:
10
10
  template: specdojo:pm-quality-management-plan-template
11
11
  based_on:
12
12
  - specdojo:people-and-organization-definition-standard
13
+ - specdojo:document-metadata-standard
13
14
  ---
14
15
 
15
16
  # 品質管理計画 作成ルール
@@ -21,15 +22,13 @@ Quality Management Plan Documentation Rulebook
21
22
  ## 1. 全体方針
22
23
 
23
24
  - 品質は、利用者価値の成立と、それを支える成果物・技術条件の両方で判定します。
24
- - 成功基準の条件 ID、成果物rulebook、検証コマンドを正本とし、本書には判定の接続方法だけを書きます。
25
- - 品質目標、メトリクス、検査基準を重複させず、品質ゲートへ統合します。
26
25
  - 小規模プロジェクトでは、代表試行、主要レビュー、公開前確認など必要なゲートだけを置きます。
27
- - 低コストや継続性を価値に置く場合は、現金支出、作業時間、継続運用負荷を品質判断に含めます。
28
-
29
- - AI Agent は検証や指摘整理を支援できますが、利用者価値、例外、公開可否の最終判断は人間が行います。
30
26
 
31
27
  ## 2. 位置づけと用語定義
32
28
 
29
+ - 本計画は、管理計画の品質方針を判定時点・責任・証跡・是正へ具体化し、レビューと後続作業の計画に用います。
30
+ - Role、Member、RACI の定義と委任方針は [[specdojo:people-and-organization-definition-standard|人と組織の定義標準]] を正本とします。
31
+
33
32
  | 用語 | 定義 |
34
33
  | ---------- | -------------------------------------------------------------- |
35
34
  | 品質ゲート | 所定の時点で、条件・証跡・判断者をそろえて合否を確認する仕組み |
@@ -41,78 +40,82 @@ Quality Management Plan Documentation Rulebook
41
40
 
42
41
  - 配置は `docs/ja/projects/<project-id>/030-project-management/pm-quality-management-plan.md` を推奨します。
43
42
  - ID は `<project-id>:pm-quality-management-plan`、ファイル名は `pm-quality-management-plan.md` とします。
44
- - 判定条件は成功基準 ID、受入条件 ID、成果物 ID など安定した識別子で参照します。
43
+ - 共通の命名規則は [[specdojo:docs-structure-guide|ドキュメント構成ガイド]] に従い、判定条件は成功基準 ID、受入条件 ID、成果物 ID など安定した識別子で参照します。
45
44
 
46
45
  ## 4. 推奨 Frontmatter 項目
47
46
 
48
- | 項目 | 説明 | 必須 |
49
- | ---------- | ---------------------------------------------- | ---- |
50
- | id | `<project-id>:pm-quality-management-plan` | ○ |
51
- | type | `project` | ○ |
52
- | status | `draft` / `ready` / `deprecated` | ○ |
53
- | rulebook | `specdojo:pm-quality-management-plan-rulebook` | ○ |
54
- | based_on | 管理計画、成功基準など直接根拠となる ID | 任意 |
55
- | supersedes | 置き換え対象の旧文書 ID | 任意 |
47
+ - 共通項目・型・許容値は [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] と同標準から参照する成果物 schema に従います。`rulebook` は本書の ID、種別は本書の `deliverable_type` に合わせます。
48
+ - `based_on` には、管理計画など作成時に直接根拠とした先行成果物を記載します。カタログを利用する場合は `depends_on` の推移閉包内に限り、閉包外の根拠が必要なら依存関係の整備を先行させます。
49
+ - 置き換え時の `supersedes` と状態変更はメタ情報標準に従います。
56
50
 
57
- ## 5. 本文構成(標準テンプレ)
51
+ ## 5. 本文要件
58
52
 
59
- | 番号 | 見出し | 必須 | 内容 |
60
- | ---- | ------ | ---- | ---- |
53
+ 見出し順・表・記入欄の骨組みは Frontmatter で宣言した template を正本とし、本書では各章が満たす意味要件を定めます。
61
54
 
62
- | 1 | 品質方針と適用範囲 | ○ | 価値品質、成果物品質、対象期間、人と AI の境界 |
63
- | 2 | 品質ゲート | ○ | 観点、合格条件、方法・証跡、時期、確認・承認責任 |
64
- | 3 | レビューと証跡 | ○ | 対象、観点、実施責任、出口条件、記録先 |
65
- | 4 | 不適合と是正 | ○ | 区分、対応、再判定、記録先 |
66
- | 5 | 見直し条件と未決事項 | 任意 | 見直しトリガー、未決論点、判断者 |
55
+ | 要件 | 必須条件 | 記載する判断・根拠 |
56
+ | ------------------------------ | ------------------------ | ------------------------------------------------------------------------------ |
57
+ | 品質方針と適用範囲 | 必須 | 価値品質と成果物品質、適用開始・終了、人間と AI Agent の判断境界 |
58
+ | 品質ゲート | 必須 | ゲートごとの品質観点、条件 ID、確認方法と証跡、時期、確認・承認責任 |
59
+ | レビューと証跡 | 必須 | 対象、主要観点、実施責任、合否を判定できる出口条件、証跡、記録先 |
60
+ | 不適合と是正 | 必須 | 区分ごとの対応、再判定条件、再判定責任、記録先、重大不適合の通過制限 |
61
+ | 見直し条件と未決事項(見直し) | 必須 | 見直し契機、影響する正本・後続作業、追従更新の責任 |
62
+ | 見直し条件と未決事項(未決) | 未決事項がある場合に必須 | 未決論点、決定時期、判断者、決定まで保留する判定。なければ「なし」と明記できる |
67
63
 
68
64
  ## 6. 記述ガイド
69
65
 
66
+ 共通のメタ情報・役割・値・構文は上位標準と schema を参照し、ここでは品質計画固有の判断基準と部分例を示します。責任を表す項目は、組織・ロール定義で採用された Role code を用い、RACI がある場合は該当する作業・判断の責任と整合させます。実行主体や兼務はメンバー定義へ委譲します。以下の Role code は例であり、未採用ロールの追加を要求しません。
67
+
70
68
  ### 6.1. 品質方針と適用範囲
71
69
 
72
- - 成功基準から、利用者価値として確認する品質を要約します。
73
- - 構造、整合、検証、公開適性など、価値提供を支える成果物品質を示します。
74
- - 詳細な条件やコマンドは正本へ委譲し、本文へ複製しません。
70
+ - 判断基準は、利用者価値とそれを支える成果物品質、対象範囲・期間、判断主体を識別できることです。成功基準を根拠とし、技術検証だけで価値を判定しません。
71
+ - 適用開始・終了は日付または識別可能なイベントで示します。公開後の観測を含む場合は終了までの関係を示し、未確定の終了日は終了条件と見直し契機で代替できます。
72
+ - AI Agent が支援する確認作業と、人間が担う価値・例外・公開可否の最終判断を明記します。上位計画へ委譲する場合も、該当する判断と参照先を特定します。
73
+ - 良い例: 「代表試行開始から公開後価値ゲートの判定完了まで適用する。利用継続と負担を価値品質、再現性を成果物品質として確認する。AI Agent は検証記録を整理し、人間の `PO` が利用価値と公開可否を判断する」。
74
+ - 悪い例: 「開発中の品質を高め、AI Agent が問題なしと判定する」。期間の境界と人間の判断責任を確認できません。
75
75
 
76
76
  ### 6.2. 品質ゲート
77
77
 
78
- | ゲート | 品質観点 | 合格条件 | 方法・証跡 | 時期 | 確認者 / 承認者 |
79
- | ------ | -------- | -------- | ---------- | ---- | --------------- |
80
-
81
- - 価値品質と成果物品質を区別し、両方を必要なゲートへ配置します。
82
- - 合格条件は成功基準 ID、受入条件 ID、検証結果などを参照します。
83
- - 費用・負荷を扱う場合は、現金支出、作業時間、継続運用負荷を分けます。
78
+ - 判断基準は、各ゲートから条件の正本、確認方法、証跡、時期、確認者と承認者を辿り、合否または保留を決められることです。初期受入と公開後の継続判断は適用時点を分けます。
79
+ - 合格条件は文書 ID と条件 ID で参照します。数値を使う場合、算出方法・閾値・計測頻度を正本の該当箇所から確認できるようにします。未定義なら担当と決定期限を未決事項に置き、判定前に解消します。
80
+ - 確認者は証跡に基づく品質確認、承認者は当該判断の承認を担います。品質確認と公開可否を分け、RACI の異なる判断を一つの承認責任で代替しません。
81
+ - 費用・負荷を扱う場合は、現金支出、作業時間、継続運用負荷を別の基準・記録で確認します。
82
+ - 良い例: 「初期受入は成功基準の SC-01・AC-01 に基づき試行終了時に判定する。`QE` が試行記録を確認し、人間の `PO` が受入を判断する。未達または証跡不足なら保留する」。数値や検証コマンドは正本に残します。
83
+ - 悪い例: 「lint が通れば公開し、利用者の評価は後で確認する」。価値の合否と公開判断の根拠が欠けています。
84
84
 
85
85
  ### 6.3. レビューと証跡
86
86
 
87
- | 対象 | 主な観点 | 実施責任 | 出口条件・証跡 |
88
- | ---- | -------- | -------- | -------------- |
89
-
90
- - レビュー種別を増やすより、対象ごとの主要観点と出口条件を示します。
91
- - 指摘は差分、レビュー記録、登録簿など追跡できる場所へ残します。
92
- - 生成物は正本から再生成し、直接編集を品質是正に使いません。
87
+ - 判断基準は、対象版について誰が何を確認し、どの状態なら通過でき、どこに結果が残るかを再現できることです。レビュー種別は対象と対応が異なるものに絞ります。
88
+ - 列名は「対象」「実施責任」に統一します。「出口条件」は合否を分ける状態、「証跡」は判定を裏付ける記録、「記録先」はその記録へ到達する文書 ID またはパスです。三者を独立した列で必須とし、証跡名だけで出口条件を代替しません。
89
+ - 証跡には対象版、実施日、結果、未達条件・指摘と是正・再判定結果を追跡できる情報を残します。生成物の是正は生成元の正本を修正し、再生成して確認します。
90
+ - 良い例: 「公開対象の差分を `QE` が確認する。出口条件は公開に関する重大指摘が未解消で残っていないこと、証跡は対象版と指摘別結果を持つ公開前レビュー記録、記録先は `execution/reviews/release-1/result.md` とする」。パスは例示であり、実際の保存先を指定します。
91
+ - 悪い例: 「実施者: 関係者、出口条件・証跡: レビュー結果」。責任、通過条件、記録先を特定できません。
93
92
 
94
93
  ### 6.4. 不適合と是正
95
94
 
96
- | 区分 | 対応 | 再判定 | 記録先 |
97
- | ---- | ---- | ------ | ------ |
98
-
99
- - 軽微な修正、価値不適合、構造・検証不適合、公開不適合など対応が異なる区分だけを置きます。
100
- - 是正後は、未達だった条件またはゲートを再判定します。
101
- - 目的・スコープ・成功基準に影響する場合は変更要求または決定として扱います。
95
+ - 判断基準は、不適合から是正、再判定、結果記録までを追跡できることです。軽微、価値、構造・検証、公開など対応差がある区分だけを置きます。
96
+ - 「再判定条件」と「再判定責任」を独立した列に分けます。前者は是正後に再確認する条件 ID・ゲートと確認を再開する契機、後者は再確認を担う Role code です。公開・例外の承認が別に必要なら、その判断責任も区別します。
97
+ - 計画ごとに、必須の価値・受入条件、検証の成立、公開安全性への影響から重大性の判定境界を示します。重大な不適合は担当 Role が PM(未採用なら管理責務を代替する採用 Role)へ報告し、管理担当が課題または変更要求へ登録します。是正完了または承認済み基準が認める期限付き例外の判断まで該当ゲートを通過させません。例外には理由、期限、人間の承認者、再判定条件を記録します。
98
+ - 将来の品質上の懸念は、管理担当がリスク登録簿へ担当 Role・兆候・対策を付けて記録し、顕在化したら元の記録を参照して課題へ移します。
99
+ - 記録先はレビュー記録・検証結果・登録簿の文書 ID またはパスで特定し、目的・スコープ・成功基準に影響する是正は変更要求と決定記録へ接続します。
100
+ - 良い例: 「技術不適合は生成元を修正する。再判定条件は再生成後に未達の AC-02 と影響範囲の検証が成功すること、再判定責任は `QE` とし、対象版・結果を課題個票から辿れる検証記録に残す」。
101
+ - 悪い例: 「対応: 修正、再判定: `QE`、記録先: 課題」。条件・確認契機と到達先が不明です。
102
102
 
103
103
  ### 6.5. 見直し条件と未決事項
104
104
 
105
- - 成功基準、公開範囲、成果物構造、検証方法、重大不適合の傾向が変わった場合に見直します。
106
- - 未決事項は _UNDECIDED_: とし、決定時期と判断者を添えます。
107
- - 品質課題の個票は本書に残さず、登録簿やレビュー記録へ移します。
105
+ - 判断基準は、計画を見直す契機と追従責任が明確で、未決事項を確定済みとして合格扱いしないことです。成功基準、公開範囲、成果物構造、検証方法、体制、重大不適合の傾向の変化を確認します。
106
+ - 未決事項は `_UNDECIDED_:` とし、決定時期、判断者、未決の間は保留するゲートを添えます。他の正本で管理する論点は該当記録を参照し、品質課題の個票は登録簿やレビュー記録へ委譲します。
107
+ - 計画の改訂・置き換え・廃止はメタ情報標準の「文書の改訂・廃止とライフサイクル変更管理」に従います。`PM` または兼務する採用ロールが管理計画・RACI・Schedule・証跡参照の追従先と担当 Role code・期限を整理し、`QE` または品質確認を担う採用ロールが判定条件への影響を確認します。
108
+ - 良い例: 「`_UNDECIDED_:` 試行記録の形式は試行開始前に `QE` が提案し、人間の `PO` が決定する。未決の間は代表試行ゲートを保留する。決定で確認工数が変われば `PM` が Schedule を更新する」。
109
+ - 悪い例: 「手順は後で決め、変更時は見直す」。期限、判断者、ゲートと後続作業への影響を確認できません。
108
110
 
109
111
  ## 7. 禁止事項
110
112
 
111
- | 禁止事項 | 理由 |
112
- | ------------------------------------------------------ | ---------------------------------- |
113
- | 成功基準、rulebook、検証手順を本文へ複製する | 判定条件の正本が分散するため |
114
- | 品質目標、メトリクス、検査基準へ同じ条件を重複記載する | 更新量と不整合が増えるため |
115
- | 技術検証だけで利用者価値の品質を代替する | プロジェクト成功を判定できないため |
116
- | 現金支出だけを確認し、人の負荷を除外する | 負荷転嫁を見逃すため |
117
- | 生成物を直接修正して不適合を解消する | 再生成時に修正が失われるため |
118
- | Agent に価値、例外、公開可否の最終判断を委ねる | 人間の判断責任を代替するため |
113
+ | 禁止事項 | 理由 |
114
+ | ---------------------------------------------------------- | ---------------------------------- |
115
+ | 成功基準、rulebook、schema、検証手順の詳細を本文へ複製する | 判定条件の正本が分散するため |
116
+ | 品質目標、メトリクス、検査基準へ同じ条件を重複記載する | 更新量と不整合が増えるため |
117
+ | 技術検証だけで利用者価値の品質を代替する | プロジェクト成功を判定できないため |
118
+ | 現金支出だけを確認し、人の負荷を除外する | 負荷転嫁を見逃すため |
119
+ | 生成物を直接修正して不適合を解消する | 再生成時に修正が失われるため |
120
+ | 証跡名や Role code だけで出口条件・再判定条件を代替する | 合否と責任を別々に確認できないため |
121
+ | AI Agent に価値、例外、公開可否の最終判断を委ねる | 人間の判断責任を代替するため |