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,50 @@
1
+ ## 共通: 記法・成果物規約
2
+
3
+ この規約は、生成される全 exec plan に共通で適用される。result の完了条件、他文書を参照する際のリンク記法、成果物の状態(status)の扱いを統一する。
4
+
5
+ 要点(次の `plan-essentials` マーカーの間の箇条書き)は、plan の本文にもそのまま転記される。plan に転記するとき、`_SCHEMA_REF_` はタスクごとに解決した schema のパスに置き換わり、schema の無いタスクではその行が除かれる。
6
+
7
+ <!-- plan-essentials:start -->
8
+
9
+ - result(review plan の場合は review result)への記入は、タスク完了に必須の作業である。成果物の編集とは別に、最後に必ず実施する。
10
+ - 終了コード 0 で完了する前に、result の必須セクションをすべて実際の内容で埋め、プレースホルダ(_TODO_ など)や未記入のセクションを残さない。
11
+ - 文書へのリンクは、対象文書が既に存在する場合は `[[id|title]]` 形式で記載する(`id` は project 修飾 doc id)。
12
+ - リンクを表(テーブル)のセル内に置く場合は、区切りの `|` を `[[id\|title]]` のようにエスケープする。エスケープしないと列がずれて表が壊れ、prettier 整形でセルが分割されて固定化される。
13
+ - まだ存在しない文書を参照する場合は、`[[...]]` ではなく `` `id` `` または `` `filename` `` のようにバッククォートで仮置きする。
14
+ - Markdown の自由記述では、`_` を含む識別子・フィールド名(例: `depends_on`)を必ずインラインコードで囲む。result に描画される executor evidence や reporter の自由記述も同じ記法にする。
15
+ - 成果物 frontmatter の `status` を `ready` に変更しない。`ready` への昇格は人間のみが行うため、`draft` のまま据え置く(exec のコミット時ガードでも昇格はブロックされる)。
16
+ - ファイルの読み取り・書き込み・編集は、作業ディレクトリ(カレントディレクトリ)からの相対パスで指定する。絶対パスを自分で組み立てたり、作業ディレクトリ名を推測して指定したりしない(作業ディレクトリ名の取り違えは外部パス扱いになり拒否される)。
17
+ - 検査を実行する前に、リポジトリの `package.json`、`.specdojo/specdojo.config.json`、hook 設定(`lefthook.yml` など)を読み、本共通規約の詳細にある検査表の適用条件で、実行する検査を決める。
18
+ - 適用条件を満たさない検査は実行せず、executor evidence の validations に `not_applicable` と非適用の理由を `reason` へ記録する。適用される検査が 1 つもない場合も同じく、該当する検査ごとに `not_applicable` と理由を記録する。
19
+ - `not_run` は、適用される検査を実行できたのに実行しなかった場合だけに使う。runner は `not_run` を検証失敗として扱い、タスクを先へ進めない。
20
+ - `pipeline.parent_validations` に設定された検査は executor evidence の validations に含めなくてよい。executor が同じ検査を `not_run` または `not_applicable` として含めても、同じリポジトリで実行した親 runner の結果を正とする。含める場合は検査ごとに 1 行ずつ、実際のコマンド(例: `npm run lint:md`)で書き、複数の検査を 1 行にまとめない。
21
+
22
+ <!-- plan-essentials:end -->
23
+
24
+ - 成果物に変更が不要と判断した場合でも、result の記入は省略しない。変更不要と判断した理由と根拠を result に記入してから完了する。
25
+ - result の変更ファイル欄には、変更したファイル(成果物・ソース・テストなど)ごとの実施内容を具体的に記入する。
26
+ - result が未記入・プレースホルダのまま終了コード 0 で終了すると、runner は成果物未完了(block)として扱い、タスクはやり直しになる。完了前に result の記入漏れがないことを必ず確認する。
27
+ - result の frontmatter は scaffold 済みの構造を正本とする。`id` / `task_id` / `mode` / `project_id` / `plan_ref` / `agent` / `execution` / `approach` / `targets` はキーの追加・削除・改名をせず、scaffold された値のまま維持する。見出し構成(`# Edit Result` などの H1、`## 1.` 以降の章立て)も独自の構成に置き換えない。埋めるのは本文セクションの `_TODO_` プレースホルダの中身だけである。`status` と `completed_at` は完了処理(runner 側)が更新するため、自分で書き換えない。
28
+ - 編集・書き込みが作業ディレクトリ外(`external_directory`)として拒否された場合、原因はパス指定の誤り(誤った絶対パス・ディレクトリ名の取り違え)である。bash の heredoc などへ回避的に切り替えず、相対パスに直したうえで同じ編集ツールで再実行する。
29
+ - 作業用のファイル(編集用スクリプト、検証用の一時データなど)はリポジトリの外(一時ディレクトリ)または worktree の `tmp/` 配下に置き、終了前に削除する。使い捨てのファイルを最上位に作らない。`tmp/` 配下のファイルは commit の対象から除外される。
30
+ - 整形・静的検査は、この plan の完了手順または本共通規約で明示されたコマンドを実行する。変更対象に必要な test、build、schema 検証は、plan に個別記載がなくても実行してよい。同じ test script では対象限定と全件を同一 executor run 内で連続実行せず、どちらか一方に絞る。下表、plan、またはプロジェクト標準が全件 test を求める場合は、全件を1回だけ実行して対象限定の実行を省く。この制約は executor が sandbox 内で実行する test script の回数に対するものであり、親検証に設定された ID のコマンドは対象外である(親 runner が別途実行する)。実行したコマンド・対象・結果は result に記録する。
31
+ - executor / reporter pipeline で親 runner の検証が設定されている場合、executor は設定済み ID に対応するコマンドを sandbox 内で実行せず、executor 終了後に親 runner が固定許可リストから実行して evidence へ追記する。`validate-schema` は `npm run validate:schema`、`test-unit` は `npm run test:unit`、`test-integration` は `npm run test:integration` に対応する。executor は親検証と同じコマンドの対象限定版も追加せず、二重実行しない。executor が親検証のコマンドを validations に含めた場合も、同じリポジトリで実行された親 runner の結果を正とし、executor の `not_run` / `not_applicable` は pipeline を失敗させない。
32
+ - 適用条件の判定と `not_applicable` / `not_run` の使い分けは、要点に記した規則に従う。誤って `not_run` と記録しても、npm script・依存 package の不在、または SpecDojo サブコマンドの設定上の非適用を runner が機械的に確定できる場合は適用外として扱われるが、この救済を前提に記録を省略しない。
33
+ - 依存パッケージの有無は、対象リポジトリの `package.json` の `dependencies` / `devDependencies` と、リポジトリに固定された package manager の設定を基準に判断する。`npx` が未導入パッケージをネットワークから一時取得できることは、導入済みとはみなさない。設定ファイルがない、壊れているなどの理由で適用条件を確定できない検査は実行せず、validations に `not_applicable` として理由と次の確認事項を記録する。
34
+ - `npm init` が `package.json` に入れる仮の `test` script(`echo "Error: no test specified" && exit 1` と、引用符の有無・種類や空白だけが違う変種)は、常に失敗する仮置きであり、`test` script がないものとみなす。`npm test` は実行せず、validations に `not_applicable` と、仮の script である旨を `reason` に記録する。runner も同じ判断で `not_applicable` を受け付ける。本物の test script がある場合は適用される。
35
+ - 終了する前に、コミット時に実行される検査(pre-commit 相当)のうち、現在のリポジトリに設定され、上記の適用条件を満たすものを先回りで実行する。適用した検査の失敗はすべて修正してから完了する。
36
+ - 実行対象は、executor 自身が変更したファイルの種別で判断する。runner が生成・更新する実行管理ファイル(`exec/plans/`・`exec/results/`・`exec/evidence/`・`exec/events/`・`exec/.locks/`、および状態遷移で書き換わる `pjr-index.md`)は、executor の変更ファイルには含めない。下表のうち、変更したファイルが該当し、かつ適用条件を満たす行の検査を実行する。該当行がない場合や適用条件を満たさない場合は追加の検査は不要である。ただし親検証に設定された ID のコマンドは下表よりも優先し、executor は実行しない。下表に同じコマンドが挙がっていても、親 runner の実行に委ねる。
37
+ - 検査コマンドの正本はリポジトリの hook 設定(`lefthook.yml` など)である。下表と設定が食い違う場合は、適用条件を満たす設定側のコマンドに合わせ、実行したコマンドと結果を result に記録する。`specdojo` コマンドは、リポジトリで定められた起動方法(`npx specdojo <subcommand>`、`npx tsx src/specdojo.ts <subcommand>` など)で実行する。ただし、sandbox 環境で `tsx` の IPC エラー(`EPERM`)が発生する場合は、代わりに `node --import tsx src/specdojo.ts <subcommand>` を使用して実行する。
38
+
39
+ | 変更したファイル | 適用条件 | 実行する検査 |
40
+ | ------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------- |
41
+ | `*.md` | 対応するローカル依存が `package.json` にある | `npx prettier --write <対象ファイル>`、導入済み実装に対応する markdownlint コマンド |
42
+ | `*.ts` / `*.js` / `*.json` / `*.yaml` / `*.yml` | Prettier が `package.json` にある | `npx prettier --write <対象ファイル>` |
43
+ | `src/`、`tests/`、`scripts/`、`tools/`、`tsconfig*.json` | `package.json` に `typecheck` script がある | `npm run typecheck` |
44
+ | `src/`、`tests/`、`docs/ja/specdojo/templates/`、`docs/ja/specdojo/exec-templates/`、`vitest.config.*` | pipeline executor は `test:unit`、それ以外は `test` script が `package.json` にある(`npm init` の仮の `test` script は、ないものとみなす) | pipeline executor は `npm run test:unit`、それ以外は `npm test`(`test-unit` が親検証に設定されている場合は executor では実行しない) |
45
+ | `docs/ja/projects/` 配下(runner が書く `exec/` 配下を除く) | 対象 project に `catalog_path` が設定されている | `specdojo catalog validate`(または `npm run validate:catalog`) |
46
+ | 履歴蓄積ファイル(`pjr-*.md`(`pjr-index.md` を除く)、または executor 自身が変更した既存の `exec/plans/**/*.md`・`exec/results/**/*.md`) | `package.json` に `validate:history-links` script がある | `npm run validate:history-links` |
47
+ | `dct-*.yaml` | 対象 project に `catalog_path` が設定されている | `specdojo catalog build` |
48
+ | `pjr-index.md` | 対象 project に `project_register_path` が設定されている | `specdojo register build` |
49
+ | `sch-*.yaml` | 対象 project に `schedule_path` が設定されている | `specdojo exec refresh` |
50
+ | `docs/` 配下 | リポジトリで定められた起動方法により SpecDojo CLI を実行できる | `specdojo index build` |
@@ -0,0 +1,30 @@
1
+ <!-- plan-essentials:start -->
2
+
3
+ ### review の判断手順
4
+
5
+ review plan に共通で適用する。review はタスクの成果を判定し、成果物の品質は判定しない。成果物の品質は grade が一度だけ評価する。review はその評価結果(grade・finding)を事実として受け取り、このタスクを完了してよいかを判断する([[bps-task-completion]])。
6
+
7
+ - 成果物を再評価しない。観点ごとの pass / fail を付け直したり、評価結果の判定を自分の判断で置き換えたりしない。評価結果の内容に疑義がある場合は、疑義の内容と再評価が必要な理由を改善指示に記録する。
8
+ - 評価結果の鮮度を最初に確認する(`E-01`)。plan の「評価結果」章に示す評価対象と `--target` を使い、`specdojo grade list --target <対象種別> --path <評価対象> --changed-only` を実行する。`--target deliverable` の場合は `--dependency-changed` でも同様に実行する。いずれかが評価対象のパスを出力した場合、または評価結果サイドカーが存在しない場合は、評価結果が最新でない。成果物を自分で評価して補わず、verdict を `grade-stale` とする。
9
+ - 評価結果を確定できない場合(`E-02`)は、verdict を `grade-unavailable` とする。サイドカーを読み取れない場合と、`specdojo grade list --target <対象種別> --path <評価対象> --incomplete` が評価対象のパスを出力する場合(評価パイプラインが未完了)が該当する。
10
+ - 評価結果が最新であれば、サイドカーの `verdict` / `score` / `finding_counts` / `findings`、および `done_criteria`(存在する場合)を読み取る。
11
+ - 変更内容・この plan・実行記録・完了条件・最新の finding を照合し、このタスクの範囲と完了条件を満たすかを判断する(`S-02`)。完了条件の充足は、評価結果に判定がある場合はそれを事実として用いる。評価結果が扱わない事項を review で確かめる。対象は、フェーズ説明が求めた変更が行われたか、対象外の変更が混入していないか、実行記録の検証結果が成功しているかである。実行記録(先行する edit タスクの result)を特定できない場合は、確認できなかったことを判断根拠に記録する。
12
+ - finding が残っていても、このタスクの範囲と完了条件を満たしていれば完了できる。その場合は finding を消去・再評価せず、完了を妨げない理由と必要な改善指示を記録する。
13
+ - 判断の根拠は、評価結果・成果物・plan・実行記録を実際に読んで得た具体的な事実に限る。executor の最終メッセージや result の自己申告を、そのまま、または言い換えて根拠にしない。
14
+ - verdict を記録する直前に鮮度の確認を再実行する。最初の確認の後に成果物が変更されて評価結果が最新でなくなった場合は、verdict を `changed-during-review` とする(review 中の成果物変更)。
15
+
16
+ verdict は次の 6 値から 1 つを選ぶ。各値は [[bps-task-completion]] の検証・受入観点と一対一に対応する。
17
+
18
+ | verdict | 受入観点 | 選ぶ条件 | 記録すること |
19
+ | ------------------------ | ----------------------- | --------------------------------------------------------------------------------- | ---------------------------------------------------------- |
20
+ | `complete` | 完了可能 | 評価結果が最新で、plan と完了条件を満たし、完了を妨げる未充足事項がない | 照合した根拠 |
21
+ | `complete-with-findings` | 品質 finding を伴う完了 | 評価結果に finding があるが、このタスクの範囲と完了条件は満たしている | finding が完了を妨げない理由と改善指示 |
22
+ | `incomplete` | 品質良好だが未完了 | plan または完了条件に未充足事項がある(grade の良否は問わない) | 未充足事項と、再計画に使う改善指示 |
23
+ | `grade-stale` | 評価結果が最新でない | 評価結果がない、`content_hash` が一致しない、または評価コンテキストの変化が未反映 | 鮮度確認のコマンドと出力。完了可否は判断しない |
24
+ | `grade-unavailable` | 評価不能 | 評価結果を読み取れない、または評価パイプラインが未完了で grade・finding が未確定 | 評価不能の理由と不足情報。完了は保留する |
25
+ | `changed-during-review` | review 中の成果物変更 | 最初の鮮度確認の後に成果物が変更され、評価結果が最新でなくなった | 変更を検知した確認の出力。verdict を確定せず再評価を求める |
26
+
27
+ - verdict が `complete` 以外でも、review result を記録できた場合は正常終了する(終了コード 0)。runner は verdict に応じて再評価または再計画へ進む。
28
+ - review result の章立ては `評価結果の確認`、`判断根拠`、`未充足事項・改善指示`、`approach に応じた確認`、`decision` である。`decision` の `verdict` は必ず上表の値で埋める。
29
+
30
+ <!-- plan-essentials:end -->
@@ -158,7 +158,7 @@ git status --short
158
158
 
