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
@@ -11,86 +11,80 @@ specdojo:
11
11
 
12
12
  RACI Writing Recipe
13
13
 
14
- 責任衝突が起きやすい主要成果物と主要判断だけを、二つのマトリクスへ整理する作り方です。
14
+ 責任衝突が起きやすい成果物と判断だけを選び、Schedule の担当まで整理する作り方を示す。
15
15
 
16
16
  ## 1. このレシピの使い方
17
17
 
18
- - 初期スコープから主要成果物と主要判断を選びます。
19
- - 成果物別と判断・プロセス別のRACIを作ります。
20
- - Schedule owner、member割り当てとの整合を確認します。
21
- - 責任衝突や判断停滞の回避(Why)、対象となる主要成果物・判断(What)、RACI と owner 方針(How)を扱い、行名・Role code・Schedule owner の対応で追跡します(Trace)。member 割り当ては再掲しません。
18
+ - 責任衝突や判断停滞を防ぐ理由(Why)から対象の成果物・判断(What)を選び、責任配置と担当(How)を決め、行名・Role code・Schedule の `owner` でたどれるようにする(Trace)。
22
19
 
23
20
  ## 2. 作成前に集める情報
24
21
 
25
- | 項目 | 集める情報 |
26
- | --------- | -------------------------------------- |
27
- | Role code | 採用済みの責任語彙 |
28
- | 成果物 | 初期スコープ、管理計画、公開対象 |
29
- | 判断 | 価値、費用・負荷、変更、品質例外、公開 |
30
- | 実行 | Schedule owner、主たる作業責任 |
31
- | 割り当て | member、兼務、Agent支援の正本 |
22
+ | 項目 | 集める情報と取り出し元 |
23
+ | --------- | ----------------------------------------------------- |
24
+ | 採用 Role | 列に使う Role code(組織定義) |
25
+ | 対象 | 主要成果物・公開対象(初期スコープ) |
26
+ | 判断 | 価値・費用・変更・品質例外・公開の判断者(PM に聞く) |
27
+ | 実行 | 明示 `owner`、タスク種別(WBS・Schedule) |
32
28
 
33
29
  ## 3. 全体の作成手順
34
30
 
35
- 1. 責任衝突の可能性がある成果物・判断だけを選びます。
36
- 2. 使用するRole code列を必要最小限に絞ります。
37
- 3. 各行へ一つの`A`と一つ以上の`R`を置きます。
38
- 4. 相談が必要なRoleに`C`、結果共有だけのRoleに`I`を置きます。
39
- 5. Schedule ownerと主たる`R`を一致させます。
40
- 6. 生成ビューや通常手順の重複行を削除します。
31
+ 1. 対象の成果物と判断を先に選ぶ。カタログから始めると責任が埋もれる。
32
+ 2. 列の Role を必要な分だけ残す。
33
+ 3. 成果物別、判断・プロセス別の順に表を作る。承認者が先に決まると、プロセス行の判断を分けやすい。
34
+ 4. Schedule と照合する。不一致で表を直すため表の後に行う。
35
+ 5. 見直し条件を書く。
41
36
 
42
37
  ## 4. 各章の書き方
43
38
 
44
39
  ### 4.1. 適用方針
45
40
 
46
- - 対象・省略範囲とRACI記号を簡潔に書きます。
47
- - 兼務とAgent支援の扱いを示します。
48
- - 未使用Role code列を置かない理由を示します。
41
+ - 問い: どの成果物・判断で責任がぶつかり得るか。外す範囲の理由は何か。
42
+ - コツ: PM に「誰の判断を待って作業が止まったか」を聞く。採用 Role の一覧は写さず参照に置き換える。
49
43
 
50
44
  ### 4.2. 成果物別RACI
51
45
 
52
- - 主要成果物と管理文書へ絞ります。
53
- - 同じ正本から生成するビューはまとめます。
54
- - 成果物の作業責任と内容の最終責任を区別します。
46
+ - 問い: 誰が作成し、どの Role の人間が内容を承認するか。
47
+ - コツ: 作業担当が複数なら、分担をその場で聞いて注記する。後から Schedule を見て選ぶと根拠が残らない。
55
48
 
56
49
  ### 4.3. 判断・プロセス別RACI
57
50
 
58
- - 最終判断者が異なる判断を行にします。
59
- - 通常作業を網羅せず、価値・変更・品質・公開を優先します。
60
- - 当事者確認が必要な場合は内部Roleだけで代替しません。
51
+ - 問い: 判断者が異なる判断はどれか。成果物行の承認と重なるとき、それぞれ何を判断するか。
52
+ - コツ: 「作成フローの運営」は内容の承認も含むと読まれやすいため、順序・進捗の判断と分ける。
61
53
 
62
54
  ### 4.4. Schedule・実行主体との対応
63
55
 
