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,29 +13,16 @@ specdojo:
13
13
 
14
14
  Migration Test Plan (MTP) Documentation Rules
15
15
 
16
- 本ドキュメントは、移行テスト計画(リハーサル計画)ドキュメント(`mtp-index` / `mtp-<term>`)を統一形式で記述するためのルールです。
17
- 移行手順と結果の妥当性を事前に検証し、当日の失敗確率を下げるための内容を定義します。
16
+ 移行テスト計画(リハーサル計画)の記述基準を定めます。移行手順と結果の妥当性を事前に検証し、当日の失敗確率を下げるための内容を定義します。
18
17
 
19
18
  ## 1. 全体方針
20
19
 
21
- `mtp-index`(必要に応じて `mtp-<term>`)は、移行リハーサルの計画と評価基準を **再現可能** な形で整理し、GO/NO-GO判断の根拠を提供する。
22
-
23
- - リハーサル回数とスケジュールを明確にする
24
- - テスト環境/データ準備を事前に固定する
25
- - 検証観点(件数/差分/業務シナリオ)と合否基準を明記する
26
- - 差異発生時の扱い(許容/修正/再実行)を明文化する
27
- - 結果報告フォーマットとGO/NO-GO判断プロセスを定義する
28
-
29
- 運用方針:
30
-
31
- - 原則 `mtp-index` を作成し、全体の計画(SSOT)を1つにまとめる
32
- - `mtp-<term>` は、ウェーブ分割・責任分界・対象の独立性が高い場合に限り追加する
33
- - `mtp-<term>` を追加する場合でも、共通方針・全体日程・GO/NO-GOの基準点は `mtp-index` を正とする
20
+ - **目的と適用範囲**: `mtp-index` / `mtp-<term>` に、再現可能なリハーサル計画と評価基準を定義し、GO/NO-GO判断の根拠を提供する。
21
+ - **全体と分冊**: 原則 `mtp-index` に全体の計画をまとめる。ウェーブ分割・責任分界・対象の独立性が高い場合に限り `mtp-<term>` を追加し、共通方針・全体日程・GO/NO-GOの基準点は `mtp-index` を正とする。
22
+ - **共通の運用**: 役割の割り当ては適用先のメンバー定義に、`status`・承認・改訂と廃止・未決事項の引き継ぎは [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] に従う。文書の整形・lint はリポジトリの検証で扱う。
34
23
 
35
24
  ## 2. 位置づけ
36
25
 
37
- `mtp-index` / `mtp-<term>` と他ドキュメントの関係を示します。必要に応じて Mermaid による図を使用してよい。
38
-
39
26
  - `mip-index`:移行の合意・判断のSSOT(成功条件・カットオーバー骨格を含む)
40
27
  - `dmd-index` / `dmd-<term>`:データ移行の詳細設計(マッピング/変換/検証)
41
28
  - **`mtp-index` / `mtp-<term>`:リハーサル計画・検証設計(観点/手順/証跡)**
@@ -44,29 +31,24 @@ Migration Test Plan (MTP) Documentation Rules
44
31
 
45
32
  ## 3. ファイル命名・ID規則
46
33
 
47
- - `id` は `mtp-index` または `mtp-<term>`(kebab-case。例: `mtp-cutover-rehearsal`)。
34
+ - `id` のローカル部分は `mtp-index` または `mtp-<term>`(kebab-case。例: `mtp-cutover-rehearsal`)。
48
35
  - ファイル名は `mtp-010-移行テスト計画.md` / `mtp-020-移行テスト計画-<term>.md` 等、プロジェクト内で一意になるように命名する。
49
- - `<term>` は用語集(GL)の論理名キー(英小文字kebab-case)を用いる(表示名は title / ファイル名で日本語を使用してよい)。
36
+ - `<term>` は用語集(GL)の論理名キー(英小文字kebab-case)を用いる。表示名は H1 / ファイル名で日本語を使用してよい。
50
37
 
51
38
  ## 4. 推奨 Frontmatter 項目
52
39
 
53
40
  ### 4.1. 設定内容
54
41
 
55
- 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))。
42
+ 共通の必須項目・型制約はドキュメントメタ情報標準と `docs/specdojo/schemas/v1/deliverable-frontmatter.schema.yaml` を正本とし、SpecDojo の項目は `specdojo:` 配下に置く。文書名は Frontmatter の `title` ではなく本文先頭の H1 に書く。
56
43
 
