specdojo 0.4.5 → 0.4.7

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 (101) hide show
  1. package/.github/agents/specdojo-orchestrator.md +4 -4
  2. package/CHANGELOG.md +41 -0
  3. package/dist/catalog/document-target.js +75 -0
  4. package/dist/commands/agent.js +2 -80
  5. package/dist/commands/init.js +33 -7
  6. package/dist/devcontainer/scaffold.js +5 -1
  7. package/dist/exec/agent-config.js +28 -16
  8. package/dist/exec/agent-plan.js +108 -0
  9. package/dist/exec/commands.js +3 -3
  10. package/dist/exec/evidence.js +35 -3
  11. package/dist/exec/grade-checkpoint.js +12 -0
  12. package/dist/exec/pipeline-state.js +1 -0
  13. package/dist/exec/plans-core.js +11 -67
  14. package/dist/exec/plans-generation.js +22 -5
  15. package/dist/exec/project.js +4 -1
  16. package/dist/exec/register-resume.js +8 -4
  17. package/dist/exec/register.js +66 -5
  18. package/dist/exec/reporter.js +8 -1
  19. package/dist/exec/results.js +1 -1
  20. package/dist/exec/run/agent-pipeline.js +7 -5
  21. package/dist/exec/run/agent.js +14 -1
  22. package/dist/exec/run/lifecycle-commands.js +2 -0
  23. package/dist/exec/run/register-resume.js +2 -0
  24. package/dist/exec/run/register-state.js +4 -1
  25. package/dist/exec/run/register-worktree.js +8 -1
  26. package/dist/exec/run/schedule-prepare.js +7 -1
  27. package/dist/exec/worktree-command.js +8 -1
  28. package/dist/exec/worktree-ops-lifecycle.js +4 -2
  29. package/dist/exec/worktree-ops-merge.js +40 -1
  30. package/dist/grade/apply.js +7 -5
  31. package/dist/grade/command-inspect.js +2 -1
  32. package/dist/grade/command-run.js +39 -0
  33. package/dist/grade/grade.js +3 -1
  34. package/dist/grade/markdown.js +4 -4
  35. package/dist/grade/pipeline-state.js +8 -6
  36. package/dist/grade/plan.js +8 -6
  37. package/dist/grade/run.js +307 -0
  38. package/dist/grade/target-discovery.js +1 -1
  39. package/dist/grade/targets.js +44 -22
  40. package/dist/kata/command.js +54 -9
  41. package/dist/register/approach.js +16 -0
  42. package/dist/register/core.js +2 -0
  43. package/dist/register/create-commands.js +57 -7
  44. package/dist/register/deliverable-target.js +215 -0
  45. package/dist/register/events.js +4 -0
  46. package/dist/register/external-project.js +18 -7
  47. package/dist/register/item.js +8 -0
  48. package/dist/register/views.js +3 -0
  49. package/dist/review/grade.js +19 -17
  50. package/dist/shared/agent-plan.js +1 -0
  51. package/dist/shared/git.js +3 -2
  52. package/dist/shared/lefthook-scaffold.js +5 -22
  53. package/dist/shared/markdownlint-scaffold.js +67 -0
  54. package/dist/shared/provider-scaffold.js +7 -5
  55. package/dist/shared/slidev-scaffold.js +102 -0
  56. package/dist/shared/specdojo-config.js +9 -3
  57. package/dist/specdojo.js +5 -1
  58. package/docs/ja/specdojo/exec-templates/xep-register-template.md +5 -4
  59. package/docs/ja/specdojo/exec-templates/xrp-freeform-template.md +2 -2
  60. package/docs/ja/specdojo/exec-templates/xrp-fully-guided-template.md +2 -2
  61. package/docs/ja/specdojo/exec-templates/xrp-recipe-guided-template.md +2 -2
  62. package/docs/ja/specdojo/exec-templates/xrp-recipe-maintenance-template.md +2 -2
  63. package/docs/ja/specdojo/exec-templates/xrp-retrofit-template.md +2 -2
  64. package/docs/ja/specdojo/exec-templates/xrp-rulebook-maintenance-template.md +2 -2
  65. package/docs/ja/specdojo/exec-templates/xrp-sample-maintenance-template.md +2 -2
  66. package/docs/ja/specdojo/exec-templates/xrp-template-maintenance-template.md +2 -2
  67. package/docs/ja/specdojo/exec-templates/xrp-template.md +2 -2
  68. package/docs/ja/specdojo/guides/exec-config-guide.md +81 -19
  69. package/docs/ja/specdojo/guides/exec-operation-guide.md +4 -0
  70. package/docs/ja/specdojo/guides/kata-guide.md +108 -1
  71. package/docs/ja/specdojo/guides/orchestrator-operation-guide.md +6 -6
  72. package/docs/ja/specdojo/guides/plan-result-lifecycle-guide.md +3 -1
  73. package/docs/ja/specdojo/guides/quick-start-guide.md +22 -2
  74. package/docs/ja/specdojo/guides/register-operation-guide.md +2 -0
  75. package/docs/ja/specdojo/guides/remote-host-development-guide.md +15 -1
  76. package/docs/ja/specdojo/guides/review-guide.md +2 -2
  77. package/docs/ja/specdojo/guides/ryu-guide.md +12 -0
  78. package/docs/ja/specdojo/references/command-reference.md +178 -62
  79. package/docs/ja/specdojo/references/specdojo-config-reference.md +31 -8
  80. package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +28 -22
  81. package/docs/specdojo/schemas/v1/exec-evidence.schema.yaml +17 -1
  82. package/docs/specdojo/schemas/v1/grade-pipeline-state.schema.yaml +1 -1
  83. package/docs/specdojo/schemas/v1/register-events.schema.yaml +2 -0
  84. package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +33 -1
  85. package/docs/specdojo/schemas/v1/specdojo-config.schema.yaml +16 -3
  86. package/package.json +5 -5
  87. package/templates/antigravity/orchestrator.md +4 -4
  88. package/templates/claude/README.md +2 -0
  89. package/templates/claude/agents/specdojo-orchestrator.md +4 -4
  90. package/templates/codex/README.md +38 -9
  91. package/templates/codex/agents/codex-executor.toml +1 -1
  92. package/templates/codex/agents/codex-expert-executor.toml +1 -1
  93. package/templates/codex/agents/codex-expert-review-executor.toml +1 -1
  94. package/templates/codex/agents/codex-review-executor.toml +1 -1
  95. package/templates/codex/agents/specdojo-orchestrator.toml +5 -5
  96. package/templates/codex/orchestrator.md +4 -4
  97. package/templates/devcontainer/devcontainer.json +1 -0
  98. package/templates/init-agent-members.yaml +131 -16
  99. package/templates/opencode/README.md +118 -14
  100. package/templates/opencode/agents/specdojo-orchestrator.md +5 -5
  101. package/templates/opencode/opencode.json +25 -0
