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
@@ -225,7 +225,7 @@ flowchart
225
225
  | [業務データ辞書 / 概念データストア定義](../rulebooks/cdsd-rulebook.md) | Conceptual Data Store Definition | `cdsd-<term>` | 概念データストア(情報の保管場所)を一覧で定義する | データストア名、対応プロセス、内容、更新タイミング、粒度、主な用途 など |
226
226
  | [業務データ辞書 / 保管場所定義](../rulebooks/sld-rulebook.md) | Storage Location Definition | `sld-<term>` | 業務対象となる物の物理的な保管場所を一覧で定義する | 保管場所名、保管対象、内容・目的、関連プロセス、管理頻度 など |
227
227
  | [業務データ辞書 / ステータス定義](../rulebooks/stsd-rulebook.md) | Status Definition | `stsd-<term>` | 業務上のエンティティが取り得る状態と状態間の遷移を一文書で定義する | 対象、状態名、通称、意味、成立条件、管理場所、状態遷移図、イベント、遷移条件など |
228
- | [業務データ辞書 / 分類定義](../rulebooks/cld-rulebook.md) | Classification Definition | `cld-<term>` | 業務上の分類(カテゴリ、種別、区分など)を一覧で定義する | 分類定義名、種別、分類名、説明など |
228
+ | [業務データ辞書 / 分類一覧](../rulebooks/cdt-rulebook.md) | Code Table | `cdt-<term>` | 業務上の分類(カテゴリ、種別、区分など)を一覧で定義する | 分類定義名、種別、分類名、説明など |
229
229
  | [概念クラス図](../rulebooks/ccd-mermaid-rulebook.md) | Conceptual Class Diagram | `ccd-<term>` | 業務上のエンティティ関係を図で定義する | 商品・在庫・発注・店舗などの概念と属性、関連(継承/親子/参照) など |
230
230
 
231
231
  #### 2.1.3. 業務モデル
@@ -244,6 +244,7 @@ flowchart
244
244
  | ドキュメント | 英語名称 | 推奨ファイル名 | 目的 | 主な内容 |
245
245
  | --- | --- | --- | --- | --- |
246
246
  | [画面仕様](../rulebooks/uis-rulebook.md) | UI Specification | `uis-<term>` | 業務ユーザー視点の画面の利用目的や表示項目、操作を定義する | 画面概要、利用目的、表示項目、操作、遷移、エラー表示 など |
247
+ | [CLI仕様](../rulebooks/clis-rulebook.md) | CLI Specification | `clis-<term>` | 利用者視点での CLI コマンド群の利用目的や操作の流れ、出力・エラーを定義する | 概要、利用目的、操作の流れ、操作とコマンド参照、出力・生成ファイルの要点、終了コードとエラー表示・利用者の次の手 など |
247
248
  | [帳票仕様](../rulebooks/bds-rulebook.md) | Business Document Specification | `bds-<term>` | 業務ユーザー視点の帳票の利用目的や表示項目を定義する | 帳票概要、利用目的、表示項目、出力タイミング など |
248
249
 
249
250
  #### 2.1.5. システム化機能
@@ -251,8 +252,8 @@ flowchart
251
252
  <!-- prettier-ignore -->
252
253
  | ドキュメント | 英語名称 | 推奨ファイル名 | 目的 | 主な内容 |
253
254
  | --- | --- | --- | --- | --- |
254
- | [システム化機能一覧 / 全体構成](../rulebooks/sf-rulebook.md) | System Functions Index | `sf-index` | システムで実現する機能の全体構成と一覧を定義する | 機能ID、機能名、概要、関連プロセス、関連仕様ID など |
255
- | [システム化機能一覧 / 個別](../rulebooks/sf-rulebook.md) | System Function | `sf-<term>` | 個別のシステム化機能の概要・関連仕様を定義する | 機能概要、関連プロセス、関連画面、関連IF、関連ルール など |
255
+ | [システム化機能一覧 / 全体構成](../rulebooks/sf-index-rulebook.md) | System Functions Index | `sf-index` | システムで実現する機能の全体構成と一覧を定義する | 機能ID、機能名、概要、関連プロセス、関連仕様ID など |
256
+ | [システム化機能(個別)](../rulebooks/sf-rulebook.md) | System Function | `sf-<term>` | 個別のシステム化機能の目的、業務プロセス・画面との対応、処理要件を定義する | 機能目的・概要、業務プロセス・画面との対応、入出力・前提条件、処理要件、非機能制約、操作手順・コマンド参照、検証観点 |
256
257
 
257
258
  #### 2.1.6. 用語集
258
259
 
@@ -272,7 +273,7 @@ flowchart
272
273
  | [外部API仕様](../rulebooks/ifx-api-rulebook.md) | External API Specification | `ifx-api-<term>.yaml` | 外部システムとのAPI連携をOpenAPI形式(YAML)で定義する | エンドポイント、HTTPメソッド、リクエスト/レスポンス、ステータスコード |
273
274
  | [外部ファイル連携仕様](../rulebooks/ifx-file-rulebook.md) | External File Exchange Specification | `ifx-file-<term>.yaml` | 外部システムとのファイル連携をYAMLで定義する | ファイル形式、伝送方法、スケジュール、ファイル項目一覧 |
