specdojo 0.7.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 (337) hide show
  1. package/.github/agents/specdojo-orchestrator.md +3 -2
  2. package/CHANGELOG.md +153 -0
  3. package/dist/catalog/build.js +24 -1
  4. package/dist/catalog/plan.js +1 -1
  5. package/dist/catalog/scaffold.js +4 -1
  6. package/dist/commands/init.js +5 -1
  7. package/dist/commands/night-orchestrator.js +6 -4
  8. package/dist/dashboard/dashboard-timeline.js +18 -16
  9. package/dist/dashboard/dashboard.js +612 -259
  10. package/dist/dashboard/epic-plan.js +81 -0
  11. package/dist/dashboard/exec-records.js +16 -20
  12. package/dist/dashboard/routines.js +8 -6
  13. package/dist/dashboard/timeline-build.js +5 -9
  14. package/dist/dashboard/timeline.js +9 -4
  15. package/dist/devcontainer/scaffold.js +18 -0
  16. package/dist/docs/frontmatter-namespace.js +1 -48
  17. package/dist/docs/yaml-pages.js +125 -3
  18. package/dist/exec/agent-config.js +22 -0
  19. package/dist/exec/agent-plan.js +3 -2
  20. package/dist/exec/commands.js +69 -21
  21. package/dist/exec/commit-hook-skips.js +78 -0
  22. package/dist/exec/core.js +19 -7
  23. package/dist/exec/events.js +159 -8
  24. package/dist/exec/evidence.js +64 -16
  25. package/dist/exec/handoff.js +9 -13
  26. package/dist/exec/limit.js +1 -1
  27. package/dist/exec/mechanical-result.js +45 -0
  28. package/dist/exec/migrate-records.js +249 -0
  29. package/dist/exec/parent-validation.js +153 -12
  30. package/dist/exec/pipeline-state.js +27 -5
  31. package/dist/exec/plans-condense-findings.js +89 -0
  32. package/dist/exec/plans-core.js +24 -17
  33. package/dist/exec/plans-generation.js +48 -25
  34. package/dist/exec/plans-grade-findings.js +8 -3
  35. package/dist/exec/plans-kata-findings.js +61 -0
  36. package/dist/exec/plans-planning.js +3 -3
  37. package/dist/exec/plans-storage.js +12 -24
  38. package/dist/exec/register-resume.js +55 -56
  39. package/dist/exec/register.js +26 -22
  40. package/dist/exec/repo-integration-sync.js +8 -4
  41. package/dist/exec/repo-integration.js +21 -1
  42. package/dist/exec/reporter.js +121 -23
  43. package/dist/exec/results.js +85 -24
  44. package/dist/exec/review-completion.js +47 -0
  45. package/dist/exec/review-kata.js +109 -0
  46. package/dist/exec/run/agent-pipeline.js +75 -6
  47. package/dist/exec/run/agent.js +20 -7
  48. package/dist/exec/run/in-place.js +69 -32
  49. package/dist/exec/run/job.js +81 -24
  50. package/dist/exec/run/lifecycle-commands.js +188 -36
  51. package/dist/exec/run/mode-shared.js +11 -3
  52. package/dist/exec/run/register-command.js +6 -10
  53. package/dist/exec/run/register-core.js +20 -13
  54. package/dist/exec/run/register-mode.js +12 -12
  55. package/dist/exec/run/register-post-review.js +21 -9
  56. package/dist/exec/run/register-resume.js +28 -18
  57. package/dist/exec/run/register-state.js +10 -7
  58. package/dist/exec/run/register-worktree.js +60 -30
  59. package/dist/exec/run/schedule-mode.js +4 -4
  60. package/dist/exec/run/schedule-prepare.js +201 -59
  61. package/dist/exec/run/schedule-task.js +129 -25
  62. package/dist/exec/run/shared.js +4 -3
  63. package/dist/exec/run/trailing-records.js +35 -0
  64. package/dist/exec/run-records.js +2 -0
  65. package/dist/exec/strategy.js +1 -0
  66. package/dist/exec/trailing-records.js +242 -0
  67. package/dist/exec/trial-commands.js +3 -2
  68. package/dist/exec/validate-records-commit.js +110 -0
  69. package/dist/exec/validate-records.js +148 -0
  70. package/dist/exec/worktree-command.js +29 -16
  71. package/dist/exec/worktree-ops-commit.js +119 -48
  72. package/dist/exec/worktree-ops-lifecycle.js +77 -48
  73. package/dist/exec/worktree-ops-merge.js +13 -2
  74. package/dist/exec/worktree-ops.js +2 -2
  75. package/dist/exec/worktree.js +19 -2
  76. package/dist/grade/apply.js +32 -6
  77. package/dist/grade/command-inspect.js +2 -2
  78. package/dist/grade/command-run.js +2 -0
  79. package/dist/grade/command-shared.js +1 -1
  80. package/dist/grade/core.js +18 -5
  81. package/dist/grade/markdown.js +3 -3
  82. package/dist/grade/pipeline-state.js +15 -11
  83. package/dist/grade/plan.js +37 -17
  84. package/dist/grade/result.js +3 -3
  85. package/dist/grade/run.js +23 -3
  86. package/dist/grade/target-discovery.js +17 -4
  87. package/dist/grade/targets.js +12 -11
  88. package/dist/job/job.js +31 -17
  89. package/dist/job/noop.js +104 -0
  90. package/dist/register/core.js +2 -0
  91. package/dist/register/create-commands.js +28 -3
  92. package/dist/register/deliverable-target.js +9 -1
  93. package/dist/register/epic.js +104 -26
  94. package/dist/register/event-merge.js +3 -0
  95. package/dist/register/events.js +4 -0
  96. package/dist/register/external-project.js +3 -0
  97. package/dist/register/item.js +6 -0
  98. package/dist/register/maintenance-commands.js +4 -1
  99. package/dist/register/planning.js +7 -14
  100. package/dist/register/register.js +43 -9
  101. package/dist/register/track-domains.js +34 -0
  102. package/dist/register/track-plan.js +78 -0
  103. package/dist/register/transition-commands.js +8 -0
  104. package/dist/register/work-table.js +64 -0
  105. package/dist/review/grade.js +35 -13
  106. package/dist/routine/definition.js +4 -3
  107. package/dist/routine/failure.js +30 -0
  108. package/dist/routine/routine.js +56 -32
  109. package/dist/routine/storage.js +33 -0
  110. package/dist/schedule/schedule.js +1 -0
  111. package/dist/schedule/strategy-generate-document.js +26 -14
  112. package/dist/schedule/strategy-generate-scope.js +17 -45
  113. package/dist/schedule/strategy-generate.js +33 -3
  114. package/dist/schedule/strategy-profiles.js +86 -12
  115. package/dist/shared/agent-types.js +2 -0
  116. package/dist/shared/condense-records.js +25 -0
  117. package/dist/shared/deprecation.js +8 -0
  118. package/dist/shared/document-metadata.js +20 -0
  119. package/dist/shared/finding-cause.js +20 -0
  120. package/dist/shared/frontmatter-namespace.js +48 -0
  121. package/dist/shared/git.js +142 -15
  122. package/dist/shared/grade-result.js +17 -1
  123. package/dist/shared/local-state.js +20 -0
  124. package/dist/shared/markdownlint-config.js +8 -3
  125. package/dist/shared/plan-conventions.js +129 -0
  126. package/dist/shared/plan-templates.js +57 -41
  127. package/dist/shared/run-records.js +224 -0
  128. package/dist/shared/specdojo-config.js +39 -21
  129. package/dist/shared/text.js +65 -5
  130. package/dist/shared/timeline-index.js +2 -0
  131. package/docs/ja/specdojo/defaults/pm-review-viewpoints.yaml +9 -2
  132. package/docs/ja/specdojo/exec-templates/xep-common-conventions-template.md +4 -74
  133. package/docs/ja/specdojo/exec-templates/xep-condense-template.md +50 -0
  134. package/docs/ja/specdojo/exec-templates/xep-draft-template.md +17 -5
  135. package/docs/ja/specdojo/exec-templates/xep-fully-guided-template.md +16 -3
  136. package/docs/ja/specdojo/exec-templates/xep-recipe-guided-template.md +15 -5
  137. package/docs/ja/specdojo/exec-templates/xep-recipe-maintenance-template.md +6 -0
  138. package/docs/ja/specdojo/exec-templates/xep-register-template.md +1 -1
  139. package/docs/ja/specdojo/exec-templates/xep-rulebook-maintenance-template.md +6 -0
  140. package/docs/ja/specdojo/exec-templates/xep-sample-maintenance-template.md +6 -0
  141. package/docs/ja/specdojo/exec-templates/xep-template-maintenance-template.md +6 -0
  142. package/docs/ja/specdojo/exec-templates/xer-condense-template.md +25 -0
  143. package/docs/ja/specdojo/exec-templates/xp-common-conventions-template.md +50 -0
  144. package/docs/ja/specdojo/exec-templates/xrp-common-conventions-template.md +30 -0
  145. package/docs/ja/specdojo/guides/branch-workflow-guide.md +1 -1
  146. package/docs/ja/specdojo/guides/docs-editing-guide.md +12 -0
  147. package/docs/ja/specdojo/guides/docs-structure-guide.md +48 -15
  148. package/docs/ja/specdojo/guides/exec-config-guide.md +47 -16
  149. package/docs/ja/specdojo/guides/exec-operation-guide.md +53 -17
  150. package/docs/ja/specdojo/guides/exec-worktree-guide.md +20 -11
  151. package/docs/ja/specdojo/guides/plan-result-lifecycle-guide.md +92 -55
  152. package/docs/ja/specdojo/guides/project-move-guide.md +381 -0
  153. package/docs/ja/specdojo/guides/quick-start-guide.md +70 -14
  154. package/docs/ja/specdojo/guides/register-operation-guide.md +25 -5
  155. package/docs/ja/specdojo/guides/remote-host-development-guide.md +2 -0
  156. package/docs/ja/specdojo/guides/review-guide.md +22 -19
  157. package/docs/ja/specdojo/guides/routine-operation-guide.md +14 -8
  158. package/docs/ja/specdojo/guides/ryu-guide.md +23 -13
  159. package/docs/ja/specdojo/guides/schedule-design-guide.md +7 -4
  160. package/docs/ja/specdojo/guides/schedule-operation-guide.md +27 -3
  161. package/docs/ja/specdojo/guides/specdojo-overview-guide.md +5 -4
  162. package/docs/ja/specdojo/guides/timeline-design-guide.md +27 -144
  163. package/docs/ja/specdojo/guides/use-case-guide.md +92 -155
  164. package/docs/ja/specdojo/recipes/bac-recipe.md +94 -0
  165. package/docs/ja/specdojo/recipes/bes-recipe.md +105 -0
  166. package/docs/ja/specdojo/recipes/br-recipe.md +84 -0
  167. package/docs/ja/specdojo/recipes/cdfd-uc-recipe.md +36 -24
  168. package/docs/ja/specdojo/recipes/cnd-recipe.md +125 -0
  169. package/docs/ja/specdojo/recipes/cpd-recipe.md +126 -0
  170. package/docs/ja/specdojo/recipes/cxd-recipe.md +145 -0
  171. package/docs/ja/specdojo/recipes/ifd-recipe.md +134 -0
  172. package/docs/ja/specdojo/recipes/ifx-cmd-recipe.md +135 -86
  173. package/docs/ja/specdojo/recipes/ifx-index-recipe.md +130 -0
  174. package/docs/ja/specdojo/recipes/pm-organization-recipe.md +29 -26
  175. package/docs/ja/specdojo/recipes/pm-plan-recipe.md +35 -26
  176. package/docs/ja/specdojo/recipes/pm-quality-management-plan-recipe.md +38 -28
  177. package/docs/ja/specdojo/recipes/pm-raci-recipe.md +39 -31
  178. package/docs/ja/specdojo/recipes/pm-roles-recipe.md +26 -28
  179. package/docs/ja/specdojo/recipes/prj-assumptions-constraints-dependencies-recipe.md +10 -8
  180. package/docs/ja/specdojo/recipes/prj-comparison-of-alternatives-recipe.md +18 -17
  181. package/docs/ja/specdojo/recipes/stsd-recipe.md +100 -62
  182. package/docs/ja/specdojo/recipes/sysd-critical-flows-recipe.md +106 -0
  183. package/docs/ja/specdojo/recipes/sysd-cross-cutting-policy-recipe.md +137 -0
  184. package/docs/ja/specdojo/recipes/sysd-index-recipe.md +122 -0
  185. package/docs/ja/specdojo/references/command-reference.md +79 -64
  186. package/docs/ja/specdojo/references/deliverables-reference.md +9 -4
  187. package/docs/ja/specdojo/references/directory-layout-reference.md +3 -2
  188. package/docs/ja/specdojo/references/specdojo-config-reference.md +17 -16
  189. package/docs/ja/specdojo/rulebooks/bac-rulebook.md +72 -290
  190. package/docs/ja/specdojo/rulebooks/bdd-rulebook.md +212 -79
  191. package/docs/ja/specdojo/rulebooks/bds-rulebook.md +138 -154
  192. package/docs/ja/specdojo/rulebooks/bes-index-rulebook.md +147 -59
  193. package/docs/ja/specdojo/rulebooks/bes-rulebook.md +100 -96
  194. package/docs/ja/specdojo/rulebooks/br-rulebook.md +88 -108
  195. package/docs/ja/specdojo/rulebooks/ccd-mermaid-rulebook.md +126 -211
  196. package/docs/ja/specdojo/rulebooks/cdfd-uc-rulebook.md +56 -35
  197. package/docs/ja/specdojo/rulebooks/cdsd-rulebook.md +102 -68
  198. package/docs/ja/specdojo/rulebooks/cdt-rulebook.md +152 -0
  199. package/docs/ja/specdojo/rulebooks/cld-rulebook.md +9 -184
  200. package/docs/ja/specdojo/rulebooks/clis-rulebook.md +187 -0
  201. package/docs/ja/specdojo/rulebooks/cnd-rulebook.md +93 -247
  202. package/docs/ja/specdojo/rulebooks/cpd-rulebook.md +104 -241
  203. package/docs/ja/specdojo/rulebooks/cxd-rulebook.md +124 -257
  204. package/docs/ja/specdojo/rulebooks/dct-index-rulebook.md +87 -98
  205. package/docs/ja/specdojo/rulebooks/dct-rulebook.md +9 -7
  206. package/docs/ja/specdojo/rulebooks/dec-rulebook.md +2 -1
  207. package/docs/ja/specdojo/rulebooks/dss-rulebook.md +193 -0
  208. package/docs/ja/specdojo/rulebooks/gl-rulebook.md +100 -54
  209. package/docs/ja/specdojo/rulebooks/ifd-mermaid-rulebook.md +69 -252
  210. package/docs/ja/specdojo/rulebooks/ifx-cmd-rulebook.md +91 -76
  211. package/docs/ja/specdojo/rulebooks/ifx-file-rulebook.md +252 -226
  212. package/docs/ja/specdojo/rulebooks/ifx-index-rulebook.md +118 -40
  213. package/docs/ja/specdojo/rulebooks/imp-business-rulebook.md +11 -11
  214. package/docs/ja/specdojo/rulebooks/imp-data-rulebook.md +9 -9
  215. package/docs/ja/specdojo/rulebooks/imp-interface-rulebook.md +4 -4
  216. package/docs/ja/specdojo/rulebooks/imp-operations-rulebook.md +11 -11
  217. package/docs/ja/specdojo/rulebooks/imp-test-rulebook.md +11 -11
  218. package/docs/ja/specdojo/rulebooks/mm-rulebook.md +4 -3
  219. package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +34 -29
  220. package/docs/ja/specdojo/rulebooks/pm-change-request-log-rulebook.md +8 -8
  221. package/docs/ja/specdojo/rulebooks/pm-issue-log-rulebook.md +2 -2
  222. package/docs/ja/specdojo/rulebooks/pm-organization-rulebook.md +50 -56
  223. package/docs/ja/specdojo/rulebooks/pm-plan-rulebook.md +46 -55
  224. package/docs/ja/specdojo/rulebooks/pm-quality-management-plan-rulebook.md +57 -54
  225. package/docs/ja/specdojo/rulebooks/pm-raci-rulebook.md +50 -65
  226. package/docs/ja/specdojo/rulebooks/pm-risk-register-rulebook.md +2 -2
  227. package/docs/ja/specdojo/rulebooks/pm-roles-rulebook.md +70 -97
  228. package/docs/ja/specdojo/rulebooks/pr-rulebook.md +2 -1
  229. package/docs/ja/specdojo/rulebooks/prj-assumptions-constraints-dependencies-rulebook.md +47 -56
  230. package/docs/ja/specdojo/rulebooks/prj-comparison-of-alternatives-rulebook.md +61 -135
  231. package/docs/ja/specdojo/rulebooks/sf-index-rulebook.md +116 -32
  232. package/docs/ja/specdojo/rulebooks/sf-rulebook.md +118 -61
  233. package/docs/ja/specdojo/rulebooks/sld-rulebook.md +152 -57
  234. package/docs/ja/specdojo/rulebooks/stsd-mermaid-rulebook.md +51 -39
  235. package/docs/ja/specdojo/rulebooks/stsd-rulebook.md +101 -46
  236. package/docs/ja/specdojo/rulebooks/sysd-critical-flows-rulebook.md +72 -329
  237. package/docs/ja/specdojo/rulebooks/sysd-cross-cutting-policy-rulebook.md +74 -263
  238. package/docs/ja/specdojo/rulebooks/sysd-index-rulebook.md +78 -195
  239. package/docs/ja/specdojo/rulebooks/tml-rulebook.md +4 -9
  240. package/docs/ja/specdojo/rulebooks/trc-requirements-to-specs-rulebook.md +3 -4
  241. package/docs/ja/specdojo/rulebooks/trc-requirements-to-tests-rulebook.md +3 -3
  242. package/docs/ja/specdojo/rulebooks/uis-rulebook.md +140 -143
  243. package/docs/ja/specdojo/samples/bac-sample.md +106 -21
  244. package/docs/ja/specdojo/samples/bdd-sample.yaml +143 -35
  245. package/docs/ja/specdojo/samples/bds-sample.md +100 -21
  246. package/docs/ja/specdojo/samples/bes-index-sample.md +59 -20
  247. package/docs/ja/specdojo/samples/bes-sample.md +80 -21
  248. package/docs/ja/specdojo/samples/br-sample.md +68 -14
  249. package/docs/ja/specdojo/samples/ccd-sample.md +81 -19
  250. package/docs/ja/specdojo/samples/cdfd-sample.md +172 -99
  251. package/docs/ja/specdojo/samples/cdfd-uc-sample.md +9 -7
  252. package/docs/ja/specdojo/samples/cdsd-sample.md +89 -20
  253. package/docs/ja/specdojo/samples/cdt-sample.md +116 -0
  254. package/docs/ja/specdojo/samples/cld-sample.md +3 -30
  255. package/docs/ja/specdojo/samples/clis-sample.md +132 -0
  256. package/docs/ja/specdojo/samples/cnd-sample.md +127 -21
  257. package/docs/ja/specdojo/samples/cpd-sample.md +136 -22
  258. package/docs/ja/specdojo/samples/cxd-sample.md +108 -22
  259. package/docs/ja/specdojo/samples/dct-index-sample.yaml +63 -17
  260. package/docs/ja/specdojo/samples/dss-sample.md +175 -0
  261. package/docs/ja/specdojo/samples/gl-sample.yaml +50 -14
  262. package/docs/ja/specdojo/samples/ifd-sample.md +105 -21
  263. package/docs/ja/specdojo/samples/ifx-cmd-sample.yaml +91 -60
  264. package/docs/ja/specdojo/samples/ifx-file-sample.md +462 -21
  265. package/docs/ja/specdojo/samples/ifx-index-sample.yaml +87 -19
  266. package/docs/ja/specdojo/samples/pm-members-sample.yaml +37 -13
  267. package/docs/ja/specdojo/samples/pm-organization-sample.md +52 -20
  268. package/docs/ja/specdojo/samples/pm-plan-sample.md +84 -26
  269. package/docs/ja/specdojo/samples/pm-quality-management-plan-sample.md +55 -22
  270. package/docs/ja/specdojo/samples/pm-raci-sample.md +69 -28
  271. package/docs/ja/specdojo/samples/pm-roles-sample.yaml +13 -12
  272. package/docs/ja/specdojo/samples/prj-assumptions-constraints-dependencies-sample.md +50 -26
  273. package/docs/ja/specdojo/samples/prj-comparison-of-alternatives-sample.md +89 -62
  274. package/docs/ja/specdojo/samples/sf-index-sample.md +89 -20
  275. package/docs/ja/specdojo/samples/sf-sample.md +121 -21
  276. package/docs/ja/specdojo/samples/sld-sample.md +107 -21
  277. package/docs/ja/specdojo/samples/stsd-sample.md +54 -26
  278. package/docs/ja/specdojo/samples/sysd-critical-flows-sample.md +166 -21
  279. package/docs/ja/specdojo/samples/sysd-cross-cutting-policy-sample.md +178 -21
  280. package/docs/ja/specdojo/samples/sysd-index-sample.md +82 -21
  281. package/docs/ja/specdojo/samples/tml-sample.yaml +4 -1
  282. package/docs/ja/specdojo/samples/uis-sample.md +164 -20
  283. package/docs/ja/specdojo/standards/document-metadata-standard.md +33 -4
  284. package/docs/ja/specdojo/standards/id-and-file-naming-standard.md +3 -1
  285. package/docs/ja/specdojo/standards/rulebook-authoring-standard.md +1 -0
  286. package/docs/ja/specdojo/templates/bac-template.md +76 -0
  287. package/docs/ja/specdojo/templates/bes-template.md +56 -0
  288. package/docs/ja/specdojo/templates/br-template.md +64 -0
  289. package/docs/ja/specdojo/templates/cdfd-template.md +81 -54
  290. package/docs/ja/specdojo/templates/cdfd-uc-template.md +9 -5
  291. package/docs/ja/specdojo/templates/cnd-template.md +137 -0
  292. package/docs/ja/specdojo/templates/cpd-template.md +129 -0
  293. package/docs/ja/specdojo/templates/cxd-template.md +105 -0
  294. package/docs/ja/specdojo/templates/dct-data-model-cdt-template.yaml +40 -0
  295. package/docs/ja/specdojo/templates/dct-data-model-cld-template.yaml +7 -14
  296. package/docs/ja/specdojo/templates/dct-index-template.md +9 -20
  297. package/docs/ja/specdojo/templates/dct-project-management-template.yaml +5 -1
  298. package/docs/ja/specdojo/templates/ifd-template.md +86 -0
  299. package/docs/ja/specdojo/templates/ifx-cmd-template.yaml +44 -28
  300. package/docs/ja/specdojo/templates/ifx-index-template.yaml +40 -0
  301. package/docs/ja/specdojo/templates/opr-template.md +2 -4
  302. package/docs/ja/specdojo/templates/pm-organization-template.md +9 -3
  303. package/docs/ja/specdojo/templates/pm-plan-template.md +4 -4
  304. package/docs/ja/specdojo/templates/pm-quality-management-plan-template.md +17 -9
  305. package/docs/ja/specdojo/templates/pm-raci-template.md +24 -13
  306. package/docs/ja/specdojo/templates/pm-roles-template.yaml +3 -2
  307. package/docs/ja/specdojo/templates/prj-assumptions-constraints-dependencies-template.md +6 -3
  308. package/docs/ja/specdojo/templates/prj-comparison-of-alternatives-template.md +22 -19
  309. package/docs/ja/specdojo/templates/stsd-template.md +46 -21
  310. package/docs/ja/specdojo/templates/sysd-critical-flows-template.md +94 -0
  311. package/docs/ja/specdojo/templates/sysd-cross-cutting-policy-template.md +122 -0
  312. package/docs/ja/specdojo/templates/sysd-index-template.md +89 -0
  313. package/docs/specdojo/lib/yaml-metadata.cjs +7 -0
  314. package/docs/specdojo/schemas/v1/bdd.schema.yaml +25 -57
  315. package/docs/specdojo/schemas/v1/condense-records.schema.yaml +26 -0
  316. package/docs/specdojo/schemas/v1/dct.schema.yaml +10 -0
  317. package/docs/specdojo/schemas/v1/deliverable-frontmatter.schema.yaml +3 -0
  318. package/docs/specdojo/schemas/v1/esil.schema.yaml +7 -141
  319. package/docs/specdojo/schemas/v1/exec-common.schema.yaml +3 -0
  320. package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +53 -3
  321. package/docs/specdojo/schemas/v1/exec-evidence.schema.yaml +3 -0
  322. package/docs/specdojo/schemas/v1/exec-plan-frontmatter.schema.yaml +14 -0
  323. package/docs/specdojo/schemas/v1/exec-result-frontmatter.schema.yaml +18 -0
  324. package/docs/specdojo/schemas/v1/finding-cause.schema.yaml +22 -0
  325. package/docs/specdojo/schemas/v1/grade-pipeline-state.schema.yaml +1 -1
  326. package/docs/specdojo/schemas/v1/grade-result.schema.yaml +2 -0
  327. package/docs/specdojo/schemas/v1/ifx-cmd.schema.yaml +65 -5
  328. package/docs/specdojo/schemas/v1/ifx-index.schema.yaml +142 -0
  329. package/docs/specdojo/schemas/v1/register-events.schema.yaml +2 -0
  330. package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +17 -1
  331. package/package.json +2 -2
  332. package/templates/antigravity/orchestrator.md +3 -2
  333. package/templates/claude/agents/specdojo-orchestrator.md +3 -2
  334. package/templates/codex/agents/specdojo-orchestrator.toml +3 -2
  335. package/templates/codex/orchestrator.md +3 -2
  336. package/templates/devcontainer/tmux.conf +6 -0
  337. package/templates/opencode/agents/specdojo-orchestrator.md +3 -2
