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
@@ -1,12 +1,15 @@
1
1
  # yaml-language-server: $schema=../../../../docs/specdojo/schemas/v1/tml-index.schema.yaml
2
+ # 非推奨: 全体計画は epic で管理する。移行先は specdojo:pjr-rulebook、
3
+ # 移行手順は specdojo:timeline-design-guide を参照。以下は旧形式の互換用サンプル。
2
4
 
3
5
  id: specdojo:tml-sample
4
6
  type: project
5
- status: draft
7
+ status: deprecated
6
8
  title: トラック順序計画
7
9
  rulebook: specdojo:tml-rulebook
8
10
  version: 1
9
11
  project_id: prj-0001
12
+ notes: 全体計画は epic へ移行してください(specdojo:pjr-rulebook、specdojo:timeline-design-guide)。
10
13
 
11
14
  tracks:
12
15
  - track: launch
@@ -4,35 +4,179 @@ specdojo:
4
4
  type: ui
5
5
  status: draft
6
6
  rulebook: specdojo:uis-rulebook
7
+ part_of: []
8
+ based_on: []
7
9
  ---
8
10
 
9
- # [画面仕様](../rulebooks/uis-rulebook.md) サンプル
11
+ # 駄菓子屋きぬや 販売登録画面 画面仕様
10
12
 
11
- ## 1. 目的と適用範囲
13
+ ## 1. 概要
12
14
 
13
- 本書は、業務ユーザー視点の画面の利用目的や表示項目、操作を定義するための最小サンプルである。
15
+ 駄菓子屋きぬやの店員・店主が、来店客の購入商品と預かり金を登録し、販売を確定して釣銭を確認する GUI 画面である。販売の記録漏れと金額の計算誤りを減らし、店番を交代しても同じ手順で現金販売を完了できるようにする。
14
16
 
15
- ## 2. 入力情報
17
+ ### 1.1. 利用環境と対象範囲
16
18
 
17
- - 対象: 駄菓子屋の販売管理システム
18
- - 前提: プロジェクト文脈は handbook の共通方針に準拠する
19
- - 参照: `../rulebooks/uis-rulebook.md`
19
+ - 単一店舗のタブレット 1 台で、認証済みの担当者が 1 件ずつ取引する。新規販売は店舗待機画面から開始し、確定後は販売完了画面へ進む。
20
+ - 商品コードは手入力するか、入力欄を選択した状態でバーコードスキャナから読み取る。スキャナは商品コードの入力と商品追加の確定を行う。
21
+ - 本画面は現金販売を扱う。つけ販売・返品・確定後の取消は別業務とし、登録中の取引は本画面で中止できる。
22
+ - _ASSUMPTION_: 店舗サービスに接続して商品情報の取得と会計確定を行う。接続できない間は入力済みの明細を保持して復旧を待つ。営業中に復旧できない場合は店主が取引番号と状況を控えて開発担当へ連絡し、紙の販売記録による継続を判断する。採用前の確認担当・判断時点・報告先は「本仕様内の未確認事項」に示す。
20
23
 
21
- ## 3. 記述内容
24
+ ## 2. 対象ユーザー/利用目的
22
25
 
23
- - 主な内容: 画面概要、利用目的、表示項目、操作、遷移、エラー表示 など
24
- - 必須観点: 対象、条件、判定基準、責任者
26
+ | 対象ユーザー | 利用場面・目的 | 許可される操作 |
27
+ | ------------ | ---------------------------------------------------------- | ------------------------------------------------------------------ |
28
+ | 店員 | 接客中に商品を登録し、請求額と預かり金を照合して釣銭を渡す | 商品追加、数量変更、明細削除、商品検索、会計確定、登録中の取引中止 |
29
+ | 店主 | 自ら店番し、誤入力や通信失敗時にも取引の確定状況を確認する | 店員と同じ操作、および同じ回復操作 |
25
30
 
26
- ## 4. 最小記述例
31
+ 来店客には担当者が合計請求金額と釣銭を伝える。画面を直接操作するのは店員・店主とする。販売登録権限を持たない利用者は本画面を利用できない。
27
32
 
28
- | 項目 | 値 | 備考 |
29
- | ------------ | ---------------------------------------------------------- | ------------------------------------ |
30
- | ドキュメント | [画面仕様](../rulebooks/uis-rulebook.md) | 最小サンプル |
31
- | 目的 | 業務ユーザー視点の画面の利用目的や表示項目、操作を定義する | specdojo:deliverables-reference 準拠 |
32
- | 主な内容 | 画面概要、利用目的、表示項目、操作、遷移、エラー表示 など | 要点のみ記載 |
33
+ ## 3. 表示項目
33
34
 
34
- ## 5. 未解決事項
35
+ ### 3.1. 入力・明細・集計
35
36
 
