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,42 +11,32 @@ specdojo:
11
11
 
12
12
  Project Issues and Approach Writing Recipe
13
13
 
14
- 本ドキュメントは、プロジェクト課題と解決アプローチを「関係者が、何が課題で、どれを、どう解く方針かを合意できる内容」に仕上げるための作り方です。
15
- 本書では問い、深掘り手順、具体化のコツ、レビュー観点を扱います。
14
+ プロジェクト課題と解決アプローチを、関係者が何が課題で、どれを、どう解く方針かを合意できる内容に仕上げるための作り方を示す。
16
15
 
17
16
  ## 1. このレシピの使い方
18
17
 
19
- - 最初に、プロジェクト概要・スコープ・前提制約から「何を実現したいか」と「成立条件」を短く抜き出す。
20
- - 次に、課題一覧、原因、解決策候補、採用アプローチと理由を順に書く。
21
- - 最後に、トレードオフ/リスクと次の検討事項を置き、未確定のまま判断を進めないようにする。
22
- - 目指す価値と課題の影響(Why)、優先課題と到達方針(What)、解決策候補・採用アプローチ・軽減策(How)を整理し、課題 ID、案 ID、根拠、採否理由、記録先で追跡する(Trace)。方式設計と実装詳細は後続成果物へ委譲する。
18
+ - 本書は、概要の目指す価値(Why)を引き継ぎ、優先課題と採用方針(What)を定め、解決策候補・採否理由・軽減策(How)を書く。課題 ID と案 ID で、課題から原因・候補・採否までたどれるようにする(Trace)。方式設計と実装詳細は書かない。
19
+ - 「作成前に集める情報」をメモでそろえてから、「全体の作成手順」の順に書く。
20
+ - 書き終えたら「レビュー観点」で読み直し、「仕上げチェック」で確かめる。
23
21
 
24
22
  ## 2. 作成前に集める情報
25
23
 
26
- 最初から正確に書こうとせず、以下を短いメモで集める。
27
-
28
- | 項目 | 集める情報 |
29
- | -------------- | -------------------------------------------------------------- |
30
- | 背景と必要性 | なぜ取り組むか、放置すると何が悪化するか |
31
- | 困っている現象 | 利用者や運用で実際に起きている問題(解決策ではなく現象) |
32
- | 影響 | 課題を放置した場合の損失、リスク、誰がどう困るか |
33
- | 原因の手がかり | 情報不足、判断基準の不在、手順のばらつき、システム制約など |
34
- | 解決の選択肢 | 取りうる方針(2 件以上)と、代替・補完の関係 |
35
- | 判断軸 | 効果、コスト、期間、リスク、再利用性、公開適性など重視する観点 |
36
- | 前提・制約 | スコープ、前提・制約・依存関係から、守るべき境界と成立条件 |
37
- | 未確定事項 | 追加調査、確認、承認が必要な事項と、その責任ロール |
24
+ | 項目 | 集める情報 | 取り出し元 |
25
+ | -------------- | ---------------------------------------------------- | -------------------------------------- |
26
+ | 目指す価値 | 誰のどの業務価値に近づけたいか、放置で何が悪化するか | プロジェクト概要 |
27
+ | 困っている現象 | 利用者や運用で実際に起きていること(解決策ではなく) | 利用者・運用担当への聞き取り、観察記録 |
28
+ | 境界と成立条件 | 対象範囲・対象外、守るべき前提・制約 | スコープ、前提・制約・依存関係 |
29
+ | 原因の手がかり | 確認できた事実と、まだ推測の段階のこと | 観察記録、既存の成果物、聞き取り |
30
+ | 判断軸の順序 | 効果・費用・期間・負荷などを、今回どの順で重視するか | 承認者への確認 |
38
31
 
39
32
  ## 3. 全体の作成手順
40
33
 
