specdojo 0.3.1 → 0.4.1

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 (260) hide show
  1. package/.github/agents/specdojo-orchestrator.md +61 -2
  2. package/CHANGELOG.md +90 -0
  3. package/README.md +85 -25
  4. package/dist/{catalog-build-references.js → catalog/build-references.js} +4 -4
  5. package/dist/catalog/build-render.js +32 -0
  6. package/dist/{catalog-build.js → catalog/build.js} +9 -9
  7. package/dist/{catalog.js → catalog/catalog.js} +10 -10
  8. package/dist/{catalog-generate.js → catalog/generate.js} +8 -8
  9. package/dist/catalog/paths.js +1 -0
  10. package/dist/{catalog-plan-generate.js → catalog/plan-generate.js} +4 -4
  11. package/dist/{catalog-plan.js → catalog/plan.js} +4 -4
  12. package/dist/{catalog-scaffold.js → catalog/scaffold.js} +3 -3
  13. package/dist/{agent.js → commands/agent.js} +11 -11
  14. package/dist/{build-command.js → commands/build.js} +2 -2
  15. package/dist/{init-command.js → commands/init.js} +168 -45
  16. package/dist/commands/night-orchestrator.js +287 -0
  17. package/dist/{orchestrator.js → commands/orchestrator.js} +12 -5
  18. package/dist/{watch.js → commands/watch.js} +3 -3
  19. package/dist/{dashboard-timeline.js → dashboard/dashboard-timeline.js} +2 -2
  20. package/dist/{dashboard.js → dashboard/dashboard.js} +11 -10
  21. package/dist/{dashboard-exec-records.js → dashboard/exec-records.js} +2 -2
  22. package/dist/{dashboard-routines.js → dashboard/routines.js} +6 -5
  23. package/dist/{dashboard-shared.js → dashboard/shared.js} +1 -1
  24. package/dist/{timeline-build.js → dashboard/timeline-build.js} +2 -1
  25. package/dist/{timeline.js → dashboard/timeline.js} +1 -1
  26. package/dist/{deliverable.js → deliverable/deliverable.js} +5 -5
  27. package/dist/{deliverable-trash.js → deliverable/trash.js} +5 -5
  28. package/dist/{devcontainer-command.js → devcontainer/command.js} +8 -4
  29. package/dist/devcontainer/scaffold.js +418 -0
  30. package/dist/{doc-index.js → docs/doc-index.js} +1 -1
  31. package/dist/{frontmatter-namespace.js → docs/frontmatter-namespace.js} +1 -1
  32. package/dist/{index-command.js → docs/index-command.js} +1 -1
  33. package/dist/docs/template-resolution.js +1 -0
  34. package/dist/{viewpoint-document-kinds-check.js → docs/viewpoint-document-kinds-check.js} +1 -1
  35. package/dist/{yaml-pages-command.js → docs/yaml-pages-command.js} +1 -1
  36. package/dist/{yaml-pages.js → docs/yaml-pages.js} +2 -2
  37. package/dist/{exec-agent-config.js → exec/agent-config.js} +92 -5
  38. package/dist/{exec-agent-git-state.js → exec/agent-git-state.js} +1 -1
  39. package/dist/{exec-agent-protected-config.js → exec/agent-protected-config.js} +1 -1
  40. package/dist/{exec-commands.js → exec/commands.js} +22 -18
  41. package/dist/{exec-core.js → exec/core.js} +11 -11
  42. package/dist/{exec-events.js → exec/events.js} +2 -2
  43. package/dist/{exec-evidence.js → exec/evidence.js} +11 -6
  44. package/dist/exec/exec.js +2 -0
  45. package/dist/exec/format.js +1 -0
  46. package/dist/{exec-handoff.js → exec/handoff.js} +13 -12
  47. package/dist/{exec-limit.js → exec/limit.js} +93 -12
  48. package/dist/{exec-parent-validation.js → exec/parent-validation.js} +18 -4
  49. package/dist/{exec-pipeline-state.js → exec/pipeline-state.js} +29 -2
  50. package/dist/{exec-plans-core.js → exec/plans-core.js} +68 -114
  51. package/dist/{exec-plans-generation.js → exec/plans-generation.js} +53 -10
  52. package/dist/{exec-plans-storage.js → exec/plans-storage.js} +5 -5
  53. package/dist/{exec-plans.js → exec/plans.js} +3 -3
  54. package/dist/{exec-project.js → exec/project.js} +1 -1
  55. package/dist/{exec-protection-handoff.js → exec/protection-handoff.js} +3 -3
  56. package/dist/{exec-register-resume.js → exec/register-resume.js} +2 -2
  57. package/dist/{exec-register.js → exec/register.js} +114 -9
  58. package/dist/{exec-repo-integration-git.js → exec/repo-integration-git.js} +2 -2
  59. package/dist/{exec-repo-integration-sync.js → exec/repo-integration-sync.js} +4 -4
  60. package/dist/{exec-repo-integration.js → exec/repo-integration.js} +14 -11
  61. package/dist/{exec-repo-trace.js → exec/repo-trace.js} +3 -3
  62. package/dist/{exec-reporter-output.js → exec/reporter-output.js} +2 -2
  63. package/dist/{exec-reporter.js → exec/reporter.js} +142 -25
  64. package/dist/{exec-results.js → exec/results.js} +287 -31
  65. package/dist/{exec-run-agent-pipeline.js → exec/run/agent-pipeline.js} +35 -12
  66. package/dist/{exec-run-agent.js → exec/run/agent.js} +115 -28
  67. package/dist/{exec-run-in-place.js → exec/run/in-place.js} +56 -27
  68. package/dist/{exec-run-job.js → exec/run/job.js} +65 -36
  69. package/dist/{exec-run-lifecycle-commands.js → exec/run/lifecycle-commands.js} +30 -22
  70. package/dist/{exec-run-lock.js → exec/run/lock.js} +4 -3
  71. package/dist/{exec-run-mode-shared.js → exec/run/mode-shared.js} +3 -3
  72. package/dist/{exec-run-register-command.js → exec/run/register-command.js} +38 -11
  73. package/dist/{exec-run-register-core.js → exec/run/register-core.js} +63 -21
  74. package/dist/{exec-run-register-mode.js → exec/run/register-mode.js} +58 -31
  75. package/dist/exec/run/register-post-review.js +420 -0
  76. package/dist/{exec-run-register-resume.js → exec/run/register-resume.js} +48 -27
  77. package/dist/{exec-run-register-state.js → exec/run/register-state.js} +13 -10
  78. package/dist/{exec-run-register-worktree.js → exec/run/register-worktree.js} +119 -24
  79. package/dist/{exec-run.js → exec/run/run.js} +11 -11
  80. package/dist/{exec-run-schedule-mode.js → exec/run/schedule-mode.js} +17 -17
  81. package/dist/{exec-run-schedule-prepare.js → exec/run/schedule-prepare.js} +31 -18
  82. package/dist/{exec-run-schedule-task.js → exec/run/schedule-task.js} +45 -18
  83. package/dist/{exec-run-shared.js → exec/run/shared.js} +78 -30
  84. package/dist/{exec-schedule-calendar.js → exec/schedule/calendar.js} +1 -1
  85. package/dist/{exec-schedule-cpm.js → exec/schedule/cpm.js} +2 -2
  86. package/dist/{exec-schedule-gantt-chart-render.js → exec/schedule/gantt-chart-render.js} +2 -2
  87. package/dist/exec/schedule/gantt-chart.js +2 -0
  88. package/dist/{exec-schedule-hash.js → exec/schedule/hash.js} +2 -2
  89. package/dist/exec/schedule/index.js +1 -0
  90. package/dist/{exec-schedule-initial.js → exec/schedule/initial.js} +2 -2
  91. package/dist/{exec-schedule-progress.js → exec/schedule/progress.js} +2 -2
  92. package/dist/{exec-schedule-ready.js → exec/schedule/ready.js} +2 -2
  93. package/dist/{exec-schedule.js → exec/schedule/schedule.js} +11 -11
  94. package/dist/exec/shared.js +63 -0
  95. package/dist/exec/slot-lock.js +1 -0
  96. package/dist/{exec-strategy.js → exec/strategy.js} +2 -2
  97. package/dist/{exec-task-repos.js → exec/task-repos.js} +104 -17
  98. package/dist/{exec-task-view.js → exec/task-view.js} +4 -4
  99. package/dist/{exec-trial-commands.js → exec/trial-commands.js} +20 -22
  100. package/dist/{exec-trial-core.js → exec/trial-core.js} +6 -6
  101. package/dist/{exec-trial.js → exec/trial.js} +2 -2
  102. package/dist/{exec-worktree-command.js → exec/worktree-command.js} +25 -23
  103. package/dist/{exec-worktree-ops-commit.js → exec/worktree-ops-commit.js} +25 -60
  104. package/dist/{exec-worktree-ops-lifecycle.js → exec/worktree-ops-lifecycle.js} +13 -8
  105. package/dist/{exec-worktree-ops-merge.js → exec/worktree-ops-merge.js} +48 -7
  106. package/dist/{exec-worktree-ops.js → exec/worktree-ops.js} +3 -3
  107. package/dist/exec/worktree.js +305 -0
  108. package/dist/{grade-apply.js → grade/apply.js} +9 -9
  109. package/dist/{grade-command-apply.js → grade/command-apply.js} +7 -7
  110. package/dist/{grade-command-inspect.js → grade/command-inspect.js} +6 -6
  111. package/dist/{grade-command-plan.js → grade/command-plan.js} +5 -5
  112. package/dist/{grade-core.js → grade/core.js} +3 -3
  113. package/dist/grade/grade.js +19 -0
  114. package/dist/{grade-markdown.js → grade/markdown.js} +6 -6
  115. package/dist/{grade-pipeline-state.js → grade/pipeline-state.js} +4 -4
  116. package/dist/{grade-plan.js → grade/plan.js} +5 -5
  117. package/dist/{grade-result.js → grade/result.js} +5 -94
  118. package/dist/{grade-target-discovery.js → grade/target-discovery.js} +7 -7
  119. package/dist/{grade-targets.js → grade/targets.js} +11 -8
  120. package/dist/{job-definition.js → job/definition.js} +25 -6
  121. package/dist/{job.js → job/job.js} +12 -11
  122. package/dist/{kata-command.js → kata/command.js} +3 -3
  123. package/dist/{kata.js → kata/kata.js} +5 -5
  124. package/dist/register/approach.js +134 -0
  125. package/dist/{register-core.js → register/core.js} +26 -8
  126. package/dist/{register-create-commands.js → register/create-commands.js} +171 -8
  127. package/dist/{register-date.js → register/date.js} +1 -1
  128. package/dist/register/derivation.js +163 -0
  129. package/dist/{register-event-merge.js → register/event-merge.js} +44 -3
  130. package/dist/{register-events.js → register/events.js} +13 -3
  131. package/dist/{register-history.js → register/history.js} +7 -6
  132. package/dist/{register-item.js → register/item.js} +32 -5
  133. package/dist/register/lifecycle-lock.js +5 -0
  134. package/dist/{register-maintenance-commands.js → register/maintenance-commands.js} +13 -7
  135. package/dist/{register-migrate-timestamps.js → register/migrate-timestamps.js} +3 -3
  136. package/dist/{register-migration.js → register/migration.js} +5 -4
  137. package/dist/{register.js → register/register.js} +32 -27
  138. package/dist/{register-renumber.js → register/renumber.js} +38 -11
  139. package/dist/{register-transition-commands.js → register/transition-commands.js} +3 -3
  140. package/dist/{register-update.js → register/update.js} +5 -5
  141. package/dist/{register-views.js → register/views.js} +47 -7
  142. package/dist/{review-grade.js → review/grade.js} +2 -2
  143. package/dist/{review-plan.js → review/plan.js} +3 -3
  144. package/dist/{routine-definition.js → routine/definition.js} +2 -2
  145. package/dist/{routine.js → routine/routine.js} +49 -22
  146. package/dist/{schedule-approach.js → schedule/approach.js} +8 -8
  147. package/dist/{schedule-build.js → schedule/build.js} +7 -4
  148. package/dist/{schedule.js → schedule/schedule.js} +6 -6
  149. package/dist/{schedule-strategy-generate-document.js → schedule/strategy-generate-document.js} +2 -2
  150. package/dist/{schedule-strategy-generate-scope.js → schedule/strategy-generate-scope.js} +4 -4
  151. package/dist/{schedule-strategy-generate.js → schedule/strategy-generate.js} +10 -10
  152. package/dist/shared/agent-types.js +23 -0
  153. package/dist/shared/artifact-path.js +9 -0
  154. package/dist/{build-if-stale.js → shared/build-if-stale.js} +1 -1
  155. package/dist/{catalog-build-render.js → shared/catalog-render.js} +3 -32
  156. package/dist/{exec-slot-lock.js → shared/cross-process-lock.js} +3 -1
  157. package/dist/shared/fs.js +30 -0
  158. package/dist/shared/git.js +346 -0
  159. package/dist/shared/grade-result.js +94 -0
  160. package/dist/{package-paths.js → shared/package-paths.js} +3 -3
  161. package/dist/shared/plan-templates.js +114 -0
  162. package/dist/{exec-provider-scaffold.js → shared/provider-scaffold.js} +6 -3
  163. package/dist/shared/random.js +4 -0
  164. package/dist/{exec-schedule-index.js → shared/schedule-index.js} +3 -1
  165. package/dist/shared/schedule-paths.js +9 -0
  166. package/dist/{specdojo-config.js → shared/specdojo-config.js} +162 -21
  167. package/dist/{exec-shared.js → shared/text.js} +4 -135
  168. package/dist/shared/time.js +28 -0
  169. package/dist/shared/workspace-scaffold.js +69 -0
  170. package/dist/specdojo.js +22 -22
  171. package/docs/ja/specdojo/exec-templates/xep-common-conventions-template.md +31 -18
  172. package/docs/ja/specdojo/exec-templates/xep-register-investigate-template.md +1 -2
  173. package/docs/ja/specdojo/exec-templates/xep-register-template.md +3 -2
  174. package/docs/ja/specdojo/exec-templates/xer-template.md +1 -3
  175. package/docs/ja/specdojo/exec-templates/xrp-job-template.md +6 -4
  176. package/docs/ja/specdojo/exec-templates/xrp-register-post-run-template.md +46 -0
  177. package/docs/ja/specdojo/guides/branch-workflow-guide.md +34 -1
  178. package/docs/ja/specdojo/guides/docs-structure-guide.md +2 -0
  179. package/docs/ja/specdojo/guides/exec-config-guide.md +169 -26
  180. package/docs/ja/specdojo/guides/exec-operation-guide.md +184 -13
  181. package/docs/ja/specdojo/guides/exec-worktree-guide.md +2 -0
  182. package/docs/ja/specdojo/guides/orchestrator-operation-guide.md +40 -3
  183. package/docs/ja/specdojo/guides/quick-start-guide.md +89 -21
  184. package/docs/ja/specdojo/guides/register-operation-guide.md +44 -1
  185. package/docs/ja/specdojo/guides/remote-host-development-guide.md +61 -6
  186. package/docs/ja/specdojo/guides/review-guide.md +1 -1
  187. package/docs/ja/specdojo/guides/routine-operation-guide.md +5 -5
  188. package/docs/ja/specdojo/guides/specdojo-overview-guide.md +1 -1
  189. package/docs/ja/specdojo/guides/use-case-guide.md +1 -1
  190. package/docs/ja/specdojo/guides/waza-guide.md +1 -1
  191. package/docs/ja/specdojo/references/command-reference.md +124 -55
  192. package/docs/ja/specdojo/references/specdojo-config-reference.md +33 -7
  193. package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +22 -13
  194. package/docs/ja/specdojo/standards/job-definition-standard.md +20 -18
  195. package/docs/ja/specdojo/standards/rulebook-authoring-standard.md +2 -2
  196. package/docs/ja/specdojo/templates/pjr-derived-items-template.md +22 -0
  197. package/docs/ja/specdojo/templates/pjr-index-template.md +1 -0
  198. package/docs/specdojo/schemas/v1/agent-members.schema.yaml +29 -2
  199. package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +111 -17
  200. package/docs/specdojo/schemas/v1/exec-evidence.schema.yaml +28 -0
  201. package/docs/specdojo/schemas/v1/job-run.schema.yaml +2 -2
  202. package/docs/specdojo/schemas/v1/job.schema.yaml +7 -0
  203. package/docs/specdojo/schemas/v1/pipeline-state.schema.yaml +38 -0
  204. package/docs/specdojo/schemas/v1/register-events.schema.yaml +5 -0
  205. package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +91 -7
  206. package/docs/specdojo/schemas/v1/routine-run.schema.yaml +1 -1
  207. package/docs/specdojo/schemas/v1/specdojo-config.schema.yaml +36 -1
  208. package/package.json +17 -17
  209. package/templates/antigravity/README.md +6 -2
  210. package/templates/antigravity/agent-members-snippet.yaml +108 -12
  211. package/templates/antigravity/exec-defaults-snippet.yaml +8 -13
  212. package/templates/antigravity/orchestrator.md +61 -2
  213. package/templates/claude/README.md +27 -3
  214. package/templates/claude/agents/claude-executor.md +0 -1
  215. package/templates/claude/agents/claude-reporter.md +2 -1
  216. package/templates/claude/agents/claude-review-executor.md +0 -1
  217. package/templates/claude/agents/specdojo-orchestrator.md +61 -2
  218. package/templates/codex/README.md +40 -4
  219. package/templates/codex/agents/specdojo-orchestrator.toml +61 -2
  220. package/templates/codex/orchestrator.md +61 -2
  221. package/templates/devcontainer/devcontainer.json +5 -2
  222. package/templates/devcontainer/post-create.sh +15 -7
  223. package/templates/devcontainer/remote-host/specdojo-tmux.sh.sample +102 -0
  224. package/templates/devcontainer/remote-host/ssh-config.sample +19 -0
  225. package/templates/devcontainer/vim/vimrc +37 -0
  226. package/templates/init-agent-members.yaml +75 -25
  227. package/templates/init-exec-defaults.yaml +44 -9
  228. package/templates/opencode/README.md +17 -3
  229. package/templates/opencode/agents/opencode-executor.md +0 -1
  230. package/templates/opencode/agents/opencode-reporter.md +2 -1
  231. package/templates/opencode/agents/opencode-review-executor.md +0 -1
  232. package/templates/opencode/agents/specdojo-orchestrator.md +61 -2
  233. package/dist/devcontainer-scaffold.js +0 -165
  234. package/dist/exec-schedule-gantt-chart.js +0 -2
  235. package/dist/exec-worktree.js +0 -474
  236. package/dist/exec.js +0 -2
  237. package/dist/grade.js +0 -19
  238. package/templates/claude/agents/claude-expert-review-executor.md +0 -14
  239. /package/dist/{catalog-plan-prompt.js → catalog/plan-prompt.js} +0 -0
  240. /package/dist/{catalog-types.js → catalog/types.js} +0 -0
  241. /package/dist/{template-frontmatter.js → docs/template-frontmatter.js} +0 -0
  242. /package/dist/{role-types.js → exec/role-types.js} +0 -0
  243. /package/dist/{exec-schedule-gantt-chart-scope.js → exec/schedule/gantt-chart-scope.js} +0 -0
  244. /package/dist/{exec-types.js → exec/types.js} +0 -0
  245. /package/dist/{grade-command-shared.js → grade/command-shared.js} +0 -0
  246. /package/dist/{register-command-types.js → register/command-types.js} +0 -0
  247. /package/dist/{review-types.js → review/types.js} +0 -0
  248. /package/dist/{schedule-phase-sets.js → schedule/phase-sets.js} +0 -0
  249. /package/dist/{schedule-strategy-profiles.js → schedule/strategy-profiles.js} +0 -0
  250. /package/dist/{agent-response.js → shared/agent-response.js} +0 -0
  251. /package/dist/{catalog-paths.js → shared/catalog-paths.js} +0 -0
  252. /package/dist/{dist-freshness.js → shared/dist-freshness.js} +0 -0
  253. /package/dist/{git-environment.js → shared/git-environment.js} +0 -0
  254. /package/dist/{exec-format.js → shared/markdown-format.js} +0 -0
  255. /package/dist/{practice-id.js → shared/practice-id.js} +0 -0
  256. /package/dist/{spawn-self.js → shared/spawn-self.js} +0 -0
  257. /package/dist/{specdojo-gitignore.js → shared/specdojo-gitignore.js} +0 -0
  258. /package/dist/{template-resolution.js → shared/template-resolution.js} +0 -0
  259. /package/dist/{yaml-schema-modeline.js → shared/yaml-schema-modeline.js} +0 -0
  260. /package/dist/{yaml.js → shared/yaml.js} +0 -0
