specdojo 0.4.4 → 0.4.6

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 (66) hide show
  1. package/.github/agents/specdojo-orchestrator.md +4 -4
  2. package/CHANGELOG.md +31 -0
  3. package/dist/commands/init.js +33 -7
  4. package/dist/devcontainer/scaffold.js +5 -1
  5. package/dist/exec/evidence.js +35 -3
  6. package/dist/exec/pipeline-state.js +1 -0
  7. package/dist/exec/plans-core.js +18 -2
  8. package/dist/exec/plans-generation.js +1 -1
  9. package/dist/exec/register-resume.js +8 -4
  10. package/dist/exec/register.js +47 -14
  11. package/dist/exec/reporter.js +8 -1
  12. package/dist/exec/results.js +1 -1
  13. package/dist/exec/run/agent-pipeline.js +7 -5
  14. package/dist/exec/run/agent.js +14 -1
  15. package/dist/exec/run/in-place.js +7 -4
  16. package/dist/exec/run/register-core.js +10 -2
  17. package/dist/exec/run/register-resume.js +1 -0
  18. package/dist/exec/run/register-worktree.js +7 -1
  19. package/dist/exec/task-repos.js +11 -0
  20. package/dist/exec/worktree-ops-lifecycle.js +4 -2
  21. package/dist/kata/command.js +54 -9
  22. package/dist/register/approach.js +13 -12
  23. package/dist/register/authoring-sources.js +132 -0
  24. package/dist/register/core.js +1 -0
  25. package/dist/register/create-commands.js +84 -15
  26. package/dist/register/events.js +2 -0
  27. package/dist/register/external-project.js +29 -8
  28. package/dist/register/item.js +6 -0
  29. package/dist/register/renumber.js +3 -3
  30. package/dist/register/views.js +3 -0
  31. package/dist/shared/git.js +3 -2
  32. package/dist/shared/lefthook-scaffold.js +5 -22
  33. package/dist/shared/markdownlint-scaffold.js +67 -0
  34. package/dist/shared/provider-scaffold.js +2 -2
  35. package/dist/shared/slidev-scaffold.js +102 -0
  36. package/dist/shared/specdojo-config.js +9 -3
  37. package/docs/ja/specdojo/exec-templates/xep-recipe-authoring-template.md +7 -7
  38. package/docs/ja/specdojo/exec-templates/xep-register-template.md +5 -4
  39. package/docs/ja/specdojo/exec-templates/xep-rulebook-authoring-template.md +7 -7
  40. package/docs/ja/specdojo/exec-templates/xep-sample-authoring-template.md +7 -7
  41. package/docs/ja/specdojo/exec-templates/xep-template-authoring-template.md +7 -7
  42. package/docs/ja/specdojo/guides/exec-config-guide.md +46 -16
  43. package/docs/ja/specdojo/guides/kata-guide.md +111 -2
  44. package/docs/ja/specdojo/guides/orchestrator-operation-guide.md +6 -6
  45. package/docs/ja/specdojo/guides/quick-start-guide.md +4 -2
  46. package/docs/ja/specdojo/guides/register-operation-guide.md +2 -0
  47. package/docs/ja/specdojo/references/command-reference.md +155 -59
  48. package/docs/ja/specdojo/references/specdojo-config-reference.md +2 -0
  49. package/docs/specdojo/schemas/v1/exec-evidence.schema.yaml +17 -1
  50. package/docs/specdojo/schemas/v1/exec-plan-frontmatter.schema.yaml +4 -3
  51. package/docs/specdojo/schemas/v1/exec-result-frontmatter.schema.yaml +3 -3
  52. package/docs/specdojo/schemas/v1/register-events.schema.yaml +1 -0
  53. package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +31 -3
  54. package/package.json +8 -7
  55. package/templates/antigravity/orchestrator.md +4 -4
  56. package/templates/claude/README.md +2 -0
  57. package/templates/claude/agents/specdojo-orchestrator.md +4 -4
  58. package/templates/codex/README.md +38 -9
  59. package/templates/codex/agents/codex-executor.toml +1 -1
  60. package/templates/codex/agents/codex-expert-executor.toml +1 -1
  61. package/templates/codex/agents/codex-expert-review-executor.toml +1 -1
  62. package/templates/codex/agents/codex-review-executor.toml +1 -1
  63. package/templates/codex/agents/specdojo-orchestrator.toml +5 -5
  64. package/templates/codex/orchestrator.md +4 -4
  65. package/templates/init-agent-members.yaml +85 -13
  66. package/templates/opencode/agents/specdojo-orchestrator.md +4 -4
