specdojo 0.6.0 → 0.8.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (366) hide show
  1. package/.github/agents/specdojo-orchestrator.md +3 -2
  2. package/CHANGELOG.md +193 -0
  3. package/README.md +2 -2
  4. package/dist/catalog/build.js +24 -1
  5. package/dist/catalog/plan.js +1 -1
  6. package/dist/catalog/scaffold.js +4 -1
  7. package/dist/commands/agent.js +33 -0
  8. package/dist/commands/init.js +6 -1
  9. package/dist/commands/night-orchestrator.js +6 -4
  10. package/dist/commands/orchestrator.js +10 -1
  11. package/dist/dashboard/dashboard-timeline.js +18 -16
  12. package/dist/dashboard/dashboard.js +612 -259
  13. package/dist/dashboard/epic-plan.js +81 -0
  14. package/dist/dashboard/exec-records.js +16 -20
  15. package/dist/dashboard/routines.js +8 -6
  16. package/dist/dashboard/timeline-build.js +5 -9
  17. package/dist/dashboard/timeline.js +9 -4
  18. package/dist/devcontainer/command.js +18 -0
  19. package/dist/devcontainer/host-script.js +21 -0
  20. package/dist/devcontainer/scaffold.js +22 -3
  21. package/dist/docs/frontmatter-namespace.js +1 -48
  22. package/dist/docs/yaml-pages.js +125 -3
  23. package/dist/exec/agent-config.js +22 -0
  24. package/dist/exec/agent-plan.js +3 -2
  25. package/dist/exec/antigravity-session.js +154 -0
  26. package/dist/exec/commands.js +69 -21
  27. package/dist/exec/commit-hook-skips.js +78 -0
  28. package/dist/exec/core.js +19 -7
  29. package/dist/exec/events.js +159 -8
  30. package/dist/exec/evidence.js +64 -16
  31. package/dist/exec/handoff.js +9 -13
  32. package/dist/exec/limit.js +1 -1
  33. package/dist/exec/mechanical-result.js +45 -0
  34. package/dist/exec/migrate-records.js +249 -0
  35. package/dist/exec/parent-validation.js +160 -12
  36. package/dist/exec/pipeline-state.js +27 -5
  37. package/dist/exec/plan-markdownlint.js +89 -0
  38. package/dist/exec/plans-condense-findings.js +89 -0
  39. package/dist/exec/plans-core.js +24 -17
  40. package/dist/exec/plans-generation.js +52 -25
  41. package/dist/exec/plans-grade-findings.js +8 -3
  42. package/dist/exec/plans-kata-findings.js +61 -0
  43. package/dist/exec/plans-planning.js +3 -3
  44. package/dist/exec/plans-storage.js +12 -24
  45. package/dist/exec/register-resume.js +69 -42
  46. package/dist/exec/register.js +26 -22
  47. package/dist/exec/repo-integration-sync.js +8 -4
  48. package/dist/exec/repo-integration.js +21 -1
  49. package/dist/exec/reporter.js +121 -23
  50. package/dist/exec/results.js +85 -24
  51. package/dist/exec/review-completion.js +47 -0
  52. package/dist/exec/review-kata.js +109 -0
  53. package/dist/exec/run/agent-pipeline.js +75 -6
  54. package/dist/exec/run/agent.js +20 -7
  55. package/dist/exec/run/in-place.js +69 -32
  56. package/dist/exec/run/job.js +81 -24
  57. package/dist/exec/run/lifecycle-commands.js +264 -43
  58. package/dist/exec/run/mode-shared.js +11 -3
  59. package/dist/exec/run/register-command.js +12 -10
  60. package/dist/exec/run/register-core.js +20 -13
  61. package/dist/exec/run/register-mode.js +12 -12
  62. package/dist/exec/run/register-post-review.js +21 -9
  63. package/dist/exec/run/register-resume.js +28 -18
  64. package/dist/exec/run/register-state.js +10 -7
  65. package/dist/exec/run/register-worktree.js +60 -30
  66. package/dist/exec/run/schedule-mode.js +26 -6
  67. package/dist/exec/run/schedule-prepare.js +228 -45
  68. package/dist/exec/run/schedule-task.js +132 -25
  69. package/dist/exec/run/shared.js +4 -3
  70. package/dist/exec/run/trailing-records.js +35 -0
  71. package/dist/exec/run-records.js +2 -0
  72. package/dist/exec/strategy.js +1 -0
  73. package/dist/exec/trailing-records.js +242 -0
  74. package/dist/exec/trial-commands.js +3 -2
  75. package/dist/exec/validate-records-commit.js +110 -0
  76. package/dist/exec/validate-records.js +148 -0
  77. package/dist/exec/worktree-command.js +29 -16
  78. package/dist/exec/worktree-ops-commit.js +118 -59
  79. package/dist/exec/worktree-ops-lifecycle.js +77 -44
  80. package/dist/exec/worktree-ops-merge.js +13 -2
  81. package/dist/exec/worktree-ops.js +2 -2
  82. package/dist/exec/worktree.js +19 -2
  83. package/dist/grade/apply.js +32 -6
  84. package/dist/grade/command-inspect.js +2 -2
  85. package/dist/grade/command-run.js +2 -0
  86. package/dist/grade/command-shared.js +1 -1
  87. package/dist/grade/core.js +18 -5
  88. package/dist/grade/markdown.js +3 -3
  89. package/dist/grade/pipeline-state.js +15 -11
  90. package/dist/grade/plan.js +37 -17
  91. package/dist/grade/result.js +3 -3
  92. package/dist/grade/run.js +23 -3
  93. package/dist/grade/target-discovery.js +17 -4
  94. package/dist/grade/targets.js +12 -11
  95. package/dist/job/job.js +31 -17
  96. package/dist/job/noop.js +104 -0
  97. package/dist/register/core.js +2 -0
  98. package/dist/register/create-commands.js +28 -3
  99. package/dist/register/deliverable-target.js +9 -1
  100. package/dist/register/epic.js +104 -26
  101. package/dist/register/event-merge.js +3 -0
  102. package/dist/register/events.js +4 -0
  103. package/dist/register/external-project.js +3 -0
  104. package/dist/register/item.js +6 -0
  105. package/dist/register/maintenance-commands.js +4 -1
  106. package/dist/register/planning.js +7 -14
  107. package/dist/register/register.js +74 -32
  108. package/dist/register/track-domains.js +34 -0
  109. package/dist/register/track-plan.js +78 -0
  110. package/dist/register/transition-commands.js +8 -0
  111. package/dist/register/work-table.js +64 -0
  112. package/dist/review/grade.js +35 -13
  113. package/dist/routine/definition.js +4 -3
  114. package/dist/routine/failure.js +30 -0
  115. package/dist/routine/routine.js +56 -32
  116. package/dist/routine/storage.js +33 -0
  117. package/dist/schedule/schedule.js +1 -0
  118. package/dist/schedule/strategy-generate-document.js +26 -14
  119. package/dist/schedule/strategy-generate-scope.js +17 -45
  120. package/dist/schedule/strategy-generate.js +33 -3
  121. package/dist/schedule/strategy-profiles.js +86 -12
  122. package/dist/shared/agent-types.js +2 -0
  123. package/dist/shared/condense-records.js +25 -0
  124. package/dist/shared/deprecation.js +8 -0
  125. package/dist/shared/document-metadata.js +20 -0
  126. package/dist/shared/finding-cause.js +20 -0
  127. package/dist/shared/frontmatter-namespace.js +48 -0
  128. package/dist/shared/git.js +149 -15
  129. package/dist/shared/grade-result.js +17 -1
  130. package/dist/shared/local-state.js +20 -0
  131. package/dist/shared/markdownlint-config.js +8 -3
  132. package/dist/shared/plan-conventions.js +129 -0
  133. package/dist/shared/plan-templates.js +57 -41
  134. package/dist/shared/provider-scaffold.js +2 -0
  135. package/dist/shared/run-records.js +224 -0
  136. package/dist/shared/specdojo-config.js +39 -21
  137. package/dist/shared/specdojo-gitignore.js +1 -0
  138. package/dist/shared/text.js +65 -5
  139. package/dist/shared/timeline-index.js +2 -0
  140. package/docs/ja/specdojo/defaults/pm-review-viewpoints.yaml +11 -2
  141. package/docs/ja/specdojo/exec-templates/xep-common-conventions-template.md +4 -74
  142. package/docs/ja/specdojo/exec-templates/xep-condense-template.md +50 -0
  143. package/docs/ja/specdojo/exec-templates/xep-draft-template.md +17 -5
  144. package/docs/ja/specdojo/exec-templates/xep-fully-guided-template.md +16 -3
  145. package/docs/ja/specdojo/exec-templates/xep-recipe-guided-template.md +15 -5
  146. package/docs/ja/specdojo/exec-templates/xep-recipe-maintenance-template.md +6 -0
  147. package/docs/ja/specdojo/exec-templates/xep-register-template.md +1 -1
  148. package/docs/ja/specdojo/exec-templates/xep-rulebook-maintenance-template.md +6 -0
  149. package/docs/ja/specdojo/exec-templates/xep-sample-maintenance-template.md +6 -0
  150. package/docs/ja/specdojo/exec-templates/xep-template-maintenance-template.md +6 -0
  151. package/docs/ja/specdojo/exec-templates/xer-condense-template.md +25 -0
  152. package/docs/ja/specdojo/exec-templates/xp-common-conventions-template.md +50 -0
  153. package/docs/ja/specdojo/exec-templates/xrp-common-conventions-template.md +30 -0
  154. package/docs/ja/specdojo/guides/branch-workflow-guide.md +1 -1
  155. package/docs/ja/specdojo/guides/docs-editing-guide.md +48 -0
  156. package/docs/ja/specdojo/guides/docs-structure-guide.md +48 -15
  157. package/docs/ja/specdojo/guides/exec-config-guide.md +61 -28
  158. package/docs/ja/specdojo/guides/exec-operation-guide.md +61 -13
  159. package/docs/ja/specdojo/guides/exec-worktree-guide.md +20 -11
  160. package/docs/ja/specdojo/guides/orchestrator-operation-guide.md +4 -2
  161. package/docs/ja/specdojo/guides/plan-result-lifecycle-guide.md +92 -55
  162. package/docs/ja/specdojo/guides/project-move-guide.md +381 -0
  163. package/docs/ja/specdojo/guides/quick-start-guide.md +589 -807
  164. package/docs/ja/specdojo/guides/register-operation-guide.md +26 -4
  165. package/docs/ja/specdojo/guides/remote-host-development-guide.md +33 -4
  166. package/docs/ja/specdojo/guides/review-guide.md +22 -19
  167. package/docs/ja/specdojo/guides/routine-operation-guide.md +14 -8
  168. package/docs/ja/specdojo/guides/ryu-guide.md +23 -13
  169. package/docs/ja/specdojo/guides/schedule-design-guide.md +7 -4
  170. package/docs/ja/specdojo/guides/schedule-operation-guide.md +41 -3
  171. package/docs/ja/specdojo/guides/specdojo-overview-guide.md +5 -4
  172. package/docs/ja/specdojo/guides/timeline-design-guide.md +27 -144
  173. package/docs/ja/specdojo/guides/use-case-guide.md +471 -74
  174. package/docs/ja/specdojo/recipes/bac-recipe.md +94 -0
  175. package/docs/ja/specdojo/recipes/bes-recipe.md +105 -0
  176. package/docs/ja/specdojo/recipes/br-recipe.md +84 -0
  177. package/docs/ja/specdojo/recipes/cdfd-overview-recipe.md +88 -86
  178. package/docs/ja/specdojo/recipes/cdfd-uc-recipe.md +108 -122
  179. package/docs/ja/specdojo/recipes/cnd-recipe.md +125 -0
  180. package/docs/ja/specdojo/recipes/cpd-recipe.md +126 -0
  181. package/docs/ja/specdojo/recipes/cxd-recipe.md +145 -0
  182. package/docs/ja/specdojo/recipes/ifd-recipe.md +134 -0
  183. package/docs/ja/specdojo/recipes/ifx-cmd-recipe.md +135 -86
  184. package/docs/ja/specdojo/recipes/ifx-index-recipe.md +130 -0
  185. package/docs/ja/specdojo/recipes/pm-organization-recipe.md +29 -26
  186. package/docs/ja/specdojo/recipes/pm-plan-recipe.md +35 -26
  187. package/docs/ja/specdojo/recipes/pm-quality-management-plan-recipe.md +38 -28
  188. package/docs/ja/specdojo/recipes/pm-raci-recipe.md +39 -31
  189. package/docs/ja/specdojo/recipes/pm-roles-recipe.md +26 -28
  190. package/docs/ja/specdojo/recipes/prj-assumptions-constraints-dependencies-recipe.md +10 -8
  191. package/docs/ja/specdojo/recipes/prj-comparison-of-alternatives-recipe.md +18 -17
  192. package/docs/ja/specdojo/recipes/stsd-recipe.md +100 -62
  193. package/docs/ja/specdojo/recipes/sysd-critical-flows-recipe.md +106 -0
  194. package/docs/ja/specdojo/recipes/sysd-cross-cutting-policy-recipe.md +137 -0
  195. package/docs/ja/specdojo/recipes/sysd-index-recipe.md +122 -0
  196. package/docs/ja/specdojo/references/command-reference.md +146 -99
  197. package/docs/ja/specdojo/references/deliverables-reference.md +9 -4
  198. package/docs/ja/specdojo/references/directory-layout-reference.md +3 -2
  199. package/docs/ja/specdojo/references/specdojo-config-reference.md +17 -16
  200. package/docs/ja/specdojo/rulebooks/bac-rulebook.md +72 -290
  201. package/docs/ja/specdojo/rulebooks/bdd-rulebook.md +212 -79
  202. package/docs/ja/specdojo/rulebooks/bds-rulebook.md +138 -154
  203. package/docs/ja/specdojo/rulebooks/bes-index-rulebook.md +147 -59
  204. package/docs/ja/specdojo/rulebooks/bes-rulebook.md +100 -96
  205. package/docs/ja/specdojo/rulebooks/br-rulebook.md +88 -108
  206. package/docs/ja/specdojo/rulebooks/ccd-mermaid-rulebook.md +126 -211
  207. package/docs/ja/specdojo/rulebooks/cdfd-d2-rulebook.md +367 -0
  208. package/docs/ja/specdojo/rulebooks/cdfd-mermaid-rulebook.md +6 -5
  209. package/docs/ja/specdojo/rulebooks/cdfd-overview-rulebook.md +96 -100
  210. package/docs/ja/specdojo/rulebooks/cdfd-rulebook.md +38 -47
  211. package/docs/ja/specdojo/rulebooks/cdfd-uc-rulebook.md +132 -106
  212. package/docs/ja/specdojo/rulebooks/cdsd-rulebook.md +102 -68
  213. package/docs/ja/specdojo/rulebooks/cdt-rulebook.md +152 -0
  214. package/docs/ja/specdojo/rulebooks/cld-rulebook.md +9 -184
  215. package/docs/ja/specdojo/rulebooks/clis-rulebook.md +187 -0
  216. package/docs/ja/specdojo/rulebooks/cnd-rulebook.md +93 -247
  217. package/docs/ja/specdojo/rulebooks/cpd-rulebook.md +104 -241
  218. package/docs/ja/specdojo/rulebooks/cxd-rulebook.md +124 -257
  219. package/docs/ja/specdojo/rulebooks/dct-index-rulebook.md +87 -98
  220. package/docs/ja/specdojo/rulebooks/dct-rulebook.md +9 -7
  221. package/docs/ja/specdojo/rulebooks/dec-rulebook.md +2 -1
  222. package/docs/ja/specdojo/rulebooks/dss-rulebook.md +193 -0
  223. package/docs/ja/specdojo/rulebooks/gl-rulebook.md +100 -54
  224. package/docs/ja/specdojo/rulebooks/ifd-mermaid-rulebook.md +69 -252
  225. package/docs/ja/specdojo/rulebooks/ifx-cmd-rulebook.md +91 -76
  226. package/docs/ja/specdojo/rulebooks/ifx-file-rulebook.md +252 -226
  227. package/docs/ja/specdojo/rulebooks/ifx-index-rulebook.md +118 -40
  228. package/docs/ja/specdojo/rulebooks/imp-business-rulebook.md +11 -11
  229. package/docs/ja/specdojo/rulebooks/imp-data-rulebook.md +9 -9
  230. package/docs/ja/specdojo/rulebooks/imp-interface-rulebook.md +4 -4
  231. package/docs/ja/specdojo/rulebooks/imp-operations-rulebook.md +11 -11
  232. package/docs/ja/specdojo/rulebooks/imp-test-rulebook.md +11 -11
  233. package/docs/ja/specdojo/rulebooks/mm-rulebook.md +4 -3
  234. package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +34 -29
  235. package/docs/ja/specdojo/rulebooks/pm-change-request-log-rulebook.md +8 -8
  236. package/docs/ja/specdojo/rulebooks/pm-issue-log-rulebook.md +2 -2
  237. package/docs/ja/specdojo/rulebooks/pm-organization-rulebook.md +50 -56
  238. package/docs/ja/specdojo/rulebooks/pm-plan-rulebook.md +46 -55
  239. package/docs/ja/specdojo/rulebooks/pm-quality-management-plan-rulebook.md +57 -54
  240. package/docs/ja/specdojo/rulebooks/pm-raci-rulebook.md +50 -65
  241. package/docs/ja/specdojo/rulebooks/pm-risk-register-rulebook.md +2 -2
  242. package/docs/ja/specdojo/rulebooks/pm-roles-rulebook.md +70 -97
  243. package/docs/ja/specdojo/rulebooks/pr-rulebook.md +2 -1
  244. package/docs/ja/specdojo/rulebooks/prj-assumptions-constraints-dependencies-rulebook.md +47 -56
  245. package/docs/ja/specdojo/rulebooks/prj-comparison-of-alternatives-rulebook.md +61 -135
  246. package/docs/ja/specdojo/rulebooks/sf-index-rulebook.md +116 -32
  247. package/docs/ja/specdojo/rulebooks/sf-rulebook.md +118 -61
  248. package/docs/ja/specdojo/rulebooks/sld-rulebook.md +152 -57
  249. package/docs/ja/specdojo/rulebooks/stsd-mermaid-rulebook.md +51 -39
  250. package/docs/ja/specdojo/rulebooks/stsd-rulebook.md +101 -46
  251. package/docs/ja/specdojo/rulebooks/sysd-critical-flows-rulebook.md +72 -329
  252. package/docs/ja/specdojo/rulebooks/sysd-cross-cutting-policy-rulebook.md +74 -263
  253. package/docs/ja/specdojo/rulebooks/sysd-index-rulebook.md +78 -195
  254. package/docs/ja/specdojo/rulebooks/tml-rulebook.md +4 -9
  255. package/docs/ja/specdojo/rulebooks/trc-requirements-to-specs-rulebook.md +3 -4
  256. package/docs/ja/specdojo/rulebooks/trc-requirements-to-tests-rulebook.md +3 -3
  257. package/docs/ja/specdojo/rulebooks/uis-rulebook.md +140 -143
  258. package/docs/ja/specdojo/samples/bac-sample.md +106 -21
  259. package/docs/ja/specdojo/samples/bdd-sample.yaml +143 -35
  260. package/docs/ja/specdojo/samples/bds-sample.md +100 -21
  261. package/docs/ja/specdojo/samples/bes-index-sample.md +59 -20
  262. package/docs/ja/specdojo/samples/bes-sample.md +80 -21
  263. package/docs/ja/specdojo/samples/br-sample.md +68 -14
  264. package/docs/ja/specdojo/samples/ccd-sample.md +81 -19
  265. package/docs/ja/specdojo/samples/cdfd-overview-sample.md +248 -140
  266. package/docs/ja/specdojo/samples/cdfd-sample.md +172 -99
  267. package/docs/ja/specdojo/samples/cdfd-uc-sample.md +130 -97
  268. package/docs/ja/specdojo/samples/cdsd-sample.md +89 -20
  269. package/docs/ja/specdojo/samples/cdt-sample.md +116 -0
  270. package/docs/ja/specdojo/samples/cld-sample.md +3 -30
  271. package/docs/ja/specdojo/samples/clis-sample.md +132 -0
  272. package/docs/ja/specdojo/samples/cnd-sample.md +127 -21
  273. package/docs/ja/specdojo/samples/cpd-sample.md +136 -22
  274. package/docs/ja/specdojo/samples/cxd-sample.md +108 -22
  275. package/docs/ja/specdojo/samples/dct-index-sample.yaml +63 -17
  276. package/docs/ja/specdojo/samples/dss-sample.md +175 -0
  277. package/docs/ja/specdojo/samples/gl-sample.yaml +50 -14
  278. package/docs/ja/specdojo/samples/ifd-sample.md +105 -21
  279. package/docs/ja/specdojo/samples/ifx-cmd-sample.yaml +91 -60
  280. package/docs/ja/specdojo/samples/ifx-file-sample.md +462 -21
  281. package/docs/ja/specdojo/samples/ifx-index-sample.yaml +87 -19
  282. package/docs/ja/specdojo/samples/pm-members-sample.yaml +37 -13
  283. package/docs/ja/specdojo/samples/pm-organization-sample.md +52 -20
  284. package/docs/ja/specdojo/samples/pm-plan-sample.md +84 -26
  285. package/docs/ja/specdojo/samples/pm-quality-management-plan-sample.md +55 -22
  286. package/docs/ja/specdojo/samples/pm-raci-sample.md +69 -28
  287. package/docs/ja/specdojo/samples/pm-roles-sample.yaml +13 -12
  288. package/docs/ja/specdojo/samples/prj-assumptions-constraints-dependencies-sample.md +50 -26
  289. package/docs/ja/specdojo/samples/prj-comparison-of-alternatives-sample.md +89 -62
  290. package/docs/ja/specdojo/samples/sf-index-sample.md +89 -20
  291. package/docs/ja/specdojo/samples/sf-sample.md +121 -21
  292. package/docs/ja/specdojo/samples/sld-sample.md +107 -21
  293. package/docs/ja/specdojo/samples/stsd-sample.md +54 -26
  294. package/docs/ja/specdojo/samples/sysd-critical-flows-sample.md +166 -21
  295. package/docs/ja/specdojo/samples/sysd-cross-cutting-policy-sample.md +178 -21
  296. package/docs/ja/specdojo/samples/sysd-index-sample.md +82 -21
  297. package/docs/ja/specdojo/samples/tml-sample.yaml +4 -1
  298. package/docs/ja/specdojo/samples/uis-sample.md +164 -20
  299. package/docs/ja/specdojo/standards/document-metadata-standard.md +33 -4
  300. package/docs/ja/specdojo/standards/id-and-file-naming-standard.md +3 -1
  301. package/docs/ja/specdojo/standards/rulebook-authoring-standard.md +1 -0
  302. package/docs/ja/specdojo/templates/bac-template.md +76 -0
  303. package/docs/ja/specdojo/templates/bes-template.md +56 -0
  304. package/docs/ja/specdojo/templates/br-template.md +64 -0
  305. package/docs/ja/specdojo/templates/cdfd-overview-template.md +161 -83
  306. package/docs/ja/specdojo/templates/cdfd-template.md +81 -54
  307. package/docs/ja/specdojo/templates/cdfd-uc-template.md +130 -89
  308. package/docs/ja/specdojo/templates/cnd-template.md +137 -0
  309. package/docs/ja/specdojo/templates/cpd-template.md +129 -0
  310. package/docs/ja/specdojo/templates/cxd-template.md +105 -0
  311. package/docs/ja/specdojo/templates/dct-data-model-cdt-template.yaml +40 -0
  312. package/docs/ja/specdojo/templates/dct-data-model-cld-template.yaml +7 -14
  313. package/docs/ja/specdojo/templates/dct-index-template.md +9 -20
  314. package/docs/ja/specdojo/templates/dct-project-management-template.yaml +5 -1
  315. package/docs/ja/specdojo/templates/ifd-template.md +86 -0
  316. package/docs/ja/specdojo/templates/ifx-cmd-template.yaml +44 -28
  317. package/docs/ja/specdojo/templates/ifx-index-template.yaml +40 -0
  318. package/docs/ja/specdojo/templates/opr-template.md +2 -4
  319. package/docs/ja/specdojo/templates/pm-organization-template.md +9 -3
  320. package/docs/ja/specdojo/templates/pm-plan-template.md +4 -4
  321. package/docs/ja/specdojo/templates/pm-quality-management-plan-template.md +17 -9
  322. package/docs/ja/specdojo/templates/pm-raci-template.md +24 -13
  323. package/docs/ja/specdojo/templates/pm-roles-template.yaml +3 -2
  324. package/docs/ja/specdojo/templates/prj-assumptions-constraints-dependencies-template.md +6 -3
  325. package/docs/ja/specdojo/templates/prj-comparison-of-alternatives-template.md +22 -19
  326. package/docs/ja/specdojo/templates/stsd-template.md +46 -21
  327. package/docs/ja/specdojo/templates/sysd-critical-flows-template.md +94 -0
  328. package/docs/ja/specdojo/templates/sysd-cross-cutting-policy-template.md +122 -0
  329. package/docs/ja/specdojo/templates/sysd-index-template.md +89 -0
  330. package/docs/specdojo/lib/yaml-metadata.cjs +7 -0
  331. package/docs/specdojo/schemas/v1/bdd.schema.yaml +25 -57
  332. package/docs/specdojo/schemas/v1/condense-records.schema.yaml +26 -0
  333. package/docs/specdojo/schemas/v1/dct.schema.yaml +10 -0
  334. package/docs/specdojo/schemas/v1/deliverable-frontmatter.schema.yaml +3 -0
  335. package/docs/specdojo/schemas/v1/esil.schema.yaml +7 -141
  336. package/docs/specdojo/schemas/v1/exec-common.schema.yaml +3 -0
  337. package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +54 -3
  338. package/docs/specdojo/schemas/v1/exec-evidence.schema.yaml +3 -0
  339. package/docs/specdojo/schemas/v1/exec-plan-frontmatter.schema.yaml +14 -0
  340. package/docs/specdojo/schemas/v1/exec-result-frontmatter.schema.yaml +18 -0
  341. package/docs/specdojo/schemas/v1/finding-cause.schema.yaml +22 -0
  342. package/docs/specdojo/schemas/v1/grade-pipeline-state.schema.yaml +1 -1
  343. package/docs/specdojo/schemas/v1/grade-result.schema.yaml +2 -0
  344. package/docs/specdojo/schemas/v1/ifx-cmd.schema.yaml +65 -5
  345. package/docs/specdojo/schemas/v1/ifx-index.schema.yaml +142 -0
  346. package/docs/specdojo/schemas/v1/register-events.schema.yaml +2 -0
  347. package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +17 -1
  348. package/docs/specdojo/schemas/v1/specdojo-config.schema.yaml +1 -0
  349. package/package.json +6 -3
  350. package/templates/antigravity/README.md +19 -46
  351. package/templates/antigravity/exec-defaults-snippet.yaml +5 -6
  352. package/templates/antigravity/orchestrator.md +3 -2
  353. package/templates/antigravity/settings.edit.json +73 -0
  354. package/templates/antigravity/settings.orchestrator.json +15 -0
  355. package/templates/antigravity/settings.report.json +7 -0
  356. package/templates/antigravity/settings.review.json +7 -0
  357. package/templates/claude/agents/specdojo-orchestrator.md +3 -2
  358. package/templates/codex/agents/specdojo-orchestrator.toml +3 -2
  359. package/templates/codex/orchestrator.md +3 -2
  360. package/templates/devcontainer/remote-host/devcontainer-tmux.sh +217 -0
  361. package/templates/devcontainer/remote-host/specdojo-tmux.sh.sample +8 -96
  362. package/templates/devcontainer/remote-host/ssh-config.sample +3 -1
  363. package/templates/devcontainer/tmux.conf +6 -0
  364. package/templates/init-agent-members.yaml +1 -0
  365. package/templates/init-exec-defaults.yaml +1 -1
  366. package/templates/opencode/agents/specdojo-orchestrator.md +3 -2