@@ -85,6 +85,28 @@ properties:
85
85
  - recipe-authoring
86
86
  - sample-authoring
87
87
  - template-authoring
88
+ - if:
89
+ anyOf:
90
+ - required: [target_path]
91
+ properties:
92
+ target_path: true
93
+ - required: [target_rulebook]
94
+ properties:
95
+ target_rulebook: true
96
+ then:
97
+ required: [approach]
98
+ properties:
99
+ approach:
100
+ enum:
101
+ [
102
+ fully-guided,
103
+ recipe-guided,
104
+ freeform,
105
+ retrofit,
106
+ bootstrap,
107
+ finalize,
108
+ bootstrap-finalize,
109
+ ]
88
110
  - type: object
89
111
  required:
90
112
  - rulebook
@@ -226,13 +248,23 @@ properties:
226
248
  minItems: 1
227
249
  description: >
228
250
  Doc ids of documents this register item targets. Deliverable targets
229
- used with an approach are resolved via the project catalog so that
251
+ used with an approach prefer the project catalog; target_path and target_rulebook or existing frontmatter allow catalog-less resolution so that
230
252
  not-yet-created deliverables can be selected; kata and standalone
231
253
  targets are resolved via the doc index. When present, exec plan
232
254
  generation copies these into the plan frontmatter so that target
233
255
  coverage validation works for register-originated plans. Omit the
234
256
  key when the target documents are unknown or not applicable.
235
257
 
258
+ target_path:
259
+ type: string
260
+ minLength: 1
261
+ description: Repository-relative deliverable path for catalog-less resolution.
262
+
263
+ target_rulebook:
264
+ type: string
265
+ minLength: 1
266
+ description: Deliverable rulebook id; bootstrap requires a new id under kata_authority.
267
+
236
268
  sources:
237
269
  type: array
238
270
  items:
@@ -166,9 +166,22 @@ $defs:
166
166
  type: string
167
167
  parent_validations:
168
168
  description: >-