64
- - ownerと主たる`R`を一致させます。
65
- - 個人やAgentはRACI列ではなくmember正本へ置きます。
66
- - 不一致時の更新先を決めます。
56
+ - 問い: WBS に明示の `owner` はあるか。なければ、どの `R` から担当を展開するか。
57
+ - コツ: 担当が一意に決まらなければ、タスクの分割を WBS の担当者に相談する。
58
+
59
+ ### 4.5. 見直し条件
60
+
61
+ - 問い: 何が変わると見直し、どの行と Schedule が追従するか。
62
+ - コツ: 判断が止まった場面を聞くと、契機を具体的に書ける。
67
63
 
68
64
  ## 5. 深掘り手順
69
65
 
70
- 1. 各行の`A`が本当に最終判断者か確認します。
71
- 2. `C`と`I`を必要最小限に減らします。
72
- 3. 同じ責任配置の行をグループ化します。
73
- 4. Scheduleに存在しない管理目的だけの行を削除します。
66
+ 内容が浅いときは、次の順で対応のない主張を探す。
67
+
68
+ 1. 各行が防ぐ責任衝突・判断停滞を確かめ、目的のない行を外す。
69
+ 2. 各行の `A` が実際の最終判断者かを確かめる。
70
+ 3. `C`・`I` がどの判断に効くかを確かめ、効かないものを外す。
71
+ 4. Schedule の各 `owner` がどの行から来たかをたどる。
74
72
 
75
73
  ## 6. 良い例 / 悪い例
76
74
 
77
- | 観点 | 良い例 | 悪い例 |
78
- | ---- | ---------------------------- | ----------------------- |
79
- | 対象 | 主要成果物と公開判断へ絞る | 全カタログ行を転記する |
80
- | 責任 | 一行に`A`を一つ置く | `A`を複数置く |
81
- | 実行 | ownerと主たる`R`を一致させる | 個人名をownerと列に使う |
75
+ | 観点 | 良い例 | 悪い例 |
76
+ | ---------- | --------------------------------------------- | ----------------------------------- |
77
+ | 判断の行名 | 「初期公開の可否」のように判断を名指す | 「プロジェクト運営」とだけ書く |
78
+ | 承認タスク | 別タスクにした承認を、その行の `A` と照合する | 承認タスクも作成者の `R` にそろえる |
79
+ | AI Agent | 支援として注記し、`A` は人間の Role に置く | AI Agent を承認者の列に入れる |
82
80
 
83
81
  ## 7. レビュー観点
84
82
 
85
- - 一行に`A`が一つ、`R`が一つ以上あるか。
86
- - 未採用Roleや個人名を使っていないか。
87
- - Schedule ownerと整合しているか。
88
- - 責任境界が重要でない行を増やしていないか。
83
+ | 観点 | 確認内容 |
84
+ | -------- | ------------------------------------------------------------- |
85
+ | 判断範囲 | 成果物行とプロセス行で、同じ判断を二つの `A` が持っていないか |
89
86
 
90
87
  ## 8. 仕上げチェック
91
88
 
92
- - 成果物別、判断・プロセス別の二表がある。
93
- - 省略範囲と見直し条件が明確である。
94
- - member・Agent割り当てを再掲していない。
95
- - Agentに`A`を割り当てていない。
96
- - 各行の採用理由、`A` / `R`、Schedule owner または判断記録先の対応を追跡できる。
89
+ - 各行の採用理由、`A`・`R`、Schedule の `owner` をたどれる。
90
+ - メンバーの割り当てを写していない。
@@ -11,126 +11,97 @@ specdojo:
11
11
 
12
12
  Project Role Definition Writing Recipe
13
13
 
14
- 本ドキュメントは、ロール定義を「PO が全 Role code とプロジェクト固有メモを承認できる内容」に仕上げるための作り方です。本書では問い、深掘り手順、レビュー観点を扱います。
14
+ ロール定義を、PO が全 Role code とプロジェクト固有メモを承認・保留・差し戻しできる内容に仕上げるための作り方を示す。
15
15
 
16
16
  ## 1. このレシピの使い方
17
17
 
18
- - 最初に、組織定義から採用する責務語彙、最終判断の集約先、公開方針を確認する。
19
- - 次に、`pm-roles.yaml` に列挙する Role code を、Schedule の `owner` や RACI の列として使える粒度で整理する。
20
- - 最後に、member nickname、agent 名、個人名、兼務割り当てを混ぜず、プロジェクト固有メモだけを残す。
21
- - schema にないメタ項目を追加しない。rulebook 参照は成果物カタログまたは計画側で解決する。
22
- - 組織上必要な責任領域(Why)、採用する Role code(What)、プロジェクト固有の責務強調(How)を扱い、`based_on` と下流の Role code 参照で追跡する(Trace)。割り当てや一般責務は各正本へ委譲する。
18
+ - ロール定義は、組織定義の採用判断(Why)を引き継ぎ、採用する Role code の集合(What)を転記し、プロジェクト固有の扱い(How)だけを `project_note` に添える。採用根拠は `based_on`、下流の利用は Schedule・RACI・メンバー定義の Role code 参照でたどる(Trace)。
19
+ - 「作成前に集める情報」をメモでそろえてから、「全体の作成手順」の順に書く。
23
20
 
