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
@@ -0,0 +1,19 @@
1
+ # 接続元端末の ~/.ssh/config 用設定サンプル
2
+ # <host> や <user> などのプレースホルダーは実際の接続先環境に合わせて変更してください。
3
+
4
+ # 常時稼働ホストへの通常接続用
5
+ Host <host>
6
+ HostName <host>
7
+ User <user>
8
+
9
+ # devcontainer 内の tmux セッションへ直接入る接続用
10
+ # RemoteCommand は非対話シェルで動くため、接続先端末の ~/.zshrc などの PATH 設定は読み込まれません。
11
+ # 接続元から「ssh <host> 'command -v devcontainer'」を実行して Dev Container CLI が見つかるか確認できます。
12
+ # 見つからない場合は、ホスト側の ~/bin/specdojo-tmux.sh の node_bin_dir を設定してください。
13
+ Host <host>-tmux
14
+ HostName <host>
15
+ User <user>
16
+ RequestTTY force
17
+ RemoteCommand ~/bin/specdojo-tmux.sh
18
+ # devcontainer.json の公開ポート(appPort / forwardPorts)に合わせて LocalForward を追加してください。
19
+ # 例: LocalForward 5173 127.0.0.1:5173
@@ -0,0 +1,37 @@
1
+ " SpecDojo Dev Container Vim defaults.
2
+ " This file is copied only when ~/.vimrc and ~/.vim/vimrc do not exist.
3
+
4
+ set encoding=utf-8
5
+ set fileencoding=utf-8
6
+ set number
7
+ set ruler
8
+ set showmatch
9
+ set expandtab
10
+ set shiftwidth=2
11
+ set softtabstop=2
12
+ set tabstop=2
13
+ set smartindent
14
+ set hidden
15
+ set wildmenu
16
+ set ignorecase
17
+ set smartcase
18
+ set incsearch
19
+ set hlsearch
20
+ set mouse=a
21
+ set backspace=indent,eol,start
22
+
23
+ " Keep swap, backup, and undo files outside the worktree.
24
+ if exists('*mkdir')
25
+ call mkdir(expand('~/.local/share/vim/swap'), 'p')
26
+ call mkdir(expand('~/.local/share/vim/backup'), 'p')
27
+ call mkdir(expand('~/.local/share/vim/undo'), 'p')
28
+ endif
29
+ set directory^=~/.local/share/vim/swap//
30
+ set backupdir^=~/.local/share/vim/backup//
31
+ if has('persistent_undo')
32
+ set undofile
33
+ set undodir^=~/.local/share/vim/undo//
34
+ endif
35
+
36
+ filetype plugin indent on
37
+ syntax enable
@@ -1,14 +1,24 @@
1
1
  # yaml-language-server: $schema=../docs/specdojo/schemas/v1/agent-members.schema.yaml
2
2
  # Agent definitions used by `specdojo init --exec`.
3
- # The init command selects only the members whose provider was requested.
3
+ # The init command selects only the members whose provider was requested, and only the
4
+ # aliases whose target member was selected.
5
+ #
6
+ # The roster has two levels (PJR-ZM1K):
7
+ # members : concrete agents named after the model family (sonnet-executor, terra-executor, ...).
8
+ # Each member carries the provider, model, and role. The model version is written
9
+ # only in `model`, so replacing a model touches one place.
10
+ # aliases : the earlier names (claude-executor, codex-executor, ...). Each alias points at a
11
+ # concrete member, so Jobs, routines, documents, and user settings keep working.
12
+ # Events and results record the concrete member name, so the model that actually ran is kept.
4
13
  version: 1
5
14
  members:
6
- - nickname: claude-executor
7
- display_name: Claude Executor
15
+ - nickname: sonnet-executor
16
+ display_name: Claude Sonnet Executor
8
17
  email: null
9
18
  roles: []
10
19
  type: agent
11
20
  provider: claude
21
+ model: sonnet
12
22
  mode: edit
13
23
  stage_role: executor
14
24
  capabilities: [web_search]
@@ -16,12 +26,13 @@ members:
16
26
  priority: 2
17
27
  persona: task-executor
18
28
  scheduler_strategy: critical-first
