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,128 +11,136 @@ specdojo:
11
11
 
12
12
  Status Definition Authoring Recipe
13
13
 
14
- 一つの業務対象について、状態の意味・成立条件と状態間の遷移を矛盾なく一文書へまとめる手順です。
14
+ 一つの業務対象について、状態で判断をそろえたい理由から、状態と遷移を説明できる内容に仕上げるための作り方を示す。
15
15
 
16
16
  ## 1. このレシピの使い方
17
17
 
18
- - 対象の開始から終了までを時系列で聞き取り、状態候補と状態変更イベントを同時に集めます。
19
- - 状態一覧を先に仮置きし、遷移図を描いた後で到達不能・出口なし・重複状態を見つけて一覧へ戻します。
20
- - 遷移の説明を図と一行ずつ照合し、最後に関連フローや用語との名称一致を確認します。
21
- - 実装値は状態の安定識別に必要な範囲だけ扱い、実装条件式や操作手順は後続設計へ委ねます。
18
+ - STSD は、状態で判断をそろえたい業務課題(Why)を「目的」で引き継ぎ、一つの対象の状態と遷移(What)を「状態一覧」と「状態遷移」で定め、現在状態の決め方と遷移の条件・判断者(How)を「状態の判定」と遷移表で示す。状態値と遷移 ID で、図・遷移表・関連文書・レビュー指摘から同じ状態と遷移をたどれるようにする(Trace)。実装条件式や操作手順は後続設計へ委ねる。
22
19
 
23
20
  ## 2. 作成前に集める情報
24
21
 
25
- | 入力 | 確認する内容 |
26
- | ---------------- | --------------------------------------------------------- |
27
- | 対象とスコープ | 状態を持つ一つの対象、AS-IS / TO-BE、開始・終了の業務境界 |
28
- | 状態候補 | 現場の正式名称・通称、その状態と判断する事実 |
29
- | 状態変更イベント | 誰が何をした、または何が起きたとき状態が変わるか |
30
- | 分岐条件 | 同じイベントから遷移先が分かれる場合の判定条件 |
31
- | 管理場所 | 現在状態と変更結果を確認する帳簿、台帳、記録、物の保管先 |
32
- | 関連文書 | 用語集、業務データ辞書、状態を変えるプロセスを示す CDFD |
22
+ | 項目 | 集める情報 | 取り出し元 |
23
+ | ---------------- | -------------------------------------------------------------- | ------------------------ |
24
+ | 対象と業務境界 | 状態を持つ一つの対象、状態変更が始まる業務と対象外の業務 | 関連 CDFD、業務分析担当 |
25
+ | 状態で行う判断 | 誰がその状態を見て、次に何をするかを決めるか | 現場の担当者への聞き取り |
26
+ | 状態候補 | 現場で「いま何の状態か」と答える名称・通称と、そう判断する事実 | 現場の担当者への聞き取り |
27
+ | 状態変更イベント | 誰が何をした、または何が起きたときに状態が変わるか | 関連 CDFD、現場の担当者 |
28
+ | 管理場所と正本 | 現在状態を確かめる記録と、派生して作る一覧・集計 | 帳簿・台帳・記録の現物 |
29
+ | 旧記録の扱い | 旧状態値・旧イベント・未設定の記録があるか | 既存の記録、移行の担当者 |
33
30
 
34
31
  ## 3. 全体の作成手順
35
32
 
36
- 1. 対象を一つに限定し、開始イベントと業務上の終了を短い文で定義します。
37
- 2. 現場で「いま何の状態か」と答える際の名称を集め、意味または成立条件が同じ候補を統合します。
38
- 3. 各状態へ値、正式名称、通称、意味、成立条件、管理場所を記入します。
39
- 4. 開始点から状態を並べ、状態を変えるイベントと条件を付けて Mermaid の状態遷移図を描きます。
40
- 5. 図の矢印へ `T-01` から遷移 ID を割り当て、遷移元・遷移先・イベント・条件・補足を表へ記載します。
41
- 6. 状態一覧と図を双方向に照合し、孤立状態、到達不能状態、出口のない状態、条件の重複を解消します。
42
- 7. 関連文書と状態名・イベント名・管理場所を照合し、未決事項だけを今後の検討メモへ残します。
33
+ 1. 対象を一つに決め、「目的」と「適用範囲」を書く。対象が決まらないと、状態候補の粒度と終了点の要否が決まらない。
34
+ 2. 状態候補と状態変更イベントを同時に聞き取り、意味か成立条件が同じ候補を統合して「状態一覧」を仮置きする。名称とイベントを別々に集めると、つながらない状態が残る。
35
+ 3. 「状態の判定」に正本の記録と現在状態を一つに決める規則を書く。成立条件だけでは判定が分かれる箇所が、ここで見つかる。
36
+ 4. 「状態遷移」で正常系の図と直下の遷移表を作り、その後に例外分岐と戻りを加える。正常系を先に描くと、例外がどの状態から外れるかが見える。
37
+ 5. 図から到達できない状態、出口のない状態、区別できない状態を探し、「状態一覧」へ戻して直す。
38
+ 6. 関連文書と状態名・イベント名を突き合わせ、残った未決事項だけを「今後の検討メモ」へ置く。
39
+ 7. 最後に H1 直下の頭書きを書く。対象と到達点が決まってから書くと、本文の言い直しにならない。
43
40
 
