specdojo 0.8.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 (284) hide show
  1. package/.github/agents/specdojo-orchestrator.md +4 -1
  2. package/CHANGELOG.md +64 -0
  3. package/dist/catalog/catalog.js +16 -14
  4. package/dist/commands/agent.js +5 -3
  5. package/dist/commands/build.js +69 -10
  6. package/dist/commands/git.js +206 -0
  7. package/dist/commands/init.js +4 -2
  8. package/dist/commands/where.js +25 -0
  9. package/dist/dashboard/dashboard.js +5 -3
  10. package/dist/dashboard/routines.js +4 -7
  11. package/dist/dashboard/timeline.js +14 -14
  12. package/dist/docs/index-command.js +2 -2
  13. package/dist/docs/yaml-business-tables.js +243 -0
  14. package/dist/docs/yaml-interface-tables.js +106 -0
  15. package/dist/docs/yaml-pages-command.js +5 -3
  16. package/dist/docs/yaml-pages.js +146 -3
  17. package/dist/docs/yaml-table-shared.js +70 -0
  18. package/dist/docs/yaml-tables.js +39 -0
  19. package/dist/exec/agent-config.js +9 -0
  20. package/dist/exec/agent-protected-config.js +2 -0
  21. package/dist/exec/commands.js +31 -18
  22. package/dist/exec/events.js +34 -14
  23. package/dist/exec/evidence.js +13 -3
  24. package/dist/exec/parent-validation.js +56 -3
  25. package/dist/exec/plans-core.js +21 -2
  26. package/dist/exec/plans-generation.js +6 -7
  27. package/dist/exec/post-integration.js +162 -0
  28. package/dist/exec/queue-command.js +166 -0
  29. package/dist/exec/queue.js +285 -0
  30. package/dist/exec/register-foreign-wait.js +84 -0
  31. package/dist/exec/repo-integration-sync.js +17 -5
  32. package/dist/exec/reporter.js +2 -2
  33. package/dist/exec/results.js +24 -4
  34. package/dist/exec/review-kata.js +4 -1
  35. package/dist/exec/run/agent-pipeline.js +3 -2
  36. package/dist/exec/run/agent.js +12 -6
  37. package/dist/exec/run/change-scope.js +365 -0
  38. package/dist/exec/run/deferred-cleanup.js +31 -0
  39. package/dist/exec/run/in-place.js +4 -1
  40. package/dist/exec/run/job-lock.js +66 -0
  41. package/dist/exec/run/job-sequence.js +137 -0
  42. package/dist/exec/run/job.js +56 -19
  43. package/dist/exec/run/lifecycle-commands.js +1 -1
  44. package/dist/exec/run/lock.js +22 -1
  45. package/dist/exec/run/register-command.js +8 -5
  46. package/dist/exec/run/register-mode.js +68 -8
  47. package/dist/exec/run/register-resume.js +68 -14
  48. package/dist/exec/run/register-state.js +13 -8
  49. package/dist/exec/run/register-worktree.js +140 -125
  50. package/dist/exec/run/schedule-mode.js +75 -14
  51. package/dist/exec/run/schedule-prepare.js +3 -0
  52. package/dist/exec/run/schedule-task.js +88 -38
  53. package/dist/exec/run/shared.js +5 -0
  54. package/dist/exec/schedule/schedule.js +116 -4
  55. package/dist/exec/shared.js +1 -1
  56. package/dist/exec/smoke.js +190 -0
  57. package/dist/exec/strategy.js +13 -3
  58. package/dist/exec/task-view.js +6 -4
  59. package/dist/exec/trial-commands.js +5 -2
  60. package/dist/exec/trial-core.js +6 -1
  61. package/dist/exec/validation-metrics.js +181 -0
  62. package/dist/exec/worktree-cleanup-lock.js +26 -0
  63. package/dist/exec/worktree-command.js +9 -1
  64. package/dist/exec/worktree-ops-commit.js +2 -2
  65. package/dist/exec/worktree.js +13 -2
  66. package/dist/grade/command-apply.js +3 -3
  67. package/dist/grade/command-inspect.js +5 -3
  68. package/dist/grade/command-plan.js +1 -1
  69. package/dist/grade/command-run.js +5 -1
  70. package/dist/grade/run.js +64 -8
  71. package/dist/job/definition.js +84 -8
  72. package/dist/job/job.js +79 -23
  73. package/dist/register/authoring-sources.js +22 -16
  74. package/dist/register/maintenance-commands.js +2 -2
  75. package/dist/register/register.js +31 -7
  76. package/dist/routine/definition.js +9 -0
  77. package/dist/routine/routine.js +137 -43
  78. package/dist/routine/status.js +62 -0
  79. package/dist/schedule/schedule.js +38 -39
  80. package/dist/shared/agent-types.js +5 -0
  81. package/dist/shared/cross-process-lock.js +9 -1
  82. package/dist/shared/dist-freshness.js +8 -2
  83. package/dist/shared/git-environment.js +2 -1
  84. package/dist/shared/git.js +44 -1
  85. package/dist/shared/lefthook-scaffold.js +3 -0
  86. package/dist/shared/local-config.js +244 -0
  87. package/dist/shared/specdojo-config.js +34 -20
  88. package/dist/shared/specdojo-gitignore.js +1 -0
  89. package/dist/shared/text.js +9 -1
  90. package/dist/shared/where-alias.js +13 -0
  91. package/dist/specdojo.js +4 -0
  92. package/docs/ja/specdojo/defaults/pm-review-viewpoints.yaml +2 -0
  93. package/docs/ja/specdojo/guides/exec-config-guide.md +23 -4
  94. package/docs/ja/specdojo/guides/exec-operation-guide.md +44 -1
  95. package/docs/ja/specdojo/guides/job-sequence-guide.md +77 -0
  96. package/docs/ja/specdojo/guides/quick-start-guide.md +3 -3
  97. package/docs/ja/specdojo/guides/register-operation-guide.md +1 -1
  98. package/docs/ja/specdojo/guides/routine-operation-guide.md +11 -6
  99. package/docs/ja/specdojo/guides/schedule-design-guide.md +20 -17
  100. package/docs/ja/specdojo/guides/waza-guide.md +12 -8
  101. package/docs/ja/specdojo/recipes/bac-recipe.md +66 -49
  102. package/docs/ja/specdojo/recipes/bes-recipe.md +90 -54
  103. package/docs/ja/specdojo/recipes/bps-recipe.md +88 -139
  104. package/docs/ja/specdojo/recipes/br-recipe.md +40 -47
  105. package/docs/ja/specdojo/recipes/cdfd-overview-recipe.md +97 -109
  106. package/docs/ja/specdojo/recipes/cdfd-recipe.md +85 -146
  107. package/docs/ja/specdojo/recipes/cdfd-uc-recipe.md +91 -110
  108. package/docs/ja/specdojo/recipes/cnd-recipe.md +79 -69
  109. package/docs/ja/specdojo/recipes/cpd-recipe.md +78 -64
  110. package/docs/ja/specdojo/recipes/cxd-recipe.md +92 -75
  111. package/docs/ja/specdojo/recipes/ifd-recipe.md +79 -68
  112. package/docs/ja/specdojo/recipes/ifx-cmd-recipe.md +78 -105
  113. package/docs/ja/specdojo/recipes/ifx-index-recipe.md +105 -71
  114. package/docs/ja/specdojo/recipes/pm-communication-plan-recipe.md +60 -49
  115. package/docs/ja/specdojo/recipes/pm-members-recipe.md +50 -51
  116. package/docs/ja/specdojo/recipes/pm-organization-recipe.md +59 -51
  117. package/docs/ja/specdojo/recipes/pm-plan-recipe.md +69 -56
  118. package/docs/ja/specdojo/recipes/pm-quality-management-plan-recipe.md +37 -56
  119. package/docs/ja/specdojo/recipes/pm-raci-recipe.md +39 -53
  120. package/docs/ja/specdojo/recipes/pm-roles-recipe.md +52 -79
  121. package/docs/ja/specdojo/recipes/prj-assumptions-constraints-dependencies-recipe.md +64 -93
  122. package/docs/ja/specdojo/recipes/prj-charter-recipe.md +71 -106
  123. package/docs/ja/specdojo/recipes/prj-comparison-of-alternatives-recipe.md +78 -157
  124. package/docs/ja/specdojo/recipes/prj-issues-and-approach-recipe.md +62 -111
  125. package/docs/ja/specdojo/recipes/prj-scope-recipe.md +67 -123
  126. package/docs/ja/specdojo/recipes/prj-stakeholder-register-recipe.md +60 -96
  127. package/docs/ja/specdojo/recipes/prj-success-criteria-and-acceptance-criteria-recipe.md +61 -105
  128. package/docs/ja/specdojo/recipes/stsd-recipe.md +79 -109
  129. package/docs/ja/specdojo/recipes/sysd-critical-flows-recipe.md +78 -55
  130. package/docs/ja/specdojo/recipes/sysd-cross-cutting-policy-recipe.md +82 -73
  131. package/docs/ja/specdojo/recipes/sysd-index-recipe.md +78 -59
  132. package/docs/ja/specdojo/recipes/tsd-recipe.md +149 -129
  133. package/docs/ja/specdojo/references/command-reference.md +257 -117
  134. package/docs/ja/specdojo/references/deliverables-reference.md +21 -12
  135. package/docs/ja/specdojo/references/specdojo-config-reference.md +37 -2
  136. package/docs/ja/specdojo/rulebooks/atc-index-rulebook.md +101 -257
  137. package/docs/ja/specdojo/rulebooks/atc-rulebook.md +102 -228
  138. package/docs/ja/specdojo/rulebooks/bac-rulebook.md +19 -28
  139. package/docs/ja/specdojo/rulebooks/bdd-rulebook.md +16 -67
  140. package/docs/ja/specdojo/rulebooks/bds-rulebook.md +30 -51
  141. package/docs/ja/specdojo/rulebooks/bes-index-rulebook.md +41 -61
  142. package/docs/ja/specdojo/rulebooks/bes-rulebook.md +22 -50
  143. package/docs/ja/specdojo/rulebooks/bps-rulebook.md +24 -56
  144. package/docs/ja/specdojo/rulebooks/br-rulebook.md +13 -38
  145. package/docs/ja/specdojo/rulebooks/ccd-mermaid-rulebook.md +41 -76
  146. package/docs/ja/specdojo/rulebooks/cdfd-d2-rulebook.md +18 -93
  147. package/docs/ja/specdojo/rulebooks/cdfd-mermaid-rulebook.md +18 -52
  148. package/docs/ja/specdojo/rulebooks/cdfd-overview-rulebook.md +109 -147
  149. package/docs/ja/specdojo/rulebooks/cdfd-rulebook.md +80 -108
  150. package/docs/ja/specdojo/rulebooks/cdfd-uc-rulebook.md +21 -46
  151. package/docs/ja/specdojo/rulebooks/cdr-rulebook.md +144 -0
  152. package/docs/ja/specdojo/rulebooks/cdsd-rulebook.md +27 -48
  153. package/docs/ja/specdojo/rulebooks/cdt-rulebook.md +37 -50
  154. package/docs/ja/specdojo/rulebooks/clis-rulebook.md +52 -69
  155. package/docs/ja/specdojo/rulebooks/cnd-mermaid-rulebook.md +33 -86
  156. package/docs/ja/specdojo/rulebooks/cnd-rulebook.md +16 -32
  157. package/docs/ja/specdojo/rulebooks/cop-index-rulebook.md +45 -131
  158. package/docs/ja/specdojo/rulebooks/cop-rulebook.md +69 -275
  159. package/docs/ja/specdojo/rulebooks/cpd-mermaid-rulebook.md +20 -112
  160. package/docs/ja/specdojo/rulebooks/cpd-rulebook.md +23 -56
  161. package/docs/ja/specdojo/rulebooks/cxd-mermaid-rulebook.md +12 -145
  162. package/docs/ja/specdojo/rulebooks/cxd-rulebook.md +39 -47
  163. package/docs/ja/specdojo/rulebooks/dct-index-rulebook.md +37 -56
  164. package/docs/ja/specdojo/rulebooks/dct-rulebook.md +118 -175
  165. package/docs/ja/specdojo/rulebooks/dec-rulebook.md +5 -14
  166. package/docs/ja/specdojo/rulebooks/dmd-index-rulebook.md +22 -66
  167. package/docs/ja/specdojo/rulebooks/dmd-rulebook.md +36 -94
  168. package/docs/ja/specdojo/rulebooks/dss-rulebook.md +59 -81
  169. package/docs/ja/specdojo/rulebooks/etc-index-rulebook.md +31 -131
  170. package/docs/ja/specdojo/rulebooks/etc-rulebook.md +50 -104
  171. package/docs/ja/specdojo/rulebooks/gl-rulebook.md +51 -61
  172. package/docs/ja/specdojo/rulebooks/ifd-mermaid-rulebook.md +38 -45
  173. package/docs/ja/specdojo/rulebooks/ifx-api-rulebook.md +14 -20
  174. package/docs/ja/specdojo/rulebooks/ifx-cmd-rulebook.md +26 -38
  175. package/docs/ja/specdojo/rulebooks/ifx-file-rulebook.md +26 -107
  176. package/docs/ja/specdojo/rulebooks/ifx-index-rulebook.md +42 -49
  177. package/docs/ja/specdojo/rulebooks/ifx-msg-rulebook.md +14 -22
  178. package/docs/ja/specdojo/rulebooks/imp-business-rulebook.md +21 -44
  179. package/docs/ja/specdojo/rulebooks/imp-data-rulebook.md +41 -64
  180. package/docs/ja/specdojo/rulebooks/imp-interface-rulebook.md +14 -38
  181. package/docs/ja/specdojo/rulebooks/imp-operations-rulebook.md +34 -61
  182. package/docs/ja/specdojo/rulebooks/imp-test-rulebook.md +27 -50
  183. package/docs/ja/specdojo/rulebooks/itc-index-rulebook.md +70 -199
  184. package/docs/ja/specdojo/rulebooks/itc-rulebook.md +65 -153
  185. package/docs/ja/specdojo/rulebooks/mip-index-rulebook.md +74 -150
  186. package/docs/ja/specdojo/rulebooks/mm-rulebook.md +11 -23
  187. package/docs/ja/specdojo/rulebooks/mtp-rulebook.md +99 -176
  188. package/docs/ja/specdojo/rulebooks/nfr-availability-rulebook.md +35 -61
  189. package/docs/ja/specdojo/rulebooks/nfr-index-rulebook.md +75 -117
  190. package/docs/ja/specdojo/rulebooks/nfr-integrity-rulebook.md +31 -60
  191. package/docs/ja/specdojo/rulebooks/nfr-maintainability-rulebook.md +26 -81
  192. package/docs/ja/specdojo/rulebooks/nfr-operations-rulebook.md +32 -70
  193. package/docs/ja/specdojo/rulebooks/nfr-performance-rulebook.md +45 -87
  194. package/docs/ja/specdojo/rulebooks/nfr-reliability-rulebook.md +48 -101
  195. package/docs/ja/specdojo/rulebooks/nfr-security-safety-rulebook.md +44 -80
  196. package/docs/ja/specdojo/rulebooks/nfr-usability-rulebook.md +59 -127
  197. package/docs/ja/specdojo/rulebooks/opd-index-rulebook.md +31 -50
  198. package/docs/ja/specdojo/rulebooks/opd-rulebook.md +42 -109
  199. package/docs/ja/specdojo/rulebooks/opr-index-rulebook.md +29 -42
  200. package/docs/ja/specdojo/rulebooks/opr-rulebook.md +29 -87
  201. package/docs/ja/specdojo/rulebooks/otp-index-rulebook.md +62 -84
  202. package/docs/ja/specdojo/rulebooks/otp-rulebook.md +11 -61
  203. package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +91 -106
  204. package/docs/ja/specdojo/rulebooks/pm-change-request-log-rulebook.md +25 -34
  205. package/docs/ja/specdojo/rulebooks/pm-communication-plan-rulebook.md +30 -53
  206. package/docs/ja/specdojo/rulebooks/pm-issue-log-rulebook.md +23 -35
  207. package/docs/ja/specdojo/rulebooks/pm-members-rulebook.md +27 -45
  208. package/docs/ja/specdojo/rulebooks/pm-organization-rulebook.md +37 -45
  209. package/docs/ja/specdojo/rulebooks/pm-plan-rulebook.md +45 -46
  210. package/docs/ja/specdojo/rulebooks/pm-quality-management-plan-rulebook.md +37 -48
  211. package/docs/ja/specdojo/rulebooks/pm-raci-rulebook.md +25 -29
  212. package/docs/ja/specdojo/rulebooks/pm-risk-register-rulebook.md +28 -35
  213. package/docs/ja/specdojo/rulebooks/pm-roles-rulebook.md +36 -41
  214. package/docs/ja/specdojo/rulebooks/pr-rulebook.md +5 -18
  215. package/docs/ja/specdojo/rulebooks/prj-assumptions-constraints-dependencies-rulebook.md +16 -37
  216. package/docs/ja/specdojo/rulebooks/prj-charter-rulebook.md +23 -97
  217. package/docs/ja/specdojo/rulebooks/prj-comparison-of-alternatives-rulebook.md +39 -57
  218. package/docs/ja/specdojo/rulebooks/prj-issues-and-approach-rulebook.md +43 -116
  219. package/docs/ja/specdojo/rulebooks/prj-scope-rulebook.md +16 -51
  220. package/docs/ja/specdojo/rulebooks/prj-stakeholder-register-rulebook.md +47 -92
  221. package/docs/ja/specdojo/rulebooks/prj-success-criteria-and-acceptance-criteria-rulebook.md +25 -84
  222. package/docs/ja/specdojo/rulebooks/sac-rulebook.md +44 -107
  223. package/docs/ja/specdojo/rulebooks/sf-index-rulebook.md +39 -49
  224. package/docs/ja/specdojo/rulebooks/sf-rulebook.md +42 -49
  225. package/docs/ja/specdojo/rulebooks/sld-rulebook.md +64 -89
  226. package/docs/ja/specdojo/rulebooks/stc-index-rulebook.md +90 -189
  227. package/docs/ja/specdojo/rulebooks/stc-rulebook.md +45 -105
  228. package/docs/ja/specdojo/rulebooks/stsd-mermaid-rulebook.md +6 -12
  229. package/docs/ja/specdojo/rulebooks/stsd-rulebook.md +49 -68
  230. package/docs/ja/specdojo/rulebooks/sysd-critical-flows-rulebook.md +51 -60
  231. package/docs/ja/specdojo/rulebooks/sysd-cross-cutting-policy-rulebook.md +46 -50
  232. package/docs/ja/specdojo/rulebooks/sysd-index-rulebook.md +39 -64
  233. package/docs/ja/specdojo/rulebooks/sysd-rulebook.md +47 -60
  234. package/docs/ja/specdojo/rulebooks/trc-requirements-to-specs-rulebook.md +69 -70
  235. package/docs/ja/specdojo/rulebooks/trc-requirements-to-tests-rulebook.md +65 -72
  236. package/docs/ja/specdojo/rulebooks/tsd-index-rulebook.md +35 -46
  237. package/docs/ja/specdojo/rulebooks/tsd-rulebook.md +49 -66
  238. package/docs/ja/specdojo/rulebooks/tsp-index-rulebook.md +64 -139
  239. package/docs/ja/specdojo/rulebooks/uis-rulebook.md +41 -108
  240. package/docs/ja/specdojo/rulebooks/utc-index-rulebook.md +49 -144
  241. package/docs/ja/specdojo/rulebooks/utc-rulebook.md +67 -155
  242. package/docs/ja/specdojo/samples/bds-sample.md +58 -71
  243. package/docs/ja/specdojo/samples/bes-index-sample.md +20 -37
  244. package/docs/ja/specdojo/samples/bes-sample.md +43 -53
  245. package/docs/ja/specdojo/samples/bps-sample.md +42 -54
  246. package/docs/ja/specdojo/samples/br-sample.md +40 -52
  247. package/docs/ja/specdojo/samples/ccd-sample.md +0 -1
  248. package/docs/ja/specdojo/samples/cdr-sample.md +78 -0
  249. package/docs/ja/specdojo/samples/cdsd-sample.md +47 -63
  250. package/docs/ja/specdojo/samples/clis-sample.md +70 -77
  251. package/docs/ja/specdojo/samples/dec-sample.md +2 -3
  252. package/docs/ja/specdojo/samples/ifx-api-sample.yaml +0 -2
  253. package/docs/ja/specdojo/samples/ifx-msg-sample.yaml +0 -2
  254. package/docs/ja/specdojo/samples/job-sequence.yaml +67 -0
  255. package/docs/ja/specdojo/samples/mip-index-sample.md +98 -20
  256. package/docs/ja/specdojo/samples/pm-communication-plan-sample.md +26 -19
  257. package/docs/ja/specdojo/samples/pm-organization-sample.md +39 -50
  258. package/docs/ja/specdojo/samples/pm-plan-sample.md +61 -67
  259. package/docs/ja/specdojo/samples/pm-quality-management-plan-sample.md +31 -45
  260. package/docs/ja/specdojo/samples/pm-raci-sample.md +31 -37
  261. package/docs/ja/specdojo/samples/prj-assumptions-constraints-dependencies-sample.md +32 -48
  262. package/docs/ja/specdojo/samples/prj-charter-sample.md +42 -59
  263. package/docs/ja/specdojo/samples/prj-comparison-of-alternatives-sample.md +55 -61
  264. package/docs/ja/specdojo/samples/prj-success-criteria-and-acceptance-criteria-sample.md +30 -33
  265. package/docs/ja/specdojo/samples/sf-index-sample.md +13 -55
  266. package/docs/ja/specdojo/samples/sf-sample.md +73 -85
  267. package/docs/ja/specdojo/samples/sld-sample.md +60 -79
  268. package/docs/ja/specdojo/samples/uis-sample.md +98 -121
  269. package/docs/ja/specdojo/standards/job-definition-standard.md +24 -9
  270. package/docs/ja/specdojo/templates/cdr-template.md +58 -0
  271. package/docs/specdojo/schemas/v1/exec-common.schema.yaml +2 -1
  272. package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +42 -5
  273. package/docs/specdojo/schemas/v1/exec-evidence.schema.yaml +35 -0
  274. package/docs/specdojo/schemas/v1/job-run.schema.yaml +23 -0
  275. package/docs/specdojo/schemas/v1/job.schema.yaml +63 -2
  276. package/docs/specdojo/schemas/v1/sch-strategy.schema.yaml +2 -2
  277. package/package.json +9 -6
  278. package/templates/antigravity/orchestrator.md +4 -1
  279. package/templates/claude/agents/specdojo-orchestrator.md +4 -1
  280. package/templates/codex/agents/specdojo-orchestrator.toml +4 -1
  281. package/templates/codex/orchestrator.md +4 -1
  282. package/templates/init-exec-defaults.yaml +13 -0
  283. package/templates/lefthook/tools/specdojo-pre-commit.mjs +8 -0
  284. package/templates/opencode/agents/specdojo-orchestrator.md +5 -2
