devil-team-orchestrator

devil-team-orchestrator

別系統 LLM の目で批判的にレビューする 2 層 orchestrator。Claude 単独の自信過剰バイアス (同一モデル内では自分の盲点を拾えない構造的問題) を抑え、観点の盲点を別系統で拾う。タスク受領のたびに自動的に Layer 2 の起動を判断する。

責務 (一方向)

Devil 観点策定 + Devil ファイル生成 (devil-team-adder skill が責務)
   ↓
devils/ ディレクトリ (常駐 Devil 群)
   ↓ orchestrator が読み込み
devil-team-orchestrator (本 skill、runtime 起動判断 + 並列実行 専用)

• 本 skill は scaffold しない (観点策定 + Devil ファイル生成は devil-team-adder skill)
• 本 skill は Devil の追加・修正をしない (既存 Devil ファイルを読むだけ)

入力

• ユーザーから受領した最新タスク (プロンプト全体)
• skill 内 devils/ 配下の Devil 役割定義ファイル (複数)

Phase 構成

Phase 0: 環境ケーパビリティ判定

references/codex-capability-check.md の手順で判定:

• codex --version 成功 + codex exec --sandbox read-only --cd "$(pwd)" "echo OK" dry-run 成功 → Layer 2 = Codex Devil 並列起動 (主役)
• どちらか失敗 → Layer 2 = Claude Devil 並列起動 (fallback、Agent tool 経由)
• Agent tool 不可 (subagent 内のネスト等) → 主セッション内逐次レビューに縮退 (ユーザー通知)

Phase 1: 起動判断 (Claude が文脈判断、キーワード判定禁止)

タスクの実質的な重みを Claude が文脈 から判断する。ユーザー発話の表層キーワード (「実装」「commit」等) で機械分類しない。詳細な判断軸とガイダンスは references/launch-decision.md を参照。

判断軸 (要点):

• 作業の影響範囲・不可逆性・複雑度・既知の癖発動条件 を Claude が自問
• スキップ妥当な典型例 / 適用妥当な典型例は launch-decision.md にガイダンスとして記載 (絶対ルールではない)
• 迷ったら適用側に倒す (独断スコープ縮小回避)

判定結果は Phase 4 で必ず出力。

Phase 2: Layer 2 — Devil 並列起動 (Codex 主役、Claude fallback)

2a. Codex 利用可能 (主役、案 A)

1. devils/devil-*.md を全列挙

2. 各 Devil の役割定義を読み込み

3. Codex CLI で並列起動:

   codex exec --sandbox read-only --cd "$(pwd)" "<devil-role-prompt>"
   

   • prompt は役割定義から構築 (Devil 観点 = α / β / γ / δ 等を明示)
   • 並列実行は Bash 並列 (& バックグラウンド) または Agent tool 経由で codex exec を発行
   • --full-auto は使わない (workspace-write エイリアスで read-only と矛盾)

4. 各 Devil は対象タスクに対して批判的レビューを返す

2b. Codex 利用不可 (fallback、Agent tool 経由)

旧運用と同等に縮退:

1. 同じ Devil 役割定義を Agent tool で並列起動 (subagent_type: general-purpose)
2. Phase 4 出力に「Codex 利用不可、Claude Devil 並列に縮退」を明記

Phase 3: 廃止 (旧 Layer 3 Codex cross-check)

案 A 採用で削除。Codex を Phase 2 で直接 Devil として起動するため、cross-check 専用レイヤーは役割重複として廃止。旧 Phase 3 の prompt テンプレート (cross-check prompt) は Phase 2 の Codex Devil prompt として吸収。Devil 観点が複数あれば複数の codex exec を並列で発行する設計。

Phase 4: 起動判断結果出力 (Hard rule、必須)

以下の形式で必ず出力:

━━━━━━━━━━━━━━━━━━━━━━
DEVIL-TEAM-ORCHESTRATOR 起動判断:
- タスク種別: {Claude が文脈から判断、自由記述。例: 実装 / 設計 / 調査 / 記事執筆 / Skill 編集 / instruction 編集 / 設定ファイル編集 / 軽微 / commit のみ / 等}
- 適用判定: {適用 / スキップ}
- 理由: {除外理由 or 適用根拠}
- Codex 環境: {利用可 (dry-run 成功) / 利用不可 (理由)}
- 常駐 Devil 群: {n} 体 ({Devil 名一覧})
- 起動方式: {Layer 2 Codex Devil 並列 / Layer 2 Claude Devil 並列 (fallback) / スキップ}
━━━━━━━━━━━━━━━━━━━━━━

Phase 5: レビュー結果集約

• 各 Devil の出力を主セッションが集約
• 運用レシピ「重複は高確度で当たり / 単独指摘は要吟味」を適用
• (案 A 採用後は全 Devil が Codex 経由のため、Codex 単独指摘も Layer 2 内の単独指摘として同様に吟味)
• ユーザーへの提示 or 修正反映

Hard rules

• 起動判断結果出力必須 (Phase 4 をスキップしない)
• ユーザー指示範囲外のスコープ縮小禁止: 「軽微」の定義を Claude が独断で広めに引かない (コスト最適化バイアス禁止)
• Codex 利用判定は dry-run 成功必須: command -v codex だけでは不十分、実 cwd で 1 回 dry-run 成功
• scaffold はしない: 観点策定や Skill 内 Devil の追加・修正は devil-team-adder skill の責務
• subprocess 起動コマンドにユーザー指示外の制限値を独断付与しない (予算・ターン・timeout 等を勝手に付けない)
• Codex 利用可能なのに fallback (Claude Devil) で起動しない (案 A 採用後は Codex 主役)

移植性

references/self-portability-contract.md の禁忌に従う。プロジェクト固有要素は skill 内で参照しない。devils/ 配下の同梱ファイルは「動かして試すための参考実装サンプル」(α evasion-watcher / β rule-skipper-detector / γ verification-coverage / δ audience-blind-spot の 4 体)。さらに固有観点が必要なら devil-team-adder skill で 6 軸ガイドに沿って観点を策定して devils/ に追加できる。詳細は references/devils-roster.md の表を参照。

関連

• devil-team-adder skill -- Skill 内 Devil 観点策定 + scaffold (本 skill とペア運用)
• references/launch-decision.md -- runtime 起動判断ロジック
• references/codex-capability-check.md -- Codex 環境判定手順
• references/devils-roster.md -- 同梱 Devil 名簿 + 観点策定 6 軸ガイド
• references/self-portability-contract.md -- skill 移植性契約