specdojo 0.1.0 → 0.2.1

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 (540) hide show
  1. package/LICENSE +22 -0
  2. package/README.md +142 -35
  3. package/dist/agent-response.js +27 -0
  4. package/dist/agent.js +124 -0
  5. package/dist/build-command.js +149 -0
  6. package/dist/build-if-stale.js +35 -0
  7. package/dist/catalog-build.js +1079 -0
  8. package/dist/catalog-generate.js +226 -0
  9. package/dist/catalog-paths.js +31 -0
  10. package/dist/catalog-plan-generate.js +301 -0
  11. package/dist/catalog-plan-prompt.js +73 -0
  12. package/dist/catalog-plan.js +471 -0
  13. package/dist/catalog-scaffold.js +255 -0
  14. package/dist/catalog-types.js +4 -0
  15. package/dist/catalog.js +606 -0
  16. package/dist/dashboard.js +990 -0
  17. package/dist/deliverable-trash.js +148 -0
  18. package/dist/deliverable.js +97 -0
  19. package/dist/dist-freshness.js +150 -0
  20. package/dist/doc-index.js +424 -0
  21. package/dist/exec-agent-config.js +172 -0
  22. package/dist/exec-agent-git-state.js +136 -0
  23. package/dist/exec-agent-protected-config.js +276 -0
  24. package/dist/exec-events.js +250 -112
  25. package/dist/exec-evidence.js +317 -0
  26. package/dist/exec-format.js +54 -0
  27. package/dist/exec-limit.js +202 -0
  28. package/dist/exec-parent-validation.js +169 -0
  29. package/dist/exec-pipeline-state.js +160 -0
  30. package/dist/exec-plans.js +1016 -0
  31. package/dist/exec-project.js +25 -11
  32. package/dist/exec-protection-handoff.js +169 -0
  33. package/dist/exec-provider-scaffold.js +99 -0
  34. package/dist/exec-register-resume.js +196 -0
  35. package/dist/exec-register.js +281 -0
  36. package/dist/exec-reporter.js +329 -0
  37. package/dist/exec-results.js +510 -0
  38. package/dist/exec-run-lock.js +149 -0
  39. package/dist/exec-run.js +4953 -0
  40. package/dist/exec-schedule-calendar.js +86 -9
  41. package/dist/exec-schedule-cpm.js +30 -12
  42. package/dist/exec-schedule-gantt-chart-render.js +428 -0
  43. package/dist/exec-schedule-gantt-chart-scope.js +111 -0
  44. package/dist/exec-schedule-gantt-chart.js +2 -0
  45. package/dist/exec-schedule-hash.js +34 -25
  46. package/dist/exec-schedule-index.js +200 -67
  47. package/dist/exec-schedule-initial.js +100 -0
  48. package/dist/exec-schedule-progress.js +51 -26
  49. package/dist/exec-schedule-ready.js +71 -27
  50. package/dist/exec-schedule.js +171 -93
  51. package/dist/exec-shared.js +146 -25
  52. package/dist/exec-strategy.js +547 -0
  53. package/dist/exec-task-view.js +64 -0
  54. package/dist/exec-trial.js +895 -0
  55. package/dist/exec-worktree-command.js +426 -0
  56. package/dist/exec-worktree-ops.js +847 -0
  57. package/dist/exec-worktree.js +359 -0
  58. package/dist/exec.js +744 -192
  59. package/dist/frontmatter-namespace.js +48 -0
  60. package/dist/git-environment.js +23 -0
  61. package/dist/grade-result.js +137 -0
  62. package/dist/grade.js +2456 -0
  63. package/dist/index-command.js +103 -0
  64. package/dist/job.js +1081 -0
  65. package/dist/kata-command.js +303 -0
  66. package/dist/kata.js +187 -0
  67. package/dist/package-paths.js +33 -0
  68. package/dist/practice-id.js +24 -0
  69. package/dist/register-date.js +122 -0
  70. package/dist/register-events.js +363 -0
  71. package/dist/register-history.js +323 -0
  72. package/dist/register-item.js +455 -0
  73. package/dist/register-migrate-timestamps.js +176 -0
  74. package/dist/register.js +2199 -0
  75. package/dist/review-plan.js +199 -0
  76. package/dist/review-types.js +1 -0
  77. package/dist/role-types.js +1 -0
  78. package/dist/routine.js +814 -0
  79. package/dist/schedule-approach.js +252 -0
  80. package/dist/schedule-build.js +552 -0
  81. package/dist/schedule-phase-sets.js +73 -0
  82. package/dist/schedule-strategy-generate.js +812 -0
  83. package/dist/schedule-strategy-profiles.js +276 -0
  84. package/dist/schedule.js +420 -0
  85. package/dist/spawn-self.js +28 -0
  86. package/dist/specdojo-config.js +133 -39
  87. package/dist/specdojo.js +56 -7
  88. package/dist/template-frontmatter.js +89 -0
  89. package/dist/template-resolution.js +92 -0
  90. package/dist/timeline-build.js +334 -0
  91. package/dist/timeline.js +107 -0
  92. package/dist/watch.js +313 -0
  93. package/dist/yaml-pages-command.js +28 -0
  94. package/dist/yaml-pages.js +180 -0
  95. package/dist/yaml-schema-modeline.js +49 -0
  96. package/docs/ja/specdojo/defaults/pm-review-viewpoints.yaml +600 -0
  97. package/docs/ja/specdojo/exec-templates/xep-bootstrap-template.md +120 -0
  98. package/docs/ja/specdojo/exec-templates/xep-common-conventions-template.md +37 -0
  99. package/docs/ja/specdojo/exec-templates/xep-cross-deliverable-dedup-template.md +51 -0
  100. package/docs/ja/specdojo/exec-templates/xep-freeform-template.md +74 -0
  101. package/docs/ja/specdojo/exec-templates/xep-fully-guided-template.md +109 -0
  102. package/docs/ja/specdojo/exec-templates/xep-job-template.md +43 -0
  103. package/docs/ja/specdojo/exec-templates/xep-recipe-guided-template.md +82 -0
  104. package/docs/ja/specdojo/exec-templates/xep-recipe-maintenance-template.md +86 -0
  105. package/docs/ja/specdojo/exec-templates/xep-register-investigate-template.md +42 -0
  106. package/docs/ja/specdojo/exec-templates/xep-register-template.md +49 -0
  107. package/docs/ja/specdojo/exec-templates/xep-retrofit-template.md +98 -0
  108. package/docs/ja/specdojo/exec-templates/xep-rulebook-maintenance-template.md +86 -0
  109. package/docs/ja/specdojo/exec-templates/xep-sample-maintenance-template.md +86 -0
  110. package/docs/ja/specdojo/exec-templates/xep-template-maintenance-template.md +86 -0
  111. package/docs/ja/specdojo/exec-templates/xep-template.md +66 -0
  112. package/docs/ja/specdojo/exec-templates/xer-cross-deliverable-dedup-template.md +31 -0
  113. package/docs/ja/specdojo/exec-templates/xer-human-bootstrap-finalize-template.md +40 -0
  114. package/docs/ja/specdojo/exec-templates/xer-human-finalize-template.md +30 -0
  115. package/docs/ja/specdojo/exec-templates/xer-template.md +19 -0
  116. package/docs/ja/specdojo/exec-templates/xrp-freeform-template.md +70 -0
  117. package/docs/ja/specdojo/exec-templates/xrp-fully-guided-template.md +97 -0
  118. package/docs/ja/specdojo/exec-templates/xrp-recipe-guided-template.md +76 -0
  119. package/docs/ja/specdojo/exec-templates/xrp-recipe-maintenance-template.md +73 -0
  120. package/docs/ja/specdojo/exec-templates/xrp-retrofit-template.md +74 -0
  121. package/docs/ja/specdojo/exec-templates/xrp-rulebook-maintenance-template.md +74 -0
  122. package/docs/ja/specdojo/exec-templates/xrp-sample-maintenance-template.md +73 -0
  123. package/docs/ja/specdojo/exec-templates/xrp-template-maintenance-template.md +73 -0
  124. package/docs/ja/specdojo/exec-templates/xrp-template.md +67 -0
  125. package/docs/ja/specdojo/exec-templates/xrp-viewpoint-detail-template.md +7 -0
  126. package/docs/ja/specdojo/exec-templates/xrr-template.md +21 -0
  127. package/docs/ja/specdojo/exec-templates/xrr-viewpoint-detail-template.md +7 -0
  128. package/docs/ja/specdojo/guides/branch-workflow-guide.md +354 -0
  129. package/docs/ja/specdojo/guides/docs-editing-guide.md +327 -0
  130. package/docs/ja/specdojo/guides/docs-structure-guide.md +519 -0
  131. package/docs/ja/specdojo/guides/exec-config-guide.md +589 -0
  132. package/docs/ja/specdojo/guides/exec-operation-guide.md +440 -0
  133. package/docs/ja/specdojo/guides/exec-worktree-guide.md +318 -0
  134. package/docs/ja/specdojo/guides/kata-guide.md +89 -0
  135. package/docs/ja/specdojo/guides/orchestrator-operation-guide.md +127 -0
  136. package/docs/ja/specdojo/guides/plan-result-lifecycle-guide.md +228 -0
  137. package/docs/ja/specdojo/guides/practice-system-composition-guide.md +111 -0
  138. package/docs/ja/specdojo/guides/quick-start-guide.md +472 -0
  139. package/docs/ja/specdojo/guides/register-operation-guide.md +418 -0
  140. package/docs/ja/specdojo/guides/remote-host-development-guide.md +163 -0
  141. package/docs/ja/specdojo/guides/review-guide.md +428 -0
  142. package/docs/ja/specdojo/guides/routine-operation-guide.md +282 -0
  143. package/docs/ja/specdojo/guides/ryu-guide.md +230 -0
  144. package/docs/ja/specdojo/guides/schedule-design-guide.md +429 -0
  145. package/docs/ja/specdojo/guides/schedule-operation-guide.md +151 -0
  146. package/docs/ja/specdojo/guides/specdojo-overview-guide.md +257 -0
  147. package/docs/ja/specdojo/guides/timeline-design-guide.md +160 -0
  148. package/docs/ja/specdojo/guides/track-design-guide.md +215 -0
  149. package/docs/ja/specdojo/guides/use-case-guide.md +133 -0
  150. package/docs/ja/specdojo/guides/waza-guide.md +224 -0
  151. package/docs/ja/specdojo/index.md +33 -0
  152. package/docs/ja/specdojo/philosophy/needs-to-implementation-philosophy.md +212 -0
  153. package/docs/ja/specdojo/philosophy/specdojo-philosophy.md +242 -0
  154. package/docs/ja/specdojo/recipes/cdfd-overview-recipe.md +198 -0
  155. package/docs/ja/specdojo/recipes/cdfd-recipe.md +218 -0
  156. package/docs/ja/specdojo/recipes/cdfd-uc-recipe.md +198 -0
  157. package/docs/ja/specdojo/recipes/exec-human-finalize-recipe.md +100 -0
  158. package/docs/ja/specdojo/recipes/ifx-cmd-recipe.md +148 -0
  159. package/docs/ja/specdojo/recipes/pm-communication-plan-recipe.md +97 -0
  160. package/docs/ja/specdojo/recipes/pm-members-recipe.md +149 -0
  161. package/docs/ja/specdojo/recipes/pm-organization-recipe.md +96 -0
  162. package/docs/ja/specdojo/recipes/pm-plan-recipe.md +98 -0
  163. package/docs/ja/specdojo/recipes/pm-quality-management-plan-recipe.md +97 -0
  164. package/docs/ja/specdojo/recipes/pm-raci-recipe.md +96 -0
  165. package/docs/ja/specdojo/recipes/pm-roles-recipe.md +136 -0
  166. package/docs/ja/specdojo/recipes/prj-assumptions-constraints-dependencies-recipe.md +162 -0
  167. package/docs/ja/specdojo/recipes/prj-charter-recipe.md +187 -0
  168. package/docs/ja/specdojo/recipes/prj-comparison-of-alternatives-recipe.md +235 -0
  169. package/docs/ja/specdojo/recipes/prj-issues-and-approach-recipe.md +205 -0
  170. package/docs/ja/specdojo/recipes/prj-overview-recipe.md +289 -0
  171. package/docs/ja/specdojo/recipes/prj-scope-recipe.md +201 -0
  172. package/docs/ja/specdojo/recipes/prj-stakeholder-register-recipe.md +168 -0
  173. package/docs/ja/specdojo/recipes/prj-success-criteria-and-acceptance-criteria-recipe.md +179 -0
  174. package/docs/ja/specdojo/recipes/stsd-recipe.md +138 -0
  175. package/docs/ja/specdojo/references/command-reference.md +718 -0
  176. package/docs/ja/specdojo/references/deliverables-reference.md +407 -0
  177. package/docs/ja/specdojo/references/directory-layout-reference.md +280 -0
  178. package/docs/ja/specdojo/references/specdojo-config-reference.md +133 -0
  179. package/docs/ja/specdojo/rulebooks/atc-index-rulebook.md +372 -0
  180. package/docs/ja/specdojo/rulebooks/atc-rulebook.md +302 -0
  181. package/docs/ja/specdojo/rulebooks/bac-rulebook.md +331 -0
  182. package/docs/ja/specdojo/rulebooks/bdd-rulebook.md +134 -0
  183. package/docs/ja/specdojo/rulebooks/bds-rulebook.md +207 -0
  184. package/docs/ja/specdojo/rulebooks/bes-index-rulebook.md +102 -0
  185. package/docs/ja/specdojo/rulebooks/bes-rulebook.md +131 -0
  186. package/docs/ja/specdojo/rulebooks/bps-rulebook.md +269 -0
  187. package/docs/ja/specdojo/rulebooks/br-rulebook.md +187 -0
  188. package/docs/ja/specdojo/rulebooks/ccd-mermaid-rulebook.md +279 -0
  189. package/docs/ja/specdojo/rulebooks/cdfd-mermaid-rulebook.md +219 -0
  190. package/docs/ja/specdojo/rulebooks/cdfd-overview-rulebook.md +233 -0
  191. package/docs/ja/specdojo/rulebooks/cdfd-rulebook.md +182 -0
  192. package/docs/ja/specdojo/rulebooks/cdfd-uc-rulebook.md +171 -0
  193. package/docs/ja/specdojo/rulebooks/cdsd-rulebook.md +105 -0
  194. package/docs/ja/specdojo/rulebooks/cld-rulebook.md +195 -0
  195. package/docs/ja/specdojo/rulebooks/cnd-mermaid-rulebook.md +285 -0
  196. package/docs/ja/specdojo/rulebooks/cnd-rulebook.md +292 -0
  197. package/docs/ja/specdojo/rulebooks/cop-index-rulebook.md +171 -0
  198. package/docs/ja/specdojo/rulebooks/cop-rulebook.md +325 -0
  199. package/docs/ja/specdojo/rulebooks/cpd-mermaid-rulebook.md +266 -0
  200. package/docs/ja/specdojo/rulebooks/cpd-rulebook.md +294 -0
  201. package/docs/ja/specdojo/rulebooks/cstd-rulebook.md +21 -0
  202. package/docs/ja/specdojo/rulebooks/cxd-mermaid-rulebook.md +401 -0
  203. package/docs/ja/specdojo/rulebooks/cxd-rulebook.md +311 -0
  204. package/docs/ja/specdojo/rulebooks/dct-index-rulebook.md +158 -0
  205. package/docs/ja/specdojo/rulebooks/dct-rulebook.md +287 -0
  206. package/docs/ja/specdojo/rulebooks/dec-rulebook.md +62 -0
  207. package/docs/ja/specdojo/rulebooks/dmd-index-rulebook.md +100 -0
  208. package/docs/ja/specdojo/rulebooks/dmd-rulebook.md +298 -0
  209. package/docs/ja/specdojo/rulebooks/etc-index-rulebook.md +379 -0
  210. package/docs/ja/specdojo/rulebooks/etc-rulebook.md +310 -0
  211. package/docs/ja/specdojo/rulebooks/gl-rulebook.md +86 -0
  212. package/docs/ja/specdojo/rulebooks/ifd-mermaid-rulebook.md +297 -0
  213. package/docs/ja/specdojo/rulebooks/ifx-api-rulebook.md +79 -0
  214. package/docs/ja/specdojo/rulebooks/ifx-cmd-rulebook.md +213 -0
  215. package/docs/ja/specdojo/rulebooks/ifx-file-rulebook.md +311 -0
  216. package/docs/ja/specdojo/rulebooks/ifx-index-rulebook.md +94 -0
  217. package/docs/ja/specdojo/rulebooks/ifx-msg-rulebook.md +81 -0
  218. package/docs/ja/specdojo/rulebooks/imp-business-rulebook.md +117 -0
  219. package/docs/ja/specdojo/rulebooks/imp-data-rulebook.md +118 -0
  220. package/docs/ja/specdojo/rulebooks/imp-interface-rulebook.md +116 -0
  221. package/docs/ja/specdojo/rulebooks/imp-operations-rulebook.md +116 -0
  222. package/docs/ja/specdojo/rulebooks/imp-test-rulebook.md +116 -0
  223. package/docs/ja/specdojo/rulebooks/itc-index-rulebook.md +421 -0
  224. package/docs/ja/specdojo/rulebooks/itc-rulebook.md +307 -0
  225. package/docs/ja/specdojo/rulebooks/mip-index-rulebook.md +312 -0
  226. package/docs/ja/specdojo/rulebooks/mm-rulebook.md +63 -0
  227. package/docs/ja/specdojo/rulebooks/mtp-rulebook.md +353 -0
  228. package/docs/ja/specdojo/rulebooks/nfr-availability-rulebook.md +184 -0
  229. package/docs/ja/specdojo/rulebooks/nfr-index-rulebook.md +179 -0
  230. package/docs/ja/specdojo/rulebooks/nfr-integrity-rulebook.md +184 -0
  231. package/docs/ja/specdojo/rulebooks/nfr-maintainability-rulebook.md +183 -0
  232. package/docs/ja/specdojo/rulebooks/nfr-operations-rulebook.md +185 -0
  233. package/docs/ja/specdojo/rulebooks/nfr-performance-rulebook.md +185 -0
  234. package/docs/ja/specdojo/rulebooks/nfr-reliability-rulebook.md +186 -0
  235. package/docs/ja/specdojo/rulebooks/nfr-security-safety-rulebook.md +186 -0
  236. package/docs/ja/specdojo/rulebooks/nfr-usability-rulebook.md +184 -0
  237. package/docs/ja/specdojo/rulebooks/ntp-rulebook.md +61 -0
  238. package/docs/ja/specdojo/rulebooks/opd-index-rulebook.md +84 -0
  239. package/docs/ja/specdojo/rulebooks/opd-rulebook.md +357 -0
  240. package/docs/ja/specdojo/rulebooks/opr-index-rulebook.md +80 -0
  241. package/docs/ja/specdojo/rulebooks/opr-rulebook.md +484 -0
  242. package/docs/ja/specdojo/rulebooks/otp-index-rulebook.md +120 -0
  243. package/docs/ja/specdojo/rulebooks/otp-rulebook.md +293 -0
  244. package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +211 -0
  245. package/docs/ja/specdojo/rulebooks/pm-change-request-log-rulebook.md +94 -0
  246. package/docs/ja/specdojo/rulebooks/pm-communication-plan-rulebook.md +116 -0
  247. package/docs/ja/specdojo/rulebooks/pm-issue-log-rulebook.md +93 -0
  248. package/docs/ja/specdojo/rulebooks/pm-members-rulebook.md +190 -0
  249. package/docs/ja/specdojo/rulebooks/pm-organization-rulebook.md +108 -0
  250. package/docs/ja/specdojo/rulebooks/pm-plan-rulebook.md +122 -0
  251. package/docs/ja/specdojo/rulebooks/pm-quality-management-plan-rulebook.md +117 -0
  252. package/docs/ja/specdojo/rulebooks/pm-raci-rulebook.md +116 -0
  253. package/docs/ja/specdojo/rulebooks/pm-risk-register-rulebook.md +93 -0
  254. package/docs/ja/specdojo/rulebooks/pm-roles-rulebook.md +146 -0
  255. package/docs/ja/specdojo/rulebooks/pr-rulebook.md +65 -0
  256. package/docs/ja/specdojo/rulebooks/prj-assumptions-constraints-dependencies-rulebook.md +178 -0
  257. package/docs/ja/specdojo/rulebooks/prj-charter-rulebook.md +232 -0
  258. package/docs/ja/specdojo/rulebooks/prj-comparison-of-alternatives-rulebook.md +235 -0
  259. package/docs/ja/specdojo/rulebooks/prj-issues-and-approach-rulebook.md +242 -0
  260. package/docs/ja/specdojo/rulebooks/prj-overview-rulebook.md +187 -0
  261. package/docs/ja/specdojo/rulebooks/prj-scope-rulebook.md +201 -0
  262. package/docs/ja/specdojo/rulebooks/prj-stakeholder-register-rulebook.md +165 -0
  263. package/docs/ja/specdojo/rulebooks/prj-success-criteria-and-acceptance-criteria-rulebook.md +165 -0
  264. package/docs/ja/specdojo/rulebooks/sac-rulebook.md +202 -0
  265. package/docs/ja/specdojo/rulebooks/sch-rulebook.md +139 -0
  266. package/docs/ja/specdojo/rulebooks/sf-index-rulebook.md +63 -0
  267. package/docs/ja/specdojo/rulebooks/sf-rulebook.md +93 -0
  268. package/docs/ja/specdojo/rulebooks/sld-rulebook.md +93 -0
  269. package/docs/ja/specdojo/rulebooks/stc-index-rulebook.md +329 -0
  270. package/docs/ja/specdojo/rulebooks/stc-rulebook.md +297 -0
  271. package/docs/ja/specdojo/rulebooks/stsd-mermaid-rulebook.md +132 -0
  272. package/docs/ja/specdojo/rulebooks/stsd-rulebook.md +215 -0
  273. package/docs/ja/specdojo/rulebooks/sysd-critical-flows-rulebook.md +376 -0
  274. package/docs/ja/specdojo/rulebooks/sysd-cross-cutting-policy-rulebook.md +313 -0
  275. package/docs/ja/specdojo/rulebooks/sysd-index-rulebook.md +246 -0
  276. package/docs/ja/specdojo/rulebooks/sysd-rulebook.md +119 -0
  277. package/docs/ja/specdojo/rulebooks/tml-rulebook.md +188 -0
  278. package/docs/ja/specdojo/rulebooks/trc-requirements-to-specs-rulebook.md +114 -0
  279. package/docs/ja/specdojo/rulebooks/trc-requirements-to-tests-rulebook.md +117 -0
  280. package/docs/ja/specdojo/rulebooks/tsd-index-rulebook.md +101 -0
  281. package/docs/ja/specdojo/rulebooks/tsd-rulebook.md +103 -0
  282. package/docs/ja/specdojo/rulebooks/tsp-index-rulebook.md +396 -0
  283. package/docs/ja/specdojo/rulebooks/uis-rulebook.md +207 -0
  284. package/docs/ja/specdojo/rulebooks/utc-index-rulebook.md +387 -0
  285. package/docs/ja/specdojo/rulebooks/utc-rulebook.md +303 -0
  286. package/docs/ja/specdojo/samples/atc-index-sample.md +38 -0
  287. package/docs/ja/specdojo/samples/atc-sample.md +41 -0
  288. package/docs/ja/specdojo/samples/bac-sample.md +38 -0
  289. package/docs/ja/specdojo/samples/bdd-sample.yaml +71 -0
  290. package/docs/ja/specdojo/samples/bds-sample.md +38 -0
  291. package/docs/ja/specdojo/samples/bes-index-sample.md +38 -0
  292. package/docs/ja/specdojo/samples/bes-sample.md +38 -0
  293. package/docs/ja/specdojo/samples/bps-sample.md +38 -0
  294. package/docs/ja/specdojo/samples/br-sample.md +40 -0
  295. package/docs/ja/specdojo/samples/ccd-sample.md +38 -0
  296. package/docs/ja/specdojo/samples/cdfd-overview-sample.md +284 -0
  297. package/docs/ja/specdojo/samples/cdfd-sample.md +229 -0
  298. package/docs/ja/specdojo/samples/cdfd-uc-sample.md +146 -0
  299. package/docs/ja/specdojo/samples/cdsd-sample.md +38 -0
  300. package/docs/ja/specdojo/samples/cld-sample.md +38 -0
  301. package/docs/ja/specdojo/samples/cnd-sample.md +38 -0
  302. package/docs/ja/specdojo/samples/cop-index-sample.md +38 -0
  303. package/docs/ja/specdojo/samples/cop-sample.md +38 -0
  304. package/docs/ja/specdojo/samples/cpd-sample.md +38 -0
  305. package/docs/ja/specdojo/samples/cstd-sample.md +11 -0
  306. package/docs/ja/specdojo/samples/cxd-sample.md +38 -0
  307. package/docs/ja/specdojo/samples/dct-index-sample.yaml +39 -0
  308. package/docs/ja/specdojo/samples/dct-sample.yaml +91 -0
  309. package/docs/ja/specdojo/samples/dec-sample.md +39 -0
  310. package/docs/ja/specdojo/samples/dmd-index-sample.md +50 -0
  311. package/docs/ja/specdojo/samples/dmd-sample.md +74 -0
  312. package/docs/ja/specdojo/samples/etc-index-sample.md +38 -0
  313. package/docs/ja/specdojo/samples/etc-sample.md +38 -0
  314. package/docs/ja/specdojo/samples/gl-sample.yaml +37 -0
  315. package/docs/ja/specdojo/samples/ifd-sample.md +38 -0
  316. package/docs/ja/specdojo/samples/ifx-api-sample.yaml +102 -0
  317. package/docs/ja/specdojo/samples/ifx-cmd-sample.yaml +107 -0
  318. package/docs/ja/specdojo/samples/ifx-file-sample.md +38 -0
  319. package/docs/ja/specdojo/samples/ifx-msg-sample.yaml +89 -0
  320. package/docs/ja/specdojo/samples/imp-business-sample.md +66 -0
  321. package/docs/ja/specdojo/samples/imp-data-sample.md +60 -0
  322. package/docs/ja/specdojo/samples/imp-interface-sample.md +60 -0
  323. package/docs/ja/specdojo/samples/imp-operations-sample.md +60 -0
  324. package/docs/ja/specdojo/samples/imp-test-sample.md +60 -0
  325. package/docs/ja/specdojo/samples/itc-index-sample.md +38 -0
  326. package/docs/ja/specdojo/samples/itc-sample.md +38 -0
  327. package/docs/ja/specdojo/samples/mip-index-sample.md +38 -0
  328. package/docs/ja/specdojo/samples/mm-sample.md +35 -0
  329. package/docs/ja/specdojo/samples/mtp-sample.md +38 -0
  330. package/docs/ja/specdojo/samples/nfr-availability-sample.md +38 -0
  331. package/docs/ja/specdojo/samples/nfr-index-sample.md +38 -0
  332. package/docs/ja/specdojo/samples/nfr-integrity-sample.md +38 -0
  333. package/docs/ja/specdojo/samples/nfr-maintainability-sample.md +38 -0
  334. package/docs/ja/specdojo/samples/nfr-operations-sample.md +38 -0
  335. package/docs/ja/specdojo/samples/nfr-performance-sample.md +38 -0
  336. package/docs/ja/specdojo/samples/nfr-reliability-sample.md +38 -0
  337. package/docs/ja/specdojo/samples/nfr-security-safety-sample.md +38 -0
  338. package/docs/ja/specdojo/samples/nfr-usability-sample.md +38 -0
  339. package/docs/ja/specdojo/samples/ntp-sample.md +38 -0
  340. package/docs/ja/specdojo/samples/opd-access-control-sample.md +29 -0
  341. package/docs/ja/specdojo/samples/opd-incident-management-sample.md +31 -0
  342. package/docs/ja/specdojo/samples/opd-index-sample.md +41 -0
  343. package/docs/ja/specdojo/samples/opd-monitoring-sample.md +32 -0
  344. package/docs/ja/specdojo/samples/opd-sample.md +38 -0
  345. package/docs/ja/specdojo/samples/opr-access-control-sample.md +24 -0
  346. package/docs/ja/specdojo/samples/opr-backup-restore-sample.md +27 -0
  347. package/docs/ja/specdojo/samples/opr-batch-sample.md +23 -0
  348. package/docs/ja/specdojo/samples/opr-change-sample.md +24 -0
  349. package/docs/ja/specdojo/samples/opr-incident-sample.md +38 -0
  350. package/docs/ja/specdojo/samples/opr-index-sample.md +43 -0
  351. package/docs/ja/specdojo/samples/opr-monitoring-sample.md +27 -0
  352. package/docs/ja/specdojo/samples/opr-sample.md +38 -0
  353. package/docs/ja/specdojo/samples/opr-support-sample.md +23 -0
  354. package/docs/ja/specdojo/samples/otp-index-sample.md +66 -0
  355. package/docs/ja/specdojo/samples/otp-sample.md +68 -0
  356. package/docs/ja/specdojo/samples/pm-change-request-log-sample.md +47 -0
  357. package/docs/ja/specdojo/samples/pm-communication-plan-sample.md +46 -0
  358. package/docs/ja/specdojo/samples/pm-issue-log-sample.md +45 -0
  359. package/docs/ja/specdojo/samples/pm-members-sample.yaml +103 -0
  360. package/docs/ja/specdojo/samples/pm-organization-sample.md +46 -0
  361. package/docs/ja/specdojo/samples/pm-plan-sample.md +57 -0
  362. package/docs/ja/specdojo/samples/pm-quality-management-plan-sample.md +52 -0
  363. package/docs/ja/specdojo/samples/pm-raci-sample.md +57 -0
  364. package/docs/ja/specdojo/samples/pm-risk-register-sample.md +43 -0
  365. package/docs/ja/specdojo/samples/pm-roles-sample.yaml +41 -0
  366. package/docs/ja/specdojo/samples/pr-sample.md +39 -0
  367. package/docs/ja/specdojo/samples/prj-assumptions-constraints-dependencies-sample.md +57 -0
  368. package/docs/ja/specdojo/samples/prj-charter-sample.md +121 -0
  369. package/docs/ja/specdojo/samples/prj-comparison-of-alternatives-sample.md +105 -0
  370. package/docs/ja/specdojo/samples/prj-issues-and-approach-sample.md +78 -0
  371. package/docs/ja/specdojo/samples/prj-overview-sample.md +95 -0
  372. package/docs/ja/specdojo/samples/prj-scope-sample.md +71 -0
  373. package/docs/ja/specdojo/samples/prj-stakeholder-register-sample.md +60 -0
  374. package/docs/ja/specdojo/samples/prj-success-criteria-and-acceptance-criteria-sample.md +62 -0
  375. package/docs/ja/specdojo/samples/sac-sample.md +38 -0
  376. package/docs/ja/specdojo/samples/sf-index-sample.md +38 -0
  377. package/docs/ja/specdojo/samples/sf-sample.md +38 -0
  378. package/docs/ja/specdojo/samples/sld-sample.md +38 -0
  379. package/docs/ja/specdojo/samples/stc-index-sample.md +38 -0
  380. package/docs/ja/specdojo/samples/stc-sample.md +38 -0
  381. package/docs/ja/specdojo/samples/stsd-sample.md +58 -0
  382. package/docs/ja/specdojo/samples/sysd-critical-flows-sample.md +38 -0
  383. package/docs/ja/specdojo/samples/sysd-cross-cutting-policy-sample.md +38 -0
  384. package/docs/ja/specdojo/samples/sysd-index-sample.md +38 -0
  385. package/docs/ja/specdojo/samples/trc-requirements-to-specs-sample.md +56 -0
  386. package/docs/ja/specdojo/samples/trc-requirements-to-tests-sample.md +56 -0
  387. package/docs/ja/specdojo/samples/tsd-index-sample.md +29 -0
  388. package/docs/ja/specdojo/samples/tsd-sample.md +38 -0
  389. package/docs/ja/specdojo/samples/tsp-index-sample.md +38 -0
  390. package/docs/ja/specdojo/samples/uis-sample.md +38 -0
  391. package/docs/ja/specdojo/samples/utc-index-sample.md +38 -0
  392. package/docs/ja/specdojo/samples/utc-sample.md +38 -0
  393. package/docs/ja/specdojo/schemas/v1/guide-content.schema.yaml +20 -0
  394. package/docs/ja/specdojo/schemas/v1/philosophy-content.schema.yaml +21 -0
  395. package/docs/ja/specdojo/schemas/v1/reference-content.schema.yaml +21 -0
  396. package/docs/ja/specdojo/standards/document-metadata-standard.md +323 -0
  397. package/docs/ja/specdojo/standards/exec-human-finalize-standard.md +75 -0
  398. package/docs/ja/specdojo/standards/git-branching-standard.md +227 -0
  399. package/docs/ja/specdojo/standards/guide-authoring-standard.md +124 -0
  400. package/docs/ja/specdojo/standards/id-and-file-naming-standard.md +929 -0
  401. package/docs/ja/specdojo/standards/job-definition-standard.md +148 -0
  402. package/docs/ja/specdojo/standards/people-and-organization-definition-standard.md +431 -0
  403. package/docs/ja/specdojo/standards/philosophy-authoring-standard.md +113 -0
  404. package/docs/ja/specdojo/standards/recipe-authoring-standard.md +143 -0
  405. package/docs/ja/specdojo/standards/reference-authoring-standard.md +99 -0
  406. package/docs/ja/specdojo/standards/rulebook-authoring-standard.md +140 -0
  407. package/docs/ja/specdojo/standards/sample-authoring-standard.md +151 -0
  408. package/docs/ja/specdojo/standards/standard-authoring-standard.md +108 -0
  409. package/docs/ja/specdojo/standards/template-authoring-standard.md +101 -0
  410. package/docs/ja/specdojo/standards/test-document-scope-standard.md +176 -0
  411. package/docs/ja/specdojo/templates/cdfd-overview-template.md +199 -0
  412. package/docs/ja/specdojo/templates/cdfd-template.md +173 -0
  413. package/docs/ja/specdojo/templates/cdfd-uc-template.md +148 -0
  414. package/docs/ja/specdojo/templates/dct-architecture-template.yaml +136 -0
  415. package/docs/ja/specdojo/templates/dct-business-acceptance-criteria-template.yaml +34 -0
  416. package/docs/ja/specdojo/templates/dct-business-model-bes-template.yaml +75 -0
  417. package/docs/ja/specdojo/templates/dct-business-model-bps-template.yaml +49 -0
  418. package/docs/ja/specdojo/templates/dct-business-model-br-template.yaml +50 -0
  419. package/docs/ja/specdojo/templates/dct-data-flow-template.yaml +40 -0
  420. package/docs/ja/specdojo/templates/dct-data-model-bdd-template.yaml +46 -0
  421. package/docs/ja/specdojo/templates/dct-data-model-ccd-template.yaml +46 -0
  422. package/docs/ja/specdojo/templates/dct-data-model-cdsd-template.yaml +41 -0
  423. package/docs/ja/specdojo/templates/dct-data-model-cld-template.yaml +38 -0
  424. package/docs/ja/specdojo/templates/dct-data-model-sld-template.yaml +38 -0
  425. package/docs/ja/specdojo/templates/dct-data-model-stsd-template.yaml +46 -0
  426. package/docs/ja/specdojo/templates/dct-external-interface-specs-template.yaml +114 -0
  427. package/docs/ja/specdojo/templates/dct-glossary-template.yaml +35 -0
  428. package/docs/ja/specdojo/templates/dct-impact-analysis-template.yaml +138 -0
  429. package/docs/ja/specdojo/templates/dct-index-template.md +40 -0
  430. package/docs/ja/specdojo/templates/dct-migration-planning-template.yaml +148 -0
  431. package/docs/ja/specdojo/templates/dct-non-functional-requirements-template.yaml +222 -0
  432. package/docs/ja/specdojo/templates/dct-operations-template.yaml +108 -0
  433. package/docs/ja/specdojo/templates/dct-project-definition-template.yaml +210 -0
  434. package/docs/ja/specdojo/templates/dct-project-management-template.yaml +423 -0
  435. package/docs/ja/specdojo/templates/dct-system-acceptance-criteria-template.yaml +37 -0
  436. package/docs/ja/specdojo/templates/dct-system-design-template.yaml +82 -0
  437. package/docs/ja/specdojo/templates/dct-system-functions-template.yaml +58 -0
  438. package/docs/ja/specdojo/templates/dct-test-specs-template.yaml +261 -0
  439. package/docs/ja/specdojo/templates/dct-user-interface-model-template.yaml +60 -0
  440. package/docs/ja/specdojo/templates/ifx-cmd-template.yaml +88 -0
  441. package/docs/ja/specdojo/templates/opr-template.md +85 -0
  442. package/docs/ja/specdojo/templates/pjr-change-request-template.md +60 -0
  443. package/docs/ja/specdojo/templates/pjr-decision-template.md +61 -0
  444. package/docs/ja/specdojo/templates/pjr-index-template.md +49 -0
  445. package/docs/ja/specdojo/templates/pjr-issue-template.md +50 -0
  446. package/docs/ja/specdojo/templates/pjr-note-template.md +35 -0
  447. package/docs/ja/specdojo/templates/pjr-question-template.md +53 -0
  448. package/docs/ja/specdojo/templates/pjr-risk-template.md +49 -0
  449. package/docs/ja/specdojo/templates/pjr-todo-template.md +41 -0
  450. package/docs/ja/specdojo/templates/pjr-views-by-owner-template.md +22 -0
  451. package/docs/ja/specdojo/templates/pjr-views-by-priority-template.md +22 -0
  452. package/docs/ja/specdojo/templates/pjr-views-by-status-template.md +22 -0
  453. package/docs/ja/specdojo/templates/pm-change-request-log-template.md +20 -0
  454. package/docs/ja/specdojo/templates/pm-communication-plan-template.md +46 -0
  455. package/docs/ja/specdojo/templates/pm-decision-log-template.md +20 -0
  456. package/docs/ja/specdojo/templates/pm-issue-log-template.md +20 -0
  457. package/docs/ja/specdojo/templates/pm-members-template.yaml +105 -0
  458. package/docs/ja/specdojo/templates/pm-organization-template.md +44 -0
  459. package/docs/ja/specdojo/templates/pm-plan-template.md +52 -0
  460. package/docs/ja/specdojo/templates/pm-quality-management-plan-template.md +46 -0
  461. package/docs/ja/specdojo/templates/pm-raci-template.md +51 -0
  462. package/docs/ja/specdojo/templates/pm-risk-register-template.md +20 -0
  463. package/docs/ja/specdojo/templates/pm-roles-template.yaml +53 -0
  464. package/docs/ja/specdojo/templates/prj-assumptions-constraints-dependencies-template.md +59 -0
  465. package/docs/ja/specdojo/templates/prj-charter-template.md +116 -0
  466. package/docs/ja/specdojo/templates/prj-comparison-of-alternatives-template.md +116 -0
  467. package/docs/ja/specdojo/templates/prj-issues-and-approach-template.md +89 -0
  468. package/docs/ja/specdojo/templates/prj-overview-template.md +85 -0
  469. package/docs/ja/specdojo/templates/prj-scope-template.md +75 -0
  470. package/docs/ja/specdojo/templates/prj-stakeholder-register-template.md +64 -0
  471. package/docs/ja/specdojo/templates/prj-success-criteria-and-acceptance-criteria-template.md +60 -0
  472. package/docs/ja/specdojo/templates/stsd-template.md +57 -0
  473. package/docs/specdojo/schemas/v1/bdd.schema.yaml +230 -0
  474. package/docs/specdojo/schemas/v1/common-frontmatter.schema.yaml +77 -0
  475. package/docs/specdojo/schemas/v1/dct-index.schema.yaml +85 -0
  476. package/docs/specdojo/schemas/v1/dct-plan.schema.yaml +324 -0
  477. package/docs/specdojo/schemas/v1/dct.schema.yaml +368 -0
  478. package/docs/specdojo/schemas/v1/deliverable-frontmatter.schema.yaml +91 -0
  479. package/docs/specdojo/schemas/v1/esil.schema.yaml +142 -0
  480. package/docs/specdojo/schemas/v1/exec-common.schema.yaml +101 -0
  481. package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +272 -0
  482. package/docs/specdojo/schemas/v1/exec-evidence.schema.yaml +162 -0
  483. package/docs/specdojo/schemas/v1/exec-plan-frontmatter.schema.yaml +126 -0
  484. package/docs/specdojo/schemas/v1/exec-reporter-output.schema.yaml +151 -0
  485. package/docs/specdojo/schemas/v1/exec-result-frontmatter.schema.yaml +144 -0
  486. package/docs/specdojo/schemas/v1/grade-done-criteria.schema.yaml +79 -0
  487. package/docs/specdojo/schemas/v1/grade-pipeline-state.schema.yaml +60 -0
  488. package/docs/specdojo/schemas/v1/grade-result.schema.yaml +118 -0
  489. package/docs/specdojo/schemas/v1/guide-frontmatter.schema.yaml +19 -0
  490. package/docs/specdojo/schemas/v1/ifx-cmd.schema.yaml +293 -0
  491. package/docs/specdojo/schemas/v1/job-run.schema.yaml +90 -0
  492. package/docs/specdojo/schemas/v1/job.schema.yaml +198 -0
  493. package/docs/specdojo/schemas/v1/philosophy-frontmatter.schema.yaml +19 -0
  494. package/docs/specdojo/schemas/v1/pipeline-state.schema.yaml +56 -0
  495. package/docs/specdojo/schemas/v1/pm-members.schema.yaml +252 -0
  496. package/docs/specdojo/schemas/v1/pm-review-viewpoints.schema.yaml +387 -0
  497. package/docs/specdojo/schemas/v1/pm-roles.schema.yaml +106 -0
  498. package/docs/specdojo/schemas/v1/recipe-frontmatter.schema.yaml +27 -0
  499. package/docs/specdojo/schemas/v1/reference-frontmatter.schema.yaml +18 -0
  500. package/docs/specdojo/schemas/v1/register-events.schema.yaml +106 -0
  501. package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +204 -0
  502. package/docs/specdojo/schemas/v1/routine-run.schema.yaml +36 -0
  503. package/docs/specdojo/schemas/v1/routine.schema.yaml +87 -0
  504. package/docs/specdojo/schemas/v1/rulebook-frontmatter.schema.yaml +61 -0
  505. package/docs/specdojo/schemas/v1/sch-common.schema.yaml +258 -0
  506. package/docs/specdojo/schemas/v1/sch-defaults.schema.yaml +48 -0
  507. package/docs/specdojo/schemas/v1/sch-milestones.schema.yaml +64 -0
  508. package/docs/specdojo/schemas/v1/sch-strategy.schema.yaml +772 -0
  509. package/docs/specdojo/schemas/v1/sch-track.schema.yaml +66 -0
  510. package/docs/specdojo/schemas/v1/standard-frontmatter.schema.yaml +18 -0
  511. package/docs/specdojo/schemas/v1/tml-index.schema.yaml +103 -0
  512. package/package.json +121 -24
  513. package/templates/antigravity/README.md +35 -0
  514. package/templates/antigravity/exec-defaults-snippet.yaml +38 -0
  515. package/templates/antigravity/orchestrator.md +146 -0
  516. package/templates/antigravity/pm-members-snippet.yaml +55 -0
  517. package/templates/claude/README.md +46 -0
  518. package/templates/claude/agents/claude-expert-review-executor.md +14 -0
  519. package/templates/claude/agents/claude-review-executor.md +14 -0
  520. package/templates/claude/agents/specdojo-orchestrator.md +153 -0
  521. package/templates/claude/settings.edit.json +6 -0
  522. package/templates/claude/settings.report.json +6 -0
  523. package/templates/claude/settings.review.json +7 -0
  524. package/templates/codex/README.md +61 -0
  525. package/templates/codex/agents/codex-executor.toml +12 -0
  526. package/templates/codex/agents/codex-expert-executor.toml +12 -0
  527. package/templates/codex/agents/codex-expert-review-executor.toml +10 -0
  528. package/templates/codex/agents/codex-review-executor.toml +10 -0
  529. package/templates/codex/agents/specdojo-orchestrator.toml +154 -0
  530. package/templates/codex/orchestrator.md +146 -0
  531. package/templates/copilot/README.md +41 -0
  532. package/templates/copilot/exec-defaults-snippet.yaml +28 -0
  533. package/templates/copilot/pm-members-snippet.yaml +44 -0
  534. package/templates/opencode/README.md +41 -0
  535. package/templates/opencode/agents/opencode-executor.md +59 -0
  536. package/templates/opencode/agents/opencode-reporter.md +26 -0
  537. package/templates/opencode/agents/opencode-review-executor.md +48 -0
  538. package/templates/opencode/agents/specdojo-orchestrator.md +193 -0
  539. package/dist/exec-schedule-timeline-render.js +0 -201
  540. package/dist/exec-schedule-timeline.js +0 -2
