---
title: "Ralph Orchestrator: AI 에이전트를 루프에 가둬서 작업 끝날 때까지 돌리는 프레임워크"
published: 2025-12-17T21:52:51.000Z
canonical: https://jeff.news/article/965
---
# Ralph Orchestrator: AI 에이전트를 루프에 가둬서 작업 끝날 때까지 돌리는 프레임워크

AI 에이전트를 LOOP_COMPLETE까지 반복 실행하는 오케스트레이션 프레임워크. Claude Code, Gemini CLI 등 다중 백엔드 지원, Hat 기반 페르소나 시스템, Telegram 연동 인간 개입, MCP 서버 모드를 제공한다.

- **Ralph Orchestrator**는 AI 에이전트를 `LOOP_COMPLETE`를 출력하거나 반복 제한에 도달할 때까지 계속 루프를 돌리는 오케스트레이션 프레임워크임. 이름의 유래는 심슨즈의 Ralph Wiggum인데, "Me fail English? That's unpossible!"이 모토임

- 지원하는 백엔드가 상당히 다양함: **Claude Code, Kiro, Gemini CLI, Codex, Amp, Copilot CLI, OpenCode** 등 주요 AI 코딩 도구 대부분을 지원

- **Hat 시스템**이라는 특이한 개념이 있음. 전문화된 페르소나(Hat)들이 이벤트를 통해 서로 협력하는 구조. 빌트인으로 `code-assist`, `debug`, `research`, `review`, `pdd-to-code-assist` 5가지가 제공됨

- **Backpressure** 기능이 실용적임: 테스트, 린트, 타입체크 같은 게이트를 설정해두면 미완성 작업을 거부(reject)함. 에이전트가 대충 하고 넘어가는 걸 방지하는 장치

- **Telegram 연동**으로 인간이 루프 중간에 개입할 수 있음. 에이전트가 질문을 던지면 사람이 답할 때까지 루프가 블로킹되고, 사람이 먼저 가이드를 보낼 수도 있음. `/status`, `/tasks`, `/restart` 같은 Telegram 명령어도 지원

- MCP 서버 모드도 있어서 MCP 호환 클라이언트에서 `ralph mcp serve`로 바로 붙일 수 있음. 다만 서버 인스턴스당 하나의 워크스페이스 루트에 바인딩되는 구조라, 멀티 레포는 레포당 인스턴스를 따로 띄워야 함

- 설치는 npm, brew, cargo 세 가지 방식 모두 지원. 웹 대시보드도 있는데 아직 알파 단계라 깨지는 거 감수해야 함

## 핵심 포인트

- Claude Code, Kiro, Gemini CLI 등 7개 백엔드 지원
- Hat 시스템으로 전문화된 페르소나 간 이벤트 기반 협력
- Backpressure로 테스트/린트/타입체크 미통과 시 거부
- Telegram 연동으로 루프 중 인간 개입 가능

## 인사이트

AI 에이전트를 루프에 넣고 품질 게이트로 제어하는 패턴이 점점 표준화되고 있음. Backpressure 개념이 특히 실용적.