19
- - nickname: claude-review-executor
20
- display_name: Claude Review Executor
29
+ - nickname: sonnet-review-executor
30
+ display_name: Claude Sonnet Review Executor
21
31
  email: null
22
32
  roles: []
23
33
  type: agent
24
34
  provider: claude
35
+ model: sonnet
25
36
  mode: review
26
37
  stage_role: executor
27
38
  capabilities: [web_search]
@@ -29,12 +40,13 @@ members:
29
40
  priority: 2
30
41
  persona: multi-viewpoint-reviewer
31
42
  scheduler_strategy: fifo
32
- - nickname: claude-reporter
33
- display_name: Claude Reporter
43
+ - nickname: sonnet-reporter
44
+ display_name: Claude Sonnet Reporter
34
45
  email: null
35
46
  roles: []
36
47
  type: agent
37
48
  provider: claude
49
+ model: sonnet
38
50
  mode: report
39
51
  stage_role: reporter
40
52
  capabilities: []
@@ -43,12 +55,13 @@ members:
43
55
  persona: execution-reporter
44
56
  scheduler_strategy: fifo
45
57
 
46
- - nickname: codex-executor
47
- display_name: Codex Executor
58
+ - nickname: terra-executor
59
+ display_name: Codex Terra Executor
48
60
  email: null
49
61
  roles: []
50
62
  type: agent
51
63
  provider: codex
64
+ model: gpt-5.6-terra
52
65
  mode: edit
53
66
  stage_role: executor
54
67
  capabilities: [web_search]
@@ -56,12 +69,13 @@ members:
56
69
  priority: 1
57
70
  persona: task-executor
58
71
  scheduler_strategy: critical-first
59
- - nickname: codex-review-executor
60
- display_name: Codex Review Executor
72
+ - nickname: terra-review-executor
73
+ display_name: Codex Terra Review Executor
61
74
  email: null
62
75
  roles: []
63
76
  type: agent
64
77
  provider: codex
78
+ model: gpt-5.6-terra
65
79
  mode: review
66
80
  stage_role: executor
67
81
  capabilities: [web_search]
@@ -69,12 +83,13 @@ members:
69
83
  priority: 1
70
84
  persona: multi-viewpoint-reviewer
71
85
  scheduler_strategy: fifo
72
- - nickname: codex-reporter
73
- display_name: Codex Reporter
86
+ - nickname: terra-reporter
87
+ display_name: Codex Terra Reporter
74
88
  email: null
75
89
  roles: []
76
90
  type: agent
77
91
  provider: codex
92
+ model: gpt-5.6-terra
78
93
  stage_role: reporter
79
94
  capabilities: []
80
95
  proficiency: normal
@@ -82,12 +97,13 @@ members:
82
97
  persona: execution-reporter
83
98
  scheduler_strategy: fifo
84
99
 
85
- - nickname: opencode-executor
86
- display_name: OpenCode Executor
100
+ - nickname: gemma-executor
101
+ display_name: OpenCode Gemma Executor
87
102
  email: null
88
103
  roles: []
89
104
  type: agent
90
105
  provider: opencode
106
+ model: ollama-local/gemma4:31b-mlx-work-64k
91
107
  mode: edit
92
108
  stage_role: executor
93
109
  capabilities: [web_search]
@@ -95,12 +111,13 @@ members:
95
111
  priority: 3
96
112
  persona: task-executor
97
113
  scheduler_strategy: critical-first
98
- - nickname: opencode-review-executor
99
- display_name: OpenCode Review Executor
114
+ - nickname: gemma-review-executor
115
+ display_name: OpenCode Gemma Review Executor
100
116
  email: null
101
117
  roles: []
102
118
  type: agent
103
119
  provider: opencode
120
+ model: ollama-local/gemma4:31b-mlx-work-64k
104
121
  mode: review
105
122
  stage_role: executor
106
123
  capabilities: [web_search]
@@ -108,12 +125,14 @@ members:
108
125
  priority: 3
109
126
  persona: multi-viewpoint-reviewer
110
127
  scheduler_strategy: fifo
111
- - nickname: opencode-reporter
112
- display_name: OpenCode Reporter
128
+ - nickname: gemma-reporter
129
+ display_name: OpenCode Gemma Reporter
113
130
  email: null
