2.6 Ralph Loop

요약

AI 코딩 에이전트를 무한 루프에 넣고, 자는 동안 코드를 배포하는 기법입니다.

Ralph Wiggum

핵심 메커니즘

• 매 반복마다 새 컨텍스트(빈 머리)로 시작 -- 컨텍스트 오염 원천 차단
  • 실패한 시도, 관련 없는 코드, 혼합된 관심사가 축적 → 컨텍스트 오염
  • 오염이 쌓이기 전에 의도적으로 새 컨텍스트로 교체
• 상태(State)는 LLM 메모리가 아닌 파일 시스템과 git에 저장
  • 파일과 git 히스토리를 보고 "여기까지 했구나"를 스스로 파악
• 마치 매일 아침 새로 출근하지만, 어제 커밋한 코드를 보고 이어서 일하는 개발자와 같음

"In the loop" vs "On the loop"

• 기존 방식 (In the loop): 개발자가 AI와 채팅하며 일일이 지시 → 개발자가 병목
• Ralph 방식 (On the loop): 개발자가 시스템을 설계하고 AI가 스스로 실행 → 개발자는 감독자
  • AI를 단순한 코딩 조수가 아닌, 엄격한 테스트를 통과해야만 완료되는 주니어 엔지니어처럼 취급

핵심 철학: "deterministically bad in an undeterministic world"

Ralph Playbook 철학

Anthropic 플러그인 철학

• Iteration > Perfection
• Failures Are Data (Deterministically bad)
• Operator Skill Matters (good prompts)
• Persistence Wins

Anthropic 공식 플러그인

# 방법 1: 직접 설치
/plugin install ralph-loop@claude-plugins-official

# 방법 2: /plugin 입력 후 직접 찾아서 설치
/plugin

/ralph-loop:ralph-loop PROMPT [--max-iterations N] [--completion-promise TEXT]

터미널 1: feat/auth 브랜치 → /ralph-loop:ralph-loop PROMPT
터미널 2: feat/payment 브랜치 → /ralph-loop:ralph-loop PROMPT
터미널 3: feat/notification 브랜치 → /ralph-loop:ralph-loop PROMPT

git checkout main
git merge feat/auth
git merge feat/payment
git merge feat/notification

주의 사항

• --dangerously-skip-permissions 플래그 사용 시 AI가 파일 삭제/외부 API 호출 등을 자유롭게 수행할 수 있음
• 반드시 격리된 git 브랜치에서 실행할 것
• 루프 시작 전 명세서(spec)가 충분히 구체적인지 검토 필수: 모호한 명세는 모호한 코드로 이어짐 (/spec-review)
• 테스트 코드가 없으면 Ralph는 반쪽짜리: Backpressure가 없으면 아무 코드나 커밋

Ralph Loop vs. Planning with Files

충돌 주의사항

둘 다 설치된 상태에서 Stop 이벤트가 발생하면 양쪽 훅이 모두 실행됩니다.

Stop 훅 경합

ralph-loop를 돌리는 프로젝트 폴더에 task_plan.md가 함께 있는 경우:

• 루프 종료 시점에 planning-with-files가 "아직 미완료 단계 있음"을 출력할 수 있음
• ralph 루프가 의도한 것보다 더 오래 실행될 수 있음

planning-with-files 비활성화

ralph loop 프로젝트 루트에 설정합니다.

// {프로젝트}/.claude/settings.json
{
  "enabledPlugins": {
    "planning-with-files": false
  }
}

선택 가이드