@@ -13,33 +13,27 @@ specdojo:
13
13
 
14
14
  Acceptance Test Catalog (ATC) Documentation Rules
15
15
 
16
- 本ドキュメントは、受入テストカタログ(ATC)の対象別 `atc-<term>` を統一形式で記述するためのルールです。
17
- `atc-index` を前提に、SSOT の本体として、対象ごとの **受入判断に必要な範囲(責務・境界・観点×条件=ケース、トレース、証跡)** を明文化します。
16
+ 受入テストカタログの対象別文書 `atc-<term>` を、対象ごとの受入判断の範囲(責務・境界・観点とケース・トレース・証跡)が分かる統一形式で記述するためのルールです。
18
17
 
19
18
  ## 1. 全体方針
20
19
 
21
- 個別 ATC(`atc-<term>`)は、受入テストにおける SSOT の本体として、対象ごとの受入判断単位と責務を明確化し、
22
- 観点×条件=ケース(末端表)を最小情報で整理して、実施記録/レポート/ログ等の証跡へ確実に接続できる形で記述する。
20
+ - `atc-<term>` は `atc-index` を前提とする受入テストの正本であり、対象固有の情報だけを書く。共通の方針は `atc-index` を参照し、言い直さない。
21
+ - 目的は関係者が受け入れ可否を判断できることであり、内部実装の網羅や詳細な分岐の確認は扱わない(必要なら別のテストレベルへ送る)。
22
+ - ケースは表の 1 行を 1 受入シナリオとし、手順と期待値を合否判定できる粒度で簡潔に書く。クリック列挙や大量データは実施手順書・実施記録へ寄せ、証跡から参照する。
23
+ - すべての観点とケースを、根拠仕様(トレース)と証跡(実施記録・レポート・ログ)へ接続する。
24
+ - 環境・データ・外部依存の前提は合否の再現性に直結するため、対象固有の差分を必ず書く。
25
+ - 共通の運用: 役割の割り当ては適用先のメンバー定義に、`status` の昇格と承認、改訂と廃止、未決事項の登録簿への引き継ぎは [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] に従い、本書と成果物で言い直さない。文書の整形・lint はリポジトリの検証で扱い、業務の受入確認に含めない。
23
26
 