44
41
  ## 4. 各章の書き方
45
42
 
46
- ### 4.1. 概要
43
+ ### 4.1. 頭書きと目的
47
44
 
48
45
  問い:
49
46
 
50
- - 状態を持つ対象は一つの名詞で答えられますか。
51
- - どの出来事からどの終了までを扱い、AS-IS / TO-BE のどちらですか。
52
- - 誰が現在状態を判断し、誰が遷移の定義を設計・検証に使いますか。
53
- - 状態を確認する正本はどの記録または保管先ですか。
47
+ - 状態は対象の何を管理するのか(進み具合、利用可否など)。
48
+ - 誰がその状態を見て、どの業務の要否を判断するのか。
54
49
 
55
- 背景を長く再掲せず、対象・境界・利用目的・正本を短く固定します。
50
+ コツ:
56
51
 
57
- ### 4.2. 状態一覧
52
+ - 「状態を区別しないと、どの判断がそろわないか」と聞くと、管理する内容と判断が一度に出る。
53
+ - 上位の概要や CDFD に書かれた背景は写さず、参照に置き換える。
54
+
55
+ ### 4.2. 適用範囲
58
56
 
59
57
  問い:
60
58
 
61
- - 状態名は業務上の名詞句で、実装フラグや処理名になっていませんか。
62
- - 成立条件だけで第三者が現在状態を一つに判定できますか。
63
- - 通称が正式名称と違う場合、その対応を一行で確認できますか。
64
- - 管理場所から現在状態の根拠を確認できますか。
59
+ - どの開始イベントから、どこまでの業務で状態変更を扱うのか。
60
+ - 完了・中止の後も、差し戻しや記録更新のために状態を管理し続けるのか。
61
+
62
+ コツ:
65
63
 
66
- 候補が同時に成立する場合は、状態を統合するか優先関係を明記します。単なる処理待ちを状態にする場合は、業務判断や管理責任が変わることを確認します。
64
+ - 「完了した後に戻すことはあるか」を聞くと、終了点を置くかどうかが決まる。記録を保存するだけなら継続の理由にならない。
67
65
 
68
- ### 4.3. 状態遷移図
66
+ ### 4.3. 状態の判定
69
67
 
70
68
  問い:
71
69
 
72
- - 開始点から主要な終了点または継続状態まで矢印をたどれますか。
73
- - 状態一覧の全状態が図にあり、図の業務状態が一覧にありますか。
74
- - 各矢印にイベントと条件があり、同じ分岐元の条件を区別できますか。
75
- - 例外経路から復帰、終了、または人間の判断へ進めますか。
70
+ - 現在状態を確かめる正本はどの記録で、どれが派生した一覧か。
71
+ - 旧状態値や未設定の記録を、どう読み取るのか。
76
72
 
77
- まず正常系を描き、その後に例外分岐と戻りを加えます。図が読みにくい場合は、状態を削るのではなく通常系・例外系などの観点で図を分けます。
73
+ コツ:
78
74
 
79
- ### 4.4. 遷移の説明
75
+ - 同じ対象の記録を二人が別々に判定し、同じ状態になるか確かめる。分かれた箇所へ順序や優先関係を補う。
76
+ - 根拠のない読み替えや初期値は仮定せず、未決事項へ回す。
77
+
78
+ ### 4.4. 状態一覧
80
79
 
81
80
  問い:
82
81
 
83
- - 図の全矢印を遷移 ID で一行ずつ説明していますか。
84
- - 遷移元・遷移先は状態一覧と同じ名称ですか。
85
- - 条件は記録や業務判断から yes / no で判定できますか。
86
- - 図だけでは分からない判断者、証跡、例外時の扱いを補足していますか。
82
+ - その状態になると、誰の判断や管理責任が変わるのか。
83
+ - 隣の状態と、どの事実で区別できるのか。
84
+
85
+ コツ:
86
+
87
+ - 単なる処理待ちを状態にしたくなったら、判断や責任が変わるかを確かめ、変わらなければ前の状態に含める。
88
+ - 二つの候補が同時に成り立つなら、統合するか「状態の判定」に優先関係を書く。
89
+
90
+ ### 4.5. 状態遷移
91
+
92
+ 問い:
87
93
 
88
- 図の言い換えだけで終わらせず、レビューとテストで使う判定根拠を補います。ただし、実装条件式や詳細な操作手順は記載しません。
94
+ - 例外の経路は、復帰・終了・人間の判断のどこへ進むのか。
95
+ - 分岐の条件は、記録や判断から yes / no で決められるのか。
89
96
 
90
- ### 4.5. 今後の検討メモ
97
+ コツ:
91
98
 