@@ -3,92 +3,149 @@ specdojo:
3
3
  id: specdojo:sf-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: not-needed
8
9
  sample: specdojo:sf-sample
9
- template: undecided
10
+ template: not-needed
10
11
  ---
11
12
 
12
- # システム化機能一覧(System Function List, SFL)作成ルール
13
+ # システム化機能仕様 作成ルール
13
14
 
14
- 業務をシステムで実現するための機能(ユースケースや画面・バッチ単位など)を一覧化し、各機能の目的・入出力・関連プロセスを明確にします。
15
+ System Function Specification (SF) Documentation Rules
15
16
 
16
- ## 1. メタデータ
17
+ 業務要件を個別のシステム機能へ割り当て、設計・実装・受入判断に必要な目的、入出力、振る舞い、制約を定義するためのルールです。値・構文・データ構造の詳細は、それぞれの schema・リファレンス・ガイドを正本として参照します。
17
18
 
18
- | 項目 | 説明 | 必須 |
19
- | ---------- | ----------------------------- | ---- |
20
- | id | 機能一覧ID (sf-xxx-xxxx) | ○ |
21
- | type | `requirement` 固定 | ○ |
22
- | title | 機能一覧名 | ○ |
23
- | status | `draft`/`ready`/`deprecated` | ○ |
24
- | supersedes | 置き換え関係(古仕様→新仕様) | 任意 |
19
+ ## 1. 全体方針
25
20
 
