specdojo 0.7.0 → 0.9.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (462) hide show
  1. package/.github/agents/specdojo-orchestrator.md +7 -3
  2. package/CHANGELOG.md +217 -0
  3. package/dist/catalog/build.js +24 -1
  4. package/dist/catalog/catalog.js +16 -14
  5. package/dist/catalog/plan.js +1 -1
  6. package/dist/catalog/scaffold.js +4 -1
  7. package/dist/commands/agent.js +5 -3
  8. package/dist/commands/build.js +69 -10
  9. package/dist/commands/git.js +206 -0
  10. package/dist/commands/init.js +9 -3
  11. package/dist/commands/night-orchestrator.js +6 -4
  12. package/dist/commands/where.js +25 -0
  13. package/dist/dashboard/dashboard-timeline.js +18 -16
  14. package/dist/dashboard/dashboard.js +616 -261
  15. package/dist/dashboard/epic-plan.js +81 -0
  16. package/dist/dashboard/exec-records.js +16 -20
  17. package/dist/dashboard/routines.js +11 -12
  18. package/dist/dashboard/timeline-build.js +5 -9
  19. package/dist/dashboard/timeline.js +23 -18
  20. package/dist/devcontainer/scaffold.js +18 -0
  21. package/dist/docs/frontmatter-namespace.js +1 -48
  22. package/dist/docs/index-command.js +2 -2
  23. package/dist/docs/yaml-business-tables.js +243 -0
  24. package/dist/docs/yaml-interface-tables.js +106 -0
  25. package/dist/docs/yaml-pages-command.js +5 -3
  26. package/dist/docs/yaml-pages.js +268 -3
  27. package/dist/docs/yaml-table-shared.js +70 -0
  28. package/dist/docs/yaml-tables.js +39 -0
  29. package/dist/exec/agent-config.js +31 -0
  30. package/dist/exec/agent-plan.js +3 -2
  31. package/dist/exec/agent-protected-config.js +2 -0
  32. package/dist/exec/commands.js +100 -39
  33. package/dist/exec/commit-hook-skips.js +78 -0
  34. package/dist/exec/core.js +19 -7
  35. package/dist/exec/events.js +179 -8
  36. package/dist/exec/evidence.js +77 -19
  37. package/dist/exec/handoff.js +9 -13
  38. package/dist/exec/limit.js +1 -1
  39. package/dist/exec/mechanical-result.js +45 -0
  40. package/dist/exec/migrate-records.js +249 -0
  41. package/dist/exec/parent-validation.js +209 -15
  42. package/dist/exec/pipeline-state.js +27 -5
  43. package/dist/exec/plans-condense-findings.js +89 -0
  44. package/dist/exec/plans-core.js +45 -19
  45. package/dist/exec/plans-generation.js +52 -30
  46. package/dist/exec/plans-grade-findings.js +8 -3
  47. package/dist/exec/plans-kata-findings.js +61 -0
  48. package/dist/exec/plans-planning.js +3 -3
  49. package/dist/exec/plans-storage.js +12 -24
  50. package/dist/exec/post-integration.js +162 -0
  51. package/dist/exec/queue-command.js +166 -0
  52. package/dist/exec/queue.js +285 -0
  53. package/dist/exec/register-foreign-wait.js +84 -0
  54. package/dist/exec/register-resume.js +55 -56
  55. package/dist/exec/register.js +26 -22
  56. package/dist/exec/repo-integration-sync.js +21 -5
  57. package/dist/exec/repo-integration.js +21 -1
  58. package/dist/exec/reporter.js +121 -23
  59. package/dist/exec/results.js +106 -25
  60. package/dist/exec/review-completion.js +47 -0
  61. package/dist/exec/review-kata.js +112 -0
  62. package/dist/exec/run/agent-pipeline.js +78 -8
  63. package/dist/exec/run/agent.js +32 -13
  64. package/dist/exec/run/change-scope.js +365 -0
  65. package/dist/exec/run/deferred-cleanup.js +31 -0
  66. package/dist/exec/run/in-place.js +73 -33
  67. package/dist/exec/run/job-lock.js +66 -0
  68. package/dist/exec/run/job-sequence.js +137 -0
  69. package/dist/exec/run/job.js +135 -41
  70. package/dist/exec/run/lifecycle-commands.js +189 -37
  71. package/dist/exec/run/lock.js +22 -1
  72. package/dist/exec/run/mode-shared.js +11 -3
  73. package/dist/exec/run/register-command.js +14 -15
  74. package/dist/exec/run/register-core.js +20 -13
  75. package/dist/exec/run/register-mode.js +77 -17
  76. package/dist/exec/run/register-post-review.js +21 -9
  77. package/dist/exec/run/register-resume.js +95 -31
  78. package/dist/exec/run/register-state.js +23 -15
  79. package/dist/exec/run/register-worktree.js +184 -139
  80. package/dist/exec/run/schedule-mode.js +79 -18
  81. package/dist/exec/run/schedule-prepare.js +204 -59
  82. package/dist/exec/run/schedule-task.js +203 -49
  83. package/dist/exec/run/shared.js +9 -3
  84. package/dist/exec/run/trailing-records.js +35 -0
  85. package/dist/exec/run-records.js +2 -0
  86. package/dist/exec/schedule/schedule.js +116 -4
  87. package/dist/exec/shared.js +1 -1
  88. package/dist/exec/smoke.js +190 -0
  89. package/dist/exec/strategy.js +14 -3
  90. package/dist/exec/task-view.js +6 -4
  91. package/dist/exec/trailing-records.js +242 -0
  92. package/dist/exec/trial-commands.js +8 -4
  93. package/dist/exec/trial-core.js +6 -1
  94. package/dist/exec/validate-records-commit.js +110 -0
  95. package/dist/exec/validate-records.js +148 -0
  96. package/dist/exec/validation-metrics.js +181 -0
  97. package/dist/exec/worktree-cleanup-lock.js +26 -0
  98. package/dist/exec/worktree-command.js +38 -17
  99. package/dist/exec/worktree-ops-commit.js +119 -48
  100. package/dist/exec/worktree-ops-lifecycle.js +77 -48
  101. package/dist/exec/worktree-ops-merge.js +13 -2
  102. package/dist/exec/worktree-ops.js +2 -2
  103. package/dist/exec/worktree.js +32 -4
  104. package/dist/grade/apply.js +32 -6
  105. package/dist/grade/command-apply.js +3 -3
  106. package/dist/grade/command-inspect.js +7 -5
  107. package/dist/grade/command-plan.js +1 -1
  108. package/dist/grade/command-run.js +7 -1
  109. package/dist/grade/command-shared.js +1 -1
  110. package/dist/grade/core.js +18 -5
  111. package/dist/grade/markdown.js +3 -3
  112. package/dist/grade/pipeline-state.js +15 -11
  113. package/dist/grade/plan.js +37 -17
  114. package/dist/grade/result.js +3 -3
  115. package/dist/grade/run.js +87 -11
  116. package/dist/grade/target-discovery.js +17 -4
  117. package/dist/grade/targets.js +12 -11
  118. package/dist/job/definition.js +84 -8
  119. package/dist/job/job.js +109 -39
  120. package/dist/job/noop.js +104 -0
  121. package/dist/register/authoring-sources.js +22 -16
  122. package/dist/register/core.js +2 -0
  123. package/dist/register/create-commands.js +28 -3
  124. package/dist/register/deliverable-target.js +9 -1
  125. package/dist/register/epic.js +104 -26
  126. package/dist/register/event-merge.js +3 -0
  127. package/dist/register/events.js +4 -0
  128. package/dist/register/external-project.js +3 -0
  129. package/dist/register/item.js +6 -0
  130. package/dist/register/maintenance-commands.js +6 -3
  131. package/dist/register/planning.js +7 -14
  132. package/dist/register/register.js +74 -16
  133. package/dist/register/track-domains.js +34 -0
  134. package/dist/register/track-plan.js +78 -0
  135. package/dist/register/transition-commands.js +8 -0
  136. package/dist/register/work-table.js +64 -0
  137. package/dist/review/grade.js +35 -13
  138. package/dist/routine/definition.js +13 -3
  139. package/dist/routine/failure.js +30 -0
  140. package/dist/routine/routine.js +189 -71
  141. package/dist/routine/status.js +62 -0
  142. package/dist/routine/storage.js +33 -0
  143. package/dist/schedule/schedule.js +39 -39
  144. package/dist/schedule/strategy-generate-document.js +26 -14
  145. package/dist/schedule/strategy-generate-scope.js +17 -45
  146. package/dist/schedule/strategy-generate.js +33 -3
  147. package/dist/schedule/strategy-profiles.js +86 -12
  148. package/dist/shared/agent-types.js +7 -0
  149. package/dist/shared/condense-records.js +25 -0
  150. package/dist/shared/cross-process-lock.js +9 -1
  151. package/dist/shared/deprecation.js +8 -0
  152. package/dist/shared/dist-freshness.js +8 -2
  153. package/dist/shared/document-metadata.js +20 -0
  154. package/dist/shared/finding-cause.js +20 -0
  155. package/dist/shared/frontmatter-namespace.js +48 -0
  156. package/dist/shared/git-environment.js +2 -1
  157. package/dist/shared/git.js +186 -16
  158. package/dist/shared/grade-result.js +17 -1
  159. package/dist/shared/lefthook-scaffold.js +3 -0
  160. package/dist/shared/local-config.js +244 -0
  161. package/dist/shared/local-state.js +20 -0
  162. package/dist/shared/markdownlint-config.js +8 -3
  163. package/dist/shared/plan-conventions.js +129 -0
  164. package/dist/shared/plan-templates.js +57 -41
  165. package/dist/shared/run-records.js +224 -0
  166. package/dist/shared/specdojo-config.js +73 -41
  167. package/dist/shared/specdojo-gitignore.js +1 -0
  168. package/dist/shared/text.js +74 -6
  169. package/dist/shared/timeline-index.js +2 -0
  170. package/dist/shared/where-alias.js +13 -0
  171. package/dist/specdojo.js +4 -0
  172. package/docs/ja/specdojo/defaults/pm-review-viewpoints.yaml +11 -2
  173. package/docs/ja/specdojo/exec-templates/xep-common-conventions-template.md +4 -74
  174. package/docs/ja/specdojo/exec-templates/xep-condense-template.md +50 -0
  175. package/docs/ja/specdojo/exec-templates/xep-draft-template.md +17 -5
  176. package/docs/ja/specdojo/exec-templates/xep-fully-guided-template.md +16 -3
  177. package/docs/ja/specdojo/exec-templates/xep-recipe-guided-template.md +15 -5
  178. package/docs/ja/specdojo/exec-templates/xep-recipe-maintenance-template.md +6 -0
  179. package/docs/ja/specdojo/exec-templates/xep-register-template.md +1 -1
  180. package/docs/ja/specdojo/exec-templates/xep-rulebook-maintenance-template.md +6 -0
  181. package/docs/ja/specdojo/exec-templates/xep-sample-maintenance-template.md +6 -0
  182. package/docs/ja/specdojo/exec-templates/xep-template-maintenance-template.md +6 -0
  183. package/docs/ja/specdojo/exec-templates/xer-condense-template.md +25 -0
  184. package/docs/ja/specdojo/exec-templates/xp-common-conventions-template.md +50 -0
  185. package/docs/ja/specdojo/exec-templates/xrp-common-conventions-template.md +30 -0
  186. package/docs/ja/specdojo/guides/branch-workflow-guide.md +1 -1
  187. package/docs/ja/specdojo/guides/docs-editing-guide.md +12 -0
  188. package/docs/ja/specdojo/guides/docs-structure-guide.md +48 -15
  189. package/docs/ja/specdojo/guides/exec-config-guide.md +69 -19
  190. package/docs/ja/specdojo/guides/exec-operation-guide.md +97 -18
  191. package/docs/ja/specdojo/guides/exec-worktree-guide.md +20 -11
  192. package/docs/ja/specdojo/guides/job-sequence-guide.md +77 -0
  193. package/docs/ja/specdojo/guides/plan-result-lifecycle-guide.md +92 -55
  194. package/docs/ja/specdojo/guides/project-move-guide.md +381 -0
  195. package/docs/ja/specdojo/guides/quick-start-guide.md +73 -17
  196. package/docs/ja/specdojo/guides/register-operation-guide.md +26 -6
  197. package/docs/ja/specdojo/guides/remote-host-development-guide.md +2 -0
  198. package/docs/ja/specdojo/guides/review-guide.md +22 -19
  199. package/docs/ja/specdojo/guides/routine-operation-guide.md +23 -12
  200. package/docs/ja/specdojo/guides/ryu-guide.md +23 -13
  201. package/docs/ja/specdojo/guides/schedule-design-guide.md +27 -21
  202. package/docs/ja/specdojo/guides/schedule-operation-guide.md +27 -3
  203. package/docs/ja/specdojo/guides/specdojo-overview-guide.md +5 -4
  204. package/docs/ja/specdojo/guides/timeline-design-guide.md +27 -144
  205. package/docs/ja/specdojo/guides/use-case-guide.md +92 -155
  206. package/docs/ja/specdojo/guides/waza-guide.md +12 -8
  207. package/docs/ja/specdojo/recipes/bac-recipe.md +111 -0
  208. package/docs/ja/specdojo/recipes/bes-recipe.md +141 -0
  209. package/docs/ja/specdojo/recipes/bps-recipe.md +88 -139
  210. package/docs/ja/specdojo/recipes/br-recipe.md +77 -0
  211. package/docs/ja/specdojo/recipes/cdfd-overview-recipe.md +97 -109
  212. package/docs/ja/specdojo/recipes/cdfd-recipe.md +85 -146
  213. package/docs/ja/specdojo/recipes/cdfd-uc-recipe.md +92 -99
  214. package/docs/ja/specdojo/recipes/cnd-recipe.md +135 -0
  215. package/docs/ja/specdojo/recipes/cpd-recipe.md +140 -0
  216. package/docs/ja/specdojo/recipes/cxd-recipe.md +162 -0
  217. package/docs/ja/specdojo/recipes/ifd-recipe.md +145 -0
  218. package/docs/ja/specdojo/recipes/ifx-cmd-recipe.md +112 -90
  219. package/docs/ja/specdojo/recipes/ifx-index-recipe.md +164 -0
  220. package/docs/ja/specdojo/recipes/pm-communication-plan-recipe.md +60 -49
  221. package/docs/ja/specdojo/recipes/pm-members-recipe.md +50 -51
  222. package/docs/ja/specdojo/recipes/pm-organization-recipe.md +59 -48
  223. package/docs/ja/specdojo/recipes/pm-plan-recipe.md +72 -50
  224. package/docs/ja/specdojo/recipes/pm-quality-management-plan-recipe.md +40 -49
  225. package/docs/ja/specdojo/recipes/pm-raci-recipe.md +42 -48
  226. package/docs/ja/specdojo/recipes/pm-roles-recipe.md +52 -81
  227. package/docs/ja/specdojo/recipes/prj-assumptions-constraints-dependencies-recipe.md +64 -91
  228. package/docs/ja/specdojo/recipes/prj-charter-recipe.md +71 -106
  229. package/docs/ja/specdojo/recipes/prj-comparison-of-alternatives-recipe.md +78 -156
  230. package/docs/ja/specdojo/recipes/prj-issues-and-approach-recipe.md +62 -111
  231. package/docs/ja/specdojo/recipes/prj-scope-recipe.md +67 -123
  232. package/docs/ja/specdojo/recipes/prj-stakeholder-register-recipe.md +60 -96
  233. package/docs/ja/specdojo/recipes/prj-success-criteria-and-acceptance-criteria-recipe.md +61 -105
  234. package/docs/ja/specdojo/recipes/stsd-recipe.md +88 -80
  235. package/docs/ja/specdojo/recipes/sysd-critical-flows-recipe.md +129 -0
  236. package/docs/ja/specdojo/recipes/sysd-cross-cutting-policy-recipe.md +146 -0
  237. package/docs/ja/specdojo/recipes/sysd-index-recipe.md +141 -0
  238. package/docs/ja/specdojo/recipes/tsd-recipe.md +149 -129
  239. package/docs/ja/specdojo/references/command-reference.md +303 -148
  240. package/docs/ja/specdojo/references/deliverables-reference.md +30 -16
  241. package/docs/ja/specdojo/references/directory-layout-reference.md +3 -2
  242. package/docs/ja/specdojo/references/specdojo-config-reference.md +54 -18
  243. package/docs/ja/specdojo/rulebooks/atc-index-rulebook.md +101 -257
  244. package/docs/ja/specdojo/rulebooks/atc-rulebook.md +102 -228
  245. package/docs/ja/specdojo/rulebooks/bac-rulebook.md +63 -290
  246. package/docs/ja/specdojo/rulebooks/bdd-rulebook.md +162 -80
  247. package/docs/ja/specdojo/rulebooks/bds-rulebook.md +118 -155
  248. package/docs/ja/specdojo/rulebooks/bes-index-rulebook.md +128 -60
  249. package/docs/ja/specdojo/rulebooks/bes-rulebook.md +70 -94
  250. package/docs/ja/specdojo/rulebooks/bps-rulebook.md +24 -56
  251. package/docs/ja/specdojo/rulebooks/br-rulebook.md +58 -103
  252. package/docs/ja/specdojo/rulebooks/ccd-mermaid-rulebook.md +103 -223
  253. package/docs/ja/specdojo/rulebooks/cdfd-d2-rulebook.md +18 -93
  254. package/docs/ja/specdojo/rulebooks/cdfd-mermaid-rulebook.md +18 -52
  255. package/docs/ja/specdojo/rulebooks/cdfd-overview-rulebook.md +109 -147
  256. package/docs/ja/specdojo/rulebooks/cdfd-rulebook.md +80 -108
  257. package/docs/ja/specdojo/rulebooks/cdfd-uc-rulebook.md +51 -55
  258. package/docs/ja/specdojo/rulebooks/cdr-rulebook.md +144 -0
  259. package/docs/ja/specdojo/rulebooks/cdsd-rulebook.md +81 -68
  260. package/docs/ja/specdojo/rulebooks/cdt-rulebook.md +139 -0
  261. package/docs/ja/specdojo/rulebooks/cld-rulebook.md +9 -184
  262. package/docs/ja/specdojo/rulebooks/clis-rulebook.md +170 -0
  263. package/docs/ja/specdojo/rulebooks/cnd-mermaid-rulebook.md +33 -86
  264. package/docs/ja/specdojo/rulebooks/cnd-rulebook.md +79 -249
  265. package/docs/ja/specdojo/rulebooks/cop-index-rulebook.md +45 -131
  266. package/docs/ja/specdojo/rulebooks/cop-rulebook.md +69 -275
  267. package/docs/ja/specdojo/rulebooks/cpd-mermaid-rulebook.md +20 -112
  268. package/docs/ja/specdojo/rulebooks/cpd-rulebook.md +79 -249
  269. package/docs/ja/specdojo/rulebooks/cxd-mermaid-rulebook.md +12 -145
  270. package/docs/ja/specdojo/rulebooks/cxd-rulebook.md +115 -256
  271. package/docs/ja/specdojo/rulebooks/dct-index-rulebook.md +79 -109
  272. package/docs/ja/specdojo/rulebooks/dct-rulebook.md +119 -174
  273. package/docs/ja/specdojo/rulebooks/dec-rulebook.md +6 -14
  274. package/docs/ja/specdojo/rulebooks/dmd-index-rulebook.md +22 -66
  275. package/docs/ja/specdojo/rulebooks/dmd-rulebook.md +36 -94
  276. package/docs/ja/specdojo/rulebooks/dss-rulebook.md +171 -0
  277. package/docs/ja/specdojo/rulebooks/etc-index-rulebook.md +31 -131
  278. package/docs/ja/specdojo/rulebooks/etc-rulebook.md +50 -104
  279. package/docs/ja/specdojo/rulebooks/gl-rulebook.md +93 -57
  280. package/docs/ja/specdojo/rulebooks/ifd-mermaid-rulebook.md +63 -253
  281. package/docs/ja/specdojo/rulebooks/ifx-api-rulebook.md +14 -20
  282. package/docs/ja/specdojo/rulebooks/ifx-cmd-rulebook.md +79 -76
  283. package/docs/ja/specdojo/rulebooks/ifx-file-rulebook.md +182 -237
  284. package/docs/ja/specdojo/rulebooks/ifx-index-rulebook.md +111 -40
  285. package/docs/ja/specdojo/rulebooks/ifx-msg-rulebook.md +14 -22
  286. package/docs/ja/specdojo/rulebooks/imp-business-rulebook.md +23 -46
  287. package/docs/ja/specdojo/rulebooks/imp-data-rulebook.md +41 -64
  288. package/docs/ja/specdojo/rulebooks/imp-interface-rulebook.md +16 -40
  289. package/docs/ja/specdojo/rulebooks/imp-operations-rulebook.md +34 -61
  290. package/docs/ja/specdojo/rulebooks/imp-test-rulebook.md +27 -50
  291. package/docs/ja/specdojo/rulebooks/itc-index-rulebook.md +70 -199
  292. package/docs/ja/specdojo/rulebooks/itc-rulebook.md +65 -153
  293. package/docs/ja/specdojo/rulebooks/mip-index-rulebook.md +74 -150
  294. package/docs/ja/specdojo/rulebooks/mm-rulebook.md +12 -23
  295. package/docs/ja/specdojo/rulebooks/mtp-rulebook.md +99 -176
  296. package/docs/ja/specdojo/rulebooks/nfr-availability-rulebook.md +35 -61
  297. package/docs/ja/specdojo/rulebooks/nfr-index-rulebook.md +75 -117
  298. package/docs/ja/specdojo/rulebooks/nfr-integrity-rulebook.md +31 -60
  299. package/docs/ja/specdojo/rulebooks/nfr-maintainability-rulebook.md +26 -81
  300. package/docs/ja/specdojo/rulebooks/nfr-operations-rulebook.md +32 -70
  301. package/docs/ja/specdojo/rulebooks/nfr-performance-rulebook.md +45 -87
  302. package/docs/ja/specdojo/rulebooks/nfr-reliability-rulebook.md +48 -101
  303. package/docs/ja/specdojo/rulebooks/nfr-security-safety-rulebook.md +44 -80
  304. package/docs/ja/specdojo/rulebooks/nfr-usability-rulebook.md +59 -127
  305. package/docs/ja/specdojo/rulebooks/opd-index-rulebook.md +31 -50
  306. package/docs/ja/specdojo/rulebooks/opd-rulebook.md +42 -109
  307. package/docs/ja/specdojo/rulebooks/opr-index-rulebook.md +29 -42
  308. package/docs/ja/specdojo/rulebooks/opr-rulebook.md +29 -87
  309. package/docs/ja/specdojo/rulebooks/otp-index-rulebook.md +62 -84
  310. package/docs/ja/specdojo/rulebooks/otp-rulebook.md +11 -61
  311. package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +92 -102
  312. package/docs/ja/specdojo/rulebooks/pm-change-request-log-rulebook.md +25 -34
  313. package/docs/ja/specdojo/rulebooks/pm-communication-plan-rulebook.md +30 -53
  314. package/docs/ja/specdojo/rulebooks/pm-issue-log-rulebook.md +23 -35
  315. package/docs/ja/specdojo/rulebooks/pm-members-rulebook.md +27 -45
  316. package/docs/ja/specdojo/rulebooks/pm-organization-rulebook.md +45 -59
  317. package/docs/ja/specdojo/rulebooks/pm-plan-rulebook.md +56 -66
  318. package/docs/ja/specdojo/rulebooks/pm-quality-management-plan-rulebook.md +54 -62
  319. package/docs/ja/specdojo/rulebooks/pm-raci-rulebook.md +46 -65
  320. package/docs/ja/specdojo/rulebooks/pm-risk-register-rulebook.md +28 -35
  321. package/docs/ja/specdojo/rulebooks/pm-roles-rulebook.md +65 -97
  322. package/docs/ja/specdojo/rulebooks/pr-rulebook.md +6 -18
  323. package/docs/ja/specdojo/rulebooks/prj-assumptions-constraints-dependencies-rulebook.md +48 -78
  324. package/docs/ja/specdojo/rulebooks/prj-charter-rulebook.md +23 -97
  325. package/docs/ja/specdojo/rulebooks/prj-comparison-of-alternatives-rulebook.md +61 -153
  326. package/docs/ja/specdojo/rulebooks/prj-issues-and-approach-rulebook.md +43 -116
  327. package/docs/ja/specdojo/rulebooks/prj-scope-rulebook.md +16 -51
  328. package/docs/ja/specdojo/rulebooks/prj-stakeholder-register-rulebook.md +47 -92
  329. package/docs/ja/specdojo/rulebooks/prj-success-criteria-and-acceptance-criteria-rulebook.md +25 -84
  330. package/docs/ja/specdojo/rulebooks/sac-rulebook.md +44 -107
  331. package/docs/ja/specdojo/rulebooks/sf-index-rulebook.md +106 -32
  332. package/docs/ja/specdojo/rulebooks/sf-rulebook.md +111 -61
  333. package/docs/ja/specdojo/rulebooks/sld-rulebook.md +129 -59
  334. package/docs/ja/specdojo/rulebooks/stc-index-rulebook.md +90 -189
  335. package/docs/ja/specdojo/rulebooks/stc-rulebook.md +45 -105
  336. package/docs/ja/specdojo/rulebooks/stsd-mermaid-rulebook.md +46 -40
  337. package/docs/ja/specdojo/rulebooks/stsd-rulebook.md +104 -68
  338. package/docs/ja/specdojo/rulebooks/sysd-critical-flows-rulebook.md +64 -330
  339. package/docs/ja/specdojo/rulebooks/sysd-cross-cutting-policy-rulebook.md +70 -263
  340. package/docs/ja/specdojo/rulebooks/sysd-index-rulebook.md +58 -200
  341. package/docs/ja/specdojo/rulebooks/sysd-rulebook.md +47 -60
  342. package/docs/ja/specdojo/rulebooks/tml-rulebook.md +4 -9
  343. package/docs/ja/specdojo/rulebooks/trc-requirements-to-specs-rulebook.md +69 -71
  344. package/docs/ja/specdojo/rulebooks/trc-requirements-to-tests-rulebook.md +65 -72
  345. package/docs/ja/specdojo/rulebooks/tsd-index-rulebook.md +35 -46
  346. package/docs/ja/specdojo/rulebooks/tsd-rulebook.md +49 -66
  347. package/docs/ja/specdojo/rulebooks/tsp-index-rulebook.md +64 -139
  348. package/docs/ja/specdojo/rulebooks/uis-rulebook.md +91 -161
  349. package/docs/ja/specdojo/rulebooks/utc-index-rulebook.md +49 -144
  350. package/docs/ja/specdojo/rulebooks/utc-rulebook.md +67 -155
  351. package/docs/ja/specdojo/samples/bac-sample.md +106 -21
  352. package/docs/ja/specdojo/samples/bdd-sample.yaml +143 -35
  353. package/docs/ja/specdojo/samples/bds-sample.md +87 -21
  354. package/docs/ja/specdojo/samples/bes-index-sample.md +42 -20
  355. package/docs/ja/specdojo/samples/bes-sample.md +70 -21
  356. package/docs/ja/specdojo/samples/bps-sample.md +42 -54
  357. package/docs/ja/specdojo/samples/br-sample.md +57 -15
  358. package/docs/ja/specdojo/samples/ccd-sample.md +80 -19
  359. package/docs/ja/specdojo/samples/cdfd-sample.md +172 -99
  360. package/docs/ja/specdojo/samples/cdfd-uc-sample.md +9 -7
  361. package/docs/ja/specdojo/samples/cdr-sample.md +78 -0
  362. package/docs/ja/specdojo/samples/cdsd-sample.md +73 -20
  363. package/docs/ja/specdojo/samples/cdt-sample.md +116 -0
  364. package/docs/ja/specdojo/samples/cld-sample.md +3 -30
  365. package/docs/ja/specdojo/samples/clis-sample.md +125 -0
  366. package/docs/ja/specdojo/samples/cnd-sample.md +127 -21
  367. package/docs/ja/specdojo/samples/cpd-sample.md +136 -22
  368. package/docs/ja/specdojo/samples/cxd-sample.md +108 -22
  369. package/docs/ja/specdojo/samples/dct-index-sample.yaml +63 -17
  370. package/docs/ja/specdojo/samples/dec-sample.md +2 -3
  371. package/docs/ja/specdojo/samples/dss-sample.md +175 -0
  372. package/docs/ja/specdojo/samples/gl-sample.yaml +50 -14
  373. package/docs/ja/specdojo/samples/ifd-sample.md +105 -21
  374. package/docs/ja/specdojo/samples/ifx-api-sample.yaml +0 -2
  375. package/docs/ja/specdojo/samples/ifx-cmd-sample.yaml +91 -60
  376. package/docs/ja/specdojo/samples/ifx-file-sample.md +462 -21
  377. package/docs/ja/specdojo/samples/ifx-index-sample.yaml +87 -19
  378. package/docs/ja/specdojo/samples/ifx-msg-sample.yaml +0 -2
  379. package/docs/ja/specdojo/samples/job-sequence.yaml +67 -0
  380. package/docs/ja/specdojo/samples/mip-index-sample.md +98 -20
  381. package/docs/ja/specdojo/samples/pm-communication-plan-sample.md +26 -19
  382. package/docs/ja/specdojo/samples/pm-members-sample.yaml +37 -13
  383. package/docs/ja/specdojo/samples/pm-organization-sample.md +42 -21
  384. package/docs/ja/specdojo/samples/pm-plan-sample.md +78 -26
  385. package/docs/ja/specdojo/samples/pm-quality-management-plan-sample.md +41 -22
  386. package/docs/ja/specdojo/samples/pm-raci-sample.md +63 -28
  387. package/docs/ja/specdojo/samples/pm-roles-sample.yaml +13 -12
  388. package/docs/ja/specdojo/samples/prj-assumptions-constraints-dependencies-sample.md +33 -25
  389. package/docs/ja/specdojo/samples/prj-charter-sample.md +42 -59
  390. package/docs/ja/specdojo/samples/prj-comparison-of-alternatives-sample.md +83 -62
  391. package/docs/ja/specdojo/samples/prj-success-criteria-and-acceptance-criteria-sample.md +30 -33
  392. package/docs/ja/specdojo/samples/sf-index-sample.md +47 -20
  393. package/docs/ja/specdojo/samples/sf-sample.md +109 -21
  394. package/docs/ja/specdojo/samples/sld-sample.md +88 -21
  395. package/docs/ja/specdojo/samples/stsd-sample.md +54 -26
  396. package/docs/ja/specdojo/samples/sysd-critical-flows-sample.md +166 -21
  397. package/docs/ja/specdojo/samples/sysd-cross-cutting-policy-sample.md +178 -21
  398. package/docs/ja/specdojo/samples/sysd-index-sample.md +82 -21
  399. package/docs/ja/specdojo/samples/tml-sample.yaml +4 -1
  400. package/docs/ja/specdojo/samples/uis-sample.md +141 -20
  401. package/docs/ja/specdojo/standards/document-metadata-standard.md +33 -4
  402. package/docs/ja/specdojo/standards/id-and-file-naming-standard.md +3 -1
  403. package/docs/ja/specdojo/standards/job-definition-standard.md +24 -9
  404. package/docs/ja/specdojo/standards/rulebook-authoring-standard.md +1 -0
  405. package/docs/ja/specdojo/templates/bac-template.md +76 -0
  406. package/docs/ja/specdojo/templates/bes-template.md +56 -0
  407. package/docs/ja/specdojo/templates/br-template.md +64 -0
  408. package/docs/ja/specdojo/templates/cdfd-template.md +81 -54
  409. package/docs/ja/specdojo/templates/cdfd-uc-template.md +9 -5
  410. package/docs/ja/specdojo/templates/cdr-template.md +58 -0
  411. package/docs/ja/specdojo/templates/cnd-template.md +137 -0
  412. package/docs/ja/specdojo/templates/cpd-template.md +129 -0
  413. package/docs/ja/specdojo/templates/cxd-template.md +105 -0
  414. package/docs/ja/specdojo/templates/dct-data-model-cdt-template.yaml +40 -0
  415. package/docs/ja/specdojo/templates/dct-data-model-cld-template.yaml +7 -14
  416. package/docs/ja/specdojo/templates/dct-index-template.md +9 -20
  417. package/docs/ja/specdojo/templates/dct-project-management-template.yaml +5 -1
  418. package/docs/ja/specdojo/templates/ifd-template.md +86 -0
  419. package/docs/ja/specdojo/templates/ifx-cmd-template.yaml +44 -28
  420. package/docs/ja/specdojo/templates/ifx-index-template.yaml +40 -0
  421. package/docs/ja/specdojo/templates/opr-template.md +2 -4
  422. package/docs/ja/specdojo/templates/pm-organization-template.md +9 -3
  423. package/docs/ja/specdojo/templates/pm-plan-template.md +4 -4
  424. package/docs/ja/specdojo/templates/pm-quality-management-plan-template.md +17 -9
  425. package/docs/ja/specdojo/templates/pm-raci-template.md +24 -13
  426. package/docs/ja/specdojo/templates/pm-roles-template.yaml +3 -2
  427. package/docs/ja/specdojo/templates/prj-assumptions-constraints-dependencies-template.md +6 -3
  428. package/docs/ja/specdojo/templates/prj-comparison-of-alternatives-template.md +22 -19
  429. package/docs/ja/specdojo/templates/stsd-template.md +46 -21
  430. package/docs/ja/specdojo/templates/sysd-critical-flows-template.md +94 -0
  431. package/docs/ja/specdojo/templates/sysd-cross-cutting-policy-template.md +122 -0
  432. package/docs/ja/specdojo/templates/sysd-index-template.md +89 -0
  433. package/docs/specdojo/lib/yaml-metadata.cjs +7 -0
  434. package/docs/specdojo/schemas/v1/bdd.schema.yaml +25 -57
  435. package/docs/specdojo/schemas/v1/condense-records.schema.yaml +26 -0
  436. package/docs/specdojo/schemas/v1/dct.schema.yaml +10 -0
  437. package/docs/specdojo/schemas/v1/deliverable-frontmatter.schema.yaml +3 -0
  438. package/docs/specdojo/schemas/v1/esil.schema.yaml +7 -141
  439. package/docs/specdojo/schemas/v1/exec-common.schema.yaml +5 -1
  440. package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +95 -8
  441. package/docs/specdojo/schemas/v1/exec-evidence.schema.yaml +38 -0
  442. package/docs/specdojo/schemas/v1/exec-plan-frontmatter.schema.yaml +14 -0
  443. package/docs/specdojo/schemas/v1/exec-result-frontmatter.schema.yaml +18 -0
  444. package/docs/specdojo/schemas/v1/finding-cause.schema.yaml +22 -0
  445. package/docs/specdojo/schemas/v1/grade-pipeline-state.schema.yaml +1 -1
  446. package/docs/specdojo/schemas/v1/grade-result.schema.yaml +2 -0
  447. package/docs/specdojo/schemas/v1/ifx-cmd.schema.yaml +65 -5
  448. package/docs/specdojo/schemas/v1/ifx-index.schema.yaml +142 -0
  449. package/docs/specdojo/schemas/v1/job-run.schema.yaml +23 -0
  450. package/docs/specdojo/schemas/v1/job.schema.yaml +63 -2
  451. package/docs/specdojo/schemas/v1/register-events.schema.yaml +2 -0
  452. package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +17 -1
  453. package/docs/specdojo/schemas/v1/sch-strategy.schema.yaml +2 -2
  454. package/package.json +10 -7
  455. package/templates/antigravity/orchestrator.md +7 -3
  456. package/templates/claude/agents/specdojo-orchestrator.md +7 -3
  457. package/templates/codex/agents/specdojo-orchestrator.toml +7 -3
  458. package/templates/codex/orchestrator.md +7 -3
  459. package/templates/devcontainer/tmux.conf +6 -0
  460. package/templates/init-exec-defaults.yaml +13 -0
  461. package/templates/lefthook/tools/specdojo-pre-commit.mjs +8 -0
  462. package/templates/opencode/agents/specdojo-orchestrator.md +8 -4
