specdojo 0.8.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 (284) hide show
  1. package/.github/agents/specdojo-orchestrator.md +4 -1
  2. package/CHANGELOG.md +64 -0
  3. package/dist/catalog/catalog.js +16 -14
  4. package/dist/commands/agent.js +5 -3
  5. package/dist/commands/build.js +69 -10
  6. package/dist/commands/git.js +206 -0
  7. package/dist/commands/init.js +4 -2
  8. package/dist/commands/where.js +25 -0
  9. package/dist/dashboard/dashboard.js +5 -3
  10. package/dist/dashboard/routines.js +4 -7
  11. package/dist/dashboard/timeline.js +14 -14
  12. package/dist/docs/index-command.js +2 -2
  13. package/dist/docs/yaml-business-tables.js +243 -0
  14. package/dist/docs/yaml-interface-tables.js +106 -0
  15. package/dist/docs/yaml-pages-command.js +5 -3
  16. package/dist/docs/yaml-pages.js +146 -3
  17. package/dist/docs/yaml-table-shared.js +70 -0
  18. package/dist/docs/yaml-tables.js +39 -0
  19. package/dist/exec/agent-config.js +9 -0
  20. package/dist/exec/agent-protected-config.js +2 -0
  21. package/dist/exec/commands.js +31 -18
  22. package/dist/exec/events.js +34 -14
  23. package/dist/exec/evidence.js +13 -3
  24. package/dist/exec/parent-validation.js +56 -3
  25. package/dist/exec/plans-core.js +21 -2
  26. package/dist/exec/plans-generation.js +6 -7
  27. package/dist/exec/post-integration.js +162 -0
  28. package/dist/exec/queue-command.js +166 -0
  29. package/dist/exec/queue.js +285 -0
  30. package/dist/exec/register-foreign-wait.js +84 -0
  31. package/dist/exec/repo-integration-sync.js +17 -5
  32. package/dist/exec/reporter.js +2 -2
  33. package/dist/exec/results.js +24 -4
  34. package/dist/exec/review-kata.js +4 -1
  35. package/dist/exec/run/agent-pipeline.js +3 -2
  36. package/dist/exec/run/agent.js +12 -6
  37. package/dist/exec/run/change-scope.js +365 -0
  38. package/dist/exec/run/deferred-cleanup.js +31 -0
  39. package/dist/exec/run/in-place.js +4 -1
  40. package/dist/exec/run/job-lock.js +66 -0
  41. package/dist/exec/run/job-sequence.js +137 -0
  42. package/dist/exec/run/job.js +56 -19
  43. package/dist/exec/run/lifecycle-commands.js +1 -1
  44. package/dist/exec/run/lock.js +22 -1
  45. package/dist/exec/run/register-command.js +8 -5
  46. package/dist/exec/run/register-mode.js +68 -8
  47. package/dist/exec/run/register-resume.js +68 -14
  48. package/dist/exec/run/register-state.js +13 -8
  49. package/dist/exec/run/register-worktree.js +140 -125
  50. package/dist/exec/run/schedule-mode.js +75 -14
  51. package/dist/exec/run/schedule-prepare.js +3 -0
  52. package/dist/exec/run/schedule-task.js +88 -38
  53. package/dist/exec/run/shared.js +5 -0
  54. package/dist/exec/schedule/schedule.js +116 -4
  55. package/dist/exec/shared.js +1 -1
  56. package/dist/exec/smoke.js +190 -0
  57. package/dist/exec/strategy.js +13 -3
  58. package/dist/exec/task-view.js +6 -4
  59. package/dist/exec/trial-commands.js +5 -2
  60. package/dist/exec/trial-core.js +6 -1
  61. package/dist/exec/validation-metrics.js +181 -0
  62. package/dist/exec/worktree-cleanup-lock.js +26 -0
  63. package/dist/exec/worktree-command.js +9 -1
  64. package/dist/exec/worktree-ops-commit.js +2 -2
  65. package/dist/exec/worktree.js +13 -2
  66. package/dist/grade/command-apply.js +3 -3
  67. package/dist/grade/command-inspect.js +5 -3
  68. package/dist/grade/command-plan.js +1 -1
  69. package/dist/grade/command-run.js +5 -1
  70. package/dist/grade/run.js +64 -8
  71. package/dist/job/definition.js +84 -8
  72. package/dist/job/job.js +79 -23
  73. package/dist/register/authoring-sources.js +22 -16
  74. package/dist/register/maintenance-commands.js +2 -2
  75. package/dist/register/register.js +31 -7
  76. package/dist/routine/definition.js +9 -0
  77. package/dist/routine/routine.js +137 -43
  78. package/dist/routine/status.js +62 -0
  79. package/dist/schedule/schedule.js +38 -39
  80. package/dist/shared/agent-types.js +5 -0
  81. package/dist/shared/cross-process-lock.js +9 -1
  82. package/dist/shared/dist-freshness.js +8 -2
  83. package/dist/shared/git-environment.js +2 -1
  84. package/dist/shared/git.js +44 -1
  85. package/dist/shared/lefthook-scaffold.js +3 -0
  86. package/dist/shared/local-config.js +244 -0
  87. package/dist/shared/specdojo-config.js +34 -20
  88. package/dist/shared/specdojo-gitignore.js +1 -0
  89. package/dist/shared/text.js +9 -1
  90. package/dist/shared/where-alias.js +13 -0
  91. package/dist/specdojo.js +4 -0
  92. package/docs/ja/specdojo/defaults/pm-review-viewpoints.yaml +2 -0
  93. package/docs/ja/specdojo/guides/exec-config-guide.md +23 -4
  94. package/docs/ja/specdojo/guides/exec-operation-guide.md +44 -1
  95. package/docs/ja/specdojo/guides/job-sequence-guide.md +77 -0
  96. package/docs/ja/specdojo/guides/quick-start-guide.md +3 -3
  97. package/docs/ja/specdojo/guides/register-operation-guide.md +1 -1
  98. package/docs/ja/specdojo/guides/routine-operation-guide.md +11 -6
  99. package/docs/ja/specdojo/guides/schedule-design-guide.md +20 -17
  100. package/docs/ja/specdojo/guides/waza-guide.md +12 -8
  101. package/docs/ja/specdojo/recipes/bac-recipe.md +66 -49
  102. package/docs/ja/specdojo/recipes/bes-recipe.md +90 -54
  103. package/docs/ja/specdojo/recipes/bps-recipe.md +88 -139
  104. package/docs/ja/specdojo/recipes/br-recipe.md +40 -47
  105. package/docs/ja/specdojo/recipes/cdfd-overview-recipe.md +97 -109
  106. package/docs/ja/specdojo/recipes/cdfd-recipe.md +85 -146
  107. package/docs/ja/specdojo/recipes/cdfd-uc-recipe.md +91 -110
  108. package/docs/ja/specdojo/recipes/cnd-recipe.md +79 -69
  109. package/docs/ja/specdojo/recipes/cpd-recipe.md +78 -64
  110. package/docs/ja/specdojo/recipes/cxd-recipe.md +92 -75
  111. package/docs/ja/specdojo/recipes/ifd-recipe.md +79 -68
  112. package/docs/ja/specdojo/recipes/ifx-cmd-recipe.md +78 -105
  113. package/docs/ja/specdojo/recipes/ifx-index-recipe.md +105 -71
  114. package/docs/ja/specdojo/recipes/pm-communication-plan-recipe.md +60 -49
  115. package/docs/ja/specdojo/recipes/pm-members-recipe.md +50 -51
  116. package/docs/ja/specdojo/recipes/pm-organization-recipe.md +59 -51
  117. package/docs/ja/specdojo/recipes/pm-plan-recipe.md +69 -56
  118. package/docs/ja/specdojo/recipes/pm-quality-management-plan-recipe.md +37 -56
  119. package/docs/ja/specdojo/recipes/pm-raci-recipe.md +39 -53
  120. package/docs/ja/specdojo/recipes/pm-roles-recipe.md +52 -79
  121. package/docs/ja/specdojo/recipes/prj-assumptions-constraints-dependencies-recipe.md +64 -93
  122. package/docs/ja/specdojo/recipes/prj-charter-recipe.md +71 -106
  123. package/docs/ja/specdojo/recipes/prj-comparison-of-alternatives-recipe.md +78 -157
  124. package/docs/ja/specdojo/recipes/prj-issues-and-approach-recipe.md +62 -111
  125. package/docs/ja/specdojo/recipes/prj-scope-recipe.md +67 -123
  126. package/docs/ja/specdojo/recipes/prj-stakeholder-register-recipe.md +60 -96
  127. package/docs/ja/specdojo/recipes/prj-success-criteria-and-acceptance-criteria-recipe.md +61 -105
  128. package/docs/ja/specdojo/recipes/stsd-recipe.md +79 -109
  129. package/docs/ja/specdojo/recipes/sysd-critical-flows-recipe.md +78 -55
  130. package/docs/ja/specdojo/recipes/sysd-cross-cutting-policy-recipe.md +82 -73
  131. package/docs/ja/specdojo/recipes/sysd-index-recipe.md +78 -59
  132. package/docs/ja/specdojo/recipes/tsd-recipe.md +149 -129
  133. package/docs/ja/specdojo/references/command-reference.md +257 -117
  134. package/docs/ja/specdojo/references/deliverables-reference.md +21 -12
  135. package/docs/ja/specdojo/references/specdojo-config-reference.md +37 -2
  136. package/docs/ja/specdojo/rulebooks/atc-index-rulebook.md +101 -257
  137. package/docs/ja/specdojo/rulebooks/atc-rulebook.md +102 -228
  138. package/docs/ja/specdojo/rulebooks/bac-rulebook.md +19 -28
  139. package/docs/ja/specdojo/rulebooks/bdd-rulebook.md +16 -67
  140. package/docs/ja/specdojo/rulebooks/bds-rulebook.md +30 -51
  141. package/docs/ja/specdojo/rulebooks/bes-index-rulebook.md +41 -61
  142. package/docs/ja/specdojo/rulebooks/bes-rulebook.md +22 -50
  143. package/docs/ja/specdojo/rulebooks/bps-rulebook.md +24 -56
  144. package/docs/ja/specdojo/rulebooks/br-rulebook.md +13 -38
  145. package/docs/ja/specdojo/rulebooks/ccd-mermaid-rulebook.md +41 -76
  146. package/docs/ja/specdojo/rulebooks/cdfd-d2-rulebook.md +18 -93
  147. package/docs/ja/specdojo/rulebooks/cdfd-mermaid-rulebook.md +18 -52
  148. package/docs/ja/specdojo/rulebooks/cdfd-overview-rulebook.md +109 -147
  149. package/docs/ja/specdojo/rulebooks/cdfd-rulebook.md +80 -108
  150. package/docs/ja/specdojo/rulebooks/cdfd-uc-rulebook.md +21 -46
  151. package/docs/ja/specdojo/rulebooks/cdr-rulebook.md +144 -0
  152. package/docs/ja/specdojo/rulebooks/cdsd-rulebook.md +27 -48
  153. package/docs/ja/specdojo/rulebooks/cdt-rulebook.md +37 -50
  154. package/docs/ja/specdojo/rulebooks/clis-rulebook.md +52 -69
  155. package/docs/ja/specdojo/rulebooks/cnd-mermaid-rulebook.md +33 -86
  156. package/docs/ja/specdojo/rulebooks/cnd-rulebook.md +16 -32
  157. package/docs/ja/specdojo/rulebooks/cop-index-rulebook.md +45 -131
  158. package/docs/ja/specdojo/rulebooks/cop-rulebook.md +69 -275
  159. package/docs/ja/specdojo/rulebooks/cpd-mermaid-rulebook.md +20 -112
  160. package/docs/ja/specdojo/rulebooks/cpd-rulebook.md +23 -56
  161. package/docs/ja/specdojo/rulebooks/cxd-mermaid-rulebook.md +12 -145
  162. package/docs/ja/specdojo/rulebooks/cxd-rulebook.md +39 -47
  163. package/docs/ja/specdojo/rulebooks/dct-index-rulebook.md +37 -56
  164. package/docs/ja/specdojo/rulebooks/dct-rulebook.md +118 -175
  165. package/docs/ja/specdojo/rulebooks/dec-rulebook.md +5 -14
  166. package/docs/ja/specdojo/rulebooks/dmd-index-rulebook.md +22 -66
  167. package/docs/ja/specdojo/rulebooks/dmd-rulebook.md +36 -94
  168. package/docs/ja/specdojo/rulebooks/dss-rulebook.md +59 -81
  169. package/docs/ja/specdojo/rulebooks/etc-index-rulebook.md +31 -131
  170. package/docs/ja/specdojo/rulebooks/etc-rulebook.md +50 -104
  171. package/docs/ja/specdojo/rulebooks/gl-rulebook.md +51 -61
  172. package/docs/ja/specdojo/rulebooks/ifd-mermaid-rulebook.md +38 -45
  173. package/docs/ja/specdojo/rulebooks/ifx-api-rulebook.md +14 -20
  174. package/docs/ja/specdojo/rulebooks/ifx-cmd-rulebook.md +26 -38
  175. package/docs/ja/specdojo/rulebooks/ifx-file-rulebook.md +26 -107
  176. package/docs/ja/specdojo/rulebooks/ifx-index-rulebook.md +42 -49
  177. package/docs/ja/specdojo/rulebooks/ifx-msg-rulebook.md +14 -22
  178. package/docs/ja/specdojo/rulebooks/imp-business-rulebook.md +21 -44
  179. package/docs/ja/specdojo/rulebooks/imp-data-rulebook.md +41 -64
  180. package/docs/ja/specdojo/rulebooks/imp-interface-rulebook.md +14 -38
  181. package/docs/ja/specdojo/rulebooks/imp-operations-rulebook.md +34 -61
  182. package/docs/ja/specdojo/rulebooks/imp-test-rulebook.md +27 -50
  183. package/docs/ja/specdojo/rulebooks/itc-index-rulebook.md +70 -199
  184. package/docs/ja/specdojo/rulebooks/itc-rulebook.md +65 -153
  185. package/docs/ja/specdojo/rulebooks/mip-index-rulebook.md +74 -150
  186. package/docs/ja/specdojo/rulebooks/mm-rulebook.md +11 -23
  187. package/docs/ja/specdojo/rulebooks/mtp-rulebook.md +99 -176
  188. package/docs/ja/specdojo/rulebooks/nfr-availability-rulebook.md +35 -61
  189. package/docs/ja/specdojo/rulebooks/nfr-index-rulebook.md +75 -117
  190. package/docs/ja/specdojo/rulebooks/nfr-integrity-rulebook.md +31 -60
  191. package/docs/ja/specdojo/rulebooks/nfr-maintainability-rulebook.md +26 -81
  192. package/docs/ja/specdojo/rulebooks/nfr-operations-rulebook.md +32 -70
  193. package/docs/ja/specdojo/rulebooks/nfr-performance-rulebook.md +45 -87
  194. package/docs/ja/specdojo/rulebooks/nfr-reliability-rulebook.md +48 -101
  195. package/docs/ja/specdojo/rulebooks/nfr-security-safety-rulebook.md +44 -80
  196. package/docs/ja/specdojo/rulebooks/nfr-usability-rulebook.md +59 -127
  197. package/docs/ja/specdojo/rulebooks/opd-index-rulebook.md +31 -50
  198. package/docs/ja/specdojo/rulebooks/opd-rulebook.md +42 -109
  199. package/docs/ja/specdojo/rulebooks/opr-index-rulebook.md +29 -42
  200. package/docs/ja/specdojo/rulebooks/opr-rulebook.md +29 -87
  201. package/docs/ja/specdojo/rulebooks/otp-index-rulebook.md +62 -84
  202. package/docs/ja/specdojo/rulebooks/otp-rulebook.md +11 -61
  203. package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +91 -106
  204. package/docs/ja/specdojo/rulebooks/pm-change-request-log-rulebook.md +25 -34
  205. package/docs/ja/specdojo/rulebooks/pm-communication-plan-rulebook.md +30 -53
  206. package/docs/ja/specdojo/rulebooks/pm-issue-log-rulebook.md +23 -35
  207. package/docs/ja/specdojo/rulebooks/pm-members-rulebook.md +27 -45
  208. package/docs/ja/specdojo/rulebooks/pm-organization-rulebook.md +37 -45
  209. package/docs/ja/specdojo/rulebooks/pm-plan-rulebook.md +45 -46
  210. package/docs/ja/specdojo/rulebooks/pm-quality-management-plan-rulebook.md +37 -48
  211. package/docs/ja/specdojo/rulebooks/pm-raci-rulebook.md +25 -29
  212. package/docs/ja/specdojo/rulebooks/pm-risk-register-rulebook.md +28 -35
  213. package/docs/ja/specdojo/rulebooks/pm-roles-rulebook.md +36 -41
  214. package/docs/ja/specdojo/rulebooks/pr-rulebook.md +5 -18
  215. package/docs/ja/specdojo/rulebooks/prj-assumptions-constraints-dependencies-rulebook.md +16 -37
  216. package/docs/ja/specdojo/rulebooks/prj-charter-rulebook.md +23 -97
  217. package/docs/ja/specdojo/rulebooks/prj-comparison-of-alternatives-rulebook.md +39 -57
  218. package/docs/ja/specdojo/rulebooks/prj-issues-and-approach-rulebook.md +43 -116
  219. package/docs/ja/specdojo/rulebooks/prj-scope-rulebook.md +16 -51
  220. package/docs/ja/specdojo/rulebooks/prj-stakeholder-register-rulebook.md +47 -92
  221. package/docs/ja/specdojo/rulebooks/prj-success-criteria-and-acceptance-criteria-rulebook.md +25 -84
  222. package/docs/ja/specdojo/rulebooks/sac-rulebook.md +44 -107
  223. package/docs/ja/specdojo/rulebooks/sf-index-rulebook.md +39 -49
  224. package/docs/ja/specdojo/rulebooks/sf-rulebook.md +42 -49
  225. package/docs/ja/specdojo/rulebooks/sld-rulebook.md +64 -89
  226. package/docs/ja/specdojo/rulebooks/stc-index-rulebook.md +90 -189
  227. package/docs/ja/specdojo/rulebooks/stc-rulebook.md +45 -105
  228. package/docs/ja/specdojo/rulebooks/stsd-mermaid-rulebook.md +6 -12
  229. package/docs/ja/specdojo/rulebooks/stsd-rulebook.md +49 -68
  230. package/docs/ja/specdojo/rulebooks/sysd-critical-flows-rulebook.md +51 -60
  231. package/docs/ja/specdojo/rulebooks/sysd-cross-cutting-policy-rulebook.md +46 -50
  232. package/docs/ja/specdojo/rulebooks/sysd-index-rulebook.md +39 -64
  233. package/docs/ja/specdojo/rulebooks/sysd-rulebook.md +47 -60
  234. package/docs/ja/specdojo/rulebooks/trc-requirements-to-specs-rulebook.md +69 -70
  235. package/docs/ja/specdojo/rulebooks/trc-requirements-to-tests-rulebook.md +65 -72
  236. package/docs/ja/specdojo/rulebooks/tsd-index-rulebook.md +35 -46
  237. package/docs/ja/specdojo/rulebooks/tsd-rulebook.md +49 -66
  238. package/docs/ja/specdojo/rulebooks/tsp-index-rulebook.md +64 -139
  239. package/docs/ja/specdojo/rulebooks/uis-rulebook.md +41 -108
  240. package/docs/ja/specdojo/rulebooks/utc-index-rulebook.md +49 -144
  241. package/docs/ja/specdojo/rulebooks/utc-rulebook.md +67 -155
  242. package/docs/ja/specdojo/samples/bds-sample.md +58 -71
  243. package/docs/ja/specdojo/samples/bes-index-sample.md +20 -37
  244. package/docs/ja/specdojo/samples/bes-sample.md +43 -53
  245. package/docs/ja/specdojo/samples/bps-sample.md +42 -54
  246. package/docs/ja/specdojo/samples/br-sample.md +40 -52
  247. package/docs/ja/specdojo/samples/ccd-sample.md +0 -1
  248. package/docs/ja/specdojo/samples/cdr-sample.md +78 -0
  249. package/docs/ja/specdojo/samples/cdsd-sample.md +47 -63
  250. package/docs/ja/specdojo/samples/clis-sample.md +70 -77
  251. package/docs/ja/specdojo/samples/dec-sample.md +2 -3
  252. package/docs/ja/specdojo/samples/ifx-api-sample.yaml +0 -2
  253. package/docs/ja/specdojo/samples/ifx-msg-sample.yaml +0 -2
  254. package/docs/ja/specdojo/samples/job-sequence.yaml +67 -0
  255. package/docs/ja/specdojo/samples/mip-index-sample.md +98 -20
  256. package/docs/ja/specdojo/samples/pm-communication-plan-sample.md +26 -19
  257. package/docs/ja/specdojo/samples/pm-organization-sample.md +39 -50
  258. package/docs/ja/specdojo/samples/pm-plan-sample.md +61 -67
  259. package/docs/ja/specdojo/samples/pm-quality-management-plan-sample.md +31 -45
  260. package/docs/ja/specdojo/samples/pm-raci-sample.md +31 -37
  261. package/docs/ja/specdojo/samples/prj-assumptions-constraints-dependencies-sample.md +32 -48
  262. package/docs/ja/specdojo/samples/prj-charter-sample.md +42 -59
  263. package/docs/ja/specdojo/samples/prj-comparison-of-alternatives-sample.md +55 -61
  264. package/docs/ja/specdojo/samples/prj-success-criteria-and-acceptance-criteria-sample.md +30 -33
  265. package/docs/ja/specdojo/samples/sf-index-sample.md +13 -55
  266. package/docs/ja/specdojo/samples/sf-sample.md +73 -85
  267. package/docs/ja/specdojo/samples/sld-sample.md +60 -79
  268. package/docs/ja/specdojo/samples/uis-sample.md +98 -121
  269. package/docs/ja/specdojo/standards/job-definition-standard.md +24 -9
  270. package/docs/ja/specdojo/templates/cdr-template.md +58 -0
  271. package/docs/specdojo/schemas/v1/exec-common.schema.yaml +2 -1
  272. package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +42 -5
  273. package/docs/specdojo/schemas/v1/exec-evidence.schema.yaml +35 -0
  274. package/docs/specdojo/schemas/v1/job-run.schema.yaml +23 -0
  275. package/docs/specdojo/schemas/v1/job.schema.yaml +63 -2
  276. package/docs/specdojo/schemas/v1/sch-strategy.schema.yaml +2 -2
  277. package/package.json +9 -6
  278. package/templates/antigravity/orchestrator.md +4 -1
  279. package/templates/claude/agents/specdojo-orchestrator.md +4 -1
  280. package/templates/codex/agents/specdojo-orchestrator.toml +4 -1
  281. package/templates/codex/orchestrator.md +4 -1
  282. package/templates/init-exec-defaults.yaml +13 -0
  283. package/templates/lefthook/tools/specdojo-pre-commit.mjs +8 -0
  284. package/templates/opencode/agents/specdojo-orchestrator.md +5 -2