24
- - `atc-<term>` は **対象固有の情報のみ** を記述し、共通ルールは `atc-index` を参照する(重複記述しない)
25
- - 受入テストの目的は「関係者が受け入れ可否を判断できること」であり、内部実装の網羅や詳細分岐の確認は目的外(必要なら別レベルへ)
26
- - ケースは「表の1行=1受入シナリオ」とし、手順と期待値は **合否判定可能** な粒度で簡潔に書く
27
- - クリック列挙・画面要素の細部・大量データ列挙は避け、必要な詳細は **実施手順書/実施記録** 側へ寄せる(証跡で参照可能にする)
28
- - すべての観点・ケースは、根拠仕様(`based_on` / `トレース`)と、証跡(実施記録/レポート/ログ)に接続されていること
29
- - 環境・データ・外部依存の前提は受入判断の再現性に直結するため、対象ごとの差分は必ず明記する(共通は `atc-index`)
30
-
31
- ## 2. 位置づけ(他ドキュメントとの関係)
32
-
33
- 個別 ATC(`atc-<term>`)と他ドキュメントの関係を示します。
27
+ ## 2. 位置づけ
34
28
 
35
29
  ```mermaid
36
30
  flowchart BT
37
31
  TSP["tsp-index<br>テスト戦略・方針"]
38
32
 
39
- subgraph TC["テストカタログ"]
33
+ subgraph TC["受入テストカタログ"]
40
34
  direction RL
41
- TCIndex["atc-index<br>テスト仕様-全体構成"]
42
- TCDetail["atc-&lt;term&gt;<br>テスト仕様-対象別"]
35
+ TCIndex["atc-index<br>受入テストカタログ(全体構成)"]
36
+ TCDetail["atc-&lt;term&gt;<br>受入テストカタログ(対象別)"]
43
37
  TCDetail -->|based_on| TCIndex
44
38
  end
45
39
 
@@ -50,254 +44,134 @@ flowchart BT
50
44
 
51
45
  classDef target stroke-width:4px
52
46
  class TCDetail target
53
-
54
47
  ```
