Conductor: Gemini CLI를 위한 컨텍스트 기반 개발 소개

Source: Google Developers Blog

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

Dec 17, 2025

• Jay Kornder – 시니어 제품 매니저, 개발자 및 경험
• Sherzat Aitbayev – 시니어 소프트웨어 엔지니어, 개발자 및 경험

두 번 측정하고 한 번 코딩하라

벤자민 프랭클린은 이렇게 말했습니다: “계획을 세우지 않는 것은 실패를 계획하는 것이다.” 그러나 AI 시대에는 우리가 무엇을 만들고 있는지 명확히 이해하지 못한 채 바로 구현에 뛰어드는 경우가 많습니다. Conductor – Gemini CLI용 새로운 프리뷰 확장 – 은 컨텍스트 기반 개발을 통해 이 워크플로우를 바꿉니다. 일시적인 채팅 로그에 의존하는 대신, Conductor는 코드와 함께 영구적인 Markdown 파일에 공식 사양과 계획을 작성하도록 해줍니다. 이를 통해 다음을 할 수 있습니다:

• Build 전에 계획하기 – 새로운 코드베이스든 기존 코드베이스든 에이전트를 안내할 사양과 계획을 작성합니다.
• 컨텍스트 유지 – AI가 스타일 가이드, 기술 스택 선택, 제품 목표를 따르도록 보장합니다.
• 안전하게 반복 – 코드를 작성하기 전에 계획을 검토하여 항상 루프에 머무를 수 있습니다.
• 팀으로 작업 – AI 에이전트에게 동일한 프로젝트와 모범 사례 컨텍스트를 제공합니다.
• 기존 프로젝트에 기반 – 현재 코드를 활용해 설계 결정을 내립니다.

Conductor 뒤에 있는 철학은 간단합니다: 코드를 제어하라. 컨텍스트를 코드와 함께 관리되는 아티팩트로 취급함으로써, 저장소를 모든 에이전트 상호작용을 이끄는 단일 진실 소스로 만들고, 깊고 지속적인 프로젝트 인식을 제공하게 됩니다.

“브라운필드” 프로젝트 지원

우리 작업의 대부분은 기존 코드베이스(브라운필드)를 다룹니다. AI 도구는 프로젝트의 역사와 아키텍처에 대한 미묘한 이해가 부족하기 때문에 여기서 종종 어려움을 겪습니다.

Conductor의 접근 방식

• Context‑driven: 기존 프로젝트에 Conductor를 도입하면, 아키텍처, 가이드라인 및 목표를 포괄하는 기본 문서 세트를 만들 수 있도록 인터랙티브 세션을 시작합니다.
• Continuous updates: 새로운 기능을 구축하고 작업을 수행함에 따라 Conductor는 이 공유 컨텍스트를 업데이트하여 지식이 프로젝트와 함께 성장하도록 보장합니다.

이는 첫 번째 단계에 불과합니다. 앞으로 몇 달 동안 Conductor를 기존 프로젝트에 없어서는 안 될 파트너로 만들기 위해 지속적으로 개선할 것이므로 큰 향상을 기대하셔도 좋습니다.

Source: …

Conductor for Teams

Conductor는 프로젝트 수준 컨텍스트—제품 목표, 기술 스택, 워크플로우 선호도 등을 한 번 정의하고 전체 팀에 공유할 수 있게 해줍니다. 이 공유된 기반은 팀이 구축하는 모든 기능에 자동으로 적용됩니다. 예시:

• 테스트 전략 – Gemini가 기본 제공하는 확립된 테스트 접근 방식을 정의합니다.
• 기술 제약 – 코딩 표준, 린팅 규칙, 의존성 버전을 중앙에서 관리합니다.
• 워크플로우 선호도 – 기본 브랜치 정책, CI/CD 파이프라인, 코드 리뷰 가이드라인을 설정합니다.

왜 Conductor를 사용하나요?

• 일관성 – AI가 생성한 모든 기여가 누가 명령을 실행하든 동일한 가이드라인을 따릅니다.
• 빠른 온보딩 – 새로운 구성원이 전체 설정을 즉시 상속받아 적응 시간을 줄입니다.
• 통합된 코드베이스 – 서로 다른 사람이 만든 기능이라도 하나의 통합된 엔지니어링 팀이 작성한 것처럼 느껴집니다.

기술 제약과 코딩 표준을 중앙 집중화함으로써 Conductor는 모든 기여가 팀 표준에 맞도록 보장하고, 개발 속도를 높이며 전반적인 코드 품질을 향상시킵니다.

Conductor 작동 방식

Conductor는 에이전트 기반 개발을 위한 구조화된 워크플로우로, 단순 코드 수정보다 복잡한 작업에 적합합니다. 단일 상호작용에 국한되는 일반 채팅 세션과 달리, Conductor는 일련의 Markdown 파일을 사용해 시간에 따라 계획을 세우고 진행 상황을 추적합니다. 이 파일들은 리포지토리에 영구히 저장되므로, 작업을 일시 중지하고, 재개하고, 머신을 자유롭게 전환할 수 있습니다.

1. 컨텍스트 설정

/conductor:setup 을 실행해 프로젝트의 핵심 구성 요소를 정의합니다. 캡처된 컨텍스트는 이후 새로운 컴포넌트나 기능을 만들 때 재사용할 수 있습니다.

• Product – 사용자, 제품 목표, 고수준 기능을 정의합니다.
• Tech stack – 선호하는 언어, 데이터베이스, 프레임워크를 선택합니다.
• Workflow – 팀 선호도(예: 테스트‑주도 개발)를 설정합니다.

2. 지정 및 계획

새로운 기능이나 버그 수정을 시작할 준비가 되면 /conductor:newTrack 을 실행합니다. 이는 track—Conductor가 사용하는 고수준 작업 단위—을 생성합니다. 바로 코딩에 뛰어들기보다, Conductor는 두 가지 필수 산출물을 만들도록 도와줍니다:

Conductor는 기존 컨텍스트를 기반으로 답변을 제안하면서 각 산출물을 만드는 과정을 안내해, 고품질의 스펙과 계획을 빠르게 작성할 수 있도록 돕습니다.

3. 구현

계획을 승인한 후 /conductor:implement 을 실행합니다. 코딩 에이전트가 plan.md 파일을 따라 작업을 진행하며, 완료된 작업을 체크합니다. 상태가 파일에 저장되기 때문에 다음과 같은 장점이 있습니다:

• 나중에 중단하고 다시 시작해도 진행 위치를 잃지 않음.
• 내장된 체크포인트를 통해 이전 버전으로 되돌릴 수 있음.
• 우선순위가 바뀌면 계획을 중간에 수정 가능.

시작하기

우리는 컨텍스트‑드리븐 개발이 복잡한 프로젝트에서 더 높은 품질의 결과를 가져온다고 믿습니다. 문서를 진실의 원천으로 다룸으로써 Gemini가 엔지니어링 팀의 진정한 확장 역할을 할 수 있도록 합니다.

확장 설치

Conductor를 두 가지 방법 중 하나로 설치할 수 있습니다:

• 리포지토리 링크를 통해:

gemini extensions install https://github.com/gemini-cli-extensions/conductor

• Gemini CLI를 통해:

gemini extensions install https://github.com/gemini-cli-extensions/conductor

← 이전 | 다음 →