274
275
  | [外部メッセージ仕様](../rulebooks/ifx-msg-rulebook.md) | External Message Specification | `ifx-msg-<term>.yaml` | 他システムとのイベント/キューのメッセージ連携をAsyncAPI + CloudEvents(YAML)で定義する | チャネル名、メッセージ構造、エンドポイント、プロトコル |
275
- | [外部コマンド連携仕様](../rulebooks/ifx-cmd-rulebook.md) | External Command Interface Specification | `ifx-cmd-<term>.yaml` | 外部CLIコマンドの起動契約をYAMLで定義する | コマンド名、引数、stdin/stdout/stderr、終了コード、認証注入方式、エラー処理 |
276
+ | [外部コマンド連携仕様](../rulebooks/ifx-cmd-rulebook.md) | External Command Interface Specification | `ifx-cmd-<term>.yaml` | 外部CLIコマンドの起動契約をYAMLで定義する | コマンド名、正本参照、入出力ストリーム、入出力ファイル、副作用、終了コード、エラー処理 |
276
277
 
277
278
  ### 2.3. アーキテクチャ
278
279
 
@@ -301,6 +302,7 @@ flowchart
301
302
  - **System Design Index**:設計のSSOT(OpenAPI / AsyncAPI / migration / job定義 / config schema 等)への導線
302
303
  - **System Design Critical Flows**:事故や仕様誤解の原因になりやすい“重要フロー”だけを少数(最大5件)定義
303
304
  - **System Design Cross-cutting Policy**:エラー・冪等・リトライ・監査・トレーシング等の横断ルール(実装の共通前提)
305
+ - **Design System Specification**:画面をまたぐ GUI のデザインの決まり。既存のトークンや部品の正本は参照する
304
306
 
305
307
  #### 2.4.1. ドキュメント一覧と概要(最小構成)
306
308
 
@@ -310,6 +312,9 @@ flowchart
310
312
  | 全体構成(リンク集) | System Design Index | `sysd-index` | システム設計のSSOTへの導線を1箇所に集約し、設計情報を迷子にしない | 内部API定義(OpenAPI等)/イベント定義(AsyncAPI等)/DBスキーマ(migration等)/バッチ定義(workflow/cron等)/設定スキーマ(config schema等)/コード配置規約(モジュール境界) |
311
313
  | 重要フロー | System Design Critical Flows | `sysd-critical-flows` | “読まないと事故る”フローだけを可視化し、実装・テスト・運用の共通理解を作る | 最大5フロー(冪等/補償/非同期/順序/整合性/外部I/F障害など)について、境界・永続化点・再実行性・失敗時挙動を図または箇条書きで定義 |
312
314
  | 横断ルール | System Design Cross-cutting Policy | `sysd-cross-cutting-policy` | 実装全体に影響する共通ルールをSSOT化し、各所の実装ブレを防ぐ | エラー形式/例外分類、タイムアウト・リトライ、冪等キー、トランザクション境界、ログ/監査ログ、トレーシング、セキュリティ(認証・認可の実装原則)、バージョニング、設定の上書き階層 |
315
+ | [[specdojo:dss-rulebook\|デザインシステム]] | Design System Specification | `dss-<term>`(既定: `dss-common`) | GUI の見た目と操作時の表現を揃え、操作性目標を満たす設計の決まりを定める | デザイントークン、部品の使い方、レイアウトの型、状態表示、アクセシビリティ、正本への参照、検証方法 |
316
+
317
+ DSS の成果物は `docs/ja/product/040-system-design/` へ置きます。画面ごとの目的・項目・操作・遷移は UIS、測れる操作性目標は NFR が持ちます。ワイヤーフレームは文書として保守せず、UIS と DSS から試作を作ってプロダクトのリポジトリに置きます。
313
318
 
314
319
  > 補足:従来の「実装データフロー図/実装クラス図/DB論理・物理/実装画面仕様/内部I/F/バッチ設計/設定一覧」は、
315
320
  > **“SSOTをコード(定義ファイル)に寄せる”** 方針により、個別ドキュメントとしては作りません。
@@ -201,7 +201,7 @@ docs/
201
201
  │ │ │ ├── cdsd-sales-management.md # 概念データストア定義(例:販売管理)
202
202
  │ │ │ ├── sld-sales-management.md # 保管場所定義(例:倉庫・店舗)
203
203
  │ │ │ ├── stsd-product-lifecycle.md # ステータス定義(状態一覧・状態遷移図の例:商品ライフサイクル)
204
- │ │ │ ├── cld-product-category.md # 分類定義(例:商品カテゴリ)
204
+ │ │ │ ├── cdt-product-category.md # 分類一覧(コード表の例:商品カテゴリ)
205
205
  │ │ │ └── ccd-sales-management.md # 概念クラス図(例:販売管理)
206
206
  │ │ ├── 030-business-model/ # 業務モデル
207
207
  │ │ │ ├── bps-sales-order-flow.md # 業務プロセス仕様(例:受注フロー)
@@ -235,7 +235,8 @@ docs/
235
235
  │ ├── 040-system-design/ # システム設計
236
236
  │ │ ├── sysd-index.md # 全体構成(リンク集)
237
237
  │ │ ├── sysd-critical-flows.md # 重要フロー
238
- │ │ └── sysd-cross-cutting-policy.md # 横断ルール
238
+ │ │ ├── sysd-cross-cutting-policy.md # 横断ルール
239
+ │ │ └── dss-common.md # GUI デザインシステム
239
240
  │ │
240
241
  │ ├── 050-business-acceptance-criteria/ # 業務受入条件