55
48
 
56
49
  ## 3. ファイル命名・ID規則
57
50
 
58
- - `id` は `atc-<term>`(kebab-case。例: `atc-checkout`)。
59
- - ファイル名は `atc-010-受入テストカタログ-<term>.md` 等(例: `atc-010-受入テストカタログ-会計確定.md`)。
60
- - `<term>` は 用語集(GL) の論理名キー(英小文字kebab-case)を用いる(表示名は title / ファイル名で日本語を使用してよい)。
51
+ - `id` は `atc-<term>`(kebab-case。例: `atc-checkout`)とする。
52
+ - ファイル名は `atc-<term>.md` 等とし、成果物カタログの宣言と一致させる。
53
+ - `<term>` は用語集(GL)の論理名キー(英小文字 kebab-case)を用いる。日本語の表示名は H1 に書く(例: `# 受入テストカタログ: 会計確定`)。
61
54
 
62
55
  ## 4. 推奨 Frontmatter 項目
63
56
 
64
- ### 4.1. 設定内容
65
-
66
- Frontmatter は共通スキーマに従います(あわせてドキュメントのメタ情報の記述ルールも参照)。
67
-
68
- - 参照スキーマ: [docs/specdojo/schemas/v1/deliverable-frontmatter.schema.yaml](../../../specdojo/schemas/v1/deliverable-frontmatter.schema.yaml)
69
- - メタ情報標準: [document-metadata-standard.md](../standards/document-metadata-standard.md)
70
-
71
- | 項目 | 説明 | 必須 |
72
- | ---------- | -------------------------------------------------------------------------------- | ---- |
73
- | id | ATC ID(個別: `atc-<term>`) | ○ |
74
- | type | `test` 固定 | ○ |
75
- | title | 受入テストカタログ: <対象名> | ○ |
76
- | status | `draft` / `ready` / `deprecated` | ○ |
77
- | based_on | 根拠仕様(最低限: `tsp-index`, `atc-index`。対象固有の根拠は本文トレースに集約) | ○ |
78
- | part_of | 集約ドキュメントへの所属(ID配列) | 任意 |
79
- | supersedes | 置き換え関係 | 任意 |
80
-
81
- ### 4.2. 推奨ルール
82
-
83
- - `based_on` は原則 `[tsp-index, atc-index]` を最低限とする。
84
- - 対象固有の根拠(`br-*` / `bac-*` / `spec-*` / `ac-*` / `nfr-*` 等)は本文「トレース」に集約する。
85
- 機械処理上の都合で `based_on` にも列挙する場合は、本文トレースと矛盾しないこと。
86
- - 記述内容が多くなる場合はドキュメントを分割し、`part_of` で集約ドキュメントに所属させる。
87
- - `part_of` / `based_on` / `supersedes` は ID 配列(未指定は `[]` 可)。
88
-
89
- ## 5. 本文構成(標準テンプレ)
90
-
91
- 個別 ATC(`atc-<term>`)は以下の見出し構成を **順序固定** で配置します。
92
-
93
- | 番号 | 見出し | 必須 |
94
- | ---- | --------------------------- | ---- |
95
- | 1 | 概要(`<term>`) | ○ |
96
- | 2 | 受入の責務(成果/完了条件) | ○ |
97
- | 3 | 対象外 | ○ |
98
- | 4 | 環境/データ/外部依存 | ○ |
99
- | 5 | トレース | ○ |
100
- | 6 | 受入観点とケース | ○ |
101
-
102
- 注意:次章の記述ガイドのMarkdown見出しはルール文章内の参照用であり、
103
- 生成する `atc-<term>` 本文の見出しは各章で指定された **番号付き** の形式に置き換えてください。
104
-
105
- ## 6. 記述ガイド
106
-
107
- ### 6.1. 概要(`<term>`)
108
-
109
- 生成する `atc-<term>` 本文の見出しは **## 1. 概要(&lt;term&gt;)**
110
-
111
- 本節では、対象(`<term>`)が何であり、どの受入判断単位を本カタログで扱うかを簡潔に示します。
112
-
113
- - `<term>` の説明(1〜3行):業務成果(ユーザ価値)として説明する
114
- - 期待する利用者:PO/利用部門/QA/運用が、前提を把握できる内容にする
115
- - 対象の粒度:`atc-index` の分割基準に従い、過分割/肥大化を避ける
116
- - 関連する業務フロー名・主要画面/主要I/F(任意):入口を示すために列挙してよい
117
- - 詳細な仕様説明や背景は書かない(根拠はトレースで示す)
118
-
119
- ### 6.2. 受入の責務(成果/完了条件)
120
-
121
- 生成する `atc-<term>` 本文の見出しは **## 2. 受入の責務(成果/完了条件)**
122
-
123
- 本節では、「この対象が受入で何を保証すべきか(受入判断の責務)」を列挙します。
124
-
125
- - 箇条書きで 3〜7 個程度を目安に、**成果が分かる動詞**で記述する
126
- - 例:注文が確定できる/取消できる/通知が届く/監査証跡が残る/権限で拒否される
127
-
128
- - 責務は「観点」の上位概念(責務≠観点)。観点は責務を分解した切り口
129
- - 正常系だけでなく、受入判断に必要な重要分岐(代表失敗/復帰/やり直し等)も含める
130
- - 可能なら「観測できる成果(画面、帳票、通知、ログ相関ID等)」とセットで書く
131
- - 責務に含まれないものは「対象外」へ移す
132
-
133
- ### 6.3. 対象外
134
-
135
- 生成する `atc-<term>` 本文の見出しは **## 3. 対象外**
136
-
137
- 本節では、「この対象カタログ(`atc-<term>`)ではやらないこと」を明示します。
138
- `atc-index` の「対象外・除外理由(共通)」と矛盾しないことが前提です。
139
-
140
- - 対象外は「なぜ除外するか(理由)」とセットで書く
141
- - 可能なら「代替するレベル/手段」(ST/NFR/互換試験/運用検証 等)も併記する
142
- - 対象固有の対象外(例:別業務成果、別termの責務)を明確にする
143
- - 例外としてATで扱う場合は、条件・根拠・前提(環境/データ)を明記する
144
-
145
- 推奨フォーマット(簡易):
146
-
147
- - 対象外:xxx(理由:yyy、代替:zzz)
148
-
149
- ### 6.4. 環境/データ/外部依存
57
+ 許可キー・必須項目・型制約は [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] と `docs/specdojo/schemas/v1/deliverable-frontmatter.schema.yaml` を正本とする。
150
58
 
