specdojo 0.7.0 → 0.9.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 (462) hide show
  1. package/.github/agents/specdojo-orchestrator.md +7 -3
  2. package/CHANGELOG.md +217 -0
  3. package/dist/catalog/build.js +24 -1
  4. package/dist/catalog/catalog.js +16 -14
  5. package/dist/catalog/plan.js +1 -1
  6. package/dist/catalog/scaffold.js +4 -1
  7. package/dist/commands/agent.js +5 -3
  8. package/dist/commands/build.js +69 -10
  9. package/dist/commands/git.js +206 -0
  10. package/dist/commands/init.js +9 -3
  11. package/dist/commands/night-orchestrator.js +6 -4
  12. package/dist/commands/where.js +25 -0
  13. package/dist/dashboard/dashboard-timeline.js +18 -16
  14. package/dist/dashboard/dashboard.js +616 -261
  15. package/dist/dashboard/epic-plan.js +81 -0
  16. package/dist/dashboard/exec-records.js +16 -20
  17. package/dist/dashboard/routines.js +11 -12
  18. package/dist/dashboard/timeline-build.js +5 -9
  19. package/dist/dashboard/timeline.js +23 -18
  20. package/dist/devcontainer/scaffold.js +18 -0
  21. package/dist/docs/frontmatter-namespace.js +1 -48
  22. package/dist/docs/index-command.js +2 -2
  23. package/dist/docs/yaml-business-tables.js +243 -0
  24. package/dist/docs/yaml-interface-tables.js +106 -0
  25. package/dist/docs/yaml-pages-command.js +5 -3
  26. package/dist/docs/yaml-pages.js +268 -3
  27. package/dist/docs/yaml-table-shared.js +70 -0
  28. package/dist/docs/yaml-tables.js +39 -0
  29. package/dist/exec/agent-config.js +31 -0
  30. package/dist/exec/agent-plan.js +3 -2
  31. package/dist/exec/agent-protected-config.js +2 -0
  32. package/dist/exec/commands.js +100 -39
  33. package/dist/exec/commit-hook-skips.js +78 -0
  34. package/dist/exec/core.js +19 -7
  35. package/dist/exec/events.js +179 -8
  36. package/dist/exec/evidence.js +77 -19
  37. package/dist/exec/handoff.js +9 -13
  38. package/dist/exec/limit.js +1 -1
  39. package/dist/exec/mechanical-result.js +45 -0
  40. package/dist/exec/migrate-records.js +249 -0
  41. package/dist/exec/parent-validation.js +209 -15
  42. package/dist/exec/pipeline-state.js +27 -5
  43. package/dist/exec/plans-condense-findings.js +89 -0
  44. package/dist/exec/plans-core.js +45 -19
  45. package/dist/exec/plans-generation.js +52 -30
  46. package/dist/exec/plans-grade-findings.js +8 -3
  47. package/dist/exec/plans-kata-findings.js +61 -0
  48. package/dist/exec/plans-planning.js +3 -3
  49. package/dist/exec/plans-storage.js +12 -24
  50. package/dist/exec/post-integration.js +162 -0
  51. package/dist/exec/queue-command.js +166 -0
  52. package/dist/exec/queue.js +285 -0
  53. package/dist/exec/register-foreign-wait.js +84 -0
  54. package/dist/exec/register-resume.js +55 -56
  55. package/dist/exec/register.js +26 -22
  56. package/dist/exec/repo-integration-sync.js +21 -5
  57. package/dist/exec/repo-integration.js +21 -1
  58. package/dist/exec/reporter.js +121 -23
  59. package/dist/exec/results.js +106 -25
  60. package/dist/exec/review-completion.js +47 -0
  61. package/dist/exec/review-kata.js +112 -0
  62. package/dist/exec/run/agent-pipeline.js +78 -8
  63. package/dist/exec/run/agent.js +32 -13
  64. package/dist/exec/run/change-scope.js +365 -0
  65. package/dist/exec/run/deferred-cleanup.js +31 -0
  66. package/dist/exec/run/in-place.js +73 -33
  67. package/dist/exec/run/job-lock.js +66 -0
  68. package/dist/exec/run/job-sequence.js +137 -0
  69. package/dist/exec/run/job.js +135 -41
  70. package/dist/exec/run/lifecycle-commands.js +189 -37
  71. package/dist/exec/run/lock.js +22 -1
  72. package/dist/exec/run/mode-shared.js +11 -3
  73. package/dist/exec/run/register-command.js +14 -15
  74. package/dist/exec/run/register-core.js +20 -13
  75. package/dist/exec/run/register-mode.js +77 -17
  76. package/dist/exec/run/register-post-review.js +21 -9
  77. package/dist/exec/run/register-resume.js +95 -31
  78. package/dist/exec/run/register-state.js +23 -15
  79. package/dist/exec/run/register-worktree.js +184 -139
  80. package/dist/exec/run/schedule-mode.js +79 -18
  81. package/dist/exec/run/schedule-prepare.js +204 -59
  82. package/dist/exec/run/schedule-task.js +203 -49
  83. package/dist/exec/run/shared.js +9 -3
  84. package/dist/exec/run/trailing-records.js +35 -0
  85. package/dist/exec/run-records.js +2 -0
  86. package/dist/exec/schedule/schedule.js +116 -4
  87. package/dist/exec/shared.js +1 -1
  88. package/dist/exec/smoke.js +190 -0
  89. package/dist/exec/strategy.js +14 -3
  90. package/dist/exec/task-view.js +6 -4
  91. package/dist/exec/trailing-records.js +242 -0
  92. package/dist/exec/trial-commands.js +8 -4
  93. package/dist/exec/trial-core.js +6 -1
  94. package/dist/exec/validate-records-commit.js +110 -0
  95. package/dist/exec/validate-records.js +148 -0
  96. package/dist/exec/validation-metrics.js +181 -0
  97. package/dist/exec/worktree-cleanup-lock.js +26 -0
  98. package/dist/exec/worktree-command.js +38 -17
  99. package/dist/exec/worktree-ops-commit.js +119 -48
  100. package/dist/exec/worktree-ops-lifecycle.js +77 -48
  101. package/dist/exec/worktree-ops-merge.js +13 -2
  102. package/dist/exec/worktree-ops.js +2 -2
  103. package/dist/exec/worktree.js +32 -4
  104. package/dist/grade/apply.js +32 -6
  105. package/dist/grade/command-apply.js +3 -3
  106. package/dist/grade/command-inspect.js +7 -5
  107. package/dist/grade/command-plan.js +1 -1
  108. package/dist/grade/command-run.js +7 -1
  109. package/dist/grade/command-shared.js +1 -1
  110. package/dist/grade/core.js +18 -5
  111. package/dist/grade/markdown.js +3 -3
  112. package/dist/grade/pipeline-state.js +15 -11
  113. package/dist/grade/plan.js +37 -17
  114. package/dist/grade/result.js +3 -3
  115. package/dist/grade/run.js +87 -11
  116. package/dist/grade/target-discovery.js +17 -4
  117. package/dist/grade/targets.js +12 -11
  118. package/dist/job/definition.js +84 -8
  119. package/dist/job/job.js +109 -39
  120. package/dist/job/noop.js +104 -0
  121. package/dist/register/authoring-sources.js +22 -16
  122. package/dist/register/core.js +2 -0
  123. package/dist/register/create-commands.js +28 -3
  124. package/dist/register/deliverable-target.js +9 -1
  125. package/dist/register/epic.js +104 -26
  126. package/dist/register/event-merge.js +3 -0
  127. package/dist/register/events.js +4 -0
  128. package/dist/register/external-project.js +3 -0
  129. package/dist/register/item.js +6 -0
  130. package/dist/register/maintenance-commands.js +6 -3
  131. package/dist/register/planning.js +7 -14
  132. package/dist/register/register.js +74 -16
  133. package/dist/register/track-domains.js +34 -0
  134. package/dist/register/track-plan.js +78 -0
  135. package/dist/register/transition-commands.js +8 -0
  136. package/dist/register/work-table.js +64 -0
  137. package/dist/review/grade.js +35 -13
  138. package/dist/routine/definition.js +13 -3
  139. package/dist/routine/failure.js +30 -0
  140. package/dist/routine/routine.js +189 -71
  141. package/dist/routine/status.js +62 -0
  142. package/dist/routine/storage.js +33 -0
  143. package/dist/schedule/schedule.js +39 -39
  144. package/dist/schedule/strategy-generate-document.js +26 -14
  145. package/dist/schedule/strategy-generate-scope.js +17 -45
  146. package/dist/schedule/strategy-generate.js +33 -3
  147. package/dist/schedule/strategy-profiles.js +86 -12
  148. package/dist/shared/agent-types.js +7 -0
  149. package/dist/shared/condense-records.js +25 -0
  150. package/dist/shared/cross-process-lock.js +9 -1
  151. package/dist/shared/deprecation.js +8 -0
  152. package/dist/shared/dist-freshness.js +8 -2
  153. package/dist/shared/document-metadata.js +20 -0
  154. package/dist/shared/finding-cause.js +20 -0
  155. package/dist/shared/frontmatter-namespace.js +48 -0
  156. package/dist/shared/git-environment.js +2 -1
  157. package/dist/shared/git.js +186 -16
  158. package/dist/shared/grade-result.js +17 -1
  159. package/dist/shared/lefthook-scaffold.js +3 -0
  160. package/dist/shared/local-config.js +244 -0
  161. package/dist/shared/local-state.js +20 -0
  162. package/dist/shared/markdownlint-config.js +8 -3
  163. package/dist/shared/plan-conventions.js +129 -0
  164. package/dist/shared/plan-templates.js +57 -41
  165. package/dist/shared/run-records.js +224 -0
  166. package/dist/shared/specdojo-config.js +73 -41
  167. package/dist/shared/specdojo-gitignore.js +1 -0
  168. package/dist/shared/text.js +74 -6
  169. package/dist/shared/timeline-index.js +2 -0
  170. package/dist/shared/where-alias.js +13 -0
  171. package/dist/specdojo.js +4 -0
  172. package/docs/ja/specdojo/defaults/pm-review-viewpoints.yaml +11 -2
  173. package/docs/ja/specdojo/exec-templates/xep-common-conventions-template.md +4 -74
  174. package/docs/ja/specdojo/exec-templates/xep-condense-template.md +50 -0
  175. package/docs/ja/specdojo/exec-templates/xep-draft-template.md +17 -5
  176. package/docs/ja/specdojo/exec-templates/xep-fully-guided-template.md +16 -3
  177. package/docs/ja/specdojo/exec-templates/xep-recipe-guided-template.md +15 -5
  178. package/docs/ja/specdojo/exec-templates/xep-recipe-maintenance-template.md +6 -0
  179. package/docs/ja/specdojo/exec-templates/xep-register-template.md +1 -1
  180. package/docs/ja/specdojo/exec-templates/xep-rulebook-maintenance-template.md +6 -0
  181. package/docs/ja/specdojo/exec-templates/xep-sample-maintenance-template.md +6 -0
  182. package/docs/ja/specdojo/exec-templates/xep-template-maintenance-template.md +6 -0
  183. package/docs/ja/specdojo/exec-templates/xer-condense-template.md +25 -0
  184. package/docs/ja/specdojo/exec-templates/xp-common-conventions-template.md +50 -0
  185. package/docs/ja/specdojo/exec-templates/xrp-common-conventions-template.md +30 -0
  186. package/docs/ja/specdojo/guides/branch-workflow-guide.md +1 -1
  187. package/docs/ja/specdojo/guides/docs-editing-guide.md +12 -0
  188. package/docs/ja/specdojo/guides/docs-structure-guide.md +48 -15
  189. package/docs/ja/specdojo/guides/exec-config-guide.md +69 -19
  190. package/docs/ja/specdojo/guides/exec-operation-guide.md +97 -18
  191. package/docs/ja/specdojo/guides/exec-worktree-guide.md +20 -11
  192. package/docs/ja/specdojo/guides/job-sequence-guide.md +77 -0
  193. package/docs/ja/specdojo/guides/plan-result-lifecycle-guide.md +92 -55
  194. package/docs/ja/specdojo/guides/project-move-guide.md +381 -0
  195. package/docs/ja/specdojo/guides/quick-start-guide.md +73 -17
  196. package/docs/ja/specdojo/guides/register-operation-guide.md +26 -6
  197. package/docs/ja/specdojo/guides/remote-host-development-guide.md +2 -0
  198. package/docs/ja/specdojo/guides/review-guide.md +22 -19
  199. package/docs/ja/specdojo/guides/routine-operation-guide.md +23 -12
  200. package/docs/ja/specdojo/guides/ryu-guide.md +23 -13
  201. package/docs/ja/specdojo/guides/schedule-design-guide.md +27 -21
  202. package/docs/ja/specdojo/guides/schedule-operation-guide.md +27 -3
  203. package/docs/ja/specdojo/guides/specdojo-overview-guide.md +5 -4
  204. package/docs/ja/specdojo/guides/timeline-design-guide.md +27 -144
  205. package/docs/ja/specdojo/guides/use-case-guide.md +92 -155
  206. package/docs/ja/specdojo/guides/waza-guide.md +12 -8
  207. package/docs/ja/specdojo/recipes/bac-recipe.md +111 -0
  208. package/docs/ja/specdojo/recipes/bes-recipe.md +141 -0
  209. package/docs/ja/specdojo/recipes/bps-recipe.md +88 -139
  210. package/docs/ja/specdojo/recipes/br-recipe.md +77 -0
  211. package/docs/ja/specdojo/recipes/cdfd-overview-recipe.md +97 -109
  212. package/docs/ja/specdojo/recipes/cdfd-recipe.md +85 -146
  213. package/docs/ja/specdojo/recipes/cdfd-uc-recipe.md +92 -99
  214. package/docs/ja/specdojo/recipes/cnd-recipe.md +135 -0
  215. package/docs/ja/specdojo/recipes/cpd-recipe.md +140 -0
  216. package/docs/ja/specdojo/recipes/cxd-recipe.md +162 -0
  217. package/docs/ja/specdojo/recipes/ifd-recipe.md +145 -0
  218. package/docs/ja/specdojo/recipes/ifx-cmd-recipe.md +112 -90
  219. package/docs/ja/specdojo/recipes/ifx-index-recipe.md +164 -0
  220. package/docs/ja/specdojo/recipes/pm-communication-plan-recipe.md +60 -49
  221. package/docs/ja/specdojo/recipes/pm-members-recipe.md +50 -51
  222. package/docs/ja/specdojo/recipes/pm-organization-recipe.md +59 -48
  223. package/docs/ja/specdojo/recipes/pm-plan-recipe.md +72 -50
  224. package/docs/ja/specdojo/recipes/pm-quality-management-plan-recipe.md +40 -49
  225. package/docs/ja/specdojo/recipes/pm-raci-recipe.md +42 -48
  226. package/docs/ja/specdojo/recipes/pm-roles-recipe.md +52 -81
  227. package/docs/ja/specdojo/recipes/prj-assumptions-constraints-dependencies-recipe.md +64 -91
  228. package/docs/ja/specdojo/recipes/prj-charter-recipe.md +71 -106
  229. package/docs/ja/specdojo/recipes/prj-comparison-of-alternatives-recipe.md +78 -156
  230. package/docs/ja/specdojo/recipes/prj-issues-and-approach-recipe.md +62 -111
  231. package/docs/ja/specdojo/recipes/prj-scope-recipe.md +67 -123
  232. package/docs/ja/specdojo/recipes/prj-stakeholder-register-recipe.md +60 -96
  233. package/docs/ja/specdojo/recipes/prj-success-criteria-and-acceptance-criteria-recipe.md +61 -105
  234. package/docs/ja/specdojo/recipes/stsd-recipe.md +88 -80
  235. package/docs/ja/specdojo/recipes/sysd-critical-flows-recipe.md +129 -0
  236. package/docs/ja/specdojo/recipes/sysd-cross-cutting-policy-recipe.md +146 -0
  237. package/docs/ja/specdojo/recipes/sysd-index-recipe.md +141 -0
  238. package/docs/ja/specdojo/recipes/tsd-recipe.md +149 -129
  239. package/docs/ja/specdojo/references/command-reference.md +303 -148
  240. package/docs/ja/specdojo/references/deliverables-reference.md +30 -16
  241. package/docs/ja/specdojo/references/directory-layout-reference.md +3 -2
  242. package/docs/ja/specdojo/references/specdojo-config-reference.md +54 -18
  243. package/docs/ja/specdojo/rulebooks/atc-index-rulebook.md +101 -257
  244. package/docs/ja/specdojo/rulebooks/atc-rulebook.md +102 -228
  245. package/docs/ja/specdojo/rulebooks/bac-rulebook.md +63 -290
  246. package/docs/ja/specdojo/rulebooks/bdd-rulebook.md +162 -80
  247. package/docs/ja/specdojo/rulebooks/bds-rulebook.md +118 -155
  248. package/docs/ja/specdojo/rulebooks/bes-index-rulebook.md +128 -60
  249. package/docs/ja/specdojo/rulebooks/bes-rulebook.md +70 -94
  250. package/docs/ja/specdojo/rulebooks/bps-rulebook.md +24 -56
  251. package/docs/ja/specdojo/rulebooks/br-rulebook.md +58 -103
  252. package/docs/ja/specdojo/rulebooks/ccd-mermaid-rulebook.md +103 -223
  253. package/docs/ja/specdojo/rulebooks/cdfd-d2-rulebook.md +18 -93
  254. package/docs/ja/specdojo/rulebooks/cdfd-mermaid-rulebook.md +18 -52
  255. package/docs/ja/specdojo/rulebooks/cdfd-overview-rulebook.md +109 -147
  256. package/docs/ja/specdojo/rulebooks/cdfd-rulebook.md +80 -108
  257. package/docs/ja/specdojo/rulebooks/cdfd-uc-rulebook.md +51 -55
  258. package/docs/ja/specdojo/rulebooks/cdr-rulebook.md +144 -0
  259. package/docs/ja/specdojo/rulebooks/cdsd-rulebook.md +81 -68
  260. package/docs/ja/specdojo/rulebooks/cdt-rulebook.md +139 -0
  261. package/docs/ja/specdojo/rulebooks/cld-rulebook.md +9 -184
  262. package/docs/ja/specdojo/rulebooks/clis-rulebook.md +170 -0
  263. package/docs/ja/specdojo/rulebooks/cnd-mermaid-rulebook.md +33 -86
  264. package/docs/ja/specdojo/rulebooks/cnd-rulebook.md +79 -249
  265. package/docs/ja/specdojo/rulebooks/cop-index-rulebook.md +45 -131
  266. package/docs/ja/specdojo/rulebooks/cop-rulebook.md +69 -275
  267. package/docs/ja/specdojo/rulebooks/cpd-mermaid-rulebook.md +20 -112
  268. package/docs/ja/specdojo/rulebooks/cpd-rulebook.md +79 -249
  269. package/docs/ja/specdojo/rulebooks/cxd-mermaid-rulebook.md +12 -145
  270. package/docs/ja/specdojo/rulebooks/cxd-rulebook.md +115 -256
  271. package/docs/ja/specdojo/rulebooks/dct-index-rulebook.md +79 -109
  272. package/docs/ja/specdojo/rulebooks/dct-rulebook.md +119 -174
  273. package/docs/ja/specdojo/rulebooks/dec-rulebook.md +6 -14
  274. package/docs/ja/specdojo/rulebooks/dmd-index-rulebook.md +22 -66
  275. package/docs/ja/specdojo/rulebooks/dmd-rulebook.md +36 -94
  276. package/docs/ja/specdojo/rulebooks/dss-rulebook.md +171 -0
  277. package/docs/ja/specdojo/rulebooks/etc-index-rulebook.md +31 -131
  278. package/docs/ja/specdojo/rulebooks/etc-rulebook.md +50 -104
  279. package/docs/ja/specdojo/rulebooks/gl-rulebook.md +93 -57
  280. package/docs/ja/specdojo/rulebooks/ifd-mermaid-rulebook.md +63 -253
  281. package/docs/ja/specdojo/rulebooks/ifx-api-rulebook.md +14 -20
  282. package/docs/ja/specdojo/rulebooks/ifx-cmd-rulebook.md +79 -76
  283. package/docs/ja/specdojo/rulebooks/ifx-file-rulebook.md +182 -237
  284. package/docs/ja/specdojo/rulebooks/ifx-index-rulebook.md +111 -40
  285. package/docs/ja/specdojo/rulebooks/ifx-msg-rulebook.md +14 -22
  286. package/docs/ja/specdojo/rulebooks/imp-business-rulebook.md +23 -46
  287. package/docs/ja/specdojo/rulebooks/imp-data-rulebook.md +41 -64
  288. package/docs/ja/specdojo/rulebooks/imp-interface-rulebook.md +16 -40
  289. package/docs/ja/specdojo/rulebooks/imp-operations-rulebook.md +34 -61
  290. package/docs/ja/specdojo/rulebooks/imp-test-rulebook.md +27 -50
  291. package/docs/ja/specdojo/rulebooks/itc-index-rulebook.md +70 -199
  292. package/docs/ja/specdojo/rulebooks/itc-rulebook.md +65 -153
  293. package/docs/ja/specdojo/rulebooks/mip-index-rulebook.md +74 -150
  294. package/docs/ja/specdojo/rulebooks/mm-rulebook.md +12 -23
  295. package/docs/ja/specdojo/rulebooks/mtp-rulebook.md +99 -176
  296. package/docs/ja/specdojo/rulebooks/nfr-availability-rulebook.md +35 -61
  297. package/docs/ja/specdojo/rulebooks/nfr-index-rulebook.md +75 -117
  298. package/docs/ja/specdojo/rulebooks/nfr-integrity-rulebook.md +31 -60
  299. package/docs/ja/specdojo/rulebooks/nfr-maintainability-rulebook.md +26 -81
  300. package/docs/ja/specdojo/rulebooks/nfr-operations-rulebook.md +32 -70
  301. package/docs/ja/specdojo/rulebooks/nfr-performance-rulebook.md +45 -87
  302. package/docs/ja/specdojo/rulebooks/nfr-reliability-rulebook.md +48 -101
  303. package/docs/ja/specdojo/rulebooks/nfr-security-safety-rulebook.md +44 -80
  304. package/docs/ja/specdojo/rulebooks/nfr-usability-rulebook.md +59 -127
  305. package/docs/ja/specdojo/rulebooks/opd-index-rulebook.md +31 -50
  306. package/docs/ja/specdojo/rulebooks/opd-rulebook.md +42 -109
  307. package/docs/ja/specdojo/rulebooks/opr-index-rulebook.md +29 -42
  308. package/docs/ja/specdojo/rulebooks/opr-rulebook.md +29 -87
  309. package/docs/ja/specdojo/rulebooks/otp-index-rulebook.md +62 -84
  310. package/docs/ja/specdojo/rulebooks/otp-rulebook.md +11 -61
  311. package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +92 -102
  312. package/docs/ja/specdojo/rulebooks/pm-change-request-log-rulebook.md +25 -34
  313. package/docs/ja/specdojo/rulebooks/pm-communication-plan-rulebook.md +30 -53
  314. package/docs/ja/specdojo/rulebooks/pm-issue-log-rulebook.md +23 -35
  315. package/docs/ja/specdojo/rulebooks/pm-members-rulebook.md +27 -45
  316. package/docs/ja/specdojo/rulebooks/pm-organization-rulebook.md +45 -59
  317. package/docs/ja/specdojo/rulebooks/pm-plan-rulebook.md +56 -66
  318. package/docs/ja/specdojo/rulebooks/pm-quality-management-plan-rulebook.md +54 -62
  319. package/docs/ja/specdojo/rulebooks/pm-raci-rulebook.md +46 -65
  320. package/docs/ja/specdojo/rulebooks/pm-risk-register-rulebook.md +28 -35
  321. package/docs/ja/specdojo/rulebooks/pm-roles-rulebook.md +65 -97
  322. package/docs/ja/specdojo/rulebooks/pr-rulebook.md +6 -18
  323. package/docs/ja/specdojo/rulebooks/prj-assumptions-constraints-dependencies-rulebook.md +48 -78
  324. package/docs/ja/specdojo/rulebooks/prj-charter-rulebook.md +23 -97
  325. package/docs/ja/specdojo/rulebooks/prj-comparison-of-alternatives-rulebook.md +61 -153
  326. package/docs/ja/specdojo/rulebooks/prj-issues-and-approach-rulebook.md +43 -116
  327. package/docs/ja/specdojo/rulebooks/prj-scope-rulebook.md +16 -51
  328. package/docs/ja/specdojo/rulebooks/prj-stakeholder-register-rulebook.md +47 -92
  329. package/docs/ja/specdojo/rulebooks/prj-success-criteria-and-acceptance-criteria-rulebook.md +25 -84
  330. package/docs/ja/specdojo/rulebooks/sac-rulebook.md +44 -107
  331. package/docs/ja/specdojo/rulebooks/sf-index-rulebook.md +106 -32
  332. package/docs/ja/specdojo/rulebooks/sf-rulebook.md +111 -61
  333. package/docs/ja/specdojo/rulebooks/sld-rulebook.md +129 -59
  334. package/docs/ja/specdojo/rulebooks/stc-index-rulebook.md +90 -189
  335. package/docs/ja/specdojo/rulebooks/stc-rulebook.md +45 -105
  336. package/docs/ja/specdojo/rulebooks/stsd-mermaid-rulebook.md +46 -40
  337. package/docs/ja/specdojo/rulebooks/stsd-rulebook.md +104 -68
  338. package/docs/ja/specdojo/rulebooks/sysd-critical-flows-rulebook.md +64 -330
  339. package/docs/ja/specdojo/rulebooks/sysd-cross-cutting-policy-rulebook.md +70 -263
  340. package/docs/ja/specdojo/rulebooks/sysd-index-rulebook.md +58 -200
  341. package/docs/ja/specdojo/rulebooks/sysd-rulebook.md +47 -60
  342. package/docs/ja/specdojo/rulebooks/tml-rulebook.md +4 -9
  343. package/docs/ja/specdojo/rulebooks/trc-requirements-to-specs-rulebook.md +69 -71
  344. package/docs/ja/specdojo/rulebooks/trc-requirements-to-tests-rulebook.md +65 -72
  345. package/docs/ja/specdojo/rulebooks/tsd-index-rulebook.md +35 -46
  346. package/docs/ja/specdojo/rulebooks/tsd-rulebook.md +49 -66
  347. package/docs/ja/specdojo/rulebooks/tsp-index-rulebook.md +64 -139
  348. package/docs/ja/specdojo/rulebooks/uis-rulebook.md +91 -161
  349. package/docs/ja/specdojo/rulebooks/utc-index-rulebook.md +49 -144
  350. package/docs/ja/specdojo/rulebooks/utc-rulebook.md +67 -155
  351. package/docs/ja/specdojo/samples/bac-sample.md +106 -21
  352. package/docs/ja/specdojo/samples/bdd-sample.yaml +143 -35
  353. package/docs/ja/specdojo/samples/bds-sample.md +87 -21
  354. package/docs/ja/specdojo/samples/bes-index-sample.md +42 -20
  355. package/docs/ja/specdojo/samples/bes-sample.md +70 -21
  356. package/docs/ja/specdojo/samples/bps-sample.md +42 -54
  357. package/docs/ja/specdojo/samples/br-sample.md +57 -15
  358. package/docs/ja/specdojo/samples/ccd-sample.md +80 -19
  359. package/docs/ja/specdojo/samples/cdfd-sample.md +172 -99
  360. package/docs/ja/specdojo/samples/cdfd-uc-sample.md +9 -7
  361. package/docs/ja/specdojo/samples/cdr-sample.md +78 -0
  362. package/docs/ja/specdojo/samples/cdsd-sample.md +73 -20
  363. package/docs/ja/specdojo/samples/cdt-sample.md +116 -0
  364. package/docs/ja/specdojo/samples/cld-sample.md +3 -30
  365. package/docs/ja/specdojo/samples/clis-sample.md +125 -0
  366. package/docs/ja/specdojo/samples/cnd-sample.md +127 -21
  367. package/docs/ja/specdojo/samples/cpd-sample.md +136 -22
  368. package/docs/ja/specdojo/samples/cxd-sample.md +108 -22
  369. package/docs/ja/specdojo/samples/dct-index-sample.yaml +63 -17
  370. package/docs/ja/specdojo/samples/dec-sample.md +2 -3
  371. package/docs/ja/specdojo/samples/dss-sample.md +175 -0
  372. package/docs/ja/specdojo/samples/gl-sample.yaml +50 -14
  373. package/docs/ja/specdojo/samples/ifd-sample.md +105 -21
  374. package/docs/ja/specdojo/samples/ifx-api-sample.yaml +0 -2
  375. package/docs/ja/specdojo/samples/ifx-cmd-sample.yaml +91 -60
  376. package/docs/ja/specdojo/samples/ifx-file-sample.md +462 -21
  377. package/docs/ja/specdojo/samples/ifx-index-sample.yaml +87 -19
  378. package/docs/ja/specdojo/samples/ifx-msg-sample.yaml +0 -2
  379. package/docs/ja/specdojo/samples/job-sequence.yaml +67 -0
  380. package/docs/ja/specdojo/samples/mip-index-sample.md +98 -20
  381. package/docs/ja/specdojo/samples/pm-communication-plan-sample.md +26 -19
  382. package/docs/ja/specdojo/samples/pm-members-sample.yaml +37 -13
  383. package/docs/ja/specdojo/samples/pm-organization-sample.md +42 -21
  384. package/docs/ja/specdojo/samples/pm-plan-sample.md +78 -26
  385. package/docs/ja/specdojo/samples/pm-quality-management-plan-sample.md +41 -22
  386. package/docs/ja/specdojo/samples/pm-raci-sample.md +63 -28
  387. package/docs/ja/specdojo/samples/pm-roles-sample.yaml +13 -12
  388. package/docs/ja/specdojo/samples/prj-assumptions-constraints-dependencies-sample.md +33 -25
  389. package/docs/ja/specdojo/samples/prj-charter-sample.md +42 -59
  390. package/docs/ja/specdojo/samples/prj-comparison-of-alternatives-sample.md +83 -62
  391. package/docs/ja/specdojo/samples/prj-success-criteria-and-acceptance-criteria-sample.md +30 -33
  392. package/docs/ja/specdojo/samples/sf-index-sample.md +47 -20
  393. package/docs/ja/specdojo/samples/sf-sample.md +109 -21
  394. package/docs/ja/specdojo/samples/sld-sample.md +88 -21
  395. package/docs/ja/specdojo/samples/stsd-sample.md +54 -26
  396. package/docs/ja/specdojo/samples/sysd-critical-flows-sample.md +166 -21
  397. package/docs/ja/specdojo/samples/sysd-cross-cutting-policy-sample.md +178 -21
  398. package/docs/ja/specdojo/samples/sysd-index-sample.md +82 -21
  399. package/docs/ja/specdojo/samples/tml-sample.yaml +4 -1
  400. package/docs/ja/specdojo/samples/uis-sample.md +141 -20
  401. package/docs/ja/specdojo/standards/document-metadata-standard.md +33 -4
  402. package/docs/ja/specdojo/standards/id-and-file-naming-standard.md +3 -1
  403. package/docs/ja/specdojo/standards/job-definition-standard.md +24 -9
  404. package/docs/ja/specdojo/standards/rulebook-authoring-standard.md +1 -0
  405. package/docs/ja/specdojo/templates/bac-template.md +76 -0
  406. package/docs/ja/specdojo/templates/bes-template.md +56 -0
  407. package/docs/ja/specdojo/templates/br-template.md +64 -0
  408. package/docs/ja/specdojo/templates/cdfd-template.md +81 -54
  409. package/docs/ja/specdojo/templates/cdfd-uc-template.md +9 -5
  410. package/docs/ja/specdojo/templates/cdr-template.md +58 -0
  411. package/docs/ja/specdojo/templates/cnd-template.md +137 -0
  412. package/docs/ja/specdojo/templates/cpd-template.md +129 -0
  413. package/docs/ja/specdojo/templates/cxd-template.md +105 -0
  414. package/docs/ja/specdojo/templates/dct-data-model-cdt-template.yaml +40 -0
  415. package/docs/ja/specdojo/templates/dct-data-model-cld-template.yaml +7 -14
  416. package/docs/ja/specdojo/templates/dct-index-template.md +9 -20
  417. package/docs/ja/specdojo/templates/dct-project-management-template.yaml +5 -1
  418. package/docs/ja/specdojo/templates/ifd-template.md +86 -0
  419. package/docs/ja/specdojo/templates/ifx-cmd-template.yaml +44 -28
  420. package/docs/ja/specdojo/templates/ifx-index-template.yaml +40 -0
  421. package/docs/ja/specdojo/templates/opr-template.md +2 -4
  422. package/docs/ja/specdojo/templates/pm-organization-template.md +9 -3
  423. package/docs/ja/specdojo/templates/pm-plan-template.md +4 -4
  424. package/docs/ja/specdojo/templates/pm-quality-management-plan-template.md +17 -9
  425. package/docs/ja/specdojo/templates/pm-raci-template.md +24 -13
  426. package/docs/ja/specdojo/templates/pm-roles-template.yaml +3 -2
  427. package/docs/ja/specdojo/templates/prj-assumptions-constraints-dependencies-template.md +6 -3
  428. package/docs/ja/specdojo/templates/prj-comparison-of-alternatives-template.md +22 -19
  429. package/docs/ja/specdojo/templates/stsd-template.md +46 -21
  430. package/docs/ja/specdojo/templates/sysd-critical-flows-template.md +94 -0
  431. package/docs/ja/specdojo/templates/sysd-cross-cutting-policy-template.md +122 -0
  432. package/docs/ja/specdojo/templates/sysd-index-template.md +89 -0
  433. package/docs/specdojo/lib/yaml-metadata.cjs +7 -0
  434. package/docs/specdojo/schemas/v1/bdd.schema.yaml +25 -57
  435. package/docs/specdojo/schemas/v1/condense-records.schema.yaml +26 -0
  436. package/docs/specdojo/schemas/v1/dct.schema.yaml +10 -0
  437. package/docs/specdojo/schemas/v1/deliverable-frontmatter.schema.yaml +3 -0
  438. package/docs/specdojo/schemas/v1/esil.schema.yaml +7 -141
  439. package/docs/specdojo/schemas/v1/exec-common.schema.yaml +5 -1
  440. package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +95 -8
  441. package/docs/specdojo/schemas/v1/exec-evidence.schema.yaml +38 -0
  442. package/docs/specdojo/schemas/v1/exec-plan-frontmatter.schema.yaml +14 -0
  443. package/docs/specdojo/schemas/v1/exec-result-frontmatter.schema.yaml +18 -0
  444. package/docs/specdojo/schemas/v1/finding-cause.schema.yaml +22 -0
  445. package/docs/specdojo/schemas/v1/grade-pipeline-state.schema.yaml +1 -1
  446. package/docs/specdojo/schemas/v1/grade-result.schema.yaml +2 -0
  447. package/docs/specdojo/schemas/v1/ifx-cmd.schema.yaml +65 -5
  448. package/docs/specdojo/schemas/v1/ifx-index.schema.yaml +142 -0
  449. package/docs/specdojo/schemas/v1/job-run.schema.yaml +23 -0
  450. package/docs/specdojo/schemas/v1/job.schema.yaml +63 -2
  451. package/docs/specdojo/schemas/v1/register-events.schema.yaml +2 -0
  452. package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +17 -1
  453. package/docs/specdojo/schemas/v1/sch-strategy.schema.yaml +2 -2
  454. package/package.json +10 -7
  455. package/templates/antigravity/orchestrator.md +7 -3
  456. package/templates/claude/agents/specdojo-orchestrator.md +7 -3
  457. package/templates/codex/agents/specdojo-orchestrator.toml +7 -3
  458. package/templates/codex/orchestrator.md +7 -3
  459. package/templates/devcontainer/tmux.conf +6 -0
  460. package/templates/init-exec-defaults.yaml +13 -0
  461. package/templates/lefthook/tools/specdojo-pre-commit.mjs +8 -0
  462. package/templates/opencode/agents/specdojo-orchestrator.md +8 -4
