8. 서브에이전트에게 일을 나눠 맡기는 법

subagents usage
subagents usage

다른 역할로 집중해서 볼 일이 있습니다

일을 하다 보면 자료를 조사하고, 그걸 바탕으로 방향을 정하고, 결과물을 만들어야 합니다. 만든 결과가 요청과 맞는지도 봐야 하고요.

이 모든 일을 같은 대화에서 이어갈 수도 있습니다. 그런데 조사 과정의 자료와 중간 결과가 많아지거나, 서로 다른 대상을 따로 살펴보거나, 만든 결과를 다른 기준으로 점검하고 싶을 때가 있습니다.

이럴 때 저는 일의 일부를 별도 역할에 맡기는 서브에이전트를 씁니다.

스킬보다 오래 걸리는 일을 하는 도구라고 나누면 핵심을 놓칩니다. 중요한 것은 시간보다 무엇을 따로 맡기고, 어떤 방법과 자료를 주고, 무엇을 받아올 것인가입니다.

역할의 방법과 이번 일의 맥락

카페 오픈을 준비하는 역할을 생각해보겠습니다.

브랜드 방향을 먼저 정하고, 운영 조건을 보고, 공간과 메뉴를 검토하는 방법이 있을 수 있습니다. 그 역할에게 제 경험을 바탕으로 어떤 질문을 하고 무엇을 놓치지 말아야 하는지 알려줄 수 있습니다.

그런데 이번 프로젝트의 예산과 일정, 고객, 현재 정해진 것이 빠져 있다면 어떨까요? 일반적인 오픈 계획은 만들 수 있어도 이번에 필요한 계획인지는 다릅니다.

처음 이 역할을 설명할 때도 강조했던 부분입니다.

역할의 방법과 원칙
  + 이번 프로젝트의 목적·조건·자료
  → 이번 일에 맞는 결과

‘카페 오픈 전문가니까 알아서 해줘’만으로 제 사정을 모두 알 수는 없습니다. 반대로 프로젝트 자료만 주고 어떤 관점으로 볼지 정하지 않으면 필요한 질문을 놓칠 수 있습니다.

영상 자료를 정리하는 역할이나 사업 전략을 보는 역할도 같습니다. 자막을 읽어 무엇을 뽑을지, 시장의 불확실성을 어떤 질문으로 바꿀지에 방법이 들어갑니다. 그리고 지금 제가 그 자료로 무슨 결정을 하려는지가 함께 전달돼야 합니다.

제가 원했던 것도 막연히 ‘사업이 괜찮아 보인다’는 답보다 무엇을 확인해야 다음 결정을 할 수 있는지였습니다.

서브에이전트는 무엇을 받고 일하나요?

Claude Code의 기본 서브에이전트는 별도 작업 맥락에서 시작합니다. 역할 지침과 맡긴 요청, 적용되는 안내 등을 받아 자기 도구로 일하고 결과를 돌려줍니다.

주 대화에서 이미 나눈 이야기나 읽은 파일이 전부 자동으로 넘어가는 것은 아닙니다. 그래서 총괄하는 Claude Code가 필요한 배경과 자료 위치, 받을 결과를 정리해 전달해야 합니다. 서브에이전트의 맥락

내가 원하는 업무와 판단 목적을 설명
  ↓
총괄 Claude Code
  ├─ 맡길 범위와 참고 자료를 정리
  ├─ 역할에 필요한 방법·조건을 전달
  └─ 별도 서브에이전트에 위임
        ↓
      자료 읽기·조사·분석 등 도구 사용
        ↓
      결과·근거·남은 질문을 반환
  ↓
총괄이 다른 결과와 비교하고 연결
  ↓
내가 다음 선택을 판단

독자가 역할마다 긴 프롬프트를 하나씩 직접 작성해야 한다는 뜻은 아닙니다. 제가 업무의 목적과 중요한 조건을 이야기하고, AI가 나눌 범위와 전달 내용을 구성하게 할 수 있습니다.

