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,130 +3,134 @@ specdojo:
3
3
  id: specdojo:bes-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:bes-recipe
8
9
  sample: specdojo:bes-sample
9
- template: undecided
10
+ template: specdojo:bes-template
10
11
  ---
11
12
 
12
13
  # 業務イベント仕様 作成ルール
13
14
 
14
- Business Event Specification (BES) Documentation Rules
15
+ Business Event Specification Documentation Rulebook
15
16
 
16
- BES は、BEL(業務イベント一覧)の各イベントについて、**重要/複雑なものだけ** を詳細化するための仕様です。
17
+ 業務イベント一覧の一行では解釈が分かれる出来事を、発生した事実として定義するためのルールです。発生境界、時点、主体、条件、事実データを明確にし、業務承認とイベント処理・テスト設計の入力にします。
17
18
 
18
- ## 1. 位置づけ
19
+ ## 1. 全体方針
19
20
 
20
- - BEL: イベントを網羅する一覧(表)
21
- - BES: イベント1件の記述を **責務の範囲で** 最小限に明確化(何が起きたか/いつ/誰が・何が/発生条件/事実データ)
22
- - BPS: イベントを契機に動く業務プロセスの手順(詳細手順ガイドは BPS 側に寄せる)
23
- - BR: 判断/計算ロジック(BES には直書きせず、必要なら `implements` で参照)
21
+ - 一つの BES は、一つの業務上の出来事を扱います。確定・受付などの境界、時点、起点、条件、データのいずれかが一覧だけでは判定できない場合に詳細化します。
22
+ - 冒頭には、この定義が解消する業務上の混同、対象範囲、定義を使えると判断する基準を簡潔に置きます。業務全体の目的は上位文書を正本とし、全文を再掲しません。
23
+ - 人、システム、外部からの要求を同じイベントにまとめる場合は、同じ事実が成立する境界と、一回の要求から生じるイベントの単位を示します。対象外と適用未判定は区別します。
24
+ - 確認できた事実と未決事項を分けます。未決事項には影響、判断者、確認担当、判断時期、記録先を添え、根拠や承認が揃うまで実装・公開可能な完成仕様と扱いません。
24
25
 
25
- ## 2. いつ BES を作るか
26
+ ## 2. 位置づけと用語定義
26
27
 
27
- 次のいずれかに当てはまる場合に作成します。
28
+ | 用語 | 本書での意味・責務 |
29
+ | ----------------------- | ------------------------------------------------------------------------------------------------------------ |
30
+ | 業務イベント一覧(BEL) | イベントの網羅性と個別仕様への入口を持つ上位の一覧。共通の対象範囲・用語は一覧を正本とする |
31
+ | 業務イベント仕様(BES) | 一覧のうち解釈が分かれる一件について、発生した事実とその観測境界を詳細化する仕様 |
32
+ | 業務プロセス仕様(BPS) | イベントを受けた後の手順、担当解決、通知、失敗時の回復などを定める仕様 |
33
+ | 業務ルール(BR) | 選択、計算、可否判定の規則。BES には発生に必要な条件と参照だけを残す |
34
+ | 相関情報 | 同じ要求・取引から生じた複数イベントを関連付ける業務上の識別情報。個別イベントや実行一回の識別子とは区別する |
28
35
 
29
- 前提:
36
+ 状態の意味・遷移は状態定義、項目の構造・値・構文はデータモデル・schema・リファレンスを正本とします。BES は事実データの業務上の意味と必要になる条件を扱います。
30
37
 
31
- - BES の本文は「何が起きたか / いつ / 誰が/何が / 発生条件 / 事実データ」の **事実(観測)** に限定します。
32
- - それでも、BEL の 1 行だけでは **解釈が割れやすい**(= 後工程が迷う)場合があり、そのとき BES を作成します。
38
+ - **主要な関係者(Role code)と確認観点**:
39
+ - **BA(ビジネスアナリスト / 主作成者)**: 業務上の事実境界、発生条件、事実データの正確性を定義し、改訂・廃止時の BEL・BPS への波及影響を整理する。
40
+ - **PO(プロダクトオーナー / 承認者)**: 業務定義の確定、BES の置き換えおよび廃止(`deprecated` 移行)を最終判断・承認する。
41
+ - **ARC(アーキテクト / 確認者)**: イベント相関境界、システム連携、BPS・データモデルとの構造整合性を確認する。
42
+ - **DEV(開発者 / 利用者)**: イベント発行・購読の実装設計、外部インターフェースとの契約整合を確認する。
43
+ - **QE(品質保証 / 確認者)**: 発生境界の検証可能性、事実データ・相関の確認例、受入条件(BAC/ATC)への追従を確認する。
44
+ - **PM(プロジェクトマネージャー / 進行管理)**: 改訂・廃止に伴う関連成果物・実装・テストの更新タスク(PJR)を起票・管理する。
33
45
 