26
- ### 1.1 ID規約
21
+ - 1 成果物で 1 個別機能を扱い、利用者の業務課題、期待価値、対象範囲・対象外から責務を定めます。主要な要件は上位目的または根拠仕様に対応付けます。
22
+ - 業務プロセス仕様(BPS)や利用接点の要件を、入力・処理・出力・例外・受入条件へつなぎます。画面を持たない CLI・自動実行の機能も対象です。
23
+ - システムとして保証する結果と責務境界を記述します。操作手順、内部実装、schema のフィールド定義や設定値一覧を複製しません。
24
+ - 全体の機能一覧・共通方針は上位の `sf-index` を正本とし、個別機能には差分と対応関係を記述します。プロジェクトの進捗・課題・変更判断は Schedule・プロジェクト登録簿(PJR)・レビュー記録へ接続します。
25
+ - 読者、確認者、公開範囲と人間の PO による最終承認責任を明示します。例や証跡に認証情報・個人情報・非公開データを含めません。
27
26
 
28
- - 機能一覧IDは正規表現 `^sf-[a-z0-9-]+$` に合致する一意IDを使用する。
27
+ ## 2. 位置づけ
29
28
 
30
- - `type: requirement` は機能・業務イベントの要件であることを示します。
29
+ - 一覧ハブには [[specdojo:sf-index-rulebook|システム化機能一覧 作成ルール]] を適用します。本書は一覧行を詳細化する個別機能を扱い、一覧全体の網羅性を重複して定義しません。
30
+ - 上流の BPS・ビジネスルール(BR)・業務イベント仕様(BES)から、機能が担当する業務ステップと判断の参照先を特定します。利用接点は画面仕様(UIS)、CLI 仕様(CLIS)、外部 I/F 仕様(IFX)などへ対応付けます。
31
+ - 下流のコンポーネント設計、データ設計、テスト仕様、運用手順は本仕様の要件を入力にします。変更時には入出力・状態・連携・受入条件を起点に影響先を識別します。
31
32
 