다만 무엇이 전달됐는지는 볼 수 있어야 합니다. 맡긴 대상이 달라지거나 핵심 조건이 빠지면, 역할이 열심히 일해도 다른 결과를 가져올 수 있으니까요.

수업에서는 경쟁사 세 곳을 나눠 조사했습니다

9월 수업에서 경쟁사 세 곳의 마케팅 현황을 조사하는 모습을 보여드렸습니다. 요청을 받은 뒤 리서치 역할 세 개가 각각 대상을 맡았습니다.

그중 하나를 열어보니 조사 대상과 최근 기간, 브랜드 메시지와 캠페인 같은 조사 항목, 사실에는 URL 근거를 붙이고 근거가 없으면 쓰지 않는 원칙이 전달돼 있었습니다.

제가 경쟁사마다 긴 조사 지시문을 새로 쓴 것이 아니었습니다. 비교하려는 업무를 이야기하고, AI가 대상별 역할에 필요한 요청을 정리한 겁니다.

이 시연에서 중요한 것은 세 개가 동시에 열렸다는 모습만이 아닙니다. 각자가 같은 비교 목적을 이해하고, 맡은 대상의 자료를 어디까지 확인해야 하는지 알고 시작하는 것입니다.

지금 같은 일을 맡긴다면 이런 내용을 전달할 수 있습니다. 아래는 수업의 실제 호출 기록이 아니라 설명용으로 정리한 예시입니다.

전달할 것 설명용 내용
목적 다음 캠페인 기획에서 참고할 차이를 찾는다
대상과 범위 지정한 회사 한 곳, 최근에 정한 조사 기간
방법과 원칙 원자료 우선, 주장마다 출처, 사실과 해석 구별
필요한 도구 실제 웹 자료를 찾고 읽을 수 있는 도구
반환할 것 항목별 발견, 근거 URL과 날짜, 확인하지 못한 부분

최신 웹 조사를 맡기려면 그 자료에 접근할 도구가 있어야 합니다. 로컬 문서만 읽는 역할에게 새 시장 정보를 조사했다고 기대할 수는 없습니다. 어떤 도구가 허용돼 있는지도 역할의 조건입니다.

돌아온 결과는 그냥 붙이지 않습니다

한 역할은 최근 캠페인만 봤고, 다른 역할은 몇 년 전 자료까지 섞었다면 표의 칸을 채웠다고 비교가 끝난 게 아닙니다.

먼저 같은 기간과 항목을 봤는지, 근거가 있는지, 빠진 자료는 무엇인지 맞춰야 합니다. 서로 다른 수치를 가져왔다면 어느 자료와 시점에서 나온 것인지도 봐야 하고요.

자료를 못 찾았다는 것과 그 활동이 없었다는 것은 다릅니다. 이 구별 없이 합치면 빈칸을 잘못된 결론으로 바꿀 수 있습니다.

그다음 제가 처음 하려던 판단으로 돌아옵니다. 어떤 회사가 더 많은 일을 했는지 세는 것인지, 우리 상황에서 시험해볼 차이를 찾는 것인지. 조사 결과를 다음 선택에 쓰는 단계가 남아 있습니다.

동시에 할 일과 기다려야 할 일

대상이 다른 조사를 같은 기준으로 하는 일은 서로 결과를 기다릴 필요가 없을 수 있습니다. 이런 독립적인 작업은 병렬로 맡길 수 있습니다.

반대로 조사 결과를 바탕으로 제안서를 쓰려면 자료가 먼저 필요합니다. 총괄이 앞 결과를 받아 다음 역할에게 필요한 부분을 전달해야 합니다.

독립적인 조사 A ─┐
독립적인 조사 B ─┼→ 범위와 근거 대조 → 제안 작성
독립적인 조사 C ─┘