114
131
  roles: []
115
132
  type: agent
116
133
  provider: opencode
134
+ model: ollama-local/gemma4:31b-mlx-work-64k
135
+ mode: report
117
136
  stage_role: reporter
118
137
  capabilities: []
119
138
  proficiency: normal
@@ -121,12 +140,13 @@ members:
121
140
  persona: execution-reporter
122
141
  scheduler_strategy: fifo
123
142
 
124
- - nickname: agy-executor
125
- display_name: Antigravity Executor
143
+ - nickname: flash-executor
144
+ display_name: Antigravity Flash Executor
126
145
  email: null
127
146
  roles: []
128
147
  type: agent
129
148
  provider: antigravity
149
+ model: gemini-3.8-flash-high
130
150
  mode: edit
131
151
  stage_role: executor
132
152
  capabilities: [web_search]
@@ -134,12 +154,13 @@ members:
134
154
  priority: 4
135
155
  persona: task-executor
136
156
  scheduler_strategy: critical-first
137
- - nickname: agy-review-executor
138
- display_name: Antigravity Review Executor
157
+ - nickname: flash-review-executor
158
+ display_name: Antigravity Flash Review Executor
139
159
  email: null
140
160
  roles: []
141
161
  type: agent
142
162
  provider: antigravity
163
+ model: gemini-3.8-flash-high
143
164
  mode: review
144
165
  stage_role: executor
145
166
  capabilities: [web_search]
@@ -147,12 +168,13 @@ members:
147
168
  priority: 4
148
169
  persona: multi-viewpoint-reviewer
149
170
  scheduler_strategy: fifo
150
- - nickname: agy-reporter
151
- display_name: Antigravity Reporter
171
+ - nickname: flash-reporter
172
+ display_name: Antigravity Flash Reporter
152
173
  email: null
153
174
  roles: []
154
175
  type: agent
155
176
  provider: antigravity
177
+ model: gemini-3.8-flash-high
156
178
  stage_role: reporter
157
179
  capabilities: []
158
180
  proficiency: normal
@@ -160,6 +182,8 @@ members:
160
182
  persona: execution-reporter
161
183
  scheduler_strategy: fifo
162
184
 
185
+ # Copilot selects its model automatically (--model auto), so its members have no model
186
+ # family to name. They stay as concrete members under the earlier names and need no alias.
163
187
  - nickname: copilot-executor
164
188
  display_name: Copilot Executor
165
189
  email: null
@@ -198,3 +222,29 @@ members:
198
222
  priority: 5
199
223
  persona: execution-reporter
200
224
  scheduler_strategy: fifo
225
+
226
+ aliases:
227
+ - nickname: claude-executor
228
+ alias_of: sonnet-executor
229
+ - nickname: claude-review-executor
230
+ alias_of: sonnet-review-executor
231
+ - nickname: claude-reporter
232
+ alias_of: sonnet-reporter
233
+ - nickname: codex-executor
234
+ alias_of: terra-executor
235
+ - nickname: codex-review-executor
236
+ alias_of: terra-review-executor
237
+ - nickname: codex-reporter
238
+ alias_of: terra-reporter
239
+ - nickname: opencode-executor
240
+ alias_of: gemma-executor
241
+ - nickname: opencode-review-executor
242
+ alias_of: gemma-review-executor
243
+ - nickname: opencode-reporter
244
+ alias_of: gemma-reporter
245
+ - nickname: agy-executor
246
+ alias_of: flash-executor
247
+ - nickname: agy-review-executor
248
+ alias_of: flash-review-executor
249
+ - nickname: agy-reporter
250
+ alias_of: flash-reporter
@@ -12,12 +12,33 @@ pipeline:
12
12
  - test-unit
13
13
  run:
14
14
  register_execution: worktree
