![[TIP]Gemini Conductor 사용 가이드](https://tzmluihlahuykicindyt.supabase.co/storage/v1/object/public/blog/thumbnails/1768050563304_0wlch5.svg)
[TIP]Gemini Conductor 사용 가이드
Conductor는 Gemini CLI용 확장 프로그램으로, Context-Driven Development (컨텍스트 주도형 개발) 를 가능하게 합니다.
"Measure twice, code once."
Conductor는 코드를 작성하기 전에 명세(Spec)와 계획(Plan)을 통해 AI 에이전트를 안내하는 체계적인 개발 프로세스를 제공합니다.
📦 1. 설치
터미널에서 아래 명령어를 실행하여 Conductor 확장 프로그램을 설치합니다.
gemini extensions install https://github.com/gemini-cli-extensions/conductor --auto-update
--auto-update: 선택 사항입니다. 지정하면 새 버전이 출시될 때 자동으로 업데이트됩니다.
▶️ 2. Gemini CLI 실행
gemini --yolo
🔄 3. Conductor 개발 워크플로우
Conductor는 Context → Spec & Plan → Implement의 3단계 프로세스를 따릅니다.
| 단계 | 명령어 | 설명 |
|---|---|---|
| 1단계 | /conductor:setup | 프로젝트 컨텍스트 설정 (프로젝트당 1회) |
| 2단계 | /conductor:newTrack "설명" | 새 기능/버그 추적 시작 |
| 3단계 | /conductor:implement | 계획 실행 및 코드 구현 |
📋 단계별 상세 가이드
📍 (1) 프로젝트 설정 (/conductor:setup) - 프로젝트당 1회 실행
프로젝트의 핵심 컴포넌트를 정의합니다. 이 설정은 팀 전체의 공유 기반이 됩니다.
/conductor:setup
설정 항목:
| 항목 | 설명 | 예시 |
|---|---|---|
| Product | 프로젝트 컨텍스트 (사용자, 목표, 기능) | "할 일 관리 앱, 초보자 대상" |
| Product Guidelines | 표준 (문체, 브랜드, 디자인) | "친근한 어조, 미니멀 디자인" |
| Tech Stack | 기술 스택 (언어, DB, 프레임워크) | "HTML, CSS, JavaScript" |
| Workflow | 팀 선호사항 (TDD, 커밋 전략) | "테스트 주도 개발" |
생성되는 파일:
conductor/
├── product.md # 제품 컨텍스트
├── product-guidelines.md # 제품 가이드라인
├── tech-stack.md # 기술 스택
├── workflow.md # 워크플로우
├── tracks.md # 추적 작업 목록
└── code_styleguides/ # 코드 스타일 가이드
📍 (2) 새 트랙 시작 (/conductor:newTrack)
새로운 기능이나 버그 수정을 시작할 때 실행합니다. Spec(명세)과 Plan(계획)을 생성합니다.
/conductor:newTrack
또는 설명과 함께
/conductor:newTrack "할 일 추가 및 삭제가 가능한 화면 만들기"
생성되는 파일:
conductor/tracks/<track_id>/
├── spec.md # 상세 요구사항 (무엇을, 왜 구축하는가?)
├── plan.md # 실행 가능한 할 일 목록 (단계 → 작업 → 하위 작업)
└── metadata.json # 메타데이터
내용 확인 후 승인하면 다음 단계로 진행합니다.
📍 (3) 구현 실행 (/conductor:implement)
계획에 따라 AI가 코드를 작성합니다.
/conductor:implement
작업 흐름:
- 다음 대기 중인 작업 선택
- 정의된 워크플로우 따르기 (예: TDD: 테스트 작성 → 실패 → 구현 → 통과)
- 진행 상황에 따라 plan.md 상태 업데이트
- 진행 상황 검증: 각 단계 종료 시 수동 검증
추가 명령어:
| 명령어 | 설명 |
|---|---|
/conductor:status | 현재 프로젝트 진행 상황 표시 |
/conductor:revert | 트랙, 단계, 작업별 git 되돌리기 |
📊 명령어 참조
| 명령어 | 설명 | 생성/수정 파일 |
|---|---|---|
/conductor:setup | 프로젝트 스캐폴딩 및 환경 설정 | product.md, tech-stack.md, workflow.md, tracks.md 등 |
/conductor:newTrack | 새 기능/버그 트랙 시작 | tracks/<id>/spec.md, tracks/<id>/plan.md, tracks.md |
/conductor:implement | 현재 트랙의 계획 실행 | tracks.md, tracks/<id>/plan.md |
/conductor:status | 현재 진행 상황 표시 | tracks.md 읽기 |
/conductor:revert | git 기반으로 작업 되돌리기 | git history |
✨ 주요 기능
- 📝 Plan before you build: 새 및 기존 코드베이스를 위한 명세와 계획 생성
- 🎯 Maintain context: AI가 스타일 가이드, 기술 스택, 제품 목표를 준수
- 🔄 Iterate safely: 코드 작성 전 계획 검토
- 👥 Work as a team: 프로젝트 수준 컨텍스트를 팀 공유 기반으로 설정
- 🏗️ Build on existing projects: 새 프로젝트(Greenfield)와 기존 프로젝트(Brownfield) 모두 지원
- ↩️ Smart revert: 커밋 해시가 아닌 논리적 작업 단위(트랙, 단계, 작업)를 이해하는 git 기반 되돌리기
⚠️ 토큰 소모 주의사항
Conductor의 컨텍스트 주도형 방식은 프로젝트의 컨텍스트, 명세, 계획을 읽고 분석해야 하므로 토큰 소모가 증가할 수 있습니다.
- 특히 대규모 프로젝트에서
- 광범위한 계획 및 구현 단계 중
현재 세션의 토큰 소모를 확인하려면:
/stats model
🎯 전체 흐름 요약
1. 설치
└─ gemini extensions install [conductor URL] --auto-update
2. Gemini 실행
└─ gemini --yolo
3. 프로젝트 설정 (최초 1회)
└─ /conductor:setup
4. 새 기능 계획
└─ /conductor:newTrack "기능 설명"
5. 구현 시작
└─ /conductor:implement
6. 상태 확인 (필요 시)
└─ /conductor:status
💡 활용 팁
- 명확한 기능 명시:
newTrack에서 구체적으로 설명할수록 더 좋은 결과 - 계획 검토:
implement전에plan.md를 꼭 확인 - 팀 워크플로우:
workflow.md를 팀 표준에 맞게 커스터마이즈 - 정기적 상태 확인:
/conductor:status로 진행 상황 파악
📚 추가 리소스
- Conductor GitHub Repository - 공식 저장소
- Gemini CLI Extensions 문서 - 공식 문서
- Google Developers Blog 소개 - 블로그 게시물
⚠️ 면책 조항
본 가이드를 따르면서 발생하는 모든 결과에 대한 책임은 전적으로 사용자 본인에게 있습니다. 이 문서는 참고용으로 제공되며, 작성자는 어떠한 손해나 문제에 대해 책임지지 않습니다.
금지 사항:
- 본 내용을 악의적인 목적으로 사용하는 것을 엄격히 금지합니다.
- 타인의 권리를 침해하거나 불법적인 활동에 사용하는 것을 금지합니다.
- 상업적 목적의 무단 복제나 재배포를 금지합니다.
본 가이드의 내용은 학습 및 교육 목적으로만 사용해야 합니다.