이 그림은 작업 관계를 줄인 개념도입니다. ‘역할을 많이 만들면 언제나 좋다’는 뜻은 아닙니다. 역할마다 별도 사용량이 들고, 결과를 읽고 맞추는 부담도 있습니다. 같은 맥락을 계속 주고받으며 고쳐야 한다면 주 대화에서 이어가는 편이 나을 수 있습니다. 병렬 조사와 순차 위임

별도로 확인하게 하는 역할

제가 수업에서 특히 강조하는 사용법은 실행과 평가를 나누는 것입니다.

어떤 일을 맡겨 결과를 받았습니다. 그다음 같은 작업자가 ‘잘했습니다’라고 설명하는 것만으로 끝내지 않고, 별도 역할에게 요청과 실제 수행, 결과를 나란히 놓고 어긋난 곳을 찾게 합니다.

이때 검토자에게 성공했다는 요약만 주면 충분하지 않습니다. 무엇을 부탁했는지, 실제 결과가 무엇인지, 근거 자료는 무엇인지 볼 수 있어야 합니다.

‘최근 기간의 경쟁사 자료를 조사했다’는 요청이라면 그 기간의 자료가 있는지, 출처를 실제로 읽었는지, 모르는 부분을 확정해서 쓰지는 않았는지 확인하게 할 수 있습니다.

별도 역할을 썼다고 모든 오류를 찾아내는 것은 아닙니다. 확인에 필요한 자료가 없으면 그 한계도 반환해야 합니다. 문제를 발견해 고쳤다면 바뀐 결과도 다시 봐야 하고요. 이 대조 방식은 뒤의 확인 응용에서 더 다루겠습니다.

별도 맥락은 파일을 격리한다는 뜻은 아닙니다

한 가지 더 구별하면 좋습니다. 대화를 따로 한다고 각자 다른 파일 사본을 쓰는 것은 아닙니다. 같은 파일에 접근해 변경하면 서로 영향을 줄 수 있습니다. 파일 작업의 범위와 도구 권한은 따로 봐야 합니다.

또 부모 대화 이력을 이어받는 대화 fork 방식도 있습니다. 일반적인 새 맥락의 서브에이전트와 달리 이전 대화를 넘겨받는 예외입니다. 스킬의 context: fork와 부모 대화 전체를 복제하는 대화 fork는 같은 뜻이 아닙니다. 대화 fork 안내

지금은 모든 고급 방식을 외우기보다, 이 역할이 실제로 어떤 배경과 자료를 받고 시작했는지 확인하면 됩니다.

스킬과는 어떻게 나눠 쓸까요?

저는 원하는 결과와 절차를 다시 쓰는 일에는 스킬을 많이 씁니다. 별도 역할에게 방법과 원칙을 주고 대상을 조사하거나 다른 관점으로 확인하게 할 때는 서브에이전트를 씁니다.

둘이 서로 배타적인 것은 아닙니다. 서브에이전트에 필요한 스킬을 주어 활용할 수도 있습니다. 스킬은 짧은 일, 서브에이전트는 긴 일이라고 나누기보다 업무 방식의 재사용과 역할·맥락의 분리라는 차이를 보면 됩니다.

자기 일에서도 생각해보세요. 각각 살펴본 뒤 비교할 대상이 있나요? 만든 결과를 다른 기준으로 대조할 필요가 있나요? 그 역할에 어떤 자료와 원칙을 줘야 할까요?

다음 글에서는 자기 일에 필요한 서브에이전트를 구성하는 방법을 보겠습니다. 역할 파일에 무엇이 들어가고, AI가 만든 내용을 어떻게 확인하고 고칠지 이어가겠습니다.

Subscribe to 비개발자를 위한 Claude Code | 일을 잘하기 위한 AI Workspace

Don’t miss out on the latest issues. Sign up now to get access to the library of members-only issues.
[email protected]
Subscribe