skill-parallel-agents

ホスト：Codex CLI — このスキルはClaude Code向けに設計され、Codex向けに適応されています。 相互参照コマンドでは、/octo:* スラッシュコマンドではなく、Codexにインストールされたスキル名を使用します。 現在のCodexシェルとサブエージェントツールを使用してください。現在のセッションで利用可能であることが確認できるまでは、プロバイダー、モデル、またはホストのサブエージェントが利用可能だと主張しないでください。 ホストツールに相当するものについては、skills/blocks/codex-host-adapter.md を参照してください。

Claude Octopus - 多腕のオーケストレーター

必須の遵守事項 — 省略禁止

このスキルが呼び出された場合、複数のプロバイダーに並行して作業を割り当てなければなりません。次の行為は禁止されています。

• 並行する複数プロバイダーへの割り当ての代わりに、単一モデルでタスクを逐次実行する
• orchestrate.shを省略して、直接作業を行う
• タスクが単一プロバイダーで対応できるほど「簡単」だと判断する
• 複数のLLMによる並行実行の代わりに、Claudeのみで逐次実行する

このスキルは、複数プロバイダーによる並行作業のために存在します。「自分だけで対応しよう」と考えていることに気づいたら、そこで止めてください。

Claude Code向けの多腕オーケストレーター — ダブルダイヤモンド手法を用いて、包括的な問題探索、合意形成、検証済みの成果物の提供を行います。

    DISCOVER          DEFINE           DEVELOP          DELIVER
      (probe)         (grasp)          (tangle)          (ink)

    \         /     \         /     \         /     \         /
     \   *   /       \   *   /       \   *   /       \   *   /
      \ * * /         \     /         \ * * /         \     /
       \   /           \   /           \   /           \   /
        \ /             \ /             \ /             \ /

   Diverge then      Converge to      Diverge with     Converge to
    converge          problem          solutions        delivery

クイックスタート

Claude Codeユーザーへの注意： これらのコマンドを実行する必要はありません。Claudeに自然な言葉で話しかけてください。

• 「OAuth認証のパターンを調査して」
• 「ユーザー認証システムを構築して」
• 「このコードにセキュリティ上の問題がないかレビューして」

以下のコマンドは、CLIを直接使用する場合や自動化向けです。

# Full Double Diamond workflow (all 4 phases)
${HOME}/.claude-octopus/plugin/scripts/orchestrate.sh embrace "Build a user authentication system"

# Individual phases
${HOME}/.claude-octopus/plugin/scripts/orchestrate.sh probe "Research authentication best practices"
${HOME}/.claude-octopus/plugin/scripts/orchestrate.sh grasp "Define auth requirements"
${HOME}/.claude-octopus/plugin/scripts/orchestrate.sh tangle "Implement auth feature"
${HOME}/.claude-octopus/plugin/scripts/orchestrate.sh ink "Validate and deliver auth implementation"

# Crossfire: Adversarial cross-model review
${HOME}/.claude-octopus/plugin/scripts/orchestrate.sh grapple "implement password reset API"
${HOME}/.claude-octopus/plugin/scripts/orchestrate.sh grapple --principles security "implement JWT auth"
${HOME}/.claude-octopus/plugin/scripts/orchestrate.sh squeeze "review auth.ts for vulnerabilities"

# Smart auto-routing (detects intent automatically)
${HOME}/.claude-octopus/plugin/scripts/orchestrate.sh auto "research OAuth patterns"           # -> probe
${HOME}/.claude-octopus/plugin/scripts/orchestrate.sh auto "build user login"                  # -> tangle + ink
${HOME}/.claude-octopus/plugin/scripts/orchestrate.sh auto "review the auth code"              # -> ink

重要：このスキルを使用しない場合

ユーザーのリクエストが次のいずれかに該当する場合、このスキルを使用しないでください。