@@ -3,310 +3,177 @@ specdojo:
3
3
  id: specdojo:cxd-rulebook
4
4
  type: rulebook
5
5
  deliverable_type: architecture
6
- status: draft
7
- recipe: undecided
6
+ status: ready
7
+ target_format: markdown
8
+ includes:
9
+ - specdojo:cxd-mermaid-rulebook
10
+ recipe: specdojo:cxd-recipe
8
11
  sample: specdojo:cxd-sample
9
- template: undecided
12
+ template: specdojo:cxd-template
13
+ based_on:
14
+ - specdojo:rulebook-authoring-standard
10
15
  ---
11
16
 
12
- # C4コンテキスト図 ドキュメント作成ルール
17
+ # C4コンテキスト図(CXD)作成ルール
13
18
 
14
- C4 Contextual Diagram (CXD) Documentation Rules
19
+ C4 Context Diagram (CXD) Authoring Rule
15
20
 
16
- 本ドキュメントは、アーキテクチャ設計のために **C4コンテキスト図と、その図を説明する文章**を、統一した粒度・表現で作成するためのルールです。
17
-
18
- この章の成果物は、次の2つをセットで扱います。
19
-
20
- - **C4コンテキスト図(Mermaid)**: 対象システムと「境界外」の人・外部システムとの関係を俯瞰で合意する
21
- - **説明(Markdown)**: 図の要素(人/対象/外部/境界/関係)の意味を文章で合意する
22
-
23
- Mermaid 記法そのもののルールは [cxd-mermaid-rulebook.md](cxd-mermaid-rulebook.md) を参照してください。
21
+ 対象システム(Software System)を 1 つのブラックボックスとして捉え、システム境界の外側に位置する利用者(Person)および外部システム(External Software System)との関係・責任分界を俯瞰的に定義する規約を定めます。内部のコンテナ・コンポーネント構造や外部インターフェース構文・データ構造の詳細は各正本を参照し、本書ではシステム境界の合意、外部依存の識別、境界上の技術制約と検証観点の整理を扱います。
24
22
 
