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
@@ -13,76 +13,49 @@ specdojo:
13
13
 
14
14
  Acceptance Test Catalog (ATC) Index Documentation Rules
15
15
 
16
- 本ドキュメントは、受入テストカタログ(ATC)の全体概要 `atc-index` を統一形式で記述するためのルールです。
17
- TSPに基づき、受入テストに共通するルールや方針を定義します。
18
-
19
- 個別受入テストカタログ(`atc-<term>`)の記述ルールは `atc-rulebook.md` を参照してください。
16
+ TSP に基づき、受入テストカタログの全体概要 `atc-index` に記述する共通方針・合格基準・証跡の要件を定めます。対象別カタログは [[specdojo:atc-rulebook|受入テストカタログ 対象別 作成ルール]] に従います。
20
17
 
21
18
  ## 1. 全体方針
22
19
 
23
- `atc-index` は、受入テストカタログ(ATC)を **運用可能な最小情報** で統一し、
24
- 対象別カタログ(`atc-<term>`)の品質と一貫性を担保するための **共通ルール(SSOT)** とする。
25
-
26
- - `atc-index` は **「考え方・共通方針・共通定義」** を記述する(個別ケースは持たない)
27
- - 個別の受入観点・条件・ケースは **`atc-<term>` に集約** し、詳細は **テスト実施記録/レポート/証跡** に寄せる
28
- - 記述は **合意形成(顧客/PO/QA)に耐える** ことを優先し、長文化を避ける(方針は箇条書き中心)
29
- - 「対象外」や「合否判定の原則」を明示し、受入テストの責任境界(何をもって受け入れるか/受け入れないか)を固定する
30
- - `tsp-index` の方針を根拠として、受入テストに共通する **対象単位・観点/条件の立て方・環境前提・合格基準・証跡** を定義する
20
+ - `atc-index` は受入判断の対象単位・共通定義・方針の正本とし、個別の観点・条件・ケースは `atc-<term>`、実施の詳細は実施記録・レポート・証跡に置きます。
21
+ - 顧客・利用部門が合意できる粒度で、対象外、受入全体の合格基準、判定の流れを明示します。
22
+ - `tsp-index` を根拠に、対象の分割、観点と条件の採用、環境前提、証跡を定義します。
23
+ - **共通の運用**: 役割の割り当ては適用先のメンバー定義に、`status`・承認・改訂と廃止・未決事項の登録簿への引き継ぎは [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] に従います。文書の整形・lint はリポジトリの検証で扱い、業務の受入確認に含めません。
31
24
 
32
25
  ## 2. 位置づけ(他ドキュメントとの関係)
33
26
 
34
- `atc-index` と他ドキュメントの関係を示します。
35
-
36
27
  ```mermaid
37
28
  flowchart BT
38
29
  TSP["tsp-index<br>テスト戦略・方針"]
39
-
40
- subgraph TC["テストカタログ"]
41
- direction RL
42
- TCIndex["atc-index<br>テスト仕様-全体構成"]
43
- TCDetail["atc-&lt;term&gt;<br>テスト仕様-対象別"]
30
+ subgraph TC["受入テストカタログ"]
31
+ direction RL
32
+ TCIndex["atc-index<br>受入テストカタログ 概要"]
33
+ TCDetail["atc-&lt;term&gt;<br>対象別カタログ"]
44
34
  TCDetail -->|based_on| TCIndex
45
35
  end
46
-
47
36
  Code["テストコード 等"]
48
-
49
37
  TC -->|based_on| TSP
50
38
  Code -->|based_on| TC
51
-
52
39
  classDef target stroke-width:4px
53
40
  class TCIndex target
54
41
  ```
55
42
 
56
43
  ## 3. ファイル命名・ID規則
57
44
 
58
- - 本ルールの対象ドキュメントの `id` は `atc-index` 固定。対象別は `atc-<term>`(詳細は `atc-rulebook.md`)。
59
- - ファイル名は `atc-010-受入テストカタログ-概要.md` 等、プロジェクト内で一意になるように命名する。
60
- - `<term>` は用語集(GL) の論理名キー(英小文字kebab-case)を用いる(表示名は title に日本語で記載してよい)。
45
+ - ファイル名は `atc-index.md`、対象別は `atc-<term>.md` を基本とし、配置は成果物カタログと一致させます。
46
+ - 文書 ID はプロジェクト固有なら `<project-id>:atc-index`、プロダクト仕様なら `atc-index` とし、カタログの宣言に合わせます。対象別も同じ修飾方針で `atc-<term>` とします。
47
+ - `<term>` は用語集(GL)の論理名キー(英小文字 kebab-case)とし、日本語の表示名は本文の H1 に記載します。
61
48
 