41
- 1. H1 で対象プロジェクト名を明示し、本書の目的(何が課題で、どれを、どう解く方針かを合意する材料)と利用ロール(PO は方針承認、BA は利用者影響整理、ARC は技術的境界識別、PM は作業計画入力など)、合意対象・非合意対象を 1〜2 段落で書く。
42
- 2. 課題一覧で、困っている現象、影響、優先度を書く。
43
- 3. 原因で、事実と仮説を分けて、課題ごとの発生要因を書く。
44
- 4. 解決策候補で、2 件以上の方針を概要、期待できる効果、対応課題、代替・補完の関係とともに並べる。
45
- 5. 採用アプローチと理由で、採用方針、補完策を組み合わせる理由、代替案の採否を判断軸で説明する。
46
- 6. トレードオフ/リスクで、捨てるもの・起きうることと軽減策を書く。
47
- 7. 次の検討事項で、未確定事項と責任ロールを書く。
48
- 8. 見直しと変更管理で、本書を見直す契機・確認観点・対応方針と記録先を書く。
49
- 9. 最後に、設計詳細や曖昧表現を書きすぎていないか確認する。
34
+ 1. 課題一覧を最初に書き、課題 ID を振る。原因と候補が課題 ID を参照するため、ここが決まらないとほかの章が書けない。
35
+ 2. 原因を、課題ごとに事実と仮説に分けて書く。
36
+ 3. 解決策候補を 2 件以上挙げ、代替か補完かと対応課題を添える。
37
+ 4. 採用アプローチと理由を、判断軸の順序に沿って書く。
38
+ 5. 必要な場合だけ、トレードオフ/リスク、次の検討事項(ToDo)、見直しと変更管理を書く。書く内容がなければ置かない。
39
+ 6. 最後に H1 直下の導入部(目的、承認者と利用ロール、合意対象と合意対象外)を書く。採用方針が決まってから書くと、本文の言い直しにならない。
50
40
 
51
41
  ## 4. 各章の書き方
52
42
 
@@ -55,120 +45,91 @@ Project Issues and Approach Writing Recipe
55
45
  問い:
56
46
 
57
47
  - 利用者や運用で、実際に困っている現象は何か。
58
- - 放置すると、誰が、どの業務価値で、どう困るか。
59
- - どの課題から先に決めるべきか(優先度)。
60
-
61
- 書き方:
62
-
63
- - 課題は「困っている現象」で書き、解決策の欠落(例:「自動発注がない」)にしない。
64
- - 各課題に最低限「影響」と「優先度」を添える。
65
- - 課題ID(例: P-01)を振り、原因表や決定記録から参照できるようにする。
48
+ - 放置すると、誰がどの業務価値で困るか。
66
49
 
67
- 良い例:
50
+ コツ:
68
51
 
69
- - 文書の粒度・構成・記述ルールがプロジェクトごとにばらつき、再利用・レビュー・引き継ぎが難しい。
70
-
71
- 悪い例:
72
-
73
- - 共通テンプレートがない。
52
+ - 「〜がない」と書き始めたら解決策の先取りなので、それがないと何が起きているかを聞き直す。
53
+ - 概要の背景を写したくなったら、概要への参照に置き換え、本書では課題の影響だけを書く。
74
54
 
75
55
  ### 4.2. 原因(仮説でも可)
76
56
 
77
57
  問い:
78
58
 
79
59
  - その課題は、なぜ起きているか。
80
- - 確認できている事実はどれで、推測はどれか。
81
- - 根拠となる文書や観察事実は何か。
60
+ - それは確認した事実か、まだ推測か。
82
61
 
83
- 書き方:
62
+ コツ:
84
63
 
85
- - 原因区分(事実 / 仮説)を明示し、混ぜない。
86
- - 課題IDで課題一覧と対応づける。
87
- - 根拠文書、観察事実、補足を添える。
64
+ - 仮説には、何を見れば確かめられるかを添えるよう聞く。確認方法がない仮説は、検証できないまま採否の根拠になりやすい。
65
+ - 一つの課題に原因を一つだけ書くと、候補が一つに絞られやすい。情報・判断基準・手順・制約の別に分けて聞く。
88
66
 
89
67
  ### 4.3. 解決策候補
90
68
 
91
69
  問い:
92
70
 
93
- - 課題を解くために取りうる方針は何か。
94
- - 候補同士は同じ判断を置き換える代替案か、別の課題・原因を扱う補完策か。
95
- - 各案は、どの業務価値に近づけるか。
96
- - 案ごとに失うもの・効果は何か。
71
+ - 候補は、同じ判断を置き換える代替案か、別の課題・原因を扱う補完策か。
72
+ - 各案は、どの課題に効き、何を失うか。
97
73
 
98
- 書き方:
74
+ コツ:
99
75
 
100
- - 2 件以上の方針を、案ID・関係・概要・期待できる効果・対応課題とともに並べる。
101
- - 単一案の押し付けにしない。
102
- - 案IDを振り、採用アプローチや代替案比較から参照できるようにする。
103
- - 同じ判断を置き換える案の詳細比較は代替案比較へ委譲し、本書では比較が必要な論点を示す。
76
+ - 案が一つしか出ないときは、「この案を採らないなら何をするか」と聞いて代替案を引き出す。
77
+ - 代替案どうしの詳細な比較を書き始めたら、比較が要る論点だけを残す。
104
78
 