@@ -13,7 +13,7 @@ Routine Operation Guide
13
13
 
14
14
  routineは、既存の未完了Schedule/Register項目を探索するほか、再利用可能なJob Definitionから期間・revisionごとのJob Runを生成できます。週報や変更文書の翻訳は[Job実行設計](../../product/040-system-design/sysd-job-execution.md)を参照してください。
15
15
 
16
- 継続品質評価は `job-grade-kata` や `job-grade-deliverable` の Job Definition から `action.kind: job` の routine で定期起動します。文書の選択、各文書の executor 実行、executor の marker を GradeSubmission へ機械変換する `grade apply --path --analysis-from` の逐次処理は `tools/grade/run-per-document.sh` が持ちます。このスクリプトと、このスクリプトを前提とする定期 Job は SpecDojo 本体リポジトリの開発用であり、スクリプトは npm package に含まれません。定期 Job は `--stages 1` で codex 単段を選びます。Job runnerは`task.command`からその入口を直接起動してevidenceを記録し、成功後の結果判断だけを`task.analysis`のreporter agentへ委譲します。責務の切り分け基準は [Job定義標準](../standards/job-definition-standard.md) を参照します。
16
+ 継続品質評価は `job-grade-kata` や `job-grade-deliverable` の Job Definition から `action.kind: job` の routine で定期起動します。Job の `task.command` は選択条件ごとの `grade list` の和集合を Run ごとに固定し、各文書の executor 実行と marker の機械変換・反映を `grade run` に任せます(PJR-R7BQ)。`grade run` は単段で評価します。Job runnerは`task.command`からその入口を直接起動してevidenceを記録し、成功後の結果判断だけを`task.analysis`のreporter agentへ委譲します。責務の切り分け基準は [Job定義標準](../standards/job-definition-standard.md) を参照します。
17
17
 