@@ -12,34 +12,26 @@ specdojo:
12
12
 
13
13
  Issue Log Documentation Rules
14
14
 
15
- 本ドキュメントは、`課題ログ` を一貫した粒度で作成するためのルールを定義する。
15
+ 顕在化した課題の優先度・期限・対応・状態を追跡する課題ログの記述基準を定める。
16
16
 
17
17
  ## 1. 全体方針
18
18
 
19
- - 発生課題の特定、優先度判断、対応状況を追跡可能に管理する。
20
- - 課題ごとにID、期限、担当、状態、次アクションを明確にする。
21
- - 曖昧表現を避け、未解決課題の判定が可能な記述にする。
19
+ - 顕在化した課題ごとに、未解決かどうかと次の対応を判定できる形で残す。
20
+ - **共通の運用**: 役割の割り当ては適用先のメンバー定義に、`status`・承認・改訂と廃止・未決事項の引き継ぎは [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] に従う。文書の整形・lint はリポジトリの検証で扱う。
22
21
 
23
- ## 2. 位置づけと用語定義(必要に応じて)
22
+ ## 2. 位置づけ
24
23
 
25
- - `pm-plan`: 全体管理方針。
26
- - `pm-risk-register`: 潜在リスクの管理。
27
- - `pm-issue-log`: 顕在化した課題の管理。
24
+ - プロジェクト登録簿を使うプロジェクトでは、課題 1 件を `item_type: issue` の個票に書き、`controls/generated/pm-issue-log.md` は `register build` が個票から生成する。生成物の Frontmatter は `rulebook: specdojo:pjr-rulebook` とし、直接編集しない([[specdojo:pjr-rulebook|プロジェクト登録簿 作成ルール]] に従う)。
25
+ - 本書の判断基準は、個票と、登録簿を使わない単独の課題ログの両方に適用する。
28
26
 
