specdojo 0.6.0 → 0.8.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (366) hide show
  1. package/.github/agents/specdojo-orchestrator.md +3 -2
  2. package/CHANGELOG.md +193 -0
  3. package/README.md +2 -2
  4. package/dist/catalog/build.js +24 -1
  5. package/dist/catalog/plan.js +1 -1
  6. package/dist/catalog/scaffold.js +4 -1
  7. package/dist/commands/agent.js +33 -0
  8. package/dist/commands/init.js +6 -1
  9. package/dist/commands/night-orchestrator.js +6 -4
  10. package/dist/commands/orchestrator.js +10 -1
  11. package/dist/dashboard/dashboard-timeline.js +18 -16
  12. package/dist/dashboard/dashboard.js +612 -259
  13. package/dist/dashboard/epic-plan.js +81 -0
  14. package/dist/dashboard/exec-records.js +16 -20
  15. package/dist/dashboard/routines.js +8 -6
  16. package/dist/dashboard/timeline-build.js +5 -9
  17. package/dist/dashboard/timeline.js +9 -4
  18. package/dist/devcontainer/command.js +18 -0
  19. package/dist/devcontainer/host-script.js +21 -0
  20. package/dist/devcontainer/scaffold.js +22 -3
  21. package/dist/docs/frontmatter-namespace.js +1 -48
  22. package/dist/docs/yaml-pages.js +125 -3
  23. package/dist/exec/agent-config.js +22 -0
  24. package/dist/exec/agent-plan.js +3 -2
  25. package/dist/exec/antigravity-session.js +154 -0
  26. package/dist/exec/commands.js +69 -21
  27. package/dist/exec/commit-hook-skips.js +78 -0
  28. package/dist/exec/core.js +19 -7
  29. package/dist/exec/events.js +159 -8
  30. package/dist/exec/evidence.js +64 -16
  31. package/dist/exec/handoff.js +9 -13
  32. package/dist/exec/limit.js +1 -1
  33. package/dist/exec/mechanical-result.js +45 -0
  34. package/dist/exec/migrate-records.js +249 -0
  35. package/dist/exec/parent-validation.js +160 -12
  36. package/dist/exec/pipeline-state.js +27 -5
  37. package/dist/exec/plan-markdownlint.js +89 -0
  38. package/dist/exec/plans-condense-findings.js +89 -0
  39. package/dist/exec/plans-core.js +24 -17
  40. package/dist/exec/plans-generation.js +52 -25
  41. package/dist/exec/plans-grade-findings.js +8 -3
  42. package/dist/exec/plans-kata-findings.js +61 -0
  43. package/dist/exec/plans-planning.js +3 -3
  44. package/dist/exec/plans-storage.js +12 -24
  45. package/dist/exec/register-resume.js +69 -42
  46. package/dist/exec/register.js +26 -22
  47. package/dist/exec/repo-integration-sync.js +8 -4
  48. package/dist/exec/repo-integration.js +21 -1
  49. package/dist/exec/reporter.js +121 -23
  50. package/dist/exec/results.js +85 -24
  51. package/dist/exec/review-completion.js +47 -0
  52. package/dist/exec/review-kata.js +109 -0
  53. package/dist/exec/run/agent-pipeline.js +75 -6
  54. package/dist/exec/run/agent.js +20 -7
  55. package/dist/exec/run/in-place.js +69 -32
  56. package/dist/exec/run/job.js +81 -24
  57. package/dist/exec/run/lifecycle-commands.js +264 -43
  58. package/dist/exec/run/mode-shared.js +11 -3
  59. package/dist/exec/run/register-command.js +12 -10
  60. package/dist/exec/run/register-core.js +20 -13
  61. package/dist/exec/run/register-mode.js +12 -12
  62. package/dist/exec/run/register-post-review.js +21 -9
  63. package/dist/exec/run/register-resume.js +28 -18
  64. package/dist/exec/run/register-state.js +10 -7
  65. package/dist/exec/run/register-worktree.js +60 -30
  66. package/dist/exec/run/schedule-mode.js +26 -6
  67. package/dist/exec/run/schedule-prepare.js +228 -45
  68. package/dist/exec/run/schedule-task.js +132 -25
  69. package/dist/exec/run/shared.js +4 -3
  70. package/dist/exec/run/trailing-records.js +35 -0
  71. package/dist/exec/run-records.js +2 -0
  72. package/dist/exec/strategy.js +1 -0
  73. package/dist/exec/trailing-records.js +242 -0
  74. package/dist/exec/trial-commands.js +3 -2
  75. package/dist/exec/validate-records-commit.js +110 -0
  76. package/dist/exec/validate-records.js +148 -0
  77. package/dist/exec/worktree-command.js +29 -16
  78. package/dist/exec/worktree-ops-commit.js +118 -59
  79. package/dist/exec/worktree-ops-lifecycle.js +77 -44
  80. package/dist/exec/worktree-ops-merge.js +13 -2
  81. package/dist/exec/worktree-ops.js +2 -2
  82. package/dist/exec/worktree.js +19 -2
  83. package/dist/grade/apply.js +32 -6
  84. package/dist/grade/command-inspect.js +2 -2
  85. package/dist/grade/command-run.js +2 -0
  86. package/dist/grade/command-shared.js +1 -1
  87. package/dist/grade/core.js +18 -5
  88. package/dist/grade/markdown.js +3 -3
  89. package/dist/grade/pipeline-state.js +15 -11
  90. package/dist/grade/plan.js +37 -17
  91. package/dist/grade/result.js +3 -3
  92. package/dist/grade/run.js +23 -3
  93. package/dist/grade/target-discovery.js +17 -4
  94. package/dist/grade/targets.js +12 -11
  95. package/dist/job/job.js +31 -17
  96. package/dist/job/noop.js +104 -0
  97. package/dist/register/core.js +2 -0
  98. package/dist/register/create-commands.js +28 -3
  99. package/dist/register/deliverable-target.js +9 -1
  100. package/dist/register/epic.js +104 -26
  101. package/dist/register/event-merge.js +3 -0
  102. package/dist/register/events.js +4 -0
  103. package/dist/register/external-project.js +3 -0
  104. package/dist/register/item.js +6 -0
  105. package/dist/register/maintenance-commands.js +4 -1
  106. package/dist/register/planning.js +7 -14
  107. package/dist/register/register.js +74 -32
  108. package/dist/register/track-domains.js +34 -0
  109. package/dist/register/track-plan.js +78 -0
  110. package/dist/register/transition-commands.js +8 -0
  111. package/dist/register/work-table.js +64 -0
  112. package/dist/review/grade.js +35 -13
  113. package/dist/routine/definition.js +4 -3
  114. package/dist/routine/failure.js +30 -0
  115. package/dist/routine/routine.js +56 -32
  116. package/dist/routine/storage.js +33 -0
  117. package/dist/schedule/schedule.js +1 -0
  118. package/dist/schedule/strategy-generate-document.js +26 -14
  119. package/dist/schedule/strategy-generate-scope.js +17 -45
  120. package/dist/schedule/strategy-generate.js +33 -3
  121. package/dist/schedule/strategy-profiles.js +86 -12
  122. package/dist/shared/agent-types.js +2 -0
  123. package/dist/shared/condense-records.js +25 -0
  124. package/dist/shared/deprecation.js +8 -0
  125. package/dist/shared/document-metadata.js +20 -0
  126. package/dist/shared/finding-cause.js +20 -0
  127. package/dist/shared/frontmatter-namespace.js +48 -0
  128. package/dist/shared/git.js +149 -15
  129. package/dist/shared/grade-result.js +17 -1
  130. package/dist/shared/local-state.js +20 -0
  131. package/dist/shared/markdownlint-config.js +8 -3
  132. package/dist/shared/plan-conventions.js +129 -0
  133. package/dist/shared/plan-templates.js +57 -41
  134. package/dist/shared/provider-scaffold.js +2 -0
  135. package/dist/shared/run-records.js +224 -0
  136. package/dist/shared/specdojo-config.js +39 -21
  137. package/dist/shared/specdojo-gitignore.js +1 -0
  138. package/dist/shared/text.js +65 -5
  139. package/dist/shared/timeline-index.js +2 -0
  140. package/docs/ja/specdojo/defaults/pm-review-viewpoints.yaml +11 -2
  141. package/docs/ja/specdojo/exec-templates/xep-common-conventions-template.md +4 -74
  142. package/docs/ja/specdojo/exec-templates/xep-condense-template.md +50 -0
  143. package/docs/ja/specdojo/exec-templates/xep-draft-template.md +17 -5
  144. package/docs/ja/specdojo/exec-templates/xep-fully-guided-template.md +16 -3
  145. package/docs/ja/specdojo/exec-templates/xep-recipe-guided-template.md +15 -5
  146. package/docs/ja/specdojo/exec-templates/xep-recipe-maintenance-template.md +6 -0
  147. package/docs/ja/specdojo/exec-templates/xep-register-template.md +1 -1
  148. package/docs/ja/specdojo/exec-templates/xep-rulebook-maintenance-template.md +6 -0
  149. package/docs/ja/specdojo/exec-templates/xep-sample-maintenance-template.md +6 -0
  150. package/docs/ja/specdojo/exec-templates/xep-template-maintenance-template.md +6 -0
  151. package/docs/ja/specdojo/exec-templates/xer-condense-template.md +25 -0
  152. package/docs/ja/specdojo/exec-templates/xp-common-conventions-template.md +50 -0
  153. package/docs/ja/specdojo/exec-templates/xrp-common-conventions-template.md +30 -0
  154. package/docs/ja/specdojo/guides/branch-workflow-guide.md +1 -1
  155. package/docs/ja/specdojo/guides/docs-editing-guide.md +48 -0
  156. package/docs/ja/specdojo/guides/docs-structure-guide.md +48 -15
  157. package/docs/ja/specdojo/guides/exec-config-guide.md +61 -28
  158. package/docs/ja/specdojo/guides/exec-operation-guide.md +61 -13
  159. package/docs/ja/specdojo/guides/exec-worktree-guide.md +20 -11
  160. package/docs/ja/specdojo/guides/orchestrator-operation-guide.md +4 -2
  161. package/docs/ja/specdojo/guides/plan-result-lifecycle-guide.md +92 -55
  162. package/docs/ja/specdojo/guides/project-move-guide.md +381 -0
  163. package/docs/ja/specdojo/guides/quick-start-guide.md +589 -807
  164. package/docs/ja/specdojo/guides/register-operation-guide.md +26 -4
  165. package/docs/ja/specdojo/guides/remote-host-development-guide.md +33 -4
  166. package/docs/ja/specdojo/guides/review-guide.md +22 -19
  167. package/docs/ja/specdojo/guides/routine-operation-guide.md +14 -8
  168. package/docs/ja/specdojo/guides/ryu-guide.md +23 -13
  169. package/docs/ja/specdojo/guides/schedule-design-guide.md +7 -4
  170. package/docs/ja/specdojo/guides/schedule-operation-guide.md +41 -3
  171. package/docs/ja/specdojo/guides/specdojo-overview-guide.md +5 -4
  172. package/docs/ja/specdojo/guides/timeline-design-guide.md +27 -144
  173. package/docs/ja/specdojo/guides/use-case-guide.md +471 -74
  174. package/docs/ja/specdojo/recipes/bac-recipe.md +94 -0
  175. package/docs/ja/specdojo/recipes/bes-recipe.md +105 -0
  176. package/docs/ja/specdojo/recipes/br-recipe.md +84 -0
  177. package/docs/ja/specdojo/recipes/cdfd-overview-recipe.md +88 -86
  178. package/docs/ja/specdojo/recipes/cdfd-uc-recipe.md +108 -122
  179. package/docs/ja/specdojo/recipes/cnd-recipe.md +125 -0
  180. package/docs/ja/specdojo/recipes/cpd-recipe.md +126 -0
  181. package/docs/ja/specdojo/recipes/cxd-recipe.md +145 -0
  182. package/docs/ja/specdojo/recipes/ifd-recipe.md +134 -0
  183. package/docs/ja/specdojo/recipes/ifx-cmd-recipe.md +135 -86
  184. package/docs/ja/specdojo/recipes/ifx-index-recipe.md +130 -0
  185. package/docs/ja/specdojo/recipes/pm-organization-recipe.md +29 -26
  186. package/docs/ja/specdojo/recipes/pm-plan-recipe.md +35 -26
  187. package/docs/ja/specdojo/recipes/pm-quality-management-plan-recipe.md +38 -28
  188. package/docs/ja/specdojo/recipes/pm-raci-recipe.md +39 -31
  189. package/docs/ja/specdojo/recipes/pm-roles-recipe.md +26 -28
  190. package/docs/ja/specdojo/recipes/prj-assumptions-constraints-dependencies-recipe.md +10 -8
  191. package/docs/ja/specdojo/recipes/prj-comparison-of-alternatives-recipe.md +18 -17
  192. package/docs/ja/specdojo/recipes/stsd-recipe.md +100 -62
  193. package/docs/ja/specdojo/recipes/sysd-critical-flows-recipe.md +106 -0
  194. package/docs/ja/specdojo/recipes/sysd-cross-cutting-policy-recipe.md +137 -0
  195. package/docs/ja/specdojo/recipes/sysd-index-recipe.md +122 -0
  196. package/docs/ja/specdojo/references/command-reference.md +146 -99
  197. package/docs/ja/specdojo/references/deliverables-reference.md +9 -4
  198. package/docs/ja/specdojo/references/directory-layout-reference.md +3 -2
  199. package/docs/ja/specdojo/references/specdojo-config-reference.md +17 -16
  200. package/docs/ja/specdojo/rulebooks/bac-rulebook.md +72 -290
  201. package/docs/ja/specdojo/rulebooks/bdd-rulebook.md +212 -79
  202. package/docs/ja/specdojo/rulebooks/bds-rulebook.md +138 -154
  203. package/docs/ja/specdojo/rulebooks/bes-index-rulebook.md +147 -59
  204. package/docs/ja/specdojo/rulebooks/bes-rulebook.md +100 -96
  205. package/docs/ja/specdojo/rulebooks/br-rulebook.md +88 -108
  206. package/docs/ja/specdojo/rulebooks/ccd-mermaid-rulebook.md +126 -211
  207. package/docs/ja/specdojo/rulebooks/cdfd-d2-rulebook.md +367 -0
  208. package/docs/ja/specdojo/rulebooks/cdfd-mermaid-rulebook.md +6 -5
  209. package/docs/ja/specdojo/rulebooks/cdfd-overview-rulebook.md +96 -100
  210. package/docs/ja/specdojo/rulebooks/cdfd-rulebook.md +38 -47
  211. package/docs/ja/specdojo/rulebooks/cdfd-uc-rulebook.md +132 -106
  212. package/docs/ja/specdojo/rulebooks/cdsd-rulebook.md +102 -68
  213. package/docs/ja/specdojo/rulebooks/cdt-rulebook.md +152 -0
  214. package/docs/ja/specdojo/rulebooks/cld-rulebook.md +9 -184
  215. package/docs/ja/specdojo/rulebooks/clis-rulebook.md +187 -0
  216. package/docs/ja/specdojo/rulebooks/cnd-rulebook.md +93 -247
  217. package/docs/ja/specdojo/rulebooks/cpd-rulebook.md +104 -241
  218. package/docs/ja/specdojo/rulebooks/cxd-rulebook.md +124 -257
  219. package/docs/ja/specdojo/rulebooks/dct-index-rulebook.md +87 -98
  220. package/docs/ja/specdojo/rulebooks/dct-rulebook.md +9 -7
  221. package/docs/ja/specdojo/rulebooks/dec-rulebook.md +2 -1
  222. package/docs/ja/specdojo/rulebooks/dss-rulebook.md +193 -0
  223. package/docs/ja/specdojo/rulebooks/gl-rulebook.md +100 -54
  224. package/docs/ja/specdojo/rulebooks/ifd-mermaid-rulebook.md +69 -252
  225. package/docs/ja/specdojo/rulebooks/ifx-cmd-rulebook.md +91 -76
  226. package/docs/ja/specdojo/rulebooks/ifx-file-rulebook.md +252 -226
  227. package/docs/ja/specdojo/rulebooks/ifx-index-rulebook.md +118 -40
  228. package/docs/ja/specdojo/rulebooks/imp-business-rulebook.md +11 -11
  229. package/docs/ja/specdojo/rulebooks/imp-data-rulebook.md +9 -9
  230. package/docs/ja/specdojo/rulebooks/imp-interface-rulebook.md +4 -4
  231. package/docs/ja/specdojo/rulebooks/imp-operations-rulebook.md +11 -11
  232. package/docs/ja/specdojo/rulebooks/imp-test-rulebook.md +11 -11
  233. package/docs/ja/specdojo/rulebooks/mm-rulebook.md +4 -3
  234. package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +34 -29
  235. package/docs/ja/specdojo/rulebooks/pm-change-request-log-rulebook.md +8 -8
  236. package/docs/ja/specdojo/rulebooks/pm-issue-log-rulebook.md +2 -2
  237. package/docs/ja/specdojo/rulebooks/pm-organization-rulebook.md +50 -56
  238. package/docs/ja/specdojo/rulebooks/pm-plan-rulebook.md +46 -55
  239. package/docs/ja/specdojo/rulebooks/pm-quality-management-plan-rulebook.md +57 -54
  240. package/docs/ja/specdojo/rulebooks/pm-raci-rulebook.md +50 -65
  241. package/docs/ja/specdojo/rulebooks/pm-risk-register-rulebook.md +2 -2
  242. package/docs/ja/specdojo/rulebooks/pm-roles-rulebook.md +70 -97
  243. package/docs/ja/specdojo/rulebooks/pr-rulebook.md +2 -1
  244. package/docs/ja/specdojo/rulebooks/prj-assumptions-constraints-dependencies-rulebook.md +47 -56
  245. package/docs/ja/specdojo/rulebooks/prj-comparison-of-alternatives-rulebook.md +61 -135
  246. package/docs/ja/specdojo/rulebooks/sf-index-rulebook.md +116 -32
  247. package/docs/ja/specdojo/rulebooks/sf-rulebook.md +118 -61
  248. package/docs/ja/specdojo/rulebooks/sld-rulebook.md +152 -57
  249. package/docs/ja/specdojo/rulebooks/stsd-mermaid-rulebook.md +51 -39
  250. package/docs/ja/specdojo/rulebooks/stsd-rulebook.md +101 -46
  251. package/docs/ja/specdojo/rulebooks/sysd-critical-flows-rulebook.md +72 -329
  252. package/docs/ja/specdojo/rulebooks/sysd-cross-cutting-policy-rulebook.md +74 -263
  253. package/docs/ja/specdojo/rulebooks/sysd-index-rulebook.md +78 -195
  254. package/docs/ja/specdojo/rulebooks/tml-rulebook.md +4 -9
  255. package/docs/ja/specdojo/rulebooks/trc-requirements-to-specs-rulebook.md +3 -4
  256. package/docs/ja/specdojo/rulebooks/trc-requirements-to-tests-rulebook.md +3 -3
  257. package/docs/ja/specdojo/rulebooks/uis-rulebook.md +140 -143
  258. package/docs/ja/specdojo/samples/bac-sample.md +106 -21
  259. package/docs/ja/specdojo/samples/bdd-sample.yaml +143 -35
  260. package/docs/ja/specdojo/samples/bds-sample.md +100 -21
  261. package/docs/ja/specdojo/samples/bes-index-sample.md +59 -20
  262. package/docs/ja/specdojo/samples/bes-sample.md +80 -21
  263. package/docs/ja/specdojo/samples/br-sample.md +68 -14
  264. package/docs/ja/specdojo/samples/ccd-sample.md +81 -19
  265. package/docs/ja/specdojo/samples/cdfd-overview-sample.md +248 -140
  266. package/docs/ja/specdojo/samples/cdfd-sample.md +172 -99
  267. package/docs/ja/specdojo/samples/cdfd-uc-sample.md +130 -97
  268. package/docs/ja/specdojo/samples/cdsd-sample.md +89 -20
  269. package/docs/ja/specdojo/samples/cdt-sample.md +116 -0
  270. package/docs/ja/specdojo/samples/cld-sample.md +3 -30
  271. package/docs/ja/specdojo/samples/clis-sample.md +132 -0
  272. package/docs/ja/specdojo/samples/cnd-sample.md +127 -21
  273. package/docs/ja/specdojo/samples/cpd-sample.md +136 -22
  274. package/docs/ja/specdojo/samples/cxd-sample.md +108 -22
  275. package/docs/ja/specdojo/samples/dct-index-sample.yaml +63 -17
  276. package/docs/ja/specdojo/samples/dss-sample.md +175 -0
  277. package/docs/ja/specdojo/samples/gl-sample.yaml +50 -14
  278. package/docs/ja/specdojo/samples/ifd-sample.md +105 -21
  279. package/docs/ja/specdojo/samples/ifx-cmd-sample.yaml +91 -60
  280. package/docs/ja/specdojo/samples/ifx-file-sample.md +462 -21
  281. package/docs/ja/specdojo/samples/ifx-index-sample.yaml +87 -19
  282. package/docs/ja/specdojo/samples/pm-members-sample.yaml +37 -13
  283. package/docs/ja/specdojo/samples/pm-organization-sample.md +52 -20
  284. package/docs/ja/specdojo/samples/pm-plan-sample.md +84 -26
  285. package/docs/ja/specdojo/samples/pm-quality-management-plan-sample.md +55 -22
  286. package/docs/ja/specdojo/samples/pm-raci-sample.md +69 -28
  287. package/docs/ja/specdojo/samples/pm-roles-sample.yaml +13 -12
  288. package/docs/ja/specdojo/samples/prj-assumptions-constraints-dependencies-sample.md +50 -26
  289. package/docs/ja/specdojo/samples/prj-comparison-of-alternatives-sample.md +89 -62
  290. package/docs/ja/specdojo/samples/sf-index-sample.md +89 -20
  291. package/docs/ja/specdojo/samples/sf-sample.md +121 -21
  292. package/docs/ja/specdojo/samples/sld-sample.md +107 -21
  293. package/docs/ja/specdojo/samples/stsd-sample.md +54 -26
  294. package/docs/ja/specdojo/samples/sysd-critical-flows-sample.md +166 -21
  295. package/docs/ja/specdojo/samples/sysd-cross-cutting-policy-sample.md +178 -21
  296. package/docs/ja/specdojo/samples/sysd-index-sample.md +82 -21
  297. package/docs/ja/specdojo/samples/tml-sample.yaml +4 -1
  298. package/docs/ja/specdojo/samples/uis-sample.md +164 -20
  299. package/docs/ja/specdojo/standards/document-metadata-standard.md +33 -4
  300. package/docs/ja/specdojo/standards/id-and-file-naming-standard.md +3 -1
  301. package/docs/ja/specdojo/standards/rulebook-authoring-standard.md +1 -0
  302. package/docs/ja/specdojo/templates/bac-template.md +76 -0
  303. package/docs/ja/specdojo/templates/bes-template.md +56 -0
  304. package/docs/ja/specdojo/templates/br-template.md +64 -0
  305. package/docs/ja/specdojo/templates/cdfd-overview-template.md +161 -83
  306. package/docs/ja/specdojo/templates/cdfd-template.md +81 -54
  307. package/docs/ja/specdojo/templates/cdfd-uc-template.md +130 -89
  308. package/docs/ja/specdojo/templates/cnd-template.md +137 -0
  309. package/docs/ja/specdojo/templates/cpd-template.md +129 -0
  310. package/docs/ja/specdojo/templates/cxd-template.md +105 -0
  311. package/docs/ja/specdojo/templates/dct-data-model-cdt-template.yaml +40 -0
  312. package/docs/ja/specdojo/templates/dct-data-model-cld-template.yaml +7 -14
  313. package/docs/ja/specdojo/templates/dct-index-template.md +9 -20
  314. package/docs/ja/specdojo/templates/dct-project-management-template.yaml +5 -1
  315. package/docs/ja/specdojo/templates/ifd-template.md +86 -0
  316. package/docs/ja/specdojo/templates/ifx-cmd-template.yaml +44 -28
  317. package/docs/ja/specdojo/templates/ifx-index-template.yaml +40 -0
  318. package/docs/ja/specdojo/templates/opr-template.md +2 -4
  319. package/docs/ja/specdojo/templates/pm-organization-template.md +9 -3
  320. package/docs/ja/specdojo/templates/pm-plan-template.md +4 -4
  321. package/docs/ja/specdojo/templates/pm-quality-management-plan-template.md +17 -9
  322. package/docs/ja/specdojo/templates/pm-raci-template.md +24 -13
  323. package/docs/ja/specdojo/templates/pm-roles-template.yaml +3 -2
  324. package/docs/ja/specdojo/templates/prj-assumptions-constraints-dependencies-template.md +6 -3
  325. package/docs/ja/specdojo/templates/prj-comparison-of-alternatives-template.md +22 -19
  326. package/docs/ja/specdojo/templates/stsd-template.md +46 -21
  327. package/docs/ja/specdojo/templates/sysd-critical-flows-template.md +94 -0
  328. package/docs/ja/specdojo/templates/sysd-cross-cutting-policy-template.md +122 -0
  329. package/docs/ja/specdojo/templates/sysd-index-template.md +89 -0
  330. package/docs/specdojo/lib/yaml-metadata.cjs +7 -0
  331. package/docs/specdojo/schemas/v1/bdd.schema.yaml +25 -57
  332. package/docs/specdojo/schemas/v1/condense-records.schema.yaml +26 -0
  333. package/docs/specdojo/schemas/v1/dct.schema.yaml +10 -0
  334. package/docs/specdojo/schemas/v1/deliverable-frontmatter.schema.yaml +3 -0
  335. package/docs/specdojo/schemas/v1/esil.schema.yaml +7 -141
  336. package/docs/specdojo/schemas/v1/exec-common.schema.yaml +3 -0
  337. package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +54 -3
  338. package/docs/specdojo/schemas/v1/exec-evidence.schema.yaml +3 -0
  339. package/docs/specdojo/schemas/v1/exec-plan-frontmatter.schema.yaml +14 -0
  340. package/docs/specdojo/schemas/v1/exec-result-frontmatter.schema.yaml +18 -0
  341. package/docs/specdojo/schemas/v1/finding-cause.schema.yaml +22 -0
  342. package/docs/specdojo/schemas/v1/grade-pipeline-state.schema.yaml +1 -1
  343. package/docs/specdojo/schemas/v1/grade-result.schema.yaml +2 -0
  344. package/docs/specdojo/schemas/v1/ifx-cmd.schema.yaml +65 -5
  345. package/docs/specdojo/schemas/v1/ifx-index.schema.yaml +142 -0
  346. package/docs/specdojo/schemas/v1/register-events.schema.yaml +2 -0
  347. package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +17 -1
  348. package/docs/specdojo/schemas/v1/specdojo-config.schema.yaml +1 -0
  349. package/package.json +6 -3
  350. package/templates/antigravity/README.md +19 -46
  351. package/templates/antigravity/exec-defaults-snippet.yaml +5 -6
  352. package/templates/antigravity/orchestrator.md +3 -2
  353. package/templates/antigravity/settings.edit.json +73 -0
  354. package/templates/antigravity/settings.orchestrator.json +15 -0
  355. package/templates/antigravity/settings.report.json +7 -0
  356. package/templates/antigravity/settings.review.json +7 -0
  357. package/templates/claude/agents/specdojo-orchestrator.md +3 -2
  358. package/templates/codex/agents/specdojo-orchestrator.toml +3 -2
  359. package/templates/codex/orchestrator.md +3 -2
  360. package/templates/devcontainer/remote-host/devcontainer-tmux.sh +217 -0
  361. package/templates/devcontainer/remote-host/specdojo-tmux.sh.sample +8 -96
  362. package/templates/devcontainer/remote-host/ssh-config.sample +3 -1
  363. package/templates/devcontainer/tmux.conf +6 -0
  364. package/templates/init-agent-members.yaml +1 -0
  365. package/templates/init-exec-defaults.yaml +1 -1
  366. package/templates/opencode/agents/specdojo-orchestrator.md +3 -2
