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
@@ -3,293 +3,156 @@ specdojo:
3
3
  id: specdojo:cpd-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:cpd-mermaid-rulebook
10
+ recipe: specdojo:cpd-recipe
8
11
  sample: specdojo:cpd-sample
9
- template: undecided
12
+ template: specdojo:cpd-template
13
+ based_on:
14
+ - specdojo:rulebook-authoring-standard
10
15
  ---
11
16
 
12
- # C4コンポーネント図 ドキュメント作成ルール
17
+ # C4コンポーネント図(CPD)作成ルール
13
18
 
14
- C4 Component Diagram (CPD) Documentation Rules
19
+ C4 Component Diagram (CPD) Authoring Rule
15
20
 
16
- 本ドキュメントは、アーキテクチャ設計のために **C4コンポーネント図と、その図を説明する文章**を、統一した粒度・表現で作成するためのルールです。
17
-
18
- この章の成果物は、次の2つをセットで扱います。
19
-
20
- - **C4コンポーネント図(Mermaid)**: 対象コンテナ(実行/配備単位)の内部を主要コンポーネント(責務のまとまり)に分解し、外部要素との関係を俯瞰で合意する
21
- - **説明(Markdown)**: 図の要素(人/境界/コンポーネント/DB/外部/関係)の意味を文章で合意する
22
-
23
- Mermaid 記法そのもののルールは [cpd-mermaid-rulebook.md](cpd-mermaid-rulebook.md) を参照してください。
21
+ 一つのコンテナ内部を主要な責務へ分け、依存方向と境界で受け渡す情報を定義する規約です。実装配置と結合テストの設計入力を扱い、クラス構造や連携構文は各詳細仕様へ委ねます。
24
22
 
25
23
  ## 1. 全体方針
26
24
 
