GIIP Dev Agent (멀티 에이전트) 가이드

복잡한 엔지니어링 태스크를 자율적으로 수행하는 GIIP의 멀티 에이전트 프레임워크, Dev Agent 활용 방법을 안내합니다.

📋 개요

Dev Agent는 단일 AI가 아닌, 각기 다른 전문성을 가진 여러 AI 에이전트들이 협력하여 문제를 해결하는 프레임워크입니다. 사용자가 복잡한 요구사항을 제시하면, 오케스트레이터(Orchestrator)가 태스크를 분할하고 적절한 에이전트에게 할당하여 완결성 있는 결과물을 도출합니다.

🤖 에이전트 역할 구성

• Orchestrator: 전체 워크플로우를 설계하고 태스크의 우선순위를 결정합니다.
• Coder (Antigravity/Claude): 실제 소스 코드를 작성하거나 시스템 설정을 변경합니다.
• Reviewer: 작성된 코드의 품질을 검사하고 보안 취약점을 점검합니다.
• Tester: 변경 사항이 기존 시스템에 영향을 주지 않는지 검증 시나리오를 실행합니다.

🛠️ Dev Agent 활성화 및 사용

1. 이슈 등록: GIIP [이슈 관리] 페이지에서 해결하고자 하는 기술적 문제나 요구사항을 등록합니다.
2. 에이전트 호출: 이슈 상세 페이지에서 [Launch Dev Agent] 버튼을 클릭합니다.
3. 워크플로우 모니터링: 에이전트들이 실시간으로 대화하며 태스크를 처리하는 과정을 타임라인에서 확인할 수 있습니다.
4. 결과 승인: 모든 작업이 완료되면 에이전트가 작성한 보고서를 검토하고 최종 승인(Merge/Apply)합니다.

🚀 주요 이점

• 생산성 극대화: 반복적인 코딩 작업이나 복잡한 환경 설정을 AI에게 위임하여 엔지니어의 업무 부하를 줄입니다.
• 결함 감소: 다중 검증 단계(Review/Test)를 거치므로 사람이 놓칠 수 있는 실수를 사전에 방지합니다.

💡 활용 팁

• 요구사항을 구체적으로 적을수록 에이전트들이 더 정확하게 태스크를 분배합니다.
• 특정 에이전트의 출력이 마음에 들지 않을 경우, 대화형 인터페이스를 통해 즉시 수정을 요청할 수 있습니다.

문제 해결

증상	원인	해결
에이전트가 태스크를 잘못 분배하거나 결과가 의도와 다름	요구사항이 모호하게 작성됨	요구사항을 더 구체적으로 작성하여 에이전트가 태스크를 정확히 분배하도록 합니다.
[Launch Dev Agent] 버튼을 눌러도 에이전트가 시작되지 않음	이슈가 등록되지 않음	먼저 [이슈 관리] 페이지에서 기술적 문제나 요구사항을 등록합니다.
특정 에이전트의 출력이 마음에 들지 않음	초기 출력이 의도와 일치하지 않음	대화형 인터페이스를 통해 즉시 수정을 요청합니다.
변경 사항이 시스템에 반영되지 않음	최종 승인이 수행되지 않음	에이전트 보고서를 검토한 후 최종 승인(Merge/Apply)을 수행합니다.

---

버전: 1.0 최종 업데이트: 2026-03-19 소스 파일: giipv3/public/help/dev-agent.ko.md