REFERENCE · BACKLOG DELIVERY

Herdr 백로그 멀티 코딩 에이전트 작업 가이드

마지막 업데이트 2026-08-27

백로그 수용 기준을 구현·리뷰·검증으로 나누고, Herdr의 pane에서 Claude Code와 Codex를 감독하는 운영 패턴입니다.

1. 감독자작업 분해·조율
2. developerCodex 구현
3. reviewerClaude Code 리뷰
4. verifier테스트·로그 검증

언제 사용하는가

권장 pane 구성

[Pane 1] Supervisor: 작업 분해·상태 확인·최종 요약
[Pane 2] Codex developer: 조사 → 테스트 → 구현 → 관련 테스트
[Pane 3] Claude reviewer: 수용 기준·diff·회귀 위험 검토
[Pane 4] Verifier: 테스트, dev server, 로그, 브라우저 검증

developer와 reviewer가 같은 파일을 동시에 수정하지 않도록 reviewer는 읽기 전용으로 운영합니다. 리뷰는 developer가 구현을 끝낸 뒤 시작합니다.

감독자에게 보내는 작업 지시문

Herdr에서 이 백로그 작업을 진행해.

1. 수용 기준과 관련 코드를 먼저 조사하고 작업을 작은 단계로 나눠.
2. sibling pane을 만들고 Codex를 developer로 시작해.
   - 필요한 테스트 작성
   - 기능 구현
   - 관련 테스트 실행
3. Codex가 끝나면 별도 pane의 Claude Code를 reviewer로 실행해.
   - 수용 기준 충족 여부
   - 버그·회귀 가능성
   - 테스트 누락 여부를 검토
   - 코드는 수정하지 말고 문제만 보고
4. 리뷰 문제가 있으면 Codex에게 수정시키고 테스트를 다시 실행해.
5. 마지막에 변경 내용, 리뷰 결과, 테스트 결과를 요약해.
모호하거나 승인 필요한 사항은 임의로 결정하지 말고 질문해.

Herdr 운영 명령

# pane 생성 후 반환된 pane ID를 사용
herdr pane split --current --direction right --cwd "$PWD" --no-focus
herdr agent start developer --kind codex --pane <pane-id>
herdr agent start reviewer --kind claude --pane <pane-id>

# 상태·출력 확인
herdr agent list
herdr agent get developer
herdr agent read developer --source recent-unwrapped --lines 120
herdr agent wait developer --until blocked --timeout 120000

명령 응답의 JSON에서 실제 workspace, tab, pane ID를 읽어 다음 명령에 사용합니다. ID를 예시처럼 추측하지 않습니다.

백로그 완료 체크리스트

  1. 수용 기준이 테스트 또는 명시적인 검증 절차로 연결되었는가?
  2. 변경 범위가 백로그 목적에 필요한 최소 범위인가?
  3. reviewer가 현재 diff를 실제로 확인했는가?
  4. 관련 테스트와 필요한 브라우저·로그 검증이 통과했는가?
  5. 미해결 질문, 승인 대기, 남은 위험이 기록되었는가?

운영 원칙

관련 문서