25
23
  ## 1. 全体方針
26
24
 
27
- - CXDは「対象システムが、誰に/何と関わるか」を合意するための図である。
28
- - 図に入れるのは **システム境界の外側との関係**までとし、内部構造(コンテナ/コンポーネント)や実装詳細は含めない。
29
- - 1つの図には **対象システムを1つ**だけ置く(複数対象がある場合は図を分ける)。
30
- - 図は「正確さ(過剰な詳細)」よりも「解釈が割れないこと(合意)」を優先する。
31
-
32
- ## 2. ファイル命名・ID規則
33
-
34
- - ファイル名: `cxd-<番号>-<短い日本語名>.md`
35
-
36
- - 例: `cxd-010-駄菓子屋きぬや販売管理システム-コンテキスト.md`
37
-
38
- - Frontmatter:
39
-
40
- - `id`: 小文字ハイフン形式(例: `cxd-candy-shop-sales-context`)
41
- - `title`: 「〇〇のC4コンテキスト図」のように対象が分かる表現
42
-
43
- ## 3. 推奨 Frontmatter 項目
44
-
45
- Frontmatter の共通ルールは [document-metadata-standard.md](../standards/document-metadata-standard.md) に従います。
46
-
47
- | 項目 | 説明 | 必須 |
48
- | ---------- | ---------------------------------------------- | ---- |
49
- | id | ドキュメントID(小文字ハイフン) | ○ |
50
- | type | `architecture` 固定 | ○ |
51
- | title | ドキュメント名 | ○ |
52
- | status | `draft`/`ready`/`deprecated` | ○ |
53
- | part_of | 上位ドキュメントID(分割している場合) | 任意 |
54
- | based_on | 根拠となる定義(用語集、外部IF、上位方針など) | 任意 |
55
- | supersedes | 置き換え関係(古い図→新しい図) | 任意 |
56
-
57
- ### 3.1. `based_on` の考え方(例)
58
-
59
- - 用語集(`gl-...`)や業務データ辞書(`bdd-...`)
60
- - 外部システムIFの仕様(IF章のドキュメント)
61
- - 参照する上位の方針(DEC、非機能要件など)
62
-
63
- ## 4. CXDで合意すること(スコープ)
64
-
65
- ### 4.1. 合意したいこと
66
-
67
- - 対象システムの名前と、責務の一言(何をするシステムか)
68
- - 利用者(Person)と、その利用目的(何のために使うか)
69
- - 外部システム(External Software System)と、連携の意図(何をやり取りするか)
70
- - 関係(Relationship)の向きと意味(誰が主に呼び出す/依存するか)
71
- - 対象システムの「境界」の考え方(何を含み、何を含まないか)
72
-
73
- ### 4.2. 合意しないこと(この図で扱わない)
74
-
75
- - 対象システムの内部の分解(コンテナ/コンポーネント、内部プロセス、内部データストア)
76
- - APIエンドポイント、HTTPメソッド、リクエスト/レスポンスJSONなどのIF詳細
77
- - 物理テーブル名・物理カラム名・SQL全文
78
- - 実装クラス/関数名、ライブラリ名、具体的な技術選定の列挙
79
-
80
- ## 5. CXDの要素定義(図と文章の両方で説明する)
81
-
82
- この章では、図に描いた要素について **最低限の説明**を併記し、レビュー可能にします。
83
-
84
- ### 5.1. Person(人/ロール)
25
+ - 1 ファイルにつき 1 つの対象システム(または合意したシステム境界)を扱い、対象システムを内部構造に立ち入らない単一のブラックボックスとして定義します。
26
+ - 対象システムを取り巻く利用者(人・ロール)と外部システム、およびそれらの間の主たる利用・連携の関係を、図と対応表の両面から解釈が割れない粒度で記述します。
27
+ - 図の描画記法は `includes` で宣言した [[specdojo:cxd-mermaid-rulebook|Mermaid を用いたC4コンテキスト図 作成ルール]] に従います。図と本文の表で要素名・関係ラベルを一致させ、図の矢印を文章でそのままなぞる重複説明は行いません。
28
+ - 内部コンテナ分割は C4 コンテナ図(`cnd`)、内部コンポーネント構造は C4 コンポーネント図(`cpd`)、実行環境・ネットワーク配置はインフラ構成図(`ifd`)、採用技術一覧は技術スタック一覧(`tsd-index`)、外部連携や操作の詳細は外部インターフェース仕様(`ifx-*`)や CLI 仕様(`clis`)・画面仕様(`uis`)を正本とし、CXD には境界判断に必要な要点と参照先だけを残します。
29
+ - 必須・任意・禁止を区別します。未作成の参照先や未確定の境界論点がある場合は、確定仕様と混ぜずに「メモ / 将来課題」へ影響・担当ロール・解消条件・引き継ぎ先を記録します。
85
30
 