32
- ドキュメントID・機能IDともに `sf-` プレフィックスの `lower-kebab` 形式(正規表現: `^sf-[a-z0-9-]+$`)を使用します。
33
- 一覧ハブには `sf-index`、個別機能には `sf-<機能名>` を付与してください(例: `sf-product-register`)。
33
+ ## 3. ファイル命名・ID規則
34
34
 
35
- ## 2. 記述ルール
35
+ - ファイル名は `sf-<term>.md`、成果物 ID は `sf-<term>` とします。`<term>` は機能の業務的責務を表す英小文字・数字・ハイフンのスラッグとし、Unit 内で一意にします(例: `sf-task-execution`)。
36
+ - `sf-index.md` と ID `sf-index` は一覧ハブ用に予約します。個別機能の ID にプロジェクト ID、authority、実装クラス名、一時的な連番を付けません。
37
+ - 配置は成果物カタログの宣言を優先し、命名・管理境界の共通原則は [[specdojo:docs-structure-guide|ドキュメント構成ガイド]] に従います。責務を分割・統合するときは一覧と参照元の対応も確認します。
36
38
 
37
- - 機能一覧は **表形式** で整理する。1行が1機能を表す。
38
- - 機能名・概要は業務観点で記述し、実装技術や画面遷移手順など実装詳細は含めない。
39
- - 項目の表現は他仕様(BDD/CDSL/CCD/用語集)と整合性を保つ。
39
+ ## 4. 推奨 Frontmatter 項目
40
40
 
41
- ### 2.1 標準列の定義(必須順)
41
+ - 共通の必須・任意項目と ID・参照・状態の制約は [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] と `docs/specdojo/schemas/v1/deliverable-frontmatter.schema.yaml` に従います。項目の型や許可値を本書で再定義しません。
42
+ - 個別機能の `type` は `requirement`、`rulebook` は `specdojo:sf-rulebook` とします。文書名は H1 に置きます。
43
+ - `part_of` で一覧・親成果物、`based_on` で直接の根拠を表す場合は、実在する文書を参照し、カタログ上の先行依存と照合します。単に読んだ資料を根拠へ追加しません。
44
+ - 作成・改訂中は `status: draft` とします。静的検査の成功や作業タスクの完了だけで `ready` へ昇格せず、人間の PO が「完成判定と承認」の条件で判断します。
42
45
 
43
- | 列名 | 説明 |
44
- | ---------------- | ------------------------------------------------------------------------------- |
45
- | **機能ID** | 機能を識別するID(例: sf-product-register。`sf-` プレフィックスの lower-kebab) |
46
- | **機能名** | 業務担当が理解できる日本語名(簡潔) |
47
- | **概要** | 機能の目的/要約(何を実現するか) |
48
- | **入出力** | 主な入力と出力(データ種別や帳票、外部システムとのインターフェース) |
49
- | **関連プロセス** | 関連する業務領域(例:調達、販売、会計) |
50
- | **関連仕様ID** | 関連する他仕様の `id`(業務プロセス / 画面 / 帳票 等のファイルID) |
51
- | **備考** | 追加説明、依存関係、制約など |
46
+ ## 5. 本文要件
52
47
 
53
- ※ 列順は上記に統一してください。プロジェクト固有の列を追加する場合は、必須列を変えないこと。
48
+ 次の章を開始時の構成とし、各章の意味要件を満たします。内容に応じて処理や連携ごとの小節を設け、見出しには階層ごとの連番を付けます。
54
49
 
55
- ## 3. サンプル
50
+ | 章 | 章タイトル | 必須 | 目的と記載要件 |
51
+ | --- | -------------------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------- |
52
+ | 1 | 目的と概要 | ○ | 業務課題・期待価値と上位目的の関係、対象・対象外、利用者・読者、確認者と合意対象、公開範囲・承認責任を定義する |
53
+ | 2 | 業務プロセス・画面との対応 | ○ | BPS の処理ステップと機能の責務、UIS・CLIS・IFX・BES など該当する接点と受け渡しを対応付ける。接点がない場合も理由を示す |
54
+ | 3 | 入出力と前提条件 | ○ | 入出力の論理情報、入手元・提供先、必須となる条件、契約の正本、着手条件と正常・異常終了時の事後条件を定義する |
55
+ | 4 | 処理要件・機能振る舞い | ○ | 開始条件、処理の責務、確定する結果、BR・状態定義(STSD)の参照、例外時の通知・保持・回復条件を定義する |
56
+ | 5 | 非機能・技術制約 | ○ | 該当する性能・可用性・権限・秘匿・外部依存・互換性の制約と適用範囲を示す。値・構造・版の正本を特定し、未確定事項を分離する |
57
+ | 6 | 操作手順・コマンド参照 | ○ | 操作・設定・障害回復の参照先と参照目的を示す。運用上の問い合わせ・エスカレーション先をロールと参照文書で特定する |
58
+ | 7 | 検証・受入観点 | ○ | 要件と対応する正常・異常・境界条件、観測できる期待結果、検証方法・確認ロールを示し、第三者が合否を判断できるようにする |
59
+ | 8 | 未決事項 | 条件付き | 未決・仮定・調査事項がある場合に論点、影響、担当・判断者、期限または判断時点、次アクション、追跡先、承認を保留する条件を示す |
56
60
 
57
- ### 3.1 メタデータ(front-matter YAML)
61
+ ## 6. 記述ガイド
58
62
 