@@ -54,13 +54,17 @@ SpecDojo は自律実行を前提とします。次の 2 つが作業端末の
54
54
  利用リポジトリに `.devcontainer/` がない場合は、指定した provider の CLI を含む最小構成を生成できます。まず dry-run で対象を確認します。
55
55
 
56
56
  ```bash
57
- npx specdojo devcontainer scaffold --provider claude,codex --dry-run
58
- npx specdojo devcontainer scaffold --provider claude,codex
57
+ npx specdojo devcontainer scaffold --provider claude,codex --preset recommended --dry-run
58
+ npx specdojo devcontainer scaffold --provider claude,codex --preset recommended
59
59
  ```
60
60
 
61
- 既存の `.devcontainer/` は通常実行では上書きしません。置き換える場合だけ `--force` を指定します。生成設定は provider の設定ディレクトリを名前付きボリュームへ保存し、ホストの認証情報・秘密鍵・`.env` は既定でマウントしません。Ollama 接続、コンテナ内の cron、コンテナ内の tmux が必要な場合だけ `--ollama`、`--cron`、`--tmux` を追加します。本書の構成図のようにホスト側の tmux でコンテナ自体を包む場合、`--tmux` は不要です。
61
+ `recommended` preset は、端末版 Emacs と Vim(既存設定を上書きしない雛形)、tmux、SpecDojo の文書作業向け VS Code 拡張をまとめて追加します。拡張は Git Graph、markdownlint、YAML、Prettier、remark、Markdown All in One、Code Spell Checker、EditorConfig、Error Lens、Even Better TOML で、選択した provider の拡張もその provider の分だけ追加します。Markdown と YAML は保存時に Prettier で整形し、主要な SpecDojo YAML を `docs/specdojo/schemas/v1/` の schema へ関連付けます。同じ拡張は `.vscode/extensions.json` の recommendation にも追加されます。
62
62
 
