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,27 +13,17 @@ specdojo:
13
13
 
14
14
  Internal Integration Test Catalog (ITC) Index Documentation Rules
15
15
 
16
- 本ドキュメントは、内部結合テストカタログ(ITC)の全体概要 `itc-index` を統一形式で記述するためのルールです。
17
- TSPに基づき、内部結合テストに共通するルールや方針を定義します。
18
-
19
- 個別内部結合テストカタログ(`itc-<term>`)の記述ルールは `itc-rulebook.md` を参照してください。
16
+ 内部結合テストカタログ(ITC)の全体概要 `itc-index` に、TSPに基づく共通方針を記述するためのルールです。対象別カタログ `itc-<term>` は [[specdojo:itc-rulebook|内部結合テストカタログ 作成ルール]] に従います。
20
17
 
21
18
  ## 1. 全体方針
22
19
 
23
- `itc-index` は、内部結合テストカタログ(ITC)を **運用可能な最小情報**で統一し、
24
- 対象別カタログ(`itc-<term>`)の品質と一貫性を担保するための **共通ルール(SSOT)** とする。
25
-
26
- - `itc-index` は **「考え方・共通方針・共通定義」** を記述する(個別ケースは持たない)
27
- - 個別の観点・条件・ケースは **`itc-<term>` に集約**し、詳細は **テストコード/CI証跡** に寄せる
28
- - 記述は **レビュー可能**であることを優先し、長文化を避ける(方針は箇条書き中心)
29
- - 「例外」や「対象外」を明示し、内部結合テストの責任境界(何をやらないか)を固定する
30
- - `tsp-index` の方針を根拠として、内部結合テストに共通する **分割基準・観点/条件の立て方・依存境界・合格基準・証跡** を定義する
31
- - IT(内部結合)は **「複数コンポーネントの結合」** を扱い、UTでMockしていた依存の一部を **実装/実インフラに近づけて検証**する(ただし外部要因で不安定になるものは制御する)
20
+ - **正本の分担**: `itc-index` は共通方針、`itc-<term>` は対象別の観点・条件・ケース、テストコード/CIは実装と実行証跡を担う。
21
+ - **記載範囲**: `tsp-index` を根拠に、分割基準、観点/条件の立て方、依存境界、合格基準、証跡を定義し、対象外と例外条件を明示する。
22
+ - **検証範囲**: 複数コンポーネントを結合し、UTでMockしていた依存の一部を実装/実インフラに近づけて検証する。結果を不安定にする外部要因は制御する。
23
+ - **共通の運用**: 役割の割り当ては適用先のメンバー定義に、`status` の昇格と承認、改訂と廃止、未決事項の登録簿への引き継ぎは [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] に従う。文書の整形・lint はリポジトリの検証で扱い、業務の検証に含めない。
32
24
 
33
25
  ## 2. 位置づけ(他ドキュメントとの関係)
34
26
 
