specdojo 0.4.7 → 0.6.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 (312) hide show
  1. package/.github/agents/specdojo-orchestrator.md +16 -9
  2. package/CHANGELOG.md +106 -0
  3. package/dist/catalog/generate.js +144 -13
  4. package/dist/commands/init.js +4 -0
  5. package/dist/commands/night-orchestrator.js +33 -4
  6. package/dist/dashboard/dashboard.js +5 -6
  7. package/dist/dashboard/timeline-build.js +5 -1
  8. package/dist/dashboard/timeline.js +6 -3
  9. package/dist/deliverable/deliverable.js +77 -4
  10. package/dist/docs/yaml-pages.js +17 -17
  11. package/dist/exec/core.js +3 -0
  12. package/dist/exec/parent-validation.js +7 -0
  13. package/dist/exec/pipeline-state.js +5 -2
  14. package/dist/exec/plans-core.js +49 -3
  15. package/dist/exec/plans-generation.js +48 -8
  16. package/dist/exec/plans-grade-findings.js +16 -0
  17. package/dist/exec/plans-planning.js +43 -0
  18. package/dist/exec/plans-storage.js +6 -2
  19. package/dist/exec/product-branch-records.js +105 -0
  20. package/dist/exec/product-branches.js +52 -0
  21. package/dist/exec/register-product-message.js +50 -0
  22. package/dist/exec/register.js +22 -1
  23. package/dist/exec/repo-integration-sync.js +11 -0
  24. package/dist/exec/repo-integration.js +58 -6
  25. package/dist/exec/repo-trace.js +19 -4
  26. package/dist/exec/results.js +11 -5
  27. package/dist/exec/run/register-command.js +16 -0
  28. package/dist/exec/run/register-core.js +11 -0
  29. package/dist/exec/run/register-mode.js +19 -1
  30. package/dist/exec/run/register-resume.js +33 -1
  31. package/dist/exec/run/register-worktree.js +52 -8
  32. package/dist/exec/run/schedule-prepare.js +7 -3
  33. package/dist/exec/strategy.js +4 -1
  34. package/dist/exec/task-repos.js +92 -16
  35. package/dist/exec/worktree-command.js +2 -2
  36. package/dist/exec/worktree-ops-commit.js +7 -1
  37. package/dist/exec/worktree.js +3 -3
  38. package/dist/grade/apply.js +6 -2
  39. package/dist/grade/markdown.js +7 -2
  40. package/dist/grade/plan.js +6 -4
  41. package/dist/register/approach.js +19 -0
  42. package/dist/register/catalog-status.js +49 -0
  43. package/dist/register/core.js +8 -0
  44. package/dist/register/create-commands.js +86 -4
  45. package/dist/register/deliverable-target.js +24 -17
  46. package/dist/register/dependency.js +123 -0
  47. package/dist/register/derivation.js +2 -2
  48. package/dist/register/epic.js +42 -0
  49. package/dist/register/event-merge.js +9 -2
  50. package/dist/register/events.js +10 -0
  51. package/dist/register/external-project.js +6 -0
  52. package/dist/register/input.js +168 -0
  53. package/dist/register/item.js +71 -0
  54. package/dist/register/maintenance-commands.js +7 -1
  55. package/dist/register/planning.js +37 -0
  56. package/dist/register/register.js +7 -3
  57. package/dist/register/renumber.js +16 -4
  58. package/dist/register/update.js +6 -0
  59. package/dist/register/views.js +55 -4
  60. package/dist/schedule/approach.js +9 -0
  61. package/dist/schedule/schedule.js +3 -1
  62. package/dist/schedule/strategy-generate-scope.js +5 -1
  63. package/dist/schedule/strategy-generate.js +1 -0
  64. package/dist/schedule/strategy-profiles.js +22 -2
  65. package/dist/shared/agent-types.js +7 -1
  66. package/dist/shared/branch-template.js +26 -0
  67. package/dist/shared/commit-message-template.js +38 -0
  68. package/dist/shared/commit-types.js +15 -0
  69. package/dist/shared/grade-result.js +23 -5
  70. package/dist/shared/markdownlint-config.js +38 -0
  71. package/dist/shared/markdownlint-scaffold.js +2 -9
  72. package/dist/shared/specdojo-config.js +42 -4
  73. package/dist/shared/specdojo-gitignore.js +4 -0
  74. package/docs/ja/specdojo/exec-templates/xep-catalog-planning-template.md +24 -0
  75. package/docs/ja/specdojo/exec-templates/xep-draft-template.md +93 -0
  76. package/docs/ja/specdojo/exec-templates/xep-fully-guided-template.md +9 -2
  77. package/docs/ja/specdojo/exec-templates/xep-register-investigate-template.md +2 -0
  78. package/docs/ja/specdojo/exec-templates/xep-register-template.md +2 -0
  79. package/docs/ja/specdojo/exec-templates/xep-strategy-planning-template.md +24 -0
  80. package/docs/ja/specdojo/exec-templates/xer-human-bootstrap-finalize-template.md +2 -0
  81. package/docs/ja/specdojo/exec-templates/xer-human-draft-template.md +23 -0
  82. package/docs/ja/specdojo/exec-templates/xer-human-finalize-template.md +2 -0
  83. package/docs/ja/specdojo/exec-templates/xrp-fully-guided-template.md +7 -4
  84. package/docs/ja/specdojo/guides/docs-editing-guide.md +14 -1
  85. package/docs/ja/specdojo/guides/docs-structure-guide.md +10 -8
  86. package/docs/ja/specdojo/guides/exec-config-guide.md +3 -1
  87. package/docs/ja/specdojo/guides/exec-operation-guide.md +111 -16
  88. package/docs/ja/specdojo/guides/orchestrator-operation-guide.md +19 -1
  89. package/docs/ja/specdojo/guides/practice-system-composition-guide.md +2 -0
  90. package/docs/ja/specdojo/guides/quick-start-guide.md +37 -14
  91. package/docs/ja/specdojo/guides/register-operation-guide.md +58 -16
  92. package/docs/ja/specdojo/guides/remote-host-development-guide.md +1 -1
  93. package/docs/ja/specdojo/guides/ryu-guide.md +114 -23
  94. package/docs/ja/specdojo/guides/schedule-design-guide.md +31 -4
  95. package/docs/ja/specdojo/guides/specdojo-overview-guide.md +16 -16
  96. package/docs/ja/specdojo/guides/timeline-design-guide.md +37 -33
  97. package/docs/ja/specdojo/recipes/exec-human-finalize-recipe.md +1 -0
  98. package/docs/ja/specdojo/recipes/tsd-recipe.md +206 -0
  99. package/docs/ja/specdojo/references/command-reference.md +86 -15
  100. package/docs/ja/specdojo/references/specdojo-config-reference.md +81 -8
  101. package/docs/ja/specdojo/rulebooks/atc-index-rulebook.md +1 -0
  102. package/docs/ja/specdojo/rulebooks/atc-rulebook.md +1 -0
  103. package/docs/ja/specdojo/rulebooks/bac-rulebook.md +5 -4
  104. package/docs/ja/specdojo/rulebooks/bdd-rulebook.md +3 -2
  105. package/docs/ja/specdojo/rulebooks/bds-rulebook.md +4 -3
  106. package/docs/ja/specdojo/rulebooks/bes-index-rulebook.md +8 -7
  107. package/docs/ja/specdojo/rulebooks/bes-rulebook.md +4 -3
  108. package/docs/ja/specdojo/rulebooks/bps-rulebook.md +1 -0
  109. package/docs/ja/specdojo/rulebooks/br-rulebook.md +1 -0
  110. package/docs/ja/specdojo/rulebooks/ccd-mermaid-rulebook.md +1 -0
  111. package/docs/ja/specdojo/rulebooks/cdfd-mermaid-rulebook.md +1 -0
  112. package/docs/ja/specdojo/rulebooks/cdfd-overview-rulebook.md +1 -0
  113. package/docs/ja/specdojo/rulebooks/cdfd-rulebook.md +1 -0
  114. package/docs/ja/specdojo/rulebooks/cdfd-uc-rulebook.md +1 -0
  115. package/docs/ja/specdojo/rulebooks/cdsd-rulebook.md +3 -2
  116. package/docs/ja/specdojo/rulebooks/cld-rulebook.md +2 -1
  117. package/docs/ja/specdojo/rulebooks/cnd-mermaid-rulebook.md +1 -0
  118. package/docs/ja/specdojo/rulebooks/cnd-rulebook.md +1 -0
  119. package/docs/ja/specdojo/rulebooks/cop-index-rulebook.md +2 -1
  120. package/docs/ja/specdojo/rulebooks/cop-rulebook.md +3 -2
  121. package/docs/ja/specdojo/rulebooks/cpd-mermaid-rulebook.md +1 -0
  122. package/docs/ja/specdojo/rulebooks/cpd-rulebook.md +1 -0
  123. package/docs/ja/specdojo/rulebooks/cstd-rulebook.md +1 -0
  124. package/docs/ja/specdojo/rulebooks/cxd-mermaid-rulebook.md +1 -0
  125. package/docs/ja/specdojo/rulebooks/cxd-rulebook.md +1 -0
  126. package/docs/ja/specdojo/rulebooks/dct-index-rulebook.md +1 -0
  127. package/docs/ja/specdojo/rulebooks/dct-rulebook.md +9 -0
  128. package/docs/ja/specdojo/rulebooks/dec-rulebook.md +1 -0
  129. package/docs/ja/specdojo/rulebooks/dmd-index-rulebook.md +2 -1
  130. package/docs/ja/specdojo/rulebooks/dmd-rulebook.md +2 -1
  131. package/docs/ja/specdojo/rulebooks/etc-index-rulebook.md +1 -0
  132. package/docs/ja/specdojo/rulebooks/etc-rulebook.md +1 -0
  133. package/docs/ja/specdojo/rulebooks/gl-rulebook.md +9 -6
  134. package/docs/ja/specdojo/rulebooks/ifd-mermaid-rulebook.md +1 -0
  135. package/docs/ja/specdojo/rulebooks/ifx-api-rulebook.md +3 -1
  136. package/docs/ja/specdojo/rulebooks/ifx-cmd-rulebook.md +2 -1
  137. package/docs/ja/specdojo/rulebooks/ifx-file-rulebook.md +2 -1
  138. package/docs/ja/specdojo/rulebooks/ifx-index-rulebook.md +2 -0
  139. package/docs/ja/specdojo/rulebooks/ifx-msg-rulebook.md +4 -2
  140. package/docs/ja/specdojo/rulebooks/imp-business-rulebook.md +1 -0
  141. package/docs/ja/specdojo/rulebooks/imp-data-rulebook.md +1 -0
  142. package/docs/ja/specdojo/rulebooks/imp-interface-rulebook.md +1 -0
  143. package/docs/ja/specdojo/rulebooks/imp-operations-rulebook.md +1 -0
  144. package/docs/ja/specdojo/rulebooks/imp-test-rulebook.md +1 -0
  145. package/docs/ja/specdojo/rulebooks/itc-index-rulebook.md +1 -0
  146. package/docs/ja/specdojo/rulebooks/itc-rulebook.md +1 -0
  147. package/docs/ja/specdojo/rulebooks/mip-index-rulebook.md +2 -1
  148. package/docs/ja/specdojo/rulebooks/mm-rulebook.md +1 -0
  149. package/docs/ja/specdojo/rulebooks/mtp-rulebook.md +4 -3
  150. package/docs/ja/specdojo/rulebooks/nfr-availability-rulebook.md +9 -8
  151. package/docs/ja/specdojo/rulebooks/nfr-index-rulebook.md +10 -9
  152. package/docs/ja/specdojo/rulebooks/nfr-integrity-rulebook.md +9 -8
  153. package/docs/ja/specdojo/rulebooks/nfr-maintainability-rulebook.md +9 -8
  154. package/docs/ja/specdojo/rulebooks/nfr-operations-rulebook.md +9 -8
  155. package/docs/ja/specdojo/rulebooks/nfr-performance-rulebook.md +9 -8
  156. package/docs/ja/specdojo/rulebooks/nfr-reliability-rulebook.md +10 -9
  157. package/docs/ja/specdojo/rulebooks/nfr-security-safety-rulebook.md +9 -8
  158. package/docs/ja/specdojo/rulebooks/nfr-usability-rulebook.md +9 -8
  159. package/docs/ja/specdojo/rulebooks/ntp-rulebook.md +7 -6
  160. package/docs/ja/specdojo/rulebooks/opd-index-rulebook.md +1 -0
  161. package/docs/ja/specdojo/rulebooks/opd-rulebook.md +1 -0
  162. package/docs/ja/specdojo/rulebooks/opr-index-rulebook.md +1 -0
  163. package/docs/ja/specdojo/rulebooks/opr-rulebook.md +1 -0
  164. package/docs/ja/specdojo/rulebooks/otp-index-rulebook.md +2 -1
  165. package/docs/ja/specdojo/rulebooks/otp-rulebook.md +2 -1
  166. package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +54 -36
  167. package/docs/ja/specdojo/rulebooks/pm-change-request-log-rulebook.md +1 -0
  168. package/docs/ja/specdojo/rulebooks/pm-communication-plan-rulebook.md +1 -0
  169. package/docs/ja/specdojo/rulebooks/pm-issue-log-rulebook.md +1 -0
  170. package/docs/ja/specdojo/rulebooks/pm-members-rulebook.md +1 -0
  171. package/docs/ja/specdojo/rulebooks/pm-organization-rulebook.md +1 -0
  172. package/docs/ja/specdojo/rulebooks/pm-plan-rulebook.md +1 -0
  173. package/docs/ja/specdojo/rulebooks/pm-quality-management-plan-rulebook.md +1 -0
  174. package/docs/ja/specdojo/rulebooks/pm-raci-rulebook.md +1 -0
  175. package/docs/ja/specdojo/rulebooks/pm-risk-register-rulebook.md +1 -0
  176. package/docs/ja/specdojo/rulebooks/pm-roles-rulebook.md +1 -0
  177. package/docs/ja/specdojo/rulebooks/pr-rulebook.md +1 -0
  178. package/docs/ja/specdojo/rulebooks/prj-assumptions-constraints-dependencies-rulebook.md +1 -0
  179. package/docs/ja/specdojo/rulebooks/prj-charter-rulebook.md +1 -0
  180. package/docs/ja/specdojo/rulebooks/prj-comparison-of-alternatives-rulebook.md +1 -0
  181. package/docs/ja/specdojo/rulebooks/prj-issues-and-approach-rulebook.md +1 -0
  182. package/docs/ja/specdojo/rulebooks/prj-overview-rulebook.md +1 -0
  183. package/docs/ja/specdojo/rulebooks/prj-scope-rulebook.md +1 -0
  184. package/docs/ja/specdojo/rulebooks/prj-stakeholder-register-rulebook.md +1 -0
  185. package/docs/ja/specdojo/rulebooks/prj-success-criteria-and-acceptance-criteria-rulebook.md +1 -0
  186. package/docs/ja/specdojo/rulebooks/sac-rulebook.md +3 -2
  187. package/docs/ja/specdojo/rulebooks/sch-rulebook.md +4 -1
  188. package/docs/ja/specdojo/rulebooks/sf-index-rulebook.md +7 -6
  189. package/docs/ja/specdojo/rulebooks/sf-rulebook.md +4 -3
  190. package/docs/ja/specdojo/rulebooks/sld-rulebook.md +2 -1
  191. package/docs/ja/specdojo/rulebooks/stc-index-rulebook.md +1 -0
  192. package/docs/ja/specdojo/rulebooks/stc-rulebook.md +1 -0
  193. package/docs/ja/specdojo/rulebooks/stsd-mermaid-rulebook.md +1 -0
  194. package/docs/ja/specdojo/rulebooks/stsd-rulebook.md +1 -0
  195. package/docs/ja/specdojo/rulebooks/sysd-critical-flows-rulebook.md +2 -1
  196. package/docs/ja/specdojo/rulebooks/sysd-cross-cutting-policy-rulebook.md +9 -8
  197. package/docs/ja/specdojo/rulebooks/sysd-index-rulebook.md +2 -1
  198. package/docs/ja/specdojo/rulebooks/sysd-rulebook.md +1 -0
  199. package/docs/ja/specdojo/rulebooks/tml-rulebook.md +1 -0
  200. package/docs/ja/specdojo/rulebooks/trc-requirements-to-specs-rulebook.md +1 -0
  201. package/docs/ja/specdojo/rulebooks/trc-requirements-to-tests-rulebook.md +1 -0
  202. package/docs/ja/specdojo/rulebooks/tsd-index-rulebook.md +80 -61
  203. package/docs/ja/specdojo/rulebooks/tsd-rulebook.md +111 -63
  204. package/docs/ja/specdojo/rulebooks/tsp-index-rulebook.md +1 -0
  205. package/docs/ja/specdojo/rulebooks/uis-rulebook.md +3 -2
  206. package/docs/ja/specdojo/rulebooks/utc-index-rulebook.md +1 -0
  207. package/docs/ja/specdojo/rulebooks/utc-rulebook.md +1 -0
  208. package/docs/ja/specdojo/samples/atc-index-sample.md +1 -1
  209. package/docs/ja/specdojo/samples/atc-sample.md +1 -1
  210. package/docs/ja/specdojo/samples/bac-sample.md +1 -1
  211. package/docs/ja/specdojo/samples/bdd-sample.yaml +1 -1
  212. package/docs/ja/specdojo/samples/bds-sample.md +1 -1
  213. package/docs/ja/specdojo/samples/bes-index-sample.md +1 -1
  214. package/docs/ja/specdojo/samples/bes-sample.md +1 -1
  215. package/docs/ja/specdojo/samples/ccd-sample.md +1 -1
  216. package/docs/ja/specdojo/samples/cdfd-sample.md +1 -1
  217. package/docs/ja/specdojo/samples/cdfd-uc-sample.md +1 -1
  218. package/docs/ja/specdojo/samples/cdsd-sample.md +1 -1
  219. package/docs/ja/specdojo/samples/cld-sample.md +1 -1
  220. package/docs/ja/specdojo/samples/cnd-sample.md +1 -1
  221. package/docs/ja/specdojo/samples/cop-index-sample.md +1 -1
  222. package/docs/ja/specdojo/samples/cop-sample.md +1 -1
  223. package/docs/ja/specdojo/samples/cpd-sample.md +1 -1
  224. package/docs/ja/specdojo/samples/cstd-sample.md +1 -1
  225. package/docs/ja/specdojo/samples/cxd-sample.md +1 -1
  226. package/docs/ja/specdojo/samples/dct-sample.yaml +5 -1
  227. package/docs/ja/specdojo/samples/dmd-index-sample.md +1 -1
  228. package/docs/ja/specdojo/samples/dmd-sample.md +1 -1
  229. package/docs/ja/specdojo/samples/etc-index-sample.md +1 -1
  230. package/docs/ja/specdojo/samples/etc-sample.md +1 -1
  231. package/docs/ja/specdojo/samples/gl-sample.yaml +2 -0
  232. package/docs/ja/specdojo/samples/ifd-sample.md +1 -1
  233. package/docs/ja/specdojo/samples/ifx-api-sample.yaml +1 -0
  234. package/docs/ja/specdojo/samples/ifx-cmd-sample.yaml +1 -1
  235. package/docs/ja/specdojo/samples/ifx-file-sample.md +1 -1
  236. package/docs/ja/specdojo/samples/ifx-index-sample.yaml +1 -0
  237. package/docs/ja/specdojo/samples/ifx-msg-sample.yaml +2 -1
  238. package/docs/ja/specdojo/samples/itc-index-sample.md +1 -1
  239. package/docs/ja/specdojo/samples/itc-sample.md +1 -1
  240. package/docs/ja/specdojo/samples/mtp-sample.md +1 -1
  241. package/docs/ja/specdojo/samples/nfr-availability-sample.md +1 -1
  242. package/docs/ja/specdojo/samples/nfr-index-sample.md +1 -1
  243. package/docs/ja/specdojo/samples/nfr-integrity-sample.md +1 -1
  244. package/docs/ja/specdojo/samples/nfr-maintainability-sample.md +1 -1
  245. package/docs/ja/specdojo/samples/nfr-operations-sample.md +1 -1
  246. package/docs/ja/specdojo/samples/nfr-performance-sample.md +1 -1
  247. package/docs/ja/specdojo/samples/nfr-reliability-sample.md +1 -1
  248. package/docs/ja/specdojo/samples/nfr-security-safety-sample.md +1 -1
  249. package/docs/ja/specdojo/samples/nfr-usability-sample.md +1 -1
  250. package/docs/ja/specdojo/samples/ntp-sample.md +1 -1
  251. package/docs/ja/specdojo/samples/opd-sample.md +1 -1
  252. package/docs/ja/specdojo/samples/opr-sample.md +1 -1
  253. package/docs/ja/specdojo/samples/otp-index-sample.md +1 -1
  254. package/docs/ja/specdojo/samples/otp-sample.md +1 -1
  255. package/docs/ja/specdojo/samples/prj-stakeholder-register-sample.md +1 -1
  256. package/docs/ja/specdojo/samples/sac-sample.md +1 -1
  257. package/docs/ja/specdojo/samples/sf-index-sample.md +1 -1
  258. package/docs/ja/specdojo/samples/sf-sample.md +1 -1
  259. package/docs/ja/specdojo/samples/sld-sample.md +1 -1
  260. package/docs/ja/specdojo/samples/stc-index-sample.md +1 -1
  261. package/docs/ja/specdojo/samples/stc-sample.md +1 -1
  262. package/docs/ja/specdojo/samples/stsd-sample.md +1 -1
  263. package/docs/ja/specdojo/samples/sysd-critical-flows-sample.md +1 -1
  264. package/docs/ja/specdojo/samples/sysd-cross-cutting-policy-sample.md +1 -1
  265. package/docs/ja/specdojo/samples/sysd-index-sample.md +1 -1
  266. package/docs/ja/specdojo/samples/tsd-index-sample.md +22 -16
  267. package/docs/ja/specdojo/samples/tsd-sample.md +241 -21
  268. package/docs/ja/specdojo/samples/tsp-index-sample.md +1 -1
  269. package/docs/ja/specdojo/samples/uis-sample.md +1 -1
  270. package/docs/ja/specdojo/samples/utc-index-sample.md +1 -1
  271. package/docs/ja/specdojo/samples/utc-sample.md +1 -1
  272. package/docs/ja/specdojo/standards/document-metadata-standard.md +44 -3
  273. package/docs/ja/specdojo/standards/exec-human-finalize-standard.md +1 -0
  274. package/docs/ja/specdojo/standards/guide-authoring-standard.md +2 -1
  275. package/docs/ja/specdojo/standards/id-and-file-naming-standard.md +2 -0
  276. package/docs/ja/specdojo/standards/philosophy-authoring-standard.md +1 -0
  277. package/docs/ja/specdojo/standards/recipe-authoring-standard.md +2 -1
  278. package/docs/ja/specdojo/standards/rulebook-authoring-standard.md +18 -12
  279. package/docs/ja/specdojo/standards/sample-authoring-standard.md +1 -0
  280. package/docs/ja/specdojo/standards/standard-authoring-standard.md +2 -1
  281. package/docs/ja/specdojo/templates/ifx-cmd-template.yaml +1 -1
  282. package/docs/ja/specdojo/templates/pjr-change-request-template.md +10 -4
  283. package/docs/ja/specdojo/templates/pjr-dependent-items-template.md +22 -0
  284. package/docs/ja/specdojo/templates/pjr-epic-items-template.md +22 -0
  285. package/docs/ja/specdojo/templates/pjr-epic-template.md +44 -0
  286. package/docs/ja/specdojo/templates/pjr-index-template.md +4 -2
  287. package/docs/ja/specdojo/templates/pjr-issue-template.md +10 -4
  288. package/docs/ja/specdojo/templates/pjr-question-template.md +11 -5
  289. package/docs/ja/specdojo/templates/pjr-risk-template.md +10 -4
  290. package/docs/ja/specdojo/templates/pjr-todo-template.md +10 -4
  291. package/docs/specdojo/schemas/v1/bdd.schema.yaml +1 -1
  292. package/docs/specdojo/schemas/v1/dct.schema.yaml +9 -0
  293. package/docs/specdojo/schemas/v1/deliverable-frontmatter.schema.yaml +24 -16
  294. package/docs/specdojo/schemas/v1/exec-common.schema.yaml +5 -1
  295. package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +1 -0
  296. package/docs/specdojo/schemas/v1/exec-plan-frontmatter.schema.yaml +1 -1
  297. package/docs/specdojo/schemas/v1/gl.schema.yaml +8 -0
  298. package/docs/specdojo/schemas/v1/ifx-cmd.schema.yaml +5 -1
  299. package/docs/specdojo/schemas/v1/pipeline-state.schema.yaml +2 -1
  300. package/docs/specdojo/schemas/v1/register-events.schema.yaml +21 -0
  301. package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +75 -3
  302. package/docs/specdojo/schemas/v1/rulebook-frontmatter.schema.yaml +5 -0
  303. package/docs/specdojo/schemas/v1/sch-strategy.schema.yaml +1 -0
  304. package/docs/specdojo/schemas/v1/specdojo-config.schema.yaml +43 -0
  305. package/package.json +4 -3
  306. package/templates/antigravity/orchestrator.md +16 -9
  307. package/templates/claude/agents/specdojo-orchestrator.md +16 -9
  308. package/templates/codex/agents/specdojo-orchestrator.toml +16 -9
  309. package/templates/codex/orchestrator.md +16 -9
  310. package/templates/copilot/README.md +2 -1
  311. package/templates/devcontainer/remote-host/specdojo-tmux.sh.sample +14 -8
  312. package/templates/opencode/agents/specdojo-orchestrator.md +16 -9
