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,51 +13,41 @@ specdojo:
13
13
 
14
14
  Technology Stack Index (TSD Index) Documentation Rules
15
15
 
16
- `tsd-index.md` は、対象システムや開発基盤で採用する技術と担当責務を一覧にし、詳細な構成・設定の正本へ導く入口文書である。技術の用途と適用範囲を俯瞰し、構築、実装、運用、変更時に参照すべき定義を判断できる内容を記載する。
16
+ `tsd-index.md` は、採用技術と担当責務を俯瞰し、構築・実装・運用・変更時に詳細な構成や設定の正本へ導く入口文書である。
17
17
 
18
18
  ## 1. 全体方針
19
19
 
20
- - 一つのシステムまたは合意した対象範囲につき、技術一覧の正本を一つにする。複数システムを扱う場合は、一覧の対象範囲を明示する。
21
- - 採用技術の名称、区分、担当責務を一覧で対応させる。実行基盤だけでなく、対象範囲に含まれる開発、検証、文書化、配布、運用の技術も扱う。
22
- - すべての依存パッケージを列挙するのではなく、構成や作業の前提として関係者が把握すべき技術を選ぶ。
23
- - 採用済みの必須構成と任意利用の構成を区別する。未決の候補は採用技術に混ぜず、判断の記録へ導く。
24
- - 詳細な設定、構築手順、接続方法、資源制約は `tsd-<term>` または設定ファイルなどの正本へ委ねる。
25
- - 版の粒度と参照元を明確にし、lockfile や詳細 TSD と異なる固定値を二重管理しない。
20
+ - 合意した対象範囲につき一覧の正本を一つにする。複数システムの場合も範囲を明示する。
21
+ - 全依存パッケージではなく、構成や作業の前提として把握すべき技術を選ぶ。網羅範囲は「区分と網羅範囲」に従う。
22
+ - 詳細な設定・手順・資源制約は「位置づけ」の正本に委ね、版や採用状態は「版と採用状態」に従う。
23
+ - **共通の運用**: 役割は適用先のメンバー定義、`status`・承認・改訂と廃止・未決事項の引き継ぎは [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] に従う。整形・lint はリポジトリの検証で扱い、業務の受入確認に含めない。
26
24
 
27
25
  ## 2. 位置づけ
28
26
 
29
- | 文書・情報 | 役割 | 一覧からの導線 |
30
- | ------------------------ | ------------------------------------ | ------------------------------------------ |
31
- | `tsd-index` | 採用技術と担当責務の全体一覧 | 対象範囲の技術を俯瞰する入口とする |
32
- | `tsd-<term>` | 技術領域や実行基盤の詳細定義 | 構成、前提、設定、導入、動作確認を参照する |
33
- | 接続設定・日常利用の TSD | 基盤を利用するクライアント設定や操作 | 初期構築と利用時の手順を区別して導く |
34
- | 設定ファイル・依存定義 | 実際に適用する版や設定の正本 | 正確な版や有効設定が必要な場合に参照する |
35
- | 採用判断の記録 | 技術を選んだ理由と未決事項 | 一覧で説明しきれない判断の根拠へ導く |
27
+ | 文書・情報 | 役割 | 一覧からの導線 |
28
+ | ------------------------ | ------------------------ | -------------------------------- |
29
+ | `tsd-index` | 採用技術と担当責務の一覧 | 対象範囲を俯瞰する入口 |
30
+ | `tsd-<term>` | 技術領域・実行基盤の詳細 | 構成・前提・設定・導入・動作確認 |
31
+ | 接続設定・日常利用の TSD | クライアント設定や操作 | 初期構築と利用手順を区別する |
32
+ | 設定ファイル・依存定義 | 適用する版・設定の正本 | 正確な版・有効設定 |
33
+ | 採用判断の記録 | 選定理由と未決事項 | 一覧で説明しきれない判断の根拠 |
36
34
 
37
- - 詳細 TSD が未作成でも、採用が確認できた技術と担当責務は一覧に記載してよい。未整備の詳細文書を存在するように参照しない。
38
- - 一つの技術に基盤設定と接続設定など複数の詳細文書がある場合は、参照先ごとの役割を示す。
39
- - 同じ技術を複数の用途で使う場合は、責務を一行にまとめるか、適用範囲を明示して行を分ける。説明のない重複は作らない。
35
+ - 詳細 TSD が未作成でも、採用を確認できた技術と責務は記載できる。
36
+ - 同じ技術の複数用途は責務を一行にまとめるか、適用範囲で行を分ける。
40
37
 