35
- `itc-index` と他ドキュメントの関係を示します。
36
-
37
27
  ```mermaid
38
28
  flowchart BT
39
29
  TSP["tsp-index<br>テスト戦略・方針"]
@@ -56,82 +46,55 @@ flowchart BT
56
46
 
57
47
  ## 3. ファイル命名・ID規則
58
48
 
59
- - 本ルールの対象ドキュメントの `id` は `itc-index` 固定。対象別は `itc-<term>`(詳細は `itc-rulebook.md`)。
60
- - ファイル名は `itc-010-内部結合テストカタログ-概要.md` 等、プロジェクト内で一意になるように命名します。
61
- - `<term>` は用語集の論理名キー(英小文字kebab-case)を用いる(表示名は title に日本語で記載してよい)。
49
+ - **ファイル名**: `itc-index.md` とし、配置は成果物カタログの宣言に合わせる。
50
+ - **文書 ID**: [[specdojo:id-and-file-naming-standard|ID・ファイル命名標準]] に従い、プロダクト文書は `itc-index`、プロジェクト文書は `<project-id>:itc-index` とする。対象別も同じ区分で `itc-<term>` を使う。
51
+ - **対象名**: `<term>` は用語集の論理名キー(英小文字kebab-case)とし、日本語の表示名は本文先頭の H1 に記載する。
62
52
 
63
53
  ## 4. 推奨 Frontmatter 項目
64
54
 
65
55
  ### 4.1. 設定内容
66
56
 
67
- 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))。
57
+ 許可キー・必須項目・型制約は [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] と `docs/specdojo/schemas/v1/deliverable-frontmatter.schema.yaml` に従う。
68
58
 
69
- | 項目 | 説明 | 必須 |
70
- | ---------- | -------------------------------------------------- | ---- |
71
- | id | `itc-index`(固定) | ○ |
72
- | type | `test` 固定 | ○ |
73
- | title | 内部結合テストカタログ: 概要(`<システム名>`) | ○ |
74
- | status | `draft` / `ready` / `deprecated` | ○ |
75
- | based_on | 根拠となる仕様ID(ID配列。未指定時は `[]` を許容) | 任意 |
76
- | supersedes | 置き換え関係(ID配列。未指定時は `[]` を許容) | 任意 |
59
+ - `specdojo.id` は「ファイル命名・ID規則」の区分に従う。
60
+ - `specdojo.type` は `test`、`specdojo.rulebook` は `specdojo:itc-index-rulebook` とする。
61
+ - 文書名は `# 内部結合テストカタログ: 概要(<システム名>)` とする。
77
62
 
78
63
  ### 4.2. 推奨ルール
79
64
 
80
- - `based_on` には最低限 `tsp-index` を含めます。
81
- - BAC/NFR/BR 等は、`itc-index` の方針判断(境界・分配・共通合格基準・環境方針)に **直接利用したものだけ** を `based_on` に列挙します。
82
- - `based_on` / `supersedes` は ID 配列(未指定は `[]` 可)。
65
+ - `based_on` には、適用先の正規 ID で `tsp-index` を含める。
66
+ - BAC/NFR/BR 等は、境界・分配・共通合格基準・環境方針の判断に直接利用したものだけを列挙する。
67
+ - カタログの `depends_on` がある場合は、その推移閉包内の作成済み文書に限定する。
83
68
 
84
69
  ## 5. 本文構成(標準テンプレ)
85
70
 
86
71
  `itc-index` は以下の見出し構成を **順序固定**で配置します。
87
72
 
88
- | 番号 | 見出し | 必須 |
89
- | ---- | ------------------------------ | ---- |
90
- | 1 | 本ドキュメントの目的と適用対象 | ○ |
91
- | 2 | テスト対象の括り方と分割基準 | ○ |
92
- | 3 | 対象外・除外理由(共通) | ○ |
93
- | 4 | 観点の立て方(共通) | ○ |
94
- | 5 | 条件の立て方(共通) | ○ |
95
-
96
- | 6 | 観点/条件の採用基準と対象別への分配方針(共通) | ○ |
97
- | 7 | 内部結合テスト共通の境界/依存の扱い | ○ |
98
- | 8 | テスト環境・データの共通方針 | ○ |
99
- | 9 | ケース表の共通カラム | ○ |
100
- | 10 | メモ / 将来課題 | 任意 |
101
-
102
- 注意:次章の記述ガイドのMarkdown見出しはルール文章内の参照用であり、
103
- 生成する `itc-index` 本文の見出しは各章で指定された **番号付き** の形式
104
- (例: `## 6.`, `### 6.1.` / `#### 6.1.1.` / `#### 6.1.2.`)に置き換えてください。
73
+ | 番号 | 見出し | 必須 |
74
+ | ---- | ----------------------------------------------- | ---- |
75
+ | 1 | 本ドキュメントの目的と適用対象 | ○ |
76
+ | 2 | テスト対象の括り方と分割基準 | ○ |
77
+ | 3 | 対象外・除外理由(共通) | ○ |
78
+ | 4 | 観点の立て方(共通) | ○ |
79
+ | 5 | 条件の立て方(共通) | ○ |
80
+ | 6 | 観点/条件の採用基準と対象別への分配方針(共通) | ○ |
81
+ | 7 | 内部結合テスト共通の境界/依存の扱い | ○ |
82
+ | 8 | テスト環境・データの共通方針 | ○ |
83
+ | 9 | ケース表の共通カラム | ○ |
84
+ | 10 | メモ / 将来課題 | 任意 |
85
+
86
+ 成果物本文は上表の番号付き H2 とし、各章の内容は「記述ガイド」に従う。
105
87
 