241
242
  │ │ └── bac-sales-order.md # 業務受入条件(例:受注)
@@ -99,21 +99,23 @@ exec の result の commit 前検査にも、利用リポジトリに設定が
99
99
 
100
100
  `projects.<project-id>` に指定するキーです。`base_path` 以外の表中のパスは、`base_path` があればそこからの相対パス、無ければリポジトリルートからの相対パスとして解決します。
101
101
 
102
- | キー | 既定値 | 主な役割 | 必要とする主なコマンド |
103
- | ----------------------- | ---------------- | ------------------------------------------------- | ------------------------------------------------------------- |
104
- | `base_path` | リポジトリルート | project 文書に共通するパス接頭辞 | project に紐づく各コマンド |
105
- | `project_register_path` | なし | 個票、event、登録簿の配置先 | `register *`、`exec plan/run --register` |
106
- | `catalog_path` | なし | `dct-*.yaml` と生成ビューの配置先 | `catalog *`、`deliverable scaffold`、catalog を使う grade 等 |
107
- | `schedule_path` | `schedule` | strategy、track、Schedule の配置先 | `schedule *`、schedule 対象の `exec *` |
108
- | `execution_path` | `execution` | plan、result、実行状態、grade / Job Run の配置先 | `exec *`、`grade *`、`job *`、`dashboard build` |
109
- | `timeline_path` | `timeline` | Timeline の正本と生成物の配置先 | `timeline *`、`dashboard build`、`schedule strategy generate` |
110
- | `members_path` | なし | 人間と対応 Role code を定義する `pm-members.yaml` | actor 検証、owner 検証、合成名簿の project 側入力 |
111
- | `roles_path` | なし | role 定義ファイルの配置先 | `schedule strategy generate`、owner を解決する `exec plan` |
112
- | `viewpoints_path` | なし | review / grade 観点ファイルの配置先 | `grade *`、review plan、`exec scaffold --project` |
113
- | `routines_path` | なし | `rtn-*.yaml` と routine 状態の配置先 | `routine *`、routine を集約する `dashboard build` |
114
- | `jobs_path` | なし | `job-*.yaml` の配置先 | `job *`、`exec run --job` |
115
-
116
- `schedule_path`、`execution_path`、`timeline_path` には解決時の既定値があります。ただし `schedule` コマンドや一括 `build` の対象判定ではキーの明示が必要なため、catalog から Schedule と exec へ進む構成では省略しないでください。
102
+ | キー | 既定値 | 主な役割 | 必要とする主なコマンド |
103
+ | ----------------------- | ---------------- | -------------------------------------------------- | ------------------------------------------------------------ |
104
+ | `base_path` | リポジトリルート | project 文書に共通するパス接頭辞 | project に紐づく各コマンド |
105
+ | `project_register_path` | なし | 個票、event、登録簿の配置先 | `register *`、`exec plan/run --register` |
106
+ | `catalog_path` | なし | `dct-*.yaml` と生成ビューの配置先 | `catalog *`、`deliverable scaffold`、catalog を使う grade 等 |
107
+ | `schedule_path` | `schedule` | strategy、track、Schedule の配置先 | `schedule *`、schedule 対象の `exec *` |
108
+ | `execution_path` | `execution` | plan、result、実行状態、grade / Job Run の配置先 | `exec *`、`grade *`、`job *`、`dashboard build` |
109
+ | `timeline_path` | `timeline` | 非推奨。旧 timeline の互換読み込み・生成物の配置先 | 旧 `timeline *` と範囲解決の互換処理 |
110
+ | `members_path` | なし | 人間と対応 Role code を定義する `pm-members.yaml` | actor 検証、owner 検証、合成名簿の project 側入力 |
111
+ | `roles_path` | なし | role 定義ファイルの配置先 | `schedule strategy generate`、owner を解決する `exec plan` |
112
+ | `viewpoints_path` | なし | review / grade 観点ファイルの配置先 | `grade *`、review plan、`exec scaffold --project` |
113
+ | `routines_path` | なし | `rtn-*.yaml` と routine 状態の配置先 | `routine *`、routine を集約する `dashboard build` |
114
+ | `jobs_path` | なし | `job-*.yaml` の配置先 | `job *`、`exec run --job` |
115
+
116
+ `schedule_path` と `execution_path` は解決時の既定値があります。ただし `schedule` コマンドや一括 `build` の対象判定ではキーの明示が必要なため、catalog から Schedule と exec へ進む構成では省略しないでください。
117
+
118
+ 全体計画は `project_register_path` の epic を正本とし、`dashboard build` が `execution_path` 配下の `generated/` へ生成します。`timeline_path` の明示指定と旧 `tml-index.yaml` の読み込みは非推奨の警告を出します。未指定でも互換読み込み先は `timeline/` です。新規構成で `timeline_path` は不要です。移行手順は [[specdojo:timeline-design-guide|Timeline からの移行ガイド]] を参照してください。
117
119
 
118
120
  ## 4. projectの非パスキー
119
121
 
@@ -342,7 +344,6 @@ agent 実行を使う場合は、この project オブジェクトとは別に
342
344
  "catalog_path": "010-deliverables-catalog",
343
345
  "schedule_path": "schedule",
344
346
  "execution_path": "execution",
345
- "timeline_path": "timeline",
346
347
  "members_path": "030-project-management/pm-members.yaml",
347
348
  "roles_path": "030-project-management/pm-roles.yaml",