15
+ # Opt in after the team is ready for review-agent verdicts to close todo/issue items.
16
+ register_post_review: false
17
+ # `specdojo init --exec` replaces these generic names with members from the selected providers.
18
+ # Explicit `exec run --register` stage/recovery options override the matching difficulty route.
19
+ routing:
20
+ hard:
21
+ executor_by: primary-executor
22
+ reporter_by: primary-reporter
23
+ on_rate_limit: wait
24
+ medium:
25
+ executor_by: primary-executor
26
+ reporter_by: primary-reporter
27
+ on_rate_limit: stop
28
+ easy:
29
+ executor_by: primary-executor
30
+ reporter_by: primary-reporter
31
+ on_rate_limit: stop
15
32
  rate_limit_detection:
16
33
  exit_codes: []
17
34
  stderr_patterns: [rate limit, "429"]
18
35
  rate_limit_policy:
19
36
  cooldown_seconds:
20
37
  rate_limit: 900
38
+ # Agent を nickname で指名した実行の既定。CLI の --on-rate-limit が優先する。
39
+ pinned:
40
+ action: stop
41
+ max_wait_seconds: 28800
21
42
  on_non_critical:
22
43
  action: skip
23
44
  on_critical:
@@ -28,9 +49,17 @@ rate_limit_policy:
28
49
  backoff_multiplier: 3
29
50
  max_wait_seconds: 600
30
51
  on_exhausted: block
52
+ # command_template expands member attributes. {model} is the concrete member's model, and
53
+ # {nickname} is the concrete member's name even when an alias was requested (PJR-ZM1K).
54
+ # The claude and opencode role definitions are one file per role, selected by mode.
31
55
  providers:
32
56
  claude:
33
- command_template: "claude -p --verbose --agent {nickname} --settings .specdojo/claude/settings.{mode}.json"
57
+ command_template: "claude -p --verbose --agent {agent} --model {model} --settings .specdojo/claude/settings.{mode}.json"
58
+ command_params:
59
+ by_mode:
60
+ edit: { agent: claude-executor }
61
+ review: { agent: claude-review-executor }
62
+ report: { agent: claude-reporter }
34
63
  rate_limit_detection:
35
64
  stderr_patterns: [rate limit, "429", overloaded, session limit]
36
65
  codex:
@@ -38,26 +67,32 @@ providers:
38
67
  codex exec --ephemeral --sandbox workspace-write -c approval_policy="never"
39
68
  -c sandbox_workspace_write.network_access=false --model {model}
40
69
  -c model_reasoning_effort="{effort}"
70
+ # The model comes from the concrete member. The reasoning effort follows proficiency.
41
71
  command_params:
42
72
  by_proficiency:
43
- normal: { model: gpt-5.6-terra, effort: medium }
44
- expert: { model: gpt-5.6-sol, effort: high }
73
+ normal: { effort: medium }
74
+ expert: { effort: high }
45
75
  rate_limit_detection:
46
76
  stderr_patterns: [rate limit, "429", session limit, weekly limit, usage limit]
47
77
  opencode:
48
- command_template: "opencode run --agent {nickname}"
78
+ # The model ID depends on the provider name in opencode.json. Adjust the members' model.
79
+ command_template: "opencode run --agent {agent} --model {model}"
80
+ command_params:
81
+ by_mode:
82
+ edit: { agent: opencode-executor }
83
+ review: { agent: opencode-review-executor }
84
+ report: { agent: opencode-reporter }
49
85
  max_concurrency: 1
50
86
  rate_limit_detection:
51
87
  exit_codes: []
52
- stderr_patterns: [timeout, connection refused, out of memory, model is loading]
88
+ stderr_patterns: [timeout, out of memory, model is loading]
89
+ connection_error_detection:
90
+ stderr_patterns: [Cannot connect to API, ECONNREFUSED, connection refused]
53
91
  antigravity:
54
92
  # 使える model の ID は `agy models` で確かめる。Gemini の Pro 系は提供されなくなったため、
55
93
  # expert は Flash の high とする(2026-10-15、agy 1.3.5 で確認)。
94
+ # model の ID は実体の member の model に書く(PJR-ZM1K)。
56
95
  command_template: 'agy --sandbox --add-dir "$(pwd)" --model {model} -p "$(cat)"'
57
- command_params:
58
- by_proficiency:
59
- normal: { model: gemini-3.8-flash-medium }
60
- expert: { model: gemini-3.8-flash-high }
61
96
  rate_limit_detection:
62
97
  stderr_patterns: [rate limit, "429", quota, RESOURCE_EXHAUSTED]
63
98
  copilot:
@@ -29,13 +29,27 @@ specdojo exec scaffold --provider opencode
29
29
 
30
30
  コピー後に次を行います。
31
31
 
32
- 1. `.specdojo/exec-defaults.yaml` の `providers.opencode.command_template` に `opencode run --agent {nickname}` を指定する(member の nickname と agent 定義のファイル名を一致させる)。member 側に `command` は書かない。
33
- 2. モデル接続設定(`opencode.json` の provider / model)を利用環境に合わせて作成する。ローカル Ollama の接続先などマシン固有の値を含むため、このテンプレートには含めていない。
34
- 3. コピーしたファイルをコミットする。worktree はコミット済み内容から作られるため、未コミットだと agent 実行時に設定が読めない。
32
+ 1. `.specdojo/exec-defaults.yaml` の `providers.opencode.command_template` に `opencode run --agent {agent} --model {model}` を指定し、`command_params.by_mode` で mode から役割の定義を選ぶ。agent の定義は役割ごとの 1 ファイルで model を持たず、model は実体の member の `model` を `--model` で渡す。member 側に `command` は書かない。
33
+
34
+ ```yaml
35
+ providers:
36
+ opencode:
37
+ command_template: "opencode run --agent {agent} --model {model}"
38
+ command_params:
39
+ by_mode:
40
+ edit: { agent: opencode-executor }
41
+ review: { agent: opencode-review-executor }
42
+ report: { agent: opencode-reporter }
43
+ ```
44
+
45
+ 2. `.specdojo/agent-members.yaml` を実体と別名の 2 段で書く。実体は model の系統で名付け(`gemma-executor`・`qwen-executor` など)、`model` に `opencode.json` の provider 名を含む ID(`ollama-local/gemma4:31b-mlx-work-64k` など)を持つ。従来の名前(`opencode-executor` など)は `aliases` で実体を指す別名にする。
46
+ 3. モデル接続設定(`opencode.json` の provider / model)を利用環境に合わせて作成する。ローカル Ollama の接続先などマシン固有の値を含むため、このテンプレートには含めていない。
47
+ 4. コピーしたファイルをコミットする。worktree はコミット済み内容から作られるため、未コミットだと agent 実行時に設定が読めない。
35
48
 
36
49
  ## 4. カスタマイズ
37
50
 
38
51
  - edit agent の `permission.edit` は既定で `docs/**`、`src/**`、`tests/**` を許可する。`permission.edit` / `permission.bash` のパターンは、利用プロジェクトの成果物・execution ディレクトリ配置に合わせて調整する。
52
+ - 従来の `opencode run --agent {nickname}` と model を持つ定義ファイルで組んだ 1 段の名簿は、そのまま動く。scaffold は既存ファイルを上書きしないため、`--force` で役割ごとの定義(model を持たない)に置き換える場合だけ、上の `command_template` と 2 段の名簿へ移す。
39
53
  - executor の result パス deny と reporter の全ツール deny は、pipeline の責務境界なので維持する。
40
54
  - `bash` は deny 基点の許可リストを維持する。`git add` / `git commit` を許可しないこと(許可すると specdojo CLI の commit 許可リストを迂回できる)。
41
55
  - 権限設計の背景は `exec-config-guide.md` の `agent 権限とプロンプトインジェクション対策` を参照する。
@@ -1,7 +1,6 @@
1
1
  ---
2
2
  description: SpecDojo pipeline の executor。成果物の編集と検証だけを行い、result は更新しない。
3
3
  mode: primary
4
- model: ollama-local/gemma4:31b-mlx-work-64k
5
4
  temperature: 0.2
6
5
  permission:
7
6
  read:
@@ -1,7 +1,6 @@
1
1
  ---
2
2
  description: SpecDojo pipeline の reporter。渡された evidence だけから指定スキーマの構造化結果を返す。
3
3
  mode: primary
4
- model: ollama-local/gemma4:31b-mlx-work-64k
5
4
  temperature: 0.1
6
5
  permission:
7
6
  read: deny