159
159
  自動実行では、SpecDojo が worktree の準備、agent 実行、commit、現在ブランチへの統合、状態更新を行います。
160
160
 
161
- worktree 実行の `prepare execution` / `apply task changes` と実行管理の記帳は exec ブランチに保持されます。成功時に project `develop` の first-parent へ追加されるのは `--no-ff` の merge commit 1件だけで、subject は Schedule タスクなら `exec(<task-id>): <task name>`、register 項目なら `exec(register <PJR-ID>): <title>` です。register 実行では `start → review` の遷移をこの merge commit に同梱し、失敗時は `start → waiting` の遷移、plan、result を `wait` commit 1件にまとめます(worktree は再開のため保持します)。再開後に成功した場合も merge commit 1件です。squash / rebase は使わず、既存履歴は書き換えません。
161
+ worktree 実行の `prepare execution` / `apply task changes` と実行管理の記帳は exec ブランチに保持されます。成功時に project `develop` の first-parent へ追加されるのは `--no-ff` の merge commit 1件だけで、subject は Schedule タスクなら `exec(<task-id>): <task name>`、register 項目なら `exec(register <PJR-ID>): <title>` です。register 実行では `start → review` の遷移をこの merge commit に同梱し、失敗時は `start → waiting` の遷移、plan、result を `wait` commit 1件にまとめます(worktree は再開のため保持します)。再開後に成功した場合も merge commit 1件です。Schedule の run(`exec run` / `exec resume` / `exec cycle`)の終わりには、統合の後に runner が書いたイベントと run の記録をまとめた記帳の commit(`exec(run): record execution events and run records`)が run ごとに 1 件加わります([Schedule実行運用ガイド](schedule-operation-guide.md) の「実行記録の記帳」)。squash / rebase は使わず、既存履歴は書き換えません。
162
162
 
163
163
  ```bash
164
164
  specdojo exec run \
@@ -69,6 +69,7 @@ SpecDojo 拡張は、ワークスペースの `.specdojo/doc-index.json` を使
69
69
  | 文書リンクの表示・遷移 | Markdown の SpecDojo 文書リンクをクリックして対象文書を開きます。プレビュー内のリンクにも対応します |
70
70
  | ID で文書を開く | コマンドパレットで `SpecDojo: Open Document by ID` を実行し、文書 ID を入力します |
71
71
  | Markdown 表の整形 | 表内へカーソルを置き、コマンドパレットで `SpecDojo: Format Markdown Table` を実行します |
72
+ | 対話のプレビュー | `chat` を吹き出し、`chat tui` を TUI 風に表示します |
72
73
 
73
74
  文書リンクは、本文では `[[id]]` または `[[id|表示名]]` と記述します。Markdown 表のセル内では、
74
75
  列区切りとの衝突を避けるため `[[id\|表示名]]` と記述してください。
@@ -136,6 +137,17 @@ VS Code では、Markdown ファイルを編集しながら、
136
137
 
137
138
  現在の Markdown ファイルのプレビューが開きます。
138
139
 
140
+ SpecDojo 拡張を導入すると、次の `chat` ブロックが吹き出しで表示されます。利用者は右、相手側は左に配置されます。`chat tui` に変えると、暗い背景と等幅文字を使い、利用者の発言に `>`、相手側に `●` を添えます。
141
+
142
+ ```chat
143
+ あなた: 設定を確認してください。
144
+
145
+ オーケストレーター: `specdojo.config.json` を確認しました。
146
+ プロジェクトの設定が見つかりました。
147
+ ```
148
+
149
+ 発言の間には 1 行空け、続き行は字下げします。空行なしでも描画でき、空白・タブだけの行を含む空行は続き行の間でも読み飛ばします。空行の後の続き行も直前の発言に含まれ、空行以外の改行・字下げは維持されます。インラインコードにはバッククォートを使えます。文書サイトも同じ表示に対応し、GitHub や拡張未導入の VS Code ではコードブロックとして読めます。
150
+
139
151
  #### 3.1.2. 編集画面とプレビューを並べて表示(推奨)
140
152
 
141
153
  - Windows / Linux: `Ctrl + K` → `V`
@@ -346,6 +358,7 @@ Mermaid SVG の生成だけを行う場合は `npx specdojo-docs-site mermaid .`
346
358
  /.vitepress/dist/
347
359
  /.vitepress/cache/
348
360
  /.vitepress/mermaid/
361
+ /.vitepress/d2/
349
362
  /.vitepress/kata-staging/
350
363
  ```