@@ -17,105 +17,83 @@ Operations Transition Plan Documentation Rules
17
17
 
18
18
  ## 1. 全体方針
19
19
 
20
- - `otp-index` は運用切替計画の入口(共通SSOT)として、運用安定化に必要な共通方針と判断軸を定義する。
21
- - 個別領域の詳細は `otp-<term>` に委譲し、`otp-index` では共通運用と導線を定義する。
22
- - 曖昧表現を避け、一次応答条件・SLA・クローズ条件が判定可能な記述にする。
20
+ - `otp-index` は切替後の運用が安定するまでの共通方針と判断軸(監視・窓口・ハイパーケア体制・クローズ条件)を定義する入口とする。
21
+ - 対象別の運用詳細は `otp-<term>` に委譲し、`otp-index` には共通運用と導線だけを書く。
22
+ - 一次応答条件・SLA・クローズ条件は、数値・期限・判断者で判定できる形で書く。
23
+ - **共通の運用**: 役割の割り当ては適用先のメンバー定義に、`status` の昇格と承認、改訂と廃止、未決事項の登録簿への引き継ぎは [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] に従い、本書と成果物で言い直さない。
23
24
 
24
- ## 2. 位置づけと用語定義(必要に応じて)
25
+ ## 2. 位置づけ
25
26
 
