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
@@ -13,107 +13,84 @@ specdojo:
13
13
 
14
14
  Impact Analysis (Data) Rulebook
15
15
 
16
- 本ドキュメントは、変更要求がデータへ与える影響を整理するための「影響調査(データ)」の記述ルールを定義します。プロジェクト関係者が変更要否・影響度・対応方針・未解決事項を同じ粒度で判断できる状態を目標とします。
16
+ 変更要求によるデータへの影響を整理し、変更要否・影響度・対応方針を判断する基準を定めます。
17
17
 
18
18
  ## 1. 全体方針
19
19
 
20
- - 対象は「変更要求によるデータ影響の把握と判断」であり、実装設計の詳細化は扱わない。
21
- - 記載粒度は「データ責任者とプロジェクト管理者が合意形成できるレベル」とし、影響の有無だけでなく、判断根拠を簡潔に残す。
22
- - 1 ドキュメントで複数のデータ領域を扱ってよいが、影響詳細はデータ対象単位で分割して管理する。
20
+ - データ責任者とプロジェクト管理者が合意できる粒度で、影響と判断根拠を記載する。
21
+ - 複数領域を扱う場合も影響詳細はデータ対象単位とし、実装設計の詳細化は扱わない。
22
+ - **共通の運用**: 役割は適用先のメンバー定義、`status`・承認・改訂と廃止・未決事項の引き継ぎは [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] に従う。文書の整形・lint はリポジトリの検証で扱う。
23
23
 
24
- - インターフェース仕様、テスト仕様、運用設計への波及がある場合は、本書で概要と判断を記載し、詳細は各ドキュメントへ委譲する。
24
+ ## 2. 位置づけ
25
25
 
26
- ## 2. 位置づけと用語定義(必要に応じて)
27
-
28
- | 用語 | 定義 |
29
- | -------------- | ---------------------------------------------------------------------------- |
30
- | 変更要求 | プロダクトまたは運用に対する変更の要望。起票済みの要求や課題を含む |
31
- | 影響対象データ | 変更要求の影響を受けるデータ項目、データモデル、データストア、データ連携項目 |
32
- | 変更要否 | 影響対象に対して変更が必要かどうかの判定 |
33
- | 影響度 | 影響の強さ。整合性、可用性、移行難易度、利用者影響を踏まえて評価する |
34
- | 対応方針 | 影響に対して採用する対処方針(実施、代替、見送りなど) |
35
- | 未解決事項 | 判断や実施に必要な情報が不足している課題 |
26
+ 業務影響をデータ構造・整合性・移行への影響に具体化する。波及先の詳細は I/F 仕様(`ifx-*`)、テスト仕様(`itc-*` 等)、運用設計(`opd-*`)へ委ね、「備考」に適用先カタログの対応する成果物 ID を示す。
36
27
 
37
28
  ## 3. ファイル命名・ID規則
38
29
 
39
- - 対象ドキュメント ID は `<project-id>:imp-data` とする(例: `prj-0001:imp-data`)。
40
- - 対象ドキュメントの推奨ファイル名は `imp-data.md` とする。
41
- - `id` は [id-and-file-naming-standard.md](../standards/id-and-file-naming-standard.md) の規則に従い、英小文字・数字・ハイフンで構成する。
42
- - 関連する追補文書を分割する場合は `<project-id>:imp-data-<term>` 形式を用いる。
30
+ - `local_id` は `imp-data`、Frontmatter の `id` は `<project-id>:imp-data`、推奨ファイル名は `imp-data.md` とする。
31
+ - 追補は `<project-id>:imp-data-<term>` とし、共通規則は [[specdojo:id-and-file-naming-standard|ID・ファイル命名標準]] に従う。
43
32
 
44
33
  ## 4. 推奨 Frontmatter 項目
45
34
 
46
- 影響調査(データ)ドキュメントでは、[document-metadata-standard.md](../standards/document-metadata-standard.md) に準拠し、以下を推奨する。
47
-
48
- | 項目 | 説明 | 必須 |
49
- | -------- | ---------------------------------------------- | ---- |
50
- | id | ドキュメント ID(例: `<project-id>:imp-data`) | ○ |
51
- | type | `project` | ○ |
52
- | status | `draft` / `ready` / `deprecated` | ○ |
53
- | rulebook | `specdojo:imp-data-rulebook` 固定 | ○ |
54
- | part_of | 一覧/親ドキュメントへの所属 ID 配列 | 任意 |
55
-
56
- | based_on | 変更要求や根拠資料の ID 配列 | 任意 |
57
- | supersedes | 置き換え対象ドキュメント ID 配列 | 任意 |
35
+ 共通項目・必須性・型制約は [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] に従う。`type` は `project`、`rulebook` は `specdojo:imp-data-rulebook` とする。`based_on` には直接の根拠とした作成済みの `<project-id>:imp-business` を必須とし、追加の根拠もカタログの `depends_on` の推移閉包内に限る。
58
36
 