59
- ```yaml
60
- ---
61
- id: sf-index
62
- type: requirement
63
- title: システム化機能一覧(main)
64
- status: draft
63
+ 共通事項は上位の一覧・根拠仕様を参照し、各章にはその機能の判断に必要な情報を残します。実在する文書へのリンクは `[[id|title]]`、表のセル内は `[[id\|title]]` とし、未作成の参照先は ID をインラインコードで仮置きします。以下の良い例・悪い例は判断の差を示す断片です。
65
64
 
66
- supersedes: []
65
+ ### 6.1. 目的と概要
67
66
 
68
- ---
69
- ```
67
+ - 「誰のどの課題を、どの成果によって改善するか」を示し、上位目的や要求の参照先を添えます。成功を確認する観点は「検証・受入観点」に対応付けます。
68
+ - 対象と対象外を対にして示し、他機能・人の判断へ引き渡す境界を明記します。利用者、設計・検証に使う読者、公開対象を区別します。
69
+ - 確認者と合意対象を明記します。例として BA は業務対応、ARC・DEV は設計入力、QE は受入可能性、PO はスコープと公開可否を確認します。ロールと担当者はプロジェクトの組織・メンバー定義を参照し、個人の連絡先を複製しません。
70
+ - 良い例: 「PM が停止理由と保存済み成果を確認して再開を判断できる。実行結果の記録までを担当し、業務上の完了承認は PO に引き渡す」。
71
+ - 悪い例: 「agent を起動する機能である」。起動という手段だけで、解決する課題と責務境界を判断できません。
72
+
73
+ ### 6.2. 業務プロセス・画面との対応
74
+
75
+ - BPS の処理ステップから本機能の入出力・処理要件まで追えるようにします。画面のない機能では CLI やイベントなど実際の起動接点を示し、架空の UIS を要求しません。
76
+ - 上流仕様が未作成なら、確認済みのカタログ等の根拠と暫定範囲を示します。詳細ステップ ID を創作せず、照合担当と判断時点を「未決事項」へ残します。
77
+ - 対応表は「根拠仕様・ステップ」「本機能の責務」「対応要件・入出力」を基本列とし、連携には「接点」「トリガー・受け渡し」「責務境界」を加えます。
78
+ - 良い例: 「検証ステップで結果を受け取り、失敗を記録して統合を止める。検証コマンドの契約は対応するリファレンスを参照する」。
79
+ - 悪い例: 「BPS と対応する」。どのステップの何を担うか不明です。
80
+
81
+ ### 6.3. 入出力と前提条件
82
+
83
+ - データは業務論理名で示し、BDD・CDT・BES・IFX・schema 等の正本を特定します。実装上の変数・内部構造の一覧は書きません。
84
+ - 前提条件、正常時の確定結果、失敗時に保持・変更しない情報を区別します。経路や実行方式で条件が異なる場合は、その適用範囲を付けます。
85
+ - 良い例: 「状態追跡する実行では完了状態を記録する。追跡しない単発実行では状態を変更しない」。
86
+ - 悪い例: 「成功したら常にタスクを完了にする」。追跡しない経路にも事後条件を広げています。
87
+
88
+ 推奨する入出力表の列と記入断片:
89
+
90
+ | 区分 | 情報 | 入手元 / 提供先 | 必須性・確定条件 | 正本仕様 | 対応要件 |
91
+ | ---- | ------------------------ | ------------------- | ---------------- | ----------------------------- | -------------- |
92
+ | 入力 | 保存済みの成果と停止理由 | 実行記録 / 再開処理 | 再開時に必須 | 記録契約の文書・schema を指定 | 再開の前提条件 |
93
+
94
+ ### 6.4. 処理要件・機能振る舞い
95
+
96
+ - 開始条件、処理責務、観測できる結果をひとまとまりにします。処理を識別できる見出しや要件 ID を使い、設計・テストへ割り当てられる単位に分けます。
97
+ - 業務判断は BR、状態・遷移は STSD を参照し、機能がその判断結果をどう利用するかを書きます。処理成功、作業完了、人間の受入承認を区別します。
98
+ - 異常系は「条件」「通知と保持する情報」「回復・再開条件」で整理し、外部サービスの失敗を成功扱いにしません。
99
+ - 良い例: 「検証失敗時は失敗結果を残し、未検証の成果を統合しない。修正後の再検証成功を統合条件とする」。
100
+ - 悪い例: 「問題があれば適切に復旧する」。停止位置、保持情報、復旧条件がありません。
101
+
102
+ ### 6.5. 非機能・技術制約
103
+
104
+ - 制約の対象、適用経路、根拠、判定方法を示します。性能・同時実行・タイムアウト等の値は設定・契約の正本へ委ね、上書き・省略・適用外の場合も判定できるようにします。
105
+ - 連携先と利用側の責務、障害時の扱い、権限と秘匿要件を示します。公開データ契約がある場合は、論理契約・schema・版管理の正本と互換性の確認先を特定し、既存契約にない互換動作を断定しません。
106
+ - 現行動作と要求する変更を区別します。既存動作と異なる制約を採用する場合は、変更判断・下流影響を PJR 等へ接続し、未承認の値を既定値として書きません。
107
+ - 良い例: 「上限が適用される経路では有効設定値の超過時に停止理由を残す。上限省略時と対象外の経路は設定ガイドの契約で判定する」。
108
+ - 悪い例: 「すべての経路で上限は 1」。正本・対象・設定による差を示さない固定値です。
109
+
110
+ ### 6.6. 操作手順・コマンド参照
111
+
112
+ - 「参照先」「種類」「参照目的」を列にして、利用開始・設定・障害回復に必要な文書を案内します。該当する操作がない場合は、その理由と運用上の確認先を示します。
113
+ - 障害時に誰が一次対応し、どの条件でどのロールへ引き渡すかを定めます。手順と連絡先の詳細は運用手順・組織定義へ委ねます。
114
+ - 良い例: 「再開判断は実行担当が運用ガイドで確認する。契約や保護設定の変更が必要なら PM・ARC へ引き渡す」。
115
+ - 悪い例: 「困ったら担当者に連絡する」。担当ロールと参照導線が特定できません。
70
116
 
71
- ### 3.2 機能一覧(表)
117
+ ### 6.7. 検証・受入観点
72
118
 
73
- | 機能ID | 機能名 | 概要 | 入出力 | 関連プロセス | 関連仕様ID | 備考 |
74
- | ------------------- | -------- | ---------------------------------------------- | ------------------------------------------- | ------------ | -------------------------- | ---- |
75
- | sf-product-register | 商品登録 | 新しい商品を登録し、在庫管理テーブルを作成する | 入: 商品マスタ情報 / 出: 商品ID | 管理、販売 | bps-product, uis-admin | |
76
- | sf-closing-daily | レジ締め | 当日の売上を集計し日次レポートを生成する | 入: 売上トランザクション / 出: 日次レポート | 会計 | bps-closing, rpt-daily-sum | |
119
+ - 各主要要件に正常系、入力不成立、外部障害、境界条件を対応付けます。該当しない観点は理由を示します。成功基準は利用者が得る成果や失敗時の保護にも結び付けます。
120
+ - 表は「観点 ID」「対象要件」「対象条件」「観測する期待結果」「検証方法・証跡」「確認ロール」を基本列とします。条件と結果は yes / no で判定できる表現にします。
121
+ - 制約値は正本の有効値を使い、上書き・省略・適用外の条件を区別します。計測や実機確認が必要な場合は、その方法と担当を示し、未実施を合格扱いにしません。
122
+ - 良い例: 「検証が失敗した場合、失敗出力が証跡に残り、統合記録と完了記録が作られないことを QE が実行記録で確認する」。
123
+ - 悪い例: 「正常・異常とも正しく動作する」。観測する情報と合否境界がありません。
77
124
 
78
- ## 4. 本文構成(標準テンプレ)
125
+ ### 6.8. 未決事項と変更影響
79
126
 
80
- | 番号 | 見出し | 必須 |
81
- | ---- | -------- | ---- |
82
- | 1 | 機能一覧 | ○ |
127
+ - `_TODO_`・`_UNDECIDED_`・`_ASSUMPTION_` の使い分けはドキュメントメタ情報標準に従います。論点ごとに影響先、担当・判断者の Role code、期限または判断時点、次アクション、追跡先、承認への影響を記録します。
128
+ - 要件変更時は、変更する入出力・状態・接点・制約・受入条件から、上流仕様、UI・DB・コンポーネント設計、schema・生成処理・コマンド、テスト、運用手順の該当する影響先を特定します。互換性、依存する作業の着手可否、再確認が必要な条件も示します。
129
+ - 機能別の作業単位と完了条件は要件・受入観点からカタログへ、担当・順序・期限やマイルストーンは Schedule へ接続します。進捗は実行結果、課題・リスク・変更要求・決定は PJR 等へ分け、PM に追跡・計画見直しを引き渡します。機能仕様には恒久的な要件と追跡参照を残し、管理台帳を複製しません。
130
+ - 良い例: 「上流 BPS 作成時に BA が処理ステップ対応を照合し、ARC が設計境界への影響を確認する。PM が追跡先を管理し、対応の合意までは PO の承認を保留する」。
131
+ - 悪い例: 「詳細は後で決める」。判断者・影響・次の行動がありません。
83
132
 
84
- ## 5. 記述ガイド
133
+ ### 6.9. 完成判定と承認
85
134
 