29
27
  ## 3. ファイル命名・ID規則
30
28
 
31
- - `id` は `pm-issue-log` を使用する。
32
- - ファイル名は `pm-issue-log-課題ログ.md` など一意にする。
29
+ - `id` は `<project-id>:pm-issue-log`、ファイル名は `pm-issue-log.md` とする。
30
+ - 課題 ID は登録簿では `PJR-XXXX`、単独のログでは `IS-NNN` とし、再利用しない。
33
31
 
34
32
  ## 4. 推奨 Frontmatter 項目
35
33
 
36
- | 項目 | 説明 | 必須 |
37
- | ---------- | -------------------------------- | ---- |
38
- | id | `pm-issue-log` | ○ |
39
- | type | `project` 固定 | ○ |
40
- | status | `draft` / `ready` / `deprecated` | ○ |
41
- | based_on | 根拠仕様ID(配列) | 任意 |
42
- | supersedes | 置換関係ID(配列) | 任意 |
34
+ - 許可キーと型は [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] を正本とし、`type` は `project` とする。
43
35
 
44
36
  ## 5. 本文構成(標準テンプレ)
45
37
 
@@ -56,39 +48,35 @@ Issue Log Documentation Rules
56
48
 
57
49
  ### 6.1. 概要
58
50
 
