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
@@ -156,19 +156,35 @@ type は派生ビューの生成と `exec run --register` の挙動(`agent実
156
156
 
157
157
  ### 1.4. track の仕事を epic と子 todo で管理する
158
158
 
159
- epic は `track` を Frontmatter に持ち、子 todo と schedule の進捗を材料に、人が完了を判断します。`tml-index.yaml` がある場合は、定義済みの track だけを指定できます。timeline がない project でも track の識別子を保持できます。
159
+ epic は track ごとの全体計画の正本です。順序は epic 間の `depends_on`、範囲は `domains`、期間は予定開始日 `start_on`・着手・完了の記録と `due_on` で管理します。未着手の計画も `open` の epic として起票し、epic がない track は全体計画に出しません。子 todo と schedule の進捗を材料に、人が完了を判断します。
160
160
 
161
161
  ```bash
162
- specdojo register add --type epic --title "業務の仕様整備" --topic business-specs --track business
162
+ specdojo register add --type epic --title "業務の仕様整備" --topic business-specs \
163
+ --track business --domain business-model --start-on 2026-11-09 --due 2026-11-30
163
164
  specdojo register add --type todo --title "カタログを作成する" --topic business-catalog --from PJR-AB12
164
- specdojo register update --id PJR-AB12 --track business
165
+ specdojo register update --id PJR-AB12 --track business --domain business-model
165
166
  specdojo register build
167
+ specdojo dashboard build
166
168
  ```
167
169
 
168
- `PJR-AB12` は作成した epic の ID に置き換えます。`--track` は epic で必須で、`update` では別の識別子に置換できます。削除(`--track -`)とほかの type への指定は拒否します。timeline の配置は project の `timeline_path` に従い、省略時は project 配下の `timeline/tml-index.yaml` を参照します。add・update・build で track を検証し、変更は event に記録します。
170
+ `PJR-AB12` は作成した epic の ID に置き換えます。`--track` は epic で必須で、`update` では別の識別子に置換できます。削除(`--track -`)とほかの type への指定は拒否します。track の重複は add・update・build で、epic 間の依存循環は build で拒否します。旧 timeline への track 登録は不要です。
171
+
172
+ `--domain` は epic にだけ繰り返し指定でき、`update` では一覧を置き換えます。`--domain -` 単独で削除できます。domain の一部だけを対象にする場合は個票の範囲の章に境界を書き、strategy の `scope.catalogs[].local_ids` で限定します。strategy と未作成カタログの範囲は既存 strategy の scope、epic の `domains`、互換用 timeline の順で解決し、空の scope や `domains: []` も明示指定として扱います。変更は event に記録します。
173
+
174
+ `--start-on` は epic にだけ指定できる予定開始日です。実在する暦日を `YYYY-MM-DD` で指定し、未定なら省略します。`update` では未指定なら保持し、`--start-on -` で削除します。ほかの type への指定と不正な日付は、個票・event を書く前に拒否します。
169
175
 
170
176
  `register build` は `generated/pjr-epic-items.md` に、epic ごとの直接の子項目とその type・現在の状態を表示します。別 project の子も project 修飾 ID で表示し、子がない epic も残します。孫は再帰的に表示しません。子の状態から epic を自動 close せず、完了基準を満たしたことを人が確認して `register close --id <epic-id> --conclusion "判断の根拠"` で `done` にします。`reject` / `defer` / `reopen` も todo と同じように使用できます。
171
177
 
178
+ ### 1.5. 全体計画を確認する
179
+
180
+ `dashboard build` は epic の依存順に全体計画の表とガントを `execution/generated/` へ出力します。カレンダーは `sch-defaults.yaml` を使います。
181
+
182
+ 開始日は `start_on`、epic 自身の最初の着手 event、先行 epic の最も遅い終了日の翌稼働日の順に使います。どれも求められなければ未定です。子 todo の着手や起票日からは補いません。
183
+
184
+ 終了日は完了した epic なら `completed_at`、未完了なら `due_on` を使います。開始日と終了日がそろえば稼働日数とガントの期間を表示します。期限のない未完了 epic の終了日は未定です。先行 epic の終了日が未定でも、後続自身の予定開始日や着手記録があれば開始日に使います。`start_on` が `due_on` より後なら `register build` が警告し、開始日が終了日より後になる場合も含めて期間は未定とし、後続への終了日の引き継ぎも止めます。`derived_from` は起票の由来であり、全体計画の順序には使いません。
185
+
186
+ `execution/generated/catalog-scaffold.md` には未作成の domain のカタログと作成コマンドを出力します。旧 timeline の移行は [[specdojo:timeline-design-guide|Timeline からの移行ガイド]] を参照してください。
187
+
172
188
  ## 2. 登録項目のライフサイクル
173
189
 
174
190
  登録から完了までの状態遷移、個票の扱い、完了時の記録、派生ビューを示します。
@@ -253,6 +269,8 @@ specdojo register close \
253
269
 
254
270
  `--commit` は register の worktree 実行の記帳・統合と同じ `register lifecycle` 枠が空くまで待ち、枠の内側で記帳、`register build` 相当の検証・再生成、commit を順に行います。commit 対象はそのコマンドが新たに変更した個票・event・参照文書だけで、開始前からあるほかの未 commit 変更は残します。対象個票やevent自体に開始前の変更がある場合は、既存差分を混ぜないため書き込み前に停止します。既定の件名は `docs(register PJR-XXXX): <command> <title>` で、`-m <message>` または `--message <message>` で上書きできます。`--dry-run` と同時に指定した場合は表示だけを行い、枠の取得と commit は行いません。
255
271
 
272
+ ほかのファイルがすでに stage されていても、初回 commit と hook 整形後の amend は対象パスだけを記録し、既存の staged 変更を保持します。実行中に別タスクの exec event が増えても対象へ取り込みません。stage 後の検査や commit・amend が失敗した場合、または `SIGINT`・`SIGTERM`・`SIGHUP` で中断された場合は、そのコマンドが stage した対象だけを unstage し、作業ツリーの本文を残します。Git の実行中に届いた中断は Git が戻ってから処理します。初回 commit 後の失敗・中断では commit が残るため、本文と HEAD の差分を確認してから再実行してください。
273
+
256
274
  別 project への起票では、対象登録簿全体が clean であることを追加で確認します。元の作業ツリーのブランチと HEAD は変更しません。
257
275
 
258
276
  ### 2.2. 個票の作成
@@ -495,6 +513,10 @@ specdojo register update --project <project-id> --id PJR-0012 \
495
513
 
496
514
  夜間実行は `specdojo orchestrator night` が担います。worktree 隔離、post-review、自動 close / `waiting` への復帰を必須とし、件数、並列数、連続失敗停止、rate limit 時の fallback をオプションで制限します。承認範囲外の操作が必要になった失敗は、元項目を `derived_from` に持つ issue として起票します。結果は `execution/reports/night-orchestrator/` の朝報告 1 文書へ集約します。
497
515
 
516
+ 朝報告は `type: project`・`status: draft`・`rulebook: none` の管理文書として生成し、番号付きの「1. 集計」「2. 実行結果」を記録します。Job の review 前に、通常の成果物と同じ frontmatter・Markdown 検査の対象になります。
517
+
518
+ merge に commit-msg hook を使うリポジトリでは、Git が hook に渡すメッセージファイルを検査してください。Lefthook の設定例は `run: npx commitlint --edit "{1}"` です。`$1` は Lefthook の引数置換ではないため、ファイル名が渡らず `COMMIT_EDITMSG` を検査する場合があります。merge で渡される `MERGE_MSG` と異なり、linked worktree では未作成、主の作業ツリーでは古い内容が残っていることがあります。検査を省略せず、両方の作業ツリーで有効な merge メッセージの受理と無効なメッセージの拒否を確かめてください。
519
+
498
520
  定期起動は Job `job-night-approved-register` と routine `rtn-night-approved-register` を使います。サンプル routine は保護された運用設定を勝手に有効化しないため `enabled: false` です。人が 2 時(Asia/Tokyo)、一晩 10 件、並列 2、連続失敗 2 件、fallback executor を確認してから有効化してください。
499
521
 
500
522
  ## 4. 例外対応と特殊な運用
@@ -82,10 +82,14 @@ npx specdojo devcontainer scaffold --provider claude,codex --editor emacs
82
82
 
83
83
  生成される `.devcontainer/emacs/init.el` は、`~/.emacs`、`~/.emacs.el`、`~/.emacs.d/init.el`、`~/.config/emacs/init.el` のいずれも無い場合だけコピーされます。空の `~/.emacs.d` があればその中の `init.el` へ、なければ `~/.config/emacs/init.el` へ配置し、配置先を出力します。初回作成前の既定値は生成されたテンプレートで変更でき、作成後は出力されたコピー先を編集します。dotfiles が設定を配置していれば上書きされません。
84
84
 
85
+ tmux を含める構成(`--tmux`、または preset に `recommended` 以上を指定)では、マウス操作(`set -g mouse on`)、クリップボード(`set -g set-clipboard on`)、256 色(`set -g default-terminal "tmux-256color"` と `set -as terminal-overrides ',*:Tc'`)を設定した `.devcontainer/tmux.conf` を生成します。コンテナ作成時に `post-create.sh` がこのファイルを `~/.tmux.conf` へシンボリックリンク(`ln -sfn`)します。利用者が既に独自の `~/.tmux.conf`(シンボリックリンクでない通常ファイル)を持っている場合は上書きせず、既存の設定を保護します。また、tmux を含めない構成では `tmux.conf` もリンク処理も生成されません。
86
+
85
87
  scaffold は、常時稼働ホストへの接続と tmux セッションの維持に使えるサンプルを `.devcontainer/remote-host/` に生成します。
86
88
 
87
- - `specdojo-tmux.sh.sample`: 常時稼働ホストの `~/bin/specdojo-tmux.sh` などへコピーし、実行権限(`chmod +x`)を付与して使います。ラベル(`devcontainer.local_folder`)が一致するコンテナだけを探して接続し、停止していれば `devcontainer up` で起動してからコンテナ内の tmux セッション(`specdojo`)へ接続します。ホスト名や作業パスはプレースホルダーになっているため、ホストの環境に合わせて調整してください。
88
- - `ssh-config.sample`: 接続元端末の `~/.ssh/config` へ追加して使います。ホストへの通常接続エイリアスと、`RemoteCommand` と `RequestTTY force` で `specdojo-tmux.sh` を直接呼び出すエイリアス(`Host <host>-tmux`)を含みます。`RemoteCommand` では端末の `PATH` の設定が読み込まれないため、接続元から `ssh <host> 'command -v devcontainer'` を実行して Dev Container CLI が見つかるか確かめられます。
89
+ - `specdojo-tmux.sh.sample`: 常時稼働ホストの `~/bin/specdojo-tmux.sh` などへコピーし、実行権限(`chmod +x`)を付与して使います。workspace のパスを渡して、SpecDojo が配布する本体スクリプト(`.specdojo/host/devcontainer-tmux.sh`)を呼び出す数行のラッパーです。本体スクリプトは `npx specdojo devcontainer host-script` で workspace へ書き出せます。
90
+ - `ssh-config.sample`: 接続元端末の `~/.ssh/config` へ追加して使います。ホストへの通常接続エイリアスと、`RemoteCommand` と `RequestTTY force` で `specdojo-tmux.sh` を直接呼び出すエイリアス(`Host <host>-tmux`)を含みます。通常の接続(稼働中または停止中のコンテナ)では Node.js は不要(Docker のみ使用)です。コンテナ未作成時のみ Dev Container CLI が起動されます。
91
+
92
+ 本体スクリプト(`devcontainer-tmux.sh`)の対応 OS は macOS、Linux、Windows の WSL2 です。稼働中のコンテナがあればそのまま tmux へ入り、停止中のコンテナがあれば `docker start` で起動してから接続するため、通常の接続ではホスト側に Node.js は不要です。コンテナが存在しないときだけ `devcontainer up` を動かします。Dev Container CLI の場所は環境変数 `SPECDOJO_NODE_BIN` で上書きでき、mise を使う場合は shims のディレクトリ(例: `~/.local/share/mise/shims`)を設定します。指定がない場合は利用者のログインシェル(`"$SHELL" -lic`)経由で起動します。コンテナ内の作業ディレクトリはマウント情報から、実行ユーザーは `devcontainer.json` の `remoteUser` から自動で求めます。
89
93
 
90
94
  `devcontainer.json` の `appPort` や `forwardPorts` で開発サーバなどの公開ポートを設定している場合は、接続用エイリアスに `LocalForward` の行が含まれます。開発サーバのポートを増やしたときは、`~/.ssh/config` の tmux 接続用エイリアスにも `LocalForward <ポート> 127.0.0.1:<ポート>` を追加してください。
91
95
 
@@ -199,13 +203,38 @@ Host <ホスト名>
199
203
 
200
204
  ### 6.2. 実行環境の起動に失敗する
201
205
 
202
- SSH 経由の非対話シェル(`RemoteCommand` など)では、ログインシェルや対話端末で読み込まれる `~/.zshrc` などの `PATH` の設定が読み込まれないため、コンテナ起動用のコマンドが見つからない場合があります。接続元から次を実行して確認します。
206
+ 新方式では、稼働中または停止中のコンテナへの接続は Docker コマンドのみで行うためホスト側に Node.js は不要です。コンテナが存在しない初回起動時のみ、`devcontainer up` を動かします。
207
+
208
+ SSH 経由の非対話シェル(`RemoteCommand` など)では、ログインシェルや対話端末で読み込まれる `~/.zshrc` などの `PATH` の設定が読み込まれず、Docker や起動用コマンドが見つからない場合があります。本体スクリプトは、最初に Docker を呼ぶ前に次の順序で実行ファイルを探します。
209
+
210
+ 1. `SPECDOJO_DOCKER_BIN` が指定されていれば、そのディレクトリの `docker` を使用する。
211
+ 2. 現在の `PATH` で探す。
212
+ 3. ログインシェル(`"$SHELL" -lc`。`SHELL` が未設定なら `/bin/bash`)に `command -v docker` を問い合わせる。起動時のメッセージは無視し、実行できるファイルのパスだけを採る。
213
+ 4. `/usr/local/bin`、`/opt/homebrew/bin`、`$HOME/.docker/bin`、`/Applications/Docker.app/Contents/Resources/bin`、`/snap/bin`、`/usr/bin` の順に探す。
214
+
215
+ 見つかったディレクトリを `PATH` の先頭へ追加し、以降の Docker 呼び出しと `devcontainer up` に引き継ぎます。`SPECDOJO_DOCKER_BIN` に指定するのは実行ファイル自体ではなく、`docker` があるディレクトリです。明示指定が無効な場合は、ほかの場所に切り替えずエラーで停止します。SSH の接続先で、例えば次のように指定できます。
216
+
217
+ ```bash
218
+ SPECDOJO_DOCKER_BIN=/opt/homebrew/bin bash .specdojo/host/devcontainer-tmux.sh /path/to/workspace
219
+ ```
220
+
221
+ Docker が見つからない場合は、探索した場所と OS ごとの対処方法を標準エラーへ出して終了コード 1 で停止します。見つかっても `docker info` に失敗すれば、コンテナを探す前に同様に停止します。
222
+
223
+ | ホスト | Docker が見つからないとき | `docker info` が失敗するとき |
224
+ | ------------ | ---------------------------------------------------------------------------------- | -------------------------------------------------------------------------- |
225
+ | macOS | Docker Desktop を導入する | Docker Desktop を起動し、Docker context を確認する |
226
+ | Windows WSL2 | Docker Desktop を起動し、対象ディストリビューションの WSL integration を有効にする | Docker Desktop の起動と WSL integration を確認する |
227
+ | Linux | Docker Engine を導入する | docker サービスを起動し、`docker` グループへの所属を確認してログインし直す |
228
+
229
+ 既存の workspace へ本体の更新を反映するには、更新後の SpecDojo で `npx specdojo devcontainer host-script` を再実行します。ホスト側のラッパーはそのまま使えます。
230
+
231
+ コンテナ未作成時の Dev Container CLI の探索は、接続元から次を実行して確認します。
203
232
 
204
233
  ```bash
205
234
  ssh <ホスト名> 'command -v devcontainer'
206
235
  ```
207
236
 
208
- `devcontainer` が見つからない場合は、ホスト側の通常端末で `dirname "$(command -v devcontainer)"` を実行して場所を確認し、`specdojo-tmux.sh` の `node_bin_dir` に設定してください。詳細な `PATH` を確認する場合は次を実行します。
237
+ `devcontainer` が見つからない場合は、ホスト側の環境変数 `SPECDOJO_NODE_BIN` に Dev Container CLI や Node.js の bin ディレクトリを設定してください。mise を使う場合は shims のディレクトリ(例: `~/.local/share/mise/shims`)を指定します。詳細な `PATH` を確認する場合は次を実行します。
209
238
 
210
239
  ```bash
211
240
  ssh <ホスト名> 'printf "PATH=%s\n" "$PATH"; command -v node || true; command -v devcontainer || true'
@@ -50,15 +50,15 @@ grade と review は判定する対象が異なります。2 つは重複する
50
50
 
51
51
  review では次を入力として扱います。確認に用いる文書は review plan に記載されたものに限ります。
52
52
 
53
- | 入力 | 正本ファイル | 役割 |
54
- | -------------- | ------------------------------ | ------------------------------------------------------------------------------ |
55
- | 評価結果 | grade result サイドカー | grade の verdict・score・観点ごとの level・finding。review plan にも提示される |
56
- | review plan | `exec/plans/<task-id>-plan.md` | 対象成果物、評価結果、完了条件、進め方を固定する |
57
- | 実行記録 | 先行する edit タスクの result | 何を変更し、どの検証を実行したか |
58
- | 対象成果物 | - | 変更内容を確かめる対象の Markdown / YAML / JSON など |
59
- | 成果物カタログ | `dct-*.yaml` | 成果物、依存関係、`done_criteria`(text / roles / viewpoint)を定義する |
60
- | 関連成果物 | - | `depends_on` 成果物とプロジェクトコンテキスト |
61
- | 登録簿 | `generated/pjr-index.md` | 未解決事項、課題、リスク、変更要求、決定の転記先 |
53
+ | 入力 | 正本ファイル | 役割 |
54
+ | -------------- | ---------------------------------------------------- | ------------------------------------------------------------------------------ |
55
+ | 評価結果 | grade result サイドカー | grade の verdict・score・観点ごとの level・finding。review plan にも提示される |
56
+ | review plan | `execution/runs/schedule/<task-id>/<run-id>/plan.md` | 対象成果物、評価結果、完了条件、進め方を固定する |
57
+ | 実行記録 | 先行する edit タスクの result | 何を変更し、どの検証を実行したか |
58
+ | 対象成果物 | - | 変更内容を確かめる対象の Markdown / YAML / JSON など |
59
+ | 成果物カタログ | `dct-*.yaml` | 成果物、依存関係、`done_criteria`(text / roles / viewpoint)を定義する |
60
+ | 関連成果物 | - | `depends_on` 成果物とプロジェクトコンテキスト |
61
+ | 登録簿 | `generated/pjr-index.md` | 未解決事項、課題、リスク、変更要求、決定の転記先 |
62
62
 
63
63
  ### 1.3. grade・機械検証・review の分担
64
64
 
@@ -207,11 +207,11 @@ edit タスク(成果物を作る・直す)
207
207
  ↓
208
208
  grade(成果物を評価する。評価結果が最新なら再実行しない)
209
209
  ↓
210
- exec plan / exec run → review plan(exec/plans/<task-id>-plan.md。評価結果を提示する)
210
+ exec plan / exec run → review plan(execution/runs/schedule/<task-id>/<run-id>/plan.md。評価結果を提示する)
211
211
  ↓
212
212
  human / agent review(タスクの完了可否を判断する)
213
213
  ↓
214
- review result(exec/results/<task-id>-result.md)
214
+ review result(execution/runs/schedule/<task-id>/<run-id>/result.md)
215
215
  ↓
216
216
  完了 / 再評価 / 再計画
217
217
  ```
@@ -240,9 +240,12 @@ edit plan で観点別の自己レビューを行わないのは、各観点を
240
240
  この自動 grade は同じ npm package の `grade run` を使います。開発用スクリプトの配置は不要です。選択した review agent の実体名と起動設定を引き継ぎ、対象 1 件の plan 生成・評価・サイドカー反映を実行します。成果物の grade には project の `catalog_path` が必要です。単独の実行や部品ごとの手順は [[specdojo:command-reference|CLI コマンドリファレンス]] を参照してください。
241
241
 
242
242
  - 評価対象は成果物です。`approach` が `rulebook-maintenance` / `recipe-maintenance` / `sample-maintenance` / `template-maintenance` の場合は、見直した実践の型そのものが評価対象になります(`--target kata`)。
243
+ - Schedule の intent が `improve-kata` / `bootstrap-kata-set` の場合は、review の `approach` にかかわらず、代表成果物に加えて rulebook と宣言済みの sample・recipe・template も順に grade します。複数の sample はすべて対象です。sample が `not-needed` なら除外し、未宣言・`undecided` や `bootstrap_scope` の未解決参照は完了を保留します。型すべての最新 grade が `pass` であることを追加完了条件とし、`needs-work` / `fail` は `incomplete`、未評価・古い結果・参照未解決は `grade-stale`、読取不能は `grade-unavailable` にします。`complete-with-findings` による迂回はできません。runner も result の完了判定をこの条件で制限します。
243
244
  - 評価対象の `content_hash` が既存の評価結果サイドカーの `content_hash` と一致する場合は、grade を再実行せず既存の評価結果を使います。どちらの場合も評価は 1 回です。
244
245
  - grade は `grade run --path <対象文書>` で評価対象 1 件に絞って実行します。評価対象を解決できない場合と `--dry-run` の場合は実行しません。
245
- - grade が失敗しても review は止めません。実行の結果と評価結果の鮮度を review plan に示し、review が verdict(`grade-stale` / `grade-unavailable` など)として記録します。
246
+ - grade が失敗した場合は、別の run ID で合計 3 回まで試します。それでも失敗した場合も review は止めず、実行の結果と評価結果の鮮度を review plan に示し、review が verdict(`grade-stale` / `grade-unavailable` など)として記録します。ただし runner はそのタスクを done にせず blocked にし、失敗の理由と次の操作を block の理由と result の `block_reason` に残します。
247
+ - schedule の review を再開するとき(reporter や executor からの再開)も、runner は review の agent より前に grade を確かめます。worktree の評価結果サイドカーが root の最新と違う場合は、exec branch へ取り込む commit を作ります。plan の評価結果の節は前回の実行の時点のままなので、再開の時点の評価結果を agent への指示に足します。取り込みがあった reporter からの再開では、古い grade で判定した executor の結果を使い回さず、executor から流し直します。
248
+ - 自動 grade は `--if-busy wait` で同一 project の実行終了を待ち、`--isolate-pipeline-state` で再試行状態を run 内へ分離します。同じ秒に複数の型を評価しても run ID が衝突しないよう、対象パスの識別子を含めます。
246
249
 
247
250
  ### 3.3. review plan の生成
248
251
 
@@ -266,12 +269,12 @@ review plan の `評価結果` 章には、評価結果を確定済みの事実
266
269
 
267
270
  ### 3.4. review plan の配置
268
271
 
269
- review plan は `<execution_path>/exec/plans/<task-id>-plan.md` に生成します。`<execution_path>` はプロジェクトの実行ディレクトリ(例: `execution`)を指します。
272
+ review plan は `<execution_path>/runs/schedule/<task-id>/<run-id>/plan.md` に生成します(register の post-review では `runs/register/<項目 ID>/<run ID>/plan.md`)。`<execution_path>` はプロジェクトの実行ディレクトリ(例: `execution`)を指します。
270
273
 
271
274
  例
272
275
 
273
276
  ```text
274
- exec/plans/T-LAUNCH-prj-overview-030-plan.md
277
+ execution/runs/schedule/T-LAUNCH-prj-overview-030/<run-id>/plan.md
275
278
  ```
276
279
 
277
280
  ### 3.5. review plan の構成
@@ -306,13 +309,13 @@ specdojo:
306
309
 
307
310
  ### 3.6. review execution
308
311
 
309
- 人または agent は review plan に従って review します。`<execution_path>/exec/results/<task-id>-result.md` は `specdojo exec claim` の時点で scaffold される(手動 claim でも `exec run` 経由の claim でも同様)ため、agent または人はそこに結果を記入します。
312
+ 人または agent は review plan に従って review します。`<execution_path>/runs/schedule/<task-id>/<run-id>/result.md`(register の post-review では `runs/register/<項目 ID>/<run ID>/result.md`)は `specdojo exec claim` の時点で scaffold される(手動 claim でも `exec run` 経由の claim でも同様)ため、agent または人はそこに結果を記入します。
310
313
 
311
314
  agent に review を実行させる場合は、`exec run --plan` で executor と reporter を指定して 2 段で実行します。
312
315
 
313
316
  ```bash
314
317
  # review を 2 段で実行する
315
- npx specdojo exec run --project <project-id> --plan <execution_path>/exec/plans/<task-id>-plan.md \
318
+ npx specdojo exec run --project <project-id> --plan <execution_path>/runs/schedule/<task-id>/<run-id>/plan.md \
316
319
  --executor-by <executor-nickname> --reporter-by <reporter-nickname>
317
320
  ```
318
321
 
@@ -329,7 +332,7 @@ review で `approach` に応じて何を確かめるかは、plan の `進め方
329
332
 
330
333
  ### 3.7. review result の構成
331
334
 
332
- review result は `<execution_path>/exec/results/<task-id>-result.md` に生成・更新します。
335
+ review result は `<execution_path>/runs/schedule/<task-id>/<run-id>/result.md`(register の post-review では `runs/register/<項目 ID>/<run ID>/result.md`)に生成・更新します。
333
336
 
334
337
  ```yaml
335
338
  specdojo:
@@ -339,7 +342,7 @@ specdojo:
339
342
  mode: review
340
343
  status: in_progress | complete | blocked
341
344
  project_id: <project_id>
342
- plan_ref: exec/plans/<task-id>-plan.md
345
+ plan_ref: runs/schedule/<task-id>/<run-id>/plan.md
343
346
  started_at: <ISO8601>
344
347
  completed_at: <ISO8601>
345
348
  agent: <member nickname>
@@ -353,7 +356,7 @@ specdojo:
353
356
  | approach に応じた確認 | `approach` に応じて確認した内容 |
354
357
  | decision | `verdict`(タスク完了可否の 6 値。値の一覧は次のとおり) |
355
358
 
356
- `verdict` は `complete` / `complete-with-findings` / `incomplete` / `grade-stale` / `grade-unavailable` / `changed-during-review` のいずれかです。`pm-review-viewpoints.yaml` の `verdict_definitions` も同じ 6 値を定義します。各値を選ぶ条件は共通規約の `review の判断手順` を正本とします。verdict が `complete` 以外でも、review result を記録できた場合は正常終了します。runner は verdict に応じて再評価または再計画へ進みます。
359
+ `verdict` は `complete` / `complete-with-findings` / `incomplete` / `grade-stale` / `grade-unavailable` / `changed-during-review` のいずれかです。`pm-review-viewpoints.yaml` の `verdict_definitions` も同じ 6 値を定義します。各値を選ぶ条件は共通規約の `review の判断手順` を正本とします。verdict が `complete` 以外でも、review result を記録できた場合は正常終了します。runner は verdict に応じて再評価または再計画へ進みます。schedule のタスクでは、`grade-stale` / `grade-unavailable` / `changed-during-review` の review を done にせず blocked にします。
357
360
 
358
361
  ### 3.8. grade の結果を review の入力にする規則
359
362
 
@@ -71,6 +71,8 @@ action の `commit: true` は互換として残しています。`task.review`
71
71
 
72
72
  統合前 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
73
 
74
+ `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 前のリポジトリではファイルの差分だけで判定します。
75
+
74
76
  出力 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
77
 
76
78
  #### waiting Run の確認・統合・破棄
@@ -156,11 +158,11 @@ action:
156
158
  args: [dashboard, build]
157
159
  ```
158
160
 
159
- Job Definition を持たないため、実行記録は `generated/routine-runs.jsonl` の 1 行だけで、Job Run と evidence は作られません。agent を呼ぶ処理や成果物を変更する処理には使わず、`kind: job` を使います。
161
+ Job Definition を持たないため、Job Run と evidence は作られません。成功時の実行履歴は端末側の `routine-runs.jsonl` にだけ残ります。失敗時の保存先は次節の規則に従います。agent を呼ぶ処理や成果物を変更する処理には使わず、`kind: job` を使います。
160
162
 
161
163
  ### 1.2. grade の単段評価
162
164
 
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` を入力します。
165
+ 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` は本体リポジトリにだけある `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` を入力します。
164
166
 
165
167
  成果物は `rtn-grade-deliverable-recheck` が `job-grade-deliverable` を起動します。Job は同じ script を `--stages 1 --target deliverable` で実行し、成果物カタログから変更済み・未評価・段未完了・旧 rubric の Markdown 成果物だけを最大10件選びます。評価結果は成果物の最新 grade と成果物ごとの `done_criteria` 詳細へ上書きされるため、実行ごとの review result は増やしません。
166
168
 
@@ -181,10 +183,10 @@ npx tsx src/specdojo.ts grade list --target deliverable --project prj-0001 --rub
181
183
 
182
184
  両 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
185
 
184
- | 段 | agent | 対象と役割 |
185
- | ------ | ----------------------------------- | ------------------------------------------------------------ |
186
- | 判定 | `codex-expert-executor` / `machine` | 対象文書を英語で評価し、正本の判定を確定する |
187
- | 表示化 | `gemma26-translator` | finding の英語原文だけを日本語へ翻訳し、表示文として付加する |
186
+ | 段 | agent | 対象と役割 |
187
+ | ------ | ----------------------------------- | ------------------------------------------------------------- |
188
+ | 判定 | `codex-expert-executor` / `machine` | 対象文書を日本語で評価し、正本の判定を確定する |
189
+ | 表示化 | `gemma26-translator` | 英語の finding が残る場合だけ日本語へ翻訳し、表示文を付加する |
188
190
 
189
191
  Job runnerは、この入口をmaterialize済みの引数で1回起動し、コマンド、終了コード、stdout/stderrをevidenceへ記録します。コマンドが成功した場合だけanalysis reporterが、未完了の段、失敗の切り分け、verdict と score の偏りを判断します。executor、reporter(既定は機械変換の `machine`)、対象種別、件数上限はscriptの引数またはJobの`inputs`から解決します。
190
192
 
@@ -194,9 +196,13 @@ Job Definition は script を `if` の条件として起動し、終了コード
194
196
 
195
197
  ## 2. due判定と実行
196
198
 
197
- 最終実行時刻と結果は `<routines-path>/generated/routine-state.json` に記録され、`interval`(`30m` / `6h` / `1d` / `1w` 形式)が経過したものを due と判定します。配列 action の場合は段別結果も同じ state に記録します。多重起動は lock で防ぐため、外部スケジューラが重複起動しても同じ routine が二重に走ることはありません。
199
+ 最終実行時刻と結果は端末側の `routine-state.json` に記録され、`interval`(`30m` / `6h` / `1d` / `1w` 形式)が経過したものを due と判定します。配列 action の場合は段別結果も同じ state に記録します。多重起動は同じ保存先の lock で防ぎます。
200
+
201
+ 実行履歴は同じ保存先の `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 の日別実績表示に使います。
202
+
203
+ 保存先は `$XDG_STATE_HOME/specdojo/<repository-key>/routines/<path-key>/`、環境変数が未設定または相対パスなら `~/.local/state/specdojo/` 以下です。repository key は Git 共通ディレクトリの実パス(Git がなければリポジトリの実パス)、path key はリポジトリからの routine 定義の相対パスの SHA-256 です。linked worktree 間で共有し、別リポジトリ・別 routine ツリーを分離します。`routine where` で実際のパスを確認できます。初回の `routine list`・通常実行・dashboard 集計時に旧 `generated/` の状態と履歴をコピーし、新しいファイルがあれば上書きしません。旧ファイルは復旧用に残しますが以後は参照しません。移行前に旧版の routine プロセスを停止してください。別端末へ状態を引き継ぐ場合はこの保存先を別途コピーします。
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
+ routine 自身が Git に残すのは、結果が `failure` かつ関連 Job Run ID が空の実行だけです。`<execution-path>/routines/failures/<routine-id>/<UUID>.json` に履歴と同じ項目と `run_id` を書き、理由を伏せ字処理したうえで、そのファイルだけを commit します。Job Run があればその記録を診断に使います。成功・skip・無変更の履歴は端末側にだけ保存し、dashboard も同じ状態・履歴を参照します。lock は文書ツリー外にあり、`.gitignore` の追加設定は不要です。
200
206
 
201
207
  単一オブジェクトの `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
208
 
@@ -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
 
@@ -332,8 +332,9 @@ phase_sets:
332
332
  2. `retrofit` edit: DCT の `evidence_refs` から各成果物を新設・補正する。
333
333
  3. `cross-deliverable-dedup`: 必要な場合だけ、成果物間の正本選択と重複整理を行う。
334
334
  4. `fully-guided`: 整備済みの実践の型に沿って内容を磨き込む。
335
- 5. `retrofit` review: 完成版と実装エビデンスの一致・乖離・未確認範囲を判定する。
336
- 6. `finalize` または `bootstrap-finalize`: human が成果物と必要な実践の型を確定する。
335
+ 5. `condense`: 意味と判断に要る情報を保ち、1 文書内の冗長さを整理して記録する。
336
+ 6. `retrofit` review: 完成版と実装エビデンスの一致・乖離・未確認範囲を判定する。
337
+ 7. `finalize` または `bootstrap-finalize`: human が成果物と必要な実践の型を確定する。
337
338
 
338
339
  `retrofit` を使う成果物には、事前に DCT の `evidence_refs` を宣言します。実装エビデンスは Schedule の依存関係ではなく調査入力であるため、`depends_on` や `targets` へ複製しません。
339
340
 
@@ -369,6 +370,7 @@ phase や owner rule に書く `approach` は、タスクの目的と実践の
369
370
  - `bootstrap` は `bootstrap_scope`(作成条件から必要と判断し、一式で初期整備する実践の型)と理由の記載が必要です。`not-needed` またはすべて利用可能な型を対象にできません。`retrofit` は解決済みの `evidence_refs` が 1 件以上必要です。
370
371
  - intent の欠落・重複、必要な grade や追加パラメータの欠落、参照切れがある場合は暫定 approach を使わず生成を停止します。
371
372
  - 標準 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` で分けます。
373
+ - `bootstrap-kata-set` は初期整備の後、rulebook → recipe → sample → template の見直しを経て、磨き込み・冗長整理・実装照合レビュー・確定へ進みます。`improve-kata` の `kata_target: rulebook` も同じ順で型一式を同期してからレビュー・確定へ進みます。recipe / sample / template を直接指定した場合は、その型だけを見直します。生成時に `not-needed` の段は省略し、実行までに不要と判断された段は変更せず理由を result に残します。型の整備段には Rulebook 記述標準、完成例の厚さ、詳細の正本参照の方針も含めます。
372
374
  - owner は明示オプション、既存 strategy、既定 owner の順に解決します。DCT の `done_criteria.roles` はレビュー観点なので、主担当へ流用しません。
373
375
  - generator は書き込み前に `schedule build --dry-run` 相当を実行します。全 strategy の project ID、参照、schema、milestone ID に問題があれば既存ファイルを上書きしません。
374
376
 
@@ -389,15 +391,16 @@ approach_rules:
389
391
  | 雛形作成・文脈記入 | `context-pass` | `010` | `human` | `edit` | `draft` |
390
392
  | 下書き | `guided-pass` | `020` | `agent` | `edit` | `draft` |
391
393
  | 磨き込み | `refine-pass` | `070` | `agent` | `edit` | `fully-guided` |
394
+ | 冗長さの整理 | `condense-pass` | `080` | `agent` | `edit` | `condense` |
392
395
  | 完成版レビュー | `review-pass` | `090` | `agent` | `review` | `fully-guided` |
393
396
  | 確定 | `finalize-pass` | `140` | `human` | `edit` | `finalize` |
394
397
 
395
- 雛形作成と文脈記入は一つの human 段にまとめます。雛形を人が確認してその場で文脈を記入でき、独立した空の待ち段を増やさずに draft へ渡せます。各段は直前の段に依存し、human の完了前に agent は着手しません。human 段には agent pipeline を付けません。
398
+ 雛形作成と文脈記入は一つの human 段にまとめます。雛形を人が確認してその場で文脈を記入でき、独立した空の待ち段を増やさずに draft へ渡せます。`condense-pass` の executor / reporter はともに `normal` です。`refine-pass` を含むすべての標準 profile に、磨き込みの後・review の前の段として生成します。既存 strategy は自動更新しません。各段は直前の段に依存し、human の完了前に agent は着手しません。human 段には agent pipeline を付けません。
396
399
 
397
400
  1. `specdojo exec claim --project <project-id> --task <context-task-id> --by <human>` で着手します。既存の human タスクと同じく plan は生成せず、claim が作成した result に作業案内と記録欄を持ちます。
398
401
  2. `specdojo deliverable scaffold --project <project-id> --target <doc-id>` で対象成果物の雛形を作成します。既存成果物は上書きせず、`--force` は指定しません。
399
402
  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 して確定します。
403
+ 4. result に対象と記入内容を残し、`specdojo exec complete --project <project-id> --task <context-task-id> --by <human>` で draft へ渡します。draft は指示を本文へ反映し、元の指示と反映箇所を実行記録へ残します。続いて refine・condense・review を行い、最後に人が finalize を claim / complete して確定します。
401
404
 
402
405
  文脈の記入を待つ必要がない場合は従来の `author-deliverable` を使います。必要な型がそろった場合の `fully-guided` profile も、草案作成の `guided-pass` は `approach: draft` です。文脈や成果物が未作成でも template を骨組みにして根拠のある範囲を下書きします。文脈が無いことを調査・選定の委任とは解釈せず、未委任の判断は保留します。既存 strategy の段定義を更新するには `schedule strategy generate --force` の差分を確認して適用し、構造が変わる場合は `schedule build --force`、続いて `exec refresh` を実行します。
403
406