swarm-forgeの使い方【Uncle Bobの6役構成】——AIエージェントを部屋で分け、引き継ぎで繋ぐ

オープンソース研究所

2026年9月10日 12:03

AIエージェントを2体同時に動かしたら、同じファイルを取り合って壊れた。

これ、やったことありませんか？

私もやりました。1体は直して、もう1体は消して、最後に残ったのはどちらの仕事でもないファイル。

SwarmForgeは、この問題に「部屋を分ける」で答えるツールです。作者は unclebob、Robert C. Martin氏のアカウント。GitHubで公開されていて、2026年9月10日時点で約3,800スターです。

出典はGitHubのリポジトリ。READMEを同じ日に確認しました。

この記事では、答える問いを1つに絞ります。swarm-forgeの使い方で、最初に何を試し、動く状態になったことをどう確かめるか。前提から起動、引き継ぎの仕組みまで、READMEの記述だけで組み立てます。

swarm-forgeとは——複数のAIエージェントを「別の作業場所」で走らせる道具

READMEの冒頭の一文は、こうです。

SwarmForgeは、隔離されたgit worktreeとtmuxセッションの中でAIエージェントを協調させる。

エージェント同士は、コミット済みの作業を「durable handoff（消えない引き継ぎ）」でやり取りする。人間の操作者は、手元のダッシュボードで作業を開始し、エージェントを確認し、承認ゲートを扱い、質問に答え、群れを止める。

つまり、こういうこと。

1体ごとに別のフォルダ（worktree）と別の端末（tmux）を与える。だから、ファイルの取り合いが起きない。やり取りは、コミットした結果を「引き継ぎ」として渡す形だけ。

ここで1つ注意。READMEの最上部に、赤字でこう書かれています。「bankrbot の SWARM トークンにお金を使わないでください」。このOSSは暗号資産と無関係です。似た名前のものが出回っているらしく、作者が明示的に警告している。先に知っておくと安心です。

swarm-forgeの使い方の前提——揃えるもの5つ

先に前提を確認します。READMEの Prerequisites には5つ並んでいます。

zsh、git、tmux、Babashka（bb・Clojureのスクリプト実行環境）、そして設定済みのエージェント基盤を最低1つ。対応しているのは grok、codex、claude、copilot。

ここで気づくことがあります。

SwarmForge自体はAIを持っていません。 動かすのは、あなたがすでに契約しているCodexやClaude Codeです。だから、無料で6体が走るわけではなく、6体分の呼び出しが自分の契約から出ていく。

うちはClaude Codeを複数の口で並列に使っていますが、並列にした瞬間に増えるのは速度より使用量でした。SwarmForgeを試すなら、どの契約で何体動かすかを先に決めるのが現実的だと思います。

STEP1：get-swarm-forge を置いて、パックを選ぶ

導入は、helperスクリプトを1つ置くところから始まります。READMEの手順はこれです。

mkdir -p ~/cmds
curl -L -o ~/cmds/get-swarm-forge \
  https://raw.githubusercontent.com/unclebob/swarm-forge/main/get-swarm-forge
chmod +x ~/cmds/get-swarm-forge

~/cmds をPATHに入れる。helperが変わったら入れ直す。READMEには、helperが「複数のブランチからファイルを組み合わせる」のでこれが正規の入口だ、とあります。

次に、何を入れるかを選びます。製品は5つ。

two-pack は coder → cleaner の2役。four-pack は specifier → coder → refactorer → architect の4役。six-pack は仕様・実装・整理・設計・堅牢化・QAの6役。project-manager と lieutenant は「forge」と呼ばれ、空のフォルダに入れて複数プロジェクトを束ねる形です。

pack は既存のプロジェクトに組み込むもの、forge は空のフォルダに入れるもの。 最初に試すなら、既存のリポジトリに two-pack を入れるのがいちばん小さい。

STEP2：swarmforge.conf の1行を読めるようになる

インストールすると、プロジェクトに swarmforge/swarmforge.conf ができます。ここが、誰が・どこで・どう受け取るかの正本です。

READMEにある1行の形はこれ。