59
37
  ## 5. 本文構成(標準テンプレ)
60
38
 
61
- 影響調査(データ)の本文は、以下の構成を標準とする。
39
+ 本文は次の6章を標準とする。
62
40
 
63
- | 章 | 見出し | 必須 | 目的 |
64
- | --- | -------------- | ---- | ---------------------------------------------- |
65
- | 1 | 目的と適用範囲 | ○ | 対象と判断対象範囲を明確化する |
66
- | 2 | 変更要求の概要 | ○ | 変更背景と要求内容を要約する |
67
- | 3 | 影響分析サマリ | ○ | 影響の全体像と優先順位を俯瞰する |
68
- | 4 | 影響詳細一覧 | ○ | 影響対象データごとの変更要否・影響度を記録する |
69
- | 5 | 対応方針 | ○ | 採用方針、実施条件、担当と期限を整理する |
70
- | 6 | 未解決事項 | ○ | 意思決定待ちや調査不足を明示する |
41
+ | 章 | 見出し | 必須 | 目的 |
42
+ | --- | -------------- | ---- | -------------------- |
43
+ | 1 | 目的と適用範囲 | ○ | 対象と判断範囲 |
44
+ | 2 | 変更要求の概要 | ○ | 背景・要求・成功条件 |
45
+ | 3 | 影響分析サマリ | ○ | 尺度・件数・優先対象 |
46
+ | 4 | 影響詳細一覧 | ○ | 対象別の判定と根拠 |
47
+ | 5 | 対応方針 | ○ | 実施条件と受入確認 |
48
+ | 6 | 未解決事項 | ○ | 論点と影響 |
71
49
 
72
50
  ## 6. 記述ガイド
73
51
 
74
52
  ### 6.1. 目的と適用範囲
75
53
 
76
- - 対象変更要求の識別子、対象データ領域、対象期間を明記する。
77
- - 「何を判断する文書か」を 2〜4 行で示す。
54
+ 変更要求の識別子、対象データ領域、対象期間、判断目的を示す。
78
55
 
79
56
  ### 6.2. 変更要求の概要
80
57
 
81
- - 変更の背景、狙い、成功条件を簡潔に記述する。
82
- - 要求詳細は原文を転記せず、判断に必要な要点のみを要約する。
58
+ 背景・要求・狙いと判定可能な成功条件を要約する(例: 移行前後の売上合計の差額0円)。
83
59
 
84
60
  ### 6.3. 影響分析サマリ
85
61
 
86
- - 高・中・低の影響度で件数を整理し、優先対応対象を明記する。
87
- - サマリで使用した評価観点(例: データ整合性、データ欠損リスク、移行影響、監査影響)を先に示す。
62
+ 整合性・可用性・移行難易度・利用者影響を次の尺度で評価し、最も高い判定を採る。許容停止時間など案件の境界値を先に示し、高・中・低の件数と優先対象をまとめる。
63
+
64
+ - 高: データ欠損・不整合、許容時間を超える停止、復旧不能な移行、代替不能な業務停止のいずれかがある。
65
+ - 中: 高に該当せず、補正・移行手順または利用者の操作変更が必要。
66
+ - 低: 高・中に該当せず、現行データと操作で継続可能。
88
67
 
89
68
  ### 6.4. 影響詳細一覧
90
69
 
91
- - 影響詳細は表形式で記載し、最低限次のカラムを含める。
70
+ 次の6列を必須とする。
71
+
72
+ | カラム | 内容 |
73
+ | -------------- | ---------------------------- |
74
+ | 影響対象データ | エンティティ、項目、格納先 |
75
+ | 変更要否 | `要` / `否` |
76
+ | 影響度 | `高` / `中` / `低` |
77
+ | 対応方針 | 実施・代替・見送りなどの方針 |
78
+ | 判断根拠 | 判定理由の要点 |
79
+ | 備考 | 制約、前提、関連ドキュメント |
92
80
 
93
- | カラム | 内容 |
94
- | -------------- | ---------------------------------------------------- |
95
- | 影響対象データ | 影響を受けるデータ対象(エンティティ、項目、格納先) |
96
- | 変更要否 | `要` / `否` |
97
- | 影響度 | `高` / `中` / `低` |
98
- | 対応方針 | 実施・代替・見送りなどの方針 |
99
- | 判断根拠 | 判定理由の要点 |
100
- | 備考 | 制約、前提、関連ドキュメント |
81
+ 「判断根拠」に構造・整合性、データ検証・移行テスト、実装変更への影響を必ず示す。影響なしも理由を残す。
101
82
 