41
38
  ## 3. ファイル命名・ID規則
42
39
 
43
40
  - ファイル名は `tsd-index.md` とする。
44
- - `id` は `tsd-index` を基準に、名前空間と対象範囲内の一意性を共通のメタデータ規約に従って定める。
45
- - 配置先はプロジェクトのアーキテクチャまたは技術基盤の文書群とし、詳細な `tsd-<term>.md` も同じ文書群にまとめる。
46
- - 環境や領域ごとの補足を分冊する場合も、全体一覧の正本を複製せず、本書から参照する。
41
+ - `id` は `tsd-index` を基準とし、名前空間と一意性は共通のメタデータ規約に従う。
42
+ - アーキテクチャまたは技術基盤の文書群に詳細な `tsd-<term>.md` とまとめる。環境・領域別の補足は一覧を複製せず参照する。
47
43
 
48
44
  ## 4. 推奨 Frontmatter 項目
49
45
 
50
- 項目は `specdojo` 配下に置く。共通の型と参照形式は [document-metadata-standard.md](../standards/document-metadata-standard.md) と成果物の Frontmatter スキーマに従う。
46
+ 共通項目・必須性・型は [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] と成果物の Frontmatter スキーマに従う。
51
47
 
52
- | 項目 | 必須 | 値・記述内容 |
53
- | ------------ | -------- | -------------------------------------------------- |
54
- | `id` | ○ | 対象範囲で一意な `tsd-index` 系の ID |
55
- | `type` | ○ | `architecture` |
56
- | `status` | ○ | `draft` / `ready` / `deprecated` |
57
- | `rulebook` | 推奨 | `specdojo:tsd-index-rulebook` |
58
- | `part_of` | 任意 | 所属するアーキテクチャ文書などの ID 配列 |
59
- | `based_on` | 条件付き | 技術構成の直接の根拠となる設計や採用判断の ID 配列 |
60
- | `supersedes` | 条件付き | 既存の技術一覧を置き換える場合の旧文書 ID 配列 |
48
+ - `type` は `architecture`、`rulebook` は `specdojo:tsd-index-rulebook` とする。
49
+ - `part_of` は任意で、所属するアーキテクチャ文書の ID 配列を記す。
50
+ - `based_on` は直接の根拠となる設計・採用判断、`supersedes` は置き換える旧一覧がある場合に ID 配列で記す。
61
51
 
62
52
  ## 5. 本文要件
63
53
 
@@ -67,9 +57,9 @@ Technology Stack Index (TSD Index) Documentation Rules
67
57
  | 技術スタック一覧 | ○ | 区分、採用技術、担当責務を一つの主一覧表で対応させる |
68
58
  | 補足・詳細への導線 | 条件付き | 詳細 TSD や設定の正本がある場合、各参照先の役割と適用条件を示す |
69
59
 
70
- - 実行時に使う技術と、開発・検証・運用に使う技術の範囲が分かるようにする。対象外の領域まで空欄や仮の技術で埋めない。
71
- - 版、利用環境、必須・任意が判断に必要な場合は、一覧の列または補足に記載する。
72
- - 補足では全体の共通条件と参照先を示し、設定値や手順の詳細を転載しない。
60
+ - 対象外の領域を空欄や仮の技術で埋めない。
61
+ - 版・利用環境・必須と任意の違いは、判断に必要な場合に列または補足で示す。
62
+ - 補足には全体の共通条件と参照先を記す。
73
63
 
74
64
  ## 6. 記述ガイド
75
65
 
@@ -84,28 +74,28 @@ Technology Stack Index (TSD Index) Documentation Rules
84
74
  | 適用範囲 | 条件付き | 対象環境、実行場所、必須・任意など、利用条件の違い |
85
75
  | 詳細・備考 | 任意 | 詳細 TSD への参照、短い制約や選定理由 |
86
76
 
87
- - 担当責務は「開発用」「利用する」だけで終えず、対象と役割を一文で示す。
88
- - 複数の製品を一つの実行基盤としてまとめる場合は、構成の内訳と各役割を詳細 TSD へ導く。
77
+ - 担当責務は対象と役割を一文で示す。「開発用」「利用する」だけにしない。
78
+ - 複数製品を実行基盤としてまとめる場合は、内訳と各役割を詳細 TSD へ導く。
89
79
  - 版を採用技術名に含める場合は、別の版列で同じ情報を繰り返さない。