@@ -18,7 +18,17 @@ specdojo:
18
18
  | `agents/*.toml` | `.codex/agents/` | subagent 定義。command template から直接選択はされない |
19
19
  | `rules/*.rules` | `.codex/rules/` | `git push` と全 `gh` を拒否する project-local command rule |
20
20
 
21
- 配布する subagent には、成果物の編集と検証だけを担い result を更新しない `codex-expert-executor` を含みます。
21
+ 配布する `agents/*.toml` のモデルは、名簿の雛形と同じ GPT-6 の 2 段構成(normal は `gpt-6-luna`、expert は `gpt-6.1-sol`)にそろえています。成果物の編集と検証だけを担い result を更新しない `codex-expert-executor` も含みます。
22
+
23
+ | ファイル名 | モデル | reasoning effort | 用途 |
24
+ | ----------------------------------- | ------------- | ---------------- | ------------------------------------------------------------------- |
25
+ | `codex-executor.toml` | `gpt-6-luna` | `medium` | 標準的な成果物の編集と検証(result は更新しない) |
26
+ | `codex-review-executor.toml` | `gpt-6-luna` | `medium` | 多観点レビュー(成果物・result のいずれにも書き込まない) |
27
+ | `codex-expert-executor.toml` | `gpt-6.1-sol` | `high` | 複雑な分析・設計判断を伴う編集と検証(result は更新しない) |
28
+ | `codex-expert-review-executor.toml` | `gpt-6.1-sol` | `high` | 複雑な多観点レビュー(成果物・result のいずれにも書き込まない) |
29
+ | `specdojo-orchestrator.toml` | `gpt-6.1-sol` | `medium` | 対話型オーケストレーター(提案 → 承認 → 実行で CLI 操作を代行する) |
30
+
31
+ ※ `gpt-6-luna` は Max までで Ultra を受け付けないため、Ultra は割り当てません。
22
32
 
23
33
  ## 3. 導入手順
24
34
 
@@ -28,13 +38,13 @@ specdojo:
28
38
  specdojo config scaffold --provider codex
29
39
  ```
30
40
 
31
- `package.json` がある場合は、モデルの系統で名付けた `orch:sol` と `orch:terra` も追加されます。モデルはそれぞれ `gpt-5.6-sol` と `gpt-5.6-terra` を明示して起動します。
41
+ `package.json` がある場合は、モデルの系統で名付けた `orch:sol` と `orch:luna` も追加されます。モデルはそれぞれ `gpt-6.1-sol` と `gpt-6-luna` を明示して起動します。既存の `orch:terra` などのスクリプトは書き換えません。
32
42
 
33
43
  ```json
34
44
  {
35
45
  "scripts": {
36
- "orch:sol": "specdojo orchestrator launch --provider codex -- -m gpt-5.6-sol \"$(cat .specdojo/codex/orchestrator.md)\"",
37
- "orch:terra": "specdojo orchestrator launch --provider codex -- -m gpt-5.6-terra \"$(cat .specdojo/codex/orchestrator.md)\""
46
+ "orch:sol": "specdojo orchestrator launch --provider codex -- -m gpt-6.1-sol \"$(cat .specdojo/codex/orchestrator.md)\"",
47
+ "orch:luna": "specdojo orchestrator launch --provider codex -- -m gpt-6-luna \"$(cat .specdojo/codex/orchestrator.md)\""
38
48
  }
39
49
  }
40
50
  ```
@@ -42,7 +52,7 @@ specdojo config scaffold --provider codex
42
52
  ```sh
43
53
  npm run orch:sol
44
54
  # または
