테마
Scene G · Sub-agent 병렬 위임과 검증
💡 이 실습의 위임 기준과 검증 방법은 기능 카탈로그 · Sub-agents를 먼저 확인하세요.
목표
서로 독립적인 세 분석 작업을 sub-agent에 병렬로 위임하고, 반환된 주장을 실제 파일 anchor로 검증합니다. AI-Driven Development with Kiro — Sub-Agents: Parallel task delegation의 병렬 위임 원칙을 작은 API 프로젝트에 적용합니다.
사전 준비
src/api/처럼 API 라우트나 핸들러가 있는 작은 프로젝트- 검토 대상 파일의 위치를 알고 있는 상태
- 변경 전 작업 트리 상태 확인
해볼 것
1단계: 독립 작업을 고르기
다음 세 작업은 서로 다른 산출물을 만들므로 병렬 후보입니다.
| 작업 | 산출물 | 반드시 포함할 파일 anchor |
|---|---|---|
| 보안 리뷰 | 입력 검증·권한·비밀값 노출 위험 목록 | 파일 경로, 함수·클래스명 또는 고유 코드 문자열 |
| API 문서 | 엔드포인트, 요청·응답, 오류 조건 초안 | 라우트 정의 또는 핸들러 anchor |
| 테스트 계획 | 정상·실패·경계 사례와 우선순위 | 대상 함수·컴포넌트 anchor |
2단계: 병렬 위임 요청
채팅에서 다음처럼 한 번에 요청합니다. 실제 프로젝트의 경로로 바꾸세요.
병렬 sub-agent 위임 프롬프트
text
다음 세 작업을 각각 별도 sub-agent로 병렬 실행하고 결과를 분리해서 돌려주세요.
1. `src/api/`를 보안 리뷰하세요. 각 발견에는 파일 경로와 함수명 또는 고유 코드 anchor를 포함하고, 확인하지 못한 내용은 추정하지 마세요.
2. `src/api/`를 바탕으로 API 문서 초안을 작성하세요. 각 엔드포인트는 실제 라우트 또는 핸들러 anchor를 포함하세요.
3. `src/`를 바탕으로 테스트 계획을 작성하세요. 정상·실패·경계 사례와 각 대상의 파일 anchor를 포함하세요.
파일을 수정하지 말고, 서로의 결과를 전제로 삼지 마세요. 결과는 메인 에이전트가 검증할 수 있게 작업별로 나누세요.3단계: 결과를 파일에서 검증
각 결과를 채택하기 전에 다음을 확인합니다.
- 보고된 파일 경로를 엽니다.
- 함수명·클래스명·고유 문자열 anchor가 실제로 존재하는지 찾습니다.
- 보안 발견이 코드 흐름과 일치하는지, API 문서가 실제 라우트와 일치하는지, 테스트 항목이 대상 동작을 검증하는지 확인합니다.
- 근거를 찾지 못한 항목은 삭제하거나 재조사를 요청합니다.
4단계: 의존 작업은 순서대로 처리
예를 들어 “보안 리뷰 결과를 반영해 인증 미들웨어를 수정하고, 수정된 API 문서를 갱신한 뒤 회귀 테스트를 작성한다”는 작업은 병렬 위임하면 안 됩니다. 구현 결과가 다음 단계의 입력이므로, 수정 → 문서 갱신 → 테스트 순서로 진행합니다.
⚠️ 흔한 실수
- sub-agent의 요약만 보고 발견을 확정하지 않기
- 같은 파일을 여러 sub-agent에게 동시에 수정시키지 않기
- 앞 단계의 결과가 필요한 작업을 병렬화하지 않기
기대 결과
- 세 독립 분석 결과가 분리되어 반환됨
- 각 채택 항목에 실제 파일 path와 anchor가 남음
- 의존 작업은 병렬화하지 않고 순서를 유지함
- 독립적인 세 분석 작업 정의필수
- 보안 리뷰의 파일 anchor 확인필수
- API 문서의 라우트·핸들러 anchor 확인필수
- 테스트 계획의 대상 anchor 확인필수
- 의존 작업을 순차 처리필수