90
80
 
91
81
  ### 6.2. 区分と網羅範囲
92
82
 
93
- - 言語・ランタイム・フレームワーク、データ保存・連携、ホスティング・ネットワークなど、対象の実行に必要な技術を確認する。
94
- - build・テスト・静的検査・文書化・図解・ソース管理・CI/CD・パッケージ配布・運用監視など、対象の開発と保守を支える技術も確認する。
95
- - AI 実行環境やローカルモデル基盤など固有の領域は、実際に採用した範囲で追加する。区分名や製品名の例を、すべてのプロジェクトの必須構成にしない。
83
+ - 実行時の技術: 言語・ランタイム・フレームワーク、データ保存・連携、ホスティング・ネットワーク。
84
+ - 開発・保守の技術: build・テスト・静的検査・文書化・図解・ソース管理・CI/CD・配布・運用監視。
85
+ - AI 実行環境やローカルモデル基盤など固有の領域は採用範囲で追加する。例示を一律の必須構成にしない。
96
86
 
97
87
  ### 6.3. 版と採用状態
98
88
 
99
- - 一覧ではメジャーバージョンや互換性の制約など、構成を理解するために必要な粒度を使う。特定の版が採用判断に不可欠な場合は、その理由と正本を示す。
100
- - 正確なパッチ版や依存解決結果を lockfile などで管理する場合は、その参照先を示す。確認していない版を推測で記入しない。
101
- - 任意利用の技術は、採用済みの選択肢であることと適用条件を明示する。未採択の比較候補や将来案は、採用一覧の外で扱う。
102
- - 「最新版」と記載する場合は、取得元と更新方針を示す。実際に使用した版の確認方法が分からない表現にしない。
89
+ - メジャー版や互換性制約など必要な粒度を使い、特定版が採用判断に不可欠なら理由と正本を示す。
90
+ - パッチ版や依存解決結果は lockfile 等の参照先を示し、未確認の版を推測しない。
91
+ - 必須・任意を区別し、任意技術には採用済みであることと適用条件を示す。未採択の候補・将来案は判断の記録へ導く。
92
+ - 「最新版」は取得元・更新方針・使用版の確認方法を示す。
103
93
 
104
94
  ### 6.4. 詳細文書と更新
105
95
 
106
- - 技術の初期構築、クライアント接続、日常利用を分冊している場合は、それぞれの目的が分かる参照名にする。
107
- - 採用・廃止・責務・適用範囲が変わったときに一覧を更新し、詳細 TSD や設定の正本との不一致を確認する。
108
- - 未作成の詳細や未決の条件は共通ラベルで示し、仮の参照先や設定値を確定情報として残さない。
96
+ - 初期構築・クライアント接続・日常利用を分冊する場合は、各参照名で目的を示す。
97
+ - 技術の採用・廃止・責務・適用範囲の変更時は一覧と詳細 TSD・設定の正本を照合し、不一致を解消する。
98
+ - 未作成の詳細や未決条件は共通ラベルで示し、仮の参照先や設定値を確定情報にしない。
109
99
 
110
100
  ## 7. 禁止事項
111
101
 
@@ -116,5 +106,4 @@ Technology Stack Index (TSD Index) Documentation Rules
116
106
  | 同じ技術や一覧を、適用範囲を示さず重複させる | 責務と更新先が分からなくなるため |
117
107
  | 全依存パッケージやすべての版固定値を転載する | 一覧の目的を超え、依存定義と二重管理になるため |
118
108
  | 詳細設定、接続先、構築コマンド、コードを一覧の本文へ展開する | 詳細 TSD や設定の正本との責務が重なるため |
119
- | API キー、トークン、秘密鍵、機密の接続情報を記載する | 一覧の配布や履歴を通じて漏れるため |
120
109
  | 任意利用の製品や実例の構成を一律の必須技術にする | 対象範囲や環境による違いを失うため |
@@ -13,62 +13,50 @@ specdojo:
13
13
 
14
14
  Technology Stack Detail Definition (TSD) Documentation Rules
15
15
 