348
349
  "viewpoints_path": "030-project-management/pm-review-viewpoints.yaml",
@@ -3,330 +3,112 @@ specdojo:
3
3
  id: specdojo:bac-rulebook
4
4
  type: rulebook
5
5
  deliverable_type: requirement
6
- status: draft
7
- recipe: undecided
6
+ status: ready
7
+ target_format: markdown
8
+ recipe: specdojo:bac-recipe
8
9
  sample: specdojo:bac-sample
9
- template: undecided
10
+ template: specdojo:bac-template
10
11
  ---
11
12
 
12
13
  # 業務受入条件 作成ルール
13
14
 
14
- Business Acceptance Criteria (BAC) Documentation Rules
15
+ Business Acceptance Criteria Documentation Rulebook
15
16
 
16
- 本ドキュメントは、業務分析・要求定義のために **業務受入条件を統一形式で記述する標準ルール**です。
17
-
18
- BAC は「業務側から見て、このシステムで業務が回せる」ことを確認するための受入条件を定義します。
17
+ 業務担当者が「この仕組みで業務を進められる」と判断するための受入条件を定めます。利用場面、前提、業務行為、観測可能な期待結果を対応させ、承認と受入テスト設計に渡せる粒度を規定します。
19
18
 
20
19
  ## 1. 全体方針
21
20
 
22
- - 対象は「業務として受け入れ可能であること」を示す条件であり、**業務用語で、期待結果が検証可能な形**に書きます。
23
- - 実装詳細(例: 物理テーブル名、SQL、実装クラス/関数名、APIの内部処理)は記載しません。
24
- - クリック手順の逐語列挙など、UIの操作手順に寄りすぎた記述は避け、**業務行為**として要約します。
25
- - 1ファイル = 1 受入対象(業務の塊)を基本とします。肥大化する場合は受入対象を分割します。
26
-
27
- ## 2. 用語定義
28
-
29
- | 用語 | 定義 |
30
- | -------- | ------------------------------------------------------ |
31
- | BAC | 業務受入条件。業務側の観点での受け入れ基準(期待結果) |
32
- | 受入対象 | 業務として実現したい能力(例: 商品販売) |
33
- | シナリオ | 具体的な業務シナリオ(例: 顧客が商品を購入する) |
34
- | 前提 | シナリオ開始前の条件(前提状態、準備) |
35
- | 操作 | 業務の実行(業務イベントや操作の要約) |
36
- | 期待結果 | 観測可能な事実(状態変化、記録、通知など) |
37
-
38
- ## 3. ファイル命名・ID規則
39
-
40
- - ファイル名: `bac-<番号>-<短い日本語名>.md` (例: `bac-0010-商品販売.md`)
41
- - Frontmatter:
42
- - `id`: `bac-sale-checkout` のように小文字ハイフン形式。
43
- - `title`: 「業務受入条件: 商品販売」など。
44
-
45
- ## 4. 推奨 Frontmatter 項目
46
-
47
- Frontmatter は `docs/specdojo/schemas/v1/deliverable-frontmatter.schema.yaml` の制約に従います。
48
-
49
- | 項目 | 説明 | 必須 |
50
- | ---- | ---- | ---- |
51
-
52
- | id | 受入条件ID(`bac-...`) | ○ |
53
- | type | `requirement` 固定 | ○ |
54
- | title | 受入条件名(例: 業務受入条件: 商品販売) | ○ |
55
- | status | `draft`/`ready`/`deprecated` | ○ |
56
- | part_of | 上位BAC ID(分割している場合) | 任意 |
57
- | based_on | 根拠となる仕様ID(BPS/BR/UIS/BES/BEL 等) | 任意 |
58
- | supersedes | 置き換え関係(古仕様→新仕様) | 任意 |
21
+ - [[specdojo:deliverables-reference|成果物リファレンス]] の業務受入条件として、業務仕様が利用者の課題を解決するかを合意・確認する基準を定める。仕様が存在するだけでは業務を進められると判断できないため、利用場面と確認できる結果へ具体化する。
22
+ - 1 文書で一つの受入対象(業務の塊)を扱い、対象者の課題と期待価値に結び付くシナリオを選ぶ。
23
+ - 決定済みの業務仕様を受入条件へ変換する。新しい業務判断、閾値、例外承認を BAC で確定しない。
24
+ - 期待結果は状態、記録、引き継ぎなど観測できる事実にする。実装や画面の手順を受入基準の代替にしない。
25
+ - 共通事項は上位の index・標準を正本とし、構文・値・保存構造は schema・リファレンスへ委譲する。
59
26
 
60
- 推奨:
27
+ ## 2. 位置づけと用語定義
61
28
 
62
- - `based_on` に、受入対象の仕様IDを列挙します(例: `bps-...`, `br-...`, `uis-...`, `bes-...`)。
63
- - BR や BPS 側の `tests` から BAC を参照できるよう、ID は安定させます(名前を変える場合は `supersedes` を使う)。
29
+ BAC は BPS や業務ルール、プロジェクトの受入条件を根拠に、業務としての成立を確認する要求である。BA が作成し、PO が業務的な妥当性を承認する。ARC は設計への入力として、QE は受入テスト設計への入力として利用する。テストの詳細手順と実行結果は BAC に含めない。
64
30
 