63
- 生成する `devcontainer.json` は、利用リポジトリ単体ではなく、その親ディレクトリを `/workspaces/specdojo-workspace` へマウントします。別リポジトリ構成では `repos` の参照先(例: `../app1`)と `worktree_base`(例: `../app1-specdojo-worktrees`)が利用リポジトリの外にあるためです。これらの Git リポジトリと worktree は `safe.directory` の対象になります。一方、同じ親ディレクトリに置いたその他のファイルもコンテナから見えるため、秘密情報などコンテナへ公開しないファイルは別の場所へ置いてください。
63
+ 既存の `.devcontainer/` は通常実行では上書きしません。置き換える場合だけ `--force` を指定します。生成設定は provider の設定ディレクトリを名前付きボリュームへ保存し、ホストの認証情報・秘密鍵・`.env` は既定でマウントしません。preset を使わない場合、Ollama 接続、コンテナ内の cron、コンテナ内の tmux が必要なときだけ `--ollama`、`--cron`、`--tmux` を追加します。本書の構成図のようにホスト側の tmux でコンテナ自体を包む場合、tmux を含めない個別指定も選べます。
64
+
65
+ 生成する `devcontainer.json` は、利用リポジトリ単体ではなく、その親ディレクトリをホスト側と同じ名前の `/workspaces/<親名>` へマウントします。例えば `app1-workspace/app1-specdojo` の作業ディレクトリは `/workspaces/app1-workspace/app1-specdojo` です。別リポジトリ構成では `repos` の参照先(例: `../app1`)と `worktree_base`(例: `../app1-specdojo-worktrees`)が利用リポジトリの外にあるためです。これらの Git リポジトリと worktree は `safe.directory` の対象になります。一方、同じ親ディレクトリに置いたその他のファイルもコンテナから見えるため、秘密情報などコンテナへ公開しないファイルは別の場所へ置いてください。
66
+
67
+ 親名に空白や `/` などがある場合は scaffold が停止するため、`--workspace-name <name>` で英数字・`.`・`_`・`-` だけの名前を指定します。また、コンテナ内で作成した Git worktree は絶対パスを記録します。ホスト側の親ディレクトリ名を変えて `.devcontainer/` を作り直す場合は、`--workspace-name` に以前の名前を指定し、コンテナ内のパスを維持してください。
64
68
 
65
69
  端末版 Emacs と TypeScript・Markdown・YAML・Bash の LSP 環境を追加する場合は `--editor emacs` を指定します。
66
70
 
@@ -70,6 +74,37 @@ npx specdojo devcontainer scaffold --provider claude,codex --editor emacs
70
74
 
71
75
  生成される `.devcontainer/emacs/init.el` は、`~/.emacs`、`~/.emacs.el`、`~/.emacs.d/init.el`、`~/.config/emacs/init.el` のいずれも無い場合だけコピーされます。空の `~/.emacs.d` があればその中の `init.el` へ、なければ `~/.config/emacs/init.el` へ配置し、配置先を出力します。初回作成前の既定値は生成されたテンプレートで変更でき、作成後は出力されたコピー先を編集します。dotfiles が設定を配置していれば上書きされません。
72
76
 
77
+ scaffold は、常時稼働ホストへの接続と tmux セッションの維持に使えるサンプルを `.devcontainer/remote-host/` に生成します。
78
+
79
+ - `specdojo-tmux.sh.sample`: 常時稼働ホストの `~/bin/specdojo-tmux.sh` などへコピーし、実行権限(`chmod +x`)を付与して使います。devcontainer が停止していれば `devcontainer up` で起動し、コンテナ内の tmux セッション(`specdojo`)へ接続します。ホスト名や作業パスはプレースホルダーになっているため、ホストの環境に合わせて調整してください。
80
+ - `ssh-config.sample`: 接続元端末の `~/.ssh/config` へ追加して使います。ホストへの通常接続エイリアスと、`RemoteCommand` と `RequestTTY force` で `specdojo-tmux.sh` を直接呼び出すエイリアス(`Host <host>-tmux`)を含みます。`RemoteCommand` では端末の `PATH` の設定が読み込まれないため、接続元から `ssh <host> 'command -v devcontainer'` を実行して Dev Container CLI が見つかるか確かめられます。
81
+
82
+ `devcontainer.json` の `appPort` や `forwardPorts` で開発サーバなどの公開ポートを設定している場合は、接続用エイリアスに `LocalForward` の行が含まれます。開発サーバのポートを増やしたときは、`~/.ssh/config` の tmux 接続用エイリアスにも `LocalForward <ポート> 127.0.0.1:<ポート>` を追加してください。
83
+
84
+ 生成される `devcontainer.json` は `remoteEnv` で `/home/node/.local/bin`(利用者が別の場合は `/home/<remoteUser>/.local/bin`)を `PATH` の先頭に追加するため、コンテナ作成後に開く端末や VS Code のターミナルでも `~/.local/bin` に入った Claude Code などの CLI がそのまま利用できます。
85
+
86
+ ### 2.2. 生成した Dev Container をホストで実地確認する
87
+
88
+ SpecDojo 本体の開発者は、Docker daemon と Dev Container CLI を利用できる Mac のホストで、次の E2E を実行できます。ホストとコンテナで `node_modules` を共有しているため `tsx` は使えません。スクリプトは Node の標準ライブラリだけを使っており、Node 22.18 以上(型を外して直接動かせる版)が必要です。
89
+
90
+ ```bash
91
+ node tools/e2e/devcontainer-host-e2e.ts
92
+ ```
93
+
94
+ このスクリプトは、手元のソースを npm tarball にし、新しい一時リポジトリで `specdojo init --yes --provider claude --devcontainer` と `devcontainer up` を実行します。作成したコンテナでは、利用者、`~/.local/bin` の所有者、tmux、Vim、Emacs、Claude Code CLI の配置を項目ごとに検査します。また、agent にホストの権限を渡さない前提を守るため、開発用コンテナに Docker CLI がないことも検査します。
95
+
96
+ 通常は、検査の成否にかかわらず一時ディレクトリ、コンテナ、テスト用の名前付き volume、テストで新しく作られた container image を最後に削除します。失敗状態を調べる場合は `--keep` を付けて残し、表示された一時ディレクトリと Docker resource を調査後に手動で削除してください。
97
+
98
+ ```bash
99
+ node tools/e2e/devcontainer-host-e2e.ts --keep
100
+ ```
101
+
102
+ Docker または Dev Container CLI を利用できない場合、スクリプトは確認コマンドと Dev Container CLI の導入方法を表示し、終了コード 1 で終了します。Dev Container CLI は次のコマンドで導入できます。
103
+
104
+ ```bash
105
+ npm install --global @devcontainers/cli
106
+ ```
107
+
73
108
  ## 3. 構成例
74
109
 
75
110
  ```text
@@ -156,12 +191,32 @@ Host <ホスト名>
156
191
 
157
192
  ### 6.2. 実行環境の起動に失敗する
158
193
 
159
- SSH 経由の非対話シェルでは `PATH` が対話シェルと異なることがあり、コンテナ起動用のコマンドが見つからない場合があります。接続元から次を実行して確認します。
194
+ SSH 経由の非対話シェル(`RemoteCommand` など)では、ログインシェルや対話端末で読み込まれる `~/.zshrc` などの `PATH` の設定が読み込まれないため、コンテナ起動用のコマンドが見つからない場合があります。接続元から次を実行して確認します。
160
195
 
161
196
  ```bash
162
- ssh <ホスト名> 'printf "PATH=%s\n" "$PATH"; command -v node || true'
197
+ ssh <ホスト名> 'command -v devcontainer'
163
198
  ```
164
199
 
200
+ `devcontainer` が見つからない場合は、ホスト側の通常端末で `dirname "$(command -v devcontainer)"` を実行して場所を確認し、`specdojo-tmux.sh` の `node_bin_dir` に設定してください。詳細な `PATH` を確認する場合は次を実行します。
201
+
202
+ ```bash
203
+ ssh <ホスト名> 'printf "PATH=%s\n" "$PATH"; command -v node || true; command -v devcontainer || true'
204
+ ```
205
+
206
+ ### 6.3. コンテナ内の端末で ~/.local/bin の CLI が見つからない
207
+
208
+ v0.4.0 などで生成した Dev Container 環境では、`devcontainer.json` に `remoteEnv` がないため、コンテナ作成後に開く端末や VS Code のターミナルで `~/.local/bin` が `PATH` に入らず、Claude Code などの CLI が見つからない場合があります。
209
+
210
+ 既存の環境を修正するには、`.devcontainer/devcontainer.json` に `remoteEnv` を追加(または既存の `remoteEnv` に `PATH` を追加)し、コンテナをリビルドしてください。
211
+
212
+ ```json
213
+ "remoteEnv": {
214
+ "PATH": "/home/node/.local/bin:${containerEnv:PATH}"
215
+ }
216
+ ```
217
+
218
+ コンテナ内の利用者が `node` 以外の場合は、`/home/<remoteUser>/.local/bin` に合わせてください。
219
+
165
220
  ## 7. 運用上のセキュリティ
166
221
 
167
222
  この構成は、常時稼働ホストを外部から到達可能にします。次を守ります。
@@ -174,7 +174,7 @@ viewpoint は継続品質評価 `specdojo grade` の正本です。review plan
174
174
 
175
175
  `document_kinds.include` は列挙した種類だけへ適用し、`document_kinds.exclude` は列挙した種類を除外します。二つは同時に指定できません。宣言を省略した観点は全種類へ適用します。`grade_targets` は kata / deliverable という評価経路の大分類、`document_kinds` は rulebook ID による文書種類の細分類であり、両方を指定した場合は双方を満たす文書だけを対象にします。
176
176
 
177
- `include` または `exclude` で rulebook ID を列挙した観点は、すべての rulebook について扱いを判断済みにします。列挙していない rulebook を既定の結果(`exclude` の観点では適用、`include` の観点では対象外)のままにすると判断した場合は、`document_kinds.confirmed_default` へ列挙します。`confirmed_default` は判断の記録で、適用判定は変えません。同じ rulebook を `include` / `exclude` と重ねて書くことはできません。`src/viewpoint-document-kinds-check.ts` の検証は、どこにも載っていない rulebook、存在しない rulebook ID、重複した判断を観点 ID と rulebook ID の組で error として報告します。この検証は `npm test`(`npm run check` に含まれる)で実行され、`npx tsx src/viewpoint-document-kinds-check.ts` で単独でも実行できます。`unclassified` だけを宣言した観点は全種類へ適用するため、検証の対象外です。
177
+ `include` または `exclude` で rulebook ID を列挙した観点は、すべての rulebook について扱いを判断済みにします。列挙していない rulebook を既定の結果(`exclude` の観点では適用、`include` の観点では対象外)のままにすると判断した場合は、`document_kinds.confirmed_default` へ列挙します。`confirmed_default` は判断の記録で、適用判定は変えません。同じ rulebook を `include` / `exclude` と重ねて書くことはできません。`src/docs/viewpoint-document-kinds-check.ts` の検証は、どこにも載っていない rulebook、存在しない rulebook ID、重複した判断を観点 ID と rulebook ID の組で error として報告します。この検証は `npm test`(`npm run check` に含まれる)で実行され、`npx tsx src/docs/viewpoint-document-kinds-check.ts` で単独でも実行できます。`unclassified` だけを宣言した観点は全種類へ適用するため、検証の対象外です。
178
178
 
179
179
  `grade_rubric` の level 0-4 は category を跨いで共有し、viewpoint score を `level × 25` とします。`grade_rubric` には level ごとの `review_verdict`(level 4 が `complete`、level 3 が `complete-with-findings`、level 0-2 が `incomplete`)が定義されています。これは grade の level を review の入力にする写像であり、review はこの対応で観点を判定し直しません。写像の使い方は `grade の結果を review の入力にする規則` に示します。
180
180
 
@@ -69,9 +69,9 @@ review agent は、`exec run` の `--review-by` / `--reporter-by`、Job の `tas
69
69
 