27
- - CPD は「**対象コンテナの内部**が、どの主要コンポーネントで構成され、何とやり取りするか」を合意するための図である。
28
- - 図に入れるのは **コンポーネント粒度**までとし、クラス/関数等の実装詳細は含めない。
29
- - 1つの図には **対象コンテナを1つ**だけ置く(複数対象がある場合は図を分ける)。
30
- - 図は「正確さ(過剰な詳細)」よりも「解釈が割れないこと(合意)」を優先する。
31
-
32
- ## 2. ファイル命名・ID規則
33
-
34
- - ファイル名: `cpd-<番号>-<短い日本語名>.md`
35
- - 例: `cpd-010-販売API-コンポーネント.md`
36
- - Frontmatter:
37
- - `id`: 小文字ハイフン形式(例: `cpd-sales-api-components`)
38
- - `title`: 「〇〇のC4コンポーネント図」のように対象が分かる表現
39
-
40
- ## 3. 推奨 Frontmatter 項目
41
-
42
- Frontmatter の共通ルールは [document-metadata-standard.md](../standards/document-metadata-standard.md) に従います。
43
-
44
- | 項目 | 説明 | 必須 |
45
- | ---------- | ---------------------------------------------- | ---- |
46
- | id | ドキュメントID(小文字ハイフン) | ○ |
47
- | type | `architecture` 固定 | ○ |
48
- | title | ドキュメント名 | ○ |
49
- | status | `draft`/`ready`/`deprecated` | ○ |
50
- | part_of | 上位ドキュメントID(分割している場合) | 任意 |
51
- | based_on | 根拠となる定義(用語集、外部IF、上位方針など) | 任意 |
52
- | supersedes | 置き換え関係(古い図→新しい図) | 任意 |
53
-
54
- ### 3.1. `based_on` の考え方(例)
55
-
56
- - 用語集(`gl-...`)や業務データ辞書(`bdd-...`)
57
- - 外部システムIFの仕様(IF章のドキュメント)
58
- - 参照する上位の方針(DEC、非機能要件など)
59
- - 上位のコンテナ図(CND)の該当ページ
60
-
61
- ## 4. CPDで合意すること(スコープ)
62
-
63
- ### 4.1. 合意したいこと
64
-
65
- - 対象コンテナ(Container Boundary)と、責務の一言(何をするコンテナか)
66
- - 主要コンポーネント(Component)の一覧と、それぞれの責務(1〜2文)
67
- - 主要DB(Database)がある場合、その役割(何を永続化するか)
68
- - 外部システム(External Software System)と、連携の意図(何をやり取りするか)
69
- - 関係(Relationship)の向きと意味(誰が主に呼び出す/依存するか)
70
-
71
- ### 4.2. 合意しないこと(この図で扱わない)
72
-
73
- - クラス設計、内部の関数構成、ソースコード構造の網羅
74
- - APIエンドポイント、HTTPメソッド、リクエスト/レスポンスJSONなどのIF詳細
75
- - 物理テーブル名・物理カラム名・SQL全文
76
- - 画面遷移やクリック手順の逐語列挙
77
-
78
- ## 5. CPDの要素定義(図と文章の両方で説明する)
79
-
80
- この章では、図に描いた要素について **最低限の説明**を併記し、レビュー可能にします。
81
-
82
- ### 5.1. Person(人/ロール)
83
-
84
- Personは、対象コンテナに対して目的をもって関わる主体(人/役割/組織)です。
85
-
86
- - 書くこと(推奨):
87
- - ロール名(例: 店員、店主、経理担当)
88
- - どのコンポーネントを、何のために利用するか(例: UI で売上登録を行う)
89
- - 書かないこと:
90
- - 個人名、UI操作手順の逐語列挙
91
-
92
- ### 5.2. Container Boundary(対象コンテナ境界)
25
+ - 上位 C4 コンテナ図から対象コンテナを一つ選び、利用者、外部依存、ストアの境界を引き継ぎます。別コンテナを内部コンポーネントへ取り込みません。
26
+ - 分割単位は固有の責務と入出力を持つまとまりです。主要コンポーネントは 5〜15 個程度を目安とし、数合わせやコマンド・ファイル単位の機械的な分割はしません。
27
+ - 図は主要依存、定義表は責務・情報の受け渡し・制約を担います。主要経路を選んだ理由と省略範囲を示し、全関数・全呼び出しの一覧にしません。
28
+ - 記法は `includes` で適用する [[specdojo:cpd-mermaid-rulebook|CPD Mermaid 記法ルール]] を正本とし、形状・色・構文は本書で再定義しません。
93
29
 
94
- 境界は「この図で扱う対象コンテナの範囲」を表します。
30
+ ### 1.1. 作成・確認・合意の分担
95
31
 
96
- - 書くこと(推奨):
97
- - 境界に含めるもの(主要コンポーネント/主要DB等)
98
- - 境界に含めないもの(外部システム/外部サービス等)
32
+ 以下を作業単位とし、PM が対象コンテナ数、関係数、未確認の依存を基に担当と見積もりを Schedule に割り当てます。Role code と実行主体の対応・兼務はプロジェクトの組織定義に従い、CPD に別の名簿を作りません。
99
33
 
100
- ### 5.3. Component(コンポーネント)
34
+ | 作業・確認対象 | 担当 Role code | 判断タイミング・完了条件 |
35
+ | ---------------------------------------------- | ------------------------------ | --------------------------------------------------------------------------------------- |
36
+ | 対象者の課題・期待価値と分割の目的 | BA、業務確認者となる利用者代表 | 分割案の作成前。上位の目的と成功基準に対応すること |
37
+ | 境界・責務・依存方向の作成とアーキテクチャ確認 | ARC | 詳細設計への引き渡し前。上位図との対応と採用理由を説明できること |
38
+ | 実装配置・詳細契約への対応確認 | DEV | 実装着手前。確認済みの対応と未確認の論点を分離できること |
39
+ | 図・定義表の照合と結合観測点の確認 | QE | 合意依頼前。「検証と合意の判定」の条件を満たすこと |
40
+ | 未決事項・後続作業・期限の調整 | PM | 依存変更時と合意依頼前。PJR と Schedule への反映先が定まること |
41
+ | 公開前確認と最終合意 | OPS、人間の PO | 公開・確定前。OPS が確認結果を提示し、PO が承認・保留・差し戻しと公開可否を判断すること |
101
42
 