34
- 判断基準(BEL 1 行では足りないサイン):
46
+ ## 3. ファイル命名・ID規則
35
47
 
36
- - **何が起きたか** の解釈が割れる(例: 「確定」「受付」「取消」「訂正」「差戻し」など、事実の境界が曖昧)
37
- - **いつ** の基準が割れる(例: 入力時/承認時/締め処理時/外部応答時 のどれを指すかが曖昧)
38
- - **誰が/何が** が混在して割れる(例: 人の操作/システム自動/外部起点が混ざり、起点が一意にならない)
39
- - **発生条件** が複数パターンで揉める(例: 部分返品、分割納品、在庫差異の許容、締め済みへの訂正など)
40
- - **事実データ** の範囲が合意できない(例: ID体系、金額内訳、訂正元ID、理由の必須性、個人情報の含有可否など)
48
+ - ファイル名は `bes-<event>.md` とし、`<event>` は出来事を区別できる英小文字のスラッグにします。
49
+ - 文書 ID は `bes-<event>` を基本とし、プロジェクト配下ではそのプロジェクトの authority を付けます。命名・配置の共通規則は [[specdojo:docs-structure-guide|ドキュメント構成ガイド]] を正本とします。
50
+ - イベント一覧が存在する場合は対応行から個別 BES へリンクし、BES からも一覧の対応イベントを識別できるようにします。一覧がなければ未解決の参照を wikilink にせず、文書 ID を仮置きして照合担当と時期を残します。
51
+ - **改訂・廃止と変更管理手順**:
52
+ - 置き換えによる大幅な改訂がある場合は、新 BES の `supersedes` に旧 BES の ID を列挙し、旧 BES を `status: deprecated` へ移行します。
53
+ - BES の改訂・廃止時は、共通基準 [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] に従い、参照元となる BEL・BPS・実装・テストへの影響を追跡して同期更新します。
54
+ - **業務イベント一覧(BEL)の追従**: 保守担当(BA)は BEL の該当行のリンクを新 BES へ付け替え、イベント名・概要・状態(非推奨・置換)を同期します。廃止時は該当行を非推奨表示または削除へ更新します。
55
+ - **業務プロセス仕様(BPS)の追従**: 保守担当(BA / ARC)は旧 BES をトリガー・受領情報・発行イベントとして参照している全 BPS の処理ステップ・トリガー表を抽出し、新 BES への参照付け替え、あるいは迂回・代替経路の設計見直しを実施します。
56
+ - **外部インターフェース・実装の追従**: DEV は旧 BES の事実データや相関情報に依存するイベント契約(API・メッセージ仕様)および発行・購読コードを特定し、追従修正または互換性を維持します。
57
+ - **テスト・受入条件の追従**: QE は旧 BES の事実境界・発生条件を検証する業務受入条件(BAC)や受入テスト(ATC)を特定し、テストケースの更新とリグレッション確認を実施します。
58
+ - 意思決定と承認は PO が担い、未決事項や波及タスクは PM が PJR 項目として起票・管理します。
41
59
 
42
- 目安:
60
+ ## 4. 推奨 Frontmatter 項目
43
61
 
44
- - 重要な「確定」を伴う出来事(売上確定/在庫確定/会計確定など)は、上記の曖昧さが起きやすいため BES 化を優先検討します。
62
+ - メタ情報の構文と許容値は [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] と `docs/specdojo/schemas/v1/deliverable-frontmatter.schema.yaml` を正本とします。
63
+ - BES の `type` は `requirement`、`rulebook` は `specdojo:bes-rulebook` とします。作成中は `status: draft` を維持し、`ready` への昇格は人間が行います。
64
+ - `supersedes` は置き換え対象の旧 BES の ID 配列を指定します。旧仕様との置換関係を明確にし、下流への影響確認が完了するまで旧 BES は `status: deprecated` として保持します。
65
+ - `status` は `draft` / `ready` / `deprecated` とします。作成・改訂中は `draft` とし、PO の承認を経て `ready` へ昇格します。廃止時は直接削除せず `deprecated` に移行して移行期間を設けます。`deprecated` の BES を有効な BPS や新規文書から参照してはなりません。
66
+ - `based_on` には実際に根拠とした先行成果物だけを記載します。依存として宣言されていない文書やプロジェクト共通文脈を、根拠に見せるために追加しません。
67
+ - 業務承認を担う人間と承認条件は本文で識別します。未確認の個人名・担当割当を補完せず、実名または Member の確認を未決事項に残します。
45
68
 
46
- ### 2.1 BEL からのリンク
69
+ ## 5. 本文要件
47
70
 
48
- 個別 BES を作成したら、対応する BEL の一覧表で **イベントIDをBESファイルへのリンク** に更新します。
71
+ 見出し順・表・記入欄の骨組みは template を正本とします。以下は各章の意味要件であり、任意の小節も該当する章の範囲に置きます。Markdown の `##`〜`####` には階層ごとに連番と末尾の `.` を付けます。
49
72
 