65
- ## 5. 本文構成(標準テンプレ)
31
+ [[specdojo:track-design-guide|トラック設計ガイド]] の品質仕様カテゴリで業務仕様を受け取り、受入テスト仕様とその実施へ渡す。BPS の業務の流れ、BR の判断規則、UIS の利用者操作、BES の業務イベントと発生条件を、業務の開始から結果まで横断して確認する。各仕様の定義は入力元を正本とし、BAC はそれらの組合せで業務が成立する条件を担う。
66
32
 
67
- 各 BAC ファイルは以下の見出しを順番に並べます。
33
+ | 用語 | 本系統での意味 |
34
+ | -------- | ---------------------------------------------------------- |
35
+ | 受入対象 | 一連の結果として業務担当者が受け入れる能力・業務の範囲 |
36
+ | シナリオ | 特定の開始状態から、業務行為を経て期待結果を確認する一単位 |
37
+ | 判定方法 | 誰が、どの時点で、何の証跡を照合して期待結果を確認するか |
68
38
 
69
- 1. 概要
70
- 2. 受入条件
71
- 3. メモ / 将来課題
72
-
73
- ## 6. 記述ガイド詳細
74
-
75
- ### 6.1 概要
76
-
77
- - 1〜3文で「何を受け入れるか」を書きます。
78
- - 可能であれば、対象の業務イベント(BEV)や業務プロセス(BPS)を言及し、`based_on` と整合させます。
39
+ ## 3. ファイル命名・ID規則
79
40
 
80
- 任意(レビューが速くなる場合のみ):
41
+ - ファイル名は受入対象を表す `bac-<subject>.md` を推奨し、配置は成果物カタログに従う。連番や日本語名を採用する場合は、同じ対象の ID とパスの対応をカタログで一意にし、表示順や表示名の変更だけでは ID を変えない。
42
+ - 新規 ID は `<project-id>:bac-<subject>` のようにプロジェクトを表す authority と対象のローカル ID を組み合わせる。既存文書は宣言された ID を使い、ファイル名から別の ID を推測しない。共通規則は [[specdojo:docs-structure-guide|ドキュメント構造ガイド]] に従う。
43
+ - シナリオには文書内で一意な識別子を付ける。ケース表を用いる場合も行 ID を持たせ、根拠やテスト設計から追跡できるようにする。
81
44
 
82
- - 「誰が」「何のために」を 1 行で明記してよいです。
83
- - 例: 「役割: 発注担当者 / 目的: 在庫補充のために発注〜入荷〜支払を追跡できる」
45
+ ## 4. 推奨 Frontmatter 項目
84
46
 
85
- ### 6.2 受入条件
47
+ メタ情報の型・許可値・キーの配置・必須項目は [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] と [成果物 Frontmatter schema](../../../specdojo/schemas/v1/deliverable-frontmatter.schema.yaml) を正本とする。SpecDojo の項目は `specdojo` 名前空間配下に置く。
86
48
 
87
- Markdown で「受入対象」と「シナリオ」を記述します。
49
+ - `type` は業務受入基準を表す `requirement` とし、必須の `rulebook` に本 rulebook の ID を宣言する。文書の名称は H1 に置く。
50
+ - `based_on` は受入条件の根拠となる先行成果物を示す。カタログ管理下では `depends_on` の範囲に従い、プロジェクト文脈をそのまま転記しない。
51
+ - 作成・改訂中の文書は `draft` とする。`part_of` は親 BAC がある場合、`supersedes` は旧 BAC を置き換える場合に用いる。
52
+ - 要求の充足やテストからの検証関係はメタ情報標準の「型付き参照」を使う。根拠を示す `based_on` と区別し、独自の関係キーを追加しない。
53
+ - 改訂・廃止はメタ情報標準の「文書の改訂・廃止とライフサイクル変更管理」に従う。BA が理由・代替先・移行時期と影響を整理し、PO が判断する。BA はカタログと BPS・BR 等の本文参照、ARC は設計、QE は受入テスト仕様・ケースと再検証、PM は追従作業と期限を担当する。ID・シナリオ ID または条件を変える場合は旧参照を検索し、参照先と期待値を更新して参照切れがないことを確認する。
88
54
 
89
- 基本:
55
+ ## 5. 本文要件
90
56
 
91
- - 1ファイル = 1 受入対象(大きい場合はファイル分割)。
92
- - シナリオは 2〜8 個程度を目安に、業務の代表パターンを押さえます。
93
- - 期待結果は **観測可能な事実** として書きます(例: 「在庫が減少する」「売上が記録される」「納品が記録される」など)。
57
+ 見出し順・表・記入欄の骨組みは frontmatter で宣言した template を正本とする。内容の成立条件は次のとおり。
94
58
 
95
- シナリオの標準テンプレ(推奨):
59
+ | 扱う内容 | 必須 | 成立条件 |
60
+ | --------------- | ---- | ------------------------------------------------------------------------------------------------------------------------------------- |
61
+ | 概要 | ○ | 受入対象、対象者、守る価値、利用場面、対象範囲と対象外、根拠が分かる。確認者・承認者と合意対象を示す |
62
+ | 受入条件 | ○ | シナリオごとに ID、根拠、前提、操作、期待結果、判定方法を対応させる。正常経路と、業務上結果が異なる例外・停止・再開を必要な範囲で扱う |
63
+ | メモ / 将来課題 | ○ | 未確定事項の影響、判断依頼先、解消時点・条件を記す。未決がなければ「なし」と明記する |
96
64
 
