swarm

Swarm

ディスパッチ契約。 各ワーカーの記述子は、provider-dispatch.md を通じて解決します。親がネイティブレーンと外部レーンを開始します。ワーカーが自分でルーティングすることはありません。Codex では、残りの Claude ツール名を codex-tools.md を使って解決します。

開始

何かを起動する前に、各フェーズにつき1つの項目を記した ToDo リストを作成します。

1. 方針を定める
2. 作業を振り分ける
3. 結果を集約する
4. 報告する

フェーズ A：方針を定める

1. 完了条件と、Swarm が返すべき成果物またはレポートを明示します。
2. 形を選びます。作業を分割する、同一の指示を N 人のワーカーに並行して実行させる、または両方を組み合わせます。並行実行または組み合わせる場合は、ワーカーの起動前に first pass、rank all、または best-of を宣言します。
3. 現在のハーネスの pstack モデルシートに swarm workers がある場合は、そこからワーカーの記述子を選びます。ない場合は、役割の既定値 を使います。モデルを並行実行する場合は、各実行に使う記述子を事前に指定します。poteto-mode スキルの Subagents セクションに従って、各サブエージェントの作業に応じた effort を選びます。
4. 書き込みを行う場合は、各ワーカーにそれぞれ書き込み可能な出力先を割り当てます。ワーカーがコミットを検証または測定する場合は、各指示に正確な SHA を記載します。測定の指示には、測定方法（サンプル数、1サンプルの定義、順序）も記載します。ワーカーは結果にその両方を記録します。

フェーズ B：作業を振り分ける

プロバイダーディスパッチを通じて、1回の振り分けフェーズですべての N 人のワーカーを起動します。ネイティブレーンではバックグラウンドのサブエージェントを使います。外部レーンではランチャーをバックグラウンド処理として呼び出し、タスク／セッションのハンドルを保持します。長時間実行するワーカーに Claude のフォアグラウンド Bash パスを使ってはいけません。各書き込みワーカーは、割り当てられた worktree または出力ディレクトリで実行します。分離はプロバイダーではなく、これらのパスによって実現します。

ワーカーを既定でないブランチから開始する必要がある場合は、ワーカー自身の worktree でそのブランチをチェックアウトし、指示に worktree のパスを記載します。

各指示はそれだけで完結するものにします。目標、範囲、正確な分割または並行実行での担当、検証方法、報告内容を含めます。報告では、証拠を添えて PASS、ISSUES、または BLOCKED を使います。不具合を証明できるワーカーは ISSUES を報告し、最初の1件だけでなく、証明できるすべての問題を列挙します。

ワーカーが離脱した場合は、N-1 人で続行し、プロバイダー、モデル、受領失敗を記録します。別のプロバイダーで黙って代替してはいけません。

フェーズ C：結果を集約する

最終結果を読みます。指示で指定された SHA と測定方法が記録されていない結果は破棄し、そのワーカーを1回だけ再起動します。2回目も記録がない場合は、ギャップとして記録します。ギャップは合格として数えません。カバレッジについては、必須のすべての分割に結果が必要です。並行実行については、事前に宣言した選択ルールを適用します。first pass、rank all、または best-of を使います。ワーカーの出力をそのまま貼り付けてはいけません。

フェーズ D：報告する

表、問題点の一行説明、ギャップまたは離脱、ならびに並行実行で使用した場合はその選択ルールを含む、統合済みのチャット内レポートを1つ返します。