@@ -2,6 +2,7 @@
2
2
  specdojo:
3
3
  id: specdojo:prj-charter-rulebook
4
4
  type: rulebook
5
+ deliverable_type: project
5
6
  status: ready
6
7
  target_format: markdown
7
8
  recipe: specdojo:prj-charter-recipe
@@ -2,6 +2,7 @@
2
2
  specdojo:
3
3
  id: specdojo:prj-comparison-of-alternatives-rulebook
4
4
  type: rulebook
5
+ deliverable_type: project
5
6
  status: ready
6
7
  target_format: markdown
7
8
  recipe: specdojo:prj-comparison-of-alternatives-recipe
@@ -2,6 +2,7 @@
2
2
  specdojo:
3
3
  id: specdojo:prj-issues-and-approach-rulebook
4
4
  type: rulebook
5
+ deliverable_type: project
5
6
  status: ready
6
7
  target_format: markdown
7
8
  recipe: specdojo:prj-issues-and-approach-recipe
@@ -2,6 +2,7 @@
2
2
  specdojo:
3
3
  id: specdojo:prj-overview-rulebook
4
4
  type: rulebook
5
+ deliverable_type: project
5
6
  status: ready
6
7
  target_format: markdown
7
8
  recipe: specdojo:prj-overview-recipe
