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
@@ -0,0 +1,217 @@
1
+ #!/usr/bin/env bash
2
+ #
3
+ # devcontainer-tmux.sh
4
+ #
5
+ # SpecDojo が配布する、ホストから devcontainer 内の tmux セッションへ入るためのスクリプト本体です。
6
+ # workspace の .specdojo/host/devcontainer-tmux.sh へ書き出され、ホスト側のラッパーから呼ばれます。
7
+ #
8
+ # 対応 OS:
9
+ # - macOS
10
+ # - Linux
11
+ # - Windows WSL2
12
+ #
13
+ set -euo pipefail
14
+
15
+ if [ $# -lt 1 ] || [ -z "${1:-}" ]; then
16
+ echo "Usage: $0 <workspace-path>" >&2
17
+ exit 1
18
+ fi
19
+
20
+ workspace_dir_input="$1"
21
+ if [ ! -d "$workspace_dir_input" ]; then
22
+ echo "Workspace directory not found: $workspace_dir_input" >&2
23
+ exit 1
24
+ fi
25
+
26
+ workspace_dir="$(cd "$workspace_dir_input" && pwd -P)"
27
+
28
+ devcontainer_json="$workspace_dir/.devcontainer/devcontainer.json"
29
+ if [ ! -f "$devcontainer_json" ]; then
30
+ if [ -f "$workspace_dir/.devcontainer.json" ]; then
31
+ devcontainer_json="$workspace_dir/.devcontainer.json"
32
+ else
33
+ echo "devcontainer.json was not found in $workspace_dir" >&2
34
+ exit 1
35
+ fi
36
+ fi
37
+
38
+ remote_user="$(sed -E -e 's,//.*$,,' -e 's,/\*.*\*/,,' "$devcontainer_json" | grep -E '"remoteUser"[[:space:]]*:' | head -n 1 | sed -E 's/.*"remoteUser"[[:space:]]*:[[:space:]]*"([^"]+)".*/\1/' || true)"
39
+
40
+ if [ -z "$remote_user" ]; then
41
+ echo "remoteUser is not defined in $devcontainer_json" >&2
42
+ exit 1
43
+ fi
44
+
45
+ # docker の探索は最初の呼び出しより前に行う。SSH の PATH だけには依存しない。
46
+ docker_dir=""
47
+ docker_search_path="$PATH"
48
+ docker_login_shell="${SHELL:-/bin/bash}"
49
+ docker_candidates=(
50
+ /usr/local/bin
51
+ /opt/homebrew/bin
52
+ "${HOME:-}/.docker/bin"
53
+ /Applications/Docker.app/Contents/Resources/bin
54
+ /snap/bin
55
+ /usr/bin
56
+ )
57
+
58
+ select_docker() {
59
+ local candidate="$1" candidate_dir
60
+ # command -v が返す alias や関数の説明は受け付けない。
61
+ case "$candidate" in
62
+ */docker) ;;
63
+ *) return 1 ;;
64
+ esac
65
+ [ -f "$candidate" ] && [ -x "$candidate" ] || return 1
66
+ candidate_dir="${candidate%/*}"
67
+ candidate_dir="$(cd "${candidate_dir:-/}" && pwd -P)" || return 1
68
+ docker_dir="$candidate_dir"
69
+ }
70
+
71
+ docker_hint() {
72
+ local failure="$1" host_os kernel
73
+ host_os="$(uname -s 2>/dev/null || true)"
74
+ kernel="$(uname -r 2>/dev/null || true)"
75
+ case "$host_os" in
76
+ Darwin)
77
+ if [ "$failure" = missing ]; then
78
+ echo "macOS: Install Docker Desktop." >&2
79
+ else
80
+ echo "macOS: Start Docker Desktop and check the Docker context." >&2
81
+ fi
82
+ ;;
83
+ Linux)
84
+ if printf '%s\n' "$kernel" | grep -qi microsoft || grep -qi microsoft /proc/version 2>/dev/null; then
85
+ echo "WSL2: Start Docker Desktop and enable WSL integration for this distribution." >&2
86
+ elif [ "$failure" = missing ]; then
87
+ echo "Linux: Install Docker Engine." >&2
88
+ else
89
+ echo "Linux: Start the docker service and check membership in the docker group (then log in again)." >&2
90
+ fi
91
+ ;;
92
+ *) echo "Install and start Docker, and check the Docker context and access permissions." >&2 ;;
93
+ esac
94
+ }
95
+
96
+ if [ -n "${SPECDOJO_DOCKER_BIN:-}" ]; then
97
+ # 明示指定はディレクトリ。誤指定を別の Docker で隠さず、下で診断する。
98
+ select_docker "$SPECDOJO_DOCKER_BIN/docker" || true
99
+ else
100
+ if ! select_docker "$(command -v docker || true)"; then
101
+ # 起動時のメッセージを無視し、問い合わせの印が付いた実行ファイルだけを採る。
102
+ # shellcheck disable=SC2016
103
+ login_output="$("$docker_login_shell" -lc 'printf "\n__SPECDOJO_DOCKER__"; command -v docker' 2>/dev/null)" || login_output=""
104
+ while IFS= read -r line; do
105
+ case "$line" in
106
+ __SPECDOJO_DOCKER__*)
107
+ if select_docker "${line#__SPECDOJO_DOCKER__}"; then
108
+ break
109
+ fi
110
+ ;;
111
+ esac
112
+ done <<< "$login_output"
113
+ if [ -z "$docker_dir" ]; then
114
+ for candidate_dir in "${docker_candidates[@]}"; do
115
+ if select_docker "$candidate_dir/docker"; then
116
+ break
117
+ fi
118
+ done
119
+ fi
120
+ fi
121
+ fi
122
+
123
+ if [ -z "$docker_dir" ]; then
124
+ echo "Docker executable not found." >&2
125
+ if [ -n "${SPECDOJO_DOCKER_BIN:-}" ]; then
126
+ echo "Searched SPECDOJO_DOCKER_BIN: $SPECDOJO_DOCKER_BIN/docker (must be an executable file)." >&2
127
+ else
128
+ echo "Searched PATH: $docker_search_path" >&2
129
+ echo "Queried login shell: $docker_login_shell -lc 'command -v docker'" >&2
130
+ printf 'Searched directory: %s\n' "${docker_candidates[@]}" >&2
131
+ fi
132
+ docker_hint missing
133
+ exit 1
134
+ fi
135
+
136
+ export PATH="$docker_dir:$PATH"
137
+ if ! docker info >/dev/null 2>&1; then
138
+ echo "Docker is not usable: $docker_dir/docker (docker info failed)." >&2
139
+ docker_hint unavailable
140
+ exit 1
141
+ fi
142
+
143
+ # 1. 動いているコンテナを探す
144
+ container_id="$(docker ps -q --filter "label=devcontainer.local_folder=$workspace_dir" | head -n 1)"
145
+
146
+ # 2. 止まっているコンテナがあれば docker start で起こす
147
+ if [ -z "$container_id" ]; then
148
+ stopped_id="$(docker ps -a -q --filter "label=devcontainer.local_folder=$workspace_dir" | head -n 1)"
149
+ if [ -n "$stopped_id" ]; then
150
+ docker start "$stopped_id" >/dev/null
151
+ container_id="$stopped_id"
152
+ fi
153
+ fi
154
+
155
+ # 3. コンテナが無いときだけ devcontainer up を動かす
156
+ if [ -z "$container_id" ]; then
157
+ echo "Starting devcontainer for $workspace_dir..." >&2
158
+ if [ -n "${SPECDOJO_NODE_BIN:-}" ]; then
159
+ PATH="$docker_dir:$SPECDOJO_NODE_BIN:$PATH" devcontainer up --workspace-folder "$workspace_dir" >&2
160
+ else
161
+ # shellcheck disable=SC2016
162
+ "${SHELL:-/bin/bash}" -lic 'export PATH="$1:$PATH"; exec devcontainer up --workspace-folder "$2"' devcontainer-launcher "$docker_dir" "$workspace_dir" >&2
163
+ fi
164
+ container_id="$(docker ps -q --filter "label=devcontainer.local_folder=$workspace_dir" | head -n 1)"
165
+ fi
166
+
167
+ if [ -z "$container_id" ]; then
168
+ echo "Failed to start or find devcontainer for $workspace_dir" >&2
169
+ exit 1
170
+ fi
171
+
172
+ # 4. コンテナ内の作業ディレクトリをマウント情報から求める
173
+ mounts_info="$(docker inspect --format '{{range .Mounts}}{{printf "%s\t%s\t%s\n" .Type .Source .Destination}}{{end}}' "$container_id")"
174
+ best_match_src=""
175
+ best_match_dst=""
176
+
177
+ while IFS=$'\t' read -r m_type m_src m_dst; do
178
+ [ "$m_type" != "bind" ] && continue
179
+ [ -z "$m_src" ] && continue
180
+
181
+ norm_src="$m_src"
182
+ if [ -d "$m_src" ]; then
183
+ norm_src="$(cd "$m_src" && pwd -P)"
184
+ fi
185
+
186
+ if [ "$workspace_dir" = "$norm_src" ]; then
187
+ best_match_src="$norm_src"
188
+ best_match_dst="$m_dst"
189
+ break
190
+ elif [ "${workspace_dir#"$norm_src"/}" != "$workspace_dir" ]; then
191
+ if [ ${#norm_src} -gt ${#best_match_src} ]; then
192
+ best_match_src="$norm_src"
193
+ best_match_dst="$m_dst"
194
+ fi
195
+ fi
196
+ done <<< "$mounts_info"
197
+
198
+ if [ -z "$best_match_src" ]; then
199
+ echo "Could not determine container workspace directory from mounts for: $workspace_dir" >&2
200
+ exit 1
201
+ fi
202
+
203
+ if [ "$workspace_dir" = "$best_match_src" ]; then
204
+ container_workspace_dir="$best_match_dst"
205
+ else
206
+ rel_path="${workspace_dir#"$best_match_src"/}"
207
+ container_workspace_dir="${best_match_dst%/}/$rel_path"
208
+ fi
209
+
210
+ if ! docker exec "$container_id" test -d "$container_workspace_dir"; then
211
+ echo "Workspace directory '$container_workspace_dir' does not exist in container '$container_id'." >&2
212
+ exit 1
213
+ fi
214
+
215
+ # 5. tmux セッションへ入る
216
+ session_name="${SPECDOJO_TMUX_SESSION:-specdojo}"
217
+ exec docker exec -it --detach-keys="ctrl-]" -u "$remote_user" -w "$container_workspace_dir" "$container_id" tmux new-session -A -s "$session_name"
@@ -5,104 +5,16 @@
5
5
  # 常時稼働ホスト上で devcontainer 内の tmux セッションへ入るためのスクリプトです。
6
6
  # ホスト側の ~/bin/specdojo-tmux.sh などへコピーし、実行権限(chmod +x)を付与して使用してください。
7
7
  #
8
- # 前提ツール:
9
- # - Docker (Docker Desktop または Docker Engine): コンテナの実行環境
10
- # - Dev Container CLI (@devcontainers/cli): コンテナの起動に使用 (npm install -g @devcontainers/cli)
11
- # - tmux: コンテナ内にインストールされている必要があります
12
- #
13
- # 起動コマンド:
14
- # - コンテナ起動: devcontainer up --workspace-folder "$workspace_dir"
15
- # - セッション接続: docker exec -it ... tmux new-session -A -s <名前>
16
- #
17
- # コンテナの特定(ラベルの一致):
18
- # - スクリプトはラベル devcontainer.local_folder が workspace_dir と一致する
19
- # コンテナを探して接続します。
20
- # - ラベルが workspace_dir と一致しないと、devcontainer up が別の新しいコンテナを作ります。
21
- # - 既存コンテナのラベルは次のコマンドで確認できます:
22
- # docker inspect <id> --format '{{index .Config.Labels "devcontainer.local_folder"}}'
8
+ # 実際の処理本体は各 workspace の .specdojo/host/devcontainer-tmux.sh が行います。
9
+ # 本体のスクリプトは `npx specdojo devcontainer host-script` で書き出せます。
23
10
  #
24
- # 利用者(ユーザー)の変更:
25
- # - devcontainer.json の remoteUser(既定は node)に合わせて -u でコンテナに入ります。
26
- # - remoteUser を変更した場合は、下記 container_user の値を変更してください。
27
- #
28
- # PATH の設定(SSH 経由での実行):
29
- # - ssh の RemoteCommand は非対話シェルで動くため、Mac の通常端末で読み込まれる
30
- # ~/.zshrc などの PATH の設定が反映されません。
31
- # - ホスト側の通常端末で node と devcontainer の配置場所を確認し、必要に応じて
32
- # 下記 node_bin_dir を設定してください:
33
- # dirname "$(command -v devcontainer)"
34
- # - Homebrew の例: node_bin_dir="/opt/homebrew/bin"
35
- # - nvm の例: node_bin_dir="$HOME/.nvm/versions/node/v22.0.0/bin"
36
- # - mise の例: node_bin_dir="$HOME/.local/share/mise/installs/node/24/bin"
37
- # - node と Dev Container CLI は同じ node_bin_dir にあることを前提とします。
11
+ # 前提ツール:
12
+ # - Docker (Docker Desktop または Docker Engine)
13
+ # - Dev Container CLI (@devcontainers/cli): コンテナ未作成時のみ起動に使用
38
14
  #
39
15
  set -euo pipefail
40
16
 
41
- # コンテナ内とホスト側の作業ディレクトリ(実際の環境に合わせて設定してください)
42
- container_workspace_dir="/workspaces/<workspace-name>/<repo-name>"
43
- workspace_dir="${HOME}/<path-to-workspace>/<repo-name>"
44
-
45
- # コンテナ内の実行ユーザー(devcontainer.json の remoteUser に合わせます。既定は node です)
46
- # remoteUser を変更した場合は、この値を変更してください。
47
- container_user="node"
48
-
49
- # セッション名(必要に応じて変更してください)
50
- session_name="specdojo"
51
-
52
- # Mac や Linux の通常端末で確認した実際のディレクトリへ置き換えてください。
53
- # Homebrew の例: node_bin_dir="/opt/homebrew/bin"
54
- # nvm の例: node_bin_dir="$HOME/.nvm/versions/node/v22.0.0/bin"
55
- # mise の例: node_bin_dir="$HOME/.local/share/mise/installs/node/24/bin"
56
- # node と Dev Container CLI は同じ node_bin_dir にあることを前提とします。
57
- node_bin_dir="/absolute/path/to/node/bin"
58
- export PATH="$node_bin_dir:/opt/homebrew/bin:/usr/local/bin:$PATH"
59
-
60
- find_container() {
61
- docker ps -q --filter "label=devcontainer.local_folder=$workspace_dir" | head -n 1
62
- }
63
-
64
- if [ ! -f "$workspace_dir/.devcontainer/devcontainer.json" ]; then
65
- echo "devcontainer.json was not found: $workspace_dir" >&2
66
- echo "Set workspace_dir to the repository path on the host." >&2
67
- exit 1
68
- fi
69
-
70
- if ! command -v devcontainer >/dev/null 2>&1; then
71
- echo "Dev Container CLI is not installed or not in PATH." >&2
72
- echo "Current PATH: $PATH" >&2
73
- echo "Check the location on the host terminal with: dirname \"\$(command -v devcontainer)\"" >&2
74
- echo "Install it with: npm install -g @devcontainers/cli" >&2
75
- exit 1
76
- fi
77
-
78
- if ! command -v docker >/dev/null 2>&1; then
79
- echo "Docker command was not found in PATH." >&2
80
- echo "Current PATH: $PATH" >&2
81
- echo "Check the location on the host terminal with: dirname \"\$(command -v docker)\"" >&2
82
- exit 1
83
- fi
84
-
85
- if ! docker info >/dev/null 2>&1; then
86
- echo "Docker is not running on the host." >&2
87
- exit 1
88
- fi
89
-
90
- container_name="$(find_container)"
91
-
92
- if [ -z "$container_name" ]; then
93
- echo "Starting devcontainer..." >&2
94
- devcontainer up --workspace-folder "$workspace_dir" >&2
95
- container_name="$(find_container)"
96
- fi
97
-
98
- if [ -z "$container_name" ]; then
99
- echo "The devcontainer did not start." >&2
100
- exit 1
101
- fi
102
-
103
- if ! docker exec "$container_name" test -d "$container_workspace_dir"; then
104
- echo "Workspace directory '$container_workspace_dir' was not found in container '$container_name'." >&2
105
- exit 1
106
- fi
17
+ # ホスト上のワークスペースのパス(実際の配置場所に合わせて書き換えてください)
18
+ workspace_dir="${1:-$HOME/<path-to-workspace>/<repo-name>}"
107
19
 
108
- exec docker exec -it --detach-keys="ctrl-]" -u "$container_user" -w "$container_workspace_dir" "$container_name" tmux new-session -A -s "$session_name"
20
+ exec bash "$workspace_dir/.specdojo/host/devcontainer-tmux.sh" "$workspace_dir"
@@ -8,8 +8,10 @@ Host <host>
8
8
 
9
9
  # devcontainer 内の tmux セッションへ直接入る接続用
10
10
  # RemoteCommand は非対話シェルで動くため、接続先端末の ~/.zshrc などの PATH 設定は読み込まれません。
11
+ # 通常の接続(コンテナ稼働中または停止中)では Node.js は不要です(docker のみ使用)。
12
+ # コンテナ未作成時のみ Dev Container CLI が自動起動されます。
11
13
  # 接続元から「ssh <host> 'command -v devcontainer'」を実行して Dev Container CLI が見つかるか確認できます。
12
- # 見つからない場合は、ホスト側の ~/bin/specdojo-tmux.sh の node_bin_dir を設定してください。
14
+ # 見つからない場合は、ホストの環境変数 SPECDOJO_NODE_BIN を設定するか、ログインシェルの PATH を確認してください。
13
15
  Host <host>-tmux
14
16
  HostName <host>
15
17
  User <user>
@@ -0,0 +1,6 @@
1
+ # Enable mouse interactions, including scrolling through pane history with the wheel.
2
+ set -g mouse on
3
+ set -g set-clipboard on
4
+
5
+ set -g default-terminal "tmux-256color"
6
+ set -as terminal-overrides ',*:Tc'
@@ -282,6 +282,7 @@ members:
282
282
  type: agent
283
283
  provider: antigravity
284
284
  model: gemini-3.8-flash-high
285
+ mode: report
285
286
  stage_role: reporter
286
287
  capabilities: []
287
288
  proficiency: normal
@@ -92,7 +92,7 @@ providers:
92
92
  # 使える model の ID は `agy models` で確かめる。Gemini の Pro 系は提供されなくなったため、
93
93
  # expert は Flash の high とする(2026-10-15、agy 1.3.5 で確認)。
94
94
  # model の ID は実体の member の model に書く(PJR-ZM1K)。
95
- command_template: 'agy --sandbox --add-dir "$(pwd)" --model {model} -p "$(cat)"'
95
+ command_template: 'specdojo agent launch --provider antigravity --role {mode} -- --sandbox --model {model} -p "$(cat)"'
96
96
  rate_limit_detection:
97
97
  stderr_patterns: [rate limit, "429", quota, RESOURCE_EXHAUSTED]
98
98
  copilot:
@@ -279,6 +279,7 @@ npx specdojo exec validate --project <project-id>
279
279
  - 完了条件にない変更(特に保護された設定や、利用者の環境に関わる設定)が入っていないかを確かめる。
280
280
  - runner や CLI の動きを変えた項目は、統合の後に実際の `exec run --register` を 1 回流して動作を確かめてから close する。生成物を変えた項目は、空のリポジトリで生成して確かめる。
281
281
  - 確かめられない条件(ホストでの確認など)が残る場合は close せず `review` のまま残し、利用者に確かめ方を示す。
282
+ - 確かめた結果、または利用者の確認で直す点が出たら、同じ目的・同じ対象のファイルの手直しは新しく起票しない。元の todo の完了条件に「n 回目の実行(日付)」として直す点を足し、`review` のまま `exec run --register` で流し直す。人の確定を待つ decision は、確定するまで開けたままにし、各回の指摘と判断を個票に足していく。目的が変わる、対象の型やファイルが変わる、元の項目を close してから時間がたっている、のどれかに当たるときだけ新しく起票する。
282
283
  - 見つけた別の問題は、元の項目を `--from` で記録して起票する。完了条件の範囲を勝手に広げない。
283
284
 
284
285
  ## 止まったときの対処
@@ -288,7 +289,7 @@ npx specdojo exec validate --project <project-id>
288
289
  | agent の rate limit・つながらない | `--fallback-executor-by` / `--fallback-reporter-by` で代わりの agent を指定して再開する。解除の時刻が分かれば待つ |
289
290
  | 親の検証の失敗(型・lint・テストの本当の失敗) | `--resume --resume-from executor` で executor からやり直す。失敗した検証の結果が引き継がれる |
290
291
  | 負荷による時間切れ | 負荷を下げてから `--resume` で親の検証を流し直す |
291
- | 統合での衝突(CHANGELOG の同じ節など) | 両方の行を残す形に exec ブランチ側をそろえてから `--resume` する。記帳のファイルの衝突は runner に任せ、手で解かない |
292
+ | 統合での衝突(同じファイルの同じ行など) | 両方の行を残す形に exec ブランチ側をそろえてから `--resume` する。記帳のファイルの衝突は runner に任せ、手で解かない |
292
293
  | 保護された設定への変更 | worktree でその変更だけを戻して `--resume` するか、`exec handoff apply` で利用者の承認のもと当てる |
293
294
  | commit の hook の失敗 | 失敗した段(markdownlint など)の出力を読み、記録のファイルを規約に合わせてから commit する |
294
295
  | 既に統合済みで再開できない | 新しい run として `--force-restart` で流す |
@@ -297,7 +298,7 @@ npx specdojo exec validate --project <project-id>
297
298
 
298
299
  - 検証できる形で書く。完了条件は `exec plan` の入力になり、曖昧だと agent が意図と違う範囲を実装する。
299
300
  - 作業を終える前に流す検査(型検査・lint・単体テスト)と、通すべき親の検証を書く。
300
- - CHANGELOG は未公開の版の節に書き、公開済みの版の節を変えないと書く。
301
+ - CHANGELOG の書き方は、プロジェクトの運用メモの決まりに従うと書く。決まりがなければ、各項目が CHANGELOG の同じ節へ直接書くと並べて流したときに統合で衝突しやすいことを踏まえ、書き方を利用者と決める。公開済みの版の節は変えないと書く。
301
302
  - 保護された設定に触れる場合、register の項目では案を個票の対応結果に書き、pipeline では報告の `handoff` にも書く。反映は利用者の承認のもとで行うと書く。「result に書く」は executor が result を直接書ける実行形式に限る。
302
303
  - 未決の点は `_UNDECIDED_` で残すか、executor に決めさせて理由を記録させるかを明記する。register の項目では個票の対応結果に書かせ、pipeline では報告の `handoff` にも書かせる。「result に書く」は executor が result を直接書ける実行形式に限る。
303
304
  - Markdown では、`*` や `_` を含む語(glob など)をコードの書式にする。コードの書式の中を空白で始めたり終えたりしない。