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,25 +13,17 @@ specdojo:
13
13
 
14
14
  Internal Integration Test Catalog (ITC) Documentation Rules
15
15
 
16
- 本ドキュメントは、内部結合テストカタログ(ITC)の対象別 `itc-<term>` を統一形式で記述するためのルールです。
17
- `itc-index` を前提に、SSOTの本体として、対象ごとの **内部結合テストの責務・境界・依存、観点 x 条件=ケース、トレース、証跡** を明文化します。
16
+ 内部結合テストカタログ(ITC)の対象別 `itc-<term>` に、責務・結合境界・依存、観点×条件=ケース、根拠仕様と証跡を記述する基準を定めます。
18
17
 
19
18
  ## 1. 全体方針
20
19
 
21
- 個別 ITC(`itc-<term>`)は、内部結合テストにおける SSOT の本体として、対象ごとの責務と結合境界を明確化し、
22
- 観点×条件=ケース(末端表)を最小情報で整理して、テストコード/CI証跡へ確実に接続できる形で記述する。
23
-
24
- - `itc-<term>` は **対象固有の情報のみ**を記述し、共通ルールは `itc-index` を参照する(重複記述しない)
25
- - 内部結合テストの目的は「**複数コンポーネントの結合としての振る舞い**を決定的に検証すること」であり、外部要因(外部サービス実疎通/実ユーザUI)は原則排除する(例外は根拠を明記)
26
- - ITでは、UTでMockしていた境界の一部(例:Repository実装、SQL/制約、トランザクション)を **実装に近い形で検証**する(ただし再現性が崩れる要因は制御する)
27
- - ケースは「表の1行=1テスト」とし、手順と期待値は **判定可能**な粒度で簡潔に書く
28
- - 詳細な操作列挙やデータ大量列挙は避け、必要な詳細はテストコード側へ寄せる(証跡で参照可能にする)
29
- - すべての観点・ケースは、根拠仕様(`based_on` / `トレース`)と、証跡(テストコード/CI)に接続されていること
20
+ - **正本の分担**: `itc-<term>` は対象固有の観点・ケースの正本とし、共通方針は `itc-index` に従う。詳細な操作・データはテストコードへ寄せる。
21
+ - **検証範囲**: 複数コンポーネントの結合としての振る舞いを決定的に検証する。UTでMockしていた境界の一部(Repository、SQL/制約、トランザクション等)を実装に近づけ、外部サービス実疎通・実ユーザUIは原則除外する。例外には根拠と再現性対策を明記する。
22
+ - **ケースの単位**: 表の1行を1テストとし、判定可能な条件・期待値、根拠仕様、テストコード/CI証跡を対応付ける。
23
+ - **共通の運用**: 役割の割り当ては適用先のメンバー定義に、`status` の昇格と承認、改訂と廃止、未決事項の登録簿への引き継ぎは [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] に従う。文書の整形・lint はリポジトリの検証で扱い、業務の検証に含めない。
30
24
 
31
25
  ## 2. 位置づけ(他ドキュメントとの関係)
32
26
 
33
- 個別 ITC(`itc-<term>`)と他ドキュメントの関係を示します。
34
-
35
27
  ```mermaid
36
28
  flowchart BT
37
29
  TSP["tsp-index<br>テスト戦略・方針"]
@@ -50,42 +42,29 @@ flowchart BT
50
42
 
51
43
  classDef target stroke-width:4px
52
44
  class TCDetail target
53
-
54
45
  ```
55
46
 
56
47
  ## 3. ファイル命名・ID規則
57
48
 
