서브에이전트 (Subagent)

별도 맥락이 의미하는 것

자료 조사가 길어지면 메인 대화에 검색 결과와 파일 내용이 쌓입니다. 그 조사를 서브에이전트에 맡기고 결과와 근거를 받으면 메인 대화는 종합과 결정에 집중할 수 있습니다.

다만 실행 맥락이 분리됐다는 것과 이전 정보를 전혀 받지 않았다는 것은 다릅니다. Claude Code 공식 문서는 새 맥락으로 실행하는 서브에이전트뿐 아니라 대화를 이어받는 fork와 실행 중인 작업을 관찰·조정하는 방식도 구분합니다. 실제 정보 경계는 호출 방식과 설정에 달려 있습니다.

Skill과는 역할이 다르다

Claude Code의 Skill 문서는 별도 맥락 실행과 서브에이전트의 Skill 사전 로드를 지원한다고 설명합니다. ‘맥락을 이어야 하면 Skill, 끊어야 하면 서브에이전트’라는 이분법만으로 선택하기는 어렵습니다.

검증을 맡길 때 전달할 것

설명용으로, 제안서 초안의 예산이 원문과 다른 상황을 생각해봅시다. 검토자에게 초안만 주면 그 금액을 전제로 내용이 자연스러운지만 확인할 수 있습니다. 다음 세 가지가 함께 필요합니다.

1. 검토할 결과물.
2. 대조할 원문과 그 위치.
3. 금액·조건·적용 범위 등 구체적인 통과 기준.

작성 과정의 모든 추론을 복사할 필요는 없지만 검증에 필요한 배경은 빠뜨리지 않아야 합니다. 원문과 AI의 해석을 구분하는 출처 추적이 도움이 됩니다.

분리는 정확성을 보장하지 않는다

검토 에이전트도 같은 모델의 한계와 잘못된 자료의 영향을 받을 수 있습니다. 수치 계산은 코드로, 실제 실행 여부는 산출물과 로그로, 해석과 업무 범위는 사람이 확인하는 식으로 검증 수단을 나눕니다.

BOAZ의 위키 운영에서도 링크·인용 위치 검사와 문장 의미 검토는 따로 다룹니다. ‘다른 에이전트가 승인했다’는 사실만으로 원문의 뜻이 확인됐다고 보지 않습니다.

언제 나누고 언제 함께 처리할까

독립적인 조사, 많은 파일을 읽는 일, 별도 관점의 검토에는 분리가 유용할 수 있습니다. 짧은 수정이나 앞선 논의에 강하게 의존하는 일은 전달과 재설명 비용이 더 클 수 있습니다.

한 파일을 여러 에이전트가 함께 바꾼다면 작업 영역과 병합 책임도 정해야 합니다. 동시 실행 수보다 각 작업의 범위·반환 형식·완료 기준을 먼저 정하는 편이 중요합니다. 필요한 실행 기준은 하네스와 검증 Loop에서 다룹니다.