1. Claude Codeの組み込みコマンド — Claude Code自体に含まれる、/ で始まるコマンド：

   • /plugin - プラグイン管理（追加、削除、更新、一覧表示）
   • /init - プロジェクトの初期化
   • /help - ヘルプドキュメント
   • /clear - 会話のクリア
   • /commit - Gitコミット操作
   • /remember - メモリ管理
   • /parallel-agents または /octo:* ではない、その他の / コマンド

2. ツールの直接使用 — 簡単なファイル操作、gitコマンド、またはターミナル作業

   • ファイルの読み取り／書き込み
   • gitコマンドの実行
   • 基本的なbash操作
   • これらには組み込みツールを直接使用してください

3. Claude Codeの設定 — Claude Code自体の管理

   • 設定の変更
   • プラグインの管理
   • Claude Codeの更新

ユーザーのリクエストが上記のいずれかに該当する場合、このスキルを有効にしないでください。代わりに、標準のClaude Codeツールと機能を使用して対応してください。

視覚的なインジケーター — 実行中の内容を確認

Claude Octopusは視覚的なインジケーターを使用するため、どのAIが応答しているかを常に確認できます。

インジケーター	意味	使用するもの
🐙	並行モード	orchestrate.shを介してオーケストレーションされた複数のCLI
🔴	Codex CLI	OpenAI Codex（あなたのOPENAI_API_KEY）
🧭	Antigravity CLI	Google Antigravity（認証済みの利用枠）
🔵	Claudeサブエージェント	Claude Codeホストのサブエージェントツール（組み込み）

外部CLIとサブエージェントを起動する条件

外部CLIが実行される場合：

• /parallel-agents コマンドを明示的に使用した場合
• /octo:debate コマンド（AI Debate Hub）を使用した場合
• orchestrate.shのワークフロー（probe、grasp、tangle、ink、embrace、grapple、squeeze）を実行した場合
• Knowledge Modeの熟議（Knowledge ModeがONの場合）
• このスキルを起動する自然言語のリクエスト（調査、構築、レビューのタスク）

Claudeサブエージェントが実行される場合：

• 簡単なファイル操作（読み取り、書き込み、編集）
• Gitコマンドとbash操作
• コードの読み取りとナビゲーション
• 複数の視点を必要としないタスク
• Claude Codeの組み込み機能で十分に対応できる場合

重要な理由： 外部CLIはOpenAI／GoogleのAPI利用枠を使用し、費用が発生します。Claudeサブエージェントは追加料金なしでClaude Codeに含まれています。

🐙 CLAUDE OCTOPUS ACTIVATED と表示された場合、複数の視点から分析するために、CodexやAntigravityなどの外部CLIプロバイダーが呼び出されます。

マルチプロバイダーモードを強制する

通常はワークフローが起動しないような簡単なタスクでも、マルチプロバイダー分析が必要な場合があります。意思決定に包括的な視点が必要な場合、異なるモデルの考え方を比較したい場合、自動ルーティングがタスクの複雑さを過小評価している場合に便利です。

明示的なコマンド

/octo:multi コマンドを使って、マルチプロバイダー実行を強制します。

/octo:multi "Explain how Redis works"
/octo:multi "What is OAuth?"
/octo:multi "Review this simple function"
/octo:multi "Should we use TypeScript?"

自然言語によるトリガー

自然言語を使って、マルチプロバイダーモードを強制することもできます。

"Run this with all providers: What is JWT?"
"I want multiple AI models to look at our architecture"
"Get multiple perspectives on this design decision"
"Use all providers for explaining caching strategies"
"Force multi-provider analysis of our API design"

並列モードを強制する場合

次の場合は、並列モードを強制してください：

• 重要な意思決定で、複数のモデルによる包括的な分析が必要な場合
• 視点を比較する場合。異なるモデルが同じ問題にどう取り組むかを確認したい場合
• 深みのある簡単な質問。一見簡単でも、複数モデルによる綿密な分析に値する質問の場合
• 異なるアプローチを学ぶ場合。各モデルがトピックについてどう考えるかを探りたい場合
• 自動ルーティングが複雑さを過小評価している場合。タスクは簡単に見えても、微妙な点がある場合