59
- - 管理対象、レビュー頻度、更新責任者を 1〜3 行で示す。
51
+ - 管理対象、レビュー頻度、記録単位を 1〜3 行で示す。
60
52
 
61
53
  ### 6.2. 課題ログ一覧
62
54
 
63
- - 課題ID、発生日、内容、優先度、対応策、担当、期限、ステータスを一覧化する。
64
-
65
- 推奨フォーマット(表):
66
-
67
- | 課題ID | 発生日 | 内容 | 優先度 | 対応策 | 担当 | 期限 | ステータス |
68
- | ------ | ------ | ---- | ------ | ------ | ---- | ---- | ---------- |
55
+ - 課題 ID、発生日、内容、優先度、対応策、担当、期限、ステータスを一覧にする。
56
+ - 優先度とステータスは登録簿の `priority`・`item_status` の値を使い、言い換えない。
69
57
 
70
58
  ### 6.3. 優先度と期限
71
59
 
72
- - 優先度基準、期限設定ルール、期限超過時対応を明記する。
60
+ - 優先度の基準、期限の決め方、期限超過時のエスカレーション先、優先度の変更を決める者を書く。
73
61
 
74
62
  ### 6.4. 対応計画
75
63
 
76
- - 対応策、依存事項、完了条件を明記する。
64
+ - 対応策、依存事項、完了条件を書く。完了条件は確認の手段と合格の基準で書く。
77
65
 
