오픈소스 Broccoli: 클라우드 샌드박스에서 AI 코딩 에이전트 실행 방법

Broccoli가 하는 일

Broccoli는 Linear 티켓을 격리된 클라우드 샌드박스에서 AI 코딩 에이전트를 실행하여 배포된 PR로 전환합니다. 각 작업은 자체 샌드박스를 받아 저장소를 체크아웃하고, 티켓 컨텍스트를 사용하며, 솔루션을 구현하고, 테스트와 검토 루프를 실행한 후 팀 검토를 위해 풀 리퀘스트를 엽니다.

아키텍처와 배포

구현에는 다음이 사용됩니다:

웹훅 배포: GCP
샌드박스: GCP 또는 Blaxel
프로젝트 관리: Linear
코드 호스팅 및 CI/CD: GitHub

이는 타사 제어 평면 없이 자체 GCP 프로젝트와 Postgres 데이터베이스에 배포됩니다. 배포는 Cloud Run + Secret Manager + 웹훅 중복 제거 + 내구성 있는 작업 상태를 사용하는 프로덕션 등급입니다.

주요 기능

Linear 티켓 → 검토 가능한 PR 워크플로우
당신의 인프라, 키, 데이터가 당신의 테넌시 내에 유지됨
Claude와 Codex를 사용한 모든 PR에 대한 AI 코드 리뷰
포크, 조정, 버전 관리 가능한 사용자 정의 프롬프트 템플릿
하나의 부트스트랩 스크립트와 하나의 구성 파일로 약 30분 내 배포

배포 필수 조건

배포하려면 다음이 필요합니다:

청구가 연결되고 gcloud가 로그인된 GCP 프로젝트
특정 권한이 있는 GitHub 앱 (Contents, Pull requests, Issues = 읽기/쓰기; Metadata = 읽기 전용; Pull request 리뷰 이벤트 구독)
API 키가 있는 Linear 봇 사용자 (개인 계정이 아닌 전용)
청구가 활성화된 OpenAI 및 Anthropic API 키
${Service URL}/webhooks/linear를 가리키는 Linear 웹훅 (자동 생성된 broccoli-oss-linear-webhook-secret 사용)