86
- Personは、対象システムに対して目的をもって関わる主体(人/役割/組織)です。
31
+ ### 1.1. 対象者と確認する内容
87
32
 
88
- - 書くこと(推奨):
89
- - ロール名(例: 店員、店主、経理担当)
90
- - 対象システムに何をしに来るか(例: 売上登録を行う、在庫を確認する)
91
- - 重要な前提(ある場合のみ。例: 店舗内からのみ利用)
92
- - 書かないこと:
93
- - 個人名、組織の詳細階層、UI操作手順の逐語列挙
33
+ | 対象者 | 解決する課題 | 確認する内容 |
34
+ | -------------------------------------------- | ---------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------- |
35
+ | プロダクトオーナー(PO)・業務分析担当(BA) | システムの提供価値・対象範囲と業務上の利用者・外部連携の認識がずれる | システム境界の内外、対象外責務の委譲先、利用者と外部システムの関係が業務観点で妥当かを確認・承認できる |
36
+ | アーキテクト(ARC)・開発者(DEV) | 下位設計や外部連携設計の前提となるシステム境界・技術制約が曖昧になる | 外部システムとの依存方向、信頼・実行境界の制約、下位設計(`cnd`・`ifd`・`ifx-*` 等)への接続先を判断できる |
37
+ | 品質保証担当(QE)・運用担当(OPS) | 境界上の契約や外部依存の障害・不在時に検証・監視すべき対象が分からない | 境界をまたぐ入出力の要点、外部システム異常時の扱い、結合テスト・スタブ検証の観点を識別できる |
94
38
 