window[-invisible] <role> <backend> <worktree> [task|batch] [forward-only|back-one|back-all] [backend arguments...]

読み方を順に。

role は役割の名前。backend は codex / grok / claude / copilot のどれか。worktree は作業場所で、ちょうど1役だけ master を使う。これは「プロジェクトの本体の checkout」を指す目印で、ブランチ名が master である必要はない、と書かれています。他の名前は .worktrees/<名前> の checkout になる。

task か batch は受信の形。既定は task。batch は、たまった引き継ぎをまとめて処理する。

forward-only / back-one / back-all は伝播。既定は前方向のみ。back-one と back-all は、後工程の結果を前の役へ「マージだけの写し」として戻す。

ファイルの並び順が、そのまま既定の流れになります。上から下へ、引き継ぎが進む。

STEP3：./swarm で起動し、ダッシュボードで承認する

six-pack のREADMEに、役の流れが1行で書かれています。

New Task → specifier → approval → coder → cleaner → architect → hardender → QA → Done

起動は get-swarm-forge six-pack のあと ./swarm。READMEでは、これで設定されたエージェント、引き継ぎデーモン、手元のダッシュボードが立ち上がる、とあります。既定の役は見えないtmuxセッションとして動き、ダッシュボードから各画面を開けます。

six-pack の既定では、specifier と hardender が Codex、それ以外が Grok に割り当てられています。ここは swarmforge.conf を書き換えれば変えられる、と明記されています。

動いた、と言える最初の場面はここです。ダッシュボードの「New Task」から specifier に仕事を渡す。specifier はプロジェクト本体の役なので、その引き継ぎは「Attention」に保留され、操作者の承認を待つ。承認すると coder へ届き、以降は自動で進む。

つまり最初の確認点は、「6体が走った」ではなく「1つ目の引き継ぎがAttentionに止まり、承認したら次へ動いた」です。ここが見えれば、部屋の分け方と引き継ぎの配線が生きています。

引き継ぎは「ファイル」で残る——handoffの仕組み

なぜ、たとえ途中で止めても壊れにくいのか。理由は handoff-protocol.md に書かれています。

エージェントはtmuxに直接命令を送らない。代わりに、小さな引き継ぎファイルを outbox/ に作る。デーモンがそれを検証し、受け手の inbox/new/ にコピーして、起こすための通知だけをtmuxで送る。元のファイルは sent か failed に移る。

受け手側は inbox/new/ → in_process/ → completed/ と、ファイルの置き場所そのものが状態です。

ファイル名も決まっています。

<priority>_<timestamp>_<sequence>_from_<sender>_to_<recipient-list>.handoff

優先度の数字が小さいほど先。タイムスタンプはUTC。同じ秒に作られた引き継ぎは連番で順序が決まる。

ログを別に付けなくても、フォルダを見れば「誰が誰に何を渡して、どこまで進んだか」が分かる。引き継ぎの正本がチャットの履歴ではなくファイルなのは、うちがAI社員の状態を毎回ファイルへ書き出す運用にしているのと同じ考え方で、ここは個人的にも素直に納得しました。

swarm-forgeの使い方で、先に決めておくこと

最後に、試す前の3点。

1つ目、契約。前提のとおり、動かすAIはあなたの契約です。6役なら6体分の消費が出ます。

2つ目、ライセンス。2026年9月10日時点で、GitHubのAPIが返すリポジトリ情報にライセンスの記載はありませんでした。業務で組み込む前に、リポジトリ内のファイルと作者の表記を自分で確かめてください。

3つ目、変更の速さ。READMEには、実験的なブランチ（squad など）は製品ではないこと、設定の正本は各ブランチの conf であることが繰り返し書かれています。記事の記述より、手元の conf を信じてください。

今日できることは、get-swarm-forge を置いて two-pack を1つの試しリポジトリに入れ、swarmforge.conf の2行を読むところまで。6体は、その後で十分です。

OSSを実務で活用するための6大特典

OSSの選び方や、AIと組み合わせた実務への取り入れ方を整理したい方へ。活用を進めるための6大特典をご案内しています。

👉 OSS活用の6大特典を見る