105
79
  ### 4.4. 採用アプローチと理由
106
80
 
107
81
  問い:
108
82
 
109
- - どの案を採用し、補完策を組み合わせる場合は各案がどの課題・原因を担うか。
110
- - 各案を単独で採用した場合に不足することは何か。
111
- - 採用・非採用の判断軸は何で、今回重視する順序はどうか。
112
- - 採用しない案は、なぜ採用しないか。
83
+ - どの案を採用し、単独で採用した場合に何が不足するか。
84
+ - 採用しない案は、どの判断軸で外れたか。
113
85
 
114
- 書き方:
86
+ コツ:
115
87
 
116
- - 採用案を明記し、判断軸で採用理由を説明する。
117
- - 「採用対象」「判定」「理由」の表にすると、採否と根拠が読み取りやすい。
118
- - 補完策を組み合わせる場合は、併用する理由を説明する。中核・補助または実行順序がある場合だけ、その関係も示す。
119
- - 判断軸の優先順位を 1 文で示す。
88
+ - 判断軸の順序は承認者に先に聞く。順序が決まらないまま書くと、理由が「よさそう」に戻る。
89
+ - 補完策は、各案が担う課題・原因が重ならないかを確かめる。重なるなら代替の関係である。
120
90
 
121
91
  ### 4.5. トレードオフ/リスク
122
92
 
123
93
  問い:
124
94
 
125
- - 採用の代償として、何を捨てる・先送りする・我慢するか。
126
- - 起きうる失敗・遅延・品質低下は何か。
127
- - それぞれの軽減策は何か。
95
+ - 採用の代償として、何を捨てる・先送りするか。
96
+ - 起きうる失敗と、その軽減策は何か。
128
97
 
129
- 書き方:
98
+ コツ:
130
99
 
131
- - 区分(`トレードオフ` / `リスク`)で揃え、課題ログやリスク登録簿へ転記しやすい粒度にする。区切りの `/` の前後にはスペースを置かない。
132
- - リスクは「起きうること」と「軽減策」をセットで書く。
100
+ - 採用理由の判断軸で劣る点を探すと、トレードオフが見つかりやすい。
133
101
 
134
102
  ### 4.6. 次の検討事項(ToDo)
135
103
 
136
104
  問い:
137
105
 
138
- - 次の意思決定に必要な追加調査・確認・承認は何か。
139
- - それぞれの責任ロールは誰か。
106
+ - 次の意思決定に必要な調査・確認・承認は何で、誰が担うか。
107
+ - 何が決まれば完了で、いつまでに決める必要があるか。
140
108
 
141
- 書き方:
109
+ コツ:
142
110
 
143
- - 「ToDo」「目的」「責任ロール」の表にする。
144
- - ToDo の項目は、未確定事項を示す場合は _TODO_: または _UNDECIDED_ ラベルを先頭に付け、後続で検索・フィルタできるようにする(例: _TODO_: 公開先にGitHub を採用するか決定する)。
145
- - 責任ロールは、体制定義で採用済みのロールまたは担当単位で書く。
111
+ - 採否を保留した論点と、仮説の確認方法から拾うと漏れにくい。
146
112
 
147
113
  ### 4.7. 見直しと変更管理
148
114
 
149
115
  問い:
150
116
 
151
- - 本書の合意は、どんな変化で見直す必要があるか。
152
- - 見直したとき、何を確認し、どう対応するか。
153
- - 見直し結果は、どこに記録するか。
117
+ - どんな変化があれば本書の合意を見直すか。
118
+ - そのとき何を確認し、どう対応するか。
154
119
 
155
- 書き方:
120
+ コツ:
156
121
 
157
- - 見直しの契機(仮説の反証、スコープ・前提制約の変更、採用アプローチに影響する決定、リスクの顕在化など)を挙げる。
158
- - 契機ごとに、確認する観点と対応方針をセットで書く。
159
- - 記録先(プロジェクト登録簿、決定記録など)と、監視・取りまとめ・最終判断のロールを示す。
122
+ - 原因の仮説ごとに「反証されたら何を見直すか」を聞くと、契機と対応が対で決まる。
160
123
 
161
124
  ## 5. 深掘り手順
162
125
 
