Claude Code 서브 에이전트 활용 가이드: Planner, Generator, Healer로 E2E 테스트 자동화하기

• •역할 분담을 통한 시스템적 개발 설계 가능
• •수백 개 이상의 에이전트 병렬 가동으로 작업 속도 향상
• •독립된 컨텍스트 활용으로 대규모 작업 처리 최적화

서브 에이전트는 메인 에이전트로부터 특정 작업을 위임받아 독립적으로 수행하는 하위 AI 유닛이다.

• •Planner: 앱 탐색 및 마크다운 기반 테스트 계획 수립
• •Generator: 수립된 계획에 따른 Playwright 테스트 코드 생성
• •Healer: 실패한 테스트 케이스의 자동 디버깅 및 복구

Playwright는 웹 브라우저 자동화를 위한 오픈소스 프레임워크로 E2E 테스트에 널리 쓰인다.

• •명령어: claude --dangerously-skip-permissions 사용
• •병렬 작업 시 사용자 승인 병목 현상 제거
• •테스트 코드 생성 등 안전한 작업 환경에서 활용 권장

YOLO 모드는 에이전트의 파일 수정이나 명령 실행 시 사용자 승인 없이 진행하는 모드이다.

• •웹 서비스 자동 탐색 및 인터페이스 분석 수행
• •50개 이상의 테스트 시나리오를 마크다운으로 자동 문서화
• •수동 작성 대비 획기적인 시간 단축 및 정확도 향상

테스트 시나리오는 사용자가 앱에서 수행할 수 있는 동작과 기대 결과를 정의한 문서이다.

• •시나리오 간 의존성 분석을 통한 그룹화 진행
• •12개의 Generator 에이전트 동시 가동으로 생성 속도 극대화
• •컨텍스트 분리를 통해 대규모 코드 생성 시 충돌 방지

병렬 처리는 여러 작업을 동시에 수행하여 전체 소요 시간을 줄이는 기법이다.

• •실패한 테스트 케이스의 에러 로그 자동 분석
• •Healer 에이전트의 자율적인 코드 수정 및 재검증
• •모든 테스트 통과 시까지 반복 수행으로 안정성 확보

디버깅은 프로그램의 오류를 찾아내고 수정하는 과정이다.