@@ -18,7 +18,7 @@ Project Role Definition Writing Recipe
18
18
  - 最初に、組織定義から採用する責務語彙、最終判断の集約先、公開方針を確認する。
19
19
  - 次に、`pm-roles.yaml` に列挙する Role code を、Schedule の `owner` や RACI の列として使える粒度で整理する。
20
20
  - 最後に、member nickname、agent 名、個人名、兼務割り当てを混ぜず、プロジェクト固有メモだけを残す。
21
- - schema にないメタ項目を追加しない。rulebook 参照は成果物カタログまたは計画側で解決する。
21
+ - 準拠先と採用根拠をメタ項目へ接続し、対応 schema で出力を検証する。
22
22
  - 組織上必要な責任領域(Why)、採用する Role code(What)、プロジェクト固有の責務強調(How)を扱い、`based_on` と下流の Role code 参照で追跡する(Trace)。割り当てや一般責務は各正本へ委譲する。
23
23
 
24
24
  ## 2. 作成前に集める情報
@@ -36,13 +36,13 @@ Project Role Definition Writing Recipe
36
36
 
37
37
  ## 3. 全体の作成手順
38
38
 
39
- 1. `id`、`type`、`status`、`version`、`project_id` を設定する。
40
- 2. `based_on` に、ロール採用の根拠となる組織定義などの ID を記載する。
41
- 3. `roles` に、プロジェクトで使用する Role code を標準順で列挙する。
42
- 4. 各 Role に `code` と `name` を記載し、必要な場合だけ `project_note` を 1 行で添える。
43
- 5. `project_note` から member nickname、agent 名、個人名、具体的な兼務割り当てを除く。
44
- 6. schema にないキー、重複 Role code、標準外 Role code がないことを確認する。
45
- 7. PO が承認できるよう、全 Role code の過不足、公開可否、下流文書への入力適合を確認する。
39
+ 1. 対象プロジェクトと一覧の名称・版を確認し、メタ項目へ反映する。成果物自身の `rulebook` も指定して準拠先を保持する。
40
+ 2. 採用判断の根拠となる組織定義を読み、カタログを使う場合は依存の範囲を確認して `based_on` へ接続する。
41
+ 3. 組織定義の採用集合を `roles` へ転記し、`code` と上位標準の正式な `name` を対応付ける。
42
+ 4. PO の判断に必要な固有の扱いだけを `project_note` に短く添える。
43
+ 5. 実行主体・兼務の説明はメンバー定義へ移し、下流参照と採用集合の差分を確認する。
44
+ 6. `docs/specdojo/schemas/v1/pm-roles.schema.yaml` で検証し、コードの重複・採用集合・正式名称は別途照合する。
45
+ 7. PO に、採用変更の理由、未決事項、下流への追従結果と公開判断に必要な材料を提示する。
46
46
 
