specdojo 0.1.0 → 0.2.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 (531) hide show
  1. package/LICENSE +22 -0
  2. package/README.md +82 -38
  3. package/dist/agent-response.js +27 -0
  4. package/dist/agent.js +124 -0
  5. package/dist/build-command.js +149 -0
  6. package/dist/build-if-stale.js +35 -0
  7. package/dist/catalog-build.js +1079 -0
  8. package/dist/catalog-generate.js +226 -0
  9. package/dist/catalog-paths.js +31 -0
  10. package/dist/catalog-plan-generate.js +301 -0
  11. package/dist/catalog-plan-prompt.js +73 -0
  12. package/dist/catalog-plan.js +471 -0
  13. package/dist/catalog-scaffold.js +255 -0
  14. package/dist/catalog-types.js +4 -0
  15. package/dist/catalog.js +606 -0
  16. package/dist/dashboard.js +980 -0
  17. package/dist/deliverable-trash.js +148 -0
  18. package/dist/deliverable.js +97 -0
  19. package/dist/dist-freshness.js +150 -0
  20. package/dist/doc-index.js +424 -0
  21. package/dist/exec-agent-config.js +172 -0
  22. package/dist/exec-agent-git-state.js +136 -0
  23. package/dist/exec-agent-protected-config.js +276 -0
  24. package/dist/exec-events.js +250 -112
  25. package/dist/exec-evidence.js +317 -0
  26. package/dist/exec-format.js +45 -0
  27. package/dist/exec-limit.js +202 -0
  28. package/dist/exec-parent-validation.js +169 -0
  29. package/dist/exec-pipeline-state.js +160 -0
  30. package/dist/exec-plans.js +1016 -0
  31. package/dist/exec-project.js +25 -11
  32. package/dist/exec-protection-handoff.js +169 -0
  33. package/dist/exec-provider-scaffold.js +99 -0
  34. package/dist/exec-register-resume.js +196 -0
  35. package/dist/exec-register.js +281 -0
  36. package/dist/exec-reporter.js +329 -0
  37. package/dist/exec-results.js +510 -0
  38. package/dist/exec-run-lock.js +149 -0
  39. package/dist/exec-run.js +4953 -0
  40. package/dist/exec-schedule-calendar.js +86 -9
  41. package/dist/exec-schedule-cpm.js +30 -12
  42. package/dist/exec-schedule-gantt-chart-render.js +428 -0
  43. package/dist/exec-schedule-gantt-chart-scope.js +111 -0
  44. package/dist/exec-schedule-gantt-chart.js +2 -0
  45. package/dist/exec-schedule-hash.js +34 -25
  46. package/dist/exec-schedule-index.js +200 -67
  47. package/dist/exec-schedule-initial.js +100 -0
  48. package/dist/exec-schedule-progress.js +51 -26
  49. package/dist/exec-schedule-ready.js +71 -27
  50. package/dist/exec-schedule.js +171 -93
  51. package/dist/exec-shared.js +146 -25
  52. package/dist/exec-strategy.js +547 -0
  53. package/dist/exec-task-view.js +64 -0
  54. package/dist/exec-trial.js +895 -0
  55. package/dist/exec-worktree-command.js +426 -0
  56. package/dist/exec-worktree-ops.js +847 -0
  57. package/dist/exec-worktree.js +359 -0
  58. package/dist/exec.js +744 -192
  59. package/dist/frontmatter-namespace.js +48 -0
  60. package/dist/git-environment.js +23 -0
  61. package/dist/grade-result.js +137 -0
  62. package/dist/grade.js +2456 -0
  63. package/dist/index-command.js +103 -0
  64. package/dist/job.js +1081 -0
  65. package/dist/kata-command.js +303 -0
  66. package/dist/kata.js +187 -0
  67. package/dist/package-paths.js +15 -0
  68. package/dist/practice-id.js +24 -0
  69. package/dist/register-date.js +122 -0
  70. package/dist/register-events.js +363 -0
  71. package/dist/register-history.js +323 -0
  72. package/dist/register-item.js +455 -0
  73. package/dist/register-migrate-timestamps.js +176 -0
  74. package/dist/register.js +2199 -0
  75. package/dist/review-plan.js +199 -0
  76. package/dist/review-types.js +1 -0
  77. package/dist/role-types.js +1 -0
  78. package/dist/routine.js +814 -0
  79. package/dist/schedule-approach.js +252 -0
  80. package/dist/schedule-build.js +552 -0
  81. package/dist/schedule-phase-sets.js +73 -0
  82. package/dist/schedule-strategy-generate.js +812 -0
  83. package/dist/schedule-strategy-profiles.js +276 -0
  84. package/dist/schedule.js +420 -0
  85. package/dist/spawn-self.js +28 -0
  86. package/dist/specdojo-config.js +133 -39
  87. package/dist/specdojo.js +55 -7
  88. package/dist/template-frontmatter.js +89 -0
  89. package/dist/template-resolution.js +92 -0
  90. package/dist/timeline-build.js +334 -0
  91. package/dist/timeline.js +107 -0
  92. package/dist/watch.js +313 -0
  93. package/dist/yaml-pages-command.js +28 -0
  94. package/dist/yaml-pages.js +180 -0
  95. package/dist/yaml-schema-modeline.js +49 -0
  96. package/docs/ja/specdojo/defaults/pm-review-viewpoints.yaml +600 -0
  97. package/docs/ja/specdojo/exec-templates/xep-bootstrap-template.md +120 -0
  98. package/docs/ja/specdojo/exec-templates/xep-common-conventions-template.md +37 -0
  99. package/docs/ja/specdojo/exec-templates/xep-cross-deliverable-dedup-template.md +51 -0
  100. package/docs/ja/specdojo/exec-templates/xep-freeform-template.md +74 -0
  101. package/docs/ja/specdojo/exec-templates/xep-fully-guided-template.md +109 -0
  102. package/docs/ja/specdojo/exec-templates/xep-job-template.md +43 -0
  103. package/docs/ja/specdojo/exec-templates/xep-recipe-guided-template.md +82 -0
  104. package/docs/ja/specdojo/exec-templates/xep-recipe-maintenance-template.md +86 -0
  105. package/docs/ja/specdojo/exec-templates/xep-register-investigate-template.md +42 -0
  106. package/docs/ja/specdojo/exec-templates/xep-register-template.md +49 -0
  107. package/docs/ja/specdojo/exec-templates/xep-retrofit-template.md +98 -0
  108. package/docs/ja/specdojo/exec-templates/xep-rulebook-maintenance-template.md +86 -0
  109. package/docs/ja/specdojo/exec-templates/xep-sample-maintenance-template.md +86 -0
  110. package/docs/ja/specdojo/exec-templates/xep-template-maintenance-template.md +86 -0
  111. package/docs/ja/specdojo/exec-templates/xep-template.md +66 -0
  112. package/docs/ja/specdojo/exec-templates/xer-cross-deliverable-dedup-template.md +31 -0
  113. package/docs/ja/specdojo/exec-templates/xer-human-bootstrap-finalize-template.md +40 -0
  114. package/docs/ja/specdojo/exec-templates/xer-human-finalize-template.md +30 -0
  115. package/docs/ja/specdojo/exec-templates/xer-template.md +19 -0
  116. package/docs/ja/specdojo/exec-templates/xrp-freeform-template.md +70 -0
  117. package/docs/ja/specdojo/exec-templates/xrp-fully-guided-template.md +97 -0
  118. package/docs/ja/specdojo/exec-templates/xrp-recipe-guided-template.md +76 -0
  119. package/docs/ja/specdojo/exec-templates/xrp-recipe-maintenance-template.md +73 -0
  120. package/docs/ja/specdojo/exec-templates/xrp-retrofit-template.md +74 -0
  121. package/docs/ja/specdojo/exec-templates/xrp-rulebook-maintenance-template.md +74 -0
  122. package/docs/ja/specdojo/exec-templates/xrp-sample-maintenance-template.md +73 -0
  123. package/docs/ja/specdojo/exec-templates/xrp-template-maintenance-template.md +73 -0
  124. package/docs/ja/specdojo/exec-templates/xrp-template.md +67 -0
  125. package/docs/ja/specdojo/exec-templates/xrp-viewpoint-detail-template.md +7 -0
  126. package/docs/ja/specdojo/exec-templates/xrr-template.md +21 -0
  127. package/docs/ja/specdojo/exec-templates/xrr-viewpoint-detail-template.md +7 -0
  128. package/docs/ja/specdojo/guides/branch-workflow-guide.md +354 -0
  129. package/docs/ja/specdojo/guides/docs-editing-guide.md +327 -0
  130. package/docs/ja/specdojo/guides/docs-structure-guide.md +519 -0
  131. package/docs/ja/specdojo/guides/exec-config-guide.md +589 -0
  132. package/docs/ja/specdojo/guides/exec-operation-guide.md +440 -0
  133. package/docs/ja/specdojo/guides/exec-worktree-guide.md +318 -0
  134. package/docs/ja/specdojo/guides/kata-guide.md +89 -0
  135. package/docs/ja/specdojo/guides/orchestrator-operation-guide.md +127 -0
  136. package/docs/ja/specdojo/guides/plan-result-lifecycle-guide.md +228 -0
  137. package/docs/ja/specdojo/guides/practice-system-composition-guide.md +111 -0
  138. package/docs/ja/specdojo/guides/quick-start-guide.md +473 -0
  139. package/docs/ja/specdojo/guides/register-operation-guide.md +418 -0
  140. package/docs/ja/specdojo/guides/review-guide.md +428 -0
  141. package/docs/ja/specdojo/guides/routine-operation-guide.md +282 -0
  142. package/docs/ja/specdojo/guides/ryu-guide.md +230 -0
  143. package/docs/ja/specdojo/guides/schedule-design-guide.md +429 -0
  144. package/docs/ja/specdojo/guides/schedule-operation-guide.md +151 -0
  145. package/docs/ja/specdojo/guides/specdojo-overview-guide.md +257 -0
  146. package/docs/ja/specdojo/guides/timeline-design-guide.md +160 -0
  147. package/docs/ja/specdojo/guides/track-design-guide.md +215 -0
  148. package/docs/ja/specdojo/guides/use-case-guide.md +133 -0
  149. package/docs/ja/specdojo/guides/waza-guide.md +224 -0
  150. package/docs/ja/specdojo/index.md +33 -0
  151. package/docs/ja/specdojo/philosophy/needs-to-implementation-philosophy.md +212 -0
  152. package/docs/ja/specdojo/philosophy/specdojo-philosophy.md +242 -0
  153. package/docs/ja/specdojo/recipes/cdfd-overview-recipe.md +198 -0
  154. package/docs/ja/specdojo/recipes/cdfd-recipe.md +218 -0
  155. package/docs/ja/specdojo/recipes/cdfd-uc-recipe.md +198 -0
  156. package/docs/ja/specdojo/recipes/exec-human-finalize-recipe.md +100 -0
  157. package/docs/ja/specdojo/recipes/ifx-cmd-recipe.md +148 -0
  158. package/docs/ja/specdojo/recipes/pm-communication-plan-recipe.md +97 -0
  159. package/docs/ja/specdojo/recipes/pm-members-recipe.md +149 -0
  160. package/docs/ja/specdojo/recipes/pm-organization-recipe.md +96 -0
  161. package/docs/ja/specdojo/recipes/pm-plan-recipe.md +98 -0
  162. package/docs/ja/specdojo/recipes/pm-quality-management-plan-recipe.md +97 -0
  163. package/docs/ja/specdojo/recipes/pm-raci-recipe.md +96 -0
  164. package/docs/ja/specdojo/recipes/pm-roles-recipe.md +136 -0
  165. package/docs/ja/specdojo/recipes/prj-assumptions-constraints-dependencies-recipe.md +162 -0
  166. package/docs/ja/specdojo/recipes/prj-charter-recipe.md +187 -0
  167. package/docs/ja/specdojo/recipes/prj-comparison-of-alternatives-recipe.md +235 -0
  168. package/docs/ja/specdojo/recipes/prj-issues-and-approach-recipe.md +205 -0
  169. package/docs/ja/specdojo/recipes/prj-overview-recipe.md +289 -0
  170. package/docs/ja/specdojo/recipes/prj-scope-recipe.md +201 -0
  171. package/docs/ja/specdojo/recipes/prj-stakeholder-register-recipe.md +168 -0
  172. package/docs/ja/specdojo/recipes/prj-success-criteria-and-acceptance-criteria-recipe.md +179 -0
  173. package/docs/ja/specdojo/recipes/stsd-recipe.md +138 -0
  174. package/docs/ja/specdojo/references/command-reference.md +718 -0
  175. package/docs/ja/specdojo/references/deliverables-reference.md +407 -0
  176. package/docs/ja/specdojo/references/directory-layout-reference.md +280 -0
  177. package/docs/ja/specdojo/references/specdojo-config-reference.md +133 -0
  178. package/docs/ja/specdojo/rulebooks/atc-index-rulebook.md +372 -0
  179. package/docs/ja/specdojo/rulebooks/atc-rulebook.md +302 -0
  180. package/docs/ja/specdojo/rulebooks/bac-rulebook.md +331 -0
  181. package/docs/ja/specdojo/rulebooks/bdd-rulebook.md +134 -0
  182. package/docs/ja/specdojo/rulebooks/bds-rulebook.md +207 -0
  183. package/docs/ja/specdojo/rulebooks/bes-index-rulebook.md +102 -0
  184. package/docs/ja/specdojo/rulebooks/bes-rulebook.md +131 -0
  185. package/docs/ja/specdojo/rulebooks/bps-rulebook.md +269 -0
  186. package/docs/ja/specdojo/rulebooks/br-rulebook.md +187 -0
  187. package/docs/ja/specdojo/rulebooks/ccd-mermaid-rulebook.md +279 -0
  188. package/docs/ja/specdojo/rulebooks/cdfd-mermaid-rulebook.md +219 -0
  189. package/docs/ja/specdojo/rulebooks/cdfd-overview-rulebook.md +233 -0
  190. package/docs/ja/specdojo/rulebooks/cdfd-rulebook.md +182 -0
  191. package/docs/ja/specdojo/rulebooks/cdfd-uc-rulebook.md +171 -0
  192. package/docs/ja/specdojo/rulebooks/cdsd-rulebook.md +105 -0
  193. package/docs/ja/specdojo/rulebooks/cld-rulebook.md +195 -0
  194. package/docs/ja/specdojo/rulebooks/cnd-mermaid-rulebook.md +285 -0
  195. package/docs/ja/specdojo/rulebooks/cnd-rulebook.md +292 -0
  196. package/docs/ja/specdojo/rulebooks/cop-index-rulebook.md +171 -0
  197. package/docs/ja/specdojo/rulebooks/cop-rulebook.md +325 -0
  198. package/docs/ja/specdojo/rulebooks/cpd-mermaid-rulebook.md +266 -0
  199. package/docs/ja/specdojo/rulebooks/cpd-rulebook.md +294 -0
  200. package/docs/ja/specdojo/rulebooks/cstd-rulebook.md +21 -0
  201. package/docs/ja/specdojo/rulebooks/cxd-mermaid-rulebook.md +401 -0
  202. package/docs/ja/specdojo/rulebooks/cxd-rulebook.md +311 -0
  203. package/docs/ja/specdojo/rulebooks/dct-index-rulebook.md +158 -0
  204. package/docs/ja/specdojo/rulebooks/dct-rulebook.md +287 -0
  205. package/docs/ja/specdojo/rulebooks/dec-rulebook.md +62 -0
  206. package/docs/ja/specdojo/rulebooks/dmd-index-rulebook.md +100 -0
  207. package/docs/ja/specdojo/rulebooks/dmd-rulebook.md +298 -0
  208. package/docs/ja/specdojo/rulebooks/etc-index-rulebook.md +379 -0
  209. package/docs/ja/specdojo/rulebooks/etc-rulebook.md +310 -0
  210. package/docs/ja/specdojo/rulebooks/gl-rulebook.md +86 -0
  211. package/docs/ja/specdojo/rulebooks/ifd-mermaid-rulebook.md +297 -0
  212. package/docs/ja/specdojo/rulebooks/ifx-api-rulebook.md +79 -0
  213. package/docs/ja/specdojo/rulebooks/ifx-cmd-rulebook.md +213 -0
  214. package/docs/ja/specdojo/rulebooks/ifx-file-rulebook.md +311 -0
  215. package/docs/ja/specdojo/rulebooks/ifx-index-rulebook.md +94 -0
  216. package/docs/ja/specdojo/rulebooks/ifx-msg-rulebook.md +81 -0
  217. package/docs/ja/specdojo/rulebooks/imp-business-rulebook.md +117 -0
  218. package/docs/ja/specdojo/rulebooks/imp-data-rulebook.md +118 -0
  219. package/docs/ja/specdojo/rulebooks/imp-interface-rulebook.md +116 -0
  220. package/docs/ja/specdojo/rulebooks/imp-operations-rulebook.md +116 -0
  221. package/docs/ja/specdojo/rulebooks/imp-test-rulebook.md +116 -0
  222. package/docs/ja/specdojo/rulebooks/itc-index-rulebook.md +421 -0
  223. package/docs/ja/specdojo/rulebooks/itc-rulebook.md +307 -0
  224. package/docs/ja/specdojo/rulebooks/mip-index-rulebook.md +312 -0
  225. package/docs/ja/specdojo/rulebooks/mm-rulebook.md +63 -0
  226. package/docs/ja/specdojo/rulebooks/mtp-rulebook.md +353 -0
  227. package/docs/ja/specdojo/rulebooks/nfr-availability-rulebook.md +184 -0
  228. package/docs/ja/specdojo/rulebooks/nfr-index-rulebook.md +179 -0
  229. package/docs/ja/specdojo/rulebooks/nfr-integrity-rulebook.md +184 -0
  230. package/docs/ja/specdojo/rulebooks/nfr-maintainability-rulebook.md +183 -0
  231. package/docs/ja/specdojo/rulebooks/nfr-operations-rulebook.md +185 -0
  232. package/docs/ja/specdojo/rulebooks/nfr-performance-rulebook.md +185 -0
  233. package/docs/ja/specdojo/rulebooks/nfr-reliability-rulebook.md +186 -0
  234. package/docs/ja/specdojo/rulebooks/nfr-security-safety-rulebook.md +186 -0
  235. package/docs/ja/specdojo/rulebooks/nfr-usability-rulebook.md +184 -0
  236. package/docs/ja/specdojo/rulebooks/ntp-rulebook.md +61 -0
  237. package/docs/ja/specdojo/rulebooks/opd-index-rulebook.md +84 -0
  238. package/docs/ja/specdojo/rulebooks/opd-rulebook.md +357 -0
  239. package/docs/ja/specdojo/rulebooks/opr-index-rulebook.md +80 -0
  240. package/docs/ja/specdojo/rulebooks/opr-rulebook.md +484 -0
  241. package/docs/ja/specdojo/rulebooks/otp-index-rulebook.md +120 -0
  242. package/docs/ja/specdojo/rulebooks/otp-rulebook.md +293 -0
  243. package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +211 -0
  244. package/docs/ja/specdojo/rulebooks/pm-change-request-log-rulebook.md +94 -0
  245. package/docs/ja/specdojo/rulebooks/pm-communication-plan-rulebook.md +116 -0
  246. package/docs/ja/specdojo/rulebooks/pm-issue-log-rulebook.md +93 -0
  247. package/docs/ja/specdojo/rulebooks/pm-members-rulebook.md +190 -0
  248. package/docs/ja/specdojo/rulebooks/pm-organization-rulebook.md +108 -0
  249. package/docs/ja/specdojo/rulebooks/pm-plan-rulebook.md +122 -0
  250. package/docs/ja/specdojo/rulebooks/pm-quality-management-plan-rulebook.md +117 -0
  251. package/docs/ja/specdojo/rulebooks/pm-raci-rulebook.md +116 -0
  252. package/docs/ja/specdojo/rulebooks/pm-risk-register-rulebook.md +93 -0
  253. package/docs/ja/specdojo/rulebooks/pm-roles-rulebook.md +146 -0
  254. package/docs/ja/specdojo/rulebooks/pr-rulebook.md +65 -0
  255. package/docs/ja/specdojo/rulebooks/prj-assumptions-constraints-dependencies-rulebook.md +178 -0
  256. package/docs/ja/specdojo/rulebooks/prj-charter-rulebook.md +232 -0
  257. package/docs/ja/specdojo/rulebooks/prj-comparison-of-alternatives-rulebook.md +235 -0
  258. package/docs/ja/specdojo/rulebooks/prj-issues-and-approach-rulebook.md +242 -0
  259. package/docs/ja/specdojo/rulebooks/prj-overview-rulebook.md +187 -0
  260. package/docs/ja/specdojo/rulebooks/prj-scope-rulebook.md +201 -0
  261. package/docs/ja/specdojo/rulebooks/prj-stakeholder-register-rulebook.md +165 -0
  262. package/docs/ja/specdojo/rulebooks/prj-success-criteria-and-acceptance-criteria-rulebook.md +165 -0
  263. package/docs/ja/specdojo/rulebooks/sac-rulebook.md +202 -0
  264. package/docs/ja/specdojo/rulebooks/sch-rulebook.md +139 -0
  265. package/docs/ja/specdojo/rulebooks/sf-index-rulebook.md +63 -0
  266. package/docs/ja/specdojo/rulebooks/sf-rulebook.md +93 -0
  267. package/docs/ja/specdojo/rulebooks/sld-rulebook.md +93 -0
  268. package/docs/ja/specdojo/rulebooks/stc-index-rulebook.md +329 -0
  269. package/docs/ja/specdojo/rulebooks/stc-rulebook.md +297 -0
  270. package/docs/ja/specdojo/rulebooks/stsd-mermaid-rulebook.md +132 -0
  271. package/docs/ja/specdojo/rulebooks/stsd-rulebook.md +215 -0
  272. package/docs/ja/specdojo/rulebooks/sysd-critical-flows-rulebook.md +376 -0
  273. package/docs/ja/specdojo/rulebooks/sysd-cross-cutting-policy-rulebook.md +313 -0
  274. package/docs/ja/specdojo/rulebooks/sysd-index-rulebook.md +246 -0
  275. package/docs/ja/specdojo/rulebooks/sysd-rulebook.md +119 -0
  276. package/docs/ja/specdojo/rulebooks/tml-rulebook.md +188 -0
  277. package/docs/ja/specdojo/rulebooks/trc-requirements-to-specs-rulebook.md +114 -0
  278. package/docs/ja/specdojo/rulebooks/trc-requirements-to-tests-rulebook.md +117 -0
  279. package/docs/ja/specdojo/rulebooks/tsd-index-rulebook.md +101 -0
  280. package/docs/ja/specdojo/rulebooks/tsd-rulebook.md +103 -0
  281. package/docs/ja/specdojo/rulebooks/tsp-index-rulebook.md +396 -0
  282. package/docs/ja/specdojo/rulebooks/uis-rulebook.md +207 -0
  283. package/docs/ja/specdojo/rulebooks/utc-index-rulebook.md +387 -0
  284. package/docs/ja/specdojo/rulebooks/utc-rulebook.md +303 -0
  285. package/docs/ja/specdojo/samples/atc-index-sample.md +38 -0
  286. package/docs/ja/specdojo/samples/atc-sample.md +41 -0
  287. package/docs/ja/specdojo/samples/bac-sample.md +38 -0
  288. package/docs/ja/specdojo/samples/bdd-sample.yaml +71 -0
  289. package/docs/ja/specdojo/samples/bds-sample.md +38 -0
  290. package/docs/ja/specdojo/samples/bes-index-sample.md +38 -0
  291. package/docs/ja/specdojo/samples/bes-sample.md +38 -0
  292. package/docs/ja/specdojo/samples/bps-sample.md +38 -0
  293. package/docs/ja/specdojo/samples/br-sample.md +40 -0
  294. package/docs/ja/specdojo/samples/ccd-sample.md +38 -0
  295. package/docs/ja/specdojo/samples/cdfd-overview-sample.md +284 -0
  296. package/docs/ja/specdojo/samples/cdfd-sample.md +229 -0
  297. package/docs/ja/specdojo/samples/cdfd-uc-sample.md +146 -0
  298. package/docs/ja/specdojo/samples/cdsd-sample.md +38 -0
  299. package/docs/ja/specdojo/samples/cld-sample.md +38 -0
  300. package/docs/ja/specdojo/samples/cnd-sample.md +38 -0
  301. package/docs/ja/specdojo/samples/cop-index-sample.md +38 -0
  302. package/docs/ja/specdojo/samples/cop-sample.md +38 -0
  303. package/docs/ja/specdojo/samples/cpd-sample.md +38 -0
  304. package/docs/ja/specdojo/samples/cstd-sample.md +11 -0
  305. package/docs/ja/specdojo/samples/cxd-sample.md +38 -0
  306. package/docs/ja/specdojo/samples/dct-index-sample.yaml +39 -0
  307. package/docs/ja/specdojo/samples/dct-sample.yaml +91 -0
  308. package/docs/ja/specdojo/samples/dec-sample.md +39 -0
  309. package/docs/ja/specdojo/samples/dmd-index-sample.md +50 -0
  310. package/docs/ja/specdojo/samples/dmd-sample.md +74 -0
  311. package/docs/ja/specdojo/samples/etc-index-sample.md +38 -0
  312. package/docs/ja/specdojo/samples/etc-sample.md +38 -0
  313. package/docs/ja/specdojo/samples/gl-sample.yaml +37 -0
  314. package/docs/ja/specdojo/samples/ifd-sample.md +38 -0
  315. package/docs/ja/specdojo/samples/ifx-api-sample.yaml +102 -0
  316. package/docs/ja/specdojo/samples/ifx-cmd-sample.yaml +107 -0
  317. package/docs/ja/specdojo/samples/ifx-file-sample.md +38 -0
  318. package/docs/ja/specdojo/samples/ifx-msg-sample.yaml +89 -0
  319. package/docs/ja/specdojo/samples/imp-business-sample.md +66 -0
  320. package/docs/ja/specdojo/samples/imp-data-sample.md +60 -0
  321. package/docs/ja/specdojo/samples/imp-interface-sample.md +60 -0
  322. package/docs/ja/specdojo/samples/imp-operations-sample.md +60 -0
  323. package/docs/ja/specdojo/samples/imp-test-sample.md +60 -0
  324. package/docs/ja/specdojo/samples/itc-index-sample.md +38 -0
  325. package/docs/ja/specdojo/samples/itc-sample.md +38 -0
  326. package/docs/ja/specdojo/samples/mip-index-sample.md +38 -0
  327. package/docs/ja/specdojo/samples/mm-sample.md +35 -0
  328. package/docs/ja/specdojo/samples/mtp-sample.md +38 -0
  329. package/docs/ja/specdojo/samples/nfr-availability-sample.md +38 -0
  330. package/docs/ja/specdojo/samples/nfr-index-sample.md +38 -0
  331. package/docs/ja/specdojo/samples/nfr-integrity-sample.md +38 -0
  332. package/docs/ja/specdojo/samples/nfr-maintainability-sample.md +38 -0
  333. package/docs/ja/specdojo/samples/nfr-operations-sample.md +38 -0
  334. package/docs/ja/specdojo/samples/nfr-performance-sample.md +38 -0
  335. package/docs/ja/specdojo/samples/nfr-reliability-sample.md +38 -0
  336. package/docs/ja/specdojo/samples/nfr-security-safety-sample.md +38 -0
  337. package/docs/ja/specdojo/samples/nfr-usability-sample.md +38 -0
  338. package/docs/ja/specdojo/samples/ntp-sample.md +38 -0
  339. package/docs/ja/specdojo/samples/opd-access-control-sample.md +29 -0
  340. package/docs/ja/specdojo/samples/opd-incident-management-sample.md +31 -0
  341. package/docs/ja/specdojo/samples/opd-index-sample.md +41 -0
  342. package/docs/ja/specdojo/samples/opd-monitoring-sample.md +32 -0
  343. package/docs/ja/specdojo/samples/opd-sample.md +38 -0
  344. package/docs/ja/specdojo/samples/opr-access-control-sample.md +24 -0
  345. package/docs/ja/specdojo/samples/opr-backup-restore-sample.md +27 -0
  346. package/docs/ja/specdojo/samples/opr-batch-sample.md +23 -0
  347. package/docs/ja/specdojo/samples/opr-change-sample.md +24 -0
  348. package/docs/ja/specdojo/samples/opr-incident-sample.md +38 -0
  349. package/docs/ja/specdojo/samples/opr-index-sample.md +43 -0
  350. package/docs/ja/specdojo/samples/opr-monitoring-sample.md +27 -0
  351. package/docs/ja/specdojo/samples/opr-sample.md +38 -0
  352. package/docs/ja/specdojo/samples/opr-support-sample.md +23 -0
  353. package/docs/ja/specdojo/samples/otp-index-sample.md +66 -0
  354. package/docs/ja/specdojo/samples/otp-sample.md +68 -0
  355. package/docs/ja/specdojo/samples/pm-change-request-log-sample.md +47 -0
  356. package/docs/ja/specdojo/samples/pm-communication-plan-sample.md +46 -0
  357. package/docs/ja/specdojo/samples/pm-issue-log-sample.md +45 -0
  358. package/docs/ja/specdojo/samples/pm-members-sample.yaml +103 -0
  359. package/docs/ja/specdojo/samples/pm-organization-sample.md +46 -0
  360. package/docs/ja/specdojo/samples/pm-plan-sample.md +57 -0
  361. package/docs/ja/specdojo/samples/pm-quality-management-plan-sample.md +52 -0
  362. package/docs/ja/specdojo/samples/pm-raci-sample.md +57 -0
  363. package/docs/ja/specdojo/samples/pm-risk-register-sample.md +43 -0
  364. package/docs/ja/specdojo/samples/pm-roles-sample.yaml +41 -0
  365. package/docs/ja/specdojo/samples/pr-sample.md +39 -0
  366. package/docs/ja/specdojo/samples/prj-assumptions-constraints-dependencies-sample.md +57 -0
  367. package/docs/ja/specdojo/samples/prj-charter-sample.md +121 -0
  368. package/docs/ja/specdojo/samples/prj-comparison-of-alternatives-sample.md +105 -0
  369. package/docs/ja/specdojo/samples/prj-issues-and-approach-sample.md +78 -0
  370. package/docs/ja/specdojo/samples/prj-overview-sample.md +95 -0
  371. package/docs/ja/specdojo/samples/prj-scope-sample.md +71 -0
  372. package/docs/ja/specdojo/samples/prj-stakeholder-register-sample.md +60 -0
  373. package/docs/ja/specdojo/samples/prj-success-criteria-and-acceptance-criteria-sample.md +62 -0
  374. package/docs/ja/specdojo/samples/sac-sample.md +38 -0
  375. package/docs/ja/specdojo/samples/sf-index-sample.md +38 -0
  376. package/docs/ja/specdojo/samples/sf-sample.md +38 -0
  377. package/docs/ja/specdojo/samples/sld-sample.md +38 -0
  378. package/docs/ja/specdojo/samples/stc-index-sample.md +38 -0
  379. package/docs/ja/specdojo/samples/stc-sample.md +38 -0
  380. package/docs/ja/specdojo/samples/stsd-sample.md +58 -0
  381. package/docs/ja/specdojo/samples/sysd-critical-flows-sample.md +38 -0
  382. package/docs/ja/specdojo/samples/sysd-cross-cutting-policy-sample.md +38 -0
  383. package/docs/ja/specdojo/samples/sysd-index-sample.md +38 -0
  384. package/docs/ja/specdojo/samples/trc-requirements-to-specs-sample.md +56 -0
  385. package/docs/ja/specdojo/samples/trc-requirements-to-tests-sample.md +56 -0
  386. package/docs/ja/specdojo/samples/tsd-index-sample.md +29 -0
  387. package/docs/ja/specdojo/samples/tsd-sample.md +38 -0
  388. package/docs/ja/specdojo/samples/tsp-index-sample.md +38 -0
  389. package/docs/ja/specdojo/samples/uis-sample.md +38 -0
  390. package/docs/ja/specdojo/samples/utc-index-sample.md +38 -0
  391. package/docs/ja/specdojo/samples/utc-sample.md +38 -0
  392. package/docs/ja/specdojo/schemas/v1/guide-content.schema.yaml +20 -0
  393. package/docs/ja/specdojo/schemas/v1/philosophy-content.schema.yaml +21 -0
  394. package/docs/ja/specdojo/schemas/v1/reference-content.schema.yaml +21 -0
  395. package/docs/ja/specdojo/standards/document-metadata-standard.md +323 -0
  396. package/docs/ja/specdojo/standards/exec-human-finalize-standard.md +75 -0
  397. package/docs/ja/specdojo/standards/git-branching-standard.md +227 -0
  398. package/docs/ja/specdojo/standards/guide-authoring-standard.md +124 -0
  399. package/docs/ja/specdojo/standards/id-and-file-naming-standard.md +929 -0
  400. package/docs/ja/specdojo/standards/job-definition-standard.md +148 -0
  401. package/docs/ja/specdojo/standards/people-and-organization-definition-standard.md +431 -0
  402. package/docs/ja/specdojo/standards/philosophy-authoring-standard.md +113 -0
  403. package/docs/ja/specdojo/standards/recipe-authoring-standard.md +143 -0
  404. package/docs/ja/specdojo/standards/reference-authoring-standard.md +99 -0
  405. package/docs/ja/specdojo/standards/rulebook-authoring-standard.md +140 -0
  406. package/docs/ja/specdojo/standards/sample-authoring-standard.md +151 -0
  407. package/docs/ja/specdojo/standards/standard-authoring-standard.md +108 -0
  408. package/docs/ja/specdojo/standards/template-authoring-standard.md +101 -0
  409. package/docs/ja/specdojo/standards/test-document-scope-standard.md +176 -0
  410. package/docs/ja/specdojo/templates/cdfd-overview-template.md +199 -0
  411. package/docs/ja/specdojo/templates/cdfd-template.md +173 -0
  412. package/docs/ja/specdojo/templates/cdfd-uc-template.md +148 -0
  413. package/docs/ja/specdojo/templates/dct-architecture-template.yaml +136 -0
  414. package/docs/ja/specdojo/templates/dct-business-acceptance-criteria-template.yaml +34 -0
  415. package/docs/ja/specdojo/templates/dct-business-model-bes-template.yaml +75 -0
  416. package/docs/ja/specdojo/templates/dct-business-model-bps-template.yaml +49 -0
  417. package/docs/ja/specdojo/templates/dct-business-model-br-template.yaml +50 -0
  418. package/docs/ja/specdojo/templates/dct-data-flow-template.yaml +40 -0
  419. package/docs/ja/specdojo/templates/dct-data-model-bdd-template.yaml +46 -0
  420. package/docs/ja/specdojo/templates/dct-data-model-ccd-template.yaml +46 -0
  421. package/docs/ja/specdojo/templates/dct-data-model-cdsd-template.yaml +41 -0
  422. package/docs/ja/specdojo/templates/dct-data-model-cld-template.yaml +38 -0
  423. package/docs/ja/specdojo/templates/dct-data-model-sld-template.yaml +38 -0
  424. package/docs/ja/specdojo/templates/dct-data-model-stsd-template.yaml +46 -0
  425. package/docs/ja/specdojo/templates/dct-external-interface-specs-template.yaml +114 -0
  426. package/docs/ja/specdojo/templates/dct-glossary-template.yaml +35 -0
  427. package/docs/ja/specdojo/templates/dct-impact-analysis-template.yaml +138 -0
  428. package/docs/ja/specdojo/templates/dct-index-template.md +40 -0
  429. package/docs/ja/specdojo/templates/dct-migration-planning-template.yaml +148 -0
  430. package/docs/ja/specdojo/templates/dct-non-functional-requirements-template.yaml +222 -0
  431. package/docs/ja/specdojo/templates/dct-operations-template.yaml +108 -0
  432. package/docs/ja/specdojo/templates/dct-project-definition-template.yaml +210 -0
  433. package/docs/ja/specdojo/templates/dct-project-management-template.yaml +423 -0
  434. package/docs/ja/specdojo/templates/dct-system-acceptance-criteria-template.yaml +37 -0
  435. package/docs/ja/specdojo/templates/dct-system-design-template.yaml +82 -0
  436. package/docs/ja/specdojo/templates/dct-system-functions-template.yaml +58 -0
  437. package/docs/ja/specdojo/templates/dct-test-specs-template.yaml +261 -0
  438. package/docs/ja/specdojo/templates/dct-user-interface-model-template.yaml +60 -0
  439. package/docs/ja/specdojo/templates/ifx-cmd-template.yaml +88 -0
  440. package/docs/ja/specdojo/templates/opr-template.md +85 -0
  441. package/docs/ja/specdojo/templates/pjr-change-request-template.md +60 -0
  442. package/docs/ja/specdojo/templates/pjr-decision-template.md +61 -0
  443. package/docs/ja/specdojo/templates/pjr-index-template.md +49 -0
  444. package/docs/ja/specdojo/templates/pjr-issue-template.md +50 -0
  445. package/docs/ja/specdojo/templates/pjr-note-template.md +35 -0
  446. package/docs/ja/specdojo/templates/pjr-question-template.md +53 -0
  447. package/docs/ja/specdojo/templates/pjr-risk-template.md +49 -0
  448. package/docs/ja/specdojo/templates/pjr-todo-template.md +41 -0
  449. package/docs/ja/specdojo/templates/pjr-views-by-owner-template.md +22 -0
  450. package/docs/ja/specdojo/templates/pjr-views-by-priority-template.md +22 -0
  451. package/docs/ja/specdojo/templates/pjr-views-by-status-template.md +22 -0
  452. package/docs/ja/specdojo/templates/pm-change-request-log-template.md +20 -0
  453. package/docs/ja/specdojo/templates/pm-communication-plan-template.md +46 -0
  454. package/docs/ja/specdojo/templates/pm-decision-log-template.md +20 -0
  455. package/docs/ja/specdojo/templates/pm-issue-log-template.md +20 -0
  456. package/docs/ja/specdojo/templates/pm-members-template.yaml +105 -0
  457. package/docs/ja/specdojo/templates/pm-organization-template.md +44 -0
  458. package/docs/ja/specdojo/templates/pm-plan-template.md +52 -0
  459. package/docs/ja/specdojo/templates/pm-quality-management-plan-template.md +46 -0
  460. package/docs/ja/specdojo/templates/pm-raci-template.md +51 -0
  461. package/docs/ja/specdojo/templates/pm-risk-register-template.md +20 -0
  462. package/docs/ja/specdojo/templates/pm-roles-template.yaml +53 -0
  463. package/docs/ja/specdojo/templates/prj-assumptions-constraints-dependencies-template.md +59 -0
  464. package/docs/ja/specdojo/templates/prj-charter-template.md +116 -0
  465. package/docs/ja/specdojo/templates/prj-comparison-of-alternatives-template.md +116 -0
  466. package/docs/ja/specdojo/templates/prj-issues-and-approach-template.md +89 -0
  467. package/docs/ja/specdojo/templates/prj-overview-template.md +85 -0
  468. package/docs/ja/specdojo/templates/prj-scope-template.md +75 -0
  469. package/docs/ja/specdojo/templates/prj-stakeholder-register-template.md +64 -0
  470. package/docs/ja/specdojo/templates/prj-success-criteria-and-acceptance-criteria-template.md +60 -0
  471. package/docs/ja/specdojo/templates/stsd-template.md +57 -0
  472. package/docs/specdojo/schemas/v1/bdd.schema.yaml +230 -0
  473. package/docs/specdojo/schemas/v1/common-frontmatter.schema.yaml +77 -0
  474. package/docs/specdojo/schemas/v1/dct-index.schema.yaml +85 -0
  475. package/docs/specdojo/schemas/v1/dct-plan.schema.yaml +324 -0
  476. package/docs/specdojo/schemas/v1/dct.schema.yaml +368 -0
  477. package/docs/specdojo/schemas/v1/deliverable-frontmatter.schema.yaml +91 -0
  478. package/docs/specdojo/schemas/v1/esil.schema.yaml +142 -0
  479. package/docs/specdojo/schemas/v1/exec-common.schema.yaml +101 -0
  480. package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +272 -0
  481. package/docs/specdojo/schemas/v1/exec-evidence.schema.yaml +162 -0
  482. package/docs/specdojo/schemas/v1/exec-plan-frontmatter.schema.yaml +126 -0
  483. package/docs/specdojo/schemas/v1/exec-reporter-output.schema.yaml +151 -0
  484. package/docs/specdojo/schemas/v1/exec-result-frontmatter.schema.yaml +144 -0
  485. package/docs/specdojo/schemas/v1/grade-done-criteria.schema.yaml +79 -0
  486. package/docs/specdojo/schemas/v1/grade-pipeline-state.schema.yaml +60 -0
  487. package/docs/specdojo/schemas/v1/grade-result.schema.yaml +118 -0
  488. package/docs/specdojo/schemas/v1/guide-frontmatter.schema.yaml +19 -0
  489. package/docs/specdojo/schemas/v1/ifx-cmd.schema.yaml +293 -0
  490. package/docs/specdojo/schemas/v1/job-run.schema.yaml +90 -0
  491. package/docs/specdojo/schemas/v1/job.schema.yaml +198 -0
  492. package/docs/specdojo/schemas/v1/philosophy-frontmatter.schema.yaml +19 -0
  493. package/docs/specdojo/schemas/v1/pipeline-state.schema.yaml +56 -0
  494. package/docs/specdojo/schemas/v1/pm-members.schema.yaml +252 -0
  495. package/docs/specdojo/schemas/v1/pm-review-viewpoints.schema.yaml +387 -0
  496. package/docs/specdojo/schemas/v1/pm-roles.schema.yaml +106 -0
  497. package/docs/specdojo/schemas/v1/recipe-frontmatter.schema.yaml +27 -0
  498. package/docs/specdojo/schemas/v1/reference-frontmatter.schema.yaml +18 -0
  499. package/docs/specdojo/schemas/v1/register-events.schema.yaml +106 -0
  500. package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +204 -0
  501. package/docs/specdojo/schemas/v1/routine-run.schema.yaml +36 -0
  502. package/docs/specdojo/schemas/v1/routine.schema.yaml +87 -0
  503. package/docs/specdojo/schemas/v1/rulebook-frontmatter.schema.yaml +61 -0
  504. package/docs/specdojo/schemas/v1/sch-common.schema.yaml +258 -0
  505. package/docs/specdojo/schemas/v1/sch-defaults.schema.yaml +48 -0
  506. package/docs/specdojo/schemas/v1/sch-milestones.schema.yaml +64 -0
  507. package/docs/specdojo/schemas/v1/sch-strategy.schema.yaml +772 -0
  508. package/docs/specdojo/schemas/v1/sch-track.schema.yaml +66 -0
  509. package/docs/specdojo/schemas/v1/standard-frontmatter.schema.yaml +18 -0
  510. package/docs/specdojo/schemas/v1/tml-index.schema.yaml +103 -0
  511. package/package.json +120 -24
  512. package/templates/claude/README.md +46 -0
  513. package/templates/claude/agents/claude-expert-review-executor.md +14 -0
  514. package/templates/claude/agents/claude-review-executor.md +14 -0
  515. package/templates/claude/settings.edit.json +6 -0
  516. package/templates/claude/settings.report.json +6 -0
  517. package/templates/claude/settings.review.json +7 -0
  518. package/templates/codex/README.md +61 -0
  519. package/templates/codex/agents/codex-executor.toml +12 -0
  520. package/templates/codex/agents/codex-expert-executor.toml +12 -0
  521. package/templates/codex/agents/codex-expert-review-executor.toml +10 -0
  522. package/templates/codex/agents/codex-review-executor.toml +10 -0
  523. package/templates/copilot/README.md +41 -0
  524. package/templates/copilot/exec-defaults-snippet.yaml +28 -0
  525. package/templates/copilot/pm-members-snippet.yaml +44 -0
  526. package/templates/opencode/README.md +41 -0
  527. package/templates/opencode/agents/opencode-executor.md +59 -0
  528. package/templates/opencode/agents/opencode-reporter.md +26 -0
  529. package/templates/opencode/agents/opencode-review-executor.md +48 -0
  530. package/dist/exec-schedule-timeline-render.js +0 -201
  531. package/dist/exec-schedule-timeline.js +0 -2