26
- - `mip-index`: 移行計画・成功条件・ハイパーケア方針の合意
27
- - `cop-index`: 当日切替の実行計画(Runbook)
28
- - `otp-index`: 運用切替の共通設計(本書)
29
- - `otp-<term>`: 対象別の運用詳細(監視、窓口、当番、手順差分)
30
- - `mtp-index` / `mtp-<term>`: リハーサル計画と証跡
27
+ | 文書 | 役割 |
28
+ | -------------------------- | --------------------------------------------------- |
29
+ | `mip-index` | 移行計画・成功条件・ハイパーケア方針の合意 |
30
+ | `cop-index` | 当日切替の実行計画(Runbook)。本書はその後を受ける |
31
+ | `otp-index` | 運用切替の共通設計(本書) |
32
+ | `otp-<term>` | 対象別の運用詳細(監視、窓口、当番、手順差分) |
33
+ | `mtp-index` / `mtp-<term>` | リハーサル計画と証跡 |
31
34
 
32
35
  ## 3. ファイル命名・ID規則
33
36
 
34
- - `id` は `otp-index` を使用する。
35
- - ファイル名は `otp-index-運用切替計画.md` など、プロジェクト内で一意になるように命名する。
37
+ - **文書 ID**: プロジェクト固有の成果物は `<project-id>:otp-index`(例: `prj-0001:otp-index`)とし、成果物カタログの宣言と一致させる。
38
+ - **ファイル名**: 成果物カタログの `path` に従い、`otp-index.md` を基本とする。
39
+ - **分冊**: 対象別の分冊は `<project-id>:otp-<term>` とし、`<term>` は英小文字の kebab-case とする。
36
40
 