102
83
  ### 6.5. 対応方針
103
84
 
104
- - 重要度が高い項目から順に、実施時期、担当、前提条件を記載する。
105
- - 見送りの場合は、再評価条件と時期を必ず記載する。
85
+ - 影響度順に実施時期・担当・前提条件を示す。見送りは再評価条件と時期を付す。
86
+ - 受入確認では業務影響の各対象を「影響詳細一覧」と照合し、欠落がなく、各判定の根拠・対応と、データ検証・移行テストの確認手順・合格条件が特定できることを確認する。
106
87
 
107
88
  ### 6.6. 未解決事項
108
89
 
109
- - 各項目に「論点」「不足情報」「決定期限」「担当」を記載する。
110
- - 未解決事項は放置せず、次回レビューでの処理方針を記録する。
90
+ 論点・不足情報・判断や対応への影響・当面の扱いを示す。なければ「なし」とする。
111
91
 
112
92
  ## 7. 禁止事項
113
93
 
114
94
  - 実装詳細(SQL 全文、クラス名、API リクエスト構造)を記載しない。
115
- - 「影響あり」「要対応」のみで根拠を記載しない。
116
-
117
- - 影響度の尺度を定義せずに高・中・低を混在させない。
118
- - 未解決事項に期限や担当を設定せずに放置しない。
119
- - 他ドキュメントの本文を重複転記し、参照元との不整合を生む記述をしない。
95
+ - 「影響あり」「要対応」だけで判定を済ませない。
96
+ - 「影響分析サマリ」の尺度と異なる判定を混在させない。
@@ -13,51 +13,32 @@ specdojo:
13
13
 
14
14
  Impact Analysis (Interface) Rulebook
15
15
 
16
- 本ドキュメントは、変更要求がインターフェースへ与える影響を整理するための「影響調査(I/F)」の記述ルールを定義します。プロジェクト関係者が変更要否・影響度・対応方針・未解決事項を同じ粒度で判断できる状態を目標とします。
16
+ 変更要求による I/F への影響を整理し、変更要否・影響度・対応方針・未解決事項を判断するための記述基準を定めます。
17
17
 
18
18
  ## 1. 全体方針
19
19
 
20
- - 対象は「変更要求によるインターフェース影響の把握と判断」であり、詳細な実装仕様の設計は扱わない。
21
- - 記載粒度は「I/F 責任者とプロジェクト管理者が合意形成できるレベル」とし、影響の有無だけでなく、判断根拠を簡潔に残す。
22
- - 1 ドキュメントで複数の連携方式を扱ってよいが、影響詳細は I/F 単位で分割して管理する。
23
- - データ仕様、テスト仕様、運用手順への波及がある場合は、本書で概要と判断を記載し、詳細は各ドキュメントへ委譲する。
20
+ - I/F 責任者とプロジェクト管理者が合意できる粒度で、影響と判断根拠を記載する。
21
+ - 複数の連携方式を扱う場合も影響詳細は I/F 単位とする。データ仕様・テスト仕様・運用手順への波及は概要と判断を示し、詳細は各文書へ委ねる。
22
+ - **共通の運用**: 役割は適用先のメンバー定義、`status`・承認・改訂と廃止・未決事項の引き継ぎは [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] に従う。文書の整形・lint はリポジトリの検証で扱う。
24
23
 
25
- ## 2. 位置づけと用語定義(必要に応じて)
24
+ ## 2. 位置づけ
26
25
 
27
- | 用語 | 定義 |
28
- | ----------- | -------------------------------------------------------------------- |
29
- | 変更要求 | プロダクトまたは運用に対する変更の要望。起票済みの要求や課題を含む |
30
- | 影響対象I/F | 変更要求の影響を受ける API、ファイル連携、メッセージ連携、通知連携 |
31
- | 変更要否 | 影響対象に対して変更が必要かどうかの判定 |
32
- | 影響度 | 影響の強さ。契約変更、互換性、障害波及、利用者影響を踏まえて評価する |
33
- | 対応方針 | 影響に対して採用する対処方針(実施、代替、見送りなど) |
34
- | 未解決事項 | 判断や実施に必要な情報が不足している課題 |
26
+ 起票済みの要求・課題を含む変更要求を受け、連携先との契約・互換性・障害波及・利用者への影響を判断する。詳細な実装設計は扱わない。
35
27
 
36
28
  ## 3. ファイル命名・ID規則
37
29
 
38
30
  - 対象ドキュメント ID は `<project-id>:imp-interface` とする(例: `prj-0001:imp-interface`)。
