specdojo 0.6.0 → 0.8.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 (366) hide show
  1. package/.github/agents/specdojo-orchestrator.md +3 -2
  2. package/CHANGELOG.md +193 -0
  3. package/README.md +2 -2
  4. package/dist/catalog/build.js +24 -1
  5. package/dist/catalog/plan.js +1 -1
  6. package/dist/catalog/scaffold.js +4 -1
  7. package/dist/commands/agent.js +33 -0
  8. package/dist/commands/init.js +6 -1
  9. package/dist/commands/night-orchestrator.js +6 -4
  10. package/dist/commands/orchestrator.js +10 -1
  11. package/dist/dashboard/dashboard-timeline.js +18 -16
  12. package/dist/dashboard/dashboard.js +612 -259
  13. package/dist/dashboard/epic-plan.js +81 -0
  14. package/dist/dashboard/exec-records.js +16 -20
  15. package/dist/dashboard/routines.js +8 -6
  16. package/dist/dashboard/timeline-build.js +5 -9
  17. package/dist/dashboard/timeline.js +9 -4
  18. package/dist/devcontainer/command.js +18 -0
  19. package/dist/devcontainer/host-script.js +21 -0
  20. package/dist/devcontainer/scaffold.js +22 -3
  21. package/dist/docs/frontmatter-namespace.js +1 -48
  22. package/dist/docs/yaml-pages.js +125 -3
  23. package/dist/exec/agent-config.js +22 -0
  24. package/dist/exec/agent-plan.js +3 -2
  25. package/dist/exec/antigravity-session.js +154 -0
  26. package/dist/exec/commands.js +69 -21
  27. package/dist/exec/commit-hook-skips.js +78 -0
  28. package/dist/exec/core.js +19 -7
  29. package/dist/exec/events.js +159 -8
  30. package/dist/exec/evidence.js +64 -16
  31. package/dist/exec/handoff.js +9 -13
  32. package/dist/exec/limit.js +1 -1
  33. package/dist/exec/mechanical-result.js +45 -0
  34. package/dist/exec/migrate-records.js +249 -0
  35. package/dist/exec/parent-validation.js +160 -12
  36. package/dist/exec/pipeline-state.js +27 -5
  37. package/dist/exec/plan-markdownlint.js +89 -0
  38. package/dist/exec/plans-condense-findings.js +89 -0
  39. package/dist/exec/plans-core.js +24 -17
  40. package/dist/exec/plans-generation.js +52 -25
  41. package/dist/exec/plans-grade-findings.js +8 -3
  42. package/dist/exec/plans-kata-findings.js +61 -0
  43. package/dist/exec/plans-planning.js +3 -3
  44. package/dist/exec/plans-storage.js +12 -24
  45. package/dist/exec/register-resume.js +69 -42
  46. package/dist/exec/register.js +26 -22
  47. package/dist/exec/repo-integration-sync.js +8 -4
  48. package/dist/exec/repo-integration.js +21 -1
  49. package/dist/exec/reporter.js +121 -23
  50. package/dist/exec/results.js +85 -24
  51. package/dist/exec/review-completion.js +47 -0
  52. package/dist/exec/review-kata.js +109 -0
  53. package/dist/exec/run/agent-pipeline.js +75 -6
  54. package/dist/exec/run/agent.js +20 -7
  55. package/dist/exec/run/in-place.js +69 -32
  56. package/dist/exec/run/job.js +81 -24
  57. package/dist/exec/run/lifecycle-commands.js +264 -43
  58. package/dist/exec/run/mode-shared.js +11 -3
  59. package/dist/exec/run/register-command.js +12 -10
  60. package/dist/exec/run/register-core.js +20 -13
  61. package/dist/exec/run/register-mode.js +12 -12
  62. package/dist/exec/run/register-post-review.js +21 -9
  63. package/dist/exec/run/register-resume.js +28 -18
  64. package/dist/exec/run/register-state.js +10 -7
  65. package/dist/exec/run/register-worktree.js +60 -30
  66. package/dist/exec/run/schedule-mode.js +26 -6
  67. package/dist/exec/run/schedule-prepare.js +228 -45
  68. package/dist/exec/run/schedule-task.js +132 -25
  69. package/dist/exec/run/shared.js +4 -3
  70. package/dist/exec/run/trailing-records.js +35 -0
  71. package/dist/exec/run-records.js +2 -0
  72. package/dist/exec/strategy.js +1 -0
  73. package/dist/exec/trailing-records.js +242 -0
  74. package/dist/exec/trial-commands.js +3 -2
  75. package/dist/exec/validate-records-commit.js +110 -0
  76. package/dist/exec/validate-records.js +148 -0
  77. package/dist/exec/worktree-command.js +29 -16
  78. package/dist/exec/worktree-ops-commit.js +118 -59
  79. package/dist/exec/worktree-ops-lifecycle.js +77 -44
  80. package/dist/exec/worktree-ops-merge.js +13 -2
  81. package/dist/exec/worktree-ops.js +2 -2
  82. package/dist/exec/worktree.js +19 -2
  83. package/dist/grade/apply.js +32 -6
  84. package/dist/grade/command-inspect.js +2 -2
  85. package/dist/grade/command-run.js +2 -0
  86. package/dist/grade/command-shared.js +1 -1
  87. package/dist/grade/core.js +18 -5
  88. package/dist/grade/markdown.js +3 -3
  89. package/dist/grade/pipeline-state.js +15 -11
  90. package/dist/grade/plan.js +37 -17
  91. package/dist/grade/result.js +3 -3
  92. package/dist/grade/run.js +23 -3
  93. package/dist/grade/target-discovery.js +17 -4
  94. package/dist/grade/targets.js +12 -11
  95. package/dist/job/job.js +31 -17
  96. package/dist/job/noop.js +104 -0
  97. package/dist/register/core.js +2 -0
  98. package/dist/register/create-commands.js +28 -3
  99. package/dist/register/deliverable-target.js +9 -1
  100. package/dist/register/epic.js +104 -26
  101. package/dist/register/event-merge.js +3 -0
  102. package/dist/register/events.js +4 -0
  103. package/dist/register/external-project.js +3 -0
  104. package/dist/register/item.js +6 -0
  105. package/dist/register/maintenance-commands.js +4 -1
  106. package/dist/register/planning.js +7 -14
  107. package/dist/register/register.js +74 -32
  108. package/dist/register/track-domains.js +34 -0
  109. package/dist/register/track-plan.js +78 -0
  110. package/dist/register/transition-commands.js +8 -0
  111. package/dist/register/work-table.js +64 -0
  112. package/dist/review/grade.js +35 -13
  113. package/dist/routine/definition.js +4 -3
  114. package/dist/routine/failure.js +30 -0
  115. package/dist/routine/routine.js +56 -32
  116. package/dist/routine/storage.js +33 -0
  117. package/dist/schedule/schedule.js +1 -0
  118. package/dist/schedule/strategy-generate-document.js +26 -14
  119. package/dist/schedule/strategy-generate-scope.js +17 -45
  120. package/dist/schedule/strategy-generate.js +33 -3
  121. package/dist/schedule/strategy-profiles.js +86 -12
  122. package/dist/shared/agent-types.js +2 -0
  123. package/dist/shared/condense-records.js +25 -0
  124. package/dist/shared/deprecation.js +8 -0
  125. package/dist/shared/document-metadata.js +20 -0
  126. package/dist/shared/finding-cause.js +20 -0
  127. package/dist/shared/frontmatter-namespace.js +48 -0
  128. package/dist/shared/git.js +149 -15
  129. package/dist/shared/grade-result.js +17 -1
  130. package/dist/shared/local-state.js +20 -0
  131. package/dist/shared/markdownlint-config.js +8 -3
  132. package/dist/shared/plan-conventions.js +129 -0
  133. package/dist/shared/plan-templates.js +57 -41
  134. package/dist/shared/provider-scaffold.js +2 -0
  135. package/dist/shared/run-records.js +224 -0
  136. package/dist/shared/specdojo-config.js +39 -21
  137. package/dist/shared/specdojo-gitignore.js +1 -0
  138. package/dist/shared/text.js +65 -5
  139. package/dist/shared/timeline-index.js +2 -0
  140. package/docs/ja/specdojo/defaults/pm-review-viewpoints.yaml +11 -2
  141. package/docs/ja/specdojo/exec-templates/xep-common-conventions-template.md +4 -74
  142. package/docs/ja/specdojo/exec-templates/xep-condense-template.md +50 -0
  143. package/docs/ja/specdojo/exec-templates/xep-draft-template.md +17 -5
  144. package/docs/ja/specdojo/exec-templates/xep-fully-guided-template.md +16 -3
  145. package/docs/ja/specdojo/exec-templates/xep-recipe-guided-template.md +15 -5
  146. package/docs/ja/specdojo/exec-templates/xep-recipe-maintenance-template.md +6 -0
  147. package/docs/ja/specdojo/exec-templates/xep-register-template.md +1 -1
  148. package/docs/ja/specdojo/exec-templates/xep-rulebook-maintenance-template.md +6 -0
  149. package/docs/ja/specdojo/exec-templates/xep-sample-maintenance-template.md +6 -0
  150. package/docs/ja/specdojo/exec-templates/xep-template-maintenance-template.md +6 -0
  151. package/docs/ja/specdojo/exec-templates/xer-condense-template.md +25 -0
  152. package/docs/ja/specdojo/exec-templates/xp-common-conventions-template.md +50 -0
  153. package/docs/ja/specdojo/exec-templates/xrp-common-conventions-template.md +30 -0
  154. package/docs/ja/specdojo/guides/branch-workflow-guide.md +1 -1
  155. package/docs/ja/specdojo/guides/docs-editing-guide.md +48 -0
  156. package/docs/ja/specdojo/guides/docs-structure-guide.md +48 -15
  157. package/docs/ja/specdojo/guides/exec-config-guide.md +61 -28
  158. package/docs/ja/specdojo/guides/exec-operation-guide.md +61 -13
  159. package/docs/ja/specdojo/guides/exec-worktree-guide.md +20 -11
  160. package/docs/ja/specdojo/guides/orchestrator-operation-guide.md +4 -2
  161. package/docs/ja/specdojo/guides/plan-result-lifecycle-guide.md +92 -55
  162. package/docs/ja/specdojo/guides/project-move-guide.md +381 -0
  163. package/docs/ja/specdojo/guides/quick-start-guide.md +589 -807
  164. package/docs/ja/specdojo/guides/register-operation-guide.md +26 -4
  165. package/docs/ja/specdojo/guides/remote-host-development-guide.md +33 -4
  166. package/docs/ja/specdojo/guides/review-guide.md +22 -19
  167. package/docs/ja/specdojo/guides/routine-operation-guide.md +14 -8
  168. package/docs/ja/specdojo/guides/ryu-guide.md +23 -13
  169. package/docs/ja/specdojo/guides/schedule-design-guide.md +7 -4
  170. package/docs/ja/specdojo/guides/schedule-operation-guide.md +41 -3
  171. package/docs/ja/specdojo/guides/specdojo-overview-guide.md +5 -4
  172. package/docs/ja/specdojo/guides/timeline-design-guide.md +27 -144
  173. package/docs/ja/specdojo/guides/use-case-guide.md +471 -74
  174. package/docs/ja/specdojo/recipes/bac-recipe.md +94 -0
  175. package/docs/ja/specdojo/recipes/bes-recipe.md +105 -0
  176. package/docs/ja/specdojo/recipes/br-recipe.md +84 -0
  177. package/docs/ja/specdojo/recipes/cdfd-overview-recipe.md +88 -86
  178. package/docs/ja/specdojo/recipes/cdfd-uc-recipe.md +108 -122
  179. package/docs/ja/specdojo/recipes/cnd-recipe.md +125 -0
  180. package/docs/ja/specdojo/recipes/cpd-recipe.md +126 -0
  181. package/docs/ja/specdojo/recipes/cxd-recipe.md +145 -0
  182. package/docs/ja/specdojo/recipes/ifd-recipe.md +134 -0
  183. package/docs/ja/specdojo/recipes/ifx-cmd-recipe.md +135 -86
  184. package/docs/ja/specdojo/recipes/ifx-index-recipe.md +130 -0
  185. package/docs/ja/specdojo/recipes/pm-organization-recipe.md +29 -26
  186. package/docs/ja/specdojo/recipes/pm-plan-recipe.md +35 -26
  187. package/docs/ja/specdojo/recipes/pm-quality-management-plan-recipe.md +38 -28
  188. package/docs/ja/specdojo/recipes/pm-raci-recipe.md +39 -31
  189. package/docs/ja/specdojo/recipes/pm-roles-recipe.md +26 -28
  190. package/docs/ja/specdojo/recipes/prj-assumptions-constraints-dependencies-recipe.md +10 -8
  191. package/docs/ja/specdojo/recipes/prj-comparison-of-alternatives-recipe.md +18 -17
  192. package/docs/ja/specdojo/recipes/stsd-recipe.md +100 -62
  193. package/docs/ja/specdojo/recipes/sysd-critical-flows-recipe.md +106 -0
  194. package/docs/ja/specdojo/recipes/sysd-cross-cutting-policy-recipe.md +137 -0
  195. package/docs/ja/specdojo/recipes/sysd-index-recipe.md +122 -0
  196. package/docs/ja/specdojo/references/command-reference.md +146 -99
  197. package/docs/ja/specdojo/references/deliverables-reference.md +9 -4
  198. package/docs/ja/specdojo/references/directory-layout-reference.md +3 -2
  199. package/docs/ja/specdojo/references/specdojo-config-reference.md +17 -16
  200. package/docs/ja/specdojo/rulebooks/bac-rulebook.md +72 -290
  201. package/docs/ja/specdojo/rulebooks/bdd-rulebook.md +212 -79
  202. package/docs/ja/specdojo/rulebooks/bds-rulebook.md +138 -154
  203. package/docs/ja/specdojo/rulebooks/bes-index-rulebook.md +147 -59
  204. package/docs/ja/specdojo/rulebooks/bes-rulebook.md +100 -96
  205. package/docs/ja/specdojo/rulebooks/br-rulebook.md +88 -108
  206. package/docs/ja/specdojo/rulebooks/ccd-mermaid-rulebook.md +126 -211
  207. package/docs/ja/specdojo/rulebooks/cdfd-d2-rulebook.md +367 -0
  208. package/docs/ja/specdojo/rulebooks/cdfd-mermaid-rulebook.md +6 -5
  209. package/docs/ja/specdojo/rulebooks/cdfd-overview-rulebook.md +96 -100
  210. package/docs/ja/specdojo/rulebooks/cdfd-rulebook.md +38 -47
  211. package/docs/ja/specdojo/rulebooks/cdfd-uc-rulebook.md +132 -106
  212. package/docs/ja/specdojo/rulebooks/cdsd-rulebook.md +102 -68
  213. package/docs/ja/specdojo/rulebooks/cdt-rulebook.md +152 -0
  214. package/docs/ja/specdojo/rulebooks/cld-rulebook.md +9 -184
  215. package/docs/ja/specdojo/rulebooks/clis-rulebook.md +187 -0
  216. package/docs/ja/specdojo/rulebooks/cnd-rulebook.md +93 -247
  217. package/docs/ja/specdojo/rulebooks/cpd-rulebook.md +104 -241
  218. package/docs/ja/specdojo/rulebooks/cxd-rulebook.md +124 -257
  219. package/docs/ja/specdojo/rulebooks/dct-index-rulebook.md +87 -98
  220. package/docs/ja/specdojo/rulebooks/dct-rulebook.md +9 -7
  221. package/docs/ja/specdojo/rulebooks/dec-rulebook.md +2 -1
  222. package/docs/ja/specdojo/rulebooks/dss-rulebook.md +193 -0
  223. package/docs/ja/specdojo/rulebooks/gl-rulebook.md +100 -54
  224. package/docs/ja/specdojo/rulebooks/ifd-mermaid-rulebook.md +69 -252
  225. package/docs/ja/specdojo/rulebooks/ifx-cmd-rulebook.md +91 -76
  226. package/docs/ja/specdojo/rulebooks/ifx-file-rulebook.md +252 -226
  227. package/docs/ja/specdojo/rulebooks/ifx-index-rulebook.md +118 -40
  228. package/docs/ja/specdojo/rulebooks/imp-business-rulebook.md +11 -11
  229. package/docs/ja/specdojo/rulebooks/imp-data-rulebook.md +9 -9
  230. package/docs/ja/specdojo/rulebooks/imp-interface-rulebook.md +4 -4
  231. package/docs/ja/specdojo/rulebooks/imp-operations-rulebook.md +11 -11
  232. package/docs/ja/specdojo/rulebooks/imp-test-rulebook.md +11 -11
  233. package/docs/ja/specdojo/rulebooks/mm-rulebook.md +4 -3
  234. package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +34 -29
  235. package/docs/ja/specdojo/rulebooks/pm-change-request-log-rulebook.md +8 -8
  236. package/docs/ja/specdojo/rulebooks/pm-issue-log-rulebook.md +2 -2
  237. package/docs/ja/specdojo/rulebooks/pm-organization-rulebook.md +50 -56
  238. package/docs/ja/specdojo/rulebooks/pm-plan-rulebook.md +46 -55
  239. package/docs/ja/specdojo/rulebooks/pm-quality-management-plan-rulebook.md +57 -54
  240. package/docs/ja/specdojo/rulebooks/pm-raci-rulebook.md +50 -65
  241. package/docs/ja/specdojo/rulebooks/pm-risk-register-rulebook.md +2 -2
  242. package/docs/ja/specdojo/rulebooks/pm-roles-rulebook.md +70 -97
  243. package/docs/ja/specdojo/rulebooks/pr-rulebook.md +2 -1
  244. package/docs/ja/specdojo/rulebooks/prj-assumptions-constraints-dependencies-rulebook.md +47 -56
  245. package/docs/ja/specdojo/rulebooks/prj-comparison-of-alternatives-rulebook.md +61 -135
  246. package/docs/ja/specdojo/rulebooks/sf-index-rulebook.md +116 -32
  247. package/docs/ja/specdojo/rulebooks/sf-rulebook.md +118 -61
  248. package/docs/ja/specdojo/rulebooks/sld-rulebook.md +152 -57
  249. package/docs/ja/specdojo/rulebooks/stsd-mermaid-rulebook.md +51 -39
  250. package/docs/ja/specdojo/rulebooks/stsd-rulebook.md +101 -46
  251. package/docs/ja/specdojo/rulebooks/sysd-critical-flows-rulebook.md +72 -329
  252. package/docs/ja/specdojo/rulebooks/sysd-cross-cutting-policy-rulebook.md +74 -263
  253. package/docs/ja/specdojo/rulebooks/sysd-index-rulebook.md +78 -195
  254. package/docs/ja/specdojo/rulebooks/tml-rulebook.md +4 -9
  255. package/docs/ja/specdojo/rulebooks/trc-requirements-to-specs-rulebook.md +3 -4
  256. package/docs/ja/specdojo/rulebooks/trc-requirements-to-tests-rulebook.md +3 -3
  257. package/docs/ja/specdojo/rulebooks/uis-rulebook.md +140 -143
  258. package/docs/ja/specdojo/samples/bac-sample.md +106 -21
  259. package/docs/ja/specdojo/samples/bdd-sample.yaml +143 -35
  260. package/docs/ja/specdojo/samples/bds-sample.md +100 -21
  261. package/docs/ja/specdojo/samples/bes-index-sample.md +59 -20
  262. package/docs/ja/specdojo/samples/bes-sample.md +80 -21
  263. package/docs/ja/specdojo/samples/br-sample.md +68 -14
  264. package/docs/ja/specdojo/samples/ccd-sample.md +81 -19
  265. package/docs/ja/specdojo/samples/cdfd-overview-sample.md +248 -140
  266. package/docs/ja/specdojo/samples/cdfd-sample.md +172 -99
  267. package/docs/ja/specdojo/samples/cdfd-uc-sample.md +130 -97
  268. package/docs/ja/specdojo/samples/cdsd-sample.md +89 -20
  269. package/docs/ja/specdojo/samples/cdt-sample.md +116 -0
  270. package/docs/ja/specdojo/samples/cld-sample.md +3 -30
  271. package/docs/ja/specdojo/samples/clis-sample.md +132 -0
  272. package/docs/ja/specdojo/samples/cnd-sample.md +127 -21
  273. package/docs/ja/specdojo/samples/cpd-sample.md +136 -22
  274. package/docs/ja/specdojo/samples/cxd-sample.md +108 -22
  275. package/docs/ja/specdojo/samples/dct-index-sample.yaml +63 -17
  276. package/docs/ja/specdojo/samples/dss-sample.md +175 -0
  277. package/docs/ja/specdojo/samples/gl-sample.yaml +50 -14
  278. package/docs/ja/specdojo/samples/ifd-sample.md +105 -21
  279. package/docs/ja/specdojo/samples/ifx-cmd-sample.yaml +91 -60
  280. package/docs/ja/specdojo/samples/ifx-file-sample.md +462 -21
  281. package/docs/ja/specdojo/samples/ifx-index-sample.yaml +87 -19
  282. package/docs/ja/specdojo/samples/pm-members-sample.yaml +37 -13
  283. package/docs/ja/specdojo/samples/pm-organization-sample.md +52 -20
  284. package/docs/ja/specdojo/samples/pm-plan-sample.md +84 -26
  285. package/docs/ja/specdojo/samples/pm-quality-management-plan-sample.md +55 -22
  286. package/docs/ja/specdojo/samples/pm-raci-sample.md +69 -28
  287. package/docs/ja/specdojo/samples/pm-roles-sample.yaml +13 -12
  288. package/docs/ja/specdojo/samples/prj-assumptions-constraints-dependencies-sample.md +50 -26
  289. package/docs/ja/specdojo/samples/prj-comparison-of-alternatives-sample.md +89 -62
  290. package/docs/ja/specdojo/samples/sf-index-sample.md +89 -20
  291. package/docs/ja/specdojo/samples/sf-sample.md +121 -21
  292. package/docs/ja/specdojo/samples/sld-sample.md +107 -21
  293. package/docs/ja/specdojo/samples/stsd-sample.md +54 -26
  294. package/docs/ja/specdojo/samples/sysd-critical-flows-sample.md +166 -21
  295. package/docs/ja/specdojo/samples/sysd-cross-cutting-policy-sample.md +178 -21
  296. package/docs/ja/specdojo/samples/sysd-index-sample.md +82 -21
  297. package/docs/ja/specdojo/samples/tml-sample.yaml +4 -1
  298. package/docs/ja/specdojo/samples/uis-sample.md +164 -20
  299. package/docs/ja/specdojo/standards/document-metadata-standard.md +33 -4
  300. package/docs/ja/specdojo/standards/id-and-file-naming-standard.md +3 -1
  301. package/docs/ja/specdojo/standards/rulebook-authoring-standard.md +1 -0
  302. package/docs/ja/specdojo/templates/bac-template.md +76 -0
  303. package/docs/ja/specdojo/templates/bes-template.md +56 -0
  304. package/docs/ja/specdojo/templates/br-template.md +64 -0
  305. package/docs/ja/specdojo/templates/cdfd-overview-template.md +161 -83
  306. package/docs/ja/specdojo/templates/cdfd-template.md +81 -54
  307. package/docs/ja/specdojo/templates/cdfd-uc-template.md +130 -89
  308. package/docs/ja/specdojo/templates/cnd-template.md +137 -0
  309. package/docs/ja/specdojo/templates/cpd-template.md +129 -0
  310. package/docs/ja/specdojo/templates/cxd-template.md +105 -0
  311. package/docs/ja/specdojo/templates/dct-data-model-cdt-template.yaml +40 -0
  312. package/docs/ja/specdojo/templates/dct-data-model-cld-template.yaml +7 -14
  313. package/docs/ja/specdojo/templates/dct-index-template.md +9 -20
  314. package/docs/ja/specdojo/templates/dct-project-management-template.yaml +5 -1
  315. package/docs/ja/specdojo/templates/ifd-template.md +86 -0
  316. package/docs/ja/specdojo/templates/ifx-cmd-template.yaml +44 -28
  317. package/docs/ja/specdojo/templates/ifx-index-template.yaml +40 -0
  318. package/docs/ja/specdojo/templates/opr-template.md +2 -4
  319. package/docs/ja/specdojo/templates/pm-organization-template.md +9 -3
  320. package/docs/ja/specdojo/templates/pm-plan-template.md +4 -4
  321. package/docs/ja/specdojo/templates/pm-quality-management-plan-template.md +17 -9
  322. package/docs/ja/specdojo/templates/pm-raci-template.md +24 -13
  323. package/docs/ja/specdojo/templates/pm-roles-template.yaml +3 -2
  324. package/docs/ja/specdojo/templates/prj-assumptions-constraints-dependencies-template.md +6 -3
  325. package/docs/ja/specdojo/templates/prj-comparison-of-alternatives-template.md +22 -19
  326. package/docs/ja/specdojo/templates/stsd-template.md +46 -21
  327. package/docs/ja/specdojo/templates/sysd-critical-flows-template.md +94 -0
  328. package/docs/ja/specdojo/templates/sysd-cross-cutting-policy-template.md +122 -0
  329. package/docs/ja/specdojo/templates/sysd-index-template.md +89 -0
  330. package/docs/specdojo/lib/yaml-metadata.cjs +7 -0
  331. package/docs/specdojo/schemas/v1/bdd.schema.yaml +25 -57
  332. package/docs/specdojo/schemas/v1/condense-records.schema.yaml +26 -0
  333. package/docs/specdojo/schemas/v1/dct.schema.yaml +10 -0
  334. package/docs/specdojo/schemas/v1/deliverable-frontmatter.schema.yaml +3 -0
  335. package/docs/specdojo/schemas/v1/esil.schema.yaml +7 -141
  336. package/docs/specdojo/schemas/v1/exec-common.schema.yaml +3 -0
  337. package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +54 -3
  338. package/docs/specdojo/schemas/v1/exec-evidence.schema.yaml +3 -0
  339. package/docs/specdojo/schemas/v1/exec-plan-frontmatter.schema.yaml +14 -0
  340. package/docs/specdojo/schemas/v1/exec-result-frontmatter.schema.yaml +18 -0
  341. package/docs/specdojo/schemas/v1/finding-cause.schema.yaml +22 -0
  342. package/docs/specdojo/schemas/v1/grade-pipeline-state.schema.yaml +1 -1
  343. package/docs/specdojo/schemas/v1/grade-result.schema.yaml +2 -0
  344. package/docs/specdojo/schemas/v1/ifx-cmd.schema.yaml +65 -5
  345. package/docs/specdojo/schemas/v1/ifx-index.schema.yaml +142 -0
  346. package/docs/specdojo/schemas/v1/register-events.schema.yaml +2 -0
  347. package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +17 -1
  348. package/docs/specdojo/schemas/v1/specdojo-config.schema.yaml +1 -0
  349. package/package.json +6 -3
  350. package/templates/antigravity/README.md +19 -46
  351. package/templates/antigravity/exec-defaults-snippet.yaml +5 -6
  352. package/templates/antigravity/orchestrator.md +3 -2
  353. package/templates/antigravity/settings.edit.json +73 -0
  354. package/templates/antigravity/settings.orchestrator.json +15 -0
  355. package/templates/antigravity/settings.report.json +7 -0
  356. package/templates/antigravity/settings.review.json +7 -0
  357. package/templates/claude/agents/specdojo-orchestrator.md +3 -2
  358. package/templates/codex/agents/specdojo-orchestrator.toml +3 -2
  359. package/templates/codex/orchestrator.md +3 -2
  360. package/templates/devcontainer/remote-host/devcontainer-tmux.sh +217 -0
  361. package/templates/devcontainer/remote-host/specdojo-tmux.sh.sample +8 -96
  362. package/templates/devcontainer/remote-host/ssh-config.sample +3 -1
  363. package/templates/devcontainer/tmux.conf +6 -0
  364. package/templates/init-agent-members.yaml +1 -0
  365. package/templates/init-exec-defaults.yaml +1 -1
  366. package/templates/opencode/agents/specdojo-orchestrator.md +3 -2