37
41
  ## 4. 推奨 Frontmatter 項目
38
42
 
39
- | 項目 | 説明 | 必須 |
40
- | ---- | ---- | ---- |
43
+ 許可キー・必須項目・型制約は [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] と `docs/specdojo/schemas/v1/deliverable-frontmatter.schema.yaml` を正本とする。
41
44
 
42
- | id | `otp-index` | ○ |
45
+ - `specdojo.type` は `operations`、`specdojo.rulebook` は `specdojo:otp-index-rulebook` とする。
46
+ - `specdojo.based_on` には、実際に読んで根拠とした作成済み文書(`cop-index` など)の ID を記載する。
43
47
 
44
- | type | `operations` 固定 | ○ |
45
- | title | `運用切替計画: 全体` | ○ |
46
-
47
- | status | `draft` / `ready` / `deprecated` | ○ |
48
- | based_on | 根拠となる仕様ID(ID配列。未指定は `[]` 可) | 任意 |
49
- | supersedes | 置き換え関係(ID配列。未指定は `[]` 可) | 任意 |
50
-
51
- ## 5. 本文構成(標準テンプレ)
52
-
53
- | 番号 | 見出し | 必須 |
54
- | ---- | ------ | ---- |
55
-
56
- | 1 | 概要(index) | ○ |
57
- | 2 | 監視/アラート | ○ |
58
- | 3 | バックアップ/リストア | ○ |
59
- | 4 | 権限/アカウント移行 | ○ |
60
- | 5 | 運用手順の変更点 | ○ |
61
- | 6 | 問合せ窓口/一次対応 | ○ |
62
- | 7 | 障害対応フロー | ○ |
63
- | 8 | 初期増員体制(期間・当番・SLA) | ○ |
64
- | 9 | 旧システムの停止/参照方針 | ○ |
65
- | 10 | 移行完了後のクローズ条件 | ○ |
66
- | 11 | 関連ドキュメント(必須) | ○ |
48
+ ```yaml
49
+ ---
50
+ specdojo:
51
+ id: prj-0001:otp-index
52
+ type: operations
53
+ status: draft
54
+ rulebook: specdojo:otp-index-rulebook
55
+ based_on:
56
+ - prj-0001:cop-index
57
+ ---
58
+ ```
59
+
60
+ ## 5. 本文要件
61
+
62
+ 本文は次の 11 章をすべて必須とする。
63
+
64
+ | 章 | 受入条件 |
65
+ | ------------------------------- | -------------------------------------------------------------------------------- |
66
+ | 概要(index) | 運用安定化の目的と適用範囲を 1〜3 行で示し、詳細が `otp-<term>` にあると分かる |
67
+ | 監視/アラート | 監視対象ごとに指標・閾値・通知先・初動ルールが表で分かる |
68
+ | バックアップ/リストア | 頻度・保管先・保持期間・リストア責任者が分かる |
69
+ | 権限/アカウント移行 | 旧新の権限差分・移行タイミング・検証方法が分かる |
70
+ | 運用手順の変更点 | 手順ごとに旧・新・変更理由・影響・参照先が表で分かる |
71
+ | 問合せ窓口/一次対応 | 受付時間・チャネル・優先度分類・エスカレーション条件が分かる |
72
+ | 障害対応フロー | 判断・連絡・復旧・報告の流れと指揮系統が分かる |
73
+ | 初期増員体制(期間・当番・SLA) | ハイパーケア期間・当番と時間帯・SLA・終了判断者が表で分かる |
74
+ | 旧システムの停止/参照方針 | 停止時期・参照可否と期間・アーカイブ方針が分かる |
75
+ | 移行完了後のクローズ条件 | 測定可能な完了条件・クローズ判断者・最終報告物が分かる |
76
+ | 関連ドキュメント(必須) | 各 `otp-<term>` と前後の文書への導線がある。分冊が無ければ `(本書のみ)` と書く |
67
77
 