106
88
  ## 6. 記述ガイド
107
89
 
108
90
  ### 6.1. 本ドキュメントの目的と適用対象
109
91
 
110
- 生成する `itc-index` 本文の見出しは **## 1. 本ドキュメントの目的と適用対象**
111
-
112
- 本節では、`itc-index` が **何のために存在し、何に適用されるか** を明確にします。
113
-
114
- - 目的:`itc-<term>` を同一基準で作成し、品質・粒度・責任範囲を揃える
115
- - 適用対象:内部結合テスト(IT)に関するカタログ群(`itc-index` / `itc-<term>`)
116
- - 非適用:UT/ET/ST/AT のルールはそれぞれの `*c-index` で扱う
117
- - 成果物の位置づけ:
118
- - `itc-index`:共通方針(SSOT)
119
- - `itc-<term>`:対象別の観点・条件・ケース表(SSOT)
120
- - テストコード/CI:実装と実行証跡(SSOT)
121
-
122
- - SSOTの一次情報は `itc-index` / `itc-<term>` とし、テストコード/CIは **実装と実行結果の証跡(Evidence)** として扱う。
123
- - 本書が扱う粒度:**判断基準・共通ルールまで**(個別ケースの列挙は禁止)
124
-
125
- - ITで保証する範囲(例):
126
- - コンポーネント間の結合(I/F、変換、永続化、トランザクション境界)
127
- - UTでMockしていた依存の「実装妥当性」の一部(例:Repository実装、SQL、マイグレーション、シリアライズ)
92
+ - 目的は対象別カタログの品質・粒度・責任範囲を揃えることとし、適用対象のシステム・コンポーネント群を明記する。
93
+ - UT/ET/ST/AT との責務分界を示し、各レベルの詳細はそれぞれの `*c-index` に委ねる。
94
+ - 保証する結合を具体化する(例:I/F変換、永続化、トランザクション境界、Repository実装・SQL・マイグレーション・シリアライズの妥当性)。
128
95
 
129
96
  ### 6.2. テスト対象の括り方と分割基準
130
97
 
131
- 生成する `itc-index` 本文の見出しは **## 2. テスト対象の括り方と分割基準**
132
-
133
- 本節では、`itc-<term>` の `<term>` をどう切るか(対象単位の設計)を定義します。
134
-
135
98
  - `<term>` は「結合のまとまり」(例:ユースケース×主要I/F、サブシステム境界、アプリ層+DB層の縦スライス)とする
136
99
  - 分割基準(推奨順):
137
100
  1. **結合境界**:どのコンポーネント(層/モジュール/サービス)間を結合するかが説明できる