16
- `tsd-<term>.md` は、採用した技術や実行基盤について、構成、設定、導入、接続、動作確認、継続利用に必要な情報を定義する。`tsd-index.md` の技術一覧を具体化し、別の担当者が対象環境で同じ構成を再現し、正常性を判断できる内容を残す。
16
+ `tsd-<term>.md` は、採用した技術や実行基盤の構成・設定・利用手順を定義する。構築・接続・日常利用を行う人と確認者が、対象環境で構成を再現し、採用設定と正常性を照合するために使う。
17
17
 
18
18
  ## 1. 全体方針
19
19
 
20
- - 一つの文書は、技術領域、接続関係、または一連の利用場面を単位とする。目的を共有する複数の技術を、一つの実行基盤として扱ってよい。
21
- - 目的、対象環境、前提条件、実行場所を明示し、採用設定と動作確認を対応させる。
22
- - 採用した値、推奨する値、任意の選択肢、未決事項を区別する。根拠のない製品名、版、容量、並列数を補わない。
23
- - 一覧、技術基盤の初期構築、クライアントからの接続、日常利用を必要に応じて分冊し、同じ設定の正本を一つにする。
24
- - 再現に必要な設定ファイル、コマンド、補助スクリプトの記述を認める。アプリケーションの内部設計、詳細 API 仕様、SQL 全文は扱わない。
25
- - 秘密値は記載せず、取得・保存・参照の方法を記載する。公開可能な接続方式、ポート、汎用ホスト名と、個人・組織固有の機密情報を区別する。
20
+ - 一冊は技術領域・接続関係・一連の利用場面を単位とし、目的を共有する複数技術を含めてよい。
21
+ - 採用値・推奨値・任意の選択肢・未決事項を区別し、根拠のない製品名・版・容量・並列数を補わない。
22
+ - 初期構築・接続設定・日常利用は必要に応じて分冊し、各設定の正本を一つにする。
23
+ - 再現に必要な設定・コマンド・補助スクリプトを記載する。アプリケーション内部設計・詳細 API 仕様・SQL 全文は対象外とする。
24
+ - **共通の運用**: 作成・維持・確認の役割は適用先のメンバー定義に、`status`・承認・改訂と廃止・未決事項の引き継ぎは [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] に従う。文書の整形・lint はリポジトリの検証で扱い、業務の動作確認に含めない。
26
25
 
27
26
  ## 2. 位置づけ
28
27
 
29
- | 文書・情報 | 役割 | TSD との関係 |
30
- | -------------------- | ------------------------------------------ | --------------------------------------------------------------- |
31
- | `tsd-index` | 採用技術、区分、担当責務の一覧 | 全体の入口とし、技術領域ごとの詳細へ導く |
32
- | `tsd-<term>` | 技術領域や実行基盤の構成と採用設定 | 対象領域の設定と再現手順の正本にする |
33
- | 接続設定の分冊 | 既存の技術基盤を利用するクライアントの設定 | 基盤側の導入を前提として参照し、重複記載しない |
34
- | 日常利用の分冊 | 接続、再接続、起動、停止などの利用手順 | 初期構築の完了を前提とし、設定の正本を参照する |
35
- | 上位設計・非機能要件 | 責務分界、品質要求、採用判断の根拠 | TSD の設定が満たすべき条件を示す |
36
- | 運用設計・運用手順 | 体制、SLO、障害対応、バックアップなど | 組織的な運用方針は参照し、技術固有の操作だけを TSD で具体化する |
28
+ | 文書・情報 | TSD との分担 |
29
+ | -------------------- | ----------------------------------------------------------- |
30
+ | `tsd-index` | 採用技術・区分・担当責務の一覧から詳細へ導く |
31
+ | `tsd-<term>` | 対象領域の構成・採用設定・再現手順の正本 |
32
+ | 接続設定の分冊 | 基盤導入を前提とするクライアント設定 |
33
+ | 日常利用の分冊 | 初期構築後の接続・再接続・起動・停止 |
34
+ | 上位設計・非機能要件 | 責務分界・品質要求・採用判断の根拠 |
35
+ | 運用設計・運用手順 | 体制・SLO・障害対応・バックアップ方針。技術固有の操作は TSD |
37
36
 
38
- - 分冊した文書には、前提となる文書と、本書で定義する差分を明示する。
39
- - ホスト、コンテナ、接続元端末などで役割が異なる場合は、構成図または対応表で境界を示す。
40
- - 共通設定や技術一覧を転載せず、正本への参照でつなぐ。参照だけでは実行順が分からない場合は、前提の完了条件を併記する。
37
+ 分冊では前提文書と完了条件、本書で定義する差分を示し、共通設定や技術一覧は参照する。
41
38
 