102
- コンポーネントは、責務のまとまり(モジュール/サービス/層など)です。
43
+ ## 2. 位置づけと用語定義
103
44
 
104
- - 書くこと(必須):
105
- - コンポーネント名
106
- - 責務(1〜2文)
107
- - 書くこと(推奨):
108
- - 主な入出力の種類(例: 売上登録、在庫照会)
109
- - 関係するデータストア(例: 販売DBを更新する)
110
- - 書かないこと:
111
- - 内部クラス/関数、パッケージ構成の網羅
45
+ | 用語 | 本書での意味 |
46
+ | -------------- | ---------------------------------------------------------------------------- |
47
+ | コンテナ | 上位図が定める実行・配備単位。コンポーネントごとの別プロセス化を意味しない |
48
+ | コンポーネント | 対象コンテナ内で、まとまった責務と他要素との接点を持つ論理単位 |
49
+ | 依存方向 | 主たる利用・依頼の起点から終点への向き。時系列や応答データの向きとは区別する |
112
50
 
113
- ### 5.4. Database(データベース)
51
+ 上位図は実行単位間の境界、本図は一単位の内部責務を扱います。物理配置、内部クラス、値・構文・データ構造はインフラ設計、実装、リファレンス、schema、外部 IF 仕様を正本とします。
114
52
 
115
- Database は、対象コンテナが主に参照/更新する永続データストアです。
53
+ ## 3. ファイル命名・ID規則
116
54
 
117
- - 書くこと(推奨):
118
- - DBの論理名(例: 販売DB、在庫DB)
119
- - 何を永続化するか(例: 売上・在庫・仕入の記録)
120
- - 書かないこと:
121
- - 物理テーブル名・物理カラム名・SQL
55
+ - 共通規則は [[specdojo:id-and-file-naming-standard|ID・ファイル命名標準]] と [[specdojo:docs-structure-guide|ドキュメント構成ガイド]] に従います。
56
+ - ファイル名は `cpd-<context>.md` とし、対象コンテナを識別する英小文字・数字・ハイフンの名前を使います。プロダクト文書の配置は原則 `docs/<lang>/product/030-architecture/010-c4/` とします。
57
+ - プロダクト文書の ID は `cpd-<context>`、プロジェクト文書は `<project-id>:cpd-<context>` とし、H1 に対象名と図の種別を示します。
58
+ - 関係には文書内で一意な `REL-01` 形式の ID を付け、図の端点・ラベルと関係表を対応付けます。名称変更だけでは ID を振り直しません。
122
59
 
123
- ### 5.5. External Software System(外部システム)
60
+ ## 4. 推奨 Frontmatter 項目
124
61
 
125
- 対象コンテナの外側にあり、対象コンテナが連携する相手(既存の別システム、SaaS、決済、会計など)です。
62
+ 共通項目の型・値・必須条件は [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] と `docs/specdojo/schemas/v1/deliverable-frontmatter.schema.yaml` を正本とします。
126
63
 
127
- - 書くこと(推奨):
128
- - 外部システム名(一般名でよい)
129
- - 連携の目的(例: 決済を依頼する、仕訳を送る)
130
- - 連携の方向性(誰が主に呼び出す/依存するか)
131
- - 書かないこと:
132
- - API仕様の詳細、データ項目一覧(それらはIF仕様へ)
64
+ - メタ情報は `specdojo:` 配下に置き、`type` は `architecture`、主 `rulebook` は `specdojo:cpd-rulebook` とします。記法部品を主 rulebook にしません。
65
+ - `based_on` には対象コンテナの根拠となる上位 CND を接続します。適用する外部 IF・用語定義も根拠を辿れるよう本文の該当箇所へ参照を置きます。カタログ管理下の `based_on` は `depends_on` の推移閉包に限り、必要な依存が閉包外なら PM にカタログの整備を引き継ぎます。プロジェクト共通文脈は本文で必要な結論だけ参照します。
66
+ - 作成・編集時の `status` は `draft` とします。`owner`、`part_of`、`supersedes` は共通規約に従い、本文の設計前提を独自メタ項目で代用しません。
67
+ - 未同梱の上位図を使う学習用例は、架空参照と `based_on` 未接続の理由を概要へ明記します。実案件の依存未接続を、この例外で解決済みにはできません。
133
68
 