50
- - 例(例示はコード表記): `[bes-sale-checkout](./bes-sale-checkout.md)`
73
+ | 記述対象 | 必須・任意 | 判定基準 |
74
+ | -------------------------- | ------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------ |
75
+ | 導入 | 必須 | 解消する混同、対象範囲、利用できると判断する基準、上位一覧との対応が分かる |
76
+ | 「何が起きたか」の事実境界 | 必須 | 対象と確定した事実を過去形で示す。一回の発生単位、似ているが含めない出来事、対象業務の境界を区別できる |
77
+ | 「いつ」の観測時点 | 必須 | 要求・受付・確定・後処理のどの時点か判定できる。繰り返し・一括要求がある場合は各イベントの発生時点を説明できる |
78
+ | 「誰が/何が」の主体 | 必須 | 要求する主体と事実を成立させる主体を区別する。システム名は責務を定義し、業務承認者と混同しない |
79
+ | 「発生条件」の成立・不成立 | 必須 | 共通条件と起点別の差異を示す。候補なし・条件未充足など、発生しない場合を判定できる。判断ロジックは BR、状態は状態定義へ委ねる |
80
+ | 「事実データ」の内容 | 必須 | 項目ごとの業務上の意味と必要になる条件を示す。一括・並列などでは相関情報の単位と照合先を示す。未来の処理結果を発生時点の事実にしない |
81
+ | 発生判定・相関の確認例 | 境界や相関の解釈が分かれる場合に必須 | 同じ条件から発生有無・回数・同じ要求への帰属を判断できる。テスト実装や網羅的なケース集は持ち込まない |
82
+ | 未決事項と承認条件 | 未決事項がある場合に必須 | 関連する章に、未決の内容、利用への影響、決定者、確認担当、時期、記録先を置く。解消済み・承認済みと誤認させない |
51
83
 
52
- ## 3. メタデータ(Frontmatter)
84
+ ## 6. 記述ガイド
53
85
 
54
- Frontmatter は `docs/specdojo/schemas/v1/deliverable-frontmatter.schema.yaml` の制約に従います。
86
+ 共通の業務範囲・用語は上位一覧を参照し、各 BES では個別の差分だけを具体化します。完成例を本文へ埋め込まず、以下では判断を分ける短い例だけを示します。
55
87
 
56
- | 項目 | 説明 | 必須 |
57
- | ---- | --------------------------------- | ---- |
58
- | id | BES ID(例: `bes-sale-checkout`) | ○ |
88
+ ### 6.1. 導入
59
89
 
60
- | type | `requirement` 固定 | ○ |
61
- | title | 業務イベント名(例: 業務イベント: 会計確定(販売)) | ○ |
62
- | status | `draft`/`ready`/`deprecated` | ○ |
63
- | based_on | 根拠となる仕様ID(BEL/UIS/BPS 等) | 任意 |
64
- | supersedes | 置き換え関係(古仕様→新仕様) | 任意 |
90
+ - 判断基準: 読者が、何の混同を防ぎ、どこまでを判断できる定義か説明できるようにします。
91
+ - 良い例: 「入力途中を売上と混同しないため、店頭の現金会計の確定を定義する。成立・不成立の代表例から記録対象を判断できることを確認する。」
92
+ - 悪い例: 「システムの重要イベントを説明する。」対象も利用の判定基準も分かりません。
65
93
 
66
- ### 3.1 ID規約
94
+ ### 6.2. 何が起きたか
67
95
 
68
- - BES ID は `bes-...` の形式を推奨します(例: `bes-sale-checkout`)。
69
- - `type: requirement` は機能・業務イベントの要件であることを示します。
96
+ - 判断基準: 対象、一回の単位、隣接する出来事との境界を示します。適用未判定の業務を、確認済みの対象や恒久的な対象外にしません。
97
+ - 良い例: 「一取引の現金会計が確定した。明細追加と日次締めの確定は含めない。」
98
+ - 悪い例: 「会計処理をする。」出来事が成立したのか、処理手順なのかを判定できません。
70
99
 
71
- ## 4. 本文テンプレ(最小)
100
+ ### 6.3. いつ
72
101
 
73
- BES の責務は次に **限定** し、各項目を見出しとしてこの順序で記述します。
102
+ - 判断基準: 観測できる成立時点を選び、要求時や後処理の完了時と区別します。同時実行されることだけを根拠に、複数の事実を一つにしません。
103
+ - 良い例: 「店番担当が金額と受領を確認して会計を確定した時点。控えの印字完了は待たない。」
104
+ - 悪い例: 「会計時。」入力・確定・印字のどこかが分かりません。
74
105
 
75
- 1. 何が起きたか
76
- 2. いつ
77
- 3. 誰が/何が
78
- 4. 発生条件
79
- 5. 事実データ
106
+ ### 6.4. 誰が/何が
80
107
 
