Squad：GitHub Copilot 上で動くファイルベースの AI エージェントチーム

帽子を被ったチャットボットではない、と README が言う理由

Squad は README 冒頭で「Human-led AI agent teams for any project」と位置づけられ、アルファソフトウェアであることも最初に警告されています。API と CLI コマンドはリリース間で変わり得るため、CHANGELOG.md が破壊的変更の参照先になります。

README が述べるのは、各チームメンバーが独立したコンテキストで動き、自分専用の知識だけを読み、学んだ内容をファイルへ書き戻す点です。人間は優先順位と最終承認を担い、Squad は調整と反復作業を補助する、という責任分界が明文化されています。エージェントは `.squad/` 以下の Markdown と履歴として残るため、セッションをまたいでも「誰が何を決めたか」を diff で追えます。

TypeScript のモノレポで、ランタイムは `@bradygaster/squad-sdk`、CLI は `@bradygaster/squad-cli` に分かれています。パッケージ境界は SDK と CLI で分かれており、導入の入口は npm の `@bradygaster/squad-cli` です。

squad init から copilot --agent squad --yolo まで

クイックスタートは空の git リポジトリを想定します。`git init` のあと `npm install -g @bradygaster/squad-cli` で CLI を入れ、`squad init` を実行すると `.squad/team.md` が生成されます。即座に既定構成を使うなら `squad init --preset default` が README にあり、メンバー、charter、ルーティング規則まで含むテンプレートが一括で入ります。

Issues や PR、Ralph 連携には `gh auth login` が前提で、README は各段階で `git status` と `gh auth status` による検証を推奨しています。Copilot 側は `copilot --agent squad --yolo` が入口です。`--yolo` は Squad が多数のツール呼び出しを行うため、都度の承認プロンプトを抑える目的で README が説明しています。VS Code では Copilot Chat から Squad エージェントを選び、「Set up the team」のように依頼するとメンバー案が返り、`yes` で確定する流れが例示されています。

アップグレードは二段階です。CLI 本体は `npm install -g @bradygaster/squad-cli@latest`、プロジェクト内の Squad 所有ファイルは `squad upgrade` で更新します。後者は `.squad/` のチーム状態には触れず、`squad.agent.md` や GitHub ワークフローだけを最新化します。`--force` でバージョン一致時も再適用できます。

.squad/ ディレクトリが担う役割

`.squad/` は Squad の状態機械そのものです。`team.md` が名簿、`routing.md` が担当割り当て、`decisions.md` がエージェント決定のログ、`ceremonies.md` がスプリント儀式の設定を保持します。`casting/` 配下には policy、registry、history があり、新メンバーの命名規則を制御します。

各エージェントフォルダには `charter.md`（アイデンティティと専門領域）と `history.md`（プロジェクト知識の蓄積）があります。加えて `skills/`、`identity/now.md` と `wisdom.md`、`log/` が README に列挙されています。README はこのディレクトリをコミットしてチームを永続化し、リポジトリを clone した誰もが同じキャストを得られるようにすることを指示しています。

`squad externalize` は `.squad/` を作業ツリー外へ移し、ブランチ切り替えでも状態を失わない選択肢です。`--key` でプロジェクトキーを変えられます。逆方向は `squad internalize` です。状態の所在を決めたうえで Copilot セッションを始めると、後から「どの squad がアクティブか」を `squad status` で説明できます。

Ralph ウォッチモードと squad triage

README では Ralph というウォッチモードが、issue の自動トリアージ用ポーリングループとして説明されています。`squad triage`（エイリアス `watch` / `loop`）がそれに相当し、デフォルト間隔は 10 分で `--interval` で変更できます。実行なしのトリアージか、`--execute` で Copilot エージェントをディスパッチするかを選べます。

エージェント実行のカスタマイズには `--agent-cmd`、`--copilot-flags`、`--auth-user` があります。状態永続化は `--state-backend` で git-notes、orphan-branch、デフォルトのインメモリから選べます。README は四層のエラー回復（サーキットブレーカーリセット、認証再プローブ、git pull、30 分一時停止）を述べ、監視停止は `.squad/ralph-stop` センチネルファイルで行えるとしています。

本番リポジトリで Ralph を有効にする前に、まず `--dry-run` 相当のトリアージのみ、`--log-file` で診断ログを取り、`.squad/ralph-stop` で停止できることを確認するのが README の意図に沿います。Copilot エージェントの自動起動は `--execute` を付けた瞬間に権限と課金の両方が動くため、小さなテストリポジトリで `--interval` を長めに設定して挙動を記録してから本番 issue へ広げるのが安全です。

