blog

AI 에이전트 팀 구성: 기능 개발 팀과 버그 대응 팀

Front-end / AI-Tools#AI Agent#Claude Code#서브에이전트#하네스

AI 코딩 도구의 서브에이전트 기능으로 개발 과정을 역할별로 나누기 위해 세운 팀 구성안이다. 한 에이전트에게 요구사항부터 QA까지 모두 맡기면 맥락이 길어지고 스스로 만든 결과를 스스로 검토하게 되므로, 역할마다 별도 에이전트를 두고 산출물로 일을 넘기게 했다.

Task Team: 기능 개발

역할담당
Task Orchestrator사용자 요청 수신, 태스크 분해, 에이전트 간 맥락 전달과 handoff 관리
Project Manager기획·설계, 요구사항 정의
DesignerUX/UI 리서치와 디자인 명세
Frontend DeveloperUI 컴포넌트와 프론트엔드 비즈니스 로직 구현
Backend DeveloperDB 구조 설계, 서버·API 구현
DevOps EngineerCI/CD 파이프라인 설계와 운영
Code Reviewer로직 정확성, 가독성, 코드 품질 검토
Security Reviewer취약점 탐지, 보안 정책 준수 검토
QA Engineer테스트 계획 수립과 테스트 작성

Bug Team: 버그 대응

역할담당
Bug Orchestrator자연어 버그 설명 수신, 필요한 에이전트 호출과 처리 흐름 관리
Bug Reporter중복 확인, 심각도 분류, 구조화된 버그 리포트 작성
Bug Localizer리포트를 바탕으로 결함 위치 탐지, 근본 원인 분석
Postmortem Agent처리된 버그의 패턴 분석, 재발 방지 문서 작성, Task Team에 피드백

설계할 때 고려한 점

  • 오케스트레이터만 사용자와 대화한다. 나머지 에이전트는 정해진 입력(이전 단계 산출물)을 받아 정해진 산출물을 남긴다.
  • 구현과 검토를 분리한다. 코드를 쓴 에이전트와 리뷰하는 에이전트를 나눠야 리뷰가 의미를 가진다. 리뷰어는 읽기 전용 권한만 준다.
  • 버그 팀의 결과가 기능 팀으로 돌아간다. 포스트모텀에서 나온 재발 방지 규칙을 기능 팀의 요구사항·리뷰 기준에 반영해 같은 유형의 버그를 줄인다.
  • 병렬 구현은 작업 공간을 분리한다. 프론트엔드와 백엔드 구현자를 동시에 돌릴 때는 git worktree처럼 서로의 변경이 섞이지 않는 환경에서 작업하게 한다.