97
- - `### シナリオ: <短い名称>`
98
- - `#### 前提`(箇条書き)
99
- - `#### 操作`(箇条書き。クリック手順の逐語列挙ではなく、業務行為として要約)
100
- - `#### 期待結果`(箇条書き。状態変化/記録/通知などの観測点)
101
- - `#### 判定方法`(任意。どこを見て合否判定するか)
65
+ ### 5.1. シナリオの記述規約
102
66
 
103
- 記述のコツ:
67
+ - 前提は開始時点の状態、必要な入力、権限を記す。共通前提は受入条件の冒頭に一度だけ置き、例外シナリオでは異なる前提を明示する。
68
+ - 操作は担当者による業務行為を示す。期待結果は操作後の変化に加え、停止時に確定してはならない記録と次の担当への引き継ぎを示す。
69
+ - 判定方法は必須とし、期待結果の各項目に確認者、確認時点、観測先(記録・画面・帳票等)、照合対象を対応させる。前提と入力から期待結果を導けない箇所は未決事項へ送る。
70
+ - 同じ操作と観測点で条件だけが変わる場合はケース表へまとめてよい。停止範囲や再開先が異なる場合はシナリオを分ける。
104
71
 
105
- - 「前提」はシナリオ開始時点で成立している状態を業務用語で書く。
106
- - 「操作」は業務イベントや業務行為に寄せ、UI は必要最低限の要約に留める。
107
- - 「期待結果」は検証不能な曖昧表現(「正しく処理される」等)を避け、観測できる事実に分解する。
72
+ ### 5.2. 確認完了と確定の条件
108
73
 
109
- #### 6.2.1 ケース表
74
+ - BA は、概要の価値・対象範囲に必要なシナリオがそろい、各シナリオの根拠と `based_on` が有効な先行成果物へ解決できることを確認する。カタログ管理下では依存関係との整合も確認する。
75
+ - QE は、全シナリオに前提・操作・観測可能な期待結果・判定方法があり、正常経路と必要な例外・停止・再開を判断できることを確認する。ARC は設計への引き渡しと参照の整合を確認する。
76
+ - BA・QE は、メタ情報標準の「バリデーション」とリポジトリの検査設定に従う。本リポジトリでは `npm run lint:md` と `npm run lint:fm` が終了コード 0 となり、Markdown・Frontmatter・参照にエラーがないことを確認する。失敗箇所を修正して再検査する。executor / reporter pipeline では設定済みの親検証結果を用いる。
77
+ - PO は業務側の確認者との合意と、受入の合否を左右する未確定事項の解消を確認して確定を判断する。PM は残る準備作業の担当・判断時点・追跡先を確認する。`ready` への昇格は人が行い、文書の確定を受入試行の合格実績とは扱わない。
110
78
 
111
- 同じ業務行為を **入力値や条件だけ変えて反復**する場合は、シナリオを増やす代わりに **ケース表**で差分をまとめてよいです。
79
+ ## 6. 記述ガイド
112
80
 
113
- - 使いどころ: 金額計算・税区分・支払方法・数量パターンなど、差分が「値」中心で説明できる場合
114
- - 避けるべき: 例外時の扱いがケースごとに大きく異なり、期待結果の観測点が増える場合(この場合はシナリオ分割の方がレビューしやすい)
81
+ ### 6.1. 概要
115
82
 
116
- 書き方(最小):
83
+ - 判断基準: 対象者の業務課題・期待価値、利用場面、対象範囲と対象外、業務側の確認者・合意者を必ず記す。各価値をどのシナリオ ID で確認するかを示し、対象外を別 BAC で扱う場合は参照先を添える。上位の Why は要約と参照で引き継ぐ。
84
+ - 良い例: 「家族が店番しても販売と在庫を記録して引き継げることを BAC-01 で確認し、店主代表が受入に合意する。返品と仕入れは対象外とする」。
85
+ - 悪い例: 「システムが正常に動くこと」。利用者、対象、成立する業務が不明である。
117
86
 
118
- - `### シナリオ: <共通の業務行為>` を 1 つ置く
119
- - その下に `#### ケース一覧`(表)を置き、ケースごとの違いを表にまとめる
87
+ ### 6.2. 受入条件
120
88
 
121
- ケース表の例(列は必要に応じて調整):
89
+ - 判断基準: 前提と操作から期待結果が決まり、確認者が証跡で合否を判断できること。業務仕様の判断自体は参照先を正本とする。
90
+ - 良い例: 「在庫が 5 個の商品の 2 個販売を確定する。販売記録が 1 件残り、在庫が 3 個になる。家族利用者代表が確定後に両記録を照合する」。
91
+ - 悪い例: 「確定ボタンを押すと正しく処理される」。観測点がなく、画面操作に依存している。
122
92
 
123
- | ケース | 条件/入力 | 操作 | 期待結果(観測点) |
124
- | ------ | --------- | ---- | ------------------ |
125
- | C1 | … | … | … |
93
+ #### 6.2.1. 差分と例外の書き分け
126
94
 
127
- ※ ケース表を使う場合でも、「期待結果(観測点)」は検証可能な事実として具体化してください。
95
+ - ケース表の推奨列は「ケース ID / 条件・入力 / 期待結果(観測点)」。操作と判定方法は共通部分に置き、同じ内容を各行に繰り返さない。
96
+ - 良い例: 同じ販売操作で数量だけが異なる場合は表にまとめ、記録不能の場合は別シナリオで未確定の状態と引き継ぎ先を示す。
97
+ - 悪い例: 正常完了、入力不足、再開を一つの「エラーなら対応する」にまとめる。業務を続けられる条件が判別できない。
128
98
 