78
66
  ### 6.5. 進捗レビュー
79
67
 
80
- - レビュー周期、判定観点、更新ルールを明記する。
68
+ - レビュー周期、完了を判定する者と判定の観点、状態を更新する契機を書く。
81
69
 
82
70
  ### 6.6. 関連ドキュメント
83
71
 
84
- - `pm-risk-register`、`pm-change-request-log` への導線を記載する。
85
- - 関連がない場合でも `(本書のみ)` を明記する。
72
+ - 根拠、影響先、課題から起票したリスク・変更要求を文書 ID で示す。なければ `(本書のみ)` と書く。
86
73
 
87
74
  ## 7. 禁止事項
88
75
 
89
- | 禁止事項 | 理由 |
90
- | ---------------------------- | -------------------------- |
91
- | 課題IDなしで記録する | 追跡不能になるため |
92
- | 優先度・期限を未記載にする | 対応順序が判断できないため |
93
- | 状態更新ルールを未定義にする | 管理の一貫性が崩れるため |
94
- | 根拠のない完了判定を記載する | 品質低下を招くため |
76
+ | 禁止事項 | 理由 |
77
+ | ------------------------------------------ | -------------------------- |
78
+ | 課題IDなしで記録する | 追跡不能になるため |
79
+ | 優先度・期限を未記載にする | 対応順序が判断できないため |
80
+ | 根拠のない完了判定を記載する | 品質低下を招くため |
81
+ | 個人情報・認証情報を内容や対応策に書き写す | 公開範囲を超えて広がるため |
82
+ | 生成された `pm-issue-log.md` を直す | 再生成で修正が失われるため |
@@ -16,40 +16,32 @@ specdojo:
16
16
 
17
17
  Project Human Member Roster Documentation Rulebook
18
18
 
19
- `pm-members.yaml` を、人間の実行主体と対応 Role code を管理するプロジェクト成果物として作成・更新するためのルールです。実行可能な agent の定義は、リポジトリ共通の保護設定へ分離します。
19
+ `pm-members.yaml` に人間の実行主体と対応 Role code を定義する基準です。
20
20
 
21
21
  ## 1. 全体方針
22
22
 
23
- - `pm-members.yaml` には人間の member だけを記載し、`members[].type` は `human` とします。
24
- - 実行可能な agent は `.specdojo/agent-members.yaml` を正本とし、`pm-members.yaml` に複製しません。
25
- - Member は実行主体、Role code は責務を表します。Schedule の `owner` には member nickname を書きません。
26
- - `members[].roles` には `pm-roles.yaml` に存在する Role code だけを記載します。
27
- - 公開文書には、不要な個人名、私用メールアドレス、非公開組織情報、アクセス情報を記載しません。
28
- - 人間の最終承認、公開可否、説明責任は agent 定義へ移しません。
23
+ - 対象は project の人間名簿です。agent の実行定義は含めません。
24
+ - Role・Member・`owner` の区別と公開情報の扱いは [[specdojo:people-and-organization-definition-standard|人と組織の定義標準]] に従います。
25
+ - **共通の運用**: 役割の割り当ては適用先のメンバー定義に、`status`・承認・改訂と廃止・未決事項の引き継ぎは [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] に従います。文書の整形・lint はリポジトリの検証で扱います。
29
26
 
30
27
  ## 2. 位置づけと用語定義
31
28
 
32
- | 情報 | 正本 | 粒度 |
33
- | ----------------------------- | ------------------------------ | ---------- |
34
- | 人間の identity・連絡先・兼務 | `pm-members.yaml` | project |
35
- | agent の identity・選択属性 | `.specdojo/agent-members.yaml` | repository |
36
- | provider の起動コマンド | `.specdojo/exec-defaults.yaml` | repository |
37
- | Role code と責務 | `pm-roles.yaml` | project |
38
- | Schedule の主責任 | Schedule の `owner` | task |
39
-
40
- `loadMemberRoster` は人間名簿と agent 定義を schema 検証した後に合成します。合成後の nickname は一意でなければならず、`--by` と実行イベントはこの合成名簿を参照します。
29
+ | 情報 | 正本 |
30
+ | ----------------------------- | ------------------------------ |
31
+ | 人間の identity・連絡先・兼務 | project の `pm-members.yaml` |
32
+ | agent の identity・選択属性 | `.specdojo/agent-members.yaml` |
33
+ | provider の起動コマンド | `.specdojo/exec-defaults.yaml` |
41
34
 
42
35
  ## 3. ファイル命名・ID規則
43
36
 
44
- - ファイル名は `pm-members.yaml` とします。
45
- - 配置は `docs/ja/projects/<project-id>/030-project-management/pm-members.yaml` を推奨します。
37
+ - ファイル名は `pm-members.yaml`、推奨配置は `docs/ja/projects/<project-id>/030-project-management/` です。
46
38
  - `id` は `<project-id>:pm-members`、`project_id` は配置先 project ID と一致させます。
47
- - `members[].nickname` は英小文字または数字で始め、英小文字、数字、ハイフン、アンダースコアだけを使います。
48
- - 実行ログへ記録済みの nickname は変更せず、交代時は新しい member を追加します。
49
- - 同じ nickname を `.specdojo/agent-members.yaml` に定義しません。
39
+ - `members[].nickname` は1〜63文字、先頭は英小文字か数字、以降は英小文字・数字・`_`・`-` とします。
50
40
 
51
41
  ## 4. 推奨メタ項目
52
42
 
43
+ 許可キーと型は `docs/specdojo/schemas/v1/pm-members.schema.yaml` を正本とし、メタ項目はルートに置きます。
44
+
53
45
  | 項目 | 必須 | 内容 |
54
46
  | ------------ | ---- | -------------------------------- |
55
47
  | `id` | ○ | `<project-id>:pm-members` |
@@ -57,12 +49,11 @@ Project Human Member Roster Documentation Rulebook
57
49
  | `status` | ○ | `draft` / `ready` / `deprecated` |
58
50
  | `title` | ○ | 名簿の表示名 |
59
51
  | `rulebook` | ○ | `specdojo:pm-members-rulebook` |
60
- | `based_on` | 任意 | 根拠文書 ID |
61
- | `version` | ○ | 1 以上のデータ版 |
52
+ | `based_on` | 任意 | 根拠文書 ID の配列 |
53
+ | `supersedes` | 任意 | 置き換える旧文書 ID の配列 |
54
+ | `version` | ○ | 1 以上の整数 |
62
55
  | `project_id` | ○ | 対象 project ID |
63
56
 
64
- schema にないメタ項目は追加しません。成果物の `status` は作成中は `draft` とし、`ready` への変更は人間が判断します。
65
-
66
57
  ## 5. 本文要件
67
58
 
68
59
  | 要素 | 必須 | 内容 |
@@ -70,14 +61,14 @@ schema にないメタ項目は追加しません。成果物の `status` は作
70
61
  | `members` | ○ | 人間 member の配列 |
71
62
  | `rules` | 任意 | 名簿利用時の project 固有の運用ルール |
72
63
 
73
- `members[]` は次のフィールドを使用します。
64
+ `members[]` の必須性は対応 schema を優先します。上位の人と組織の定義標準では任意の `roles` も、本形式では必須です。
74
65
 
75
66
  | フィールド | 必須 | 内容 |
76
67
  | -------------------- | ---- | --------------------------------------------------------- |
77
68
  | `nickname` | ○ | CLI と履歴で使う安定識別子 |
78
69
  | `display_name` | ○ | 公開可能な表示名 |