18
18
  v0.3.0 の公開物における grade は試験的な機能です。利用者は `grade list` / `plan` / `apply` / `validate` / `result` などの部品を利用できますが、定期実行や通しの pipeline は自分で組み合わせます。成果物の grade には project の `catalog_path` が必要です。1 文書の最小手順は [CLI コマンドリファレンス](../references/command-reference.md#81-npm-package-で-1-文書を評価する)を参照してください。
19
19
 
@@ -32,6 +32,8 @@ v0.3.0 の公開物における grade は試験的な機能です。利用者は
32
32
 
33
33
  ## 1. routineの定義
34
34
 
35
+ resume → auto → register → grade → build のように前段の完了を待つ流れは、command Job の `task.steps` に定義し、routine からその Job を1回呼びます。各段の失敗方針・状態判定・有限の lock 待機は runner が処理するため、agent の会話再開機能を必要としません。設定例と cron 起動は [[specdojo:job-sequence-guide|順次実行 Job の例]] を参照してください。
36
+
35
37
  `routine` は `rtn-*.yaml` の定義に基づき、Schedule の依存グラフとは独立にタスクを定期実行します。CLI は常駐しません。外部スケジューラ(cron / CI の scheduled workflow)から `routine run --due` を冪等に呼び出す前提です。
36
38
 
37
39
  定義は `.specdojo/specdojo.config.json` の `routines_path` 配下に `rtn-<slug>.yaml` として置き、`id` はファイル名と一致させます。
@@ -71,6 +73,8 @@ action の `commit: true` は互換として残しています。`task.review`
71
73
 
72
74
  統合前 review を宣言した Job は本体の checkout では実行せず、`exec/<project-id>-<run-id>` の worktree で実行します。runner は Job Run の plan・result・evidence・Run JSON と Job が更新した成果物だけを `chore(routine): …` の commit にし、commit 本文へ Job Run ID と `succeeded` / `partial` / `failed` を記録します。本体 checkout にある利用者の未 commit 変更は commit 対象に入りません。
73
75
 
76
+ `precondition` の有無によらず、成功した Job が成果物を変更しなかった場合は、その Run の記録ディレクトリ全体(plan・result・evidence・ログなど)と Run JSON を Git の差分から除き、commit と統合前 review を省きます。runner は実行前後の変更ファイルの内容・モードと HEAD 間の差分を比較し、その Run 自身の記録、`generated/`、exec の lock を判定から除外します。子の exec event や grade result は成果物の変更として扱います。無変更の Run は端末側へ `noop` として保存し、同じ入力・実行枠の重複実行防止と checkpoint を維持します。以前の attempt の記録があれば復元し、既存の失敗履歴を消しません。失敗・部分完了は無変更扱いにしません。Git 未初期化の in-place 実行は従来どおり記録し、初回 commit 前のリポジトリではファイルの差分だけで判定します。
77
+
74
78
  出力 commit の後、runner は `mode: review` の plan/result を作ります。review executor は score・verdict・finding・失敗文書と Job の完了条件を照合しますが、Job Run 出力は修正しません。Run が `succeeded` で verdict が `complete` または `complete-with-findings` の場合に加え、Run が `partial` で verdict が `complete-with-findings` の場合も、runner は現在の統合先へ `--no-ff` で merge し、worktree と exec branch を撤去します。`partial`を統合した routine は`last_result: partial`と記録し、`routine list`でも部分成功を表示します。Run が失敗した場合、review が未完了の場合、またはそれ以外の verdict の場合は統合せず、worktree を保持して routine の `last_result: failure`、`last_reason`、review result、Job Run JSON に理由を残します。
75
79
 
76
80
  #### waiting Run の確認・統合・破棄
@@ -156,13 +160,13 @@ action:
156
160
  args: [dashboard, build]
157
161
  ```
158
162
 
159
- Job Definition を持たないため、実行記録は `generated/routine-runs.jsonl` の 1 行だけで、Job Run と evidence は作られません。agent を呼ぶ処理や成果物を変更する処理には使わず、`kind: job` を使います。
163
+ Job Definition を持たないため、Job Run と evidence は作られません。成功時の実行履歴は端末側の `routine-runs.jsonl` にだけ残ります。失敗時の保存先は次節の規則に従います。agent を呼ぶ処理や成果物を変更する処理には使わず、`kind: job` を使います。
160
164
 
161
165
  ### 1.2. grade の単段評価
162
166
 
163
- Kata と成果物の定期評価は、SpecDojo 本体リポジトリ内で executor の単段により実行します。GradeSubmission は LLM の reporter を通さず、`grade apply` が executor の英語 marker から機械的に生成します。正本の grade result を保存した後、英語 finding が1件以上ある場合だけ `gemma26-translator` が日本語へ翻訳し、表示用の `message_ja` を更新します。モデルには英語文だけの配列を渡し、件数、各訳文の仮名、元の文と訳文のインラインコードの多重集合の一致をコードで検証します。元にないインラインコードが増えた項目も不合格とし、不合格項目だけを1件ずつ1回再翻訳します。それでも不合格なら正本の英語を表示に使います。翻訳は判定値を変えません。`job-grade-kata` と `job-grade-deliverable` は本体リポジトリにだけある `tools/grade/run-per-document.sh --stages 1` を起動し、条件付きの後続段は持ちません。変更済み・未評価・段未完了・旧 rubric を横断的に再評価する `rtn-grade-recheck` は `kind: all`、`changed_only: true`、`ungraded: true`、`incomplete: true`、`rubric_outdated: true`、`limit: 15` を入力します。
167
+ Kata と成果物の定期評価は、SpecDojo 本体リポジトリ内で executor の単段により実行します。GradeSubmission は LLM の reporter を通さず、`grade apply` が executor の marker から機械的に生成します。executor は判定根拠と finding を日本語で書き、その文が正本になります。正本の grade result を保存した後、旧結果から再掲された英語の正本など英語 finding が1件以上ある場合だけ `gemma26-translator` が日本語へ翻訳し、表示用の `message_ja` を更新します。0件なら翻訳の段を流しません。モデルには英語文だけの配列を渡し、件数、各訳文の仮名、元の文と訳文のインラインコードの多重集合の一致をコードで検証します。元にないインラインコードが増えた項目も不合格とし、不合格項目だけを1件ずつ1回再翻訳します。それでも不合格なら正本の英語を表示に使います。翻訳は判定値を変えません。`job-grade-kata` と `job-grade-deliverable` は `grade run` を起動し、条件付きの後続段は持ちません。`job-grade-kata` は `--reference-per-kind` で各文書を同じ種別の `prj-overview` 文書と比較します。`grade run` は翻訳の段を持たないため、上記の英語 finding の翻訳は定期 Job では流れません。変更済み・未評価・段未完了・旧 rubric を横断的に再評価する `rtn-grade-recheck` は `kind: all`、`changed_only: true`、`ungraded: true`、`incomplete: true`、`rubric_outdated: true`、`limit: 15` を入力します。
164
168
 
165
- 成果物は `rtn-grade-deliverable-recheck` が `job-grade-deliverable` を起動します。Job は同じ script を `--stages 1 --target deliverable` で実行し、成果物カタログから変更済み・未評価・段未完了・旧 rubric の Markdown 成果物だけを最大10件選びます。評価結果は成果物の最新 grade と成果物ごとの `done_criteria` 詳細へ上書きされるため、実行ごとの review result は増やしません。
169
+ 成果物は `rtn-grade-deliverable-recheck` が `job-grade-deliverable` を起動します。Job は `grade run --target deliverable` を実行し、成果物カタログから変更済み・未評価・段未完了・旧 rubric の Markdown 成果物だけを最大10件選びます。評価結果は成果物の最新 grade と成果物ごとの `done_criteria` 詳細へ上書きされるため、実行ごとの review result は増やしません。
166
170
 
167
171
  `rtn-grade-deliverable-recheck` は毎日1時、`rtn-grade-recheck` は毎日5時に実行し、いずれも `missed_run: skip` とします。`rtn-dashboard-refresh` は `action.kind: specdojo` で毎時 `dashboard build` を直接起動します(exec の実行ロックを取らないため、grade や register の実行中でも並行して動きます)。devcontainer の cron は毎時 `routine run --due` を呼びますが、各 routine の発火時刻は routine 側の cron で決まります。コンテナ停止中の実行枠を日中へ持ち越さず、対話的な register 実行との競合を避けます。
168
172
 
@@ -181,10 +185,10 @@ npx tsx src/specdojo.ts grade list --target deliverable --project prj-0001 --rub
181
185
 
182
186
  両 routine では、Job の `task.precondition` が `grade list` を使って script の selection-v5 と同じ変更済み・未評価・再試行可能な段未完了・旧 rubric の和集合、辞書順、対象種別、件数上限を先に評価します。連続失敗上限に達した文書は `grade state --exhausted` で同じ和集合に加えてから件数上限を適用し、処理対象からは外して report-only 対象にします。処理対象も report-only 対象も0件なら Job Run、plan、result、evidence を作らず、command と analysis reporter も起動しません。routine はこの結果を `skipped` として受け取り、`routine-state.json` の `last_run` / `last_result` と、cron の場合は `last_scheduled_for` を更新します。
183
187
 
184
- | 段 | agent | 対象と役割 |
185
- | ------ | ----------------------------------- | ------------------------------------------------------------ |
186
- | 判定 | `codex-expert-executor` / `machine` | 対象文書を英語で評価し、正本の判定を確定する |
187
- | 表示化 | `gemma26-translator` | finding の英語原文だけを日本語へ翻訳し、表示文として付加する |
188
+ | 段 | agent | 対象と役割 |
189
+ | ------ | ----------------------------------- | ------------------------------------------------------------- |
190
+ | 判定 | `codex-expert-executor` / `machine` | 対象文書を日本語で評価し、正本の判定を確定する |
191
+ | 表示化 | `gemma26-translator` | 英語の finding が残る場合だけ日本語へ翻訳し、表示文を付加する |
188
192
 
189
193
  Job runnerは、この入口をmaterialize済みの引数で1回起動し、コマンド、終了コード、stdout/stderrをevidenceへ記録します。コマンドが成功した場合だけanalysis reporterが、未完了の段、失敗の切り分け、verdict と score の偏りを判断します。executor、reporter(既定は機械変換の `machine`)、対象種別、件数上限はscriptの引数またはJobの`inputs`から解決します。
190
194
 
@@ -194,9 +198,13 @@ Job Definition は script を `if` の条件として起動し、終了コード
194
198
 
195
199
  ## 2. due判定と実行
196
200
 
197
- 最終実行時刻と結果は `<routines-path>/generated/routine-state.json` に記録され、`interval`(`30m` / `6h` / `1d` / `1w` 形式)が経過したものを due と判定します。配列 action の場合は段別結果も同じ state に記録します。多重起動は lock で防ぐため、外部スケジューラが重複起動しても同じ routine が二重に走ることはありません。
201
+ 最終実行時刻と結果は端末側の `routine-state.json` に記録され、`interval`(`30m` / `6h` / `1d` / `1w` 形式)が経過したものを due と判定します。配列 action の場合は段別結果も同じ state に記録します。多重起動は同じ保存先の lock で防ぎます。
202
+
203
+ 実行履歴は同じ保存先の `routine-runs.jsonl` へ1実行1行で追記します。各行は `routine_id`、`scheduled_for`、`started_at`、`completed_at`、`result`、`job_run_ids` を持ち、`docs/specdojo/schemas/v1/routine-run.schema.yaml` に従います。最新状態は due 判定、追記履歴は dashboard の日別実績表示に使います。
198
204
 
199
- 実行履歴は `<routines-path>/generated/routine-runs.jsonl` へ1実行1行で追記します。各行は `routine_id`、`scheduled_for`、`started_at`、`completed_at`、`result`、`job_run_ids` を持ち、`docs/specdojo/schemas/v1/routine-run.schema.yaml` に従います。最新状態だけを持つ `routine-state.json` は due 判定、追記履歴は dashboard の日別実績表示に使います。
205
+ 保存先は `$XDG_STATE_HOME/specdojo/<repository-key>/routines/<path-key>/`、環境変数が未設定または相対パスなら `~/.local/state/specdojo/` 以下です。repository key は Git 共通ディレクトリの実パス(Git がなければリポジトリの実パス)、path key はリポジトリからの routine 定義の相対パスの SHA-256 です。linked worktree 間で共有し、別リポジトリ・別 routine ツリーを分離します。`where routine` で実際のパスを確認できます。初回の `routine list`・通常実行・dashboard 集計時に旧 `generated/` の状態と履歴をコピーし、新しいファイルがあれば上書きしません。旧ファイルは復旧用に残しますが以後は参照しません。移行前に旧版の routine プロセスを停止してください。別端末へ状態を引き継ぐ場合はこの保存先を別途コピーします。
206
+
207
+ routine 自身が Git に残すのは、結果が `failure` かつ関連 Job Run ID が空の実行だけです。`<execution-path>/routines/failures/<routine-id>/<UUID>.json` に履歴と同じ項目と `run_id` を書き、理由を伏せ字処理したうえで、そのファイルだけを commit します。Job Run があればその記録を診断に使います。成功・skip・無変更の履歴は端末側にだけ保存し、dashboard も同じ状態・履歴を参照します。lock は文書ツリー外にあり、`.gitignore` の追加設定は不要です。
200
208
 
201
209
  単一オブジェクトの `action.kind`、配列の各要素の `kind` とも `job` だけを受け付けます。routine は `job-*.yaml` から一意な Job Run を生成して `exec run --job` へ委譲し、コマンド、入力の型・値域、冪等キーは Job Definition が担います。旧 `register` / `exec-auto` / `exec-resume` / `exec-cycle` kind は 2026-09-09 に廃止し、同等の command Job へ移行しました。
202
210
 
@@ -236,13 +244,16 @@ specdojo routine run --project <project-id> --id rtn-daily-register-sweep
236
244
  specdojo routine run --project <project-id> --due --dry-run
237
245
  ```
238
246
 
239
- 各 action は委譲先へ `--if-busy skip` を渡します。同じ project の `exec run` または `exec resume` が動作中なら待機せず、次のように記録して終了します。単一の routine 実行内では再試行せず、次回の cron tick に委ねます。
247
+ 各 action は委譲先へ `--if-busy skip` を渡します。同じ project の `exec run` または `exec resume` が動作中なら待機せず、次のように記録して終了します。単一の routine 実行内では再試行せず、次の `routine run --due` に委ねます。
240
248
 
241
249
  ```text
242
250
  [routine] skipped rtn-daily-register-sweep: job action skipped
251
+ [routine] rtn-daily-register-sweep: busy skip 1/24, retried on the next routine run --due
243
252
  ```
244
253
 
245
- `routine-state.json` の `last_result` は、実行開始時に `running` が記録され、実行完了時に `success`、`partial`、`failure`、`skipped` のいずれかへ更新されます。実行中は前回の結果や理由を残さず、`routine list` の最終実行の欄には `(running)` と表示されます(例: `2026-10-15T21:00:03Z (running)`)。実行プロセスの異常終了などにより `running` の表示が残った場合でも、次回の due 判定は `last_run` の時刻(cron の場合は `last_scheduled_for`)に基づいて判定されるため、次回の実行機会には影響しません。`partial` は完了分の統合と失敗分の再試行待ちが混在する状態であり、`routine list` では `(partial)` と表示されます。`skipped` は project busy または Job precondition の skip を表し、failure 件数や終了コードへ加算されません。`routine list` では最終実行時刻の後ろに `(skipped)` と表示されます。
254
+ 別の run の lock による skip(busy)は済んだ回として扱いません。cron の routine は `missed_run` が `latest` または `all`(省略時を含む)なら `last_scheduled_for` を進めず、空いた次の `routine run --due` でその回を流し直します。`latest` で新しい回が既に来ていれば新しい回だけを流します。`all` で同じ実行内に後の回が残っていても、busy の回より後は流さず次に回します。interval の routine は `busy_skip_count` が正の間、interval の経過を待たずに次の回で due になります。続いた busy skip が 24 回(毎時の `routine run --due` でおよそ 1 日)を超えたら、その回を済んだ回として扱い、`last_reason` と履歴の `reason` に上限到達を残します。`missed_run: skip` の cron、Job precondition の skip、失敗の回は従来どおり流し直しません。履歴の各行には skip の内訳を `skip_reason`(`busy` / `precondition`)で、流し直し待ちを `retry_pending: true` で残し、`routine status` で状態と直近の履歴を確認できます。
255
+
256
+ `routine-state.json` の `last_result` は、実行開始時に `running` が記録され、実行完了時に `success`、`partial`、`failure`、`skipped` のいずれかへ更新されます。実行中は前回の結果や理由を残さず、`routine list` の最終実行の欄には `(running)` と表示されます(例: `2026-10-15T21:00:03Z (running)`)。実行プロセスの異常終了などにより `running` の表示が残った場合でも、次回の due 判定は `last_run` の時刻(cron の場合は `last_scheduled_for`)に基づいて判定されるため、次回の実行機会には影響しません。`partial` は完了分の統合と失敗分の再試行待ちが混在する状態であり、`routine list` では `(partial)` と表示されます。`skipped` は project busy または Job precondition の skip を表し、failure 件数や終了コードへ加算されません。内訳は `routine-state.json` の `last_skip_reason` に残ります。`routine list` では最終実行時刻の後ろに `(skipped)` と表示されます。
246
257
 
247
258
  ### 2.1. devcontainerでのcron設定
248
259
 
@@ -55,7 +55,8 @@ flowchart TD
55
55
  M -->|"必要な型が揃い信頼できる"| FG
56
56
  M -->|"recipe のみ使える"| RG["recipe-guided"]
57
57
  M -->|"実践の型に頼れない"| FF["freeform"]
58
- FG --> RV["レビュー → finalize(人が確定)"]
58
+ FG --> CN["condense<br/>1 文書の冗長さを整理"] --> RV["レビュー → finalize(人が確定)"]
59
+ P -->|"1 文書の冗長さを整理"| CN
59
60
  RG --> W["雛形から開始 → 内容を記述 → レビュー"]
60
61
  FF --> W
61
62
  P -->|"実装先行の成果物を反映・新設"| RF["retrofit<br/>実装 → 成果物"]
@@ -66,7 +67,7 @@ flowchart TD
66
67
  P -->|"human が確定する"| FIN["finalize / bootstrap-finalize<br/>status を ready へ昇格"]
67
68
  ```
68
69
 
69
- `draft` は文脈で任された調査・下書きのための段であり、型の件数からは自動選択しません。整備状況で分岐するのは成果物の作成・更新(`fully-guided` / `recipe-guided` / `freeform`)だけです。`bootstrap` / `retrofit` / `cross-deliverable-dedup` / 各 `*-maintenance` / `finalize` 系は目的別のフェーズであり、実践の型が何件そろっているかだけでは選びません。とくに `bootstrap` は「実践の型が1件でも欠ける」ことを理由に選ばず、`undecided` の型を含めてどの型が必要かを作成条件に照らして判断し、成果物と必要な型を一式で初期整備する場合に限って選びます。不要な recipe / sample / template は rulebook frontmatter へ `not-needed` と宣言し、作成対象へ含めません。基準にできる実践の型が無くても、初期整備の対象でなければ `freeform` です。
70
+ `draft` は文脈で任された調査・下書きのための段であり、型の件数からは自動選択しません。整備状況で分岐するのは成果物の作成・更新(`fully-guided` / `recipe-guided` / `freeform`)だけです。`bootstrap` / `retrofit` / `condense` / `cross-deliverable-dedup` / 各 `*-maintenance` / `finalize` 系は目的別のフェーズであり、実践の型が何件そろっているかだけでは選びません。とくに `bootstrap` は「実践の型が1件でも欠ける」ことを理由に選ばず、`undecided` の型を含めてどの型が必要かを作成条件に照らして判断し、成果物と必要な型を一式で初期整備する場合に限って選びます。不要な recipe / sample / template は rulebook frontmatter へ `not-needed` と宣言し、作成対象へ含めません。基準にできる実践の型が無くても、初期整備の対象でなければ `freeform` です。
70
71
 
71
72
  ### 1.2. approach 一覧
72
73
 
@@ -74,7 +75,7 @@ flowchart TD
74
75
 
75
76
  #### 1.2.1. 成果物の作成・更新
76
77
 
77
- `draft` は下書き、`fully-guided` は磨き込みを担います。基本の流れは、雛形 → 人が文脈を記入 → `draft` → `fully-guided` → `finalize`(人)です。`recipe-guided` / `freeform` は実践の型をどこまで基準にするかを切り替えます。
78
+ `draft` は下書き、`fully-guided` は磨き込みを担います。基本の流れは、雛形 → 人が文脈を記入 → `draft` → `fully-guided` → `condense` → review → `finalize`(人)です。`recipe-guided` / `freeform` は実践の型をどこまで基準にするかを切り替えます。
78
79
 
79
80
  `draft` を除く三つの流は、型との関係を表す守破離に対応します。「守」は型をそのまま守り、「破」は型を基準にしながら工夫し、「離」は型から離れて完了条件と根拠から組み立てます。守破離は品質の序列ではなく、タスクの目的と実践の型の整備状況に応じて進め方を選ぶための名前です。
80
81
 
@@ -99,7 +100,7 @@ flowchart LR
99
100
  | `approach` | 流の名前 | 参照方針と進め方 | 対応テンプレート |
100
101
  | --------------- | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------- |
101
102
  | `draft` | 下書き | 文脈で任された範囲を調べて下書きする。型・依存成果物・`based_on`・`project_context`・個票の `入力`・カタログの `brief`・成果物内の文脈・出典つき外部情報を参照する。選定値を提案として示し、出典と選定理由を result に残す | `xep-draft-template.md`(edit) |
102
- | `fully-guided` | 守 | 既存成果物の磨き込み専用。宣言された rulebook / recipe / sample、`depends_on`、`based_on`、`project_context`、個票の `入力`、カタログの `brief` だけを参照する。template は読み込まない | [edit](../exec-templates/xep-fully-guided-template.md) / [review](../exec-templates/xrp-fully-guided-template.md) |
103
+ | `fully-guided` | 守 | 既存成果物の磨き込み専用。宣言された rulebook / recipe / sample、`depends_on`、`based_on`、`project_context`、個票の `入力`、カタログの `brief` を参照する。edit では `evidence_refs` も読む。template は読み込まない | [edit](../exec-templates/xep-fully-guided-template.md) / [review](../exec-templates/xrp-fully-guided-template.md) |
103
104
  | `recipe-guided` | 破 | recipe が示す構成・問い・観点を主基準にする。rulebook / sample / template が存在しても、構造・文体の基準にはしない | [edit](../exec-templates/xep-recipe-guided-template.md) / [review](../exec-templates/xrp-recipe-guided-template.md) |
104
105
  | `freeform` | 離 | 実践の型に頼れないため、カタログの `done_criteria`、対応 schema、既存の類似成果物を根拠に構成と内容を決める。参照した根拠と未決事項を result に残す | [edit](../exec-templates/xep-freeform-template.md) / [review](../exec-templates/xrp-freeform-template.md) |
105
106
 
@@ -205,11 +206,12 @@ flowchart LR
205
206
  S --> DD --> C
206
207
  ```
207
208
 
208
- | `approach` | 流の名前 | 参照方針と進め方 | 対応テンプレート |
209
- | ------------------------- | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------- |
210
- | `bootstrap` | 型起こし | 作成条件から型の要否を判断し、成果物と必要な rulebook / recipe / sample / template を同じタスクで初期作成する。不要な3種は rulebook frontmatter へ `not-needed` と宣言する | [edit](../exec-templates/xep-bootstrap-template.md) |
211
- | `retrofit` | 見取り | DCT の `evidence_refs` を読み、現在動作・意図された仕様・`done_criteria` を照合して、成果物の維持・部分反映・作り直し・新設を判断する | [edit](../exec-templates/xep-retrofit-template.md) / [review](../exec-templates/xrp-retrofit-template.md) |
212
- | `cross-deliverable-dedup` | 型寄せ | scope 内の成果物から正本を選び、他文書の重複を要約・参照へ置き換える。実践の型は変更せず、各成果物の必須情報と追跡性を維持する | [edit](../exec-templates/xep-cross-deliverable-dedup-template.md) / [result](../exec-templates/xer-cross-deliverable-dedup-template.md) |
209
+ | `approach` | 流の名前 | 参照方針と進め方 | 対応テンプレート |
210
+ | ------------------------- | ------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------- |
211
+ | `bootstrap` | 型起こし | 作成条件から型の要否を判断し、成果物と必要な rulebook / recipe / sample / template を同じタスクで初期作成する。不要な3種は rulebook frontmatter へ `not-needed` と宣言する | [edit](../exec-templates/xep-bootstrap-template.md) |
212
+ | `retrofit` | 見取り | DCT の `evidence_refs` を読み、現在動作・意図された仕様・`done_criteria` を照合して、成果物の維持・部分反映・作り直し・新設を判断する | [edit](../exec-templates/xep-retrofit-template.md) / [review](../exec-templates/xrp-retrofit-template.md) |
213
+ | `condense` | 冗長さの整理 | 1 文書内の冗長さを削る・まとめる・参照に置き換える。意味と判断に要る情報を保ち、新しい内容を足さない。磨き込みの後・review の前に置き、修正・保持の箇所と原因を result に記録する | `xep-condense-template.md` / `xer-condense-template.md` |
214
+ | `cross-deliverable-dedup` | 型寄せ | scope 内の成果物から正本を選び、他文書の重複を要約・参照へ置き換える。実践の型は変更せず、各成果物の必須情報と追跡性を維持する | [edit](../exec-templates/xep-cross-deliverable-dedup-template.md) / [result](../exec-templates/xer-cross-deliverable-dedup-template.md) |
213
215
 
214
216
  `retrofit` では、実装を現在動作(AS-IS)の根拠、既存成果物・決定記録・プロジェクトコンテキストを意図された仕様の根拠、`done_criteria` を成果物が満たすべき目的として扱います。三者が一致すれば成果物へ反映し、実装が意図された仕様と異なる場合は実装へ無条件に合わせず、乖離と修正対象候補を result に記録します。実装から確認できない目的・業務判断・将来方針は推測しません。
215
217
 
@@ -287,17 +289,19 @@ flowchart LR
287
289
 
288
290
  `approach` にかかわらず適用する原則です。
289
291
 
290
- - 矛盾時の優先: `draft` / `fully-guided` は rulebook(規約)を優先し、template の章構成が食い違っても rulebook を正とします。`recipe-guided` は rulebook を参照範囲に含めないため recipe を優先します。
292
+ - 書き方の矛盾時の優先: `draft` / `fully-guided` は rulebook(規約)を優先し、template の章構成が食い違っても rulebook を正とします。`recipe-guided` は rulebook を参照範囲に含めないため recipe を優先します。
291
293
  - 参照範囲: `fully-guided` は宣言された文書だけを参照します。対象成果物、rulebook / 併せて適用する rulebook / recipe / sample、`depends_on` 成果物、対象成果物 frontmatter の `based_on`、`project_context`、個票の `入力`、カタログの `brief` を含み、未宣言の文書や外部の情報は探索しません。`入力` と `brief` は未指定なら plan に載りません。`draft` はこれらに template・成果物内の文脈・任された調査に必要な出典つき外部情報を加えます。`recipe-guided` および未指定では、対象成果物に紐づく実践の型・`depends_on` 成果物・プロジェクトコンテキスト(→ [遂行の技活用ガイド](waza-guide.md))に限定し、他のプロジェクト文書を独自に探索しません。`freeform` は類似実例やプロジェクト文脈を参照するため対象外です。
294
+ - edit の実装の根拠: `draft` / `fully-guided` / `recipe-guided` は、plan に展開されたカタログの `evidence_refs` も読み取り専用で参照します。`recipe-guided` では個票の `入力` も参照します。実装は現在動作の事実、rulebook(`recipe-guided` では recipe)は書き方、`depends_on` と個票の `入力` は意図された仕様の根拠です。承認根拠のない乖離は意図された仕様を保持して result に記録し、実装から業務判断や将来方針を推測しません。実装の根拠は `targets`・変更許可範囲・commit 対象に含めません。`evidence_refs` 未指定やカタログなしだけでは異常終了しません。
295
+ - edit の未作成の依存: 上記 3 approach の plan は、未作成の `depends_on` を wikilink ではなくインラインコードと「未作成」で示します。未作成だけでは止めず、内容を推測せず _TODO_ / _ASSUMPTION_ と不足する根拠・次のアクションを残します。review や `condense` など他 approach の参照方針は変わりません。
292
296
  - 既存記述の尊重: `fully-guided` / `recipe-guided` および未指定では既存記述を尊重し、`depends_on` の最新の決定と矛盾する箇所、および参照範囲に含む実践の型に適合しない箇所(rulebook を参照範囲に含む `fully-guided` / 未指定では、rulebook の必須要素の欠落・禁止事項への抵触・章構成の不適合)のみ最小限を修正し、不足は加筆・補強します。実践の型への適合は内容の全面書き換えではなく、既存記述を保持したままの章立ての移し替えと必須要素の補完として行います。あわせて、同一成果物内で重複している記述は正本を1箇所に定めて統合し、参照範囲に含む実践の型の必須要素にも `done_criteria` にも寄与しない記述は削除します(rulebook を参照範囲に含む `fully-guided` / 未指定では rulebook の必須要素が基準)。統合・削除は既存記述の尊重の例外であり、判断根拠を result に記録することで担保します。`freeform` は対象外です。上記のいずれにも該当しない場合(完成度・整合性・読みやすさの向上など)は、それだけを理由に修正しません。rulebook が複数の構成を許容している場合(例: 領域単位・グループ単位のいずれの粒度も認める場合)、他章との見た目の整合を理由により詳細な構成へ書き換えません。
293
- - 根拠のない具体化の禁止: `freeform` と `draft` の文脈で任された範囲を除き、ファイルパス・コマンド・設定値など実装や設定の実態を示す記述を新たに書き加える場合、参照範囲の文書(rulebook / recipe / `depends_on` 成果物・プロジェクトコンテキスト、`fully-guided` ではさらに `based_on`・個票の `入力`・カタログの `brief`、`retrofit` では `evidence_refs`)で裏付けが取れる場合に限ります。既存記述が曖昧・不完全でも、裏付けが無ければ完成度を上げる目的だけで断定的に具体化しません。`draft` では任された範囲に限って調べて値を決め、成果物に「提案」と示し、出典と選定理由を result に残します。任されていない範囲や裏付けの無い箇所は _TODO_ / _ASSUMPTION_ として論点を残します。品質上の根拠不足は grade が該当 viewpoint の level と finding で評価し、review はその評価を付け直しません。
297
+ - 根拠のない具体化の禁止: `freeform` と `draft` の文脈で任された範囲を除き、ファイルパス・コマンド・設定値など実装や設定の実態を示す記述を新たに書き加える場合、参照範囲の文書(rulebook / recipe / `depends_on` 成果物・プロジェクトコンテキスト、`fully-guided` ではさらに `based_on`・個票の `入力`・カタログの `brief`、`retrofit` と上記 3 approach の edit では `evidence_refs`)で裏付けが取れる場合に限ります。既存記述が曖昧・不完全でも、裏付けが無ければ完成度を上げる目的だけで断定的に具体化しません。`draft` では任された範囲に限って調べて値を決め、成果物に「提案」と示し、出典と選定理由を result に残します。任されていない範囲や裏付けの無い箇所は _TODO_ / _ASSUMPTION_ として論点を残します。品質上の根拠不足は grade が該当 viewpoint の level と finding で評価し、review はその評価を付け直しません。
294
298
  - 判断根拠の記録: 参照した文書・しなかった文書とその理由を成果物または result に残します(特に `recipe-guided` / `freeform`)。後から実践の型を整備する材料になります。
295
299
  - 判定基準の優先: `done_criteria` と grade 結果が判定基準を示す場合はそれらを優先します。本原則は、判定基準だけでは読み取れない「どこまで参照に照らすか」を補います。
296
300
  - 前提・概要・判定基準の使い分け: カタログの `overview`(成果物の目的を1文で表す概要)、`brief`(成果物の外から継続して渡す技術スタックや制約などの前提)、`done_criteria`(成果物が満たすべき検証可能な完了条件)を明確に区別します。`brief` は schedule / register 両経路の plan に前提として展開され、未指定なら plan に載りません。複数の成果物で前提を共有する場合は YAML アンカー(`&anchor` / `*anchor`)を活用できます。前提を完了条件に混同せず、検証可能な基準だけを `done_criteria` に記載します。
297
301
 
298
302
  ### 1.4. 成果物カタログなしで進める
299
303
 
300
- register からの `draft`・`fully-guided`・`recipe-guided`・`freeform`・`retrofit`・`bootstrap`・`finalize`・`bootstrap-finalize` は、カタログなしでも使えます。既存成果物は `--target <doc-id>` を文書索引で引き、frontmatter の `specdojo.rulebook` を起点に kata を辿ります。新規成果物は `register add`・`register update` の `--target-path` と `--target-rulebook` にパスと rulebook ID を明示します。個票へ保存する名前は `target_path` と `target_rulebook` です。既存文書と指定が矛盾した場合は停止します。
304
+ register からの `draft`・`fully-guided`・`condense`・`recipe-guided`・`freeform`・`retrofit`・`bootstrap`・`finalize`・`bootstrap-finalize` は、カタログなしでも使えます。既存成果物は `--target <doc-id>` を文書索引で引き、frontmatter の `specdojo.rulebook` を起点に kata を辿ります。`condense` は既存成果物に限ります。新規成果物は `register add`・`register update` の `--target-path` と `--target-rulebook` にパスと rulebook ID を明示します。個票へ保存する名前は `target_path` と `target_rulebook` です。既存文書と指定が矛盾した場合は停止します。
301
305
 
302
306
  カタログの `done_criteria` はないため、個票の完了条件と rulebook を完了基準にします。`fully-guided` には `not-needed` を除く kata 一式、`recipe-guided` には recipe が必要で、不足すると起票時に停止します。`retrofit` では調べる実装のパスを個票に明記します。
303
307
 
@@ -313,6 +317,12 @@ register からの `draft`・`fully-guided`・`recipe-guided`・`freeform`・`re
313
317
 
314
318
  メンテナンスのタスクでは、対象の実践の型を「見直す対象」として扱い、複数の成果物・review result・対象領域の慣行を根拠に、次の観点で妥当性を見直します。対象の実践の型に finding がある場合は、finding の message と同じ viewpoint の判定根拠から指摘の根拠となる規範を特定し、紐づく rulebook / recipe / sample / template や執筆標準も必要な根拠として読みます。たとえば rulebook との構成不整合を指摘する finding では、成果物の有無にかかわらず rulebook を正として照合します。
315
319
 
320
+ 成果物の grade は、すべての観点の finding に原因 `cause` を付けます。原因は `document`、または Kata の種類と箇所を持つ `kata` です。Kata の箇所を根拠として示せない場合と、原因を持たない旧結果は `document` として扱います。Kata そのものの grade には原因を付けません。項目の形は [[specdojo:command-reference]] の grade の説明を参照してください。
321
+
322
+ 手入れの edit plan は、対象 Kata 自身の指摘に加え、「成果物から届いた Kata が原因の finding」節に、その Kata を rulebook 宣言から辿れる成果物の指摘を取り込みます。対象の種類と一致する原因だけを選び、現在の成果物全体のハッシュと一致する最新サイドカーから、成果物・行・観点・内容・Kata の箇所を1件ずつ載せます。`document` の指摘と、成果物が評価後に変わった古い指摘は取り込みません。`fully-guided` の磨き込み plan は、その成果物のすべての指摘を原因付きで載せます。Kata が原因でも成果物側の修正は必要です。
323
+
324
+ 同じ節には、宣言済みの Kata が原因の `condense` の記録も取り込みます。成果物ごとに最新の完了済み result を選び、空の記録で古い記録が復活しないようにします。出どころを `source=grade` / `source=condense` で区別し、condense は result ID と修正前の場所・種類・直し方・理由・Kata の箇所を示します。`document` の記録は取り込みません。記録形式は [[specdojo:plan-result-lifecycle-guide]] を参照してください。
325
+
316
326
  | `approach` | 見直す対象 | 主な見直し観点 |
317
327
  | ---------------------- | ---------- | ---------------------------------------------------------------- |
318
328
  | `rulebook-maintenance` | rulebook | 章構成、必須項目、禁止事項、判定基準 |
@@ -322,7 +332,7 @@ register からの `draft`・`fully-guided`・`recipe-guided`・`freeform`・`re
322
332
 
323
333
  根拠の種別を一律に必須化せず、finding ごとに指摘の解消を判定できる資料を使います。成果物または review result がないことだけを理由に根拠不足とは判定しません。finding の message と判定根拠、対象の実践の型から辿れる関連文書、該当する執筆標準、利用可能な成果物・review result・対象領域の慣行を確認しても修正内容を確定できない場合に限り、根拠不足として見送ります。見送る場合は、確認した資料、判断できなかった理由、不足している根拠、次のアクションを result に記録します。
324
334
 
325
- 実践の型メンテナンスは自動で差し込まれません。schedule で実行する場合は、`approach: rulebook-maintenance` のように対象を指定した phase / phase_set を `sch-strategy-<track>.yaml` に明示的に記述します([Schedule設計ガイド](schedule-design-guide.md))。
335
+ `schedule strategy generate` は `bootstrap-kata-set` の初期整備後と、`improve-kata` の `kata_target: rulebook` に、rulebook → recipe → sample → template の見直し段を生成します。`not-needed` の型は省略します。他の型を直接指定した `improve-kata` はその型だけが対象です。手で strategy を組む場合は、`approach: rulebook-maintenance` のように対象を指定した phase / phase_set を記述します([[specdojo:schedule-design-guide|Schedule設計ガイド]])。
326
336
 
327
337
  ## 3. review への適用
328
338
 
@@ -148,14 +148,15 @@ specdojo schedule strategy generate --project <project-id> --track <track> \
148
148
 
149
149
  `sch-strategy-<track>.yaml`(生成入力)から `sch-track-<track>.yaml`(生成物)への展開では、タスク単位で確定する実行情報だけを展開します。
150
150
 
151
- | 展開する情報 | 理由 |
152
- | ------------------ | -------------------------------------------------------- |
153
- | `name` | 実行者が作業を識別するために必要 |
154
- | `description` | エージェント・人間が実行時に参照するフェーズ指示 |
155
- | `target_local_ids` | 横断タスクの対象成果物群を plan / commit scope へ渡す |
156
- | `owner` | 誰が実行するかを決定するために必要 |
157
- | `duration_days` | CPM 計算に必要 |
158
- | `depends_on` | 実行順序の決定に必要。タスク ID に解決済みの形で展開する |
151
+ | 展開する情報 | 理由 |
152
+ | ------------------ | --------------------------------------------------------------------------------------------------------------------- |
153
+ | `name` | 実行者が作業を識別するために必要 |
154
+ | `description` | エージェント・人間が実行時に参照するフェーズ指示 |
155
+ | `target_local_ids` | 横断タスクの対象成果物群を plan / commit scope へ渡す |
156
+ | `owner` | 誰が実行するかを決定するために必要 |
157
+ | `duration_days` | CPM 計算に必要 |
158
+ | `depends_on` | 実行順序の決定に必要。タスク ID に解決済みの形で展開する |
159
+ | `agent` | phase の `agent` と `owner_rules[].phase_overrides[].agent` を解決した指名。plan だけで実行者を確かめられるようにする |
159
160
 
160
161
  トラック全体に共通する生成ルールや設計意図は strategy に留めます。
161
162
 
@@ -166,6 +167,8 @@ specdojo schedule strategy generate --project <project-id> --track <track> \
166
167
  | `cross_domain_dependencies` | 依存関係の設計意図。トラックには解決済み `depends_on` として反映 |
167
168
  | `phase_gates`・`group_milestones` | 生成ロジック。トラックにはマイルストーンとして展開済み |
168
169
 
170
+ `agent` もトラックへ展開しますが、実行時の解決は strategy を正とし、トラックの値では上書きしません。指名を変えるときは strategy を直し、`schedule build --track <track> --force` で作り直します。トラックを直接直すと、`exec validate` と `exec run --auto` が strategy から作り直した結果との違いを警告します。
171
+
169
172
  `description` をトラックへ展開するのは、エージェントや人間が plan ファイルだけを読んで実行できるようにするためです。strategy を参照させる方式は plan 生成時にファイルが 2 つ必要になり、自己完結性が損なわれます。
170
173
 
171
174
  反復タスクには、実行時にタスク ID の文字列解析へ依存しないよう、生成元を表す `phase_set`・`phase_id`・`phase_suffix` と、該当する `cycle`・`iteration` を展開します。
@@ -276,14 +279,14 @@ phase_sets:
276
279
  proficiency: expert
277
280
  ```
278
281
 
279
- | フィールド | 用途 |
280
- | -------------- | ------------------------------------------ |
281
- | `execution` | `agent` または `human`。省略時は `agent` |
282
- | `mode` | `edit` または `review`。省略時は `edit` |
283
- | `approach` | plan テンプレートの進め方を選ぶ |
284
- | `capabilities` | 必要なツールや能力を示す |
285
- | `proficiency` | 必要な習熟度を示す |
286
- | `agent` | executor / reporter を nickname で指名する |
282
+ | フィールド | 用途 |
283
+ | -------------- | ------------------------------------------------------------------- |
284
+ | `execution` | `agent` または `human`。省略時は `agent` |
285
+ | `mode` | `edit` または `review`。省略時は `edit` |
286
+ | `approach` | plan テンプレートの進め方を選ぶ |
287
+ | `capabilities` | 必要なツールや能力を示す |
288
+ | `proficiency` | 必要な習熟度を示す。`frontier` は明示要求時だけ自動選択の候補になる |
289
+ | `agent` | executor / reporter を nickname で指名する |
287
290
 
288
291
  `approach` の値ごとの意味と、rulebook / recipe / sample / template の参照方針は [実践の進め方ガイド](ryu-guide.md) を参照します。エージェント選択の詳細は [exec設定ガイド](exec-config-guide.md) を参照します。
289
292
 
@@ -320,7 +323,7 @@ phase_sets:
320
323
  - pipeline を指定した phase は agent 実行専用です。`execution: human` と併用できません。
321
324
  - `mode` と `approach` は phase 全体へ適用し、各 stage の agent 選択要件は stage 内の `capabilities` と `proficiency` で定義します。
322
325
  - 通常は `stage_role` と実行要件に一致する member を実行時に自動選択します。provider の利用枠を phase ごとに計画する場合は、phase の `agent.executor` / `agent.reporter` に `.specdojo/agent-members.yaml` の nickname を指定します。
323
- - `agent` と `agent_pipeline` は併用できます。`--executor-by` / `--reporter-by`、phase の `agent`、stage の `capabilities` / `proficiency` による自動選択の順で解決します。`owner_rules[].phase_overrides[].agent` では成果物単位に指名を上書きできます。
326
+ - `agent` と `agent_pipeline` は併用できます。`--executor-by` / `--reporter-by`、成果物単位に指名を上書きする `owner_rules[].phase_overrides[].agent`、phase の `agent`、stage の `capabilities` / `proficiency` による自動選択の順で解決します。ready の作り直し・タスクの表示・実行のどれでも同じ順で、strategy を持つトラックでは、トラックへ展開した `agent` を使いません(トラックへ展開する情報を参照)。
324
327
  - by-name の agent が rate limit になった場合は別 agent へ自動フォールバックせず、タスクを待機状態にします。再開時も同じ agent を使い、緊急の差し替えだけを CLI の stage override で行います。
325
328
  - 登録簿の項目(`exec run --register`)は per-item のパイプライン宣言を持たないため、`agent_pipeline` の YAML 定義は使いません。代わりに `--executor-by <nickname>` と `--reporter-by <nickname>` を両方指定すると、同じ executor/reporter 2段階(evidence の受け渡し・result 描画を含む)で実行します。詳細は [CLIコマンドリファレンス](../references/command-reference.md) の `exec run` を参照します。
326
329
 
@@ -332,8 +335,9 @@ phase_sets:
332
335
  2. `retrofit` edit: DCT の `evidence_refs` から各成果物を新設・補正する。
333
336
  3. `cross-deliverable-dedup`: 必要な場合だけ、成果物間の正本選択と重複整理を行う。
334
337
  4. `fully-guided`: 整備済みの実践の型に沿って内容を磨き込む。
335
- 5. `retrofit` review: 完成版と実装エビデンスの一致・乖離・未確認範囲を判定する。
336
- 6. `finalize` または `bootstrap-finalize`: human が成果物と必要な実践の型を確定する。
338
+ 5. `condense`: 意味と判断に要る情報を保ち、1 文書内の冗長さを整理して記録する。
339
+ 6. `retrofit` review: 完成版と実装エビデンスの一致・乖離・未確認範囲を判定する。
340
+ 7. `finalize` または `bootstrap-finalize`: human が成果物と必要な実践の型を確定する。
337
341
 
338
342
  `retrofit` を使う成果物には、事前に DCT の `evidence_refs` を宣言します。実装エビデンスは Schedule の依存関係ではなく調査入力であるため、`depends_on` や `targets` へ複製しません。
339
343
 
@@ -369,6 +373,7 @@ phase や owner rule に書く `approach` は、タスクの目的と実践の
369
373
  - `bootstrap` は `bootstrap_scope`(作成条件から必要と判断し、一式で初期整備する実践の型)と理由の記載が必要です。`not-needed` またはすべて利用可能な型を対象にできません。`retrofit` は解決済みの `evidence_refs` が 1 件以上必要です。
370
374
  - intent の欠落・重複、必要な grade や追加パラメータの欠落、参照切れがある場合は暫定 approach を使わず生成を停止します。
371
375
  - 標準 profile は `bootstrap`、`retrofit`、`draft`、`fully-guided`、`recipe-guided`、`freeform`、4種の maintenance、横断整理、`finalize` / `bootstrap-finalize` を、固定の phase ID・suffix・duration・execution・mode・agent pipeline へ写像します。`not-needed` の型に対応する maintenance は生成せず、成果物ごとに異なる profile は `owner_rules[].phase_sets` で分けます。
376
+ - `bootstrap-kata-set` は初期整備の後、rulebook → recipe → sample → template の見直しを経て、磨き込み・冗長整理・実装照合レビュー・確定へ進みます。`improve-kata` の `kata_target: rulebook` も同じ順で型一式を同期してからレビュー・確定へ進みます。recipe / sample / template を直接指定した場合は、その型だけを見直します。生成時に `not-needed` の段は省略し、実行までに不要と判断された段は変更せず理由を result に残します。型の整備段には Rulebook 記述標準、完成例の厚さ、詳細の正本参照の方針も含めます。
372
377
  - owner は明示オプション、既存 strategy、既定 owner の順に解決します。DCT の `done_criteria.roles` はレビュー観点なので、主担当へ流用しません。
373
378
  - generator は書き込み前に `schedule build --dry-run` 相当を実行します。全 strategy の project ID、参照、schema、milestone ID に問題があれば既存ファイルを上書きしません。
374
379
 
@@ -389,15 +394,16 @@ approach_rules:
389
394
  | 雛形作成・文脈記入 | `context-pass` | `010` | `human` | `edit` | `draft` |
390
395
  | 下書き | `guided-pass` | `020` | `agent` | `edit` | `draft` |
391
396
  | 磨き込み | `refine-pass` | `070` | `agent` | `edit` | `fully-guided` |
397
+ | 冗長さの整理 | `condense-pass` | `080` | `agent` | `edit` | `condense` |
392
398
  | 完成版レビュー | `review-pass` | `090` | `agent` | `review` | `fully-guided` |
393
399
  | 確定 | `finalize-pass` | `140` | `human` | `edit` | `finalize` |
394
400
 
395
- 雛形作成と文脈記入は一つの human 段にまとめます。雛形を人が確認してその場で文脈を記入でき、独立した空の待ち段を増やさずに draft へ渡せます。各段は直前の段に依存し、human の完了前に agent は着手しません。human 段には agent pipeline を付けません。
401
+ 雛形作成と文脈記入は一つの human 段にまとめます。雛形を人が確認してその場で文脈を記入でき、独立した空の待ち段を増やさずに draft へ渡せます。`condense-pass` の executor / reporter はともに `normal` です。`refine-pass` を含むすべての標準 profile に、磨き込みの後・review の前の段として生成します。既存 strategy は自動更新しません。各段は直前の段に依存し、human の完了前に agent は着手しません。human 段には agent pipeline を付けません。
396
402
 
397
403
  1. `specdojo exec claim --project <project-id> --task <context-task-id> --by <human>` で着手します。既存の human タスクと同じく plan は生成せず、claim が作成した result に作業案内と記録欄を持ちます。
398
404
  2. `specdojo deliverable scaffold --project <project-id> --target <doc-id>` で対象成果物の雛形を作成します。既存成果物は上書きせず、`--force` は指定しません。
399
405
  3. 対象本文の `_CONTEXT_:` に固定前提・制約・調査や選定を任せる範囲を書きます。例: `_CONTEXT_: 既存 API を維持し、認証方式の候補を調べて提案してほしい。` 記法は [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] の「文脈の目印」に従います。
400
- 4. result に対象と記入内容を残し、`specdojo exec complete --project <project-id> --task <context-task-id> --by <human>` で draft へ渡します。draft は指示を本文へ反映し、元の指示と反映箇所を実行記録へ残します。続いて refine・review を行い、最後に人が finalize を claim / complete して確定します。
406
+ 4. result に対象と記入内容を残し、`specdojo exec complete --project <project-id> --task <context-task-id> --by <human>` で draft へ渡します。draft は指示を本文へ反映し、元の指示と反映箇所を実行記録へ残します。続いて refine・condense・review を行い、最後に人が finalize を claim / complete して確定します。
401
407
 
402
408
  文脈の記入を待つ必要がない場合は従来の `author-deliverable` を使います。必要な型がそろった場合の `fully-guided` profile も、草案作成の `guided-pass` は `approach: draft` です。文脈や成果物が未作成でも template を骨組みにして根拠のある範囲を下書きします。文脈が無いことを調査・選定の委任とは解釈せず、未委任の判断は保留します。既存 strategy の段定義を更新するには `schedule strategy generate --force` の差分を確認して適用し、構造が変わる場合は `schedule build --force`、続いて `exec refresh` を実行します。
403
409
 
@@ -47,6 +47,8 @@ exec run --auto [--loop]
47
47
  -> 失敗: result を blocked に更新 / block / worktree を保持
48
48
  exec refresh
49
49
  -> 次の Ready タスクを更新
50
+ run の終わり
51
+ -> runner が書いたイベントと run の記録を記帳の commit 1件にまとめる
50
52
  ```
51
53
 
52
54
  `--loop --parallel <n>` では、最初に最大 `n` 件を起動した後、1件の agent が終了するたびに root 側の統合処理を終えて `exec refresh` を実行し、空いた枠へ次の Ready タスクを投入します。他の実行中 task の完了を待たないため、長時間 task と短時間 task が混在しても短時間 task の枠を継続利用できます。`--loop` を指定しない場合は、開始時に選択した最大 `n` 件だけを実行して終了します。
@@ -74,17 +76,22 @@ specdojo exec run --project <project-id> --auto --track data-flow-uc-rewrite --p
74
76
 
75
77
  ### 1.2. auto実行中の注意点
76
78
 
77
- `--auto` と `--loop` は root の現在ブランチへ task ごとの merge commit を繰り返します(checkpoint commit は exec branch 側に置き、root には plan / result / claim event の複製が未commitのまま残ります)。同じ作業ツリーで並行して手作業を行う場合は、次の安全ガードに注意します。
79
+ `--auto` と `--loop` は root の現在ブランチへ task ごとの merge commit を繰り返します(checkpoint commit は exec branch 側に置き、root には plan / result / claim event の複製が統合まで未commitのまま残ります。統合されずに残った複製は `実行記録の記帳` に従って run の終わりに commit します)。同じ作業ツリーで並行して手作業を行う場合は、次の安全ガードに注意します。
78
80
 
79
81
  | 状況 | 挙動 |
80
82
  | --------------------------------------------------------------------------- | ------------------------------------------------- |
81
- | root index に stage 済み変更がある | checkpoint 前に停止する |
83
+ | root index の stage 済み変更が checkpoint 対象と重複する | checkpoint 前に停止する |
84
+ | root index に stage 済み変更がある | merge 前に対象パスと解除手順を示して停止する |
82
85
  | root の未commit変更(runner が置いた複製を除く)と merge 対象パスが重複する | merge 前に停止する |
83
86
  | agent が失敗して `blocked` になる | worktree を保持し、auto の Ready 選択から除外する |
84
87
  | プロセス中断で `doing` が残る | `exec resume` で再開する |
85
88
 
86
89
  parallel 実行中でも、claim、checkpoint、merge、complete、`exec refresh` は runner が直列化します。agent プロセスだけを並列に走らせ、root 側の状態更新や Ready 再計算は1件ずつ処理します。
87
90
 
91
+ review plan の生成前に runner が実行する grade は、再試行状態を `<execution_path>/grade/generated/runs/<grade-run-id>/pipeline/` へ run ごとに保存します。grade の agent や応答の適用が失敗しても共有の `grade/pipeline/` は変えず、別 review の統合確認を妨げません。失敗内容は review plan に渡され、評価結果の鮮度に応じた review 判定に使います。正本の評価結果・完了条件詳細の checkpoint と統合前の変更検出は引き続き行います。
92
+
93
+ stage 済み変更による停止では、表示された worktree で対象を commit するか、各パスに `git restore --staged -- <path>` を実行してから `exec resume` します。後者はファイルの内容を残して stage だけを解除します。runner は別タスクや手作業の変更を自動で commit・unstage しません。
94
+
88
95
  agent が成功した後、runner は commit / merge / worktree 削除へ進む前に、最新の event log から task state を再構築し、`exec complete` と同じ完了可否を検証します。task が `doing` でない場合や、実行 actor が claim actor と一致しない場合は統合を中止し、成果物を未統合のまま worktree に保持します。これにより、`exec resume --by` などで別 actor を指定しても、Schedule が `doing` のまま成果物だけが統合される状態を防ぎます。
89
96
 
90
97
  auto 実行と並行して人が作業する場合は、別ブランチの worktree を作成して編集します。
@@ -93,6 +100,23 @@ auto 実行と並行して人が作業する場合は、別ブランチの workt
93
100
  git worktree add ../specdojo-edit -b <edit-branch>
94
101
  ```
95
102
 
103
+ ### 1.3. 実行記録の記帳
104
+
105
+ 統合の merge commit に入るのは、その時点までのイベント(claim)と run の記録だけです。統合の後に書く complete、失敗・延期の block、再開の unblock・release・claim、保持した worktree に対応する root の plan / result の複製は、merge commit に入りません。runner は `exec run`(Schedule の `--auto` と `--task --worktree`)、`exec resume`、`exec cycle` の終わりに、これらを `exec(run): record execution events and run records` という記帳の commit 1件にまとめます。成功・失敗・延期・再開のどれで終わっても、作業ツリーに実行記録を残しません。
106
+
107
+ | 記帳の commit に入るもの | 条件 |
108
+ | ------------------------------- | ----------------------------------------------------------------------------------------- |
109
+ | `exec/events/*.json` | `by` が `.specdojo/agent-members.yaml` の agent(runner が書いたイベント) |
110
+ | `runs/schedule/<task-id>/` 配下 | 上のイベントの task の plan・result・evidence・pipeline-state・ログ(退避した試行を含む) |
111
+ | `plan-conventions/` 配下 | 上の run の記録を 1 件以上含む場合 |
112
+
113
+ - 対象は root の未 commit のファイルだけで、前の run で残った runner の記録も次の run の終わりに拾います。
114
+ - commit した後に `plan.md`・`result.md`・`evidence.json` がそろわない run(setup や executor の起動前に止まり plan だけを残した run など)は記帳せず、作業ツリーに残してディレクトリと次の操作を標準エラーに出力します。commit すると `exec validate --records-only` が欠落で失敗するためです。run を再開して記録をそろえるか、executor の起動前に止まった run ならディレクトリを消します。result.md を外して再試行するときも、HEAD に result.md がない run は丸ごと外します。
115
+ - 人が `exec claim`・`complete`・`block`・`release` などで書いたイベント(`by` が agent でないもの)と、human タスクの run の記録は、従来どおり記帳する人が commit します。
116
+ - commit は統合と同じ scheduler lock で直列化し、index.lock の競合は解放を待って再試行します(待ち時間は [exec 設定ガイド](exec-config-guide.md) の `run.git_index_lock_wait_seconds`)。pre-commit hook(整形・markdownlint・実行記録の認証情報検査)は通常どおり実行し、result.md の記法違反で拒否された場合は result.md を外して再試行します。
117
+ - それでも commit できない場合、run の終了コードは変えず、残ったファイルと次の操作を標準エラーに出力します。原因を直して commit するか、次の `exec run` / `exec resume` で記帳をやり直します。
118
+ - 保持した worktree を後で統合するとき、記帳済みの plan / result と exec branch 側で更新した同じファイルが競合した場合は、その task の run の記録に限って exec branch 側(最新の記録)で解決します。
119
+
96
120
  ## 2. 手動実行
97
121
 
98
122
  自動実行がまとめて行う各段階を、人が確認しながら順に進める経路です。
@@ -147,7 +171,7 @@ plan を先に生成して内容を確認・編集してから実行できます
147
171
 
148
172
  ```bash
149
173
  specdojo exec plan --project <project-id> --task <task-id>
150
- specdojo exec run --project <project-id> --plan <execution-path>/exec/plans/<task-id>-plan.md
174
+ specdojo exec run --project <project-id> --plan <execution-path>/runs/schedule/<task-id>/<run-id>/plan.md
151
175
  ```
152
176
 
153
177
  schedule のタスクから plan を生成するときは、Prettier による整形・ファイルへの書き込みより前に、phase の `description` を展開した plan 全体を markdownlint で検査します。箇条書きの前に空行がない場合(MD032)などは、タスク ID・plan のパス・生成内容の行番号・規則名を表示して停止し、既存の plan は上書きしません。表示する行番号は strategy YAML ではなく、整形前の plan に対する番号です。strategy の説明を修正し、`schedule build --track <track> --force` でトラックを更新してから plan を再生成してください。
@@ -245,10 +245,10 @@ CLI の導入は
245
245
 
246
246
  ### 8.3. 成果物の作成を計画する
247
247
 
248
- | 目的 | 参照先 |
249
- | ------------------------------------------------------------------------------------------ | ---------------------------------------------- |
250
- | 複数トラックの着手順序・並行可否を計画し、カタログ作成から Schedule 展開までを見通す | [Timeline設計ガイド](timeline-design-guide.md) |
251
- | 成果物カタログから Schedule への流れを理解する、フェーズ・タスク・依存関係・反復を設計する | [Schedule設計ガイド](schedule-design-guide.md) |
248
+ | 目的 | 参照先 |
249
+ | ------------------------------------------------------------------------------------------ | ------------------------------------------------------- |
250
+ | epic の依存・範囲・期間で全体計画を管理する | [[specdojo:register-operation-guide\|登録簿運用ガイド]] |
251
+ | 成果物カタログから Schedule への流れを理解する、フェーズ・タスク・依存関係・反復を設計する | [Schedule設計ガイド](schedule-design-guide.md) |
252
252
 
253
253
  ### 8.4. プロジェクトを実行・管理する
254
254
 
@@ -268,6 +268,7 @@ CLI の導入は
268
268
  | worktreeを使って手動で隔離実行する | [exec worktree運用ガイド](exec-worktree-guide.md) |
269
269
  | 対話でCLI操作を進める | [オーケストレーター運用ガイド](orchestrator-operation-guide.md) |
270
270
  | 任意の Dev Container や常時稼働ホストで実行環境を分離する | [常時稼働ホスト運用ガイド](remote-host-development-guide.md) |
271
+ | プロジェクトを管理用の別リポジトリへ移す手順と安全確認を行う | [[specdojo:project-move-guide\|プロジェクト移行ガイド]] |
271
272
 
272
273
  登録簿を agent 実行と並行して記帳する場合は、記帳コマンドの `--commit` が同じ project の `register lifecycle` 枠を使います。provider 設定を配布するときは `config scaffold` を使い、Antigravity の `--global` はすべてのリポジトリに効くため dry-run 後に適用します。Dev Container は必須ではなく、必要な場合だけ `devcontainer scaffold` で追加します。各操作の詳細は上表のガイドと [CLIコマンドリファレンス](../references/command-reference.md) を参照してください。
273
274