47
47
  ## 4. 各要素の書き方
48
48
 
@@ -50,31 +50,29 @@ Project Role Definition Writing Recipe
50
50
 
51
51
  問い:
52
52
 
53
- - `id` は `<project-id>:pm-roles` 形式になっているか。
54
- - `project_id` は配置先プロジェクトと一致しているか。
55
- - `based_on` はロール採用の根拠を指しているか。
53
+ - 対象プロジェクト、一覧の名称、現在の版をメタ項目から識別できるか。
54
+ - `rulebook` は成果物の準拠先を示し、カタログ側だけの宣言で済ませていないか。
55
+ - `based_on` は確認した採用根拠を指し、カタログ利用時は依存から辿れるか。
56
56
 
57
57
  書き方:
58
58
 
59
- - `type` は `project`、`version` は整数で記載する。
60
- - `status` は現時点の成果物状態を示す。
61
- - 根拠 ID は、内容を実際に確認した文書だけを記載する。
62
- - `rulebook` など schema が許可しないキーを追加しない。
59
+ - 名称・版・プロジェクトの記入値を、配置先と採用判断の文書に照らして確かめる。
60
+ - 準拠先を成果物自身に残し、schema 検証でメタ項目の漏れや入力誤りを見つける。
61
+ - 採用理由の本文は組織定義を正本とし、ここでは根拠 ID で接続する。
63
62
 