163
- 内容が浅いと感じる場合は、次の順で深掘りする。
126
+ 内容が浅いときは、次の順で対応のない主張を探す。
164
127
 
165
- 1. **困っている現象** を、解決策抜きで言い換える。
166
- 2. **影響** を、誰がどの業務価値で困るかで具体化する。
167
- 3. **原因** を、事実と仮説に分けて分解する。
168
- 4. **解決策候補** を 2 件以上に広げ、代替・補完の関係と対応課題を整理する。
169
- 5. **判断軸の優先順位** を決める。
170
- 6. **採用・非採用の理由** を判断軸で説明する。
171
- 7. **未確定事項と責任ロール** を残す。
128
+ 1. 各課題の影響が、目指す価値のどれに当たるかを確かめ、対応のない課題を外すか価値を問い直す。
129
+ 2. 各原因が課題 ID に結び付き、仮説に確認方法があるかを確かめる。
130
+ 3. 各候補が、どの課題・原因を扱うかを確かめ、対応先のない案を外す。
131
+ 4. 採否の理由が判断軸のどれによるかを確かめる。
132
+ 5. 設計詳細や特定技術の採否を書いた箇所を、後続の成果物への参照に戻す。
172
133
 
173
134
  ## 6. 良い例 / 悪い例
174
135
 
@@ -178,28 +139,18 @@ Project Issues and Approach Writing Recipe
178
139
  | 原因 | 事実: 担当ごとに記述様式が異なる / 仮説: 共通様式が浸透していない | なんとなく属人化している |
179
140
  | 解決策候補 | A 案と B 案は同じ課題への代替、C 案は別原因への補完と整理する | とにかく標準化する |
180
141
  | 採用理由 | A 案と C 案が異なる原因を扱い、単独では不足するため併用する | A 案がよさそうだから採用 |
181
- | リスク | 実践の型の整合が崩れる → 品質管理とレビューで確認する | 特に問題はない |
182
142
 
183
143
  ## 7. レビュー観点
184
144
 
185
- 作成後は、次の観点で確認する。
186
-
187
- | 観点 | 確認内容 |
188
- | -------------------- | ------------------------------------------------------------------ |
189
- | 業務価値との対応 | 課題と解決アプローチが、業務目的・利用者・期待効果と対応しているか |
190
- | 課題の妥当性 | 課題が困っている現象で書かれ、解決策の先取りになっていないか |
191
- | 事実と仮説の区別 | 原因で事実と仮説が混ざっていないか |
192
- | 候補の関係 | 方針が 2 件以上あり、代替・補完の関係と対応課題が明確か |
193
- | 採用理由の説明可能性 | 採用・非採用が判断軸で説明され、後から再現できるか |
194
- | 関係者・利用場面 | 関係者、利用場面、確認者、合意対象が読み取れるか |
195
- | 責務分担 | 設計詳細・実装詳細・テスト設計を書きすぎていないか |
196
- | 未確定の明示 | 未確定事項が _TODO_ / _UNDECIDED_ 等で明示されているか |
145
+ | 観点 | 確認内容 |
146
+ | ---------------- | -------------------------------------------------------------- |
147
+ | 業務価値との対応 | 課題と採用方針が、目指す価値・利用者・期待効果と対応しているか |
148
+ | 関係者・利用場面 | 承認者、利用ロール、合意対象が読み取れるか |
149
+ | 採否の再現性 | 後から読んだ人が、判断軸の順序から同じ採否を導けるか |
150
+ | 委譲の境界 | 設計詳細・実装詳細・特定技術の採否を書きすぎていないか |
197
151
 
198
152
  ## 8. 仕上げチェック
199
153
 
200
- - 「全体の作成手順」で示した章立てと必須表がそろっている。
201
- - 課題一覧、原因、解決策候補、採用アプローチと理由がすべて記述されている。
202
- - 解決策候補が 2 件以上あり、代替・補完の関係と対応課題がある。
203
- - 採用アプローチに判断軸と採用理由がある。
204
- - 各採用アプローチを、目指す価値、課題・原因、候補案、採否理由、見直し記録へ ID で追跡できる。
205
- - 曖昧表現や設計詳細を書きすぎていない。
154
+ - 各課題が原因・候補・採否まで課題 ID と案 ID でたどれる。
155
+ - 仮説を事実として書いていない。
156
+ - 課題・原因・リスクの記述に、個人や特定の組織を識別できる情報や非公開の観察事実がない。
@@ -11,42 +11,31 @@ specdojo:
11
11
 
12
12
  Project Scope Writing Recipe