169
- Parent-runner validations appended, in order, to pipeline.parent_validations from this
170
- project's exec_defaults file. A plain ID targets the project repository; { id, repo }
171
- targets project or a product repository declared by this project.
169
+ Parent-runner validations appended, in order, after parent_validations_exclude removes
170
+ matching entries from pipeline.parent_validations in this project's exec_defaults file.
171
+ A plain ID targets the project repository; { id, repo } targets project or a product
172
+ repository declared by this project. Duplicate ID/repository pairs in the effective list
173
+ are rejected before agent launch.
174
+ type: array
175
+ uniqueItems: true
176
+ items:
177
+ $ref: "#/$defs/ParentValidation"
178
+ parent_validations_exclude:
179
+ description: >-
180
+ Remove these ID/repository pairs from shared pipeline.parent_validations before appending
181
+ this project's parent_validations. Omitted or [] preserves the shared list. A plain ID
182
+ matches only the project repository, equivalently { id, repo: project }. Every exclusion
183
+ must exist in the shared list; missing entries and duplicate pairs are configuration
184
+ errors checked by the CLI before agent launch. Other projects are unaffected.
172
185
  type: array
173
186
  uniqueItems: true
174
187
  items:
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "specdojo",
3
- "version": "0.4.5",
3
+ "version": "0.4.7",
4
4
  "description": "A dojo for Spec-Dō, the way of specification: decide with a register, write specs and designs with kata, and keep sharpening them with AI.",
5
5
  "license": "MIT",
6
6
  "author": "naoji3x",
@@ -63,10 +63,10 @@
63
63
  "orch:sonnet:work": "tools/worktree/open-agent-worktree.sh claude-work tsx \"$(pwd)/src/specdojo.ts\" orchestrator launch --provider claude -- --agent specdojo-orchestrator --model sonnet",
64
64
  "orch:opus": "tsx src/specdojo.ts orchestrator launch --provider claude -- --agent specdojo-orchestrator --model opus",
65
65
  "orch:opus:work": "tools/worktree/open-agent-worktree.sh claude-work tsx \"$(pwd)/src/specdojo.ts\" orchestrator launch --provider claude -- --agent specdojo-orchestrator --model opus",
66
- "orch:terra": "tsx src/specdojo.ts orchestrator launch --provider codex -- -m gpt-5.6-terra \"$(cat .agents/specdojo-orchestrator.agent.md)\"",
67
- "orch:terra:work": "tools/worktree/open-agent-worktree.sh codex-work tsx \"$(pwd)/src/specdojo.ts\" orchestrator launch --provider codex -- -m gpt-5.6-terra \"$(cat .agents/specdojo-orchestrator.agent.md)\"",
68
- "orch:sol": "tsx src/specdojo.ts orchestrator launch --provider codex -- -m gpt-5.6-sol \"$(cat .agents/specdojo-orchestrator.agent.md)\"",
69
- "orch:sol:work": "tools/worktree/open-agent-worktree.sh codex-work tsx \"$(pwd)/src/specdojo.ts\" orchestrator launch --provider codex -- -m gpt-5.6-sol \"$(cat .agents/specdojo-orchestrator.agent.md)\"",
66
+ "orch:luna": "tsx src/specdojo.ts orchestrator launch --provider codex -- -m gpt-6-luna \"$(cat .agents/specdojo-orchestrator.agent.md)\"",
67
+ "orch:luna:work": "tools/worktree/open-agent-worktree.sh codex-work tsx \"$(pwd)/src/specdojo.ts\" orchestrator launch --provider codex -- -m gpt-6-luna \"$(cat .agents/specdojo-orchestrator.agent.md)\"",
68
+ "orch:sol": "tsx src/specdojo.ts orchestrator launch --provider codex -- -m gpt-6.1-sol \"$(cat .agents/specdojo-orchestrator.agent.md)\"",
69
+ "orch:sol:work": "tools/worktree/open-agent-worktree.sh codex-work tsx \"$(pwd)/src/specdojo.ts\" orchestrator launch --provider codex -- -m gpt-6.1-sol \"$(cat .agents/specdojo-orchestrator.agent.md)\"",
70
70
  "orch:copilot": "tsx src/specdojo.ts orchestrator launch --provider copilot -- --agent specdojo-orchestrator",
71
71
  "orch:copilot:work": "tools/worktree/open-agent-worktree.sh copilot-work tsx \"$(pwd)/src/specdojo.ts\" orchestrator launch --provider copilot -- --agent specdojo-orchestrator",
72
72
  "orch:flash": "tsx src/specdojo.ts orchestrator launch --provider antigravity -- --add-dir \"$(pwd)\" --model gemini-3.8-flash-high -i \"$(cat .agents/specdojo-orchestrator.agent.md)\"",
@@ -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 の選び方
@@ -48,6 +48,8 @@ providers:
48
48
 
49
49
  `.specdojo/agent-members.yaml` は実体と別名の 2 段で書く。実体は model の系統で名付け(`sonnet-executor`・`opus-executor` など)、`model` に `sonnet` / `opus` を持つ。従来の名前(`claude-executor`・`claude-expert-executor` など)は `aliases` で実体を指す別名にする。
50
50
 
