PageAI-Pro/ralph-loop

해결하는 문제

Ralph Loop는 장기간 소프트웨어 개발 작업을 자동화하도록 설계되었습니다. AI 에이전트가 집중력을 잃거나 조기 중단되는 것을 방지하기 위해, 프로젝트가 완료될 때까지 구조화된 작업 목록을 반복적으로 처리합니다. 이로써 AI가 수일간 지속적으로 코드를 작성할 수 있게 됩니다.

작동 방식

Ralph는 고립된 Docker 사전에서 에이전트 AI CLI(예: Claude Code, Cursor, Gemini 등)를 관리하는 루프로 작동합니다. 각 반복 단계에서 시스템은 다음과 같은 워크플로우를 따릅니다:

1. 작업 선택: 조회 테이블에서 우선순위가 가장 높은 미완료 작업을 식별합니다.
2. 실행: 에이전트가 해당 작업의 세부 단계를 처리합니다.
3. 검증: 에이전트는 테스트, 린팅, 타입 체크를 실행하여 작업의 정확성을 검증합니다.
4. 완료: 검증이 완료되면 에이전트는 스크린샷을 캡처하고, 작업 상태를 업데이트하며, 변경 사항을 커밋합니다.

사용자는 STEERING.md 파일을 수정하여 에이전트가 표준 작업 목록을 계속 진행하기 전에 처리해야 할 중요한 우선순위를 주입할 수 있습니다.

대상 사용자

전체 제품 요구사항 문서(PRD)의 구현을 자동화하고, 반복적인 코드 작성, 테스트, 커밋 과정을 에이전트 AI가 자율적으로 처리하고 싶은 소프트웨어 개발자에게 적합합니다.

주요 특징

• PRD에서 작업 자동화: 비구조화된 요구사항을 공식적인 PRD와 상세한 작업 목록으로 변환하는 prd-creator 기능을 포함합니다.
• 사전 환경에서 실행: Docker 사전을 사용해 보안이 강화되고 고립된 환경을 제공하며, 다양한 에이전트에 대해 결정적 이름을 부여합니다.
• 관측성: 실시간 스트리밍 미리보기, 반복 시간, 에이전트가 수행한 모든 단계의 기록 로그를 제공합니다.
• 확장 가능한 기능: React, PostgreSQL, Playwright 등 다양한 프레임워크용으로 재사용 가능한 '기능'(특화된 지식과 워크플로우) 라이브러리를 제공합니다.
• 사람이 개입하는 구조: 인간의 개입이나 결정이 필요한 경우 <promise>BLOCKED</promise>와 같은 세미틱 프로미스 태그를 사용해 신호를 보냅니다.