13
13
 
14
- 本ドキュメントは、プロジェクトスコープを「関係者が対象範囲と対象外を合意できる内容」に仕上げるための作り方です。
15
- 本書では問い、深掘り手順、具体化のコツ、レビュー観点を扱います。
14
+ プロジェクトスコープを、関係者が今回やることとやらないことを合意できる内容に仕上げるための作り方を示す。
16
15
 
17
16
  ## 1. このレシピの使い方
18
17
 
19
- - 最初に、プロジェクト概要や上位方針から「何を実現したいか」を短く抜き出す。
20
- - 次に、対象業務、対象システム、対象期間、スコープ外を分けて書く。
21
- - 最後に、境界の判断基準とスコープ変更方針を置き、迷ったときの扱いを決める。
22
- - 上位の目的・期待効果(Why)、対象業務・対象システム・対象期間・対象外(What)、境界判断と変更方針(How)を整理し、上位参照、対象項目、理由、変更記録で追跡する(Trace)。受入条件と設計・実装詳細は後続成果物へ委譲する。
18
+ - スコープは、プロジェクト概要の目的・期待効果(Why)を引き継ぎ、対象業務・対象システム・対象期間・スコープ外(What)を定め、任意で境界の判断基準と変更方針(How)を決める。各行は、上位の期待効果と境界の理由で、変更後は変更記録でもたどれるようにする(Trace)。
23
19
 
24
20
  ## 2. 作成前に集める情報
25
21
 
26
- 最初から正確に書こうとせず、以下を短いメモで集める。
27
-
28
- | 項目 | 集める情報 |
29
- | ------------------ | -------------------------------------------------------------------------------------- |
30
- | 背景と必要性 | なぜ取り組むか、放置すると何が悪化するか |
31
- | 対象利用者 | 誰が使うか、誰が影響を受けるか |
32
- | 対象業務 | どの業務、活動、利用場面を対象にするか |
33
- | 対象システム | どのシステム、成果物、実行ツール、管理データ、生成物、基盤、外部連携を含めるか |
34
- | 初期対象期間 | いつからいつまで、またはどのイベントまでを対象にするか。未確定なら _UNDECIDED_: で残す |
35
- | 明示的な対象外 | やらないこと、理由、後続で扱う条件 |
36
- | 境界で迷う項目 | 含めるか外すか判断が必要な候補 |
37
- | 変更時の決め方 | 提案入口、影響評価、承認者、記録先 |
38
- | 下流文書への委譲先 | 成功基準、前提・制約、課題、設計、実装、テストへ委譲する内容 |
22
+ | 項目 | 集める情報 | 取り出し元 |
23
+ | ---------------- | ------------------------------------------------------------ | ------------------------ |
24
+ | 目的と期待効果 | 取り組む理由、放置したときに悪化すること | プロジェクト概要 |
25
+ | 利用者と利用場面 | 誰が使い、誰の作業や判断が変わるか | プロジェクト概要、利用者 |
26
+ | 整備するもの | 作る・変える・運用するシステム、ツール、正本データ、生成物 | 既存の構成、実行責任者 |
27
+ | 期間の区切り | 初期対象の終わりを決める日付またはイベント | スケジュール、承認責任者 |
28
+ | 外す候補 | やらないことと理由、再検討する条件 | 関係者への確認 |
29
+ | 迷う候補 | 含めるか外すかで意見が分かれた項目と、そのときの判断のしかた | 確認の過程のメモ |
39
30
 
40
31
  ## 3. 全体の作成手順
41
32
 
42
- 1. H1 で対象プロジェクト名を明示する。
43
- 2. 対象業務で、活動領域、利用場面、利用者影響を書く。
44
- 3. 対象システムで、対象となるシステム、成果物、実行ツール、管理データ、生成物、基盤を粒度を揃えて並べ、責務境界を書く。
45
- 4. 対象期間で、初期対象、判断イベント、継続改善との切り分けを書く。
46
- 5. スコープ外で、やらないこと、理由、後続で扱う条件を書く。
47
- 6. 境界の判断基準で、迷ったときの優先順位を定義する。
48
- 7. スコープ変更方針で、提案入口、影響評価、承認者、記録先を定義する。
49
- 8. 最後に、設計詳細や受入条件を書きすぎていないか確認する。
33
+ 1. 対象外の候補を先に書き出す。外すものが決まると、対象業務の範囲が狭まり書きやすくなる。
34
+ 2. 対象業務を、利用者の作業や判断の単位で書く。
35
+ 3. 対象システムを、対象業務を支えるものに限って並べる。
36
+ 4. 対象期間で、初期対象と継続改善を分ける。
37
+ 5. スコープ外に、1 で出した候補を理由と再検討条件を添えて書く。
38
+ 6. 迷う候補が残った場合は境界の判断基準を、変更の決め方を合意した場合はスコープ変更方針を書く。どちらも任意の章で、なければ省く。
50
39
 
