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,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
- - 対象ドキュメント ID は `imp-interface` とする。
39
- - 対象ドキュメントの推奨ファイル名は `imp-interface.md` とする。
40
- - `id` は [id-and-file-naming-standard.md](../standards/id-and-file-naming-standard.md) の規則に従い、英小文字・数字・ハイフンで構成する。
41
- - 関連する追補文書を分割する場合は `imp-interface-<term>` 形式を用いる。
30
+ - 対象ドキュメント ID は `<project-id>:imp-interface` とする(例: `prj-0001:imp-interface`)。
31
+ - 推奨配置は `docs/ja/projects/<project-id>/050-impact-analysis/imp-interface.md` とし、適用先の成果物カタログに合わせる。
32
+ - 命名の共通規則は [[specdojo:id-and-file-naming-standard|ID・ファイル命名標準]] に従う。
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(例: `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 は `imp-operations` とする。
40
- - 対象ドキュメントの推奨ファイル名は `imp-operations.md` とする。
41
- - `id` は [id-and-file-naming-standard.md](../standards/id-and-file-naming-standard.md) の規則に従い、英小文字・数字・ハイフンで構成する。
42
- - 関連する追補文書を分割する場合は `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(例: `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 は `imp-test` とする。
39
- - 対象ドキュメントの推奨ファイル名は `imp-test.md` とする。
40
- - `id` は [id-and-file-naming-standard.md](../standards/id-and-file-naming-standard.md) の規則に従い、英小文字・数字・ハイフンで構成する。
41
- - 関連する追補文書を分割する場合は `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(例: `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
- - 他ドキュメントの本文を重複転記し、参照元との不整合を生む記述をしない。