39
- - 対象ドキュメントの推奨ファイル名は `imp-interface.md` とする。
40
- - `id` は [id-and-file-naming-standard.md](../standards/id-and-file-naming-standard.md) の規則に従い、英小文字・数字・ハイフンで構成する。
31
+ - 推奨配置は `docs/ja/projects/<project-id>/050-impact-analysis/imp-interface.md` とし、適用先の成果物カタログに合わせる。
32
+ - 命名の共通規則は [[specdojo:id-and-file-naming-standard|ID・ファイル命名標準]] に従う。
41
33
  - 関連する追補文書を分割する場合は `<project-id>:imp-interface-<term>` 形式を用いる。
42
34
 
43
35
  ## 4. 推奨 Frontmatter 項目
44
36
 
45
- 影響調査(I/F)ドキュメントでは、[document-metadata-standard.md](../standards/document-metadata-standard.md) に準拠し、以下を推奨する。
46
-
47
- | 項目 | 説明 | 必須 |
48
-
49
- | ---------- | ---------------------------------------------------- | ---- |
50
- | id | ドキュメント ID(例: `<project-id>:imp-interface`) | ○ |
51
- | type | `project` | ○ |
52
- | status | `draft` / `ready` / `deprecated` | ○ |
53
- | rulebook | `specdojo:imp-interface-rulebook` 固定 | ○ |
54
- | part_of | 一覧/親ドキュメントへの所属 ID 配列 | 任意 |
55
- | based_on | 変更要求や根拠資料の ID 配列 | 任意 |
56
- | supersedes | 置き換え対象ドキュメント ID 配列 | 任意 |
37
+ 共通項目・必須性・型制約は [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] に従う。`type` は `project`、`rulebook` は `specdojo:imp-interface-rulebook` とする。
57
38
 
58
39
  ## 5. 本文構成(標準テンプレ)
59
40
 
60
- 影響調査(I/F)の本文は、以下の構成を標準とする。
41
+ 本文は次の6章を標準とする。
61
42
 
62
43
  | 章 | 見出し | 必須 | 目的 |
63
44
  | --- | -------------- | ---- | --------------------------------------------- |
@@ -77,17 +58,15 @@ Impact Analysis (Interface) Rulebook
77
58
 
78
59
  ### 6.2. 変更要求の概要
79
60
 
80
- - 変更の背景、狙い、成功条件を簡潔に記述する。
81
- - 要求詳細は原文を転記せず、判断に必要な要点のみを要約する。
61
+ - 変更の背景・狙い・成功条件を示す。要求詳細は判断に必要な要点に絞る。
82
62
 
83
63
  ### 6.3. 影響分析サマリ
84
64
 
85
- - 高・中・低の影響度で件数を整理し、優先対応対象を明記する。
86
- - サマリで使用した評価観点(例: 契約互換性、接続先調整、障害影響、監査影響)を先に示す。
65
+ - 契約互換性、接続先調整、障害・利用者・監査への影響などの評価観点と、高・中・低を分ける尺度を先に定義し、件数と優先対応対象を示す。
87
66
 
88
67
  ### 6.4. 影響詳細一覧
89
68
 
90
- - 影響詳細は表形式で記載し、最低限次のカラムを含める。
69
+ - 影響詳細は表形式で、次の6列を必須とする。
91
70
 
92
71
  | カラム | 内容 |
93
72
  | ----------- | ------------------------------------------------------ |
@@ -105,13 +84,10 @@ Impact Analysis (Interface) Rulebook
105
84
 
106
85
  ### 6.6. 未解決事項
107
86
 
108
- - 各項目に「論点」「不足情報」「決定期限」「担当」を記載する。
109
- - 未解決事項は放置せず、次回レビューでの処理方針を記録する。
87
+ - 論点、不足情報、判断・対応への影響と当面の扱いを記載する。未解決事項がなければ「なし」とする。
110
88
 
111
89
  ## 7. 禁止事項
112
90
 
113
91
  - 実装詳細(SQL 全文、クラス名、API リクエスト構造)を記載しない。
114
92
  - 「影響あり」「要対応」のみで根拠を記載しない。
115
93
  - 影響度の尺度を定義せずに高・中・低を混在させない。
116
- - 未解決事項に期限や担当を設定せずに放置しない。
117
- - 他ドキュメントの本文を重複転記し、参照元との不整合を生む記述をしない。
@@ -4,99 +4,76 @@ specdojo:
4
4
  type: rulebook
5
5
  deliverable_type: project
6
6
  status: draft
7
- recipe: undecided
7
+ recipe: not-needed
8
8
  sample: specdojo:imp-operations-sample
9
- template: undecided
9
+ template: not-needed
10
10
  ---
11
11
 
12
12
  # 影響調査(運用)作成ルール
13
13
 
14
14
  Impact Analysis (Operations) Rulebook
15
15
 