129
- ### 6.3 メモ / 将来課題
99
+ ### 6.3. メモ / 将来課題
130
100
 
131
- - 未確定の運用(例: 締め処理、例外時の扱い)や、将来追加したい Scenario を記録します。
101
+ - 判断基準: 現行の受入を止める論点と将来の拡張を区別でき、誰のどの判断で解消するかが分かること。
102
+ - 記録規約: 確認・追記作業には `_TODO_`、意思決定待ちには `_UNDECIDED_` を付ける。推奨列は「論点 / 影響するシナリオ ID・受入への影響 / 担当・判断者 / 判断時点・解消条件 / 追跡先」。解決した記述は確定内容へ更新し、ラベルを外す。
103
+ - 管理への接続: 将来追加するシナリオは対象外の範囲と追加条件を BAC に残す。現行の受入、期限、依存先に影響する未確定事項は PJR 登録候補とし、BA が影響を整理して PM へ渡す。課題・リスク・変更要求・決定の追跡は [[specdojo:pjr-rulebook|プロジェクト登録簿 作成ルール]] に従い、登録後は BAC に受入への影響と個票への参照を残す。
104
+ - 上流変更への追従: `based_on` 先の改訂・廃止、業務判断や受入範囲の変更時に、BA が影響するシナリオと期待値を特定する。未確定の判断は入力元へ戻し、確定後に BAC と参照を更新する。QE が判定方法と後続テストを再確認し、PO が変更後の業務条件を承認するまで、旧条件で受入を確定しない。追従作業は PM が PJR で管理する。
105
+ - 良い例: 「`_UNDECIDED_`: 記録不能時に販売を続けるかは店主代表が当該シナリオ作成前に判断する。現行は記録可能な場合に限定し、BA が販売停止への影響を整理して PM へリスク登録候補として渡す」。
106
+ - 悪い例: 「例外は今後検討」。影響範囲と次の判断が不明である。
132
107
 
133
108
  ## 7. 禁止事項
134
109
 