64
63
  ### 4.2. `roles`
65
64
 
66
65
  問い:
67
66
 
68
- - Schedule の `owner` として必要な Role code が過不足なく入っているか。
67
+ - 組織定義の採用集合を、専門支援だけの Role も含めて転記できているか。
69
68
  - 重複した Role code や表記ゆれはないか。
70
69
  - 専任 member がいない Role code でも、責務語彙として必要なら残せているか。
71
70
 
72
71
  書き方:
73
72
 
74
- - 標準順に `PO`, `PM`, `BA`, `ARC`, `DEV`, `QE`, `UX`, `OPS` を並べる。
75
- - 独自 Role code は追加しない。
76
- - `roles` は責務語彙の一覧であり、実行主体の一覧ではないことを意識する。
77
- - 下流の `pm-members.yaml` や Schedule が参照する Role code を後から推測しなくてよいよう、採用する責務語彙を明示する。
73
+ - 組織定義の採用行だけを抜き出し、上位標準の定義順で照合すると漏れを見つけやすい。
74
+ - 専任者の不在と未採用を取り違えず、使用可能な `owner` の部分集合とも区別する。
75
+ - 下流の Role 参照に差分があれば、採用判断か参照元のどちらを直すか決めてから転記を確定する。
78
76
 
79
77
  ### 4.3. `roles[].project_note`
80
78
 
@@ -103,14 +101,14 @@ Project Role Definition Writing Recipe
103
101
 
104
102
  ## 6. 良い例 / 悪い例
105
103
 
106
- | 観点 | 良い例 | 悪い例 |
107
- | -------------------- | ------------------------------------------------- | -------------------------------------- |
108
- | Role code | `code: PM` | `code: project-manager-agent` |
109
- | 実行主体との分離 | 実行主体の割り当ては `pm-members.yaml` で管理する | `PM は pm-agent が担当する` |
110
- | プロジェクト固有メモ | 小規模運用では専任化せず、滞留時に見直す | 必要に応じて対応する |
111
- | 公開可否 | 公開判断は PO に残す | agent が公開可否を判断する |
112
- | 下流入力 | `roles[].code` を Schedule の `owner` に使う | `owner` に member nickname を使う |
113
- | schema 適合 | メタ項目は schema が許可するキーだけにする | `rulebook: specdojo:pm-roles-rulebook` |
104
+ | 観点 | 良い例 | 悪い例 |
105
+ | -------------------- | ---------------------------------------------------------- | --------------------------------- |
106
+ | Role code | `code: PM` | `code: project-manager-agent` |
107
+ | 実行主体との分離 | 実行主体の割り当ては `pm-members.yaml` で管理する | `PM は pm-agent が担当する` |
108
+ | プロジェクト固有メモ | 小規模運用では専任化せず、滞留時に見直す | 必要に応じて対応する |
109
+ | 公開可否 | 公開判断は PO に残す | agent が公開可否を判断する |
110
+ | 下流入力 | `roles[].code` を Schedule の `owner` に使う | `owner` に member nickname を使う |
111
+ | 準拠先 | 成果物自身に `rulebook: specdojo:pm-roles-rulebook` を残す | カタログにあるので成果物から省く |
114
112
 
115
113
  ## 7. レビュー観点
116
114
 
@@ -35,12 +35,12 @@ Assumptions, Constraints and Dependencies Writing Recipe
35
35
 
36
36
  1. 直接参照したスコープ・上位成果物を `based_on` に限定して記載する。
37
37
  2. 候補のうち、スコープで確定済みの境界・対象外は登録せず、該当章の冒頭で参照先を明示して委譲する。
38
- 3. 成立条件を前提条件として書き、根拠、影響、確認方法、変化時の対応を補う。
38
+ 3. 自分たちが成立すると置く仮説と、他者から受ける提供・判断を分け、前者を前提条件へ書く。根拠、影響、確認方法、変化時の対応を補う。
39
39
  4. 守るべき限界を制約事項として書き、適用範囲と逸脱条件を明確にする。
40
40
  5. 他者・外部・先行成果物から受ける条件を依存関係として書き、成立条件を定める。意思決定待ちの依存は、プロジェクト登録簿へ登録して本書から項目 ID を参照する。
41
41
  6. 変化の種別ごとに、最初に確認することと対応方針をまとめる。
42
42
  7. 監視・変更管理に、見直す契機と変更記録に残す情報を置く。
43
- 8. 表の各行について、前提・制約・依存の分類、根拠、所有者、対応が欠けていないか確認する。
43
+ 8. 既存の項目 ID を保持し、新規行を種別ごとに採番する。分類変更は新旧 ID を変更記録で結び、各行の根拠、所有者、対応を照合する。
44
44
 
45
45
  ## 4. 各章の書き方
46
46
 
@@ -57,8 +57,8 @@ Assumptions, Constraints and Dependencies Writing Recipe
57
57
  - 「〜できる」「〜である」という成立条件を一文にし、根拠と影響を分離する。
58
58
  - 単なる希望や目標は前提にしない。確認できない場合は仮置きであることを明示する。
59
59
  - スコープで定義済みの境界は前提として再掲せず、章冒頭でスコープの該当章へ委譲する。
60
- - リポジトリ、作業環境、外部ツールなど、継続的な提供が必要な基盤は前提ではなく依存関係(4.3.)として書く。
61
- - 例: 「店頭で使う端末を利用できる」を前提として、利用不可時の代替記録を対応に置く。
60
+ - 端末、リポジトリ、作業環境、外部ツールなど、継続的な提供が必要な基盤は「依存関係」へ分類する。
61
+ - 例: 「現行手順に近い操作なら記録を継続できる」を仮説にし、操作確認の記録と、成立しなかった場合の手順見直しを結ぶ。
62
62
 
63
63
  ### 4.2. 制約事項
64
64
 
@@ -72,7 +72,7 @@ Assumptions, Constraints and Dependencies Writing Recipe
72
72
 
73
73
  - 「〜しない」「〜に限定する」のように、禁止または限界を判定可能に書く。
74
74
  - 技術制約は製品名だけで固定せず、再利用性、公開適性、運用責任などの意図を添える。
75
- - スコープの対象外・境界の判断基準と同内容の制約は再掲せず、上位文書に現れない運用上の制約だけを書く。
75
+ - 上位文書が結論だけを示す制約を運用化する場合は、展開元の文書・章と監視・対応を添える。既に監視・記録先がある事項は参照へまとめる。
76
76
  - 詳細な設計方法や受入条件は、対応する後続成果物に委譲する。
77
77
 
78
78
  ### 4.3. 依存関係
@@ -87,6 +87,7 @@ Assumptions, Constraints and Dependencies Writing Recipe
87
87
 
88
88
  - 依存先を「外部サービス」だけに限定せず、先行成果物や承認も記載する。
89
89
  - 依存先名だけで終わらせず、必要な理由と成立条件を添える。
90
+ - 誰が、いつ、どの証跡で成立を確認するかを「受領・成立条件」へ書く。成果物の受入は対象 ID・品質ゲート・証跡へ接続し、部分決定と未決部分を分ける。
90
91
  - 意思決定待ちの依存はプロジェクト登録簿へ登録し、本書からは登録項目 ID を参照する。
91
92
  - 期限や責任者が未確定なら、推測で埋めず決定先を残す。
92
93
 
@@ -115,7 +116,8 @@ Assumptions, Constraints and Dependencies Writing Recipe
115
116
  書き方:
116
117
 
117
118
  - 「定期的に確認する」ではなく、「スコープまたは実践の型一式が変わったとき」「新たな機密情報検出時」などの具体的な契機を記載する。