@@ -2,6 +2,7 @@
2
2
  specdojo:
3
3
  id: specdojo:prj-scope-rulebook
4
4
  type: rulebook
5
+ deliverable_type: project
5
6
  status: ready
6
7
  target_format: markdown
7
8
  recipe: specdojo:prj-scope-recipe
@@ -2,6 +2,7 @@
2
2
  specdojo:
3
3
  id: specdojo:prj-stakeholder-register-rulebook
4
4
  type: rulebook
5
+ deliverable_type: project
5
6
  status: ready
6
7
  target_format: markdown
7
8
  recipe: specdojo:prj-stakeholder-register-recipe
@@ -2,6 +2,7 @@
2
2
  specdojo:
3
3
  id: specdojo:prj-success-criteria-and-acceptance-criteria-rulebook
4
4
  type: rulebook
5
+ deliverable_type: project
5
6
  status: ready
6
7
  target_format: markdown
7
8
  recipe: specdojo:prj-success-criteria-and-acceptance-criteria-recipe
@@ -2,6 +2,7 @@
2
2
  specdojo:
3
3
  id: specdojo:sac-rulebook
4
4
  type: rulebook
5
+ deliverable_type: requirement
5
6
  status: draft
6
7
  recipe: undecided
7
8
  sample: specdojo:sac-sample