92
- - 未決の例外状態、条件、用語、責任境界だけを記載します。
93
- - 影響する状態名または遷移 ID、決定者、決定時期を添えます。
94
- - 調査不足、意思決定待ち、仮置き前提を共通ラベルで区別します。
99
+ - 補足には、判断者・証跡・例外時の扱いなど、図から読めない根拠だけを書く。
100
+ - 承認者や共通条件など、運用ガイドなどの上位成果物を正とする内容は写さず、参照に置き換える。
101
+
102
+ ### 4.6. 今後の検討メモ
103
+
104
+ 問い:
105
+
106
+ - 決まっていない例外状態・条件・用語・責任境界はどれか。
107
+ - 決まるまで、どの遷移をどう扱うのか。
108
+
109
+ コツ:
110
+
111
+ - 「今後検討」だけで終えず、影響する状態または遷移 ID と、決まるまでの扱いを聞いて書く。
95
112
 
96
113
  ## 5. 深掘り手順
97
114
 
98
- 1. 各状態について「その直前は何か」「何が起きてこの状態になるか」を逆向きに確認します。
99
- 2. 各状態について「次に何へ進むか」「進めない場合はどうなるか」を順方向に確認します。
100
- 3. 同じ成立条件を持つ状態を探し、意味の違いを説明できなければ統合します。
101
- 4. 同じイベントから複数の矢印が出る箇所で条件を一つずつ反転し、重複や漏れを探します。
102
- 5. 管理場所を一つずつ確認し、状態変更の証跡が残らない遷移へ記録方法または判断者を補います。
103
- 6. 関連 CDFD の状態変更プロセスを一つずつたどり、対応する STSD とイベントを特定します。
115
+ 内容が浅いときは、次の順で対応のない主張を探す。
116
+
117
+ 1. 各状態について「その直前は何か」「何が起きてこの状態になるか」を逆向きにたどり、入口のない状態を探す。
118
+ 2. 各状態について「次に何へ進むか」「進めないときはどうなるか」を順向きにたどり、出口の理由を説明できない状態を探す。
119
+ 3. 同じイベントから分かれる矢印で条件を一つずつ反転し、重なりと漏れを探す。
120
+ 4. 各状態が「目的」のどの判断に使われるかを確かめ、使われない状態を統合する。
121
+ 5. 関連 CDFD の状態変更プロセスを一つずつたどり、対応する遷移のないプロセスを探す。
104
122
 
105
123
  ## 6. 良い例 / 悪い例
106
124
 
107
- | 観点 | 良い例 | 悪い例 |
108
- | -------- | ------------------------------------------------------ | -------------------------------------- |
109
- | 対象 | 商品の入荷から販売・返品までを一文書で扱う | 商品と発注の状態を同じ一覧へ混在させる |
110
- | 状態名 | 販売可能 | `is_sellable` |
111
- | 成立条件 | 検品結果が合格で在庫数量へ反映された | 検品が終わったら |
112
- | 遷移 | 検品完了 / 数量・品質が合格 | 次へ進む |
113
- | 分岐 | 合格と、数量違いまたは品質不良を別条件にする | 成功 / それ以外 |
114
- | 管理場所 | 仕入記録で受入、在庫記録で販売可能を確認する | システムで管理する |
115
- | 文書分割 | 状態一覧・遷移図・遷移説明を `stsd-product` に集約する | 状態一覧と遷移図を別ファイルで管理する |
125
+ | 観点 | 良い例 | 悪い例 |
126
+ | -------- | -------------------------------------------------------------- | -------------------------------------- |
127
+ | 対象 | 商品の入荷から販売・返品までを一文書で扱う | 商品と発注の状態を同じ一覧へ混在させる |
128
+ | 分岐 | 合格と、数量違いまたは品質不良を別の条件にする | 成功 / それ以外 |
129
+ | 処理待ち | 検品待ちは、検品者が受入可否の判断を負うため独立した状態にする | 画面の処理中表示をそのまま状態にする |
130
+ | 補足 | 返品の判断者を店主代表とし、仕入記録に返品理由を残す | 図と同じ経路を文章で順に説明する |
116
131
 
117
132
  ## 7. レビュー観点
118
133
 
119
- | 観点 | 確認内容 | 主な確認者 |
120
- | ------------ | -------------------------------------------------------------------- | ---------------------- |
121
- | 業務妥当性 | 状態と遷移が現場の判断・例外を表し、対象のライフサイクルを説明できる | 業務分析担当、店主代表 |
122
- | 一意性 | 成立条件から現在状態を一意に判定できる | 業務分析担当 |
123
- | 図表整合 | 状態一覧、状態遷移図、遷移の説明の名称・件数・条件が一致する | 品質確認担当 |
124
- | 設計入力 | 状態値、イベント、条件、管理場所を後続設計へ引き渡せる | 技術メンター |
125
- | テスト可能性 | 初期、正常、例外、終了の経路と分岐条件から状態遷移テストを設計できる | 品質確認担当 |
126
- | 用語整合 | 状態名・通称・イベント名が関連文書と一致する | 業務分析担当 |
134
+ | 観点 | 確認内容 |
135
+ | ------------ | -------------------------------------------------------------------- |
136
+ | 目的との対応 | 各状態と遷移が、「目的」に書いた誰のどの判断に使われるか |
137
+ | 業務妥当性 | 現場の判断と例外を表し、対象の開始から到達点までを説明できるか |
138
+ | テスト可能性 | 初期・正常・例外・到達点の経路と分岐条件から状態遷移テストを組めるか |
139
+ | 委譲の境界 | 実装条件式・画面操作・詳細 API を後続設計へ委ね、書きすぎていないか |
127
140
 
