specdojo 0.2.0 → 0.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (170) hide show
  1. package/.github/agents/specdojo-orchestrator.md +165 -0
  2. package/CHANGELOG.md +280 -0
  3. package/README.md +143 -30
  4. package/dist/agent-response.js +20 -0
  5. package/dist/agent.js +4 -4
  6. package/dist/build-command.js +28 -8
  7. package/dist/dashboard.js +140 -9
  8. package/dist/devcontainer-command.js +43 -0
  9. package/dist/devcontainer-scaffold.js +165 -0
  10. package/dist/exec-agent-config.js +107 -9
  11. package/dist/exec-agent-git-state.js +18 -0
  12. package/dist/exec-agent-protected-config.js +46 -8
  13. package/dist/exec-evidence.js +254 -11
  14. package/dist/exec-format.js +13 -4
  15. package/dist/exec-handoff.js +336 -0
  16. package/dist/exec-parent-validation.js +317 -43
  17. package/dist/exec-pipeline-state.js +74 -9
  18. package/dist/exec-plans.js +115 -113
  19. package/dist/exec-protection-handoff.js +43 -2
  20. package/dist/exec-provider-scaffold.js +247 -15
  21. package/dist/exec-register-resume.js +65 -19
  22. package/dist/exec-register.js +9 -3
  23. package/dist/exec-repo-integration.js +811 -0
  24. package/dist/exec-repo-trace.js +182 -0
  25. package/dist/exec-reporter.js +613 -132
  26. package/dist/exec-results.js +81 -56
  27. package/dist/exec-run-lock.js +110 -107
  28. package/dist/exec-run.js +1585 -356
  29. package/dist/exec-shared.js +7 -0
  30. package/dist/exec-slot-lock.js +242 -0
  31. package/dist/exec-task-repos.js +415 -0
  32. package/dist/exec-trial.js +51 -25
  33. package/dist/exec-worktree-command.js +87 -43
  34. package/dist/exec-worktree-ops.js +502 -57
  35. package/dist/exec-worktree.js +114 -27
  36. package/dist/exec.js +13 -6
  37. package/dist/grade-result.js +128 -0
  38. package/dist/grade.js +809 -72
  39. package/dist/init-command.js +443 -0
  40. package/dist/job.js +160 -10
  41. package/dist/orchestrator.js +213 -0
  42. package/dist/package-paths.js +19 -1
  43. package/dist/register-event-merge.js +169 -0
  44. package/dist/register-item.js +7 -1
  45. package/dist/register.js +294 -86
  46. package/dist/review-grade.js +252 -0
  47. package/dist/review-plan.js +111 -1
  48. package/dist/review-types.js +40 -1
  49. package/dist/routine.js +72 -5
  50. package/dist/schedule-build.js +2 -2
  51. package/dist/schedule.js +17 -4
  52. package/dist/specdojo-config.js +466 -20
  53. package/dist/specdojo-gitignore.js +135 -0
  54. package/dist/specdojo.js +8 -1
  55. package/dist/viewpoint-document-kinds-check.js +128 -0
  56. package/docs/ja/specdojo/defaults/pm-review-viewpoints.yaml +348 -90
  57. package/docs/ja/specdojo/exec-templates/xep-common-conventions-template.md +51 -17
  58. package/docs/ja/specdojo/exec-templates/xep-fully-guided-template.md +7 -5
  59. package/docs/ja/specdojo/exec-templates/xrp-freeform-template.md +29 -31
  60. package/docs/ja/specdojo/exec-templates/xrp-fully-guided-template.md +34 -55
  61. package/docs/ja/specdojo/exec-templates/xrp-job-template.md +54 -0
  62. package/docs/ja/specdojo/exec-templates/xrp-recipe-guided-template.md +28 -37
  63. package/docs/ja/specdojo/exec-templates/xrp-recipe-maintenance-template.md +29 -34
  64. package/docs/ja/specdojo/exec-templates/xrp-retrofit-template.md +30 -30
  65. package/docs/ja/specdojo/exec-templates/xrp-rulebook-maintenance-template.md +29 -34
  66. package/docs/ja/specdojo/exec-templates/xrp-sample-maintenance-template.md +29 -34
  67. package/docs/ja/specdojo/exec-templates/xrp-template-maintenance-template.md +29 -34
  68. package/docs/ja/specdojo/exec-templates/xrp-template.md +29 -28
  69. package/docs/ja/specdojo/exec-templates/xrr-template.md +11 -9
  70. package/docs/ja/specdojo/guides/docs-editing-guide.md +20 -0
  71. package/docs/ja/specdojo/guides/docs-structure-guide.md +103 -70
  72. package/docs/ja/specdojo/guides/exec-config-guide.md +91 -47
  73. package/docs/ja/specdojo/guides/exec-operation-guide.md +124 -27
  74. package/docs/ja/specdojo/guides/exec-worktree-guide.md +40 -11
  75. package/docs/ja/specdojo/guides/kata-guide.md +4 -4
  76. package/docs/ja/specdojo/guides/orchestrator-operation-guide.md +25 -4
  77. package/docs/ja/specdojo/guides/plan-result-lifecycle-guide.md +1 -1
  78. package/docs/ja/specdojo/guides/practice-system-composition-guide.md +13 -13
  79. package/docs/ja/specdojo/guides/quick-start-guide.md +261 -32
  80. package/docs/ja/specdojo/guides/register-operation-guide.md +31 -14
  81. package/docs/ja/specdojo/guides/release-v0-3-0-migration-guide.md +264 -0
  82. package/docs/ja/specdojo/guides/remote-host-development-guide.md +184 -0
  83. package/docs/ja/specdojo/guides/review-guide.md +195 -158
  84. package/docs/ja/specdojo/guides/routine-operation-guide.md +74 -9
  85. package/docs/ja/specdojo/guides/ryu-guide.md +32 -30
  86. package/docs/ja/specdojo/guides/schedule-design-guide.md +10 -10
  87. package/docs/ja/specdojo/guides/schedule-operation-guide.md +1 -1
  88. package/docs/ja/specdojo/guides/specdojo-overview-guide.md +58 -33
  89. package/docs/ja/specdojo/guides/use-case-guide.md +3 -3
  90. package/docs/ja/specdojo/guides/waza-guide.md +15 -2
  91. package/docs/ja/specdojo/index.md +2 -2
  92. package/docs/ja/specdojo/philosophy/specdojo-philosophy.md +5 -5
  93. package/docs/ja/specdojo/recipes/bps-recipe.md +213 -0
  94. package/docs/ja/specdojo/recipes/pm-members-recipe.md +52 -117
  95. package/docs/ja/specdojo/references/command-reference.md +336 -93
  96. package/docs/ja/specdojo/references/deliverables-reference.md +1 -1
  97. package/docs/ja/specdojo/references/directory-layout-reference.md +13 -9
  98. package/docs/ja/specdojo/references/specdojo-config-reference.md +107 -24
  99. package/docs/ja/specdojo/rulebooks/bps-rulebook.md +132 -220
  100. package/docs/ja/specdojo/rulebooks/br-rulebook.md +6 -44
  101. package/docs/ja/specdojo/rulebooks/cdfd-rulebook.md +2 -0
  102. package/docs/ja/specdojo/rulebooks/dmd-rulebook.md +0 -87
  103. package/docs/ja/specdojo/rulebooks/gl-rulebook.md +61 -39
  104. package/docs/ja/specdojo/rulebooks/ifx-cmd-rulebook.md +0 -87
  105. package/docs/ja/specdojo/rulebooks/ifx-index-rulebook.md +1 -33
  106. package/docs/ja/specdojo/rulebooks/opd-rulebook.md +0 -137
  107. package/docs/ja/specdojo/rulebooks/opr-rulebook.md +0 -247
  108. package/docs/ja/specdojo/rulebooks/otp-rulebook.md +0 -83
  109. package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +4 -2
  110. package/docs/ja/specdojo/rulebooks/pm-members-rulebook.md +78 -150
  111. package/docs/ja/specdojo/rulebooks/pm-roles-rulebook.md +5 -4
  112. package/docs/ja/specdojo/rulebooks/sch-rulebook.md +1 -1
  113. package/docs/ja/specdojo/rulebooks/stsd-mermaid-rulebook.md +0 -11
  114. package/docs/ja/specdojo/rulebooks/stsd-rulebook.md +0 -61
  115. package/docs/ja/specdojo/rulebooks/tml-rulebook.md +2 -47
  116. package/docs/ja/specdojo/samples/bps-sample.md +74 -21
  117. package/docs/ja/specdojo/samples/gl-sample.yaml +17 -1
  118. package/docs/ja/specdojo/samples/ifx-index-sample.yaml +28 -0
  119. package/docs/ja/specdojo/samples/pm-members-sample.yaml +2 -67
  120. package/docs/ja/specdojo/samples/pm-organization-sample.md +8 -7
  121. package/docs/ja/specdojo/samples/pm-raci-sample.md +1 -1
  122. package/docs/ja/specdojo/samples/tml-sample.yaml +40 -0
  123. package/docs/ja/specdojo/standards/document-metadata-standard.md +21 -16
  124. package/docs/ja/specdojo/standards/id-and-file-naming-standard.md +14 -14
  125. package/docs/ja/specdojo/standards/job-definition-standard.md +37 -17
  126. package/docs/ja/specdojo/standards/people-and-organization-definition-standard.md +37 -32
  127. package/docs/ja/specdojo/standards/philosophy-authoring-standard.md +1 -1
  128. package/docs/ja/specdojo/standards/rulebook-authoring-standard.md +21 -11
  129. package/docs/ja/specdojo/templates/agent-members-template.yaml +25 -0
  130. package/docs/ja/specdojo/templates/bps-template.md +91 -0
  131. package/docs/ja/specdojo/templates/pm-members-template.yaml +2 -59
  132. package/docs/specdojo/schemas/v1/agent-members.schema.yaml +76 -0
  133. package/docs/specdojo/schemas/v1/exec-common.schema.yaml +4 -2
  134. package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +55 -2
  135. package/docs/specdojo/schemas/v1/exec-evidence.schema.yaml +93 -6
  136. package/docs/specdojo/schemas/v1/exec-reporter-output.schema.yaml +27 -78
  137. package/docs/specdojo/schemas/v1/gl.schema.yaml +87 -0
  138. package/docs/specdojo/schemas/v1/grade-result.schema.yaml +33 -0
  139. package/docs/specdojo/schemas/v1/job-run.schema.yaml +27 -0
  140. package/docs/specdojo/schemas/v1/job.schema.yaml +25 -0
  141. package/docs/specdojo/schemas/v1/pipeline-state.schema.yaml +49 -1
  142. package/docs/specdojo/schemas/v1/pm-members.schema.yaml +9 -169
  143. package/docs/specdojo/schemas/v1/pm-review-viewpoints.schema.yaml +100 -10
  144. package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +13 -0
  145. package/docs/specdojo/schemas/v1/routine-run.schema.yaml +3 -0
  146. package/docs/specdojo/schemas/v1/routine.schema.yaml +7 -0
  147. package/docs/specdojo/schemas/v1/specdojo-config.schema.yaml +110 -0
  148. package/package.json +16 -9
  149. package/templates/antigravity/README.md +60 -0
  150. package/templates/antigravity/agent-members-snippet.yaml +61 -0
  151. package/templates/antigravity/exec-defaults-snippet.yaml +39 -0
  152. package/templates/antigravity/orchestrator.md +157 -0
  153. package/templates/antigravity/settings.global.json +55 -0
  154. package/templates/claude/agents/claude-executor.md +14 -0
  155. package/templates/claude/agents/claude-reporter.md +16 -0
  156. package/templates/claude/agents/specdojo-orchestrator.md +164 -0
  157. package/templates/claude/settings.edit.json +27 -1
  158. package/templates/codex/README.md +5 -4
  159. package/templates/codex/agents/specdojo-orchestrator.toml +165 -0
  160. package/templates/codex/orchestrator.md +157 -0
  161. package/templates/copilot/README.md +7 -5
  162. package/templates/copilot/{pm-members-snippet.yaml → agent-members-snippet.yaml} +4 -2
  163. package/templates/devcontainer/devcontainer.json +27 -0
  164. package/templates/devcontainer/emacs/init.el +88 -0
  165. package/templates/devcontainer/post-create.sh +62 -0
  166. package/templates/init-agent-members.yaml +200 -0
  167. package/templates/init-exec-defaults.yaml +72 -0
  168. package/templates/opencode/agents/specdojo-orchestrator.md +204 -0
  169. package/docs/ja/specdojo/exec-templates/xrp-viewpoint-detail-template.md +0 -7
  170. package/docs/ja/specdojo/exec-templates/xrr-viewpoint-detail-template.md +0 -7