16
- 本ドキュメントは、変更要求が運用へ与える影響を整理するための「影響調査(運用)」の記述ルールを定義します。プロジェクト関係者が変更要否・影響度・対応方針・未解決事項を同じ粒度で判断できる状態を目標とします。
16
+ 変更要求による運用への影響を整理し、変更要否・影響度・対応方針を判断する基準を定めます。
17
17
 
18
18
  ## 1. 全体方針
19
19
 
20
- - 対象は「変更要求による運用影響の把握と判断」であり、実運用手順の詳細化は扱わない。
21
- - 記載粒度は「運用責任者とプロジェクト管理者が合意形成できるレベル」とし、影響の有無だけでなく、判断根拠を簡潔に残す。
22
- - 1 ドキュメントで複数の運用領域を扱ってよいが、影響詳細は運用対象単位で分割して管理する。
23
- - データ変更、I/F 変更、テスト計画への波及がある場合は、本書で概要と判断を記載し、詳細は各ドキュメントへ委譲する。
20
+ - 運用責任者とプロジェクト管理者が合意できる粒度で、影響と判断根拠を記載する。
21
+ - 複数領域を扱う場合も影響詳細は運用対象単位とし、実運用手順の詳細化は扱わない。
22
+ - 標準6章・6列と sample で記入形式が定まるため、別の作成手順・雛形は不要とし、`recipe`・`template` は `not-needed` とする。
23
+ - **共通の運用**: 役割は適用先のメンバー定義、`status`・承認・改訂と廃止・未決事項の引き継ぎは [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] に従う。文書の整形・lint はリポジトリの検証で扱う。
24
24
 
25
- ## 2. 位置づけと用語定義(必要に応じて)
25
+ ## 2. 位置づけ
26
26
 
27
- | 用語 | 定義 |
28
- | ------------ | -------------------------------------------------------------------------- |
29
- | 変更要求 | プロダクトまたは運用に対する変更の要望。起票済みの要求や課題を含む |
30
- | 影響対象運用 | 変更要求の影響を受ける監視、アラート、手順、体制、運用統制、SLA 運用 |
31
- | 変更要否 | 影響対象に対して変更が必要かどうかの判定 |
32
- | 影響度 | 影響の強さ。運用品質、障害対応力、継続運用性、利用者影響を踏まえて評価する |
33
-
34
- | 対応方針 | 影響に対して採用する対処方針(実施、代替、見送りなど) |
35
- | 未解決事項 | 判断や実施に必要な情報が不足している課題 |
27
+ 波及の概要と判断は本書に残し、詳細はデータ仕様(`bdd-*`)、I/F 仕様(`ifx-*`)、テスト戦略・方針(`tsp-index`)などへ委譲する。「備考」に適用先カタログの対応する成果物 ID を示す。
36
28
 
37
29
  ## 3. ファイル命名・ID規則
38
30
 
39
- - 対象ドキュメント ID は `<project-id>:imp-operations` とする(例: `prj-0001:imp-operations`)。
40
- - 対象ドキュメントの推奨ファイル名は `imp-operations.md` とする。
41
- - `id` は [id-and-file-naming-standard.md](../standards/id-and-file-naming-standard.md) の規則に従い、英小文字・数字・ハイフンで構成する。
42
- - 関連する追補文書を分割する場合は `<project-id>:imp-operations-<term>` 形式を用いる。
31
+ - 文書 ID は `<project-id>:imp-operations`、推奨ファイル名は `imp-operations.md` とする。
32
+ - 追補は `<project-id>:imp-operations-<term>` とし、共通規則は [[specdojo:id-and-file-naming-standard|ID・ファイル命名標準]] に従う。
43
33
 
44
34
  ## 4. 推奨 Frontmatter 項目
45
35
 
46
- 影響調査(運用)ドキュメントでは、[document-metadata-standard.md](../standards/document-metadata-standard.md) に準拠し、以下を推奨する。
47
-
48
- | 項目 | 説明 | 必須 |
49
- | ---------- | ---------------------------------------------------- | ---- |
50
- | id | ドキュメント ID(例: `<project-id>:imp-operations`) | ○ |
51
- | type | `project` | ○ |
52
- | status | `draft` / `ready` / `deprecated` | ○ |
53
- | rulebook | `specdojo:imp-operations-rulebook` 固定 | ○ |
54
- | part_of | 一覧/親ドキュメントへの所属 ID 配列 | 任意 |
55
- | based_on | 変更要求や根拠資料の ID 配列 | 任意 |
56
- | supersedes | 置き換え対象ドキュメント ID 配列 | 任意 |
36
+ 共通項目・必須性・型制約は [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] に従う。`type` は `project`、`rulebook` は `specdojo:imp-operations-rulebook` とする。`based_on` は直接の根拠とした変更要求や資料の ID を記載する任意項目とする。
57
37
 