62
49
  ## 4. 推奨 Frontmatter 項目
63
50
 
64
- ### 4.1. 設定内容
51
+ 許可項目・必須性・型制約は [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] と `docs/specdojo/schemas/v1/deliverable-frontmatter.schema.yaml` を正本とし、メタ情報は `specdojo:` 配下に置きます。
65
52
 
66
- Frontmatter は共通スキーマに従います(参照: [docs/specdojo/schemas/v1/deliverable-frontmatter.schema.yaml](../../../specdojo/schemas/v1/deliverable-frontmatter.schema.yaml) / [document-metadata-standard.md](../standards/document-metadata-standard.md))。
53
+ - `type` は `test`、`rulebook` は `specdojo:atc-index-rulebook` とします。
54
+ - `based_on` には直接の根拠とした `tsp-index` の文書 ID を含めます。BAC/NFR/BR/AC 等は方針判断に直接使ったものに限ります。成果物カタログに `depends_on` がある場合はその推移閉包内の作成済み文書に限定します。
67
55
 
68
- | 項目 | 説明 | 必須 |
69
- | ---------- | -------------------------------------------------- | ---- |
70
- | id | `atc-index`(固定) | ○ |
71
- | type | `test` 固定 | ○ |
72
- | title | 受入テストカタログ: 概要(`<システム名>`) | ○ |
73
- | status | `draft` / `ready` / `deprecated` | ○ |
74
- | based_on | 根拠となる仕様ID(ID配列。未指定時は `[]` を許容) | 任意 |
75
- | supersedes | 置き換え関係(ID配列。未指定時は `[]` を許容) | 任意 |
56
+ ## 5. 本文要件
76
57
 
77
- ### 4.2. 推奨ルール
78
-
79
- - `based_on` には最低限 `tsp-index` を含める。
80
- - BAC/NFR/BR/AC 等は、`atc-index` の方針判断(対象単位・合格基準・証跡・例外)に **直接利用したものだけ** を `based_on` に列挙する。
81
- - `based_on` / `supersedes` は ID 配列(未指定は `[]` 可)。
82
-
83
- ## 5. 本文構成(標準テンプレ)
84
-
85
- `atc-index` は以下の見出し構成を **順序固定** で配置します。
58
+ 次の章名・順序・必須区分を用い、本文の見出しは `## 1. 本ドキュメントの目的と適用対象` のように番号を付けます。各章の記述条件は「記述ガイド」に従います。
86
59
 
87
60
  | 番号 | 見出し | 必須 |
88
61
  | ---- | ----------------------------------------------- | ---- |