@@ -9,7 +9,7 @@ specdojo:
9
9
 
10
10
  Exec Configuration Guide
11
11
 
12
- SpecDojo のエージェント実行は、`sch-strategy-<track>.yaml` の phase に作業要件を定義し、`pm-members.yaml` のエージェント定義から実行者を選択します。レートリミットなどの共通実行ポリシーは `exec-defaults.yaml` に分離します。
12
+ SpecDojo のエージェント実行は、`sch-strategy-<track>.yaml` の phase に作業要件を定義し、`.specdojo/agent-members.yaml` のエージェント定義から実行者を選択します。人間の名簿は project ごとの `pm-members.yaml`、レートリミットなどの共通実行ポリシーは `exec-defaults.yaml` に分離します。
13
13
 
14
14
  **対象読者**
15
15
 
@@ -38,10 +38,11 @@ SpecDojo のエージェント実行は、`sch-strategy-<track>.yaml` の phase
38
38
  | ファイル | 役割 | 粒度 |
39
39
  | ------------------------------ | ---------------------------------------------------------------------------------------- | ------------ |
40
40
  | `sch-strategy-<track>.yaml` | phase ごとの `mode`・`approach`・実行要件・任意の `agent` / `agent_pipeline` | トラック |
41
- | `pm-members.yaml` | 誰が作業するか(identity・capabilities・proficiency・priority・任意の `stage_role`) | プロジェクト |
41
+ | `pm-members.yaml` | 人間の identity・連絡先・対応 Role code | プロジェクト |
42
+ | `.specdojo/agent-members.yaml` | agent の identity・capabilities・proficiency・priority・任意の `stage_role` | リポジトリ |
42
43
  | `.specdojo/exec-defaults.yaml` | provider 別起動コマンドテンプレート・rate limit 検出条件・リトライポリシー・同時実行上限 | システム |
43
44
 
44
- `sch-strategy` は通常、phase に「どんな能力が必要か」を書き、`pm-members.yaml` の候補から自動選択します。provider の利用枠を計画する phase だけは `agent` で個体を指名できます。
45
+ `sch-strategy` は通常、phase に「どんな能力が必要か」を書き、`.specdojo/agent-members.yaml` の候補から自動選択します。provider の利用枠を計画する phase だけは `agent` で個体を指名できます。
45
46
 
46
47
  ## 2. phase の実行要件
47
48
 
@@ -92,7 +93,7 @@ pipeline では `agent_pipeline.stages` を `executor`、`reporter` の順に定
92
93
 
93
94
  ## 3. エージェントの定義
94
95
 
95
- `pm-members.yaml` の `type: agent` メンバーには `provider`・`capabilities`・`proficiency`・`priority` を定義します。起動コマンドは member には書かず、`.specdojo/exec-defaults.yaml` の `providers.<provider>.command_template` を member 属性(`{nickname}`・`{mode}`・`{proficiency}` と `command_params` の変数)で展開して解決します。member の `command` はテンプレートで表現できない特殊構成向けの上書きとしてのみ使います。
96
+ `.specdojo/agent-members.yaml` の member には `type: agent` と `provider`・`capabilities`・`proficiency`・`priority` を定義します。起動コマンドは通常 member には書かず、`.specdojo/exec-defaults.yaml` の `providers.<provider>.command_template` を member 属性(`{nickname}`・`{mode}`・`{proficiency}` と `command_params` の変数)で展開して解決します。member の `command` はテンプレートで表現できない特殊構成向けの上書きとしてのみ使います。
96
97
 
97
98
  ```yaml
98
99
  members:
@@ -125,13 +126,13 @@ pipeline 専用 agent には `stage_role: executor` または `stage_role: repor
125
126
  2. `priority` 昇順(同値なら次へ)。
126
127
  3. 余剰 capabilities 数の少ない順。
127
128
 