57
- | 項目 | 説明 | 必須 |
58
- | ---------- | -------------------------------------------- | ---- |
59
- | id | MTP ID(`mtp-index` または `mtp-<term>`) | ○ |
60
- | type | `test` 固定 | ○ |
61
- | title | 移行テスト計画: <対象名> | ○ |
62
- | status | `draft` / `ready` / `deprecated` | ○ |
63
- | based_on | 根拠となる仕様ID(ID配列。未指定は `[]` 可) | 任意 |
64
- | supersedes | 置き換え関係(ID配列。未指定は `[]` 可) | 任意 |
44
+ | 項目 | MTP 固有の設定 | 必須 |
45
+ | ---------- | ---------------------------- | ---- |
46
+ | `type` | `test` 固定 | ○ |
47
+ | `rulebook` | `specdojo:mtp-rulebook` 固定 | ○ |
65
48
 
66
49
  ### 4.2. 推奨ルール
67
50
 
68
- - `based_on` には移行判断に直接利用した成果物(例: `br-*` / `nfr-*` / `issue-*`)のみ列挙する
69
- - `based_on` / `supersedes` は ID 配列(未指定は `[]` 可)
51
+ - `based_on` には移行判断に直接利用した作成済みの成果物のみ列挙する。成果物カタログに `depends_on` がある場合は、その推移閉包内に限定する。
70
52
 
71
53
  ## 5. 本文構成(標準テンプレ)
72
54
 