51
40
  ## 4. 各章の書き方
52
41
 
@@ -54,148 +43,103 @@ Project Scope Writing Recipe
54
43
 
55
44
  問い:
56
45
 
57
- - どの業務、活動、利用場面を対象にするか。
58
- - 誰が使うか、誰の負担や判断が変わるか。
59
- - 対象にすることで、どの業務価値に近づくか。
60
- - 何を運用・管理できる状態にしたいか。
61
-
62
- 書き方:
63
-
64
- - 機能名だけでなく、利用者が行う作業や判断で書く。
65
- - 「対象利用者」「利用場面」「利用者影響」を読み取れる粒度にする。
66
- - 業務アプリケーション以外のプロジェクトでは、文書整備、公開準備、運用基盤整備などを活動領域として書く。
46
+ - 対象にすると、誰のどの作業や判断が変わるか。
47
+ - 作るだけでなく、運用・管理できる状態にしたいものは何か。
67
48
 
68
- 良い例:
49
+ コツ:
69
50
 
70
- - 単一店舗の店頭販売、店頭在庫、常連顧客のつけ管理を対象にし、店主代表以外が店番する場合でも同じ手順で確認できる状態を目指す。
71
-
72
- 悪い例:
73
-
74
- - 販売管理機能を作る。
51
+ - 機能名を書き始めたら、利用者に「その機能で何をするか」を聞いて作業の言葉に直す。
52
+ - 背景や期待効果を概要から写したくなったら、写さず概要への参照に置き換える。
75
53
 
76
54
  ### 4.2. 対象システム
77
55
 
78
56
  問い:
79
57
 
80
- - 対象となるシステム、成果物、文書体系、基盤は何か。
81
- - プロジェクトが整備・変更する実行ツールや CLI、正本データ、生成物は何か。
82
- - 生成物の正本はどれで、直接編集してよいか。
83
- - 外部連携や公開基盤はどこまで含めるか。
84
- - 対象業務と対象システムの粒度は揃っているか。
85
- - 後続の設計文書へ委譲すべき詳細を書いていないか。
58
+ - プロジェクトが整備・変更するツール、正本データ、生成物は何か。
59
+ - 外部サービスのうち、プロジェクトが担うのは設定・接続・利用のどこまでか。
86
60
 
87
- 書き方:
61
+ コツ:
88
62
 
89
- - 表形式で「対象」「内容」「境界」を分け、プロジェクトが担う範囲と担わない範囲を示す。
90
- - 業務機能、文書体系、補助ツール、公開基盤など異なる性質の対象は、同じ粒度の大項目として扱う。
91
- - 正本データと生成物は、編集方法や責務が異なる場合に別の行へ分ける。
92
- - 外部ツール本体を開発しない場合は、設定・接続・利用のみを対象とするなど責務境界を書く。
93
- - UI、API、DB、テストケースの詳細は書かない。
63
+ - 業務機能と文書体系、補助ツールが混ざると粒度がずれやすい。並べた後で、同じ大きさの項目かを見直す。
64
+ - 生成物は、生成元の正本と直接編集してよいかを聞くと、責務の境界が決まる。
65
+ - 画面・API・DB の名前が出てきたら、設計の話なので書かない。
94
66
 
95
67
  ### 4.3. 対象期間
96
68
 
97
69
  問い:
98
70
 
99
- - 初期対象はいつからいつまでか。
100
- - 日付が未確定なら、どのイベントまでを対象にするか。
101
- - 初回公開、初期リリース、運用定着、継続改善をどう分けるか。
102
- - どのスケジュール文書を期間判断の根拠にするか。
71
+ - 初期対象はどの日付、または何が起きたら終わるか。
72
+ - 継続改善のうち、今回の範囲に含めるものはあるか。
103
73
 
104
- 書き方:
74
+ コツ:
105
75
 