128
- ソート後、`exec-defaults.yaml` の `providers.<provider>.max_concurrency` が設定された provider について、現在実行中の agent が上限に達していれば、その provider の候補を除外します。別 provider の候補が残ればそれを実行者に繰り上げます。すべての候補の provider が上限に達している場合は、claim も worktree 生成も行わずにそのタスクを繰り延べます(タスクは `todo` のまま保持され、取りこぼしません)。`--loop` 実行では、agent 終了時に provider の枠を解放し、空いた `--parallel` 枠へ次の Ready タスクを投入します。`max_concurrency` はグローバルな `--parallel` を下げないため、他 provider は並列実行を維持します。`max_concurrency` は auto 選択のみに適用し、phase の `agent`、`--by` / `--edit-by` / `--review-by` / `--executor-by` / `--reporter-by` による明示指定や resume 実行には適用しません。
129
+ ソート後、`exec-defaults.yaml` の `providers.<provider>.max_concurrency` が設定された provider について、現在実行中の agent が上限に達していれば、その provider の候補を除外します。別 provider の候補が残ればそれを実行者に繰り上げます。すべての候補の provider が上限に達している場合は、claim も worktree 生成も行わずにそのタスクを繰り延べます(タスクは `todo` のまま保持され、取りこぼしません)。`--loop` 実行では、agent 終了時に provider の枠を解放し、空いた `--parallel` 枠へ次の Ready タスクを投入します。`max_concurrency` はグローバルな `--parallel` を下げないため、他 provider は並列実行を維持します。auto 選択以外では、register の worktree モードで実行する executor/reporter pipeline(`--parallel` / `--resume` を含む)に適用し、項目ごとの各 stage を provider の空き枠まで待機させます。その他の Schedule phase の `agent`、`--by` / `--edit-by` / `--review-by` / `--executor-by` / `--reporter-by` による明示指定や Schedule task の resume 実行には適用しません。
129
130
 
130
131
  phase の by-name agent が rate limit になった場合は、別 agent へ自動フォールバックせず待機状態にします。`exec resume` は同じ agent を再開し、運用者が差し替える場合だけ stage override を指定します。
131
132
 
132
133
  ## 4. 実行フロー
133
134
 
134
- `providers.<provider>.max_concurrency` は1つの `exec run` プロセス内の provider 枠を制御します。複数の `exec run` プロセスを跨ぐ上限ではないため、project ごとの `exec-run.lock` が手動実行・routine・CI の run 全体を排他します。同一 run 内の `--parallel` はこのロックの内側で動作します。
135
+ `providers.<provider>.max_concurrency` は1つの `exec run` プロセス内の provider 枠を制御します。project ごとの `exec-run.lock` が手動実行・routine・CI の run 全体を排他し、同一 run 内の `--parallel` はこのロックの内側で動作します。例外は register の worktree 実行へ `exec run --register ... --worktree --join` で合流する run です。この場合は、register pipeline の executor と reporter が `exec/.locks/provider-<provider>/` の枠を取得するため、`max_concurrency` は合流した run を跨いで効きます([exec運用ガイド](exec-operation-guide.md) の「実行中の register worktree 実行へ後から合流する」を参照)。
135
136
 
136
137
  手動 CLI の busy 時既定は `--if-busy fail` です。必要に応じて `wait` または `skip` を明示します。routine は待機で cron worker を占有しないよう常に `--if-busy skip` を渡し、再試行は次回の cron tick に委ねます。
137
138
 
@@ -163,7 +164,7 @@ flowchart LR
163
164
 
164
165
  ## 5. exec-defaults
165
166
 
166
- `.specdojo/exec-defaults.yaml` には、全トラック共通の実行ポリシーを定義します。executor の sandbox 外で親 runner に実行させる固定検証は `pipeline.parent_validations` に許可リスト ID だけを指定します。
167
+ `.specdojo/exec-defaults.yaml` には、全トラック共通の実行ポリシーを定義します。executor の sandbox 外で親 runner に実行させる固定検証は `pipeline.parent_validations` に許可リスト ID だけを指定します。別リポジトリ構成では、ID と実行するリポジトリの組(`{ id, repo }`)も指定できます。
167
168
 
168
169
  ```yaml
169
170
  pipeline:
@@ -172,6 +173,10 @@ pipeline:
172
173
  - typecheck
173
174
  - test-unit
174
175
  - test-integration
176
+ parent_validation_concurrency: 1 # 省略時も 1(run 内と合流した run の親検証を直列化)
177
+
178
+ run:
179
+ max_concurrent_runs: 4 # 省略時も 4(最初の run と --join の run の合計)
175
180
 
176
181
  rate_limit_detection:
177
182
  exit_codes: []
@@ -194,10 +199,40 @@ rate_limit_policy:
194
199
  on_exhausted: block
195
200
  ```
196
201
 
197
- `test-integration` は組み込み許可リストで `npm run test:integration` へ解決されます。設定や executor evidence に command・引数を書くことはできません。未知 ID、重複 ID は agent 起動前の設定エラーになります。親 runner は `shell: false` の固定 argv で実行し、現時点で許可される ID は `validate-schema`、`typecheck`、`test-unit`、`test-integration` の 4 つです。
202
+ `test-integration` は組み込み許可リストで `npm run test:integration` へ解決されます。設定や executor evidence に command・引数を書くことはできません。未知 ID、重複 ID は agent 起動前の設定エラーになります。親 runner は `shell: false` の固定 argv で実行し、現時点で許可される ID は `validate-schema`、`typecheck`、`test-unit`、`test-integration`、`lint-ts`、`lint-fm`、`lint-md` の 7 つです。
198
203
 
199
204
  `typecheck`(`npm run typecheck`)は Vitest と異なり型検査を行うため、executor が残した TypeScript の型エラーを検出します。Vitest は型検査を行わないため、`typecheck` を親検証に含めないと型エラーは test-unit を通過して統合時の pre-commit hook で初めて失敗するため、既定では `test-unit` の前に置いて早めに止めます(PJR-W66B)。
200
205
 