@@ -16,133 +16,174 @@ specdojo:
16
16
 
17
17
  # 概念データフロー図(ユースケース別): _USE_CASE_NAME_
18
18
 
19
- _TODO_: 全体概要のケース `_CASE_ID_` が扱うユースケースと、複数のプロセスグループを横断して定める目的を一文で記述する。
19
+ _TODO_: 全体概要のケース `_CASE_ID_` が扱うユースケースまたは系統を一文で示す。
20
20
 
21
21
  ## 1. 目的
22
22
 
23
- _TODO_: 対象者ごとに、横断順序、引き渡し条件、例外時の戻り先を承認・設計・確認する利用結果を記述する。
24
-
25
- - _ROLE_ は、_TODO_: グループの通過順と責任境界を承認する。
26
- - _ROLE_ は、_TODO_: 引き渡す情報と条件を後続設計へ利用する。
27
- - _ROLE_ は、_TODO_: 引き渡しと戻り経路の重複・欠落を確認する。
23
+ _TODO_: その業務が何のためにあるか、どの出来事からどの成果までを成立させるかを 1〜2 文で書く。読み手の承認・設計・確認作業は書かない。
28
24
 
29
25
  ## 2. 適用範囲
30
26
 
31
- - ケース: `_CASE_ID_` _USE_CASE_NAME_。_TODO_: `cdfd-overview` と同じケース ID、名称、業務目的を書く。
32
- - 開始イベント: _START_EVENT_。_TODO_: 最初のグループが動き始める出来事を書く。
33
- - 終了条件: _END_CONDITION_。_TODO_: 最後のグループが成果を利用可能と判断できる条件を書く。
34
- - 横断するプロセスグループ: _PROCESS_GROUP_NAME_ → _PROCESS_GROUP_NAME_。_TODO_: 正常系の通過順で二つ以上を書く。
35
- - 組織境界: _TODO_: 引き渡し可否、戻し、再開を判断するロールと、対象範囲外の主体を書く。
36
- - システム境界: _TODO_: 横断条件の判定と情報・物の引き渡しまでを対象とし、画面・保存方式などの実装詳細を対象外とする旨を書く。
37
- - 対象外: グループ内部の領域・プロセス・主要例外・補助操作は各 `cdfd-_GROUP_`、状態の定義と遷移は STSD を正本とし、本書では再掲しない。
38
- - 責任分担: _TODO_: 人間と AI Agent の責任分担を定める既存文書への参照を書く。参照先がない場合は、承認と最終判断を人間が担う原則を書く。
39
-
40
- ## 3. プロセス領域
41
-
42
- ケース `_CASE_ID_` は _GROUP_COUNT_ のプロセスグループを正常系の順序で横断する。グループ名、含む領域、業務目的は全体概要を正本とし、本章では各グループがこのユースケースで担う役割を定める。
27
+ - **対象**: ケース `_CASE_ID_`「_USE_CASE_NAME_」の _START_EVENT_ から _END_EVENT_ まで、_TODO_: 参加単位と必要な組織・システム境界を 1 行で書く。
28
+ - **対象外**: _TODO_: rulebook の「描き方の選択」に従う対象外、補助操作・実装詳細、状態定義・遷移を委ねる STSD を 1 行で示し、共通の責任分担は全体概要を参照する。
43
29
 