118
- - 変更記録には項目 ID、変化内容、影響範囲、判断者、対応状況を残す。記録先が未定なら _TODO_: とする。
119
+ - 変更記録には項目 ID、変化内容、影響範囲、判断者、対応状況、再確認時期を結ぶ。既存の ID は並べ替え・廃止後も再利用せず、変更の前後を追跡する。
120
+ - 発生済みの支障・将来の不確実性・計画変更案・決定を各管理記録へ分け、PM が報告先と転送先を管理する。ARC は参照・技術制約、QE は受入・検証への追従を確認する。
119
121
  - 文書構造の整合確認は `ARC` 、公開可否やスコープ変更などの最終判断は人間の責任者が行うと明示する。
120
122
 
121
123
  ## 5. 深掘り手順
@@ -132,10 +134,10 @@ Assumptions, Constraints and Dependencies Writing Recipe
132
134
  | -------- | ------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------ |
133
135
  | 重複排除 | スコープ外で確定済みの境界は、章冒頭の参照で委譲する | スコープの対象外を言い換えて前提・制約として再掲する |
134
136
  | 運用化 | 憲章などが結論だけを示す制約に、監視方法・トリガー・所有者を添えて展開し、展開元を明記する | 憲章などがすでに継続監視・記録先を持つ判断ゲートを、要約して重複登録する |
135
- | 分類 | 「単一店舗で運用する」を前提として記載する | 「単一店舗で進める」を種別なしで書く |
137
+ | 分類 | 「現行手順に近い操作なら継続できる」を仮説として操作確認で検証する | スコープで確定済みの単一店舗運用を前提に再登録する |
136
138
  | 分類 | 「作業環境の継続利用」を依存関係として記載する | 「作業環境を継続利用できる」を前提条件として書く |
137
139
  | 制約 | 「個人情報を公開資料に含めない」と逸脱時の対応を併記する | 「情報管理に注意する」とだけ書く |
138
- | 依存 | 「先行するスコープ文書」と、その成立条件を記載する | 「他の資料を参照する」とだけ書く |
140
+ | 依存 | 受入対象版・条件 ID と、QE がゲート前に照合する判定記録を示す | 根拠として読んだだけの文書を依存先に登録する |
139
141
  | トリガー | 「対象外の機能を初期対象へ追加しようとした」と書く | 「必要に応じて確認する」と書く |
140
142
  | 未確定 | 「_TODO_: 公開判断の記録先を決定する」と書く | 未確認の責任者や期限を断定する |
141
143
 
@@ -36,7 +36,7 @@ Comparison of Alternatives Writing Recipe
36
36
  | 比較レイヤー | 業務運用、解決方式、購入 / 構築、製品、開発方式など |
37
37
  | 候補カテゴリ | 非システム、汎用ツール、既存製品、個別構築など |
38
38
  | 候補選定根拠 | 公式資料で確認した責務、保管場所、対応環境、移行可能性 |
39
- | 評価軸 | 効果、コスト、期間、リスク、運用適合、技術実現性 |
39
+ | 評価軸 | 効果、コスト、期間、リスク、業務適合、技術実現性 |
40
40
  | 技術的成立条件 | 既存資産、外部依存、制約、後続成果物への影響 |
41
41
  | 採択判断者 | 最終判断を行う人間の責任ロール。通常は `PO` |
42
42
  | 再評価条件 | 方針を見直すトリガー、次に確認する指標、記録先 |
@@ -112,10 +112,10 @@ Comparison of Alternatives Writing Recipe
112
112
 
113
113
  書き方:
114
114
 
115
- - 効果、コスト、期間、リスク、運用適合、技術実現性を最低ラインにし、比較目的に応じて適応性、追跡性、AI 適合、成熟度を追加する。
116
- - 重みを使う場合は、重みの理由を備考に書く。
115
+ - 課題と制約を効果、コスト、期間、リスク、業務適合、技術実現性へ対応付ける。扱わない観点は観点名と不要な理由を、他軸へ統合する観点は対応先と判定条件を残す。
116
+ - 重みを使う場合は、その理由と、優先順位か加重計算かの集約方法を書く。
117
117
  - 低いほどよい軸は、備考で判定方向を明示する。
118
- - 評価軸の説明には、根拠資料の課題 ID や業務価値との対応を添え、評価が業務価値から離れないようにする。
118
+ - 各軸に測定値または観察可能な状態で評価の境界を置く。未確認の値は未判定とし、確認作業を次の計画へ渡す。
119
119
  - レイヤーが異なれば評価軸を分けてよいが、同一レイヤーの候補には同じ軸と判定方向を使う。
120
120
  - 製品・サービスには、業務適合、データ移行、ロックイン、可逆性、成熟度を必要に応じて加える。
121
121
 
@@ -142,7 +142,7 @@ Comparison of Alternatives Writing Recipe
142
142
 
143
143
  - 採択によって先送りする範囲、受容する負荷、失う選択肢は何か。
144
144
  - 起きうる失敗と軽減策は対になっているか。
145
- - PM や後続作業がリスク登録簿へ転記できる粒度か。
145
+ - 対象の決定・案 ID、担当 Role、依存作業、完了条件を PM が後続作業へ渡せるか。
146
146
 
147
147
  書き方:
148
148
 
@@ -164,6 +164,7 @@ Comparison of Alternatives Writing Recipe
164
164
  - `PO` が最終判断し、AI Agent は比較分析の支援に留めることを明記する。
165
165
  - 再評価条件は、時間、指標、利用者フィードバック、依存変更など具体的なトリガーにする。
166
166
  - 方針変更時の記録先を、決定記録、変更要求ログ、プロジェクト登録簿などから選ぶ。
167
+ - PM が追従を管理し、BA の業務影響、ARC の技術制約、DEV の実装、QE の受入・検証、PO の方針判断をどの更新へ接続するか確認する。
167
168
 
168
169
  ## 5. 深掘り手順
169
170
 
@@ -182,18 +183,18 @@ Comparison of Alternatives Writing Recipe
182
183
 
183
184
  ## 6. 良い例 / 悪い例
184
185
 
185
- | 観点 | 良い例 | 悪い例 |
186
- | ------------ | ---------------------------------------------------------------- | -------------------------------------------------------------- |
187
- | 比較目的 | 販売・在庫・つけの記録を継続できる解決方式を選ぶ | どれがよいか考える |
188
- | 代替案 | 紙運用改善、既存サービス、個別構築を解決案として比較 | 画面、データ、開発ツールを別案として並べ、すべて採択する |
189
- | 比較レイヤー | 購入 / 構築を先に判断し、必要な場合だけ製品を比較 | 販売管理方式と開発タスク管理ツールを同じ表で採点 |
190
- | 候補選定 | カテゴリと基準を定め、各カテゴリの具体候補を公式資料で確認 | 知っている製品だけを代表例として比較 |
191
- | 評価軸 | 効果、コスト、期間、リスク、運用適合、技術実現性を同じ基準で評価 | 案ごとに都合のよい観点だけを書く |
192
- | 採択理由 | 業務適合と記録継続を重視し、ALT-04 を採択する | ALT-04 がよさそうだから |
193
- | 技術影響 | タブレット 1 台で試行でき、ノート移行と紙への切り戻しを要する | 実現性や影響の根拠を書かずに結論だけ述べる |
194
- | 見直し条件 | 2 週間の試行で記録漏れが許容値を超えた場合、採択案を見直す | 必要なら見直す |
195
- | 試行 | 同じ販売・つけ記録を 2 候補で試し、操作時間と記録漏れを測る | 導入してから使いやすそうか判断する |
196
- | 軽減策の根拠 | 後続の品質確認で対応する(根拠資料にある仕組みを指す) | 品質管理計画で対応する(根拠資料に存在しない計画名を断定する) |
186
+ | 観点 | 良い例 | 悪い例 |
187
+ | ------------ | ---------------------------------------------------------------------- | -------------------------------------------------------------- |
188
+ | 比較目的 | 販売・在庫・つけの記録を継続できる解決方式を選ぶ | どれがよいか考える |
189
+ | 代替案 | 紙運用改善、既存サービス、個別構築を解決案として比較 | 画面、データ、開発ツールを別案として並べ、すべて採択する |
190
+ | 比較レイヤー | 購入 / 構築を先に判断し、必要な場合だけ製品を比較 | 販売管理方式と開発タスク管理ツールを同じ表で採点 |
191
+ | 候補選定 | カテゴリと基準を定め、各カテゴリの具体候補を公式資料で確認 | 知っている製品だけを代表例として比較 |
192
+ | 評価軸 | 全案で同じ判定境界を使い、リスクを他軸へ統合するなら対応先と条件を記す | 案ごとに都合のよい観点だけを書く |
193
+ | 採択理由 | 業務適合と記録継続を重視し、ALT-04 を採択する | ALT-04 がよさそうだから |
194
+ | 技術影響 | タブレット 1 台で試行でき、ノート移行と紙への切り戻しを要する | 実現性や影響の根拠を書かずに結論だけ述べる |
195
+ | 見直し条件 | 2 週間の試行で記録漏れが許容値を超えた場合、採択案を見直す | 必要なら見直す |
196
+ | 試行 | 同じ販売・つけ記録を 2 候補で試し、操作時間と記録漏れを測る | 導入してから使いやすそうか判断する |
197
+ | 軽減策の根拠 | 後続の品質確認で対応する(根拠資料にある仕組みを指す) | 品質管理計画で対応する(根拠資料に存在しない計画名を断定する) |
197
198
 
198
199
  ## 7. レビュー観点
199
200
 
@@ -15,83 +15,115 @@ Status Definition Authoring Recipe
15
15
 
16
16
  ## 1. このレシピの使い方
17
17
 
18
- - 対象の開始から終了までを時系列で聞き取り、状態候補と状態変更イベントを同時に集めます。
18
+ - 状態で判断をそろえたい業務課題を起点に、対象の開始から終了または継続管理に至るまでを聞き取り、状態候補と状態変更イベントを同時に集めます。
19
19
  - 状態一覧を先に仮置きし、遷移図を描いた後で到達不能・出口なし・重複状態を見つけて一覧へ戻します。
