specdojo 0.4.0 → 0.4.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (77) hide show
  1. package/.github/agents/specdojo-orchestrator.md +61 -2
  2. package/CHANGELOG.md +43 -0
  3. package/README.md +8 -7
  4. package/dist/commands/init.js +72 -15
  5. package/dist/commands/night-orchestrator.js +287 -0
  6. package/dist/commands/orchestrator.js +10 -3
  7. package/dist/devcontainer/command.js +3 -1
  8. package/dist/devcontainer/scaffold.js +166 -5
  9. package/dist/exec/agent-config.js +60 -2
  10. package/dist/exec/parent-validation.js +14 -0
  11. package/dist/exec/pipeline-state.js +13 -0
  12. package/dist/exec/register.js +23 -1
  13. package/dist/exec/repo-integration.js +1 -1
  14. package/dist/exec/reporter.js +113 -13
  15. package/dist/exec/results.js +36 -14
  16. package/dist/exec/run/agent-pipeline.js +3 -0
  17. package/dist/exec/run/agent.js +40 -5
  18. package/dist/exec/run/job.js +2 -2
  19. package/dist/exec/run/lifecycle-commands.js +2 -2
  20. package/dist/exec/run/register-command.js +23 -4
  21. package/dist/exec/run/register-core.js +17 -0
  22. package/dist/exec/run/register-mode.js +39 -16
  23. package/dist/exec/run/register-post-review.js +420 -0
  24. package/dist/exec/run/register-resume.js +27 -11
  25. package/dist/exec/run/register-worktree.js +66 -2
  26. package/dist/exec/run/run.js +1 -1
  27. package/dist/exec/run/shared.js +22 -24
  28. package/dist/exec/task-repos.js +102 -15
  29. package/dist/register/core.js +14 -2
  30. package/dist/register/create-commands.js +62 -6
  31. package/dist/register/event-merge.js +13 -1
  32. package/dist/register/events.js +4 -0
  33. package/dist/register/item.js +9 -0
  34. package/dist/register/migration.js +1 -0
  35. package/dist/register/register.js +2 -2
  36. package/dist/shared/git.js +45 -15
  37. package/dist/shared/provider-scaffold.js +3 -2
  38. package/dist/shared/specdojo-config.js +69 -16
  39. package/dist/shared/text.js +4 -1
  40. package/dist/shared/workspace-scaffold.js +69 -0
  41. package/docs/ja/specdojo/exec-templates/xep-common-conventions-template.md +2 -1
  42. package/docs/ja/specdojo/exec-templates/xep-register-template.md +2 -0
  43. package/docs/ja/specdojo/exec-templates/xrp-register-post-run-template.md +46 -0
  44. package/docs/ja/specdojo/guides/branch-workflow-guide.md +34 -1
  45. package/docs/ja/specdojo/guides/docs-structure-guide.md +2 -0
  46. package/docs/ja/specdojo/guides/exec-config-guide.md +79 -11
  47. package/docs/ja/specdojo/guides/exec-operation-guide.md +39 -1
  48. package/docs/ja/specdojo/guides/orchestrator-operation-guide.md +9 -3
  49. package/docs/ja/specdojo/guides/quick-start-guide.md +9 -6
  50. package/docs/ja/specdojo/guides/register-operation-guide.md +42 -0
  51. package/docs/ja/specdojo/guides/remote-host-development-guide.md +52 -6
  52. package/docs/ja/specdojo/guides/specdojo-overview-guide.md +1 -1
  53. package/docs/ja/specdojo/guides/waza-guide.md +1 -1
  54. package/docs/ja/specdojo/references/command-reference.md +101 -56
  55. package/docs/ja/specdojo/references/specdojo-config-reference.md +33 -7
  56. package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +5 -2
  57. package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +92 -18
  58. package/docs/specdojo/schemas/v1/exec-evidence.schema.yaml +6 -1
  59. package/docs/specdojo/schemas/v1/pipeline-state.schema.yaml +12 -0
  60. package/docs/specdojo/schemas/v1/register-events.schema.yaml +2 -0
  61. package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +21 -0
  62. package/docs/specdojo/schemas/v1/specdojo-config.schema.yaml +35 -0
  63. package/package.json +17 -17
  64. package/templates/antigravity/README.md +1 -1
  65. package/templates/antigravity/orchestrator.md +61 -2
  66. package/templates/claude/agents/specdojo-orchestrator.md +61 -2
  67. package/templates/codex/README.md +17 -0
  68. package/templates/codex/agents/specdojo-orchestrator.toml +61 -2
  69. package/templates/codex/orchestrator.md +61 -2
  70. package/templates/devcontainer/devcontainer.json +3 -0
  71. package/templates/devcontainer/post-create.sh +15 -7
  72. package/templates/devcontainer/remote-host/specdojo-tmux.sh.sample +38 -5
  73. package/templates/devcontainer/remote-host/ssh-config.sample +3 -0
  74. package/templates/devcontainer/vim/vimrc +37 -0
  75. package/templates/init-agent-members.yaml +3 -3
  76. package/templates/init-exec-defaults.yaml +20 -1
  77. package/templates/opencode/agents/specdojo-orchestrator.md +61 -2