51
+ `specdojo init --exec` は claude を 2 段で書く。normal の段は `sonnet-executor`・`sonnet-review-executor`・`sonnet-reporter`(別名 `claude-executor`・`claude-review-executor`・`claude-reporter`)、expert の段は `proficiency: expert` の `opus-executor`・`opus-review-executor`(別名 `claude-expert-executor`・`claude-expert-review-executor`)である。振り分けの表(`routing`)は hard を expert の別名、medium・easy と reporter を normal の別名にする。
52
+
51
53
  ```yaml
52
54
  members:
53
55
  - nickname: opus-executor
@@ -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 の選び方
@@ -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 の選び方
@@ -5,6 +5,7 @@
5
5
  "init": true,
6
6
  "workspaceMount": "source=${localWorkspaceFolder}/..,target=/workspaces/__SPECDOJO_WORKSPACE_NAME__,type=bind,consistency=cached",
7
7
  "workspaceFolder": "/workspaces/__SPECDOJO_WORKSPACE_NAME__/${localWorkspaceFolderBasename}",
8
+ "shutdownAction": "none",
8
9
  "features": {
9
10
  "ghcr.io/devcontainers/features/common-utils:2": {
10
11
  "installZsh": false,
@@ -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
@@ -103,7 +167,7 @@ members:
103
167
  roles: []
104
168
  type: agent
105
169
  provider: opencode
106
- model: ollama-local/gemma4:31b
170
+ model: ollama-local/gemma4:31b-mlx-work-64k
107
171
  mode: edit
108
172
  stage_role: executor
109
173
  capabilities: [web_search]
@@ -117,7 +181,7 @@ members:
117
181
  roles: []
118
182
  type: agent
119
183
  provider: opencode
120
- model: ollama-local/gemma4:31b
184
+ model: ollama-local/gemma4:31b-mlx-work-64k
121
185
  mode: review
122
186
  stage_role: executor
123
187
  capabilities: [web_search]
@@ -131,7 +195,50 @@ members:
131
195
  roles: []
132
196
  type: agent
133
197
  provider: opencode
134
- model: ollama-local/gemma4:26b
198
+ model: ollama-local/gemma4:26b-mlx-work-64k
199
+ mode: report
200
+ stage_role: reporter
201
+ capabilities: []
202
+ proficiency: normal
203
+ priority: 3
204
+ persona: execution-reporter
205
+ scheduler_strategy: fifo
206
+
207
+ - nickname: qwen-executor
208
+ display_name: OpenCode Qwen Executor
209
+ email: null
210
+ roles: []
211
+ type: agent
212
+ provider: opencode
213
+ model: ollama-local/qwen3.8:27b-mlx-work-64k
214
+ mode: edit
215
+ stage_role: executor
216
+ capabilities: [web_search]
217
+ proficiency: normal
218
+ priority: 3
219
+ persona: task-executor
220
+ scheduler_strategy: critical-first
221
+ - nickname: qwen-review-executor
222
+ display_name: OpenCode Qwen Review Executor
223
+ email: null
224
+ roles: []
225
+ type: agent
226
+ provider: opencode
227
+ model: ollama-local/qwen3.8:27b-mlx-work-64k
228
+ mode: review
229
+ stage_role: executor
230
+ capabilities: [web_search]
231
+ proficiency: normal
232
+ priority: 3
233
+ persona: multi-viewpoint-reviewer
234
+ scheduler_strategy: fifo
235
+ - nickname: qwen-reporter
236
+ display_name: OpenCode Qwen Reporter
237
+ email: null
238
+ roles: []
239
+ type: agent
240
+ provider: opencode
241
+ model: ollama-local/qwen3.8:27b-mlx-work-64k
135
242
  mode: report
136
243
  stage_role: reporter
137
244
  capabilities: []
@@ -230,12 +337,20 @@ aliases:
230
337
  alias_of: sonnet-review-executor
231
338
  - nickname: claude-reporter
232
339
  alias_of: sonnet-reporter
340
+ - nickname: claude-expert-executor
341
+ alias_of: opus-executor
342
+ - nickname: claude-expert-review-executor
343
+ alias_of: opus-review-executor
233
344
  - nickname: codex-executor
234
- alias_of: terra-executor
345
+ alias_of: luna-executor
235
346
  - nickname: codex-review-executor
236
- alias_of: terra-review-executor
347
+ alias_of: luna-review-executor
237
348
  - nickname: codex-reporter
238
- alias_of: terra-reporter
349
+ alias_of: luna-reporter
350
+ - nickname: codex-expert-executor
351
+ alias_of: sol-executor
352
+ - nickname: codex-expert-review-executor
353
+ alias_of: sol-review-executor
239
354
  - nickname: opencode-executor
240
355
  alias_of: gemma-executor
241
356
  - nickname: opencode-review-executor