「Broccoli」が実現するクラウド上のコードエージェント：GitHubチケットからPRまで自動化
本記事は、AIを活用したエンジニアリングワークフローの自動化ツール「Broccoli」の導入方法と機能について詳細に解説している。Broccoliは、開発管理ツールLinearのチケットをトリガーとして、コードの計画、実装、そしてプルリクエスト（PR）のオープンまでを自動で行う「コードエージェント」である。このシステムは、AnthropicのClaudeとOpenAIのCodexといった大規模言語モデル（LLM）を動力源とし、ユーザー自身のGoogle Cloud Platform (GCP) 環境内で動作することが最大の特徴である。
**【機能と仕組み】**
Broccoliの主要な機能は、Linearの課題（Issue）にボットをアサインするだけで、自動的にPRが生成される点にある。また、すべてのPRに対してClaudeとCodexがコードレビューを行い、具体的な改善コメントを出し、指示があれば修正コミットまでプッシュする機能も備えている。システムは、サーバーレスなCloud RunとSecret Managerを利用し、高い信頼性とセキュリティを確保している。
**【導入プロセス（Who, How）】**
導入は、ユーザーのGCPプロジェクト内で行われる。プロセスは複数のチェックポイントからなる。まず、GCPプロジェクトの準備（課金設定の確認）、次にGitHub Appの作成（必要な権限設定を含む）、そして専用のLinearボットユーザーの指定とAPIキーの取得が必要である。さらに、OpenAIとAnthropicのAPIキーを準備し、これら全ての機密情報（GitHub Appの秘密鍵、APIキーなど）をGCPのSecret Managerに安全に格納する必要がある。これらの準備が整った後、デプロイメントスクリプトを実行し、最終的にシステムが稼働するサービスURLが確定する。
**【セキュリティと利点】**
最大の利点は、データがユーザーのテナンシー（tenancy）から外に出ない点、つまり「Your infra. Your keys. Your data.」という形で、完全に自己管理できる点にある。これにより、サードパーティのコントロールプレーンに依存することなく、高いセキュリティとデータ主権を維持できる。本システムは、開発チームがAIによる支援を受けながら、より迅速かつ高品質な形でソフトウェアをリリースするための包括的なソリューションを提供する。
背景
近年、AI技術の進化に伴い、ソフトウェア開発のプロセス（SDLC）の自動化が求められている。特に、チケット管理からコード実装、レビューに至る一連の作業をAIが担う「エージェントワークフロー」が注目されている。Broccoliは、この課題に対し、既存の開発ツール（Linear, GitHub）とLLMを連携させ、エンドツーエンドの自動化を実現した。
重要用語解説
- Linear: 課題管理システム。開発チームがタスクやバグを追跡するために使用されるツール。本記事では、このLinearのチケットがAIエージェントのトリガーとなる。
- PR (Pull Request): GitHubなどのバージョン管理システムにおける機能。開発者が自分の変更をメインブランチに統合する前に、レビューを依頼するための仕組み。コードレビューの主要な対象となる。
- GCP (Google Cloud Platform): Googleが提供するクラウドコンピューティングプラットフォーム。本システムは、ユーザー自身のインフラストラクチャ（GCP）上にデプロイされ、データ主権を確保している。
- 影響: 本ツールは、開発チームの生産性を劇的に向上させる可能性を秘めている。手動で行っていたチケットからの実装、レビュー、コミットといった一連の作業を自動化することで、開発サイクルを大幅に短縮し、エンジニアがより高度な設計や問題解決に集中できる環境を提供する。ただし、複雑な設定と複数の外部サービス連携が必要なため、導入障壁も高い。