umputun/ralphex

해결하는 문제

ralphex는 Claude Code 또는 codex와 같은 AI 코딩 에이전트를 사용하여 복잡한 소프트웨어 구현 계획을 자동화하는 CLI 도구입니다. 인터랙티브 에이전트를 수동으로 관찰할 필요 없이, 너무 많은 컨텍스트로 인해 한 번의 긴 AI 세션에서 품질이 저하되는 문제를 방지합니다. 각 작업을 새 세션에서 실행함으로써 AI 모델이 날카롭고 집중된 상태를 유지할 수 있습니다.

작동 방식

ralphex는 마크다운 기반의 계획을 완성된 코드로 전환하기 위한 다단계 파이프라인을 오케스트레이션합니다:

1. 작업 실행: 계획 파일을 읽고, AI 에이전트를 사용해 미완료 작업을 하나씩 실행하며, 각 단계 후에 검증 명령어(예: 테스트 또는 린터)를 실행합니다.
2. 첫 번째 코드 리뷰: 품질, 구현, 테스팅, 단순화, 문서화에 특화된 5개의 전문 에이전트를 병렬로 시작하여 문제를 발견하고 수정합니다.
3. 외부 리뷰: 선택적으로 OpenAI Codex와 같은 외부 도구를 사용해 독립적인 크로스모델 리뷰를 수행합니다.
4. 두 번째 코드 리뷰: 최종 단계에서 두 개의 에이전트가 중요한 문제와 주요 문제에 집중하여 리그레션 여부를 확인합니다.
5. 최종화: 선택적 단계로, 커밋을 리베이스하고 스쿼시하여 Git 히스토리를 정리할 수 있습니다.

대상 사용자

IDE 플러그인이나 클라우드 서비스 없이 AI 에이전트를 사용해 기능 구현과 코드 리뷰를 자동화하고 싶은 개발자, 그리고 AI 보조 코딩에서 구조적이고 계획 중심의 접근 방식을 선호하는 사용자에게 적합합니다.

주요 기능

• 자율적 파이프라인: 계획 생성부터 최종 커밋까지 완전 자동화.
• 다중 에이전트 리뷰: 여러 전문 에이전트와 선택적 크로스모델 검증을 사용하는 고도화된 파이프라인.
• 워크트리 격리: git worktrees를 사용해 여러 계획을 병렬로 실행할 수 있는 능력.
• 유연한 실행 엔진: Claude Code와 codex를 주 실행 엔진으로 지원.
• 실시간 모니터링: 스트리밍 터미널 출력과 진행 상황을 추적할 수 있는 선택적 웹 대시보드 제공.