위임 패턴
기준일: 2026-07-26
난이도: 중급
공식 기준: Delegation Patterns
개요
delegate_task와 관련 패턴으로 병렬 작업 위임을 안전하게 쓰는 실전 가이드입니다. Kanban(보드)과 달리 위임은 주로 자식 에이전트 일회성 병렬에 가깝습니다.
핵심 개념
| 패턴 | 언제 |
|---|---|
| Map-reduce | 독립 서브태스크 분할 후 병합 |
| Specialist child | 조사/구현/리뷰 역할 분리 |
| Bounded scope | 파일·디렉터리·시간 제한 |
| Isolation | worktree / 별도 cwd / 도구 제한 |
| Parent synthesis | 부모가 결과 통합·품질 게이트 |
상세
언제 위임하나
- 서로 의존성 없는 탐색
- 긴 조사와 구현을 겹치기
- 컨텍스트 오염 방지 (자식만 큰 로그)
언제 위임하지 않나
- 한 파일 소규모 수정
- 강한 순차 의존
- 승인 필요 파괴적 작업 (부모에서 통제)
패턴 예
- 코드베이스 조사 분할: 모듈별 자식 → 부모 아키텍처 요약
- 테스트 작성 || 구현: 충돌 파일 주의
- 리뷰어 자식: diff만 주고 보안/스타일 피드백
프롬프트 계약
자식에게 줄 것:
- 목표 1문장
- 입력 경로
- 금지 사항 (push, prod, secrets)
- 출력 형식 (요약 + 파일 리스트 + 리스크)
부모 체크리스트
- 자식 결과 검증 없이 merge 금지
- 동일 브랜치 동시 쓰기 방지 (worktree)
- 예산/시간 제한
- 실패 시 partial result 처리
체크리스트
- 공식 원문과 명령·설정 키를 대조했다
- 로컬/
config.yaml/.env에서 재현 경로를 확인했다 - 권한·allowlist·시크릿 노출을 점검했다
- 실패 시 롤백·비활성화 방법을 알고 있다
다음 단계
기준일: 2026-07-26 — 공식 문서 동기화 코퍼스