70
70
  action の `commit: true` は互換として残しています。`task.review` を宣言していない Job でも `commit: true` なら同じ流れで実行しますが、新しい routine では推奨しません。Job が `task.review` を宣言している場合は Job を優先し、`commit` を省略しても、`false` を指定しても review を経て統合します。
71
71
 
72
- 統合前 review を宣言した Job は本体の checkout では実行せず、`exec/<project-id>-<run-id>` の worktree で実行します。runner は Job Run の plan・result・evidence・Run JSON と Job が更新した成果物だけを `chore(routine): …` の commit にし、commit 本文へ Job Run ID と `succeeded` / `failed` を記録します。本体 checkout にある利用者の未 commit 変更は commit 対象に入りません。
72
+ 統合前 review を宣言した Job は本体の checkout では実行せず、`exec/<project-id>-<run-id>` の worktree で実行します。runner は Job Run の plan・result・evidence・Run JSON と Job が更新した成果物だけを `chore(routine): …` の commit にし、commit 本文へ Job Run ID と `succeeded` / `partial` / `failed` を記録します。本体 checkout にある利用者の未 commit 変更は commit 対象に入りません。
73
73
 
74
- 出力 commit の後、runner は `mode: review` の plan/result を作ります。review executor は score・verdict・finding・失敗文書と Job の完了条件を照合しますが、Job Run 出力は修正しません。Run が `succeeded` で verdict が `complete` または `complete-with-findings` の場合だけ、runner は現在の統合先へ `--no-ff` で merge し、worktree と exec branch を撤去します。Run が失敗した場合、review が未完了の場合、またはそれ以外の verdict の場合は統合せず、worktree を保持して routine の `last_result: failure`、`last_reason`、review result、Job Run JSON に理由を残します。
74
+ 出力 commit の後、runner は `mode: review` の plan/result を作ります。review executor は score・verdict・finding・失敗文書と Job の完了条件を照合しますが、Job Run 出力は修正しません。Run が `succeeded` で verdict が `complete` または `complete-with-findings` の場合に加え、Run が `partial` で verdict が `complete-with-findings` の場合も、runner は現在の統合先へ `--no-ff` で merge し、worktree と exec branch を撤去します。`partial`を統合した routine は`last_result: partial`と記録し、`routine list`でも部分成功を表示します。Run が失敗した場合、review が未完了の場合、またはそれ以外の verdict の場合は統合せず、worktree を保持して routine の `last_result: failure`、`last_reason`、review result、Job Run JSON に理由を残します。
75
75
 
76
76
  #### waiting Run の確認・統合・破棄
77
77
 
@@ -123,7 +123,7 @@ action:
123
123
  mode: strict
124
124
  ```
125
125
 
126
- 配列は先頭から1段ずつ同期的に実行し、前段が完了してから次段を起動します。途中の段が `failure` または `skipped` でも、失敗分を後段で拾う運用を可能にするため、残りの段を続行します。全体結果は `failure`、`skipped`、`success` の優先順で集約します。つまり、1段でも失敗すれば `failure`、失敗がなく1段でも skip なら `skipped`、全段成功時だけ `success` です。段間の待機と失敗時中断の切り替えは提供しません。
126
+ 配列は先頭から1段ずつ同期的に実行し、前段が完了してから次段を起動します。途中の段が `failure`、`partial`、`skipped` でも、失敗分を後段で拾う運用を可能にするため、残りの段を続行します。全体結果は `failure`、`partial`、`skipped`、`success` の優先順で集約します。つまり、1段でも失敗すれば `failure`、失敗がなく1段でも部分成功なら `partial`、そのどちらもなく1段でも skip なら `skipped`、全段成功時だけ `success` です。段間の待機と失敗時中断の切り替えは提供しません。
127
127
 
128
128
  配列 action の実行後は、通常の `last_result` に加えて段ごとの `index`(1始まり)、`kind`、`result` を `last_action_results` へ記録します。単一オブジェクトの action では `last_action_results` を記録せず、既存の状態形式を維持します。
129
129
 
@@ -190,7 +190,7 @@ Job runnerは、この入口をmaterialize済みの引数で1回起動し、コ
190
190
 
191
191
  scriptの`--run-id`にはJob Run IDを渡すため、rate limitや中断後に同じJob Runをretryすると完了済みの処理を飛ばして再開します。通常の agent / apply 失敗は `<execution_path>/grade/pipeline/` に完了段、失敗段、本文ハッシュ、連続失敗回数を保存します。次の日次実行枠でも本文ハッシュが同じなら失敗段から再開し、本文が変われば古い到達状況を使わず1段目から評価します。保存済み state の `stage_total` が現在の構成と異なる場合は、古い grade の日時にかかわらず完了扱いへ移行せず、state を削除して1段目から再評価します。rate limit は失敗回数に数えません。既定で同じ段が3回連続失敗すると再試行から外し、結果の `retry_exhausted` 行で人手対応を報告します。`period`は対象期間の表示だけに使い、実行や再開の同一性には使いません。
192
192
 
193
- Job Definition は script を `if` の条件として起動し、非0の終了コードを保存してそのまま Job runner へ返します。これにより、後続の `results.tsv` 表示が rate limit や中断の終了コードを0へ上書きしません。script が正常終了した場合だけ `grade pipeline complete:` と `results.tsv` が command evidence に揃い、analysis reporter が起動します。
193
+ Job Definition は script を `if` の条件として起動し、終了コードを保存してそのまま Job runner へ返します。script は全件完了を0、完了文書と失敗文書の混在を2、全件失敗を1、rate limitを75で返します。grade Jobは`partial_exit_code: 2`を宣言するため、2だけが`partial`になりanalysis reporterとreviewへ進みます。Jobは0と2のどちらでも`results.tsv`をcommand evidenceへ出力します。reviewは、`passed`が1件以上あり、`failed`の文書と失敗段がpipeline stateへ記録され次回の`--incomplete`で再試行できる場合だけ`complete-with-findings`を選べます。全件失敗、rate limit、中断、未開始文書があるRunは統合せず`waiting`にします。
194
194
 
195
195
  ## 2. due判定と実行
196
196
 
@@ -242,7 +242,7 @@ specdojo routine run --project <project-id> --due --dry-run
242
242
  [routine] skipped rtn-daily-register-sweep: job action skipped
243
243
  ```
244
244
 
245
- `routine-state.json` の `last_result` は `success`、`failure`、`skipped` のいずれかです。`skipped` は project busy または Job precondition の skip を表し、failure 件数や終了コードへ加算されません。`routine list` では最終実行時刻の後ろに `(skipped)` と表示されます。
245
+ `routine-state.json` の `last_result` は、実行開始時に `running` が記録され、実行完了時に `success`、`partial`、`failure`、`skipped` のいずれかへ更新されます。実行中は前回の結果や理由を残さず、`routine list` の最終実行の欄には `(running)` と表示されます(例: `2026-10-15T21:00:03Z (running)`)。実行プロセスの異常終了などにより `running` の表示が残った場合でも、次回の due 判定は `last_run` の時刻(cron の場合は `last_scheduled_for`)に基づいて判定されるため、次回の実行機会には影響しません。`partial` は完了分の統合と失敗分の再試行待ちが混在する状態であり、`routine list` では `(partial)` と表示されます。`skipped` は project busy または Job precondition の skip を表し、failure 件数や終了コードへ加算されません。`routine list` では最終実行時刻の後ろに `(skipped)` と表示されます。
246
246
 
247
247
  ### 2.1. devcontainerでのcron設定
248
248
 
@@ -32,7 +32,7 @@ SpecDojo に関わるすべての読者の入口となる文書であり、個
32
32
 
33
33
  ## 1. SpecDojoとは
34
34
 
35
- SpecDojo は、仕様道(Spec-Dō)の道場です。
35
+ SpecDojo は、Spec道(仕様道)の道場です。
36
36
 
37
37
  プロダクトの構築・改修に必要な情報を、単発の説明資料ではなく、相互に参照できる構造化された成果物として管理します。
38
38
  人が内容と判断理由を理解でき、AI とツールが成果物を作成・検証・更新できる状態を目指します。
@@ -69,7 +69,7 @@ flowchart TD
69
69
  ### 2.1. 新規プロジェクトを最短で立ち上げる
70
70
 
71
71
  - ゴール: 設定から1タスク完了までを最短で通す。
72
- - 進め方: `config init` → 成果物カタログ作成・検証・生成 → トラック戦略作成 → `schedule build` → `exec refresh` → 1タスクを claim / complete。
72
+ - 進め方: `specdojo init` → `register add` → 個票へ完了条件を記入 → `exec run --register --worktree` → 変更と動作を確認 → `register close`。成果物を計画的に増やす場合は、その後に成果物カタログと Schedule へ広げる。
73
73
  - 主に使う文書: [Quick Startガイド](quick-start-guide.md)、[遂行の技活用ガイド](waza-guide.md)。
74
74
 
75
75
  ### 2.2. 課題整理から目的・スコープを固める
@@ -43,7 +43,7 @@ SpecDojo は道場のメタファーとして、`specdojo` CLI のコマンド
43
43
 
44
44
  ### 1.1. 技の名前
45
45
 
46
- 主要な CLI 機能には、仕様道(Spec-Dō)の道場で使う技の名前を付けています。
46
+ 主要な CLI 機能には、Spec道(仕様道)の道場で使う技の名前を付けています。
47
47
 
48
48
  | 技の名前 | CLI の機能 | 役割 |
49
49
  | -------- | ---------- | ---------------------------------------------------------------------------------- |