151
- 生成する `atc-<term>` 本文の見出しは **## 4. 環境/データ/外部依存**
59
+ - `specdojo.type` は `test`、`specdojo.rulebook` は `specdojo:atc-rulebook` とする。
60
+ - `specdojo.based_on` は原則 `tsp-index` と `atc-index` とし、実際に読んで直接の根拠とした作成済み文書だけを加える。
61
+ - 検証する上流の受入条件(`bac-*`・`ac-*` 等)は `specdojo.relations.verifies` に宣言する。本文「トレース」の `TR-xx` は項目単位の対応で、`relations.verifies` の ID を含むこと。上流の受入条件が変わったときは、`relations.verifies` から影響する ATC を特定し、該当する `TR-xx` を参照するケースを見直す。
62
+ - 分割した場合は `part_of` で集約文書に所属させ、置き換える場合は `supersedes` を用いる。
152
63
 
153
- 本節では、受入シナリオの合否が揺れないよう、対象固有の前提(差分)を明確にします。
154
- 共通方針は `atc-index` に従い、ここでは **対象固有の追加/例外** を中心に書きます。
155
-
156
- - 環境:
157
- - 代表構成(端末/ブラウザ/ロール)に対象固有の追加がある場合は明記
158
- - バージョン識別(タグ/ビルド番号)を証跡にどう残すか(差分があれば明記)
159
-
160
- - データ:
161
- - 必要な前提データ(顧客/商品/権限/状態など)を「データセットID」等で参照可能にする
162
- - 初期化/後始末が対象固有で必要なら明記(例:採番の戻し、外部の受信箱掃除)
163
-
164
- - 外部依存:
165
- - sandbox/疑似の接続先、確認手段(管理画面、受信箱、ダッシュボード、ログ)を明記
166
- - 外部依存が不安定な場合の扱い(再試行可否、判定保留条件など)が必要なら明記
167
-
168
- - 観測点(アサーション):
169
- - 画面・帳票・通知・ログ相関IDなど「誰が見ても判定できる」観測点を整理してよい
170
-
171
- ### 6.5. トレース
172
-
173
- 生成する `atc-<term>` 本文の見出しは **## 5. トレース**
174
-
175
- 本節では、`atc-<term>` の根拠となる上位成果物との対応関係(トレーサビリティ)を示します。
176
- 本カタログにおけるトレースの一次情報(SSOT)は **`## 5. トレース`** とし、観点・ケース表では **trace_key(`TR-xx`)参照** に統一します。
177
-
178
- #### 6.5.1. 記述ルール(trace_key)
179
-
180
- - 各トレース項目に **trace_key(`TR-xx`)** を付与する(例:`TR-01`, `TR-02` …、01始まり推奨)
181
- - `trace_key` は **本ドキュメント内で一意**で、原則変更しない
182
- - 観点・ケース表の `トレース` 列には **仕様IDを直書きせず**、`TR-xx` を列挙する
183
- - ケース表に新しい根拠が必要になった場合は、**先に本節の表へ行追加**し、付与された `TR-xx` をケース表で参照する
184
- - 採番は追加順。並び替えても trace_key は維持する。削除しても欠番は詰めない
64
+ ```yaml
65
+ ---
66
+ specdojo:
67
+ id: atc-checkout
68
+ type: test
69
+ status: draft
70
+ rulebook: specdojo:atc-rulebook
71
+ based_on: [tsp-index, atc-index]
72
+ relations:
73
+ verifies: [bac-checkout]
74
+ ---
75
+ ```
185
76
 
186
- #### 6.5.2. トレース表(標準フォーマット)
77
+ ## 5. 本文要件
187
78
 
188
- | trace_key | 仕様ID | 要点 | 備考 |
189
- | --------- | ------ | ------- | ---- |
190
- | TR-01 | ac-... | (1行) | 任意 |
191
- | TR-02 | br-... | (1行) | 任意 |
79
+ 本文は次の章を順序固定で置く。すべて必須とする。
192
80
 
193
- - `要点` は「受入判断に使ったポイント」を **1行**で書く(冗長な仕様説明はしない)
81
+ | 章 | 内容・受入条件 |
82
+ | --------------------------- | -------------------------------------------------------------------------------------------------------------- |
83
+ | 概要(`<term>`) | 対象が何で、誰がどの受入判断に使うか、`atc-index` の分割基準に沿った対象の粒度が分かる |
84
+ | 受入の責務(成果/完了条件) | 受入で保証する成果を 3〜7 個程度、観測できる成果とともに示す。正常系に加え代表的な失敗・復帰・やり直しを含める |
85
+ | 対象外 | 除外する事項を理由と代替手段(ST・NFR・運用検証等)とともに示し、`atc-index` の共通の対象外と矛盾しない |
86
+ | 環境/データ/外部依存 | 対象固有の環境・データセット・初期化・外部依存の確認手段と、外部依存が不安定なときの判定保留条件を示す |
87
+ | トレース | 根拠仕様を `trace_key`(`TR-xx`)付きの表で示す。トレースの正本はこの章とする |
88
+ | 受入観点とケース | 観点ごとに `### 6.n. 観点:<観点名>`、その下に `#### 6.n.1. 意図` と `#### 6.n.2. 条件・ケース表` を置く |
194
89
 
195
- ### 6.6. 受入観点とケース
90
+ ### 5.1. トレース表の列
196
91
 
197
- 生成する `atc-<term>` 本文の見出しは **## 6. 受入観点とケース**
92
+ | 列 | 必須 | 内容 |
93
+ | ----------- | ---- | -------------------------------------------------------------- |
94
+ | `trace_key` | ○ | `TR-01` からの追加順の連番。並べ替え・削除しても番号を変えない |
95
+ | 仕様ID | ○ | 根拠とする受入条件・業務ルール・仕様の ID |
96
+ | 要点 | ○ | 受入判断に使ったポイントを 1 行で書く |
97
+ | 備考 | 任意 | 補足 |
198
98
 
199
- 本節は `atc-<term>` の中心です。観点(見出し)→ ケース表(末端表)の順で構成します。
99
+ ### 5.2. 条件・ケース表の列
200
100
 
201
- #### 6.6.1. 観点:<観点>
101
+ 次の列をこの順序で置く。
202
102
 