134
- ### 5.6. Relationship(関係)
69
+ ## 5. 本文要件
135
70
 
136
- 関係は「やり取りの意味」を合意するための線です。CPDでは **すべての関係にラベル**を付けます。
71
+ 見出し順・表の列・記入欄の骨組みは template を正本とし、ここでは意味要件を定めます。
137
72
 
138
- - 書くこと(必須):
139
- - 方向(誰が主に利用/依存/送信するか)
140
- - ラベル(短い日本語。名詞句または短い動詞句)
141
- - 書かないこと:
142
- - HTTP詳細、データ項目列挙、SQL、実装条件式
73
+ | 章の役割 | 必須 | 満たす内容 |
74
+ | -------------------- | -------- | -------------------------------------------------------------------------------------------------------------------------------- |
75
+ | 概要 | 必須 | 上位図の対象コンテナ、業務目的との対応、分割の目的、利用する設計判断、対象外、確定度、確認者・最終合意者と公開範囲 |
76
+ | 構成図 | 必須 | 一つのコンテナ境界、主要コンポーネント、接点となる利用者・ストア・外部依存、ラベル付きの関係 |
77
+ | 要素・境界の定義 | 必須 | 内外の分界、コンポーネントの責務・入出力・論理配置と採用理由、外部依存の利用条件、関係の授受情報と詳細の正本 |
78
+ | 技術前提・検証対象 | 必須 | 依存の制約、失敗時に区別する結果、関係 ID に結び付く結合検証の観測点 |
79
+ | 未確定事項の引き継ぎ | 条件付き | 仮定・未確認箇所がある場合の区分、影響、担当・判断者、判断タイミング、次アクション、解消条件、合意への影響、PJR などの引き継ぎ先 |
143
80
 
144
- ## 6. 本文構成(標準テンプレ)
81
+ Person・ストア・外部システムが該当しない場合は、定義欄へ非該当の理由を書きます。論理配置はコンテナ内部の責務の配置までとし、確認できていないソースパスを断定しません。
145
82
 