20
- - 遷移の説明を図と一行ずつ照合し、最後に関連フローや用語との名称一致を確認します。
20
+ - 各図と直下の遷移表を遷移 ID で一行ずつ照合し、最後に関連フローや用語との名称一致を確認します。
21
21
  - 実装値は状態の安定識別に必要な範囲だけ扱い、実装条件式や操作手順は後続設計へ委ねます。
22
22
 
23
23
  ## 2. 作成前に集める情報
24
24
 
25
- | 入力 | 確認する内容 |
26
- | ---------------- | --------------------------------------------------------- |
27
- | 対象とスコープ | 状態を持つ一つの対象、AS-IS / TO-BE、開始・終了の業務境界 |
28
- | 状態候補 | 現場の正式名称・通称、その状態と判断する事実 |
29
- | 状態変更イベント | 誰が何をした、または何が起きたとき状態が変わるか |
30
- | 分岐条件 | 同じイベントから遷移先が分かれる場合の判定条件 |
31
- | 管理場所 | 現在状態と変更結果を確認する帳簿、台帳、記録、物の保管先 |
32
- | 関連文書 | 用語集、業務データ辞書、状態を変えるプロセスを示す CDFD |
25
+ | 入力 | 確認する内容 |
26
+ | ---------------- | ---------------------------------------------------------------------------------------------------------------------- |
27
+ | 対象と業務境界 | 状態を持つ一つの対象、開始・終了または継続管理の業務境界。同じ対象の TO-BE 文書と並ぶ場合だけ AS-IS / TO-BE を区別する |
28
+ | 状態管理の目的 | 対象の何を管理する状態か、誰がその状態で何を判断するか、解決する業務課題 |
29
+ | 状態候補 | 現場の正式名称・通称、その状態と判断する事実 |
30
+ | 状態変更イベント | 誰が何をした、または何が起きたとき状態が変わるか |
31
+ | 分岐条件 | 同じイベントから遷移先が分かれる場合の判定条件 |
32
+ | 管理場所 | 現在状態と変更結果を確認する帳簿、台帳、記録、物の保管先 |
33
+ | 判定規則と互換 | 正本と派生記録の区別、現在状態を一意に決める規則、旧状態値・旧イベント・未設定や欠損記録の扱い |
34
+ | 関連文書 | 用語集、業務データ辞書、状態を変えるプロセスを示す CDFD |
33
35
 
34
36
  ## 3. 全体の作成手順
35
37
 
36
- 1. 対象を一つに限定し、開始イベントと業務上の終了を短い文で定義します。
37
- 2. 現場で「いま何の状態か」と答える際の名称を集め、意味または成立条件が同じ候補を統合します。
38
- 3. 各状態へ値、正式名称、通称、意味、成立条件、管理場所を記入します。
39
- 4. 開始点から状態を並べ、状態を変えるイベントと条件を付けて Mermaid の状態遷移図を描きます。
40
- 5. 図の矢印へ `T-01` から遷移 ID を割り当て、遷移元・遷移先・イベント・条件・補足を表へ記載します。
41
- 6. 状態一覧と図を双方向に照合し、孤立状態、到達不能状態、出口のない状態、条件の重複を解消します。
42
- 7. 関連文書と状態名・イベント名・管理場所を照合し、未決事項だけを今後の検討メモへ残します。
38
+ 1. 対象を一つに限定し、H1 直下に頭書き、「目的」に対象の何を状態で管理し、誰が何を判断するか、「適用範囲」に対象・業務境界・到達点を記載します。終了点を置かない場合は、管理を続ける状態と理由も「適用範囲」へ記載します。
39
+ 2. 「状態の判定」に正本の管理場所、現在状態を一意に決める規則、互換の扱いを整理します。
40
+ 3. 現場で「いま何の状態か」と答える際の名称を集め、意味または成立条件が同じ候補を統合します。
41
+ 4. 「状態一覧」の各状態へ値、正式名称、通称、意味、成立条件、管理場所を記入し、判定規則と合わせて現在状態を特定できるか確認します。
42
+ 5. 「状態遷移」で開始点から状態を並べ、矢印に `T-<nn> イベント / 条件` のラベルを付けて Mermaid の状態遷移図を描きます。新規文書では `T-01` から割り当てます。初回の確定前(`status: draft`)は、遷移の追加・削除・並べ替えに合わせて図と表の順に `T-01` から欠番なく振り直してかまいません。分割時も文書全体で通し番号にします。振り直すときは図のラベル・遷移表・本文中の遷移 ID への参照を同時に更新し、振り直したことと旧 ID・新 ID の対応(削除した遷移は削除した旨)を STSD 本文ではなく作業の記録へ残します。一度確定(`status: ready`)した後は既存 ID を保ち、削除した ID は欠番として再利用せず、追加する遷移には過去に未使用の ID を使います。
43
+ 6. 各図のすぐ下に、その図の遷移 ID・遷移元・遷移先・イベント・条件・補足を一行ずつ記載した遷移表を置きます。分割時も図と表を一組として作成します。
44
+ 7. 状態一覧・図・遷移表を照合し、孤立状態、到達不能状態、継続管理の理由を説明できない出口なしの状態、条件の重複を解消します。
45
+ 8. 関連文書と状態名・イベント名・管理場所を照合し、未決事項だけを今後の検討メモへ残します。
46
+
47
+ 成果物は頭書きに続けて「目的」「適用範囲」「状態の判定」「状態一覧」「状態遷移」の順に章を設け、未決事項がある場合だけ「今後の検討メモ」を加えます。スコープは現行を既定として省略し、同じ対象の TO-BE 文書と並ぶ場合だけ AS-IS / TO-BE を明記して文書を分けます。
43
48
 
44
49
  ## 4. 各章の書き方
45
50
 
46
- ### 4.1. 概要
51
+ ### 4.1. 頭書き
52
+
53
+ 問い:
54
+
55
+ - 何の状態と遷移を定義する文書か、対象を一つの業務用語で答えられますか。
56
+ - 読み手が H1 と頭書きだけで、この文書の主題を識別できますか。
57
+ - 利用目的や範囲の詳細を後続の章へ分け、1〜2 行にまとめられますか。
58
+
59
+ 「商品の納品から販売または返品までの状態と遷移を定義する」のように、H1 直下へ記載します。頭書きには見出しを設けません。
60
+
61
+ ### 4.2. 目的
62
+
63
+ 問い:
64
+
65
+ - 状態は対象の何を管理しますか。進み具合、利用可否など、区別したい業務上の意味を答えられますか。
66
+ - 誰がその状態を見て、次に行える業務や対応の要否を判断しますか。
67
+ - 状態を区別しないと、どの判断が揃わず、業務にどのような支障が出ますか。
68
+
69
+ 「商品の受入から販売・返品までの進み具合と販売可否を管理する。店主代表が、売場へ補充できるか、仕入先への返品が必要かを判断するために使う」のように、管理する内容と状態による業務判断を 1〜3 文で結び付けます。文書の承認者や実装・テストへの利用方法は目的に含めません。
70
+
71
+ ### 4.3. 適用範囲
47
72
 
48
73
  問い:
49
74
 
50
- - 状態を持つ対象は一つの名詞で答えられますか。
51
- - どの出来事からどの終了までを扱い、AS-IS / TO-BE のどちらですか。
52
- - 誰が現在状態を判断し、誰が遷移の定義を設計・検証に使いますか。
53
- - 状態を確認する正本はどの記録または保管先ですか。
75
+ - 状態を持つ対象を一つの業務用語で特定できますか。
76
+ - どの開始イベントから、どの業務範囲で状態変更を扱い、どこから先を対象外にしますか。
77
+ - 業務上の完了・中止後も、差し戻し、状態確認、記録更新のために状態管理を続けますか。
78
+ - 終了点を置かない場合、業務上の到達点と管理を続ける状態・理由を説明できますか。
54
79
 
55
- 背景を長く再掲せず、対象・境界・利用目的・正本を短く固定します。
80
+ 「適用範囲」へ、対象、状態変更を起こす業務範囲、到達点を箇条書きで記載します。終了点を置くかは、ライフサイクルを閉じる業務イベントと条件の有無から判断します。置かない場合は継続管理の理由、出力遷移のない継続状態もここへ記載し、記録の保存だけを理由にしません。対象が一状態だけなら、状態変化がない根拠も記載します。
56
81
 
57
- ### 4.2. 状態一覧
82
+ ### 4.4. 状態の判定
83
+
84
+ 問い:
85
+
86
+ - 現在状態を確認する正本はどの記録ですか。履歴や集約記録を併用する場合、どれが正本でどれが派生物ですか。
87
+ - 同じ対象の記録から、現在状態を一つに決められますか。イベントをたどる場合の順序と初期値、導出状態がある場合の条件と再判定の契機、成立条件が重なる場合の優先関係は明らかですか。
88
+ - 旧状態値・旧イベント、未設定・欠損記録をどう読み取りますか。過去の記録の読み替えと、現在発行する遷移を混同していませんか。
89
+
90
+ 同じ対象の記録を二人が別々に判定し、同じ状態へ至るか確かめます。判定が分かれた箇所へ順序や優先関係を補い、状態固有の成立条件は「状態一覧」にまとめます。互換の扱いが不要ならその旨を示し、根拠がない読み替えや初期値は仮定せず、未決事項へ残します。
91
+
92
+ ### 4.5. 状態一覧
58
93
 
59
94
  問い:
60
95
 
61
96
  - 状態名は業務上の名詞句で、実装フラグや処理名になっていませんか。
62
- - 成立条件だけで第三者が現在状態を一つに判定できますか。
97
+ - 成立条件と「状態の判定」の規則から第三者が現在状態を一つに判定できますか。
63
98
  - 通称が正式名称と違う場合、その対応を一行で確認できますか。
64
99
  - 管理場所から現在状態の根拠を確認できますか。
65
100
 