@@ -57,7 +58,7 @@ Frontmatter は `docs/specdojo/schemas/v1/deliverable-frontmatter.schema.yaml`
57
58
  | 項目 | 説明 | 必須 |
58
59
  | ---------- | --------------------------------------------- | ---- |
59
60
  | id | 受入条件ID(`sac-...`) | ○ |
60
- | type | `test` 固定 | ○ |
61
+ | type | `requirement` 固定 | ○ |
61
62
  | title | 受入条件名(例: システム受入条件: 性能) | ○ |
62
63
  | status | `draft`/`ready`/`deprecated` | ○ |
63
64
  | part_of | 上位SAC ID(分割している場合) | 任意 |
@@ -153,7 +154,7 @@ SAC は **Markdown** で「受入対象」と「シナリオ」を記述しま
153
154
  ```yaml
154
155
  ---
155
156
  id: sac-performance
156
- type: test
157
+ type: requirement
157
158
  title: システム受入条件: 性能
158
159
  status: draft
159
160
  part_of: []
@@ -2,6 +2,7 @@
2
2
  specdojo:
3
3
  id: specdojo:sch-rulebook
4
4
  type: rulebook
5
+ deliverable_type: project
5
6
  status: ready
6
7
  target_format: yaml
7
8
  recipe: not-needed
@@ -116,8 +117,10 @@ schema で機械検証できない記述規範だけを定める。設計の考
116
117
  ### 5.5. intent と grade からの strategy 生成
117
118
 
118
119
  - `schedule strategy generate --track <track>` は、既存 strategy の `scope.catalogs` と catalog ごとの `local_ids` を優先し、新規 track では Timeline の `domains` から物理分割を含む DCT を解決する。scope は `include_kinds: [work]` 固定とし、既存の `local_ids` がある場合は選択部分集合だけを生成対象にする。
119
- - `approach_rules` は scope の全 work 成果物を重複なく網羅し、7 種の intent を成果物別に宣言する。`improve-kata` は `kata_target`、`bootstrap-kata-set` と `confirm-with-kata-set` は `bootstrap_scope` も宣言する。
120
+ - `approach_rules` は scope の全 work 成果物を重複なく網羅し、8 種の intent を成果物別に宣言する。`improve-kata` は `kata_target`、`bootstrap-kata-set` と `confirm-with-kata-set` は `bootstrap_scope` も宣言する。
120
121
  - `author-deliverable` の approach は Kata 宣言と保存済み grade から `fully-guided` / `recipe-guided` / `freeform` へ導出する。他の intent は目的別 approach へ一意に写像し、必要な evidence や追加パラメータがなければ生成を停止する。
122
+ - 人が雛形に文脈を記入してから下書きする場合は `draft-with-context` を宣言する。必要な Kata がすべて利用可能な場合だけ `draft` profile を生成し、雛形作成・文脈記入(human)、下書き(`draft`)、磨き込み(`fully-guided`)、review、finalize(human)の順とする。human の着手と完了は claim / complete で記録する。
123
+ - `guided-pass` の草案作成は `draft` とし、文脈がない場合も template を骨組みにして根拠のある内容を下書きする。未委任の調査・選定を行わず、`fully-guided` は後続の既存草案の磨き込みに使う。
121
124
  - 導出した approach は標準 profile へ写像し、`phase_sets`、`default_phase_sets`、`owner_rules`、phase gate、finalize 系フェーズをコードで組み立てる。profile は duration、`execution`、`mode`、`approach`、agent pipeline を一元管理する。
122
125
  - 主担当は `--owner <local_id>=<ROLE>`、既存 strategy の `owner_rules`、`--default-owner <ROLE>` の順に解決する。`done_criteria.roles` はレビュー観点であり主担当の根拠にしない。未解決または `pm-roles.yaml` に存在しない owner があれば生成を停止する。
123
126
  - `bootstrap` と他の approach が同一 track に混在する場合は成果物別に profile を分け、既定では同一カタログの非 bootstrap 成果物を代表 bootstrap 成果物の後に配置する。不要な場合だけ `--no-bootstrap-ordering` を明示する。
@@ -2,6 +2,7 @@
2
2
  specdojo:
3
3
  id: specdojo:sf-index-rulebook
4
4
  type: rulebook
5
+ deliverable_type: requirement
5
6
  status: draft
6
7
  recipe: undecided
7
8
  sample: specdojo:sf-index-sample
@@ -33,12 +34,12 @@ System Functions Index Documentation Rules
33
34
 
34
35
  ## 4. 推奨 Frontmatter 項目
35
36
 
36
- | 項目 | 値 | 必須 |
37
- | -------- | ------------------------------------------------- | ---- |
38
- | id | 一意なID | ○ |
39
- | type | project / spec / test / architecture / operations | ○ |
40
- | status | draft / ready / deprecated | ○ |
41
- | rulebook | `sf-index-rulebook` | 任意 |
37
+ | 項目 | 値 | 必須 |
38
+ | -------- | -------------------------- | ---- |
39
+ | id | 一意なID | ○ |
40
+ | type | `requirement` 固定 | ○ |
41
+ | status | draft / ready / deprecated | ○ |
42
+ | rulebook | `sf-index-rulebook` | 任意 |
42
43
 
43
44
  ## 5. 本文構成(標準テンプレ)
44
45
 
@@ -2,6 +2,7 @@
2
2
  specdojo:
3
3
  id: specdojo:sf-rulebook
4
4
  type: rulebook
5
+ deliverable_type: requirement
5
6
  status: draft
6
7
  recipe: undecided
7
8
  sample: specdojo:sf-sample
@@ -17,7 +18,7 @@ specdojo:
17
18
  | 項目 | 説明 | 必須 |
18
19
  | ---------- | ----------------------------- | ---- |
19
20
  | id | 機能一覧ID (sf-xxx-xxxx) | ○ |
20
- | type | `domain` 固定 | ○ |
21
+ | type | `requirement` 固定 | ○ |
21
22
  | title | 機能一覧名 | ○ |
22
23
  | status | `draft`/`ready`/`deprecated` | ○ |
23
24
  | supersedes | 置き換え関係(古仕様→新仕様) | 任意 |
@@ -26,7 +27,7 @@ specdojo:
26
27
 
27
28
  - 機能一覧IDは正規表現 `^sf-[a-z0-9-]+$` に合致する一意IDを使用する。
28
29
 
29
- - `type: data` は業務ドメイン仕様であることを示す。
30
+ - `type: requirement` は機能・業務イベントの要件であることを示します。
30
31
 
31
32
  ドキュメントID・機能IDともに `sf-` プレフィックスの `lower-kebab` 形式(正規表現: `^sf-[a-z0-9-]+$`)を使用します。
32
33
  一覧ハブには `sf-index`、個別機能には `sf-<機能名>` を付与してください(例: `sf-product-register`)。
@@ -58,7 +59,7 @@ specdojo:
58
59
  ```yaml