146
- 各 CPD 成果物は、以下見出しを順番に並べます。
147
-
148
- 1. 概要
149
- 2. C4コンポーネント図(Mermaid)
150
- 3. 要素の説明
151
- 4. 補足
152
-
153
- ## 7. 記述ガイド詳細
154
-
155
- ### 7.1. 概要
156
-
157
- - 「この図が何を表すか」「対象コンテナ」「前提」を1〜3文で書きます。
158
-
159
- ### 7.2. C4コンポーネント図(Mermaid)
160
-
161
- - Mermaid のコードブロックで図を記述します。
162
- - Mermaid 記法ルールは [cpd-mermaid-rulebook.md](cpd-mermaid-rulebook.md) に従います。
163
- - 図には、少なくとも以下を含めます。
164
- - Person(いる場合)
165
- - 境界(Container Boundary)
166
- - 主要コンポーネント(5〜15個程度を目安)
167
- - 主要DB(ある場合)
168
- - 外部システム(ある場合)
169
- - 関係(Relationship。全矢印にラベル)
170
-
171
- ### 7.3. 要素の説明
172
-
173
- - 図に登場する要素を、レビューしやすい粒度で説明します。
174
- - 推奨スタイル:
175
- - `###` レベルの小見出しで要素名(境界/人/コンポーネント/DB/外部/関係)
176
- - 1〜3文で意味・前提・境界条件(含む/含まない)を説明
177
-
178
- ### 7.4. 補足
179
-
180
- - 未確定な外部連携、境界が揺れている論点、図を分ける必要がありそうな論点を列挙します。
181
-
182
- ## 8. 命名・記述スタイル
183
-
184
- - 用語はこの図の中で揺らさない(同じ要素を別名で呼ばない)。
185
- - ラベルは短くし、長い場合は改行(`<br>`)で読みやすくする(詳細はIF仕様へ)。
186
- - コンポーネント名は「責務が読める短い名前」を優先し、実装都合(ファイル名/クラス名)に寄せすぎない。
187
-
188
- ## 9. 禁止事項
189
-
190
- 次の記述は、CPDの粒度を超えるため避けます。
191
-
192
- | 項目 | 理由 |
193
- | --------------------------------------- | -------------------------------- |
194
- | 物理テーブル名・物理カラム名・SQL全文 | 図の粒度を超える(DB設計に記述) |
195
- | APIエンドポイント/HTTP/JSON等の詳細 | IF仕様に記述する |
196
- | 実装クラス/関数名、内部モジュールの網羅 | 変更に弱い・合意の対象がずれる |
197
- | 画面遷移やクリック手順の逐語列挙 | UI変更に弱い・図の目的から逸脱 |
198
- | 矢印ラベルなしの関係 | 何の関係か合意できない |
199
-
200
- ## 10. レビュー観点(チェックリスト)
201
-
202
- - 対象コンテナは1つに絞れているか
203
- - 境界の内外が説明され、責任分界が曖昧でないか
204
- - 主要コンポーネントが多すぎず(目安: 5〜15)、過不足なく俯瞰できるか
205
- - Person/外部システム/DBがある場合、必要十分に含まれているか
206
- - すべての関係にラベルがあり、意味が解釈一致するか
207
- - 図が「クラス/実装詳細」や「IF詳細」に踏み込んでいないか
208
-
209
- ## 11. サンプル(簡易)
210
-
211
- ```yaml
212
- ---
213
- id: cpd-sales-api-components
214
- type: architecture
215
- title: 販売APIのC4コンポーネント図
216
- status: draft
217
- part_of: []
218
- based_on: []
219
- ---
220
- ```
83
+ 確認者・公開範囲・変更時の影響は概要、技術前提またはメモの該当箇所に記録し、独立した章を増やすことは必須にしません。作業・検証・承認の証跡は実行記録や決定記録を正本とし、CPD から参照します。
221
84
 
222
- ## 12. 概要
85
+ ## 6. 記述ガイド
223
86
 
224
- この図は「販売API(対象コンテナ)」を主要コンポーネントに分割し、利用者・外部システム・DBとの関係を俯瞰します。
87
+ 共通のメタ情報・命名は上位標準を参照し、以下ではコンポーネント分割に固有の判断を扱います。
225
88
 
226
- ## 13. C4コンポーネント図(Mermaid)
89
+ ### 6.1. 概要
227
90
 