@@ -96,278 +69,149 @@ Frontmatter は共通スキーマに従います(参照: [docs/specdojo/schema
96
69
  | 8 | ケース表の共通カラム | ○ |
97
70
  | 9 | メモ / 将来課題 | 任意 |
98
71
 
99
- 注意:次章の記述ガイドのMarkdown見出しはルール文章内の参照用です。
100
- 生成する `atc-index` 本文の見出しは各章で指定された **番号付き** 形式に置き換えてください。
72
+ 「本ドキュメントの目的と適用対象」には、受入全体の合格基準と合否判定の流れも必須で記載します。
101
73
 
102
74
  ## 6. 記述ガイド
103
75
 
104
76
  ### 6.1. 本ドキュメントの目的と適用対象
105
77
 
106
- 生成する `atc-index` 本文の見出しは **## 1. 本ドキュメントの目的と適用対象**
107
-
108
- 本節では、`atc-index` が **何のために存在し、何に適用されるか** を明確にします。
109
-
110
- - 目的:`atc-<term>` を同一基準で作成し、受入判断に必要な粒度・責任範囲・証跡の揃い方を統一する
111
- - 適用対象:受入テスト(AT)に関するカタログ群(`atc-index` / `atc-<term>`)
112
- - 成果物の位置づけ:
113
- - `atc-index`:受入テストの共通方針(SSOT)
114
- - `atc-<term>`:対象別の受入観点・条件・ケース表(SSOT)
115
- - 実施記録/レポート/ログ:合否の証跡(Evidence)
116
-
117
- - SSOTの一次情報は `atc-index` / `atc-<term>` とし、実施記録/レポート/ログは **判断の裏付け** として扱う
118
- - 本書が扱う粒度:**受入基準・共通ルールまで**(個別ケースの列挙は禁止)
78
+ - 対象業務・利用場面と、対象別カタログに共通化する受入判断の範囲を示します。
79
+ - 全体概要は共通方針、対象別カタログは個別ケース、実施記録は合否の裏付けという分担を示します。
80
+ - **合格基準**: P0/P1/P2 の意味と優先度別の集計条件を定めます。例は「P0 は全件 pass、P1/P2 の fail は業務影響と回避策を確認し条件付き受入の可否を判断」です。未実施・判定保留を pass に数えず、fail を許容する条件、再試験と再判定の条件を明示します。
81
+ - **判定の流れ**: 実施結果の集計 → 証跡と期待値の照合 → 残存不具合・未決事項の影響確認 → 判定者による受入可・条件付き受入・保留・受入不可の判断と記録、の手順と各段階の完了条件を定めます。判定者が実施者・証跡確認者とその記録を辿れるようにします。
119
82
 
120
83
  ### 6.2. 受入テスト対象の括り方と分割基準
121
84
 
122
- 生成する `atc-index` 本文の見出しは **## 2. 受入テスト対象の括り方と分割基準**
123
-
124
- 本節では、`atc-<term>` の `<term>` をどう切るか(受入単位の設計)を定義します。
125
-
126
- - `<term>` は「ユーザ価値/業務成果のまとまり」(例:主要業務フロー、重要ユースケース群、運用シナリオ)とする
127
- - 分割基準(推奨順):
128
- 1. **受入判断の単位**:受け入れる/受け入れないが明確に言える
129
- 2. **業務成果の完了条件**:開始条件→完了条件が説明できる
130
- 3. **関係者合意の境界**:PO/利用部門/運用の責任境界に沿う
131
- 4. **リスク境界**:重大障害・法務/監査・金銭影響などのリスクが同質
132
-
133
- - 過分割の禁止:`atc-<term>` が「1〜2ケースしかない」単位は原則統合する
134
- - 肥大化の抑制:
135
- - ケースが過剰(例:50以上)になったら分割候補
136
- - 受入観点が混在(例:別業務成果が同居)する場合は分割候補
85
+ - `<term>` はユーザ価値・業務成果のまとまり(主要業務フロー、重要ユースケース群、運用シナリオ)とします。
86
+ - 分割は、受入判断の単位 → 業務成果の開始・完了条件 → 関係者合意の責任境界 → 重大障害・監査・金銭影響等のリスク境界の順で検討します。
87
+ - 1〜2 ケースだけの単位は原則統合します。50 ケース以上、または別の業務成果が混在する単位は分割候補とします。
137
88
 
138
89
  ### 6.3. 対象外・除外理由(共通)
139
90
 
140
- 生成する `atc-index` 本文の見出しは **## 3. 対象外・除外理由(共通)**
141
-
142
- 本節では、受入テスト(AT)で **やらないこと** と、その **理由**、および **例外条件** を明確にします。
143
-
144
- #### 6.3.1. 記述ルール
145
-
146
- - 形式は **「対象外」「除外理由」「代替レベル/代替手段」「例外」** のセットを基本とする
147
- - 「対象外」は **責務分界**(UT/IT/ET/ST/AT/NFR/運用)に紐づけて書く
148
- - 「例外」は乱用しない。例外を認める場合は **判断基準**(いつ/どの条件で)を明記する
149
- - 個別対象(`atc-<term>`)固有の対象外は `atc-<term>` 側に書く。本節は **AT共通** に限定する
150
-
151
- #### 6.3.2. 推奨フォーマット(表)
91
+ AT 共通の責務分界(UT/IT/ET/ST/AT/NFR/運用)を次の列で示します。対象固有の除外は対象別カタログに置きます。
152
92
 
153
- | 対象外(やらないこと) | 除外理由 | 代替レベル/代替手段 | 例外(ATで扱う条件) |
154
- | ---------------------- | -------- | ------------------- | -------------------- |
155
-
156
- - 「代替レベル/代替手段」は、どこで担保するか(ST/NFR/運用等)を必ず記載する
157
- - 例外がない場合は `なし` とする
158
-
159
- #### 6.3.3. 典型例(記載候補)
160
-
161
- - 低レベルの内部仕様の検証(アルゴリズム詳細、内部例外分岐の網羅)
162
- - 直積(全組合せ)網羅の確認(ATの目的は受入判断であり網羅性は別レベルで担保)
163
- - 性能・負荷・耐久の厳密測定(p95/p99等はNFRへ)
164
- - 端末/ブラウザ全網羅(ATでは代表構成、網羅は別途互換試験へ)
93
+ | 列 | 記述条件 |
94
+ | ---------------------- | ------------------------------------------------------------------ |
95
+ | 対象外(やらないこと) | 例: 内部例外分岐の全網羅、全組合せ、性能の厳密測定、全端末の互換性 |
96
+ | 除外理由 | 受入判断の目的に照らして除外する理由 |
97
+ | 代替レベル/代替手段 | ST/NFR/互換試験/運用等、どこで担保するか |
98
+ | 例外(ATで扱う条件) | 例外の判断基準。例外がなければ `なし` |
165
99
 
166
100
  ### 6.4. 受入観点の立て方(共通)
167
101
 
168
- 生成する `atc-index` 本文の見出しは **## 4. 受入観点の立て方(共通)**
169
-
170
- 受入観点は「受入判断に必要な切り口」であり、対象別カタログの章立て(見出し)として用います。
171
-
172
- - 観点の型(最低限この順で検討):
173
- - 業務成果の成立(完了条件、ユーザ価値)
174
- - 重要分岐の成立(代表失敗、やり直し、取消、再実行)
175
- - 重要な契約/約束(通知、帳票、監査ログ、権限、データ整合)
176
- - 運用可能性(復旧手順、観測性、問い合わせに答えられる証跡)
177
- - 非機能(ATで扱う範囲のみ:操作感の重大劣化、致命的遅延の有無 等)
178
-
179
- - 命名規則:**「名詞+成立/保証/整合」**(例:`注文確定の成立` / `通知の保証` / `監査証跡の整合`)
180
- - 粒度規則:
181
- - 観点は「条件が複数持てる」程度にまとめる(細分化し過ぎない)
182
- - 受入判断に結びつかない抽象観点は作らない(観点を再定義する)
102
+ - 業務成果の成立、重要分岐(代表失敗・やり直し・取消・再実行)、契約(通知・帳票・監査ログ・権限・データ整合)、運用可能性(復旧・観測・問い合わせの証跡)、AT で扱う非機能の順に検討します。
103
+ - 観点名は「名詞+成立/保証/整合」(例: `注文確定の成立`、`通知の保証`)とし、対象別カタログの見出しに使います。
104
+ - 複数条件を持てる粒度にまとめます。受入判断に結びつかない抽象観点は再定義します。
183
105
 
184
106
  ### 6.5. 条件の立て方(共通)
185
107
 
186
- 生成する `atc-index` 本文の見出しは **## 5. 条件の立て方(共通)**
108
+ 条件は前提・入力・環境の差分とし、代表性とリスクで絞ります。
187
109
 
188
- 条件は、受入観点を確認するための前提状態・入力状態・環境条件のバリエーションです。
189
- ATでは「**代表性とリスク**」を優先し、ケース爆発を避けます。
110
+ - **入力**: 代表入力、空・最大・形式不正のうち業務影響がある境界。
111
+ - **状態**: 代表ユーザ・権限・データ・ステータス。
112
+ - **環境**: 代表端末・ブラウザ・設定、外部依存の正常と代表失敗。
113
+ - **経路**: 代表経路、失敗からの復帰、再試行、取消、二重実行防止。
190
114
 
191
- - 入力(Input):代表入力、現実的な境界(空/最大/形式不正のうち重要なもの)
192
- - 状態(State):代表ユーザ/権限、代表データ、代表ステータス(有効/無効、未確定/確定 等)
193
- - 環境(Env):代表端末/ブラウザ、代表設定、外部依存の代表状態(正常/代表失敗)
194
- - 経路(Flow):代表経路、重要分岐(失敗→復帰、再試行、取消、二重実行防止)
195
-
196
- 組合せルール(増やし過ぎ防止):
197
-
198
- - まず「代表(P0)」を作る(業務成果が成立する最短経路)
199
- - 次に「重要分岐(P0/P1)」を追加(代表失敗、やり直し、取消、再実行)
200
- - 最後に「重大リスク(P0)」を追加(不正権限、金銭/監査、データ破壊につながるもの)
201
- - 原則として全組合せ(直積)は作らない。必要な場合は理由と管理方法を明記する
115
+ ケースは代表(P0: 業務成果が成立する最短経路)→ 重要分岐(P0/P1)→ 重大リスク(P0: 不正権限・金銭・監査・データ破壊)の順で追加します。全組合せは原則作らず、必要な場合は理由・範囲・管理方法を示します。
202
116
 
203
117
  ### 6.6. 観点/条件の採用基準と対象別への分配方針(共通)
204
118
 
205
- 生成する `atc-index` 本文の見出しは **## 6. 観点/条件の採用基準と対象別への分配方針(共通)**
206
-
207
- 本節では、観点/条件を「採用する判断」と「`atc-<term>` へ割り当てる判断」を共通ルールとして定義します。
208
-
209
- #### 6.6.1. 採用基準(共通)
210
-
211
- - 観点は「1観点=1合否命題」で採用する(複数命題の混在を禁止)
212
- - 条件は「1条件=1差分(入力/状態/環境/経路)」で採用する
213
- - 追加時は、次のいずれかに該当する根拠を明示する
214
- - 失敗時の業務影響が大きい(受入不可/業務停止/監査不備など)
215
- - 境界/例外/状態遷移の欠落が不具合につながりやすい
216
- - 上位仕様(BAC/NFR/BR/AC等)に明示的な要求がある
217
- - 「重要そうだから」など根拠不明の採用はしない
218
-
219
- #### 6.6.2. 対象別への分配方針(共通)
220
-
221
- - 観点/条件は、責務を持つ `atc-<term>` に **主担当1つ** を割り当てる(重複割当は例外扱い)
222
- - 複数 `atc-<term>` に跨る場合は、主担当 + 従担当(参照)で表現し、重複記載を避ける
223
- - 分配判断は「受入判断の単位」「業務成果の完了条件」「関係者合意の境界」の順で決める
224
- - 分配結果は `atc-<term>` 側のケース表とトレース列で追跡可能にする
119
+ - 1 観点は 1 合否命題、1 条件は 1 差分(入力/状態/環境/経路)とします。
120
+ - 採用根拠は、業務停止・監査不備等の業務影響、境界・例外・状態遷移の欠落リスク、BAC/NFR/BR/AC 等の明示要求のいずれかで示します。「重要そうだから」は根拠にしません。
121
+ - 責務を持つ対象別カタログを主担当 1 つとし、複数対象に跨る場合は従担当から参照します。分配は「受入テスト対象の括り方と分割基準」に従い、ケース表とトレース列で追跡可能にします。
225
122
 
226
- 推奨フォーマット(例):
123
+ 分配表を使う場合の列順は次のとおりです。
227
124
 
228
- | 観点/条件 | 採用理由 | 主担当 `atc-<term>` | 従担当(任意) | 備考 |
229
- | --------- | -------- | ------------------- | -------------- | ---- |
125
+ `観点/条件` / `採用理由` / `主担当 atc-<term>` / `従担当(任意)` / `備考`
230
126
 
231
127
  ### 6.7. 受入テストの環境/データ/外部依存の扱い(共通)
232
128
 
233
- 生成する `atc-index` 本文の見出しは **## 7. 受入テストの環境/データ/外部依存の扱い(共通)**
234
-
235
- 受入テストでは、合否判断の公平性と再現性を確保するため、環境・データ・外部依存の前提を固定します。
236
-
237
- - 環境:
238
- - 受入環境(staging/uat等)と代表構成(主要ブラウザ/端末)を明記する
239
- - リリース候補版(ビルド番号/タグ)と実施期間の紐づけ方を定める
240
-
241
- - データ:
242
- - 受入用データの準備・初期化・後始末(namespace/テナント/掃除手順)を共通化する
243
- - ケースは「データ大量列挙」ではなく、データセットID参照等で管理する
244
-
245
- - 外部依存:
246
- - 原則:sandbox/疑似/検証用接続を利用し、本番影響を排除する
247
- - 依存先ごとに「検証方法(画面/ログ/受信箱/ダッシュボード)」を決める
248
-
249
- - 証跡の最小セット(例):
250
- - 実施者/日時/版、結果(pass/fail)、スクショ or 画面録画キー、ログ相関ID、必要な外部ID(決済ID等)
129
+ - **環境**: staging/uat 等の受入環境・主要ブラウザ/端末を示し、リリース候補版(ビルド番号/タグ)と実施期間の紐づけ方を定めます。
130
+ - **データ**: 準備・初期化・後始末(namespace/テナント/清掃手順)を共通化し、個々の値の列挙はデータセット ID の参照へ寄せます。
131
+ - **外部依存**: sandbox/疑似/検証用接続で本番影響を排除し、依存先ごとに画面・ログ・受信箱等の検証方法を定めます。
132
+ - **証跡**: 実施者・日時・版・ケース別結果(pass/fail 等)、画面録画等のキー・ログ相関 ID・必要な外部 ID を記録します。受入全体の判定記録から、証跡確認者、判定責任者(人間)、判定結果・理由・承認日、条件付き受入の条件を追跡できるようにします。
251
133
 
252
134
  ### 6.8. ケース表の共通カラム
253
135
 
254
- 生成する `atc-index` 本文の見出しは **## 8. ケース表の共通カラム**
255
-
256
- `atc-<term>` の末端(条件・ケース表)は、レビュー・合意・追跡性を確保するため、全termで同一カラム順を採用します。
136
+ 全対象で次の列順を共通化します。必須 4 列に続き、推奨列(受入テストの運用では必須)を配置します。
257
137
 
258
- 必須カラム:
138
+ | 区分 | 列 | 記述条件 |
139
+ | ---- | ---------------------- | --------------------------------------------------------------------------------------------------------- |
140
+ | 必須 | `case_id` | 対象別で一意かつ不変。推奨は `at-<term>-<perspective_key>-<nnn>`。キーは kebab-case、番号は 3 桁・10 刻み |
141
+ | 必須 | 条件 | 入力/状態/環境/経路の必要な要素 |
142
+ | 必須 | 手順(最小) | 操作の意図が分かる高位の手順 |
143
+ | 必須 | 期待値 | 観測して判定できる合格条件 |
144
+ | 推奨 | 観測点(アサーション) | 画面・帳票・ログ相関 ID・外部 ID 等 |
145
+ | 推奨 | 環境/依存 | 代表構成と sandbox/疑似の前提 |
146
+ | 推奨 | トレース | 要求・受入条件・契約の ID(`trace_key` 参照も可) |
147
+ | 推奨 | 優先度 | 「本ドキュメントの目的と適用対象」で定義する P0/P1/P2 |
148
+ | 推奨 | 実施形態 | manual/assisted/automated |
149
+ | 推奨 | 証跡 | 実施記録・レポート・録画・ログ等の参照先 |
259
150
 
260
- - `case_id`(ケースID):対象別に一意なIDで変更しない
261
- - 推奨形式:`<level>-<term>-<perspective_key>-<nnn>`(`level` は `at`、`nnn` は3桁10刻み推奨)
262
- - `perspective_key` は kebab-case のキー文字列で、原則変更しない
263
-
264
- - `条件`:入力/状態/環境/経路の要点(必要な要素のみ)
265
- - `手順(最小)`:高位の最小手順(クリック列挙は禁止。操作の意図が分かる粒度)
266
- - `期待値`:判定可能な合格条件(受入判断に必要な観測点を含める)
267
-
268
- 推奨カラム(運用必須):
269
-
270
- - `観測点(アサーション)`:画面/帳票/ログ相関ID/外部IDなど「見れば判定できるもの」
271
- - `環境/依存`:代表構成、sandbox/疑似の前提
272
- - `トレース`:要求/受入条件/契約(trace_key参照でもよい)
273
- - `優先度`:P0/P1/P2(受入で外せないものを明確化)
274
- - `実施形態`:manual/assisted/automated(受入の実施形態)
275
- - `証跡`:実施記録/レポート/録画/ログ相関ID等の参照先
276
-
277
- 注意:
278
-
279
- - 表の1行=1受入シナリオ(条件×期待値が一意)
280
- - 手順・期待値を冗長に書かず、詳細は実施記録/テストスクリプトへ寄せる
151
+ - 1 行は 1 受入シナリオ(条件×期待値が一意)とし、詳細は実施記録・テストスクリプトに寄せます。
152
+ - 共通列を変える場合は、全 `atc-<term>`、実施記録・レポート、集計・自動実行処理の利用箇所を特定し、列と値の対応を更新します。既存の `case_id` と `perspective_key` は維持し、ケースからトレース・証跡へ辿れることと集計結果を再確認します。
281
153
 
282
154
  ### 6.9. メモ / 将来課題
283
155
 
284
- 生成する `atc-index` 本文の見出しは **## 9. メモ / 将来課題**
285
-
286
- 現時点で決めきれない事項や将来の改善点を記録します。
287
- 運用ルールとして必須になった時点で本文へ昇格させます。
288
-
289
- - 将来検討(例):
290
- - 受入の証跡フォーマット統一(テンプレ、保存先、命名)
291
- - 代表構成の見直し(端末/ブラウザ/権限ロール)
292
- - 受入の自動化範囲(回帰の一部を自動化する基準)
293
- - カタログlint(case_id重複、必須列欠落など)
156
+ 未決事項がある場合、論点と受入判断への影響(当面の扱い、決定時に変わる方針)を記録します。例は証跡の保存形式、代表構成の見直し、自動化の範囲です。
294
157
 
295
158
  ## 7. 禁止事項
296
159
 
297
- | 項目 | 理由 |
298
- | ------------------------------------------------------------------ | ---------------------------------------------------------------------- |
299
- | `atc-index` に個別ケース(条件・手順・期待値)を大量に列挙する | `atc-index` は共通方針のSSOTであり、個別は `atc-<term>` に集約するため |
300
- | 受入環境・データ前提を対象ごとに無根拠に変更する | 合否判断の公平性と再現性が崩れるため |
301
- | 手順にUI操作のクリック列挙や画面要素の細部を大量に書く | 変更に弱く、合意/レビューが困難になるため |
302
- | 期待値を曖昧に書く(例:「問題がないこと」「使えること」) | 判定不能で合否が揺れ、証跡として機能しないため |
303
- | `case_id` を後から変更する(参照があるのに変更する) | トレース・証跡リンクが壊れ、履歴追跡が不能になるため |
304
- | 対象外・除外理由(共通)と矛盾するケースを `atc-<term>` に記載する | 責任境界が崩れるため(例外は根拠と条件を明記) |
160
+ | 項目 | 理由 |
161
+ | ---------------------------------------------------------------------------- | -------------------------------------- |
162
+ | `atc-index` に個別の条件・手順・期待値をケースとして記載する(形式例を除く) | 個別ケースは対象別カタログが正本のため |
163
+ | 受入環境・データ前提を対象ごとに無根拠に変更する | 公平性と再現性が崩れるため |
164
+ | ケースの手順をクリック位置・ボタン名・画面要素の全操作列挙にする | 業務上の操作意図を確認できなくなるため |
165
+ | 期待値を「問題がないこと」「使えること」だけで済ませる | 合否の観測点を特定できないため |
166
+ | 参照済みの `case_id` を変更する | トレースと証跡の参照が壊れるため |
167
+ | 共通の除外方針に反するケースを根拠と例外条件なしで採用する | 受入判断の責任境界が崩れるため |
305
168
 
306
169
  ## 8. サンプル(最小)
307
170
 
308
- 注:以下はルール文書内の例示です。生成する `atc-index` では `## 1...` から始まります。
171
+ 以下は全必須章の輪郭を示す形式例です。
309
172
 
310
- ```yaml
173
+ ```markdown
311
174
  ---
312
- id: atc-index
313
- type: test
314
- title: 受入テストカタログ: 概要
315
- status: draft
316
- based_on: [tsp-index]
317
- supersedes: []
175
+ specdojo:
176
+ id: prj-example:atc-index
177
+ type: test
178
+ status: draft
179
+ rulebook: specdojo:atc-index-rulebook
180
+ based_on: [prj-example:tsp-index]
318
181
  ---
319
- ```
320
182
 
321
- ### 8.1. 本ドキュメントの目的と適用対象
183
+ # 受入テストカタログ 概要(販売管理)
322
184
 
323
- 本ドキュメントは、受入テストカタログ(ATC)の全体概要 `atc-index` を統一形式で記述するためのルールである。
324
- `atc-index` は受入判断に必要な「対象単位の切り方」「受入観点/条件の立て方」「環境・データ前提」「合格基準」「証跡方針」を定義し、
325
- 対象別カタログ `atc-<term>` の作成と運用の基盤とする。
185
+ ## 1. 本ドキュメントの目的と適用対象
326
186
 
327
- ### 8.2. 受入テスト対象の括り方と分割基準
187
+ 会計の受入判断に適用する。P0 は必須の代表・重大リスク、P1 は重要分岐、P2 は補助確認とする。P0 は全件 pass、P1/P2 の fail は回避策を実施でき業務継続に支障がない場合だけ条件付き受入とする。未実施・保留は pass に数えない。
188
+ 実施結果の集計、証跡照合、残存不具合の影響確認を経て、判定者が受入可否を記録する。
328
189
 
329
- `atc-<term>` の `<term>` はユーザ価値/業務成果のまとまり(主要業務フロー等)とする。
330
- 分割は受入判断の単位・完了条件・関係者合意の境界・リスク境界を基準とし、過分割と肥大化の双方を避ける。
190
+ ## 2. 受入テスト対象の括り方と分割基準
331
191
 
332
- ### 8.3. 対象外・除外理由(共通)
192
+ 会計完了を 1 つの受入単位とし、業務成果とリスク境界で分割する。
333
193
 
334
- 受入テスト(AT)では、受入判断のための代表性と再現性を優先するため、以下は原則として対象外とする。
194
+ ## 3. 対象外・除外理由(共通)
335
195
 
336
- | 対象外(やらないこと) | 除外理由 | 代替レベル/代替手段 | 例外(ATで扱う条件) |
337
- | -------------------------------------------------- | ---------------------------------------- | ------------------- | -------------------- |
338
- | 内部実装の網羅(例外分岐の全網羅、内部関数の詳細) | 受入判断の目的から外れ、変更に弱い | UT/IT/ST | なし |
339
- | 直積(全組合せ)網羅 | ケース爆発で運用不能、代表性が落ちる | UT/IT/ET | 重大リスクのみ |
340
- | 性能の厳密測定(p95/p99、長時間耐久) | 計測設計が別物で受入の枠を超える | NFR | なし |
341
- | 端末/ブラウザ全網羅 | 受入環境の代表構成で十分、網羅は別途必要 | 互換試験/運用 | なし |
196
+ 内部例外分岐の全網羅は受入判断の対象外とし、UT/IT で担保する。AT で扱う例外はない。
342
197
 
343
- ### 8.4. 受入観点の立て方(共通)
198
+ ## 4. 受入観点の立て方(共通)
344
199
 
345
- 受入観点は業務成果の成立・重要分岐の成立・契約(通知/監査/権限)・運用可能性を基軸に立てる。
346
- 観点名は「名詞+成立/保証/整合」で統一し、条件を複数持てる粒度にまとめる。
200
+ 業務成果・重要分岐・契約・運用可能性から、合否命題を持つ観点を立てる。
347
201
 
348
- ### 8.5. 条件の立て方(共通)
202
+ ## 5. 条件の立て方(共通)
349
203
 
350
- 条件は入力・状態・環境・経路に分解し、代表→重要分岐→重大リスクの順で追加する。
351
- 全組合せ(直積)は原則作らず、必要時のみ理由と管理方法を明記する。
204
+ 入力・状態・環境・経路を分け、代表、重要分岐、重大リスクの順に採用する。
352
205
 
353
- ### 8.6. 観点/条件の採用基準と対象別への分配方針(共通)
206
+ ## 6. 観点/条件の採用基準と対象別への分配方針(共通)
354
207
 
355
- 観点/条件は、業務影響・境界/例外/状態遷移の重要性・上位仕様根拠を基準に採用する。
356
- 分配は受入判断の単位・業務成果の完了条件・関係者合意の境界を基準に主担当 `atc-<term>` を1つ定め、重複は例外として扱う。
357
- 分配結果は `atc-<term>` のケース表とトレース列で追跡可能にする。
208
+ 業務影響または明示要求を根拠に、責務を持つ対象別カタログを主担当とする。
358
209
 
359
- ### 8.7. 受入テストの環境/データ/外部依存の扱い(共通)
210
+ ## 7. 受入テストの環境/データ/外部依存の扱い(共通)
360
211
 
361
- 受入環境と代表構成、受入用データの準備/初期化/後始末、外部依存(sandbox/疑似)の前提を固定し、
362
- 合否判断の再現性を担保する。証跡の最小セット(版/日時/結果/スクショ/ログ相関ID等)を共通化する。
212
+ 代表構成と候補版を固定し、受入用データを初期化する。決済は sandbox で確認する。実施・証跡確認の記録と、判定者・結果・理由・承認日を関連付ける。
363
213
 
364
- ### 8.8. ケース表の共通カラム
214
+ ## 8. ケース表の共通カラム
365
215
 
366
- 対象別カタログ `atc-<term>` の末端表は全termで共通のカラム順を採用する。
367
- 必須:case_id / 条件 / 手順(最小) / 期待値
368
- 推奨:観測点(アサーション)/ 環境・依存 / トレース / 優先度 / 実施形態 / 証跡
369
-
370
- ### 8.9. メモ / 将来課題
371
-
372
- 将来検討事項(例):証跡テンプレ統一、代表構成の見直し、受入の自動化範囲、カタログlint等を記録する。
373
- 必須になった時点で本文へ昇格させる。
216
+ 必須は `case_id` / 条件 / 手順(最小)/ 期待値。推奨は観測点(アサーション)/ 環境/依存 / トレース / 優先度 / 実施形態 / 証跡。
217
+ ```