128
141
  ## 8. 仕上げチェック
129
142
 
130
- - 一文書が一つの対象と一つの AS-IS / TO-BE スコープだけを扱っている。
131
- - 状態一覧の全行に状態名、意味、成立条件、管理場所がある。
132
- - 状態一覧と状態遷移図の業務状態が過不足なく一致している。
133
- - 図の全遷移が遷移の説明に一度ずつあり、イベントと条件が一致している。
134
- - 開始から正常終了までと、主要な例外経路をたどれる。
135
- - 条件分岐が相互に区別でき、判定不能な「適切」「問題なし」を使っていない。
136
- - 状態名、通称、イベント名、管理場所が用語集・業務データ辞書・関連 CDFD と矛盾しない。
137
- - 実装条件式、SQL、詳細 API、画面操作を状態定義として記載していない。
138
- - 今後の検討メモに _TODO_ が残っていない。未決事項は決定者と決定時期を持つ。
143
+ - 各状態が、「目的」に書いた判断のどれかに使われている。
144
+ - 例外の経路ごとに、復帰・終了・人間の判断のどこへ進むかを説明できる。
145
+ - 分岐の条件に「適切」「問題なし」など、判定できない語を使っていない。
146
+ - 未決事項ごとに、影響する状態または遷移 ID と決まるまでの扱いがある。
@@ -0,0 +1,129 @@
1
+ ---
2
+ specdojo:
3
+ id: specdojo:sysd-critical-flows-recipe
4
+ type: recipe
5
+ status: ready
6
+ rulebook: specdojo:sysd-critical-flows-rulebook
7
+ sample: specdojo:sysd-critical-flows-sample
8
+ ---
9
+
10
+ # システム設計 重要フロー 作成レシピ
11
+
12
+ System Design Critical Flows Authoring Recipe
13
+
14
+ 取り返しのつかない境界と失敗後の次の手を見つけ、実装・検証・運用の担当が同じ判断へ戻れる重要フローに仕上げる作り方を示す。
15
+
16
+ ## 1. このレシピの使い方
17
+
18
+ - 業務フローから、失敗すると誰の何が損なわれるか(Why)を引き継ぎ、処理の境界・成功を認める保存状態・中断後に許す動作(What)を決め、整合・排他・保持・再開の方針(How)までを書く。フロー ID で受入条件・検証・未決事項を結ぶ(Trace)。
19
+
20
+ ## 2. 作成前に集める情報
21
+
22
+ | 項目 | 集める情報 | 取り出し元 |
23
+ | ---------------- | -------------------------------------------- | ---------------------------- |
24
+ | 対象者と損失 | 失敗で誰が何をやり直し、何が残るか | 業務フロー、プロジェクト概要 |
25
+ | 境界と識別子 | 内外の境界と、要求・受付・完了の識別キー | システム設計索引、連携契約 |
26
+ | 状態と権限 | 再実行・取消・承認の意味と、それを判断する人 | 状態遷移仕様、判断記録 |
27
+ | 上限と設定の所在 | 上限と優先順位の正本 | 実装・設定の担当への確認 |
28
+ | 検証と復旧の実績 | 既存のテスト・復旧手順と未整備のもの | テスト担当・運用担当への確認 |
29
+
30
+ ## 3. 全体の作成手順
31
+
32
+ 1. 概要で入口・出口・対象外を決める。これが事故候補を比べる範囲になる。
33
+ 2. 一覧で事故候補を利用者の損失で比べる。候補が多ければ、同じ事故を防ぐ候補をまとめる。
34
+ 3. フロー詳細で、成功の確定点を先に置き、そこへ至る処理・保存先・識別子を図にする。確定点が先にないと、図が通常処理の説明になる。
35
+ 4. 各保存点の直前・直後で止めた場合の残存状態と次の手を決める。
36
+ 5. 観測性と運用連携で、機械が検出する条件と人間が対応する責任を分ける。
37
+ 6. 最後に関連ドキュメント導線で、正本への参照と変更の波及をつなぐ。足りない根拠は未決事項にする。
38
+
39
+ ## 4. 各章の書き方
40
+
41
+ ### 4.1. 概要
42
+
43
+ 問い:
44
+
45
+ - どの操作からどの業務結果までを扱い、通常処理を外した理由は何か。
46
+ - 公開版に、実行記録や個人を識別できる情報が紛れていないか。
47
+
48
+ コツ:
49
+
50
+ - 状態用語や対象者の説明を写したくなったら、業務フロー・状態遷移仕様への参照に置き換える。
51
+ - 根拠が廃止済みの文書だけなら、現行仕様との照合を未決事項にする。
52
+
53
+ ### 4.2. 重要フロー一覧
54
+
55
+ 問い:
56
+
57
+ - 放置すると誰の何が壊れ、成功すればどの負荷が減るか。
58
+ - その損失は、ほかの候補より重いか。
59
+
60
+ コツ:
61
+
62
+ - 対象者・事故・影響・効果を 1 行で言えない候補は、まだ詳細へ進めない。
63
+
64
+ ### 4.3. フロー詳細
65
+
66
+ 問い:
67
+
68
+ - どの記録が残れば成功と言えるか。
69
+ - 応答を失った後の再送で、二度目の副作用が起きないか。取り消せないなら、何を保持して誰が照合するか。
70
+
71
+ コツ:
72
+
73
+ - 処理主体と保存先を分け、境界を越える要求と応答を同じ識別子で追うと、受付と完了の取り違えが見つかる。
74
+
75
+ ### 4.4. 観測性と運用連携
76
+
77
+ 問い:
78
+
79
+ - 同じ処理を内外でどのキーで照合するか。trace を渡せない境界では何で追うか。
80
+ - 検知の後、誰が何を止め、どこへ相談するか。
81
+
82
+ コツ:
83
+
84
+ - 閾値を使うなら測定元と判定時点を正本に聞く。未決なら未決事項にし、無通知でよいとは書かない。
85
+
86
+ ### 4.5. 関連ドキュメント導線
87
+
88
+ 問い:
89
+
90
+ - どの設定とテスト・復旧手順を読めば、成功条件を再現できるか。
91
+ - フローの変更で、契約・保存済みの記録・CLI のどれに影響が及ぶか。
92
+
93
+ コツ:
94
+
95
+ - 設定値やテストの手順は写さず、所在への参照に置き換える。
96
+
97
+ ## 5. 深掘り手順
98
+
99
+ 内容が浅いときは、次の順で対応のない主張を探す。
100
+
101
+ 1. 「再試行」「再開」の箇所ごとに、受付前・受付後・保存後で結果が変わらないかを確かめる。
102
+ 2. 図の非同期の境界で応答を失った場合を追い、照合キーと保存記録が両側に残るかを確かめる。
103
+ 3. 同じ ID を二つの実行へ与え、排他や重複排除が副作用を守るかを問い直す。
104
+ 4. 設定値の参照を辿り、条件を一意に解決できなければ未決事項へ移す。
105
+ 5. 成功条件ごとに検証・運用の担当へ渡せるかを確かめ、対応しない説明を削る。
106
+
107
+ ## 6. 良い例 / 悪い例
108
+
109
+ | 観点 | 良い例 | 悪い例 |
110
+ | ---- | ---------------------------------------------------------------------- | --------------------------------- |
111
+ | 選定 | 「応答欠落後の再送が店番の二重売上照合を増やすため、閲覧より優先する」 | 「複雑なので High」 |
112
+ | 失敗 | 「受付結果が不明なら同じ取引 ID と控えで照合し、未受付と確かめて再送」 | 「timeout なら retry」 |
113
+ | 補償 | 受付済みの売上を保持し、返品の判断を店主へ渡す | 失敗表示なら取引記録を削除する |
114
+ | 責任 | 「重複を検出して停止し、OPS が取引 ID で外部受付と控えを照合する」 | 「runner が担当」 |
115
+ | 検証 | 「応答欠落のテストで売上一件と照合待ち表示を確かめる」 | 「テストファイルがあるので pass」 |
116
+ | 変更 | 受付契約の変更時に、旧控えからの照合と復旧手順を確かめる | 新形式で動けば完了とする |
117
+
118
+ ## 7. レビュー観点
119
+
120
+ | 観点 | 確認内容 |
121
+ | ---------- | -------------------------------------------------- |
122
+ | 価値と範囲 | 守る利用者・損失と、選んだフローが対応しているか |
123
+ | 機械と人間 | 機械の動作、人間の一次対応、照会先が分かれているか |
124
+
125
+ ## 8. 仕上げチェック
126
+
127
+ - 一覧の選定理由が、詳細の受入条件までたどれる。
128
+ - すべての成功経路に確定の記録があり、すべての失敗経路に保持状態と次の手がある。
129
+ - 未確認のテスト・復旧手順を、確認済みと書いていない。
@@ -0,0 +1,146 @@
1
+ ---
2
+ specdojo:
3
+ id: specdojo:sysd-cross-cutting-policy-recipe
4
+ type: recipe
5
+ status: ready
6
+ rulebook: specdojo:sysd-cross-cutting-policy-rulebook
7
+ sample: specdojo:sysd-cross-cutting-policy-sample
8
+ ---
9
+
10
+ # システム設計 / 横断ルール 作成レシピ
11
+
12
+ System Design Cross-cutting Policy Writing Recipe
13
+
14
+ 複数領域にまたがる失敗と回復を起点に、一般的な規約の列挙を、対象システムで判断に使える制約へ変えるための作り方を示す。
15
+
16
+ ## 1. このレシピの使い方
17
+
18
+ - 横断ルールは、設計索引と上位の価値から利用者・保守担当の困り事(Why)を引き継ぎ、それを防ぐ不変条件と適用境界(What)を定め、検証の入口と例外の復帰条件(How)を決める。各制約は Rule ID で検証結果と正本へたどれるようにする(Trace)。
19
+ - 「作成前に集める情報」をメモでそろえてから、「全体の作成手順」の順に書く。
20
+
21
+ ## 2. 作成前に集める情報
22
+
23
+ | 項目 | 集める情報 | 取り出し元 |
24
+ | -------- | ---------------------------------------------------------------------------- | -------------------------------- |
25
+ | 困り事 | 誰が何を引き継げず、どの失敗で費用・作業負荷が増えるか | 上位の価値・課題、障害の記録 |
26
+ | 実行経路 | CLI、API、ジョブ、生成、外部プロセス、保存先のどこが共通制約を持つか | システム設計索引 |
27
+ | 正本 | 値と構造を決める設定・schema・リファレンス、実在する検証コマンドと対象ケース | 実装担当への確認、リポジトリ |
28
+ | 途中状態 | 時間切れ・応答欠落・統合失敗の時点で、外部状態・ファイル・利用枠に何が残るか | 実装担当への確認、失敗注入の結果 |
29
+ | 観測 | 誰がどの証跡から対象の実行を特定し、停止と回復を判断するか | 運用担当への確認、ログの実例 |
30
+ | 不足 | 正本に値がない上限・優先順・通知先 | 確認の過程のメモ |
31
+
32
+ ## 3. 全体の作成手順
33
+
34
+ 1. 概要を最初に書き、対象の実行経路と対象外を決める。境界が決まらないと、ルールの抜けを判定できない。
35
+ 2. 代表的な途中失敗を 1 つずつ追い、各ルール詳細を書く。一覧から書くと、実装の説明を規則に見せかけやすい。
36
+ 3. 詳細がそろってから、同じ失敗を防ぐ制約をまとめてルール一覧を作る。
37
+ 4. 承認済みの逸脱だけを例外に分け、未承認の不適合と混ぜない。
38
+ 5. 一つの規則変更から実装・schema・生成物・回帰対象をたどり、関連導線を書く。
39
+ 6. 最後に、確認できない値や判断待ちを未決事項に分け、どの Rule の受入を止めるかを書く。
40
+
41
+ ## 4. 各章の書き方
42
+
43
+ ### 4.1. 概要
44
+
45
+ 問い:
46
+
47
+ - 共通規則がないと、誰が同じ調査や回復を繰り返すか。
48
+ - 安全な保存と速度などが競合したとき、何を先に守るか。
49
+
50
+ コツ:
51
+
52
+ - HTTP API や DB がなくても、CLI のエラーやファイル保存の途中状態で同じ責務が残る。技術の不在を対象外の理由にしない。
53
+ - 上位の価値や背景を写したくなったら、上位成果物への参照に置き換える。
54
+
55
+ ### 4.2. ルール一覧
56
+
57
+ 問い:
58
+
59
+ - 先に設定や契約を決めなければ確認できない規則はどれか。
60
+ - 要約と必須度を組み合わせて読んでも、意図が逆にならないか。
61
+
62
+ コツ:
63
+
64
+ - 構成上の実行経路を横に並べ、どの経路にも効く規則がない領域を探す。
65
+ - 規則を書いたことと実装済みの証拠を分けて聞く。照合していなければ未照合と書く。
66
+
67
+ ### 4.3. 各ルール詳細
68
+
69
+ 問い:
70
+
71
+ - 同じ入力と前提なら、次の動作と合否は一つに決まるか。
72
+ - 検証コマンドはそのリポジトリで実行でき、対象ケースへ到達するか。
73
+
74
+ コツ:
75
+
76
+ - 一つの途中失敗を、再試行・時間切れ・設定の競合・ログの欠落の順に追い、答えを適用境界と検証の説明に入れる。
77
+ - 上限値・設定キー・構文は写さず、正本への参照に置き換える。分からない値は推測で埋めず、実装担当に聞く。
78
+
79
+ ### 4.4. 例外
80
+
81
+ 問い:
82
+
83
+ - 一時的に許した逸脱か、既に起きた問題か、将来の懸念か。
84
+ - 期限が来たとき、どの検証で通常規則へ戻ったと判断するか。
85
+
86
+ コツ:
87
+
88
+ - 「緊急なら」など条件の広い許可を求められたら、対象の Rule と期限を具体的に聞き直す。
89
+
90
+ ### 4.5. 関連導線
91
+
92
+ 問い:
93
+
94
+ - 読む人はその参照で何を判断するか。
95
+ - schema を変えたとき、古い記録・生成物・CLI の利用者に何が起きるか。
96
+
97
+ コツ:
98
+
99
+ - 見出し・表・本文で同じ文書を同じ名称で呼ぶ。略号だけでは参照先を特定できない。
100
+ - 参照先が未作成なら未作成と書き、作成済みのように扱わない。
101
+
102
+ ### 4.6. 未決事項と公開条件
103
+
104
+ 問い:
105
+
106
+ - 不明な事実か、意思決定待ちか、仮定か。
107
+ - 解消しない間、どの Rule の受入を止めるか。
108
+
109
+ コツ:
110
+
111
+ - 不明は _TODO_、判断待ちは _UNDECIDED_、仮定は _ASSUMPTION_ で書き分ける。
112
+ - 未発行の作業 ID を、発行済みの証拠として数えない。
113
+
114
+ ## 5. 深掘り手順
115
+
116
+ 内容が浅いときは、次の順で対応のない主張を探す。
117
+
118
+ 1. 各 Rule が、概要のどの困り事を防ぐかを確かめ、対応のない実装解説を外す。
119
+ 2. 同じ失敗の再実行と並列の別実行を追い、識別・重複防止・時間上限・停止・観測が途切れる箇所を探す。
120
+ 3. 手段だけがあり、支える制約や防ぐ失敗を説明できない Enforcement を探す。
121
+ 4. 途切れた箇所の正本を確かめ、根拠がなければ固定値で穴を隠さず未決事項へ移す。
122
+
123
+ ## 6. 良い例 / 悪い例
124
+
125
+ | 観点 | 良い例 | 悪い例 |
126
+ | -------- | ------------------------------------------------------------- | -------------------------------------- |
127
+ | 対象範囲 | 「API はないが CLI の失敗記録を共通化し、再開対象を選べる」 | 「API がないのでエラー・監視は対象外」 |
128
+ | 冪等 | 同じ論理処理と attempt を区別し、保存・受付を照合して再開する | 同じファイル名へ書くので安全とする |
129
+ | 時間制御 | 上限到達では部分出力を保持して停止し、受付結果を照合して再開 | 「タイムアウトしたら再実行する」 |
130
+ | 設定 | 同じ項目の競合指定を与え、正本の優先順と反映時点を確かめる | 全項目で CLI が優先すると推測する |
131
+ | 実装状況 | 「未照合、設定確定後に失敗注入で確かめる」 | 規則を書いたので実装済みとする |
132
+
133
+ ## 7. レビュー観点
134
+
135
+ | 観点 | 確認内容 |
136
+ | ------------ | ---------------------------------------------------------------- |
137
+ | 目的との対応 | 各 Rule が概要の困り事につながり、個別機能の手順を抱えていないか |
138
+ | 合否の再現 | 正本・入力・期待結果がつながり、第三者が同じ判定を出せるか |
139
+ | 回復 | 途中状態から安全に再開でき、判断できなければ人へ情報を渡せるか |
140
+ | 変更の追従 | Rule の変更から、実装・schema・生成物・回帰対象をたどれるか |
141
+
142
+ ## 8. 仕上げチェック
143
+
144
+ - 各 Rule が概要の困り事に対応し、検証の入口と正本までたどれる。
145
+ - 同じ状態に異なる動作を求める Rule がない。
146
+ - 確認していない値や実装状況を、確認済みのように書いていない。
@@ -0,0 +1,141 @@
1
+ ---
2
+ specdojo:
3
+ id: specdojo:sysd-index-recipe
4
+ type: recipe
5
+ status: ready
6
+ rulebook: specdojo:sysd-index-rulebook
7
+ sample: specdojo:sysd-index-sample
8
+ ---
9
+
10
+ # システム設計索引 作成レシピ
11
+
12
+ System Design Index Writing Recipe
13
+
14
+ 変更する人が最初に直す正本と確かめ方を選べる索引の作り方を示す。
15
+
16
+ ## 1. このレシピの使い方
17
+
18
+ - 索引は、正本探しと二重更新(Why)に応え、設計領域ごとの正本・派生物・非該当・未確認(What)を定め、変更目的から更新先と検証へたどる経路(How)を示す。所在・更新責任・追従先は同じ行で結び付ける(Trace)。
19
+
20
+ ## 2. 作成前に集める情報
21
+
22
+ | 項目 | 集める情報 | 取り出し元 |
23
+ | -------- | ------------------------------------------------------ | --------------------------------- |
24
+ | 利用目的 | 誰がどの設計情報を探し、どの領域に困っているか | 開発担当・引継ぎを受けた担当 |
25
+ | 対象境界 | 対象システム、外部へ任せる部分、任意で使う構成 | システム概要・構成図 |
26
+ | 正本候補 | 値を変えるとき最初に編集するファイルと基準ディレクトリ | 各リポジトリの配置、開発担当 |
27
+ | 生成経路 | 生成の入力、script・サブコマンド、出力先 | `package.json` などの script 定義 |
28
+ | 確認経路 | 変更後に流す検査と対象ケース、観測できる結果 | テスト・CI の定義、品質担当 |
29
+ | 関連仕様 | 判断の根拠を持つ文書と、その現行・廃止状態 | 文書体系の一覧 |
30
+
31
+ ## 3. 全体の作成手順
32
+
33
+ 1. 概要に対象と対象外を書く。範囲が決まらないと、SSOT 一覧に載せる領域が決まらない。
34
+ 2. SSOT 一覧で、候補を正本・派生物・業務記録・未確認に仕分ける。
35
+ 3. 自動生成物で、正本から再生成できる入力と出力を一対にする。正本の後に書くと、生成物を正本に載せずに済む。
36
+ 4. 変更の入口で、代表的な変更を更新先から検証まで一度たどり、たどれない箇所は前の章で直す。
37
+ 5. 関連ドキュメント導線で、読み手が判断に使う文書だけを並べる。
38
+ 6. 途中でメモした未確認・未決を留保事項にまとめる。
39
+
40
+ ## 4. 各章の書き方
41
+
42
+ ### 4.1. 概要
43
+
44
+ 問い:
45
+
46
+ - どの利用者の、どの調査・引継ぎを助けるか。
47
+ - 対象外と、外部に任せる部分はどこか。
48
+
49
+ コツ:
50
+
51
+ - 範囲は機能や実行単位(CLI、日次処理など)で区切ると対象外が見える。外部に任せる部分は、連携の正本として残る。
52
+ - プロジェクトの背景は写さず、上位の文書への参照に置き換える。
53
+
54
+ ### 4.2. SSOT 一覧
55
+
56
+ 問い:
57
+
58
+ - 値を変えるとき、最初に編集するのはどのファイルか。
59
+ - 「なし」と書く領域は、構成上ないのか、まだ調べていないのか。
60
+
61
+ コツ:
62
+
63
+ - 開発担当に「この値を変えるとき最初にどこを開くか」と聞くと、派生物ではなく正本が出てくる。
64
+ - DB がない構成では保存形式と移行の契約が、監視では形式・通知を決める設定が抜けやすい。
65
+
66
+ ### 4.3. 自動生成物
67
+
68
+ 問い:
69
+
70
+ - 入力、コマンド、出力が実際につながっているか。
71
+ - 生成後にどこを見れば更新を確かめられるか。
72
+
73
+ コツ:
74
+
75
+ - 出力名からコマンドを推測しやすい。script 定義を開いて照合する。
76
+ - 実行結果を保持するファイルは、生成物に見えても業務記録として分ける。
77
+
78
+ ### 4.4. 変更の入口
79
+
80
+ 問い:
81
+
82
+ - この変更が起きたら、最初に何を変え、何が追従するか。
83
+ - どのケースを見れば、今回の変更を判定できるか。
84
+
85
+ コツ:
86
+
87
+ - 品質担当に「この変更で壊れやすいのはどこか」と聞くと、正常系以外のケースを選べる。
88
+ - これから行う確認と実行済みの証跡を混ぜやすい。
89
+
90
+ ### 4.5. 関連ドキュメント導線
91
+
92
+ 問い:
93
+
94
+ - 読み手はこの参照で何を判断するか。
95
+ - 未作成の文書は、当面どこを参照するか。
96
+
97
+ コツ:
98
+
99
+ - 略号だけで分類すると、同じ文書を別名で呼び分けやすい。参照目的で分ける。
100
+ - 同名・後継・廃止の文書を取り違えやすい。
101
+
102
+ ### 4.6. 留保事項
103
+
104
+ 問い:
105
+
106
+ - 不明な事実、意思決定待ち、仮定のどれか。
107
+ - 解消したら、どの行・設定・手順へ反映するか。
108
+
109
+ コツ:
110
+
111
+ - 実装が動いたことと、未整備の監視を残したまま使えるかは別の論点として分ける。
112
+
113
+ ## 5. 深掘り手順
114
+
115
+ 内容が浅いときは、次の順で対応のない主張を探す。
116
+
117
+ 1. 変更の入口の各行が、どの正本から始まり、どの検証で終わるかを確かめる。欠ける行は留保事項へ移す。
118
+ 2. 非該当の行ごとに、代わりの保存・連携・観測の手段が残っているかを確かめる。
119
+ 3. 自動生成物の各行の入力が、SSOT 一覧の正本にあるかを確かめる。ない行は正本か業務記録かを見直す。
120
+
121
+ ## 6. 良い例 / 悪い例
122
+
123
+ | 観点 | 良い例 | 悪い例 |
124
+ | ---------- | ---------------------------------------------------------------- | ------------------------------------- |
125
+ | パスの解釈 | 複数リポジトリの入力・出力に、それぞれの基準ディレクトリを添える | 同名の `src/` を基準なしで並べる |
126
+ | 検証の範囲 | 「二つの実行が別の保存先を使うことを、分離テストで確かめる」 | 「代表実行が成功したので分離も確認」 |
127
+ | 検証の段階 | CI の検査成功と、実機での確認が未実施であることを分けて書く | CI が成功したので運用も確認済みとする |
128
+
129
+ ## 7. レビュー観点
130
+
131
+ | 観点 | 確認内容 |
132
+ | -------- | ---------------------------------------------------------- |
133
+ | 所在 | 初めて読む開発担当が、派生物ではなく正本を選べるか |
134
+ | 検証経路 | 品質担当が、コマンド・対象ケース・期待結果を一組で選べるか |
135
+ | 委譲 | 値・電文・設定の中身を写さず、正本への導線だけを置いたか |
136
+
137
+ ## 8. 仕上げチェック
138
+
139
+ - 非該当の行に、代わりの手段か、代わりが要らない理由がある。
140
+ - 未確認の領域を確定情報にしていない。
141
+ - 実在しない文書やコマンドを現行の導線にしていない。