228
- ```mermaid
229
- flowchart LR
230
- %% Person
231
- 店員["👤店員"]
91
+ - 上位図のどのコンテナを展開するか、何の設計入力に使うか、何を扱わないかを書きます。
92
+ - 対象者の業務課題、放置時の影響、期待価値・成功基準は、上位の要求・目的の該当箇所へ必ず参照を置きます。上位に定義がなければ BA が論点化し、CPD だけで業務上の成功を確定しません。
93
+ - 作成者、アーキテクチャ確認者、業務確認者、最終合意者を「作成・確認・合意の分担」に対応付け、プロジェクトの役割割当てまたは合意記録を参照します。公開する相手・媒体・範囲も示します。
94
+ - 設計案と実装の確認済み構成を区別し、未確認の分割は _ASSUMPTION_: として影響と確認先を残します。
95
+ - 良い例: 「販売処理サービス内部を分け、保存と印字の責任境界を結合設計へ渡す。再送の詳細は連携仕様へ委ねる」。悪い例: 「システム全体の詳細を示す」。対象と用途を限定できるかが基準です。
232
96
 
233
- %% External Systems
234
- 会計システム["会計システム"]
97
+ ### 6.2. C4コンポーネント図(Mermaid)
235
98
 
236
- %% Target Container Boundary
237
- subgraph 境界["対象コンテナ(例: 販売API)"]
238
- 売上受付("売上受付")
239
- 在庫照会("在庫照会")
240
- 認証("認証")
241
- 販売DB[("販売DB")]
242
- end
99
+ - 上位図で対象外のストア・他コンテナは境界外に置きます。同じ端末で動くことを境界内に置く理由にしません。
100
+ - 矢印が依存・依頼を表すかを明示し、応答を同じ関係に含めるか説明します。主要経路の省略範囲も短く示します。
101
+ - 良い例: 「会計処理 → 印字連携: 保存済み控えの印字依頼」。悪い例: 「会計処理 ↔ 共通処理: 処理」。責務と依存方向を読めるかが基準です。
243
102
 
244
- %% Relationships
245
- 店員 -->|"売上登録"| 売上受付
246
- 売上受付 -->|"売上データ"| 販売DB
247
- 売上受付 -->|"会計仕訳連携"| 会計システム
248
- 在庫照会 -->|"在庫データ参照"| 販売DB
249
- 売上受付 -->|"認証"| 認証
103
+ ### 6.3. 要素と境界の定義
250
104
 
251
- %% Styles
252
- classDef person fill:#fff3bf,stroke:#f08c00,color:#000;
253
- classDef system fill:#d0ebff,stroke:#1c7ed6,color:#000;
254
- classDef external fill:#e9ecef,stroke:#495057,color:#000;
255
- class 店員 person;
256
- class 売上受付,在庫照会,認証,販売DB system;
257
- class 会計システム external;
258
- style 境界 fill:#ffffff,fill-opacity:0,stroke:#868e96,stroke-width:1px,stroke-dasharray: 5 5;
259
- ```
105
+ - コンポーネントは固有の責務、入力と出力の種類、コンテナ内での論理配置を記述します。実装上の配置を示す場合は根拠を付け、未確認なら論点に残します。
106
+ - 主要な分割・共通化・依存の採用理由を、概要で参照した業務目的または技術制約へ対応付けます。同じ理由で分けた責務はまとめて説明し、各行で上位の目的を繰り返しません。
107
+ - 関係表の推奨列は「関係 ID / 起点 → 終点 / 授受情報・条件 / 詳細の正本」です。外部の別コンテナ、ストア、外部システムを区別し、未作成の正本はバッククォートで仮置きします。
108
+ - 良い例: 「会計処理は確認済み明細を受け、確定結果を返す。印字の成否は印字連携が扱う」。悪い例: 「会計処理は販売のすべてを行う」。他コンポーネントとの更新責任を分けられるかが基準です。
260
109
 
261
- ## 14. 要素の説明
110
+ ### 6.4. 技術前提・制約と検証観点
262
111
 
263
- ### 14.1. 対象コンテナ境界
112
+ - 共通機構への依存、外部依頼、正本と派生物の区別を、対象コンテナに必要な範囲で示します。未確認の排他・原子性・再試行保証は置きません。
113
+ - 関係 ID または要素名に、入力条件と観測する結果を対応付けます。テストケースの全件列挙や実施結果の記録は行いません。
114
+ - 良い例: 「保存成功後の印字失敗で、販売結果と未印字を別々に観測する」。悪い例: 「正常系と異常系を十分テストする」。境界ごとの確認対象を識別できるかが基準です。
264
115
 
265
- この境界は販売APIの内部(主要コンポーネントとDBアクセス)を表します。
116
+ ### 6.5. メモ / 将来課題
266
117
 