351
364
 
@@ -390,3 +403,38 @@ block
390
403
  - ローカル検索は登録簿一覧 `pjr-index` を入口にし、個票、状態別などの派生ビュー、管理ログ、実行記録を検索インデックスから除外します。個票本文を探す場合は `pjr-index` から対象個票へ移動します。
391
404
 
392
405
  ステージングの参照元、Mermaid SVG だけを生成するコマンドなど、package 固有の設定は `packages/docs-site/README.md` を参照してください。
406
+
407
+ ### 6.2. 図の道具を選ぶ
408
+
409
+ 図の目的と複雑さで道具を選びます。agent もこの基準に従って作成・修正してください。
410
+
411
+ | 道具 | 選ぶ目安 | 正本 |
412
+ | ------- | -------------------------------------------------------------------------------- | ------------------------------------ |
413
+ | Mermaid | 単純な図、状態遷移図、シーケンス図など。ノードと辺がそれぞれおおむね 20 程度まで | Markdown の `mermaid` コードブロック |
414
+ | D2 | ノード・辺が多い構成図、入れ子が多い図、Mermaid で配置が読みづらくなる図 | Markdown の `d2` コードブロック |
415
+ | draw.io | さらに複雑で、人が配置を決めたい図や発表用の図 | 圧縮しない `.drawio` |
416
+
417
+ 20 は切り替えの目安です。図を読む目的が分かれる場合は、道具の変更とともに図の分割も検討します。draw.io の自動書き出しは別途整備するため、現時点では表示用の SVG を手動で用意してください。
418
+
419
+ ### 6.3. D2 図を書く・検査する
420
+
421
+ `d2` のコードブロックは `build` と `dev` で SVG に書き出します。D2 CLI v0.9.0 を PATH に配置してください。このリポジトリの Dev Container はコンテナの再ビルドで導入されます。Linux で手動導入する場合は、版と SHA-256 を固定した `sh .devcontainer/install-d2.sh "$HOME/.local/bin"` を使えます。
422
+
423
+ ````markdown
424
+ ```d2
425
+ direction: right
426
+ client: 利用者
427
+ system: システム {
428
+ api: API
429
+ db: データベース {shape: cylinder}
430
+ api -> db: 読み書き
431
+ }
432
+ client -> system.api: リクエスト
433
+ ```
434
+ ````
435
+
436
+ 配置の既定は ELK です。図はコードブロック内で完結させ、外部ファイルの import は使いません。1 つのブロックにつきルートの図を 1 枚の SVG にします。layers・scenarios・steps の追加ページは書き出しません。生成 SVG は `.vitepress/d2/`、公開 URL はサイトの base に続く `/d2/<hash>.svg` です。SVG は生成物なので直接編集しません。
437
+
438
+ 生成だけを行う場合は `npx specdojo-docs-site d2 .` を使います。本リポジトリの構文検査は `node tools/lint-d2.mjs`、対象を絞る場合は `node tools/lint-d2.mjs '<Markdown のパスまたは glob>'` です。開始 fence の行番号とエラーを報告し、不正な図は終了コード 1 になります。D2 を含む文書がある場合、CLI が未導入・版違いでも失敗します。ブラウザは不要です。
439
+
440
+ GitHub の Markdown 表示では D2 は図に変換されないため、文書サイトで確認します。npm の `lint:d2`・`check`、commit hook とこのリポジトリの親検証設定への登録、および CI の導入設定は、保護された設定の承認・反映後に有効になります。
@@ -224,16 +224,36 @@ flowchart TB
224
224
 
225
225
  ### 6.1. dct・sch・execの対応
226
226
 
227
- | 情報 | 主な役割 | 担当ファイル |
228
- | ------------------- | -------------------------------------------------------------------- | ------------------------------------------------------ |
229
- | 成果物カタログ | 管理する成果物、配置、依存関係、完了条件を定義する | `dct-<domain>.yaml` |
230
- | トラック | 対象成果物のスコープを決め、実行系列としてまとめる | `sch-track-<track>.yaml` / `sch-strategy-<track>.yaml` |
231
- | 実行フェーズ / パス | 成果物ごと、または成果物群を横断して適用する作業段階を定義する | `sch-strategy-<track>.yaml` |
232
- | タスク | 成果物×フェーズ から生成される実行アトム。担当・期限・依存関係を持つ | `sch-track-<track>.yaml`(生成物) |
233
- | plan | 一回の作業で確認・変更する対象と手順を示す | `execution/exec/plans/` |
234
- | result | 実施内容、確認結果、残課題を記録する | `execution/exec/results/` |
235
- | 実行イベント | claim / complete / block などの実行履歴を表す | `execution/exec/events/` |
236
- | 実行生成物 | Ready、状態スナップショット、クリティカルパスなどを表す | `execution/generated/` |
227
+ | 情報 | 主な役割 | 担当ファイル |
228
+ | ------------------- | -------------------------------------------------------------------- | -------------------------------------------------------- |
229
+ | 成果物カタログ | 管理する成果物、配置、依存関係、完了条件を定義する | `dct-<domain>.yaml` |
230
+ | トラック | 対象成果物のスコープを決め、実行系列としてまとめる | `sch-track-<track>.yaml` / `sch-strategy-<track>.yaml` |
231
+ | 実行フェーズ / パス | 成果物ごと、または成果物群を横断して適用する作業段階を定義する | `sch-strategy-<track>.yaml` |
232
+ | タスク | 成果物×フェーズ から生成される実行アトム。担当・期限・依存関係を持つ | `sch-track-<track>.yaml`(生成物) |
233
+ | plan | 一回の作業で確認・変更する対象と手順を示す | `execution/runs/<出どころ>/<項目 ID>/<run ID>/plan.md` |
234
+ | result | 実施内容、確認結果、残課題を記録する | `execution/runs/<出どころ>/<項目 ID>/<run ID>/result.md` |
235
+ | 実行イベント | claim / complete / block などの実行履歴を表す | `execution/exec/events/` |
236
+ | 実行生成物 | Ready、状態スナップショット、クリティカルパスなどを表す | `execution/generated/` |
237
+
238
+ 実行記録は次の配置で保持します。出どころは `register`・`schedule`・`job` です。項目 ID と run ID の決め方は [[specdojo:plan-result-lifecycle-guide|plan/resultライフサイクルガイド]] を参照してください。
239
+
240
+ ```text
241
+ execution/
242
+ runs/<出どころ>/<項目 ID>/<run ID>/
243
+ plan.md
244
+ result.md
245
+ evidence.json
246
+ pipeline-state.json
247
+ executor.log
248
+ reporter.log
249
+ conventions/
250
+ exec/events/
251
+ grade/results/
252
+ jobs/runs/
253
+ generated/
254
+ ```
255
+
256
+ job の定義はプロジェクト直下の `jobs/` に置きます。`exec/trials/` は比較実験の記録であり、通常の run とは別に管理します。配置の検査は [[specdojo:plan-result-lifecycle-guide|plan/resultライフサイクルガイド]] の「配置の検査」を参照してください。
237
257
 
238
258
  ### 6.2. 展開の流れ
239
259
 
@@ -287,14 +307,17 @@ idと対応させない場合(日本語名称を使用する場合等)は、
287
307
  #### 8.1.2. 横断ドキュメント
288
308
 
289
309
  - 横断ディレクトリは特定ドメインの配下に置かず、プロジェクト直下に置きます。
290
- `controls/project-register/` の登録項目や `execution/exec/plans/` の実行プランは、
310
+ `controls/project-register/` の登録項目や `execution/runs/<出どころ>/<項目 ID>/<run ID>/plan.md` の実行プランは、
291
311
  プロジェクト定義・プロダクト変更を含む全ドメインの成果物を対象とするためです。
292
312
  - これらが成果物カタログの管理対象かどうかは配置とは独立で、
293
313
  どのドメインに分類するかは各 `dct-<domain>.yaml` の `domain` が決めます。
294
314
  例えば `controls/` と `reporting/` は `dct-project-management.yaml`
295
- (`domain: project-management`)が管理します。`timeline/` と `schedule/` の計画成果物は、
296
- トラック追加に伴って増えるため `dct-planning.yaml`(`domain: planning`)で管理します。
297
- `routines/`、`controls/reviews/`、各 `generated/` は CLI の入出力領域なのでカタログ管理対象外です。
315
+ (`domain: project-management`)が管理します。全体計画の正本は `controls/project-register/` の epic です。
316
+ `schedule/` の計画成果物は `dct-planning.yaml`(`domain: planning`)で管理し、
317
+ 旧 `timeline/tml-index.yaml` は非推奨の互換用ファイルとして扱います。
318
+ `routines/`、`controls/generated/`、各 `generated/` は CLI の入出力領域なのでカタログ管理対象外です。
319
+
320
+ 派生ビューは `controls/generated/`、`schedule/generated/` など横断ディレクトリの直下に置きます。旧 sch-assessment は廃止済みのため、専用のサブディレクトリは作りません。routine の状態・履歴・lock は [[specdojo:routine-operation-guide|routine 運用ガイド]] に従って Git の外の端末側へ保存し、exec の lock は Git が無視する `execution/exec/.locks/` に置きます。
298
321
 
