테마
Sub-agents
목표
Sub-agent를 독립적인 작업에만 위임하고, 반환된 결과를 파일 근거와 함께 검증하는 방법을 익힙니다.
Sub-agent란?
Sub-agent는 메인 에이전트가 맡긴 집중 작업을 별도 컨텍스트에서 수행하고 결과를 돌려주는 에이전트입니다. 메인 에이전트는 결과를 통합하고 최종 판단을 맡습니다.
Custom agent와의 차이
- Custom agent는 역할·도구·지침을 정의한 재사용 가능한 에이전트 구성입니다.
- Sub-agent는 현재 작업 중 하나를 위임하는 실행 방식입니다. 내장 sub-agent를 쓸 수도 있고, 특정 custom agent를 sub-agent로 호출할 수도 있습니다.
즉 custom agent는 “누가 어떤 방식으로 일할지”를 정의하고, sub-agent는 “어떤 독립 작업을 지금 맡길지”를 정합니다.
지원 환경과 실행 방식
| 환경 | 지원 |
|---|---|
| IDE | 지원 |
| CLI | 지원. Ctrl+G로 실행 상태 확인 |
| Web | 지원 |
| Mobile | 내장 sub-agent만 지원 |
독립 작업은 병렬로 실행됩니다. 작업 그래프는 실행 전에 계획되며 실행 중에는 바꿀 수 없습니다. Workflows가 꺼져 있으면 메인 에이전트는 모든 sub-agent가 끝날 때까지 기다린 뒤 결과를 통합합니다.
이 페이지는 Kiro에 내장된 sub-agent 기능을 설명합니다. Kiro Crew의 Subagents는 Crew 게이트웨이가 별도 세션을 조율하는 확장 기능입니다.
병렬화 기준
서로 읽기·분석·산출물이 독립적인 작업만 병렬로 위임합니다. 예를 들어 보안 검토, API 문서 초안, 테스트 계획은 서로 다른 결과를 만들 수 있으므로 병렬 후보가 됩니다.
다음 작업은 병렬 sub-agent에 동시에 맡기지 않습니다.
- 한 작업의 결과가 다음 작업의 입력인 경우
- 같은 파일이나 공유 상태를 수정하는 경우
- 이전 검토 결과에 따라 구현 범위가 달라지는 경우
이 경우 의존성을 먼저 정리하고 순차 실행하거나, Kiro가 작업 그래프를 실행 전에 계획해 올바른 순서로 처리하도록 합니다.
결과 검증
Sub-agent의 요약만으로 변경을 채택하지 않습니다. 각 결과에서 다음을 확인합니다.
- 주장마다 확인 가능한 파일 경로와 anchor(함수명·클래스명·고유 문자열)를 받습니다.
- 메인 에이전트가 해당 파일과 anchor를 직접 확인합니다.
- 제안이 현재 요구사항·Spec 범위와 충돌하지 않는지 확인합니다.
- 필요한 경우에만 수정·테스트를 실행합니다.
⚠️ 주의
Sub-agent는 독립 컨텍스트에서 실행되므로 메인 대화의 모든 전제나 다른 sub-agent의 진행 상황을 자동으로 알지 못합니다. 작업 목표, 읽을 파일, 산출물 형식, 멈출 조건을 명확히 전달하세요.
기대 결과
- 독립 작업은 병렬로 완료 시간을 줄임
- 의존 작업은 순서를 보존해 충돌을 피함
- 모든 채택 결과가 실제 파일 anchor로 검증됨
실습해보기
Scene G · Sub-agent 병렬 위임과 검증에서 세 개의 독립 분석 작업을 위임하고 결과를 검증합니다.