🚀 01. Ralph Pattern

트렌드-01-ralph-pattern-diagram.svg

🎣 “while 루프 하나가 외주 개발팀을 대체했다.”

---

🤔 이게 뭔데?

Ralph Wiggum Pattern은 심슨 가족의 그 멍청한 랄프 위검에서 이름을 따왔다.

핵심은 단순하다:

while :; do cat PROMPT.md | claude-code ; done

AI 에이전트를 무한 루프에 넣고, 조건이 충족될 때까지 알아서 반복 실행하게 만드는 기법이다.

Geoffrey Huntley가 2025년 중반에 대중화했고, 지금은 AI 개발의 표준 패턴 중 하나가 됐다.

---

💡 왜 중요해?

기존 방식의 문제

1. 개발자가 AI에게 지시
2. AI가 코드 작성
3. 에러 발생
4. 개발자가 에러 복사해서 다시 지시
5. 1-4 반복… 😩

개발자가 계속 개입해야 했다.

Ralph의 해결책

1. AI가 코드 작성
2. 에러 발생
3. AI가 스스로 에러 확인하고 수정
4. 테스트 통과할 때까지 반복
5. 완료 ✅

개발자는 자러 가도 된다. 🛌

---

🔑 핵심 원리

”결정론적으로 나쁜 것이 비결정론적 세계에서 아름답다”

Ralph는 실수한다. 많이 한다. 하지만 그게 핵심이다.

• 실수 → 수정 → 학습 → 개선
• 이 과정이 자동으로 반복됨
• 결국 Eventual Consistency (최종적 일관성) 달성

마치 기타 튜닝처럼, Ralph가 삐끗할 때마다 프롬프트를 조율한다.

---

🛠️ 설치 및 설정

준비물

• Claude Code, Codex, 또는 tool call 제한 없는 AI CLI
• Bash 환경
• PROMPT.md 파일

Step 1: 프로젝트 구조 만들기

my-project/
├── PROMPT.md           # 핵심 지시문
├── AGENTS.md           # 에이전트 행동 규칙  
├── specs/              # 요구사항 명세
│   └── feature-1.md
└── src/                # 소스 코드

Step 2: PROMPT.md 작성

## 당신의 임무
 
1. specs/ 폴더의 요구사항을 읽어라
2. src/에 구현하라
3. 테스트를 실행하라
4. 실패하면 수정하라
5. 모든 테스트가 통과할 때까지 반복하라
 
## 규칙
- 한 번에 하나의 기능만 구현
- 커밋 메시지는 명확하게
- 에러가 나면 스스로 디버깅

Step 3: 루프 실행

while :; do cat PROMPT.md | claude-code ; done

또는 더 정교하게:

while :; do
  cat PROMPT.md | claude-code
  if [ $? -eq 0 ]; then
    echo "✅ 완료!"
    break
  fi
  sleep 5
done

---

🎬 실제 사용 예시

예시 1: 새 프로그래밍 언어 만들기

Geoffrey Huntley는 Ralph로 완전히 새로운 프로그래밍 언어를 만들었다.

더 놀라운 건? 그 언어는 LLM 훈련 데이터에 없었다. Ralph가 언어를 만들고, 그 언어로 프로그래밍까지 했다.

예시 2: Y Combinator 해커톤

YC 해커톤에서 팀들이 Ralph 패턴을 테스트했다.

“우리는 코딩 에이전트를 while 루프에 넣었고, 그것이 프로덕트를 배포했다.”

예시 3: 외주 대체

한 엔지니어가 Ralph를 배우고 다음 계약에 적용했다.

결과? 미친 ROI. 이제 그가 생각하는 건 오직 Ralph뿐.

---

⚠️ 주의사항

1. 명확한 완료 조건이 필수

Ralph는 “테스트 통과” 같은 검증 가능한 목표가 있을 때 빛난다.

❌ “좋은 코드 작성해줘” → 무한 루프 ✅ “모든 테스트가 통과할 때까지” → 명확한 종료 조건

2. 비용 관리

무한 루프 = 무한 API 호출 = 💸

• 최대 반복 횟수 설정
• 타임아웃 추가
• 비용 모니터링 필수

3. 적합한 작업 선택

Ralph에 적합:

• 테스트 기반 개발 (TDD)
• 빌드/배포 자동화
• 코드 마이그레이션
• 버그 수정

Ralph에 부적합:

• 창의적 디자인 결정
• 비즈니스 로직 설계
• 사용자 경험 판단

---

🔄 Two Modes: Planning vs Building

Ralph는 두 가지 모드로 작동한다:

모드	언제 사용	목적
PLANNING	계획이 없거나 오래됨	IMPLEMENTATION_PLAN.md 생성
BUILDING	계획이 있음	계획대로 구현 + 커밋

PLANNING 모드:

• specs/와 src/ 비교 (Gap 분석)
• 우선순위가 매겨진 TODO 리스트 생성
• 구현 없음, 커밋 없음

BUILDING 모드:

• 계획에서 태스크 선택
• 구현 → 테스트 → 커밋
• 계획 업데이트

---

✨ 한줄 정리

“AI를 while 루프에 넣어라. 테스트가 통과할 때까지 알아서 돌게 놔둬라. 넌 자러 가도 된다.”

---

🔗 참고 자료

• Geoffrey Huntley 원문
• GitHub: how-to-ralph-wiggum
• GitHub: ralph (자동화 도구)
• VentureBeat: Ralph Wiggum이 AI계를 뒤흔든 이유

---

📚 시리즈 목차

• Day 1: Ralph Wiggum Pattern ← 현재 글
• Day 2: Agent Skills
• Day 3: Orchestration Tools
• Day 4: Sub-agents
• Day 5: Beads & Gas Town
• Day 6: OpenClaw