@@ -147,10 +110,6 @@ Frontmatter は共通スキーマに従います(参照: [docs/specdojo/schema
147
110
 
148
111
  ### 6.3. 対象外・除外理由(共通)
149
112
 
150
- 生成する `itc-index` 本文の見出しは **## 3. 対象外・除外理由(共通)**
151
-
152
- 本節では、内部結合テスト(IT)で **やらないこと** と、その **理由**、および **例外条件** を明確にします。
153
-
154
113
  #### 6.3.1. 記述ルール
155
114
 
156
115
  - 形式は **「対象外」「除外理由」「代替レベル/代替手段」「例外」** の4点セットを基本とする
@@ -173,8 +132,6 @@ Frontmatter は共通スキーマに従います(参照: [docs/specdojo/schema
173
132
 
174
133
  ### 6.4. 観点の立て方(共通)
175
134
 
176
- 生成する `itc-index` 本文の見出しは **## 4. 観点の立て方(共通)**
177
-
178
135
  観点(Perspective)は「結合したときに何を保証するか」の切り口であり、対象別カタログの章立て(見出し)として用います。
179
136
 
180
137
  - 観点の型(最低限この順で検討):
@@ -194,8 +151,6 @@ Frontmatter は共通スキーマに従います(参照: [docs/specdojo/schema
194
151
 
195
152
  ### 6.5. 条件の立て方(共通)
196
153
 
197
- 生成する `itc-index` 本文の見出しは **## 5. 条件の立て方(共通)**
198
-
199
154
  条件(Condition)は、観点を確認するための前提状態・入力状態・環境条件のバリエーションです。
200
155
  条件は「入力」「状態」「環境」に分解して作成します(ITでは **環境/データ条件** の比重が上がります)。
201
156
 
@@ -212,10 +167,6 @@ Frontmatter は共通スキーマに従います(参照: [docs/specdojo/schema
212
167
 
213
168
  ### 6.6. 観点/条件の採用基準と対象別への分配方針(共通)
214
169
 
215
- 生成する `itc-index` 本文の見出しは **## 6. 観点/条件の採用基準と対象別への分配方針(共通)**
216
-
217
- 本節では、観点/条件を「採用する判断」と「`itc-<term>` へ割り当てる判断」を共通ルールとして定義します。
218
-
219
170
  #### 6.6.1. 採用基準(共通)
220
171
 
221
172
  - 観点は「1観点=1合否命題」で採用する(複数命題の混在を禁止)
@@ -240,11 +191,6 @@ Frontmatter は共通スキーマに従います(参照: [docs/specdojo/schema
240
191
 
241
192
  ### 6.7. 内部結合テスト共通の境界/依存の扱い
242
193
 
243
- 生成する `itc-index` 本文の見出しは **## 7. 内部結合テスト共通の境界/依存の扱い**
244
-
245
- 内部結合テストでは、UTでMockしていた境界の一部を **実装に近づけて** 検証します。
246
- ただし、再現性・安定性が落ちる外部要因は制御し、結果が揺れないことを優先します。
247
-
248
194
  - DB:
249
195
  - 原則:**実DB(または実DB相当)** を用いる(コンテナDB等で再現性を担保)
250
196
  - 例外:DB以外の結合に集中したい場合のみ、Fake/Stubを許可(理由を明記)
@@ -268,10 +214,6 @@ Frontmatter は共通スキーマに従います(参照: [docs/specdojo/schema
268
214
 
269
215
  ### 6.8. テスト環境・データの共通方針
270
216
 
271
- 生成する `itc-index` 本文の見出しは **## 8. テスト環境・データの共通方針**
272
-
273
- ITは環境差で結果が揺れやすいため、環境・データの扱いを共通化します。
274
-
275
217
  - 環境の原則:
276
218
  - CIで再現可能(コンテナ、固定バージョン、固定設定)
277
219
  - 依存サービス(DB/Queue/Cache等)は **起動方法と設定を標準化**(compose/helm等)
@@ -288,49 +230,30 @@ ITは環境差で結果が揺れやすいため、環境・データの扱いを
288
230
 
289
231
  ### 6.9. ケース表の共通カラム
290
232
 
291
- 生成する `itc-index` 本文の見出しは **## 9. ケース表の共通カラム**
292
-
293
- `itc-<term>` の末端(条件・ケース表)は、検索性・比較性・自動化移行の容易さを確保するため、
294
- 全termで同一カラム順を採用します。
295
-
296
- 必須カラム:
297
-
298
- - `case_id`(ケースID):対象別に一意なIDで変更しない
299
- - `case_id` は `<level>-<term>-<perspective_key>-<nnn>`(nnnは3桁推奨)を推奨
300
- - 例: `it-order-persistence-integrity-010`
301
- - `perspective_key` は kebab-case のキー文字列(英小文字+数字+ハイフン)で、原則変更しない
302
- - `nnn` を 10刻みで付番(010, 020, 030…)
303
-
304
- - `条件`:入力/状態/環境の要点(`入力:` `状態:` `環境:` の形を推奨)
305
-
306
- - `手順(最小)`:抽象化した最小手順(クリック列挙禁止)
307
-
308
- - `期待値`:判定可能な合格条件(観測点を含める)
309
-
310
- 推奨カラム(運用必須):
311
-
312
- - `観測点(アサーション)`
313
- - `境界/依存`(DB種別、ブローカ、Stub等の扱い)
314
- - `トレース`
315
- - `優先度`:P0/P1/P2
316
- - `自動化`:manual/automated/mixed
317
- - `証跡`:テストコード/CI/レポート等の参照先
318
-
319
- 注意:
320
-
321
- - 表の1行=1テスト(条件×期待値が一意)
322
- - 手順・期待値を冗長に書かず、詳細はテストコードへ寄せる
233
+ `itc-<term>` のケース表は、次の共通カラム順とする。「推奨(運用必須)」の列も運用時には揃える。
234
+
235
+ | カラム | 区分 | 内容・受入条件 |
236
+ | ---------------------- | ---------------- | ---------------------------------------------------------------------------------------------------------------- |
237
+ | `case_id` | 必須 | 対象別に一意で変更しない。`it-<term>-<perspective_key>-<nnn>` を推奨(例:`it-order-persistence-integrity-010`) |
238
+ | 条件 | 必須 | 入力・状態・環境の要点。`入力:` `状態:` `環境:` の形を推奨 |
239
+ | 手順(最小) | 必須 | API呼出し・ジョブ実行等の最小手順。UIクリック列挙は禁止 |
240
+ | 期待値 | 必須 | 観測点を含む、判定可能な合格条件 |
241
+ | 観測点(アサーション) | 推奨(運用必須) | レスポンス、DB状態、イベント、相互作用等の検証箇所 |
242
+ | 境界/依存 | 推奨(運用必須) | DB種別、ブローカ、Stub等の扱い |
243
+ | トレース | 推奨(運用必須) | 対象別カタログの根拠仕様への対応 |
244
+ | 優先度 | 推奨(運用必須) | P0/P1/P2 |
245
+ | 自動化 | 推奨(運用必須) | manual/automated/mixed |
246
+ | 証跡 | 推奨(運用必須) | テストコード/CI/レポート等の参照先 |
247
+
248
+ - `perspective_key` は英小文字・数字・ハイフンのkebab-caseで、原則変更しない。`nnn` は3桁・10刻み(010, 020, 030…)を推奨する。
249
+ - 表の1行は条件と期待値が一意な1テストとし、詳細手順はテストコードへ寄せる。
250
+ - **良い例**: 「一意制約違反の入力で登録APIを呼び、409応答とDB差分なしを確認する」。**悪い例**: 「正常に動くこと」(観測点も合格条件も不明)。
323
251
 
324
252
  ### 6.10. メモ / 将来課題
325
253
 
326
- 生成する `itc-index` 本文の見出しは **## 10. メモ / 将来課題**
327
-
328
- - 将来検討(例):
329
- - テストデータ管理(fixture生成、匿名化、seed戦略)
330
- - 環境起動時間の短縮(コンテナ最適化、キャッシュ)
331
- - flaky対策(リトライ方針、タイムアウト基準)
332
- - 証跡リンク形式の統一(CI URL、ログ保存場所)
333
- - カタログlint(case_id重複、必須列欠落など)
254
+ - 検討候補は fixture生成・匿名化・seed戦略、環境起動時間短縮(コンテナ最適化・キャッシュ)、flaky対策(リトライ方針・タイムアウト基準)、証跡リンク形式、ケースID重複・必須列の検査などとする。
255
+ - 未決事項は論点と、対象別カタログ・環境・データ・証跡への影響(当面の扱い、決定後に直す箇所)を記載する。
256
+ - 確定して共通方針となった内容は該当章へ移し、本節で言い直さない。
334
257
 
335
258
  ## 7. 禁止事項
336
259
 
@@ -340,83 +263,31 @@ ITは環境差で結果が揺れやすいため、環境・データの扱いを
340
263
  | 環境前提(DB/Queue等)を対象ごとに無根拠に変更する | IT全体で再現性が崩れ、CIが不安定・レビュー困難になるため(例外は根拠とともに明記) |
341
264
  | 外部サービス疎通をITの必須範囲に含める | 外部要因で結果が揺れ、再現性が低く、責務はETへ分離すべきため |
342
265
  | 手順にUI操作のクリック列挙を書く(末端表でも過剰な操作手順を書く) | 保守性が低く、変更に弱く、テストの意図が見えなくなるため |
343
- | 期待値を「成功すること」など曖昧に書く | 判定不能で合否が揺れ、証跡として機能しないため |
344
266
  | `case_id` を後から変更する(参照があるのに変更する) | トレース・証跡リンクが壊れ、履歴追跡が不能になるため |
345
267
  | `itc-index` の対象外方針と矛盾するIT範囲を無説明で拡張する | レベル間の責務分界が崩れるため(ITで必要なら、対象/根拠/再現性対策を明記して定義する) |
346
268
 
347
269
  ## 8. サンプル(最小)
348
270
 
349
- 注:以下はルール文書内の例示です。生成する `itc-index` では `## 1...` から始まります。
271
+ 対象外の判断を示す部分例です。成果物全体では「本文構成(標準テンプレ)」の必須章を揃えます。
350
272
 
351
- ```yaml
273
+ ```markdown
352
274
  ---
353
- id: itc-index
354
- type: test
355
- title: 内部結合テストカタログ: 概要
356
- status: draft
357
- based_on: [tsp-index]
358
- supersedes: []
275
+ specdojo:
276
+ id: itc-index
277
+ type: test
278
+ status: draft
279
+ rulebook: specdojo:itc-index-rulebook
280
+ based_on: [tsp-index]
359
281
  ---
360
- ```
361
-
362
- ### 8.1. 本ドキュメントの目的と適用対象
363
-
364
- 本ドキュメントは、内部結合テストカタログ(ITC)の全体概要 `itc-index` を統一形式で記述するためのルールである。
365
- `itc-index` は内部結合テストに共通する「対象単位の切り方」「観点/条件の立て方」「依存境界」「環境・データ方針」「合格基準」「証跡方針」を定義し、
366
- 対象別カタログ `itc-<term>` の作成と運用の基盤とする。
367
-
368
- ### 8.2. テスト対象の括り方と分割基準
369
-
370
- `itc-<term>` の `<term>` は結合のまとまり(例:ユースケース×主要I/F、アプリ層+DB層の縦スライス)とする。
371
- 分割は結合境界・データ境界・I/F境界・変更影響・担当境界を基準とし、過分割と肥大化の双方を避ける。
372
-
373
- ### 8.3. 対象外・除外理由(共通)
374
-
375
- 内部結合テスト(IT)では、内部結合の妥当性を再現性高く検証するため、以下は原則として対象外とする。
376
-
377
- | 対象外(やらないこと) | 除外理由 | 代替レベル/代替手段 | 例外(ITで扱う条件) |
378
- | ------------------------------------------ | ------------------------------------ | -------------------- | ---------------------------------- |
379
- | 外部サービスとの実疎通(実通信・実認証) | 外部要因で結果が揺れ、再現性が低い | ET(etcカタログ) | 外部を完全にスタブ化できる場合のみ |
380
- | ブラウザ/端末差分のUI互換(表示崩れ等) | 実行環境差が本質でITでは担保しにくい | E2E(e2eカタログ) | なし |
381
- | 性能・負荷・耐久(p95、スループット等) | 測定設計が別物で、条件統制が必要 | NFR(nfrカタログ) | なし |
382
- | 本番相当の障害試験(リージョン障害、DR等) | 環境再現コストが高く、目的が別 | ST/運用リハ、Chaos等 | なし |
383
282
 
384
- 例外を適用する場合は、`itc-<term>` 側に「例外の根拠」と「再現性担保策(スタブ、固定設定等)」を明記する。
283
+ # 内部結合テストカタログ: 概要(受注管理)
385
284
 
386
- ### 8.4. 観点の立て方(共通)
285
+ ## 3. 対象外・除外理由(共通)
387
286
 
388
- 観点は結合で崩れやすいポイント(I/F契約、永続化整合、トランザクション境界、依存障害時の挙動等)を基軸に立てる。
389
- 観点名は「名詞+品質/振る舞い」で統一し、条件を複数持てる程度の粒度にまとめる。
390
-
391
- ### 8.5. 条件の立て方(共通)
392
-
393
- 条件は入力・状態・環境に分解し、代表→境界→重大例外の順で追加する。
394
- 直積は原則作らず、必要時のみ理由と管理方法(データセット参照等)を明記する。
395
-
396
- ### 8.6. 観点/条件の採用基準と対象別への分配方針(共通)
397
-
398
- 観点/条件は、業務影響・境界/例外/状態遷移の重要性・上位仕様根拠を基準に採用する。
399
- 分配は結合境界・データ境界・変更影響を基準に主担当 `itc-<term>` を1つ定め、重複は例外として扱う。
400
- 分配結果は `itc-<term>` のケース表とトレース列で追跡可能にする。
401
-
402
- ### 8.7. 内部結合テスト共通の境界/依存の扱い
403
-
404
- 内部結合テストでは、UTでMockしていた境界の一部を実装に近づけて検証する。
405
- DBは原則として実DB相当(コンテナDB等)を用い、外部サービスはStub/Mockで制御する。
406
- 非同期やメッセージングは決定性を担保できる構成で実行する。
407
-
408
- ### 8.8. テスト環境・データの共通方針
409
-
410
- CIで再現可能な環境(固定バージョン、固定設定)で実行する。
411
- テストデータは独立・最小化し、並列実行時の干渉を避けるため名前空間分離や初期化を行う。
412
-
413
- ### 8.9. ケース表の共通カラム
414
-
415
- 対象別カタログ `itc-<term>` の末端表は全termで共通のカラム順を採用する。
416
- 必須:case_id / 条件 / 手順(最小) / 期待値
417
- 推奨:観測点(アサーション)/ 境界・依存 / トレース / 優先度 / 自動化 / 証跡
418
-
419
- ### 8.10. メモ / 将来課題
420
-
421
- 将来検討事項(例):fixture戦略、環境起動時間短縮、flaky対策、証跡リンク形式統一、カタログlint 等を記録する。
422
- 運用必須になった時点で本文へ昇格させる。
287
+ | 対象外(やらないこと) | 除外理由 | 代替レベル/代替手段 | 例外(ITで扱う条件) |
288
+ | ------------------------- | ------------------------------ | -------------------- | -------------------------------- |
289
+ | 外部決済との実疎通 | 外部要因で結果が揺れる | ET | なし。ITではStubで応答を制御する |
290
+ | ブラウザ/端末差分のUI互換 | 実行環境差が本質 | E2E | なし |
291
+ | 性能・負荷・耐久 | 測定設計と条件統制が別途必要 | NFR | なし |
292
+ | リージョン障害・DR | 本番相当環境の再現コストが高い | ST/運用リハ、Chaos等 | なし |
293
+ ```