58
38
  ## 5. 本文構成(標準テンプレ)
59
39
 
60
- 影響調査(運用)の本文は、以下の構成を標準とする。
40
+ 本文は次の6章を標準とする。
61
41
 
62
- | 章 | 見出し | 必須 | 目的 |
63
- | --- | -------------- | ---- | -------------------------------------------- |
64
- | 1 | 目的と適用範囲 | ○ | 対象と判断対象範囲を明確化する |
65
- | 2 | 変更要求の概要 | ○ | 変更背景と要求内容を要約する |
66
- | 3 | 影響分析サマリ | ○ | 影響の全体像と優先順位を俯瞰する |
67
- | 4 | 影響詳細一覧 | ○ | 影響対象運用ごとの変更要否・影響度を記録する |
68
- | 5 | 対応方針 | ○ | 採用方針、実施条件、担当と期限を整理する |
69
- | 6 | 未解決事項 | ○ | 意思決定待ちや調査不足を明示する |
42
+ | 章 | 見出し | 必須 | 目的 |
43
+ | --- | -------------- | ---- | -------------------- |
44
+ | 1 | 目的と適用範囲 | ○ | 対象と判断範囲 |
45
+ | 2 | 変更要求の概要 | ○ | 背景・要求・成功条件 |
46
+ | 3 | 影響分析サマリ | ○ | 尺度・件数・優先対象 |
47
+ | 4 | 影響詳細一覧 | ○ | 対象別の判定と根拠 |
48
+ | 5 | 対応方針 | ○ | 実施条件・担当・時期 |
49
+ | 6 | 未解決事項 | ○ | 論点・不足情報・影響 |
70
50
 
71
51
  ## 6. 記述ガイド
72
52
 
73
53
  ### 6.1. 目的と適用範囲
74
54
 
75
- - 対象変更要求の識別子、対象運用領域、対象期間を明記する。
76
- - 「何を判断する文書か」を 2〜4 行で示す。
55
+ 変更要求の識別子、対象運用領域、対象期間、判断目的を示す。
77
56
 
78
57
  ### 6.2. 変更要求の概要
79
58
 
80
- - 変更の背景、狙い、成功条件を簡潔に記述する。
81
- - 要求詳細は原文を転記せず、判断に必要な要点のみを要約する。
59
+ 背景・要求・狙いと成功条件を判断に必要な要点に絞って要約する。
82
60
 
83
61
  ### 6.3. 影響分析サマリ
84
62
 
85
- - 高・中・低の影響度で件数を整理し、優先対応対象を明記する。
86
- - サマリで使用した評価観点(例: 監視体制、障害初動、運用負荷、統制・監査影響)を先に示す。
63
+ 運用品質・障害対応力・継続運用性・利用者影響の評価観点と高・中・低の尺度を先に示し、件数と優先対象をまとめる。監視体制、障害初動、運用負荷、統制・監査への影響を検討する。
87
64
 
88
65
  ### 6.4. 影響詳細一覧
89
66
 
90
- - 影響詳細は表形式で記載し、最低限次のカラムを含める。
67
+ 影響詳細は次の6列を含む表とする。
91
68
 
92
- | カラム | 内容 |
93
- | ------------ | -------------------------------------------------- |
94
- | 影響対象運用 | 影響を受ける運用対象(監視、手順、体制、統制など) |
95
- | 変更要否 | `要` / `否` |
96
- | 影響度 | `高` / `中` / `低` |
97
- | 対応方針 | 実施・代替・見送りなどの方針 |
98
- | 判断根拠 | 判定理由の要点 |
99
- | 備考 | 制約、前提、関連ドキュメント |
69
+ | カラム | 内容 |
70
+ | ------------ | ---------------------------------------------- |
71
+ | 影響対象運用 | 監視・アラート・手順・体制・統制・SLA 運用など |
72
+ | 変更要否 | `要` / `否` |
73
+ | 影響度 | `高` / `中` / `低` |
74
+ | 対応方針 | 実施・代替・見送りなどの方針 |
75
+ | 判断根拠 | 判定理由の要点 |
76
+ | 備考 | 制約、前提、関連ドキュメント |
100
77
 
101
78
  ### 6.5. 対応方針
102
79
 
@@ -105,13 +82,9 @@ Impact Analysis (Operations) Rulebook
105
82
 
106
83
  ### 6.6. 未解決事項
107
84
 
108
- - 各項目に「論点」「不足情報」「決定期限」「担当」を記載する。
109
- - 未解決事項は放置せず、次回レビューでの処理方針を記録する。
85
+ 論点、不足情報、運用判断への影響と当面の扱いを記載する。
110
86
 