68
78
  ## 6. 記述ガイド
69
79
 
70
- ### 6.1. 概要(index)
71
-
72
- - 運用安定化の目的と適用範囲を 1〜3 行で示す。
73
- - 本書が入口(SSOT)であり、詳細は `otp-<term>` にあることを明記する。
74
-
75
- ### 6.2. 監視/アラート
76
-
77
- - 監視対象、指標/閾値、通知先、初動ルールを明記する。
78
-
79
- ### 6.3. バックアップ/リストア
80
-
81
- - バックアップ頻度、保管先、保持期間、リストア責任者を明記する。
82
-
83
- ### 6.4. 権限/アカウント移行
84
-
85
- - 旧/新の権限差分、移行タイミング、検証方法を明記する。
86
-
87
- ### 6.5. 運用手順の変更点
88
-
89
- - 旧手順との差分、理由、影響を明記し、詳細はリンク参照とする。
90
-
91
- ### 6.6. 問合せ窓口/一次対応
92
-
93
- - 受付時間、チャネル、優先度分類、エスカレーション条件を明記する。
94
-
95
- ### 6.7. 障害対応フロー
96
-
97
- - 判断/連絡/復旧/報告の流れと指揮系統を明記する。
98
-
99
- ### 6.8. 初期増員体制(期間・当番・SLA)
100
-
101
- - ハイパーケア期間、当番体制、SLA、終了判断者を明記する。
102
-
103
- ### 6.9. 旧システムの停止/参照方針
104
-
105
- - 停止時期、参照可否、アーカイブ方針を明記する。
106
-
107
- ### 6.10. 移行完了後のクローズ条件
108
-
109
- - 完了条件、クローズ判断者、最終報告物を明記する。
80
+ 完成例の全体像は Frontmatter の `sample` で宣言された sample を参照する。各章は次の判断基準に従う。
110
81
 
