ralph-orchestrator: 자율 AI 에이전트 반복 및 작업 완료를 위한 모자 기반 오케스트레이션 프레임워크

해결하는 문제

Ralph Orchestrator는 목표에 도달할 때까지 AI 에이전트를 지속적인 반복 루프에 두어 자율적인 작업 완료를 위한 프레임워크를 제공합니다. AI 어시스턴트가 부분적이거나 잘못된 답변을 제공하고 멈추는 흔한 "단일 시도" 실패를 방지하고, 대신 작업이 완전히 완료될 때까지 반복하고 검증합니다.

작동 방식

Ralph는 "Ralph Wiggum 기법"을 구현하며, "모자 시스템"을 사용해 연구, 디버그, 리뷰와 같은 특화된 페르소나가 이벤트를 통해 다단계 작업을 수행하도록 조정합니다. 여기에는 linting, 타입 체크, 테스트와 같은 자동 검증인 "역압 게이트"가 포함되어 있어, 불완전하거나 깨진 작업을 거부하고 에이전트가 다시 돌아가 수정하도록 강제합니다. 이 시스템은 Claude Code, Gemini CLI, Copilot CLI 등 여러 AI 백엔드를 지원하며 MCP 서버로 통합될 수 있습니다.

대상 사용자

복잡한 소프트웨어 엔지니어링 작업을 AI 에이전트를 사용해 자동화하고 싶지만 지속적인 수동 감시가 필요 없는 개발자와, 텔레그램을 통해 인간‑인‑루프 가이던스를 통합하고자 하는 사람들을 위한 것입니다.

주요 특징

• 멀티 백엔드 지원: Claude Code, Gemini CLI, Codex 등 다양한 AI 코딩 어시스턴트와 함께 작동합니다.
• 모자 시스템: code-assist, debug, review와 같은 특화된 역할을 사용해 작업 실행을 구조화합니다.
• 역압 게이트: 테스트나 linting에 실패한 작업을 거부하여 품질을 보장합니다.
• 인간‑인‑루프: 텔레그램 통합을 통해 인간이 에이전트 질문에 실시간으로 답하거나 사전 지침을 제공할 수 있습니다.
• 웹 대시보드: 오케스트레이션 루프를 모니터링하고 관리할 수 있는 알파 단계 대시보드입니다.
• MCP 서버 모드: 호환 클라이언트를 위한 Model Context Protocol 서버로 실행할 수 있습니다.