24
21
  ## 2. 作成前に集める情報
25
22
 
26
- | 項目 | 集める情報 |
27
- | -------------------- | ------------------------------------------------------------ |
28
- | 組織定義 | 採用する責務語彙、最終判断の集約先、見直し条件 |
29
- | プロジェクト ID | `project_id` と `id` に使う値 |
30
- | 採用 Role code | Schedule の `owner` と RACI の列に使う Role code |
31
- | Role name | 各 Role code の正式名称 |
32
- | プロジェクト固有メモ | 当該プロジェクトで強調する責務、専任化条件、公開判断上の注意 |
33
- | 下流文書 | `pm-members.yaml`、Schedule、RACI が参照する Role code |
34
- | schema | `pm-roles.yaml` に許可されるメタ項目、Role code、型制約 |
35
- | 公開制約 | 個人情報、連絡先、非公開組織情報を含めない条件 |
23
+ | 項目 | 集める情報 | 取り出し元 |
24
+ | ---------------------- | ------------------------------------------------------ | ---------------------------- |
25
+ | 採用集合 | 採用・未採用の Role code、使用可能な `owner`、採用理由 | 組織定義 |
26
+ | 正式名称 | 各 Role code の正式名称 | 人と組織の定義標準 |
27
+ | 下流の参照値 | 実際に使われている Role code と、その使い手 | Schedule、RACI、メンバー定義 |
28
+ | プロジェクト固有の扱い | 強調する責務、専任化を検討する条件、公開判断上の注意 | PO・PM への確認 |
29
+ | 識別情報 | `project_id`、名称、版 | 配置先プロジェクト |
36
30
 
37
31
  ## 3. 全体の作成手順
38
32
 
39
- 1. `id`、`type`、`status`、`version`、`project_id` を設定する。
40
- 2. `based_on` に、ロール採用の根拠となる組織定義などの ID を記載する。
41
- 3. `roles` に、プロジェクトで使用する Role code を標準順で列挙する。
42
- 4. 各 Role に `code` と `name` を記載し、必要な場合だけ `project_note` を 1 行で添える。
43
- 5. `project_note` から member nickname、agent 名、個人名、具体的な兼務割り当てを除く。
44
- 6. schema にないキー、重複 Role code、標準外 Role code がないことを確認する。
45
- 7. PO が承認できるよう、全 Role code の過不足、公開可否、下流文書への入力適合を確認する。
33
+ 1. 組織定義を読み、採用集合を確かめてから `based_on` へ接続する。採用集合が決まらないと、`roles` の範囲が決まらない。
34
+ 2. 下流の参照値を洗い出し、採用集合との差分を先に見つける。転記の後で見つけると、どちらを直すかの判断が遅れる。
35
+ 3. 採用集合を `roles` へ転記し、`code` と正式名称を対応付ける。
36
+ 4. PO の判断に要る固有の扱いだけを `project_note` に添える。
37
+ 5. 最後にメタ項目を整える。採用根拠が決まってからだと、`based_on` を未確認の文書で埋めずに済む。
46
38
 
47
- ## 4. 各要素の書き方
39
+ ## 4. 各章の書き方
48
40
 
49
- ### 4.1. メタ項目
41
+ ### 4.1. メタ項目と根拠
50
42
 
51
43
  問い:
52
44
 
53
- - `id` は `<project-id>:pm-roles` 形式になっているか。
54
- - `project_id` は配置先プロジェクトと一致しているか。
55
- - `based_on` はロール採用の根拠を指しているか。
45
+ - `based_on` の各 ID は、採用集合を実際に確かめた文書か。
46
+ - 準拠先を、成果物自身から識別できるか。
56
47
 
57
- 書き方:
48
+ コツ:
58
49
 
59
- - `type` は `project`、`version` は整数で記載する。
60
- - `status` は現時点の成果物状態を示す。
61
- - 根拠 ID は、内容を実際に確認した文書だけを記載する。
62
- - `rulebook` など schema が許可しないキーを追加しない。
50
+ - 同じディレクトリの文書をまとめて `based_on` に入れたくなったら、採用判断に使った文書だけに絞る。
51
+ - 採用理由の本文は組織定義から写さず、ID での参照に置き換える。
63
52
 
64
53
  ### 4.2. `roles`
65
54
 
66
55
  問い:
67
56
 
68
- - Schedule の `owner` として必要な Role code が過不足なく入っているか。
69
- - 重複した Role code や表記ゆれはないか。
70
- - 専任 member がいない Role code でも、責務語彙として必要なら残せているか。
57
+ - 専任 member がいない Role code を、未採用と取り違えて落としていないか。
58
+ - 下流で使われているのに採用集合にない Role code はないか。
71
59
 
72
- 書き方:
60
+ コツ:
73
61
 
