🔄에이전트

ralph-loop - 장시간 실행형 AI 에이전트로 개발 업무 자동화

Docker 샌드박스에서 Claude 등 AI CLI를 안전하게 실행하며, PRD 생성부터 태스크 완료까지 자동으로 처리하는 AI 루프 시스템

#AI-에이전트#자동화#Docker#Claude#개발도구

개요

ralph-loop는 개발 업무를 자동으로 처리하는 장시간 실행형 AI 에이전트 시스템입니다. Docker 샌드박스 환경에서 Claude Code, Codex, Gemini 등의 AI CLI를 안전하게 실행하며, 작업 목록을 순회하며 완료될 때까지 반복 수행합니다.

주요 특징

자동화된 작업 흐름

▸

PRD 자동 생성: 구조화되지 않은 요구사항에서 제품 요구사항 문서(PRD)와 작업 목록 자동 생성

▸

작업 우선순위 관리: 우선순위가 높은 미완료 작업부터 자동 처리

▸

테스트 자동화: 테스트, 린트, 타입체크 자동 실행

▸

진행 상황 추적: 실시간 출력 스트림과 스크린샷으로 진행 상황 확인

안전한 실행 환경

▸Docker 샌드박스에서 격리된 환경으로 실행

▸Bypass Permissions 모드로 안전하게 작업 수행

사용 방법

1단계: 설치

bash

npx @pageai/ralph-loop

2단계: PRD 및 태스크 생성

prd-creator 스킬로 요구사항에서 PRD를 생성하고 각 태스크를 검토합니다.

3단계: Docker 샌드박스 설정

bash

docker sandbox run claude .

중요: Bypass Permissions 모드를 반드시 Yes로 설정하세요.

4단계: Ralph 실행

bash

./ralph.sh -n 50  # 50회 반복 실행

동작 방식

각 반복 단계마다 다음 작업을 수행합니다:

1..agent/tasks.json에서 우선순위가 가장 높은 미완료 작업 찾기

2..agent/tasks/TASK-{ID}.json의 작업 단계를 순서대로 진행

3.테스트, 린트, 타입체크 실행

4.작업 완료, 스크린샷 촬영, 상태 업데이트 및 커밋

다른 Ralph 버전과의 차이점

▸

확장성: 수백 개의 작업도 처리 가능한 작업 조회 테이블

▸

가시성: 실시간 출력과 활동 단계 감지(Thinking, Testing 등)

▸

타이밍 메트릭: 각 반복 및 전체 시간에 대한 상세한 통계

▸

Steering 기능: 중요 작업 우선 처리 가능

▸

히스토리 로깅: 각 반복당 깔끔한 출력으로 전체 기록 추적

▸

사람 개입 알림: 입력이 필요할 때 자동 알림

라이선스

MIT 라이선스로 제공됩니다.

링크

▸GitHub: https://github.com/PageAI-Pro/ralph-loop