次の場合は、並列モードを強制しないでください：

• タスクですでにワークフローが自動的に起動する場合（octo research、octo build、octo review）
• Claude が確実に回答できる簡単な事実確認の質問
• コスト効率が重要な場合（下記のコストに関する注意を参照）
• ファイル操作やコードのナビゲーション（組み込みツールを使用してください）

コストに関する注意

並列モードを強制すると、すべてのタスクで外部 CLI が使用されるため、API コストが発生します：

プロバイダー	クエリあたりのコスト	使用するもの
🔴 Codex CLI	約 0.01～0.05 USD	お使いの OPENAI_API_KEY
🧭 Antigravity CLI	アクセス／サブスクリプションに含まれます	Antigravity CLI 認証
🔵 Claude	含まれています	Claude Code サブスクリプション

並列モードを強制した場合のクエリあたりの合計コスト：約 0.02～0.08 USD

複数の視点が本当に役立つタスクに限り、並列モードを慎重に強制してください。通常の作業では、マルチプロバイダー分析が有益なタイミングを自動ルーティングに判断させてください。

視覚的なインジケーター

並列モードを強制すると、次のバナーが表示されます：

🐙 **CLAUDE OCTOPUS ACTIVATED** - Multi-provider mode
Force parallel execution

Providers:
🔴 Codex CLI - [Role in this task]
🧭 Antigravity CLI - [Role in this task]
🔵 Claude - [Role in this task]

続いて、各プロバイダーのインジケーター（例：🔴 🟡 🧭 🔵）が付いた結果が表示されます。

前提条件の確認

このスキルが有効になったら、ローカルプロバイダーの確認を実行します：

OCTO_ROOT="${CLAUDE_PLUGIN_ROOT:-${HOME}/.claude-octopus/plugin}"
"$OCTO_ROOT/scripts/orchestrate.sh" detect-providers

この確認では、ローカルのコマンド、認証情報、および1時間のキャッシュを読み取ります。プロバイダー API は呼び出しません。現在の出力には、Claude Code のバージョン要件と、各プロバイダーのステータスが1つずつ含まれます：

Detecting Claude Code version...

CLAUDE_CODE_VERSION=2.1.219
CLAUDE_CODE_STATUS=ok
CLAUDE_CODE_MINIMUM=2.1.14

CODEX_STATUS=ok
AGY_STATUS=unauthenticated

プロバイダーの値は、ok、unauthenticated、quota、not-installed、または model-invalid などの具体的な理由です。

結果に基づくルーティング

Claude Code のバージョンが古い場合は、処理を中止し、コマンドから報告されたバージョンと更新手順を表示します：

CLAUDE_CODE_VERSION=2.1.13
CLAUDE_CODE_STATUS=outdated
CLAUDE_CODE_MINIMUM=2.1.14

Claude 以外のプロバイダーのうち1つでも ok と報告された場合は、それを使用します。並列実行には、準備が整った Claude 以外のプロバイダーが少なくとも1つ必要ですが、通常の Claude のみを使うコマンドは、そうしたプロバイダーがなくても動作します。ok と報告されたプロバイダーがない場合は、並列ワークフローを中止し、ユーザーに /octo:setup を案内してください。また、1つのプロバイダーを繰り返し実行して、プロバイダー間の合意を装ってはいけません。準備が整ったプロバイダーが1つあれば追加の視点は得られますが、マルチプロバイダーによる合意形成にはなりません。

このコマンドは ~/.claude-octopus/.provider-cache に書き込みます。最大1時間はこのキャッシュを再利用し、その後は再度検出を実行してください。

ダブルダイアモンド・ワークフロー

フェーズ1：PROBE（発見）

発散してから収束し、理解を深める

4つの視点による並行調査：

• 問題領域の分析（制約、要件、ニーズ）
• 既存の解決策の調査（うまくいったこと、失敗したこと）
• エッジケースの検討（潜在的な課題）
• 技術的な実現可能性（前提条件、依存関係）