74
- - 標準順に `PO`, `PM`, `BA`, `ARC`, `DEV`, `QE`, `UX`, `OPS` を並べる。
75
- - 独自 Role code は追加しない。
76
- - `roles` は責務語彙の一覧であり、実行主体の一覧ではないことを意識する。
77
- - 下流の `pm-members.yaml` や Schedule が参照する Role code を後から推測しなくてよいよう、採用する責務語彙を明示する。
62
+ - 「今いる人」から Role を数えると、兼務中のロールが抜けやすい。PO・PM に「誰もいなくても語彙として要るロールはどれか」と聞く。
63
+ - Role code を変えたり除いたりするときは、使っている下流の文書と使い手を先に聞き、責務の移り先を決めてから変える。
78
64
 
79
65
  ### 4.3. `roles[].project_note`
80
66
 
81
67
  問い:
82
68
 
83
- - PO が承認判断するために必要なプロジェクト固有の扱いが分かるか。
84
- - 専任化を検討する条件や公開判断上の注意が必要か。
85
- - member nickname、agent 名、個人名、兼務割り当てを書いていないか。
86
- - 未決事項がある場合、_UNDECIDED_: または _TODO_: で明示しているか。
69
+ - PO が承認・保留を決めるのに、このメモがないと何が判断できないか。
70
+ - このプロジェクトに固有の扱いか、どのプロジェクトにも当てはまる一般責務か。
87
71
 
88
- 書き方:
72
+ コツ:
89
73
 
90
- - 1 Role につき 1 行を目安にする。
91
- - 一般的な責務の長い再掲ではなく、当該プロジェクトでの使い方を書く。
92
- - 割り当てが必要な場合は `pm-members.yaml` に委譲する。
93
- - 未決事項は推測で確定させず、_UNDECIDED_:(判断未了)または _TODO_:(後で確認・追記が必要)から書き始め、判断時点や判断者が分かる形で残す。
74
+ - 担当者の名前や agent 名を書きたくなったら、メンバー定義へ移す。メモに書くと、割り当ての変更のたびに一覧を直すことになる。
75
+ - 「必要に応じて」と書きそうになったら、PO に「何が起きたら専任化を考えるか」を聞き、その条件を書く。
76
+ - 決めきれない点は推測で埋めず、判断する人と時期を PO に確かめる。
94
77
 
95
78
  ## 5. 深掘り手順
96
79
 
97
- 1. 組織定義の「採用ロールと owner 語彙」から、Role code の採用方針を抜き出す。
98
- 2. Schedule、RACI、member 定義で参照される可能性がある責務語彙を洗い出す。
99
- 3. 標準 Role code で代替できない独自コードが出ていないか確認する。
100
- 4. 各 Role の `project_note` を、責務強調、専任化条件、公開判断上の注意に分類する。
101
- 5. 実行主体や兼務割り当てに該当する記述を `pm-members.yaml` 側へ移す。
102
- 6. PO の最終判断、公開可否、説明責任が agent や member nickname に移っていないことを確認する。
80
+ 内容が浅いときは、次の順で対応のない主張を探す。
81
+
82
+ 1. `roles` の各 Role code が、組織定義の採用判断のどれに対応するかを確かめ、対応のないコードを外す。
83
+ 2. 下流の各参照値が `roles` にあるかを確かめ、未定義のコードを見つける。
84
+ 3. 各 `project_note` が、PO のどの判断に使われるかを確かめ、判断に使われないメモを削る。
103
85
 
104
86
  ## 6. 良い例 / 悪い例
105
87
 
106
- | 観点 | 良い例 | 悪い例 |
107
- | -------------------- | ------------------------------------------------- | -------------------------------------- |
108
- | Role code | `code: PM` | `code: project-manager-agent` |
109
- | 実行主体との分離 | 実行主体の割り当ては `pm-members.yaml` で管理する | `PM は pm-agent が担当する` |
110
- | プロジェクト固有メモ | 小規模運用では専任化せず、滞留時に見直す | 必要に応じて対応する |
111
- | 公開可否 | 公開判断は PO に残す | agent が公開可否を判断する |
112
- | 下流入力 | `roles[].code` を Schedule の `owner` に使う | `owner` に member nickname を使う |
113
- | schema 適合 | メタ項目は schema が許可するキーだけにする | `rulebook: specdojo:pm-roles-rulebook` |
88
+ | 観点 | 良い例 | 悪い例 |
89
+ | ---------- | ------------------------------------------------------------- | ---------------------------------- |
90
+ | 公開判断 | 公開可否の最終判断は PO に残す | agent が公開可否を判断する |
91
+ | 下流の参照 | `roles[].code` を Schedule の `owner` に使う | `owner` に member nickname を使う |
92
+ | 準拠先 | 成果物自身に `rulebook` を残す | カタログにあるので成果物から省く |
93
+ | 専任化 | 「実装タスクが継続して増えたら DEV の専任化を検討する」と書く | 「必要に応じて体制を見直す」と書く |
114
94
 
115
95
  ## 7. レビュー観点
116
96
 
