blog
AI 에이전트 팀 구성: 기능 개발 팀과 버그 대응 팀
Front-end / AI-Tools#AI Agent#Claude Code#서브에이전트#하네스
AI 코딩 도구의 서브에이전트 기능으로 개발 과정을 역할별로 나누기 위해 세운 팀 구성안이다. 한 에이전트에게 요구사항부터 QA까지 모두 맡기면 맥락이 길어지고 스스로 만든 결과를 스스로 검토하게 되므로, 역할마다 별도 에이전트를 두고 산출물로 일을 넘기게 했다.
Task Team: 기능 개발
| 역할 | 담당 |
|---|---|
| Task Orchestrator | 사용자 요청 수신, 태스크 분해, 에이전트 간 맥락 전달과 handoff 관리 |
| Project Manager | 기획·설계, 요구사항 정의 |
| Designer | UX/UI 리서치와 디자인 명세 |
| Frontend Developer | UI 컴포넌트와 프론트엔드 비즈니스 로직 구현 |
| Backend Developer | DB 구조 설계, 서버·API 구현 |
| DevOps Engineer | CI/CD 파이프라인 설계와 운영 |
| Code Reviewer | 로직 정확성, 가독성, 코드 품질 검토 |
| Security Reviewer | 취약점 탐지, 보안 정책 준수 검토 |
| QA Engineer | 테스트 계획 수립과 테스트 작성 |
Bug Team: 버그 대응
| 역할 | 담당 |
|---|---|
| Bug Orchestrator | 자연어 버그 설명 수신, 필요한 에이전트 호출과 처리 흐름 관리 |
| Bug Reporter | 중복 확인, 심각도 분류, 구조화된 버그 리포트 작성 |
| Bug Localizer | 리포트를 바탕으로 결함 위치 탐지, 근본 원인 분석 |
| Postmortem Agent | 처리된 버그의 패턴 분석, 재발 방지 문서 작성, Task Team에 피드백 |
설계할 때 고려한 점
- 오케스트레이터만 사용자와 대화한다. 나머지 에이전트는 정해진 입력(이전 단계 산출물)을 받아 정해진 산출물을 남긴다.
- 구현과 검토를 분리한다. 코드를 쓴 에이전트와 리뷰하는 에이전트를 나눠야 리뷰가 의미를 가진다. 리뷰어는 읽기 전용 권한만 준다.
- 버그 팀의 결과가 기능 팀으로 돌아간다. 포스트모텀에서 나온 재발 방지 규칙을 기능 팀의 요구사항·리뷰 기준에 반영해 같은 유형의 버그를 줄인다.
- 병렬 구현은 작업 공간을 분리한다. 프론트엔드와 백엔드 구현자를 동시에 돌릴 때는 git worktree처럼 서로의 변경이 섞이지 않는 환경에서 작업하게 한다.