206
+ `lint-ts`(`npm run lint:ts`)、`lint-fm`(`npm run lint:fm`)、`lint-md`(`npm run lint:md`)は、executor が残した ESLint・frontmatter・Markdown の lint エラーを agent の段階で検出します。指定しない場合、これらのエラーは統合後の `npm run check` まで持ち越されます(PJR-K1Z5)。
207
+
208
+ `specdojo.config.json` の project に `repos` を宣言した別リポジトリ構成では、`pipeline.parent_validations` の要素に `{ id, repo }` を書き、検証を実行するリポジトリを割り当てられます(PJR-V96B)。ID だけの要素はプロジェクトリポジトリで実行します。`repo` には、プロジェクトリポジトリを表す `project` か、`repos` で宣言したプロダクトリポジトリの名前を書きます。
209
+
210
+ ```yaml
211
+ pipeline:
212
+ parent_validations:
213
+ - lint-md # プロジェクトリポジトリ(文書の lint)
214
+ - validate-schema # プロジェクトリポジトリ(schema 検証)
215
+ - { id: typecheck, repo: app1 } # プロダクトリポジトリ app1
216
+ - { id: test-unit, repo: app1 }
217
+ - { id: test-unit, repo: app2 } # 同じ ID を別のリポジトリにも割り当てられる
218
+ ```
219
+
220
+ - 親 runner は、割り当てたリポジトリの task worktree(`<worktree_base>/<task-id>/<repo>/`)を `cwd` にして検証を実行します。そのリポジトリに変更が無くても省略しません。統合先の破損を検出するためです。
221
+ - evidence の runner 検証には `repo` を記録します。記録するのは、task がプロダクトリポジトリを持つ場合か、要素が `{ id, repo }` の場合です。`repos` を持たない project で ID だけを書いた場合、evidence と実行場所は従来と同じです。
222
+ - executor がプロダクトリポジトリの検証を `not_run` として親 runner へ委譲するときは、`npm --prefix <repo> run <script>` のように対象リポジトリをコマンドへ含めます。runner はコマンドとリポジトリの組で照合し、同じリポジトリに割り当てた同一コマンドの親検証が成功した場合だけ、委譲済みの検証を満たしたものとして扱います。別のプロダクトリポジトリや project リポジトリでの成功は代用しません。
223
+ - ログと block 理由では、プロダクトリポジトリの検証を `<repo>:<id>`(例: `app2:test-unit`)と表示します。
224
+ - task の worktree が無いリポジトリへ割り当てた検証は、コマンドを起動せずに `failed` になります。`repos` に無い名前を書いた場合も同じです。
225
+ - 同じ `id` と `repo` の組の重複、`id`・`repo` 以外のキー、`repo` の無いオブジェクトは、agent 起動前の設定エラーになります。
226
+ - 実行するコマンドは、どのリポジトリでも ID ごとの固定 argv です(例: `test-unit` は `npm run test:unit`)。リポジトリ別に command や npm script 名を指定する手段は設けません。プロダクトリポジトリの npm script 名が異なる場合は、プロダクト側の `package.json` に許可リストと同じ名前の script(`test:unit` など)を用意してください。用意できない検証は、そのリポジトリへ割り当てないでください。script が無いまま割り当てると、`npm run` が失敗して親検証は `failed` になります。
227
+
228
+ `run.register_execution` は、`exec run --register` の既定の実行場所です。`worktree` または `in-place` を指定します。省略時は既存リポジトリとの互換性のため `in-place` です。CLI の `--worktree` / `--in-place` は設定を上書きし、同時指定はエラーになります。
229
+
230
+ `run.max_concurrent_runs` は、同じ project で同時に動かせる `exec run` プロセスの数の上限です。最初の run と、register の worktree 実行へ `--join` で合流する run の合計で数えます。正の整数だけを指定でき、省略時や不正な値の場合は `4` です。`1` を指定すると `--join` は無効になります。現在の使用数は `exec slots --project <project-id>` で確認できます。
231
+
232
+ `pipeline.parent_validation_concurrency` は、1 つの `exec run` プロセスの中で親検証を同時に実行できる項目数の上限です。正の整数だけを指定でき、省略時は `1` です。`--parallel` で複数項目を並行実行しても、親検証は項目単位で 1 本ずつ直列に実行されます。vitest は検証ごとに複数の worker を起動するため、検証が重なるとコンテナの負荷で成果物と無関係なタイムアウトが起きます。これを防ぐための既定値です(PJR-3HHW)。制限の対象は親検証だけで、executor と reporter は `--parallel` のとおり並行に動きます。空きを待つ項目は `Waiting for parent validation slot: <項目> (<検証 ID>); running: <実行中の項目>` をログへ出力し、枠を得たときに `Parent validation slot acquired: <項目>` を出力します。
233
+
234
+ この直列化は、同じ `exec run` プロセス内の全経路に適用されます。対象は executor 成功後の検証、reporter 再開前の検証の再実行、`exec trial` の検証です。同じ project の `exec run` は `exec-run.lock` によって run 全体で排他されるため、通常は別プロセスの検証が重なることはありません。register の worktree 実行へ `--join` で合流した run どうしは並行して動くため、`exec-run.lock` または合流の枠を取得したプロセスは、同じ上限の枠を `exec/.locks/parent-validation/` にも取得します。これにより、合流した run を跨いでも親検証は `parent_validation_concurrency` 本までに抑えられます(PJR-4HBG)。別プロセスの枠を待つ項目は `Waiting for parent validation slot held by another exec run: <項目> (<検証 ID>)` をログへ出力します。枠は heartbeat 付きのロックで、プロセスが異常終了した場合は heartbeat が止まってから 30 秒で stale とみなされ、後続の run が奪取します。このため、解放漏れで無関係な run が止まり続けることはありません。別 project の run を同時に起動した場合は、ロックの配置が異なるため、互いの検証が重なり得ます。executor が sandbox 内で実行する検証は runner の管理外です。このため、vitest を使う `test-unit` / `test-integration` は `parent_validations` へ寄せ、executor には実行させません。
235
+
201
236
  provider ごとに挙動が異なる設定は `providers.<provider>` に置きます。各キーは対応するグローバル値を完全に置き換え、未指定のキーはグローバル値にフォールバックします。`<provider>` は `pm-members[].provider` に対応します。指定できるキーは次のとおりです。
202
237
 
203
238
  - `command_template`: その provider の agent を起動するコマンドテンプレート。`{nickname}`・`{mode}`・`{proficiency}` と `command_params` の変数を member 属性で展開します。グローバル既定は持ちません。
@@ -205,7 +240,7 @@ provider ごとに挙動が異なる設定は `providers.<provider>` に置き
205
240
  - `rate_limit_detection`: provider 固有の検出シグナル(`stderr_patterns` を優先します)。
206
241
  - `rate_limit_policy`: provider 固有のリトライ/フォールバック/block ポリシー。
207
242
  - `rate_limit_policy.cooldown_seconds`: reset / retry-after が無い retryable signal にだけ使う明示的な延期秒数。未指定の kind は再開時刻を推定しません。
208
- - `max_concurrency`: その provider の agent を 1 ラウンドで同時に走らせる上限(正の整数)。未指定・0 以下・非整数は「上限なし」として扱います。
243
+ - `max_concurrency`: その provider の agent を 1 ラウンドで同時に走らせる上限(正の整数)。未指定・0 以下・非整数は「上限なし」として扱います。register の worktree 実行では、`--join` で合流した run を跨いで数えます。
209
244
 
210
245
  `{nickname}` のような `{lower_snake}` は実行のたびに展開される実行時変数であり、ファイルに記法のまま残った状態が完成形です。テンプレート成果物の記入プレースホルダ `_UPPER_SNAKE_`(一度埋めたら消える)とは別の記法で、使い分けは [Template 記述標準](../standards/template-authoring-standard.md) の `他のプレースホルダ記法との使い分け` を正本とします。
211
246
 
@@ -222,18 +257,18 @@ providers:
222
257
  expert: { model: gpt-5.5, effort: high }
223
258
 
224
259
  antigravity:
225
- command_template: 'agy --sandbox --add-dir "$(pwd)" --dangerously-skip-permissions --model {model} -p "$(cat)"'
260
+ command_template: 'agy --sandbox --add-dir "$(pwd)" --model {model} -p "$(cat)"'
226
261
  command_params:
227
262
  by_proficiency:
228
263
  normal: { model: gemini-3.8-flash-medium }
229
264
  expert: { model: gemini-3.1-pro-high }
230
265
  by_nickname:
231
- agy-opus-executor: { model: claude-opus-4-6-thinking }
266
+ agy-claude-expert-executor: { model: claude-opus-4-6-thinking }
232
267
  ```
233
268
 
234
269
  `by_nickname` は、同じ provider の一部 member だけモデルなどを差し替える用途です。層をまたぐ同名変数は意図的な上書きとして許可されます。一方、`nickname`、`mode`、`proficiency` は組み込み変数なので、どの `command_params` 層でも再定義できません。
235
270
 
236
- `max_concurrency` は、同一ホストの単一モデルを共有する provider(例: ローカル Ollama の `opencode`)が複数同時起動でメモリ競合・モデルロード待ちにより不安定になるのを防ぐために使います。グローバルな `--parallel` を下げずに、その provider だけを直列化できます。
271
+ `max_concurrency` は、同一ホストの単一モデルを共有する provider(例: ローカル Ollama の `opencode`)が複数同時起動でメモリ競合・モデルロード待ちにより不安定になるのを防ぐために使います。グローバルな `--parallel` を下げずに、その provider だけを直列化できます。register の並列 pipeline では executor と reporter の各 stage が個別に枠を取得するため、別 provider の executor を並列化しつつ、同一 provider の reporter だけを直列化できます。
237
272
 
238
273
  ```yaml
239
274
  providers:
@@ -355,28 +390,30 @@ specdojo exec run --project <project-id> --task <task-id> \
355
390
 
356
391
  executor の出力は、そのまま reporter へ渡さずに run 単位の evidence へ整形して保存します。保存先は `<execution_path>/exec/evidence/<task-id>/<run-id>/` です。
357
392
 
358
- | ファイル | 内容 |
359
- | --------------------------------------------------------------------- | ----------------------------------------------------------------------------------- |
360
- | `evidence.json` | stage の実行結果、変更ファイル一覧、diff サマリ、検証結果、最終メッセージ、ログ参照 |
361
- | `executor.log` | executor の標準出力・標準エラーの抜粋(人が調査するための参照先) |
362
- | `reporter-attempt-<n>.stdout.log` / `reporter-attempt-<n>.stderr.log` | 失敗した reporter の形式試行ごとの stdout / stderr(秘匿処理後の生出力) |
363
- | `pipeline-state.json` | executor / reporter の状態・actor・試行回数・成果物参照 |
393
+ | ファイル | 内容 |
394
+ | --------------------------------------------------------------------- | --------------------------------------------------------------------------------------------- |
395
+ | `evidence.json` | stage の実行結果、変更ファイル一覧、diff サマリ、検証結果、最終メッセージ、失敗理由、ログ参照 |
396
+ | `executor.log` | executor の標準出力・標準エラーの抜粋(人が調査するための参照先) |
397
+ | `reporter-attempt-<n>.stdout.log` / `reporter-attempt-<n>.stderr.log` | 失敗した reporter の形式試行ごとの stdout / stderr(秘匿処理後の生出力) |
398
+ | `parent-validation-attempt-<n>-<id>.log` | 失敗した親検証の stdout / stderr(秘匿処理後の出力) |
399
+ | `pipeline-state.json` | executor / reporter の状態・actor・試行回数・成果物参照 |
364
400
 