117
- | 観点 | 確認内容 |
118
- | ---------------------- | --------------------------------------------------------------------------------- |
119
- | 目的・スコープとの整合 | 組織定義で採用した責務語彙と矛盾していないか |
120
- | 承認判断 | PO が全 Role code と `project_note` を承認、保留、差し戻しできるか |
121
- | 未決事項の明示 | `project_note` の未決事項が _UNDECIDED_: / _TODO_: で識別でき、放置されていないか |
122
- | owner 語彙 | Schedule の `owner` に使う値が `roles[].code` として定義されているか |
123
- | スキーマ適合 | 必須メタ項目、`roles` 配列、Role code の列挙が YAML スキーマに沿っているか |
124
- | 公開可否 | 個人情報、連絡先、非公開情報、agent への最終判断委任が含まれていないか |
125
- | 下流入力 | `pm-members.yaml`、Schedule、RACI が参照できる安定した Role code になっているか |
97
+ | 観点 | 確認内容 |
98
+ | ---------- | ------------------------------------------------------------------------- |
99
+ | 採用の対応 | 各 Role code が組織定義の採用判断に対応し、未採用のコードが紛れていないか |
100
+ | 下流の接続 | Schedule、RACI、メンバー定義が使う値がすべて `roles[].code` にあるか |
101
+ | 委譲の境界 | 一般責務・採用理由・実行主体の割り当てを、各正本へ委ねているか |
126
102
 
127
103
  ## 8. 仕上げチェック
128
104
 
129
- - 「全体の作成手順」で示した構成と必須項目がそろっている。
130
- - `roles[].code` に必要な Role code が過不足・重複なく入っている。
131
- - `roles[].project_note` はプロジェクト固有メモに限定され、具体的な member 割り当てを含まない。
132
- - `roles[].project_note` の未決事項は _UNDECIDED_: または _TODO_: で明示され、放置されていない。
133
- - `pm-organization.md` の採用方針と矛盾していない。
134
- - `pm-members.yaml` の `members[].roles` から参照できる Role code 語彙になっている。
135
- - 公開してよい情報だけで構成され、最終判断と説明責任が人間の PO に残っている。
136
- - 各 Role code の採用根拠と下流利用を、`based_on` と既存の参照値から追跡できる。
105
+ - 各 Role code の採用根拠を `based_on` から、下流での利用を参照値からたどれる。
106
+ - `project_note` に担当者・agent 名・兼務の割り当てがない。
107
+ - 公開してよい情報だけで構成され、最終判断が PO に残っている。
@@ -11,36 +11,31 @@ specdojo:
11
11
 
12
12
  Assumptions, Constraints and Dependencies Writing Recipe
13
13
 
14
- 本書は、変化があったときに判断・対応できる前提・制約・依存関係を作るための手順である。本書では問い、具体化手順、レビュー観点を扱う。
14
+ 前提・制約・依存関係を、条件が変わったときに所有者が影響を確かめ、判断者へつなげられる内容に仕上げるための作り方を示す。
15
15
 
16
16
  ## 1. このレシピの使い方
17
17
 
18
- - 最初に、スコープから「成立しないと何が困るか」「守らなければならない境界」「他者または先行成果物に求める条件」を抜き出す。
19
- - 次に、候補からスコープなど上位文書で確定済みの決定事項を除き、残った条件だけを前提、制約、依存関係のいずれか一つに分類し、影響と変化時の対応を対にして書く。除いた境界は該当章の冒頭で参照先を明示して委譲する。
20
- - 最後に、未確定事項を断定せず、確認先または決定時期を _TODO_: / _UNDECIDED_: / _ASSUMPTION_: で明示する。
21
- - 守る成果や境界(Why)、前提・制約・依存(What)、確認・監視・変化時対応(How)を整理し、項目 ID、`based_on`、根拠、影響、対応の同じ行で追跡する(Trace)。上位文書で確定済みの境界や詳細設計は再掲しない。
18
+ - 本書は、スコープ・憲章が定めた守る成果と境界(Why)を引き継ぎ、それを実行するために置く条件・守る限界・受ける提供(What)を定め、確認・変化時の対応と判断者(How)を決める。各条件は項目 ID の同じ行で根拠から対応までたどれるようにする(Trace)。
19
+ - 「作成前に集める情報」をメモでそろえてから、「全体の作成手順」の順に書く。
20
+ - 書き終えたら「レビュー観点」で読み直し、「仕上げチェック」で確かめる。
22
21
 
23
22
  ## 2. 作成前に集める情報
24
23
 
25
- | 項目 | 集める情報 |
26
- | ---------------- | ------------------------------------------------------------------ |
27
- | スコープと対象外 | 対象範囲、意図的に含めないもの、境界判断の原則 |
28
- | 成立条件 | 人、情報、環境、先行成果物、意思決定など、欠けると進行できないもの |
29
- | 守るべき限界 | 公開範囲、責務境界、互換性、費用、期日、技術選択に関する制限 |
30
- | 依存先 | 外部組織、サービス、先行成果物、承認、提供物、判断イベント |
31
- | 影響 | 変化した場合に影響するスコープ、期日、品質、運用、公開適性 |
32
- | 確認と判断 | 状態を確認する方法、変化のトリガー、所有者、最終判断者 |
24
+ | 項目 | 集める情報 | 取り出し元 |
25
+ | ---------------- | ---------------------------------------------------------- | ------------------------------ |
26
+ | 境界 | 対象外、境界の判断基準、すでに監視・記録先を持つ判断 | スコープ、憲章 |
27
+ | 結論だけの制約 | 予算枠・公開情報など、結論はあるが監視の仕組みがない条件 | 憲章の主要前提・制約 |
28
+ | 成立条件 | 欠けると進めない人・情報・環境・先行成果物 | 計画担当・実行担当への聞き取り |
29
+ | 受ける提供・判断 | 依存先、受け取る物、受け取れたと分かる記録、決定待ちの論点 | 依存先の担当、登録簿の決定記録 |
30
+ | 変化の知らせ | 変化を最初に知る人と、その記録 | 所有者候補への聞き取り |
33
31
 