81
- 補足:
108
+ - 判断基準: 起点が複数なら、起点区分、要求者、成立させる主体、差異を表で並べます。承認者の責任は成立主体の責任と分けます。
109
+ - 良い例: 「店番担当が確定を要求し、販売管理システムが確定を記録する。業務定義の承認は人間の店主代表が担う。」
110
+ - 悪い例: 「担当またはシステム。」どちらが何をするか不明です。
82
111
 
83
- - 結果(出力/状態変化/通知)や例外、購読先、詳細手順は BES の責務外です。必要なら BPS(業務プロセス仕様)側で扱います。
84
- - イベントとプロセスは独立に保ち、起動関係は BPS(業務プロセス仕様)側で記載します。
112
+ ### 6.5. 発生条件
85
113
 
86
- ## 5. 禁止事項
87
-
88
- | 項目 | 理由 |
89
- | ------------------------------------------ | ---------------------- |
90
- | 物理テーブル名・物理カラム名・SQL全文 | 概念レベル逸脱 |
91
- | 実装クラス/関数名・APIの実装詳細 | 実装依存で変更に弱い |
92
- | UIコンポーネント名、クリック手順の逐語列挙 | UI変更に弱い |
93
- | BRのロジックを本文に重複記載 | 変更時に不整合が起きる |
94
-
95
- ## 6. サンプル(最小)
96
-
97
- ```markdown
98
- ---
99
-
100
- id: bes-sale-checkout
101
- type: requirement
102
- title: 業務イベント: 会計確定(販売)
103
- status: draft
104
- part_of: []
105
- based_on:
106
- - bel-sale
107
- - uis-sale
108
- supersedes: []
109
- ---
110
-
111
- ## 1. 何が起きたか
112
-
113
- - 販売の会計が確定した。
114
-
115
- ## 2. いつ
116
-
117
- - 会計確定操作の実行時。
118
-
119
- ## 3. 誰が/何が
120
-
121
- - 店員(人)。
122
-
123
- ## 4. 発生条件
124
-
125
- - 対象の取引が確定可能な状態である。
126
-
127
- ## 5. 事実データ
128
-
129
- - 取引ID
130
- - 明細(商品、数量、単価 等)
131
- - 支払情報(支払方法、受領金額 等)
132
- ```
114
+ - 判断基準: 成立条件と不成立条件を対にして示します。根拠にない適用範囲は未決のまま、確認担当・判断者・時期・記録先を具体化します。
115
+ - 良い例: 「受領金額が請求金額以上で、未確定の取引を確定した場合に発生する。金額確認だけでは発生しない。」
116
+ - 悪い例: 「会計可能なら発生する。」判定根拠がなく、発生しない境界も分かりません。
117
+
118
+ ### 6.6. 事実データ
119
+
120
+ - 判断基準: 項目、意味、必要になる条件を表で示します。相関は要求単位・取引単位・イベント単位を分け、正本との対応と確認例を添えます。物理項目名を推測して確定しません。
121
+ - 良い例: 「取引番号は確定対象を識別する。明細は同じ取引番号に属する。一括要求の識別が別に必要なら、その対応をデータモデルで確認する。」
122
+ - 悪い例: 「ID、明細など。」何の ID か、何を同じ単位とみなすか分かりません。
123
+
124
+ ## 7. 禁止事項
125
+
126
+ | 禁止する記述・扱い | 理由 |
127
+ | ----------------------------------------------------------------------------------- | ------------------------------------------------------ |
128
+ | 一覧にない適用範囲や未確認の担当を、合意済みとして追加する | 境界と承認責任を誤って確定するため |
129
+ | 着手・通知・後処理・例外回復の詳細手順を BES に展開する | プロセス仕様の責務と重複するため |
130
+ | BR の順位付け・計算式、状態遷移表を複製する | 正本の変更を追従できなくなるため |
131
+ | 物理テーブル・カラム、SQL、実装クラス・関数、詳細 API、CLI 構文を正本として記載する | 概念上の事実と実装契約を混同するため |
132
+ | 発生後にしか分からない最終件数・結果を、発生時点の確定データとする | 観測時点と事実が矛盾するため |
133
+ | 相関情報を実行 ID や時刻で代用できると、根拠なしに断定する | 複数イベントの同一要求への帰属を誤るため |
134
+ | 未決事項や承認未了を隠して完成・公開可能と表す | 下流が不確かな前提で設計・検証を始めるため |
135
+ | `deprecated` の BES を有効な BPS や新規文書から参照する | 廃止・非推奨のイベント契約に依存して処理破綻を招くため |
136
+ | BEL や BPS への波及影響・追従更新を確認せずに BES を改訂・廃止する | 業務プロセス間でのイベント受渡しの断絶を招くため |
@@ -3,148 +3,128 @@ specdojo:
3
3
  id: specdojo:br-rulebook
4
4
  type: rulebook
5
5
  deliverable_type: rule