365
401
  引き渡しの方針は次のとおりです。
366
402
 
367
403
  - reporter へ渡すのは、plan と `evidence.json` の内容と出力 JSON Schema だけです。ログ本文・生 diff は渡しません。
368
404
  - ログは `evidence.json` の `log_refs` に参照(パス・バイト数・切り詰めの有無)としてだけ現れます。ログ本文を読むのは人です。
369
- - 保存前に上限を適用します。`executor.log` は全体で 64KiB、失敗した reporter のログは stdout / stderr の各ファイルを 64KiB とし、最終メッセージと diff サマリは各 4,000 文字、検証結果は 50 件、変更ファイルは 1,000 件までです。stdout と stderr を分離することで原因調査時にストリームを識別でき、同じ上限を各ストリームへ適用することで片方の大量出力がもう片方を押し出しません。超過分は切り詰め、切り詰めた事実を `log_refs.truncated` に残します。
405
+ - 保存前に上限を適用します。`executor.log` は全体で 64KiB、失敗した reporter のログは stdout / stderr の各ファイルを 64KiB とします。失敗した親検証は stdout / stderr をそれぞれ 1MiB まで取得し、両方を 1 つのログへ保存します。1MiB を超えたストリームは先頭と末尾を残して中間を省略します。最終メッセージと diff サマリは各 4,000 文字、検証結果は 50 件、変更ファイルは 1,000 件までです。超過分を切り詰めた事実は `log_refs.truncated` に残します。
370
406
  - 保存前に秘匿値を伏せ字化します(`Bearer` トークン、`sk-`/`gh*_` 形式のキー、`api_key` / `token` / `password` などの値)。evidence と executor / reporter のログに適用します。
371
407
  - reporter が非ゼロ終了または形式エラーで失敗した場合、同じ reporter stage 内の各形式試行を `reporter-attempt-<n>.stdout.log` と `reporter-attempt-<n>.stderr.log` に保存します。同じ run を resume して再度失敗した場合は、直近の失敗内容でこれらのファイルと `log_refs` を置き換えます。
408
+ - 親検証は失敗時だけ出力を保存し、成功時は要約だけを記録します。失敗ログは `parent-validation-output` として `log_refs` から参照します。同じ run の resume や統合段の再検証では attempt 番号を増やして新しいログを追加し、以前の失敗ログを上書きしません。親検証の要約は 1,000 文字以内で先頭と末尾を残すため、末尾に出る失敗ケース名と件数を evidence から確認できます。
372
409
  - evidence ディレクトリは Git の管理対象です。成功して統合された run のログは履歴に残り、失敗中の worktree では未コミットのまま保持されます。`--force-restart` などで worktree を破棄すると未コミットログも失われるため、必要な調査を先に行います。既知パターンは保存前に秘匿しますが、未知形式の秘密が残る可能性を考慮し、ログを外部共有する前に内容を確認します。
373
- - executor が構造化した最終報告を返す場合は、標準出力に `<specdojo_executor_evidence>` タグで JSON(`final_message`・`validations`)を出します。タグが無い場合は標準出力の残りを最終メッセージとして扱います。
374
- - `pipeline.parent_validations` には `validate-schema`(`npm run validate:schema`)、`typecheck`(`npm run typecheck`)、`test-unit`(`npm run test:unit`)、`test-integration`(`npm run test:integration`)を指定できます。親 runner は executor の成功後・reporter の起動前に、指定順で固定 argv の検証を実行します。
410
+ - executor が構造化した最終報告を返す場合は、標準出力に `<specdojo_executor_evidence>` タグで JSON(`final_message`・`validations`)を出します。`validations[].status` は `passed` / `failed` / `not_run` / `not_applicable` / `requires_human` のいずれかです。`not_applicable` はリポジトリが検査の適用条件を満たさない場合に使い、`reason` へ理由を必ず記録します。`requires_human` は、実 agent CLI の起動、利用枠や課金を伴う操作、認証情報やホスト側の操作など、agent の sandbox から実行できない確認だけに使います。実行できるが省略した検証には使わず、`not_run` として記録します。タグが無い場合は標準出力の残りを最終メッセージとして扱います。
411
+ - `pipeline.parent_validations` には `validate-schema`(`npm run validate:schema`)、`typecheck`(`npm run typecheck`)、`test-unit`(`npm run test:unit`)、`test-integration`(`npm run test:integration`)、`lint-ts`(`npm run lint:ts`)、`lint-fm`(`npm run lint:fm`)、`lint-md`(`npm run lint:md`)を指定できます。親 runner は executor の成功後・reporter の起動前に、指定順で固定 argv の検証を実行します。
375
412
  - executor prompt には設定済み ID と対応コマンドを明示します。executor はそのコマンドや対象限定版を sandbox 内で実行せず、親 runner の結果だけを `source: runner` と許可リスト `id` 付きで同じ `validations` 配列へ保存します。これにより sandbox 内で成立しない検証を親へ移した場合も二重実行しません。
376
- - 親検証が失敗しても reporter は evidence を受け取り、block 内容を構成できます。ただし reporter が誤って `outcome: complete` を返しても、runner は親検証の失敗を優先してタスクを成功扱いにしません。
413
+ - result の `changed_files` のパスは evidence の `changes` から、execution の evidence、project register とその派生ビュー、当該 result という runner 管理記録を除いて runner が機械生成します。除外後の変更一覧だけを reporter へ渡し、edit の変更説明は evidence のパスと対にして受け取ります。runner はパスで突き合わせるため、説明の順序は問いません。説明が不足したパスには差分参照を促す既定文を記録し、evidence にないパスの説明は捨てます。`outcome` と `block_reason` は stage の状態・終了コード・保護機構が保存した理由・executor / 親 runner の検証から機械生成します。reporter の JSON Schema は文章項目と対応づけ用のパスだけを受け付け、いずれかの検証が failed または `not_run` なら、reporter の文章にかかわらず機械判定は blocked です。ただし、executor が `not_run`(親 runner へ委譲)と記録したコマンドを、親 runner が同じリポジトリで同じコマンドとして実行し成功していれば、その `not_run` は満たされたものとして扱います。さらに、`npm run <name>` に対応する script がない、`npx <package>` の package が `dependencies` / `devDependencies` にない、または SpecDojo サブコマンドの設定上の適用条件を満たさないことを runner が機械的に確定できる場合、その `not_run` は block せず、edit result の申し送りへ「適用外の検証(runner の判定)」として追記します。SpecDojo の起動形は `specdojo <subcommand>`、`npx specdojo <subcommand>`、ソース/配布済み CLI の直接起動を認識し、`catalog validate` は対象 project の `catalog_path` で判定します。対象 project は、コマンドの `--project <id>`、run の対象 project(runner が execution path に一致する project を設定から特定したもの)、`current_project` の順に決めます。別の project が `catalog_path` を持っていても、run の対象 project に `catalog_path` がなければ適用外です。対象 project に `catalog_path` があっても、executor の変更(runner 管理記録を除き、rename は変更前後の両方を見ます)が `docs/ja/projects/` 配下に及ばない run では、plan の共通規約の検証表と同じく適用外とし、executor の `not_applicable` も受理します。変更が及ぶ run では従来どおり適用対象です。また、`<repo>:<path>` を引数に含むコマンドや `--prefix <repo>` 付きのコマンドは、対象 project が `repos` で宣言したそのプロダクトリポジトリの `package.json` で script と依存を判定します(`--prefix` はリポジトリ名か設定の `path` と一致するものを対象にします)。設定が読めない、対象 project を特定できない、または適用条件を未定義のサブコマンドは機械的な救済をせず、通常の `not_run` として扱います。executor の failed は親 runner の成功や適用外判定で打ち消しません。`npm run check` のように npm script を `&&` でつないだだけの合成コマンドを executor が `not_run` とした場合は、対象リポジトリの `package.json` の script を展開し、構成する各コマンドが同じリポジトリの親検証か executor 自身の検証で通っていれば満たされたものとして扱います。`npm test` は、`npm run test:unit` と `npm run test:integration` の両方が通っていれば満たされたものとします。構成するコマンドの script の中身と同じコマンドを executor が直接実行して通した場合も満たします(`tsx` の起動の書き方の違いはそろえて比べます)。任意のシェルを含む script は展開しません。理由付きの `not_applicable` は block の理由にせず、runner が edit result の申し送りへ「適用外の検証: `<コマンド>`(<理由>)」として機械的に追記します。ただし、理由がない場合、`npm run <name>` の script が存在する場合、または `npx <package>` の package が `dependencies` / `devDependencies` に存在する場合は誤申告として blocked にします。SpecDojo サブコマンドは package の有無だけでは反証せず、既知の適用条件を設定から判定します。適用条件が未定義なら理由付きの agent の申告に従います。`specdojo index build`(`npx specdojo index build`・`node --import tsx src/specdojo.ts index build` などの起動形を含みます)は runner が担う検証です。出力先の `.specdojo/doc-index.json` は agent が書き込めず、index は worktree の準備と統合の前に runner が再生成するため、executor への指示では実行も記録もしないよう伝えます。executor が `not_run` / `not_applicable` と記録しても block の理由にせず、`not_run` の場合は edit result の申し送りへ「runner が担う検証: `<コマンド>`(<理由>)」として追記します。runner の再生成が失敗した場合は worktree の準備で run が止まるか、runner の検証の失敗として block するため、満たしたものとは扱いません。executor の failed は救済せず、ほかの SpecDojo サブコマンドの `not_run` の扱いも変えません。executor の `requires_human` は block の理由にせず、runner が edit result の申し送りへ「人の確認が必要: `<コマンド>`(<要約>)」として機械的に追記します。項目は review へ進み、人が確認してから close します。
377
414
  - reporter の出力は JSON Schema で厳格に検証します。形式不正のときは同じ plan と evidence のまま reporter だけを最大 3 回再実行し、executor は再実行しません。