86
- - 機能IDは `sf-` プレフィックスで一意に管理する。
87
- - 関連仕様IDはID文字列で記載し、リンク可能性を維持する。
88
- - 入出力は業務視点で簡潔に記載する。
135
+ - 文書検査では、利用リポジトリの package・hook 設定と実行規約から適用コマンドを確認します。Markdown 整形、Markdown lint、Frontmatter・参照の検査について、対象ファイル、実行コマンド、結果を実行記録に残します。SpecDojo 同梱リポジトリでは `lint:md`・`lint:fm` 等の設定を参照します。適用検査がすべてエラーなく終了することを合格条件とし、失敗は修正後に再確認します。これは機能の受入試験の代わりにはなりません。
136
+ - 内容の完成条件は、必須章と参照が成立し、主要要件に受入条件が対応し、カタログの `done_criteria` を担当ロールが確認できることです。上流未作成や契約不一致を、形式検査の成功だけで充足扱いにしません。
137
+ - BA・ARC・DEV・QE 等の該当する確認者は合意対象と未充足条件をレビュー記録へ残します。スコープ・受入値・公開可否に影響する未決事項や未解決指摘があれば、PO は承認を保留または差し戻します。承認対象外として切り出す場合も、その境界と後続作業の追跡先を明示します。
138
+ - 人間の PO は公開対象、非公開情報の除外、確認結果と未決事項の扱いを確認し、承認・保留・差し戻しの判断を記録します。仕様の `ready`、作業タスクの完了、製品リリースの判断はそれぞれの管理規約に従います。
139
+ - 良い例: 「文書検査は合格したが、上流との照合と資源制約の合意が残るため `draft` を維持し、BA・ARC・QE の確認後に PO が承認する」。
140
+ - 悪い例: 「lint が通ったので公開・リリース可能」。内容の合意と人間の最終判断を検査で置き換えています。
89
141
 
90
- ## 6. 禁止事項
142
+ ## 7. 禁止事項
91
143
 
92
- - 実装クラス名、SQL、内部設計の詳細を記載しない。
93
- - 関連仕様IDを空欄で確定しない。
94
- - 用語不整合のまま登録しない。
144
+ - 一覧ハブと個別機能の責務を混同し、機能一覧表だけで個別仕様を終えない。
145
+ - コマンド構文・引数・オプション一覧・対話手順・画面操作手順を再掲しない。
146
+ - schema の項目一覧、実装クラス・メソッド・内部構造、SQL、物理テーブル定義を転記しない。
147
+ - BPS の全手順、BR の判定ロジック、UIS のレイアウトを複製しない。
148
+ - 未作成の参照先や未合意の値・互換性方針を確定事項として扱わない。
149
+ - 適用範囲のない事後条件や「適切に」「正しく」だけの合否基準を置かない。
150
+ - 進捗台帳・レビュー履歴・個人の連絡先・秘密情報を本文で管理しない。
151
+ - agent が `ready` 昇格や公開・リリースの最終承認を代行しない。
@@ -3,92 +3,187 @@ specdojo:
3
3
  id: specdojo:sld-rulebook
4
4
  type: rulebook
5
5
  deliverable_type: data
6
- status: draft
7
- recipe: undecided
6
+ status: ready
7
+ target_format: markdown
8
+ recipe: not-needed
8
9
  sample: specdojo:sld-sample
9
- template: undecided
10
+ template: not-needed
11
+ based_on:
12
+ - specdojo:rulebook-authoring-standard
10
13
  ---
11
14
 
12
- # 保管場所一覧 (Storage Locations List)作成ルール
15
+ # 保管場所一覧(SLD)作成ルール
16
+
17
+ Storage Location Definition (SLD) Documentation Rules
18
+
19
+ 業務で扱う現物・紙帳票・電子データ・実行時ファイルが置かれる物理的または論理的な保管場所について、置くもの・共有の有無・寿命・消してよいか(削除・処分の可否と条件)を定義する基準を定めます。
20
+ BA・OPS が日常運用の保管・清掃・処分の判断境界を合意し、ARC・DEV が概念データストアや実装上の配置先と整合させ、QE が欠落・矛盾を検証できる一覧を作ります。
13
21
 
14
- 業務で管理する物理的・論理的な保管場所を一覧で定義します。各保管場所の主な保管対象・目的・関連プロセス・管理頻度などを明記し、在庫や現金などの流れ・管理単位を明確にします。
22
+ ## 1. 全体方針
15
23
 
16
- ## 1. メタデータ
24
+ - **目的と適用範囲**: 業務分析・システム設計・運用設計で参照する `sld-*.md` を対象とします。店舗・倉庫の棚や金庫、紙台帳の保管場所、リポジトリ内のディレクトリ、端末ローカルの状態領域、作業用 worktree、一時ディレクトリなど、人が「どこに何が置かれ、共有されるか、いつまで残し、消してよいか」を判断する必要がある保管場所を網羅します。
25
+ - **正本参照と責務境界**: 概念上のデータ管理単位・正本区分・更新責務は概念データストア定義(CDSD)、データ項目の構造・型・許容値は業務データ辞書(BDD)や schema、ディレクトリ構造や CLI の詳細仕様はリファレンス・実装を正本として参照します。SLD はそれらを「場所ごとの保管物・共有範囲・寿命・削除可否」の観点で横断的に整理し、正本の詳細構造を再掲しません。
26
+ - **記載レベル**: 一覧の1行は、共有範囲・寿命・削除可否の判断が同一となる保管場所の区分とします。個々のファイル名や一時変数をすべて列挙せず、運用者や開発者が誤削除や放置を防げる粒度でまとめます。
27
+ - **実践の型の構成**: SLD は標準6列と5章構成が本 rulebook で明確に定まり、見出しの骨組みを別ファイルで管理する効果が薄く二重管理になるため、`recipe` および `template` は `not-needed` とします。完成例は sample へ外出しし、rulebook 本文には完成例を埋め込みません。改訂時は rulebook・sample・成果物(`sld-*`)の章構成・標準6列・見出し連番の一致を確認します。
28
+ - **確定とライフサイクル**: 新規作成・改訂時は `status: draft` で作成し、BA・OPS が保管運用の妥当性、ARC・DEV が CDSD および実装配置との一致、QE が受入条件の検証可能性を確認します。静的検証を通過した後、`status: ready` への昇格および廃止・置換は人間の PO が最終承認します。agent による `status: ready` への変更は禁止します。
17
29
 
18
- | 項目 | 説明 | 必須 |
19
- | ---- | ----------------------------- | ---- |
20
- | id | 保管場所一覧ID (sll-xxx-xxxx) | ○ |
21
- | type | `data` 固定 | ○ |
30
+ ### 1.1. 対象者と確認する内容
22
31
 
23
- | title | 保管場所一覧名 | ○ |
24
- | status | `draft`/`ready`/`deprecated` | ○ |
25
- | supersedes | 置き換え関係(古仕様→新仕様) | 任意 |
32
+ | Role code | 作成・確認・利用の責務 |
33
+ | --------- | -------------------------------------------------------------------------------------------------------------------------- |
34
+ | ARC | 保管場所の区分がシステム構成・ディレクトリ配置・外部依存・ロックや分離機構の実装と一致しているかを確認する |
35
+ | BA | 概念データストア(CDSD)や業務プロセスで扱う記録・現物が漏れなく保管場所に対応付けられ、業務上の保持要件を満たすか確認する |
36
+ | OPS | 日常運用・障害復旧・容量逼迫時に、消してよい場所と残すべき場所、削除前確認条件と再生成手順を迷わず判断できるか確認する |
37
+ | DEV | 実装が参照・出力するパス解決ロジック、`.gitignore` 等の共有制御、一時領域やロックの扱いと矛盾がないか確認する |
38
+ | QE | 標準列の網羅性、CDSD・実装との対応、削除可否の条件と復旧手段の検証可能性を照合する |
39
+ | PM | 未決の保管方針・保持期間や移行作業の担当・判断時期を計画へ接続し、課題・リスク・変更要求・決定事項を管理台帳へつなぐ |
40
+ | PO | 保管・共有・保持・処分の業務方針と公開範囲を最終合意し、人間の判断として `status: ready` への昇格や改廃を承認する |
26
41
 
27
- ### 1.1 ID規約
42
+ 成果物内で「店主代表」「店番担当」「運用管理者」などの業務呼称を使う場合は、適用先の組織定義の `Role code` に対応付けます。
28
43
 
29
- - 保管場所一覧IDは正規表現 `^sll-[a-z0-9-]+$` に合致する一意IDを用いる。
30
- - `type: data` は業務ドメイン仕様であることを示す。
44
+ ## 2. 位置づけと用語定義
31
45
 
32
- ## 2. 記述ルール
46
+ SLD は、概念データストア定義(CDSD)が定義する「管理単位と更新責務」および業務プロセス仕様が定義する「業務の流れ」を受け、それらが実際にどの物理的・論理的領域に配置され、どう共有・保持・処分されるかを定義します。成果物カタログ種別([[specdojo:deliverables-reference|成果物リファレンス]])における種別名は「保管場所定義(`sld`)」であり、個別文書のタイトルおよび本文では「保管場所一覧」と呼称します。
33
47
 
34
- - 保管場所の一覧を **表形式** で整理する。
35
- - 保管場所名は **日本語単数形** を使用する(例:レジ、金庫、売り場棚)。
36
- - 内容を曖昧な記述にせず、簡潔かつ明確に記載する。
37
- - 仕様間(BDD/CDSL/CCD/glossary)で名称の整合性を保つ。
48
+ ```mermaid
49
+ graph TD
50
+ BPS["業務プロセス・データフロー (BPS / CDFD)"] -->|"入出力・発生契機"| SLD["保管場所一覧 (SLD)"]
51
+ CDSD["概念データストア定義 (CDSD)"] -->|"管理単位・正本区分・更新責務"| SLD
52
+ BDD["業務データ辞書 (BDD)"] -->|"記録・現物の識別と意味"| SLD
53
+ SLD -->|"削除・退避・清掃の判断基準"| OPR["業務運用・保守運用 (OPR)"]
54
+ SLD -.->|"配置先・共有制御の整合確認"| IMPL["実装の配置定義・ディレクトリリファレンス"]
55
+ ```
38
56
 