@@ -43,11 +43,11 @@ project の解決順序と設定は [遂行の技活用ガイド](../guides/waza
43
43
  | `init` | project から agent 実行までを質問式で初期設定する | `specdojo init` |
44
44
  | `config init` | `specdojo.config.json` と `.gitignore` を個別に用意する | `specdojo config init` |
45
45
  | `config migrate-members` | agent 定義を保護設定へ移す | `specdojo config migrate-members --dry-run` |
46
- | `config scaffold` | provider の agent・settings 設定を個別に配置する | `specdojo config scaffold --provider codex` |
46
+ | `config scaffold` | provider や VS Code ワークスペースを個別に配置する | `specdojo config scaffold --provider codex` |
47
47
  | `project list` | 登録済み project を表示する | `specdojo project list` |
48
48
 
49
49
  `init` は対話できる端末で、project ID と名前、register、人の nickname と表示名、複数指定可能な
50
- provider、exec、Dev Container の順に質問します。成果物カタログは対話では質問せず、`--catalog <size>` を
50
+ provider、exec、Dev Container の順に質問します。Dev Container を選んだ場合だけ、続けて推奨 preset を入れるかを質問します(既定は「入れる」)。成果物カタログは対話では質問せず、`--catalog <size>` を
51
51
  明示した場合にだけ作成します。既存ファイルは上書きせず、スキップしたパスを表示します。`--dry-run` は
52
52
  予定だけを表示し、ファイルや `package.json` を変更しません。各回答は質問の直後に検証され、誤りの理由を
53
53
  表示して同じ質問だけをやり直します。それまでの回答は保持されます。`--exec` を選んだのに provider が
@@ -56,20 +56,21 @@ provider、exec、Dev Container の順に質問します。成果物カタログ
56
56
 
57
57
  非対話環境では質問せず、次の主要オプションと既定値を使います。
58
58
 
59
- | オプション | 用途 | 既定値 |
60
- | ------------------------- | ------------------------------------------------------------------------- | --------------- |
61
- | `--yes` | 質問せず既定値と指定済みオプションで実行する | - |
62
- | `--project <id>` | project ID | `prj-0001` |
63
- | `--name <name>` | project の表示名 | `My Project` |
64
- | `--no-register` | register を作らない | register を作る |
65
- | `--nickname <nickname>` | 人の名簿に書く nickname | `owner` |
66
- | `--display-name <name>` | 人の名簿に書く表示名 | `Project Owner` |
67
- | `--provider <names>` | provider をカンマ区切りで指定する | `codex` |
68
- | `--exec` | executor / reporter の名簿と起動設定を作る | 作らない |
69
- | `--catalog <size>` | `small` / `medium` / `large` の成果物カタログを作る(対話では質問しない) | 作らない |
70
- | `--devcontainer` | 選んだ provider の Dev Container を作る | 作らない |
71
- | `--workspace-name <name>` | Dev Container 内で使う親ディレクトリ名 | ホスト側の親名 |
72
- | `--dry-run` | 作成・変更予定だけを表示する | 書き込む |
59
+ | オプション | 用途 | 既定値 |
60
+ | ------------------------------ | ------------------------------------------------------------------------- | --------------- |
61
+ | `--yes` | 質問せず既定値と指定済みオプションで実行する | - |
62
+ | `--project <id>` | project ID | `prj-0001` |
63
+ | `--name <name>` | project の表示名 | `My Project` |
64
+ | `--no-register` | register を作らない | register を作る |
65
+ | `--nickname <nickname>` | 人の名簿に書く nickname | `owner` |
66
+ | `--display-name <name>` | 人の名簿に書く表示名 | `Project Owner` |
67
+ | `--provider <names>` | provider をカンマ区切りで指定する | `codex` |
68
+ | `--exec` | executor / reporter の名簿と起動設定を作る | 作らない |
69
+ | `--catalog <size>` | `small` / `medium` / `large` の成果物カタログを作る(対話では質問しない) | 作らない |
70
+ | `--devcontainer` | 選んだ provider の Dev Container を作る | 作らない |
71
+ | `--devcontainer-preset <name>` | Dev Container の preset(`recommended` / `none`)を選ぶ | `recommended` |
72
+ | `--workspace-name <name>` | Dev Container 内で使う親ディレクトリ名 | ホスト側の親名 |
73
+ | `--dry-run` | 作成・変更予定だけを表示する | 書き込む |
73
74
 
74
75
  `init` が作る `.specdojo/agent-members.yaml` と `.specdojo/exec-defaults.yaml` は、選択した
75
76
  provider だけを含みます。親 runner の検証は、対応する `package.json` の npm script が存在する
@@ -91,6 +92,8 @@ provider 設定、登録簿作成の順に次のコマンドを案内します
91
92
  書き込まず、予定の内容だけを表示します。`config scaffold` の `--provider` には
92
93
  `antigravity`、`claude`、`codex`、`copilot`、`opencode` を指定でき、`--dry-run` と `--force` も利用できます。
93
94
 
95
+ `package.json` がある場合、provider ごとのオーケストレーター起動スクリプトも追加します。Claude Code は `orch:opus`・`orch:sonnet`、Codex は `orch:sol`(`gpt-5.6-sol`)・`orch:terra`(`gpt-5.6-terra`)、Antigravity は `orch:flash`(`gemini-3.8-flash-high`)、OpenCode は `orch:opencode` です。既存のスクリプトは `--force` を付けても上書きしません。
96
+
94
97
  `antigravity` に限り `--global` を指定すると、`~/.gemini/antigravity-cli/settings.json` へ SpecDojo 用の permission rule を追記します。既存キー・既存 rule は保持し、実書き込み前に timestamp 付きバックアップを作ります。`--global` を省略した通常実行はユーザーディレクトリへ触れません。適用前は次の dry-run で追加 rule を確認してください。
95
98
 
96
99
  ```bash
@@ -100,6 +103,14 @@ specdojo config scaffold --provider antigravity --global
100
103
 
101
104
  `--force` はリポジトリ内の scaffold ファイルだけを上書きし、グローバル設定の既存項目は上書きしません。従来の `exec scaffold --provider antigravity` でも同じ `--global` / `--dry-run` の挙動を利用できます。
102
105
 
106
+ `config scaffold --workspace` は、`.specdojo/specdojo.config.json` の `repos` 宣言から VS Code のマルチルートワークスペース(`<project-id>.code-workspace`)をリポジトリルートに生成します。`folders` にはプロジェクトリポジトリ(`.`)と各プロダクトリポジトリ(`repos[].path`)を宣言順に並べ、別リポジトリ構成でも 1 つの VS Code ウィンドウでプロジェクトとプロダクトを同時に開けます。`--project <id>` で対象 project を指定でき、省略時は `current_project` を使います。既存のファイルは `--force` を指定しない限り上書きしません。`repos` が宣言されていない project ではエラーになります。`--dry-run` は書き込まず予定の内容だけを表示します。
107
+
108
+ ```bash
109
+ specdojo config scaffold --workspace
110
+ specdojo config scaffold --workspace --project prj-0002 --dry-run
111
+ specdojo config scaffold --workspace --force
112
+ ```
113
+
103
114
  `config migrate-members` は、各 project の `pm-members.yaml` から `type: agent` の member を取り出し、トップレベルの `agent_members_path`(既定 `.specdojo/agent-members.yaml`)へ統合します。通常実行前に `--dry-run` で対象と件数を確認してください。`--project <id>` を指定すると 1 project だけを対象にします。
104
115
 
105
116
  `current_project` を設定しておくと、多くのコマンドで `--project` を省略できます。
@@ -347,7 +358,7 @@ specdojo schedule strategy generate \
347
358
  | `--to <PJR-ID>` | 移動先の PJR-ID を指定する | `renumber` |
348
359
  | `--registered <datetime>` | 起票日時(タイムゾーン付き RFC 3339)。省略時は実行時刻 | `add` |
349
360
  | `--completed <datetime>` | 完了・却下日時(タイムゾーン付き RFC 3339)。省略時は実行時刻 | `close` / `reject` |
350
- | `--by <actor>` | 追記型 event に記録する actor を指定 | `add` / 更新 / 遷移コマンド |
361
+ | `--by <actor>` | 名簿または予約一覧の actor を追記型 event に記録する | `add` / 更新 / 遷移コマンド |
351
362
  | `--reason <text>` | event の理由を記録(`wait` では `block_reason` も更新) | `add` / 更新 / 遷移コマンド |
352
363
  | `--conclusion <text>` | 終端時の結論を記録・更新(`update` では `-` で削除) | `add` / `update` / 終端コマンド |
353
364
  | `--block-reason <text>` | `waiting` の理由を更新(`-` で削除) | `update` |
@@ -366,6 +377,8 @@ specdojo schedule strategy generate \
366
377
 
367
378
  `register add` は個票 Frontmatter の `registered_at`(起票日時)を、`register close` / `register reject` は `completed_at`(完了・却下日時)を自動記入します。値は UTC の RFC 3339・秒精度(例: `2026-08-09T14:08:51Z`)で、OS / コンテナの `TZ` 環境変数には依存しません。`register reopen` は `completed_at` を削除します。
368
379
 
380
+ `register` の `--by` は、project の `pm-members.yaml` にある人の nickname、`.specdojo/agent-members.yaml` にある agent の nickname または alias、予約 actor の `SpecDojo`・`specdojo-orchestrator`・`night-orchestrator` だけを受け付けます。agent alias は実体名で event に記録し、未知の値は書き込み前に拒否します。省略時は `SpecDojo` です。決定・承認では `PO` などの Role code や予約 actor ではなく、本人の nickname を指定します。
381
+
369
382
  `--approach` を指定する場合、`--target` は 1 件だけ必須です。成果物を作成・修正する approach の対象は成果物カタログの doc id で解決するため、まだ文書がない成果物も指定できます。kata maintenance の対象は文書索引で解決し、approach に対応する kata 種別との一致も書き込み前に検証します。
370
383
 
371
384
  `item_type: note` は `open` のまま更新する記録です。`register close` / `register reject` / `register defer` は終了コード 1 で拒否し、対応・回答・判断が必要な場合は `todo` / `question` / `decision` など目的に合う別の `item_type` で起票するよう案内します。本文の追記や修正には `register update` を使用できます。
@@ -436,37 +449,41 @@ specdojo schedule strategy generate \
436
449
 
437
450
  主要オプション:
438
451
 
439
- | オプション | 用途 | 対象 |
440
- | ------------------------------- | -------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------- |
441
- | `--task <task-id>` | 対象タスクを指定する | 状態遷移系 / `run` / `plan` |
442
- | `--by <actor>` | 実行 actor / agent の nickname を指定する(手動ターゲットの agent 選択も兼ねる) | 状態遷移系 / `run` / `resume` / `worktree agent` |
443
- | `--edit-by <nickname>` | `--auto` バッチで edit タスクに使う agent nickname | `run --auto` / `resume` |
444
- | `--review-by <nickname>` | `--auto` バッチで review タスクに使う agent nickname | `run --auto` / `resume` |
445
- | `--strategy <name>` | 選択戦略を切り替える(`critical-first` 既定 / `fifo`) | `scheduler` / `run --auto` |
446
- | `--auto` / `--loop` | Ready タスクを自動選択する / Ready がなくなるまで繰り返す | `run` |
447
- | `--parallel <n>` | 同時に走らせる agent 数の上限を指定する | `run --auto` / register の worktree モード |
448
- | `--worktree` | worktree に隔離して実行する | `run --task` / `run --register` |
449
- | `--in-place` | register 項目を現在の作業ツリーで実行する(`run.register_execution` を上書き) | `run --register` |
450
- | `--track-state` | claim / complete の状態イベントを記録する | `run --task` |
451
- | `--register <PJR-ID>` | 登録簿の項目を実行する(空白・カンマ区切りで複数可。場所の既定は `run.register_execution`) | `run` / `plan` |
452
- | `--register-filter` | 登録簿項目を type / priority / status / limit の条件で決定論的に選ぶ | `run` |
453
- | `--register-commit` | 成功したIDごとに、その実行で生じた変更を1コミットにまとめる(worktree モードでは常に commit のため無視) | `run --register` |
454
- | `--on-failure <stop\|continue>` | 途中失敗時に残りのIDを停止するか継続するか(既定は `stop`) | `run --register` |
455
- | `--resume` | run が止まった段(executor / reporter / 統合)を既存 worktree と checkpoint で再開する | register の worktree モード |
456
- | `--resume-from executor` | reporter 段から再開可能な run を、既存成果を保持したまま executor 段から再開する | register の worktree モード(`--resume` と併用) |
457
- | `--force-restart` | 再開可能な run の成果があっても、worktree を破棄して項目全体を再実行する | register の worktree モード |
458
- | `--join` | 実行中の register worktree 実行の終了を待たずに合流して並行実行する(上限は `run.max_concurrent_runs`) | register の worktree モード |
459
- | `--executor-by <nickname>` | executor 段の agent。register では `PJR-ID=nickname,...` による項目別指定も可能 | `run --auto` / `resume` / `run --register` / `run --plan` / `run --deliverable` |
460
- | `--reporter-by <nickname>` | executor/reporter パイプラインの reporter 段に使う agent nickname | `run --auto` / `resume` / `run --register` / `run --plan` / `run --deliverable` |
461
- | `--on-rate-limit <action>` | 指名した agent の上限時の扱い。`stop` / `wait` / `fallback` | `run` / `resume` |
462
- | `--fallback-executor-by <name>` | `fallback` 時に executor 段を1回だけ引き継ぐ agent | `run` / `resume` |
463
- | `--fallback-reporter-by <name>` | `fallback` 時に reporter 段を1回だけ引き継ぐ agent | `run` / `resume` |
464
- | `--due` | 再開時刻を迎えた利用制限延期 task を対象にする | `resume` |
452
+ | オプション | 用途 | 対象 |
453
+ | -------------------------------------- | -------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------- |
454
+ | `--task <task-id>` | 対象タスクを指定する | 状態遷移系 / `run` / `plan` |
455
+ | `--by <actor>` | 実行 actor / agent の nickname を指定する(手動ターゲットの agent 選択も兼ねる) | 状態遷移系 / `run` / `resume` / `worktree agent` |
456
+ | `--edit-by <nickname>` | `--auto` バッチで edit タスクに使う agent nickname | `run --auto` / `resume` |
457
+ | `--review-by <nickname>` | `--auto` の review タスク、または register の統合後 review に使う agent nickname | `run --auto` / `run --register --post-review` / `resume` |
458
+ | `--strategy <name>` | 選択戦略を切り替える(`critical-first` 既定 / `fifo`) | `scheduler` / `run --auto` |
459
+ | `--auto` / `--loop` | Ready タスクを自動選択する / Ready がなくなるまで繰り返す | `run` |
460
+ | `--parallel <n>` | 同時に走らせる agent 数の上限を指定する | `run --auto` / register の worktree モード |
461
+ | `--worktree` | worktree に隔離して実行する | `run --task` / `run --register` |
462
+ | `--in-place` | register 項目を現在の作業ツリーで実行する(`run.register_execution` を上書き) | `run --register` |
463
+ | `--track-state` | claim / complete の状態イベントを記録する | `run --task` |
464
+ | `--register <PJR-ID>` | 登録簿の項目を実行する(空白・カンマ区切りで複数可。場所の既定は `run.register_execution`) | `run` / `plan` |
465
+ | `--register-filter` | 登録簿項目を type / priority / status / limit の条件で決定論的に選ぶ | `run` |
466
+ | `--register-commit` | 成功したIDごとに、その実行で生じた変更を1コミットにまとめる(worktree モードでは常に commit のため無視) | `run --register` |
467
+ | `--post-review` | worktree 統合後に完了 review を行い、todo / issue を verdict に応じて close または waiting にする | `run --register --worktree` |
468
+ | `--on-failure <stop\|continue>` | 途中失敗時に残りのIDを停止するか継続するか(既定は `stop`) | `run --register` |
469
+ | `--integration-branch <repo>=<branch>` | run ごとのプロダクトリポジトリの統合先(繰り返し可)を指定する | register の worktree モード |
470
+ | `--resume` | run が止まった段(executor / reporter / 統合)を既存 worktree と checkpoint で再開する | register の worktree モード |
471
+ | `--resume-from executor` | reporter 段から再開可能な run を、既存成果を保持したまま executor 段から再開する | register の worktree モード(`--resume` と併用) |
472
+ | `--force-restart` | 再開可能な run の成果があっても、worktree を破棄して項目全体を再実行する | register の worktree モード |
473
+ | `--join` | 実行中の register worktree 実行の終了を待たずに合流して並行実行する(上限は `run.max_concurrent_runs`) | register の worktree モード |
474
+ | `--executor-by <nickname>` | executor 段の agent。register では `PJR-ID=nickname,...` による項目別指定も可能 | `run --auto` / `resume` / `run --register` / `run --plan` / `run --deliverable` |
475
+ | `--reporter-by <nickname>` | executor/reporter パイプラインの reporter 段に使う agent nickname | `run --auto` / `resume` / `run --register` / `run --plan` / `run --deliverable` |
476
+ | `--on-rate-limit <action>` | 指名した agent の上限時の扱い。`stop` / `wait` / `fallback` | `run` / `resume` |
477
+ | `--fallback-executor-by <name>` | rate limit の `fallback` または接続不能時に executor 段を1回だけ引き継ぐ agent | `run` / `resume` |
478
+ | `--fallback-reporter-by <name>` | rate limit の `fallback` または接続不能時に reporter 段を1回だけ引き継ぐ agent | `run` / `resume` |
479
+ | `--due` | 再開時刻を迎えた利用制限延期 task を対象にする | `resume` |
465
480
 
466
481
  `--plan` と `--deliverable` も Schedule のパイプライン宣言を持たないため、`--executor-by` / `--reporter-by` の少なくとも一方を指定したときだけ executor/reporter 2段階で実行します。指定しなかった段は `stage_role` による自動選択で決まります。`--plan` では reporter が scaffold 済みの result を記入するため、frontmatter に `task_id` を持つ plan が必要です。`--by` との併用はエラーです。`--by` に `stage_role` を持つ pipeline 用 agent を指定すると、result 未記入の blocked にはせず、`--executor-by` / `--reporter-by` を使うよう案内するエラーで実行前に拒否します。
467
482
 
468
483
  指名した agent の rate limit は既定では `stop` です。`wait` は provider の reset / retry-after、次に `rate_limit_policy.cooldown_seconds` を使い、`rate_limit_policy.pinned.max_wait_seconds`(既定8時間)以内なら同じ段を同じ agent で再開します。`fallback` は対応する fallback flag または `rate_limit_policy.pinned.fallback_executor_by` / `fallback_reporter_by` の agent へ1回だけ切り替えます。fallback 未指定時と fallback agent も上限になった場合は停止します。CLI が `exec-defaults.yaml` より優先します。待機中は project の実行ロックを保持します。
469
484
 
485
+ `connection_error_detection` に一致する接続不能は `--on-rate-limit` の値とは独立して扱い、対応する fallback flag または設定上の fallback agent があれば1回だけ切り替えます。fallback 未指定時は通常の失敗として停止し、同じ agent の再開待ちは行いません。切替元・切替先・時刻・原因は rate limit の切替と同じ pipeline state、evidence、result の経路へ記録します。
486
+
470
487
  agent の指定は repository 共通 roster nickname(`.specdojo/agent-members.yaml`)へ一本化します。手動ターゲット(`--task` / `--register` など)では `--by <nickname>`、`--auto` バッチでは mode 別に `--edit-by` / `--review-by` を使い、バッチ起動は `--auto` に一本化します。解決の優先順位は「単体指定(`--by`)> mode 別指定(`--edit-by` / `--review-by`)> 自動選択」です。
471
488
 
472
489
  Schedule タスクの `agent_pipeline`(`sch-strategy-<track>.yaml` の phase 設定)と同じ executor/reporter 2段階(`stage_role: executor` が成果物を編集・検証し、`stage_role: reporter` が evidence から result を描画する)は、`--register` の既定の実行方式です。register 項目は Schedule のような per-item のパイプライン宣言を持たないため、owner・role からの agent 選択は行いません。`--executor-by <nickname>` と `--reporter-by <nickname>` を **両方セットで** 指定すると、その agent で実行します。`--by` と `--executor-by` / `--reporter-by` をいずれも指定しない場合は、`stage_role: executor`(`mode: edit` または `mode` 未指定)と `stage_role: reporter` の agent から `priority` 順に自動で選びます。`stage_role` を持たない agent(翻訳専用など)は自動選択の候補に入りません。どちらかの段に該当する agent がいない場合は、`--executor-by` / `--reporter-by` の指定を求めるエラーで実行前に止まります。複数項目では `--executor-by PJR-0001=exec-a,PJR-0002=exec-b` のような項目別指定も使用できます。項目別指定は選択した全項目を含む必要があり、対象外 ID と指定漏れは実行前にエラーになります。片方だけの指定もエラーになります。
@@ -506,6 +523,12 @@ specdojo exec run --project prj-0001 --register-filter --register-types todo --r
506
523
  # 成果物を worktree に隔離して実行し、統合ブランチへ merge back する
507
524
  specdojo exec run --project prj-0001 --register PJR-0012 --worktree
508
525
 
526
+ # app1 の統合先を、この run だけローカルの feature/login にする
527
+ specdojo exec run --project prj-0001 --register PJR-0012 --worktree --integration-branch app1=feature/login
528
+
529
+ # 統合後に読み取り専用 review を行い、完了した todo / issue を自動 close する
530
+ specdojo exec run --project prj-0001 --register PJR-0012 --worktree --post-review
531
+
509
532
  # 保護設定で block された提案差分を表示し、確認後に統合先へ commit する
510
533
  specdojo exec handoff apply --project prj-0001 --register PJR-0012
511
534
 
@@ -528,7 +551,11 @@ specdojo exec run --project prj-0001 --register PJR-0012 --worktree --resume --r
528
551
  specdojo exec run --project prj-0001 --job job-weekly-report --input period=2026-W32
529
552
  ```
530
553
 
531
- `--register` は指定した個票の項目を実行します。`--register-filter` は `--register-types` / `--register-priorities` / `--register-statuses` のカンマ区切り条件と、正の整数の `--register-limit` で項目を選びます。条件省略時は open かつ実行可能な type が対象です。いずれも実行対象になる type は `todo` / `issue` / `change-request` / `question` / `risk` で、`decision` / `note` は対象外です。実行場所の既定は `.specdojo/exec-defaults.yaml` の `run.register_execution`(`worktree` / `in-place`)で選び、未設定時は互換性のため in-place です。`--worktree` / `--in-place` は設定を上書きし、同時指定はエラーになります。worktree モードは成果物の変更を隔離し、状態遷移(`start` / `review` / `waiting`)を直列化したうえで、成功時に merge back します。`--parallel <n>` は worktree モードでのみ指定できます。
554
+ `--register` は指定した個票の項目を実行します。`--register-filter` は `--register-types` / `--register-priorities` / `--register-statuses` のカンマ区切り条件と、正の整数の `--register-limit` で項目を選びます。条件省略時は open かつ実行可能な type が対象です。いずれも実行対象になる type は `todo` / `issue` / `change-request` / `question` / `risk` で、`decision` / `note` は対象外です。実行場所の既定は `.specdojo/exec-defaults.yaml` の `run.register_execution`(`worktree` / `in-place`)で選び、未設定時は互換性のため in-place です。`--worktree` / `--in-place` は設定を上書きし、同時指定はエラーになります。worktree モードは成果物の変更を隔離し、状態遷移(`start` / `review` / `waiting`)を直列化したうえで、成功時に merge back します。`--post-review` または `run.register_post_review: true` を指定すると、merge back の後に完了判定を行い、todo / issue を自動 close できます。`--parallel <n>` は worktree モードでのみ指定できます。
555
+
556
+ `--integration-branch <repo>=<branch>` は、register の worktree モードで、その run に限ってプロダクトリポジトリ `<repo>` の統合先を上書きします。複数リポジトリにはオプションを繰り返します。`<repo>` は `repos[].name` に宣言済みで、`<branch>` はそのリポジトリに存在する有効なローカルブランチでなければならず、リモートブランチの取得やローカルブランチの作成は行いません。同じ `<repo>` の重複、宣言にないリポジトリ、空の値は register の状態を変える前に拒否します。統合先の優先順位は「run の指定 → `repos[].integration_branch` → そのリポジトリの現在のブランチ」です。指定しない run の挙動は従来と変わりません。
557
+
558
+ 複数項目を `--parallel` で実行する場合、指定は選択された各 item run に同じように適用されます。中断した run を `--resume` するときは、開始時の指定を `pipeline-state.json` から再利用するため、オプションを繰り返す必要はありません。再開時に値を再指定する場合、その値は開始時の指定と一致する必要があり、run の途中で統合先を変更・追加する指定は拒否します。result の複数リポジトリ trace には、実際に使った統合先ブランチと統合後の commit snapshot が記録されます。
532
559
 
533
560
  `exec handoff apply --register <PJR-ID>` は、worktree 実行が `agent-config-write` で waiting になった項目の最新 result から提案差分を読み、統合先へ適用して commit します。コマンドは差分を必ず表示し、対話では `y` / `yes`、非対話実行では `--yes` による明示確認がなければ何も変更しません。提案差分がない、切り詰められている、申し送りの対象パスと一致しない、保護対象外のパスを含む、統合先へ適用できない、対象パスに既存変更がある場合は commit 前に停止します。複数リポジトリでは `# repo: <name>` で区切られた差分を、宣言済みの各統合先へ限定 commit します。`package.json` を適用した場合は、依存定義を変更したか確認して対応する lock ファイルを再生成・commit し、その後に表示された `exec run --register ... --worktree --resume` を実行します。
534
561
 
@@ -577,7 +604,7 @@ specdojo exec trial adopt --project prj-0001 --comparison <comparison-id> --tria
577
604
 
578
605
  `--agent`と任意の`--reporter-by`を使うと、reporterなしまたは全trial共通reporterの従来方式になります。`--pair <executor>=<reporter>...`は2組以上を指定し、executorとreporterを一組として比較します。`--pair`は`--agent` / `--reporter-by`と併用できません。比較記録の`reporter_mode`には`none` / `shared` / `paired`のいずれかを保存します。各reporterについて構造化出力の成否、形式試行回数、形式再試行回数、`evidence_blocked` / `invalid_output` / `invocation_failure` / `rate_limit`の失敗分類も保存します。`evidence_blocked` は reporter の申告ではなく、executor evidence から runner が機械判定した blocked を表します。
579
606
 
580
- `pipeline.parent_validations`に指定できるIDは`validate-schema`、`typecheck`、`test-unit`、`test-integration`、`lint-ts`、`lint-fm`、`lint-md`です(各IDは組み込み許可リストの固定argvへ解決されます)。`pipeline.parent_validations`はtrialにも適用され、executor成功後・reporter起動前に各worktreeで実行されます。親検証結果は`source: runner`付きでevidenceへ保存し、失敗時はtrialを`failed`にします。比較記録と`trial status`はexecutor・親検証・全体の時間を分け、executorの検証報告総数と`passed` / `failed` / `not_run` / `requires_human`、親検証の状態と件数を別々に表示します。採用前に親検証の成功、executorの未実施・未報告、sandbox 外で人が行う確認を確認してください。
607
+ `pipeline.parent_validations`に指定できるIDは`validate-schema`、`typecheck`、`test-unit`、`test-integration`、`lint-ts`、`lint-fm`、`lint-md`、`build`、`format-check`です(各IDは組み込み許可リストの固定argvへ解決されます)。`pipeline.parent_validations`はtrialにも適用され、executor成功後・reporter起動前に各worktreeで実行されます。親検証結果は`source: runner`付きでevidenceへ保存し、失敗時はtrialを`failed`にします。比較記録と`trial status`はexecutor・親検証・全体の時間を分け、executorの検証報告総数と`passed` / `failed` / `not_run` / `requires_human`、親検証の状態と件数を別々に表示します。採用前に親検証の成功、executorの未実施・未報告、sandbox 外で人が行う確認を確認してください。
581
608
 
582
609
  記録先は`execution_path/exec/trials/<comparison-id>/`です。agent選定への反映は自動化せず、人が複数比較を確認して `.specdojo/agent-members.yaml` を更新します。
583
610
 
@@ -899,6 +926,16 @@ provider CLI の実行中、起動元は `SIGINT` と `SIGQUIT` を無視して
899
926
 
900
927
  Claude Code、Codex、Antigravity、GitHub Copilot には exec と同じ追加ルート引数を渡します。OpenCode は、起動時の `OPENCODE_CONFIG_CONTENT` に選択 agent の `permission.external_directory` を注入し、全外部ディレクトリを拒否したうえで宣言済みのリポジトリだけを許可します。外部パスへ既存の `permission.edit` が一致しないため、同じ宣言済みルートの編集許可も注入します。既存の inline config の他項目は保持します。未宣言のリポジトリは、どの provider でも許可対象になりません。
901
928
 
929
+ `orchestrator night` は `autopilot: approved` の付いた `open` todo・issue だけを夜間 queue として実行します。
930
+
931
+ ```bash
932
+ specdojo orchestrator night --project prj-0001 \
933
+ --max-items 10 --parallel 2 --max-consecutive-failures 2 \
934
+ --on-rate-limit fallback --fallback-executor-by codex-executor
935
+ ```
936
+
937
+ 各 wave は worktree と post-review を必須にし、成功は close、未完了は `waiting` にします。`--max-items` は一晩の件数、`--parallel` は wave の同時数、`--max-consecutive-failures` は次の wave を止める閾値です。`--on-rate-limit fallback` では fallback executor の指定が必須です。失敗を含む朝報告を保存できた場合は部分成功を表す終了コード 2、コマンド自体の異常は 1 を返します。
938
+
902
939
  ## 16. devcontainer
903
940
 
904
941
  `devcontainer` は、利用リポジトリの `.devcontainer/` 環境を構築するためのサブコマンドです。VS Code Dev Container などで、オーケストレーターを起動するための分離されたコンテナ環境を生成します。
@@ -907,25 +944,29 @@ Claude Code、Codex、Antigravity、GitHub Copilot には exec と同じ追加
907
944
  | ----------------------- | ------------------------------------------- |
908
945
  | `devcontainer scaffold` | `.devcontainer/` の設定ファイル群を生成する |
909
946
 
910
- `devcontainer scaffold` は、指定された provider の CLI と、要求された追加機能を組み込んだ `devcontainer.json` と `post-create.sh` を生成します。あわせて、常時稼働ホストへの接続と tmux セッション維持のためのサンプルスクリプト(`.devcontainer/remote-host/specdojo-tmux.sh.sample`)と接続元 SSH 設定サンプル(`.devcontainer/remote-host/ssh-config.sample`)も生成します。provider は `antigravity`、`claude`、`codex`、`opencode` を指定できます。`--editor emacs` を指定した場合は Emacs 用の `emacs/init.el` も生成します。Dev Container は任意の実行環境であり、既存の Node.js 環境を置き換える必須手順ではありません。
947
+ `devcontainer scaffold` は、指定された provider の CLI と、要求された追加機能を組み込んだ `devcontainer.json` と `post-create.sh` を生成します。あわせて、常時稼働ホストへの接続と tmux セッション維持のためのサンプルスクリプト(`.devcontainer/remote-host/specdojo-tmux.sh.sample`)と接続元 SSH 設定サンプル(`.devcontainer/remote-host/ssh-config.sample`)も生成します。provider は `antigravity`、`claude`、`codex`、`opencode` を指定できます。`--editor emacs` / `--editor vim` を指定した場合は、それぞれ Emacs 用の `emacs/init.el` / Vim 用の `vim/vimrc` も生成します。Dev Container は任意の実行環境であり、既存の Node.js 環境を置き換える必須手順ではありません。
911
948
 
912
949
  主要オプション:
913
950
 
914
- | オプション | 用途 |
915
- | ------------------------- | ----------------------------------------------------------- |
916
- | `--provider <names>` | `claude,codex` のようにカンマ区切りで provider を指定する。 |
917
- | `--editor emacs` | 端末版 Emacs、LSP・検索ツール、初期設定を追加する。 |
918
- | `--ollama` | Ollama への接続設定(環境変数)を追加する。 |
919
- | `--cron` | cron をインストールし、起動時にサービスを開始する。 |
920
- | `--tmux` | tmux をインストールする。 |
921
- | `--workspace-name <name>` | Dev Container 内で使う親ディレクトリ名を上書きする。 |
922
- | `--force` | `.devcontainer/` が既に存在する場合に上書きする。 |
923
- | `--dry-run` | 実際にファイルを作成せず、作成予定のファイルを表示する。 |
951
+ | オプション | 用途 |
952
+ | ------------------------- | ------------------------------------------------------------ |
953
+ | `--preset recommended` | 推奨のエディタ・tmux・VS Code 拡張と設定をまとめて追加する。 |
954
+ | `--provider <names>` | `claude,codex` のようにカンマ区切りで provider を指定する。 |
955
+ | `--editor <names>` | `emacs,vim` のようにエディタと初期設定を追加する。 |
956
+ | `--ollama` | Ollama への接続設定(環境変数)を追加する。 |
957
+ | `--cron` | cron をインストールし、起動時にサービスを開始する。 |
958
+ | `--tmux` | tmux をインストールする。 |
959
+ | `--workspace-name <name>` | Dev Container 内で使う親ディレクトリ名を上書きする。 |
960
+ | `--force` | `.devcontainer/` が既に存在する場合に上書きする。 |
961
+ | `--dry-run` | 実際にファイルを作成せず、作成予定のファイルを表示する。 |
924
962
 
925
963
  ```bash
926
964
  # claude と codex 用の CLI を含む Dev Container を生成する
927
965
  npx specdojo devcontainer scaffold --provider claude,codex
928
966
 
967
+ # SpecDojo の文書作業向けの推奨設定をまとめて追加する
968
+ npx specdojo devcontainer scaffold --provider claude,codex --preset recommended
969
+
929
970
  # 追加オプションを指定する
930
971
  npx specdojo devcontainer scaffold --provider claude --ollama --tmux
931
972
 
@@ -970,6 +1011,10 @@ OpenCode の API key は `/home/node/.local/share/opencode/auth.json` に入り
970
1011
 
971
1012
  post-create は `~/.emacs`、`~/.emacs.el`、`~/.emacs.d/init.el`、`~/.config/emacs/init.el` のいずれも無い場合だけ、生成したテンプレートを配置します。`~/.emacs.d` ディレクトリがあれば `~/.emacs.d/init.el` へ、なければ `~/.config/emacs/init.el` へコピーし、配置先を出力します。dotfiles が設定を先に配置した場合は上書きしません。初回のコンテナ作成前に既定値を変える場合は `.devcontainer/emacs/init.el` を編集してください。作成後は出力されたコピー先を編集します。コピー先を削除しない限り、再度 post-create を実行してもテンプレートの変更は反映されません。
972
1013
 
1014
+ `--preset recommended` は、`--editor emacs,vim --tmux` 相当のツールに加え、Git Graph、markdownlint、YAML、Prettier、remark、Markdown All in One、Code Spell Checker、EditorConfig、Error Lens、Even Better TOML の VS Code 拡張を追加します。選択した provider が Claude Code、Codex、GitHub Copilot の場合は、その provider の拡張だけも追加します。Markdown と YAML は保存時に Prettier で整形し、`docs/specdojo/schemas/v1/` の主要な schema を SpecDojo の YAML へ関連付けます。同じ拡張は `.vscode/extensions.json` の `recommendations` にも入り、既存の recommendation は保持されます。個別の `--editor`・`--tmux` と一緒に指定した場合は両方を重複なく適用します。
1015
+
1016
+ Vim の雛形は `.devcontainer/vim/vimrc` に生成され、`~/.vimrc` と `~/.vim/vimrc` のどちらも無い場合だけ `~/.vimrc` へコピーされます。既存の Vim 設定は上書きしません。Emacs の雛形も上記と同じ上書き防止を維持します。
1017
+
973
1018
  ## 17. 関連ガイド
974
1019
 
975
1020
  | 詳細 | 参照先 |
@@ -93,12 +93,34 @@ SpecDojo Configuration Reference
93
93
 
94
94
  `projects.<project-id>.run` に指定します。これらのパスは `base_path` の影響を受けず、リポジトリルート基準です。
95
95
 
96
- | キー | 既定値 | 役割・利用箇所 |
97
- | ------------------------ | -------------- | ------------------------------------------------------------------------------------------------------------- |
98
- | `exec_defaults` | なし | provider、権限、リトライなどを定義する exec defaults ファイルです。agent を起動する `exec run` が参照します。 |
99
- | `agent_config` | なし | `exec_defaults` の旧キーです。互換目的でのみ利用し、新しい設定では `exec_defaults` を使います。 |
100
- | `worktree_base` | `../worktrees` | `exec run --worktree` / `--auto` と `exec trial` が作る worktree の親です。リポジトリ外を指定します。 |
101
- | `register_date_timezone` | `UTC` | 登録簿の「登録日」「完了日」を日時から暦日へ変換する IANA タイムゾーン名です。例は `Asia/Tokyo` です。 |
96
+ | キー | 既定値 | 役割・利用箇所 |
97
+ | ------------------------ | -------------- | ---------------------------------------------------------------------------------------------------------------------------- |
98
+ | `exec_defaults` | なし | provider、権限、リトライなどを定義する exec defaults ファイルです。agent を起動する `exec run` が参照します。 |
99
+ | `agent_config` | なし | `exec_defaults` の旧キーです。互換目的でのみ利用し、新しい設定では `exec_defaults` を使います。 |
100
+ | `parent_validations` | `[]` | この project だけで追加する親 runner の検証です。`exec_defaults` の `pipeline.parent_validations` の後ろへ指定順に加えます。 |
101
+ | `worktree_base` | `../worktrees` | `exec run --worktree` / `--auto` と `exec trial` が作る worktree の親です。リポジトリ外を指定します。 |
102
+ | `register_date_timezone` | `UTC` | 登録簿の「登録日」「完了日」を日時から暦日へ変換する IANA タイムゾーン名です。例は `Asia/Tokyo` です。 |
103
+
104
+ `parent_validations` の要素は、共有 defaults と同じく検証 ID、または `{ "id": "<id>", "repo": "<repo>" }` です。共有 defaults を複製せず、プロダクトリポジトリを持つ project だけに検証を追加できます。たとえば `prj-0002` だけで `specdojo-lp` の型と lint を検査する設定は次のとおりです。
105
+
106
+ ```json
107
+ {
108
+ "projects": {
109
+ "prj-0002": {
110
+ "repos": [{ "name": "specdojo-lp", "path": "../specdojo-lp" }],
111
+ "run": {
112
+ "exec_defaults": ".specdojo/exec-defaults.yaml",
113
+ "parent_validations": [
114
+ { "id": "typecheck", "repo": "specdojo-lp" },
115
+ { "id": "lint-ts", "repo": "specdojo-lp" }
116
+ ]
117
+ }
118
+ }
119
+ }
120
+ }
121
+ ```
122
+
123
+ 有効な一覧は「共有 defaults の `pipeline.parent_validations` → project の `run.parent_validations`」の順です。同じ ID と実行先の組が両方にある場合は重複として agent 起動前にエラーになります。`run.parent_validations` を省略した project には共有 defaults だけが適用されるため、`repos` を持たない別 project はプロダクトリポジトリ向けの追加検証に影響されません。許可される ID と実行結果の記録は [[specdojo:exec-config-guide|exec設定ガイド]] を参照してください。
102
124
 
103
125
  `config init` は一般既定の `../worktrees` ではなく、実行したリポジトリのディレクトリ名から作る `../<リポジトリ名>-worktrees` を `worktree_base` へ明示します。例えば `app1-specdojo/` で実行した場合は `../app1-specdojo-worktrees` です。
104
126
 
@@ -115,6 +137,8 @@ SpecDojo Configuration Reference
115
137
  | `integration_branch` | 任意 | そのリポジトリの現在のブランチ | exec が変更を統合する先のブランチです。exec branch もこのブランチの先端から作ります。 |
116
138
  | `setup` | 任意 | 両方 `true` | worktree 作成時の準備の有無です。`install`(依存導入)と `build`(生成物の build)を真偽値で指定します。 |
117
139
 
140
+ register の worktree 実行では、`exec run --integration-branch <repo>=<branch>` により `integration_branch` を run ごとに上書きできます。統合先の優先順位は「run の指定 → `repos[].integration_branch` → そのリポジトリの現在のブランチ」です。指定方法、ローカルブランチの検査、並列実行と再開時の扱いは [[specdojo:command-reference]] を参照してください。
141
+
118
142
  ```json
119
143
  {
120
144
  "base_path": "docs/ja/projects/prj-0001",
@@ -141,7 +165,7 @@ SpecDojo Configuration Reference
141
165
  `repos` を宣言した project の `exec run --worktree` と `exec worktree prepare` は、タスクごとに次の worktree を作ります。宣言の無い project は従来どおり `<worktree_base>/<task-id>/` の直下に 1 つだけ作ります。
142
166
 
143
167
  - `<worktree_base>/<task-id>/project/`: プロジェクトリポジトリの worktree です。agent の作業ディレクトリ(`cwd`)になります。`project` が予約名なのはこのためです。
144
- - `<worktree_base>/<task-id>/<name>/`: 宣言した各リポジトリの worktree です。exec branch は `integration_branch`(省略時は現在のブランチ)の先端から作ります。
168
+ - `<worktree_base>/<task-id>/<name>/`: 宣言した各リポジトリの worktree です。exec branch は run の `--integration-branch`、`integration_branch`、現在のブランチの順で解決した統合先の先端から作ります。
145
169
 
146
170
  agent には、各 worktree の絶対パスを次の環境変数で渡します。
147
171
 
@@ -169,6 +193,8 @@ agent 実行の前後で行う保護設定(`package.json`、CI 設定など)
169
193
 
170
194
  exec worktree の中で設定を読む場合(agent が worktree で `specdojo` を実行する場合など)、`path` の代わりに同じタスクの `<worktree_base>/<task-id>/<name>/` へ解決します。
171
195
 
196
+ `repos` を宣言した project では、`specdojo config scaffold --workspace` を実行すると、リポジトリルートに VS Code のマルチルートワークスペース(`<project-id>.code-workspace`)を生成できます。ワークスペースの `folders` にはプロジェクトリポジトリ(`.`)と宣言した各プロダクトリポジトリ(`repos[].path`)が宣言順に並び、VS Code で 1 つのウィンドウから両リポジトリを同時に操作できます。既存のワークスペースファイルは `--force` を付けない限り上書きしません。
197
+
172
198
  設定の読み込み時に、次の誤りを対象(`projects.<project-id>.repos[<n>]`)と原因を示すエラーにします。誤りは全 project 分をまとめて表示します。
173
199
 
174
200
  - `name` が `[a-z0-9-]` 以外の文字を含む、または同じ project 内で重複している。
@@ -65,6 +65,7 @@ Project Register Documentation Rules
65
65
  | `item_type` | 登録項目の分類 | ○ |
66
66
  | `item_status` | 登録項目の処理状態 | ○ |
67
67
  | `priority` | 対応優先度 | ○ |
68
+ | `difficulty` | agent 振り分け用の作業難易度 | 任意 |
68
69
  | `owner` | 主担当者または役割 | 任意 |
69
70
  | `registered_at` | 起票日時 | 任意 |
70
71
  | `due_on` | 対応期限または判断期限 | 任意 |
@@ -76,7 +77,7 @@ Project Register Documentation Rules
76
77
  | `targets` | 変更対象文書の doc id リスト | 任意 |
77
78
 
78
79
  - `status` は文書成熟度、`item_status` は処理状態であり、同じ状態軸として扱わない。
79
- - `item_type`、`item_status`、`priority` の値は schema の enum だけを使用する。
80
+ - `item_type`、`item_status`、`priority`、`difficulty` の値は schema の enum だけを使用する。`difficulty` は `hard` / `medium` / `easy` のいずれかとし、省略時は従来の agent 自動選択を使う。
80
81
  - `block_reason` は `waiting` 中の直近の待機・失敗理由、`conclusion` は終端時の結論として用途を分ける。`register wait --reason` は前者だけを更新し、`waiting` 以外へ遷移すると現在値から削除する。削除前の理由は項目別イベントログの変更前の値に残す。
81
82
  - Frontmatter の構造化フィールドを本文や生成一覧へ手作業で複製しない。
82
83
  - `derived_from` は同じ project の元項目を `PJR-XXXX`、別 project の元項目を `<project-id>:PJR-XXXX` で記録する。自己参照や存在しない項目は使用しない。別 project が設定にない場合は書式だけを検証し、設定された後に存在確認できるよう project 修飾を維持する。
@@ -144,7 +145,9 @@ Project Register Documentation Rules
144
145
  - 新しい項目は `register add` で作成し、個票の Frontmatter に初期値を書き込む。全 type で個票を省略しない。
145
146
  - 担当・期限・結論・topic・`derived_from`・`approach`・`targets` などを変更するときは `register update`、処理状態を変えるときは状態遷移コマンドを使用する。`register add` と `register update` では、起票元に繰り返し指定できる `--from`、進め方に `--approach`、対象に繰り返し指定できる `--target` を使う。起票元、`approach`、対象を削除するときは、それぞれ `--from -`、`--approach -`、`--target -` を指定する。待機理由は `register wait --reason` で記録し、誤った現在値を手動補正するときは `register update --block-reason -` で削除する。
146
147
  - `register build` は個票を読み取り、一覧・派生ビューを再生成する。`generated/pjr-derived-items.md` では `derived_from` を逆引きし、元の項目から派生先を辿れるようにする。一覧を編集して個票へ反映する経路はない。
147
- - `register add`、状態遷移、`register update`、`register renumber` は現在値を個票へ、イベントを対応する項目別ログへ記録する。`--by` で actor、`--reason` で理由を明示でき、省略時もコマンドが既定値を記録する。
148
+ - `register add`、状態遷移、`register update`、`register renumber` は現在値を個票へ、イベントを対応する項目別ログへ記録する。`--by` で actor、`--reason` で理由を明示でき、省略時は予約 actor の `SpecDojo` を記録する。
149
+ - `--by` に指定できるのは、project の `pm-members.yaml` にある人の nickname、repository の `.specdojo/agent-members.yaml` にある agent の nickname または alias、予約 actor の `SpecDojo`・`specdojo-orchestrator`・`night-orchestrator` に限る。agent の alias は実体の nickname に解決して記録し、名簿にも予約一覧にもない値は書き込み前に拒否する。
150
+ - 決定・承認を記録する actor には、`PO` などの Role code や予約 actor ではなく、決定・承認した人の nickname を使う。`specdojo-orchestrator` は対話型オーケストレーター自身の操作だけに使い、人の判断主体を代替しない。
148
151
  - 同じ現在値へ同じ操作を再実行した場合は、新しいイベントを追加しない。イベント ID と直前イベント参照を保ったまま再実行し、既存イベントの置換や削除で重複を解消しない。
149
152
  - ID の変更は `register renumber` で行い、個票のファイル名・Frontmatter・参照と生成ビューを整合させる。
150
153
  - 主題の変化に伴う `<topic>` の変更は `register update --topic` で行う。個票のファイル名と Frontmatter の文書 ID、他文書中の旧文書 ID 参照を同時に更新し、生成ビューを再生成する。
@@ -5,11 +5,11 @@ description: >
5
5
  Defines global defaults for specdojo exec run.
6
6
  Agent selection requirements are declared on sch-strategy phases; this file only
7
7
  contains runtime defaults shared across tracks, such as parent-run pipeline validations,
8
- agent launch command templates, rate-limit detection, and retry policy.
8
+ agent launch command templates, rate-limit / connection-error detection, and retry policy.
9
9
  Detection signals, exit codes, and wait times differ per agent runtime provider, so the
10
- top-level rate_limit_detection / rate_limit_policy act as global defaults and providers.<name>
11
- supplies per-provider overrides keyed by pm-members[].provider. Launch command templates
12
- are provider-specific and have no global default.
10
+ top-level rate_limit_detection / connection_error_detection / rate_limit_policy act as global
11
+ defaults and providers.<name> supplies per-provider overrides keyed by pm-members[].provider.
12
+ Launch command templates are provider-specific and have no global default.
13
13
  type: object
14
14
  additionalProperties: false
15
15
 
@@ -23,21 +23,36 @@ properties:
23
23
  description: "Defaults for `exec run`, including register execution location and project concurrency."
24
24
 
25
25
  rate_limit_detection:
26
- $ref: "#/$defs/RateLimitDetection"
26
+ $ref: "#/$defs/AgentErrorDetection"
27
27
  description: >
28
28
  Global default signals used to detect agent rate-limit / transient failures.
29
29
  Used for members whose provider has no override under providers.<name>.
30
30
 
31
+ connection_error_detection:
32
+ $ref: "#/$defs/AgentErrorDetection"
33
+ description: >
34
+ Global default signals used to detect agent connection failures. A pinned stage switches
35
+ once to its configured fallback agent when these signals match, independently of
36
+ --on-rate-limit. Used when a provider has no override under providers.<name>.
37
+
31
38
  rate_limit_policy:
32
39
  $ref: "#/$defs/RateLimitPolicy"
33
40
  description: >
34
41
  Global default behavior when an agent hits a rate limit during exec run.
35
42
  Used for members whose provider has no override under providers.<name>.
36
43
 
44
+ routing:
45
+ $ref: "#/$defs/DifficultyRouting"
46
+ description: >
47
+ Register pipeline agents and pinned rate-limit handling selected from the register item's
48
+ difficulty. Explicit CLI stage and recovery options override the matching route. Missing
49
+ difficulty entries preserve the existing priority-based automatic selection.
50
+
37
51
  providers:
38
52
  type: object
39
53
  description: >
40
- Per-provider overrides of rate_limit_detection and rate_limit_policy. The key
54
+ Per-provider overrides of rate_limit_detection, connection_error_detection, and
55
+ rate_limit_policy. The key
41
56
  matches pm-members[].provider (the agent runtime that executes the member command).
42
57
  For a given member, exec run resolves detection and policy from its provider override
43
58
  when present, otherwise from the top-level (global) values. This keeps provider-specific
@@ -49,9 +64,53 @@ properties:
49
64
  $ref: "#/$defs/ProviderOverride"
50
65
 
51
66
  $defs:
67
+ AgentNickname:
68
+ type: string
69
+ pattern: "^[a-z0-9][a-z0-9_-]{0,62}$"
70
+
71
+ DifficultyRouting:
72
+ type: object
73
+ additionalProperties: false
74
+ minProperties: 1
75
+ properties:
76
+ hard:
77
+ $ref: "#/$defs/DifficultyRoute"
78
+ medium:
79
+ $ref: "#/$defs/DifficultyRoute"
80
+ easy:
81
+ $ref: "#/$defs/DifficultyRoute"
82
+
83
+ DifficultyRoute:
84
+ type: object
85
+ additionalProperties: false
86
+ required: [executor_by, reporter_by, on_rate_limit]
87
+ properties:
88
+ executor_by:
89
+ $ref: "#/$defs/AgentNickname"
90
+ reporter_by:
91
+ $ref: "#/$defs/AgentNickname"
92
+ on_rate_limit:
93
+ type: string
94
+ enum: [stop, wait, fallback]
95
+ fallback_executor_by:
96
+ $ref: "#/$defs/AgentNickname"
97
+ fallback_reporter_by:
98
+ $ref: "#/$defs/AgentNickname"
99
+
52
100
  ParentValidationId:
53
101
  type: string
54
- enum: [validate-schema, typecheck, test-unit, test-integration, lint-ts, lint-fm, lint-md]
102
+ enum:
103
+ [
104
+ validate-schema,
105
+ typecheck,
106
+ test-unit,
107
+ test-integration,
108
+ lint-ts,
109
+ lint-fm,
110
+ lint-md,
111
+ build,
112
+ format-check,
113
+ ]
55
114
 
56
115
  PipelineDefaults:
57
116
  type: object
@@ -107,6 +166,14 @@ $defs:
107
166
  Default execution location for `exec run --register`. `--worktree` and `--in-place`
108
167
  override this value. When omitted, the historical `in-place` behavior is retained for
109
168
  compatibility with existing repositories.
169
+ register_post_review:
170
+ type: boolean
171
+ default: false
172
+ description: >
173
+ Whether `exec run --register` performs a read-only completion review after worktree
174
+ integration and automatically closes eligible todo/issue items. `--post-review` enables
175
+ the same behavior for one run. This option requires worktree execution and is disabled
176
+ when omitted.
110
177
  max_concurrent_runs:
111
178
  type: integer
112
179
  minimum: 1
@@ -140,8 +207,13 @@ $defs:
140
207
  Extra template variables resolved by member attributes. Resolution precedence is
141
208
  by_nickname, then by_proficiency, then by_mode.
142
209
  rate_limit_detection:
143
- $ref: "#/$defs/RateLimitDetection"
210
+ $ref: "#/$defs/AgentErrorDetection"
144
211
  description: "Provider-specific failure signals. Prefer stderr_patterns over generic exit_codes."
212
+ connection_error_detection:
213
+ $ref: "#/$defs/AgentErrorDetection"
214
+ description: >
215
+ Provider-specific connection failure signals. Prefer stderr_patterns over generic
216
+ exit_codes so ordinary agent failures are not treated as unavailable providers.
145
217
  rate_limit_policy:
146
218
  $ref: "#/$defs/RateLimitPolicy"
147
219
  description: "Provider-specific retry / fallback / block policy."
@@ -200,18 +272,18 @@ $defs:
200
272
  type: string
201
273
  minLength: 1
202
274
 
203
- RateLimitDetection:
275
+ AgentErrorDetection:
204
276
  type: object
205
277
  additionalProperties: false
206
- description: "Exit codes and stderr patterns that identify rate-limit / transient failures."
278
+ description: "Exit codes and output patterns that identify a configured agent failure class."
207
279
  properties:
208
280
  exit_codes:
209
281
  type: array
210
282
  uniqueItems: true
211
283
  description: >
212
- Exit codes treated as a rate-limit / transient signal. Avoid generic codes such as 1:
213
- most agent CLIs also use exit 1 for ordinary failure and for the agent's own block
214
- signal, so a bare exit 1 cannot be distinguished from a rate limit. Prefer stderr_patterns,
284
+ Exit codes treated as the configured failure signal. Avoid generic codes such as 1:
285
+ most agent CLIs also use exit 1 for ordinary failures and for the agent's own block
286
+ signal, so a bare exit 1 cannot identify one failure class. Prefer stderr_patterns,
215
287
  or set provider-specific codes under providers.<name>.
216
288
  items:
217
289
  type: integer
@@ -224,10 +296,10 @@ $defs:
224
296
  stderr_requires_nonzero_exit:
225
297
  type: boolean
226
298
  description: >
227
- Optional. When true (the default), stderr_patterns only count as a rate-limit
228
- signal if the agent process also exited non-zero. This avoids false positives
229
- where a successful run echoes a pattern phrase (e.g. an agent editing a file that
230
- contains the literal text "rate limit"). Set to false to match regardless of exit code.
299
+ Optional. When true (the default), stderr_patterns only count as the configured
300
+ failure signal if the agent process also exited non-zero. This avoids false positives
301
+ where a successful run echoes a pattern phrase. Set to false to match regardless of
302
+ exit code.
231
303
 
232
304
  RateLimitPolicy:
233
305
  type: object
@@ -267,7 +339,9 @@ $defs:
267
339
  additionalProperties: false
268
340
  description: >
269
341
  Recovery for an agent selected by nickname. CLI --on-rate-limit and fallback stage
270
- flags override these values. Omitted action preserves the historical stop behavior.
342
+ flags override these values. Omitted action preserves the historical rate-limit stop
343
+ behavior. The fallback nicknames also handle configured connection errors independently
344
+ of action.
271
345
  properties:
272
346
  action:
273
347
  type: string