@@ -84,106 +66,68 @@ Frontmatter は共通スキーマに従います(参照: [docs/specdojo/schema
84
66
  | 8 | GO/NO-GO判断プロセス | ○ |
85
67
  | 9 | 関連ドキュメント | ○ |
86
68
 
87
- 補足:
88
-
89
- - `mtp-index` は「全体」を扱い、複数 `mtp-<term>` がある場合は各termの位置づけと差分を示す
90
- - `mtp-<term>` は term固有の内容に寄せ、共通方針や全体基準の重複記載を避ける(必要なら `mtp-index` へ参照する)
91
- - 「関連ドキュメント」セクションは **必須** とし、分冊が無い場合でも `(なし)` または `(本書のみ)` を明記して空欄にしない
92
-
93
69
  ## 6. 記述ガイド
94
70
 
95
71
  ### 6.1. 概要(`index` / `<term>`)
96
72
 
97
- 生成する本文の見出しは **## 1. 概要(`index` / `<term>`)**
98
-
99
73
  - 何のリハーサルを、どの目的で行うかを 1〜3 行で示す
100
74
  - `mip-index` と整合すること
101
75
  - `mtp-<term>` の場合は「term固有の目的・範囲(何を含み、何を含まないか)」を明記する
102
76
 
103
77
  ### 6.2. リハーサル回数とスケジュール
104
78
 
105
- 生成する本文の見出しは **## 2. リハーサル回数とスケジュール**
106
-
107
79
  - 実施回数、実施日程、実施目的を明記する
108
80
  - `mtp-<term>` の場合は、term固有の日程と全体日程の関係(ウェーブ順/前提)を明記する
109
81
 
110
- 推奨フォーマット(表):
111
-
112
82
  | 回数 | 予定日 | 目的 | 完了条件 |
113
83
  | ---- | ------ | ---- | -------- |
114
84
 
115
85
  ### 6.3. テスト環境/データ準備
116
86
 
117
- 生成する本文の見出しは **## 3. テスト環境/データ準備**
118
-
119
87
  - 環境(staging/検証環境等)と前提設定を明記する
120
88
  - データ準備(データセットID、初期化/後始末)を明記する
121
89
  - 可能なら、データ準備の責任者と手順参照先(runbook等)を示す
122
90
 
123
91
  ### 6.4. 検証観点(件数/差分/業務シナリオ)
124
92
 
125
- 生成する本文の見出しは **## 4. 検証観点(件数/差分/業務シナリオ)**
126
-
127
93
  - 件数照合、差分検知、業務シナリオ検証の観点を整理する
128
94
  - `dmd-*` で定義した検証(件数/重要値/許容差)と整合すること
129
95
 
130
- 推奨フォーマット(表):
131
-
132
96
  | 観点 | 方法 | 期待値 |
133
97
  | ---- | ---- | ------ |
134
98
 
135
99
  ### 6.5. 合否基準
136
100
 
137
- 生成する本文の見出しは **## 5. 合否基準**
138
-
139
101
  - 合格基準、許容誤差、判断者を明記する
140
102
  - 重要な合否基準(停止許容/差分許容/重大障害)を最低限含める
141
103
 
142
- 推奨フォーマット(表):
143
-
144
104
  | 項目 | 基準 | 判定者 |
145
105
  | ---- | ---- | ------ |
146
106
 
147
107
  ### 6.6. 差異発生時の扱い(許容/修正/再実行)
148
108
 
149
- 生成する本文の見出しは **## 6. 差異発生時の扱い(許容/修正/再実行)**
150
-
151
109
  - 許容できる差異、修正が必要な差異、再実行条件を明記する
152
110
  - 再実行の上限(回数/期限)と判断者を可能な限り明記する
153
111
 
154
112
  ### 6.7. 結果報告フォーマット
155
113
 
156
- 生成する本文の見出しは **## 7. 結果報告フォーマット**
157
-
158
- - 報告に必要な項目(日時/結果/差異/証跡)を明記する
114
+ - 報告に必要な項目(日時/結果/差異/所要時間/証跡/GO・NO-GO案と未決事項)を明記する。未決事項は論点と移行判断への影響を示す
159
115
  - 報告先(チケット/共有フォルダ/リポジトリ)を可能な限り明記する
160
116
 
161
- 推奨フォーマット(表):
162
-
163
117
  | 項目 | 記載内容 |
164
118
  | ---- | -------- |
165
119
 
166
120
  ### 6.8. GO/NO-GO判断プロセス
167
121
 
168
- 生成する本文の見出しは **## 8. GO/NO-GO判断プロセス**
169
-
170
122
  - 判断プロセス、判断主体、必要な証跡を明記する
171
- - `mtp-index` は「全体のGO/NO-GO判断」を定義する
172
- - `mtp-<term>` は term固有の判定点がある場合のみ追記し、全体判断の正は `mtp-index` とする
123
+ - `mtp-<term>` は term固有の判定点がある場合のみ追記する
173
124
 
174
125
  ### 6.9. 関連ドキュメント
175
126
 
176
- 生成する本文の見出しは **## 9. 関連ドキュメント**
177
-
178
127
  - `mtp-index` の場合:各 `mtp-<term>`(分冊)への導線を必ず記載する
179
128
  - `mtp-<term>` の場合:`mtp-index` への導線(本体SSOT)を必ず記載する
180
129
  - 分冊が無い場合でも `(なし)` または `(本書のみ)` を明記する
181
130
 
182
- 推奨フォーマット(箇条書き):
183
-
184
- - `<doc-id>`:<説明>
185
- - `<doc-id>`:<説明>
186
-
187
131
  ## 7. 禁止事項
188
132
 
189
133
  | 禁止事項 | 理由 |
@@ -197,158 +141,137 @@ Frontmatter は共通スキーマに従います(参照: [docs/specdojo/schema
197
141
 
198
142
  ## 8. サンプル(最小・整合版)
199
143
 
200
- 注:以下はルール文書内の例示です。生成する `mtp-index` / `mtp-<term>` では `## 1...` から始まります。
144
+ 以下は架空の対象・日付による最小例である。
201
145
 
202
146
  ### 8.1. `mtp-index`(全体SSOT・入口)
203
147
 
204
- ```yaml
148
+ ```markdown
205
149
  ---
206
- id: mtp-index
207
- type: test
208
- title: 移行テスト計画: 全体
209
- status: draft
210
- based_on: []
211
- supersedes: []
150
+ specdojo:
151
+ id: mtp-index
152
+ type: test
153
+ status: draft
154
+ rulebook: specdojo:mtp-rulebook
155
+ based_on: [mip-index]
212
156
  ---
213
157
 
214
- ```
158
+ # 移行テスト計画: 全体
215
159
 
216
- #### 8.1.1. 概要(index)
160
+ ## 1. 概要(index)
217
161
 
218
- 移行リハーサルを通じて、移行手順と結果の妥当性を事前に検証し、本番切替の失敗確率を下げる。
219
- 本書は移行テスト計画のSSOTであり、term固有の詳細は `mtp-<term>` に分離する。
162
+ 受注システムの移行手順と結果を事前検証する。全体の計画を本書、判定点の詳細を `mtp-cutover-rehearsal` に定める。
220
163
 
221
- #### 8.1.2. リハーサル回数とスケジュール
164
+ ## 2. リハーサル回数とスケジュール
222
165
 
223
- | 回数 | 予定日 | 目的 | 完了条件 |
224
- | ---- | ---------- | ---------------------------- | ------------------------------ |
225
- | 1 | 2026-03-01 | カットオーバー手順の実行確認 | 全工程完了(所要時間計測含む) |
226
- | 2 | 2026-03-15 | 差異検知と再現確認 | 差異0または許容内 |
166
+ | 回数 | 予定日 | 目的 | 完了条件 |
167
+ | ---- | ---------- | ------------------ | ------------------------ |
168
+ | 1 | 2026-03-01 | 手順の実行確認 | 全工程完了・所要時間計測 |
169
+ | 2 | 2026-03-15 | 差異検知と再現確認 | 差異0または許容内 |
227
170
 
228
- #### 8.1.3. テスト環境/データ準備
171
+ ## 3. テスト環境/データ準備
229
172
 
230
- - 環境: staging
231
- - データ: 受注データセット `DS-ORDER-01`
232
- - 初期化/後始末: リハーサル前に staging を初期化し、終了後は run_id 単位でログを保全する
173
+ staging に受注データセット `DS-ORDER-01` を投入する。実行前に初期化し、終了後は `run_id` 単位でログを保全する。
233
174
 
234
- #### 8.1.4. 検証観点(件数/差分/業務シナリオ)
175
+ ## 4. 検証観点(件数/差分/業務シナリオ)
235
176
 
236
- | 観点 | 方法 | 期待値 |
237
- | ------------ | ------------------------- | ----------------- |
238
- | 件数照合 | 旧/新件数比較 | 差分0 |
239
- | 差分検知 | 重要項目の差分抽出 | 許容差内 |
240
- | 業務シナリオ | 代表シナリオ(受注→請求) | 成功(重大障害0) |
177
+ | 観点 | 方法 | 期待値 |
178
+ | ------------ | ------------------ | --------------------------- |
179
+ | 件数照合 | 旧/新件数比較 | 差分0 |
180
+ | 差分検知 | 重要項目の差分抽出 | `dmd-order-data` の許容差内 |
181
+ | 業務シナリオ | 受注→請求を実行 | 成功・重大障害0 |
241
182
 
242
- #### 8.1.5. 合否基準
183
+ ## 5. 合否基準
243
184
 
244
- | 項目 | 基準 | 判定者 |
245
- | ---------- | -------------- | ---------- |
246
- | 件数差異 | 0 | 業務責任者 |
247
- | 重要値差異 | 許容差内 | 業務責任者 |
248
- | 所要時間 | 停止許容時間内 | 運用責任者 |
249
- | 重大障害 | 0 | PO |
185
+ | 項目 | 基準 | 判定者 |
186
+ | ---------- | ---------------------------- | ---------- |
187
+ | 件数差異 | 0 | 業務責任者 |
188
+ | 重要値差異 | 「検証観点」の許容差内 | 業務責任者 |
189
+ | 所要時間 | `mip-index` の停止許容時間内 | 運用責任者 |
190
+ | 重大障害 | 0 | PO |
250
191
 
251
- #### 8.1.6. 差異発生時の扱い(許容/修正/再実行)
192
+ ## 6. 差異発生時の扱い(許容/修正/再実行)
252
193
 
253
- - 許容差内の差異:許容として記録し、原因は追跡(本番影響なしであることを確認)
254
- - 許容差超の差異:原因を修正し再実行(再実行は最大 1 回、判断者は移行責任者)
255
- - 重大障害:即時にNO-GO候補として扱い、POへエスカレーション
194
+ - 許容差内: 本番影響がないことを確認し、原因とともに記録する。
195
+ - 許容差超: 原因修正後に最大1回再実行する。移行責任者が判断する。
196
+ - 重大障害: NO-GO候補としてPOへエスカレーションする。
256
197
 
257
- #### 8.1.7. 結果報告フォーマット
198
+ ## 7. 結果報告フォーマット
258
199
 
259
- | 項目 | 記載内容 |
260
- | -------- | ------------------------------------ |
261
- | 日時 | 実施日/開始終了時刻 |
262
- | 結果 | 合格/不合格 |
263
- | 差異 | 差分件数・重要値差分・原因/対応 |
264
- | 所要時間 | 全体/主要工程別 |
265
- | 証跡 | ログ/レポート参照先(run_id, URL等) |
266
- | 判断 | GO/NO-GO案、未解決事項 |
200
+ チケットに次の項目を記録する。
267
201
 
268
- #### 8.1.8. GO/NO-GO判断プロセス
202
+ | 項目 | 記載内容 |
203
+ | -------- | -------------------------------- |
204
+ | 日時 | 実施日・開始終了時刻 |
205
+ | 結果 | 合格/不合格 |
206
+ | 差異 | 差分件数・重要値差分・原因/対応 |
207
+ | 所要時間 | 全体/主要工程別 |
208
+ | 証跡 | `run_id` とログ・レポート参照先 |
209
+ | 判断 | GO/NO-GO案、未決の論点と本番影響 |
269
210
 
270
- - 判定主体: PO(最終)/ 移行責任者(提案・取りまとめ)
271
- - 判断入力: リハーサル結果報告、差分一覧、重大障害一覧、所要時間計測
272
- - 判断結果: GO / 条件付きGO / NO-GO(延期)
211
+ ## 8. GO/NO-GO判断プロセス
273
212
 
274
- #### 8.1.9. 関連ドキュメント
213
+ 移行責任者が結果報告・差分一覧・重大障害一覧・所要時間を集約し、POがGO / 条件付きGO / NO-GO(延期)を判断する。
275
214
 
276
- - `mtp-cutover-rehearsal`:カットオーバーリハーサルの詳細(term固有の判定点/ロールバック前提)
277
- - (必要に応じて追加)`mtp-wave1`:ウェーブ1のリハーサル計画(環境/データセット/合否基準の差分)
278
- - (必要に応じて追加)`mtp-wave2`:ウェーブ2のリハーサル計画(環境/データセット/合否基準の差分)
215
+ ## 9. 関連ドキュメント
279
216
 
280
- ---
217
+ - `mtp-cutover-rehearsal`: カットオーバーの判定点とロールバック前提。
218
+ ```
281
219
 
282
220
  ### 8.2. `mtp-<term>`(個別:例)
283
221
 
284
- ```yaml
222
+ ```markdown
285
223
  ---
286
- id: mtp-cutover-rehearsal
287
- type: test
288
- title: 移行テスト計画: カットオーバーリハーサル
289
- status: draft
290
- based_on:
291
- - mip-index
292
- - dmd-order-data
293
- supersedes: []
224
+ specdojo:
225
+ id: mtp-cutover-rehearsal
226
+ type: test
227
+ status: draft
228
+ rulebook: specdojo:mtp-rulebook
229
+ based_on: [mip-index]
294
230
  ---
295
- ```
296
231
 
297
- #### 8.2.1. 概要(cutover-rehearsal)
232
+ # 移行テスト計画: カットオーバーリハーサル
298
233
 
299
- 本番切替当日の主要工程(受付停止〜差分抽出〜投入〜接続切替〜利用開始)をリハーサルし、手順と所要時間、判定点の妥当性を確認する。
300
- 共通の合否基準とGO/NO-GO判断は `mtp-index` を正とし、本書は term 固有の詳細のみを扱う。
234
+ ## 1. 概要(cutover-rehearsal)
301
235
 
302
- #### 8.2.2. リハーサル回数とスケジュール
236
+ 受付停止〜差分抽出〜投入〜接続切替〜利用開始の判定点GO1〜GO5と所要時間を確認する。共通基準は `mtp-index` に従う。
303
237
 
304
- | 回数 | 予定日 | 目的 | 完了条件 |
305
- | ---- | ---------- | ------------------ | ----------------- |
306
- | 1 | 2026-03-01 | 手順の実行確認 | 全工程完了 |
307
- | 2 | 2026-03-15 | 差異検知と再現確認 | 差異0または許容内 |
238
+ ## 2. リハーサル回数とスケジュール
308
239
 
309
- #### 8.2.3. テスト環境/データ準備
240
+ 全体日程の第1回で全工程の実行、第2回で差異0または許容内であることを確認する。
310
241
 
311
- - 環境: staging
312
- - データ: `DS-ORDER-01`
313
- - 実行前条件: 旧系相当データが投入済みであること、外部I/Fは sandbox 接続であること
242
+ ## 3. テスト環境/データ準備
314
243
 
315
- #### 8.2.4. 検証観点(件数/差分/業務シナリオ)
244
+ `mtp-index` の staging・データセットを使用する。旧系相当データの投入と外部I/Fの sandbox 接続を開始条件とする。
316
245
 
317
- | 観点 | 方法 | 期待値 |
318
- | -------------- | ------------------------------ | -------- |
319
- | 判定点の成立性 | GO1〜GO5での完了条件チェック | 全て成立 |
320
- | スモーク | 切替後に代表API/画面を確認 | 成功 |
321
- | 差分検知 | 抽出〜投入ログと差分一覧の確認 | 許容差内 |
246
+ ## 4. 検証観点(件数/差分/業務シナリオ)
322
247
 
323
- #### 8.2.5. 合否基準
248
+ | 観点 | 方法 | 期待値 |
249
+ | -------- | ------------------------------------------------ | --------------------------- |
250
+ | 判定点 | `cop-cutover-runbook` のGO1〜GO5の完了条件を確認 | 全て成立 |
251
+ | スモーク | GO4の接続切替後に代表API/画面を確認 | 全項目成功 |
252
+ | 差分検知 | 抽出〜投入ログと差分一覧を照合 | `dmd-order-data` の許容差内 |
324
253
 
325
- | 項目 | 基準 | 判定者 |
326
- | ------------------------- | -------------- | ---------- |
327
- | GO4(接続切替)後スモーク | 全項目成功 | 運用責任者 |
328
- | 主要工程所要時間 | 停止許容時間内 | 運用責任者 |
329
- | 重大障害 | 0 | PO |
254
+ ## 5. 合否基準
330
255
 
331
- #### 8.2.6. 差異発生時の扱い(許容/修正/再実行)
256
+ 共通基準は `mtp-index` に従う。運用責任者がGO4後のスモーク全項目成功と主要工程の停止許容時間内での完了を、POが重大障害0を判定する。
332
257
 
333
- - GO2/GO3で失敗:原因修正の上、再実行(最大1回)。不可ならNO-GO(延期)案。
334
- - GO4で失敗:接続先を旧系へ戻す(ロールバック)→ NO-GO(延期)案。
335
- - 軽微な差異:許容差内なら記録し、次回までに原因調査。
258
+ ## 6. 差異発生時の扱い(許容/修正/再実行)
336
259
 
337
- #### 8.2.7. 結果報告フォーマット
260
+ - GO2/GO3失敗: 原因修正後に最大1回再実行し、不可ならNO-GO案とする。
261
+ - GO4失敗: 接続先を旧系へ戻し、NO-GO案とする。
262
+ - 軽微な差異: 許容差内なら記録し、次回までに原因を調査する。
338
263
 
339
- `mtp-index` のフォーマットに従い、term固有として以下を追加する。
264
+ ## 7. 結果報告フォーマット
340
265
 
341
- | 項目 | 記載内容 |
342
- | ------------ | -------------------------------------------- |
343
- | 判定点 | GO1〜GO5の結果(完了条件/実績時刻/所要時間) |
344
- | ロールバック | 実施の有無、実施理由、復旧完了時刻 |
266
+ `mtp-index` のチケットに共通項目を記録し、GO1〜GO5の完了条件・実績時刻・所要時間、ロールバックの有無・理由・復旧完了時刻を加える。
345
267
 
346
- #### 8.2.8. GO/NO-GO判断プロセス
268
+ ## 8. GO/NO-GO判断プロセス
347
269
 
348
- term固有の判定点(GO1〜GO5)については本書に記録し、全体判断は `mtp-index` のプロセスに従う。
270
+ 個別判定点の結果を記録し、全体判断は `mtp-index` に従う。
349
271
 
350
- #### 8.2.9. 関連ドキュメント
272
+ ## 9. 関連ドキュメント
351
273
 
352
- - `mtp-index`:移行テスト計画のSSOT(全体方針/合否基準/判断プロセス)
353
- - `cop-cutover-runbook`:当日手順の詳細(分単位の作業/チェックリスト)
354
- - `dmd-order-data`:データ移行設計(抽出/変換/検証の詳細)
274
+ - `mtp-index`: 全体方針・合否基準・判断プロセス。
275
+ - `cop-cutover-runbook`: 判定点と当日手順。
276
+ - `dmd-order-data`: 抽出・変換・検証の詳細。
277
+ ```
@@ -13,20 +13,19 @@ specdojo:
13
13
 
14
14
  Non-Functional Requirements Availability Documentation Rules
15
15
 
16
- 本ドキュメントは、非機能要件のうち可用性(利用可能性・停止許容・復旧目標)を定義する `nfr-availability` の作成ルールを定義する。
17
- 可用性要件は、業務継続に必要な稼働率と復旧目標を定量で記述する。
16
+ 本書は、非機能要件のうち可用性(停止許容・復旧目標)を定義する `nfr-availability` の作成ルールを定める。
18
17
 
19
18
  ## 1. 全体方針
20
19
 
21
- - 可用性は稼働率、許容停止時間、RTO/RPO で定義する。
20
+ - 可用性は稼働率、許容停止時間、RTO/RPO で定量的に定義する。
22
21
  - 対象時間帯と除外条件(計画メンテ等)を必ず明記する。
23
- - 監視・復旧判断と結びつく形で要件化する。
22
+ - 監視・復旧判断に結びつけて要件化する。
23
+ - **共通の運用**: 役割の割り当ては適用先のメンバー定義に、`status` の昇格と承認、改訂と廃止、未決事項の登録簿への引き継ぎは [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] に従い、本書と成果物で言い直さない。文書の整形・lint はリポジトリの検証で扱い、「測定・検証方法」に含めない。
24
24
 
25
25
  ## 2. 位置づけと用語定義(必要に応じて)
26
26
 
27
27
  ### 2.1. 位置づけ
28
28
 
29
- - `nfr-availability`:可用性要求の正本
30
29
  - `nfr-index`:NFR全体の入口
31
30
  - `sac-*` / `stc-*`:可用性要件の検証先
32
31
  - `opd-*` / `opr-*`:障害対応・復旧手順
@@ -49,19 +48,14 @@ Non-Functional Requirements Availability Documentation Rules
49
48
 
50
49
  ### 4.1. 設定内容
51
50
 
52
- 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))。
51
+ 許可キー・必須項目・型制約は [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] と `docs/specdojo/schemas/v1/deliverable-frontmatter.schema.yaml` を正本とする。
53
52
 
54
- | 項目 | 説明 | 必須 |
55
- | ------- | -------------------------------- | ---- |
56
- | id | `nfr-availability` | ○ |
57
- | type | `requirement` 固定 | ○ |
58
- | title | 非機能要件: 可用性 | ○ |
59
- | status | `draft` / `ready` / `deprecated` | ○ |
60
- | part_of | `nfr-index` | 任意 |
53
+ - `specdojo.id` は `nfr-availability`、`specdojo.type` は `requirement`、`specdojo.rulebook` は `specdojo:nfr-availability-rulebook` とする。
54
+ - `specdojo.part_of` には `nfr-index` を置く。
61
55
 
62
56
  ### 4.2. 推奨ルール
63
57
 
64
- - 重要業務時間帯(営業時間、締め時刻)を `based_on` と本文で整合させる。
58
+ - 重要業務時間帯(営業時間、締め時刻)の根拠文書を `specdojo.based_on` に挙げ、本文の対象時間帯と揃える。
65
59
 
66
60
  ## 5. 本文構成(標準テンプレ)
67
61
 
@@ -100,13 +94,13 @@ Frontmatter は共通スキーマに従います(参照: [docs/specdojo/schema
100
94
 
101
95
  生成する本文の見出しは **## 4. 測定・検証方法**
102
96
 
103
- - 監視値、障害訓練、復旧試験の判定方法を定義する。
97
+ - 要件IDごとに、監視値・障害訓練・復旧試験による測定方法と判定時期を定める。
104
98
 
105
99
  ### 6.5. 関連ドキュメント導線
106
100
 
107
101
  生成する本文の見出しは **## 5. 関連ドキュメント導線**
108
102
 
109
- - `opd-*`、`opr-*`、`sac-*`、`dec-*` を紐づける。
103
+ - 「位置づけ」の文書と設計判断の `dec-*` を、種別・ドキュメントID・目的の表で紐づける。
110
104
 
111
105
  ## 7. 禁止事項
112
106
 
@@ -118,68 +112,48 @@ Frontmatter は共通スキーマに従います(参照: [docs/specdojo/schema
118
112
 
119
113
  ## 8. サンプル
120
114
 
121
- 注:以下はルール文書内の例示です。生成する `nfr-availability` では `## 1...` から始まります。
115
+ 注:形式の輪郭を示す最小例。成果物の見出しは `## 1...` から始まる。
122
116
 
123
117
  ```yaml
124
118
  ---
125
- id: nfr-availability
126
- type: requirement
127
- title: 非機能要件: 可用性
128
- status: draft
129
- part_of: [nfr-index]
130
- based_on: []
131
- supersedes: []
119
+ specdojo:
120
+ id: nfr-availability
121
+ type: requirement
122
+ status: draft
123
+ rulebook: specdojo:nfr-availability-rulebook
124
+ part_of: [nfr-index]
132
125
  ---
133
126
  ```
134
127
 
135
128
  ### 8.1. 概要(対象・目的)(例)
136
129
 
137
- 本書は、GCS 基幹システムにおいて可用性(サービス継続・復旧目標)に関する
138
- 非機能要件を定義する。
139
- 業務継続に必要な稼働率と障害時の復旧目標を定量化し、SLA および障害対応の
140
- 判断基準として運用する。
130
+ 本書は、GCS 基幹システムの稼働率と復旧目標を定量化し、障害対応の判断基準とする。
141
131
 
142
132
  ### 8.2. 適用範囲・除外条件(例)
143
133
 
144
- | 項目 | 内容 |
145
- | ------------ | ------------------------------------------------ |
146
- | 対象システム | GCS 基幹システム(受注・在庫・会計サブシステム) |
147
- | 対象時間帯 | 24 時間 365 日 |
148
- | 計画停止除外 | 月次メンテナンス(第2日曜 02:00–06:00) |
149
- | 外部依存除外 | 決済 PSP 障害・物流 API 障害 |
150
- | 測定開始時点 | 本番リリース後の初回稼働月から |
134
+ | 項目 | 内容 |
135
+ | ------------ | --------------------------------------- |
136
+ | 対象時間帯 | 24 時間 365 日 |
137
+ | 計画停止除外 | 月次メンテナンス(第2日曜 02:00–06:00) |
151
138
 
152
139
  ### 8.3. 可用性要件一覧(例)
153
140
 
154
- | id | 内容 | 指標 | 基準 | 備考 |
155
- | ----------- | ----------------------------------------- | ---------- | -------------- | -------------------------- |
156
- | nfr-avl-001 | 基幹 API は月間稼働率を維持する | 月間稼働率 | 99.9% 以上 | 計画停止除外 |
157
- | nfr-avl-002 | P1 障害時は目標時間内に復旧する | RTO | 60 分以内 | OPR 手順で検証 |
158
- | nfr-avl-003 | P1 障害時のデータ損失を目標範囲内に収める | RPO | 5 分以内 | WAL + レプリケーション |
159
- | nfr-avl-004 | P2 障害時は目標時間内に復旧する | RTO | 4 時間以内 | 営業時間内対応 |
160
- | nfr-avl-005 | 単一ノード障害でサービスを継続できること | 冗長構成 | Active-Standby | フェイルオーバー 30 秒以内 |
161
- | nfr-avl-006 | バッチ処理の計画時間超過を防止する | 完了率 | 99% 以上 | 日次バッチ対象 |
162
- | nfr-avl-007 | DR サイト切替は基準時間内に完了すること | DR-RTO | 4 時間以内 | 年次 DR 訓練で検証 |
141
+ | id | 内容 | 指標 | 基準 | 備考 |
142
+ | ----------- | ----------------------------------------- | ---------- | ---------- | ---------------------- |
143
+ | nfr-avl-001 | 基幹 API は月間稼働率を維持する | 月間稼働率 | 99.9% 以上 | 計画停止除外 |
144
+ | nfr-avl-002 | P1 障害時は目標時間内に復旧する | RTO | 60 分以内 | OPR 手順で検証 |
145
+ | nfr-avl-003 | P1 障害時のデータ損失を目標範囲内に収める | RPO | 5 分以内 | WAL + レプリケーション |
163
146
 
164
147
  ### 8.4. 測定・検証方法(例)
165
148
 
166
- | 要件ID | 測定方法 | 判定タイミング | 判定者 |
167
- | ----------- | ---------------------------------------------- | ------------------- | ----------- |
168
- | nfr-avl-001 | 外形監視(HTTP ヘルスチェック 1 分間隔)で算出 | 月次運用レビュー | SRE |
169
- | nfr-avl-002 | インシデント記録の復旧完了時刻から算出 | 障害事後レビュー | SRE / PM |
170
- | nfr-avl-003 | バックアップ復元試験でデータ差分を確認 | 四半期復元試験 | DBA / SRE |
171
- | nfr-avl-004 | インシデント記録の復旧完了時刻から算出 | 障害事後レビュー | SRE |
172
- | nfr-avl-005 | フェイルオーバー試験で切替時間を計測 | リリース前 / 四半期 | Infra / SRE |
173
- | nfr-avl-006 | バッチジョブ監視ダッシュボードで完了率を集計 | 日次確認 | Ops |
174
- | nfr-avl-007 | 年次 DR 訓練の実測値 | 年次 DR 訓練 | SRE / PM |
149
+ | 要件ID | 測定方法 | 判定タイミング |
150
+ | ----------- | ---------------------------------------------- | ---------------- |
151
+ | nfr-avl-001 | 外形監視(HTTP ヘルスチェック 1 分間隔)で算出 | 月次運用レビュー |
152
+ | nfr-avl-002 | インシデント記録の復旧完了時刻から算出 | 障害事後レビュー |
153
+ | nfr-avl-003 | バックアップ復元試験でデータ差分を確認 | 四半期復元試験 |
175
154
 
176
155
  ### 8.5. 関連ドキュメント導線(例)
177
156
 
178
- | 種別 | ドキュメントID | 目的 | 備考 |
179
- | ------------ | -------------- | ---------------------------- | ---- |
180
- | NFR 入口 | nfr-index | 非機能要件全体の俯瞰 | 必須 |
181
- | 受入条件 | sac-\* | 可用性要件の合否判定基準 | 必須 |
182
- | システム試験 | stc-\* | フェイルオーバー・DR 試験 | 必須 |
183
- | 運用設計 | opd-\* | 監視・アラート・復旧判断基準 | 必須 |
184
- | 運用手順 | opr-\* | 障害一次対応・DR 切替手順 | 必須 |
185
- | 判断記録 | dec-\* | 冗長構成・DR 方式の設計判断 | 任意 |
157
+ | 種別 | ドキュメントID | 目的 |
158
+ | -------- | -------------- | ------------------------ |
159
+ | 受入条件 | sac-\* | 可用性要件の合否判定基準 |