Codex 핸드오프 — 병렬 레인을 머지 가능한 결과로 연결하기

공식 참고 자료: Best Practices · Subagents · Review · Worktrees

커리큘럼 흐름

Codex 시작하기 — 설치, 첫 작업, 체크포인트까지 — 입문 루프
Codex 지시문 — AGENTS.md를 진짜 쓸모 있게 만드는 법 — 저장소 규칙
Codex 샌드박싱 — 권한, 승인, 클라우드 환경 이해하기 — 권한과 승인
Codex 작업 설계 — 소원 말고 이슈처럼 프롬프트 쓰기 — 좋은 task shape 만들기
Codex Skills — 반복 프롬프트를 재사용 가능한 워크플로우로 바꾸기 — 반복 워크플로우를 재사용 자산으로 만들기
Codex 서브에이전트 — 병렬 실행과 위임 패턴 — 병렬 실행과 위임
Codex MCP — 외부 컨텍스트를 복붙 대신 연결하기 — 외부 시스템 연결
Codex 리뷰와 자동화 — /review, worktree, 반복 엔지니어링 운영하기 — 반복 작업 운영
Codex Worktrees — 브랜치 충돌 없이 병렬 실행하기
Codex 핸드오프 — 병렬 레인을 머지 가능한 결과로 연결하기 ← 현재 문서
Codex 검증 루프 — 머지 전에 동작을 증명하기
Codex 릴리스 준비도 — 프로덕션 전 최종 게이트
Codex 첫날 안전 루프 — 초반 실수를 줄이는 입문 워크플로우
Codex 팀 딜리버리 플레이북 — 중급 레인 운영
Codex 고위험 변경 거버넌스 — 크리티컬 릴리스를 위한 고급 통제
Codex 운영 매뉴얼 — 팀의 일/주/릴리스 리듬 정렬하기
Codex 사고 복구 플레이북 — 프로덕션 압박 상황에서의 결정론적 대응
Codex 사고 후 하드닝 루프 — 복구를 내구성 있는 통제로 전환하기
Codex 카오스 복원력 드릴 — 실패가 오기 전에 리허설하기
Codex 복원력 지표와 SLO — 실패 전에 신뢰성을 측정하기
Codex Ralph 지속 루프 — 긴 작업을 검증 가능한 완료까지 가져가기

이 문서에서 참고한 공식 문서

작업 분해와 명시적 제약 — Best Practices
위임 워커를 통한 병렬 레인 구성 — Subagents
diff 범위 기반 검토 체크포인트 — Review
브랜치/파일 격리 모델 — Worktrees

왜 핸드오프에서 품질이 새는가

Codex로 빠르게 코드를 만드는 팀은 많습니다. 하지만 레인 사이에서 작업을 깔끔하게 넘기는 팀은 훨씬 적습니다.

핸드오프가 깨지는 대표 원인:

목표 상태가 없음
검증 근거가 없음
diff 범위가 불명확함
리스크/롤백 메모가 없음
다음 오너가 명시되지 않음

이 중 하나라도 빠지면 다음 레인이 컨텍스트를 다시 발굴해야 합니다. 그 지점에서 시간과 품질이 동시에 손실됩니다.

최소 핸드오프 계약

레인 간 핸드오프를 작은 API로 취급하세요. 항상 아래 5개 필드를 요구합니다.

Goal 상태 — done / partial / blocked
Evidence — lint/tests/build 출력(또는 생략 사유)
Diff 범위 — 무엇이 어디서 바뀌었는지
Risk 노트 — 롤백 경로와 미해결 edge case
다음 오너 — 누가 다음 액션을 수행하는지

긴 서술보다 짧고 고정된 계약이 훨씬 강합니다.

변경 유형별 근거 강도

변경 유형	최소 근거	권장 근거
UI/콘텐츠 중심 수정	lint + 로컬 렌더 sanity	lint + build + 스크린샷 체크
동작 변경 없는 리팩토링	lint + 대상 테스트	lint + 테스트 + review scope 스냅샷
auth/billing/security 로직	lint + 테스트 + build	lint + 전체 테스트 + 리뷰어 승인 + 롤백 메모
migration/데이터 스키마 변경	lint + migration 체크	lint + migration 테스트 + 롤백 계획 + 검증 레인

영향 범위가 클수록 핸드오프 근거를 더 두껍게 가져가야 합니다.

복붙 가능한 핸드오프 템플릿

### Handoff: <lane-name> -> <lane-name>
 
- Goal 상태: done | partial | blocked
- Evidence:
  - lint: <pass/fail + command>
  - tests: <pass/fail + command>
  - build: <pass/fail + command>
- Diff 범위:
  - 변경 디렉터리: <list>
  - 핵심 파일: <list>
- Risk 노트:
  - 롤백 경로: <short>
  - 미해결 edge case: <list or none>
- 다음 오너: <person/role/lane>
- 다음 액션 기한: <date/time or trigger>