45
- npm run orch:terra
55
+ npm run orch:luna
46
56
  ```
47
57
 
48
58
  コピー後に次を行います。
@@ -71,22 +81,24 @@ npm run orch:terra
71
81
 
72
82
  この構成では Codex executor は `npm run test:unit` を実行し、親 runner が `npm run test:integration` の結果を evidence へ追加する。
73
83
 
74
- 2. SpecDojo が起動する agent をリポジトリ共通の `.specdojo/agent-members.yaml` へ実体と別名の 2 段で定義する。実体は model の系統で名付け(`terra-executor`・`sol-executor` など)、`model` に版を含む ID(`gpt-5.6-terra` など)を持つ。従来の名前(`codex-executor`・`codex-expert-executor` など)は `aliases` で実体を指す別名にする。project ごとの `pm-members.yaml` は人間専用なので、`type: agent` を書かない。
84
+ 2. SpecDojo が起動する agent をリポジトリ共通の `.specdojo/agent-members.yaml` へ実体と別名の 2 段で定義する。実体は model の系統で名付け(`luna-executor`・`sol-executor` など)、`model` に版を含む ID(`gpt-6-luna` など)を持つ。従来の名前(`codex-executor`・`codex-expert-executor` など)は `aliases` で実体を指す別名にする。project ごとの `pm-members.yaml` は人間専用なので、`type: agent` を書かない。
75
85
 
76
86
  ```yaml
77
87
  members:
78
- - nickname: terra-executor
88
+ - nickname: luna-executor
79
89
  provider: codex
80
- model: gpt-5.6-terra
90
+ model: gpt-6-luna
81
91
  mode: edit
82
92
  stage_role: executor
83
93
  proficiency: normal
84
94
  # display_name などの必須項目は省略
85
95
  aliases:
86
96
  - nickname: codex-executor