378
- - reporter stage の再開では、現在の設定 ID と一致する親検証が保存済み evidence にそろっている場合だけ executor evidence を再利用します。保存済みの親検証がすべて成功していれば再実行しません。`failed` / `not_run` があれば、親 runner が現在の worktree で固定許可リストの親検証を再実行し、同じ ID の結果を evidence 上で置換してから reporter へ渡します。executor 由来の検証は再実行・置換しません。設定 ID が変わった、または結果が欠けている場合、Schedule 実行は新しい executor run としてやり直し、register 実行は明示的な再実行を促して再開を拒否します。
379
- - result の frontmatter は runner が scaffold した内容を保ち、本文は検証済み JSON から runner が描画します。reporter はファイルを書きません。
415
+ - reporter stage の再開では、現在の設定 ID と一致する親検証が保存済み evidence にそろっている場合だけ executor evidence を再利用します。`{ id, repo }` を使う場合は、ID とリポジトリの組が一致することを求めます。再実行時も同じ割り当てで、各リポジトリの worktree を `cwd` にします。保存済みの親検証がすべて成功していれば再実行しません。`failed` / `not_run` があれば、親 runner が現在の worktree で固定許可リストの親検証を再実行し、同じ ID の結果を evidence 上で置換してから reporter へ渡します。過去の親検証ログは置換せず、新しい失敗ログだけを追加します。executor 由来の検証は再実行・置換しません。設定 ID が変わった、または結果が欠けている場合、Schedule 実行は新しい executor run としてやり直し、register 実行は明示的な再実行を促して再開を拒否します。
416
+ - result の frontmatter は runner が scaffold した内容を保ち、本文は検証済みの reporter 文章と evidence 由来の事実を組み合わせて runner が描画します。reporter はファイルを書きません。
380
417
 
381
418
  ## 7. provider 設定の配布と scaffold
382
419
 