42
39
  ## 3. ファイル命名・ID規則
43
40
 
44
- - ファイル名は `tsd-<term>.md` とする。`<term>` は対象技術、実行基盤、接続関係が分かる英小文字・数字・ハイフンで表す。
45
- - 接続設定は `tsd-<technology>-<client>.md`、日常利用は `tsd-<environment>-usage.md` のように用途を区別してよい。名称だけで内容を判断できない分割は避ける。
46
- - `id` はファイル名の stem と対応させ、名前空間や一意性は共通のメタデータ規約に従う。
47
- - 配置先は `tsd-index.md` と同じ技術基盤の文書群とする。プロジェクトのディレクトリ構成を優先する。
41
+ - ファイル名は `tsd-<term>.md` とし、`<term>` は対象技術・基盤・接続関係を表す英小文字・数字・ハイフンとする。
42
+ - 接続設定は `tsd-<technology>-<client>.md`、日常利用は `tsd-<environment>-usage.md` のように用途を区別してよい。
43
+ - `id` はファイル名の stem に対応させ、配置はプロジェクトの構成に従って `tsd-index.md` と同じ文書群に置く。
48
44
 
49
45
  ## 4. 推奨 Frontmatter 項目
50
46
 
51
- 項目は `specdojo` 配下に置く。共通の型と参照形式は [document-metadata-standard.md](../standards/document-metadata-standard.md) と成果物の Frontmatter スキーマに従う。
47
+ 共通項目・型・必須性は [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] と `docs/specdojo/schemas/v1/deliverable-frontmatter.schema.yaml` に従う。
52
48
 
53
- | 項目 | 必須 | 値・記述内容 |
54
- | ------------ | -------- | ------------------------------------------------------------ |
55
- | `id` | ○ | 対象文書を一意に識別する `tsd-<term>` 系の ID |
56
- | `type` | ○ | `architecture` |
57
- | `status` | ○ | `draft` / `ready` / `deprecated` |
58
- | `rulebook` | 推奨 | `specdojo:tsd-rulebook` |
59
- | `part_of` | 推奨 | 所属する `tsd-index` などの ID 配列 |
60
- | `based_on` | 条件付き | 構成や設定の直接の根拠となる上位設計、基盤定義などの ID 配列 |
61
- | `supersedes` | 条件付き | 既存の構成定義を置き換える場合の旧文書 ID 配列 |
62
-
63
- 接続設定や利用手順を分冊する場合は、前提となる技術基盤の文書を `based_on` に示す。参考として読んだだけの文書を、採用判断の根拠として列挙しない。
49
+ - `type` は `architecture`、`rulebook` は `specdojo:tsd-rulebook` とする。
50
+ - `part_of` には所属する `tsd-index` などの ID 配列を推奨する。
51
+ - `based_on` は構成・設定の直接の根拠となる上位設計や基盤定義がある場合に示す。接続設定・利用手順の分冊では前提の基盤文書を含める。
64
52
 
65
53
  ## 5. 本文要件
66
54
 
67
- 以下は内容要件であり、固定した見出し順を要求しない。対象に合わせて章をまとめたり分けたりしてよい。条件付きの内容を別冊へ委ねる場合は、その正本と前提の完了条件を示す。
55
+ 以下は内容要件であり、章の統合・分割・順序変更を認める。別冊へ委ねる条件付きの内容は、正本と前提の完了条件を示す。
68
56
 
69
57
  | 内容 | 必須 | 目的・記述要件 |
70
58
  | ---------------------- | -------- | -------------------------------------------------------------------------------------------------- |
71
- | 概要・位置づけ | ○ | 目的、対象範囲、対象外、他文書との責務分担を明示する |
59
+ | 概要・位置づけ | ○ | 誰がどの作業・判断に使うか、目的、対象範囲・対象外、他文書との責務分担を示す |
72
60
  | 対象環境・前提条件 | ○ | OS、実行環境、必要な権限、導入済みの依存、必要な資源を示す。特別な前提がない項目はその旨を書く |
73
61
  | 全体構成・接続経路 | 条件付き | 複数のホスト、プロセス、クライアントを使う場合、配置、役割、通信方向、公開範囲を示す |
