Gemini CLI 서브에이전트 기능 도입으로 달라지는 개발 워크플로우

이 글은 Gemini CLI에 새롭게 공식 도입된 서브에이전트(Sub-agent) 기능을 중심으로, 해당 기능의 개념과 배경, 핵심 이점, 구성 방식, 병렬 실행 방식, 그리고 실제 CLI 환경에서 어떻게 활용할 수 있는지를 정리한 기술 블로그입니다. 반복적이고 복잡한 작업을 어떻게 전문 에이전트에게 위임할 수 있는지, 그리고 이것이 개발 생산성과 워크플로우 확장성에 어떤 변화를 가져오는지를 입력된 정보를 기반으로 설명합니다.

반응형

---

Gemini CLI 서브에이전트 기능 개요

Gemini CLI는 기존 단일 에이전트 기반의 상호작용에서 나아가, 멀티에이전트 아키텍처를 공식 지원하기 시작했습니다.
이 구조의 핵심은 하나의 메인 에이전트가 모든 작업을 처리하는 것이 아니라, 작업 성격에 따라 전문 서브에이전트에게 하위 작업을 위임한다는 점입니다.

메인 Gemini CLI는 전략적 오케스트레이터 역할을 수행하며, 전체 목표와 의사결정, 최종 응답에 집중합니다. 반면, 서브에이전트는 리서치, 코드 탐색, 분석, 테스트와 같은 구체적이고 반복적인 작업을 독립적으로 수행합니다.

---

서브에이전트의 구조와 실행 방식

서브에이전트는 단순한 역할 분리가 아닌, 완전히 격리된 실행 환경을 가집니다.

각 서브에이전트는 다음 요소를 독립적으로 보유합니다.

• 전용 컨텍스트 윈도우
• 커스텀 시스템 인스트럭션
• 자체 도구 세트(tools) 및 MCP 서버
• 개별 실행 흐름

이러한 구조 덕분에 서브에이전트는 수십 번의 도구 호출, 파일 검색, 테스트 실행을 포함하더라도 그 전체 결과를 단일 응답으로 메인 에이전트에 반환합니다.
그 결과, 메인 컨텍스트 윈도우가 불필요하게 채워지는 것을 방지하고 이후 인터랙션의 속도와 비용 효율성을 유지할 수 있습니다.

---

서브에이전트 도입의 핵심 이점

Gemini CLI 서브에이전트 기능의 주요 이점은 크게 세 가지로 정리할 수 있습니다.

1. 역할 분리를 통한 집중도 향상

메인 에이전트는 전체 목표 관리와 최종 판단에 집중하고, 세부 작업은 전문 서브에이전트가 처리합니다. 이로 인해 응답 품질과 일관성이 높아집니다.

2. 병렬 실행으로 작업 속도 개선

리서치, 코드 탐색, 리팩토링, 분석과 같은 작업을 여러 서브에이전트에 병렬로 분산할 수 있어 총 소요 시간이 크게 줄어듭니다.

3. 컨텍스트 오염 방지

서브에이전트가 요약되거나 포맷된 결과만 반환하므로, 기본 세션에서 발생하기 쉬운 context rot와 context pollution 문제를 효과적으로 방지합니다.

---

커스텀 서브에이전트 정의 방식

Gemini CLI는 사용자가 직접 커스텀 서브에이전트를 정의할 수 있도록 설계되어 있습니다.

정의 방법

• 마크다운 파일(.md)에 YAML frontmatter를 사용해 에이전트 정의
• 에이전트의 name, description, tools, model 상속 여부 등을 명시

배치 위치에 따른 범위

• ~/.gemini/agents
  • 개인 워크플로우용 글로벌 에이전트
• .gemini/agents (리포지토리 내부)
  • 프로젝트 레벨에서 팀과 공유
• Gemini CLI extensions의 agents/ 디렉토리
  • 확장 기능의 일부로 번들링 가능

예시: frontend-specialist 에이전트

입력 정보에 따르면 예시로 제공된 frontend-specialist 에이전트는 다음과 같은 특징을 가집니다.

• Senior Frontend Specialist 및 UI/UX Architect 역할 지정
• Core Web Vitals 기반 성능 최적화
• WCAG 2.1+ 접근성 준수
• 모듈형 아키텍처와 Atomic 컴포넌트 설계
• 이 에이전트는 분석과 개선 제안만 수행하며, 직접 코드 수정은 하지 않음

해당 파일을 .gemini/agents/frontend-specialist.md에 배치하면 Gemini CLI가 즉시 새로운 전문가 에이전트로 인식합니다.

---

병렬 실행 기능과 주의사항

Gemini CLI는 여러 서브에이전트 또는 동일 에이전트의 다수 인스턴스를 동시에 실행할 수 있습니다.

활용 예

• 여러 주제를 동시에 리서치
• 여러 컴포넌트를 병렬로 리팩토링
• 패키지 단위 분석 작업 병렬 수행

명시적 요청 예시는 다음과 같습니다.

• 여러 패키지에 대해 frontend-specialist를 병렬 실행 요청

주의해야 할 점

• 대규모 코드 편집 작업에서는 에이전트 간 충돌이나 코드 덮어쓰기 위험 존재
• 병렬 요청으로 인해 사용량 제한에 더 빠르게 도달할 수 있음

병렬 실행은 속도 향상에 효과적이지만, 작업 성격에 따라 신중한 적용이 필요합니다.

---

기본 내장 서브에이전트와 사용 방법

Gemini CLI에는 기본적으로 세 가지 서브에이전트가 탑재되어 있습니다.

1. generalist

• 모든 도구 접근 가능
• 배치 리팩토링, 대량 출력 등 턴 집약적 작업에 적합

2. cli_help

• Gemini CLI 자체 기능과 문서에 특화
• CLI 사용법 및 기능 질의에 적합

3. codebase_investigator

• 코드베이스 탐색
• 아키텍처 매핑
• 버그 근본 원인 분석 및 의존성 파악

명시적 작업 위임 방법

Gemini CLI는 description을 기반으로 자동 라우팅을 수행하지만, @agent 구문을 사용하면 특정 에이전트에 명시적으로 작업을 위임할 수 있습니다.

• @frontend-specialist 앱 리뷰 및 개선점 요청
• @generalist 프로젝트 전체 라이선스 헤더 업데이트
• @codebase_investigator 인증 플로우 매핑

현재 설정된 모든 서브에이전트는 /agents 명령으로 확인할 수 있습니다.

---

728x90

Gemini CLI의 서브에이전트 기능 도입은 단순한 기능 추가를 넘어, CLI 기반 개발 워크플로우의 구조 자체를 확장하는 변화입니다.
전문 역할을 가진 에이전트에게 작업을 위임하고, 이를 병렬로 실행하며, 컨텍스트 오염 없이 결과를 통합하는 방식은 복잡한 개발 환경에서 특히 큰 장점을 가집니다.

앞으로 이 구조를 통해 개발자는 반복 작업에서 벗어나 의사결정과 설계에 더 집중할 수 있고, 팀 단위 협업에서도 일관된 자동화 워크플로우를 구축할 수 있을 것으로 기대됩니다. Gemini CLI 서브에이전트는 생산성과 확장성을 동시에 요구하는 개발 환경에서 중요한 전환점이 될 가능성이 큽니다.

300x250

https://developers.googleblog.com/subagents-have-arrived-in-gemini-cli/

Subagents have arrived in Gemini CLI- Google Developers Blog