bradygaster/squad

Squad – 人間が指揮するAI開発チーム（アルファ版）

何であるか – Squadは、1人の開発者がGitリポジトリ内にAIエージェントのチーム（フロントエンド、バックエンド、テスト担当、リードなど）を構築・管理できる生産性ツールです。エージェントはGitHub Copilotで駆動され、CLI（@bradygaster/squad-cli）を通じて調整されます。チームは.squad/フォルダ下のMarkdownファイルとして永続化され、蓄積された「知識」がコードと共に移動します。

主要なコンセプト

• チーム定義 – squad initは、team.md、routing.md、decisions.md、および各エージェント用のチャーターと履歴を含む.squad/ディレクトリをスキャフォールディングします。
• 人間がループ内にいる – 人間が意思決定の主体であり、エージェントは協調、反復的なコード作成、トリアージ、テストの自動化のみを担当します。すべての行動はログに記録され、レビュー可能です。
• ウォッチモード（Ralph） – オプションのデーモンがGitHubのイシュー/PRをポーリングし、自動的にトリアージを行い、必要に応じてCopilotエージェントを起動して問題に対処します。設定可能なステートバックエンド（メモリ内、git-notes、孤立ブランチ）と段階的なエラーリカバリ戦略をサポートします。
• CLIコマンド – 17の第一級コマンド（init、upgrade、triage、copilot、nap、aspireなど）が、セットアップ、アップグレード、ヘルスチェック、外部ステートのエクスポート、 squadsのインポート、プラグイン/マーケットプレイス管理をカバーします。
• SDKファーストモード – デフォルトのMarkdown駆動構成に加え、開発者は@bradygaster/squad-sdkを使用してTypeScript（squad.config.ts）でチームを定義でき、squad buildでMarkdownファイルを生成できます。
• GitHub Agentic Workflows – Squadは再利用可能なGitHub Agentic Workflowとしてインストールでき、イシューコメントからのスラッシュコマンドで制御可能です。

一般的なワークフロー

1. mkdir my-project && git init
2. npm install -g @bradygaster/squad-cli && squad init
3. gh auth loginで認証
4. VS CodeでCopilot Chatを開き、Squadエージェントを選択する（またはcopilot --agent squad --yoloを実行）。
5. プロジェクトの説明（例：「ReactとNodeで構築するレシピ共有アプリ」）
6. Squadがエージェントのロースターを提案；yesで承認
7. エージェントが並列で作業を開始—フロントエンドはUIを構築、バックエンドはAPIを作成、テスト担当はテストを書くなど—人間はPRをレビューし、意思決定を承認します。

インストール方法

• CLI（グローバル）: npm install -g @bradygaster/squad-cli
• ソースから：リポジトリをクローンし、npm install（ワークスペース）、npm run build、その後npm run dev:linkで開発版をグローバルにリンクします。
• .NETプレビュー：Microsoft Agent Framework統合用に、src/Squad.Agents.AI下にNuGetパッケージSquad.Agents.AIが利用可能です。

状態 – アルファ版（READMEにバッジあり）。APIやCLIフラグは変更される予定です；重大な変更はCHANGELOG.mdに記録されています。

誰が使うべきか

• 監視を失わず、AI支援による並列処理を望む単独開発者。
• リポジトリ内に「AI強化」ワークフローをプロトタイピングしたい小規模チーム。
• エージェントオーケストレーション、GitHub Copilot、自動トリアージを実験する研究者や趣味開発者。

さらに学ぶには

• 完全なコマンドリファレンスはREADMEに記載（各コマンドとフラグのテーブル）。
• SDKドキュメント（docs/src/content/docs/reference/sdk.md）。
• サンプルプロジェクト（samples/README.md）。
• GitHub Agentic Workflowsガイド（README内のリンク）。

---

上記のすべての詳細は、リポジトリのREADMEから直接取得；追加機能は推測されていません。