95
- ### 5.2. Software System(対象システム)
39
+ ## 2. 位置づけと用語定義
96
40
 
97
- この図の中心に置くシステムです。CXDでは **対象システムは1つ**に限定します。
41
+ CXD は利用目的と対象範囲を根拠として、アーキテクチャ設計の最上位でシステム全体の境界と外部関係を定義します。下図の入力文書は候補であり、実際の根拠は各タスクの参照範囲に従います。
98
42
 
99
- - 書くこと(推奨):
100
- - システム名(短く一意)
101
- - システムの責務(1文。例: 店舗の販売・仕入・在庫・簡易会計を一元管理する)
102
- - 「境界」に含める範囲の補足(ある場合のみ)
103
- - 書かないこと:
104
- - 内部モジュール/サブシステムの列挙、画面一覧、DBスキーマ
105
-
106
- ### 5.3. External Software System(外部システム)
107
-
108
- 対象システムの外側にあり、対象システムが連携する相手(既存の別システム、SaaS、決済、会計など)です。
109
-
110
- - 書くこと(推奨):
111
- - 外部システム名(一般名でよい)
112
- - 連携の目的(例: 決済を依頼する、仕訳を送る、マスタを参照する)
113
- - 連携の方向性(誰が主に呼び出す/依存するか)
114
- - 書かないこと:
115
- - API仕様の詳細、データ項目一覧(それらはIF仕様へ)
116
-
117
- ### 5.4. System Boundary(システム境界)
118
-
119
- 境界は「対象システムが責任を持つ範囲」を表します。境界の内外が曖昧だと、責任分界(運用・障害・変更)が曖昧になります。
120
-
121
- - 書くこと(推奨):
122
- - 境界に含めるもの(例: 店舗内の販売管理)
123
- - 境界に含めないもの(例: 決済そのもの、会計システムの処理)
124
- - 注意:
125
- - 境界内に「対象システムのノード1つだけ」を置く運用を基本とし、内部構造は別図(コンテナ図など)へ委譲します。
126
-
127
- ### 5.5. Relationship(関係)
128
-
129
- 関係は「やり取りの意味」を合意するための線です。CXDでは **すべての関係にラベル**を付けます。
130
-
131
- - 書くこと(必須):
132
- - 方向(誰が主に利用/依存/送信するか)
133
- - ラベル(短い日本語。名詞句または短い動詞句)
134
- - 書くこと(推奨):
135
- - やり取りの意図(例: 売上登録、決済依頼、仕訳連携)
136
- - 重要な前提(ある場合のみ。例: 非同期、日次バッチ)
137
- - 書かないこと:
138
- - HTTP詳細、データ項目列挙、SQL、実装条件式
139
-
140
- ## 6. 本文構成(標準テンプレ)
141
-
142
- 各 CXD 成果物は、以下見出しを順番に並べます。
143
-
144
- 1. 概要
145
- 2. C4コンテキスト図(Mermaid)
146
- 3. 要素の説明
147
- 4. 補足
43
+ ```mermaid
44
+ graph TD
45
+ BIZ["プロジェクト概要 / 概念データフロー<br/>(prj-overview / cdfd)"] --> CXD["C4コンテキスト図 (cxd)<br/>システム境界・利用者・外部システム・関係"]
46
+ CXD -.->|"内部構造の展開"| C4LOW["下位C4・インフラ図<br/>(cnd / cpd / ifd)"]
47
+ CXD -.->|"操作・連携契約の正本参照"| IF["UI・CLI仕様 / 外部IF仕様<br/>(uis / clis / ifx-*)"]
48
+ CXD -.->|"採用技術の正本参照"| TSD["技術スタック一覧<br/>(tsd-index / tsd-*)"]
49
+ ```
148
50
 