${HOME}/.claude-octopus/plugin/scripts/orchestrate.sh probe "What are the best approaches for real-time notifications?"

フェーズ2：GRASP（定義）

問題について合意を形成する

多角的な問題定義：

• 核となる問題の記述
• 成功基準
• 制約と境界

# Optional second argument: no phase sets this variable; copy the path the probe
# phase printed after "Probe synthesis saved to:"
PROBE_SYNTHESIS="<printed probe-synthesis-*.md path>"
${HOME}/.claude-octopus/plugin/scripts/orchestrate.sh grasp "Define requirements for notification system" "$PROBE_SYNTHESIS"

フェーズ 3：TANGLE（開発）

複数のソリューションで発散します

検証機能を備えた拡張版の map-reduce：

• LLM によるタスクの分解
• エージェント間での並列実行
• 品質ゲート（成功率 75% のしきい値）

# Optional second argument: no phase sets this variable; copy the path the grasp
# phase printed after "Problem definition saved to:"
GRASP_CONSENSUS="<printed grasp-consensus-*.md path>"
${HOME}/.claude-octopus/plugin/scripts/orchestrate.sh tangle "Implement notification service" "$GRASP_CONSENSUS"

フェーズ 4：INK（納品）

検証済みの成果物へと収束します

納品前の検証：

• 品質ゲートの確認
• 結果の統合
• 最終成果物の生成

# Optional second argument: no phase sets this variable; copy the path the tangle
# phase printed after "Validation complete:"
TANGLE_VALIDATION="<printed tangle-validation-*.md path>"
${HOME}/.claude-octopus/plugin/scripts/orchestrate.sh ink "Deliver notification system" "$TANGLE_VALIDATION"

ワークフロー全体：EMBRACE

4 つのフェーズすべてを、コンテキストを自動的に引き継ぎながら順番に実行します：

${HOME}/.claude-octopus/plugin/scripts/orchestrate.sh embrace "Create a complete user dashboard feature"

Crossfire：敵対的なクロスモデルレビュー

モデルによって見落としやすい点は異なります。Crossfire コマンドを使うと、モデル同士が互いの成果を批評し、単一モデルのレビューより多くの問題を検出できます。

GRAPPLE - 敵対的な議論

コンセンサスに至るまで、2 本の触手がもみ合います

利用可能なプロバイダーがそれぞれソリューションを提案し、互いの成果を批評します。統合によって勝者を決定します。

┌─────────────┐     ┌─────────────┐
│   Codex     │     │ Antigravity │
│ (Proposer)  │     │ (Proposer)  │
└──────┬──────┘     └──────┬──────┘
       │                   │
       ▼                   ▼
┌─────────────┐     ┌─────────────┐
│ PROPOSAL A  │ ←─→ │ PROPOSAL B  │
└──────┬──────┘     └──────┬──────┘
       │                   │
       ▼                   ▼
┌─────────────┐     ┌─────────────┐
│ Antigravity │     │   Codex     │
│ (Critic)    │     │  (Critic)   │
└──────┬──────┘     └──────┬──────┘
       │                   │
       └─────────┬─────────┘
                 ▼
       ┌─────────────────┐
       │   SYNTHESIS     │
       │ (Winner + Fix)  │
       └─────────────────┘

# Basic grapple
${HOME}/.claude-octopus/plugin/scripts/orchestrate.sh grapple "implement password reset API"

# Grapple with security principles
${HOME}/.claude-octopus/plugin/scripts/orchestrate.sh grapple --principles security "implement JWT authentication"

# Grapple with performance principles
${HOME}/.claude-octopus/plugin/scripts/orchestrate.sh grapple --principles performance "optimize database queries"

SQUEEZE - レッドチームによるセキュリティレビュー

タコが獲物を絞り、弱点がないか調べます