44
- <!-- 正常系で通過するプロセスグループごとに 3.n の節を繰り返す。同じグループが再登場する場合は別の節とし、理由を書く。 -->
30
+ <!-- based_on と本文では、有効な全体概要や後継文書を参照し、deprecated の文書は参照しない。既存文書は project 修飾 doc id の wikilink、未作成文書は ID のインラインコードにする。 -->
45
31
 
46
- ### 3.1. _PROCESS_GROUP_NAME_(_AREA_ID_RANGE_)
32
+ ## 3. プロセス領域
47
33
 
48
- _TODO_: 前段から何を受け取り、次段へ何を渡すかを 1〜3 文で要約する。
34
+ _TODO_: ケース `_CASE_ID_` の正常系の順序を示す。名称・領域分割は全体概要、役割は本章の表、受け渡しは図を正本とする。
49
35
 
50
- - **主要入力**: _TODO_: 開始イベントまたは前段から受け取る情報・物を名詞で列挙する。
51
- - **主要出力**: _TODO_: 次段または終了側へ渡す情報・物を名詞で列挙する。
52
- - **データストア**: _TODO_: 引き渡す情報または条件判定に使う「データストア」の名称を列挙する。
36
+ <!-- rulebook の「描き方の選択」に従い、全体概要と同じグループ・区分ごとに節を置く。各節には役割表だけを置き、主要入力・主要出力の箇条書きは置かない。以下はグループ代表ノードの例。領域単位の場合は「含む領域」を「プロセス領域」にし、P-xx 領域名を書く。PDCA は必要な場合だけ独立した列で追加し、グループ・区分の列に入れない。 -->
53
37
 