6
- status: draft
7
- recipe: undecided
6
+ status: ready
7
+ target_format: markdown
8
+ recipe: specdojo:br-recipe
8
9
  sample: specdojo:br-sample
9
- template: undecided
10
+ template: specdojo:br-template
10
11
  ---
11
12
 
12
13
  # ビジネスルール 作成ルール
13
14
 
14
- Business Rule (BR) Documentation Rules
15
+ Business Rule Documentation Rulebook
15
16
 
16
- 本ドキュメントは、業務分析・要求定義のために **ビジネスルールを統一形式で記述する標準ルール**です。ビジネスルールは、複数の業務プロセス(BPS)から参照される横断的な判断・条件・計算ロジックを定義します。
17
+ 業務上の判断・制約・計算を、同じ入力から同じ結果を導ける仕様として記述するための規約です。業務担当者が妥当性を判断でき、実装とテスト設計へ引き継げる粒度を定めます。
17
18
 
18
19
  ## 1. 全体方針
19
20
 
20
- - 対象は「判断・条件・計算ロジック」であり、**概念レベルの入力条件+判定結果(または出力)** を明確化する。
21
- - 実装詳細(例: 物理テーブル名、SQL、UI操作、実装クラス/関数名)は記載しない(詳細は「9. 禁止事項」参照)。
22
- - 1ファイル = 1 ビジネスルール。複雑な場合はサブルールへ分解し、親子関係はサブルール側の `part_of` で表現する。
21
+ - 1 文書で一つの判断目的を扱い、適用条件、概念入力、判定、出力、例外を対応させる。
22
+ - 業務価値は上位文書から引き継ぎ、本書の判断が守る価値と適用境界だけを記す。共通事項は上位の index または標準を正本とする。
23
+ - 業務上の比較・計算の意味を定義し、設定値の列挙、構文、物理構造は対応する schema・リファレンスを参照する。実装コードを仕様の代替にしない。
24
+ - 未決事項は共通ラベルで確定事項と区別し、承認なしに既定値や欠損時の扱いを補わない。
23
25
 
24
- ## 2. 用語定義
26
+ ## 2. 位置づけ
25
27
 
26
- | 用語 | 定義 |
27
- | -------------- | -------------------------------------------------------------------- |
28
- | ビジネスルール | 業務上の判断・制約・計算ロジック。複数プロセスで共通に参照される定義 |
29
- | 入力 | ルールが参照する概念データ・前提条件 |
30
- | 判定 | 真偽またはカテゴリ分類の結果 |
31
- | 出力 | 計算値・カテゴリ・フラグなど、ルールの適用結果 |
32
- | 例外 | 入力不備・矛盾・外部参照失敗など |
28
+ BR は業務プロセスから呼び出される判断の正本である。BPS が適用する場面と手順を定め、BR がその時点の入力に対する結果を定める。画面操作、保存方法、実行制御、テスト手順はそれぞれの責務を持つ成果物へ委譲する。
33
29
 
34
- ## 3. ファイル命名・ID規則
35
-
36
- - ファイル名: `br-<番号>-<短い日本語名>.md` (例: `br-0010-在庫不足判定.md`)
37
- - Frontmatter:
38
- - `id`: `br-low-stock-judgment` のように小文字ハイフン形式。
39
- - `title`: 「在庫不足判定」など。
40
- - サブルールへ分割する場合: `br-low-stock-threshold`, `br-stock-reservation-deduction` などの id を付与し、サブルール側で `part_of: [br-low-stock-judgment]` を指定。
41
-
42
- ## 4. 推奨 Frontmatter 項目
43
-
44
- | 項目 | 説明 | 必須 |
45
- | ---- | ---- | ---- |
46
-
47
- | id | ルールID (br-xxx-xxxx) | ○ |
48
- | type | `rule` 固定 | ○ |
49
- | title | ルール名 | ○ |
50
- | status | `draft`/`ready`/`deprecated` | ○ |
51
- | part_of | 親ルールID(サブルールの場合) | 任意 |
52
- | based_on | 根拠となる仕様ID(BPS/UIS/BEL/BES 等) | 任意 |
53
- | supersedes | 置き換え関係(古仕様→新仕様) | 任意 |
30
+ 独立して承認・変更できる判断目的が複数ある場合は文書を分ける。同じ判断を完結させる入力検証・計算・例外は、条件数だけを理由に分割しない。
54
31
 
55
- ### NG/OK例(抜粋)
32
+ - **主要な関係者(Role code)と確認観点**:
33
+ - **BA(ビジネスアナリスト / 主作成者・問い合わせ対応)**: 業務上の判断目的・ルール・入出力・例外を記述し、改訂・廃止時の BPS への影響分析とルール解釈の問い合わせに対応する。
34
+ - **PO(プロダクトオーナー / 承認者)**: 業務判断の妥当性、ルールの置き換えおよび廃止(`deprecated` 移行)を最終判断・承認する。
35
+ - **ARC(アーキテクト / 確認者)**: システム制約、データモデル・外部スキーマとの整合性を確認する。
36
+ - **DEV(開発者 / 利用者)**: ルールを実現するロジック・関数の実装、型制約との対応を確認する。
37
+ - **QE(品質保証 / 確認者)**: 判定境界値の網羅性、検証可能性、業務受入条件(BAC)やテスト(UTC/ITC)への追従を確認する。
38
+ - **PM(プロジェクトマネージャー / 進行管理)**: 改訂・廃止に伴う関連成果物・実装・テストの更新タスク(PJR)を起票・管理する。
56
39
 