ブルーチーム（Codex）がセキュアなコードを実装します。レッドチーム（Antigravity）が攻撃して脆弱性を探します。その後、修正と検証を行います。

Phase 1: Blue Team implements secure solution
Phase 2: Red Team finds vulnerabilities
Phase 3: Remediation fixes all issues
Phase 4: Validation verifies all fixed

${HOME}/.claude-octopus/plugin/scripts/orchestrate.sh squeeze "implement user login form"
${HOME}/.claude-octopus/plugin/scripts/orchestrate.sh squeeze "review auth.ts for vulnerabilities"

憲法的原則

Grapple は、ドメイン固有の批評原則に対応しています：

原則	焦点	使用例
general	全体的な品質	ほとんどのレビューで使用するデフォルト
security	OWASP Top 10、セキュアコーディング	認証、決済、ユーザーデータ
performance	N+1 クエリ、キャッシュ、非同期処理	データベース、API の最適化
maintainability	クリーンコード、テスト容易性	リファクタリング、コードレビュー

${HOME}/.claude-octopus/plugin/scripts/orchestrate.sh grapple --principles security "implement password reset"
${HOME}/.claude-octopus/plugin/scripts/orchestrate.sh grapple --principles performance "optimize search API"
${HOME}/.claude-octopus/plugin/scripts/orchestrate.sh grapple --principles maintainability "refactor user service"

スマートな自動ルーティング

auto コマンドは意図を示すキーワードを検出し、適切なワークフローにルーティングします：

キーワード	ルーティング先	フェーズ
research, explore, investigate, analyze	probe	発見
develop, dev, build, implement, create	tangle + ink	開発 + 納品
qa, test, review, validate, check	ink	納品（品質重視）
security audit, red team, pentest	squeeze	レッドチーム
adversarial, cross-model, debate	grapple	議論
（その他のコーディング関連キーワード）	codex エージェント	単一エージェント
（その他の設計関連キーワード）	agy エージェント	単一エージェント

例：

${HOME}/.claude-octopus/plugin/scripts/orchestrate.sh auto "research best practices for caching"     # -> probe
${HOME}/.claude-octopus/plugin/scripts/orchestrate.sh auto "build the caching layer"                 # -> tangle + ink
${HOME}/.claude-octopus/plugin/scripts/orchestrate.sh auto "review the cache implementation"         # -> ink
${HOME}/.claude-octopus/plugin/scripts/orchestrate.sh auto "security audit the auth module"          # -> squeeze
${HOME}/.claude-octopus/plugin/scripts/orchestrate.sh auto "have both models debate the API design"  # -> grapple
${HOME}/.claude-octopus/plugin/scripts/orchestrate.sh auto "fix the cache invalidation bug"          # -> codex

品質ゲート

tangle フェーズでは品質ゲートが適用されます：

スコア	状態	動作
>= 90%	合格	ink に進む
75-89%	警告	注意して続行
< 75%	不合格	ink フェーズでレビュー対象としてフラグ付け

コマンドリファレンス

Double Diamond コマンド

コマンド	フェーズ	説明
probe <prompt>	発見	AI による統合を伴う並列調査
grasp <prompt>	定義	問題定義に関する合意形成
tangle <prompt>	開発	品質ゲートを備えた拡張版 map-reduce
ink <prompt>	納品	検証と最終納品
embrace <prompt>	4 つすべて	Double Diamond ワークフロー全体
preflight	-	すべての依存関係を検証

Crossfire コマンド（敵対的レビュー）

コマンド	説明
grapple <prompt>	コンセンサスに至るまで Codex と Antigravity が議論
grapple --principles TYPE <prompt>	ドメイン原則（セキュリティ、パフォーマンス、保守性）に基づく議論
squeeze <prompt>	レッドチームによるセキュリティレビュー（ブルーチーム対レッドチーム）

従来のオーケストレーションコマンド