87
- alias_of: terra-executor
97
+ alias_of: luna-executor
88
98
  ```
89
99
 
100
+ `specdojo init --exec` は codex を 2 段で書く。normal の段は `gpt-6-luna` の `luna-executor`・`luna-review-executor`・`luna-reporter`(別名 `codex-executor`・`codex-review-executor`・`codex-reporter`)、expert の段は `proficiency: expert` を付けた `gpt-6.1-sol` の `sol-executor`・`sol-review-executor`(別名 `codex-expert-executor`・`codex-expert-review-executor`)である。reasoning effort は `by_proficiency` で normal が `medium`、expert が `high` になる(`gpt-6-luna` は Max までで Ultra を受け付けないため、Ultra は割り当てない)。
101
+
90
102
  model を持たない従来の 1 段の member は、`command_params.by_proficiency` に `model` を書けばそのまま動く(member の `model` があればそちらが優先される)。
91
103
 
92
104
  3. scaffold が配置する `.codex/rules/specdojo.rules` を維持する。この rule は Dev Container の共有 GitHub 認証を agent が使わないよう、`git push` と読み取りを含む全 `gh` を `forbidden` にする。project-local rule は信頼済み project で読み込まれる。
@@ -98,3 +110,20 @@ npm run orch:terra
98
110
  - worker のモデルは実体の member の `model`、reasoning effort は `command_params.by_proficiency` で調整する。subagent(`agents/*.toml`)側の `model` / `model_reasoning_effort` は利用プランに合わせて調整する。
99
111
  - `codex-expert-executor` の result 更新禁止は pipeline の責務境界なので維持する。SpecDojo worker としての選択は `.specdojo/agent-members.yaml` の `stage_role: executor` で行い、custom subagent ファイルは起動コマンドから直接選択されない。
100
112
  - 権限設計の背景は `exec-config-guide.md` の `agent 権限とプロンプトインジェクション対策` を参照する。
113
+
114
+ ### 既存の利用者の `.codex/agents` の更新
115
+
116
+ `specdojo config scaffold --provider codex` は既存のファイルを上書きしません。以前の版で生成された `.codex/agents/*.toml`(`gpt-5.4-mini`・`gpt-5.5`・`gpt-5.6-terra` など)を GPT-6 系へ更新する場合は、次のいずれかを行います。
117
+
118
+ 1. **scaffold で一括再配置する場合**:
119
+ 手動のカスタマイズを行っていない場合は、`--force` を指定してテンプレートで上書きします。
120
+
121
+ ```sh
122
+ specdojo config scaffold --provider codex --force
123
+ ```
124
+
125
+ 2. **手動で書き換える場合**:
126
+ 各 `.codex/agents/*.toml` の `model`(および必要に応じて `model_reasoning_effort`)を直接編集します。
127
+ - `codex-executor.toml`・`codex-review-executor.toml`: `model = "gpt-6-luna"`、`model_reasoning_effort = "medium"`
128
+ - `codex-expert-executor.toml`・`codex-expert-review-executor.toml`: `model = "gpt-6.1-sol"`、`model_reasoning_effort = "high"`
129
+ - `specdojo-orchestrator.toml`: `model = "gpt-6.1-sol"`、`model_reasoning_effort = "medium"`
@@ -1,6 +1,6 @@
1
1
  name = "codex-executor"
2
2
  description = "SpecDojo pipeline の executor(edit)subagent。成果物の編集と検証だけを行い、result は更新しない。"
3
- model = "gpt-5.4-mini"
3
+ model = "gpt-6-luna"
4
4
  model_reasoning_effort = "medium"
5
5
  sandbox_mode = "workspace-write"
6
6
  developer_instructions = """
@@ -1,6 +1,6 @@
1
1
  name = "codex-expert-executor"
2
2
  description = "複雑な分析・設計判断を伴う SpecDojo pipeline の executor subagent。成果物の編集と検証だけを行う。"
3
- model = "gpt-5.5"
3
+ model = "gpt-6.1-sol"
4
4
  model_reasoning_effort = "high"
5
5
  sandbox_mode = "workspace-write"
6
6
  developer_instructions = """
@@ -1,6 +1,6 @@
1
1
  name = "codex-expert-review-executor"
2
2
  description = "複雑な多観点レビューを支援する SpecDojo pipeline の executor(review)subagent。成果物・result のいずれにも書き込まない。"
3
- model = "gpt-5.5"
3
+ model = "gpt-6.1-sol"
4
4
  model_reasoning_effort = "high"
5
5
  sandbox_mode = "workspace-write"
6
6
  developer_instructions = """
@@ -1,6 +1,6 @@
1
1
  name = "codex-review-executor"
2
2
  description = "SpecDojo pipeline の executor(review)subagent。成果物を多観点でレビューするだけで、成果物・result のいずれにも書き込まない。"
3
- model = "gpt-5.4-mini"
3
+ model = "gpt-6-luna"
4
4
  model_reasoning_effort = "medium"
5
5
  sandbox_mode = "workspace-write"
6
6
  developer_instructions = """
@@ -1,6 +1,6 @@
1
1
  name = "specdojo-orchestrator"
2
2
  description = "SpecDojo 対話型オーケストレーター。会話から意図を読み取り、specdojo register / exec などを提案→承認→実行で代行する。"
3
- model = "gpt-5.6-terra"
3
+ model = "gpt-6.1-sol"
4
4
  model_reasoning_effort = "medium"
5
5
  sandbox_mode = "workspace-write"
6
6
  approval_policy = "on-request"
@@ -168,12 +168,12 @@ npx specdojo exec validate --project <project-id>
168
168
  - 統合の後に `src` が dist より新しくなると、次の run は始まる前に止まる。dist を作り直してから流す。
169
169
  - 記帳は `register ... --commit` で行う。登録簿の lifecycle のロックを取るため、実行中の run と取り合わない。
170
170
  - 個票の本文を書き換えて普通に commit するのは、統合中の run がないときだけにする(`.git/index.lock` を確かめる)。commit に失敗したら、index に載ったファイルを残さない。残ると次の run の checkpoint が止まる。
171
- - 保護された設定(agent の定義・名簿・`exec-defaults.yaml`・`package.json` など)は、executor が書き換えると統合の前に止まる。完了条件で「案を result に書く」と指示し、反映は利用者の承認のもと feature ブランチで行う。
171
+ - 保護された設定(agent の定義・名簿・`exec-defaults.yaml`・`package.json` など)は、executor が書き換えると統合の前に止まる。register の完了条件では「案を個票の対応結果に書き、pipeline では報告の `handoff` にも書く」と指示する。「案を result に書く」は executor が result を直接書ける実行形式に限る。反映は利用者の承認のもと feature ブランチで行う。
172
172
  - プロジェクトの文書にオーケストレーター向けの運用メモがあれば、作業を始める前に読む。
173
173
 
174
174
  ## close の前の確かめ方
175
175
 
176
- - 完了条件を 1 項目ずつ、差分(`git show`)と result に照らして確かめる。親の検証が通っただけで close しない。
176
+ - 完了条件を 1 項目ずつ、差分(`git show`)と個票の対応結果と result の両方に照らして確かめる。完了条件が求める記録を result だけで未達と判定せず、個票の対応結果にもあるかを確認する。親の検証が通っただけで close しない。
177
177
  - agent の「直した」「反映済み」という報告は、実物(ファイルの中身、生成物、コマンドの出力)で確かめる。agent は、権限で編集を拒まれたあとでも完了と報告することがある。
178
178
  - 完了条件にない変更(特に保護された設定や、利用者の環境に関わる設定)が入っていないかを確かめる。
179
179
  - runner や CLI の動きを変えた項目は、統合の後に実際の `exec run --register` を 1 回流して動作を確かめてから close する。生成物を変えた項目は、空のリポジトリで生成して確かめる。
@@ -197,8 +197,8 @@ npx specdojo exec validate --project <project-id>
197
197
  - 検証できる形で書く。完了条件は `exec plan` の入力になり、曖昧だと agent が意図と違う範囲を実装する。
198
198
  - 作業を終える前に流す検査(型検査・lint・単体テスト)と、通すべき親の検証を書く。
199
199
  - CHANGELOG は未公開の版の節に書き、公開済みの版の節を変えないと書く。
200
- - 保護された設定に触れる場合は、案を result に書き、反映は利用者が行うと書く。
201
- - 未決の点は `_UNDECIDED_` で残すか、executor に決めさせて理由を result に書かせるかを明記する。
200
+ - 保護された設定に触れる場合、register の項目では案を個票の対応結果に書き、pipeline では報告の `handoff` にも書く。反映は利用者の承認のもとで行うと書く。「result に書く」は executor が result を直接書ける実行形式に限る。
201
+ - 未決の点は `_UNDECIDED_` で残すか、executor に決めさせて理由を記録させるかを明記する。register の項目では個票の対応結果に書かせ、pipeline では報告の `handoff` にも書かせる。「result に書く」は executor が result を直接書ける実行形式に限る。
202
202
  - Markdown では、`*` や `_` を含む語(glob など)をコードの書式にする。コードの書式の中を空白で始めたり終えたりしない。
203
203
 
204
204
  ## agent の選び方
@@ -161,12 +161,12 @@ npx specdojo exec validate --project <project-id>
161
161
  - 統合の後に `src` が dist より新しくなると、次の run は始まる前に止まる。dist を作り直してから流す。
162
162
  - 記帳は `register ... --commit` で行う。登録簿の lifecycle のロックを取るため、実行中の run と取り合わない。
163
163
  - 個票の本文を書き換えて普通に commit するのは、統合中の run がないときだけにする(`.git/index.lock` を確かめる)。commit に失敗したら、index に載ったファイルを残さない。残ると次の run の checkpoint が止まる。
164
- - 保護された設定(agent の定義・名簿・`exec-defaults.yaml`・`package.json` など)は、executor が書き換えると統合の前に止まる。完了条件で「案を result に書く」と指示し、反映は利用者の承認のもと feature ブランチで行う。
164
+ - 保護された設定(agent の定義・名簿・`exec-defaults.yaml`・`package.json` など)は、executor が書き換えると統合の前に止まる。register の完了条件では「案を個票の対応結果に書き、pipeline では報告の `handoff` にも書く」と指示する。「案を result に書く」は executor が result を直接書ける実行形式に限る。反映は利用者の承認のもと feature ブランチで行う。
165
165
  - プロジェクトの文書にオーケストレーター向けの運用メモがあれば、作業を始める前に読む。
166
166
 
167
167
  ## close の前の確かめ方
168
168
 
169
- - 完了条件を 1 項目ずつ、差分(`git show`)と result に照らして確かめる。親の検証が通っただけで close しない。
169
+ - 完了条件を 1 項目ずつ、差分(`git show`)と個票の対応結果と result の両方に照らして確かめる。完了条件が求める記録を result だけで未達と判定せず、個票の対応結果にもあるかを確認する。親の検証が通っただけで close しない。
170
170
  - agent の「直した」「反映済み」という報告は、実物(ファイルの中身、生成物、コマンドの出力)で確かめる。agent は、権限で編集を拒まれたあとでも完了と報告することがある。
171
171
  - 完了条件にない変更(特に保護された設定や、利用者の環境に関わる設定)が入っていないかを確かめる。
172
172
  - runner や CLI の動きを変えた項目は、統合の後に実際の `exec run --register` を 1 回流して動作を確かめてから close する。生成物を変えた項目は、空のリポジトリで生成して確かめる。
@@ -190,8 +190,8 @@ npx specdojo exec validate --project <project-id>
190
190
  - 検証できる形で書く。完了条件は `exec plan` の入力になり、曖昧だと agent が意図と違う範囲を実装する。
191
191
  - 作業を終える前に流す検査(型検査・lint・単体テスト)と、通すべき親の検証を書く。
192
192
  - CHANGELOG は未公開の版の節に書き、公開済みの版の節を変えないと書く。
193
- - 保護された設定に触れる場合は、案を result に書き、反映は利用者が行うと書く。
194
- - 未決の点は `_UNDECIDED_` で残すか、executor に決めさせて理由を result に書かせるかを明記する。
193
+ - 保護された設定に触れる場合、register の項目では案を個票の対応結果に書き、pipeline では報告の `handoff` にも書く。反映は利用者の承認のもとで行うと書く。「result に書く」は executor が result を直接書ける実行形式に限る。
194
+ - 未決の点は `_UNDECIDED_` で残すか、executor に決めさせて理由を記録させるかを明記する。register の項目では個票の対応結果に書かせ、pipeline では報告の `handoff` にも書かせる。「result に書く」は executor が result を直接書ける実行形式に限る。
195
195
  - Markdown では、`*` や `_` を含む語(glob など)をコードの書式にする。コードの書式の中を空白で始めたり終えたりしない。
196
196
 
197
197
  ## agent の選び方
@@ -4,12 +4,19 @@
4
4
  # aliases whose target member was selected.
5
5
  #
6
6
  # The roster has two levels (PJR-ZM1K):
7
- # members : concrete agents named after the model family (sonnet-executor, terra-executor, ...).
7
+ # members : concrete agents named after the model family (sonnet-executor, luna-executor, ...).
8
8
  # Each member carries the provider, model, and role. The model version is written
9
9
  # only in `model`, so replacing a model touches one place.
10
10
  # aliases : the earlier names (claude-executor, codex-executor, ...). Each alias points at a
11
11
  # concrete member, so Jobs, routines, documents, and user settings keep working.
12
12
  # Events and results record the concrete member name, so the model that actually ran is kept.
13
+ #
14
+ # Claude and Codex have two tiers (PJR-9482):
15
+ # normal : sonnet (claude) and gpt-6-luna (codex). Medium/easy items and every reporter use it.
16
+ # expert : opus (claude) and gpt-6.1-sol (codex), marked with `proficiency: expert`.
17
+ # Hard items use it through the claude-expert-* and codex-expert-* aliases.
18
+ # The reasoning effort comes from exec-defaults.yaml (providers.codex.command_params.by_proficiency:
19
+ # normal -> medium, expert -> high). gpt-6-luna accepts up to Max, so it never receives Ultra.
13
20
  version: 1
14
21
  members:
15
22
  - nickname: sonnet-executor
@@ -55,13 +62,42 @@ members:
55
62
  persona: execution-reporter
56
63
  scheduler_strategy: fifo
57
64
 
58
- - nickname: terra-executor
59
- display_name: Codex Terra Executor
65
+ - nickname: opus-executor
66
+ display_name: Claude Opus Executor
67
+ email: null
68
+ roles: []
69
+ type: agent
70
+ provider: claude
71
+ model: opus
72
+ mode: edit
73
+ stage_role: executor
74
+ capabilities: [web_search]
75
+ proficiency: expert
76
+ priority: 2
77
+ persona: task-executor
78
+ scheduler_strategy: critical-first
79
+ - nickname: opus-review-executor
80
+ display_name: Claude Opus Review Executor
81
+ email: null
82
+ roles: []
83
+ type: agent
84
+ provider: claude
85
+ model: opus
86
+ mode: review
87
+ stage_role: executor
88
+ capabilities: [web_search]
89
+ proficiency: expert
90
+ priority: 2
91
+ persona: multi-viewpoint-reviewer
92
+ scheduler_strategy: fifo
93
+
94
+ - nickname: luna-executor
95
+ display_name: Codex Luna Executor
60
96
  email: null
61
97
  roles: []
62
98
  type: agent
63
99
  provider: codex
64
- model: gpt-5.6-terra
100
+ model: gpt-6-luna
65
101
  mode: edit
66
102
  stage_role: executor
67
103
  capabilities: [web_search]
@@ -69,13 +105,13 @@ members:
69
105
  priority: 1
70
106
  persona: task-executor
71
107
  scheduler_strategy: critical-first
72
- - nickname: terra-review-executor
73
- display_name: Codex Terra Review Executor
108
+ - nickname: luna-review-executor
109
+ display_name: Codex Luna Review Executor
74
110
  email: null
75
111
  roles: []
76
112
  type: agent
77
113
  provider: codex
78
- model: gpt-5.6-terra
114
+ model: gpt-6-luna
79
115
  mode: review
80
116
  stage_role: executor
81
117
  capabilities: [web_search]
@@ -83,19 +119,47 @@ members:
83
119
  priority: 1
84
120
  persona: multi-viewpoint-reviewer
85
121
  scheduler_strategy: fifo
86
- - nickname: terra-reporter
87
- display_name: Codex Terra Reporter
122
+ - nickname: luna-reporter
123
+ display_name: Codex Luna Reporter
88
124
  email: null
89
125
  roles: []
90
126
  type: agent
91
127
  provider: codex
92
- model: gpt-5.6-terra
128
+ model: gpt-6-luna
93
129
  stage_role: reporter
94
130
  capabilities: []
95
131
  proficiency: normal
96
132
  priority: 1
97
133
  persona: execution-reporter
98
134
  scheduler_strategy: fifo
135
+ - nickname: sol-executor
136
+ display_name: Codex Sol Executor
137
+ email: null
138
+ roles: []
139
+ type: agent
140
+ provider: codex
141
+ model: gpt-6.1-sol
142
+ mode: edit
143
+ stage_role: executor
144
+ capabilities: [web_search]
145
+ proficiency: expert
146
+ priority: 1
147
+ persona: task-executor
148
+ scheduler_strategy: critical-first
149
+ - nickname: sol-review-executor
150
+ display_name: Codex Sol Review Executor
151
+ email: null
152
+ roles: []
153
+ type: agent
154
+ provider: codex
155
+ model: gpt-6.1-sol
156
+ mode: review
157
+ stage_role: executor
158
+ capabilities: [web_search]
159
+ proficiency: expert
160
+ priority: 1
161
+ persona: multi-viewpoint-reviewer
162
+ scheduler_strategy: fifo
99
163
 
100
164
  - nickname: gemma-executor
101
165
  display_name: OpenCode Gemma Executor
@@ -230,12 +294,20 @@ aliases:
230
294
  alias_of: sonnet-review-executor
231
295
  - nickname: claude-reporter
232
296
  alias_of: sonnet-reporter
297
+ - nickname: claude-expert-executor
298
+ alias_of: opus-executor
299
+ - nickname: claude-expert-review-executor
300
+ alias_of: opus-review-executor
233
301
  - nickname: codex-executor
234
- alias_of: terra-executor
302
+ alias_of: luna-executor
235
303
  - nickname: codex-review-executor
236
- alias_of: terra-review-executor
304
+ alias_of: luna-review-executor
237
305
  - nickname: codex-reporter
238
- alias_of: terra-reporter
306
+ alias_of: luna-reporter
307
+ - nickname: codex-expert-executor
308
+ alias_of: sol-executor
309
+ - nickname: codex-expert-review-executor
310
+ alias_of: sol-review-executor
239
311
  - nickname: opencode-executor
240
312
  alias_of: gemma-executor
241
313
  - nickname: opencode-review-executor
@@ -262,12 +262,12 @@ npx specdojo exec validate --project <project-id>
262
262
  - 統合の後に `src` が dist より新しくなると、次の run は始まる前に止まる。dist を作り直してから流す。
263
263
  - 記帳は `register ... --commit` で行う。登録簿の lifecycle のロックを取るため、実行中の run と取り合わない。
264
264
  - 個票の本文を書き換えて普通に commit するのは、統合中の run がないときだけにする(`.git/index.lock` を確かめる)。commit に失敗したら、index に載ったファイルを残さない。残ると次の run の checkpoint が止まる。
265
- - 保護された設定(agent の定義・名簿・`exec-defaults.yaml`・`package.json` など)は、executor が書き換えると統合の前に止まる。完了条件で「案を result に書く」と指示し、反映は利用者の承認のもと feature ブランチで行う。
265
+ - 保護された設定(agent の定義・名簿・`exec-defaults.yaml`・`package.json` など)は、executor が書き換えると統合の前に止まる。register の完了条件では「案を個票の対応結果に書き、pipeline では報告の `handoff` にも書く」と指示する。「案を result に書く」は executor が result を直接書ける実行形式に限る。反映は利用者の承認のもと feature ブランチで行う。
266
266
  - プロジェクトの文書にオーケストレーター向けの運用メモがあれば、作業を始める前に読む。
267
267
 
268
268
  ## close の前の確かめ方
269
269
 
270
- - 完了条件を 1 項目ずつ、差分(`git show`)と result に照らして確かめる。親の検証が通っただけで close しない。
270
+ - 完了条件を 1 項目ずつ、差分(`git show`)と個票の対応結果と result の両方に照らして確かめる。完了条件が求める記録を result だけで未達と判定せず、個票の対応結果にもあるかを確認する。親の検証が通っただけで close しない。
271
271
  - agent の「直した」「反映済み」という報告は、実物(ファイルの中身、生成物、コマンドの出力)で確かめる。agent は、権限で編集を拒まれたあとでも完了と報告することがある。
272
272
  - 完了条件にない変更(特に保護された設定や、利用者の環境に関わる設定)が入っていないかを確かめる。
273
273
  - runner や CLI の動きを変えた項目は、統合の後に実際の `exec run --register` を 1 回流して動作を確かめてから close する。生成物を変えた項目は、空のリポジトリで生成して確かめる。
@@ -291,8 +291,8 @@ npx specdojo exec validate --project <project-id>
291
291
  - 検証できる形で書く。完了条件は `exec plan` の入力になり、曖昧だと agent が意図と違う範囲を実装する。
292
292
  - 作業を終える前に流す検査(型検査・lint・単体テスト)と、通すべき親の検証を書く。
293
293
  - CHANGELOG は未公開の版の節に書き、公開済みの版の節を変えないと書く。
294
- - 保護された設定に触れる場合は、案を result に書き、反映は利用者が行うと書く。
295
- - 未決の点は `_UNDECIDED_` で残すか、executor に決めさせて理由を result に書かせるかを明記する。
294
+ - 保護された設定に触れる場合、register の項目では案を個票の対応結果に書き、pipeline では報告の `handoff` にも書く。反映は利用者の承認のもとで行うと書く。「result に書く」は executor が result を直接書ける実行形式に限る。
295
+ - 未決の点は `_UNDECIDED_` で残すか、executor に決めさせて理由を記録させるかを明記する。register の項目では個票の対応結果に書かせ、pipeline では報告の `handoff` にも書かせる。「result に書く」は executor が result を直接書ける実行形式に限る。
296
296
  - Markdown では、`*` や `_` を含む語(glob など)をコードの書式にする。コードの書式の中を空白で始めたり終えたりしない。
297
297
 
298
298
  ## agent の選び方