57
- - NG例: `type: api`(列挙外), `id: BR_LowStock`(大文字/アンダースコアNG), `extra: foo`(未定義プロパティNG)
58
- - OK例: `type: rule`, `id: br-low-stock-judgment`, `status: ready`
59
-
60
- ## 5. 本文構成(標準テンプレ)
40
+ ## 3. ファイル命名・ID規則
61
41
 
62
- 各 BR ファイルは以下見出しを順番に並べる。
42
+ - ファイル名は判断の意味を表す `br-<subject>.md` を推奨する。連番や特定プロジェクトの管理番号を必須にしない。
43
+ - 成果物の ID はプロジェクト内で一意にし、文書参照では `<project-id>:br-<subject>` のように project 修飾する。
44
+ - 配置は対象プロジェクトの成果物カタログに従う。ディレクトリと ID の共通規則は [[specdojo:docs-structure-guide|ドキュメント構造ガイド]] を正とする。
63
45
 
64
- 1. 概要
65
- 2. 入力
66
- 3. ルール(判定/計算)
67
- 4. 出力
68
- 5. 例外 / 異常系
69
- 6. メモ / 将来課題
46
+ ## 4. 推奨 Frontmatter 項目
70
47
 
71
- ## 6. 記述ガイド詳細
48
+ 共通項目・型・許可値は [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] と [成果物 Frontmatter schema](../../../specdojo/schemas/v1/deliverable-frontmatter.schema.yaml) を正本とする。
49
+
50
+ - `type` は業務の判断を表す `rule` とし、適用する主 rulebook を宣言する。
51
+ - `based_on` は判断の根拠となる先行成果物を示す。依存先が未作成の場合は本文にも未確認の範囲を残し、内容を確認済みと扱わない。
52
+ - `part_of` は親ルールへの所属がある場合だけ用いる。ルールの名称は H1 に置き、未承認の文書を `ready` にしない。
53
+ - `supersedes` は置き換え対象の旧 BR の ID 配列を指定する。判断規則の大幅な変更時に新 BR を作成して指定し、旧 BR は `status: deprecated` へ移行する。
54
+ - `status` は `draft` / `ready` / `deprecated` とする。作成・改訂中は `draft` とし、PO の承認を経て `ready` へ昇格する。廃止時は直接削除せず `deprecated` に移行して移行期間を設ける。
55
+ - **ライフサイクル操作と波及影響の追跡規則**:
56
+ - **更新・置き換え**: 判断規則の大幅改訂時は新 BR を作成し `supersedes` に旧 ID を設定する(PO 承認)。保守担当(BA)は BPS 側での参照更新案を作成する。
57
+ - **廃止**: 当該ビジネスルールが不要となった場合、`status: deprecated` に移行し、廃止理由と代替(無条件実行、別ルール等)を明記する(PO 承認)。`deprecated` の BR を有効な BPS や新規文書から参照してはならない。
58
+ - **問い合わせ対応**: ルールの解釈、例外発生時の扱い、境界値の妥当性に関する問い合わせ窓口は BA が担当し、仕様の曖昧さが見つかった場合は改訂またはメモ/将来課題へ記録する。
59
+ - **波及影響の識別・追従規則**:
60
+ BR の条件・出力変更時は、共通基準 [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] に従い、参照元となる BPS、実装、テストへの影響を追跡して同期更新する。
61
+ - **参照元業務プロセス仕様(BPS)**: BA は当該 BR を「活動・判断」で参照している全処理ステップを抽出し、入力項目の過不足、判定結果の分岐、完了条件の整合性を更新する。
62
+ - **実装コード**: DEV は当該 BR をロジックや計算式として実装している関数・ドメインモデルを特定し、追従修正を実施する。
63
+ - **テスト仕様・受入条件**: QE は当該 BR を検証する業務受入条件(BAC)、単体・結合テスト(UTC / ITC)の判定例・境界値を更新し、再検証を行う。
64
+ - **変更タスク管理**: PM は波及する関連文書・実装・テストの更新タスク(PJR 項目)を起票・追跡する。
65
+
66
+ ## 5. 本文要件
67
+
68
+ 内容要件は次のとおり。すべて必須とし、該当する例外や未決事項がなければ「なし」と明示する。見出し順・表・記入欄の骨組みは frontmatter で宣言した template を正本とする。
69
+
70
+ | 扱う内容 | 成立条件 |
71
+ | ------------------- | ------------------------------------------------------------------------------------------------------------------------ |
72
+ | 概要 | 判断の目的、利用者、適用する業務場面、前提、対象外が分かる |
73
+ | 入力 | 判定に使う全入力について概念項目、利用目的、適用条件、欠損時の扱いが分かる。派生ビュー等を使う経路も含む |
74
+ | ルール(判定/計算) | 適用順、条件、結果、境界値が対応する。複数条件の優先順位、同順位・欠損時の扱いを定め、代表的な判定例を置く |
75
+ | 出力 | 正常な結果の意味、単位または区分、利用先が分かる。「対象なし」と判定不能を区別する |
76
+ | 例外 / 異常系 | 状況、判定を続けるか、結果の有無、回復のために誰が何をするかが分かる |
77
+ | メモ / 将来課題 | 未決事項ごとに決定を依頼する相手、判断時点、下流への影響、必要な根拠を記す。未決事項がある場合は承認可能となる条件も示す |
78
+
79
+ ## 6. 記述ガイド
72
80
 
