Insights
AI가 자동으로 큐레이션·번역·정리하는 기술 동향 피드입니다.
GitHub Actions와 Claude Code CLI를 활용하여 인간의 개입 없이 이슈 선택부터 구현, CI 수정, PR 머지까지 수행하는 자율 개발 파이프라인입니다. 쉘 스크립트와 GraphQL 기반의 가벼운 구조로 설계되었습니다.
AI 자동 생성 콘텐츠
본 콘텐츠는 GitHub Claude Ecosystem의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기Three-Body Agent
GitHub Actions와 Claude Code CLI로 구동되는 자율 개발 파이프라인입니다. 다섯 가지 워크플로우(workflows)가 프로젝트 보드에서 이슈를 선택하고, 이를 구현하며, 자체적인 CI 실패를 수정하고, 통과된 PR(Pull Requests)을 머지하며, 보드를 최신 상태로 유지합니다 — 이 모든 과정은 인간의 개입 없이 이루어집니다.
┌─────────────────────────────────────────────────────┐
│ GitHub Actions │
│ (자율적인 두뇌) │
...
각기 다른 궤도를 가진 세 시스템이 지속적인 중력의 인력(gravitational pull)을 주고받으며 안정적인 결과를 만들어냅니다. 쉘 스크립트(Shell scripts)와 GraphQL을 사용하며 — 프레임워크, SDK, 그리고 gh, jq, curl 이외의 의존성(dependencies)은 없습니다.
지능은 모델로부터 나옵니다.
플레이북(The Playbook). 이 리포지토리(repo)의 전체 아키텍처(architecture)는 'Three-Body Agent: the Playbook'에 기록되어 있습니다: 모든 설계 결정, 있는 그대로의 역할 프롬프트(role prompts), 실패 카탈로그, 그리고 비용 대시보드(cost dashboards)가 포함됩니다. 이 리포지토리는 실행 가능한 소스이며, 책은 그 추론(reasoning) 과정입니다.
.github/workflows/와 .github/prompts/를 귀하의 리포지토리에 복사하세요. - 세 가지 시크릿(secrets)을 추가하세요 (Settings → Secrets and variables → Actions):
ANTHROPIC_API_KEY — Claude Code CLI는 워크플로우에 의해 자동으로 설치됩니다.
AGENT_PAT — repo, project, workflow 스코프(scopes)를 가진 PAT (조직 레벨의 Projects V2에는 이것이 필요하며, GITHUB_TOKEN은 이에 접근할 수 없습니다).
TELEGRAM_BOT_TOKEN + TELEGRAM_CHAT_ID — 선택 사항입니다. telegram.yml의 curl 호출을 편집하여 Slack / Discord / 이메일로 교체할 수 있습니다.
Todo, In Progress, Ready For QA, Done 컬럼을 가진 Projects V2 보드를 생성하세요. p0(긴급)부터 p5(백로그)까지의 우선순위 라벨(priority labels)을 추가하세요. 선택 사항: 스프린트 범위를 정하기 위해 `
| 워크플로우 (Workflow) | 일정 (Schedule) | 작업 (Job) |
|---|---|---|
Implementer (autoagent-implementer.yml) | 매 시간 (Hourly) | 현재 마일스톤(milestone)에서 우선순위가 가장 높은 Todo 이슈를 선택하여, 브랜치를 생성하고 구현한 뒤 PR(Pull Request)을 생성합니다. |
Fixer (autoagent-fixer.yml) | 30분마다 + CI 실패 시 | autoagent/* 브랜치에서 발생하는 CI 실패, 리뷰 코멘트(review comments), 머지 충돌(merge conflicts)을 처리합니다. |
Merger (autoagent-merger.yml) | 2시간마다 | 모든 테스트를 통과한(fully-green) autoagent PR들을 순차적으로 머지합니다. 머지 전 Claude를 사용하여 리뷰 코멘트의 비중을 평가합니다. |
Board Sync (autoagent-board-sync.yml) | PR 이벤트 발생 시 | 이슈를 Todo ↔ In Progress ↔ Ready for QA ↔ Done 사이에서 이동시킵니다. |
Week Rollover (auto-week-rollover.yml) | 매주 월요일 06:00 UTC | 열려 있는 이슈들을 다음 주 마일스톤으로 넘깁니다. |
telegram.yml
은 다른 워크플로우들이 각각 호출하는 재사용 가능한 알림 워크플로우(notification workflow)입니다. 플러그인 방식으로 작동하며, curl 본문(body)을 교체하여 어떤 메시징 서비스로든 변경할 수 있습니다.
자율적인 성공을 예측하는 가장 중요한 요소는 이슈의 품질입니다:
명확한 수락 기준 (acceptance criteria)—