frankbria/ralph-claude-code

Autonomous AI development loop for Claude Code with intelligent exit detection

What it solves

Ralph는 Claude Code에 자율 개발 루프를 제공하여 지속적인 수동 개입 없이 프로젝트를 반복적으로 개선하고 완성할 수 있게 합니다. 수동 프롬프트‑응답 사이클이라는 문제를 실행 루프를 자동화함으로써 해결하고, 무한 루프, API 과다 사용 및 비용 폭주를 방지하는 보호 메커니즘을 구현합니다.

How it works

Ralph는 Claude Code를 연속 사이클에 감쌉니다: PROMPT.md 파일에서 프로젝트 목표를 읽고, AI를 실행하며, 작업 리스트를 통해 진행 상황을 추적하고, 프로젝트가 완료되었는지 평가합니다. "이중 조건 종료 게이트"를 사용해 휴리스틱 완성 지표와 AI의 명시적 EXIT_SIGNAL: true가 모두 충족될 때만 중지합니다. 안정성을 보장하기 위해 오류 감지를 위한 회로 차단기, API 호출 레이트 제한, 반복 간 컨텍스트를 유지하는 세션 관리 기능을 포함합니다.

Who it’s for

Claude Code를 사용하고 PRD, GitHub 이슈 또는 기술 사양에 기반한 기능 구현이나 버그 수정을 수동으로 루프의 각 단계를 진행하지 않고 자동화하고자 하는 개발자를 위한 것입니다.

Highlights

  • Autonomous Loop: 프로젝트 요구사항에 따라 Claude Code를 지속적으로 실행합니다.
  • Intelligent Exit Detection: 휴리스틱 + 명시적 신호의 이중 조건 체크로 조기 종료를 방지합니다.
  • Task Integration: PRD, GitHub 이슈 또는 인터랙티브 ralph-enable 마법사에서 요구사항을 직접 가져옵니다.
  • Safety Guards: 레이트 제한, 멈춘 루프를 위한 회로 차단기, 자동 git 백업 브랜치를 포함합니다.
  • Sandbox Support: 격리된 Docker 또는 E2B 클라우드 샌드박스에서 Claude Code를 실행할 수 있습니다.
  • Session Management: --resume 플래그와 설정 가능한 만료 시간 초과를 통해 세션 연속성을 지원합니다.