149
- ## 7. 記述ガイド詳細
51
+ | 用語 | この文書での意味 |
52
+ | ---------------------------------------- | ---------------------------------------------------------------------------------------------------------------------- |
53
+ | Person(人・ロール) | システム境界の外側から対象システムを直接利用・運用・管理する業務ロールまたは利用者区分。個人名ではなく役割で定義する |
54
+ | Software System(対象システム) | 本コンテキスト図の中心となるシステム。内部のコンテナやモジュール構造を展開せず、単一の責務単位として扱う |
55
+ | System Boundary(システム境界) | 対象システムが直接責務を持つ範囲と、外部の運用・外部システムへ委ねる範囲の分界線 |
56
+ | External Software System(外部システム) | 対象システムの境界外にあり、対象システムとデータや制御をやり取りする外部ソフトウェア・外部サービス・外部ツールチェーン |
57
+ | Relationship(関係) | Person または External Software System と対象システムの間の主たる利用・呼び出し・データ連携の関係 |
150
58
 
151
- ### 7.1. 概要
59
+ ## 3. ファイル命名・ID規則
152
60
 
153
- - 「この図が何を表すか」「対象システム」「前提」を1〜3文で書きます。
61
+ 命名と配置の共通原則は [[specdojo:docs-structure-guide|ドキュメント構成ガイド]] および [[specdojo:id-and-file-naming-standard|ID・ファイル命名標準]] に従います。
154
62
 
155
- ### 7.2. C4コンテキスト図(Mermaid)
63
+ - 配置先は原則として `docs/<lang>/product/030-architecture/010-c4/` とします。
64
+ - ファイル名は `cxd-<context>.md` とします(例: `cxd-specdojo.md`)。`<context>` は対象システムまたは対象コンテキストを表す英小文字・数字・ハイフンのケバブケースとします。
65
+ - プロダクト文書の ID は `cxd-<context>`、プロジェクト文書は `<project-id>:cxd-<context>` とします。同梱の完成例は成果物と衝突しない `specdojo:` の ID を使います。
66
+ - 文書名は本文先頭の H1 に記述し、対象システム名と C4 コンテキスト図であることを明示します。
156
67
 
157
- - Mermaid のコードブロックで図を記述します。
158
- - Mermaid 記法ルールは [cxd-mermaid-rulebook.md](cxd-mermaid-rulebook.md) に従います。
159
- - 図には、少なくとも以下を含めます。
160
- - Person(人/ロール)
161
- - 対象システム(Software System)
162
- - 外部システム(External Software System)
163
- - 関係(Relationship。全矢印にラベル)
68
+ ## 4. 推奨 Frontmatter 項目
164
69
 
165
- ### 7.3. 要素の説明
70
+ 共通の必須・任意項目と値・型の制約は [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] および `docs/specdojo/schemas/v1/deliverable-frontmatter.schema.yaml` を正本とします。CXD 固有の指定と根拠の選び方は次のとおりです。
166
71
 
167
- - 図に登場する要素を、レビューしやすい粒度で説明します。
168
- - 推奨スタイル:
169
- - `###` レベルの小見出しで要素名(人/対象/外部/境界/関係)
170
- - 1〜3文で意味・前提・境界条件(含む/含まない)を説明
72
+ - `type` は本 rulebook の `deliverable_type` に対応する `architecture`、`rulebook` は `specdojo:cxd-rulebook` とします。
73
+ - `part_of` は所属する上位アーキテクチャ文書や索引がある場合に記載し、`based_on` は成果物カタログの `depends_on` の推移閉包に含まれる直接の内容根拠だけを示します。プロジェクト共通文脈(`prj-overview` 等)が `depends_on` にない場合は `based_on` に含めず、本文中で参照します。
74
+ - 未作成の依存先や未確定の契約は「メモ / 将来課題」へ記録し、空の `based_on` を埋めるために無関係な ID を追加しません。
75
+ - 作成・編集時の `status` は `draft` とし、完了条件をすべて満たして承認者が合意した時点で `ready` へ昇格します。
171
76
 
172
- ### 7.4. 補足
77
+ ## 5. 本文要件
173
78
 
174
- - 未確定な外部連携、境界が揺れている論点、図を分ける必要がありそうな論点を列挙します。
79
+ 見出し順・表・記入欄の骨組みは frontmatter で宣言した template を正本とし、本章は各内容の目的と必須性を定義します。Markdown の `##`〜`####` には階層ごとの連番と末尾の `.` を付け、章への参照は章タイトルで示します。
175
80
 
176
- ## 8. 命名・記述スタイル
81
+ | 章 | 必須・任意 | 目的と内容要件 |
82
+ | --------------------------- | ---------- | ---------------------------------------------------------------------------------------------------------------------- |
83
+ | 概要 | 必須 | 対象システムの目的・提供価値、コンテキスト図の対象範囲と対象外、主要ステークホルダーと確認内容を 1〜3 文と表で示す |
84
+ | C4コンテキスト図(Mermaid) | 必須 | `specdojo:cxd-mermaid-rulebook` に準拠したコンテキスト図と、図の読み取りに必要な補足注記(1〜3 文)を示す |
85
+ | 要素と境界の定義 | 必須 | 対象システムとシステム境界、Person、External Software System、Relationship を表で定義し、詳細仕様の正本へ案内する |
86
+ | 技術前提・制約と検証観点 | 必須 | システム境界における技術前提・制約(実行形態、信頼境界、外部依存の前提)と、境界・外部依存のテスト・検証観点を示す |
87
+ | メモ / 将来課題 | 任意 | 未作成の参照先、未確定の境界論点、段階的拡張予定について、影響・担当・解消条件・引き継ぎ先を示す。該当事項があれば必須 |
177
88
 
178
- - 用語はこの図の中で揺らさない(同じ相手を別名で呼ばない)。
179
- - ラベルは短くし、長い場合は改行(`<br>`)で読みやすくする(詳細はIF仕様へ)。
180
- - Personは「役割」を優先し、個人名ではなくロール名にする。
89
+ ## 6. 記述ガイド
181
90
 
182
- ## 9. 禁止事項
91
+ 各章は次の判断基準で記述します。共通のメタ情報・リンク・未確定事項の記法は上位のメタ情報標準を正本とし、ここには CXD 固有の判断と短い対比例を置きます。
183
92
 
184
- 次の記述は、CXDの粒度を超えるため避けます。
93
+ ### 6.1. 概要
185
94
 
186
- | 項目 | 理由 |
187
- | ------------------------------------------- | --------------------------------- |
188
- | 物理テーブル名・物理カラム名・SQL全文 | 図の粒度を超える(DB設計に記述) |
189
- | APIエンドポイント/HTTP/JSON等の詳細 | IF仕様に記述する |
190
- | 実装クラス/関数名、技術スタック列挙 | 変更に弱い・合意の対象がずれる |
191
- | 対象システム内部の詳細プロセス/データストア | コンテナ図/コンポーネント図で表す |
192
- | 矢印ラベルなしの関係 | 何の関係か合意できない |
95
+ - 判断基準: 対象システムが誰の何の課題を解決し、どこまでを本図の対象範囲とし、何を下位図や別仕様へ委ねるかを読み取れること。また、主要ステークホルダー(PO・BA・ARC・QE 等)が本図で確認・合意する観点が対応付けられていること。
96
+ - 良い例: 「本図は販売管理 CLI を単一のシステム境界として捉え、店舗スタッフ・管理者および外部の印刷・会計基盤との関係を定義する。コンテナ内部のモジュール構成は `cnd`、コマンド構文は `clis` を参照する。」
97
+ - 悪い例: 「本図はシステムの全体像を示すコンテキスト図である。」対象システムの責務範囲も対象外との分界も判断できません。
193
98
 
194
- ## 10. レビュー観点(チェックリスト)
99
+ ### 6.2. C4コンテキスト図(Mermaid)
195
100
 
