Gemini CLI에 서브에이전트 기능이 추가됐다

Gemini CLI가 복잡하고 반복적인 작업을 전문 서브에이전트에게 위임하는 멀티에이전트 아키텍처를 공식 지원하기 시작했다.

각 서브에이전트는 독립된 컨텍스트 윈도우, 커스텀 시스템 인스트럭션, 전용 도구 세트, 분리된 MCP 서버를 가질 수 있어 메인 세션의 컨텍스트 오염을 줄인다. 서브태스크 전체 실행 결과는 단일 응답으로 메인 에이전트에 돌아와, 기본 세션은 전체 목표와 최종 의사결정에 집중할 수 있다.

커스텀 서브에이전트는 마크다운 파일 + YAML frontmatter로 정의한다.

• ~/.gemini/agents에 두면 개인용 글로벌 에이전트로 사용
• 리포지토리의 .gemini/agents에 커밋하면 프로젝트 레벨로 공유
• Gemini CLI extensions의 agents/ 디렉토리에 포함해 번들링도 가능

예시로는 frontend-specialist가 소개된다. 이 에이전트는 Senior Frontend Specialist / UI/UX Architect 역할로 설정되고, 모듈형 아키텍처, Core Web Vitals 최적화, WCAG 2.1+ 접근성을 우선 기준으로 삼는다. 다만 역할은 분석과 개선 제안에 한정되며 직접 코드를 수정하지 않는다.

기본 내장 서브에이전트도 함께 제공된다.

• generalist: 범용 작업용
• cli_help: Gemini CLI 자체 문서/사용법 답변용
• codebase_investigator: 코드베이스 탐색, 아키텍처 매핑, 버그 원인 분석용

또한 @agent 구문으로 명시적 위임이 가능하고, 설명 기반 자동 라우팅도 지원한다. 여러 서브에이전트를 병렬 실행할 수 있어 리서치나 리팩토링 같은 작업 시간을 줄일 수 있지만, 대규모 코드 편집에서는 충돌 위험과 사용량 제한에 더 빨리 도달할 수 있다는 점을 주의해야 한다.