111
- ### 6.11. 関連ドキュメント(必須)
82
+ - **事実と仮定を分ける**: 合意済みの値(期間・SLA・閾値)と仮置きの値を混ぜない。仮置きは `_ASSUMPTION_`、未合意は `_UNDECIDED_` を付ける。
83
+ - **判断者を書く**: エスカレーション先・ハイパーケア終了・クローズは、判断する役割を章内に書く。
84
+ - **閾値と期限で書く**: 「早めに」「状況に応じて」ではなく、数値・時間・件数で書く。
112
85
 
113
- - 各 `otp-<term>` への導線を必ず記載する。
114
- - 分冊が無い場合でも `(本書のみ)` を明記する。
86
+ | 章 | 良い例 | 悪い例 |
87
+ | ------------------------ | --------------------------------------------------------------------------- | ---------------------------- |
88
+ | 監視/アラート | API 5xx が 5 分平均 1% 超で #ops へ通知し、P1 は 30 分以内に一次応答 | 異常があれば速やかに対応する |
89
+ | 初期増員体制 | 切替後 2 週間、8:00-20:00 は 2 名、夜間はオンコール。延長は運用責任者が判断 | 当面は手厚く対応する |
90
+ | 移行完了後のクローズ条件 | 重大障害 0 件が 30 日継続し、問合せが日次平均 5 件以下 | 運用が安定したらクローズする |
115
91
 
116
92
  ## 7. 禁止事項
117
93
 