196
- - 対象システムは1つに絞れているか
197
- - PersonとExternal Software Systemが含まれているか(無い場合は理由が書かれているか)
198
- - すべての関係にラベルがあり、意味が解釈一致するか
199
- - 境界の内外が説明され、責任分界が曖昧でないか
200
- - 図が「内部設計」や「IF詳細」に踏み込んでいないか
101
+ - 判断基準: `includes` で宣言した記法に従い、対象システムが一つで、境界外の主体とすべての関係を識別できること。ノード形状・色・構文は記法ルールへ委ねます。外部システムや Person がない場合は、その理由を明記します。
102
+ - 図の直後には、矢印の向きの意味(主たる利用・起動・データ送信の方向)、応答の省略、複数の依存をまとめた表示など、読み取りに必要な注記を 1〜3 文で補足します。詳細の参照先は関係表に集約し、図の矢印を 1 本ずつ文章で書き直す説明は置きません。
103
+ - 良い例: 境界内に対象システム 1 ノードのみを置き、Person と外部システムからの入出力・呼び出しを短い動詞句または名詞句ラベル(例: `売上登録・集計指示`、`AI実行起動・結果取得`)で表現する。
104
+ - 悪い例: 境界内に DB テーブルや内部モジュールを並べたり、ラベルなしの矢印やエンドポイント URL を図中に書き込んだりする。
201
105
 
202
- ## 11. サンプル(簡易)
106
+ ### 6.3. 要素と境界の定義
203
107
 
204
- ### 11.1. メタ情報(Frontmatter)
108
+ 判断基準は、図に登場するすべての要素と関係が漏れ・表記揺れなく表で定義され、境界内外の責任分界と詳細仕様の正本を追えることです。名称・ラベルは図との照合に使い、表には責務・利用条件・障害時の影響など図にない判断情報を加えます。
205
109
 
206
- ```yaml
207
- ---
208
- id: cxd-candy-shop-sales-context
209
- type: architecture
210
- title: 駄菓子屋きぬや販売管理システムのC4コンテキスト図
211
- status: draft
212
- part_of: []
213
- based_on: []
214
- ---
215
- ```
110
+ #### 6.3.1. 対象システムとシステム境界
216
111
 
217
- ### 11.2. 概要
112
+ - 対象システムの「システム名」「提供する中核責務」「境界内に含める範囲」「境界外へ委ねる範囲(対象外と委譲先)」を表または項目で明記します。
113
+ - 良い例: 「境界内: 取引記録とレシート控えの保持。境界外: プリンタの物理制御(印刷基盤へ委譲)、現金授受(店番担当が実施)。」
114
+ - 悪い例: 「販売管理に関する機能一式を提供する。」どこまでが自システムの実装責務で、どこからが外部システムや手運用なのか判別できません。
218
115
 
219
- この図は「駄菓子屋きぬや販売管理システム」が、利用者と外部システムとどのように関わるかを俯瞰します。
116
+ #### 6.3.2. Person(人・ロール)
220
117
 
221
- ### 11.3. C4コンテキスト図(Mermaid)
118
+ - 推奨列は「Person(図中ラベル)」「対応ロール」「利用目的・主な関わり」「境界上の接点・確認責務」です。プロジェクトのロール定義(`pm-roles` 等)や業務上の利用者区分と整合させ、個人名は記載しません。
119
+ - 良い例: 「店番担当: 現金販売を記録する。会計・印字の状態を確認し、保留取引を店舗責任者へ渡す。」業務上の利用者区分を用い、プロジェクトの役職を直接利用者として機械的に列挙しません。
120
+ - 悪い例: 「ユーザー: システムを使う人。」ロールごとの利用目的や境界上の確認責務が分かりません。
222
121
 
223
- ```mermaid
224
- flowchart LR
225
- %% Person
226
- 店員["👤店員"]
227
- 店主["👤店主"]
228
-
229
- %% External Systems
230
- 会計システム["会計システム"]
231
- 決済サービス["決済サービス"]
232
-
233
- %% Target System Boundary
234
- subgraph 境界["対象システム"]
235
- 販売管理システム("駄菓子屋きぬや<br>販売管理システム")
236
- end
237
-
238
- %% Relationships
239
- 店員 -->|"売上登録"| 販売管理システム
240
- 店主 -->|"商品・在庫管理"| 販売管理システム
241
- 販売管理システム -->|"会計仕訳連携"| 会計システム
242
- 販売管理システム -->|"決済依頼"| 決済サービス
243
- 決済サービス -->|"決済結果"| 販売管理システム
244
-
245
- %% Styles
246
- classDef person fill:#fff3bf,stroke:#f08c00,color:#000;
247
- classDef system fill:#d0ebff,stroke:#1c7ed6,color:#000;
248
- classDef external fill:#e9ecef,stroke:#495057,color:#000;
249
- class 店員,店主 person;
250
- class 販売管理システム system;
251
- class 会計システム,決済サービス external;
252
- style 境界 fill:#ffffff,fill-opacity:0,stroke:#868e96,stroke-width:1px,stroke-dasharray: 5 5;
253
- ```
122
+ #### 6.3.3. External Software System(外部システム)
254
123
 
255
- ```plaintext
256
- flowchart LR
257
- %% Person
258
- 店員["👤店員"]
259
- 店主["👤店主"]
260
-
261
- %% External Systems
262
- 会計システム["会計システム"]
263
- 決済サービス["決済サービス"]
264
-
265
- %% Target System Boundary
266
- subgraph 境界["対象システム"]
267
- 販売管理システム("駄菓子屋きぬや<br>販売管理システム")
268
-
269
- end
270
-
271
- %% Relationships
272
- 店員 -->|"売上登録"| 販売管理システム
273
- 店主 -->|"商品・在庫管理"| 販売管理システム
274
- 販売管理システム -->|"会計仕訳連携"| 会計システム
275
- 販売管理システム -->|"決済依頼"| 決済サービス
276
- 決済サービス -->|"決済結果"| 販売管理システム
277
-
278
- %% Styles
279
- classDef person fill:#fff3bf,stroke:#f08c00,color:#000;
280
- classDef system fill:#d0ebff,stroke:#1c7ed6,color:#000;
281
- classDef external fill:#e9ecef,stroke:#495057,color:#000;
282
- class 店員,店主 person;
283
- class 販売管理システム system;
284
- class 会計システム,決済サービス external;
285
- style 境界 fill:#ffffff,fill-opacity:0,stroke:#868e96,stroke-width:1px,stroke-dasharray: 5 5;
286
- ```
124
+ - 推奨列は「外部システム(図中ラベル)」「区分・位置づけ」「対象システムとの責任分界」「不在・障害時の影響と扱い」です。
125
+ - 確認できた連携相手を列挙し、必須の依存と機能を選んだ場合だけ使う依存を区別します。同じ端末で動く外部 CLI も責務が別なら境界外とし、未確認の接続経路や障害時の保証は仮定または論点として示します。
126
+ - 複数の外部システムを一つのノードにまとめる場合も、利用条件・責務・障害の影響は区別します。例えばローカル履歴管理とリモート共有をまとめても、通信失敗がローカル操作をすべて停止させるとは扱いません。注記と表で違いを説明できない場合はノードを分けます。
127
+ - 良い例: 「印刷基盤: 対象システムから控えを受け取って物理印字を担う。会計記録の管理は対象システムに残す。」境界と失敗時の影響を説明し、具体的な復旧保証は確認済みの連携契約に基づいて記述します。
128
+ - 悪い例: 「外部サービス: データを連携する。」何を外部に任せ、障害時に対象システムがどう振る舞うか判断できません。
287
129
 
288
- ### 11.4. 要素の説明
130
+ #### 6.3.4. Relationship(関係・連携契約)
289
131
 