73
81
  ### 6.1. 概要
74
82
 
75
- 短い一文で、何を判断/計算するルールかを業務用語で記述する。
83
+ - 判断基準: どの業務場面のどの判断を引き受けるかが一意で、対象外の責務と重ならないこと。
84
+ - 良い例: 「在庫確認時に、販売可能数が発注点を下回るかを判定する。発注量と発注の承認は対象外とする」。
85
+ - 悪い例: 「在庫を適切に管理する」。判断結果と責務境界を特定できない。
76
86
 
77
87
  ### 6.2. 入力
78
88
 
79
- - 業務データ辞書のエンティティ・論理名を列挙し、利用目的を簡潔に付記。
80
- - 例: エンティティ:在庫、項目:在庫数・予約数、目的:不足判定の基準
81
- - 必要に応じて用語集の用語ID(tm-xxx-xxx)や外部 IF 仕様の ID を併記。
82
-
83
- - 入力は概念レベルで記述する(詳細は「9. 禁止事項」参照)。
89
+ - 判断基準: 条件式と例外が参照する情報を全件たどれ、任意入力・条件付き入力と必須入力を区別できること。
90
+ - 推奨列は「入力 / 概念データ・項目 / 利用目的 / 適用条件・欠損時の扱い」。数値は業務上の単位と比較時点を添える。値の形式や列挙の詳細は正本へ委譲する。
91
+ - 良い例: 「予約数は個数で受け取り、販売可能数の計算に使う。未設定なら判定不能とする」。
92
+ - 悪い例: 「在庫データ一式を参照する」。どの項目の欠損が結果に影響するか分からない。
84
93
 
85
94
  ### 6.3. ルール(判定/計算)
86
95
 
87
- - 箇条書きで条件式と意味をセットで記述する。
88
- - 数式や条件式は業務用語に沿って表現し、必要なら TypeScript 風の擬似コードで補足してもよい。
89
-
90
- 例:
91
-
92
- 1. 不足判定: `在庫数 − 予約数 < 発注点` → 真なら不足
93
- 2. 優先度分類: 定番商品は高優先、季節商品は中優先、その他は低優先
94
-
95
- 擬似コード例:
96
-
97
- ```ts
98
- type 商品 = { 商品ID: string; 定番: boolean; 発注点: number };
99
- type 在庫 = { 商品ID: string; 在庫数: number; 予約数: number };
100
-
101
- function 在庫不足判定(商品: 商品, 在庫: 在庫): boolean {
102
- return 在庫.在庫数 - 在庫.予約数 < 商品.発注点;
103
- }
104
- ```
96
+ - 判断基準: 同じ入力に対して複数の結果が生じないこと。比較対象の項目ごとに有無を定義し、既定値、同順位の決着、条件が重なる場合の優先順を明らかにする。
97
+ - 文字列で順位を決める場合は、照合方法の正本または決定済みの比較規則を示す。「辞書順」だけで言語・環境に依存する差を残さない。未決なら候補と影響をメモへ送る。
98
+ - 推奨する判定例の列は「例 / 入力・前提 / 適用規則 / 期待結果」。通常、境界、欠損、同順位のうち当該ルールに該当するケースを含める。
99
+ - 良い例: 「販売可能数と発注点が等しい場合は不足としない」。
100
+ - 悪い例: 「少なければ不足」。比較する量と等号の扱いが不明である。本文と同じ処理の擬似コードも重ねない。
105
101
 
106
102
  ### 6.4. 出力
107
103
 
108
- - 判定結果(真偽/カテゴリ/数値)を列挙。
109
- - 他プロセスが参照するための概念的な出力定義(例: 「不足フラグ」「優先度ランク」)。
104
+ - 判断基準: 利用者が結果の意味と次の業務への渡し方を判断でき、未計算を正常値と取り違えないこと。
105
+ - 良い例: 「不足判定は『不足 / 不足なし』。入力不備では判定値を返さず、不備項目を返す」。
106
+ - 悪い例: 「フラグを返す」。真偽の意味、判定不能時、利用先が分からない。
110
107
 