118
- - `otp-<term>` に委譲すべき個別運用詳細を `otp-index` に重複記載しない。
119
- - 監視/窓口/SLA/クローズ条件を未定義にしない。
120
- - `otp-<term>` への導線を欠落させない。
121
- - 実装依存の長大な手順やコードを本文に記載しない。
94
+ | 禁止パターン | 理由 |
95
+ | --------------------------------------------------------- | -------------------------------------------------------- |
96
+ | `otp-<term>` に委譲すべき個別運用詳細を重複記載すること | 分冊と食い違い、改訂時に片方が取り残されるため |
97
+ | 監視・窓口・SLA・クローズ条件のいずれかを未定義にすること | ハイパーケアの開始・終了と一次対応を判断できなくなるため |
98
+ | `otp-<term>` への導線を欠くこと | 入口として対象別の詳細へ辿れなくなるため |
99
+ | 実装依存の長大な手順やコードを本文に書くこと | Runbook・手順書との二重管理になるため |
@@ -18,18 +18,9 @@ Operations Transition Plan (OTP) Documentation Rules
18
18
 
19
19
  `otp-<term>` は、切替後の運用安定化と初期対応体制の対象別詳細を定義する個別SSOTとする。
20
20
 
21
- - 共通方針(期間・SLA・優先度分類・クローズ基準)は `otp-index` を正とする
22
- - 監視/アラート、バックアップ/リストアなどの運用基盤を明記する
23
- - 権限/アカウント移行と運用手順の変更点を整理する
24
- - 問合せ窓口と一次対応体制、障害対応フローを明確にする
25
- - ハイパーケア期間の増員体制(期間/当番/SLA)を定義する
26
- - 旧システムの停止/参照方針とクローズ条件を明記する
27
-
28
- 運用方針(term 運用):
29
-
30
- - `otp-<term>` は、領域/拠点/システム群/運用ドメイン単位で作成する
31
- - `otp-<term>` の判断体系は `otp-index` と矛盾させない
32
- - **「関連ドキュメント」セクションは必須**(分冊が無い場合でも `(本書のみ)` を明記して空欄にしない)
21
+ - 共通方針(期間・SLA・優先度分類・クローズ基準)は `otp-index` を正とし、`otp-<term>` の判断体系はこれと矛盾させない
22
+ - `otp-<term>` は領域/拠点/システム群/運用ドメイン単位で作成し、term固有(監視対象、窓口、当番、手順差分)に寄せる
23
+ - 共通の運用: 役割の割り当ては適用先のメンバー定義に、`status` の昇格と承認、改訂と廃止、未決事項の登録簿への引き継ぎは [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] に従い、本書と成果物で言い直さない
33
24
 
34
25
  ## 2. 位置づけ
35
26
 
@@ -46,27 +37,14 @@ Operations Transition Plan (OTP) Documentation Rules
46
37
 
47
38
  - `id` は `otp-<term>`(kebab-case。例: `otp-hypercare` / `otp-support-desk`)。
48
39
  - ファイル名は `otp-020-運用切替計画-<term>.md` 等、プロジェクト内で一意になるように命名する。
49
- - `<term>` は用語集(GL)の論理名キー(英小文字kebab-case)を用いる(表示名は title / ファイル名で日本語を使用してよい)。
40
+ - `<term>` は用語集(GL)の論理名キー(英小文字kebab-case)を用いる(表示名は H1 / ファイル名で日本語を使用してよい)。
50
41
 
51
42
  ## 4. 推奨 Frontmatter 項目
52
43
 
53
- ### 4.1. 設定内容
54
-
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))。
56
-
57
- | 項目 | 説明 | 必須 |
58
- | ---------- | -------------------------------------------- | ---- |
59
- | id | OTP ID(`otp-<term>`) | ○ |
60
- | type | `operations` 固定 | ○ |
61
- | title | 運用切替計画: <対象名> | ○ |
62
- | status | `draft` / `ready` / `deprecated` | ○ |
63
- | based_on | 根拠となる仕様ID(ID配列。未指定は `[]` 可) | 任意 |
64
- | supersedes | 置き換え関係(ID配列。未指定は `[]` 可) | 任意 |
65
-
66
- ### 4.2. 推奨ルール
44
+ 許可キー・必須項目・型制約は [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] と `docs/specdojo/schemas/v1/deliverable-frontmatter.schema.yaml` を正本とする。
67
45
 
68
- - `based_on` には運用・移行判断に直接利用した成果物(例: `mip-index` / `cop-index` / `mtp-index` / `br-*` / `issue-*`)のみ列挙する
69
- - `based_on` / `supersedes` は ID 配列(未指定は `[]` 可)
46
+ - `specdojo.type` は `operations` 固定とする
47
+ - `specdojo.based_on` には運用・移行判断に直接利用した成果物(例: `mip-index` / `cop-index` / `mtp-index` / `br-*` / `issue-*`)のみ列挙する
70
48
 
71
49
  ## 5. 本文構成(標準テンプレ)
72
50
 