34
32
  ## 3. 全体の作成手順
35
33
 
36
- 1. 直接参照したスコープ・上位成果物を `based_on` に限定して記載する。
37
- 2. 候補のうち、スコープで確定済みの境界・対象外は登録せず、該当章の冒頭で参照先を明示して委譲する。
38
- 3. 成立条件を前提条件として書き、根拠、影響、確認方法、変化時の対応を補う。
39
- 4. 守るべき限界を制約事項として書き、適用範囲と逸脱条件を明確にする。
40
- 5. 他者・外部・先行成果物から受ける条件を依存関係として書き、成立条件を定める。意思決定待ちの依存は、プロジェクト登録簿へ登録して本書から項目 ID を参照する。
41
- 6. 変化の種別ごとに、最初に確認することと対応方針をまとめる。
42
- 7. 監視・変更管理に、見直す契機と変更記録に残す情報を置く。
43
- 8. 表の各行について、前提・制約・依存の分類、根拠、所有者、対応が欠けていないか確認する。
34
+ 1. 候補を挙げ、スコープ・憲章ですでに決まっている境界を先に外す。外さずに分類を始めると、上位文書の言い直しが行に残る。
35
+ 2. 残った候補を、自分たちが成り立つと置く仮説(前提条件)、守る限界(制約事項)、他者から受ける提供・判断(依存関係)に分ける。迷う候補は「誰が提供を止められるか」で分ける。
36
+ 3. 前提条件・制約事項・依存関係を、それぞれ根拠・影響・確認方法・対応と対にして書く。
37
+ 4. 変化の種別ごとに、最初に確かめることと次の判断者を影響評価と対応方針へまとめる。
38
+ 5. 最後に監視・変更管理と冒頭文を書く。登録した条件が決まってからだと、見直しの契機を条件から逆算できる。
44
39
 
45
40
  ## 4. 各章の書き方
46
41
 
@@ -48,115 +43,93 @@ Assumptions, Constraints and Dependencies Writing Recipe
48
43
 
49
44
  問い:
50
45
 
51
- - 何が真または利用可能であることを前提にしているか。
52
- - その前提が崩れると、誰の作業またはどの成果物に影響するか。
53
- - どの記録・確認で変化を検知できるか。
46
+ - 何が成り立たないと計画が止まり、それはどの記録で確かめられるか。
47
+ - 崩れたとき、誰のどの作業が止まるか。
54
48
 
55
- 書き方:
49
+ コツ:
56
50
 
57
- - 「〜できる」「〜である」という成立条件を一文にし、根拠と影響を分離する。
58
- - 単なる希望や目標は前提にしない。確認できない場合は仮置きであることを明示する。
59
- - スコープで定義済みの境界は前提として再掲せず、章冒頭でスコープの該当章へ委譲する。
60
- - リポジトリ、作業環境、外部ツールなど、継続的な提供が必要な基盤は前提ではなく依存関係(4.3.)として書く。
61
- - 例: 「店頭で使う端末を利用できる」を前提として、利用不可時の代替記録を対応に置く。
51
+ - 「誰が止められるか」と聞き、相手が自分たち以外なら依存関係へ移す。端末・リポジトリ・作業環境は前提に入れやすいので注意する。
52
+ - 確かめられない仮説は断定せず、仮置きと確認先を残す。
62
53
 
63
54
  ### 4.2. 制約事項
64
55
 
65
56
  問い:
66
57
 
67
- - 必ず守るべき限界は何か。
68
- - どの成果物・利用場面・期間に適用するか。
69
- - 何が起きたら逸脱として扱うか。
58
+ - どの行為が起きたら、限界を越えたと判定するか。
59
+ - その限界は、どの作業・期間に掛かるか。
70
60
 
71
- 書き方:
61
+ コツ:
72
62
 
73
- - 「〜しない」「〜に限定する」のように、禁止または限界を判定可能に書く。
74
- - 技術制約は製品名だけで固定せず、再利用性、公開適性、運用責任などの意図を添える。
75
- - スコープの対象外・境界の判断基準と同内容の制約は再掲せず、上位文書に現れない運用上の制約だけを書く。
76
- - 詳細な設計方法や受入条件は、対応する後続成果物に委譲する。
63
+ - 憲章が結論だけを示す制約は、展開元の章を書き、監視と逸脱時の対応を足す。憲章がすでに監視・記録先を持つ判断は、写さず参照に置き換える。
64
+ - 製品名で書きたくなったら、守りたい意図(費用・外部依存・公開適性)を聞き直す。
77
65
 