58
- - `id` は `itc-<term>`(kebab-case。例: `itc-order`)。
59
- - ファイル名は `itc-010-内部結合テストカタログ-<term>.md` 等(例: `itc-010-内部結合テストカタログ-受注.md`)。
60
- - `<term>` は 用語集(GL) の 論理名キー(英小文字kebab-case)を用いる(表示名は title / ファイル名で日本語を使用してよい)。
49
+ - **文書 ID**: [[specdojo:id-and-file-naming-standard|ID・ファイル命名標準]] に従い、プロダクト文書は `itc-<term>`、プロジェクト文書は `<project-id>:itc-<term>` とする。
50
+ - **ファイル名**: `itc-<term>.md` を推奨し、既存文書の配置・名称は成果物カタログの宣言に合わせる。
51
+ - **対象名**: `<term>` は用語集の論理名キー(英小文字kebab-case)とし、日本語の表示名は H1 に記載する。
61
52
 
62
53
  ## 4. 推奨 Frontmatter 項目
63
54
 
64
55
  ### 4.1. 設定内容
65
56
 
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)
57
+ 許可キー・必須項目・型制約は [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] と `docs/specdojo/schemas/v1/deliverable-frontmatter.schema.yaml` に従う。
70
58
 
71
- | 項目 | 説明 | 必須 |
72
- | ---------- | -------------------------------------------------------------------------------- | ---- |
73
- | id | ITC ID(個別: `itc-<term>`) | ○ |
74
- | type | `test` 固定 | ○ |
75
- | title | 内部結合テストカタログ: <対象名> | ○ |
76
- | status | `draft` / `ready` / `deprecated` | ○ |
77
- | based_on | 根拠仕様(最低限: `tsp-index`, `itc-index`。対象固有の根拠は本文トレースに集約) | ○ |
78
- | part_of | 集約ドキュメントへの所属(ID配列) | 任意 |
79
- | supersedes | 置き換え関係 | 任意 |
59
+ - `specdojo.id` は「ファイル命名・ID規則」の区分に従う。
60
+ - `specdojo.type` は `test`、`specdojo.rulebook` は `specdojo:itc-rulebook` とする。
61
+ - 文書名は `# 内部結合テストカタログ: <対象名>` とする。
80
62
 
81
63
  ### 4.2. 推奨ルール
82
64
 
83
- - `based_on` には **本対象の内部結合テスト観点の根拠となる仕様** を列挙します。
84
- - `based_on` は原則 `[tsp-index, itc-index]` を最低限とし、
85
- 対象固有の根拠(`br-*` / `bac-*` / `spec-*` / `nfr-*` 等)は本文「トレース」に集約する。
86
- 機械処理上の都合で `based_on` にも列挙する場合は、本文トレースと矛盾しないこと。
87
- - 記述内容が多くなる場合は、ドキュメントを分割し、`part_of` で集約ドキュメントに所属させます。
88
- - `part_of` / `based_on` / `supersedes` は ID 配列(未指定は `[]` 可)。
65
+ - `based_on` は原則 `tsp-index` と `itc-index` を最低限とする。対象固有の根拠(`br-*` / `bac-*` / `spec-*` / `nfr-*` 等)は本文「トレース」に集約し、メタ情報にも列挙する場合は対応を揃える。
66
+ - 参照には適用先の正規 ID を用い、カタログの `depends_on` がある場合は、その推移閉包内の作成済み文書に限定する。
67
+ - 分割時は `itc-index` の分割基準に従い、`part_of` で集約先を示す。
89
68
 
90
69
  ## 5. 本文構成(標準テンプレ)
91
70
 