79
- | `email` | 任意 | 公開可能な連絡先。不要または非公開なら `null` |
80
- | `roles` | ○ | 対応可能な Role code の配列 |
70
+ | `email` | 任意 | 公開可能な連絡先または `null` |
71
+ | `roles` | ○ | `pm-roles.yaml` に存在する Role code の重複なし配列 |
81
72
  | `type` | ○ | `human` 固定 |
82
73
  | `persona` | 任意 | 作業姿勢を示す短いラベル |
83
74
  | `focus` | 任意 | 重視する観点の配列 |
@@ -89,31 +80,22 @@ schema にないメタ項目は追加しません。成果物の `status` は作
89
80
  ### 6.1. 人間 member
90
81
 
91
82
  - 個人名を必要としない場合は、`po` や `store-owner` のような役割ベースの nickname と表示名を使います。
92
- - `roles` は兼務を表し、責務定義そのものは `pm-roles.yaml` に委ねます。
93
- - 最終判断、公開可否、説明責任を担う範囲は `note` に短く記載します。
83
+ - 兼務は `roles: [PO, BA]` のように記載します。
94
84
  - 連絡先を公開できない場合は推測で補わず `email: null` とします。
95
85
 
96
86
  ### 6.2. 合成名簿との整合
97
87
 
98
- - nickname が `.specdojo/agent-members.yaml` と重複しないことを確認します。
99
- - `--by` に人間または agent の nickname を指定する場合、合成名簿に一意に存在する値を使います。
88
+ - 人間名簿と agent 定義の合成後、全 nickname が一意であり、`--by`・実行イベントが登録値を使うことを照合します。
100
89
  - `pm-members.yaml` に `type: agent` が残る場合は、`specdojo config migrate-members --dry-run` で移行内容を確認します。
101
- - agent の追加・優先度・能力変更は、保護設定を変更できる人間または orchestrator が行います。
102
90
 
103
91
  ### 6.3. 運用ルール
104
92
 
105
- - `rules` には `owner`、`roles`、`--by` の使い分けを判定可能な文として記載します。
106
- - project 固有の公開制約や交代時の扱いだけを記載し、共通 schema を再掲しません。
107
- - agent の provider、モデル、起動 command は記載しません。
108
- - 名簿の変更理由は project の変更管理記録に残します。
93
+ - `rules` は project 固有の公開制約や交代時の扱いに限定し、共通標準・schema を再掲しません。
109
94
 
110
95
  ## 7. 禁止事項
111
96
 
112
- | 禁止事項 | 理由 |
113
- | ------------------------------------------------------ | ---------------------------------------- |
114
- | `type: agent` の member を記載する | 保護設定との責務境界が崩れるため |
115
- | `provider`、`command`、`mode`、`stage_role` を記載する | agent 実行設定を成果物から変更できるため |
116
- | Schedule の `owner` に nickname や人名を書く | 責務と実行主体を混同するため |
117
- | 未定義の Role code を `roles` に書く | ロール正本との整合が失われるため |
118
- | 実行ログ記録後の nickname を変更する | 履歴の参照先が不明になるため |
119
- | 秘密情報、私用連絡先、非公開組織情報を記載する | 公開適性と安全性を損なうため |
97
+ | 禁止事項 | 理由 |
98
+ | ---------------------------------------------------------------- | ---------------------------------------- |
99
+ | `type: agent` の member を記載する | 保護設定との責務境界が崩れるため |
100
+ | `provider`、`command`、`mode`、`stage_role` を記載する | agent 実行設定を成果物から変更できるため |
101
+ | 実行ログ記録後の nickname を変更する(交代時は新 member を追加) | 履歴の参照先が不明になるため |
@@ -16,94 +16,80 @@ 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
- - プロジェクト規模、関係者、判断の複雑さに合う最小体制を定義します。
24
- - 組織図や役職の網羅ではなく、価値判断、実行、品質確認、公開・運用の責任境界を示します。
25
- - Role code はロール定義、実行主体と兼務はメンバー定義、成果物・プロセス責任は RACI を正本とします。
26
- - 小規模では兼務を認めますが、最終判断と実作業の責任を概念上は分けます。
27
- - AI Agent は実行支援者であり、最終承認、当事者価値、公開可否、説明責任を担いません。
28
- - 参加者や責務が増えた場合に、軽量体制から分担体制へ拡張する条件を示します。
23
+ - 規模・関係者・判断の複雑さに合う最小体制とし、価値判断、実行、品質確認、公開・運用の責任境界を示します。
24
+ - ロールの採用と専任配置を分け、兼務時も最終判断と実作業を区別します。
25
+ - 参加者や責務の増加に応じて、分担体制へ拡張する条件を示します。
26
+ - **共通の運用**: 役割の割り当ては適用先のメンバー定義に、`status`・承認・改訂と廃止・未決事項の引き継ぎは [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] に従います。文書の整形・lint はリポジトリの検証で扱い、業務の受入確認に含めません。
29
27
 
30
- ## 2. 位置づけと用語定義
28
+ ## 2. 位置づけ
31
29
 
32
- | 用語 | 定義 |
33
- | ---------- | ------------------------------------------------------ |
34
- | 組織モデル | 意思決定、実行、確認をどの責任領域へ分けるかという設計 |
35
- | Role code | Schedule owner や RACI で使う責任語彙 |
36
- | 実行主体 | 実際に作業する人、チーム、または支援する Agent |
37
- | 兼務 | 一つの実行主体が複数の Role code を担うこと |
30
+ 共通定義と整合性ルールは [[specdojo:people-and-organization-definition-standard|人と組織の定義標準]] を正本とします。組織定義はプロジェクト固有の採用判断を残し、Schedule と RACI のロール適合を確認する起点です。採用結果の機械可読な定義は `pm-roles.yaml`、実行主体と兼務はメンバー定義、成果物・プロセス別の分担は RACI で扱います。
38
31
 
39
32
  ## 3. ファイル命名・ID規則
40
33
 
41
34
  - 配置は `docs/ja/projects/<project-id>/030-project-management/pm-organization.md` を推奨します。
42
35
  - ID は `<project-id>:pm-organization`、ファイル名は `pm-organization.md` とします。
43
- - Role code、member nickname、Schedule owner の形式は組織関連標準と各YAML正本に従います。
36
+ - 共通の命名規則は [[specdojo:docs-structure-guide|ドキュメント構成ガイド]] に従います。
44
37
 
45
38
  ## 4. 推奨 Frontmatter 項目
46
39
 
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 | 任意 |
40
+ - 共通項目の必須・任意、型・許容値は [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] と同標準から参照する成果物 schema に従います。
41
+ - `rulebook` には本書の ID を指定し、成果物の種別は本書の `deliverable_type` に合わせます。
42
+ - `based_on` には採用判断の根拠となる先行成果物を指定し、依存関係に含まれない文書は本文で参照します。
55
43
 
56
- ## 5. 本文構成(標準テンプレ)
44
+ ## 5. 本文要件
57
45
 
58
- | 番号 | 見出し | 必須 | 内容 |
59
- | ---- | ----------------- | ---- | --------------------------------------------- |
60
- | 1 | 組織モデル | ○ | 規模、責任領域、兼務、人と AI の境界 |
61
- | 2 | ロール・owner方針 | ○ | Role code の利用範囲、owner、実行主体との区別 |
62
- | 3 | 正本と責任境界 | ○ | 情報ごとの正本と本書の責務 |
63
- | 4 | 見直し条件 | ○ | 体制を変更・拡張するトリガーと判断者 |
46
+ 以下はすべて必須です。見出し順・表・記入欄の骨組みは Frontmatter で宣言した template を正本とします。
47
+
48
+ | 要件 | 記載する判断・根拠 |
49
+ | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------ |
50
+ | 体制の設計 | 規模と目的に必要な責任領域、最終判断、実行・確認、兼務方針、人間と AI Agent の境界 |
51
+ | ロールの採用判断 | 各標準ロールと独自ロールの採用・未採用、理由、プロジェクトでの扱い。未採用は代替先または対象外の理由を示し、未採用がなければ「なし」と明記 |
52
+ | 使用可能な `owner` | Schedule に使える採用ロールの集合。RACI の列とロール定義との整合 |
53
+ | 正本への参照 | 関連定義との責務境界。未作成の文書は作成予定または省略理由 |
54
+ | 体制の見直し | 開始トリガー、確認事項、更新先、判断者の Role code、追従確認。未決事項がある場合は論点と体制への影響 |
64
55
 
65
56
  ## 6. 記述ガイド
66
57
 
67
- ### 6.1. 組織モデル
58
+ 以下の判断基準と例に従います。Role code の値・構文は人と組織の定義標準と各 YAML の schema を参照します。
68
59
 
69
- | 責任領域 | 設計方針 | 最終判断 | 実行・確認 |
70
- | -------- | -------- | -------- | ---------- |
60
+ ### 6.1. 組織モデル
71
61
 
72
- - 目的達成に必要な責任領域だけを示し、全Role codeを列挙しません。
73
- - 当事者・利用者による価値確認と、プロジェクト内部の管理責任を区別します。
74
- - 兼務する場合も、最終判断と実行・確認を読み分けられるようにします。
62
+ - 判断基準は、目的に必要な責任領域に漏れがなく、当事者・利用者の価値確認と内部の管理責任を区別できることです。
63
+ - 推奨表の列は「責任領域」「設計方針」「最終判断」「実行・確認」です。責任者は RACI と整合させます。
64
+ - 良い例: 「店主の操作確認を `BA` が受け止め、`PO` が受入を判断する。初期は兼務する」。
65
+ - 悪い例: 「小規模なので責任は全員で持つ」。判断者と実行・確認の分担が分かりません。
75
66
 
76
67
  ### 6.2. ロール・owner方針
77
68
 
