Conductor: Gemini CLI를 위한 컨텍스트 기반 개발 소개
Source: Google Developers Blog
2025년 12월 17일
- Jay Kornder – Senior Product Manager – Developer & Experiences
- Sherzat Aitbayev – Senior Software Engineer – Developer & Experiences
두 번 재측정하고 한 번 코딩하기
벤자민 프랭클린은 “계획을 세우지 않는 것은 실패를 계획하는 것이다.” 라고 말했습니다. 하지만 AI 시대에 우리는 종종 무엇을 만들고 있는지 명확히 이해하지 못한 채 바로 구현 단계로 뛰어듭니다. Conductor(새로운 확장 기능으로 현재 Gemini CLI 프리뷰에서 사용 가능)는 컨텍스트 기반 개발을 통해 이 워크플로를 바꿔줍니다.
일시적인 채팅 로그에 의존하는 대신, Conductor는 코드와 함께 지속적인 Markdown 파일에 보관되는 공식 사양과 계획을 만들도록 도와줍니다. 이를 통해 다음을 할 수 있습니다:
- 구현 전에 계획하기 – 새로운 코드베이스와 기존 코드베이스 모두에 대해 에이전트를 안내할 사양과 계획을 작성합니다.
- 컨텍스트 유지 – AI가 스타일 가이드, 기술 스택 선택, 제품 목표를 따르도록 보장합니다.
- 안전하게 반복하기 – 코드를 작성하기 전에 계획을 검토하여 언제나 작업 흐름을 파악할 수 있습니다.
- 팀으로 작업하기 – AI 에이전트에게 프로젝트 전반에 걸친 베스트 프랙티스 컨텍스트를 제공합니다.
- 기존 프로젝트에 기반하기 – 현재 코드를 활용해 설계 결정을 내립니다.
Conductor의 철학은 간단합니다: 코드를 제어하라. 컨텍스트를 코드와 함께 관리되는 아티팩트로 취급함으로써, 저장소를 모든 에이전트 상호작용을 이끄는 단일 진실 원천으로 만들고, 깊고 지속적인 프로젝트 인식을 제공합니다.
스크린샷
“브라운필드” 프로젝트 지원
대부분의 작업은 기존 코드베이스(일명 브라운필드 프로젝트)를 다룹니다. 이러한 환경은 AI 도구가 종종 부족한 곳으로, 프로젝트의 역사, 아키텍처 및 관례에 대한 미묘한 이해가 부족합니다.
Conductor가 돕는 방법
-
컨텍스트 기반 온보딩 – Conductor를 기존 저장소에 지정하면, 핵심 문서 세트를 만드는 과정을 안내하는 인터랙티브 세션이 시작됩니다:
- 아키텍처 개요
- 코딩 가이드라인
- 프로젝트 목표
-
지속적인 지식 성장 – 기능을 추가하거나 새로운 작업에 착수할 때마다 Conductor가 자동으로 공유 컨텍스트를 업데이트하여, 변화하는 코드베이스와 이해를 동기화합니다.
다음 단계
이는 첫 번째 단계에 불과합니다. 앞으로 몇 달 동안 Conductor를 기존 프로젝트에 더욱 없어서는 안 될 파트너로 만들기 위한 향상 기능을 출시할 예정입니다. 기대해 주세요!
팀을 위한 Conductor
Conductor는 제품, 기술 스택 및 워크플로우 선호도에 대한 프로젝트 수준의 컨텍스트를 정의할 수 있게 해줍니다. 이 선호도를 한 번 설정하면 팀이 만드는 모든 기능의 공유 기반이 됩니다.
- 통합 테스트 전략 – Gemini가 자동으로 적용하는 테스트 접근 방식을 정의합니다.
- 중앙 집중식 제약 및 표준 – 명령을 실행하는 사람에 관계없이 모든 AI‑생성 기여가 귀하의 가이드라인을 따릅니다.
- 빠른 온보딩 – 새로운 구성원이 동일한 구성을 상속받아 기능이 하나의 일관된 엔지니어링 팀이 만든 것처럼 느껴집니다.
기술 제약과 코딩 표준을 통합함으로써 Conductor는 일관성을 보장하고 개발 속도를 높이며 전체 팀에 걸쳐 통합된 엔지니어링 목소리를 유지합니다.
Source: …
Conductor 작동 방식
Conductor는 에이전트 기반 개발을 위한 구조화된 워크플로우로, 단순 코드 편집보다 복잡한 작업에 적합합니다. 단일 상호작용에 국한되는 일반 채팅 세션과 달리, Conductor는 일련의 Markdown 파일을 사용해 시간에 따라 계획을 세우고 진행 상황을 추적합니다. 이 파일들은 저장소에 지속되므로, 컨텍스트를 잃지 않고 작업을 일시 중지·재개하거나 머신을 교체할 수 있습니다.
1. 컨텍스트 설정
/conductor:setup 을 실행해 프로젝트의 핵심 요소를 정의합니다. 캡처된 컨텍스트는 새로운 컴포넌트나 기능을 만들 때 재사용할 수 있습니다.
- Product – 사용자, 제품 목표, 고수준 기능 정의.
- Tech stack – 선호하는 언어, 데이터베이스, 프레임워크 선택.
- Workflow – 팀 선호도 설정(예: 테스트 주도 개발).
2. 명세 및 계획
새로운 기능이나 버그 수정을 시작할 준비가 되면 /conductor:newTrack 을 실행합니다. 이 명령은 track을 생성합니다—Conductor가 사용하는 고수준 작업 단위 용어입니다. 바로 코딩에 들어가기보다, Conductor는 두 가지 중요한 산출물을 만들도록 도와줍니다:
| 아티팩트 | 목적 |
|---|---|
| Specs | 세부 요구사항: 무엇을 만들고 왜 만드는지. |
| Plan | 단계 → 작업 → 하위 작업 으로 구성된 실행 가능한 할 일 목록. |
Conductor는 이전에 캡처한 컨텍스트를 기반으로 답변을 제안하면서, 고품질의 스펙과 계획을 빠르게 작성하도록 안내합니다.
3. 구현
계획을 승인한 뒤 /conductor:implement 을 실행합니다. 코딩 에이전트가 plan.md 파일을 따라 작업을 진행하며, 완료된 작업을 체크합니다. 상태가 파일에 저장되기 때문에 다음과 같은 이점이 있습니다:
- 커피를 마시며 잠시 멈추고, 나중에 다시 시작해도 위치를 잃지 않음.
- 내장된 체크포인트를 통해 이전 버전으로 되돌릴 수 있음.
- 우선순위가 바뀌면 진행 중에도 계획을 수정 가능.
Conductor를 사용하면 워크플로우가 지속적이고 협업 가능하며 재현 가능한 Markdown 기반 단계들의 연속이 되어, 복잡한 개발 작업을 시간과 머신을 초월해 관리할 수 있습니다.
시작하기
우리는 컨텍스트 기반 개발이 복잡한 프로젝트에서 더 높은 품질의 결과를 가져온다고 믿습니다. 문서를 진실의 원천으로 취급함으로써 Gemini가 엔지니어링 팀의 진정한 확장으로 작동하도록 할 수 있습니다.
- 저장소를 통해: github.com/gemini-cli-extensions/conductor
- 또는 명령줄로:
gemini extensions install https://github.com/gemini-cli-extensions/conductor