@@ -100,121 +79,78 @@ Frontmatter は共通スキーマに従います(あわせてドキュメン
100
79
  | 5 | トレース | ○ |
101
80
  | 6 | テスト観点とケース | ○ |
102
81
 
103
- 注意:次章の記述ガイドのMarkdown見出しはルール文章内の参照用であり、
104
- 生成する `utc-<term>` 本文の見出しは各章で指定された **番号付き** の形式
105
- (例: `## 6.`, `### 6.1.` / `#### 6.1.1.` / `#### 6.1.2.`)に置き換えてください。
82
+ 生成する `itc-<term>` は上表を番号付き H2 とする。「テスト観点とケース」配下は `### 6.1. 観点:<観点>`、`#### 6.1.1. 意図`、`#### 6.1.2. 条件・ケース表` とし、観点ごとに連番を振る。
106
83
 
107
84
  ## 6. 記述ガイド
108
85
 
109
86
  ### 6.1. 概要(`<term>`)
110
87
 
111
- 生成する `itc-<term>` 本文の見出しは **## 1. 概要(&lt;term&gt;)**
112
-
113
- 本節では、対象(`<term>`)が何であり、どの結合単位を本カタログで扱うかを簡潔に示します。
114
-
115
- - `<term>` の説明(1〜3行):結合のまとまり(ユースケース×主要I/F、サブシステム境界 等)を人が理解できる形で記述する
116
- - 期待する利用者:レビューア/実装者/テスト実装者が、対象の前提(構成・依存)を把握できる内容にする
117
- - 対象の粒度:`itc-index` の分割基準に従い、過分割/肥大化を避ける
118
- - 結合対象(最低限):結合する主要コンポーネント(例:App層、DB層、Queue、Cache 等)を列挙してよい
119
- - 詳細な仕様の説明や長い背景は書かない(根拠はトレースで示す)
88
+ - 対象の結合単位(ユースケース×主要I/F、サブシステム境界等)を1〜3行で示す。
89
+ - レビューア/実装者/テスト実装者が構成・依存を把握できるよう、主要コンポーネント(App層、DB層、Queue等)を示す。
90
+ - 粒度は `itc-index` の分割基準に従う。仕様の詳細は「トレース」に委ねる。
120
91
 
121
92
  ### 6.2. 責務(結合として保証)
122
93
 
123
- 生成する `itc-<term>` 本文の見出しは **## 2. 責務(結合として保証)**
124
-
125
- 本節では、「この結合対象が何を保証すべきか(内部結合テストで確認する責務)」を列挙します。
126
-
127
- - 箇条書きで 3〜7 個程度を目安に、**動詞で始まる**形で記述する
128
- - 例:API入力を永続化モデルへ正しく変換する/制約違反時に規定エラーへ変換する/同一要求の冪等性を保証する
129
-
130
- - 責務は「テスト観点」の上位概念であり、観点は責務を分解した切り口である(責務≠観点)
131
- - 例外・異常系の責務も含める(制約違反、重複、整合性破壊、部分失敗、競合 等)
132
- - 可能なら観測可能な成果(DB状態、レスポンス、イベント、ログ、トランザクション結果)とセットで書く
133
- - 責務に含まれないものは「対象外」へ移す(曖昧さを残さない)
94
+ - 結合として保証する振る舞いを、動詞で始まる箇条書きで3〜7個程度示す。例:API入力を永続化モデルへ変換する/同一要求の冪等性を保証する。
95
+ - 制約違反、重複、部分失敗、競合等の異常系を含め、可能ならDB状態・レスポンス・イベント等の観測可能な成果を添える。
96
+ - 責務は観点の上位概念とし、観点はその分解とする。保証しないものは「対象外」へ記す。
134
97
 
135
98
  ### 6.3. 対象外
136
99
 
137
- 生成する `itc-<term>` 本文の見出しは **## 3. 対象外**
138
-
139
- 本節では、「この対象カタログ(`itc-<term>`)ではやらないこと」を明示します。
140
- `itc-index` の「対象外・除外理由(共通)」と矛盾しないことが前提です。
141
-
142
- - 対象外は「なぜ除外するか(理由)」と「代替レベル/代替手段」とセットで書く
143
- - 対象固有の対象外(例:別サブシステムの責務、別termの責務)を明確にする
144
- - 例外としてITで扱う場合は、条件・根拠・再現性担保(スタブ、固定設定等)を明記する
145
-
146
- 推奨フォーマット(簡易):
147
-
148
- - 対象外:xxx(理由:yyy、代替:zzz)
100
+ - `itc-index` の「対象外・除外理由(共通)」に従い、別サブシステム・別termの責務など対象固有の除外を記す。
101
+ - 形式は「対象外:xxx(理由:yyy、代替:zzz)」とし、代替レベル/手段を明記する。
102
+ - 例外としてITで扱う場合は、条件・根拠・再現性対策(スタブ、固定設定等)を示す。
149
103
 
150
104
  ### 6.4. 結合境界/依存/環境前提
151
105
 
152
- 生成する `itc-<term>` 本文の見出しは **## 4. 結合境界/依存/環境前提**
153
-
154
- 本節では、内部結合テストにおける「結合境界(どこまでが対象か)」「依存(外部要因)」「環境前提(再現性条件)」を明確にします。
155
- ITは環境差で揺れやすいため、ここを固定することが重要です。
106
+ - 入口/出口(API、ユースケースI/F等)と結合対象(Service+Repository+DB等)を明記する。
107
+ - 依存ごとに実/スタブ/モック/固定化を選び、`itc-index` の共通方針から対象固有の設定を具体化する。
156
108
 
157
- - 結合境界:入口/出口(API、ユースケースI/F、メッセージI/F等)を明記する
158
- - 結合対象:結合するコンポーネント(例:Service+Repository+DB、Producer+Broker+Consumer 等)を列挙する
159
- - 依存はカテゴリごとに列挙し、「扱い(実/スタブ/モック/固定化)」を決める
160
- - DB:原則 実DB相当(コンテナDB等)。スキーマ/制約を観測可能にする
161
- - 外部API:原則 Stub/Mockサーバ(成功/失敗/タイムアウトを再現)
162
- - 時刻:固定クロック or 再現可能な基準時刻(TZ含む)
163
- - 乱数/UUID:固定化(シード/注入)
164
- - メッセージング:テスト用ブローカ or 同等の決定性構成(同期化/待機条件も明記)
165
- - ファイル/ストレージ:テスト用領域、Fake、I/F差替(再現性条件を明記)
109
+ | 依存 | 扱い・再現性条件 |
110
+ | ------------------- | --------------------------------------------------------- |
111
+ | DB | 原則実DB相当(コンテナ等)。スキーマ/制約を観測可能にする |
112
+ | 外部API | 原則Stub/Mockサーバで成功/失敗/タイムアウトを再現 |
113
+ | 時刻、乱数/UUID | TZを含む固定クロック・再現可能な基準時刻、シード/注入 |
114
+ | メッセージング | テスト用ブローカ等で決定性を担保し、同期化/待機条件を明記 |
115
+ | ファイル/ストレージ | テスト用領域、Fake、I/F差替と再現性条件を明記 |
166
116
 
167
- - 環境前提(推奨):DB初期化方法、seed、並列実行の分離(namespace等)、タイムアウト基準、ログ取得方針
168
- - 「観測点(アサーション)」で何を検証するか(レスポンス/DB状態/イベント/相互作用)もここで整理してよい
117
+ - 環境前提としてDB初期化、seed、並列実行の分離、タイムアウト、ログ取得を推奨する。レスポンス/DB状態/イベント/相互作用の観測点も整理してよい。
169
118
 
170
119
  ### 6.5. トレース
171
120
 
172
- 生成する `itc-<term>` 本文の見出しは **## 5. トレース**
173
-
174
- 本節では、`itc-<term>` の根拠となる上位成果物との対応関係(トレーサビリティ)を示します。
175
- 本カタログにおけるトレースの一次情報(SSOT)は **`## 5. トレース`** とし、観点・ケース表では **trace_key(`TR-xx`)参照**に統一します。
121
+ 根拠仕様との対応の正本を本章の表とし、観点・ケース表では `trace_key`(`TR-xx`)を参照する。
176
122
 
177
- #### 6.5.1. 記述ルール(trace_key)
123
+ #### 6.5.1. 記述ルール(`trace_key`)
178
124
 
179
- - 各トレース項目に **trace_key(`TR-xx`)** を付与する(2桁、01始まり推奨)
180
- - `trace_key` は **本ドキュメント内で一意**で、原則変更しない
181
- - 観点・ケース表の `トレース` 列には **仕様IDを直書きせず**、`TR-xx` を列挙する
182
- - 新しい根拠が必要になった場合は、**先に本節の表へ行追加**し、付与された `trace_key` をケース表で参照する
183
- - 追加順採番。並び替えても trace_key は維持する。また、削除しても欠番は詰めない
125
+ - `trace_key` は文書内で一意の `TR-xx`(2桁、01始まり推奨)とし、追加順に採番する。並べ替えても維持し、削除時は欠番を詰めない。
126
+ - 新たな根拠は先にトレース表へ追加する。
127
+ - 観点・ケース表の「トレース」列には仕様IDを直書きせず、`TR-xx` を列挙する。
184
128
 
185
129
  #### 6.5.2. トレース表(標準フォーマット)
186
130
 
187
- | trace_key | 仕様ID | 要点 | 備考 |
188
- | --------- | ------- | ------- | ---- |
189
- | TR-01 | br-... | (1行) | 任意 |
190
- | TR-02 | bac-... | (1行) | 任意 |
131
+ | `trace_key` | 仕様ID | 要点 | 備考 |
132
+ | ----------- | ------- | ------- | ---- |
133
+ | TR-01 | br-... | (1行) | 任意 |
134
+ | TR-02 | bac-... | (1行) | 任意 |
191
135
 
192
136
  - `要点` は「ケース作成の判断に使ったポイント」を **1行**で書く(冗長な仕様説明はしない)
193
137
 
194
138
  ### 6.6. テスト観点とケース
195
139
 
196
- 生成する `itc-<term>` 本文の見出しは **## 6. テスト観点とケース**
197
-
198
- 本節は `itc-<term>` の中心です。観点(見出し)→ ケース表(末端表)の順で構成します。
140
+ 観点(見出し)→意図→ケース表(末端表)の順で構成する。
199
141
 
200
142
  #### 6.6.1. 観点:<観点>
201
143
 
202
- 生成する `itc-<term>` 本文の見出しは **### 6.1. 観点:<観点>**
203
-
204
144
  - 観点は `itc-index` の「観点の立て方(共通)」に従って命名する
205
145
  - 観点の粒度は「条件が複数ぶら下がる」程度にまとめる(細かすぎる観点の乱立を避ける)
206
146
  - 観点名(見出し)は改善のため変更してよいが、`perspective_key` は原則変更しない(変更が必要なら `supersedes` 等で追跡する)
207
147
 
208
148
  ##### 6.6.1.1. 意図
209
149
 
210
- 生成する `itc-<term>` 本文の見出しは **#### 6.1.1. 意図**
211
-
212
150
  - 観点ごとに「意図(この観点で保証すること)」を 1〜2 行で書く
213
151
 
214
152
  ##### 6.6.1.2. 条件・ケース表
215
153
 
216
- 生成する `itc-<term>` 本文の見出しは **#### 6.1.2. 条件・ケース表**
217
-
218
154
  - ケース表の 1 行は「1テスト」を表す(条件×期待値が一意)
219
155
  - 必須カラムは `itc-index` の定義に従う
220
156
  - `case_id` は以下を推奨し、変更しない
@@ -245,64 +181,40 @@ ITは環境差で揺れやすいため、ここを固定することが重要で
245
181
 
246
182
  ## 8. サンプル(最小)
247
183
 
248
- 注:以下はルール文書内の例示です。生成する `itc-<term>` では `## 1...` から始まります。
184
+ トレースとケースの対応を示す部分例です。成果物全体では「本文構成(標準テンプレ)」の必須6章を揃えます。仕様ID・証跡は例示です。
249
185
 
250
- ```yaml
186
+ ```markdown
251
187
  ---
252
- id: itc-order
253
- type: test
254
- title: 内部結合テストカタログ: 受注(order)
255
- status: draft
256
- part_of: []
257
- based_on: [tsp-index, itc-index]
258
- supersedes: []
188
+ specdojo:
189
+ id: itc-order
190
+ type: test
191
+ status: draft
192
+ rulebook: specdojo:itc-rulebook
193
+ based_on: [tsp-index, itc-index]
259
194
  ---
260
- ```
261
-
262
- ### 8.1. 概要(order)
263
195
 
264
- 受注API(入力)から永続化(DB)までの結合、および重複/制約違反/ロールバックを扱う。
196
+ # 内部結合テストカタログ: 受注(order)
265
197
 
266
- ### 8.2. 責務(結合として保証)
198
+ ## 5. トレース
267
199
 
268
- - API入力を永続化モデルへ正しく変換し保存する
269
- - 制約違反時に規定のエラーへ変換し、DB状態を汚さない
270
- - 部分失敗時にトランザクションをロールバックする
200
+ | `trace_key` | 仕様ID | 要点 | 備考 |
201
+ | ----------- | ------------- | -------------------- | ---- |
202
+ | TR-01 | bac-order-01 | 受注登録の入力制約 | |
203
+ | TR-02 | spec-order-05 | 重複時のエラーコード | |
271
204
 
272
- ### 8.3. 対象外
205
+ ## 6. テスト観点とケース
273
206
 
274
- - 外部決済サービス実疎通(理由:外部要因、代替:ET)
275
- - ブラウザ操作のE2E(理由:責務外、代替:E2E)
207
+ ### 6.1. 観点:永続化の整合性
276
208
 
277
- ### 8.4. 結合境界/依存/環境前提
278
-
279
- - 結合境界:`POST /orders`
280
- - 結合対象:OrderController → OrderService → OrderRepository → DB
281
- - DB:PostgreSQL(コンテナ)、マイグレーション適用済み
282
- - 外部在庫API:Stub(成功/失敗/タイムアウト)
283
- - 時刻:固定クロック注入
284
- - 初期化:テストごとにDBクリーン(トランザクション or truncate)
285
-
286
- ### 8.5. トレース
287
-
288
- | trace_key | 仕様ID | 要点 | 備考 |
289
- | --------- | ------------- | -------------------- | ---- |
290
- | TR-01 | bac-order-01 | 受注登録の入力制約 | |
291
- | TR-02 | spec-order-05 | 重複時のエラーコード | |
292
- | TR-03 | br-order-02 | トランザクション境界 | |
293
-
294
- ### 8.6. テスト観点とケース
295
-
296
- #### 8.6.1. 観点:永続化の整合性
297
-
298
- ##### 8.6.1.1. 意図
209
+ #### 6.1.1. 意図
299
210
 
300
211
  入力→保存→取得で、データが欠損/改変されず、制約と整合性が担保されることを検証する。
301
212
 
302
- ##### 8.6.1.2. 条件・ケース表
213
+ #### 6.1.2. 条件・ケース表
303
214
 
304
- | case_id | 条件 | 手順(最小) | 期待値 | 観測点(アサーション) | 境界/依存 | トレース | 優先度 | 自動化 | 証跡 |
215
+ | `case_id` | 条件 | 手順(最小) | 期待値 | 観測点(アサーション) | 境界/依存 | トレース | 優先度 | 自動化 | 証跡 |
305
216
  | ---------------------------------- | -------------------------------- | ------------ | ------------------------ | -------------------------- | --------------- | -------- | ------ | --------- | --------------------------------------- |
306
217
  | it-order-persistence-integrity-010 | 入力: 正常 / 状態: DB空 | POST /orders | 201 + DBに1件作成 | レスポンス/DB行/主要カラム | DB=実(コンテナ) | TR-01 | P0 | automated | tests/it/orders/create.test.ts, CI#123 |
307
218
  | it-order-persistence-integrity-020 | 入力: 制約違反 / 状態: DB空 | POST /orders | 400 + DBに作成されない | レスポンス/DB行0 | DB=実(制約観測) | TR-01 | P0 | automated | tests/it/orders/create.test.ts, CI#124 |
308
219
  | it-order-persistence-integrity-030 | 入力: 重複 / 状態: 既存orderあり | POST /orders | 409 + DB状態が変化しない | エラーコード/DB差分なし | DB=実 | TR-02 | P1 | automated | tests/it/orders/duplicate.test.ts, CI#9 |
220
+ ```