111
87
  ## 7. 禁止事項
112
88
 
113
- - 実装詳細(SQL 全文、クラス名、API リクエスト構造)を記載しない。
114
89
  - 「影響あり」「要対応」のみで根拠を記載しない。
115
90
  - 影響度の尺度を定義せずに高・中・低を混在させない。
116
- - 未解決事項に期限や担当を設定せずに放置しない。
117
- - 他ドキュメントの本文を重複転記し、参照元との不整合を生む記述をしない。
@@ -13,50 +13,31 @@ specdojo:
13
13
 
14
14
  Impact Analysis (Test) Rulebook
15
15
 
16
- 本ドキュメントは、変更要求がテストへ与える影響を整理するための「影響調査(テスト)」の記述ルールを定義します。プロジェクト関係者が変更要否・影響度・対応方針・未解決事項を同じ粒度で判断できる状態を目標とします。
16
+ 変更要求によるテストへの影響を整理し、変更要否・影響度・対応方針・未解決事項を判断する記述基準を定めます。
17
17
 
18
18
  ## 1. 全体方針
19
19
 
20
- - 対象は「変更要求によるテスト影響の把握と判断」であり、個別テスト手順の詳細設計は扱わない。
21
- - 記載粒度は「テスト責任者とプロジェクト管理者が合意形成できるレベル」とし、影響の有無だけでなく、判断根拠を簡潔に残す。
22
- - 1 ドキュメントで複数のテストレベルを扱ってよいが、影響詳細はテスト対象単位で分割して管理する。
23
- - 仕様変更、I/F 変更、運用変更への波及がある場合は、本書で概要と判断を記載し、詳細は各ドキュメントへ委譲する。
20
+ - テスト責任者とプロジェクト管理者が合意できる粒度で影響と根拠を示す。
21
+ - 複数のテストレベルを扱う場合も影響詳細はテスト対象単位とする。仕様・I/F・運用への波及は概要と判断を示し、詳細は各仕様へ委ねる。
22
+ - **共通の運用**: 役割は適用先のメンバー定義、`status`・承認・改訂と廃止・未決事項の引き継ぎは [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] に従う。文書の整形・lint はリポジトリの検証で扱う。
24
23
 
25
- ## 2. 位置づけと用語定義(必要に応じて)
24
+ ## 2. 位置づけ
26
25
 
27
- | 用語 | 定義 |
28
- | -------------- | -------------------------------------------------------------------------- |
29
- | 変更要求 | プロダクトまたは運用に対する変更の要望。起票済みの要求や課題を含む |
30
- | 影響対象テスト | 変更要求の影響を受けるテスト観点、テスト条件、テストケース、判定基準 |
31
- | 変更要否 | 影響対象に対して変更が必要かどうかの判定 |
32
- | 影響度 | 影響の強さ。品質リスク、検証網羅性、実行コスト、納期影響を踏まえて評価する |
33
- | 対応方針 | 影響に対して採用する対処方針(実施、代替、見送りなど) |
34
- | 未解決事項 | 判断や実施に必要な情報が不足している課題 |
26
+ 起票済みの要求・課題を含む変更要求を受け、テスト観点・条件・ケース・判定基準への影響を判断する。個別テスト手順の詳細設計は扱わない。
35
27
 
36
28
  ## 3. ファイル命名・ID規則
37
29
 
38
- - 対象ドキュメント ID は `<project-id>:imp-test` とする(例: `prj-0001:imp-test`)。
39
- - 対象ドキュメントの推奨ファイル名は `imp-test.md` とする。
40
- - `id` は [id-and-file-naming-standard.md](../standards/id-and-file-naming-standard.md) の規則に従い、英小文字・数字・ハイフンで構成する。
41
- - 関連する追補文書を分割する場合は `<project-id>:imp-test-<term>` 形式を用いる。
30
+ - 文書 ID は `<project-id>:imp-test`、推奨ファイル名は `imp-test.md` とする。
31
+ - 命名の共通規則は [[specdojo:id-and-file-naming-standard|ID・ファイル命名標準]] に従う。
32
+ - 追補文書は `<project-id>:imp-test-<term>` とする。
42
33
 
43
34
  ## 4. 推奨 Frontmatter 項目
44
35
 
45
- 影響調査(テスト)ドキュメントでは、[document-metadata-standard.md](../standards/document-metadata-standard.md) に準拠し、以下を推奨する。
46
-
47
- | 項目 | 説明 | 必須 |
48
- | ---------- | ---------------------------------------------- | ---- |
49
- | id | ドキュメント ID(例: `<project-id>:imp-test`) | ○ |
50
- | type | `project` | ○ |
51
- | status | `draft` / `ready` / `deprecated` | ○ |
52
- | rulebook | `specdojo:imp-test-rulebook` 固定 | ○ |
53
- | part_of | 一覧/親ドキュメントへの所属 ID 配列 | 任意 |
54
- | based_on | 変更要求や根拠資料の ID 配列 | 任意 |
55
- | supersedes | 置き換え対象ドキュメント ID 配列 | 任意 |
36
+ 共通項目・必須性・型制約は [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] に従う。`type` は `project`、`rulebook` は `specdojo:imp-test-rulebook` とする。
56
37
 
