AutoDev Parallel — Ralph Loop 병렬 오케스트레이터

여러 에이전트가 worktree 격리 환경에서 PRD 항목을 병렬 처리한다. 독립적인 항목들을 동시에 진행하여 완료 속도를 극대화.

핵심 개념

main (또는 현재 브랜치)
 │
 ├── worktree A ── Agent 1: PRD 항목 1
 ├── worktree B ── Agent 2: PRD 항목 2
 ├── worktree C ── Agent 3: PRD 항목 3
 │
 └── Orchestrator (이 스킬)
      - 독립 항목 분류 & 배정
      - 결과 수집 & 검증
      - cherry-pick으로 통합
      - 다음 라운드 반복

Phase 0: 설정 수집

goal: "무엇을 달성할 것인가"
prd: "PRD 또는 체크리스트 파일 경로"     # 예: "PRD.md"
scope: ["수정 가능한 파일 패턴"]
verify: "검증 명령어"
parallel: 3                            # 동시 에이전트 수 (기본 3)
rounds: 5                             # 라운드 수 (기본 5)
max_iterations: 100                    # Stop Hook 최대 반복 (기본 100)
completion_promise: "DONE"

Phase 0.5: 루프 초기화 (state.json)

autodev 스킬의 Phase 1과 동일한 절차로 루프 상태를 초기화한다: autodev 브랜치 생성 → .ralph-loop/ 생성 → .ralph-loop/state.json 작성 (max_iterations, completion_promise 등 Phase 0 설정값 반영) → .gitignore에 .ralph-loop/ 추가 → 베이스라인 검증. 이후 단계의 max_iterations·completion_promise 참조는 이 state.json 값을 사용한다.

Phase 1: 항목 분류

PRD를 읽고 항목들의 의존성을 분석:

## 독립 항목 (병렬 가능)
- [ ] 항목 A: API 엔드포인트 — src/api/
- [ ] 항목 B: UI 컴포넌트 — src/components/
- [ ] 항목 C: 테스트 작성 — tests/

## 의존 항목 (순차 필요)
- [ ] 항목 D: A 완료 후 → 통합 테스트

Phase 2: 라운드 루프

for round in 1..rounds:

  1. SELECT
     - 미완료 항목 중 독립적인 것 최대 {parallel}개 선택
     - 의존성이 있는 항목은 선행 항목 완료 후에만 선택

  2. LAUNCH (병렬)
     - {parallel}개의 Agent를 동시에 호출
     - 각 Agent는 isolation: "worktree"로 격리
     - 각 Agent에게 전달하는 프롬프트:

     """
     PRD 항목을 구현하라.

     항목: {specific_item}
     Scope: {scope}
     Verify: {verify}

     절차:
     1. scope 내 파일을 읽고 항목을 구현
     2. {verify} 실행으로 검증
     3. 실패 시 build-fix 1회 시도
     4. 성공 시 git commit -m "[autodev] {item_summary}"
     5. 결과를 최종 메시지로 반환:
        AUTODEV_RESULT: status={success|fail}, commit={hash}, item="{desc}"
     """

  3. COLLECT
     - 각 Agent 완료 대기
     - 결과 파싱 (status, commit hash)

  4. INTEGRATE
     - 성공한 Agent의 변경사항을 cherry-pick
     - cherry-pick 충돌 시:
       - 충돌 해결 시도 (1회)
       - 실패 시 해당 항목 다음 라운드로 연기
     - PRD에서 완료된 항목을 [x]로 체크

  5. VERIFY ALL
     - 통합 후 전체 검증: {verify}
     - 실패 시 마지막 cherry-pick 되돌리고 항목 연기

  6. REPORT (라운드별)
     라운드 {round}/{rounds} 완료:
     - Agent 1: {status} — {item}
     - Agent 2: {status} — {item}
     - 남은 미완료 항목: {remaining}

  7. CHECK COMPLETION
     - 모든 항목 완료? → <promise>DONE</promise>
     - 아니면 → 다음 라운드

Phase 3: 완료 보고

# AutoDev Parallel 완료 보고서

## 요약
- 총 라운드: {rounds}
- 총 항목: {total} (완료: {done}, 실패: {failed})
- 병렬 에이전트: {parallel}

## 라운드별 결과
| 라운드 | 완료 항목 | 실패 | 누적 완료율 |
|--------|----------|------|-----------|
| 1 | A, B | - | 2/10 (20%) |
| 2 | C, D, E | F | 5/10 (50%) |

## 미완료 항목 (있으면)
- [ ] 항목 F: 이유

## 브랜치
autodev/{tag} — main 머지 준비 완료

병렬 수 가이드라인

상황	권장 parallel
독립적 파일/모듈	5 (최대)
같은 파일 내 변경	1-2 (충돌 위험)
성능 벤치마크 포함	2-3 (리소스 공유)
테스트만 판정	3-5

안전장치

1. worktree 격리: Agent tool의 isolation: "worktree" 사용
2. cherry-pick만: force push 절대 금지
3. 기존 테스트 보호: 통합 후 전체 검증 실패 시 롤백
4. 의존성 존중: 의존 항목은 선행 항목 완료 후에만 처리
5. 라운드 간 동기화: 이전 라운드 통합 완료 후 다음 라운드 시작
6. max_iterations: Stop Hook 안전 장치
7. TTH 상호 배타: TTH(/tth)와 동시 사용 금지 (Stop 훅 루프 충돌)

TTH 팀원 활용 (선택)

# 팀원별 전문 영역 배정
pichai: 아키텍처 변경, 모듈 분리
jensen: API 최적화, DB 쿼리 개선
zuckerberg: 프론트엔드 컴포넌트
bezos: 코드 삭제, 불필요한 추상화 제거

프롬프트에 팀 역할 파일 포함하여 전문성 부여:

해당 팀원의 역할 파일을 읽고 그 관점에서 구현하라:
~/.claude/team-roles/{role}.md