135
- | 項目 | 理由 |
136
- | ---------------------------------------- | ---------------------------- |
137
- | 物理テーブル名・物理カラム名・SQL全文 | 概念レベル逸脱 |
138
- | 実装クラス/関数名、APIの内部実装詳細 | 実装依存で変更に弱い |
139
- | クリック/画面遷移の逐語列挙 | UI変更に弱い・本質が埋もれる |
140
- | 期待結果が曖昧(「正しく処理される」等) | 検証不能 |
141
-
142
- ## 8. よくある誤りと対策
143
-
144
- - シナリオが UI 手順書になっている → 「操作」を業務行為に要約し、「期待結果」を観測可能な事実に寄せる。
145
- - 期待結果が 10 個以上に肥大 → シナリオを分割するか、期待結果を整理(“必須の観測点”に絞る)。
146
- - 例外系が抜けている → 代表的な異常(在庫不足、入力不備、締め済み等)をシナリオで追加する。
147
-
148
- ## 9. サンプル(簡易)
149
-
150
- ```markdown
151
- ---
152
- id: bac-sale-checkout
153
- type: requirement
154
- title: 業務受入条件: 商品販売
155
- status: draft
156
- part_of: []
157
- based_on:
158
- - bps-sale-checkout
159
- - bes-sale-checkout
160
- - br-sale-total-calc
161
- supersedes: []
162
- ---
163
-
164
- ## 概要
165
-
166
- レジ会計時に、商品販売(会計確定)が業務として成立し、売上と在庫が正しく記録されること。
167
-
168
- ## 受入条件
169
-
170
- ### シナリオ: 顧客が商品を購入する
171
-
172
- #### 前提
173
-
174
- - 顧客がレジに商品を持参している
175
- - 商品の在庫が十分にある
176
-
177
- #### 操作
178
-
179
- - レジ担当者が会計を確定する
180
-
181
- #### 期待結果
182
-
183
- - 売上が記録される
184
- - 商品の在庫が減少する
185
-
186
- ## メモ / 将来課題
187
-
188
- - 将来: 返品・取消の受入条件を追加する。
189
- ```
190
-
191
- ### 9.2 サンプル(複合・長め)
192
-
193
- 「複合シナリオ」の例です(発注→入荷→請求→支払までの一連を、同一の受入対象として確認)。
194
-
195
- ここでは、レビューしやすさのために **同一受入対象に対する代表パターン(正常系)と例外(差異)** を、別シナリオとして並べています。
196
-
197
- ```markdown
198
- ---
199
- id: bac-procurement-order-to-payment
200
- type: requirement
201
- title: 業務受入条件: 仕入(発注〜入荷〜支払)
202
- status: draft
203
- part_of: []
204
- based_on:
205
- - bps-procurement-order
206
- - bps-procurement-receive
207
- - bps-accounting-payment
208
- - bes-purchase-order-confirmed
209
- - bes-goods-receipt-confirmed
210
- - bes-invoice-received
211
- - bes-payment-confirmed
212
- supersedes: []
213
- ---
214
-
215
- ## 概要
216
-
217
- 在庫補充のための仕入で、発注・入荷・支払までの一連が業務として成立し、在庫・仕入・支払の記録が矛盾なく追跡できること。
218
-
219
- ## 受入条件
220
-
221
- この受入対象では、少なくとも次を確認します。
222
-
223
- - 正常系: 発注→入荷→請求→支払までが完了し、相互に追跡できる
224
- - 例外: 入荷で数量差異が発生した場合でも、差異と未完了(未入荷残)が追跡できる
225
-
226
- ### シナリオ: 発注から入荷・請求・支払までが完了する(数量一致)
227
-
228
- #### 前提
229
-
230
- - 商品Aの在庫が発注点以下である
231
- - 仕入先Sが取引可能(取引停止ではない)である
232
- - 仕入先Sの支払条件が登録されている
233
-
234
- #### 操作
235
-
236
- - 発注担当者が商品Aを数量10で発注確定する
237
- - 仕入先Sから商品Aが数量10で納品され、入荷検品を確定する
238
- - 経理担当者が仕入先Sの請求書(発注分)を受領する
239
- - 経理担当者が支払を確定する
240
-
241
- #### 期待結果
242
-
243
- - 発注が記録される
244
- - 発注には発注番号、仕入先、発注明細(商品、数量、単価)が保持される
245
- - 入荷が記録される
246
- - 入荷には入荷日、仕入先、入荷明細(商品、数量)が保持される
247
- - 在庫が数量10増加する
248
- - 請求が記録される
249
- - 請求には請求番号、仕入先、対象期間、請求金額が保持される
250
- - 支払が記録される
251
- - 支払には支払日、仕入先、支払金額、支払方法が保持される
252
- - 発注・入荷・請求・支払が相互に追跡できる(参照関係を辿れる)
253
-
254
- ### シナリオ: 入荷検品で数量差異があり、差異と未入荷残が追跡できる(不足)
255
-
256
- #### 前提
257
-
258
- - 仕入先Sが取引可能(取引停止ではない)である
259
- - 仕入先Sの支払条件が登録されている
260
- - 発注担当者が商品Aを数量10で発注確定している(同一の発注番号を持つ)
261
- - 仕入先Sから商品Aが数量9で納品される(発注数量に対して不足がある)
262
-
263
- #### 操作
264
-
265
- - 入荷検品を確定する
266
-
267
- #### 期待結果
268
-
269
- - 入荷が記録される
270
- - 入荷数量は数量9として記録される
271
- - 発注に対する差異(不足1)が記録される
272
- - 不足1は、同一の発注に紐づく未完了(未入荷残)として追跡できる
273
- - 在庫が数量9増加する
274
-
275
- ## メモ / 将来課題
276
-
277
- - 将来: 不足分の追加入荷(分納)で未入荷残が解消される Scenario を追加する。
278
- - 将来: 請求書が「発注数量基準」か「入荷実績基準」かの違いを扱う Scenario を追加する。
279
- - 将来: 値引・返品・訂正(請求訂正、支払取消)を扱う Scenario を追加する。
280
- ```
281
-
282
- ### 9.3 サンプル(役割/目的 + ケース表)
283
-
284
- 「役割/目的」の明記と、「ケース表」で差分をまとめる例です。
285
-
286
- ```markdown
287
- ---
288
- id: bac-sale-payment-method
289
- type: requirement
290
- title: 業務受入条件: 会計確定(支払方法の記録)
291
- status: draft
292
- part_of: []
293
- based_on:
294
- - bps-sale-checkout
295
- - br-sale-total-calc
296
- supersedes: []
297
- ---
298
-
299
- ## 概要
300
-
301
- レジ会計の確定時に、支払方法の違いにかかわらず、売上が記録され、支払方法が追跡できること。
302
-
303
- 役割: レジ担当者 / 目的: 会計確定の結果として、売上と支払方法を記録し追跡できる
304
-
305
- ## 受入条件
306
-
307
- ### シナリオ: 会計確定が支払方法別に成立する
308
-
309
- #### 前提
310
-
311
- - 顧客がレジに商品を持参している
312
- - 商品の在庫が十分にある
313
-
314
- #### 操作
315
-
316
- - 会計を確定する(支払方法を選択して確定する)
317
-
318
- #### ケース一覧
319
-
320
- | ケース | 条件/入力(支払方法) | 期待結果(観測点) |
321
- | ------ | --------------------- | ------------------------------------------------------- |
322
- | C1 | 現金 | 売上が記録され、支払方法=現金として追跡できる |
323
- | C2 | キャッシュレス | 売上が記録され、支払方法=キャッシュレスとして追跡できる |
324
-
325
- #### 判定方法(任意)
326
-
327
- - 売上記録(レジ記録)で、売上の作成と支払方法の記録が確認できる
328
-
329
- ## メモ / 将来課題
330
-
331
- - 将来: 支払方法別の明細(例: 釣銭、手数料、入金/未入金の扱い)を追加する。
332
- ```
110
+ - 物理テーブル、SQL、実装クラス、詳細 API、クリック手順を業務条件として書かない。
111
+ - schema・リファレンスの値・構文・構造の詳細を再掲しない。確認に必要な正本の参照を示す。
112
+ - 「問題ない」「正しく処理される」だけで期待結果や判定方法を代替しない。
113
+ - 根拠のない数値、判断権限、例外承認を追加しない。未決事項を合格済み・承認済みとして扱わない。
114
+ - 業務仕様の全文、テストの詳細手順、受入実績を BAC の本文へ複写しない。