66
- 候補が同時に成立する場合は、状態を統合するか優先関係を明記します。単なる処理待ちを状態にする場合は、業務判断や管理責任が変わることを確認します。
101
+ 候補が同時に成立する場合は、状態を統合するか「状態の判定」に優先関係を記載します。単なる処理待ちを状態にする場合は、業務判断や管理責任が変わることを確認します。
67
102
 
68
- ### 4.3. 状態遷移図
103
+ ### 4.6. 状態遷移
69
104
 
70
105
  問い:
71
106
 
72
107
  - 開始点から主要な終了点または継続状態まで矢印をたどれますか。
73
108
  - 状態一覧の全状態が図にあり、図の業務状態が一覧にありますか。
74
- - 各矢印にイベントと条件があり、同じ分岐元の条件を区別できますか。
109
+ - 各矢印のラベルが `T-<nn> イベント / 条件` となり、同じ分岐元の条件を区別できますか。
75
110
  - 例外経路から復帰、終了、または人間の判断へ進めますか。
76
-
77
- まず正常系を描き、その後に例外分岐と戻りを加えます。図が読みにくい場合は、状態を削るのではなく通常系・例外系などの観点で図を分けます。
78
-
79
- ### 4.4. 遷移の説明
80
-
81
- 問い:
82
-
83
- - 図の全矢印を遷移 ID で一行ずつ説明していますか。
84
- - 遷移元・遷移先は状態一覧と同じ名称ですか。
111
+ - 各図のすぐ下の遷移表と、図の全矢印が遷移 ID・遷移元・遷移先・イベント・条件で一対一に対応していますか。
112
+ - 初回の確定前か、一度確定した後かを確認し、遷移 ID の採番方法を選んでいますか。
113
+ - 遷移 ID を振り直した場合、作業の記録から旧 ID のレビュー指摘と対応する遷移を追えますか。
114
+ - 業務状態の遷移元・遷移先は状態一覧と同じ名称ですか。初期点は「開始」、終了点は「終了」とし、状態一覧へ追加していませんか。
85
115
  - 条件は記録や業務判断から yes / no で判定できますか。
86
116
  - 図だけでは分からない判断者、証跡、例外時の扱いを補足していますか。
87
117
 
88
- 図の言い換えだけで終わらせず、レビューとテストで使う判定根拠を補います。ただし、実装条件式や詳細な操作手順は記載しません。
118
+ まず正常系を描き、その後に例外分岐と戻りを加えます。`stateDiagram-v2` を使い、状態一覧に値がある場合は `状態名<br>値`、値が `-` なら状態名だけを表示します。無条件の矢印も `T-<nn> イベント / イベント発生時` として、開始・終了を含む全遷移を直下の表へ対応付けます。遷移の詳細は表を正本として図と同時に更新し、補足には判断者や証跡など図から読み取れない判定根拠だけを加えます。
119
+
120
+ 図を分ける場合は、業務フェーズや通常系・例外系ごとに遷移を振り分け、分割理由・扱う遷移 ID の範囲・共有状態を各図の前で説明します。共有状態は同じ表示名と `state_id` にそろえ、図のすぐ下へその図の遷移表を置いてから次の図へ進みます。全図を共有状態でつないで到達性を確認し、一つの遷移を複数の図表へ重複させません。共通条件は適用する遷移 ID とともに図の前へまとめ、表から参照します。
89
121
 
90
- ### 4.5. 今後の検討メモ
122
+ ### 4.7. 今後の検討メモ
91
123
 
92
124
  - 未決の例外状態、条件、用語、責任境界だけを記載します。
93
125
  - 影響する状態名または遷移 ID、決定者、決定時期を添えます。
94
- - 調査不足、意思決定待ち、仮置き前提を共通ラベルで区別します。
126
+ - 調査・追記・修正が必要な事項は `_TODO_:`、意思決定待ちは `_UNDECIDED_:`、仮置き前提は `_ASSUMPTION_:` を付けて区別します。
95
127
 
96
128
  ## 5. 深掘り手順
97
129
 
@@ -104,35 +136,41 @@ Status Definition Authoring Recipe
104
136
 
105
137
  ## 6. 良い例 / 悪い例
106
138
 
107
- | 観点 | 良い例 | 悪い例 |
108
- | -------- | ------------------------------------------------------ | -------------------------------------- |
109
- | 対象 | 商品の入荷から販売・返品までを一文書で扱う | 商品と発注の状態を同じ一覧へ混在させる |
110
- | 状態名 | 販売可能 | `is_sellable` |
111
- | 成立条件 | 検品結果が合格で在庫数量へ反映された | 検品が終わったら |
112
- | 遷移 | 検品完了 / 数量・品質が合格 | 次へ進む |
113
- | 分岐 | 合格と、数量違いまたは品質不良を別条件にする | 成功 / それ以外 |
114
- | 管理場所 | 仕入記録で受入、在庫記録で販売可能を確認する | システムで管理する |
115
- | 文書分割 | 状態一覧・遷移図・遷移説明を `stsd-product` に集約する | 状態一覧と遷移図を別ファイルで管理する |
139
+ | 観点 | 良い例 | 悪い例 |
140
+ | -------- | ------------------------------------------------------------------ | ------------------------------------------ |
141
+ | 対象 | 商品の入荷から販売・返品までを一文書で扱う | 商品と発注の状態を同じ一覧へ混在させる |
142
+ | 状態名 | 販売可能 | `is_sellable` |
143
+ | 成立条件 | 検品結果が合格で在庫数量へ反映された | 検品が終わったら |
144
+ | 目的 | 商品の販売可否を管理し、店主が補充・返品の要否を判断する | 開発担当が設計し、品質確認担当がテストする |
145
+ | 判定 | 正本の記録を業務の発生順にたどり、最後に成立した遷移先で判定する | 見た目で判断する |
146
+ | 遷移 | `T-02 検品完了 / 数量・品質が合格` | 次へ進む |
147
+ | 分岐 | 合格と、数量違いまたは品質不良を別条件にする | 成功 / それ以外 |
148
+ | 管理場所 | 仕入記録で受入、在庫記録で販売可能を確認する | システムで管理する |
149
+ | 図の分割 | 「状態遷移」で通常系の図と直下の表、例外系の図と直下の表を順に置く | 図を先に並べ、全遷移の表を別章へ置く |
116
150
 
117
151
  ## 7. レビュー観点
118
152
 
119
- | 観点 | 確認内容 | 主な確認者 |
120
- | ------------ | -------------------------------------------------------------------- | ---------------------- |
121
- | 業務妥当性 | 状態と遷移が現場の判断・例外を表し、対象のライフサイクルを説明できる | 業務分析担当、店主代表 |
122
- | 一意性 | 成立条件から現在状態を一意に判定できる | 業務分析担当 |
123
- | 図表整合 | 状態一覧、状態遷移図、遷移の説明の名称・件数・条件が一致する | 品質確認担当 |
124
- | 設計入力 | 状態値、イベント、条件、管理場所を後続設計へ引き渡せる | 技術メンター |
125
- | テスト可能性 | 初期、正常、例外、終了の経路と分岐条件から状態遷移テストを設計できる | 品質確認担当 |
126
- | 用語整合 | 状態名・通称・イベント名が関連文書と一致する | 業務分析担当 |
153
+ | 観点 | 確認内容 | 主な確認者 |
154
+ | ------------ | --------------------------------------------------------------------------------------------- | ---------------------- |
155
+ | 業務妥当性 | 状態と遷移が現場の判断・例外を表し、対象のライフサイクルを説明できる | 業務分析担当、店主代表 |
156
+ | 目的との対応 | 状態が管理する内容と、その状態による業務上の判断が結び付いている | 業務分析担当、店主代表 |
157
+ | 一意性 | 正本・判定規則・互換の扱いと成立条件から現在状態を一意に判定できる | 業務分析担当 |
158
+ | 図表整合 | 各図と直下の遷移表の ID・遷移元・遷移先・イベント・条件が一致し、業務状態が状態一覧と対応する | 品質確認担当 |
159
+ | 設計入力 | 状態値、イベント、条件、管理場所を後続設計へ引き渡せる | 技術メンター |
160
+ | テスト可能性 | 初期、正常、例外、終了の経路と分岐条件から状態遷移テストを設計できる | 品質確認担当 |
161
+ | 用語整合 | 状態名・通称・イベント名が関連文書と一致する | 業務分析担当 |
127
162
 
128
163
  ## 8. 仕上げチェック
129
164
 
130
- - 一文書が一つの対象と一つの AS-IS / TO-BE スコープだけを扱っている。
131
- - 状態一覧の全行に状態名、意味、成立条件、管理場所がある。
165
+ - 一文書が一つの対象を扱い、現行を既定としてスコープを省略している。同じ対象の TO-BE 文書と並ぶ場合だけ AS-IS / TO-BE を明記して文書を分けている。
166
+ - 頭書きは H1 直下の 1〜2 行に収まり、「目的」は状態が管理する内容と誰が何を判断するか、「適用範囲」は対象・業務境界・到達点、「状態の判定」は正本・判定規則・互換の扱いに分かれている。
167
+ - 状態一覧の全行に値、状態名、通称、意味、成立条件、管理場所がある。コードや通称がない欄は `-` で示し、値は `-` を除いて文書内で一意になっている。
132
168
  - 状態一覧と状態遷移図の業務状態が過不足なく一致している。
133
- - 図の全遷移が遷移の説明に一度ずつあり、イベントと条件が一致している。
134
- - 開始から正常終了までと、主要な例外経路をたどれる。
169
+ - 「状態遷移」で各図のすぐ下にその図の遷移表があり、図と表の間に説明文や別の図を挟んでいない。全遷移のラベルが `T-<nn> イベント / 条件` で、直下の表と一対一に一致し、分割時も文書全体で重複や欠落がない。
170
+ - 開始から正常系・例外系の終了状態または継続状態までをたどれ、終了点を置かない理由と継続管理する状態を「適用範囲」で説明できる。
135
171
  - 条件分岐が相互に区別でき、判定不能な「適切」「問題なし」を使っていない。
