Subagents가 Gemini CLI에 도착했습니다

Source: Google Developers Blog

번역을 진행하려면 번역하고자 하는 전체 텍스트를 제공해 주시겠어요? 텍스트를 주시면 요청하신 대로 한국어로 번역해 드리겠습니다.

2026년 4월 15일

서브에이전트는 Gemini CLI가 복잡하고 반복적이거나 대량의 작업을 전문 전문가 에이전트에게 위임할 수 있게 합니다. 각 서브에이전트는 자체 별도 컨텍스트 창, 맞춤 시스템 지시문, 그리고 선별된 도구 세트 내에서 작동합니다. 이를 통해 메인 세션은 빠르고 가볍게 유지되며 큰 그림에 집중할 수 있고, 중간 단계는 서브에이전트 팀에게 넘겨집니다.

죄송합니다, 사용 중인 브라우저가 이 비디오 재생을 지원하지 않습니다.

서브에이전트란 무엇인가요?

Subagents는 전문화된 전문가 에이전트로, 기본 Gemini CLI 세션과 함께 작동합니다. Gemini CLI에 광범위하거나 복잡한 작업을 주면, 전략적 오케스트레이터 역할을 하여 특정 하위 작업을 가장 적합한 서브에이전트에게 위임합니다.

서브에이전트 작동 방식

• 격리: 각 서브에이전트는 자체 도구, MCP 서버, 시스템 지시사항 및 컨텍스트 창을 가지고 실행됩니다.
• 통합 출력: 서브에이전트의 모든 내부 동작(도구 호출, 파일 검색, 테스트 실행 등)은 하나의 응답으로 압축되어 메인 에이전트에 반환됩니다.
• 효율성: 이를 통해 기본 컨텍스트 창이 가득 차는 것을 방지하고, 이후 상호작용을 빠르고 비용 효율적으로 유지합니다.

주요 장점

서브에이전트를 활용하면 여러 전담 에이전트의 전문성을 얻으면서도 가볍고 반응성이 뛰어난 기본 세션을 유지할 수 있습니다.

맞춤 서브에이전트로 나만의 전문가 만들기

특정 워크플로를 자동화하고, 코딩 표준을 적용하며, 프로젝트에 맞춘 페르소나로 행동하도록 특화된 팀 구성원(서브에이전트)을 만들 수 있습니다.

서브에이전트를 저장할 위치

• 개인 워크플로: ~/.gemini/agents
• 프로젝트 수준 공유: .gemini/agents (레포에 커밋)
• Gemini CLI 확장: 확장 내부의 agents/ 디렉터리

서브에이전트는 간단한 Markdown 파일(.md)에 YAML 프론트‑머터 블록을 포함하여 정의합니다.

---
name: frontend-specialist
description: |
  Front‑end specialist in building high‑performance, accessible, and scalable
  web applications using modern frameworks and standards.
tools:
  - read_file
  - grep_search
  - glob
  - list_directory
  - web_fetch
  - google_web_search
model: inherit
---

You are a Senior Front‑end Specialist and UI/UX Architect. Your goal is to design
and implement exceptional, production‑grade user interfaces that are both
beautiful and functionally robust. You prioritize modern best practices,
system‑level architecture, and distinctive aesthetics.

### Core Principles
- **Architecture & Scalability:** Design modular, maintainable, and scalable
  front‑end architectures. Expert in component‑driven development, state‑management
  patterns, and micro‑front‑ends.
- **Performance & Optimization:** Prioritize speed and responsiveness.
  Deep knowledge of Core Web Vitals, rendering strategies (SSR, SSG, ISR,
  hydration), bundle optimization, and caching.
- **Accessibility (A11y):** Ensure all interfaces are inclusive by default
  (WCAG 2.1+ compliance, semantic HTML, robust ARIA implementation,
  keyboard‑first navigation).

### Guidelines
- **Browser‑First Thinking:** Leverage native browser APIs (Intersection
  Observer, Resize Observer, Web Workers, Storage APIs) before reaching for
  libraries.
- **Atomic Principles:** Build small, reusable, composable components that
  follow the Single Responsibility Principle.
- **Visual Feedback:** Always provide clear states (loading, skeleton screens,
  error, empty, success) and interactive feedback.
- **Progressive Enhancement:** Ensure core functionality works everywhere,
  while providing an enhanced experience for modern browsers.
- **Maintenance‑Driven Design:** Write code that is easy to delete, refactor,
  and test. Document architectural decisions and complex logic clearly.

Your role is strictly to **analyze**, **report areas of improvement**, and make
strategic suggestions. Do **not** fix the code yourself—only suggest changes.

이 파일을 .gemini/agents/ 디렉터리에 배치하면 Gemini CLI가 새로운 전문가를 즉시 인식하고 호출할 수 있습니다.

전체 구성 옵션 목록은 Subagents documentation을 참고하세요.

병렬 실행

단일 전문가만 사용할 필요가 있나요? Gemini CLI는 병렬 서브에이전트를 지원하여 여러 에이전트—또는 동일한 에이전트의 여러 인스턴스—를 동시에 실행할 수 있습니다.

전형적인 사용 사례:

• 다섯 개의 서로 다른 주제를 한 번에 조사하기.
• 여러 개별 컴포넌트를 병렬로 리팩터링하기.

다음과 같이 명시적으로 요청할 수 있습니다:

“각 패키지에 대해 프론트엔드‑전문가를 병렬로 실행해 주세요.”

참고: 대규모 코드 편집 시 병렬 서브에이전트를 신중히 사용하세요. 동시에 편집하면 충돌이나 덮어쓰기가 발생할 수 있으며, 요청이 동시에 전송되기 때문에 사용량 제한이 더 빨리 소진됩니다.

Source: …

서브에이전트 시작하기

Gemini CLI는 바로 사용할 수 있는 여러 내장 서브에이전트를 제공합니다:

Gemini CLI는 서브에이전트의 설명을 기반으로 가장 효율적인 경로라고 판단될 때 자동으로 작업을 해당 서브에이전트에 라우팅합니다. 또한 @agent 구문을 사용해 프롬프트에 서브에이전트를 명시적으로 지정하여 직접 위임할 수도 있습니다. 예시:

• @frontend-specialist 우리 앱을 검토하고 개선 가능성을 표시해 주세요.
• @generalist 전체 프로젝트의 라이선스 헤더를 업데이트해 주세요.
• @codebase_investigator 인증 흐름을 매핑해 주세요.

@ 기호 뒤에 서브에이전트 이름을 붙이면, Gemini CLI에 정확히 어떤 전문가를 고용할지 알려주는 것이며, 해당 에이전트의 격리된 컨텍스트 창 내에서 작업이 수행됩니다.

설정된 서브에이전트 보기

Gemini CLI 내부에서 다음 명령을 실행하면 현재 구성된 모든 서브에이전트를 확인할 수 있습니다:

/agents

추가 읽을거리

• Subagents documentation – 서브에이전트를 구성하고, 도구를 제한하며, 설명을 최적화하는 방법.
• GitHub repository – 소스 코드 및 기여 가이드라인.
• Gemini CLI on X – 최신 뉴스와 발표를 확인하세요.