299
322
  再利用可能なJob Definitionは`jobs/`、各回のJob Runは`execution/jobs/`へ置きます。詳細は[Job実行設計](../../product/040-system-design/sysd-job-execution.md)を参照してください。
300
323
 
@@ -311,7 +334,7 @@ projects/<prj-id>/
311
334
  ├── 050-impact-analysis/ # 導入・変更の影響調査
312
335
  ├── 060-migration-planning/ # 移行計画・設計・切替計画
313
336
  ├── ... # 070- 以降の成果物ドメイン
314
- ├── controls/ # 管理台帳・派生ビュー(登録簿・レビュー結果)
337
+ ├── controls/ # 管理台帳・派生ビュー(登録簿・generated/)
315
338
  ├── schedule/ # Schedule(sch-*.yaml)
316
339
  ├── routines/ # 定期実行ルーチン(rtn-*.yaml)
317
340
  ├── jobs/ # 再利用可能なJob Definition(job-*.yaml)
@@ -321,6 +344,16 @@ projects/<prj-id>/
321
344
 
322
345
  ファイル単位の完全なツリーは [ディレクトリレイアウトリファレンス](../references/directory-layout-reference.md) の `プロジェクトドキュメントの構成` を参照してください。
323
346
 
347
+ `reporting/progress-reports/` は週報などの成果物を初めて保存するときに作成します。job・routine の定義を置くだけでは作成されません。agent 型 job は作業指示を exec plan に展開し、報告本文と保存先ディレクトリの作成を agent が行います。出力先は project の `base_path` からの相対パスです。
348
+
349
+ prj-0001 の `job-weekly-report.yaml` はこの出力先を指定していますが、対応する `rtn-weekly-report.yaml` は `enabled: false` のサンプルであり、`routine run --due` では選ばれません。週報を作成するまで `reporting/` が存在しないのは、この構成では正常です。
350
+
351
+ ### 8.3. 公開しない旧文書の保管
352
+
353
+ 現行の文書ツリーから外す旧文書は、リポジトリ直下の `archive/` に保管します。prj-0001 で廃止したプロダクト文書22件は `archive/ja/product/trash/` に置きます。`docs/` と project の外に置くことで、文書サイトのページ・サイドバー・検索と doc index の走査対象から外します。`trash` のパス区分は残し、カタログの現行文書探索や grade の対象に戻さないようにします。
354
+
355
+ カタログの `path` は移動先を指し、ID と本文は保持します。過去の文書からの wikilink は `archive/ja/product/trash/links.json` で旧IDと移動先を対応付け、サイトではリポジトリ上のソースへ解決します。この対応表は公開 doc index には追加しません。
356
+
324
357
  ## 9. プロダクトドキュメントの構成
325
358
 
326
359
  ### 9.1. ディレクトリ構成の概観
@@ -75,15 +75,15 @@ phase_sets:
75
75
  mode: review