136
172
  - 状態名、通称、イベント名、管理場所が用語集・業務データ辞書・関連 CDFD と矛盾しない。
137
173
  - 実装条件式、SQL、詳細 API、画面操作を状態定義として記載していない。
138
- - 今後の検討メモに _TODO_ が残っていない。未決事項は決定者と決定時期を持つ。
174
+ - 今後の検討メモの `_TODO_:` を解消し、残る `_UNDECIDED_:`・`_ASSUMPTION_:` には影響する状態または遷移 ID、決定者、決定時期がある。
175
+ - 公開対象の本文・図表に個人情報・非公開情報を含めていないことを確認し、公開可否の最終判断と説明責任を人間の PO が担うことを確認している。
176
+ - 公開対象と人間の承認者を特定し、`ready` への昇格条件として内容確認、未解決指摘の扱いの合意、公開前確認をそろえている。作成中は `draft` を保ち、昇格は人間の承認後に人間が行う。
@@ -0,0 +1,106 @@
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
+ - 業務フローとプロジェクトの価値判断から、失敗すると誰の何が損なわれるかを引き継ぐ。
19
+ - この文書で確定するのは処理の境界、成功を認める保存状態、重複・中断後に許す動作である。
20
+ - How は整合性・排他・保持・再開の方針までとし、設定値や操作の構文は正本へ委ねる。
21
+ - フロー ID、受入条件、検証 ID、未決事項 ID を対応させ、主要な判断を根拠と証跡へ結ぶ。
22
+
23
+ ## 2. 作成前に集める情報
24
+
25
+ | 集める情報 | 答えたい問い |
26
+ | -------------------------- | -------------------------------------------------------------------- |
27
+ | 対象者・業務結果 | 失敗すると誰がどの作業をやり直すか。支出・参加負荷・履歴に何が残るか |
28
+ | システム設計索引・連携契約 | 内外の境界はどこか。要求、受付、永続化、完了を何で識別するか |
29
+ | 状態遷移・権限 | 再実行・取消・承認の意味と責任はどこで定義され、現行の定義か |
30
+ | 実装・設定の所在 | 上限と優先順位をどの正本から一意に辿れるか。実効値の確認は誰が行うか |
31
+ | テスト・運用・判断記録 | 期待結果と実績を区別できるか。未作成の手順や未承認の条件は何か |
32
+
33
+ ## 3. 全体の作成手順
34
+
35
+ 1. 概要で入口・出口・対象外を決める。公開対象に実行記録や個人情報を含むか、人間の判断者が誰かを確認する。
36
+ 2. 一覧で事故候補を比較する。通常処理より優先する理由を利用者の損失から説明する。候補が5件を超えたら、同じ事故を防ぐ候補の統合、既存との置換、対象外への整理を行い、整理後の件数と選定理由を確認してから詳細へ進む。
37
+ 3. 詳細をフローごとに書く。起動条件と入出力から成功の確定点を置き、そこへ至る内外の処理・保存先・識別子と非同期の戻りを図にする。
38
+ 4. 各保存点の直前・直後で停止させ、重複・応答欠落・部分成功の残存状態と次の手を決める。
39
+ 5. 観測性と運用連携で、機械が検出する条件と人間が対応する責任を分ける。相関情報が境界を越えて追えるか確認する。
40
+ 6. 関連ドキュメント導線へ実装・設定・テスト・運用・判断と変更影響を接続する。足りない根拠を担当・依存順・完了条件・判断時期へ変換して引き渡す。
41
+
42
+ ## 4. 各章の書き方
43
+
44
+ ### 4.1. 概要
45
+
46
+ - 問い: どの操作からどの業務結果までを扱うか。通常処理を除いた理由は何か。人間の承認を必要とする境界はどこか。
47
+ - 具体化: 設計索引と状態用語の定義先を確かめ、公開対象と除外する情報、最終判断を担う人間の Role code を短く書く。廃止済みの根拠しかなければ、現行仕様との照合を後続作業へ渡す。
48
+ - 対比: 「販売要求から受付照合まで。購入履歴は除外し、PO が公開を判断する」なら範囲を確認できる。「全体を安全にする」では入口・出口・判断者を決められない。
49
+
50
+ ### 4.2. 重要フロー一覧
51
+
52
+ - 問い: 誰の損失を防ぐか。放置すると何が壊れるか。成功すればどの負荷が減るか。
53
+ - 具体化: 対象者・事故論点・業務影響・期待効果を一行で結び、候補間で影響を比較する。単純な処理でも重複・誤承認の影響を見落とさない。
54
+ - 対比: 「応答欠落後の再送が店番の二重売上照合を増やすため、閲覧より優先する」なら選定を説明できる。「複雑なので High」では他候補と比較できない。
55
+
56
+ ### 4.3. フロー詳細
57
+
58
+ - 問い: 誰の何の要求で始まり、何を受け取り何を返すか。どの記録があれば成功と言えるか。再送で二度目の副作用が起きないか。取消不能なら何を保持して誰が照合するか。
59
+ - 具体化: 処理主体と保存先を分け、境界を越える要求・応答を同じ識別子で追う。矢印の凡例で同期・非同期を、保存記録で要求受付・業務完了を読み分けられるか試す。保存前後の中断から保持・補償・再開条件を決め、利用者が確認できる受入結果へ結ぶ。
60
+ - 対比: 「受付結果不明なら同じ取引 ID と控えを保持して照合し、未受付と確認して再送する」なら次の手が決まる。「timeout なら retry」では受付済みの副作用を判断できない。
61
+
62
+ ### 4.4. 観測性と運用連携
63
+
64
+ - 問い: 同じ処理を内外でどう照合するか。trace はどこまで渡せるか。採用しない場合は何を根拠に代替キーで追えるか。検知後に誰が何を止め、どこへ相談するか。
65
+ - 具体化: イベントによる停止条件と、時間・滞留数などの監視条件を分ける。数値を使う場合は測定方法と判定時点を正本へ接続する。未決の通知方式・応答期限は追跡先へ渡し、異常・リスク・設計変更・人間の判断をどの管理記録へ引き渡すか整理する。
66
+ - 対比: 「重複を検出して処理を停止し、OPS が取引 ID で外部受付と控えを照合、ARC へ照会し PM へ記録を渡す」なら動作と責任を分けられる。「runner が担当」では人間の次の手が決まらない。
67
+
68
+ ### 4.5. 関連ドキュメント導線
69
+
70
+ - 問い: 設定正本のどの箇所と、どのテスト・復旧手順を読めば再現できるか。フローの統合・廃止を含む変更で、契約・schema・生成物・CLI・保存済み記録の互換性に何が波及するか。
71
+ - 具体化: 受入条件ごとに実在するテストパスまたはテスト ID、実行方法、入力条件、期待結果、失敗判定を対応させる。内部・外部の結合境界を見分け、ITC/ETC のどちらへ引き渡すか考える。所在確認・網羅性確認・実行結果を分け、不足が受入・Schedule に与える影響と、担当・依存順・完了条件・判断時期・管理記録を結ぶ。
72
+ - 対比: 「応答欠落のテストで売上一件と照合待ち表示を確認する。復旧手順の未整備は OPS が受入前に解消する追跡 ID へ渡す」なら検証と不足を分けられる。「テストファイルがあるので pass、運用は後で」では受入可否を判断できない。
73
+
74
+ ## 5. 深掘り手順
75
+
76
+ 1. 「失敗なら再試行」と書いた箇所を探し、受付前・受付後・保存後で結果が変わらないか分ける。
77
+ 2. 図の非同期境界で応答を失った場合を追い、照合キーと保存記録が両側に残るか確認する。
78
+ 3. 同じ ID を二つの実行へ与え、排他範囲や重複排除が本当に副作用を守るか問い直す。
79
+ 4. 設定値を参照だけにした箇所を辿り、実効条件を一意に解決できなければ未決事項とする。閾値を使う判断では、測定元と判定時点が同じ条件を指すか確かめる。
80
+ 5. 成功条件を一つずつ検証・運用の担当へ渡せる形にし、対応しない説明を削る。
81
+
82
+ ## 6. 良い例 / 悪い例
83
+
84
+ | 観点 | 良い例 | 悪い例・不足する判断 |
85
+ | ---- | ------------------------------------------------------ | ------------------------------------------------ |
86
+ | 再開 | 同じ block の最新状態を排他下で確認し、保持試行へ戻る | 時刻が来たら全件再実行。重複・所有権が不明 |
87
+ | 補償 | 受付済みの売上を保持し、返品の判断を店主へ渡す | 失敗表示なら取引記録を削除。部分成功の扱いが不明 |
88
+ | 変更 | 受付契約の変更時に旧控えからの照合と復旧手順を確認する | 新形式で動けば完了。既存記録への影響が不明 |
89
+
90
+ ## 7. レビュー観点
91
+
92
+ | 観点 | 確認する対応 |
93
+ | ------------ | -------------------------------------------------------------------------- |
94
+ | 価値と範囲 | 守る利用者・損失と、選んだ処理が対応しているか |
95
+ | 永続化と失敗 | 図の保存点で中断しても、保持・照合・補償・再開条件が矛盾しないか |
96
+ | 人間の責任 | 実装主体、一次対応、技術確認、最終承認が区別されているか |
97
+ | 正本と証跡 | 設定・テスト・運用が一意に辿れ、未確認を確認済みと扱っていないか |
98
+ | 変更の波及 | フローの追加・統合・廃止で影響する索引・契約・既存記録と確認担当を辿れるか |
99
+
100
+ ## 8. 仕上げチェック
101
+
102
+ - 一覧の選定理由が詳細の受入条件につながっているか。
103
+ - 全成功経路に確定の証拠があり、全失敗経路に保持状態と次の手があるか。
104
+ - 詳細値・構文・状態定義の二重管理と、図の言い換えだけの文を除いたか。
105
+ - 未決事項に担当、判断時期、解消条件、計画・管理記録への引渡し先があるか。
106
+ - 公開版に raw signal、実在人物の情報、秘密値が混入せず、人間が公開可否を判断できるか。