54
- | 順序 | プロセスグループ | 含む領域 | 横断上の役割 | 参照先 |
55
- | ---- | -------------------- | --------------- | ------------------------------ | -------------- |
56
- | 1 | _PROCESS_GROUP_NAME_ | _AREA_ID_RANGE_ | _CROSS_CUTTING_RESPONSIBILITY_ | `cdfd-_GROUP_` |
38
+ <!-- 複数の系統が共通して通る領域の内部は、全体概要またはその領域の詳細文書の 1 か所だけで描く。ほかの詳細では 1 ノードと受け渡しの線だけにし、内部の正本を役割表の「参照先」に示す。領域のまとまりの場合も全体概要の名称と含む領域 ID を併記する。 -->
57
39
 
58
- ### 3.2. _PROCESS_GROUP_NAME_(_AREA_ID_RANGE_)
40
+ ### 3.1. _GROUP_OR_CATEGORY_NAME_(_AREA_ID_RANGE_)
59
41
 
60
- _TODO_
42
+ | 順序 | プロセスグループ・区分 | 含む領域 | 横断上の役割 | 参照先 |
43
+ | ---- | ------------------------ | ----------------- | ---------------- | -------------------- |
44
+ | 1 | _GROUP_OR_CATEGORY_NAME_ | `_AREA_ID_RANGE_` | _RESPONSIBILITY_ | _TODO_: 有効な参照先 |
61
45
 
62
- - **主要入力**: _TODO_
63
- - **主要出力**: _TODO_
64
- - **データストア**: _TODO_
46
+ ### 3.2. _GROUP_OR_CATEGORY_NAME_(_AREA_ID_RANGE_)
65
47
 
66
- | 順序 | プロセスグループ | 含む領域 | 横断上の役割 | 参照先 |
67
- | ---- | -------------------- | --------------- | ------------------------------ | -------------- |
68
- | 2 | _PROCESS_GROUP_NAME_ | _AREA_ID_RANGE_ | _CROSS_CUTTING_RESPONSIBILITY_ | `cdfd-_GROUP_` |
48
+ | 順序 | プロセスグループ・区分 | 含む領域 | 横断上の役割 | 参照先 |
49
+ | ---- | ------------------------ | ----------------- | ---------------- | -------------------- |
50
+ | 2 | _GROUP_OR_CATEGORY_NAME_ | `_AREA_ID_RANGE_` | _RESPONSIBILITY_ | _TODO_: 有効な参照先 |
69
51
 
70
52
  ## 4. データストア
71
53
 
72
- 全体概要の「データストア」から、引き渡す情報または引き渡し条件の判定に使う行だけを同じ名称・区分で示す。各行は概念データフローの同名ノードと対応する。
54
+ 全体概要から、このケースで参照・更新する正本だけを同じ名称・区分で示す。
73
55
 
74
56
  ### 4.1. マスタ・構成データ
75
57
 
76
- | データストア | 関連引き渡し | 横断上の利用 |
77
- | ----------------- | -------------- | ------------ |
78
- | _DATA_STORE_NAME_ | `_HANDOFF_ID_` | _USAGE_ |
58
+ | データストア | 関連する参加単位 | 横断上の利用 |
59
+ | ------------------- | ----------------------------- | ------------ |
60
+ | _MASTER_STORE_NAME_ | _PARTICIPANT_NAME_OR_AREA_ID_ | _USAGE_ |
79
61
 
80
62
  ### 4.2. トランザクションデータ
81
63
 