コマンド	説明
init	ワークスペースを初期化
spawn <agent> <prompt>	単一エージェントを起動
auto <prompt>	スマートルーティング（Double Diamond またはエージェント）
fan-out <prompt>	複数のエージェントに送信
map-reduce <prompt>	分解して並列化
parallel [tasks.json]	タスクファイルを実行
status	実行中のエージェントを表示
kill [id|all]	エージェントを終了
clean	ワークスペースをリセット
aggregate [filter]	結果を統合

オプション

オプション	デフォルト	説明
-p, --parallel	3	同時に実行するエージェントの最大数
-t, --timeout	600	タスクごとのタイムアウト（秒）。grasp の 300 秒など、呼び出しごとに固定された予算も置き換えます。OCTOPUS_AGENT_TIMEOUT で上書きされます
-v, --verbose	false	詳細ログ
-n, --dry-run	false	実行せずに表示

エージェントの選択（プレミアムのデフォルト）

エージェント	モデル	最適な用途
codex	gpt-5.6-sol	最先端の実装と独立したレビュー
codex-standard	gpt-5.6-terra	バランスの取れた実装とレビュー
codex-mini	gpt-5.6-luna	迅速な修正、簡単なタスク
agy	サービス選択のデフォルト	詳細な分析と外部レビュー
agy-research	サービス選択のデフォルト	調査に特化した Antigravity の利用枠
codex-review	gpt-5.6-sol	コードレビューのモード
openrouter	各種	汎用フォールバック（400 以上のモデル）
orcarouter	各種	OrcaRouter ゲートウェイ経由の汎用フォールバック

プロバイダーを考慮したルーティング（v4.8）

Claude Octopus は、サブスクリプションのティアとコストに基づいてタスクをインテリジェントにルーティングします。

プロバイダーのサブスクリプションティア

プロバイダー	ティア	月額費用	機能
Codex/OpenAI	Free、Plus、Pro、API	0-200 USD	コード、チャット、レビュー
Antigravity	Google アクセス／サブスクリプション	アクセスに含まれる	コード、分析、外部レビュー
Claude	Pro、Max 5x、Max 20x、API	20-200 USD	コード、チャット、分析、長いコンテキスト
OpenRouter	従量課金	変動	400 以上のモデル、ルーティングのバリエーション
OrcaRouter	従量課金	変動	単一のゲートウェイ、名前空間付きモデル ID

コスト最適化戦略

戦略	説明
balanced（デフォルト）	コストと品質をスマートに組み合わせます
cost-first	対応可能なプロバイダーのうち、最も低コストのものを優先します
quality-first	最上位ティアのプロバイダーを優先します

例： Google の利用枠に Antigravity へのアクセスが含まれている場合、システムは廃止された Gemini CLI を呼び出さずに、分析に AGY を優先できます。

ルーティングの CLI フラグ

# Force a specific provider
${HOME}/.claude-octopus/plugin/scripts/orchestrate.sh --provider agy auto "analyze code structure"

# Prefer cheapest option
${HOME}/.claude-octopus/plugin/scripts/orchestrate.sh --cost-first auto "research best practices"

# Prefer highest quality
${HOME}/.claude-octopus/plugin/scripts/orchestrate.sh --quality-first auto "complex refactoring task"

# OpenRouter routing variants
${HOME}/.claude-octopus/plugin/scripts/orchestrate.sh --openrouter-nitro auto "quick task"  # Fastest
${HOME}/.claude-octopus/plugin/scripts/orchestrate.sh --openrouter-floor auto "bulk task"   # Cheapest

設定

プロバイダーのティアは、setup の実行時またはプロバイダー設定ファイルで設定します。

# Run setup wizard (includes provider tier steps)
${HOME}/.claude-octopus/plugin/scripts/orchestrate.sh setup

# View current provider status
${HOME}/.claude-octopus/plugin/scripts/orchestrate.sh status

設定ファイル：~/.claude-octopus/.providers-config