39
- ### 2.1 標準列の定義
57
+ | 用語 | 定義 |
58
+ | ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
59
+ | 保管場所 | 現物・紙媒体・電子ファイル・ディレクトリが置かれる物理的または論理的な区画。共有範囲・寿命・削除可否の判断単位で区分する |
60
+ | 置くもの | その保管場所に格納される現物、帳票、設定、履歴、派生生成物、ロック、一時ファイル等の対象物。対応する概念データストアや代表パスパターンを併記する |
61
+ | 共有の有無 | 複数人・複数端末・Git リポジトリ等で共有されるか、端末ローカル・作業ブランチ固有・個人手元にとどまるかの区分と共有手段 |
62
+ | 寿命・管理頻度 | 置かれたものが存在する期間(恒久保持、タスク実行中のみ、プロセス稼働中のみ、日次・月次サイクル等)および棚卸・清掃・ローテーションの周期 |
63
+ | 削除・処分の可否と条件 | 運用者や開発者がその場所の中身を消してよいかの区分(`削除不可` / `条件付き削除可` / `削除可`)と、削除前に確認すべき条件・削除後の復旧または影響 |
40
64
 
41
- | 列名 | 説明 |
65
+ メタ情報・改訂と廃止の扱いは [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]]、リポジトリ内の文書配置は [[specdojo:docs-structure-guide|ドキュメント構成ガイド]] に従います。
42
66
 
43
- | ------------------ | ----------------------------------------------------------------- |
44
- | **保管場所** | 場所の論理名(日本語単数形) |
45
- | **主な保管対象** | 主に保管する対象(商品在庫、現金など) |
46
- | **主な内容・目的** | 管理目的や作業内容(名詞句中心で簡潔に) |
67
+ ## 3. ファイル命名・ID規則
47
68
 
48
- | **関連プロセス** | 関連する業務領域(例:調達、販売、会計)※複数の場合は「、」区切り |
49
- | **管理頻度** | 更新・確認の頻度(例:日次、随時、納品時・補充時) |
69
+ - **ファイル名**: `sld-<term>.md` とし、`<term>` は対象システム・業務領域を表す英小文字の kebab-case とします(例: `sld-specdojo.md`、`sld-inventory.md`)。
70
+ - **文書 ID**: プロダクト仕様の成果物は `sld-<term>`、プロジェクト固有の成果物は `<project-id>:sld-<term>` とし、成果物カタログの宣言と一致させます。新規作成・改訂では `sld-` プレフィックスを使用し、旧来の `sll-` プレフィックスを新規に採番しません(既存の未作成予定 ID として他文書で言及されている場合のみ、移行関係を明記して対応付けます)。
71
+ - **文書タイトル(H1)**: `# 保管場所一覧(<対象領域または対象システム>)` とします。
50
72
 
51
- ※ 列順は **保管場所 → 主な保管対象 → 主な内容・目的 → 関連プロセス → 管理頻度** に統一する。
73
+ ## 4. 推奨 Frontmatter 項目
52
74
 
53
- ## 3. サンプル
75
+ 許可キー・必須項目・型制約は [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] および `docs/specdojo/schemas/v1/deliverable-frontmatter.schema.yaml` を正本とします。
54
76
 
55
- ### 3.1 メタデータ(front-matter YAML)
77
+ - `specdojo.type` は `data`、`specdojo.rulebook` は `specdojo:sld-rulebook` とします。
78
+ - `specdojo.status` は新規作成・agent 編集時は `draft` とします。
79
+ - `specdojo.based_on` には実際に読んで直接の根拠とした作成済み文書(対応する `cdsd-*` 等)の ID を記載します。成果物カタログに `depends_on` がある場合はその推移閉包内に限定し、未作成文書を含めません。
56
80
 
57
81
  ```yaml
58
82
  ---
59
- id: sll-main
60
- type: data
61
- title: 保管場所一覧(main)
62
- status: draft
63
- supersedes: []
83
+ specdojo:
84
+ id: sld-specdojo
85
+ type: data
86
+ status: draft
87
+ rulebook: specdojo:sld-rulebook
88
+ based_on:
89
+ - cdsd-planning
90
+ - cdsd-execution
91
+ - cdsd-sharing
92
+ supersedes: []
64
93
  ---
65
94
  ```
66
95
 
67
- ### 3.2 保管場所一覧(表)
96
+ ## 5. 本文要件
97
+
98
+ 本文は次の5章構成を標準とします。H1 は文書名のみに使い、`##`〜`####` の見出しには階層ごとの連番と末尾のピリオドを付けます(例: `## 1.`、`### 1.1.`、`#### 1.1.1.`)。表はヘッダー・区切り行・データ行を連続させ、途中に空行を入れません。
99
+
100
+ | 章 | 必須 | 内容・受入条件 |
101
+ | -------------------------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------- |
102
+ | 概要 | 必須 | 対象領域、想定読者(`Role code`)と利用場面、解決する運用・設計上の課題、対象範囲と隣接仕様(CDSD・BDD・実装リファレンス)との分担 |
103
+ | 保管場所一覧 | 必須 | 対象領域の全保管場所を標準6列で定義し、置くもの・共有の有無・寿命・消してよいかが漏れなく判別できること |
104
+ | 削除・退避・復旧の判断基準 | 必須 | 削除可否の区分ごとの判断条件、誤削除や孤立ロック・残存作業領域への対処、再生成・復旧方法とエスカレーション先を示すこと |
105
+ | 関連仕様・実装配置との対応と検証 | 必須 | 概念データストア(CDSD)や実装の配置定義・共有設定との対応関係、および各ロールの受入確認・検証手順を辿れること |
106
+ | 確認事項と変更影響 | 条件付き | 未決事項(`_TODO_` / `_UNDECIDED_`)、前提の欠落、保管場所追加・変更時の影響範囲、管理台帳(PJR)への追跡候補と公開承認条件を示す |
107
+
108
+ ### 5.1. 保管場所一覧の標準列
109
+
110
+ 「保管場所一覧」の表は、次の6列をこの順序で配置します。対象領域に物理的な場所と論理的な場所(またはリポジトリ内と端末ローカル)の両方が含まれる場合は、同一の標準6列で表を分けるか、区分が分かる順序で並べます。
111
+
112
+ | 列名 | 内容・判断条件 |
113
+ | ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
114
+ | 保管場所 | 場所の論理名と、物理的な設置場所またはディレクトリパス・環境変数パターン(例: `docs/ja/projects/<id>/execution/`、`${XDG_STATE_HOME}/...`) |
115
+ | 置くもの | 保管する現物・帳票・ファイル群と、その役割(正本・履歴・派生ビュー・ロック・一時データ等)。多数のファイルを個別に全列挙せず代表単位で示す |
116
+ | 関連プロセス・操作 | その場所にものを置く・参照する・回収する業務プロセスまたはコマンド・処理(複数ある場合は「、」で区切る) |
117
+ | 共有の有無 | `Git 共有(追跡対象)`、`共有なし(.gitignore・各環境で再生成)`、`共有なし(端末ローカル)`、`店舗内共有(施錠保管)` 等の区分と共有範囲 |
118
+ | 寿命・管理頻度 | 置かれてから消える・移動するまでの期間(恒久、タスク実行中、プロセス実行中、日次・月次等)と、確認・清掃・ローテーションの契機 |
119
+ | 削除・処分の可否と条件 | `削除不可` / `条件付き削除可` / `削除可`(物理現物の場合は `処分不可` / `条件付き処分可` / `即時処分可`)の区分と、削除前条件・再生成手段 |
120
+
121
+ ### 5.2. 削除・退避・復旧の判断要件
122
+
123
+ - 一覧の「削除・処分の可否と条件」で示した3区分(`削除不可` / `条件付き削除可` / `削除可`)について、運用者(OPS)や開発者(DEV)が迷いやすい境界ケースの判断基準を定義します。
124
+ - `削除不可` の場所について、不要化・廃止時に直接削除する代わりに採るべき正規手順(ステータスの `deprecated` 化、アーカイブ領域への退避、法定・監査保持期間満了後の承認手続き等)を示します。
125
+ - `条件付き削除可` の場所(実行ロック、未統合の可能性がある作業用 worktree、返品・保留箱など)について、削除前に必ず確認する状態(稼働中プロセスの有無、未マージ差分の有無、PO・責任者の確認有無)を明記します。
126
+ - `削除可` の場所(派生生成ビュー、索引キャッシュ、一時ディレクトリなど)について、削除後に必要となる再生成コマンドまたは再作成契機を示します。
127
+
128
+ ### 5.3. 関連仕様・実装配置との対応と検証要件
129
+
130
+ - 依存する概念データストア定義(`cdsd-*`)の各管理単位が、本書のどの保管場所に対応するか(および CDSD 側で未登録・整備予定の管理単位があればその対応関係)を追跡できるようにします。
131
+ - ソフトウェア・リポジトリの保管場所を扱う場合は、パス解決や共有除外を担う実装モジュール・設定ファイル(例: `.gitignore`、パス解決関数、ディレクトリレイアウトリファレンス)との対応を示します。実装コードの関数本体や schema 全文は転記しません。
132
+ - 受入確認として、次の4観点の合格条件と確認手段を定義します。
133
+ 1. **ARC・DEV(配置と技術制約の一致)**: 保管場所のパス区分、Git 追跡/除外設定、端末ローカルや worktree の分離方式が実装およびリファレンスと一致していること。
134
+ 2. **BA(要求・データストアの網羅)**: `depends_on` の CDSD 等で定義された記録・管理単位に保管場所の欠落がなく、保持・共有の業務要件と矛盾しないこと。
135
+ 3. **OPS(削除・保持判断の明確性)**: すべての保管場所について、消してよいか、消す前の確認事項、消した後の影響または再生成手順が特定できること。
136
+ 4. **QE(文書品質と整合性検証)**: 標準6列・必須章の充足、参照リンクの解決、およびリポジトリ標準の整形・lint(本リポジトリでは `npx prettier --write <対象.md>`、`npm run lint:md`、`npm run lint:fm`)がエラーなく通過すること。
137
+
138
+ ### 5.4. 未決事項・変更管理・公開判断の要件
139
+
140
+ - 保管先や保持期間が未確定の項目は推測で確定せず、`_UNDECIDED_` または `_TODO_` を付して「確認事項と変更影響」に記録します。計画済み作業は Schedule、既発の問題は課題(`issue`)、未発生の懸念はリスク(`risk`)、承認を要する仕様変更は変更要求(`change-request`)、合意した方針は決定記録(`decision`)として管理台帳(PJR)への転記候補と担当 `Role code`・判断時期を示します。
141
+ - 保管場所の新設・パス変更・共有区分の変更を行う場合は、CDSD、ディレクトリリファレンス、`.gitignore`、ビルド・再生成処理、バックアップ・清掃手順への波及を ARC・DEV・OPS が確認します。
142
+ - 公開および `status: ready` への昇格は、BA・ARC・DEV・OPS・QE の確認完了後、未決事項の影響と公開範囲を提示したうえで人間の PO が判断します。agent が独断で `ready` に変更することは禁止します。
143
+
144
+ ## 6. 記述ガイド
145
+
146
+ 共通事項は上位のメタ情報標準・文書構成ガイド、共通の語義は用語集を正本とし、各章で再定義しません。完成例の全体像は Frontmatter の `sample` で宣言された sample を参照してください。各章の記述では次の判断基準と良い例・悪い例に従います。
147
+
148
+ ### 6.1. 概要
149
+
150
+ - **判断基準**: 誰がどの運用・設計判断に使う一覧であり、CDSD(概念上の管理単位)やリファレンス(ディレクトリ構造の詳細)とどう役割分担するかが冒頭で分かること。
151
+ - **良い例**: 「リポジトリ内の正本文書・実行履歴・派生ビューと、端末ローカルの状態ファイル・worktree・一時ディレクトリの保管境界を定義し、OPS・DEV が清掃や障害復旧時に消してよい場所と残すべき場所を判別できるようにする。概念上の管理単位と更新責務は CDSD を参照する。」
152
+ - **悪い例**: 「SpecDojo のディレクトリ一覧を示す。」(誰の何の判断に使うか、CDSD やディレクトリリファレンスとの違いが分からない)
153
+
154
+ ### 6.2. 保管場所一覧
155
+
156
+ - **判断基準**: 標準6列がすべて具体化され、「共有の有無」に共有手段(Git 追跡、`.gitignore`、端末固有など)、「削除・処分の可否と条件」に可否区分と条件・復旧方法が明記されていること。
157
+ - **良い例**: 「`docs/**/generated/` および `.specdojo/doc-index.json` / カタログ・台帳・実行結果の派生 Markdown ビューと文書索引 / `specdojo build`、`index build` / 共有なし(`.gitignore` で除外し各環境で生成) / ビルド時に再生成 / `削除可`。削除しても正本 YAML・Markdown から `specdojo build` で完全再生成できる」
158
+ - **悪い例**: 「`generated` フォルダ / 生成ファイル / ビルド / なし / 随時 / 消してよい」(パス範囲、共有除外の仕組み、削除後の復旧手段が曖昧で運用判断に使えない)
68
159
 