78
- - Schedule owner と RACI 列には、ロール定義に存在する Role code だけを使います。
79
- - Role code の採用は専任memberの配置を意味しないことを明記します。
80
- - 実行主体、兼務、Agent利用はメンバー定義へ委譲します。
69
+ - 判断基準は、採用可否の根拠と使用可能な `owner` を特定し、Schedule と RACI の列を照合できることです。
70
+ - 推奨表の列は「Role code」「採用/未採用」「判断理由・プロジェクトでの扱い」「未採用時の代替方針」です。共通の正式名称・責務は転載しません。
71
+ - 良い例: 「`PO` と `BA` を採用し、`owner` に使う。`PM` は未採用とし、計画・進捗管理は `PO` が担う」。他の標準ロールも採否を記載します。
72
+ - 悪い例: 「`PM` は専任者がいないので未採用だが、`owner` に使う」。採用と配置を混同しています。
81
73
 
82
74
  ### 6.3. 正本と責任境界
83
75
 
84
- | 情報 | 正本 | 本書で扱うこと |
85
- | ---- | ---- | -------------- |
86
-
87
- - ロール語彙、実行主体、責任分担、関係者の正本を分けます。
88
- - 正本の内容を要約・複製せず、組織設計上の使い分けだけを書きます。
89
- - Scheduleや個別成果物の責任割り当ては本書に持ち込みません。
76
+ - 判断基準は、情報の更新先が一意で、本書の採用判断を外部へ委譲していないことです。
77
+ - 推奨表の列は「情報」「正本」「本書で扱うこと」です。「位置づけ」の責務境界に従います。
78
+ - 良い例: 「本書で採用を決め、ロール定義に採用結果を反映する」。
79
+ - 悪い例: 「使用できるロールはロール定義を参照」とだけ書く、または名簿・詳細 RACI を複製する。採用根拠が欠けるか、更新先が分散します。
90
80
 
91
81
  ### 6.4. 見直し条件
92
82
 
93
- | トリガー | 確認すること | 更新先 | 判断者 |
94
- | -------- | ------------ | ------ | ------ |
95
-
96
- - 目的・スコープ、関係者、参加者、作業滞留、公開・運用責任の変化を扱います。
97
- - 新しいRole codeを増やす前に、既存責任の再配分で対応できるか確認します。
98
- - 体制変更はロール、メンバー、RACI、Scheduleの必要な正本だけへ反映します。
83
+ - 判断基準は、目的・スコープ、関係者、参加者、作業滞留、公開・運用責任の変化から、体制変更の開始条件を判定できることです。ロール追加の前に既存責任の再配分を検討します。
84
+ - 推奨表の列は「トリガー」「確認すること」「更新先」「判断者」です。追従先はロール定義、メンバー定義、RACI、WBS、Schedule とし、採用変更の影響箇所を確認します。
85
+ - 良い例: 「兼務による承認待ちで Schedule の期限を超えたら、役割再配分を検討する。変更対象の RACI と Schedule に担当不在や使用不可ロールが残らないことを確認する」。
86
+ - 悪い例: 「忙しくなったら体制を強化する」。開始条件、更新先、判断者が分かりません。
99
87
 
100
88
  ## 7. 禁止事項
101
89
 
102
- | 禁止事項 | 理由 |
103
- | ---------------------------------------------------- | -------------------------------- |
104
- | Role code、member、RACIの一覧を再掲する | 正本が分散するため |
105
- | member nickname、人名、agent名をSchedule ownerにする | 責任語彙と実行主体を混同するため |
106
- | 兼務を理由に最終判断者を曖昧にする | 説明責任が不明になるため |
107
- | Agentに最終承認、当事者価値、公開可否を委ねる | 人間の判断責任を代替するため |
108
- | 必要性を示さずRole codeや階層を増やす | 小規模運用の負荷を増やすため |
109
- | 個人情報、秘密情報、アクセス情報を記載する | 公開適性に反するため |
90
+ | 禁止事項 | 理由 |
91
+ | -------------------------------------------------------------------------------------- | -------------------------------------------------------- |
92
+ | 採用・未採用 Role code と使用可能な `owner` を省略し、ロール定義への参照だけで済ませる | プロジェクト固有の採用判断と適合確認の根拠が失われるため |
93
+ | 共通のロール定義、メンバー名簿、詳細な RACI を再掲する | 正本が分散するため |
94
+ | 未採用・未定義の Role code を Schedule の `owner` や RACI 列に使う | 採用判断と責任語彙が不整合になるため |
95
+ | 必要性を示さず Role code や階層を増やす | 小規模運用の負荷を増やすため |
@@ -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
  # プロジェクト管理計画 作成ルール
@@ -20,104 +21,93 @@ Project Management Plan Documentation Rulebook
20
21
 
21
22
  ## 1. 全体方針
22
23
 
23
- - 管理計画は、何を管理し、どの逸脱を、誰が、どの証跡で判断するかを示します。
24
+ - 管理対象ごとに、期待価値・リスク、逸脱の基準、対応、責任、証跡を結び付けます。
25
+ - プロジェクト概要、スコープ、成功基準を直接の根拠とし、期待価値の検証を管理目的にします。
26
+ - 個別計画や管理台帳の詳細は各正本へ委譲します。
27
+ - **共通の運用**: 役割の割り当ては適用先のメンバー定義に、`status`・承認・改訂と廃止・未決事項の引き継ぎは [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] に従います。文書の整形・lint はリポジトリの検証で扱い、業務の受入確認に含めません。
24
28
 
25
- - プロジェクト概要、スコープ、成功基準を直接の根拠とし、作業完了ではなく期待価値の検証を管理目的にします。
26
- - 小規模プロジェクトでは一つの統合表を基本とし、規模・契約・監査要件がある場合だけ個別計画へ展開します。
27
- - 品質、コミュニケーション、組織、RACI、Schedule、登録簿は各正本へ委譲し、本書に一覧や詳細手順を複製しません。
28
- - 現金支出、人の作業時間、継続運用負荷を区別し、人への負荷転嫁をコスト削減とみなしません。
29
- - AI Agent は整理・更新・検証を支援できますが、優先順位、例外、公開、GO / Not GO の最終判断は人間が担います。
29
+ ## 2. 位置づけ
30
30
 
31
- ## 2. 位置づけと用語定義
32
-
33
- | 用語 | 定義 |
34
- | ---------------- | ------------------------------------------------------------------------ |
35
- | 統合管理方針 | スコープ、Schedule、費用・負荷、品質、課題・リスク・変更を一表で扱う方針 |
36
- | 判断ゲート | 継続、公開、変更、停止などを人間が判断する時点と条件 |
37
- | 正本 | 状態、責任、判断根拠を最終的に確認する文書、YAML、登録簿、または記録 |
38
- | 軽量プロファイル | 必要最小限の統合表と判断ゲートで管理する方式 |
39
- | 拡張プロファイル | 契約、監査、組織規模に応じ、個別計画や詳細手順を追加する方式 |
31
+ - 本計画は横断的な管理基準と判断の接続を担い、個別計画・管理記録の更新先を示します。
32
+ - 小規模では統合表と判断ゲートによる軽量プロファイルを基本とし、契約・監査・組織規模に応じて個別計画を追加する拡張プロファイルを選びます。
40
33
 
41
34
  ## 3. ファイル命名・ID規則
42
35
 
43
36
  - 配置は `docs/ja/projects/<project-id>/030-project-management/pm-plan.md` を推奨します。
44
37
  - ID は `<project-id>:pm-plan`、ファイル名は `pm-plan.md` とします。
45
- - Role code、member、Schedule owner の識別規則は組織・ロールの正本に従います。
38
+ - 共通の命名規則は [[specdojo:docs-structure-guide|ドキュメント構成ガイド]] に従います。
46
39
 
47
40
  ## 4. 推奨 Frontmatter 項目
48
41
 
49
- | 項目 | 説明 | 必須 |
50
- | -------- | -------------------------------- | ---- |
51
- | id | `<project-id>:pm-plan` | ○ |
52
- | type | `project` | ○ |
53
- | status | `draft` / `ready` / `deprecated` | ○ |
54
- | rulebook | `specdojo:pm-plan-rulebook` | ○ |
42
+ - 共通項目・型・許容値はメタ情報標準と成果物 schema に従います。`rulebook` は本書の ID、種別は本書の `deliverable_type` に合わせます。
43
+ - `based_on` は必須とし、概要・スコープ・成功基準と、組織定義など直接根拠にした先行成果物の ID を記載します。
44
+ - カタログ利用時は参照先を `depends_on` の推移閉包に含め、不足する依存関係の整備を先行作業にします。根拠宣言の省略や閉包外の ID 追加で代替しません。
55
45
 
56
- | based_on | 概要、スコープ、成功基準、組織定義など直接根拠となる ID | 任意 |
57
- | supersedes | 置き換え対象の旧文書 ID | 任意 |
46
+ ## 5. 本文要件
58
47
 
59
- ## 5. 本文構成(標準テンプレ)
48
+ 見出し順・表・記入欄の骨組みは Frontmatter で宣言した template を正本とします。本書は次の意味要件を定めます。
60
49
 