@@ -43,35 +43,41 @@ project の解決順序と設定は [遂行の技活用ガイド](../guides/waza
43
43
  | `init` | project から agent 実行までを質問式で初期設定する | `specdojo init` |
44
44
  | `config init` | `specdojo.config.json` と `.gitignore` を個別に用意する | `specdojo config init` |
45
45
  | `config migrate-members` | agent 定義を保護設定へ移す | `specdojo config migrate-members --dry-run` |
46
- | `config scaffold` | provider の agent・settings 設定を個別に配置する | `specdojo config scaffold --provider codex` |
46
+ | `config scaffold` | provider や VS Code ワークスペースを個別に配置する | `specdojo config scaffold --provider codex` |
47
47
  | `project list` | 登録済み project を表示する | `specdojo project list` |
48
48
 
49
49
  `init` は対話できる端末で、project ID と名前、register、人の nickname と表示名、複数指定可能な
50
- provider、exec、成果物カタログの規模、Dev Container の順に質問します。既存ファイルは上書きせず、
51
- スキップしたパスを表示します。`--dry-run` は予定だけを表示し、ファイルや `package.json` を変更しません。
50
+ provider、exec、Dev Container の順に質問します。Dev Container を選んだ場合だけ、続けて推奨 preset を入れるかを質問します(既定は「入れる」)。成果物カタログは対話では質問せず、`--catalog <size>` を
51
+ 明示した場合にだけ作成します。既存ファイルは上書きせず、スキップしたパスを表示します。`--dry-run` は
52
+ 予定だけを表示し、ファイルや `package.json` を変更しません。各回答は質問の直後に検証され、誤りの理由を
53
+ 表示して同じ質問だけをやり直します。それまでの回答は保持されます。`--exec` を選んだのに provider が
54
+ 空の場合も、provider の質問だけをやり直します。非対話環境や `--yes` では再質問せず、従来どおり不正な
55
+ 指定をエラーとして終了します。
52
56
 
53
57
  非対話環境では質問せず、次の主要オプションと既定値を使います。
54
58
 
55
- | オプション | 用途 | 既定値 |
56
- | ----------------------- | --------------------------------------------------- | --------------- |
57
- | `--yes` | 質問せず既定値と指定済みオプションで実行する | - |
58
- | `--project <id>` | project ID | `prj-0001` |
59
- | `--name <name>` | project の表示名 | `My Project` |
60
- | `--no-register` | register を作らない | register を作る |
61
- | `--nickname <nickname>` | 人の名簿に書く nickname | `owner` |
62
- | `--display-name <name>` | 人の名簿に書く表示名 | `Project Owner` |
63
- | `--provider <names>` | provider をカンマ区切りで指定する | `codex` |
64
- | `--exec` | executor / reporter の名簿と起動設定を作る | 作らない |
65
- | `--catalog <size>` | `small` / `medium` / `large` の成果物カタログを作る | 作らない |
66
- | `--devcontainer` | 選んだ provider の Dev Container を作る | 作らない |
67
- | `--dry-run` | 作成・変更予定だけを表示する | 書き込む |
59
+ | オプション | 用途 | 既定値 |
60
+ | ------------------------------ | ------------------------------------------------------------------------- | --------------- |
61
+ | `--yes` | 質問せず既定値と指定済みオプションで実行する | - |
62
+ | `--project <id>` | project ID | `prj-0001` |
63
+ | `--name <name>` | project の表示名 | `My Project` |
64
+ | `--no-register` | register を作らない | register を作る |
65
+ | `--nickname <nickname>` | 人の名簿に書く nickname | `owner` |
66
+ | `--display-name <name>` | 人の名簿に書く表示名 | `Project Owner` |
67
+ | `--provider <names>` | provider をカンマ区切りで指定する | `codex` |
68
+ | `--exec` | executor / reporter の名簿と起動設定を作る | 作らない |
69
+ | `--catalog <size>` | `small` / `medium` / `large` の成果物カタログを作る(対話では質問しない) | 作らない |
70
+ | `--devcontainer` | 選んだ provider の Dev Container を作る | 作らない |
71
+ | `--devcontainer-preset <name>` | Dev Container の preset(`recommended` / `none`)を選ぶ | `recommended` |
72
+ | `--workspace-name <name>` | Dev Container 内で使う親ディレクトリ名 | ホスト側の親名 |
73
+ | `--dry-run` | 作成・変更予定だけを表示する | 書き込む |
68
74
 
69
75
  `init` が作る `.specdojo/agent-members.yaml` と `.specdojo/exec-defaults.yaml` は、選択した
70
76
  provider だけを含みます。親 runner の検証は、対応する `package.json` の npm script が存在する
71
77
  ID だけを `pipeline.parent_validations` へ設定し、該当する script がなければこの設定を省略します。
72
78
  採用した ID と省略理由は実行時に表示します。最後にオーケストレーターの起動コマンド、最初の起票、
73
79
  オーケストレーターを使わない `--executor-by` / `--reporter-by` の実行例、作成ファイルの commit を
74
- 次の一歩として表示します。`run.worktree_base` は `../<リポジトリ名>-worktrees` です。個別に設定する
80
+ 次の一歩として表示します(カタログを作らなかった場合は、後から `catalog scaffold` で追加する案内も含みます)。`run.worktree_base` は `../<リポジトリ名>-worktrees` です。個別に設定する
75
81
  場合は、以下の `config init`、`config scaffold`、`register scaffold` などを利用します。
76
82
 
77
83
  `config init` は、register 単体で始められる `prj-0001` の最小設定を作成し、設定確認、任意の
@@ -86,6 +92,8 @@ provider 設定、登録簿作成の順に次のコマンドを案内します
86
92
  書き込まず、予定の内容だけを表示します。`config scaffold` の `--provider` には
87
93
  `antigravity`、`claude`、`codex`、`copilot`、`opencode` を指定でき、`--dry-run` と `--force` も利用できます。
88
94
 
95
+ `package.json` がある場合、provider ごとのオーケストレーター起動スクリプトも追加します。Claude Code は `orch:opus`・`orch:sonnet`、Codex は `orch:sol`(`gpt-5.6-sol`)・`orch:terra`(`gpt-5.6-terra`)、Antigravity は `orch:flash`(`gemini-3.8-flash-high`)、OpenCode は `orch:opencode` です。既存のスクリプトは `--force` を付けても上書きしません。
96
+
89
97
  `antigravity` に限り `--global` を指定すると、`~/.gemini/antigravity-cli/settings.json` へ SpecDojo 用の permission rule を追記します。既存キー・既存 rule は保持し、実書き込み前に timestamp 付きバックアップを作ります。`--global` を省略した通常実行はユーザーディレクトリへ触れません。適用前は次の dry-run で追加 rule を確認してください。
90
98
 
91
99
  ```bash
@@ -95,6 +103,14 @@ specdojo config scaffold --provider antigravity --global
95
103
 
96
104
  `--force` はリポジトリ内の scaffold ファイルだけを上書きし、グローバル設定の既存項目は上書きしません。従来の `exec scaffold --provider antigravity` でも同じ `--global` / `--dry-run` の挙動を利用できます。
97
105
 
106
+ `config scaffold --workspace` は、`.specdojo/specdojo.config.json` の `repos` 宣言から VS Code のマルチルートワークスペース(`<project-id>.code-workspace`)をリポジトリルートに生成します。`folders` にはプロジェクトリポジトリ(`.`)と各プロダクトリポジトリ(`repos[].path`)を宣言順に並べ、別リポジトリ構成でも 1 つの VS Code ウィンドウでプロジェクトとプロダクトを同時に開けます。`--project <id>` で対象 project を指定でき、省略時は `current_project` を使います。既存のファイルは `--force` を指定しない限り上書きしません。`repos` が宣言されていない project ではエラーになります。`--dry-run` は書き込まず予定の内容だけを表示します。
107
+
108
+ ```bash
109
+ specdojo config scaffold --workspace
110
+ specdojo config scaffold --workspace --project prj-0002 --dry-run
111
+ specdojo config scaffold --workspace --force
112
+ ```
113
+
98
114
  `config migrate-members` は、各 project の `pm-members.yaml` から `type: agent` の member を取り出し、トップレベルの `agent_members_path`(既定 `.specdojo/agent-members.yaml`)へ統合します。通常実行前に `--dry-run` で対象と件数を確認してください。`--project <id>` を指定すると 1 project だけを対象にします。
99
115
 
100
116
  `current_project` を設定しておくと、多くのコマンドで `--project` を省略できます。
@@ -342,10 +358,12 @@ specdojo schedule strategy generate \
342
358
  | `--to <PJR-ID>` | 移動先の PJR-ID を指定する | `renumber` |
343
359
  | `--registered <datetime>` | 起票日時(タイムゾーン付き RFC 3339)。省略時は実行時刻 | `add` |
344
360
  | `--completed <datetime>` | 完了・却下日時(タイムゾーン付き RFC 3339)。省略時は実行時刻 | `close` / `reject` |
345
- | `--by <actor>` | 追記型 event に記録する actor を指定 | `add` / 更新 / 遷移コマンド |
361
+ | `--by <actor>` | 名簿または予約一覧の actor を追記型 event に記録する | `add` / 更新 / 遷移コマンド |
346
362
  | `--reason <text>` | event の理由を記録(`wait` では `block_reason` も更新) | `add` / 更新 / 遷移コマンド |
347
363
  | `--conclusion <text>` | 終端時の結論を記録・更新(`update` では `-` で削除) | `add` / `update` / 終端コマンド |
348
364
  | `--block-reason <text>` | `waiting` の理由を更新(`-` で削除) | `update` |
365
+ | `--approach <approach>` | 個票の進め方を指定(`update` では `-` で削除) | `add` / `update` |
366
+ | `--target <doc-id>` | 対象文書 ID を指定(繰り返し可、`update` では `-` で削除) | `add` / `update` |
349
367
  | `--topic <slug>` | 個票ファイル名と文書 ID の論点部分を指定・更新する | `add` / `update` |
350
368
  | `--commit` | `register lifecycle` 枠内で記帳・再生成・commitを行う | `add` / `update` / `renumber` / 遷移 |
351
369
  | `-m, --message <message>` | `--commit` のcommitメッセージを上書きする | `add` / `update` / `renumber` / 遷移 |
@@ -359,19 +377,27 @@ specdojo schedule strategy generate \
359
377
 
360
378
  `register add` は個票 Frontmatter の `registered_at`(起票日時)を、`register close` / `register reject` は `completed_at`(完了・却下日時)を自動記入します。値は UTC の RFC 3339・秒精度(例: `2026-08-09T14:08:51Z`)で、OS / コンテナの `TZ` 環境変数には依存しません。`register reopen` は `completed_at` を削除します。
361
379
 
380
+ `register` の `--by` は、project の `pm-members.yaml` にある人の nickname、`.specdojo/agent-members.yaml` にある agent の nickname または alias、予約 actor の `SpecDojo`・`specdojo-orchestrator`・`night-orchestrator` だけを受け付けます。agent alias は実体名で event に記録し、未知の値は書き込み前に拒否します。省略時は `SpecDojo` です。決定・承認では `PO` などの Role code や予約 actor ではなく、本人の nickname を指定します。
381
+
382
+ `--approach` を指定する場合、`--target` は 1 件だけ必須です。成果物を作成・修正する approach の対象は成果物カタログの doc id で解決するため、まだ文書がない成果物も指定できます。kata maintenance の対象は文書索引で解決し、approach に対応する kata 種別との一致も書き込み前に検証します。
383
+
362
384
  `item_type: note` は `open` のまま更新する記録です。`register close` / `register reject` / `register defer` は終了コード 1 で拒否し、対応・回答・判断が必要な場合は `todo` / `question` / `decision` など目的に合う別の `item_type` で起票するよう案内します。本文の追記や修正には `register update` を使用できます。
363
385
 
364
386
  `--registered` / `--completed` にはタイムゾーン付きの RFC 3339 値(`2026-08-09T14:08:51Z` または `2026-08-09T23:08:51+09:00`)を指定し、保存時に UTC へ正規化します。タイムゾーンを含まない値は解釈が実行環境に依存するため受け付けません。期限(`--due`)は瞬間ではなく暦日のため `YYYY-MM-DD` のままです。
365
387
 
366
388
  `register update --topic <slug>` は個票のファイル名と Frontmatter の文書 ID を同時に変更し、`docs/ja` 配下の旧文書 ID 参照を更新してから生成ビューを再生成します。変更は `action: update` の event に文書 ID の変更として記録されます。形式は英小文字・数字・単一ハイフン区切りに限り、変更先ファイルが存在する場合は書き込み前に停止します。
367
389
 
390
+ `register add --from <ID>` は、起票の元になった登録項目を個票 Frontmatter の `derived_from` へ記録します。`--from` は複数回指定でき、同じ project の項目は `PJR-XXXX`、別 project の項目は `<project-id>:PJR-XXXX` を使います。自己参照と存在しない項目は書き込み前に拒否します。別 project が設定にあれば存在も確認し、未設定なら書式だけを確認します。`register update --from <ID>` は一覧を置換し、`--from -` で削除します。`register build` は `generated/pjr-derived-items.md` を生成し、元の項目から派生先を逆引きできるようにします。decision から todo を起票するときも、この関係を追跡先として使います。
391
+
392
+ `register add --approach <approach> --target <doc-id>` は、個票 Frontmatter に進め方と対象を書きます。`approach` を指定すると対象は 1 件だけ必須です。成果物を作成・修正する進め方は成果物カタログにある文書を、`rulebook-maintenance` などの保守の進め方は名前に対応する kata 種別を対象にします。文書索引で解決できない ID、対象種別の不一致、複数対象との組み合わせは書き込み前に拒否します。`approach` を指定しない `--target` は複数回指定でき、従来どおり変更網羅検証の対象宣言として使えます。`register update` でも同じ検証を行います。
393
+
368
394
  記帳系コマンドの `--commit` は、register の worktree 実行と同じ project の `register lifecycle` 枠を取得してから、記帳、`register build` 相当の検証・派生ビュー再生成、pathspec を限定した commit を行います。commit 対象はコマンドが新たに変更した個票・event・参照文書だけで、開始前からあるほかの変更を含めません。対象個票・event・参照文書に開始前の未 commit 変更がある場合は、既存差分との混在を避けるため記帳前に停止します。既定件名は `docs(register PJR-XXXX): <command> <title>` で、`-m` / `--message` により上書きできます。`--dry-run --commit` は変更予定だけを表示し、枠の取得と commit は行いません。
369
395
 
370
396
  一覧・派生ビューの「登録日」「完了日」は、保存した日時を config の `run.register_date_timezone`(IANA タイムゾーン名、既定 `UTC`)へ変換して導出する表示値です。
371
397
 
372
398
  `register migrate` は旧形式の登録簿データを現行形式へ移す一度限りの移行コマンドです。追跡対象だった `pjr-index.md` の表を個票 Frontmatter へ移し、旧日時を UTC へ変換し、個票内の `register_events` を `events/pjr-XXXX.yaml` へ分離します。イベントがまだない項目は、利用可能な Git 履歴を項目別イベントファイルへ変換します。event ID は commit・項目 ID・変更内容から決定的に生成するため、再実行で重複しません。
373
399
 
374
- `register history` は `events/pjr-XXXX.yaml` を読み、個票単位の追加(`added`)と変更(`updated`)を発生順に出力します。event 導入前または未移行の期間だけ Git 履歴を読み、削除(`removed`)を含む従来の履歴と統合します。event は発生日時・actor・action・reason・遷移前後状態・変更フィールドを保持するため、複数遷移を1コミットへまとめても粒度を失いません。比較対象は登録項目一覧の列と `block_reason` です。
400
+ `register history` は `events/pjr-XXXX.yaml` を読み、個票単位の追加(`added`)と変更(`updated`)を発生順に出力します。event 導入前または未移行の期間だけ Git 履歴を読み、削除(`removed`)を含む従来の履歴と統合します。event は発生日時・actor・action・reason・遷移前後状態・変更フィールドを保持するため、複数遷移を1コミットへまとめても粒度を失いません。比較対象は登録項目一覧の列と `block_reason`、`approach`、`targets`、`derived_from` です。
375
401
 
376
402
  各書き込みコマンドは現在値を個票へ、event を項目別イベントファイルへ反映します。同じ現在値になる操作の再実行では event を追加しません。`register build` は個票とイベントファイルの対応、event の schema、ID 一意性、時刻順、直前イベント参照、状態連鎖、最新 event と現在値の一致を検証します。
377
403
 
@@ -423,32 +449,41 @@ specdojo schedule strategy generate \
423
449
 
424
450
  主要オプション:
425
451
 
426
- | オプション | 用途 | 対象 |
427
- | ------------------------------- | -------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------- |
428
- | `--task <task-id>` | 対象タスクを指定する | 状態遷移系 / `run` / `plan` |
429
- | `--by <actor>` | 実行 actor / agent の nickname を指定する(手動ターゲットの agent 選択も兼ねる) | 状態遷移系 / `run` / `resume` / `worktree agent` |
430
- | `--edit-by <nickname>` | `--auto` バッチで edit タスクに使う agent nickname | `run --auto` / `resume` |
431
- | `--review-by <nickname>` | `--auto` バッチで review タスクに使う agent nickname | `run --auto` / `resume` |
432
- | `--strategy <name>` | 選択戦略を切り替える(`critical-first` 既定 / `fifo`) | `scheduler` / `run --auto` |
433
- | `--auto` / `--loop` | Ready タスクを自動選択する / Ready がなくなるまで繰り返す | `run` |
434
- | `--parallel <n>` | 同時に走らせる agent 数の上限を指定する | `run --auto` / register の worktree モード |
435
- | `--worktree` | worktree に隔離して実行する | `run --task` / `run --register` |
436
- | `--in-place` | register 項目を現在の作業ツリーで実行する(`run.register_execution` を上書き) | `run --register` |
437
- | `--track-state` | claim / complete の状態イベントを記録する | `run --task` |
438
- | `--register <PJR-ID>` | 登録簿の項目を実行する(空白・カンマ区切りで複数可。場所の既定は `run.register_execution`) | `run` / `plan` |
439
- | `--register-filter` | 登録簿項目を type / priority / status / limit の条件で決定論的に選ぶ | `run` |
440
- | `--register-commit` | 成功したIDごとに、その実行で生じた変更を1コミットにまとめる(worktree モードでは常に commit のため無視) | `run --register` |
441
- | `--on-failure <stop\|continue>` | 途中失敗時に残りのIDを停止するか継続するか(既定は `stop`) | `run --register` |
442
- | `--resume` | run が止まった段(executor / reporter / 統合)を既存 worktree と checkpoint で再開する | register の worktree モード |
443
- | `--resume-from executor` | reporter 段から再開可能な run を、既存成果を保持したまま executor 段から再開する | register の worktree モード(`--resume` と併用) |
444
- | `--force-restart` | 再開可能な run の成果があっても、worktree を破棄して項目全体を再実行する | register の worktree モード |
445
- | `--join` | 実行中の register worktree 実行の終了を待たずに合流して並行実行する(上限は `run.max_concurrent_runs`) | register の worktree モード |
446
- | `--executor-by <nickname>` | executor 段の agent。register では `PJR-ID=nickname,...` による項目別指定も可能 | `run --auto` / `resume` / `run --register` / `run --plan` / `run --deliverable` |
447
- | `--reporter-by <nickname>` | executor/reporter パイプラインの reporter 段に使う agent nickname | `run --auto` / `resume` / `run --register` / `run --plan` / `run --deliverable` |
448
- | `--due` | 再開時刻を迎えた利用制限延期 task を対象にする | `resume` |
452
+ | オプション | 用途 | 対象 |
453
+ | -------------------------------------- | -------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------- |
454
+ | `--task <task-id>` | 対象タスクを指定する | 状態遷移系 / `run` / `plan` |
455
+ | `--by <actor>` | 実行 actor / agent の nickname を指定する(手動ターゲットの agent 選択も兼ねる) | 状態遷移系 / `run` / `resume` / `worktree agent` |
456
+ | `--edit-by <nickname>` | `--auto` バッチで edit タスクに使う agent nickname | `run --auto` / `resume` |
457
+ | `--review-by <nickname>` | `--auto` の review タスク、または register の統合後 review に使う agent nickname | `run --auto` / `run --register --post-review` / `resume` |
458
+ | `--strategy <name>` | 選択戦略を切り替える(`critical-first` 既定 / `fifo`) | `scheduler` / `run --auto` |
459
+ | `--auto` / `--loop` | Ready タスクを自動選択する / Ready がなくなるまで繰り返す | `run` |
460
+ | `--parallel <n>` | 同時に走らせる agent 数の上限を指定する | `run --auto` / register の worktree モード |
461
+ | `--worktree` | worktree に隔離して実行する | `run --task` / `run --register` |
462
+ | `--in-place` | register 項目を現在の作業ツリーで実行する(`run.register_execution` を上書き) | `run --register` |
463
+ | `--track-state` | claim / complete の状態イベントを記録する | `run --task` |
464
+ | `--register <PJR-ID>` | 登録簿の項目を実行する(空白・カンマ区切りで複数可。場所の既定は `run.register_execution`) | `run` / `plan` |
465
+ | `--register-filter` | 登録簿項目を type / priority / status / limit の条件で決定論的に選ぶ | `run` |
466
+ | `--register-commit` | 成功したIDごとに、その実行で生じた変更を1コミットにまとめる(worktree モードでは常に commit のため無視) | `run --register` |
467
+ | `--post-review` | worktree 統合後に完了 review を行い、todo / issue を verdict に応じて close または waiting にする | `run --register --worktree` |
468
+ | `--on-failure <stop\|continue>` | 途中失敗時に残りのIDを停止するか継続するか(既定は `stop`) | `run --register` |
469
+ | `--integration-branch <repo>=<branch>` | run ごとのプロダクトリポジトリの統合先(繰り返し可)を指定する | register の worktree モード |
470
+ | `--resume` | run が止まった段(executor / reporter / 統合)を既存 worktree と checkpoint で再開する | register の worktree モード |
471
+ | `--resume-from executor` | reporter 段から再開可能な run を、既存成果を保持したまま executor 段から再開する | register の worktree モード(`--resume` と併用) |
472
+ | `--force-restart` | 再開可能な run の成果があっても、worktree を破棄して項目全体を再実行する | register の worktree モード |
473
+ | `--join` | 実行中の register worktree 実行の終了を待たずに合流して並行実行する(上限は `run.max_concurrent_runs`) | register の worktree モード |
474
+ | `--executor-by <nickname>` | executor 段の agent。register では `PJR-ID=nickname,...` による項目別指定も可能 | `run --auto` / `resume` / `run --register` / `run --plan` / `run --deliverable` |
475
+ | `--reporter-by <nickname>` | executor/reporter パイプラインの reporter 段に使う agent nickname | `run --auto` / `resume` / `run --register` / `run --plan` / `run --deliverable` |
476
+ | `--on-rate-limit <action>` | 指名した agent の上限時の扱い。`stop` / `wait` / `fallback` | `run` / `resume` |
477
+ | `--fallback-executor-by <name>` | rate limit の `fallback` または接続不能時に executor 段を1回だけ引き継ぐ agent | `run` / `resume` |
478
+ | `--fallback-reporter-by <name>` | rate limit の `fallback` または接続不能時に reporter 段を1回だけ引き継ぐ agent | `run` / `resume` |
479
+ | `--due` | 再開時刻を迎えた利用制限延期 task を対象にする | `resume` |
449
480
 
450
481
  `--plan` と `--deliverable` も Schedule のパイプライン宣言を持たないため、`--executor-by` / `--reporter-by` の少なくとも一方を指定したときだけ executor/reporter 2段階で実行します。指定しなかった段は `stage_role` による自動選択で決まります。`--plan` では reporter が scaffold 済みの result を記入するため、frontmatter に `task_id` を持つ plan が必要です。`--by` との併用はエラーです。`--by` に `stage_role` を持つ pipeline 用 agent を指定すると、result 未記入の blocked にはせず、`--executor-by` / `--reporter-by` を使うよう案内するエラーで実行前に拒否します。
451
482
 
483
+ 指名した agent の rate limit は既定では `stop` です。`wait` は provider の reset / retry-after、次に `rate_limit_policy.cooldown_seconds` を使い、`rate_limit_policy.pinned.max_wait_seconds`(既定8時間)以内なら同じ段を同じ agent で再開します。`fallback` は対応する fallback flag または `rate_limit_policy.pinned.fallback_executor_by` / `fallback_reporter_by` の agent へ1回だけ切り替えます。fallback 未指定時と fallback agent も上限になった場合は停止します。CLI が `exec-defaults.yaml` より優先します。待機中は project の実行ロックを保持します。
484
+
485
+ `connection_error_detection` に一致する接続不能は `--on-rate-limit` の値とは独立して扱い、対応する fallback flag または設定上の fallback agent があれば1回だけ切り替えます。fallback 未指定時は通常の失敗として停止し、同じ agent の再開待ちは行いません。切替元・切替先・時刻・原因は rate limit の切替と同じ pipeline state、evidence、result の経路へ記録します。
486
+
452
487
  agent の指定は repository 共通 roster nickname(`.specdojo/agent-members.yaml`)へ一本化します。手動ターゲット(`--task` / `--register` など)では `--by <nickname>`、`--auto` バッチでは mode 別に `--edit-by` / `--review-by` を使い、バッチ起動は `--auto` に一本化します。解決の優先順位は「単体指定(`--by`)> mode 別指定(`--edit-by` / `--review-by`)> 自動選択」です。
453
488
 
454
489
  Schedule タスクの `agent_pipeline`(`sch-strategy-<track>.yaml` の phase 設定)と同じ executor/reporter 2段階(`stage_role: executor` が成果物を編集・検証し、`stage_role: reporter` が evidence から result を描画する)は、`--register` の既定の実行方式です。register 項目は Schedule のような per-item のパイプライン宣言を持たないため、owner・role からの agent 選択は行いません。`--executor-by <nickname>` と `--reporter-by <nickname>` を **両方セットで** 指定すると、その agent で実行します。`--by` と `--executor-by` / `--reporter-by` をいずれも指定しない場合は、`stage_role: executor`(`mode: edit` または `mode` 未指定)と `stage_role: reporter` の agent から `priority` 順に自動で選びます。`stage_role` を持たない agent(翻訳専用など)は自動選択の候補に入りません。どちらかの段に該当する agent がいない場合は、`--executor-by` / `--reporter-by` の指定を求めるエラーで実行前に止まります。複数項目では `--executor-by PJR-0001=exec-a,PJR-0002=exec-b` のような項目別指定も使用できます。項目別指定は選択した全項目を含む必要があり、対象外 ID と指定漏れは実行前にエラーになります。片方だけの指定もエラーになります。
@@ -488,6 +523,12 @@ specdojo exec run --project prj-0001 --register-filter --register-types todo --r
488
523
  # 成果物を worktree に隔離して実行し、統合ブランチへ merge back する
489
524
  specdojo exec run --project prj-0001 --register PJR-0012 --worktree
490
525
 
526
+ # app1 の統合先を、この run だけローカルの feature/login にする
527
+ specdojo exec run --project prj-0001 --register PJR-0012 --worktree --integration-branch app1=feature/login
528
+
529
+ # 統合後に読み取り専用 review を行い、完了した todo / issue を自動 close する
530
+ specdojo exec run --project prj-0001 --register PJR-0012 --worktree --post-review
531
+
491
532
  # 保護設定で block された提案差分を表示し、確認後に統合先へ commit する
492
533
  specdojo exec handoff apply --project prj-0001 --register PJR-0012
493
534
 
@@ -510,7 +551,11 @@ specdojo exec run --project prj-0001 --register PJR-0012 --worktree --resume --r
510
551
  specdojo exec run --project prj-0001 --job job-weekly-report --input period=2026-W32
511
552
  ```
512
553
 
513
- `--register` は指定した個票の項目を実行します。`--register-filter` は `--register-types` / `--register-priorities` / `--register-statuses` のカンマ区切り条件と、正の整数の `--register-limit` で項目を選びます。条件省略時は open かつ実行可能な type が対象です。いずれも実行対象になる type は `todo` / `issue` / `change-request` / `question` / `risk` で、`decision` / `note` は対象外です。実行場所の既定は `.specdojo/exec-defaults.yaml` の `run.register_execution`(`worktree` / `in-place`)で選び、未設定時は互換性のため in-place です。`--worktree` / `--in-place` は設定を上書きし、同時指定はエラーになります。worktree モードは成果物の変更を隔離し、状態遷移(`start` / `review` / `waiting`)を直列化したうえで、成功時に merge back します。`--parallel <n>` は worktree モードでのみ指定できます。
554
+ `--register` は指定した個票の項目を実行します。`--register-filter` は `--register-types` / `--register-priorities` / `--register-statuses` のカンマ区切り条件と、正の整数の `--register-limit` で項目を選びます。条件省略時は open かつ実行可能な type が対象です。いずれも実行対象になる type は `todo` / `issue` / `change-request` / `question` / `risk` で、`decision` / `note` は対象外です。実行場所の既定は `.specdojo/exec-defaults.yaml` の `run.register_execution`(`worktree` / `in-place`)で選び、未設定時は互換性のため in-place です。`--worktree` / `--in-place` は設定を上書きし、同時指定はエラーになります。worktree モードは成果物の変更を隔離し、状態遷移(`start` / `review` / `waiting`)を直列化したうえで、成功時に merge back します。`--post-review` または `run.register_post_review: true` を指定すると、merge back の後に完了判定を行い、todo / issue を自動 close できます。`--parallel <n>` は worktree モードでのみ指定できます。
555
+
556
+ `--integration-branch <repo>=<branch>` は、register の worktree モードで、その run に限ってプロダクトリポジトリ `<repo>` の統合先を上書きします。複数リポジトリにはオプションを繰り返します。`<repo>` は `repos[].name` に宣言済みで、`<branch>` はそのリポジトリに存在する有効なローカルブランチでなければならず、リモートブランチの取得やローカルブランチの作成は行いません。同じ `<repo>` の重複、宣言にないリポジトリ、空の値は register の状態を変える前に拒否します。統合先の優先順位は「run の指定 → `repos[].integration_branch` → そのリポジトリの現在のブランチ」です。指定しない run の挙動は従来と変わりません。
557
+
558
+ 複数項目を `--parallel` で実行する場合、指定は選択された各 item run に同じように適用されます。中断した run を `--resume` するときは、開始時の指定を `pipeline-state.json` から再利用するため、オプションを繰り返す必要はありません。再開時に値を再指定する場合、その値は開始時の指定と一致する必要があり、run の途中で統合先を変更・追加する指定は拒否します。result の複数リポジトリ trace には、実際に使った統合先ブランチと統合後の commit snapshot が記録されます。
514
559
 
515
560
  `exec handoff apply --register <PJR-ID>` は、worktree 実行が `agent-config-write` で waiting になった項目の最新 result から提案差分を読み、統合先へ適用して commit します。コマンドは差分を必ず表示し、対話では `y` / `yes`、非対話実行では `--yes` による明示確認がなければ何も変更しません。提案差分がない、切り詰められている、申し送りの対象パスと一致しない、保護対象外のパスを含む、統合先へ適用できない、対象パスに既存変更がある場合は commit 前に停止します。複数リポジトリでは `# repo: <name>` で区切られた差分を、宣言済みの各統合先へ限定 commit します。`package.json` を適用した場合は、依存定義を変更したか確認して対応する lock ファイルを再生成・commit し、その後に表示された `exec run --register ... --worktree --resume` を実行します。
516
561
 
@@ -559,7 +604,7 @@ specdojo exec trial adopt --project prj-0001 --comparison <comparison-id> --tria
559
604
 
560
605
  `--agent`と任意の`--reporter-by`を使うと、reporterなしまたは全trial共通reporterの従来方式になります。`--pair <executor>=<reporter>...`は2組以上を指定し、executorとreporterを一組として比較します。`--pair`は`--agent` / `--reporter-by`と併用できません。比較記録の`reporter_mode`には`none` / `shared` / `paired`のいずれかを保存します。各reporterについて構造化出力の成否、形式試行回数、形式再試行回数、`evidence_blocked` / `invalid_output` / `invocation_failure` / `rate_limit`の失敗分類も保存します。`evidence_blocked` は reporter の申告ではなく、executor evidence から runner が機械判定した blocked を表します。
561
606
 
562
- `pipeline.parent_validations`に指定できるIDは`validate-schema`、`typecheck`、`test-unit`、`test-integration`、`lint-ts`、`lint-fm`、`lint-md`です(各IDは組み込み許可リストの固定argvへ解決されます)。`pipeline.parent_validations`はtrialにも適用され、executor成功後・reporter起動前に各worktreeで実行されます。親検証結果は`source: runner`付きでevidenceへ保存し、失敗時はtrialを`failed`にします。比較記録と`trial status`はexecutor・親検証・全体の時間を分け、executorの検証報告総数と`passed` / `failed` / `not_run` / `requires_human`、親検証の状態と件数を別々に表示します。採用前に親検証の成功、executorの未実施・未報告、sandbox 外で人が行う確認を確認してください。
607
+ `pipeline.parent_validations`に指定できるIDは`validate-schema`、`typecheck`、`test-unit`、`test-integration`、`lint-ts`、`lint-fm`、`lint-md`、`build`、`format-check`です(各IDは組み込み許可リストの固定argvへ解決されます)。`pipeline.parent_validations`はtrialにも適用され、executor成功後・reporter起動前に各worktreeで実行されます。親検証結果は`source: runner`付きでevidenceへ保存し、失敗時はtrialを`failed`にします。比較記録と`trial status`はexecutor・親検証・全体の時間を分け、executorの検証報告総数と`passed` / `failed` / `not_run` / `requires_human`、親検証の状態と件数を別々に表示します。採用前に親検証の成功、executorの未実施・未報告、sandbox 外で人が行う確認を確認してください。
563
608
 
564
609
  記録先は`execution_path/exec/trials/<comparison-id>/`です。agent選定への反映は自動化せず、人が複数比較を確認して `.specdojo/agent-members.yaml` を更新します。
565
610
 
@@ -881,6 +926,16 @@ provider CLI の実行中、起動元は `SIGINT` と `SIGQUIT` を無視して
881
926
 
882
927
  Claude Code、Codex、Antigravity、GitHub Copilot には exec と同じ追加ルート引数を渡します。OpenCode は、起動時の `OPENCODE_CONFIG_CONTENT` に選択 agent の `permission.external_directory` を注入し、全外部ディレクトリを拒否したうえで宣言済みのリポジトリだけを許可します。外部パスへ既存の `permission.edit` が一致しないため、同じ宣言済みルートの編集許可も注入します。既存の inline config の他項目は保持します。未宣言のリポジトリは、どの provider でも許可対象になりません。
883
928
 
929
+ `orchestrator night` は `autopilot: approved` の付いた `open` todo・issue だけを夜間 queue として実行します。
930
+
931
+ ```bash
932
+ specdojo orchestrator night --project prj-0001 \
933
+ --max-items 10 --parallel 2 --max-consecutive-failures 2 \
934
+ --on-rate-limit fallback --fallback-executor-by codex-executor
935
+ ```
936
+
937
+ 各 wave は worktree と post-review を必須にし、成功は close、未完了は `waiting` にします。`--max-items` は一晩の件数、`--parallel` は wave の同時数、`--max-consecutive-failures` は次の wave を止める閾値です。`--on-rate-limit fallback` では fallback executor の指定が必須です。失敗を含む朝報告を保存できた場合は部分成功を表す終了コード 2、コマンド自体の異常は 1 を返します。
938
+
884
939
  ## 16. devcontainer
885
940
 
886
941
  `devcontainer` は、利用リポジトリの `.devcontainer/` 環境を構築するためのサブコマンドです。VS Code Dev Container などで、オーケストレーターを起動するための分離されたコンテナ環境を生成します。
@@ -889,34 +944,44 @@ Claude Code、Codex、Antigravity、GitHub Copilot には exec と同じ追加
889
944
  | ----------------------- | ------------------------------------------- |
890
945
  | `devcontainer scaffold` | `.devcontainer/` の設定ファイル群を生成する |
891
946
 
892
- `devcontainer scaffold` は、指定された provider の CLI と、要求された追加機能を組み込んだ `devcontainer.json` と `post-create.sh` を生成します。provider は `antigravity`、`claude`、`codex`、`opencode` を指定できます。`--editor emacs` を指定した場合は Emacs 用の `emacs/init.el` も生成します。Dev Container は任意の実行環境であり、既存の Node.js 環境を置き換える必須手順ではありません。
947
+ `devcontainer scaffold` は、指定された provider の CLI と、要求された追加機能を組み込んだ `devcontainer.json` と `post-create.sh` を生成します。あわせて、常時稼働ホストへの接続と tmux セッション維持のためのサンプルスクリプト(`.devcontainer/remote-host/specdojo-tmux.sh.sample`)と接続元 SSH 設定サンプル(`.devcontainer/remote-host/ssh-config.sample`)も生成します。provider は `antigravity`、`claude`、`codex`、`opencode` を指定できます。`--editor emacs` / `--editor vim` を指定した場合は、それぞれ Emacs 用の `emacs/init.el` / Vim 用の `vim/vimrc` も生成します。Dev Container は任意の実行環境であり、既存の Node.js 環境を置き換える必須手順ではありません。
893
948
 
894
949
  主要オプション:
895
950
 
896
- | オプション | 用途 |
897
- | -------------------- | ----------------------------------------------------------- |
898
- | `--provider <names>` | `claude,codex` のようにカンマ区切りで provider を指定する。 |
899
- | `--editor emacs` | 端末版 Emacs、LSP・検索ツール、初期設定を追加する。 |
900
- | `--ollama` | Ollama への接続設定(環境変数)を追加する。 |
901
- | `--cron` | cron をインストールし、起動時にサービスを開始する。 |
902
- | `--tmux` | tmux をインストールする。 |
903
- | `--force` | `.devcontainer/` が既に存在する場合に上書きする。 |
904
- | `--dry-run` | 実際にファイルを作成せず、作成予定のファイルを表示する。 |
951
+ | オプション | 用途 |
952
+ | ------------------------- | ------------------------------------------------------------ |
953
+ | `--preset recommended` | 推奨のエディタ・tmux・VS Code 拡張と設定をまとめて追加する。 |
954
+ | `--provider <names>` | `claude,codex` のようにカンマ区切りで provider を指定する。 |
955
+ | `--editor <names>` | `emacs,vim` のようにエディタと初期設定を追加する。 |
956
+ | `--ollama` | Ollama への接続設定(環境変数)を追加する。 |
957
+ | `--cron` | cron をインストールし、起動時にサービスを開始する。 |
958
+ | `--tmux` | tmux をインストールする。 |
959
+ | `--workspace-name <name>` | Dev Container 内で使う親ディレクトリ名を上書きする。 |
960
+ | `--force` | `.devcontainer/` が既に存在する場合に上書きする。 |
961
+ | `--dry-run` | 実際にファイルを作成せず、作成予定のファイルを表示する。 |
905
962
 
906
963
  ```bash
907
964
  # claude と codex 用の CLI を含む Dev Container を生成する
908
965
  npx specdojo devcontainer scaffold --provider claude,codex
909
966
 
967
+ # SpecDojo の文書作業向けの推奨設定をまとめて追加する
968
+ npx specdojo devcontainer scaffold --provider claude,codex --preset recommended
969
+
910
970
  # 追加オプションを指定する
911
971
  npx specdojo devcontainer scaffold --provider claude --ollama --tmux
912
972
 
913
973
  # 端末版 Emacs と、すぐ使える組み込み機能だけの設定を追加する
914
974
  npx specdojo devcontainer scaffold --provider claude --editor emacs
975
+
976
+ # ホスト側の親名を変えた後も、コンテナ内の従来パスを保つ
977
+ npx specdojo devcontainer scaffold --workspace-name app1-workspace
915
978
  ```
916
979
 
917
980
  `.devcontainer/` が既に存在する場合は何も書き込まず、置き換える場合だけ `--force` を指定します。上書き前や初回生成前は `--dry-run` で対象ファイルを確認してください。生成設定は provider の設定ディレクトリを名前付きボリュームへ保存してコンテナ再作成後も利用できるようにし、ホストの認証情報・秘密鍵・`.env` を直接マウントしません。認証は生成したコンテナ内で行います。
918
981
 
919
- 生成する `devcontainer.json` は `${localWorkspaceFolder}/..` を `/workspaces/specdojo-workspace` へマウントし、`workspaceFolder` をその中の `${localWorkspaceFolderBasename}` へ向けます。別リポジトリ構成の `repos` と `worktree_base` はプロジェクトリポジトリの外にあるため、親ディレクトリを共有することでプロダクトリポジトリと exec の worktree をコンテナから利用できます。`post-create.sh` はマウントした親ディレクトリ配下の Git リポジトリと worktree を `safe.directory` の対象にします。親ディレクトリ内のその他のファイルもコンテナから見えるため、コンテナへ公開しないファイルは同じ親ディレクトリに置かないでください。
982
+ 生成する `devcontainer.json` は `${localWorkspaceFolder}/..` を、ホスト側の親ディレクトリ名に合わせた `/workspaces/<親名>` へマウントし、`workspaceFolder` をその中の `${localWorkspaceFolderBasename}` へ向けます。例えば `app1-workspace/app1-specdojo` で scaffold すると、作業ディレクトリは `/workspaces/app1-workspace/app1-specdojo` です。別リポジトリ構成の `repos` と `worktree_base` はプロジェクトリポジトリの外にあるため、親ディレクトリを共有することでプロダクトリポジトリと exec の worktree をコンテナから利用できます。`post-create.sh` はマウントした親ディレクトリ配下の Git リポジトリと worktree を `safe.directory` の対象にします。親ディレクトリ内のその他のファイルもコンテナから見えるため、コンテナへ公開しないファイルは同じ親ディレクトリに置かないでください。
983
+
984
+ 親名には英数字・`.`・`_`・`-` だけを使用できます。空白、`/`、制御文字などを含む場合は、意図しないパスへ置換せずエラーにします。必要なら `--workspace-name <name>` で有効な名前を指定してください。`specdojo init --devcontainer` でも同じオプションを指定できます。コンテナ内で作った Git worktree は作成時の絶対パスを記録するため、ホスト側の親ディレクトリ名を変えて `.devcontainer/` を作り直す場合は、`--workspace-name` に以前の名前を指定してコンテナ内のパスを保ってください。
920
985
 
921
986
  `codex` provider を指定した場合だけ、生成する `devcontainer.json` の `runArgs` に `--security-opt=seccomp=unconfined` を追加します。Docker の既定 seccomp profile は Codex 同梱の bubblewrap が sandbox 作成時に使う user namespace の作成を拒否するためです。この設定は devcontainer 全体の syscall filter を無効にしてコンテナの隔離を弱めますが、追加の Linux capability は付与せず、Docker が保護する `/proc` や `/sys` の system path も公開しません。`--security-opt=systempaths=unconfined` は保護範囲をさらに広げるため使用しません。
922
987
 
@@ -946,6 +1011,10 @@ OpenCode の API key は `/home/node/.local/share/opencode/auth.json` に入り
946
1011
 
947
1012
  post-create は `~/.emacs`、`~/.emacs.el`、`~/.emacs.d/init.el`、`~/.config/emacs/init.el` のいずれも無い場合だけ、生成したテンプレートを配置します。`~/.emacs.d` ディレクトリがあれば `~/.emacs.d/init.el` へ、なければ `~/.config/emacs/init.el` へコピーし、配置先を出力します。dotfiles が設定を先に配置した場合は上書きしません。初回のコンテナ作成前に既定値を変える場合は `.devcontainer/emacs/init.el` を編集してください。作成後は出力されたコピー先を編集します。コピー先を削除しない限り、再度 post-create を実行してもテンプレートの変更は反映されません。
948
1013
 
1014
+ `--preset recommended` は、`--editor emacs,vim --tmux` 相当のツールに加え、Git Graph、markdownlint、YAML、Prettier、remark、Markdown All in One、Code Spell Checker、EditorConfig、Error Lens、Even Better TOML の VS Code 拡張を追加します。選択した provider が Claude Code、Codex、GitHub Copilot の場合は、その provider の拡張だけも追加します。Markdown と YAML は保存時に Prettier で整形し、`docs/specdojo/schemas/v1/` の主要な schema を SpecDojo の YAML へ関連付けます。同じ拡張は `.vscode/extensions.json` の `recommendations` にも入り、既存の recommendation は保持されます。個別の `--editor`・`--tmux` と一緒に指定した場合は両方を重複なく適用します。
1015
+
1016
+ Vim の雛形は `.devcontainer/vim/vimrc` に生成され、`~/.vimrc` と `~/.vim/vimrc` のどちらも無い場合だけ `~/.vimrc` へコピーされます。既存の Vim 設定は上書きしません。Emacs の雛形も上記と同じ上書き防止を維持します。
1017
+
949
1018
  ## 17. 関連ガイド
950
1019
 
951
1020
  | 詳細 | 参照先 |