203
- 生成する `atc-<term>` 本文の見出しは **### 6.1. 観点:<観点>**
103
+ | 列 | 必須 | 内容 |
104
+ | ---------------------- | ---- | ------------------------------------------------------------------------------ |
105
+ | `case_id` | ○ | `at-<term>-<perspective_key>-<nnn>`。`nnn` は 3 桁 10 刻み。変更・再利用しない |
106
+ | 条件 | ○ | 入力・状態・環境・経路のうち必要な要素 |
107
+ | 手順(最小) | ○ | 操作の意図が分かる高位の手順 |
108
+ | 期待値 | ○ | 観測点で合否を判定できる結果 |
109
+ | 観測点(アサーション) | ○ | 画面・帳票・通知・ログ相関 ID など誰が見ても判定できる確認先 |
110
+ | 環境/依存 | 任意 | 「環境/データ/外部依存」の章と異なる前提があるときだけ書く |
111
+ | トレース | ○ | 「トレース」の章の `TR-xx`。仕様 ID を直書きしない |
112
+ | 優先度 | ○ | `P0`: 不合格なら受入不可。`P1`: 重要な分岐で、不合格時は条件付き受入を判断する |
113
+ | 実施形態 | ○ | `manual`(人が実施して記録)または `automated`(自動テストの結果を証跡にする) |
114
+ | 証跡 | ○ | 実施記録 ID・保存先・ログ相関 ID など実施記録とレポートへ辿れる参照 |
204
115
 
205
- - 観点は `atc-index` の「受入観点の立て方(共通)」に従って命名する
206
- - 観点の粒度は「条件が複数ぶら下がる」程度にまとめる(細かすぎる観点の乱立を避ける)
207
- - 観点名(見出し)は改善のため変更してよいが、`perspective_key` は原則変更しない(変更が必要なら `supersedes` 等で追跡する)
116
+ `perspective_key` は kebab-case とし、観点名を直しても変えない。
208
117
 
209
- ##### 6.6.1.1. 意図
118
+ ## 6. 記述ガイド
210
119
 
211
- 生成する `atc-<term>` 本文の見出しは **#### 6.1.1. 意図**
120
+ 完成例は Frontmatter の `sample` で宣言された sample を参照する。各章は次の判断基準と例に従う。
212
121
 
213
- - 観点ごとに「意図(この観点で受入として保証すること)」を 1〜2 行で書く
122
+ ### 6.1. 概要と受入の責務
214
123
 
215
- ##### 6.6.1.2. 条件・ケース表
124
+ - 判断基準: 責務は観点の上位概念で、成果が分かる動詞で書かれ、責務に含まれないものは「対象外」にあること。
125
+ - 良い例: 「確定後にレシートと取引 ID が参照できる」。
126
+ - 悪い例: 「会計処理が正しく動く」(観測できる成果がない)。
216
127
 
217
- 生成する `atc-<term>` 本文の見出しは **#### 6.1.2. 条件・ケース表**
128
+ ### 6.2. 対象外と環境/データ/外部依存
218
129
 
219
- - ケース表の 1 行は「1受入シナリオ」を表す(条件×期待値が一意)
220
- - `case_id` は以下を推奨し、原則変更しない
221
- - 形式:`<level>-<term>-<perspective_key>-<nnn>`
222
- - `level`:`at`
223
- - `perspective_key`:kebab-case(英小文字+数字+ハイフン)。原則変更しない
224
- - `nnn`:3桁、10刻み(010,020,030…)推奨
130
+ - 判断基準: 対象外に理由と代替があり、前提データがデータセット ID 等で参照でき、外部依存の確認手段と判定保留条件が分かること。
131
+ - 良い例: 「対象外: 決済ゲートウェイの内部ロジック(理由: 外部責務、代替: 提供者の仕様・監査)」「外部依存: 決済は sandbox。応答がない場合は判定保留とし再実施する」。
132
+ - 悪い例: 「外部連携は適宜確認する」(確認手段も保留条件もない)。
225
133
 
226
- - 条件は「入力/状態/環境/経路」で表現する(必要な要素だけ書く。直積は禁止)
227
- - 手順は高位の最小手順で書く(クリック列挙は禁止。操作の意図がわかる粒度)
228
- - 期待値は判定可能に書く(画面・帳票・通知・ログ相関ID等の観測点を含める)
229
- - 証跡は実施記録とレポートへ接続できる形で書く(例:実施記録ID、保存先、ログ相関ID)
134
+ ### 6.3. 受入観点とケース
230
135
 
231
- 推奨:観点ごとのケース数は「代表(P0)→重要分岐(P0/P1)→重大リスク(P0)」の順で増やし、直積(全組合せ)を避ける
136
+ - 判断基準: 観点は `atc-index` の観点の立て方に従い、条件が複数ぶら下がる粒度にまとめ、意図を 1〜2 行で書くこと。ケースは代表(`P0`)、重要な分岐(`P0`・`P1`)、重大なリスク(`P0`)の順に増やし、直積を避けること。
137
+ - 良い例: 「期待値: 会計が確定し、取引 ID・帳票・通知が確認できる」(行の全体は「サンプル(最小)」を参照)。
138
+ - 悪い例: 「期待値: 問題がないこと」(合否判定できず証跡にならない)。
232
139
 
233
140
  ## 7. 禁止事項
234
141
 
235
- | 禁止事項 | 理由 |
236
- | -------------------------------------------------------------------------- | ------------------------------------------------------------------ |
237
- | `atc-index` の共通方針を `atc-<term>` 側で勝手に上書きする | 受入判断の一貫性が崩れ、合意・監査・追跡が困難になるため |
238
- | ケース表にUIクリック手順や画面要素の細部を大量に列挙する | 変更に弱く、受入の意図が読めなくなるため |
239
- | 期待値を曖昧に書く(例:「問題がないこと」「使えること」「ちゃんと表示」) | 合否判定不能で証跡にならないため |
240
- | `case_id` を変更する/再利用する | トレース・証跡リンクが破壊され、履歴追跡が不能になるため |
241
- | `perspective_key` を観点名の修正に合わせて頻繁に変える | ID体系が不安定になり参照が壊れるため |
242
- | 直積(全組合せ)のケースを無条件に作る | ケース爆発で運用不能になるため(必要時は理由・範囲を明記) |
243
- | トレースや証跡を持たないケースを恒久的に残す | SSOTとして成立しないため(暫定なら期限/条件を明記) |
244
- | 外部依存が不安定なまま合否判定をする(判定条件/保留条件の定義なし) | 受入判断が揺れて合意が崩れるため(必要なら「判定保留条件」を明記) |
142
+ | 禁止事項 | 理由 |
143
+ | ------------------------------------------------------------------------ | -------------------------------------------------------- |
144
+ | `atc-index` の共通方針を `atc-<term>` 側で上書きする | 受入判断の一貫性が崩れ、合意と追跡が困難になるため |
145
+ | ケース表に UI のクリック手順や画面要素の細部を列挙する | 変更に弱く、受入の意図が読めなくなるため |
146
+ | 期待値を曖昧に書く(例: 「問題がないこと」「使えること」) | 合否判定できず証跡にならないため |
147
+ | `case_id` を変更・再利用する、`perspective_key` を観点名に合わせて変える | トレースと証跡の参照が壊れるため |
148
+ | 理由・範囲を書かずに直積のケースを作る | ケースが爆発して運用できなくなるため |
149
+ | トレースや証跡のないケースを期限・条件なしで残す | 受入の根拠として成立しないため |
150
+ | 判定保留条件を定めずに不安定な外部依存のまま合否を判定する | 受入判断が揺れて合意が崩れるため |
151
+ | ケース表の `トレース` 列に仕様 ID を直書きする | トレースの正本が二重になり、上流の変更に追従できないため |
245
152
 
246
153
  ## 8. サンプル(最小)
247
154
 
248
- 注:以下はルール文書内の例示です。生成する `atc-<term>` では `## 1...` から始まります。
249
-
250
- ```yaml
251
- ---
252
- id: atc-checkout
253
- type: test
254
- title: 受入テストカタログ: 会計確定(checkout)
255
- status: draft
256
- part_of: []
257
- based_on: [tsp-index, atc-index]
258
- supersedes: []
259
- ---
260
- ```
261
-
262
- ### 8.1. 概要(checkout)
263
-
264
- 店頭販売における会計確定(支払い→確定→レシート/通知→在庫/売上反映)を受入判断単位として扱う。
155
+ 完成例を sample へ外出しするまでの経過措置として、本文の輪郭だけを示す。
265
156
 