78
66
  ### 4.3. 依存関係
79
67
 
80
68
  問い:
81
69
 
82
- - 誰または何から、どの情報・提供物・判断を受ける必要があるか。
83
- - 受け取れたと判断する条件と、変化を知る契機は何か。
84
- - 依存先が変わった場合に、どの文書または判断を見直すか。
70
+ - 誰から何を受け取れたら成立とし、誰がいつどの記録で確かめるか。
71
+ - 決定のうち、どこまで決まり、どこが未決か。
85
72
 
86
- 書き方:
73
+ コツ:
87
74
 
88
- - 依存先を「外部サービス」だけに限定せず、先行成果物や承認も記載する。
89
- - 依存先名だけで終わらせず、必要な理由と成立条件を添える。
90
- - 意思決定待ちの依存はプロジェクト登録簿へ登録し、本書からは登録項目 ID を参照する。
91
- - 期限や責任者が未確定なら、推測で埋めず決定先を残す。
75
+ - 依存先の担当に「受け取ったと言える記録は何か」を聞く。名前だけの依存は成立を判定できない。
76
+ - 本書の根拠として読んだだけの文書を依存先に入れやすいので注意する。
92
77
 
93
78
  ### 4.4. 影響評価と対応方針
94
79
 
95
80
  問い:
96
81
 
97
- - 前提・制約・依存が変化した場合、どれ(スコープ、期日、品質、公開適性、運用責任)に影響するか。
98
- - 最初に確認すべき範囲とその根拠は何か。
99
- - 一次対応を担うロールと、最終判断者は誰か。
82
+ - 変化したとき、最初に確かめる範囲はどこか。
83
+ - 一次対応を担う所有者と、最終判断者はそれぞれ誰か。
100
84
 
101
- 書き方:
85
+ コツ:
102
86
 
103
- - 影響は「困る」「遅れる」ではなく、スコープ、期日、費用、品質、公開適性など該当する領域名で記載する。
104
- - 対応方針には「除去、軽減、受容、再判断」のいずれを行うかを示し、次に判断する人を記載する。
105
- - 最終判断者を未確認のロールで補わない。未確定なら _TODO_: として記録先を示す。
87
+ - 「遅れる」「困る」で止まったら、どの成果物・作業・判断に響くかを聞き直す。
88
+ - 判断者が決まっていなければロールで補わず、決定先を残す。
106
89
 
107
90
  ### 4.5. 監視・変更管理
108
91
 
109
92
  問い:
110
93
 
111
- - 本書をいつ、どのような契機で見直すか。
112
- - 変更時に残すべき情報(項目 ID、変化内容、影響範囲、判断者など)は何か。
113
- - どの役割が構造整合を確認し、どの部分を人間の責任者が最終判断するか。
94
+ - 本書を見直す具体的な出来事は何か。
95
+ - 変化を検知したら、どの記録へ残し、どの計画・作業へ追従させるか。
114
96
 
115
- 書き方:
97
+ コツ:
116
98
 
117
- - 「定期的に確認する」ではなく、「スコープまたは実践の型一式が変わったとき」「新たな機密情報検出時」などの具体的な契機を記載する。
118
- - 変更記録には項目 ID、変化内容、影響範囲、判断者、対応状況を残す。記録先が未定なら _TODO_: とする。
119
- - 文書構造の整合確認は `ARC` 、公開可否やスコープ変更などの最終判断は人間の責任者が行うと明示する。
99
+ - 登録した各行の変化のトリガーを集めると、見直しの契機の漏れが見つかる。
100
+ - 発生済みの支障・将来の不確実性・計画変更・決定を一つの記録に混ぜやすいので、記録先を分けて聞く。
120
101
 
121
102
  ## 5. 深掘り手順
122
103
 
123
- 1. スコープ外を読み、境界を越えたときの制約候補を抽出する。
124
- 2. 対象を成立させるために必要な人、情報、環境、先行成果物を列挙する。
125
- 3. 各候補に「変化したら何が止まるか」を問い、影響がないもの、またはスコープで確定済みのものは登録しない。
126
- 4. 変化を最初に知る方法と、一次対応を担う所有者を決める。
127
- 5. 未確認の事実は、確認先とともに未確定として残す。
104
+ 内容が浅いときは、次の順で対応のない主張を探す。
105
+
106
+ 1. 各行が、スコープ・憲章のどの守る成果または境界に応えるかを確かめ、対応のない行と、上位文書で決まった境界の言い直しを外す。
107
+ 2. 各行の対応方針が、その行の影響を減らすかを確かめる。
108
+ 3. 影響評価と対応方針の各行が、どの項目 ID の変化から来るかを確かめる。
109
+ 4. 監視・変更管理の契機に、登録した各行のトリガーが入っているかを確かめる。
128
110
 