version: "2.0"
providers:
  codex:
    installed: true
    auth_method: "oauth"
    subscription_tier: "plus"    # free|plus|pro|api-only
    cost_tier: "low"             # free|low|medium|high|bundled|pay-per-use

  agy:
    installed: true
    auth_method: "oauth"
    subscription_tier: "google"     # service-managed Google access
    cost_tier: "bundled"

  openrouter:
    enabled: false
    routing_preference: "default"   # default|nitro|floor

  orcarouter:
    enabled: false

cost_optimization:
  strategy: "balanced"  # cost-first|quality-first|balanced

OpenRouter フォールバック

OpenRouter は、外部 CLI を直接利用できない場合の汎用フォールバックとして、400 以上のモデルを提供します。

# Set up OpenRouter API key
export OPENROUTER_API_KEY="sk-or-..."

# Re-run setup to configure
${HOME}/.claude-octopus/plugin/scripts/orchestrate.sh setup

OrcaRouter フォールバック

OrcaRouter は、外部 CLI を直接利用できない場合の汎用フォールバックとして、多数のモデルに接続できる単一のゲートウェイを提供します。

# Set up OrcaRouter API key
export ORCAROUTER_API_KEY="sk-orca-..."

# Re-run setup to configure
${HOME}/.claude-octopus/plugin/scripts/orchestrate.sh setup

ワークスペースの構成

~/.claude-octopus/
├── results/
│   ├── probe-synthesis-*.md      # Research findings
│   ├── grasp-consensus-*.md      # Problem definitions
│   ├── tangle-validation-*.md    # Quality gate reports
│   └── delivery-*.md             # Final deliverables
├── logs/                         # Execution logs
├── plans/                        # Execution plan history
└── .gitignore

ワークフローの例

調査優先の開発

# 1. Explore the problem space
${HOME}/.claude-octopus/plugin/scripts/orchestrate.sh probe "Authentication patterns for microservices"

# 2. Define the approach (with the path step 1 printed after "Probe synthesis saved to:")
PROBE_SYNTHESIS="<printed probe-synthesis-*.md path>"
${HOME}/.claude-octopus/plugin/scripts/orchestrate.sh grasp "OAuth2 with JWT for our API" \
  "$PROBE_SYNTHESIS"

# 3. Implement with validation
${HOME}/.claude-octopus/plugin/scripts/orchestrate.sh tangle "Implement OAuth2 authentication"

# 4. Deliver with quality checks
${HOME}/.claude-octopus/plugin/scripts/orchestrate.sh ink "Finalize auth implementation"

クイックビルド（自動ルーティング）

# Auto-detects "build" intent -> runs tangle + ink
${HOME}/.claude-octopus/plugin/scripts/orchestrate.sh auto "build a rate limiting middleware"

機能開発の全工程

# All 4 phases in one command
${HOME}/.claude-octopus/plugin/scripts/orchestrate.sh embrace "Create a user notification system with email and push support"

ベストプラクティス

1. 探索を必要とする新機能では、まず embrace を使用します
2. アプローチを決める前に調査する場合は、probe のみを使用します
3. 意図に基づくスマートなルーティングには、auto を使用します
4. 段階的なワークフローでは、前のフェーズの結果ファイルを 2 番目の引数として渡し、フェーズを連結します
5. 長時間のワークフローの前に preflight を実行し、依存関係を確認します
6. ink に進む前に、tangle の出力にある品質ゲートを確認します

トラブルシューティング

事前チェックが失敗する

${HOME}/.claude-octopus/plugin/scripts/orchestrate.sh preflight
# Verify: codex CLI, agy CLI, and task-relevant provider credentials

品質ゲートの失敗

Tangle フェーズでは、75% の成功率が必要です。失敗する場合：

• タスクをより小さなサブタスクに分割します
• -t 600 でタイムアウトを延長します
• ~/.claude-octopus/logs/ にある個々のエージェントのログを確認します

ワークスペースをリセットする

${HOME}/.claude-octopus/plugin/scripts/orchestrate.sh clean
${HOME}/.claude-octopus/plugin/scripts/orchestrate.sh init