57
38
  ## 5. 本文構成(標準テンプレ)
58
39
 
59
- 影響調査(テスト)の本文は、以下の構成を標準とする。
40
+ 本文は次の6章を標準とする。
60
41
 
61
42
  | 章 | 見出し | 必須 | 目的 |
62
43
  | --- | -------------- | ---- | ---------------------------------------------- |
@@ -76,42 +57,38 @@ Impact Analysis (Test) Rulebook
76
57
 
77
58
  ### 6.2. 変更要求の概要
78
59
 
79
- - 変更の背景、狙い、成功条件を簡潔に記述する。
80
- - 要求詳細は原文を転記せず、判断に必要な要点のみを要約する。
60
+ - 背景・狙いと要求の要点を示す。成功条件は指標と閾値、または達成状態に加え、確認対象・判定方法を記載する。
81
61
 
82
62
  ### 6.3. 影響分析サマリ
83
63
 
84
- - 高・中・低の影響度で件数を整理し、優先対応対象を明記する。
85
- - サマリで使用した評価観点(例: 欠陥流出リスク、回帰範囲、テスト工数、検証環境影響)を先に示す。
64
+ - 欠陥流出リスク・検証網羅性・実行コスト・納期など、採用する評価観点ごとに高・中・低を分ける条件(数値の境界または状態)を先に定義する。
65
+ - 複数観点で判定が分かれる場合の集約規則(例: 最も高い影響度を採用)を定め、同じ規則で件数を集計する。
66
+ - 優先対応対象を明記し、同じ影響度で順序を分ける場合は理由を添える。
86
67
 
87
68
  ### 6.4. 影響詳細一覧
88
69
 
89
- - 影響詳細は表形式で記載し、最低限次のカラムを含める。
70
+ - 表形式で次の6列を必須とする。
90
71
 
91
- | カラム | 内容 |
92
- | -------------- | ---------------------------------------------- |
93
- | 影響対象テスト | 影響を受けるテスト対象(レベル、観点、ケース) |
94
- | 変更要否 | `要` / `否` |
95
- | 影響度 | `高` / `中` / `低` |
96
- | 対応方針 | 実施・代替・見送りなどの方針 |
97
- | 判断根拠 | 判定理由の要点 |
98
- | 備考 | 制約、前提、関連ドキュメント |
72
+ | カラム | 内容 |
73
+ | -------------- | -------------------------------------------------------------- |
74
+ | 影響対象テスト | 影響を受けるテスト対象(レベル、観点、条件、ケース、判定基準) |
75
+ | 変更要否 | `要` / `否` |
76
+ | 影響度 | `高` / `中` / `低` |
77
+ | 対応方針 | 実施・代替・見送りなどの方針 |
78
+ | 判断根拠 | 変更要否の理由、評価観点ごとの事実と尺度・集約規則の適用結果 |
79
+ | 備考 | 制約、前提、関連ドキュメント |
99
80
 
100
81
  ### 6.5. 対応方針
101
82
 
102
- - 重要度が高い項目から順に、実施時期、担当、前提条件を記載する。
83
+ - 影響度の高い順に、実施時期、担当、前提条件を記載する。
103
84
  - 見送りの場合は、再評価条件と時期を必ず記載する。
85
+ - 受入確認では「変更要求の概要」の成功条件に判定方法を適用し、全条件の達成を合格とする。未達は影響対象と対応方針へ戻す。
104
86
 
105
87
  ### 6.6. 未解決事項
106
88
 
107
- - 各項目に「論点」「不足情報」「決定期限」「担当」を記載する。
108
- - 未解決事項は放置せず、次回レビューでの処理方針を記録する。
89
+ - 論点、不足情報、判断・対応への影響と当面の扱いを記載する。該当がなければ「なし」とする。
109
90
 
110
91
  ## 7. 禁止事項
111
92
 
112
- - 実装詳細(SQL 全文、クラス名、API リクエスト構造)を記載しない。
113
93
  - 「影響あり」「要対応」のみで根拠を記載しない。
114
-
115
94
  - 影響度の尺度を定義せずに高・中・低を混在させない。
116
- - 未解決事項に期限や担当を設定せずに放置しない。
117
- - 他ドキュメントの本文を重複転記し、参照元との不整合を生む記述をしない。