74
62
  | 採用技術・設定 | ○ | 用途、採用する版・モデル・設定値、適用範囲、理由、制約を対応させる |
@@ -80,17 +68,15 @@ Technology Stack Detail Definition (TSD) Documentation Rules
80
68
  | 更新・復旧・撤去 | 条件付き | 既存環境を変更する場合、切り戻し、旧方式との共存可否、設定・データの保持や削除の範囲を示す |
81
69
  | 参照情報 | 任意 | 判断や手順の根拠となる公式情報、確認した版や日付、関連文書への導線を示す |
82
70
 
83
- - 初期構築、接続設定、日常利用のいずれを扱う文書かを冒頭で明示する。
84
- - 版や環境で手順が変わる場合は、適用条件を分ける。任意の設定を全利用者の必須条件として書かない。
85
- - 手順を省略して別文書へ導く場合も、本書の開始条件と完了を判断する確認方法は残す。
71
+ 冒頭に初期構築・接続設定・日常利用の対象と開始条件を示し、手順を別冊へ委ねても完了の確認方法は残す。版・環境別の条件と任意設定を分け、未決事項は論点と影響(当面の扱い)を記す。
86
72
 
87
73
  ## 6. 記述ガイド
88
74
 
89
75
  ### 6.1. 対象環境と責務分界
90
76
 
91
- - 接続元端末、ホスト、コンテナなどに一貫した呼び名を付け、各コマンドをどこで実行するか示す。
92
- - インストール先、設定保存先、作業ディレクトリ、実行ユーザーを、手順を再現できる粒度で記載する。
93
- - OS、ハードウェア、メモリ、ディスク、並列数などの制約は採用理由と結び付ける。検証した構成と一般的な推奨を区別する。
77
+ - 接続元端末・ホスト・コンテナを構成図か対応表で区別し、呼び名を各操作の実行場所と統一する。
78
+ - 導入先・設定保存先・作業ディレクトリ・実行ユーザーを特定する。
79
+ - OS・ハードウェア・資源・並列数の制約を採用理由に結び付け、検証済み構成と一般的な推奨を分ける。
94
80
 
95
81
  ### 6.2. 採用設定の表
96
82
 
@@ -103,14 +89,14 @@ Technology Stack Detail Definition (TSD) Documentation Rules
103
89
  | 理由・制約 | 採用根拠、互換性、資源上の制約 |
104
90
  | 反映・確認方法 | 再起動の要否、有効値の確認方法 |
105
91
 
106
- 設定ファイルと環境変数の両方がある場合は、優先順位と反映先を記載する。GUI で保存する設定も、画面の項目名、保存先、反映条件を示す。
92
+ 設定ファイルと環境変数の優先順位・反映先、GUI 設定の画面項目名・保存先・反映条件を示す。
107
93
 
108
94
  ### 6.3. 導入・変更手順
109
95
 
110
- - 順序付きリストと、言語識別子付きのコードブロックを使う。シェル、実行場所、事前条件が分かるようにする。
111
- - 設定の追加、部分的な変更、ファイル全体の置換を区別する。既存の provider や利用者設定を残す必要がある場合は統合方法を示す。
112
- - 再起動、権限変更、データ削除などの影響と、実行前に確認すべき条件を併記する。導入、起動、再起動、停止を同じ操作として扱わない。
113
- - 既存環境からの移行では、旧方式の停止、競合の回避、切り戻し方法を示す。撤去時は設定・認証状態・データの保持と削除を分ける。
96
+ - 順序付き手順と言語識別子付きコードブロックに、シェル・実行場所・事前条件を示す。
97
+ - 追加・部分変更・全体置換を区別し、既存の provider や利用者設定との統合方法を書く。
98
+ - 導入・起動・再起動・停止を分け、権限変更やデータ削除の影響・事前確認を添える。
99
+ - 移行では旧方式の停止・競合回避・切り戻しを示し、撤去では設定・認証状態・データの保持と削除を分ける。
114
100
 
115
101
  ### 6.4. 動作確認と切り分け
116
102
 
@@ -121,31 +107,28 @@ Technology Stack Detail Definition (TSD) Documentation Rules
121
107
  | 期待結果 | 出力項目、状態、応答内容などの判定条件 |
122
108
  | 失敗時の確認先 | 前提の依存、保存先、ログ、次の切り分け手順 |