CLI 17 コマンドと非推奨の squad shell

README の表には 17 コマンドが載っています。`squad init` は idempotent で `--global` や `--mode remote` も、`squad upgrade --self` は CLI 自身を更新し `--insider` でプレリリースチャンネルへ、`squad update-check` は CI 向け更新状態、`squad doctor`（エイリアス `heartbeat`）はセットアップ診断、`squad link` はリモートチーム接続、`squad export` / `squad import` は JSON スナップショット、`squad plugin marketplace` と `squad upstream` は拡張源管理、`squad nap` はコンテキスト圧縮、`squad aspire` は Aspire ダッシュボード、`squad scrub-emails` はメール除去、と機能が分かれています。

引数なしの `squad shell` は非推奨で、README は `copilot --agent squad` を使うよう促しています。チャット内で「squad commands」と言えばカテゴリ別メニューが出る `squad-commands` スキルが `squad init` と `squad upgrade` に同梱される、とも README にあります。

初回導入後は `squad doctor` の出力を保存し、失敗項目があれば `squad upgrade` を再実行する、という順序が README の検証ステップと一致します。`/status` や `/history` などシェル時代のコマンドは非推奨と明記されているため、新規セットアップでは Copilot エージェント経由の操作に寄せるのがよいです。

Squad.Agents.AI と SDK ファーストモード

.NET アプリから Squad チームを Microsoft Agent Framework の `AIAgent` として呼びたい場合、README はプレビュー NuGet `Squad.Agents.AI`（`src/Squad.Agents.AI`）を紹介しています。DI に Squad バックエンドのエージェントを登録する用途で、バージョンは `0.1.0-preview` 向けと記載されています。

ローカル開発はリポジトリ clone、`npm install`（workspaces）、`npm run build`（SDK 先行）、`node ./packages/squad-cli/dist/cli-entry.js init`、または `npm run dev:link` でグローバル `squad` をローカルビルドに差し替える流れです。SDK ファーストモードでは `squad.config.ts` で TypeScript 定義し `squad build` で Markdown を生成できますが、README は既知のバグがあり本番では Markdown ファーストを推奨すると述べています。

SDK はカスタムツール、フックパイプライン、ファイル書き込みガード、PII スクラビング、レビュアーロックアウトなどプログラム制御を提供する、と README が列挙しています。`.NET` 連携を試すなら NuGet のプレビュー版と Node CLI のバージョンを README のリリースタグ（例: v0.13.1）と一緒に記録し、破壊的変更が CHANGELOG に載ったタイミングで `squad upgrade` を再実行するのが現実的です。

MIT ライセンスとアルファ版としての限界

リポジトリは MIT ライセンスで、ソフトウェアは保証なしの現状提供と README が一致します。Squad は「エンジニアやレビュアーの代替ではない」と明言し、Responsible AI スタンスとして人間オペレーターを増幅するツールと位置づけています。

メンテナは README 上 bradygaster と tamirdresher、サポートは GitHub Discussions 経由とされています。アルファ段階では互換性とドキュメントの追随を自分で確認する必要があります。CHANGELOG.md に破壊的変更が載る前提で版を固定してください。

採用判断では、まず個人リポジトリで `squad init --preset default` と `copilot --agent squad --yolo` を通し、`.squad/team.md` が生成されること、`squad doctor` がエラーなく終わること、必要なら `squad triage --interval 30` を `--execute` なしで試すことを README 記載のコマンドに沿って確認するのがよいです。エンタープライズの変更管理ポリシー下では、`.squad/` をコミットするか externalize するかを先に決め、Ralph の自動実行は別途承認フローを設けるべきです。

編集部の結論

Squad は MIT ライセンスのアルファ版で、`.squad/` に残るファイルと `squad upgrade` で更新されるテンプレートが中心です。GitHub Copilot CLI と gh 認証を前提に、小さな git リポジトリで `squad init` と `squad doctor` を通してから本番リポジトリへ広げるのが現実的です。Ralph の自動トリアージや Agent ツール連携は README 上の実験機能として扱い、API 変更は CHANGELOG を追う前提で使うのがよいです。

公式情報源

1. Official documentation
2. Official README
3. Project repository
4. Release notes