290
- #### 11.4.1. Person(人/ロール)
132
+ - 推奨列は「関係ID」「起点 → 終点」「図中ラベル」「やり取りする情報・制御の要点」「連携方式・境界」「正本・関連仕様」です。
133
+ - 図中のすべての矢印と 1 対 1 または明確な対応関係を持たせ、やり取りの方向(利用者が起動するのか、対象システムが外部システムを起動・参照するのか)と、詳細な仕様の正本(`clis`、`ifx-cmd`、`ifx-api`、`ifx-file` 等)を示します。
134
+ - 良い例: 「`REL-03`: 対象システム → 印刷基盤。印字依頼と結果をやり取りし、詳細は外部コマンド連携仕様を参照する。」目的・方向・詳細の更新先が分かります。
135
+ - 悪い例: 引数フラグの全一覧や JSON ペイロードの全フィールドを表に転載する。外部インターフェース仕様やコマンドリファレンスとの二重管理になります。
291
136
 
292
- 店員・店主が、販売登録や在庫・商品管理のために対象システムを利用します。
137
+ #### 6.3.5. 正本の選び方と参照の境界
293
138
 
294
- #### 11.4.2. 対象システム(Software System)
139
+ | 対象 | 中身を委ねる正本 | CXD に残す判断情報 |
140
+ | ---------------------------------- | ------------------------------------------------------ | ------------------------------------------------------------ |
141
+ | システム内部のコンテナ・モジュール | C4 コンテナ図(`cnd`)・C4 コンポーネント図(`cpd`) | 対象システム全体としての責務と外部との境界 |
142
+ | 実行環境・ネットワーク配置 | インフラ構成図(`ifd`) | 境界をまたぐ通信・実行形態の前提(ローカル実行、外部通信等) |
143
+ | 採用技術・ランタイム・バージョン | 技術スタック一覧(`tsd-index`)・個別技術定義(`tsd`) | アーキテクチャ境界に影響する技術上の前提のみ |
144
+ | 利用者の画面操作・CLI 操作 | 画面仕様(`uis`)・CLI 仕様(`clis`) | 誰がどの目的で対象システムを操作するか |
145
+ | 外部システムとの連携契約 | 外部インターフェース仕様(`ifx-index` / `ifx-*`) | 連携の目的、方向、渡す情報の概要、不在・失敗時の境界上の扱い |
295
146
 
296
- 店舗の販売・仕入・在庫に関する情報を一元管理し、会計・決済などの外部連携を行います。
147
+ - 正本が未作成の場合は、予定される文書 ID またはファイル名をインラインコード(例: `` `cnd-specdojo` ``)で示し、未作成である事実と引き継ぎ事項を「メモ / 将来課題」へ記録します。存在しない文書へリンクを張りません。
148
+ - 判断基準: CXD だけで境界を説明でき、値・構文・構造の詳細には固有の更新先があること。良い例は「連携目的を残して電文は IF 仕様へ委ねる」、悪い例は「正本へのリンクだけを置き、責任分界を省く」です。
297
149
 
298
- #### 11.4.3. 外部システム(External Software System)
150
+ ### 6.4. 技術前提・制約と検証観点
299
151
 
300
- 会計システムへは仕訳相当情報を連携し、決済サービスへは決済を依頼して結果を受信します(詳細はIF仕様に記載)。
152
+ - 判断基準: システム境界の成立に必要な技術的前提・制約(実行環境、ネットワーク到達性、認証・秘密情報の管理境界、人間による承認ゲート等)が明示され、かつ境界・外部依存に対する検証観点(QE・ARC・BA・PO が確認すべきテスト・受入観点)が識別できること。
153
+ - 「技術前提・制約」と「システム境界・外部依存の検証観点」の 2 つの小節(または表)に分け、検証観点を関係 ID または対象境界に対応付けます。検証設計へ渡す確認事項と、契約・実装で確認済みの保証を区別します。
154
+ - 良い例: 「外部コマンドの時間切れ時に、会計結果と印字結果を区別できるか確認する。認証管理者と外部へ渡す情報は連携契約で確認する。」検証対象と確認済みの保証を区別します。
155
+ - 悪い例: 「セキュリティに配慮し、十分にテストを行う。」境界上の具体的な制約もテスト可能な検証観点も特定できません。
301
156
 
302
- #### 11.4.4. 境界(System Boundary)
157
+ ### 6.5. メモ / 将来課題
303
158
 
304
- 境界には販売管理システム本体を含みます。決済処理や会計処理そのものは境界の外側です。
159
+ - 判断基準: 現時点の確定仕様と、未作成の下位文書・未確定の外部連携論点が明確に区別され、影響範囲・担当ロール(Role code)・解消条件・引き継ぎ先が分かること。
160
+ - 良い例: 「印字結果不明時の再印刷条件は未確定で、二重印字の恐れがある。ARC / DEV が未作成の `ifx-cmd-print` に照合・再印刷の条件を定め、QE が会計を再実行せず紙面を照合できることを確認して解消する。」
161
+ - 悪い例: 「詳細は別途検討する。」誰がいつ何を基準に解消するか判断できません。
305
162
 
306
- ### 11.5. 補足
163
+ ## 7. 禁止事項
307
164
 
308
- - 会計連携の頻度(リアルタイム/日次)を確定する。
165
+ | 禁止する記述 | 理由 |
166
+ | --------------------------------------------------------------- | ------------------------------------------------------------------- |
167
+ | 内部コンテナ・内部モジュール・物理 DB テーブルの図中への混入 | C4 コンテキスト図の粒度を超え、`cnd`・`cpd`・`dts` の責務と重なる |
168
+ | コマンド引数・API エンドポイント・JSON ペイロード詳細の本文転載 | `clis`・`ifx-*`・リファレンス等の正本との二重管理を防ぐ(PJR-2GD6) |
169
+ | ラベルのない関係矢印、または図と表の間の要素名・ラベルの不一致 | ステークホルダー間でシステム境界と連携内容の合意が取れなくなる |
170
+ | 個人名や認証情報・秘密鍵の具体値の記載 | ロール定義およびセキュリティ原則に反する |
171
+ | 図の矢印をそのまま文章で列挙するだけの重複説明 | 判断情報を増やさず文書の保守コストだけを増やす |
172
+ | 未作成の関連文書をあたかも存在するかのようにリンクする記述 | 仕様の確定範囲と参照整合性を損なう |
173
+ | 本文への sample・recipe・template のリンク章や wikilink の設置 | 実践の型との対応関係は frontmatter で宣言する |
309
174
 
310
- ## 12. 参照
175
+ ## 8. 運用ルール
311
176
 
312
- - Mermaid 記法(CXD): [cxd-mermaid-rulebook.md](../rulebooks/cxd-mermaid-rulebook.md)
177
+ - システム境界、対象ロール、外部システムの種類・連携方向、境界上の制約や検証観点が変わる場合は CXD を改訂します。外部コマンドのオプション追加や内部モジュール分割のみの変更は各正本(`clis`・`ifx-*`・`cnd` 等)へ反映し、CXD の境界定義に影響がないことを確認します。
178
+ - 改訂・廃止は [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] の「文書の改訂・廃止とライフサイクル変更管理」に従います。CXD 固有の追従先は、境界を展開する `cnd`・`cpd`・`ifd`、利用者の接点を定義する `uis`・`clis`、外部連携の `ifx-*`、境界テスト・受入条件です。`PO` は境界と承認、`BA` は利用者・業務関係、`ARC` は下位図・連携境界、`DEV` は実装への影響、`QE` は検証仕様・期待結果を確認し、`PM` が追従作業と未決事項の登録簿への引き継ぎを管理します。
179
+ - 成果物の `status` を `ready` へ昇格させる判断は人間の承認者が行います。タスクの実行完了と成果物の確定(`ready`)を同一視しません。