267
- ### 14.2. Person(人/ロール)
118
+ - 仮定・未確認事項は共通ラベルで確定事項と区別し、対象要素・関係 ID と対応付けます。区分は、未発生の懸念をリスク、発生済みの阻害を課題、合意した構成の変更提案を変更要求、合意結果を決定事項とします。
119
+ - 推奨する記録項目は「対象・区分 / 影響と後続成果物 / 担当 Role code・判断者 / 期限または判断タイミング / 次アクション・解消条件 / 承認への影響・引き継ぎ先」です。表の既存列へ併記しても構いません。担当と判断者は分け、業務・公開判断の判断者は人間の PO とします。
120
+ - ARC は境界・契約・結合設計・作業順に影響する論点を PM へ報告します。PM は継続追跡するリスク・課題・変更要求・決定事項を共通のライフサイクル規約に従って PJR へ転記し、転送先レコードと担当を接続します。未起票なら登録候補として理由・起票担当・判断タイミングを残します。合意を要する事項は PO へ報告し、後続作業の着手可否・Schedule の順序や期限への影響も記録します。
121
+ - 良い例: 「印字応答欠落は結果不明を生むリスク。ARC が外部 IF の回復条件を整理し QE が観測点を確認する。人間の PO が実装着手前に採否を判断し、未解消なら当該経路を保留する。PM が PJR 登録候補として結合設計の開始条件へ反映する」。悪い例: 「将来検討する」。判断する人と時点、判断後の作業が特定できるかが基準です。
268
122
 
269
- 店員は売上登録のために売上受付コンポーネントを利用します。
123
+ ### 6.6. 検証と合意の判定
270
124
 
271
- ### 14.3. コンポーネント
125
+ QE は、図の全要素が定義表または境界の説明へ、全関係が一意な関係 ID へ対応することを照合します。逆に、定義表だけにある要素・関係には省略理由が必要です。主要経路では、通常時と失敗・応答欠落時の条件および観測結果を関係 ID から辿れ、上位図と異なる内外配置や依存方向が説明なく残らないことを合格条件とします。
272
126
 
273
- - 売上受付: 売上登録を受け付け、売上を永続化し、会計連携を起動します。
274
- - 在庫照会: 在庫の参照要求を受け付けます。
275
- - 認証: 利用者の認証を行います。
127
+ 検証コマンドは対象リポジトリの `package.json`・hook 設定を正本とします。SpecDojo 本体での対応は次表のとおりです。`<対象.md>` は変更した CPD、`<id>` はその参照先 ID へ置き換えます。実行記録には対象・コマンド・結果を残し、親 runner が実施する検査はその証跡を使います。
276
128
 
277
- ### 14.4. データベース
129
+ | 確認 | コマンド・確認方法 | 期待結果・失敗時の対応 |
130
+ | ------------------------------ | ------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------ |
131
+ | メタ情報・主 rulebook の型宣言 | `npm run lint:fm`(対象は `docs/` の Markdown) | CPD の schema・型宣言エラーがない。指摘された項目を正本と照合して直す |
132
+ | 参照先 | `node --import tsx src/specdojo.ts index lookup <id>` と参照先の該当箇所の閲読 | 既存 ID が意図した文書へ解決する。索引不整合は管理側に再生成を依頼し、未作成参照は仮参照と引き継ぎ事項へ直す |
133
+ | Mermaid 構文 | `node tools/lint-mermaid.mjs <対象.md>` | 全図が passed、構文エラー・未検査がない。指摘された fence を修正し、未検査なら依存環境を整える |
134
+ | 描画・可読性 | `npm run docs:build:mermaid` 後に対象図の SVG を閲覧 | 要素名・関係ラベルが欠けず、境界内外・矢印の端点を判読できる。重なりや切れを修正して再描画する |
278
135
 