123
109
 
124
- - プロセスの起動、ネットワーク疎通、認証、モデルや provider の識別子、実際の利用機能を必要に応じて段階的に確認する。
125
- - 期待結果は版や環境で変わる表示を丸写しせず、正常と判断する項目を明示する。
126
- - 未実施の確認を成功した事実として書かない。確認環境、未確認条件、残る確認方法を記載する。
110
+ - 対象に応じ、起動・疎通・認証・モデルや provider の識別子・最終利用を段階的に確認する。
111
+ - 期待結果は表示の丸写しを避け、版や環境に応じた合否判定項目を示す。
112
+ - 確認環境・未確認条件・残る確認方法を示し、未実施を成功と扱わない。
127
113
 
128
114
  ### 6.5. 継続利用と状態の保存
129
115
 
130
- - 切断後の再接続、処理の再開、プロセスの再起動を区別し、自動で復旧する範囲を明記する。
131
- - 再起動や再構築で保持される設定、認証状態、作業データと、失われるセッションを示す。
132
- - 資源制約や長時間実行が関係する場合は、監視項目、正常範囲、処理を減らす判断条件を示す。
116
+ - 再接続・処理再開・プロセス再起動と、自動復旧の範囲を区別する。
117
+ - 再起動・再構築で保持・喪失する設定・認証状態・データ・セッションを示す。
118
+ - 資源制約・長時間実行では、監視項目・正常範囲・処理を減らす条件を示す。
133
119
 
134
120
  ### 6.6. 接続情報と秘密情報
135
121
 
136
- - 接続方式、公開可能なポート、汎用ホスト名、API の基点など、再現に必要な情報は記載してよい。
137
- - 個人・組織固有のホスト名、アカウント、URL などは公開可否を判断し、機密の場合はプレースホルダーで示す。
138
- - API キー、トークン、パスワード、秘密鍵の実値を載せず、credential store などの保存・参照方法を示す。設定例や出力例にも秘密値を含めない。
122
+ - 接続方式・公開可能なポート・汎用ホスト名・API 基点は再現に必要なら記載する。
123
+ - 固有のホスト名・アカウント・URL は公開可否を判断し、機密ならプレースホルダーにする。
124
+ - 認証情報は実値に代えて取得・保存・参照方法を示し、設定例・出力例でも同じ扱いとする。
139
125
 
140
126
  ## 7. 禁止事項
141
127
 
142
- | 禁止事項 | 理由 |
143
- | ------------------------------------------------------------------------- | --------------------------------------- |
144
- | 秘密値や機密の接続先を本文・設定例・ログ例に載せる | 文書の配布や Git 履歴を通じて漏れるため |
145
- | 実行場所や適用条件が異なる手順を区別せず並べる | 誤った環境や権限で設定を変更するため |
146
- | 未確認の構成や未採択の設定を、動作確認済み・採用済みとして書く | 実行と判断の前提を誤らせるため |
147
- | 根拠なく「最新」「十分」「問題ない」だけで版や正常性を定義する | 再現や合否判定ができないため |
148
- | アプリケーションの内部クラス、関数設計、詳細 API 仕様、SQL 全文を展開する | 技術基盤の構成定義を超えるため |
149
- | 技術一覧や他の TSD の設定を複数箇所で正本として管理する | 更新時に構成が食い違うため |
150
- | 無関係な技術領域や独立した利用目的を一つの文書に詰め込む | 適用範囲と保守単位が分からなくなるため |
151
- | 停止、削除、再構築を、状態やデータへの影響を示さず指示する | 復旧や継続利用に必要な状態を失うため |
128
+ | 禁止事項 | 理由 |
129
+ | -------------------------------------------------------------- | -------------------------------------- |
130
+ | 実行場所や適用条件が異なる手順を区別せず並べる | 誤った環境や権限で設定を変更するため |
131
+ | 未確認の構成や未採択の設定を、動作確認済み・採用済みとして書く | 実行と判断の前提を誤らせるため |
132
+ | 技術一覧や他の TSD の設定を複数箇所で正本として管理する | 更新時に構成が食い違うため |
133
+ | 無関係な技術領域や独立した利用目的を一つの文書に詰め込む | 適用範囲と保守単位が分からなくなるため |
134
+ | 停止、削除、再構築を、状態やデータへの影響を示さず指示する | 復旧や継続利用に必要な状態を失うため |