61
- | 番号 | 見出し | 必須 | 内容 |
62
- | ---- | ---------------------------- | ---- | ------------------------------------------------------ |
63
- | 1 | 管理目的と適用方針 | ○ | 価値、対象期間、軽量・拡張プロファイル、人と AI の境界 |
64
- | 2 | 統合管理方針 | ○ | 管理対象、基準・上限、確認契機、逸脱時対応、責任 |
65
- | 3 | 判断ゲートとエスカレーション | ○ | 判断条件、材料、起案者、最終判断者、証跡 |
66
- | 4 | 正本・報告・見直し | ○ | 情報別の正本、報告契機、見直しトリガー |
67
- | 5 | 未決事項 | 任意 | 未決論点、決定時期、判断者 |
50
+ | 要件 | 必須条件 | 記載する判断・根拠 |
51
+ | ------------------ | ------------------------ | ---------------------------------------------------------------------------------------------------------------------------- |
52
+ | 管理範囲の選定 | 必須 | 期待価値、対象期間、適用プロファイルと拡張条件 |
53
+ | 管理対象単位の追跡 | 必須 | 価値・リスクまたは条件 ID と、基準・上限、確認契機、逸脱時対応、責任、証跡の正本を対応付ける |
54
+ | 判断の成立条件 | 必須 | 継続・公開・変更・停止などの条件、判断材料、起案者、最終判断者、証跡。未達・材料不足時の扱いを含む |
55
+ | 更新・報告の接続 | 必須 | 情報ごとの正本、報告契機、確認者、見直しトリガーと追従先。個別計画や台帳へ委譲する責務を識別する |
56
+ | 未決の扱い | 未決事項がある場合に必須 | 論点・現状、当面の扱い、決定によって変わる管理行・ゲート。別の正本にある論点は参照し、未決事項がなければ「なし」と明記できる |
68
57
 
69
58
  ## 6. 記述ガイド
70
59
 
71
60
  ### 6.1. 管理目的と適用方針
72
61
 
73
- - 概要・スコープ・成功基準から、管理対象となる価値と期間を要約します。
74
- - 軽量プロファイルか拡張プロファイルかを明記し、拡張する条件を示します。
75
- - 人間と AI Agent の判断・実行境界を 1〜3 文で示します。
62
+ - 判断基準は、管理範囲と期間を価値・スコープ・成功基準へ結び付け、管理の厚さを選んだ理由を説明できることです。
63
+ - 良い例: 「初期公開から2週間で SC-01 の価値を検証する。軽量運用とし、外部契約が生じた場合は個別計画を追加する」。
64
+ - 悪い例: 「一般的な PM 項目をすべて管理する」。価値、期間、範囲の選定理由が不明です。
76
65
 
77
66
  ### 6.2. 統合管理方針
78
67
 
79
- 管理領域ごとに別章を作らず、次の一表へ統合します。品質やコミュニケーションの詳細は個別計画へ委譲します。
80
-
81
- | 管理対象 | 基準・上限 | 確認契機 | 逸脱時対応 | 責任 |
82
- | -------- | ---------- | -------- | ---------- | ---- |
68
+ - 判断基準は、各行から根拠・判定条件・逸脱対応・責任・証跡を一続きで追跡できることです。標準列は次のとおりとし、行の結合 ID から一意に辿れる場合は列を統合できます。文書全体への参照だけで済ませません。
83
69
 
84
- - スコープ、Schedule、費用・負荷、品質、課題・リスク・変更のうち、実際に管理する対象だけを行にします。
70
+ | 列 | 内容 |
71
+ | ---------- | --------------------------------------------- |
72
+ | 管理対象 | 追跡単位 |
73
+ | 根拠 | 価値・リスクの文書 ID と該当箇所または条件 ID |
74
+ | 基準・上限 | 適合・逸脱の判定条件 |
75
+ | 確認契機 | 観測時点 |
76
+ | 逸脱時対応 | 次の行動 |
77
+ | 責任 | 担当 Role code |
78
+ | 証跡・正本 | 記録先と記録の識別方法 |
85
79
 
86
- - 費用を扱う場合は、現金支出、作業時間、継続運用負荷を分けます。
87
- - 課題・リスク・変更・決定は登録簿へ記録し、本文に個票を持ちません。
80
+ - スコープ、Schedule、費用・負荷、品質、課題・リスク・変更から適用対象を選びます。現金支出、準備・開発の作業時間、日常操作・保守の継続運用負荷は別の行または基準・記録で管理し、負荷転嫁を削減とみなしません。
81
+ - 構成管理は対象版・承認済み基準・変更履歴の識別方法、確認者、記録先を示します。技術管理は技術制約・外部依存の変更検知契機、影響確認・判断を担う Role code、記録先を示します。個別方針へ委譲しても行から確認・対応を追跡できるようにします。
82
+ - 良い例: 「継続運用負荷」の根拠を成功基準文書の SC-03、基準を同条件の上限内、確認契機を試行中の営業日、超過時対応を `PM` による手順縮小案の起案、証跡を SC-03・確認日・確認者で識別する操作時間記録とします。数値・測定手順の正本は成功基準に残します。
83
+ - 悪い例: 「参加者の時間を無理のない範囲にし、必要に応じて確認する」。準備時間と日常負荷が混ざり、根拠、判定条件、証跡を照合できません。
88
84
 
89
85
  ### 6.3. 判断ゲートとエスカレーション
90
86
 
91
- | ゲート | 判断条件 | 判断材料 | 起案・整理 | 最終判断 | 証跡 |
92
- | ------ | -------- | -------- | ---------- | -------- | ---- |
93
-
94
- - 公開、主要変更、例外、継続・停止など、人間の判断が必要なゲートだけを記載します。
95
-
96
- - 成功基準を再掲せず、参照する条件 ID と不足時の扱いを示します。
97
- - 「必要に応じて」ではなく、エスカレーションする条件を判定可能にします。
87
+ - 判断基準は、条件 ID、材料、最終判断者、判定記録が結び付き、未達と材料不足を合格扱いにしないことです。
88
+ - 成功基準・受入条件を複製せず、文書 ID と条件 ID を参照します。是正・再判定、保留・停止、例外判断を求める条件を定め、例外は上位の受入方針で認める範囲に限ります。
89
+ - 良い例: 「初期受入は成功基準の SC-01 と AC-01〜AC-04 を必須とし、未達・証跡不足なら保留する。是正後に `QE` が再確認結果を整理し、判断ゲートの最終判断者が条件 ID ごとの結果と判定を記録する」。
90
+ - 悪い例: 「初期成功基準を満たしたら公開し、問題があれば必要に応じて相談する」。参照条件、不足時の処理、判断者を特定できません。
98
91
 
99
92
  ### 6.4. 正本・報告・見直し
100
93
 
101
- | 情報 | 正本 | 更新・報告契機 | 主な確認者 |
102
- | ---- | ---- | -------------- | ---------- |
103
-
104
- - Schedule、RACI、費用・作業記録、品質証跡、登録簿などの正本を示します。
105
- - 定期報告を必須にせず、判断・逸脱・作業節目など必要な契機を定めます。
106
- - 目的、スコープ、成功基準、体制、外部条件が変わった場合の見直し先を示します。
94
+ - 判断基準は、情報ごとの更新先と確認者が一意に分かり、見直し時の追従作業をタスク化できることです。正本が未整備なら、整備時期・担当または省略理由と責任を確認する代替先を示します。
95
+ - Schedule と責任の正本を接続し、作業担当だけで判断責任を代替しません。RACI の採用・省略条件は [[specdojo:people-and-organization-definition-standard|人と組織の定義標準]] に従います。
96
+ - 判断・逸脱・作業節目の報告契機と確認者を定め、品質・コミュニケーションの詳細は各計画を参照します。
97
+ - 目的、スコープ、成功基準、体制、外部条件の変更時は、影響する個別計画・RACI・Schedule・証跡と担当 Role code を特定し、更新順序・期限・確認担当を追従タスクにします。
98
+ - 良い例: 「承認担当の交代時は、`PM` が RACI・メンバー定義・Schedule の影響箇所を特定し、更新担当と期限を設定する。`QE` が判断ゲートの最終判断者との整合を確認する」。
99
+ - 悪い例: 「担当は Schedule を参照し、変更時は関係文書を見直す」。成果物責任の正本、更新先、確認担当が不明です。
107
100
 
108
101
  ### 6.5. 未決事項
109
102
 
110
- - 未決事項は _UNDECIDED_: とし、決定時期と判断者を添えます。
111
- - 期限を過ぎた未決事項は、課題または判断事項として登録簿へ移します。
112
- - 継続的に追跡する事項を本文へ残さず、正本となる管理記録へ委譲します。
103
+ - 判断基準は、未決の論点と影響を示し、未決の上限や担当を確定済みとして着手・判定しないことです。他文書に正本があれば該当論点を参照します。
104
+ - 良い例: 「`_UNDECIDED_:` 試行準備の作業時間上限。未決中は着手を保留し、決定後に費用・負荷の管理行と準備着手ゲートへ反映する」。
105
+ - 悪い例: 「費用・時間上限は後で決める」。当面の扱いと変更先が不明です。
113
106
 
114
107
  ## 7. 禁止事項
115
108
 
116
- | 禁止事項 | 理由 |
117
- | ------------------------------------------------------ | -------------------------------- |
118
- | 個別計画、RACI、Role code 一覧、登録簿の内容を再掲する | 正本が分散し、更新量が増えるため |
119
- | 管理対象を網羅目的で増やし、基準や逸脱時対応を置かない | 実行時の判断に使えないため |
120
- | 現金支出だけを費用とし、人の作業・運用負荷を除外する | 負荷転嫁を見逃すため |
121
- | 成功基準を本文へ複製する | 判定条件の正本が分散するため |
122
- | Agent に例外、公開、GO / Not GO の最終判断を委ねる | 人間の説明責任を代替するため |
123
- | 個人情報、認証情報、秘密情報、実装詳細を記載する | 公開適性と文書責務に反するため |
109
+ | 禁止事項 | 理由 |
110
+ | ------------------------------------------------------ | ---------------------------- |
111
+ | 管理対象を網羅目的で増やし、基準や逸脱時対応を置かない | 実行時の判断に使えないため |
112
+ | 現金支出だけを費用とし、人の作業・運用負荷を除外する | 負荷転嫁を見逃すため |
113
+ | 成功基準を本文へ複製する | 判定条件の正本が分散するため |