279
- - 販売DB: 売上・在庫に関する主要データを永続化します。
136
+ OPS は公開前に対象の本文・図・ラベル・参照先について、個人情報、認証情報、内部ホスト名や非公開の構成情報が含まれないか、プロジェクトの公開方針と照合します。確認範囲・除外または匿名化した情報・残る懸念を合意記録へ残し、人間の PO が公開先と最終可否を判断します。技術検証の成功や `status` だけでは公開許可を表しません。
280
137
 
281
- ### 14.5. 外部システム
138
+ 人間の PO が `ready` へ昇格できる条件は、必須内容と検証の充足、技術・業務確認の完了、依存と詳細化先の接続、公開前確認の完了、および判断記録の存在です。未解決事項を残せるのは、承認対象の境界・責務・受け渡し・成功基準・公開可否を変えず、担当・解消時点と影響を限定できる場合に限ります。判断材料不足は保留、上位境界との矛盾や検証失敗は差し戻しとし、対象範囲と次アクションを記録します。
282
139
 
283
- - 会計システム: 会計仕訳の受け口です。
140
+ 良い例: 「全関係の照合と描画確認を終え、公開用の接続先表記を PO が承認した。対象外の将来拡張だけを担当・期限付きで残す」。悪い例: 「lint が通ったので公開・確定する」。技術検証と人間の合意の両方を証跡から確認できるかが基準です。
284
141
 
285
- ### 14.6. 関係
142
+ ### 6.7. 変更・保守時の影響確認
286
143
 
287
- 売上受付が販売DBを更新し、会計システムへ仕訳相当情報を連携します。
144
+ 更新契機は上位 CND の境界変更、責務の追加・統合・廃止、外部 IF・ストアの契約変更、実装との不一致、結合検証での前提否定です。ARC を保守の窓口とし、問い合わせはプロジェクトの役割割当てから担当を辿り、判断が必要なら「メモ / 将来課題」から PJR へ接続します。
288
145
 
289
- ## 15. 補足
146
+ - ARC は上位 CND、用語定義、外部 IF、下位のデータ・詳細設計を照合し、影響する要素・関係 ID、変更理由、変更前後、更新要否と理由を変更記録へ残します。図と定義表は同じ改訂で同期します。
147
+ - DEV は実装、schema、参照元、生成物・運用手順への追従を確認し、QE は結合観測点とテスト仕様の更新・再検証を確認します。実践の型へ一般化した規定を変える場合は ARC が sample・recipe・template の追従要否も判断します。値・構文・構造は各正本を更新し、CPD には複製しません。
148
+ - PM は後続成果物と Schedule への波及を整理して PJR の更新作業へ割り当てます。OPS は変更図を再描画し、QE が「検証と合意の判定」の該当検査を再実施した証跡を確認して、人間の PO に再合意・公開判断を依頼します。改訂・廃止・置き換えと履歴は共通のライフサイクル規約に従います。
290
149
 
291
- - 外部連携のIF詳細はAPI仕様/外部システムIFで別途定義します。
150
+ 良い例: 「保存責務の統合で `REL-05` の終点を変えるため、ARC が図・関係表とデータ設計、DEV が実装対応、QE が保存失敗の観測点、PM が結合作業の開始条件を確認する」。悪い例: 「図だけ差し替える」。影響先ごとに更新または更新不要の根拠を残せるかが基準です。
292
151
 
293
- ## 16. 参照
152
+ ## 7. 禁止事項
294
153
 
295
- - Mermaid 記法(CPD): [cpd-mermaid-rulebook.md](../rulebooks/cpd-mermaid-rulebook.md)
154
+ - 複数の実行・配備単位を一つのコンテナとして描くことや、コンポーネントを別サービスと根拠なく断定すること。
155
+ - クラス・関数・ファイル一覧、コマンドオプション、API 構文、データ項目・値制約を詳細仕様と重複して管理すること。
156
+ - ラベルのない関係、方向の意味が混在する矢印、図と表で対応しない名称・接続。
157
+ - 未確認の依存・物理配置・障害回復保証を確定事項として記載すること。
158
+ - 自動検査や AI 作業の成功を、業務判断・承認・公開許可と同一視すること。