106
- - 日付が未確定な場合は、イベント基準で定義する。
107
- - 継続改善を含める場合は、初期スコープと継続改善フェーズを分ける。
108
- - 未決事項は _UNDECIDED_: を優先し、決める文書またはタイミングを添える。実施待ちの作業を残す場合のみ _TODO_: を使い分ける。
76
+ - 日付が出ないときは「初回公開まで」のようにイベントで聞く。決まっていなければ _UNDECIDED_ を残し、決める時期を添える。
109
77
 
110
78
  ### 4.4. スコープ外
111
79
 
112
80
  問い:
113
81
 
114
- - 今回やらないことは何か。
115
- - 外した理由は、責務境界、コスト、効果、公開適性、期間のどれか。
116
- - 利用者に影響がある対象外項目は、後続でいつ再検討するか。
117
- - 対象外を書かないことで誤解される項目はないか。
82
+ - 今回やらないことは何で、なぜ外すのか。
83
+ - 外したことで困る利用者がいる項目は、いつ再検討するか。
118
84
 
119
- 書き方:
85
+ コツ:
120
86
 
121
- - 「対象(Out)」「理由」「補足」の表にすると、やらない理由と扱いが明確になる。
122
- - スコープ外は弱い表現にせず、今回含めないことを明示する。
123
- - 「将来やるかもしれない」だけで終わらせず、再検討条件を添える。
87
+ - 「必要なら考える」は対象外になっていない。含めないと言い切り、再検討の条件を添える。
88
+ - 書かないと「含まれる」と誤解されやすい項目を、関係者に聞いて拾う。
124
89
 
125
- ### 4.5. 境界の判断基準
90
+ ### 4.5. 境界の判断基準(任意)
126
91
 
127
92
  問い:
128
93
 
129
94
  - 含めるか外すかで迷ったとき、何を優先するか。
130
- - 業務価値、利用者影響、公開適性、保守容易性のどれを重く見るか。
131
- - 特定の技術、手法、個別要望に引っ張られたとき、どう判断するか。
95
+ - 個別の要望や特定の技術に引っ張られたとき、何で判断するか。
132
96
 
133
- 書き方:
97
+ コツ:
134
98
 
135
- - 2〜5 件程度の優先順位付き箇条書きにする。
136
- - 判断基準は、後続のスコープ変更や優先度判断に再利用できる表現にする。
99
+ - 迷う候補で実際に判断した理由から書くと、後の変更判断にも使える原則になる。
137
100
 
138
- ### 4.6. スコープ変更方針
101
+ ### 4.6. スコープ変更方針(任意)
139
102
 
140
103
  問い:
141
104
 
142
- - 誰が変更を提案できるか。
143
- - どこに記録するか。
144
- - 何を確認してから判断するか。
145
- - 誰が承認するか。
146
- - 変更により影響を受ける成果物は何か。
105
+ - 誰がどこに変更を提案し、誰が決めるか。
106
+ - 初期リリース前に足すとき、何を外すか延期するか。
147
107
 
148
- 書き方:
108
+ コツ:
149
109
 
150
- - 「変更入口」「影響評価」「承認者」「記録先」の表にすると、最低限の運用が揃う。
151
- - 初期リリース前に追加する場合は、同時に外すものや延期するものを示す。
152
- - 判断理由を DEC、課題一覧、Issue、PR、変更要求ログのいずれかに残す。
110
+ - 「関係者で相談する」で止めず、決める人と判断理由を残す場所を聞く。
153
111
 
154
112
  ## 5. 深掘り手順
155
113
 
156
- 内容が浅いと感じる場合は、次の順で深掘りする。
114
+ 内容が浅いときは、次の順で対応のない主張を探す。
157
115
 
158
- 1. **対象利用者** を具体化する。
159
- 2. **利用場面** を業務や活動の単位で書く。
160
- 3. **対象外にすべき候補** を先に列挙する。
161
- 4. **対象業務と対象システムの対応** を確認する。
162
- 5. **初期対象と継続改善** を分ける。
163
- 6. **迷ったときの判断順序** を 2〜5 件に絞る。
164
- 7. **変更時の承認者と記録先** を決める。
116
+ 1. 対象業務の各行が、概要のどの期待効果に応えるかを確かめ、対応のない行を外すかスコープ外へ移す。
117
+ 2. 対象システムの各行が、どの対象業務を支えるかを確かめる。
118
+ 3. スコープ外の各行に、外す理由と再検討条件があるかを確かめる。
119
+ 4. 受入条件・設計・実装の詳細を書いた箇所を見つけ、後続の成果物へ移す。
165
120
 
166
121
  ## 6. 良い例 / 悪い例
167
122
 