76
76
  ```
77
77
 
78
- | フィールド | 必須 | 説明 |
79
- | ---------------- | ---- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
80
- | `execution` | 任意 | `agent` または `human`。省略時は `agent` |
81
- | `mode` | 任意 | `edit` または `review`。省略時は `edit` |
82
- | `approach` | 任意 | `fully-guided` / `recipe-guided` / `freeform` / `bootstrap` / `retrofit` / `cross-deliverable-dedup` / `rulebook-maintenance` / `recipe-maintenance` / `sample-maintenance` / `template-maintenance` |
83
- | `capabilities` | 任意 | 必要なツールリスト。ツール不要の場合は省略 |
84
- | `proficiency` | 任意 | 必要な品質水準。省略すると全水準が候補 |
85
- | `agent` | 任意 | `executor`(必須)と `reporter`(任意)の nickname。CLI の stage override に次いで優先 |
86
- | `agent_pipeline` | 任意 | executor、reporter の 2 stage と stage ごとの `capabilities` / `proficiency`。省略時は従来の単一 agent フロー |
78
+ | フィールド | 必須 | 説明 |
79
+ | ---------------- | ---- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
80
+ | `execution` | 任意 | `agent` または `human`。省略時は `agent` |
81
+ | `mode` | 任意 | `edit` または `review`。省略時は `edit` |
82
+ | `approach` | 任意 | `fully-guided` / `condense` / `recipe-guided` / `freeform` / `bootstrap` / `retrofit` / `cross-deliverable-dedup` / `rulebook-maintenance` / `recipe-maintenance` / `sample-maintenance` / `template-maintenance` |
83
+ | `capabilities` | 任意 | 必要なツールリスト。ツール不要の場合は省略 |
84
+ | `proficiency` | 任意 | 必要な品質水準。省略すると全水準が候補 |
85
+ | `agent` | 任意 | `executor`(必須)と `reporter`(任意)の nickname。CLI の stage override に次いで優先 |
86
+ | `agent_pipeline` | 任意 | executor、reporter の 2 stage と stage ごとの `capabilities` / `proficiency`。省略時は従来の単一 agent フロー |
87
87
 
88
88
  `approach` の値ごとの意味と、rulebook / recipe / sample / template の参照方針は [実践の進め方ガイド](ryu-guide.md) を参照します。
89
89
 
@@ -206,6 +206,7 @@ pipeline:
206
206
 
207
207
  run:
208
208
  max_concurrent_runs: 4 # 省略時も 4(最初の run と --join の run の合計)
209
+ git_index_lock_wait_seconds: 1200 # 省略時も 1200(index.lock の解放を待つ秒数)
209
210
 
210
211
  rate_limit_detection:
211
212
  exit_codes: []
@@ -336,6 +337,8 @@ routing:
336
337
 
337
338
  `lint-mermaid`(`npm run lint:mermaid`)は、Markdown の Mermaid の図の構文エラーを統合前に検出します。markdownlint と remark は図の中身を検査しないため、図の構文エラーは `docs:build` まで分かりません。利用するリポジトリに `lint:mermaid` script と、検査に使う Mermaid の依存が必要です。
338
339
 
340
+ `lint-d2`(`npm run lint:d2`)は D2 の構文を検査します。利用するリポジトリに `lint:d2` script(本リポジトリの実装は `node tools/lint-d2.mjs`)、docs-site の依存、および PATH 上に D2 CLI v0.9.0 が必要です。`pipeline.parent_validations` に `lint-d2` を追加して有効にします。CLI の未導入・版違いは未検査として失敗します。
341
+
339
342
  `build`(`npm run build`)と `format-check`(`npm run format:check`)は、別リポジトリ構成でプロダクトリポジトリのビルド確認とコード整形確認を親 runner で実行するために使います。agent の sandbox 内で npm を実行できない環境でも、統合前にビルドと整形の検査を自動化できます(PJR-NS8Y)。
340
343
 
341
344
  `specdojo.config.json` の project に `repos` を宣言した別リポジトリ構成では、`pipeline.parent_validations` の要素に `{ id, repo }` を書き、検証を実行するリポジトリを割り当てられます(PJR-V96B)。ID だけの要素はプロジェクトリポジトリで実行します。`repo` には、プロジェクトリポジトリを表す `project` か、`repos` で宣言したプロダクトリポジトリの名前を書きます。
@@ -358,12 +361,40 @@ pipeline:
358
361
  - 同じ `id` と `repo` の組の重複、`id`・`repo` 以外のキー、`repo` の無いオブジェクトは、agent 起動前の設定エラーになります。
359
362
  - 実行するコマンドは、どのリポジトリでも ID ごとの固定 argv です(例: `test-unit` は `npm run test:unit`)。リポジトリ別に command や npm script 名を指定する手段は設けません。プロダクトリポジトリの npm script 名が異なる場合は、プロダクト側の `package.json` に許可リストと同じ名前の script(`test:unit` など)を用意してください。用意できない検証は、そのリポジトリへ割り当てないでください。script が無いまま割り当てると、`npm run` が失敗して親検証は `failed` になります。
360
363
 
364
+ 要素に `paths` を書くと、変更の種類で検証を選べます(PJR-T01P)。親 runner は executor が変えたファイルを `paths` の glob(`**`・`*`・`?`・`{a,b}`、割り当てたリポジトリからの相対)と照らし、合うファイルが無ければ検証を流さず `not_applicable` として記録します。`not_applicable` は失敗として扱わず、executor が同じ検証を `not_run` と報告していても block しません。次の場合は `paths` があっても流します。
365
+
366
+ - `paths` を書かない検証(迷う場合は書かずに、今までどおり毎回流します)。
367
+ - 変更一覧が無い、または evidence の上限(1,000 件)で切れた場合。
368
+ - reporter の再開の前に統合先を取り込んだ後の再検証。
369
+
370
+ ```yaml
371
+ pipeline:
372
+ parent_validations:
373
+ - lint-md
374
+ - validate-schema # 文書だけの変更でも流す
375
+ - { id: typecheck, paths: ["{src,tests,tools}/**", "tsconfig*.json"] }
376
+ - { id: test-unit, paths: ["{src,tests,tools}/**", "docs/ja/specdojo/**", "vitest.config.*"] }
377
+ ```
378
+
379
+ `pipeline.commit_hook_skips` は、runner の統合の commit で流し直さない Git hook(lefthook のコマンド名)を宣言します。`covered_by` に並べた親の検証がその run ですべて `passed` のときだけ、commit を `LEFTHOOK_EXCLUDE` 付きで実行します。`not_applicable` や失敗した検証は代わりにならないため、その場合は hook を流します。人が手で commit するときの hook は変わりません。
380
+
381
+ ```yaml
382
+ pipeline:
383
+ commit_hook_skips:
384
+ - { hook: typecheck, covered_by: [typecheck] }
385
+ - { hook: test, covered_by: [test-unit, test-integration] }
386
+ ```
387
+
388
+ `pipeline.mechanical_result` を `true` にすると、edit result を reporter の agent を起動せずに runner が作ります。対象は、結果が完了で executor が `final_message` を返した edit だけです。実施内容は `final_message` の各行で、進め方には runner が作ったことを書きます。review、block、描画の失敗は従来どおり reporter が書きます。既定は `false` です。
389
+
361
390
  `run.register_execution` は、`exec run --register` の既定の実行場所です。`worktree` または `in-place` を指定します。省略時は既存リポジトリとの互換性のため `in-place` です。CLI の `--worktree` / `--in-place` は設定を上書きし、同時指定はエラーになります。
362
391
 
363
392
  `run.register_post_review` は、register の worktree 統合後に読み取り専用 review pipeline を実行し、todo / issue を verdict に応じて自動 close または `waiting` へ遷移するかを指定する boolean です。既定は `false` です。CLI の `--post-review` でもその run だけ有効にできます。review executor の既定は `claude-expert-review-executor` で、`--review-by` が優先されます。詳しい判定と、runner 自身を変更した項目を自動 close しない規則は [exec運用ガイド](exec-operation-guide.md) を参照してください。
364
393
 
365
394
  `run.max_concurrent_runs` は、同じ project で同時に動かせる `exec run` プロセスの数の上限です。最初の run と、register の worktree 実行へ `--join` で合流する run の合計で数えます。正の整数だけを指定でき、省略時や不正な値の場合は `4` です。`1` を指定すると `--join` は無効になります。現在の使用数は `exec slots --project <project-id>` で確認できます。
366
395
 
396
+ `run.git_index_lock_wait_seconds` は、runner の統合・記帳などの git 操作が、別のプロセス(手の commit の pre-commit hook など)が握る `index.lock` の解放を待つ秒数です。0 以上の整数だけを指定でき、省略時は `1200`(20 分)です。不正な値は設定の読み込みでエラーになります。最初の 10 回は 1.5 秒間隔、その後は 5 秒間隔でやり直し、待っている間は 30 秒ごとに `warning: waiting for index.lock to be released (elapsed <経過> / limit <上限>, lock: <パス>, ...)` を出力します。上限を越えると、lock のパスと原因の候補(hook の実行中、または異常終了した git が残した古い lock)を添えて失敗します。最初の 10 回の後、lock のファイルが残っているのに git のプロセスが 1 つも動いていない場合は古い lock とみなし、上限を待たずに `index.lock looks stale` で失敗します。この判定は Linux の `/proc` で行い、読めない環境では上限まで待ちます。runner は lock のファイルを消しません。git のプロセスが動いていないことを確かめてから、人が消してください(PJR-964D)。
397
+
367
398
  `pipeline.parent_validation_concurrency` は、1 つの `exec run` プロセスの中で親検証を同時に実行できる項目数の上限です。正の整数だけを指定でき、省略時は `1` です。`--parallel` で複数項目を並行実行しても、親検証は項目単位で 1 本ずつ直列に実行されます。vitest は検証ごとに複数の worker を起動するため、検証が重なるとコンテナの負荷で成果物と無関係なタイムアウトが起きます。これを防ぐための既定値です(PJR-3HHW)。制限の対象は親検証だけで、executor と reporter は `--parallel` のとおり並行に動きます。空きを待つ項目は `Waiting for parent validation slot: <項目> (<検証 ID>); running: <実行中の項目>` をログへ出力し、枠を得たときに `Parent validation slot acquired: <項目>` を出力します。
368
399
 
369
400
  この直列化は、同じ `exec run` プロセス内の全経路に適用されます。対象は executor 成功後の検証、reporter 再開前の検証の再実行、`exec trial` の検証です。同じ project の `exec run` は `exec-run.lock` によって run 全体で排他されるため、通常は別プロセスの検証が重なることはありません。register の worktree 実行へ `--join` で合流した run どうしは並行して動くため、`exec-run.lock` または合流の枠を取得したプロセスは、同じ上限の枠を `exec/.locks/parent-validation/` にも取得します。これにより、合流した run を跨いでも親検証は `parent_validation_concurrency` 本までに抑えられます(PJR-4HBG)。別プロセスの枠を待つ項目は `Waiting for parent validation slot held by another exec run: <項目> (<検証 ID>)` をログへ出力します。枠は heartbeat 付きのロックで、プロセスが異常終了した場合は heartbeat が止まってから 30 秒で stale とみなされ、後続の run が奪取します。このため、解放漏れで無関係な run が止まり続けることはありません。別 project の run を同時に起動した場合は、ロックの配置が異なるため、互いの検証が重なり得ます。executor が sandbox 内で実行する検証は runner の管理外です。このため、vitest を使う `test-unit` / `test-integration` は `parent_validations` へ寄せ、executor には実行させません。
@@ -398,7 +429,7 @@ providers:
398
429
  expert: { effort: high }
399
430
 
400
431
  antigravity:
401
- command_template: 'agy --sandbox --add-dir "$(pwd)" --model {model} -p "$(cat)"'
432
+ command_template: 'specdojo agent launch --provider antigravity --role {mode} -- --sandbox --model {model} -p "$(cat)"'
402
433
  # model を持たない従来の 1 段の member だけが、次の model を使う
403
434
  command_params:
404
435
  by_proficiency:
@@ -537,7 +568,7 @@ specdojo exec run --project <project-id> --task <task-id> \
537
568
 
538
569
  ### 6.3. evidence とログの引き渡し方針
539
570
 
540
- executor の出力は、そのまま reporter へ渡さずに run 単位の evidence へ整形して保存します。保存先は `<execution_path>/exec/evidence/<task-id>/<run-id>/` です。
571
+ executor の出力は、そのまま reporter へ渡さずに run 単位の evidence へ整形して保存します。保存先は `<execution_path>/runs/<出どころ>/<項目 ID>/<run ID>/` です。
541
572
 
542
573
  | ファイル | 内容 |
543
574
  | --------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------- |
@@ -552,15 +583,16 @@ executor の出力は、そのまま reporter へ渡さずに run 単位の evid
552
583
  - reporter へ渡すのは、plan と `evidence.json` の内容と出力 JSON Schema だけです。ログ本文・生 diff は渡しません。
553
584
  - ログは `evidence.json` の `log_refs` に参照(パス・バイト数・切り詰めの有無)としてだけ現れます。ログ本文を読むのは人です。
554
585
  - 保存前に上限を適用します。`executor.log` は全体で 64KiB、失敗した reporter のログは stdout / stderr の各ファイルを 64KiB とします。失敗した親検証は stdout / stderr をそれぞれ 1MiB まで取得し、両方を 1 つのログへ保存します。1MiB を超えたストリームは先頭と末尾を残して中間を省略します。最終メッセージと diff サマリは各 4,000 文字、検証結果は 50 件、変更ファイルは 1,000 件までです。超過分を切り詰めた事実は `log_refs.truncated` に残します。
555
- - 保存前に秘匿値を伏せ字化します(`Bearer` トークン、`sk-`/`gh*_` 形式のキー、`api_key` / `token` / `password` などの値)。evidence と executor / reporter のログに適用します。
586
+ - 保存前に秘匿値を伏せ字化します。対象は `Bearer`、OpenAI・Anthropic・GitHub(fine-grained を含む)・AWS・Google・Slack のキーやトークン、JWT、秘密鍵の PEM ブロック全体、URL の認証情報、`api_key` / `access_token` / `password` などの名前付きの値です。evidence と executor / reporter のログに適用します。
556
587
  - reporter が非ゼロ終了または形式エラーで失敗した場合、同じ reporter stage 内の各形式試行を `reporter-attempt-<n>.stdout.log` と `reporter-attempt-<n>.stderr.log` に保存します。同じ run を resume して再度失敗した場合は、直近の失敗内容でこれらのファイルと `log_refs` を置き換えます。
557
588
  - 親検証は失敗時だけ出力を保存し、成功時は要約だけを記録します。失敗ログは `parent-validation-output` として `log_refs` から参照します。同じ run の resume や統合段の再検証では attempt 番号を増やして新しいログを追加し、以前の失敗ログを上書きしません。親検証の要約は 1,000 文字以内で先頭と末尾を残すため、末尾に出る失敗ケース名と件数を evidence から確認できます。
558
589
  - evidence ディレクトリは Git の管理対象です。成功して統合された run のログは履歴に残り、失敗中の worktree では未コミットのまま保持されます。`--force-restart` などで worktree を破棄すると未コミットログも失われるため、必要な調査を先に行います。既知パターンは保存前に秘匿しますが、未知形式の秘密が残る可能性を考慮し、ログを外部共有する前に内容を確認します。
559
590
  - executor が構造化した最終報告を返す場合は、標準出力に `<specdojo_executor_evidence>` タグで JSON(`final_message`・`validations`・省略可能な `completion_status`・`handoff`)を出します。`validations[].status` は `passed` / `failed` / `not_run` / `not_applicable` / `requires_human` のいずれかです。`not_applicable` はリポジトリが検査の適用条件を満たさない場合に使い、`reason` へ理由を必ず記録します。`requires_human` は、実 agent CLI の起動、利用枠や課金を伴う操作、認証情報やホスト側の操作など、agent の sandbox から実行できない確認だけに使います。実行できるが省略した検証には使わず、`not_run` として記録します。タグが無い場合は標準出力の残りを最終メッセージとして扱います。
560
- - `pipeline.parent_validations` には `validate-schema`(`npm run validate:schema`)、`typecheck`(`npm run typecheck`)、`test-unit`(`npm run test:unit`)、`test-integration`(`npm run test:integration`)、`lint-ts`(`npm run lint:ts`)、`lint-fm`(`npm run lint:fm`)、`lint-md`(`npm run lint:md`)、`lint-mermaid`(`npm run lint:mermaid`)、`build`(`npm run build`)、`format-check`(`npm run format:check`)を指定できます。親 runner は executor の成功後・reporter の起動前に、指定順で固定 argv の検証を実行します。
591
+ - `pipeline.parent_validations` には `validate-schema`(`npm run validate:schema`)、`typecheck`(`npm run typecheck`)、`test-unit`(`npm run test:unit`)、`test-integration`(`npm run test:integration`)、`lint-ts`(`npm run lint:ts`)、`lint-fm`(`npm run lint:fm`)、`lint-md`(`npm run lint:md`)、`lint-mermaid`(`npm run lint:mermaid`)、`lint-d2`(`npm run lint:d2`)、`build`(`npm run build`)、`format-check`(`npm run format:check`)を指定できます。親 runner は executor の成功後・reporter の起動前に、指定順で固定 argv の検証を実行します。
561
592
  - executor prompt には設定済み ID と対応コマンドを明示します。executor はそのコマンドや対象限定版を sandbox 内で実行せず、executor evidence の validations にも含めなくてよいものとします。親 runner の結果は `source: runner` と許可リスト `id` 付きで同じ `validations` 配列へ保存します。executor が同じ検査を `not_run` または `not_applicable` として含めた場合も、同じリポジトリで実行された親 runner の結果を正とします。これにより sandbox 内で成立しない検証を親へ移した場合も二重実行せず、executor の重複報告で run を止めません。
562
- - result の `changed_files` のパスは evidence の `changes` から、execution の evidence、project register とその派生ビュー、当該 result という runner 管理記録を除いて runner が機械生成します。除外後の変更一覧だけを reporter へ渡し、edit の変更説明は evidence のパスと対にして受け取ります。runner はパスで突き合わせるため、説明の順序は問いません。説明が不足したパスには Git の変更メタデータ(追加・変更・削除・名前の変更、行数)を記録し、変更ファイルが多い場合(50 件超)はディレクトリごとに集約して記録します。evidence にないパスの説明は捨てます。`outcome` と `block_reason` は stage の状態・終了コード・保護機構が保存した理由・executor / 親 runner の検証から機械生成します。reporter の JSON Schema は文章項目と対応づけ用のパスだけを受け付け、いずれかの検証が failed または `not_run` なら、reporter の文章にかかわらず機械判定は blocked です。ただし、executor が `not_run` または `not_applicable` と記録したコマンドを、親 runner が同じリポジトリで同じコマンドとして実行し成功していれば、親 runner の結果を正として executor の報告を無視します。さらに、`npm run <name>` に対応する script がない、`npx <package>` の package が `dependencies` / `devDependencies` にない、検査の対象となる種類の変更ファイルがない、または SpecDojo サブコマンドの設定上の適用条件を満たさないことを runner が機械的に確定できる場合、その `not_run` は block せず、edit result の申し送りへ「適用外の検証(runner の判定)」として追記します。変更ファイル種別で判定する対応は共通規約の検査表を正本とし、`validate:schema:file` は `*.yaml` / `*.yml`、Prettier は `*.md` / `*.ts` / `*.js` / `*.json` / `*.yaml` / `*.yml`、markdownlint は `*.md` の変更がある場合だけ適用対象とします。rename は変更前後の両方を見て、プロダクトリポジトリのコマンドはそのリポジトリの変更だけで判定します。`typecheck` など、この対応に含まれない検査の判定は変更しません。SpecDojo の起動形は `specdojo <subcommand>`、`npx specdojo <subcommand>`、ソース/配布済み CLI の直接起動を認識し、`catalog validate` は対象 project の `catalog_path` で判定します。対象 project は、コマンドの `--project <id>`、run の対象 project(runner が execution path に一致する project を設定から特定したもの)、`current_project` の順に決めます。別の project が `catalog_path` を持っていても、run の対象 project に `catalog_path` がなければ適用外です。対象 project に `catalog_path` があっても、executor の変更(runner 管理記録を除き、rename は変更前後の両方を見ます)が `docs/ja/projects/` 配下に及ばない run では、plan の共通規約の検証表と同じく適用外とし、executor の `not_applicable` も受理します。変更が及ぶ run では従来どおり適用対象です。また、`<repo>:<path>` を引数に含むコマンド、`--prefix <repo>` 付きのコマンド、または `$SPECDOJO_REPO_<NAME>` / `${SPECDOJO_REPO_<NAME>}` を含むコマンドは、対象 project が `repos` で宣言したそのプロダクトリポジトリの `package.json` で script と依存を判定します(`--prefix` はリポジトリ名か設定の `path` と一致するものを対象にします)。設定が読めない、対象 project を特定できない、または適用条件を未定義のサブコマンドは機械的な救済をせず、通常の `not_run` として扱います。executor の failed は親 runner の成功や適用外判定で打ち消しません。`npm run check` のように npm script を `&&` でつないだだけの合成コマンドを executor が `not_run` とした場合は、対象リポジトリの `package.json` の script を展開し、構成する各コマンドが同じリポジトリの親検証か executor 自身の検証で通っていれば満たされたものとして扱います。`npm test` は、`npm run test:unit` と `npm run test:integration` の両方が通っていれば満たされたものとします。構成するコマンドの script の中身と同じコマンドを executor が直接実行して通した場合も満たします(`tsx` の起動の書き方の違いはそろえて比べます)。任意のシェルを含む script は展開しません。理由付きの `not_applicable` は block の理由にせず、runner が edit result の申し送りへ「適用外の検証: `<コマンド>`(<理由>)」として機械的に追記します。ただし、理由がない場合、変更ファイル種別を含む適用条件を満たした `npm run <name>` の script が存在する場合、または同条件を満たした `npx <package>` の package が `dependencies` / `devDependencies` に存在する場合は誤申告として blocked にします。SpecDojo サブコマンドは package の有無だけでは反証せず、既知の適用条件を設定から判定します。適用条件が未定義なら理由付きの agent の申告に従います。`specdojo index build`(`npx specdojo index build`・`node --import tsx src/specdojo.ts index build` などの起動形を含みます)は runner が担う検証です。出力先の `.specdojo/doc-index.json` は agent が書き込めず、index は worktree の準備と統合の前に runner が再生成するため、executor への指示では実行も記録もしないよう伝えます。executor が `not_run` / `not_applicable` と記録しても block の理由にせず、`not_run` の場合は edit result の申し送りへ「runner が担う検証: `<コマンド>`(<理由>)」として追記します。runner の再生成が失敗した場合は worktree の準備で run が止まるか、runner の検証の失敗として block するため、満たしたものとは扱いません。executor の failed は救済せず、ほかの SpecDojo サブコマンドの `not_run` の扱いも変えません。executor の `requires_human` は block の理由にせず、runner が edit result の申し送りへ「人の確認が必要: `<コマンド>`(<要約>)」として機械的に追記します。項目は review へ進み、人が確認してから close します。
593
+ - result の `changed_files` のパスは evidence の `changes` から、execution の evidence、project register とその派生ビュー、当該 result という runner 管理記録を除いて runner が機械生成します。除外後の変更一覧だけを reporter へ渡し、edit の変更説明は evidence のパスと対にして受け取ります。runner はパスで突き合わせるため、説明の順序は問いません。説明が不足したパスには Git の変更メタデータ(追加・変更・削除・名前の変更、行数)を記録し、変更ファイルが多い場合(50 件超)はディレクトリごとに集約して記録します。evidence にないパスの説明は捨てます。`outcome` と `block_reason` は stage の状態・終了コード・保護機構が保存した理由・executor / 親 runner の検証から機械生成します。reporter の JSON Schema は文章項目と対応づけ用のパスだけを受け付け、いずれかの検証が failed または `not_run` なら、reporter の文章にかかわらず機械判定は blocked です。ただし、executor が `not_run` または `not_applicable` と記録したコマンドを、親 runner が同じリポジトリで同じコマンドとして実行し成功していれば、親 runner の結果を正として executor の報告を無視します。さらに、`npm run <name>` に対応する script がない、`npx <package>` の package が `dependencies` / `devDependencies` にない、検査の対象となる種類の変更ファイルがない、または SpecDojo サブコマンドの設定上の適用条件を満たさないことを runner が機械的に確定できる場合、その `not_run` は block せず、edit result の申し送りへ「適用外の検証(runner の判定)」として追記します。変更ファイル種別で判定する対応は共通規約の検査表を正本とし、`validate:schema:file` は `*.yaml` / `*.yml`、Prettier は `*.md` / `*.ts` / `*.js` / `*.json` / `*.yaml` / `*.yml`、markdownlint は `*.md`、`validate:history-links`(`specdojo-docs-lint history-links` を含む)は履歴蓄積ファイル(`pjr-*.md`(`pjr-index.md` を除く)、または executor 自身が変更した `execution/runs/<origin>/<item>/<run>/` 配下の `plan.md`・`result.md` や旧来の `exec/plans/**/*.md`・`exec/results/**/*.md`)の変更がある場合だけ適用対象とします。変更範囲の判定では、runner が生成・更新する `exec/` 配下(`plans/`・`results/`・`evidence/`・`events/`・`.locks/`)を executor の変更ファイルから除外し、rename は変更前後の両方を見て、プロダクトリポジトリのコマンドはそのリポジトリの変更だけで判定します。`typecheck` など、この対応に含まれない検査の判定は変更しません。SpecDojo の起動形は `specdojo <subcommand>`、`npx specdojo <subcommand>`、ソース/配布済み CLI の直接起動を認識し、`catalog validate`(`npm run validate:catalog` および `tools/catalog-validate-if-configured.mjs` を含む)は対象 project の `catalog_path` で判定します。対象 project は、コマンドの `--project <id>`、run の対象 project(runner が execution path に一致する project を設定から特定したもの)、`current_project` の順に決めます。別の project が `catalog_path` を持っていても、run の対象 project に `catalog_path` がなければ適用外です。対象 project に `catalog_path` があっても、executor の変更(runner が書く `exec/` 配下などの runner 管理記録を除き、rename は変更前後の両方を見ます)が `docs/ja/projects/` 配下に及ばない run では、plan の共通規約の検証表と同じく適用外とし、executor の `not_applicable` も受理します。変更が及ぶ run では従来どおり適用対象です。また、`<repo>:<path>` を引数に含むコマンド、`--prefix <repo>` 付きのコマンド、または `$SPECDOJO_REPO_<NAME>` / `${SPECDOJO_REPO_<NAME>}` を含むコマンドは、対象 project が `repos` で宣言したそのプロダクトリポジトリの `package.json` で script と依存を判定します(`--prefix` はリポジトリ名か設定の `path` と一致するものを対象にします)。設定が読めない、対象 project を特定できない、または適用条件を未定義のサブコマンドは機械的な救済をせず、通常の `not_run` として扱います。executor の failed は親 runner の成功や適用外判定で打ち消しません。`npm run check` のように npm script を `&&` でつないだだけの合成コマンドを executor が `not_run` とした場合は、対象リポジトリの `package.json` の script を展開し、構成する各コマンドが同じリポジトリの親検証か executor 自身の検証で通っていれば満たされたものとして扱います。`npm test` は、`npm run test:unit` と `npm run test:integration` の両方が通っていれば満たされたものとします。構成するコマンドの script の中身と同じコマンドを executor が直接実行して通した場合も満たします(`tsx` の起動の書き方の違いはそろえて比べます)。任意のシェルを含む script は展開しません。理由付きの `not_applicable` は block の理由にせず、runner が edit result の申し送りへ「適用外の検証: `<コマンド>`(<理由>)」として機械的に追記します。ただし、理由がない場合、変更ファイル種別を含む適用条件を満たした `npm run <name>` の script が存在する場合、または同条件を満たした `npx <package>` の package が `dependencies` / `devDependencies` に存在する場合は誤申告として blocked にします。SpecDojo サブコマンドは package の有無だけでは反証せず、既知の適用条件を設定から判定します。適用条件が未定義なら理由付きの agent の申告に従います。`specdojo index build`(`npx specdojo index build`・`node --import tsx src/specdojo.ts index build` などの起動形を含みます)は runner が担う検証です。出力先の `.specdojo/doc-index.json` は agent が書き込めず、index は worktree の準備と統合の前に runner が再生成するため、executor への指示では実行も記録もしないよう伝えます。executor が `not_run` / `not_applicable` と記録しても block の理由にせず、`not_run` の場合は edit result の申し送りへ「runner が担う検証: `<コマンド>`(<理由>)」として追記します。runner の再生成が失敗した場合は worktree の準備で run が止まるか、runner の検証の失敗として block するため、満たしたものとは扱いません。executor の failed は救済せず、ほかの SpecDojo サブコマンドの `not_run` の扱いも変えません。executor の `requires_human` は block の理由にせず、runner が edit result の申し送りへ「人の確認が必要: `<コマンド>`(<要約>)」として機械的に追記します。項目は review へ進み、人が確認してから close します。
563
594
  - `completion_status` は作業の完了状態を示す省略可能な欄で、値は `complete` / `incomplete` です。欄のない既存の報告は `complete` として扱います。値が指定されていてこの 2 値に合わない場合は、安全側に倒して `incomplete` として保存します。executor は計画の作業を終えられなかった場合、`incomplete` とし、理由を `final_message`、残作業を `handoff` に書きます。終了コード 0 や親検証の成功では未完了の申告を上書きしません。`exec run --register` は親検証・reporter を起動する前に停止し、項目を `waiting` にして、秘匿処理・文字数制限を適用した `final_message` の要旨を `block_reason` に記録します。worktree 実行では変更と evidence を残し、統合しません。pipeline の executor は `blocked`、evidence の `stage.status` と `exit_code` は実際のプロセス結果のままとします。`--resume --resume-from executor`(または `--resume`)で再開でき、前回の理由と `handoff`、途中の変更を executor に引き継ぎます。完了を申告し直し、必要な検証を通過してから review・統合へ進みます。
595
+ - approach が報告に求める項目は、runner が reporter の起動前に検査します。現在の対象は `condense` の edit が求める `condense_records` で、欠けている、または形式が正しくない場合は reporter の失敗にせず executor の段の失敗とします。evidence を `completion_status: incomplete` とし、理由と再開の操作(schedule は `exec resume --task <id> --resume-from executor`、register は `exec run --register <id> --worktree --resume --resume-from executor`、agent を替える場合は `--executor-by`)を `block_reason` と result に残します。pipeline の executor は `blocked` です。再開は executor の段から始まり、reporter だけを同じ evidence で流し直しません。この検査より前に記録され、reporter の段で止まった run も、reporter の再開時に同じ検査で executor の段へ戻します。
564
596
  - `handoff` は executor が申し送る判断の理由、保護された設定の変更案、次のアクションなどの文字列配列です。先頭 100 件、各 4,000 文字までを秘匿処理して evidence に保存し、空文字列や文字列以外の要素は除外します。省略した既存の報告・evidence も有効です。reporter にはこの欄も渡し、edit result の「申し送り」には runner が reporter の補足と合わせて機械的に転記します。同一の文字列は重複させず、reporter が省略しても executor の記録は残します。register の完了条件が result への記録を求める場合、pipeline の executor は個票の対応結果と報告の `handoff` の両方に書きます。close の前には個票の対応結果と result の両方を確認します。
565
597
  - reporter の出力は JSON Schema で厳格に検証します。形式不正のときは同じ plan と evidence のまま reporter だけを最大 3 回再実行し、executor は再実行しません。
566
598
  - reporter stage の再開では、現在の設定 ID と一致する親検証が保存済み evidence にそろっている場合だけ executor evidence を再利用します。`{ id, repo }` を使う場合は、ID とリポジトリの組が一致することを求めます。再実行時も同じ割り当てで、各リポジトリの worktree を `cwd` にします。保存済みの親検証がすべて成功していれば再実行しません。`failed` / `not_run` があれば、親 runner が現在の worktree で固定許可リストの親検証を再実行し、同じ ID の結果を evidence 上で置換してから reporter へ渡します。過去の親検証ログは置換せず、新しい失敗ログだけを追加します。executor 由来の検証は再実行・置換しません。設定 ID が変わった、または結果が欠けている場合、Schedule 実行は新しい executor run としてやり直し、register 実行は明示的な再実行を促して再開を拒否します。
@@ -572,13 +604,13 @@ agent が exec 実行時に読み込む provider 固有の設定(agent 定義
572
604
 
573
605
  配置規則は provider 名から機械的に決まります(`agents/` 配下 → `.<provider>/agents/`、`rules/` 配下 → `.<provider>/rules/`、`opencode.json` → リポジトリ直下の `opencode.json`、それ以外のファイル → `.specdojo/<provider>/`、`README.md` はコピーしません)。provider ごとの配布内容は次のとおりです。
574
606
 
575
- | provider | 配布内容 | 配置先 |
576
- | ----------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------- |
577
- | claude | `agents/*.md`(役割ごとの agent 定義)、`settings.edit.json` / `settings.orchestrator.json` / `settings.review.json` / `settings.report.json` | `.claude/agents/`、`.specdojo/claude/` |
578
- | codex | `agents/*.toml`(親 Codex が spawn する subagent 定義)、`rules/*.rules`(command rule) | `.codex/agents/`、`.codex/rules/` |
579
- | opencode | `agents/*.md`(permission frontmatter 込みの agent 定義)、`opencode.json`(Ollama 接続・モデル設定) | `.opencode/agents/`、`opencode.json` |
580
- | copilot | `agent-members-snippet.yaml`(agent 定義)と `exec-defaults-snippet.yaml`(`providers.copilot` の command template・rate limit 検出)の参照スニペット | `.specdojo/copilot/` |
581
- | antigravity | `orchestrator.md`、agent / provider 設定スニペット。`settings.global.json` は `--global` 用のマージ原本であり repository へは配置しない | `.specdojo/antigravity/` |
607
+ | provider | 配布内容 | 配置先 |
608
+ | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------- |
609
+ | claude | `agents/*.md`(役割ごとの agent 定義)、`settings.edit.json` / `settings.orchestrator.json` / `settings.review.json` / `settings.report.json` | `.claude/agents/`、`.specdojo/claude/` |
610
+ | codex | `agents/*.toml`(親 Codex が spawn する subagent 定義)、`rules/*.rules`(command rule) | `.codex/agents/`、`.codex/rules/` |
611
+ | opencode | `agents/*.md`(permission frontmatter 込みの agent 定義)、`opencode.json`(Ollama 接続・モデル設定) | `.opencode/agents/`、`opencode.json` |
612
+ | copilot | `agent-members-snippet.yaml`(agent 定義)と `exec-defaults-snippet.yaml`(`providers.copilot` の command template・rate limit 検出)の参照スニペット | `.specdojo/copilot/` |
613
+ | antigravity | 役割別 `settings.edit.json` / `settings.review.json` / `settings.report.json` / `settings.orchestrator.json`、orchestrator と設定スニペット。旧 `settings.global.json` は互換用途だけに使用 | `.specdojo/antigravity/` |
582
614
 
583
615
  導入手順と手動設定(`.codex/config.toml` や接続先 URL の調整、Modelfile によるローカル派生タグの作成など)は各 `templates/<provider>/README.md` を参照します。
584
616
 
@@ -683,7 +715,7 @@ provider によらず、exec の実行構造そのものが次の境界を提供
683
715
  | git 操作の分離 | `git add` / `commit` / `merge` は specdojo CLI が親プロセスで行い、agent には git 権限を与えない |
684
716
  | Git 環境・状態ガード | repository 固有環境を除去し、agent 前後の HEAD・local config 変更を検知して block する |
685
717
  | ready 昇格の human-only 化 | 成果物 `status` の `ready` への昇格を commit 時に検出し、agent 実行では block する |
686
- | commit 対象の除外 | `exec/plans/` `exec/events/` `generated/` 他タスクの `exec/results/` は commit しない |
718
+ | commit 対象の除外 | `plan.md`、対象 run 以外の `execution/runs/`、`exec/events/`、`generated/` は commit しない |
687
719
  | merge の重複ガード | root 側の未 commit 変更と merge 対象パスが重複する場合は merge しない |
688
720
 
689
721
  ### 8.2. provider 別の権限設定
@@ -739,13 +771,13 @@ providers:
739
771
  --deny-tool 'shell(git push)' --deny-tool 'shell(git reset)'
740
772
  ```
741
773
 
742
- **antigravity**(Antigravity CLI `agy`)は codex と同じく `--agent` による定義ファイルの選択を持たないため、役割は plan の共通規約で与えます。非対話実行は `-p` ですが、プロンプトを引数に取り stdin を読まないので、runner が stdin へ書く plan を `"$(cat)"` で引数に渡します(command は `shell: true` で実行されます)。
774
+ **antigravity**(Antigravity CLI `agy`)の pipeline の役割指示は plan の共通規約を正本とし、権限は `agent launch --role {mode}` が分離します。非対話実行は `-p` ですが、プロンプトを引数に取り stdin を読まないので、runner が stdin へ書く plan を `"$(cat)"` で引数に渡します(command は `shell: true` で実行されます)。
743
775
 
744
776
  ```yaml
745
777
  providers:
746
778
  antigravity:
747
779
  command_template: >-
748
- agy --sandbox --add-dir "$(pwd)" --model {model} -p "$(cat)"
780
+ specdojo agent launch --provider antigravity --role {mode} -- --sandbox --model {model} -p "$(cat)"
749
781
  command_params:
750
782
  by_proficiency:
751
783
  normal: { model: gemini-3.8-flash-medium }
@@ -758,7 +790,7 @@ providers:
758
790
  ```
759
791
 
760
792
  - `--sandbox` は書き込み先を `~/.gemini/antigravity-cli/scratch/` へ逃がすため、`--add-dir "$(pwd)"` で作業ディレクトリ(worktree)を明示して成果物へ書けるようにします。`--add-dir` なしでは成果物が更新されません。
761
- - 非対話実行に必要な permission rule は `config scaffold --provider antigravity --global` で設定します。すべてのリポジトリに効くため、先に `--global --dry-run` で差分を確認します。`--dangerously-skip-permissions` は deny rule を含む承認境界を迂回するため使いません。
793
+ - `config scaffold --provider antigravity` で役割別の設定を配置します。`agent launch` がプロファイルと宣言済み task worktree ごとの絶対パスの保護を一つの `--settings` JSON にまとめます。通常導入はユーザー設定を書き換えず、`--global` は不要です。review / report は全ファイルの書き込みと command / MCP を拒否し、親 runner が検証します。対話型は `orchestrator launch` が専用の設定を渡します。`--dangerously-skip-permissions` は使いません。既存の command template・個別 command・npm script の移行と、未確認のグローバル/project 設定マージの実機検証は [[sysd-antigravity-agent-settings|Antigravity CLI エージェント設定]] を参照してください。
762
794
  - モデルは `agy models` で確認します。標準モデルは `by_proficiency`、Antigravity 経由の Claude / GPT は `by_nickname` で選びます。モデル ID は推論強度を含む(`gemini-3.8-flash-medium` など)ため `--effort` は併用しません。ID と `--effort` が食い違うと `invalid model selection` で起動に失敗します。
763
795
  - 資格情報はコンテナ内では `~/.gemini/antigravity-cli/antigravity-oauth-token` に保存されます。devcontainer では `~/.gemini` を名前付きボリュームにして永続化します。
764
796
  - `--output-format json --json-schema <file>` は `structured_output` を含む JSON エンベロープを返します。runner の reporter は stdout の本文から JSON を読むため、現時点では既定のテキスト出力を使います。
@@ -782,11 +814,12 @@ providers:
782
814
  | human / edit | 対象 task の result、result frontmatter の `targets` から解決した成果物パス |
783
815
  | edit(maintenance / bootstrap 系 approach) | 上記に加え、実践の型ディレクトリ(rulebooks / recipes / samples / templates) |
784
816
 
785
- - 許可リスト外の変更は commit 対象に含めず、検出時は `commit-scope:` 警告として対象パスを出力します(worktree 内には残るため、必要なら人間が確認して手動で取り込みます)。
786
- - 既存の除外リスト(`exec/plans/` 等)は許可リストの内側でも引き続き適用します。
817
+ - agent の許可リスト外の変更が残っていれば、`commit-scope: integration blocked` と対象パスを出力し、commit・統合・通常の worktree 撤去を止めます。対象パスと次のアクションを result の申し送りと `integrate.log` に残し、worktree を保持します。再開時も同じ検査を適用します。human の schedule タスクは result による選択を維持します。
818
+ - `bootstrap` と `*-maintenance` でも、成果物カタログ・schema・文書サイトの型のメニューを一括で許可しません。これらは他の成果物や親 runner の動作へ影響するため、明示された `targets` で解決できるファイルだけを commit 対象にします。対象外なら変更せず、変更理由・対象パス・提案差分・必要な検証を個票の対応結果(register タスクの場合)と executor 報告の `handoff` に書き、対象の見直しまたは別タスクで反映します。
819
+ - 既存の除外リスト(`plan.md` や対象 run 以外の実行記録等)は許可リストの内側でも引き続き適用します。
787
820
  - agent の mode / approach / `targets` は worktree の **agent 起動前の HEAD 側** plan(CLI が checkpoint commit した版)から読みます。agent 前後の HEAD は runner が比較し、agent 自身の commit や checkout を検知した場合は統合前に block するため、許可リストの導出は改ざん耐性があります。
788
821
  - human は plan を持たないため、HEAD 側 result の `execution: human`、mode、approach、`targets` から許可リストを導出します。human には敵対 agent が存在しないため、plan を独立した改ざん耐性境界にする要件は適用しません。
789
- - `targets` の doc id は HEAD 側 doc-index でパスへ解決し、未登録の場合(未作成の新規成果物)は catalog(`dct-*.yaml`)が宣言するパスへフォールバックします。どちらでも解決できない id は警告を出し、commit を許可しません。
822
+ - `targets` の doc id は HEAD 側 doc-index でパスへ解決し、未登録の場合(未作成の新規成果物)は catalog(`dct-*.yaml`)が宣言するパスへフォールバックします。どちらでも解決できない id は `unresolved target doc id (no individual path; approach directory permissions still apply)` を出力し、その id による個別パスの許可は追加しません。approach が許可する型のディレクトリ内のファイルは、id の解決と独立して commit 対象になります。ディレクトリの許可もないファイルの変更は、上記の停止ガードの対象です。
790
823
  - `retrofit` の `evidence_refs` は plan 本文へ読み取り専用の調査入力として展開されますが、`targets` や実践の型ディレクトリの許可には変換されません。実装エビデンスへの変更は commit 対象外です。
791
824
  - agent で HEAD に plan が無い場合、または human で HEAD に result が無い場合など、frontmatter から task 識別を復元できない場合のみ従来の除外リスト方式へフォールバックします。CLI 経由では正本となる plan / result を checkpoint するため、agent 側からこの分岐を誘発することはできません。
792
825
  - この許可リストは specdojo CLI が行う commit にのみ効くため、**agent 自身に `git commit` を許可しないこと**が全 provider 共通の前提になります。agent が exec branch 上に直接 commit すると許可リストを経由せず merge に到達します。claude は settings の allow に `git add` / `git commit` を含めません(`-p` 実行では未許可ツールは自動拒否されます)、codex は共有 `.git` が worktree 外にあるため sandbox が書き込みを遮断します、opencode は `bash` の許可リストで塞ぎます。