@@ -0,0 +1,318 @@
1
+ ---
2
+ specdojo:
3
+ id: specdojo:exec-worktree-guide
4
+ type: guide
5
+ status: ready
6
+ ---
7
+
8
+ # exec worktree運用ガイド
9
+
10
+ Exec Worktree Guide
11
+
12
+ `specdojo exec worktree` による隔離実行の分割手順と安全条件を説明します。自動実行や通常の手動実行は [Schedule実行運用ガイド](schedule-operation-guide.md)、project `develop`・feature・exec のブランチ全体フローは [ブランチワークフローガイド](branch-workflow-guide.md) を参照します。ブランチ命名と統合方向の規範は [Git ブランチ運用標準](../standards/git-branching-standard.md) を正本とします。
13
+
14
+ **対象読者**
15
+
16
+ - task worktree の準備、agent 実行、commit、merge、削除を段階ごとに確認して操作する開発者、運用者
17
+
18
+ **この文書で分かること**
19
+
20
+ - worktree 分割コマンドの責務、標準手順、ブランチ導出、安全条件、complete・block の記録方法
21
+
22
+ **次に読む文書**
23
+
24
+ - ブランチ全体の運用は [ブランチワークフローガイド](branch-workflow-guide.md)、自動実行との使い分けは [Schedule実行運用ガイド](schedule-operation-guide.md) を参照してください。
25
+
26
+ ## 1. worktree分割コマンドの概要
27
+
28
+ 分割コマンドの責務、標準的な進め方、共通の導出ルールを示します。
29
+
30
+ ### 1.1. 分割コマンドの役割
31
+
32
+ `exec run --worktree` と `exec run --auto` は、worktree 準備、agent 起動、commit、merge、状態更新を一括で行います。各段階を人が確認しながら進める場合は `exec worktree` 配下の分割コマンドを使います。
33
+
34
+ | コマンド | 責務 | Git変更 | イベント変更 |
35
+ | ------------------ | -------------------------------------------------------------------------------- | --------- | ------------ |
36
+ | `worktree prepare` | task worktree を準備し、実行管理ファイルを exec branch へ checkpoint commit する | あり | なし |
37
+ | `worktree status` | worktree、result、Git差分の状態を確認する | なし | なし |
38
+ | `worktree agent` | worktree内で agent command を1回実行する | agent次第 | なし |
39
+ | `worktree commit` | result と成果物変更を exec ブランチへ commit する | あり | なし |
40
+ | `worktree merge` | exec ブランチを現在のブランチへ merge する | あり | なし |
41
+ | `worktree remove` | 統合済み worktree を削除する | あり | なし |
42
+ | `worktree prune` | worktree のない project 配下の exec ブランチを監査・整理する | 条件付き | なし |
43
+
44
+ 分割コマンドは `claim`、`complete`、`block` を暗黙には実行しません。対象タスクは事前に `doing` である必要があります。
45
+
46
+ ### 1.2. 標準手順
47
+
48
+ ```bash
49
+ REPO_ROOT="$(git rev-parse --show-toplevel)"
50
+
51
+ specdojo exec claim \
52
+ --project <project-id> \
53
+ --task <task-id> \
54
+ --by <actor>
55
+
56
+ specdojo exec worktree prepare --project <project-id> --task <task-id>
57
+
58
+ # prepare が表示した path へ移動する
59
+ cd <worktree-path>
60
+ specdojo exec worktree status --project <project-id> --task <task-id>
61
+ specdojo exec worktree agent --project <project-id> --task <task-id>
62
+ specdojo exec worktree commit --project <project-id> --task <task-id>
63
+
64
+ # merge 先の root worktree へ戻る
65
+ cd "${REPO_ROOT}"
66
+ specdojo exec worktree merge --project <project-id> --task <task-id>
67
+ specdojo exec worktree remove --project <project-id> --task <task-id> --delete-branch
68
+
69
+ specdojo exec complete \
70
+ --project <project-id> \
71
+ --task <task-id> \
72
+ --by <actor>
73
+ ```
74
+
75
+ 途中で問題が見つかった場合は、worktree を削除せず `agent` から再実行します。
76
+
77
+ ### 1.3. 共通の導出ルール
78
+
79
+ `exec worktree` は独自の JSON や状態ファイルを作りません。必要な情報は毎回既存情報から導出します。
80
+
81
+ | 情報 | 導出元 |
82
+ | ------------------- | ---------------------------------------------------------- |
83
+ | worktree名 / branch | project 修飾 task ID から `<slug>` と `exec/<slug>` を導出 |
84
+ | worktreeパス | `git worktree list --porcelain` から exec branch を検索 |
85
+ | plan / result パス | project 設定と task ID から導出 |
86
+ | claim actor | `exec/events/` の claim event から導出 |
87
+ | 比較起点 commit | `git merge-base HEAD <exec-branch>` で導出 |
88
+ | merge先 | `worktree merge` を実行した現在ブランチ |
89
+
90
+ project が解決できる場合、branch 名は project ID を含めます。例として `prj-0001:T-LAUNCH-prj-scope-010` は `exec/prj-0001-T-LAUNCH-prj-scope-010` になります。
91
+
92
+ ## 2. 分割コマンドの詳細
93
+
94
+ 各分割コマンドの役割、入出力、安全条件を示します。
95
+
96
+ ### 2.1. prepare
97
+
98
+ `prepare` は claim 済みタスク専用の worktree を作成します。
99
+
100
+ ```bash
101
+ specdojo exec worktree prepare \
102
+ --project <project-id> \
103
+ --task <task-id>
104
+ ```
105
+
106
+ 主な処理:
107
+
108
+ 1. task state が `doing` であることを確認します。
109
+ 2. プロジェクトロックを取得します。
110
+ 3. plan、result、claim event を確認します。
111
+ 4. plan がなければ `exec plan` 相当で生成します。
112
+ 5. root index に stage 済み変更がないことを確認します。
113
+ 6. 現在の統合先 HEAD から exec branch と worktree を作成します。
114
+ 7. root と、tracked `package-lock.json` を持つ独立 package で `npm ci` を実行します。
115
+ 8. worktree 内で `specdojo build` を実行し、生成物を用意します。
116
+ 9. plan、result、claim event を worktree へ複製し、exec branch へ checkpoint commit します。
117
+
118
+ root にある無関係な未commit変更は checkpoint commit に含めません。ただし、stage 済み変更がある場合は停止します。checkpoint は exec branch だけに置かれるため、統合先の first-parent に `prepare execution` commit は増えません。root 側の plan、result、claim event は未commitのまま残り、task が `doing` であることは統合先からも見えます。これらの root 側の複製は `worktree merge` が統合の直前に解放し(HEAD の状態へ戻し)、merge が exec branch の commit 済み内容を持ち込みます。merge が失敗した場合は複製を元に戻します。
119
+
120
+ 作成または再利用した task worktree では、tracked `package-lock.json` ごとに `npm ci --include=dev` を実行し、root と独立 package の `node_modules` を worktree 内へ実体として配置します。依存関係を元 worktree と共有しないため、agent の sandbox は task worktree 内だけへの書き込みで build、typecheck、依存更新を実行できます。
121
+
122
+ 過去のバージョンが作成した `node_modules` シンボリックリンクを検出した場合は、リンク先へ変更を加えずリンクだけを削除してから `npm ci` で置き換えます。install に失敗した場合は agent を起動せず、調査できるよう task worktree を保持したままエラー終了します。依存取得に必要な registry と npm cache は、`exec run` を起動する環境から利用できる必要があります。
123
+
124
+ 依存の install に続けて、`docs/**/generated` と `.specdojo/doc-index.json` の生成物を worktree 内で作り直します。これらは `.gitignore` の対象で worktree の checkout に含まれないため、生成物の存在を前提とするテストや検証が、タスクの成果物と無関係に失敗するからです。生成は worktree 内の CLI(SpecDojo 自身のリポジトリでは `src/specdojo.ts`、依存として利用するリポジトリでは `node_modules/.bin/specdojo`)を worktree を作業ディレクトリとして実行し、scope を絞らず全ステップを通します。生成対象が増えても準備処理側の追従は不要です。
125
+
126
+ 既存の task worktree を再利用する場合も生成をやり直します。生成物は依存と違って前回実行時のまま古くなり、生成段階を持たない版が作成した worktree には存在しないためです。`.specdojo/specdojo.config.json` を持たないリポジトリ、または worktree 内に CLI が無い場合は生成をスキップします。生成に失敗した場合は `Worktree preparation failed: specdojo build ...` として、成果物の失敗ではなく準備の失敗と分かる形でエラー終了します。
127
+
128
+ ### 2.2. status
129
+
130
+ `status` は分割実行の現在地を確認する読み取り専用コマンドです。
131
+
132
+ ```bash
133
+ specdojo exec worktree status \
134
+ --project <project-id> \
135
+ --task <task-id>
136
+ ```
137
+
138
+ 表示する主な情報:
139
+
140
+ | 情報 | 内容 |
141
+ | ------------- | ----------------------------------------- |
142
+ | task state | `doing` / `blocked` など |
143
+ | claim actor | 現在の実行主体 |
144
+ | worktree | path と branch |
145
+ | plan / result | 存在有無と変更状態 |
146
+ | Git差分 | 未commit変更、stage済み変更 |
147
+ | 統合状態 | exec branch が現在ブランチへ merge 済みか |
148
+
149
+ worktree が未準備の場合も、削除や作成はせず `not prepared` として確認できます。
150
+
151
+ ### 2.3. agent
152
+
153
+ `agent` は準備済み worktree をカレントディレクトリとして agent command を1回起動します。
154
+
155
+ ```bash
156
+ specdojo exec worktree agent \
157
+ --project <project-id> \
158
+ --task <task-id>
159
+ ```
160
+
161
+ 既定では claim actor の nickname を使い、member 属性と `.specdojo/exec-defaults.yaml` の `providers.<provider>.command_template` から command を解決します。plan 内の `[[id]]` は `index replace --format path --missing keep` 相当で展開し、agent の標準入力へ渡します。
162
+
163
+ 別の登録済み agent を明示する場合は `--by <nickname>` を使います。生の command 文字列は指定できません。
164
+
165
+ ```bash
166
+ specdojo exec worktree agent \
167
+ --project <project-id> \
168
+ --task <task-id> \
169
+ --by opencode-executor
170
+ ```
171
+
172
+ `agent` は retry、fallback、commit、merge、event 更新を行いません。終了コードは agent command の終了コードをそのまま返します。
173
+
174
+ ### 2.4. commit
175
+
176
+ `commit` は agent が更新した result と成果物を exec branch へ commit します。
177
+
178
+ ```bash
179
+ specdojo exec worktree commit \
180
+ --project <project-id> \
181
+ --task <task-id>
182
+ ```
183
+
184
+ commit 対象から除外する主なパス:
185
+
186
+ | 除外対象 | 理由 |
187
+ | -------------------------------- | -------------------------------------------- |
188
+ | `exec/plans/` | plan は実行入力であり agent の成果物ではない |
189
+ | 対象 task 以外の `exec/results/` | 他タスクの記録を混ぜない |
190
+ | `exec/events/` | event は root 側の状態管理で扱う |
191
+ | `generated/` | 再生成物を task 成果物に混ぜない |
192
+
193
+ 対象 task の result は成果物変更と同じ commit に含めます。変更がない場合は commit を作成しません。
194
+
195
+ 上表の除外に加え、プロンプトインジェクション対策として commit 対象を mode 別の許可リストで絞ります。review は対象 task の result のみ、edit は result と plan の `targets` から解決した成果物(maintenance / bootstrap 系 approach は実践の型ディレクトリも)だけを commit し、許可リスト外の変更は `commit-scope:` 警告を出して worktree に残します。詳細は [exec設定ガイド](exec-config-guide.md) の `agent 権限とプロンプトインジェクション対策` を参照します。
196
+
197
+ ### 2.5. merge
198
+
199
+ `merge` は exec branch の commit を、コマンドを実行した現在ブランチへ統合します。
200
+
201
+ ```bash
202
+ specdojo exec worktree merge \
203
+ --project <project-id> \
204
+ --task <task-id>
205
+ ```
206
+
207
+ 安全条件:
208
+
209
+ | 条件 | 意味 |
210
+ | ------------------------------------------------ | ------------------------------- |
211
+ | exec branch 側に未統合 commit がある | merge する差分が存在する |
212
+ | task worktree に commit 対象の未commit変更がない | result / 成果物を取りこぼさない |
213
+ | 現在ブランチが exec branch ではない | 自分自身へ merge しない |
214
+ | 現在の未commit変更と merge 対象パスが重複しない | 手作業の変更を壊さない |
215
+
216
+ `prepare` が root に残した plan、result、claim event の複製は、重複判定の前に解放します(exec branch の commit 済み内容が merge で入るため)。それ以外の未commit変更が merge 対象パスと重複する場合は停止します。
217
+
218
+ 通常は `git merge --no-ff` 相当で統合します。自動実行では `exec(<task-id>): <task name>` を merge commit の subject に使い、統合先の first-parent を1タスク1commitにします(`prepare execution` / `apply task changes` は exec branch 側に残ります)。`--ff-only` 指定時は fast-forward 可能な場合だけ統合します。
219
+
220
+ 競合または commit hook の失敗で merge commit を作れなかった場合は、runner が `git merge --abort` を実行して統合先を開始前の状態へ戻します。Schedule タスクは `blocked`、register 項目は `waiting` へ遷移し、再開に使う exec branch と worktree は保持します。register の `wait` commit は abort 後に作るため、統合先へ `MERGE_HEAD` を残したまま部分 commit を試みません。block reason には hook の罫線や色を除いた失敗ステップ名と最初のエラー行を記録し、executor/reporter pipeline では生の stdout / stderr と abort 結果を同じ run の `integrate.log` に保存します。
221
+
222
+ hook や検査を直した後は、Schedule タスクでは `specdojo exec resume --project <project-id> --task <task-id>`、register 項目では元の `exec run --register ... --worktree --resume` を実行します。統合段から再開するため agent は再実行せず、保持した exec branch を merge します。
223
+
224
+ 自動の `git merge --abort` 自体が失敗した場合は、runner が標準エラーへ手動復旧を案内します。案内された root worktree で状態と失敗原因を確認し、ロックファイルや Git プロセスなどの原因を解消してから次を実行してください。abort が完了するまでは commit や統合再開を行いません。
225
+
226
+ ```bash
227
+ git status
228
+ git merge --abort
229
+ ```
230
+
231
+ ### 2.6. remove
232
+
233
+ `remove` は不要になった task worktree を削除します。
234
+
235
+ ```bash
236
+ specdojo exec worktree remove \
237
+ --project <project-id> \
238
+ --task <task-id> \
239
+ --delete-branch
240
+ ```
241
+
242
+ 既定では exec branch を残します。`--delete-branch` を付けた場合だけ、merge 済み branch を `git branch -d` 相当で削除します。
243
+
244
+ `--force` は `git worktree remove --force` 相当であり、未commit変更が失われる可能性があります。exec branch の削除には `-D` 相当の強制削除を使いません。
245
+
246
+ worktree の削除とブランチの削除は Git 上で1つの原子的な操作にはできません。ブランチ削除に失敗した場合は、worktree が削除済みで exec ブランチだけが残ったことと Git の失敗理由をエラーへ出力します。自動実行では成果物の統合と task の完了を取り消さず、警告と後述の復旧コマンドを出力します。
247
+
248
+ ### 2.7. prune
249
+
250
+ `prune` は、対象 project の exec ブランチのうち、どの登録済み worktree にも使われていないものを監査します。merge 先 worktree で実行してください。
251
+
252
+ ```bash
253
+ # 削除せず、孤立したブランチと統合状態だけを確認する
254
+ specdojo exec worktree prune --project <project-id> --dry-run
255
+
256
+ # 現在の HEAD に統合済みの孤立ブランチだけを削除する
257
+ specdojo exec worktree prune --project <project-id>
258
+ ```
259
+
260
+ 判定と削除の安全条件は次のとおりです。
261
+
262
+ | 状態 | 処理 |
263
+ | --------------------------------------------- | ------------------------------------------- |
264
+ | worktree に checkout されている exec ブランチ | 孤立とみなさず、表示・削除の対象外 |
265
+ | worktree がなく、現在の HEAD に統合済み | `--dry-run` では表示のみ、通常実行では削除 |
266
+ | worktree がなく、現在の HEAD に未統合 | `kept (not merged)` と表示し、常に保持 |
267
+ | `git branch -d` が失敗 | Git の理由を出力し、終了コード1で停止 |
268
+ | exec ブランチ上から実行 | merge 先を誤認しないよう、終了コード1で拒否 |
269
+
270
+ 削除には常に `git branch -d` 相当を使い、`-D` 相当の強制削除は行いません。失敗・中断直後の実行は、未統合成果の調査と再開に必要なため worktree とブランチを対で保持します。人が worktree だけを撤去した場合や、撤去とブランチ削除の間でプロセスが中断した場合は `prune --dry-run` で孤立を確認し、統合済みのものだけを整理します。
271
+
272
+ ## 3. complete / blockの記録
273
+
274
+ 分割コマンドは状態 event を更新しないため、成果物確認後に人が明示的に `complete` または `block` を実行します。
275
+
276
+ ```bash
277
+ specdojo exec complete \
278
+ --project <project-id> \
279
+ --task <task-id> \
280
+ --by <actor> \
281
+ --msg "worktree result verified" # --msg は省略可(省略時は "complete task")
282
+ ```
283
+
284
+ 完了条件を満たせない場合は result に状況を記録し、`block` を使います。
285
+
286
+ ```bash
287
+ specdojo exec block \
288
+ --project <project-id> \
289
+ --task <task-id> \
290
+ --by <actor> \
291
+ --msg "waiting for clarification"
292
+ ```
293
+
294
+ ## 4. ベースブランチの取り込み
295
+
296
+ `worktree merge` は exec branch を現在のブランチへ統合する一方向のコマンドです。逆に worktree 側へベースブランチの最新を取り込む操作は Git の標準機能で行います。worktree はリポジトリの ref を共有するため、ローカルブランチの取り込みに `fetch` は不要です。
297
+
298
+ ```bash
299
+ # worktree のディレクトリ内で実行する
300
+ npm run worktree:sync
301
+ ```
302
+
303
+ `worktree:sync` はベースブランチを main worktree が checkout しているブランチから自動判定し、取り込み対象の commit を表示してから merge します。未commit変更がある場合は中断します。
304
+
305
+ | オプション | 用途 |
306
+ | ----------------- | ----------------------------------------------------- |
307
+ | `--dry-run` | 取り込み対象の commit を表示するだけで merge しない |
308
+ | `--rebase` | merge ではなく rebase して履歴を直線に保つ |
309
+ | `--fetch` | 先に `origin` を fetch し、`origin/<base>` を取り込む |
310
+ | `--base <branch>` | ベースブランチを明示指定する |
311
+
312
+ ベースブランチは `SPECDOJO_WORKTREE_BASE_BRANCH` でも指定できます。
313
+
314
+ 取り込み後は生成物が同期前の状態のままなので、作業を続ける前に再生成します。
315
+
316
+ ```bash
317
+ npm run build && npm run docs:generate
318
+ ```
@@ -0,0 +1,89 @@
1
+ ---
2
+ specdojo:
3
+ id: specdojo:kata-guide
4
+ type: guide
5
+ status: ready
6
+ ---
7
+
8
+ # 実践の型活用ガイド
9
+
10
+ Kata Guide
11
+
12
+ SpecDojo で成果物を作成・更新・レビューするときに、rulebook / recipe / sample / template(実践の型)がそれぞれ何を担い、成果物を書くときにどう使い分けるかを説明します。整備状況に応じてどこまで参照するか(`approach`)の選び方は [実践の進め方ガイド](ryu-guide.md) を参照してください。
13
+
14
+ **対象読者**
15
+
16
+ - 成果物を作成・更新・レビューする人、エージェント
17
+
18
+ **この文書で分かること**
19
+
20
+ - rulebook・recipe・sample・template それぞれの役割と、成果物を書くときの使い分け
21
+
22
+ **次に読む文書**
23
+
24
+ - 整備状況に応じた進め方(`approach`)の選び方は [実践の進め方ガイド](ryu-guide.md) を参照してください。
25
+ - 実践の型そのものの種別と役割は [実践体系構成ガイド](practice-system-composition-guide.md) を参照してください。
26
+
27
+ ## 1. 実践の型の使い分け
28
+
29
+ 実践の型は rulebook / recipe / sample / template の4種です。各種別の役割の正本は [実践体系構成ガイド](practice-system-composition-guide.md) とし、本章では成果物を書くときの使い方を示します。
30
+
31
+ | 種別 | 役割 | 確認できること |
32
+ | -------- | ------------------------------ | -------------------------------------------------- |
33
+ | rulebook | 成果物として成立するための規約 | 構造、必須項目、禁止事項 |
34
+ | recipe | 良い内容を書くための作り方 | 問い、観点、深掘り手順、レビュー観点 |
35
+ | sample | 完成例 | 粒度、文体、表の書き方 |
36
+ | template | 成果物の雛形 | 章構成の骨組み、記述すべき箇所を示すプレースホルダ |
37
+
38
+ 成果物を書くときは、template があれば雛形として開始し、rulebook で構造・必須項目・禁止事項を確認し、recipe の問いと深掘り手順に沿って内容を組み立て、sample で粒度・文体・表の書き方を合わせます。
39
+
40
+ template は、記述する部分を _TODO_ などのプレースホルダとして配置した雛形です。内容が埋まった完成例である sample と役割を分担し、成果物作成の開始点として使います。
41
+
42
+ 4 種類すべてが揃っているとは限りません。整備状況に応じてどこまで参照するかは、`approach`(進め方)で切り替えます。詳細は [実践の進め方ガイド](ryu-guide.md) を参照してください。
43
+
44
+ ファイルが存在することと、内容を基準にできることは別です。存在・宣言形式・参照切れはコードが判定し、内容品質は `specdojo grade` の共通 rubric で評価します。Schedule は保存済み grade と strategy の intent から approach を都度導出します。詳しくは [Schedule設計ガイド](schedule-design-guide.md) の `intent 宣言と approach の決定論的導出` を参照してください。
45
+
46
+ ## 2. 実践の型を作る条件
47
+
48
+ 実践の型は4種すべてを機械的に作るのではなく、成果物種別ごとの方針で要否を判断します。成果物カタログは成果物と rulebook の対応だけを持ち、recipe / sample / template の要否と所在は rulebook frontmatter で次の宣言により区別します。
49
+
50
+ | 要否 | 整備状況 | rulebook frontmatter 宣言 |
51
+ | ------ | -------- | ------------------------------------------------- |
52
+ | 未判断 | 未整備 | `undecided` |
53
+ | 必要 | 未整備 | 項目を省略 |
54
+ | 必要 | 整備済み | 実在する rulebook / recipe / sample / template ID |
55
+ | 不要 | 対象外 | `not-needed` |
56
+
57
+ `undecided` は要否をまだ判断していない状態です。項目の省略は必要と判断済みだが文書 ID をまだ宣言できない状態であり、両者を兼用しません。
58
+
59
+ | 種別 | 方針・作る条件 | 作らない条件 |
60
+ | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------ |
61
+ | rulebook | 構造・必須項目・禁止事項について、schema だけでは伝わらない判断がある場合に作る | 構造が schema で完全に規定され、判断の余地がない |
62
+ | recipe | 他の型とは独立して判断する。規約を満たすだけでは品質を担保できず、書き手による品質差、浅い内容になりやすい、レビューで同じ指摘が繰り返される、のいずれかに当てはまる系統に作る | 規約と schema を満たせば内容がほぼ一意に決まる |
63
+ | sample | rulebook がある成果物系統には一律に作る。完成例として粒度・文体・表の書き方を示す | 構造が schema で完全に決まる YAML 成果物 |
64
+ | template | 個別成果物ごとではなく rulebook 系統単位で判断する。定型の骨組みがあり、同じ系統の成果物を毎回同じ章立てから始める場合に作る | 対象ごとに構成が変わり、固定の雛形がかえって制約になる |
65
+
66
+ 要否は初回の `bootstrap` で判断します。`undecided` の型は、必要なら項目を省略したうえで必要な型を成果物と一緒に整備し、不要なら `not-needed` へ更新します。既存の型を廃止する、または `not-needed` を必要へ変更する場合は、成果物の実績・繰り返し発生したレビュー指摘・schema の表現範囲を根拠として rulebook frontmatter の宣言も同時に更新します。
67
+
68
+ `kind: generated` の成果物には実践の型を適用しません。成果物ごとの型宣言は置かず、`kind` から非適用を導出します。rulebook を持たない成果物は成果物カタログの `rulebook: not-needed` で表します。
69
+
70
+ ## 3. 進め方(approach)との参照分担
71
+
72
+ 実践の型の「使い分け」と「進め方」は次のように役割を分けます。本ガイドは型の役割・使い分けを扱い、進め方の選択・一覧・メンテナンス・review への適用は [実践の進め方ガイド](ryu-guide.md) を正本とします。
73
+
74
+ | 知りたいこと | 参照先 |
75
+ | -------------------------------------------------------------- | ---------------------------------- |
76
+ | rulebook / recipe / sample / template それぞれの役割と使い分け | 本ガイド `実践の型の使い分け` |
77
+ | 整備状況・タスク目的に応じた `approach` の選び方と一覧 | [実践の進め方ガイド](ryu-guide.md) |
78
+ | `approach` にかかわらず適用する参照の共通原則 | [実践の進め方ガイド](ryu-guide.md) |
79
+ | 実践の型メンテナンス(`*-maintenance`)の進め方 | [実践の進め方ガイド](ryu-guide.md) |
80
+ | review でどこまで実践の型に照らすか | [実践の進め方ガイド](ryu-guide.md) |
81
+
82
+ 型そのものの種別と実践体系全体での位置づけは [実践体系構成ガイド](practice-system-composition-guide.md) を正本とします。
83
+
84
+ ## 4. 関連ドキュメント
85
+
86
+ - [実践の進め方ガイド](ryu-guide.md): `approach` の選び方・一覧、参照の共通原則、メンテナンス・review への適用
87
+ - [実践体系構成ガイド](practice-system-composition-guide.md): 実践の型を含む実践体系の種別と役割
88
+ - [プロジェクト概要 作成レシピ](../recipes/prj-overview-recipe.md): rulebook / recipe / sample の役割分担の記述例
89
+ - [レビューガイド](review-guide.md): レビューの進め方と、実践の型の活用方法
@@ -0,0 +1,127 @@
1
+ ---
2
+ specdojo:
3
+ id: specdojo:orchestrator-operation-guide
4
+ type: guide
5
+ status: ready
6
+ ---
7
+
8
+ # オーケストレーター運用ガイド
9
+
10
+ Orchestrator Operation Guide
11
+
12
+ 会話から `specdojo` CLI を実行する対話型オーケストレーターエージェント `specdojo-orchestrator` の使い方を説明します。起動方法、対話の進め方、承認を伴う実行、安全上の制約、設定ファイルの構成を扱います。個別コマンドの詳細は [CLIコマンドリファレンス](../references/command-reference.md) を、CLI 全体像は [遂行の技活用ガイド](waza-guide.md) を参照します。
13
+
14
+ **対象読者**
15
+
16
+ - `specdojo` のプロジェクト実行管理(登録・計画・実行・状況確認)を、CLI を直接叩く代わりに対話で進めたい利用者
17
+
18
+ **この文書で分かること**
19
+
20
+ - オーケストレーターの位置づけ、起動用スクリプト、対話フロー、承認と安全の扱い、設定ファイルの構成
21
+
22
+ **次に読む文書**
23
+
24
+ - タスク実行の運用は [exec運用ガイド](exec-operation-guide.md)、登録簿の運用は [登録簿運用ガイド](register-operation-guide.md)、コマンド詳細は [CLIコマンドリファレンス](../references/command-reference.md) を参照してください。
25
+
26
+ ## 1. オーケストレーターの位置づけ
27
+
28
+ `specdojo-orchestrator` は、利用者との対話から意図を読み取り、対応する `specdojo` サブコマンド(`register` / `exec` / `catalog` / `schedule` / `routine` など)を組み立てて実行する司令塔エージェントです。
29
+
30
+ `specdojo exec run` が起動する edit / review agent とは役割が異なります。
31
+
32
+ | 観点 | edit / review agent | `specdojo-orchestrator` |
33
+ | ---------------- | ------------------------------ | ----------------------------------- |
34
+ | 起動 | `specdojo exec run` から非対話 | 利用者との対話 |
35
+ | 入力 | 標準入力で渡される1件の plan | 会話(自由入力) |
36
+ | 実行対象 | 成果物または result の編集 | `specdojo` サブコマンドの実行 |
37
+ | claim / complete | 実行しない | `specdojo` コマンドとして実行しうる |
38
+
39
+ CLI を直接操作する場合の代表フローは [遂行の技活用ガイド](waza-guide.md) の `代表フロー` を参照します。オーケストレーターは、この代表フローを会話で組み立てて実行する用途に向きます。
40
+
41
+ ## 2. 起動方法
42
+
43
+ `package.json` に、対話起動用の npm スクリプトを `orch:` 接頭辞で用意しています。Claude Code / Codex はモデル別に用意し、`:work` 付きは固定 worktree で起動します。
44
+
45
+ | スクリプト | CLI・モデル | worktree |
46
+ | ------------------- | ----------------------------------- | ----------------------------------------------- |
47
+ | `orch:sonnet` | Claude Code / `sonnet` | なし |
48
+ | `orch:sonnet:work` | Claude Code / `sonnet` | `../worktrees/claude-work`(無ければ自動作成) |
49
+ | `orch:opus` | Claude Code / `opus` | なし |
50
+ | `orch:opus:work` | Claude Code / `opus` | `../worktrees/claude-work`(無ければ自動作成) |
51
+ | `orch:terra` | Codex / `gpt-5.6-terra` | なし |
52
+ | `orch:terra:work` | Codex / `gpt-5.6-terra` | `../worktrees/codex-work`(無ければ自動作成) |
53
+ | `orch:sol` | Codex / `gpt-5.6-sol` | なし |
54
+ | `orch:sol:work` | Codex / `gpt-5.6-sol` | `../worktrees/codex-work`(無ければ自動作成) |
55
+ | `orch:copilot` | GitHub Copilot | なし |
56
+ | `orch:copilot:work` | GitHub Copilot | `../worktrees/copilot-work`(無ければ自動作成) |
57
+ | `orch:qwen` | OpenCode / Qwen 3.8 | なし |
58
+ | `orch:qwen:work` | OpenCode / Qwen 3.8 | `../worktrees/qwen-work`(無ければ自動作成) |
59
+ | `orch:gemma` | OpenCode / Gemma 4 | なし |
60
+ | `orch:gemma:work` | OpenCode / Gemma 4 | `../worktrees/gemma-work`(無ければ自動作成) |
61
+ | `orch:agy` | Antigravity / `gemini-3.1-pro-high` | なし |
62
+ | `orch:agy:work` | Antigravity / `gemini-3.1-pro-high` | `../worktrees/agy-work`(無ければ自動作成) |
63
+
64
+ Antigravity CLI(`agy`)はファイル定義の agent を持たないため、Codex と同じく SSOT `.agents/specdojo-orchestrator.agent.md` の本文を `-i`(初期プロンプトを与えて対話を続ける)で渡します。ラッパーは不要で、`.agents/rules/*.md` の薄いラッパー経由で `.github/instructions/` の規則も読み込まれます。
65
+
66
+ 用途に応じて使い分けます。
67
+
68
+ ```bash
69
+ # 通常の対話(既定モデル)
70
+ npm run orch:sonnet
71
+
72
+ # 込み入った判断が必要なときは frontier モデル
73
+ npm run orch:opus
74
+
75
+ # 変更を隔離したいときは worktree で起動
76
+ npm run orch:sonnet:work
77
+ ```
78
+
79
+ frontier モデルは Claude Code が `opus`、Codex が `gpt-5.6-sol` に対応します。通常運用はそれぞれ既定の `sonnet` / `gpt-5.6-terra` を使います。
80
+
81
+ worktree 付きは、全 CLI で `tools/worktree/open-agent-worktree.sh` を通して固定名の worktree を使い、無ければ起動時に作成します。ブランチは `worktree/<name>`、配置は `../worktrees/<name>` です。既存 worktree のブランチが一致しない場合は agent を起動しません。Claude Code の `--worktree` はブランチ名と配置を他の CLI に揃えられないため使用しません。
82
+
83
+ ## 3. 対話の進め方
84
+
85
+ オーケストレーターは「提案 → 承認 → 実行」を基本とします。
86
+
87
+ 1. 要望から「対象プロジェクト」「やりたいこと(登録・計画・実行・状況確認)」を特定します。曖昧な場合は質問で絞り込みます。
88
+ 2. 対応する `specdojo` サブコマンドと引数へマッピングします。必要なら該当コマンドの `--help` を先に確認します。
89
+ 3. 実行予定のコマンドを、目的と影響範囲(生成・更新されるファイル)とともに提示します。
90
+ 4. 状態を変える操作は承認を得てから実行します。影響が大きい場合は、先に `--dry-run` を提案します。
91
+ 5. 実行後は結果(生成物・イベント・次の作業)を要約し、必要なら検証コマンド(`specdojo exec validate` など)を案内・実行します。
92
+
93
+ 読み取り・状況確認のみのコマンド(`--help` / `list` / `status` / `where` / `validate` / `--dry-run`)は、説明の上でそのまま実行します。
94
+
95
+ 対象 project は、`--project <id>` → 環境変数 `SPECDOJO_PROJECT` → `specdojo.config.json` の `current_project` → `projects` 先頭、の順で解決します([遂行の技活用ガイド](waza-guide.md) の `プロジェクト解決順序` を参照)。会話で対象を特定できない場合は確認します。
96
+
97
+ ## 4. 安全と権限
98
+
99
+ オーケストレーターは、状態やファイルを変える操作を承認なしに実行しません。CLI 側の権限機構でも同じ方針を多重に担保します。
100
+
101
+ - 破壊的変更や `git push` は行いません。`git commit` は明示的に依頼した場合のみ行います。
102
+ - 認証情報・秘密鍵・`.env` / `secrets/` は読み込みません。
103
+ - 会話で確定していないプロジェクト事実(担当・期日・結論など)を勝手に埋めません。
104
+ - Codex は `approval_policy` により状態変更時に承認を求めます。OpenCode は読み取り系の `specdojo` のみ許可し、その他の `specdojo` 実行は都度確認します。
105
+
106
+ 影響の大きい操作(`specdojo exec run` など、エージェントを起動して成果物を生成・更新するもの)は、対象と実行範囲を提示して承認を得てから実行します。
107
+
108
+ ## 5. 設定ファイルの構成
109
+
110
+ 指示本文(システムプロンプト)の正本を1ファイルに集約し、各 agent CLI の設定はその本文を埋め込む薄いラッパーとしています。4系統の設定形式は非互換のため、単一のネイティブ設定ファイルを共有することはできません。
111
+
112
+ | 役割 | パス |
113
+ | ------------------ | ------------------------------------------ |
114
+ | 本文の正本(SSOT) | `.agents/specdojo-orchestrator.agent.md` |
115
+ | Claude Code | `.claude/agents/specdojo-orchestrator.md` |
116
+ | GitHub Copilot | `.github/agents/specdojo-orchestrator.md` |
117
+ | Codex | `.codex/agents/specdojo-orchestrator.toml` |
118
+ | OpenCode / Qwen | `.opencode/agents/qwen-orchestrator.md` |
119
+ | OpenCode / Gemma | `.opencode/agents/gemma-orchestrator.md` |
120
+
121
+ 本文を変更する場合は、次の手順で全環境を同期します。
122
+
123
+ 1. SSOT の `.agents/specdojo-orchestrator.agent.md` を編集します。
124
+ 2. Markdown ラッパー4ファイルでは frontmatter より後を、Codex ラッパーでは `developer_instructions` の複数行文字列を、SSOT と同じ本文に更新します。
125
+ 3. `npm run lint:orchestrator-sync` を実行し、5つのラッパーが SSOT とバイト単位で一致することを確認します。
126
+
127
+ この検証は対象ファイルの変更時に pre-commit hook からも自動実行され、不一致があれば commit を停止します。モデル・権限・provider の変更は本文ではなく、各ラッパーの frontmatter / TOML 側で行います。