69
- | 保管場所 | 主な保管対象 | 主な内容・目的 | 関連プロセス | 管理頻度 |
70
- | ------------ | ------------------------------------ | ---------------------------------------------------------------- | ------------ | -------------- |
71
- | バックヤード | 商品在庫(未陳列)、段ボール、予備棚 | 納品された商品を保管し、数量と賞味期限を管理。補充元として機能。 | 調達、販売 | 納品時・補充時 |
72
- | 売り場棚 | 販売中の商品 | お客様が手に取る商品を配置、価格表示、補充、前出しを行う。 | 販売 | 開店前・営業中 |
160
+ ### 6.3. 削除・退避・復旧の判断基準
73
161
 
74
- | レジ | 現金、レジ記録 | 日次の売上金を管理し、入出金記録を保持。 | 会計 | 日次 |
75
- | 金庫 | 日次売上金 | 売上金を安全に保管し、必要に応じて出金。 | 会計 | 日次 |
76
- | 銀行口座 | 事業用銀行口座 | 仕入先や経費の支払い、売上金の入金を管理。 | 会計 | 随時 |
162
+ - **判断基準**: 「いつ・何を確認すれば消せるか」「消した後にどう戻すか」「絶対に消してはいけない理由と代替手段は何か」が場面別に行動レベルで書かれていること。
163
+ - **良い例**: 「`execution/exec/.locks/` のロックファイルは `条件付き削除可` とする。`exec run` プロセスが異常終了してロックが残存した場合のみ、同一リポジトリで実行中の `exec run` プロセスが存在しないことを確認したうえで削除する。稼働中に削除すると二重実行により実行記録が破損する。」
164
+ - **悪い例**: 「ロックファイルは状況に応じて注意して削除する。」(確認条件も誤削除時の影響も分からず、事故を防げない)
77
165
 
78
- ## 4. 本文構成(標準テンプレ)
166
+ ### 6.4. 関連仕様・実装配置との対応と検証
79
167
 
80
- | 番号 | 見出し | 必須 |
81
- | ---- | ------------ | ---- |
82
- | 1 | 保管場所一覧 | ○ |
168
+ - **判断基準**: 根拠となる CDSD の管理単位や実装ファイル(パス解決・共有設定)を具体的に特定し、それらと保管場所一覧の整合をどう検証するかが分かること。
169
+ - **良い例**: 「実行履歴領域(`execution/runs/`、`execution/conventions/`)は [[cdsd-execution|概念データストア定義(プロジェクト実行)]] の実行記録および `src/shared/run-records.ts` のパス解決に対応し、Git 追跡対象の正本として保持する。」
170
+ - **悪い例**: 「実装のソースコード一式と整合していることを確認する。」(どの仕様・どの実装モジュールと対応するか追跡できない)
83
171
 
84
- ## 5. 記述ガイド
172
+ ### 6.5. 確認事項と変更影響
85
173
 
86
- - 保管場所名は業務用語で統一する。
87
- - 管理頻度は判定可能な語彙で記載する。
88
- - 関連プロセスは複数指定時の区切りを統一する。
174
+ - **判断基準**: 上位仕様(CDSD 等)で未決・未整備の事項を隠さず引き継ぎ、誰がいつ判断し、決定時に本書のどの行・どの実装へ影響するかを明記すること。
175
+ - **良い例**: 「`_UNDECIDED_`: 監視結果・費用作業記録の具体的な保管先パスと保持期間。[[cdsd-execution|概念データストア定義(プロジェクト実行)]] の未決事項に対応し、運用設計フェーズで OPS・ARC が方式を比較して PO が決定する。決定後に本書の第2章へ該当行を追加する。」
176
+ - **悪い例**: 未決の保管場所を推測で確定パスとして書き込む、または未決事項があるのに「特になし」と記載する。
89
177
 
90
- ## 6. 禁止事項
178
+ ## 7. 禁止事項
91
179
 
92
- - 物理DB設計や実装コードを記載しない。
93
- - 保管対象未記載で確定しない。
94
- - 略語のみで意味不明な名称を使わない。
180
+ | 禁止パターン | 理由 |
181
+ | -------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------- |
182
+ | 「置くもの」「共有の有無」「寿命」「消してよいか」のいずれかを欠いた行定義 | 保管場所一覧の受入条件を満たさず、運用者が誤削除や放置の判断を誤る原因になるため |
183
+ | 「適宜削除」「状況に応じて管理」など条件のない削除可否記述 | OPS・DEV が削除前の確認事項や再生成手段を判断できず、正本データや未統合 worktree の消失を招くため |
184
+ | 概念データストアの属性一覧・JSON Schema・ソースコード実装の全文転記 | CDSD・BDD・schema・実装との二重管理になり、正本更新時に不整合が発生するため |
185
+ | 未決の保管先や保持期間を根拠なく推測で確定記載すること | 合意されていない運用制約やディレクトリ構成を既成事実化し、後続の設計・実装と衝突するため |
186
+ | 本文への sample / recipe / template への wikilink やリンク章の設置 | 対応関係は Frontmatter で宣言し、本文に不要な依存リンクを残さないため |
187
+ | メタ説明(「ここに対象を書く」等)のみのサンプルや表の空行分断 | 具体例の判断基準として機能せず、また Markdown の表構文規約に違反するため |
188
+ | 章参照を章番号のみ(例: `§5` や「第5章」)で記述すること | 章構成の変更で番号がずれた際の誤認を防ぎ、章タイトルで特定するため |
189
+ | agent による `status: ready` への昇格や、承認なしの正本削除方針の確定 | 最終的な業務合意と公開・処分責任は人間の PO にあり、自動処理で代替してはならないため |