168
- | 観点 | 良い例 | 悪い例 |
169
- | ------------ | --------------------------------------------------------------------- | ---------------------------- |
170
- | 対象業務 | 店主代表以外が店番する場合でも販売・在庫・つけ残高を確認できる状態 | 販売管理を改善する |
171
- | 対象システム | 販売登録、管理データ、生成レポートを分け、編集・責務の境界を示す | 画面名、API、DBを混在させる |
172
- | 対象期間 | 初期リリースから2週間の記録継続確認までを対象にする | できるだけ早く公開する |
173
- | スコープ外 | EC は店頭販売の記録継続を優先するため対象外とし、次フェーズで検討する | 必要なら EC も考える |
174
- | 境界判断 | 日々使う業務を優先し、高度な分析は記録安定後に扱う | 便利そうなものは入れる |
175
- | 変更方針 | 提案入口、影響評価、承認者、記録先を表で示す | 関係者で相談して柔軟に決める |
123
+ | 観点 | 良い例 | 悪い例 |
124
+ | ------------ | --------------------------------------------------------------------- | --------------------------- |
125
+ | 対象業務 | 店主代表以外が店番する場合でも販売・在庫・つけ残高を確認できる状態 | 販売管理を改善する |
126
+ | 対象システム | 販売登録、管理データ、生成レポートを分け、編集・責務の境界を示す | 画面名、API、DBを混在させる |
127
+ | 対象期間 | 初期リリースから2週間の記録継続確認までを対象にする | できるだけ早く公開する |
128
+ | スコープ外 | EC は店頭販売の記録継続を優先するため対象外とし、次フェーズで検討する | 必要なら EC も考える |
129
+ | 境界判断 | 日々使う業務を優先し、高度な分析は記録安定後に扱う | 便利そうなものは入れる |
176
130
 
177
131
  ## 7. レビュー観点
178
132
 
179
- 作成後は、次の観点で確認する。
180
-
181
- | 観点 | 確認内容 |
182
- | ---------------- | ------------------------------------------------------------------ |
183
- | 業務価値との対応 | プロジェクト概要の背景、必要性、期待効果とスコープが対応しているか |
184
- | 利用者影響 | 対象利用者、利用場面、影響範囲が読み取れるか |
185
- | 対象範囲 | 対象業務、対象システム、対象期間が判断可能な粒度か |
186
- | システム境界 | 実行ツール、正本データ、生成物、外部サービスの責務を区別できるか |
187
- | 対象外 | やらないこと、理由、再検討条件が明示されているか |
188
- | 境界判断 | 迷ったときに使える優先順位や判断原則があるか |
189
- | 変更運用 | 変更入口、影響評価、承認者、記録先があるか |
190
- | 責務分担 | 受入条件、設計詳細、実装詳細を書きすぎていないか |
191
- | 公開適性 | 個人情報、非公開情報、機密情報が含まれていないか |
133
+ | 観点 | 確認内容 |
134
+ | ------------ | -------------------------------------------------------------- |
135
+ | 業務価値 | 対象業務が概要の期待効果に対応し、利用者への影響が読み取れるか |
136
+ | システム境界 | ツール、正本データ、生成物、外部サービスの責務を区別できるか |
137
+ | 境界の合意 | 関係者が、迷う候補を含めるか外すかをこの文書だけで判断できるか |
192
138
 
193
139
  ## 8. 仕上げチェック
194
140
 
195
- - 「全体の作成手順」で示した章立てがそろっている。
196
- - 対象業務、対象システム、対象期間、スコープ外がすべて記述されている。
197
- - 未確定の日付やイベントは _UNDECIDED_: を優先し、決定タイミングが添えられている。
198
- - スコープ外に理由と補足がある。
199
- - 境界の判断基準とスコープ変更方針が、後続の判断に使える。
200
- - 成功基準、受入条件、設計詳細、実装詳細を書きすぎていない。
201
- - 各対象・対象外を上位の目的または期待効果、境界理由、再検討条件、変更記録へ追跡できる。
141
+ - 対象業務・対象システムの各行が、概要の期待効果と境界の理由へたどれる。変更した行は、変更記録にもたどれる。
142
+ - 未確定の期間に _UNDECIDED_ と決める時期がある。
143
+ - 境界の判断基準・スコープ変更方針は、書いた場合だけ、後の判断に使える原則と決める人があるかを確かめる。
144
+ - 受入条件・設計・実装の詳細を書いていない。
145
+ - 個人情報、公開できない情報、機密情報を含めていない。