266
- ### 8.2. 受入の責務(成果/完了条件)
157
+ ```markdown
158
+ ## 5. トレース
267
159
 
268
- - 正常な支払いが完了し、会計が確定できる
269
- - 確定後にレシート(帳票)と取引識別子が参照できる
270
- - 取消(または返金)により取引が期待どおりに無効化され、証跡が残る
160
+ | trace_key | 仕様ID | 要点 | 備考 |
161
+ | --------- | ------------- | ------------------------ | ---- |
162
+ | TR-01 | ac-checkout-1 | 支払い成功時に確定できる | |
271
163
 
272
- ### 8.3. 対象外
164
+ ## 6. 受入観点とケース
273
165
 
274
- - 決済ゲートウェイの内部ロジックの詳細(理由:外部責務、代替:提供者の仕様/監査)
275
- - 性能の厳密測定(理由:受入の枠外、代替:NFR)
166
+ ### 6.1. 観点:会計確定の成立
276
167
 
277
- ### 8.4. 環境/データ/外部依存
168
+ #### 6.1.1. 意図
278
169
 
279
- - 環境:UAT(代表端末: iPad / 代表ブラウザ: Chrome)
280
- - データ:受入データセット `DS-CHK-01`(商品/顧客/権限ロール)
281
- - 外部依存:決済は sandbox、通知は検証用受信箱で確認
282
- - 観測点:取引ID、帳票PDF、通知メール件名、ログ相関ID
170
+ 代表シナリオで、支払いから会計確定までが成立することを保証する。
283
171
 
284
- ### 8.5. トレース
172
+ #### 6.1.2. 条件・ケース表
285
173
 
286
- | trace_key | 仕様ID | 要点 | 備考 |
287
- | --------- | ------------- | ----------------------------- | ---- |
288
- | TR-01 | ac-checkout-1 | 支払い成功時に確定できる | |
289
- | TR-02 | ac-checkout-2 | 取消時に帳票/証跡が更新される | |
290
-
291
- ### 8.6. 受入観点とケース
292
-
293
- #### 8.6.1. 観点:会計確定の成立
294
-
295
- ##### 8.6.1.1. 意図
296
-
297
- 代表シナリオで、支払い完了から会計確定までが成立し、必要な成果物が確認できることを保証する。
298
-
299
- ##### 8.6.1.2. 条件・ケース表
300
-
301
- | case_id | 条件 | 手順(最小) | 期待値 | 観測点(アサーション) | 環境/依存 | トレース | 優先度 | 実施形態 | 証跡 |
302
- | -------------------------------- | -------------------------------------------- | ------------------------------- | ------------------------------------------ | --------------------------------- | ------------ | -------- | ------ | -------- | -------------------------------- |
303
- | at-checkout-checkout-success-010 | 状態: 正常顧客 / 入力: 正常商品 / 経路: 成功 | 商品を選択し支払い→確定まで実施 | 会計が確定し取引ID・帳票・通知が確認できる | 取引ID、帳票PDF、通知件名、相関ID | 決済=sandbox | TR-01 | P0 | manual | 実施記録#A-1001 / ログ相関ID=... |
174
+ | case_id | 条件 | 手順(最小) | 期待値 | 観測点(アサーション) | 環境/依存 | トレース | 優先度 | 実施形態 | 証跡 |
175
+ | -------------------------------- | -------------------------- | --------------------- | ------------------------------------------ | ------------------------- | --------- | -------- | ------ | -------- | --------------- |
176
+ | at-checkout-checkout-success-010 | 状態: 正常顧客、経路: 成功 | 商品を選び支払い→確定 | 会計が確定し取引ID・帳票・通知が確認できる | 取引ID、帳票PDF、通知件名 | | TR-01 | P0 | manual | 実施記録#A-1001 |
177
+ ```
@@ -14,27 +14,22 @@ specdojo:
14
14
 
15
15
  Business Acceptance Criteria Documentation Rulebook
16
16
 
17
- 業務担当者が「この仕組みで業務を進められる」と判断するための受入条件を定めます。利用場面、前提、業務行為、観測可能な期待結果を対応させ、承認と受入テスト設計に渡せる粒度を規定します。
17
+ 業務担当者が「この仕組みで業務を進められる」と判断するための受入条件を、受入テスト設計に渡せる粒度で定めます。
18
18
 
19
19
  ## 1. 全体方針
20
20
 
21
21
  - [[specdojo:deliverables-reference|成果物リファレンス]] の業務受入条件として、業務仕様が利用者の課題を解決するかを合意・確認する基準を定める。仕様が存在するだけでは業務を進められると判断できないため、利用場面と確認できる結果へ具体化する。
22
- - 1 文書で一つの受入対象(業務の塊)を扱い、対象者の課題と期待価値に結び付くシナリオを選ぶ。
22
+ - 1 文書で一つの受入対象(一連の結果として業務担当者が受け入れる業務の範囲)を扱い、対象者の課題と期待価値に結び付くシナリオを選ぶ。
23
23
  - 決定済みの業務仕様を受入条件へ変換する。新しい業務判断、閾値、例外承認を BAC で確定しない。
24
24
  - 期待結果は状態、記録、引き継ぎなど観測できる事実にする。実装や画面の手順を受入基準の代替にしない。
25
25
  - 共通事項は上位の index・標準を正本とし、構文・値・保存構造は schema・リファレンスへ委譲する。
26
+ - 共通の運用: 役割の割り当ては適用先のメンバー定義に、`status` の昇格と承認、改訂と廃止、未決事項の登録簿への引き継ぎは [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] に従い、本書と成果物で言い直さない。文書の整形・lint はリポジトリの検証で扱い、業務の受入確認に含めない。
26
27
 
27
- ## 2. 位置づけと用語定義
28
+ ## 2. 位置づけ
28
29
 
29
- BAC は BPS や業務ルール、プロジェクトの受入条件を根拠に、業務としての成立を確認する要求である。BA が作成し、PO が業務的な妥当性を承認する。ARC は設計への入力として、QE は受入テスト設計への入力として利用する。テストの詳細手順と実行結果は BAC に含めない。
30
+ BAC は BPS や業務ルール、プロジェクトの受入条件を根拠に業務としての成立を確認する要求であり、設計と受入テスト設計への入力になる。テストの詳細手順と実行結果は含めない。
30
31
 
31
- [[specdojo:track-design-guide|トラック設計ガイド]] の品質仕様カテゴリで業務仕様を受け取り、受入テスト仕様とその実施へ渡す。BPS の業務の流れ、BR の判断規則、UIS の利用者操作、BES の業務イベントと発生条件を、業務の開始から結果まで横断して確認する。各仕様の定義は入力元を正本とし、BAC はそれらの組合せで業務が成立する条件を担う。
32
-
33
- | 用語 | 本系統での意味 |
34
- | -------- | ---------------------------------------------------------- |
35
- | 受入対象 | 一連の結果として業務担当者が受け入れる能力・業務の範囲 |
36
- | シナリオ | 特定の開始状態から、業務行為を経て期待結果を確認する一単位 |
37
- | 判定方法 | 誰が、どの時点で、何の証跡を照合して期待結果を確認するか |
32
+ [[specdojo:track-design-guide|トラック設計ガイド]] の品質仕様カテゴリで業務仕様を受け取り、受入テスト仕様とその実施へ渡す。BPS の業務の流れ、BR の判断規則、UIS の利用者操作、BES の業務イベントを業務の開始から結果まで横断して確認し、各仕様の定義は入力元を正本とする。
38
33
 
39
34
  ## 3. ファイル命名・ID規則
40
35
 
@@ -44,13 +39,12 @@ BAC は BPS や業務ルール、プロジェクトの受入条件を根拠に
44
39
 
45
40
  ## 4. 推奨 Frontmatter 項目
46
41
 
