에이전트 오케스트레이션 (랄프 모드)

1. 핵심 아이디어

랄프는 본질적으로 "같은 프롬프트를 반복해서 넣는 반복문"입니다. 모델이 "다 됐다"고 스스로 판단해서 멈추는 게 아니라, 명확한 완료 조건(테스트 전부 통과, 린트 클린, 커버리지 기준 충족 등)을 검증해서 그 조건이 참이 될 때까지 계속 돌립니다. 실패한 시도는 다음 반복의 컨텍스트로 다시 들어가면서 모델이 스스로의 실수를 마주하고 고쳐나가는 압력이 됩니다.

2. 잘 맞는 작업 / 안 맞는 작업

잘 맞음: 성공 기준이 명확한 작업, 새 프로젝트(그린필드) 구축, 자동 검증(테스트/린트)이 가능한 작업, 밤새/주말처럼 사람이 지켜보지 않아도 되는 장시간 작업.

안 맞음: 사람의 판단이 필요한 작업, 운영 중인 서비스의 프로덕션 디버깅, 성공 기준이 애매한 작업.

3. 프롬프트 작성 요령

• 명확한 성공 기준: "테스트 전부 통과하면 완료"처럼 검증 가능한 조건을 적습니다.
• 단계 쪼개기: 복잡한 작업은 번호가 매겨진 단계로 나눕니다.
• 자기 검증 루프 포함: 테스트 실행 → 실패 확인 → 수정 → 재검증 흐름을 프롬프트 안에 명시합니다.
• 완료 신호: 예를 들어 특정 문구를 출력하면 반복을 멈추도록 조건을 걸어둡니다.

4. 안전장치

무한 반복을 막기 위해 최대 반복 횟수 같은 상한을 항상 걸어두고, 몇 차례 연속으로 실패하면 어떻게 할지(사람에게 알림, 이전 커밋으로 되돌리기 등)도 프롬프트에 적어두는 걸 권장합니다.

5. Claude Code에서 관련 기능

Claude Code에는 성격이 다른 세 가지 반복 도구가 있습니다.

• /loop — 일정 간격으로 폴링/반복(배포 상태 확인 등). 자세한 내용은 루프 엔지니어링 가이드 참고.
• /goal — 조건이 검증될 때까지 여러 턴에 걸쳐 계속 작업
• 커뮤니티 랄프 플러그인류 — 완료 조건을 명시적으로 걸고(예: 완료 신호 문구) 끝까지 밀어붙이는 방식. 오케스트레이션을 더 강화하고 싶다면 오마이클로드(OMC)의 ralph/autopilot 모드도 참고하세요.

어떤 도구를 쓰든 핵심은 같습니다 — 모델의 능력보다 "완료 조건을 얼마나 명확하게 적었는가"가 결과를 좌우합니다.