@@ -24,3 +23,5 @@ permission:
24
23
  応答は runner が指定した構造化出力スキーマに厳密に一致するデータだけとし、Markdown の説明、コードフェンス、スキーマ外フィールドを加えないでください。evidence にない事実を補完・推測せず、必須フィールドを根拠をもって埋められない場合は、指定スキーマの block / error 表現を使用します。出力スキーマまたは必要な evidence が提示されていない場合も成功結果を捏造しません。
25
24
 
26
25
  runner が Markdown として描画する自由記述フィールドでは、`depends_on` のように `_` を含む識別子・フィールド名を必ずインラインコードで囲んでください。
26
+
27
+ edit mode では、`evidence.changes` の変更ファイルについて、成果物(`docs/`)、ソースコード(`src/`)、テストコード(`tests/`)など変更された各ファイルで何を変更したかの説明を `changed_files` に返してください。
@@ -1,7 +1,6 @@
1
1
  ---
2
2
  description: SpecDojo pipeline の executor(review)。成果物を多観点でレビューするだけで、成果物・result のいずれにも書き込まない。
3
3
  mode: primary
4
- model: ollama-local/gemma4:31b-mlx-work-64k
5
4
  temperature: 0.1
6
5
  permission:
7
6
  read:
@@ -54,7 +54,7 @@ CLI は利用リポジトリへローカル導入されるため、`npx specdojo
54
54
  ## 基本方針
55
55
 
56
56
  - 回答は原則として日本語で行う。
57
- - コマンドは「提案 → 承認 → 実行」の順で扱う。状態やファイルを変える操作は、実行するコマンドを提示して利用者の承認を得てから実行する。読み取り・状況確認のみのコマンド(`--help`、`list`、`status`、`where`、`validate`、`--dry-run`)は説明の上で実行してよい。
57
+ - 操作は「提案 → 承認 → 実行」の順で扱う。状態やファイルを変える操作は、「承認の聞き方」に従って何をするかを日本語で示し、利用者の承認を得てから実行する。読み取り・状況確認のみのコマンド(`--help`、`list`、`status`、`where`、`validate`、`--dry-run`)は説明の上で実行してよい。
58
58
  - 破壊的変更や `git push` は行わない。
59
59
  - `git commit` は次の方針で行う。実行前に必ず現在のブランチを確認して提示し、`main` では commit しない(対象ブランチを提案して止まる)。
60
60
  - register の状態遷移や worktree の統合など、runner 相当の記帳は承認なしに commit してよい。register の記帳は `--commit` で commit する。
@@ -66,6 +66,7 @@ CLI は利用リポジトリへローカル導入されるため、`npx specdojo
66
66
  - exec に流す予定の `todo` は、実行前に対象 project の `develop` へ入れておく。worktree は commit から作られるため、feature ブランチにしかない個票は実行できない。
67
67
  - commit メッセージは subject を日本語で書き、conventional commit の type と scope を保つ。本文には「なぜ」を日本語で書き、関連する登録簿項目があれば `Refs: <project-id>:<PJR-XXXX>`(例: `Refs: prj-0001:PJR-36QG`)を記載する。項目ごとに 1 行とし、過去の commit の書式は書き換えない。
68
68
  - 登録簿項目の実行は既定で `exec run --register` を使う。自分で実装するのは、利用者が実装者として自分を指定した場合に限る。「着手してください」は実行経路の指示であり、自分が実装してよい根拠として扱わない。実装者が読み取れない場合は確認する。
69
+ - 状態遷移の `--by` には、実際にその判断や作業をした主体を書く。利用者が決定・承認した記録は、役割の名前(`PO` など)ではなく人の名簿の nickname で残す。自分が確かめて close する記録や、自分で行った起票・記帳は `specdojo-orchestrator` で残す。`--by` は人と agent の名簿の nickname・alias と予約名(`SpecDojo`・`specdojo-orchestrator`・`night-orchestrator`)だけを受け付け、それ以外は記帳の前にエラーで止まる。
69
70
  - 自分が直接対応した項目は `start` を経ずに `close` してよい。実行していない主体を actor とする遷移を、記録の体裁を揃える目的で追加しない。終端イベントの `reason` に対応経路を記録し、実施内容と検証結果は個票の対応結果へ残す。