59
60
  ---
60
61
  id: sf-index
61
- type: data
62
+ type: requirement
62
63
  title: システム化機能一覧(main)
63
64
  status: draft
64
65
 
@@ -2,6 +2,7 @@
2
2
  specdojo:
3
3
  id: specdojo:sld-rulebook
4
4
  type: rulebook
5
+ deliverable_type: data
5
6
  status: draft
6
7
  recipe: undecided
7
8
  sample: specdojo:sld-sample
@@ -17,7 +18,7 @@ specdojo:
17
18
  | 項目 | 説明 | 必須 |
18
19
  | ---- | ----------------------------- | ---- |
19
20
  | id | 保管場所一覧ID (sll-xxx-xxxx) | ○ |
20
- | type | `domain` 固定 | ○ |
21
+ | type | `data` 固定 | ○ |
21
22
 
22
23
  | title | 保管場所一覧名 | ○ |
23
24
  | status | `draft`/`ready`/`deprecated` | ○ |
@@ -2,6 +2,7 @@
2
2
  specdojo:
3
3
  id: specdojo:stc-index-rulebook
4
4
  type: rulebook
5
+ deliverable_type: test
5
6
  status: draft
6
7
  recipe: undecided
7
8
  sample: specdojo:stc-index-sample
@@ -2,6 +2,7 @@
2
2
  specdojo:
3
3
  id: specdojo:stc-rulebook
4
4
  type: rulebook
5
+ deliverable_type: test
5
6
  status: draft
6
7
  recipe: undecided
7
8
  sample: specdojo:stc-sample
@@ -2,6 +2,7 @@
2
2
  specdojo:
3
3
  id: specdojo:stsd-mermaid-rulebook
4
4
  type: rulebook
5
+ deliverable_type: data
5
6
  status: draft
6
7
  target_format: markdown
7
8
  recipe: not-needed
@@ -2,6 +2,7 @@
2
2
  specdojo:
3
3
  id: specdojo:stsd-rulebook
4
4
  type: rulebook
5
+ deliverable_type: data
5
6
  status: draft
6
7
  target_format: markdown
7
8
  recipe: specdojo:stsd-recipe
@@ -2,6 +2,7 @@
2
2
  specdojo:
3
3
  id: specdojo:sysd-critical-flows-rulebook
4
4
  type: rulebook
5
+ deliverable_type: architecture
5
6
  status: draft
6
7
  sample: specdojo:sysd-critical-flows-sample
7
8
  ---
@@ -66,7 +67,7 @@ Frontmatter は共通スキーマに従います(参照: [docs/specdojo/schema
66
67
 
67
68
  | ---------- | ----------------------------------------------- | ---- |
68
69
  | id | SYSD-CF ID(推奨: `sysd-critical-flows`) | ○ |
69
- | type | `architecture` など共通スキーマで許容される種別 | ○ |
70
+ | type | `architecture` 固定 | ○ |
70
71
  | title | システム設計: 重要フロー | ○ |
71
72
  | status | `draft` / `ready` / `deprecated` | ○ |
72
73
  | based_on | 根拠となる仕様ID(ID配列。未指定は `[]` 可) | 任意 |
@@ -2,6 +2,7 @@
2
2
  specdojo:
3
3
  id: specdojo:sysd-cross-cutting-policy-rulebook
4
4
  type: rulebook
5
+ deliverable_type: architecture
5
6
  status: draft
6
7
  sample: specdojo:sysd-cross-cutting-policy-sample
7
8
  ---
@@ -64,14 +65,14 @@ SYSD-CCP は、以下を目的とする。
64
65
 
65
66
  Frontmatter は共通スキーマに従います(参照: [docs/specdojo/schemas/v1/deliverable-frontmatter.schema.yaml](../../../specdojo/schemas/v1/deliverable-frontmatter.schema.yaml) / [document-metadata-standard.md](../standards/document-metadata-standard.md))。
66
67
 
67
- | 項目 | 説明 | 必須 |
68
- | ---------- | ------------------------------------------------- | ---- |
69
- | id | SYSD-CCP ID(推奨: `sysd-cross-cutting-policy`) | ○ |
70
- | type | `architecture` など、共通スキーマで許容される種別 | ○ |
71
- | title | システム設計: 横断ルール | ○ |
72
- | status | `draft` / `ready` / `deprecated` | ○ |
73
- | based_on | 根拠となる仕様ID(ID配列。未指定は `[]` 可) | 任意 |
74
- | supersedes | 置き換え関係(ID配列。未指定は `[]` 可) | 任意 |
68
+ | 項目 | 説明 | 必須 |
69
+ | ---------- | ------------------------------------------------ | ---- |
70
+ | id | SYSD-CCP ID(推奨: `sysd-cross-cutting-policy`) | ○ |
71
+ | type | `architecture` 固定 | ○ |
72
+ | title | システム設計: 横断ルール | ○ |
73
+ | status | `draft` / `ready` / `deprecated` | ○ |
74
+ | based_on | 根拠となる仕様ID(ID配列。未指定は `[]` 可) | 任意 |
75
+ | supersedes | 置き換え関係(ID配列。未指定は `[]` 可) | 任意 |
75
76
 
76
77
  ### 4.2. 推奨ルール
77
78
 
@@ -2,6 +2,7 @@
2
2
  specdojo:
3
3
  id: specdojo:sysd-index-rulebook
4
4
  type: rulebook
5
+ deliverable_type: architecture
5
6
  status: draft
6
7
  recipe: not-needed
7
8
  sample: specdojo:sysd-index-sample
@@ -63,7 +64,7 @@ Frontmatter は共通スキーマに従います(参照: [docs/specdojo/schema
63
64
  | 項目 | 説明 | 必須 |
64
65
  | ---------- | ------------------------------------------------------ | ---- |
65
66
  | id | SYSD ID(推奨: `sysd-index`) | ○ |
66
- | type | `architecture` など、共通スキーマで許容される種別 | ○ |
67
+ | type | `architecture` 固定 | ○ |
67
68
  | title | システム設計: 全体構成(リンク集)など対象が分かる名称 | ○ |
68
69
  | status | `draft` / `ready` / `deprecated` | ○ |
69
70
  | based_on | 根拠となる仕様ID(ID配列。未指定は `[]` 可) | 任意 |
@@ -2,6 +2,7 @@
2
2
  specdojo:
3
3
  id: specdojo:sysd-rulebook
4
4
  type: rulebook
5
+ deliverable_type: architecture
5
6
  status: draft
6
7
  target_format: markdown
7
8
  template: not-needed
@@ -2,6 +2,7 @@
2
2
  specdojo:
3
3
  id: specdojo:tml-rulebook
4
4
  type: rulebook
5
+ deliverable_type: project
5
6
  status: draft
6
7
  target_format: yaml
7
8
  recipe: not-needed
@@ -2,6 +2,7 @@
2
2
  specdojo:
3
3
  id: specdojo:trc-requirements-to-specs-rulebook
4
4
  type: rulebook
5
+ deliverable_type: project
5
6
  status: draft
6
7
  sample: specdojo:trc-requirements-to-specs-sample
7
8
  ---
@@ -2,6 +2,7 @@
2
2
  specdojo:
3
3
  id: specdojo:trc-requirements-to-tests-rulebook
4
4
  type: rulebook
5
+ deliverable_type: project
5
6
  status: draft
6
7
  sample: specdojo:trc-requirements-to-tests-sample
7
8
  ---
@@ -2,100 +2,119 @@
2
2
  specdojo:
3
3
  id: specdojo:tsd-index-rulebook
4
4
  type: rulebook
5
- status: draft
5
+ deliverable_type: architecture
6
+ status: ready
6
7
  recipe: not-needed
7
8
  sample: specdojo:tsd-index-sample
8
9
  template: not-needed
9
10
  ---
10
11
 
11
- # 技術スタック定義(TSD Index)作成ルール
12
+ # 技術スタック一覧(TSD Index)作成ルール
12
13
 
13
- Technology Stack Definition Index (TSD Index) Documentation Rules
14
+ Technology Stack Index (TSD Index) Documentation Rules
14
15
 
15
- `tsd-index.md` は、プロダクトが採用する技術の **全体インベントリ(一覧表)** を一箇所に集約する入口ドキュメントである。採用技術の担当責務を関係者間で合意するための最小限の一覧を定義し、詳細は `tsd-<term>.md` にリンクで繋ぐ。
16
+ `tsd-index.md` は、対象システムや開発基盤で採用する技術と担当責務を一覧にし、詳細な構成・設定の正本へ導く入口文書である。技術の用途と適用範囲を俯瞰し、構築、実装、運用、変更時に参照すべき定義を判断できる内容を記載する。
16
17
 
17
18
  ## 1. 全体方針
18
19
 
19
- - 1プロジェクト(システム)に対して `tsd-index.md` は1つだけ作成する
20
- - 採用技術の全区分を漏れなく記載し、詳細ドキュメント(`tsd-<term>.md`)への入口とする
21
- - 表形式(Markdown)で管理し、機械判読用途には使わない
22
- - ベンダー固有の接続情報・機密値・バージョン固定値は記載しない
23
- - 採用が確定した技術のみを記載し、候補・検討中は含めない
20
+ - 一つのシステムまたは合意した対象範囲につき、技術一覧の正本を一つにする。複数システムを扱う場合は、一覧の対象範囲を明示する。
21
+ - 採用技術の名称、区分、担当責務を一覧で対応させる。実行基盤だけでなく、対象範囲に含まれる開発、検証、文書化、配布、運用の技術も扱う。
22
+ - すべての依存パッケージを列挙するのではなく、構成や作業の前提として関係者が把握すべき技術を選ぶ。
23
+ - 採用済みの必須構成と任意利用の構成を区別する。未決の候補は採用技術に混ぜず、判断の記録へ導く。
24
+ - 詳細な設定、構築手順、接続方法、資源制約は `tsd-<term>` または設定ファイルなどの正本へ委ねる。
25
+ - 版の粒度と参照元を明確にし、lockfile や詳細 TSD と異なる固定値を二重管理しない。
24
26
 
25
27
  ## 2. 位置づけ
26
28
 
27
- `tsd-index` と `tsd-<term>` の関係:
29
+ | 文書・情報 | 役割 | 一覧からの導線 |
30
+ | ------------------------ | ------------------------------------ | ------------------------------------------ |
31
+ | `tsd-index` | 採用技術と担当責務の全体一覧 | 対象範囲の技術を俯瞰する入口とする |
32
+ | `tsd-<term>` | 技術領域や実行基盤の詳細定義 | 構成、前提、設定、導入、動作確認を参照する |
33
+ | 接続設定・日常利用の TSD | 基盤を利用するクライアント設定や操作 | 初期構築と利用時の手順を区別して導く |
34
+ | 設定ファイル・依存定義 | 実際に適用する版や設定の正本 | 正確な版や有効設定が必要な場合に参照する |
35
+ | 採用判断の記録 | 技術を選んだ理由と未決事項 | 一覧で説明しきれない判断の根拠へ導く |
28
36
 
29
- | ドキュメント | 役割 | 粒度 |
30
- | ------------ | ---------------------------------- | ----------------------------- |
31
- | `tsd-index` | 採用技術の全体インベントリ(入口) | 区分・技術名・責務を1行で表す |
32
- | `tsd-<term>` | 特定技術領域の詳細設定・構成 | 複数セクションで詳述 |
33
-
34
- `tsd-index` は全区分を俯瞰でき、必要に応じて `tsd-<term>` へリンクする。詳細設定・手順・コードブロックは `tsd-<term>` に委ねる。
37
+ - 詳細 TSD が未作成でも、採用が確認できた技術と担当責務は一覧に記載してよい。未整備の詳細文書を存在するように参照しない。
38
+ - 一つの技術に基盤設定と接続設定など複数の詳細文書がある場合は、参照先ごとの役割を示す。
39
+ - 同じ技術を複数の用途で使う場合は、責務を一行にまとめるか、適用範囲を明示して行を分ける。説明のない重複は作らない。
35
40
 
36
41
  ## 3. ファイル命名・ID規則
37
42
 
38
- - ファイル名: `tsd-index.md`(固定)
39
- - `id`: `tsd-index`(固定)
40
- - 配置先: プロジェクトのアーキテクチャディレクトリ(例: `030-architecture/020-infrastructure/`)
43
+ - ファイル名は `tsd-index.md` とする。
44
+ - `id` は `tsd-index` を基準に、名前空間と対象範囲内の一意性を共通のメタデータ規約に従って定める。
45
+ - 配置先はプロジェクトのアーキテクチャまたは技術基盤の文書群とし、詳細な `tsd-<term>.md` も同じ文書群にまとめる。
46
+ - 環境や領域ごとの補足を分冊する場合も、全体一覧の正本を複製せず、本書から参照する。
41
47
 
42
48
  ## 4. 推奨 Frontmatter 項目
43
49
 
44
- | 項目 | 値 | 必須 |
45
- | ---------- | -------------------------------- | ---- |
46
- | `id` | `tsd-index` | ○ |
47
- | `type` | `architecture` | ○ |
48
- | `status` | `draft` / `ready` / `deprecated` | ○ |
49
- | `rulebook` | `specdojo:tsd-index-rulebook` | 推奨 |
50
- | `based_on` | 根拠となる仕様 ID(配列) | 任意 |
50
+ 項目は `specdojo` 配下に置く。共通の型と参照形式は [document-metadata-standard.md](../standards/document-metadata-standard.md) と成果物の Frontmatter スキーマに従う。
51
+
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 配列 |
51
61
 
52
- ## 5. 本文構成(標準テンプレ)
62
+ ## 5. 本文要件
53
63
 
54
- | 章番号 | 章タイトル | 必須 | 説明 |
55
- | ------ | ---------------- | ---- | --------------------------------- |
56
- | 1 | 技術スタック一覧 | ○ | 全区分を網羅する一覧表(表1つ) |
57
- | 2 | 補足 | 任意 | `tsd-<term>` へのリンク・注意事項 |
64
+ | 内容 | 必須 | 目的・記述要件 |
65
+ | ------------------ | -------- | --------------------------------------------------------------- |
66
+ | 冒頭の概要 | ○ | 対象システム、環境、一覧の利用目的と対象範囲を 1〜3 文で示す |
67
+ | 技術スタック一覧 | ○ | 区分、採用技術、担当責務を一つの主一覧表で対応させる |
68
+ | 補足・詳細への導線 | 条件付き | 詳細 TSD や設定の正本がある場合、各参照先の役割と適用条件を示す |
58
69
 
59
- - `技術スタック一覧` は表1つで構成する(区分ごとに複数表に分割しない)
60
- - `補足` には詳細ドキュメントへのリンクを記載し、技術固有の説明は書かない
70
+ - 実行時に使う技術と、開発・検証・運用に使う技術の範囲が分かるようにする。対象外の領域まで空欄や仮の技術で埋めない。
71
+ - 版、利用環境、必須・任意が判断に必要な場合は、一覧の列または補足に記載する。
72
+ - 補足では全体の共通条件と参照先を示し、設定値や手順の詳細を転載しない。
61
73
 
62
74
  ## 6. 記述ガイド
63
75
 
64
- ### 6.1. 技術スタック一覧表
76
+ ### 6.1. 技術スタック一覧の列
77
+
78
+ | 列 | 必須 | 記述内容 |
79
+ | ---------- | -------- | -------------------------------------------------------------------- |
80
+ | 区分 | ○ | 言語、ランタイム、DB、文書化など、利用目的を俯瞰できる分類 |
81
+ | 採用技術 | ○ | 製品・サービス・技術の識別できる名称。版を含める場合は粒度をそろえる |
82
+ | 担当責務 | ○ | 対象システムや作業のどこで、何を担うか |
83
+ | 版・正本 | 条件付き | 版の制約、または正確な版を管理する設定ファイル・詳細文書 |
84
+ | 適用範囲 | 条件付き | 対象環境、実行場所、必須・任意など、利用条件の違い |
85
+ | 詳細・備考 | 任意 | 詳細 TSD への参照、短い制約や選定理由 |
65
86
 
66
- 必須列:
87
+ - 担当責務は「開発用」「利用する」だけで終えず、対象と役割を一文で示す。
88
+ - 複数の製品を一つの実行基盤としてまとめる場合は、構成の内訳と各役割を詳細 TSD へ導く。
89
+ - 版を採用技術名に含める場合は、別の版列で同じ情報を繰り返さない。
67
90
 
68
- | 列名 | 説明 |
69
- | -------- | ------------------------------------------------------------------ |
70
- | 区分 | カテゴリ(例: 言語 / ランタイム / DB / ホスティング) |
71
- | 採用技術 | 技術名とメジャーバージョン(例: `TypeScript 5.x`、`Node.js 24.x`) |
72
- | 担当責務 | その技術を何に使うか(判定可能な粒度で1行) |
91
+ ### 6.2. 区分と網羅範囲
73
92
 
74
- 必要に応じて `補足` 列を追加してよい。
93
+ - 言語・ランタイム・フレームワーク、データ保存・連携、ホスティング・ネットワークなど、対象の実行に必要な技術を確認する。
94
+ - build・テスト・静的検査・文書化・図解・ソース管理・CI/CD・パッケージ配布・運用監視など、対象の開発と保守を支える技術も確認する。
95
+ - AI 実行環境やローカルモデル基盤など固有の領域は、実際に採用した範囲で追加する。区分名や製品名の例を、すべてのプロジェクトの必須構成にしない。
75
96
 
76
- 区分の推奨値:
97
+ ### 6.3. 版と採用状態
77
98
 
78
- - 言語 / ランタイム
79
- - CLI フレームワーク / Web FW
80
- - DB / MQ / Cache
81
- - スキーマ検証 / Markdown lint / コードフォーマット
82
- - ドキュメントサイト / 図解生成
83
- - Git フック / コミット規約
84
- - ソースコード管理 / CI/CD / パッケージ配信
85
- - AI エージェント実行 / ローカル LLM
99
+ - 一覧ではメジャーバージョンや互換性の制約など、構成を理解するために必要な粒度を使う。特定の版が採用判断に不可欠な場合は、その理由と正本を示す。
100
+ - 正確なパッチ版や依存解決結果を lockfile などで管理する場合は、その参照先を示す。確認していない版を推測で記入しない。
101
+ - 任意利用の技術は、採用済みの選択肢であることと適用条件を明示する。未採択の比較候補や将来案は、採用一覧の外で扱う。
102
+ - 「最新版」と記載する場合は、取得元と更新方針を示す。実際に使用した版の確認方法が分からない表現にしない。
86
103
 
87
- ### 6.2. 補足
104
+ ### 6.4. 詳細文書と更新
88
105
 
89
- - 詳細ドキュメント(`tsd-<term>.md`)が存在する場合はリンクを記載する
90
- - 補足に技術の設定手順・構成詳細を記述しない(`tsd-<term>` に委ねる)
106
+ - 技術の初期構築、クライアント接続、日常利用を分冊している場合は、それぞれの目的が分かる参照名にする。
107
+ - 採用・廃止・責務・適用範囲が変わったときに一覧を更新し、詳細 TSD や設定の正本との不一致を確認する。
108
+ - 未作成の詳細や未決の条件は共通ラベルで示し、仮の参照先や設定値を確定情報として残さない。
91
109
 
92
110
  ## 7. 禁止事項
93
111
 
94
- | 禁止事項 | 理由 |
95
- | ------------------------------------------------------------------- | -------------------------------------- |
96
- | 同じ技術を複数の区分に重複記載する | 一覧の見通しが悪くなるため |
97
- | 担当責務を空欄にする | 合意の根拠がなくなるため |
98
- | 接続情報・API キー・機密 URL を記載する | セキュリティリスクになるため |
99
- | `tsd-<term>` の詳細内容(設定手順・コードブロック)を本文に展開する | インデックスの責務を逸脱するため |
100
- | 採用が確定していない技術を記載する | 前提条件として誤認されるため |
101
- | `tsd-index` を複数作成する | 全体インベントリの SSOT が分散するため |
112
+ | 禁止事項 | 理由 |
113
+ | ------------------------------------------------------------ | ---------------------------------------------- |
114
+ | 担当責務を空欄や技術名の言い換えだけにする | 採用技術が担う役割を判断できないため |
115
+ | 採用済みの構成と未決の候補を区別せず並べる | 構築や実装の前提を誤らせるため |
116
+ | 同じ技術や一覧を、適用範囲を示さず重複させる | 責務と更新先が分からなくなるため |
117
+ | 全依存パッケージやすべての版固定値を転載する | 一覧の目的を超え、依存定義と二重管理になるため |
118
+ | 詳細設定、接続先、構築コマンド、コードを一覧の本文へ展開する | 詳細 TSD や設定の正本との責務が重なるため |
119
+ | API キー、トークン、秘密鍵、機密の接続情報を記載する | 一覧の配布や履歴を通じて漏れるため |
120
+ | 任意利用の製品や実例の構成を一律の必須技術にする | 対象範囲や環境による違いを失うため |