@@ -0,0 +1,379 @@
1
+ ---
2
+ specdojo:
3
+ id: specdojo:etc-index-rulebook
4
+ type: rulebook
5
+ status: draft
6
+ recipe: undecided
7
+ sample: specdojo:etc-index-sample
8
+ template: undecided
9
+ ---
10
+
11
+ # 外部結合テストカタログ概要 作成ルール
12
+
13
+ External Integration Test Catalog (ETC) Index Documentation Rules
14
+
15
+ 本ドキュメントは、外部結合テストカタログ(ETC)の全体概要 `etc-index` を統一形式で記述するためのルールです。
16
+ TSPに基づき、外部結合テストに共通するルールや方針を定義します。
17
+
18
+ 個別 外部結合テストカタログ(`etc-<term>`)の記述ルールは `etc-rulebook.md` を参照してください。
19
+
20
+ ## 1. 全体方針
21
+
22
+ `etc-index` は、外部結合テストカタログ(ETC)を **運用可能な最小情報**で統一し、
23
+ 対象別カタログ(`etc-<term>`)の品質と一貫性を担保するための **共通ルール(SSOT)** とする。
24
+
25
+ - `etc-index` は **「考え方・共通方針・共通定義」** を記述する(個別ケースは持たない)
26
+ - 個別の観点・条件・ケースは **`etc-<term>` に集約**し、詳細は **テストコード/CI証跡** に寄せる
27
+ - 記述は **レビュー可能**であることを優先し、長文化を避ける(方針は箇条書き中心)
28
+ - 「例外」や「対象外」を明示し、外部結合テストの責任境界(何をやらないか)を固定する
29
+ - `tsp-index` の方針を根拠として、外部結合テストに共通する **分割基準・観点/条件の立て方・外部依存境界・合格基準・証跡** を定義する
30
+ - 外部結合テストの目的は「**システム境界を跨ぐ結合(外部サービス/外部端末/外部環境)を含む振る舞い**を、実運用に近い前提で検証すること」である
31
+ (ただし、再現性・コスト・安全性の観点で「実疎通」を必須化しない領域は明確に除外する)
32
+
33
+ ## 2. 位置づけ(他ドキュメントとの関係)
34
+
35
+ `etc-index` と他ドキュメントの関係を示します。
36
+
37
+ ```mermaid
38
+ flowchart BT
39
+ TSP["tsp-index<br>テスト戦略・方針"]
40
+
41
+ subgraph TC["テストカタログ"]
42
+ direction RL
43
+ TCIndex["etc-index<br>テスト仕様-全体構成"]
44
+ TCDetail["etc-&lt;term&gt;<br>テスト仕様-対象別"]
45
+ TCDetail -->|based_on| TCIndex
46
+ end
47
+
48
+ Code["テストコード 等"]
49
+
50
+ TC -->|based_on| TSP
51
+ Code -->|based_on| TC
52
+
53
+ classDef target stroke-width:4px
54
+ class TCIndex target
55
+ ```
56
+
57
+ ## 3. ファイル命名・ID規則
58
+
59
+ - 本ルールの対象ドキュメントの `id` は `etc-index` 固定。対象別は `etc-<term>`(詳細は `etc-rulebook.md`)。
60
+ - ファイル名は `etc-010-外部結合テストカタログ-概要.md` 等、プロジェクト内で一意になるように命名します。
61
+ - `<term>` は用語集(GL)の論理名キー(英小文字kebab-case)を用いる(表示名は title に日本語で記載してよい)。
62
+
63
+ ## 4. 推奨 Frontmatter 項目
64
+
65
+ ### 4.1. 設定内容
66
+
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))。
68
+
69
+ | 項目 | 説明 | 必須 |
70
+ | ---------- | -------------------------------------------------- | ---- |
71
+ | id | `etc-index`(固定) | ○ |
72
+ | type | `test` 固定 | ○ |
73
+ | title | 外部結合テストカタログ: 概要(`<システム名>`) | ○ |
74
+ | status | `draft` / `ready` / `deprecated` | ○ |
75
+ | based_on | 根拠となる仕様ID(ID配列。未指定時は `[]` を許容) | 任意 |
76
+ | supersedes | 置き換え関係(ID配列。未指定時は `[]` を許容) | 任意 |
77
+
78
+ ### 4.2. 推奨ルール
79
+
80
+ - `based_on` には最低限 `tsp-index` を含めます。
81
+ - BAC/NFR/BR 等は、`etc-index` の方針判断(外部依存境界・共通合格基準・環境前提)に **直接利用したものだけ**を `based_on` に列挙します。
82
+ - `based_on` / `supersedes` は ID 配列(未指定は `[]` 可)。
83
+
84
+ ## 5. 本文構成(標準テンプレ)
85
+
86
+ `etc-index` は以下の見出し構成を **順序固定** で配置します。
87
+
88
+ | 番号 | 見出し | 必須 |
89
+ | ---- | ----------------------------------------------- | ---- |
90
+ | 1 | 本ドキュメントの目的と適用対象 | ○ |
91
+ | 2 | テスト対象の括り方と分割基準 | ○ |
92
+ | 3 | 対象外・除外理由(共通) | ○ |
93
+ | 4 | 観点の立て方(共通) | ○ |
94
+ | 5 | 条件の立て方(共通) | ○ |
95
+ | 6 | 観点/条件の採用基準と対象別への分配方針(共通) | ○ |
96
+ | 7 | 外部結合テスト共通の境界/依存/環境の扱い | ○ |
97
+ | 8 | ケース表の共通カラム | ○ |
98
+ | 9 | メモ / 将来課題 | 任意 |
99
+
100
+ 注意:次章の記述ガイドのMarkdown見出しはルール文章内の参照用であり、
101
+ 生成する `etc-index` 本文の見出しは各章で指定された **番号付き** の形式
102
+ (例: `## 6.`, `### 6.1.` / `#### 6.1.1.` / `#### 6.1.2.`)に置き換えてください。
103
+
104
+ ## 6. 記述ガイド
105
+
106
+ ### 6.1. 本ドキュメントの目的と適用対象
107
+
108
+ 生成する `etc-index` 本文の見出しは **## 1. 本ドキュメントの目的と適用対象**
109
+
110
+ 本節では、`etc-index` が **何のために存在し、何に適用されるか** を明確にします。
111
+
112
+ - 目的:`etc-<term>` を同一基準で作成し、品質・粒度・責任範囲を揃える
113
+ - 適用対象:外部結合テスト(ET)に関するカタログ群(`etc-index` / `etc-<term>`)
114
+ - 非適用:総合/受入(ST/AT)のルールはそれぞれの `stc-index` / `atc-index` で扱う
115
+ - 成果物の位置づけ:
116
+ - `etc-index`:外部結合テスト共通方針(SSOT)
117
+ - `etc-<term>`:対象別の観点・条件・ケース表(SSOT)
118
+ - テストコード/CI:実装と実行証跡(Evidence)
119
+
120
+ - SSOTの一次情報は `etc-index` / `etc-<term>` とし、テストコード/CIは **実装と実行結果の証跡** として扱う
121
+ - 本書が扱う粒度:**判断基準・共通ルールまで**(個別ケースの列挙は禁止)
122
+
123
+ ### 6.2. テスト対象の括り方と分割基準
124
+
125
+ 生成する `etc-index` 本文の見出しは **## 2. テスト対象の括り方と分割基準**
126
+
127
+ 本節では、`etc-<term>` の `<term>` をどう切るか(対象単位の設計)を定義します。
128
+
129
+ - `<term>` は「**外部境界を跨ぐ結合のまとまり**」を単位とする
130
+ 例:外部決済連携、外部IdP認証、外部通知(メール/SMS)、外部ファイル連携(S3等)、端末機能連携 など
131
+ - 分割基準(推奨順):
132
+ 1. **境界/外部I/F**:外部システムや外部環境の境界が同一
133
+ 2. **失敗モード**:タイムアウト/リトライ/認証失敗/レート制限などの性質が同一
134
+ 3. **合格基準**:SLO/復旧/再送などの期待が同一
135
+ 4. **運用責任**:監視・運用手順・担当が概ね一致する
136
+
137
+ - 過分割の禁止:`etc-<term>` が「1〜2ケースしかない」単位は原則統合する
138
+ - 肥大化の抑制(分割の目安):
139
+ - 観点が過剰(例:15以上)/表の行数が過剰(例:50以上)になったら分割候補
140
+ - 外部I/Fが異なる・環境前提が異なる(sandbox/prod相当など)が混在する場合は分割候補
141
+
142
+ - “外部”の定義(推奨):**チーム境界の外**(外部事業者)に加え、**別運用ドメイン**(別環境/別責任)も外部として扱う
143
+
144
+ ### 6.3. 対象外・除外理由(共通)
145
+
146
+ 生成する `etc-index` 本文の見出しは **## 3. 対象外・除外理由(共通)**
147
+
148
+ 本節では、外部結合テスト(ET)で **やらないこと** と、その **理由**、および **例外条件** を明確にします。
149
+
150
+ #### 6.3.1. 記述ルール
151
+
152
+ - 形式は **「対象外(何をやらないか)」「除外理由(なぜやらないか)」「代替」「例外(ETで扱う条件)」** を基本とする
153
+ - 「対象外」は **テストレベルの責務分界**(ET/ST/AT/NFR)に紐づけて書く
154
+ - 「例外」は乱用しない。例外を認める場合は **判断基準**(いつ/どの条件で)を明記する
155
+ - 個別対象(`etc-<term>`)固有の対象外は、`etc-<term>` 側に書く。本節は **ET共通** に限定する
156
+
157
+ #### 6.3.2. 推奨フォーマット(表)
158
+
159
+ | 対象外(やらないこと) | 除外理由 | 代替レベル/代替手段 | 例外(ETで扱う条件) |
160
+ | ---------------------- | -------- | ------------------- | -------------------- |
161
+
162
+ #### 6.3.3. 典型例(記載候補)
163
+
164
+ - 長時間耐久・大規模負荷(スループット/長時間稼働/Soak)
165
+ - 本番実アカウント/本番実データに依存する検証(安全性・個人情報)
166
+ - 端末群・多ブラウザの網羅(互換性はST/ATや別計画へ)
167
+ - 外部サービスの品質そのもの(外部障害の責任切り分け)
168
+
169
+ ### 6.4. 観点の立て方(共通)
170
+
171
+ 生成する `etc-index` 本文の見出しは **## 4. 観点の立て方(共通)**
172
+
173
+ 観点(Perspective)は「外部境界を跨いだときに何を保証するか」の切り口であり、対象別カタログの章立てとして用います。
174
+
175
+ - 観点の型(最低限この順で検討):
176
+ - 外部I/F契約の遵守(リクエスト/レスポンス形式、署名、ヘッダ、ステータス等)
177
+ - 認証/認可(トークン更新、失効、権限、スコープ)
178
+ - 失敗モード(タイムアウト、レート制限、リトライ、部分失敗、冪等性)
179
+ - データ整合性(送受信の欠損、重複、順序、再送、最終整合)
180
+ - 監視/運用性(ログ、トレースID、アラート条件、リカバリ手順)
181
+ - 非機能(ETで扱う範囲のみ:タイムアウト上限、リトライ回数、バックオフ等)
182
+
183
+ - 命名規則:**「名詞+品質/振る舞い」**(例:`外部認証の失効処理` / `再送と冪等性`)
184
+ - 粒度規則:観点は「条件を複数持てる」程度にまとめる(細分化し過ぎない)
185
+ - 重複禁止:同一対象内で同義の観点名を乱立させない(統合・改名する)
186
+
187
+ ### 6.5. 条件の立て方(共通)
188
+
189
+ 生成する `etc-index` 本文の見出しは **## 5. 条件の立て方(共通)**
190
+
191
+ 条件(Condition)は、観点を確認するための前提状態・入力状態・環境条件のバリエーションです。
192
+ ETでは「外部のふるまい」や「環境差」が条件になりやすいため、以下の分解で作成します。
193
+
194
+ - 入力(Input):代表値/境界値/異常値(空、最大、形式不正、署名不正 等)
195
+ - 状態(State):事前データ、トークン状態(有効/失効)、再送前提、冪等キー有無、外部側の状態(テスト用sandboxの事前条件)
196
+ - 環境(Env):外部I/Fのモード(成功/4xx/5xx/タイムアウト/レート制限)、ネットワーク制限、証明書、リージョン、設定値
197
+
198
+ 組合せルール(増やし過ぎ防止):
199
+
200
+ - まず代表(正常系)を作る
201
+ - 次に境界(タイムアウト境界、リトライ境界、期限境界)を追加する
202
+ - 最後に重大例外(課金・二重処理・取り消し不能など)を追加する
203
+ - 原則として直積(全組合せ)は作らない。必要な場合は理由と管理方法(データセット参照等)を明記する
204
+
205
+ ### 6.6. 観点/条件の採用基準と対象別への分配方針(共通)
206
+
207
+ 生成する `etc-index` 本文の見出しは **## 6. 観点/条件の採用基準と対象別への分配方針(共通)**
208
+
209
+ 本節では、観点/条件を「採用する判断」と「`etc-<term>` へ割り当てる判断」を共通ルールとして定義します。
210
+
211
+ #### 6.6.1. 採用基準(共通)
212
+
213
+ - 観点は「1観点=1合否命題」で採用する(複数命題の混在を禁止)
214
+ - 条件は「1条件=1差分(入力/状態/環境)」で採用する
215
+ - 追加時は、次のいずれかに該当する根拠を明示する
216
+ - 失敗時の業務影響が大きい(失注/誤課金/通知漏れ/監査不備など)
217
+ - 境界/例外/失敗モードの欠落が不具合につながりやすい
218
+ - 上位仕様(BAC/NFR/BR等)に明示的な要求がある
219
+ - 「重要そうだから」など根拠不明の採用はしない
220
+
221
+ #### 6.6.2. 対象別への分配方針(共通)
222
+
223
+ - 観点/条件は、責務を持つ `etc-<term>` に **主担当1つ** を割り当てる(重複割当は例外扱い)
224
+ - 複数 `etc-<term>` に跨る場合は、主担当 + 従担当(参照)で表現し、重複記載を避ける
225
+ - 分配判断は「境界/外部I/F」「失敗モード」「運用責任」の順で決める
226
+ - 分配結果は `etc-<term>` 側のケース表とトレース列で追跡可能にする
227
+
228
+ 推奨フォーマット(例):
229
+
230
+ | 観点/条件 | 採用理由 | 主担当 `etc-<term>` | 従担当(任意) | 備考 |
231
+ | --------- | -------- | ------------------- | -------------- | ---- |
232
+
233
+ ### 6.7. 外部結合テスト共通の境界/依存/環境の扱い
234
+
235
+ 生成する `etc-index` 本文の見出しは **## 7. 外部結合テスト共通の境界/依存/環境の扱い**
236
+
237
+ 外部結合テストでは「外部依存がある前提」で、再現性と安全性を両立する必要があります。
238
+ 本節で共通方針(どこまで実、どこから疑似)を定めます。
239
+
240
+ - 外部サービス接続:
241
+ - 原則:**sandbox / test environment** を使用し、実運用相当の契約を検証する
242
+ - 例外:sandboxが存在しない、または不安定で再現性が崩れる場合は **スタブ/モックサーバ** を併用(どの観点をどちらで担保するかを明記)
243
+
244
+ - 認証情報/秘密情報:
245
+ - 原則:CIの安全なsecret管理に置き、ログ出力禁止。テスト用アカウントを使用する
246
+
247
+ - タイムアウト/リトライ:
248
+ - 原則:規定値を明文化し、テストでは「境界(上限/回数)」を観測可能にする
249
+
250
+ - 冪等性/再送:
251
+ - 原則:冪等キー、重複送信、部分失敗からの再実行を **標準観点** として扱う
252
+
253
+ - 環境分離:
254
+ - 原則:テストデータはnamespaceやprefixで分離し、並列実行で衝突しない設計にする
255
+
256
+ - 証跡:
257
+ - 原則:外部リクエストID、トレースID、ログ相関キーを残し、CIから参照可能にする
258
+
259
+ ### 6.8. ケース表の共通カラム
260
+
261
+ 生成する `etc-index` 本文の見出しは **## 8. ケース表の共通カラム**
262
+
263
+ `etc-<term>` の末端(条件・ケース表)は、検索性・比較性・自動化移行の容易さを確保するため、
264
+ 全termで同一カラム順を採用します。
265
+
266
+ 必須カラム:
267
+
268
+ - `case_id`(ケースID):対象別に一意なIDで変更しない
269
+ - 形式:`<level>-<term>-<perspective_key>-<nnn>`(nnnは3桁推奨)
270
+ - `level`:`et`
271
+
272
+ - `条件`:入力/状態/環境の要点(`入力:` `状態:` `環境:` の形を推奨)
273
+ - `手順(最小)`:抽象化した最小手順(クリック列挙禁止)
274
+ - `期待値`:判定可能な合格条件(観測点を含める)
275
+
276
+ 推奨カラム(運用必須):
277
+
278
+ - `観測点(アサーション)`:レスポンス、外部ID、DB状態、イベント、ログ相関等
279
+ - `境界/依存`:sandbox/スタブ、タイムアウト設定、リトライ設定等
280
+ - `トレース`:req/spec/ac/issue 等のID
281
+ - `優先度`:P0/P1/P2
282
+ - `自動化`:manual/automated/mixed
283
+ - `証跡`:テストコード/CI run/外部リクエストID/ログ検索キー等
284
+
285
+ ### 6.9. メモ / 将来課題
286
+
287
+ 生成する `etc-index` 本文の見出しは **## 9. メモ / 将来課題**
288
+
289
+ 本節は、現時点で決めきれない事項や将来の改善点を記録します。
290
+ ただし、運用ルールとして必須な内容は本節に置かず、本文(1〜8章)へ反映します。
291
+
292
+ - 将来検討(例):
293
+ - 外部I/Fの擬似化方針の標準化(sandbox不安定時のfallback)
294
+ - テストデータの廃棄/クリーンアップ手順
295
+ - 監視(ログ/トレース)へのリンク形式統一
296
+ - 外部依存を含むテストの実行時間上限と分割基準
297
+
298
+ ## 7. 禁止事項
299
+
300
+ | 項目 | 理由 |
301
+ | ---------------------------------------------------------------------- | ---------------------------------------------------------------------------- |
302
+ | `etc-index` に個別ケース(条件・手順・期待値)を大量に列挙する | `etc-index` は共通方針のSSOTであり、個別は `etc-<term>` に集約するため |
303
+ | 外部サービス実疎通を無条件に必須化し、再現性・コスト・安全性を無視する | CI不安定・費用増・情報漏洩リスクになり、運用不能になるため(例外基準が必要) |
304
+ | 秘密情報(token/secret)を本文や証跡に平文で残す | セキュリティ事故につながるため |
305
+ | 手順にUI操作のクリック列挙を書く(末端表でも過剰な操作手順を書く) | ETの焦点が外部境界なのに、E2E/UIの責務と混ざり保守性が低下するため |
306
+ | 期待値を「エラーにならないこと」など曖昧に書く | 判定不能で合否が揺れ、証跡として機能しないため |
307
+ | `case_id` を後から変更する(参照があるのに変更する) | トレース・証跡リンクが壊れ、履歴追跡が不能になるため |
308
+ | 対象外・除外理由(共通)と矛盾するケースを `etc-<term>` に記載する | 責任境界が崩れるため(例外は根拠と条件を明記) |
309
+
310
+ ## 8. サンプル(最小)
311
+
312
+ 注:以下はルール文書内の例示です。生成する `etc-index` では `## 1...` から始まります。
313
+
314
+ ```yaml
315
+ ---
316
+ id: etc-index
317
+ type: test
318
+ title: 外部結合テストカタログ: 概要
319
+ status: draft
320
+ based_on: [tsp-index]
321
+ supersedes: []
322
+ ---
323
+ ```
324
+
325
+ ### 8.1. 本ドキュメントの目的と適用対象
326
+
327
+ 本ドキュメントは、外部結合テストカタログ(ETC)の全体概要 `etc-index` を統一形式で記述するためのルールである。
328
+ `etc-index` は外部結合テストに共通する「対象単位の切り方」「観点/条件の立て方」「外部依存境界」「合格基準」「証跡方針」を定義し、
329
+ 対象別カタログ `etc-<term>` の作成と運用の基盤とする。
330
+
331
+ ### 8.2. テスト対象の括り方と分割基準
332
+
333
+ `etc-<term>` の `<term>` は外部境界を跨ぐ結合(外部サービス/外部環境)のまとまりとする。
334
+ 分割は外部I/F境界・失敗モード・合格基準・運用責任を基準とし、過分割と肥大化の双方を避ける。
335
+ 外部I/Fや環境前提が混在する場合は分割候補とする。
336
+
337
+ ### 8.3. 対象外・除外理由(共通)
338
+
339
+ 外部結合テスト(ET)では、外部依存を含む振る舞いを確認する一方で、以下は原則として対象外とする。
340
+
341
+ | 対象外(やらないこと) | 除外理由 | 代替レベル/代替手段 | 例外(ETで扱う条件) |
342
+ | ------------------------------------------- | ------------------------------------------ | ------------------------- | ---------------------------- |
343
+ | 長時間耐久・大規模負荷(Soak/高負荷) | 測定条件設計が別物で、実行コストが高い | NFR/性能試験計画 | なし |
344
+ | 本番実アカウント/本番実データに依存する検証 | 安全性・個人情報・運用影響リスクが高い | 受入/本番リハ(別計画) | 監査済みの限定リハのみ |
345
+ | 多ブラウザ/多端末の網羅 | 組合せ爆発でETの目的(外部境界)から逸れる | ST/ATまたは互換性試験計画 | 重大不具合の再現ケースに限定 |
346
+ | 外部サービス品質そのもの(外部側のSLA保証) | 責任境界外で、原因切り分けが困難 | 監視/運用、ベンダ連携 | なし |
347
+
348
+ ### 8.4. 観点の立て方(共通)
349
+
350
+ 観点は「外部I/F契約」「認証/認可」「失敗モード」「冪等性/再送」「データ整合性」「運用性」を基軸に立てる。
351
+ 観点名は「名詞+品質/振る舞い」で統一し、条件を複数持てる程度の粒度にまとめる。
352
+
353
+ ### 8.5. 条件の立て方(共通)
354
+
355
+ 条件は入力・状態・環境に分解し、代表→境界→重大例外の順で追加する。
356
+ 直積は原則作らず、必要時のみ理由と管理方法(データセット参照等)を明記する。
357
+
358
+ ### 8.6. 観点/条件の採用基準と対象別への分配方針(共通)
359
+
360
+ 観点/条件は、業務影響・境界/失敗モードの重要性・上位仕様根拠を基準に採用する。
361
+ 分配は境界/外部I/F・失敗モード・運用責任を基準に主担当 `etc-<term>` を1つ定め、重複は例外として扱う。
362
+ 分配結果は `etc-<term>` のケース表とトレース列で追跡可能にする。
363
+
364
+ ### 8.7. 外部結合テスト共通の境界/依存/環境の扱い
365
+
366
+ 外部結合テストでは、原則sandbox等のテスト環境で外部契約を検証しつつ、
367
+ 再現性が崩れる場合はスタブ/モックを併用する(担保範囲の分担を明記する)。
368
+ 秘密情報は安全に管理し、ログ出力禁止とする。冪等性/再送/タイムアウト境界は標準観点とする。
369
+
370
+ ### 8.8. ケース表の共通カラム
371
+
372
+ 対象別カタログ `etc-<term>` の末端表は、全termで共通のカラム順を採用する。
373
+ 必須:case_id / 条件 / 手順(最小) / 期待値
374
+ 推奨:観測点(アサーション)/ 境界・依存 / トレース / 優先度 / 自動化 / 証跡
375
+
376
+ ### 8.9. メモ / 将来課題
377
+
378
+ 将来検討事項(例):sandbox不安定時の標準fallback、テストデータ廃棄、ログ/トレースリンク統一、ETの実行時間上限と分割基準等を記録する。
379
+ 運用ルールとして必須になった時点で本文へ昇格させる。