70
71
  - `specdojo.config.json` の project に `repos` で宣言されたプロダクトリポジトリは参照してよい。変更は利用者が自分を実装者に指定した場合に限り、そのリポジトリで `feature/<project-id>/<topic>` を切って commit する。`git push` は行わない。宣言していないリポジトリは参照も変更もしない。
71
72
  - 認証情報・秘密鍵・`.env`・`secrets/` を読み込まない。
@@ -76,10 +77,20 @@ CLI は利用リポジトリへローカル導入されるため、`npx specdojo
76
77
 
77
78
  1. 利用者の要望から「対象プロジェクト」「やりたいこと(登録・計画・実行・状況確認)」を特定する。曖昧なら質問して絞り込む。
78
79
  2. 対応する `specdojo` サブコマンドと引数へマッピングする。必要なら該当コマンドの `--help` を先に確認する。
79
- 3. 実行予定のコマンドを、目的・影響範囲(生成/更新されるファイル)とともに提示する。
80
+ 3. 何をするか・中身・影響(生成・更新されるファイルと commit の先)を、「承認の聞き方」に従って日本語で示す。
80
81
  4. 状態を変える操作は承認を得てから実行する。多くのコマンドは `--dry-run` を持つため、影響が大きい場合はまず `--dry-run` を提案する。
81
82
  5. 実行後は結果(生成物・イベント・次にやるべきこと)を要約し、必要なら検証コマンド(`npx specdojo exec validate`、`npm run lint:md` など)を案内・実行する。
82
83
 
84
+ ## 承認の聞き方
85
+
86
+ 状態やファイルを変える操作の承認を求めるときは、コマンドではなく、次の順で日本語で示して「よろしいですか?」と聞く。コマンドは既定では見せず、利用者が求めたときや、うまく動かなかったときの説明に使う。
87
+
88
+ 1. 何をするか(例: 「todo を起票します」「この項目を close します」)を 1 文で。
89
+ 2. 中身。起票なら種類・タイトル・優先度・担当・期限・説明の要点、close なら結論と確かめたこと、実行なら対象と使う agent。
90
+ 3. 影響。変わるファイルと commit の先(例: 「develop に記帳を 1 件 commit します」)。
91
+
92
+ 選択肢がある場合は、案ごとの利点と欠点を表にし、推奨とその理由を添える。CLI のツールが出す「このコマンドを実行してよいか」という権限の確認は、ツール側の仕組みでこの聞き方とは別である。
93
+
83
94
  ## specdojo コマンド地図
84
95
 
85
96
  | 目的 | サブコマンド | 代表操作 |
@@ -187,6 +198,54 @@ npx specdojo exec validate --project <project-id>
187
198
 
188
199
  失敗して `waiting` になった場合は、個票の `block_reason` と result の申し送りを読み、原因を特定してから再開する。reporter 段だけの再開は `--resume` で行う。
189
200
 
201
+ ## 実行の運び方
202
+
203
+ - `exec run --register` は `--worktree` で流す。同時に流すのは 2〜3 件までとする。親の検証は 1 件ずつ順に流れ、並行が多いと負荷で統合テストが時間切れになる。
204
+ - 時間のかかる run は background で流し、終わりの通知を待つ。途中経過を何度も見に行かない。
205
+ - プロセスを探す・止めるときに `pkill -f`・`pgrep -f` を使わない。探す文字列を含む自分のシェルにも一致し、自分を止める。
206
+ - 統合の後に `src` が dist より新しくなると、次の run は始まる前に止まる。dist を作り直してから流す。
207
+ - 記帳は `register ... --commit` で行う。登録簿の lifecycle のロックを取るため、実行中の run と取り合わない。
208
+ - 個票の本文を書き換えて普通に commit するのは、統合中の run がないときだけにする(`.git/index.lock` を確かめる)。commit に失敗したら、index に載ったファイルを残さない。残ると次の run の checkpoint が止まる。
209
+ - 保護された設定(agent の定義・名簿・`exec-defaults.yaml`・`package.json` など)は、executor が書き換えると統合の前に止まる。完了条件で「案を result に書く」と指示し、反映は利用者の承認のもと feature ブランチで行う。
210
+ - プロジェクトの文書にオーケストレーター向けの運用メモがあれば、作業を始める前に読む。
211
+
212
+ ## close の前の確かめ方
213
+
214
+ - 完了条件を 1 項目ずつ、差分(`git show`)と result に照らして確かめる。親の検証が通っただけで close しない。
215
+ - agent の「直した」「反映済み」という報告は、実物(ファイルの中身、生成物、コマンドの出力)で確かめる。agent は、権限で編集を拒まれたあとでも完了と報告することがある。
216
+ - 完了条件にない変更(特に保護された設定や、利用者の環境に関わる設定)が入っていないかを確かめる。
217
+ - runner や CLI の動きを変えた項目は、統合の後に実際の `exec run --register` を 1 回流して動作を確かめてから close する。生成物を変えた項目は、空のリポジトリで生成して確かめる。
218
+ - 確かめられない条件(ホストでの確認など)が残る場合は close せず `review` のまま残し、利用者に確かめ方を示す。
219
+ - 見つけた別の問題は、元の項目を `--from` で記録して起票する。完了条件の範囲を勝手に広げない。
220
+
221
+ ## 止まったときの対処
222
+
223
+ | 止まった理由 | 対処 |
224
+ | ---------------------------------------------- | -------------------------------------------------------------------------------------------------------------------- |
225
+ | agent の rate limit・つながらない | `--fallback-executor-by` / `--fallback-reporter-by` で代わりの agent を指定して再開する。解除の時刻が分かれば待つ |
226
+ | 親の検証の失敗(型・lint・テストの本当の失敗) | `--resume --resume-from executor` で executor からやり直す。失敗した検証の結果が引き継がれる |
227
+ | 負荷による時間切れ | 負荷を下げてから `--resume` で親の検証を流し直す |
228
+ | 統合での衝突(CHANGELOG の同じ節など) | 両方の行を残す形に exec ブランチ側をそろえてから `--resume` する。記帳のファイルの衝突は runner に任せ、手で解かない |
229
+ | 保護された設定への変更 | worktree でその変更だけを戻して `--resume` するか、`exec handoff apply` で利用者の承認のもと当てる |
230
+ | commit の hook の失敗 | 失敗した段(markdownlint など)の出力を読み、記録のファイルを規約に合わせてから commit する |
231
+ | 既に統合済みで再開できない | 新しい run として `--force-restart` で流す |
232
+
233
+ ## 完了条件の書き方
234
+
235
+ - 検証できる形で書く。完了条件は `exec plan` の入力になり、曖昧だと agent が意図と違う範囲を実装する。
236
+ - 作業を終える前に流す検査(型検査・lint・単体テスト)と、通すべき親の検証を書く。
237
+ - CHANGELOG は未公開の版の節に書き、公開済みの版の節を変えないと書く。
238
+ - 保護された設定に触れる場合は、案を result に書き、反映は利用者が行うと書く。
239
+ - 未決の点は `_UNDECIDED_` で残すか、executor に決めさせて理由を result に書かせるかを明記する。
240
+ - Markdown では、`*` や `_` を含む語(glob など)をコードの書式にする。コードの書式の中を空白で始めたり終えたりしない。
241
+
242
+ ## agent の選び方
243
+
244
+ - 具体的な agent の名前は、プロジェクトの設定に従う。`exec-defaults.yaml` に難しさごとの振り分けの設定があれば、個票の `difficulty`(`hard`・`medium`・`easy`)に合わせてそれを使う。
245
+ - 振り分けの設定がなければ、難しい作業(設計の判断を伴う変更、runner のコード)は expert の executor、範囲がはっきりした中程度の作業は normal の executor を選ぶ。
246
+ - 小さなローカル LLM は、編集できる範囲が限られることがあり、確かめずに完了と報告しがちである。plan で直し方が決まった小さな作業に限り、結果は必ず実物で確かめる。
247
+ - rate limit の解除まで長くかかる agent(割り当てが日単位のものなど)は、待たずに代わりの agent を指定する。
248
+
190
249
  ## プロジェクトの解決順序
191
250
 
192
251
  対象 project は次の順で解決される。通常は `current_project` を使う。会話で対象が特定できない場合は利用者に確認する。