36
- | 論点 | 処理方針 |
37
- | -------------- | ------------------------ |
38
- | 要件詳細の補強 | 実案件適用時に具体化する |
37
+ | 項目名 | 種別 | 表示内容 | 編集可否 | 初期値・表示条件・更新契機 |
38
+ | ------------------------ | ---- | ------------------------------------------------ | -------- | -------------------------------------------------------------- |
39
+ | 取引番号 | 識別 | 開始時に発行された取引の一意な番号 | 不可 | 例 `TX-20261108-0012`。回復操作でも同じ番号を使用 |
40
+ | 取引開始日時 | 識別 | 店舗時刻の年月日・時分 | 不可 | 新規販売開始時に設定し、再試行で変更しない |
41
+ | 担当者 | 識別 | 現在の担当者の表示名 | 不可 | 例「店主」。認証済みの担当者を表示 |
42
+ | 商品コード | 入力 | 登録する商品の 8 桁数字コード | 可 | 初期値は空。追加成功時に空へ戻す。失敗時は入力を保持 |
43
+ | 明細の商品コード・商品名 | 一覧 | 追加済みの商品の識別と名称 | 不可 | 商品台帳から取得。明細なしは「商品を追加してください」 |
44
+ | 明細の単価 | 一覧 | 1 個あたりの税込販売価格、円単位 | 不可 | 商品追加時に取得。確定時に価格変更があれば再確認 |
45
+ | 明細の数量 | 入力 | 当該商品の購入数量、個単位 | 可 | 初回追加は 1。同じ商品の追加で 1 増加 |
46
+ | 明細小計 | 一覧 | 税込単価 × 数量、円単位 | 不可 | 追加・数量変更の成功時に更新 |
47
+ | 現在庫数 | 一覧 | 各商品の販売可能な数量、個単位 | 不可 | 商品追加・数量変更・会計確定時に再確認 |
48
+ | 品目数・総数量 | 集計 | 異なる商品の件数と数量の合計 | 不可 | 初期値は 0 品目 0 点。明細更新時に再計算 |
49
+ | 税抜小計 | 集計 | 合計請求金額から内税額を差し引いた金額 | 不可 | 初期値は 0 円。明細更新時に再計算 |
50
+ | 内税額 | 集計 | 税率別の内税額とその合計、円単位 | 不可 | 初期値は各 0 円。明細更新時に再計算 |
51
+ | 合計請求金額 | 集計 | 全明細小計の合計、円単位 | 不可 | 初期値は 0 円。明細更新時に再計算 |
52
+ | 預かり金額 | 入力 | 来店客から受領した金額、円単位 | 可 | 初期値は空。明細更新後も入力値を保持して再判定 |
53
+ | 釣銭金額 | 集計 | 預かり金額 − 合計請求金額、円単位 | 不可 | 未入力・形式不正・金額不足時は「未計算」。有効な入力後は再計算 |
54
+ | 取引状態 | 状態 | 「登録中」「会計処理中」「結果確認待ち」 | 不可 | 状態別の操作可否は「操作」に従う |
55
+ | 処理・エラー通知 | 状態 | 実行中の操作、失敗理由、修正対象、次に行える操作 | 不可 | エラー事象に対応する表示を行い、解消時に消去 |
56
+
57
+ 商品台帳は税込単価と税率区分(8% または 10%)を持つ。金額計算は税率別に税込明細小計を合算し、それぞれの合算額 × 税率 ÷(100 + 税率)の 1 円未満を切り捨てて内税額とする。請求額に内税額を加算しない。
58
+
59
+ ### 3.2. 表示値の確認例
60
+
61
+ | 商品 | 単価 | 税率区分 | 数量 | 明細小計 |
62
+ | ---------------- | ------ | -------- | ---- | -------- |
63
+ | きなこ棒(袋) | 108 円 | 8% | 2 個 | 216 円 |
64
+ | おもちゃ入り菓子 | 110 円 | 10% | 1 個 | 110 円 |
65
+
66
+ この明細では 2 品目 3 点、合計請求金額 326 円、内税額は 8% 分 16 円と 10% 分 10 円の計 26 円、税抜小計 300 円となる。預かり金額 500 円で釣銭は 174 円、326 円で釣銭は 0 円、325 円で釣銭は「未計算」となる。
67
+
68
+ ## 4. 操作
69
+
70
+ ### 4.1. 状態と操作可否
71
+
72
+ | 状態 | 可能な操作 | 状態を抜ける条件 |
73
+ | ------------ | ---------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ |
74
+ | 登録中 | 入力・商品追加・数量変更・明細削除・商品検索・取引中止・会計確定 | 会計確定の受付で「会計処理中」。中止確認に同意した場合は店舗待機画面へ |
75
+ | 会計処理中 | 状態表示の確認 | 成功時は販売完了画面へ。確定されていないことが確認できる失敗は「登録中」。通信切断・30 秒の応答待ち超過は「結果確認待ち」 |
76
+ | 結果確認待ち | 「結果確認」、認証失効・権限不足時の「再ログイン」 | 確定済みは販売完了画面へ。元の確定処理が終了して未確定であることが確認できれば「登録中」。処理継続中・照会失敗はこの状態を保持 |
77
+
78
+ 「会計処理中」「結果確認待ち」では入力、商品検索、明細変更、取引中止、会計確定を無効化する。登録中の取得・変更操作も 1 件ずつ処理し、その処理中は他の登録操作を無効化する。認証失効・権限不足時は「再ログイン」だけを許可する。
79
+
80
+ ### 4.2. 操作ごとの前提と結果
81
+
82
+ | 操作名 | 対象 | 前提条件 | 結果(更新/遷移) |
83
+ | ------------ | -------------------------------------------- | ----------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |
84
+ | 商品追加 | 商品コード入力欄と「商品追加」、スキャナ入力 | 登録中。商品コードを入力済み | 制約確認後、未追加の商品は数量 1 の行を追加。同じ商品は既存行の数量を 1 増やし、集計・釣銭を再計算。失敗時は明細を保持 |
85
+ | 数量変更 | 明細の数量 | 登録中。対象明細が存在 | 制約確認後に数量と集計・釣銭を更新。失敗時は前の有効数量を保持し、修正用の入力値とエラーを表示 |
86
+ | 明細削除 | 明細の「削除」 | 登録中。対象明細が存在 | 対象行を削除し、集計・釣銭を再計算。最終行の削除後は空の明細表示へ戻る |
87
+ | 預かり金入力 | 預かり金額 | 登録中 | 入力値を保持。形式・金額を判定し、有効なら釣銭を再計算 |
88
+ | 商品検索 | 「商品検索」 | 登録中 | 商品検索ダイアログを開く。選択した商品コードを商品追加と同じ条件で反映。選択取消時は元の入力・明細を保持 |
89
+ | 取引中止 | 「取引中止」 | 登録中 | 中止確認を開く。同意時に明細・預かり金を破棄して店舗待機画面へ。戻る場合は登録を継続 |
90
+ | 会計確定 | 「会計確定」 | 登録中。明細が 1 件以上あり、明細の数量に未修正の入力エラーがなく、預かり金額の形式・範囲が有効 | 「バリデーション」の確定条件を判定。成功時は販売記録と在庫引落をまとめて確定し、完了画面へ。条件違反時は登録中のまま対応エラーを表示 |
91
+ | 読み直し | 「読み直し」 | 登録中。商品取得・在庫確認が通信失敗 | 同じ商品コード・数量で情報を再取得し、成功時に元の追加・変更を 1 回反映。失敗時は入力と有効な明細を保持 |
92
+ | 結果確認 | 「結果確認」 | 結果確認待ち。認証と販売登録権限が有効 | 同じ取引番号の状態を照会し、「状態と操作可否」に従って復帰。新たな会計確定要求は発行しない |
93
+ | 再ログイン | 「再ログイン」 | 認証失効または権限不足を検出 | 取引番号・状態・入力を保持してログイン画面へ。同じ担当者が再認証し権限確認できた場合に復帰 |
94
+
95
+ 会計確定は販売記録と在庫引落の両方が成功した時点を完了とする。片方だけの成功を利用者へ完了として表示しない。同じ取引番号で確定操作を再実行しても、販売記録と在庫引落は各 1 回とする。会計処理中の連打は追加の確定として受け付けない。
96
+
97
+ 「読み直し」は直前に失敗した商品取得・在庫確認を対象とする。入力の修正や別の明細操作を行った場合は、その失敗要求を取り消して「読み直し」を解除する。追加・変更の成功後も解除する。
98
+
99
+ ## 5. 遷移
100
+
101
+ 本画面の業務上の識別子は `uis-sales-register` とする。周辺画面は未作成のため、画面名と識別子で示す。
102
+
103
+ | 遷移名 | 契機(操作) | 遷移元 | 遷移先 | 条件 | 引き渡し情報・入力の扱い |
104
+ | ---------------- | -------------------------------------------- | -------------------------------- | ------------------------------------------ | ------------------------------------ | ---------------------------------------------------------------------- |
105
+ | 新規取引開始 | 「新規販売」 | `店舗待機画面(uis-store-home)` | 販売登録画面 | 販売登録権限があり、未完了取引がない | 新規取引番号、担当者識別子。空の明細と未入力の預かり金で開始 |
106
+ | 商品検索表示 | 「商品検索」 | 販売登録画面 | `商品検索ダイアログ(uis-product-search)` | 登録中 | なし。販売登録の明細・入力は保持 |
107
+ | 商品選択反映 | 検索で「選択」 | `商品検索ダイアログ` | 販売登録画面 | 商品を 1 件選択済み | 選択商品コード。追加に失敗した場合も元の明細と入力を保持してエラー表示 |
108
+ | 商品検索取消 | 検索で「戻る」 | `商品検索ダイアログ` | 販売登録画面 | 選択せず戻る | なし。保持した明細・入力へ復帰 |
109
+ | 中止確認表示 | 「取引中止」 | 販売登録画面 | 中止確認ダイアログ | 登録中 | 現在の取引番号。入力は保持 |
110
+ | 中止確定 | 確認で「中止する」 | 中止確認ダイアログ | `店舗待機画面` | 中止への同意 | 中止した取引番号。販売・在庫は更新せず、入力を破棄 |
111
+ | 中止確認から復帰 | 確認で「戻る」 | 中止確認ダイアログ | 販売登録画面 | 中止せず戻る | なし。保持した明細・入力へ復帰 |
112
+ | 会計完了 | 会計確定成功、または結果確認で確定済みを確認 | 販売登録画面 | `販売完了画面(uis-sales-complete)` | 同じ取引の販売・在庫更新が確定済み | 取引番号、確定明細、合計請求金額、預かり金額、釣銭。以後は編集不可 |
113
+ | 再認証へ | 「再ログイン」 | 販売登録画面 | `ログイン画面(uis-login)` | 認証失効または権限不足 | 復帰先と取引番号。入力と直前の取引状態を保持 |
114
+ | 再認証から復帰 | ログイン成功 | `ログイン画面` | 販売登録画面 | 同じ担当者に販売登録権限がある | 保持した取引へ復帰。会計結果が不明なら結果確認待ちで復帰 |
115
+
116
+ 販売完了画面は釣銭の手渡し確認とレシート発行を担う。印刷失敗時の再発行も同画面で扱い、販売登録へ戻して再会計しない。権限が回復しない場合はログイン画面に留まり、店主が担当者の権限を確認する。
117
+
118
+ ## 6. バリデーション
119
+
120
+ | 対象 | 必須性 | 条件 | 判定時点 | 違反時の扱い・対応エラー |
121
+ | ---------------------- | ---------------- | ------------------------------------------------------------------------------- | -------------------------------------- | ------------------------------------------------------------------------------------------ |
122
+ | 商品コード | 商品追加時に必須 | 半角数字 8 桁。先頭の 0 を保持し、前後空白や記号を許容しない | 商品追加時、スキャン確定時 | 入力値を保持し、明細は変更しない。「商品コード形式不正」 |
123
+ | 商品の存在・販売可否 | 商品追加時に必須 | 商品台帳に存在し、販売中である | 商品追加時と会計確定時 | 未登録は「商品コード未登録」。販売停止は「販売対象外」。確定時の失敗は販売・在庫とも未更新 |
124
+ | 数量 | 各明細で必須 | 半角数字による 1〜999 の整数。空欄・符号・小数・文字を許容しない | 商品追加時、数量変更時、会計確定時 | 前の有効数量を保持し、修正入力を残す。「数量形式・範囲不正」 |
125
+ | 在庫との相関 | 各明細で必須 | 同一商品をまとめた数量が最新の現在庫数以下 | 商品追加時、数量変更時、会計確定時 | 「在庫不足」。入力と明細を保持し、確定時の失敗でも在庫引落なし |
126
+ | 販売価格 | 確定時に必須 | 追加時の税込単価と最新の単価が一致 | 会計確定時 | 確定せず、最新単価・集計・釣銭へ更新。「販売価格変更」で再確認を求める |
127
+ | 明細の有無 | 確定時に必須 | 明細 1 件以上 | 会計確定前 | 0 件では「会計確定」を無効化 |
128
+ | 預かり金額の形式・範囲 | 確定時に必須 | 半角数字による 0〜999999 の整数、円単位。空欄・符号・小数・桁区切りを許容しない | 入力変更時と会計確定前 | 空欄・形式不正時は「会計確定」を無効化。「預かり金形式・範囲不正」を表示 |
129
+ | 預かり金額との相関 | 確定時に必須 | 預かり金額が合計請求金額以上 | 預かり金入力時、明細更新時、会計確定時 | 不足額を表示。確定操作でも拒否して「預かり金額不足」。釣銭は未計算 |
130
+
131
+ 会計確定時の条件違反では販売記録を確定しない。数量の境界は 1・999 を許容し、0・1000・1.5 を拒否する。在庫数 3 の商品は数量 3 を許容し、4 を拒否する。金額相関の境界は「表示値の確認例」に従う。
132
+
133
+ ## 7. エラー表示と利用者の次の手
134
+
135
+ | エラー事象 | 発生条件 | 表示要点 | 状態の扱い | 利用者の次の手(回復アクション) |
136
+ | ---------------------------- | ------------------------------------------------------------ | ------------------------------------------------------------------------ | -------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------- |
137
+ | 商品コード形式不正 | 商品追加時に空欄または 8 桁数字以外 | 「商品コードを 8 桁の数字で入力してください」 | 入力を保持。明細・集計は変更しない | コードを修正して「商品追加」。コードが不明なら「商品検索」 |
138
+ | 商品コード未登録 | 入力コードが商品台帳にない | 「商品コードが登録されていません」と入力コード | 入力を保持。明細は追加しない | 入力を確認するか、「商品検索」で登録済みの商品を選択 |
139
+ | 販売対象外 | 追加時または確定時に販売停止を検出 | 「現在販売できない商品です」と商品名 | 確定せず登録中を保持 | 未追加なら別の商品を選択。明細内の商品なら「明細削除」で除いて再確認 |
140
+ | 数量形式・範囲不正 | 数量が空欄、整数以外、1〜999 の範囲外 | 「数量は 1〜999 の整数で入力してください」と対象商品 | 前の有効明細と集計を保持し、修正入力を残す | 対象数量を修正。購入しない場合は「明細削除」 |
141
+ | 在庫不足(初回追加) | 未追加の商品を追加しようとしたが現在庫数が 0 | 「在庫が不足しています」と商品名、現在庫数 0 | 販売・在庫は未更新。対象行は作らず、入力・既存明細を保持 | 商品コードを空にして追加を取りやめるか、別のコードを入力・商品検索して販売可能な商品を追加する |
142
+ | 在庫不足(既存明細) | 同一商品の再追加・数量変更・会計確定時に数量が現在庫数を超過 | 「在庫が不足しています」と商品名、現在庫数 | 販売・在庫は未更新。入力と直前の有効明細・集計を保持 | 現在庫数が 1 以上なら数量をその数以下へ修正。0 または購入を取りやめる場合は対象行を「明細削除」して再確認 |
143
+ | 預かり金形式・範囲不正 | 入力が半角数字による 0〜999999 の整数でない | 「預かり金額を 0〜999999 円の整数で入力してください」 | 入力を保持。釣銭は未計算 | 受領額を確認し、桁区切り等を除いて預かり金額を修正 |
144
+ | 預かり金額不足 | 預かり金額が合計請求金額未満 | 「預かり金が不足しています」と不足額 | 登録中を保持。釣銭は未計算 | 不足分を受領して預かり金額を修正し、再度「会計確定」 |
145
+ | 販売価格変更 | 確定時に単価の変更を検出 | 「価格が変わりました。金額を確認してください」と変更商品、旧単価・新単価 | 販売・在庫は未更新。最新価格で再計算し、預かり金は保持 | 新しい請求額を来店客へ伝え、預かり金を確認・修正して再度「会計確定」 |
146
+ | 商品取得・在庫確認の通信失敗 | 登録中の取得要求で接続切断または 30 秒の応答待ち超過 | 「商品情報を取得できません」と「読み直し」 | 入力と有効な明細を保持。追加・変更は未反映 | 接続を確認して「読み直し」。編集を続ける場合は入力を修正して元の操作を実行すると、失敗した要求を置き換える |
147
+ | 会計確定失敗 | 店舗サービスから、会計が未確定であるとの失敗応答 | 「会計を確定できませんでした」と取引番号 | 登録中へ戻る。販売・在庫は未更新、入力を保持 | 接続の復旧後、明細と預かり金を確認して「会計確定」。再発時は店主へ取引番号を連絡 |
148
+ | 会計結果不明 | 会計要求後の接続切断または 30 秒の応答待ち超過 | 「会計結果を確認してください」と取引番号、「結果確認」 | 結果確認待ちへ移り、編集・中止・確定を無効化 | 接続の復旧後に「結果確認」。未確定が確認できた場合のみ登録を再開 |
149
+ | 会計結果の照会未完了 | 結果確認で処理継続中、または照会に失敗 | 「会計結果をまだ確認できません」と取引番号 | 結果確認待ちを保持 | 接続と処理状況を確認して再度「結果確認」。復旧しない場合は店主へ取引番号を連絡 |
150
+ | 認証失効 | 登録中または結果確認時に認証失効を検出 | 「再ログインしてください」 | 入力と直前の状態を保持。会計要求後に検出した場合は結果確認待ち | 「再ログイン」で同じ担当者が認証。復帰後、結果確認待ちなら「結果確認」 |
151
+ | 権限不足 | 画面への進入時または操作時に販売登録権限がない | 「販売登録の権限がありません」 | 進入を拒否。操作中なら入力を保持して変更を停止。会計要求後なら結果確認待ち | 「再ログイン」へ進み、店主に担当者の権限確認を依頼。権限確認後に同じ取引へ復帰 |
152
+
153
+ ## 8. メモ / 将来課題
154
+
155
+ ### 8.1. 本仕様内の未確認事項
156
+
157
+ 次表は架空の販売管理プロジェクトでの確認事項である。本 sample では例示の前提として扱い、実プロジェクトへ採用する際は確認結果に基づいて仕様を確定する。業務上の最終判断は人間の PO(店主代表)が担う。
158
+
159
+ | 未確認事項 | 影響範囲・次の確認 | 確認担当(Role code) | 確認・判断時点 | 報告先 |
160
+ | -------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------- | ------------------------------------------------ | ---------------------------------------------------------------------------------------------------- |
161
+ | _ASSUMPTION_: 店舗サービスへの接続を前提に販売を行い、復旧しない場合は店主が紙の記録による継続を判断する | 商品取得・会計確定・結果確認に影響。開発担当が接続断と復旧後の同一取引の照会を確認し、店主代表が結果不明取引を重複記録しない引継ぎ手順と紙での継続可否を確認する | DEV(技術確認)、PO(業務確認・判断) | 採用先の画面仕様承認前。未確認なら承認を保留する | DEV から PO へ結果と残る制約を報告。PO から PM(未配置なら PO が兼務)へ採用可否と運用への影響を報告 |
162
+
163
+ ### 8.2. 採用プロジェクトの管理記録へ引き継ぐ事項
164
+
165
+ 次表は本仕様の現行動作とは分けて管理する、採用先のプロジェクト登録簿(PJR)への転記候補である。PM(未配置なら PO が兼務)が起票要否と優先順位を判断する。本 sample は実際の起票・採否決定を示すものではない。
166
+
167
+ | 転記候補 | 対応方針・仕様への影響 | 確認担当(Role code) | 判断時点 | 報告先 |
168
+ | ---------------------------------- | ------------------------------------------------------------------------------------------------------------------ | --------------------- | ---------------------------------------------- | -------------------------------------- |
169
+ | 接続前提と障害時運用の受入確認 | 「本仕様内の未確認事項」の確認作業と結果をリスク・対応記録へ引き継ぎ、画面仕様の承認条件として追跡する | PM | 採用計画を作るとき。仕様承認前に結果を確認する | PO |
170
+ | 電子マネー・QR 決済への拡張 | 初期の現金販売には含めない。店主代表が決済方法と取消手順を確認し、預かり金・会計確定・結果確認の変更範囲を整理する | BA、PO | 決済方法の追加を検討するとき | PM へ変更要求候補、PO へ採否判断を報告 |
171
+ | 入力欄の選択を要しない連続スキャン | 初期の入力方式には含めない。店員と開発担当が誤読・重複追加時の修正手順を確認する | BA、DEV | 連続スキャンの導入を検討するとき | PM へ改善候補、PO へ採否判断を報告 |
172
+
173
+ ### 8.3. 同梱 sample の承認と公開前確認
174
+
175
+ 公開対象は、架空の画面仕様の完成例としての本文・表示値・課題表であり、SpecDojo の同梱文書として一般の利用者へ公開する範囲とする。実顧客・実取引の情報、担当者の個人情報、認証情報、店舗固有の非公開情報を含めない。同梱 sample の `ready` 化と公開可否の最終承認・説明責任は、SpecDojo 側の人間の PO が担う。agent による編集・検査だけでは承認済みとしない。
176
+
177
+ `draft` から `ready` へ進める前に、次の条件を確認する。
178
+
179
+ - QE が rulebook の必須項目と、表示値・操作・遷移・入力境界・回復操作の整合を確認する。在庫 0 の初回追加では行が作られず、既存明細だけが削除対象になることを含める。
180
+ - QE が Markdown・Frontmatter の検査と、uis-rulebook・uis-sample の最新内容に対する grade の pass を確認する。残る指摘があれば対応内容または未対応理由を PO に報告する。
181
+ - PO が未確認事項の担当・判断時点・報告先と PJR 転記候補を確認する。架空の運用仮定は採用時の確認事項として残せるが、同梱公開を妨げる未解決指摘は解消し、解消できなければ保留理由を記録して `draft` を維持する。
182
+ - PO が公開対象に非公開情報を含まないことを確認し、承認対象の版と承認理由をプロジェクトの管理記録へ残してから、人が `status` を変更する。
@@ -313,15 +313,44 @@ Markdown 文書の最新の継続品質評価は、プロジェクトの `<execu
313
313
 
314
314
  未充足条件がある場合だけ `done_criteria.unsatisfied` を置き、条件 ID をキー、その条件の `roles` を値として記録します。これにより詳細を grade result へ複製せず、次の確認担当を特定できます。詳細 YAML は `grade-done-criteria.schema.yaml` に従い、成果物と同じ `content_hash` を持ちます。
315
315
 
316
- `findings[].line` は Frontmatter を除く本文での指摘行(1始まり)、`anchor` は評価時点の該当行の引用です。`message` は executor が出力した原文を正本として保存し、前回 finding の一致にも使います。`message_ja` は表示専用で、判定、score、severity、引き継ぎに使いません。旧サイドカーのように `message_ja` がない場合は `message` を表示します。本文編集で行番号がずれた場合は `anchor` を照合に使います。`grade validate` はサイドカーの文書 ID・対象・件数・内容ハッシュを成果物と突き合わせます。
316
+ `findings[].line` は Markdown では Frontmatter を除く本文、YAML ではコメント・メタ情報を含む元ファイル全体での指摘行(1始まり)、`anchor` は評価時点の該当行の引用です。`message` は executor が出力した原文を正本として保存し、前回 finding の一致にも使います。`message_ja` は表示専用で、判定、score、severity、引き継ぎに使いません。旧サイドカーのように `message_ja` がない場合は `message` を表示します。本文編集で行番号がずれた場合は `anchor` を照合に使います。`grade validate` はサイドカーの文書 ID・対象・件数・内容ハッシュを成果物と突き合わせます。
317
317
 
318
- 再評価で正本の `message` が同じ finding が残る場合は未解消として扱い、severity を前回より引き下げません。`message_ja` の一致は使いません。日本語の `message` だけを持つ旧サイドカーはその日本語を互換用の正本として扱うため、英語へ翻訳した別文とは一致しません。前回の問題が解消され、別の軽微な問題だけが残る場合は、新しい finding の `message` に severity を引き下げる根拠を含めます。
318
+ 再評価で前回の正本の `message` または `message_ja` と同じ finding が残る場合は未解消として扱い、severity を前回より引き下げません。grade plan は前回の指摘を `message_ja`(なければ `message`)で示すため、英語を正本にした旧サイドカーの指摘は日本語で再掲され、その日本語が新しい正本になります。前回の問題が解消され、別の軽微な問題だけが残る場合は、新しい finding の `message` に severity を引き下げる根拠を含めます。
319
319
 
320
- executor は新しい判定根拠と finding を英語で出力します。機械変換後に `gemma26-translator` が英語 finding だけを日本語へ翻訳し、`message_ja` に保存します。モデルへ渡すのは英語文だけの配列であり、対応する index はコード側で管理します。`grade translation-plan` は元のインラインコードをそのまま残し、新しいインラインコードやバッククォートを加えず、固有名詞・識別子以外の英語の語句を日本語へ訳すよう求めます。`grade localize` は件数が一致するとき、各訳文が空でないこと、仮名を含むこと、元の文と訳文のインラインコードの多重集合が一致することを検証し、合格した項目だけを採用します。不合格項目は1件ずつ1回だけ再翻訳し、再び不合格なら `message_ja` に正本の `message` を保存します。件数が一致しない場合は全項目を不合格とします。executor が日本語で出力した finding は翻訳対象から外し、その原文を `message` と `message_ja` の両方に保存します。
320
+ executor は判定根拠と新しい finding を日本語で出力し、その原文を `message` と `message_ja` の両方に保存します(PJR-YYDS、2026-11-16。それまでは英語を正本にしていました)。英語の finding は、日本語訳のない旧サイドカーの英語の正本が原文のまま再掲された場合などに限られます。`tools/grade/run-per-document.sh` は、英語 finding が残る場合だけ機械変換後に `gemma26-translator` で日本語へ翻訳し、`message_ja` に保存します。`grade run` は翻訳しません。モデルへ渡すのは英語文だけの配列であり、対応する index はコード側で管理します。`grade translation-plan` は元のインラインコードをそのまま残し、新しいインラインコードやバッククォートを加えず、固有名詞・識別子以外の英語の語句を日本語へ訳すよう求めます。`grade localize` は件数が一致するとき、各訳文が空でないこと、仮名を含むこと、元の文と訳文のインラインコードの多重集合が一致することを検証し、合格した項目だけを採用します。不合格項目は1件ずつ1回だけ再翻訳し、再び不合格なら `message_ja` に正本の `message` を保存します。件数が一致しない場合は全項目を不合格とします。
321
321
 
322
322
  機械変換では、finding の severity が許す level 上限を超えた viewpoint だけを上限まで下げます。level を上げる補正や、viewpoint・severity・line の変更は行いません。補正した場合は `level_corrections` に viewpoint、`original_level`、`corrected_level` を保存します。
323
323
 
324
- サイドカーは `grade-result.schema.yaml` に従います。現在の評価対象は Markdown 文書であり、YAML / JSON を対象へ指定した場合はエラーとします。
324
+ サイドカーは `grade-result.schema.yaml` に従います。評価対象は Markdown と YAML(`.yaml` / `.yml`)です。YAML は `validate:schema` と共通の処理で最上位または `x-spec-meta` のメタ情報を読み、ファイル全体を評価し、その内容からハッシュを取ります。`id`・`type`・`status`・`rulebook` がない YAML は理由を表示して対象から外します。JSON は評価対象外です。
325
+
326
+ ### 6.3. 文書の改訂・廃止とライフサイクル変更管理(`supersedes` と `deprecated`)
327
+
328
+ 成果物ドキュメントの改訂(置き換え)や廃止に伴う変更管理、および参照元への波及影響の追跡は、以下の共通規則に従います。
329
+
330
+ - **`supersedes` による置き換え(改訂)**:
331
+ - 文書の設計・仕様の大幅な見直しにより新たな文書を作成する場合、新文書の Frontmatter(独立 YAML ではトップレベル)の `supersedes` に置き換え対象の旧文書 ID 配列を指定します。
332
+ - 旧文書は `status: deprecated` に移行し、新文書が `status: ready` へ昇格した時点で置き換えを完了とします。軽微な修正や誤字修正は同一文書の改訂とし、`supersedes` による新文書作成は行いません。
333
+ - 新文書の概要または変更履歴に、旧文書からの主な変更点、改訂理由、および移行期間を明記します。
334
+ - **`deprecated` への移行(非推奨化・廃止)**:
335
+ - 業務仕様の廃止や機能縮退に伴い文書を運用終了とする場合、ファイルを直接削除せず `status: deprecated` に更新して移行期間を設けます。
336
+ - 文書冒頭(導入・概要)に、廃止理由、代替手段(後継文書 ID や代替業務運用)、および廃止時期を明記します。
337
+ - `status` が `deprecated` の文書を、新規または有効な文書の `based_on` や参照先にしてはなりません。有効な上位文書または後継文書へ参照を更新します。
338
+ - **影響追跡(波及分析)と関係成果物の追従**:
339
+ - 改訂または廃止対象の文書を参照しているすべての成果物(ダウンストリーム)を特定し、次の観点で追従更新します。
340
+ - **一覧・カタログ**: 業務イベント一覧(BEL)、業務データ辞書一覧、カタログなどの対応行のリンクを新文書へ付け替え、状態(非推奨・置換)を同期します。
341
+ - **プロセス・フロー仕様**: 業務プロセス仕様(BPS)などの処理ステップ、トリガー、判断において参照している旧仕様を新仕様へ付け替え、完了条件・分岐を見直します。
342
+ - **データ仕様・スキーマ**: 業務データ辞書(BDD)、概念クラス図(CCD)、データストア仕様(CDSD)の関連エンティティ・項目・許容値との整合性を再照合します。
343
+ - **実装コード**: 仕様を参照している型定義、ドメインロジック、イベント発行・購読コードを特定し、追従修正または互換性を維持します。
344
+ - **テスト仕様・受入条件**: 業務受入条件(BAC)、テストシナリオ・ケース(ATC / ITC / UTC)を抽出し、判定条件・期待値の更新と再検証を行います。
345
+ - **担当 Role code の責務分担**:
346
+ - **BA**: 業務影響分析の主担当。仕様改訂・廃止に伴う業務境界、業務プロセス、ルール、データの波及影響を洗い出し、改訂案および参照元仕様の更新案を作成します。
347
+ - **PO**: 廃止・置き換えの意思決定と承認。`deprecated` 移行および新文書の `ready` 昇格を最終判断します。
348
+ - **ARC**: 成果物間の構造整合性、スキーマ・インターフェース・技術制約への影響を検証します。
349
+ - **DEV**: 実装コード・型定義・スキーマの特定と追従修正を担います。
350
+ - **QE**: 影響を受けるテスト仕様・受入条件の特定と再検証・品質確認を担います。
351
+ - **PM**: 改訂・廃止に伴う波及更新タスク(PJR 項目)の起票と移行スケジュールを管理します。
352
+ - **未決事項・課題の PJR への引き継ぎ**:
353
+ - 改訂・廃止の過程で生じた未決事項、恒久的なリスク、課題、変更要求、決定事項は、文書内の未確定ラベル(`_TODO_`, `_UNDECIDED_`, `_ASSUMPTION_`)のまま放置せず、PJR(リスク登録簿 `pm-risk-register`、課題管理簿 `pm-issue-log`、変更要求ログ `pm-change-request-log`、決定記録 `pm-decision-log`、または PJR 登録項目)へ担当 Role code と転送先レコードを明記して引き継ぎます。
325
354
 
326
355
  ## 7. 成果物の値制約
327
356
 
@@ -884,10 +884,11 @@ specdojo deliverable trash --project prj-0001 --local-id cdfd-register-operation
884
884
  | 概念データストア定義 | Conceptual Data Store Definition | cdsd- | cdsd-common, cdsd-sales |
885
885
  | 保管場所定義 | Storage Location Definition | sld- | sld-common, sld-sales |
886
886
  | ステータス定義(状態一覧・状態遷移図) | Status Definition | stsd- | stsd-product |
887
- | 分類定義 | Classification Definition | cld- | cld-product |
887
+ | 分類一覧 | Code Table | cdt- | cdt-product |
888
888
  | 業務プロセス仕様 | Business Process Specification | bps- | bps-order-flow |
889
889
  | ビジネスルール | Business Rule | br- | br-discount |
890
890
  | 画面仕様 | UI Specification | uis- | uis-order-edit |
891
+ | CLI仕様 | CLI Specification | clis- | clis-exec-commands |
891
892
  | 帳票仕様 | Business Document Specification | bds- | bds-order-summary |
892
893
  | システム化機能 | System Function | sf- | sf-index, sf-product-register |
893
894
  | 業務イベント仕様 | Business Event Specification | bes- | bes-index, bes-order-approved |
@@ -906,6 +907,7 @@ specdojo deliverable trash --project prj-0001 --local-id cdfd-register-operation
906
907
  | システム設計-全体構成 | System Design Index | sysd- | sysd-index |
907
908
  | システム設計-重要フロー | System Design Critical Flows | sysd- | sysd-critical-flows |
908
909
  | システム設計-横断ルール | System Design Cross-cutting Policy | sysd- | sysd-cross-cutting-policy |
910
+ | デザインシステム | Design System Specification | dss- | dss-common, dss-store-gui |
909
911
  | 非機能要件 | Non-Functional Requirements | nfr- | nfr-performance |
910
912
  | システム受入条件 | System Acceptance Criteria | sac- | sac-performance |
911
913
  | テスト戦略・方針 | Test Strategy and Policy | tsp- | tsp-index |
@@ -104,6 +104,7 @@ specdojo:
104
104
  - 用語はファイル内で統一し、`index` / `overview` などの命名ゆれを持ち込まない。
105
105
  - 用語定義を置く場合は、本文構成の見出し名や記述ガイドを単に言い換えて重複させない。重複になる場合は用語定義を省略する。
106
106
  - `推奨 Frontmatter 項目` の記述は [document-metadata-standard.md](document-metadata-standard.md) に従う。
107
+ - 成果物の改訂・廃止、置き換え(`supersedes`)、非推奨化(`deprecated`)、および参照元(一覧・プロセス・データ・実装・テスト)への影響追跡と担当 Role code の記載要件は、[[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] の「文書の改訂・廃止とライフサイクル変更管理」に従う。各 rulebook は自系統の成果物における具体的な追従対象と役割分担を定義する。
107
108
  - `ファイル命名・ID規則` は [docs-structure-guide.md](../guides/docs-structure-guide.md) に従う。
108
109
  - `target_format` がある場合は、本文ルール・記述例を対象フォーマットに合わせる。未記載の場合は markdown を対象とみなす(`Frontmatter 規約` 参照)。
109
110
  - `target_format: yaml` / `json` の場合は、Frontmatter と同等の先頭メタ項目、ルートキー、必須キー、型制約を実装可能な粒度で定義する。
@@ -0,0 +1,76 @@
1
+ ---
2
+ specdojo:
3
+ id: specdojo:bac-template
4
+ type: template
5
+ status: ready
6
+ frontmatter_template:
7
+ specdojo:
8
+ id: _LOCAL_ID_
9
+ type: requirement
10
+ status: draft
11
+ rulebook: specdojo:bac-rulebook
12
+ based_on: _BASED_ON_
13
+ ---
14
+
15
+ # _DELIVERABLE_NAME_
16
+
17
+ _DELIVERABLE_OVERVIEW_
18
+
19
+ ## 1. 概要
20
+
21
+ - 受入対象: _TODO_
22
+ - 対象者・業務課題: _TODO_
23
+ - 業務価値・対応するシナリオ ID: _TODO_
24
+ - 利用場面・対象範囲(開始点・終了点): _TODO_
25
+ - 対象外・委譲先: _TODO_
26
+ - 根拠: _TODO_
27
+
28
+ | 役割 | 確認・合意する内容 |
29
+ | ---------------- | ------------------ |
30
+ | _CONFIRMER_ROLE_ | _TODO_ |
31
+ | _APPROVER_ROLE_ | _TODO_ |
32
+
33
+ ## 2. 受入条件
34
+
35
+ 共通前提: _TODO_
36
+
37
+ ### 2.1. BAC-01 _SCENARIO_NAME_
38
+
39
+ 根拠(業務仕様の文書・項目 ID): _TODO_
40
+
41
+ #### 2.1.1. 前提
42
+
43
+ - 開始状態: _TODO_
44
+ - 入力: _TODO_
45
+ - 担当者・権限: _TODO_
46
+ - 共通前提との差分: _TODO_
47
+
48
+ #### 2.1.2. 操作
49
+
50
+ - 担当者・業務行為: _TODO_
51
+
52
+ #### 2.1.3. 期待結果
53
+
54
+ - 状態・記録の変化: _TODO_
55
+ - 停止時に確定しないもの: _TODO_
56
+ - 引き継ぎ先・内容・再開条件: _TODO_
57
+
58
+ <!-- ケース表は条件差分がある場合に使用する。不要なら削除する。 -->
59
+
60
+ | ケース ID | 条件・入力 | 期待結果(観測点) |
61
+ | --------- | ---------- | ------------------ |
62
+ | _CASE_ID_ | _TODO_ | _TODO_ |
63
+
64
+ #### 2.1.4. 判定方法
65
+
66
+ | 対応する期待結果・ケース ID | 確認者 | 確認時点 | 観測先(証跡) | 照合対象 |
67
+ | --------------------------- | ------ | -------- | -------------- | -------- |
68
+ | _TODO_ | _TODO_ | _TODO_ | _TODO_ | _TODO_ |
69
+
70
+ ## 3. メモ / 将来課題
71
+
72
+ <!-- 未決事項がない場合は表を「なし」に置き換える。 -->
73
+
74
+ | 論点 | 影響するシナリオ ID・受入への影響 | 担当・判断者 | 判断時点・解消条件 | 追跡先 |
75
+ | --------------- | --------------------------------- | ------------ | ------------------ | ------ |
76
+ | _TODO_: _ISSUE_ | _TODO_ | _TODO_ | _TODO_ | _TODO_ |
@@ -0,0 +1,56 @@
1
+ ---
2
+ specdojo:
3
+ id: specdojo:bes-template
4
+ type: template
5
+ status: ready
6
+ frontmatter_template:
7
+ specdojo:
8
+ id: _LOCAL_ID_
9
+ type: requirement
10
+ status: draft
11
+ rulebook: specdojo:bes-rulebook
12
+ based_on: _BASED_ON_
13
+ supersedes: []
14
+ ---
15
+
16
+ # 業務イベント: _EVENT_NAME_
17
+
18
+ _TODO_: 解消する業務上の混同、対象範囲、定義を利用できると判断する基準を簡潔に記入する。共通の目的や用語は上位の正本を参照する。
19
+
20
+ _TODO_: 上位一覧の文書 ID と対応イベントを記入する。未存在の参照は ID をインラインコードで仮置きする。
21
+
22
+ ## 1. 何が起きたか
23
+
24
+ _TODO_: 対象と確定した事実を過去形で記入する。一回の発生単位、含めない隣接する出来事、対象外と適用未判定の業務を区別する。
25
+
26
+ _TODO_: 業務定義・公開可否を承認する人間、判断時期、承認条件と記録先を記入する。未確認の担当割当は仮定として示す。
27
+
28
+ ## 2. いつ
29
+
30
+ _TODO_: 観測できる成立時点を記入し、要求時点や後処理の完了時点と区別する。繰り返し・一括要求がある場合は個別の発生時点を記入する。
31
+
32
+ ## 3. 誰が/何が
33
+
34
+ | 起点区分 | 要求する主体 | 事実を成立させる主体 | 主体ごとの責務・差異 |
35
+ | ------------- | ------------ | -------------------- | ---------------------- |
36
+ | _ORIGIN_KIND_ | _REQUESTER_ | _CONFIRMING_ACTOR_ | _ACTOR_RESPONSIBILITY_ |
37
+
38
+ _TODO_: システム・調整役の名称を使う場合は、本文での意味と責務を記入する。
39
+
40
+ ## 4. 発生条件
41
+
42
+ - _TODO_: 共通の成立条件と根拠となる状態定義・業務ルールの参照を記入する。
43
+ - _TODO_: 起点別に成立条件が異なる場合は、その差分を記入する。
44
+ - _TODO_: 発生しない条件と、確定後の処理を委ねる先を記入する。
45
+
46
+ _TODO_: 未決事項がある場合は関連する章に、内容、利用への影響、決定者、確認担当、判断時期、記録先を記入する。該当しなければこの記入指示を削除する。
47
+
48
+ ## 5. 事実データ
49
+
50
+ | 項目 | 業務上の意味 | 必要になる条件 |
51
+ | ----------- | ------------------ | --------------- |
52
+ | _FACT_ITEM_ | _BUSINESS_MEANING_ | _REQUIRED_WHEN_ |
53
+
54
+ _TODO_: データモデルとの対応を記入する。相関情報が必要なら、同じとみなす単位と照合先を記入し、物理項目名・構造は正本へ委ねる。相関が不要ならその理由を記入する。
55
+
56
+ _TODO_: 境界や相関の解釈が分かれる場合は、発生有無・回数や同一要求への帰属を判断できる確認例を表で記入する。確認例を別の章に置いた場合や不要な場合はこの記入指示を削除する。
@@ -0,0 +1,64 @@
1
+ ---
2
+ specdojo:
3
+ id: specdojo:br-template
4
+ type: template
5
+ status: ready
6
+ frontmatter_template:
7
+ specdojo:
8
+ id: _LOCAL_ID_
9
+ type: rule
10
+ status: draft
11
+ rulebook: specdojo:br-rulebook
12
+ based_on: _BASED_ON_
13
+ ---
14
+
15
+ # _DELIVERABLE_NAME_
16
+
17
+ _DELIVERABLE_OVERVIEW_
18
+
19
+ ## 1. 概要
20
+
21
+ - 業務価値: _TODO_: この判断が守る価値と根拠。
22
+ - 利用者・適用場面: _TODO_: 呼出元の業務、判定前に満たす条件。
23
+ - 適用範囲: _TODO_: 対象となるものと時点。
24
+ - 対象外: _TODO_: 隣接する判断・手順への委譲先。
25
+
26
+ ## 2. 入力
27
+
28
+ | 入力 | 概念データ・項目 | 利用目的 | 適用条件・欠損時の扱い |
29
+ | ------ | ---------------- | -------- | ---------------------- |
30
+ | _TODO_ | _TODO_ | _TODO_ | _TODO_ |
31
+
32
+ ## 3. ルール(判定/計算)
33
+
34
+ ### 3.1. 判定規則
35
+
36
+ _TODO_: 規則の識別子を付け、適用順、条件、結果を記入する。比較・計算の単位、境界値、同順位、項目ごとの欠損、代替規則を該当する範囲で定める。
37
+
38
+ ### 3.2. 判定例
39
+
40
+ | 例 | 入力・前提 | 適用規則 | 期待結果 |
41
+ | ------ | ---------- | -------- | -------- |
42
+ | _TODO_ | _TODO_ | _TODO_ | _TODO_ |
43
+
44
+ ## 4. 出力
45
+
46
+ | 出力 | 意味・単位または区分 | 利用先 |
47
+ | ------ | -------------------- | ------ |
48
+ | _TODO_ | _TODO_ | _TODO_ |
49
+
50
+ ## 5. 例外 / 異常系
51
+
52
+ | ID | 状況 | 扱い | 利用者の次の手 |
53
+ | ------ | ------ | ------ | -------------- |
54
+ | _TODO_ | _TODO_ | _TODO_ | _TODO_ |
55
+
56
+ ## 6. メモ / 将来課題
57
+
58
+ _TODO_: 未決事項がなければ「なし」と記入する。ある場合は共通ラベルを付け、次の表に記入する。
59
+
60
+ | 論点 | 判断依頼先 | 判断時点 | 下流への影響・必要な根拠 |
61
+ | ------ | ---------- | -------- | ------------------------ |
62
+ | _TODO_ | _TODO_ | _TODO_ | _TODO_ |
63
+
64
+ _TODO_: 未決事項の解消・承認を含め、承認可能となる条件を記入する。