47
- メタ情報の型・許可値・キーの配置・必須項目は [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] と [成果物 Frontmatter schema](../../../specdojo/schemas/v1/deliverable-frontmatter.schema.yaml) を正本とする。SpecDojo の項目は `specdojo` 名前空間配下に置く。
42
+ メタ情報の型・許可値・キーの配置・必須項目は [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] と `docs/specdojo/schemas/v1/deliverable-frontmatter.schema.yaml` を正本とする。
48
43
 
49
- - `type` は業務受入基準を表す `requirement` とし、必須の `rulebook` に本 rulebook の ID を宣言する。文書の名称は H1 に置く。
44
+ - `type` は業務受入基準を表す `requirement` とし、必須の `rulebook` に本 rulebook の ID を宣言する。
50
45
  - `based_on` は受入条件の根拠となる先行成果物を示す。カタログ管理下では `depends_on` の範囲に従い、プロジェクト文脈をそのまま転記しない。
51
- - 作成・改訂中の文書は `draft` とする。`part_of` は親 BAC がある場合、`supersedes` は旧 BAC を置き換える場合に用いる。
46
+ - `part_of` は親 BAC がある場合、`supersedes` は旧 BAC を置き換える場合に用いる。
52
47
  - 要求の充足やテストからの検証関係はメタ情報標準の「型付き参照」を使う。根拠を示す `based_on` と区別し、独自の関係キーを追加しない。
53
- - 改訂・廃止はメタ情報標準の「文書の改訂・廃止とライフサイクル変更管理」に従う。BA が理由・代替先・移行時期と影響を整理し、PO が判断する。BA はカタログと BPS・BR 等の本文参照、ARC は設計、QE は受入テスト仕様・ケースと再検証、PM は追従作業と期限を担当する。ID・シナリオ ID または条件を変える場合は旧参照を検索し、参照先と期待値を更新して参照切れがないことを確認する。
54
48
 
55
49
  ## 5. 本文要件
56
50
 
@@ -58,9 +52,9 @@ BAC は BPS や業務ルール、プロジェクトの受入条件を根拠に
58
52
 
59
53
  | 扱う内容 | 必須 | 成立条件 |
60
54
  | --------------- | ---- | ------------------------------------------------------------------------------------------------------------------------------------- |
61
- | 概要 | ○ | 受入対象、対象者、守る価値、利用場面、対象範囲と対象外、根拠が分かる。確認者・承認者と合意対象を示す |
55
+ | 概要 | ○ | 受入対象、対象者、守る価値、利用場面、対象範囲と対象外、根拠が分かる。業務側の確認者と合意対象を示す |
62
56
  | 受入条件 | ○ | シナリオごとに ID、根拠、前提、操作、期待結果、判定方法を対応させる。正常経路と、業務上結果が異なる例外・停止・再開を必要な範囲で扱う |
63
- | メモ / 将来課題 | ○ | 未確定事項の影響、判断依頼先、解消時点・条件を記す。未決がなければ「なし」と明記する |
57
+ | メモ / 将来課題 | ○ | 未確定事項の論点と、影響するシナリオ・当面の扱いを記す。未決がなければ「なし」と明記する |
64
58
 
65
59
  ### 5.1. シナリオの記述規約
66
60
 
@@ -69,12 +63,11 @@ BAC は BPS や業務ルール、プロジェクトの受入条件を根拠に
69
63
  - 判定方法は必須とし、期待結果の各項目に確認者、確認時点、観測先(記録・画面・帳票等)、照合対象を対応させる。前提と入力から期待結果を導けない箇所は未決事項へ送る。
70
64
  - 同じ操作と観測点で条件だけが変わる場合はケース表へまとめてよい。停止範囲や再開先が異なる場合はシナリオを分ける。
71
65
 
72
- ### 5.2. 確認完了と確定の条件
66
+ ### 5.2. 確認完了の条件
73
67
 
74
- - BA は、概要の価値・対象範囲に必要なシナリオがそろい、各シナリオの根拠と `based_on` が有効な先行成果物へ解決できることを確認する。カタログ管理下では依存関係との整合も確認する。
75
- - QE は、全シナリオに前提・操作・観測可能な期待結果・判定方法があり、正常経路と必要な例外・停止・再開を判断できることを確認する。ARC は設計への引き渡しと参照の整合を確認する。
76
- - BA・QE は、メタ情報標準の「バリデーション」とリポジトリの検査設定に従う。本リポジトリでは `npm run lint:md` と `npm run lint:fm` が終了コード 0 となり、Markdown・Frontmatter・参照にエラーがないことを確認する。失敗箇所を修正して再検査する。executor / reporter pipeline では設定済みの親検証結果を用いる。
77
- - PO は業務側の確認者との合意と、受入の合否を左右する未確定事項の解消を確認して確定を判断する。PM は残る準備作業の担当・判断時点・追跡先を確認する。`ready` への昇格は人が行い、文書の確定を受入試行の合格実績とは扱わない。
68
+ - 概要の価値・対象範囲に必要なシナリオがそろい、各シナリオの根拠と `based_on` が有効な先行成果物へ解決できる。カタログ管理下では依存関係とも整合する。
69
+ - 全シナリオに前提・操作・観測可能な期待結果・判定方法があり、正常経路と必要な例外・停止・再開を判断できる。
70
+ - 受入の合否を左右する未確定事項が残っていない。文書の確定を受入試行の合格実績とは扱わない。
78
71
 
79
72
  ## 6. 記述ガイド
80
73
 
@@ -98,12 +91,10 @@ BAC は BPS や業務ルール、プロジェクトの受入条件を根拠に
98
91
 
99
92
  ### 6.3. メモ / 将来課題
100
93
 
101
- - 判断基準: 現行の受入を止める論点と将来の拡張を区別でき、誰のどの判断で解消するかが分かること。
102
- - 記録規約: 確認・追記作業には `_TODO_`、意思決定待ちには `_UNDECIDED_` を付ける。推奨列は「論点 / 影響するシナリオ ID・受入への影響 / 担当・判断者 / 判断時点・解消条件 / 追跡先」。解決した記述は確定内容へ更新し、ラベルを外す。
103
- - 管理への接続: 将来追加するシナリオは対象外の範囲と追加条件を BAC に残す。現行の受入、期限、依存先に影響する未確定事項は PJR 登録候補とし、BA が影響を整理して PM へ渡す。課題・リスク・変更要求・決定の追跡は [[specdojo:pjr-rulebook|プロジェクト登録簿 作成ルール]] に従い、登録後は BAC に受入への影響と個票への参照を残す。
104
- - 上流変更への追従: `based_on` 先の改訂・廃止、業務判断や受入範囲の変更時に、BA が影響するシナリオと期待値を特定する。未確定の判断は入力元へ戻し、確定後に BAC と参照を更新する。QE が判定方法と後続テストを再確認し、PO が変更後の業務条件を承認するまで、旧条件で受入を確定しない。追従作業は PM が PJR で管理する。
105
- - 良い例: 「`_UNDECIDED_`: 記録不能時に販売を続けるかは店主代表が当該シナリオ作成前に判断する。現行は記録可能な場合に限定し、BA が販売停止への影響を整理して PM へリスク登録候補として渡す」。
106
- - 悪い例: 「例外は今後検討」。影響範囲と次の判断が不明である。
94
+ - 判断基準: 現行の受入を止める論点と将来の拡張を区別でき、影響するシナリオと当面の扱いが分かること。確認・追記作業には `_TODO_`、意思決定待ちには `_UNDECIDED_` を付け、解決したら確定内容へ更新してラベルを外す。
95
+ - 将来追加するシナリオは対象外の範囲と追加条件を残す。`based_on` 先や受入範囲の変更時は影響するシナリオと期待値を特定し、変更後の業務条件が確定するまで旧条件で受入を確定しない。
96
+ - 良い例: 「`_UNDECIDED_`: 記録不能時に販売を続けるか。現行は記録可能な場合に限定し、当該経路の受入は保留して現行シナリオの合格で代替しない」。
97
+ - 悪い例: 「例外は今後検討」。影響範囲と当面の扱いが不明である。
107
98
 
108
99
  ## 7. 禁止事項
109
100