Subagents

개요

서브에이전트(subagent)는 메인 에이전트가 집중된 작업 한 가지를 처리하기 위해 띄울 수 있는 별도의 AI 에이전트입니다. 자신만의 컨텍스트와 지시 사항을 가지고 실행되어 일을 처리한 뒤 결과를 보고합니다. 각 서브에이전트는 새로 시작하기 때문에 메인 대화는 깔끔하게 유지됩니다. 곁가지 작업의 세부 사항이 정작 중요한 작업을 밀어내지 않습니다.

강점

• 세부 사항이 많은 곁가지 작업을 떠넘겨 메인 컨텍스트를 어수선하지 않게 유지합니다.
• 독립적인 작업을 병렬로 실행할 수 있어 훨씬 빠를 수 있습니다.
• 각 서브에이전트는 리뷰어, 검색기, 테스터처럼 자신만의 집중된 프롬프트로 특화할 수 있습니다.
• 실패가 격리됩니다. 잘못 동작하는 서브에이전트 하나가 세션 전체를 망치지 않습니다.

트레이드오프

• 서브에이전트는 당신이 전달한 것만 알기 때문에 컨텍스트가 빠지면 엉뚱한 결과가 나옵니다.
• 에이전트를 많이 띄우면 토큰 비용이 늘어나 값비싸질 수 있습니다.
• 돌아오는 것은 요약뿐이라 곁가지 작업의 미묘한 뉘앙스가 사라질 수 있습니다.
• 여러 개를 동시에 조율하면 그 자체로 복잡성이 늘어납니다.

언제 사용하나

작업이 독립적으로 완결되어 있고 그렇지 않으면 메인 스레드를 부풀릴 만한 경우 서브에이전트를 사용하세요. 큰 코드베이스 검색, diff 리뷰, 여러 독립적인 조사를 동시에 진행하는 경우 등이 그렇습니다.

바이브 코딩 적합성

서브에이전트는 에이전트의 주의력을 확장하는 방법입니다. "이게 어디서 쓰이는지 전부 찾아줘", "이거 버그 있는지 리뷰해줘" 같은 시끄럽고 탐색적인 작업을 서브에이전트에 넘기고, 메인 에이전트는 계획에 집중하도록 두세요. 전체 기록이 아니라 결론만 돌아오므로, 각 서브에이전트가 무엇을 반환해야 하는지 명확히 지정하세요.

Spawn a review subagent:
  task: "Review the diff in src/auth for security issues."
  return: "A short list of concrete problems, or 'no issues found'."