82
- | データストア | 関連引き渡し | 横断上の利用 |
83
- | ----------------- | -------------- | ------------ |
84
- | _DATA_STORE_NAME_ | `_HANDOFF_ID_` | _USAGE_ |
64
+ | データストア | 関連する参加単位 | 横断上の利用 |
65
+ | ------------------------ | ----------------------------- | ------------ |
66
+ | _TRANSACTION_STORE_NAME_ | _PARTICIPANT_NAME_OR_AREA_ID_ | _USAGE_ |
85
67
 
86
- <!-- 該当する行がない区分は節ごと削除する。新しい名称・区分は本書だけへ追加せず、先に全体概要を更新する。 -->
68
+ <!-- 該当する行がない区分は節ごと削除する。図のデータストアと対応させ、新しい名称・区分を本書だけへ追加しない。 -->
87
69
 
88
70
  ## 5. 概念データフロー
89
71
 
90
- _TODO_: 開始イベント、プロセスグループ代表ノード、引き渡し条件、関連データストア、終了条件だけを配置し、正常系の順序を左から右へたどれるようにする。内部領域・内部プロセス・状態名は描かない。
91
-
92
- ```mermaid
93
- flowchart LR
94
- classDef process fill:#e3f2fd,stroke:#1e88e5,color:#000
95
- classDef event fill:#fff3e0,stroke:#fb8c00,color:#000
96
- classDef storeMaster fill:#a5d6a7,stroke:#1b5e20,color:#000
97
- classDef storeTransaction fill:#e8f5e9,stroke:#43a047,color:#000
98
-
99
- _START_EVENT_NODE_ID_{{"_START_EVENT_"}}
100
- _SOURCE_GROUP_NODE_ID_("_SOURCE_GROUP_NAME_<br>_SOURCE_AREA_ID_RANGE_")
101
- _HANDOFF_EVENT_NODE_ID_{{"_HANDOFF_ID_ _HANDOFF_CONDITION_"}}
102
- _TARGET_GROUP_NODE_ID_("_TARGET_GROUP_NAME_<br>_TARGET_AREA_ID_RANGE_")
103
- _END_EVENT_NODE_ID_{{"_END_CONDITION_"}}
104
- _MASTER_STORE_NODE_ID_[("_MASTER_STORE_NAME_")]
105
- _TRANSACTION_STORE_NODE_ID_[("_TRANSACTION_STORE_NAME_")]
106
-
107
- _START_EVENT_NODE_ID_ -->|"起動条件"| _SOURCE_GROUP_NODE_ID_
108
- _MASTER_STORE_NODE_ID_ -->|"_CONDITION_INFORMATION_"| _SOURCE_GROUP_NODE_ID_
109
- _SOURCE_GROUP_NODE_ID_ -->|"_HANDOFF_ID_ _HANDOFF_INFORMATION_"| _HANDOFF_EVENT_NODE_ID_
110
- _HANDOFF_EVENT_NODE_ID_ -->|"起動条件"| _TARGET_GROUP_NODE_ID_
111
- _TARGET_GROUP_NODE_ID_ -->|"_RESULT_INFORMATION_"| _TRANSACTION_STORE_NODE_ID_
112
- _TARGET_GROUP_NODE_ID_ -->|"完了条件"| _END_EVENT_NODE_ID_
113
-
114
- class _SOURCE_GROUP_NODE_ID_,_TARGET_GROUP_NODE_ID_ process
115
- class _START_EVENT_NODE_ID_,_HANDOFF_EVENT_NODE_ID_,_END_EVENT_NODE_ID_ event
116
- class _MASTER_STORE_NODE_ID_ storeMaster
117
- class _TRANSACTION_STORE_NODE_ID_ storeTransaction
72
+ ### 5.1. _BUSINESS_FLOW_TITLE_
73
+
74
+ _TODO_: 図から読み取れる流れや関係を 1 文で書く。題は「起票から完了記録まで」のような業務の言葉にする。
75
+
76
+ <!-- 開始から終了まで上から下へ配置する。イベントは一ノード一出来事の短い文にし、長ければ原文を保って改行する。系統の入口は全体概要の表と同じ文言にし、複数の出来事は分ける。引き渡し条件のイベント・引き渡し ID・Orchestrator は置かない。以下は D2 の例。実際の記法・色は全体概要の凡例に合わせる。 -->
77
+
78
+ <!-- 以下の例は絵文字なし。ノードの絵文字の有無・割り当ては全体概要の凡例に合わせ、正常系・戻りの全図と系統間でそろえる。凡例で付ける方針なら両図の全対象ノードへ反映し、同じ対象には同じ絵文字を使う。 -->
79
+
80
+ ```d2
81
+ direction: down
82
+
83
+ classes: {
84
+ process: {
85
+ shape: rectangle
86
+ style: {
87
+ border-radius: 8
88
+ fill: "#e3f2fd"
89
+ stroke: "#1e88e5"
90
+ font-color: "#000000"
91
+ }
92
+ }
93
+ event: {
94
+ shape: hexagon
95
+ style: {
96
+ fill: "#fff3e0"
97
+ stroke: "#fb8c00"
98
+ font-color: "#000000"
99
+ }
100
+ }
101
+ store_master: {
102
+ shape: cylinder
103
+ style: {
104
+ fill: "#e8f5e9"
105
+ stroke: "#43a047"
106
+ font-color: "#000000"
107
+ }
108
+ }
109
+ store_transaction: {
110
+ shape: cylinder
111
+ style: {
112
+ fill: "#c8e6c9"
113
+ stroke: "#2e7d32"
114
+ font-color: "#000000"
115
+ }
116
+ }
117
+ physical_store: {
118
+ shape: rectangle
119
+ style: {
120
+ border-radius: 20
121
+ fill: "#c8e6c9"
122
+ stroke: "#2e7d32"
123
+ font-color: "#000000"
124
+ }
125
+ }
126
+ material_flow: {
127
+ style: {
128
+ stroke-width: 3
129
+ }
130
+ }
131
+ }
132
+
133
+ start: "_START_EVENT_" { class: event }
134
+ source: "_SOURCE_GROUP_NAME_\n_SOURCE_AREA_ID_RANGE_" { class: process }
135
+ target: "_TARGET_GROUP_NAME_\n_TARGET_AREA_ID_RANGE_" { class: process }
136
+ end: "_END_EVENT_" { class: event }
137
+ master_store: "_MASTER_STORE_NAME_" { class: store_master }
138
+ transaction_store: "_TRANSACTION_STORE_NAME_" { class: store_transaction }
139
+
140
+ start -> source: "起動条件"
141
+ master_store -> source: "_REFERENCE_INFORMATION_"
142
+ source -> target: "_TRANSFER_INFORMATION_"
143
+ target -> transaction_store: "_RESULT_INFORMATION_"
144
+ target -> end: "_COMPLETION_INFORMATION_"
118
145
  ```
119
146
 
120
- _TODO_: 全体概要の「凡例(本プロダクト共通)」への参照、`-->` / `==>` のうち使用した線種、グループ内部を省略したこと、図に置いたデータストアと選定理由を書く。
147
+ _TODO_: 全体概要の「凡例(本プロダクト共通)」を参照する短い注記と、使用線種・別図や内部の正本へ委ねる範囲・図を分ける場合の共有ノードを書く。
148
+
149
+ <!-- 領域単位の場合は source / target のラベルを P-xx 領域名へ置き換える。物を渡す線には material_flow class を適用し、現物の保管先には physical_store class を使う。対象ケースで使わない雛形のノード・線・classes は削除する。rulebook の分割の目安(一図の線が 15 本超、または一ノードの入出力が合計 10 本以上)や読みにくさに応じて連続する業務の段ごとに分割し、必要な線を削らず、同じ名称・領域 ID の共有ノードで接続を追えるようにする。引き渡し ID は作らない。 -->
121
150
 
122
- <!-- 物を引き渡す場合は ==> を使用する。関連データストアがない場合は該当ノード、エッジ、class を削除する。グループや引き渡しが多く一図で追えない場合は 5.1、5.2 の連続する引き渡し単位へ分け、接続点に同じ引き渡し ID を置く。 -->
151
+ <!-- 対象範囲の例外時の戻りを重要度で絞らず、以下の節に漏れなく描く。戻りがない場合だけ節ごと削除する。共通して通る領域の内部は 1 か所の正本へ委ね、領域から外へ返す情報は描く。「引き渡し」「例外時の戻り先」の章や条件表は設けない。 -->
123
152
 
124
- ## 6. 引き渡し
153
+ ### 5.2. 例外時の戻り
125
154
 
126
- | 引き渡し ID | 送り元グループ | 受け側グループ | 引き渡す情報 | 引き渡し条件 | 戻す条件 |
127
- | -------------- | -------------------- | -------------------- | --------------------- | ------------------- | ------------------ |
128
- | `_HANDOFF_ID_` | _PROCESS_GROUP_NAME_ | _PROCESS_GROUP_NAME_ | _HANDOFF_INFORMATION_ | _HANDOFF_CONDITION_ | _RETURN_CONDITION_ |
155
+ _TODO_: 不足や不一致をどこへ返すか、図から読み取れることを 1 文で書く。
129
156
 
130
- <!-- 引き渡し ID は正常順序に沿った H-01 形式にする。隣接する全グループ間の引き渡しを一行ずつ追加し、情報、引き渡し条件、戻す条件を空欄にしない。 -->
157
+ ```d2
158
+ direction: down
131
159
 