@@ -86,16 +64,11 @@ Frontmatter は共通スキーマに従います(参照: [docs/specdojo/schema
86
64
  | 10 | 移行完了後のクローズ条件 | ○ |
87
65
  | 11 | 関連ドキュメント | ○ |
88
66
 
89
- 補足:
90
-
91
- - `otp-<term>` は term固有(監視対象、窓口、当番、手順差分)に寄せる
92
- - 「関連ドキュメント」セクションは **必須**(分冊が無い場合も `(本書のみ)` と明記)
93
-
94
67
  ## 6. 記述ガイド
95
68
 
96
- ### 6.1. 概要(`<term>`)
69
+ 本文の見出しは、上表の番号と見出しを `## <番号>. <見出し>` の形で用いる。
97
70
 
98
- 生成する本文の見出しは **## 1. 概要(`<term>`)**
71
+ ### 6.1. 概要(`<term>`)
99
72
 
100
73
  - 切替後の運用安定化の目的と適用範囲を 1〜3 行で示す
101
74
  - `mip-index` のハイパーケア方針と整合させる
@@ -103,8 +76,6 @@ Frontmatter は共通スキーマに従います(参照: [docs/specdojo/schema
103
76
 
104
77
  ### 6.2. 監視/アラート
105
78
 
106
- 生成する本文の見出しは **## 2. 監視/アラート**
107
-
108
79
  - 監視対象、指標/閾値、通知先を明記する
109
80
  - 重大アラートの初動ルール(一次応答期限、エスカレーション条件)を明記する
110
81
 
@@ -115,24 +86,18 @@ Frontmatter は共通スキーマに従います(参照: [docs/specdojo/schema
115
86
 
116
87
  ### 6.3. バックアップ/リストア
117
88
 
118
- 生成する本文の見出しは **## 3. バックアップ/リストア**
119
-
120
89
  - バックアップ頻度、保管先、保持期間を明記する
121
90
  - リストア時の責任者、実施手順(リンク可)、完了基準(整合性確認)を明記する
122
91
  - 可能なら「復旧目標(RTO/RPO)」を方針として記載してよい
123
92
 
124
93
  ### 6.4. 権限/アカウント移行
125
94
 
126
- 生成する本文の見出しは **## 4. 権限/アカウント移行**
127
-
128
95
  - 旧/新の権限差分、移行タイミング、切替当日の扱いを明記する
129
96
  - 移行後のアクセス検証方法(主要ロールのログイン/操作)を明記する
130
97
  - 緊急時の権限付与(ブレークグラス)方針がある場合は記載する
131
98
 
132
99
  ### 6.5. 運用手順の変更点
133
100
 
134
- 生成する本文の見出しは **## 5. 運用手順の変更点**
135
-
136
101
  - 旧手順との差分を一覧で示す
137
102
  - 変更理由と影響(誰の何が変わるか)を明記する
138
103
  - 具体的手順書はリンクでよい(本文に詳細手順を長大に貼らない)
@@ -144,24 +109,18 @@ Frontmatter は共通スキーマに従います(参照: [docs/specdojo/schema
144
109
 
145
110
  ### 6.6. 問合せ窓口/一次対応
146
111
 
147
- 生成する本文の見出しは **## 6. 問合せ窓口/一次対応**
148
-
149
112
  - 問合せ窓口、受付時間、一次対応範囲を明記する
150
113
  - 受付チャネル(メール/フォーム/チャット/電話)と優先度分類(P1〜等)を明記する
151
114
  - エスカレーション条件(一次で止めない条件)を明記する
152
115
 
153
116
  ### 6.7. 障害対応フロー
154
117
 
155
- 生成する本文の見出しは **## 7. 障害対応フロー**
156
-
157
118
  - 障害発生時の判断/連絡/復旧/報告の流れを明記する
158
119
  - エスカレーション先と判断基準(重大度、影響範囲、復旧見込み)を明記する
159
120
  - 重大障害時の指揮系統(インシデントコマンダー等)があれば明記する
160
121
 
161
122
  ### 6.8. 初期増員体制(期間・当番・SLA)
162
123
 
163
- 生成する本文の見出しは **## 8. 初期増員体制(期間・当番・SLA)**
164
-
165
124
  - ハイパーケア期間、当番体制、SLA(一次応答/暫定復旧など)を明記する
166
125
  - 期間終了の判断者と条件を明記する(クローズ条件と整合)
167
126
  - 役割分担(運用/開発/業務)を最小限で示す
@@ -173,26 +132,18 @@ Frontmatter は共通スキーマに従います(参照: [docs/specdojo/schema
173
132
 
174
133
  ### 6.9. 旧システムの停止/参照方針
175
134
 
176
- 生成する本文の見出しは **## 9. 旧システムの停止/参照方針**
177
-
178
135
  - 停止時期、参照可否、データ保持/アーカイブ方針を明記する
179
136
  - 停止後の問い合わせ対応(どこで何を見られるか)を明記する
180
137
 
181
138
  ### 6.10. 移行完了後のクローズ条件
182
139
 
183
- 生成する本文の見出しは **## 10. 移行完了後のクローズ条件**
184
-
185
140
  - 完了条件(重大障害未発生期間、問い合わせ収束、運用手順整備完了等)を列挙する
186
141
  - クローズ判断者と最終報告物(振り返り/運用引継ぎ/残課題)を明記する
187
142
 
188
- ### 6.11. 関連ドキュメント(必須)
189
-
190
- 生成する本文の見出しは **## 11. 関連ドキュメント**
143
+ ### 6.11. 関連ドキュメント
191
144
 
192
145
  - `otp-index` への導線(本体SSOT)を必ず記載する
193
- - 分冊が無い場合でも `(本書のみ)` を明記する
194
-
195
- `otp-<term>` では、`otp-index` への導線を必ず記載する。
146
+ - 分冊が無い場合でも `(本書のみ)` を明記し、空欄にしない
196
147
 
197
148
  推奨フォーマット(箇条書き):
198
149
 
@@ -208,4 +159,3 @@ Frontmatter は共通スキーマに従います(参照: [docs/specdojo/schema
208
159
  | 旧システム停止/参照方針が不明確 | 利用者・運用の混乱を招くため |
209
160
  | クローズ条件を未記載にする | 収束判定ができないため |
210
161
  | `otp-<term>` に共通方針を重複記載し、`otp-index` と矛盾させる | SSOTが崩れ、参照が割れるため |
211
- | 「関連ドキュメント」セクションを省略する | 導線が失われ、参照先が分散するため |