111
108
  ### 6.5. 例外 / 異常系
112
109
 
113
- - 入力欠損・値の矛盾(発注点 < 0 等)・外部参照失敗など。
114
- - 失敗時挙動(スキップ/再試行/警告ログ/オペ通知)を記述。
110
+ - 判断基準: 入力欠損、値の矛盾、外部参照の失敗など該当する状況を分け、正常な対象なしと区別すること。例外が重なる場合も扱いを決める。
111
+ - 推奨列は「ID / 状況 / 扱い / 利用者の次の手」。代替値や代替順位を使うなら、通常規則のどこを置き換えるかを特定する。
112
+ - 良い例: 「発注点が未設定なら判定を行わない。店主代表が発注点を登録した後に再判定する」。
113
+ - 悪い例: 「エラー時はログを出す」。業務が続くか、結果が有効かを判断できない。
115
114
 
116
115
  ### 6.6. メモ / 将来課題
117
116
 
118
- 既知の改善余地(閾値動的化、季節要因考慮など)。
119
-
120
- ## 7. 命名・記述スタイル
121
-
122
- - ルール名は「名詞+判断/計算」: 例 `在庫不足判定`, `発注優先度算定`。
123
- - 条件は簡潔に(禁止事項は「9. 禁止事項」参照)。
124
- - 数式は意味説明と併記し、業務用語で読み下せるようにする。
125
-
126
- ## 8. 階層分解ガイド
127
-
128
- | シグナル | サブルールへ分割検討 |
129
- | ---------------------- | -------------------- |
130
- | 条件が5種以上 | ルール別に分離 |
131
- | 出力が多種(>3) | 目的別再編 |
132
- | 複数ドメインに跨る参照 | 参照境界で分割 |
133
-
134
- 親子関係は、サブルール側で `part_of` を指定します(親ルール側に子を列挙しない)。
135
-
136
- ## 9. 禁止事項
137
-
138
- | 項目 | 理由 |
139
- | ------------------------ | -------------------- |
140
- | 物理テーブル名・SQL全文 | 概念レベル逸脱 |
141
- | 画面操作手順 | 概念レベル逸脱 |
142
- | 実装クラス・関数名の列挙 | 実装依存・メンテ不能 |
143
- | ビジネスルール重複記述 | 変更時不整合リスク |
144
- | 未定義略語乱用 | 用語集との整合欠如 |
117
+ - 判断基準: 作成済みの仕様で判断できる範囲と、承認前に解消すべき論点を区別できること。意思決定の未了は `_UNDECIDED_`、確認作業の不足は `_TODO_`、仮説は `_ASSUMPTION_` で示す。
118
+ - レポート引き継ぎ手順: 永続的なリスク、問題、変更要求、および決定事項は本文のラベルだけで放置せず、担当 Role code(BA / PM / ARC 等)と転送先レコード(PJR リスク登録簿 `pm-risk-register`、課題管理簿 `pm-issue-log`、変更要求ログ `pm-change-request-log`、決定記録 `pm-decision-log`、または PJR 登録項目)を明記し、PJR の共通管理手順に従って正式に起票・引き継ぎを行う。
119
+ - 良い例: 「`_UNDECIDED_`: 季節別の発注点を採用するか、店主代表へ判断を依頼する。導入承認前に決める(担当: BA、転送先: `pm-decision-log`)。未決の間は季節別判定の実装・受入条件を確定できない」。
120
+ - 悪い例: 「将来検討する」。依頼先、期限となる判断時点、下流の制約、引き継ぎ先レコードを追跡できない。
145
121
 
146
- ## 10. よくある誤りと対策
122
+ ## 7. 禁止事項
147
123
 
148
- - 複雑なロジックを長文で記述 → サブルールへ分割し参照。
149
- - 物理データ項目を記載 → 概念データ辞書の論理名に置換。
150
- - BPSの手順を流用 → 本ドキュメントでは判断・計算のみを記述。
124
+ - 業務プロセスの手順、画面操作、物理テーブル、SQL、実装クラスを BR の判断規則として持ち込まない。
125
+ - schema やリファレンスにある値・構文・構造の一覧を転記して別の正本を作らない。
126
+ - 複数の BR に同じ規則を複写しない。独立した判断は責務を分け、文書 ID で参照する。
127
+ - 不明な既定値、欠損時の順位、例外時の継続可否を推測で確定しない。未決事項を通常の判定例の期待値として扱わない。
128
+ - 未定義の略語や、根拠のない「適切に」「必要に応じて」で判定条件を代替しない。
129
+ - `deprecated` の BR を有効な BPS や新規文書から参照しない。
130
+ - 参照元 BPS、実装コード、テスト仕様への波及影響を確認・追従せずに BR を改訂または廃止しない。