129
111
  ## 6. 良い例 / 悪い例
130
112
 
131
- | 観点 | 良い例 | 悪い例 |
132
- | -------- | ------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------ |
133
- | 重複排除 | スコープ外で確定済みの境界は、章冒頭の参照で委譲する | スコープの対象外を言い換えて前提・制約として再掲する |
134
- | 運用化 | 憲章などが結論だけを示す制約に、監視方法・トリガー・所有者を添えて展開し、展開元を明記する | 憲章などがすでに継続監視・記録先を持つ判断ゲートを、要約して重複登録する |
135
- | 分類 | 「単一店舗で運用する」を前提として記載する | 「単一店舗で進める」を種別なしで書く |
136
- | 分類 | 「作業環境の継続利用」を依存関係として記載する | 「作業環境を継続利用できる」を前提条件として書く |
137
- | 制約 | 「個人情報を公開資料に含めない」と逸脱時の対応を併記する | 「情報管理に注意する」とだけ書く |
138
- | 依存 | 「先行するスコープ文書」と、その成立条件を記載する | 「他の資料を参照する」とだけ書く |
139
- | トリガー | 「対象外の機能を初期対象へ追加しようとした」と書く | 「必要に応じて確認する」と書く |
140
- | 未確定 | 「_TODO_: 公開判断の記録先を決定する」と書く | 未確認の責任者や期限を断定する |
113
+ | 観点 | 良い例 | 悪い例 |
114
+ | -------- | ------------------------------------------------------------------------ | ------------------------------------------ |
115
+ | 分類 | 「代表試行への協力者を確保できる」を前提にし、未確保時の延期判断を添える | 「店頭で使う端末を利用できる」を前提に書く |
116
+ | 依存 | 端末を依存先にし、営業開始前の動作確認とその記録先を書く | 「端末がある」とだけ書く |
117
+ | 重複排除 | 対象外の境界は章冒頭でスコープへ委ねる | スコープの対象外を言い換えて制約に書く |
118
+ | 制約 | 「承認済み予算枠がない間は発注しない」と、発注前の確認を書く | 「予算に注意する」とだけ書く |
119
+ | 部分決定 | 決定済みの部分と未決の部分を分け、未決の当面の扱いを書く | 一部の決定だけで依存を成立済みとする |
120
+ | トリガー | 「対象外の機能を初期対象へ足そうとした」と書く | 「必要に応じて確認する」と書く |
141
121
 
142
122
  ## 7. レビュー観点
143
123
 
144
- | 観点 | 確認内容 |
145
- | ------------ | ---------------------------------------------------------------------------------------------------------------------------------- |
146
- | 重複排除 | スコープなど上位文書の決定事項を再掲せず、参照で委譲しているか。上位文書がすでに継続監視・記録先を持つ事項を重複登録していないか。 |
147
- | 分類 | 各行が前提、制約、依存のいずれか一つに分類されているか。リポジトリ・作業環境など継続提供が必要な基盤を前提条件に含めていないか。 |
148
- | 根拠 | 内容がスコープまたは直接参照した成果物と矛盾しないか。 |
149
- | 変化への備え | 影響、確認方法、トリガー、所有者、対応方針があるか。 |
150
- | 技術制約 | 特定製品への過度な依存、実装詳細、責務外の設計が混入していないか。 |
151
- | 下流入力 | 業務、受入、計画・統制の担当者が、必要な条件と未確定事項を識別できるか。 |
152
- | 公開適性 | 個人情報、機密情報、非公開情報を含めていないか。 |
124
+ | 観点 | 確認内容 |
125
+ | ------------ | ---------------------------------------------------------------- |
126
+ | 根拠 | 各行がスコープ・憲章と食い違わず、守る成果か境界に対応しているか |
127
+ | 変化への備え | 所有者が変化を知る手段と、次の判断者へつなぐ対応があるか |
128
+ | 下流入力 | 計画・受入の担当者が、待つべき条件と未決の論点を見分けられるか |
129
+ | 責務の境界 | 計画・設計・実装の詳細やリスクの管理を本書に書き込んでいないか |
153
130
 
154
131
  ## 8. 仕上げチェック
155
132
 
156
- - 「全体の作成手順」で示した章立てと必須表がそろっている。
157
- - スコープなど上位文書の決定事項を再掲せず、委譲する場合は章冒頭に参照がある。
158
- - 各項目に影響と変化時の対応が対で記載されている。
159
- - 前提、制約、依存の各章があり、種別を混在させていない。
160
- - 未確定事項を推測で埋めず、確認先または決定時期を明示している。
161
- - 技術設計、実装詳細、最終判断の代替を書き込んでいない。
162
- - 各項目について、守る成果または境界、成立条件、影響、確認・対応方法を同じ ID から追跡できる。
133
+ - 未確認の事実・責任者・期限を断定せず、確認先または決定時期を残している。
134
+ - 個人情報、秘密情報、非公開の組織情報を含めていない。
135
+ - 影響評価と対応方針・監視・変更管理から、変化した条件の項目 ID へたどれる。