132
- ## 7. 例外時の戻り先
160
+ classes: {
161
+ process: {
162
+ shape: rectangle
163
+ style: {
164
+ border-radius: 8
165
+ fill: "#e3f2fd"
166
+ stroke: "#1e88e5"
167
+ font-color: "#000000"
168
+ }
169
+ }
170
+ }
133
171
 
134
- | 対象引き渡し | 条件不成立 | 戻り先グループ | 戻す情報 | 再開条件 |
135
- | -------------- | ------------------ | -------------------- | -------------------- | ------------------ |
136
- | `_HANDOFF_ID_` | _FAILED_CONDITION_ | _PROCESS_GROUP_NAME_ | _RETURN_INFORMATION_ | _RESUME_CONDITION_ |
172
+ source: "_SOURCE_GROUP_NAME_\n_SOURCE_AREA_ID_RANGE_" { class: process }
173
+ target: "_TARGET_GROUP_NAME_\n_TARGET_AREA_ID_RANGE_" { class: process }
174
+
175
+ source <- target: "_RETURN_INFORMATION_"
176
+ source -> target: "_CORRECTED_INFORMATION_"
177
+ ```
137
178
 
138
- <!-- 「引き渡し」の全 ID について戻す条件を確認する。戻り先はグループまでに留め、内部プロセス、内部例外、ログ、再試行手順を書かない。 -->
179
+ _TODO_: 全体概要の凡例を参照し、通常の図やほかの戻りの図と共有する参加単位、別図・内部の正本へ委ねる範囲を短く注記する。
139
180
 
140
- <!-- 未決事項がある場合のみ、以下の章を追加する。ない場合は章ごと削除する。
181
+ <!-- 戻りは補完・再判断を担う参加単位へ向け、返す情報と再提示する情報を名詞の線のラベルにする。線が多い場合は rulebook の分割の目安に従い、戻り先や業務の段ごとに本節の図を分け、必要な戻りを削らない。各図に戻す対象が分かる題と説明 1 文を付け、共有ノードで接続を追えるようにする。条件イベントや内部の再試行手順は置かない。 -->
141
182
 
142
- ## 8. 未決事項
183
+ <!-- 未決事項がある場合だけ以下の章を使い、ない場合は章ごと削除する。 -->
143
184
 
144
- | 論点 | 影響するケース・引き渡し | 決定者 | 決定時期 |
145
- | ------------------- | ------------------------ | --------------- | ----------------- |
146
- | _UNDECIDED_: _TODO_ | `_CASE_ID_` / `_HANDOFF_ID_` | _DECISION_ROLE_ | _DECISION_TIMING_ |
185
+ ## 6. 未決事項
147
186
 
148
- -->
187
+ | 論点 | 影響するケース・参加単位 | 決定者 | 決定時期 |
188
+ | ------------------- | ------------------------------------------- | --------------- | ----------------- |
189
+ | _UNDECIDED_: _TODO_ | `_CASE_ID_` / _PARTICIPANT_NAME_OR_AREA_ID_ | _DECISION_ROLE_ | _DECISION_TIMING_ |
@@ -0,0 +1,137 @@
1
+ ---
2
+ specdojo:
3
+ id: specdojo:cnd-template
4
+ type: template
5
+ status: draft
6
+ rulebook: specdojo:cnd-rulebook
7
+ frontmatter_template:
8
+ specdojo:
9
+ id: _LOCAL_ID_
10
+ type: architecture
11
+ status: draft
12
+ rulebook: specdojo:cnd-rulebook
13
+ part_of: []
14
+ based_on: _BASED_ON_
15
+ supersedes: []
16
+ ---
17
+
18
+ # _DELIVERABLE_NAME_
19
+
20
+ ## 1. 概要
21
+
22
+ _TODO_: 対象システム、上位コンテキスト図との対応、分割の目的、対象外を記入する。派生した提供経路を加える場合は範囲の違いを説明する。
23
+
24
+ _TODO_: 実行・配備の前提を示す。仮定は _ASSUMPTION_: とし、影響・確認先を「メモ / 将来課題」へ記入する。
25
+
26
+ _TODO_: 承認対象とする範囲・利用場面、作成担当・確認者・最終判断者の Role code を記入する。
27
+
28
+ ## 2. C4コンテナ図(Mermaid)
29
+
30
+ <!-- 要素・関係は対象に応じて増減する。Person・外部システム・ストアが該当しない場合は理由を定義欄へ書く。骨組みの接続自体を確定構成として扱わない。 -->
31
+
32
+ ```mermaid
33
+ flowchart LR
34
+ person["👤 _PERSON_NAME_"]
35
+ subgraph boundary["_SYSTEM_NAME_"]
36
+ app1("_CONTAINER_ONE_")
37
+ app2("_CONTAINER_TWO_")
38
+ store[("_STORE_NAME_")]
39
+ end
40
+ external["_EXTERNAL_NAME_"]
41
+
42
+ person -->|"_USE_LABEL_"| app1
43
+ app1 -->|"_INTERNAL_LABEL_"| app2
44
+ app2 -->|"_STORE_LABEL_"| store
45
+ app2 -->|"_EXTERNAL_LABEL_"| external
46
+
47
+ classDef person fill:#fff3bf,stroke:#f08c00,color:#000;
48
+ classDef system fill:#d0ebff,stroke:#1c7ed6,color:#000;
49
+ classDef external fill:#e9ecef,stroke:#495057,color:#000;
50
+ class person person;
51
+ class app1,app2,store system;
52
+ class external external;
53
+ style boundary fill:#ffffff,fill-opacity:0,stroke:#868e96,stroke-width:1px,stroke-dasharray: 5 5;
54
+ ```
55
+
56
+ _TODO_: 矢印の意味、応答の省略、構築時だけ成立する関係、任意依存を説明する。
57
+
58
+ _TODO_: 上位図の利用目的・外部依存について、担当コンテナと経路、描かない経路の対象外理由を記入する。
59
+
60
+ ## 3. 要素と境界の定義
61
+
62
+ ### 3.1. 対象システムとシステム境界
63
+
64
+ _TODO_: 境界内に含める責務と、境界外へ委ねる処理を対にして記入する。物理配置と責務の境界を区別する。
65
+
66
+ ### 3.2. Person(人・ロール)
67
+
68
+ | Person(図中ラベル) | 利用目的・接点 | 判断・確認の責務 |
69
+ | -------------------- | --------------- | ----------------------- |
70
+ | `_PERSON_NAME_` | `_USE_PURPOSE_` | `_USER_RESPONSIBILITY_` |
71
+
72
+ ### 3.3. Container(コンテナ)
73
+
74
+ | コンテナ(図中ラベル) | 責務 | 技術区分・実行配備の前提 |
75
+ | ---------------------- | ---------------------- | ------------------------ |
76
+ | `_CONTAINER_ONE_` | `_RESPONSIBILITY_ONE_` | `_EXECUTION_ONE_` |
77
+ | `_CONTAINER_TWO_` | `_RESPONSIBILITY_TWO_` | `_EXECUTION_TWO_` |
78
+
79
+ ### 3.4. Data Store(データストア)
80
+
81
+ | ストア(図中ラベル) | 保持する情報・正本 | アクセスと生成物の境界 |
82
+ | -------------------- | ------------------------- | ----------------------------------- |
83
+ | `_STORE_NAME_` | `_PERSISTED_INFORMATION_` | `_READERS_WRITERS_AND_DERIVATIVES_` |
84
+
85
+ ### 3.5. External Software System(外部システム)
86
+
87
+ | 外部システム(図中ラベル) | 利用条件・責任分界 | 不在・障害時の影響 |
88
+ | -------------------------- | ------------------------------------------- | ------------------ |
89
+ | `_EXTERNAL_NAME_` | `_DEPENDENCY_CONDITION_AND_RESPONSIBILITY_` | `_FAILURE_IMPACT_` |
90
+
91
+ ### 3.6. Relationship(関係・連携契約)
92
+
93
+ <!-- 図の全関係に対応させ、端点・ラベルを一致させる。詳細の正本は実在する文書なら wikilink、未作成なら ID またはファイル名をインラインコードで記入する。構文・値・データ構造は参照先へ委ねる。 -->
94
+
95
+ | 関係 ID | 起点 → 終点 | 図中ラベル | 方式・条件と情報の要点 | 詳細の正本 |
96
+ | -------- | ------------------------------------- | ------------------ | ---------------------------------- | --------------------------- |
97
+ | `REL-01` | `_PERSON_NAME_` → `_CONTAINER_ONE_` | `_USE_LABEL_` | `_USER_CHANNEL_AND_INFORMATION_` | `_USER_SPEC_REFERENCE_` |
98
+ | `REL-02` | `_CONTAINER_ONE_` → `_CONTAINER_TWO_` | `_INTERNAL_LABEL_` | `_INTERNAL_CHANNEL_AND_TIMING_` | `_INTERNAL_SPEC_REFERENCE_` |
99
+ | `REL-03` | `_CONTAINER_TWO_` → `_STORE_NAME_` | `_STORE_LABEL_` | `_STORE_ACCESS_AND_TIMING_` | `_DATA_SPEC_REFERENCE_` |
100
+ | `REL-04` | `_CONTAINER_TWO_` → `_EXTERNAL_NAME_` | `_EXTERNAL_LABEL_` | `_EXTERNAL_CHANNEL_AND_CONDITION_` | `_EXTERNAL_SPEC_REFERENCE_` |
101
+
102
+ ## 4. 技術前提・制約と検証観点
103
+
104
+ ### 4.1. 技術前提・制約
105
+
106
+ - `_EXECUTION_AND_DEPLOYMENT_PRECONDITION_`
107
+ - `_BUILD_TIME_AND_RUNTIME_BOUNDARY_`
108
+ - `_LOCAL_REMOTE_AND_READ_WRITE_BOUNDARIES_`
109
+ - `_TRUST_AND_APPROVAL_CONSTRAINT_`
110
+
111
+ ### 4.2. コンテナ間・外部依存の検証対象
112
+
113
+ <!-- 正常時は下流の結合検証へ渡す全経路に対応させる。保存先・外部依存では不在・失敗・結果不明時の状態も区別する。行は対象ごとに増減し、未確定の期待結果は「メモ / 将来課題」へ引き継ぐ。 -->
114
+
115
+ | 確認区分 | 対象関係・境界 | 観測する結果 | 主確認ロール |
116
+ | ------------ | ---------------------------------- | --------------------------------------- | --------------- |
117
+ | 正常時 | `_RELATIONSHIP_OR_BOUNDARY_` | `_NORMAL_RESULT_` | `_REVIEW_ROLE_` |
118
+ | 不在・失敗時 | `_STORE_OR_EXTERNAL_RELATIONSHIP_` | `_UNAVAILABLE_OR_FAILED_RESULT_` | `_REVIEW_ROLE_` |
119
+ | 結果不明時 | `_STORE_OR_EXTERNAL_RELATIONSHIP_` | `_UNKNOWN_RESULT_AND_RETAINED_RECORDS_` | `_REVIEW_ROLE_` |
120
+
121
+ ### 4.3. 検証・承認前の確認
122
+
123
+ <!-- 確認内容・合格条件は rulebook の「検証・承認前の確認」に従う。 -->
124
+
125
+ - 文書検査・描画確認・内容レビューの記録: `_REVIEW_EVIDENCE_REFERENCE_`
126
+ - 未解決指摘と後続作業の制限: `_OPEN_FINDINGS_AND_RESTRICTIONS_`
127
+ - PO の承認・保留・差し戻しの記録: `_APPROVAL_RECORD_REFERENCE_`
128
+ - OPS による承認対象と公開対象の照合記録: `_PUBLICATION_SCOPE_CHECK_REFERENCE_`
129
+ - 改訂・廃止時の窓口と追従先・担当ロール: `_CHANGE_CONTACT_IMPACT_AND_ROLES_`
130
+
131
+ ## 5. メモ / 将来課題
132
+
133
+ <!-- 仮定・未確定事項がない場合だけ章ごと削除する。最終列には解消条件、PJR 等の転送先レコード、判断者の Role code と判断期限または判断時点を記入する。 -->
134
+
135
+ | 対象・論点 | 影響範囲 | 担当ロール | 解消条件・引き継ぎ先 |
136
+ | -------------- | ---------- | -------------- | ---------------------------------------- |
137
+ | `_OPEN_TOPIC_` | `_IMPACT_` | `_OWNER_ROLE_` | `_RESOLUTION_RECORD_DECIDER_AND_TIMING_` |
@@ -0,0 +1,129 @@
1
+ ---
2
+ specdojo:
3
+ id: specdojo:cpd-template
4
+ type: template
5
+ status: ready
6
+ rulebook: specdojo:cpd-rulebook
7
+ frontmatter_template:
8
+ specdojo:
9
+ id: _LOCAL_ID_
10
+ type: architecture
11
+ status: draft
12
+ owner: ARC
13
+ rulebook: specdojo:cpd-rulebook
14
+ part_of: []
15
+ based_on: _BASED_ON_
16
+ supersedes: []
17
+ ---
18
+
19
+ # _DELIVERABLE_NAME_
20
+
21
+ ## 1. 概要
22
+
23
+ _TODO_: 上位コンテナ図の参照、対象コンテナ、分割の目的と設計入力としての用途、対象外を記入する。対象者の業務課題・放置時の影響・期待価値・成功基準は、上位の要求・目的の該当箇所を参照する。
24
+
25
+ _TODO_: 設計案と確認済みの実装構成を区別する。未確認の分割は _ASSUMPTION_: とし、影響と確認先を「メモ / 将来課題」に記入する。
26
+
27
+ _TODO_: 作成者、アーキテクチャ・実装・結合・業務の確認者と確認時点、最終合意者となる人間の PO を記入し、役割割当て・合意記録を参照する。公開する相手・媒体・範囲と、OPS の公開前確認の記録・PO の公開判断の参照先を記入する。
28
+
29
+ ## 2. C4コンポーネント図(Mermaid)
30
+
31
+ <!-- 要素・関係は対象に合わせて増減する。下図の接続を確定設計として流用しない。ストアや外部システムの内外は上位図の境界に合わせる。 -->
32
+
33
+ ```mermaid
34
+ flowchart LR
35
+ person["👤 _PERSON_ROLE_"]
36
+ subgraph boundary["_CONTAINER_NAME_"]
37
+ entry("_ENTRY_COMPONENT_")
38
+ domain("_DOMAIN_COMPONENT_")
39
+ adapter("_ADAPTER_COMPONENT_")
40
+ end
41
+ store[("_STORE_NAME_")]
42
+ external["_EXTERNAL_NAME_"]
43
+
44
+ person -->|"REL-01 _USE_LABEL_"| entry
45
+ entry -->|"REL-02 _REQUEST_LABEL_"| domain
46
+ domain -->|"REL-03 _DEPENDENCY_LABEL_"| adapter
47
+ domain -->|"REL-04 _STORE_LABEL_"| store
48
+ adapter -->|"REL-05 _EXTERNAL_LABEL_"| external
49
+
50
+ classDef person fill:#fff3bf,stroke:#f08c00,color:#000;
51
+ classDef system fill:#d0ebff,stroke:#1c7ed6,color:#000;
52
+ classDef external fill:#e9ecef,stroke:#495057,color:#000;
53
+ class person person;
54
+ class entry,domain,adapter system;
55
+ class store,external external;
56
+ style boundary fill:#ffffff,fill-opacity:0,stroke:#868e96,stroke-width:1px,stroke-dasharray: 5 5;
57
+ ```
58
+
59
+ _TODO_: 矢印の意味、応答の扱い、主要経路の選定理由と省略範囲を記入する。
60
+
61
+ ## 3. 要素と境界の定義
62
+
63
+ ### 3.1. 対象コンテナ境界と利用者
64
+
65
+ _TODO_: 境界に含む責務、境界外に残す別コンテナ・ストア・外部システム、上位図との対応を記入する。
66
+
67
+ | 上位図の Person | 本図の接点と確認する結果 |
68
+ | --------------- | ------------------------ |
69
+ | _PERSON_ROLE_ | _CONTACT_AND_RESULT_ |
70
+
71
+ <!-- Person が非該当なら表を削除し、その理由を書く。 -->
72
+
73
+ ### 3.2. コンポーネントと論理配置
74
+
75
+ | コンポーネント | 固有の責務 | 主な入力 → 出力 | 論理配置・境界 |
76
+ | ---------------- | ---------------- | ------------------ | ------------------- |
77
+ | _COMPONENT_NAME_ | _RESPONSIBILITY_ | _INPUT_ → _OUTPUT_ | _LOGICAL_PLACEMENT_ |
78
+
79
+ _TODO_: 主要な分割・共通化・依存の採用理由を、上位の業務目的または技術制約に対応付けて記入する。実装配置への対応を示す場合は確認根拠を記入し、未確認の対応は「メモ / 将来課題」へ残す。
80
+
81
+ ### 3.3. ストアと外部依存
82
+
83
+ | 要素・区分 | 保持内容または委ねる責務 | 利用条件・失敗の影響 |
84
+ | ----------------------- | ---------------------------- | ------------------------------ |
85
+ | _ELEMENT_NAME_AND_KIND_ | _CONTENTS_OR_RESPONSIBILITY_ | _CONDITION_AND_FAILURE_IMPACT_ |
86
+
87
+ <!-- ストア・外部依存のいずれかが非該当なら、その理由を書く。 -->
88
+
89
+ ### 3.4. 関係と詳細の正本
90
+
91
+ | 関係 ID | 起点 → 終点 | 授受情報・条件 | 詳細の正本 |
92
+ | -------- | ---------------------------------------- | -------------------------------------- | ------------------------ |
93
+ | `REL-01` | _PERSON_ROLE_ → _ENTRY_COMPONENT_ | _USE_INFORMATION_AND_CONDITION_ | _USE_DETAIL_SOURCE_ |
94
+ | `REL-02` | _ENTRY_COMPONENT_ → _DOMAIN_COMPONENT_ | _REQUEST_INFORMATION_AND_CONDITION_ | _REQUEST_DETAIL_SOURCE_ |
95
+ | `REL-03` | _DOMAIN_COMPONENT_ → _ADAPTER_COMPONENT_ | _DEPENDENCY_INFORMATION_AND_CONDITION_ | _ADAPTER_DETAIL_SOURCE_ |
96
+ | `REL-04` | _DOMAIN_COMPONENT_ → _STORE_NAME_ | _STORE_INFORMATION_AND_CONDITION_ | _STORE_DETAIL_SOURCE_ |
97
+ | `REL-05` | _ADAPTER_COMPONENT_ → _EXTERNAL_NAME_ | _EXTERNAL_INFORMATION_AND_CONDITION_ | _EXTERNAL_DETAIL_SOURCE_ |
98
+
99
+ <!-- 図に合わせて行を増減し、全関係の ID・端点を対応付ける。値・構文・構造は詳細の正本へ委ね、既存なら文書 ID のリンク、未作成ならバッククォートの仮参照とする。 -->
100
+
101
+ ## 4. 技術前提・制約と検証観点
102
+
103
+ ### 4.1. 技術前提・制約
104
+
105
+ - _DEPENDENCY_CONSTRAINT_
106
+ - _PERSISTENCE_AND_DERIVED_DATA_BOUNDARY_
107
+ - _EXTERNAL_CALL_CONSTRAINT_
108
+
109
+ _TODO_: 保守・問い合わせ窓口と、変更時の影響確認記録を参照する。変更記録には影響する要素・関係 ID、後続成果物・実装・検証・Schedule の更新要否と理由・担当を残す。
110
+
111
+ ### 4.2. コンポーネント間の検証対象
112
+
113
+ <!-- 通常時と失敗・応答欠落時の条件、合否を判断できる観測結果を関係 ID に対応付ける。実施結果は実行記録へ残す。 -->
114
+
115
+ | 対象関係 | 条件 | 観測する結果 |
116
+ | --------------- | ---------------------------- | ------------------- |
117
+ | `_RELATION_ID_` | _INPUT_OR_FAILURE_CONDITION_ | _OBSERVABLE_RESULT_ |
118
+
119
+ _TODO_: 文書検査・描画確認の証跡を参照する。
120
+
121
+ ## 5. メモ / 将来課題
122
+
123
+ <!-- 仮定・未確認事項がない場合は章を省略する。論点は共通ラベルで確定事項と区別し、図・関係・制約の該当箇所と対応付ける。 -->
124
+
125
+ | 対象・区分 | 影響と後続成果物 | 担当 Role code・判断者 | 期限または判断タイミング | 次アクション・解消条件 | 承認への影響・引き継ぎ先 |
126
+ | -------------------- | ---------------------------- | ------------------------------- | ------------------------ | ---------------------------- | --------------------------------- |
127
+ | _TOPIC_AND_CATEGORY_ | _IMPACT_AND_DOWNSTREAM_DOCS_ | _OWNER_ROLE_AND_DECISION_MAKER_ | _DECISION_TIMING_ | _NEXT_ACTION_AND_RESOLUTION_ | _APPROVAL_IMPACT_AND_DESTINATION_ |
128
+
129
+ _TODO_: ARC から PM・人間の PO への報告先、継続追跡する論点の PJR 参照を記入する。未起票なら登録候補の理由・起票担当・判断時点を残し、後続作業の着手可否と Schedule の順序・期限への影響を対応付ける。
@@ -0,0 +1,105 @@
1
+ ---
2
+ specdojo:
3
+ id: specdojo:cxd-template
4
+ type: template
5
+ status: ready
6
+ frontmatter_template:
7
+ specdojo:
8
+ id: _LOCAL_ID_
9
+ type: architecture
10
+ status: draft
11
+ rulebook: specdojo:cxd-rulebook
12
+ part_of: []
13
+ based_on: _BASED_ON_
14
+ supersedes: []
15
+ ---
16
+
17
+ # _DELIVERABLE_NAME_
18
+
19
+ ## 1. 概要
20
+
21
+ _TODO_: 対象システムの目的、提供価値、図の対象範囲を 1〜3 文で記入する。
22
+
23
+ | 対象者 | 課題・関心事 | 本図で確認する内容 |
24
+ | ------------- | ------------ | ------------------ |
25
+ | _STAKEHOLDER_ | _CONCERN_ | _CONFIRMATION_ |
26
+
27
+ _TODO_: 本図の対象外と、内部構成・操作・連携の詳細を委ねる先を示す。
28
+
29
+ ## 2. C4コンテキスト図(Mermaid)
30
+
31
+ <!-- Person・外部システムと関係は対象に応じて増減し、表と対応させる。該当する主体がない場合は理由を本文に記入する。 -->
32
+
33
+ ```mermaid
34
+ flowchart LR
35
+ person["👤 _PERSON_NAME_"]
36
+ subgraph boundary["対象システム"]
37
+ target("_SYSTEM_NAME_")
38
+ end
39
+ external["_EXTERNAL_SYSTEM_NAME_"]
40
+
41
+ person -->|"_USE_LABEL_"| target
42
+ target -->|"_DEPENDENCY_LABEL_"| external
43
+
44
+ classDef person fill:#fff3bf,stroke:#f08c00,color:#000;
45
+ classDef system fill:#d0ebff,stroke:#1c7ed6,color:#000;
46
+ classDef external fill:#e9ecef,stroke:#495057,color:#000;
47
+ class person person;
48
+ class target system;
49
+ class external external;
50
+ style boundary fill:#ffffff,fill-opacity:0,stroke:#868e96,stroke-width:1px,stroke-dasharray: 5 5;
51
+ ```
52
+
53
+ _TODO_: 矢印の向き、応答の省略など読み取りに必要な注記を 1〜3 文で記入する。
54
+
55
+ ## 3. 要素と境界の定義
56
+
57
+ ### 3.1. 対象システムとシステム境界
58
+
59
+ | 項目 | 内容 |
60
+ | ------------------------------------ | --------------------------- |
61
+ | システム名 | _SYSTEM_NAME_ |
62
+ | 提供する中核責務 | _CORE_RESPONSIBILITY_ |
63
+ | 境界内に含める範囲 | _IN_SCOPE_ |
64
+ | 境界外へ委ねる範囲(対象外と委譲先) | _OUT_OF_SCOPE_AND_DELEGATE_ |
65
+
66
+ ### 3.2. Person(人・ロール)
67
+
68
+ | Person(図中ラベル) | 対応ロール | 利用目的・主な関わり | 境界上の接点・確認責務 |
69
+ | -------------------- | -------------------- | -------------------- | ---------------------- |
70
+ | _PERSON_NAME_ | _ROLE_OR_USER_GROUP_ | _USE_PURPOSE_ | _USER_RESPONSIBILITY_ |
71
+
72
+ ### 3.3. External Software System(外部システム)
73
+
74
+ | 外部システム(図中ラベル) | 区分・位置づけ | 対象システムとの責任分界 | 不在・障害時の影響と扱い |
75
+ | -------------------------- | ---------------------- | ------------------------- | ------------------------ |
76
+ | _EXTERNAL_SYSTEM_NAME_ | _DEPENDENCY_CONDITION_ | _RESPONSIBILITY_BOUNDARY_ | _FAILURE_IMPACT_ |
77
+
78
+ ### 3.4. Relationship(関係・連携契約)
79
+
80
+ | 関係ID | 起点 → 終点 | 図中ラベル | やり取りする情報・制御の要点 | 連携方式・境界 | 正本・関連仕様 |
81
+ | -------- | -------------------------------------- | ------------------ | ---------------------------- | --------------------- | -------------------------- |
82
+ | `REL-01` | _PERSON_NAME_ → _SYSTEM_NAME_ | _USE_LABEL_ | _USER_INPUT_OUTPUT_ | _USER_CHANNEL_ | _USER_SPEC_REFERENCE_ |
83
+ | `REL-02` | _SYSTEM_NAME_ → _EXTERNAL_SYSTEM_NAME_ | _DEPENDENCY_LABEL_ | _EXTERNAL_INPUT_OUTPUT_ | _INTEGRATION_CHANNEL_ | _INTERFACE_SPEC_REFERENCE_ |
84
+
85
+ ## 4. 技術前提・制約と検証観点
86
+
87
+ ### 4.1. 技術前提・制約
88
+
89
+ - _EXECUTION_OR_COMMUNICATION_CONSTRAINT_
90
+ - _TRUST_OR_APPROVAL_CONSTRAINT_
91
+ - _EXTERNAL_DEPENDENCY_PRECONDITION_
92
+
93
+ ### 4.2. システム境界・外部依存の検証観点
94
+
95
+ | 確認区分 | 対象関係・境界 | 検証観点 | 主確認ロール |
96
+ | ---------------- | -------------------------- | ------------------ | ------------- |
97
+ | _CHECK_CATEGORY_ | _RELATIONSHIP_OR_BOUNDARY_ | _OBSERVABLE_CHECK_ | _REVIEW_ROLE_ |
98
+
99
+ ## 5. メモ / 将来課題
100
+
101
+ <!-- 未作成の参照先・未確定の境界・将来課題がなければ、この章を削除する。 -->
102
+
103
+ | 対象・論点 | 影響範囲 | 担当ロール | 解消条件・引き継ぎ先 |
104
+ | ------------ | -------- | ------------ | ---------------------------- |
105
+ | _OPEN_TOPIC_ | _IMPACT_ | _OWNER_ROLE_ | _RESOLUTION_AND_DESTINATION_ |