@@ -384,13 +421,13 @@ agent が exec 実行時に読み込む provider 固有の設定(agent 定義
384
421
 
385
422
  配置規則は provider 名から機械的に決まります(`agents/` 配下 → `.<provider>/agents/`、それ以外のファイル → `.specdojo/<provider>/`、`README.md` はコピーしません)。provider ごとの配布内容は次のとおりです。
386
423
 
387
- | provider | 配布内容 | 配置先 |
388
- | ----------- | --------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------- |
389
- | claude | `agents/*.md`、`settings.edit.json` / `settings.review.json` / `settings.report.json` | `.claude/agents/`、`.specdojo/claude/` |
390
- | codex | `agents/*.toml`(親 Codex が spawn する subagent 定義) | `.codex/agents/` |
391
- | opencode | `agents/*.md`(permission frontmatter 込みの agent 定義) | `.opencode/agents/` |
392
- | copilot | `pm-members-snippet.yaml`(member 定義)と `exec-defaults-snippet.yaml`(`providers.copilot` の command template・rate limit 検出)の参照スニペット | `.specdojo/copilot/` |
393
- | antigravity | なし(`agy` は定義ファイルを持たず、member と `providers.antigravity` の設定だけで動く) | — |
424
+ | provider | 配布内容 | 配置先 |
425
+ | ----------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------- |
426
+ | claude | `agents/*.md`、`settings.edit.json` / `settings.review.json` / `settings.report.json` | `.claude/agents/`、`.specdojo/claude/` |
427
+ | codex | `agents/*.toml`(親 Codex が spawn する subagent 定義) | `.codex/agents/` |
428
+ | opencode | `agents/*.md`(permission frontmatter 込みの agent 定義) | `.opencode/agents/` |
429
+ | copilot | `agent-members-snippet.yaml`(agent 定義)と `exec-defaults-snippet.yaml`(`providers.copilot` の command template・rate limit 検出)の参照スニペット | `.specdojo/copilot/` |
430
+ | antigravity | `orchestrator.md`、agent / provider 設定スニペット。`settings.global.json` は `--global` 用のマージ原本であり repository へは配置しない | `.specdojo/antigravity/` |
394
431
 
395
432
  導入手順とテンプレートに含めない手動設定(`opencode.json`、`.codex/config.toml` など)は各 `templates/<provider>/README.md` を参照します。
396
433
 
@@ -398,6 +435,8 @@ agent が exec 実行時に読み込む provider 固有の設定(agent 定義
398
435
 
399
436
  Claude member の `mode` はこの `{mode}` を権限プロファイル名へ展開するためにも使います。edit executor は `edit`、review executor は `review`、reporter は `report` を指定します。reporter の適格性は task mode ではなく `stage_role: reporter` で決まり、`settings.report.json` は Edit/Write と `git add` / `git commit` を deny します。
400
437
 
438
+ `settings.edit.json` は、利用者のリポジトリ固有の構成(ルート直下の成果物や `app/`・`lib/` など)にも対応できるよう、既定でリポジトリ全体への Edit を許可します。一方、agent の権限や親 runner・hook・CI の実行内容を変更できる `.specdojo/`、agent 設定、CI 設定、ルート直下の `package.json` などは deny します。deny の範囲は runner の agent-config-write 検査と同じ保護対象を unit test で照合し、Claude Code の事前拒否と runner の事後検査を重ねます。
439
+
401
440
  ### 7.1. scaffold コマンド
402
441
 
403
442
  この配置は、初期設定の導線にある `config scaffold` の `--provider <name>` オプションで自動化します。
@@ -415,9 +454,11 @@ specdojo config scaffold --provider claude
415
454
  - 配布原本はインストール済み package のルートから解決します。`templates/<name>/` が存在しない provider を指定した場合は、指定可能な provider 一覧を添えてエラーにします。
416
455
  - 配置先に同名ファイルが存在する場合は上書きせず `Skipped (already exists):` を出力します。`--force` 指定時のみ上書きします。ファイルごとに `Written:` / `Skipped:` を 1 行ずつ出力します(既存の scaffold 系コマンドの出力形式に合わせます)。
417
456
  - `--dry-run` 指定時は書き込みを行わず、コピー予定のファイル一覧を表示します。
457
+ - `antigravity` で `--global` を明示した場合だけ、`~/.gemini/antigravity-cli/settings.json` の `permissions.allow` / `deny` / `ask` へ不足 rule を追記します。既存キーと配列要素は保持し、書き換え前に timestamp 付きバックアップを作ります。`--global --dry-run` は追加 rule の差分だけを表示し、設定もバックアップも作りません。
458
+ - `--global` をサポートしない provider へ指定した場合はエラーにします。`--force` はグローバル設定の既存値を上書きしません。
418
459
  - コピー完了後、次の 2 点を案内メッセージとして出力します。配置ファイルのコミットが必要であること(worktree 実行の前提)、および `.specdojo/exec-defaults.yaml` の `providers.claude.command_template` に `--settings` の指定が必要であること。
419
460
  - `settings.*.json` の `Edit(...)` / `Write(...)` パスパターンの調整は利用者に委ねます。scaffold は `.specdojo/specdojo.config.json` のパス設定に基づく書き換えを行いません(テンプレートを事実上の推奨レイアウト前提で配布します)。
420
- - 将来 provider を追加する場合は `templates/<provider>/` を追加し、`package.json` の `files` に含めます。コマンド側は provider 名からディレクトリを解決するだけで、provider ごとの分岐を持ちません。
461
+ - 将来 provider を追加する場合は `templates/<provider>/` を追加し、`package.json` の `files` に含めます。repository 内へのコピーは provider 名からディレクトリを解決します。ユーザーディレクトリ設定も扱う provider だけは、グローバル設定原本と配置先を実装の許可リストへ明示します。
421
462
 
422
463
  ## 8. agent 権限とプロンプトインジェクション対策
423
464
 
@@ -440,6 +481,8 @@ provider によらず、exec の実行構造そのものが次の境界を提供
440
481
 
441
482
  **claude** は `provider 設定の配布と scaffold` のとおり、ロール別 `--settings`(edit は `docs/**`、`src/**`、`tests/**`、review は result 配下のみ書き込み可)でパス単位に制限します。`--permission-mode bypassPermissions` は使わず、`.claude/settings.json` の `disableBypassPermissionsMode: "disable"` で起動自体を拒否します。
442
483
 
484
+ **antigravity** は `config scaffold --provider antigravity --global` で fine-grained permission を追記します。グローバル設定は利用者のすべてのリポジトリに効くため、allow は読み取りの Git コマンド(`git status` / `diff` / `log` / `show`)だけとし、`npm run` など任意のスクリプトを実行できる command は含めません。deny には、Git の変更操作・破壊的 command・秘密情報・固定保護設定へのアクセスを入れます。`--dangerously-skip-permissions` は使いません。CLI の permission に加えて、実行後の provider 非依存ガードでも保護設定の変更を block します。
485
+
443
486
  **codex** はパス単位の permission 機構を持たず、sandbox(`read-only` / `workspace-write` / `danger-full-access`)の粒度で制御します。review でも result の記入が必要なため `read-only` にはできず、edit / review とも `workspace-write` を使います。command template には次を明示します。
444
487
 
445
488
  ```yaml
@@ -467,7 +510,7 @@ providers:
467
510
 
468
511
  `bash` を deny 基点の許可リストにするのは、`git add` / `git commit` を含む任意コマンドを塞ぐためで、denylist(`git push` などの列挙)では不十分です。ローカル Ollama 前提のため外部送信面はもともと小さいですが、`read` の `.env` / `secrets` deny と `external_directory: deny` は維持します。
469
512
 
470
- **copilot**(GitHub Copilot CLI)は command のフラグで権限を制御します。deny は allow より常に優先され、`--allow-all-tools` すら上書きできます。`pm-members.yaml` には copilot member を `disabled: true` で定義済みで、起動コマンドは `providers.copilot.command_template` に定義します。有効化する際も次の構成を維持します。
513
+ **copilot**(GitHub Copilot CLI)は command のフラグで権限を制御します。deny は allow より常に優先され、`--allow-all-tools` すら上書きできます。`.specdojo/agent-members.yaml` には copilot member を `disabled: true` で定義し、起動コマンドは `providers.copilot.command_template` に定義します。有効化する際も次の構成を維持します。
471
514
 
472
515
  ```yaml
473
516
  providers:
@@ -490,21 +533,20 @@ providers:
490
533
  providers:
491
534
  antigravity:
492
535
  command_template: >-
493
- agy --sandbox --add-dir "$(pwd)" --dangerously-skip-permissions
494
- --model {model} -p "$(cat)"
536
+ agy --sandbox --add-dir "$(pwd)" --model {model} -p "$(cat)"
495
537
  command_params:
496
538
  by_proficiency:
497
539
  normal: { model: gemini-3.8-flash-medium }
498
540
  expert: { model: gemini-3.1-pro-high }
499
541
  by_nickname:
500
- agy-sonnet-executor: { model: claude-sonnet-4-6 }
501
- agy-opus-executor: { model: claude-opus-4-6-thinking }
502
- agy-opus-review-executor: { model: claude-opus-4-6-thinking }
542
+ agy-claude-executor: { model: claude-sonnet-4-6 }
543
+ agy-claude-expert-executor: { model: claude-opus-4-6-thinking }
544
+ agy-claude-expert-review-executor: { model: claude-opus-4-6-thinking }
503
545
  agy-gpt-executor: { model: gpt-oss-120b-medium }
504
546
  ```
505
547
 
506
548
  - `--sandbox` は書き込み先を `~/.gemini/antigravity-cli/scratch/` へ逃がすため、`--add-dir "$(pwd)"` で作業ディレクトリ(worktree)を明示して成果物へ書けるようにします。`--add-dir` なしでは成果物が更新されません。
507
- - `--dangerously-skip-permissions` は非対話実行に必須です。境界は worktree、保護設定(`agent-config-write`)、commit 許可リストで作ります。
549
+ - 非対話実行に必要な permission rule は `config scaffold --provider antigravity --global` で設定します。すべてのリポジトリに効くため、先に `--global --dry-run` で差分を確認します。`--dangerously-skip-permissions` は deny rule を含む承認境界を迂回するため使いません。
508
550
  - モデルは `agy models` で確認します。標準モデルは `by_proficiency`、Antigravity 経由の Claude / GPT は `by_nickname` で選びます。モデル ID は推論強度を含む(`gemini-3.8-flash-medium` など)ため `--effort` は併用しません。ID と `--effort` が食い違うと `invalid model selection` で起動に失敗します。
509
551
  - 資格情報はコンテナ内では `~/.gemini/antigravity-cli/antigravity-oauth-token` に保存されます。devcontainer では `~/.gemini` を名前付きボリュームにして永続化します。
510
552
  - `--output-format json --json-schema <file>` は `structured_output` を含む JSON エンベロープを返します。runner の reporter は stdout の本文から JSON を読むため、現時点では既定のテキスト出力を使います。
@@ -536,7 +578,7 @@ providers:
536
578
  - `retrofit` の `evidence_refs` は plan 本文へ読み取り専用の調査入力として展開されますが、`targets` や実践の型ディレクトリの許可には変換されません。実装エビデンスへの変更は commit 対象外です。
537
579
  - agent で HEAD に plan が無い場合、または human で HEAD に result が無い場合など、frontmatter から task 識別を復元できない場合のみ従来の除外リスト方式へフォールバックします。CLI 経由では正本となる plan / result を checkpoint するため、agent 側からこの分岐を誘発することはできません。
538
580
  - この許可リストは specdojo CLI が行う commit にのみ効くため、**agent 自身に `git commit` を許可しないこと**が全 provider 共通の前提になります。agent が exec branch 上に直接 commit すると許可リストを経由せず merge に到達します。claude は settings の allow に `git add` / `git commit` を含めません(`-p` 実行では未許可ツールは自動拒否されます)、codex は共有 `.git` が worktree 外にあるため sandbox が書き込みを遮断します、opencode は `bash` の許可リストで塞ぎます。
539
- - worktree 内をパス単位で制約しない provider(codex / copilot)への本命の対策であると同時に、claude / opencode に対しても provider 設定と独立した深層防御として機能します。provider 非依存の specdojo CLI 側実装であり、`pm-members.yaml` の変更を必要としません。
581
+ - worktree 内をパス単位で制約しない provider(codex / copilot)への本命の対策であると同時に、claude / opencode に対しても provider 設定と独立した深層防御として機能します。provider 非依存の specdojo CLI 側実装です。
540
582
 
541
583
  ### 8.4. 親 runner が実行する設定と Git 状態の変更ガード
542
584
 
@@ -549,10 +591,11 @@ commit 許可リストだけでは、register 由来の除外リスト方式や
549
591
  - `AGENTS.md`、`CLAUDE.md`、`GEMINI.md`
550
592
  - `commitlint.config.*`、`.commitlintrc*`
551
593
  - `.github/workflows/**`、`.gitlab-ci.*`、`.gitlab/ci/**`、`.circleci/**`、Azure Pipelines / Jenkins の設定
594
+ - `.specdojo/**`。この中の `agent-members.yaml` は agent の identity・起動上書き・選択属性を含むため、agent が自身や他の agent の定義を書き換えられないようにする
552
595
 
553
596
  runner は agent の各試行前後でファイル内容を比較し、差分があれば親検証と reporter を起動せず block します。worktree の commit 前には Git status と exec branch の commit 済み差分を再検査するため、register の除外リスト方式や agent 自身による commit があっても merge されません。違反時は `agent-config-write:` と対象パスを標準エラーへ出力します。この定義は `exec-defaults.yaml` や member 設定から解除・拡張できません。
554
597
 
555
- 保護対象の候補はパスの固定定義で分類し、実際に block する対象は `agentProtectedConfigPaths()` で確定します。`.specdojo/doc-index.json` は `index build` が再生成し commit しない既知の生成物なので、リポジトリの ignore 規則にも一致する場合だけ除外します。判定には `git check-ignore --no-index` を使い、過去に追跡されていた worktree でも生成物として扱います。任意の ignore 対象を除外すると、agent が `.gitignore` と新規設定を同時に作って回避できるため、除外は既知の生成物の固定リストに限定します。Git による判定が失敗した場合や ignore 規則から外れた場合は除外せず、保護側へ倒します。agent 前後の snapshot と commit 前の再検査はこの判定を共有します。
598
+ 保護対象の候補はパスの固定定義で分類し、実際に block する対象は `agentProtectedConfigPaths()` で確定します。`.specdojo/doc-index.json` は `index build` が再生成し commit しない既知の生成物なので、リポジトリの ignore 規則にも一致する場合だけ除外します。判定には `git check-ignore --no-index` を使い、過去に追跡されていた worktree でも生成物として扱います。任意の ignore 対象を除外すると、agent が `.gitignore` と新規設定を同時に作って回避できるため、除外は既知の生成物の固定リストに限定します。Git による判定が失敗した場合や ignore 規則から外れた場合は除外せず、保護側へ倒します。agent 前後の snapshot と commit 前の再検査はこの判定を共有します。`pm-members.yaml` は schema により人間だけを受け付ける通常成果物なので、この保護対象には含めません。
556
599
 
557
600
  agentと親検証の子プロセスを起動する際は、`gitEnvironment()`で`GIT_DIR`、`GIT_WORK_TREE`、`GIT_COMMON_DIR`、index・object・replace関連のrepository固有環境変数を除去します。除去対象は`src/git-environment.ts`の`GIT_LOCAL_ENV_VARS`を正本とします。Vitestの全3設定も共通setupを使ってtest module読込前に同じ変数をworkerから除去するため、Git hook経由で`npm test`が起動されても、テストfixtureはcwdの一時repositoryを参照し、linked worktreeのgitdirや共有configを参照しません。
558
601
 
@@ -562,7 +605,7 @@ executor / reporter pipelineのexecutor promptは、commitとrepository設定を
562
605
 
563
606
  さらに`src/exec-agent-git-state.ts`が各agent試行の直前にagentのcwdから解決したHEAD(commitとsymbolic ref)およびlocal configを記録し、終了直後に比較します。runnerが作成したworktree branchをVS Codeが発見した際に付与する`branch.*.vscode-merge-base`は表示用metadataなので比較から除外します。それ以外のlocal configは順序と重複を保って比較し、`core.bare`などrepository動作に関わる変更を検知します。HEADまたは監視対象設定に差分があれば`agent-git-state-write:`と変更フィールドを標準エラーへ出力し、親検証・reporter・commit・mergeへ進まずblockします。通常のworktree実行だけでなく、in-place、`exec trial`、`exec worktree agent`にも同じ境界を適用します。
564
607
 
565
- 設定変更が必要なタスクでは、agent は対象パス、変更理由、提案差分、変更後に必要な検証を result の申し送りへ記載して block します。人間または対話型 orchestrator は agent 実行外で提案を確認して適用し、対象設定に対応する test / hook / CI 検証を実行して commit します。agent 用の解除フラグはありません。
608
+ 設定変更が必要なタスクでは、agent は対象パス、変更理由、提案差分、変更後に必要な検証を result の申し送りへ記載して block します。人間または対話型 orchestrator は agent 実行外で `specdojo exec handoff apply --project <project-id> --register <PJR-ID>` を実行し、表示された提案差分を確認して統合先へ適用・commit します。対話入力では `y` / `yes`、非対話実行では `--yes` が必要で、確認がなければ変更しません。`package.json` の依存定義を変更した場合は、コマンドの案内に従って対応する lock ファイルを再生成・commit してから `exec run --register ... --worktree --resume` で再開します。提案差分がない、切り詰められている、対象パスと一致しない、または統合先へ安全に適用できない場合は自動適用せずエラーにします。agent 用の解除フラグはありません。
566
609
 
567
610
  ただし block は agent の記入を待たずに成立するため、記入を agent の遵守だけに委ねると申し送りが `_TODO_` のまま残ります。そのため `src/exec-protection-handoff.ts` が、block した時点で機構側から result の申し送り節へ次を自動記録します(`agent-config-write` / `agent-git-state-write` の双方が対象です)。
568
611
 
@@ -573,17 +616,18 @@ executor / reporter pipelineのexecutor promptは、commitとrepository設定を
573
616
 
574
617
  自動記録は edit result の申し送り節(無い場合は末尾に専用節)へ書き込み、agent が書いた申し送りは残したまま自動記録を後ろへ追加します。同じ result へ再度 block した場合は前回の自動記録を置き換えます。frontmatter と他節(`実施内容` / `変更ファイル` のプレースホルダを含む)は変更しないため、未記入 result を block として扱う判定と終了コードの契約はそのままです。記録先の result が無い run では自動記録を行わず、その旨を実行ログへ出力します。`exec trial` は exec result を持たないため、違反は trial の evidence と標準エラーにのみ残ります。
575
618
 
576
- ### 8.5. pm-members.yaml の値検証(nickname インジェクション対策)
619
+ ### 8.5. agent-members.yaml の値検証(nickname インジェクション対策)
577
620
 
578
- `nickname` は `providers.<provider>.command_template` の `{nickname}` へ無エスケープで展開され、展開後のコマンドは `shell: true` で実行されます。`pm-members.yaml` を書き換えられる者が `nickname` にシェルメタ文字を仕込むと、command 起動時にコマンドインジェクションが成立し得ます。これを次の 2 層で防ぎます。
621
+ `nickname` は `providers.<provider>.command_template` の `{nickname}` へ無エスケープで展開され、展開後のコマンドは `shell: true` で実行されます。これを次の 3 層で防ぎます。
579
622
 
580
- - 入力検証: `pm-members.yaml` の先頭 modeline を `pm-members.schema.yaml` へ向け、CI の `npm run validate:schema` が同じ宣言を読んで検証します。`nickname` は schema の `^[a-z0-9][a-z0-9_-]{0,62}$` に一致しない値を拒否します。
581
- - 実行時の深層防御: 起動コマンドを組み立てる `resolveMemberCommand`(`src/exec-agent-config.ts`)は、`{nickname}` を展開する直前に同じパターンで `nickname` を再検証し、不一致の場合は command を組み立てずに例外を送出します。schema 検証を経ていない `pm-members.yaml` を読み込んだ場合でも、不正な `nickname` が shell へ到達する前に停止します。
623
+ - 書き込み境界: agent 定義を保護対象の `.specdojo/agent-members.yaml` に置きます。
624
+ - 入力検証: `loadMemberRoster` が `agent-members.schema.yaml` を実行時に検証し、`nickname` は `^[a-z0-9][a-z0-9_-]{0,62}$` に一致しない値を拒否します。
625
+ - 実行時の深層防御: 起動コマンドを組み立てる `resolveMemberCommand` は、`{nickname}` を展開する直前に同じパターンで再検証します。
582
626
 
583
627
  再検証のパターンは `pm-members.schema.yaml` の `nickname` と同一に保ちます(一方を変更したら他方も合わせます)。
584
628
 
585
629
  ## 9. 変更手順
586
630
 
587
- 新しい作業要件を追加する場合は、まず `sch-strategy-<track>.yaml` の phase に `capabilities` / `proficiency` を追加します。必要な能力を持つ agent が `pm-members.yaml` に存在しない場合だけ、新しい agent を追加します。
631
+ 新しい作業要件を追加する場合は、まず `sch-strategy-<track>.yaml` の phase に `capabilities` / `proficiency` を追加します。必要な能力を持つ agent が `.specdojo/agent-members.yaml` に存在しない場合だけ、保護設定を変更できる人間または orchestrator が追加します。
588
632
 
589
633
  `approach: rulebook-maintenance` のような進め方の違いも phase に直接定義します。実践の型メンテナンスを通常成果物作業に暗黙で混ぜず、必要な phase として明示します。