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,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 の本文へ複写しない。