Gemini CLI의 플랜 모드에 대해 알아야 할 모든 것

홈 » Python » Gemini CLI의 플랜 모드에 대해 알아야 할 모든 것

Gemini CLI의 계획 모드는 기본적으로 코드를 한 줄도 작성하기 전에 복잡한 변경 사항을 미리 생각해 볼 수 있는 안전한 읽기 전용 환경입니다. 바로 수정 작업에 들어가는 대신, 담당자와 함께 조사, 설계 및 계획 단계를 거치게 되며, Gemini는 프로젝트가 실수로 수정되는 것을 방지하면서 코드베이스, 도구 및 문서를 꼼꼼히 검토합니다.

이 모드는 속도나 유연성을 희생하지 않고 구현을 시작하기 전에 구조, 안전성 및 명확성을 확보하고자 하는 개발자를 위해 설계되었습니다. 이를 통해 데이터베이스 마이그레이션, 새로운 기능, 리팩토링 또는 감사를 계획할 수 있으며, 고도의 추론 모델, 사용자 지정 정책, 에이전트 스킬, 심지어 CI/CD의 헤드리스 워크플로까지 활용할 수 있습니다. 모든 것이 의도적이고 추적 가능한 계획 샌드박스라고 생각하면 됩니다.

Gemini CLI에서 플랜 모드란 무엇입니까?

플랜 모드는 Gemini CLI의 읽기 전용 작동 모드로, 에이전트가 제한된 안전 도구 세트만 사용할 수 있도록 합니다. Gemini가 활성화된 동안에는 저장소를 탐색하고, 파일을 검사하고, 패턴을 검색하고, 문서를 읽을 수 있지만, 프로젝트 파일을 변경하거나 상태를 바꿀 수 있는 임의의 명령을 실행할 수는 없습니다. Gemini가 작성할 수 있는 유일한 파일은 자체 내부 계획 아티팩트입니다.

플랜 모드의 핵심 아이디어는 생각과 행동을 분리하는 것입니다. 먼저, Gemini는 사용자의 요청을 이해하고, 코드베이스, 종속성 및 환경을 분석하고, 상세한 계획을 수립하는 데 집중합니다. 사용자가 해당 계획을 명시적으로 승인한 후에야 CLI는 변경 작업을 수행하기 위해 편집 또는 실행 모드로 전환됩니다.

Gemini CLI의 신규 사용자는 기본적으로 계획 모드가 활성화되어 있으므로 대부분의 워크플로는 이미 연구 중심적인 사고방식으로 시작됩니다. 언제든지 이 기능을 끄거나 워크플로에서 제거할 수 있지만, 기본 설정은 특히 규모가 크거나 위험도가 높은 변경 사항의 경우 계획 단계를 최우선 순위로 처리하는 것입니다.

이 모드는 에이전트 스킬, 정책 엔진, MCP 도구 및 모델 관리와 같은 다른 Gemini 기능과도 긴밀하게 통합되어 있습니다. 이는 단순한 안전 장치일 뿐만 아니라, 견고하고 합리적인 솔루션을 설계하기 위한 강력한 환경을 제공합니다.

플랜 모드를 활성화하고 진입하는 방법

플랜 모드는 일반적으로 기본적으로 활성화되어 있지만, Gemini CLI가 이 모드로 시작되는 방법과 시기를 제어할 수 있습니다. 플랜 모드를 기본 동작으로 설정할지, 아니면 특정 세션에서만 사용할지에 따라 플랜 모드를 구성하거나 진입하는 방법은 여러 가지가 있습니다.

Gemini CLI가 항상 플랜 모드로 시작되도록 하려면 CLI 내부에서 설정을 변경할 수 있습니다. 실행 / 설정 명령어를 실행하고 "기본 승인 모드"라는 옵션을 찾아 다음과 같이 설정하십시오. 계획그 시점부터 모든 새 세션은 이 읽기 전용 계획 환경에서 시작됩니다.

계획 모드로 바로 진입하려는 일회성 세션의 경우 명령줄 플래그를 사용할 수 있습니다. CLI를 시작하려면 다음을 입력하세요. 제미니 –승인-모드=계획 그러면 상담원은 사용자가 별도로 설정을 변경할 필요 없이 즉시 플랜 모드의 제한 사항에 따라 작동하게 됩니다.

Gemini CLI에 이미 접속한 상태에서는 여러 가지 방법으로 즉시 플랜 모드로 전환할 수 있습니다. 당신은 누를 수 있습니다. Shift + Tab 사용 가능한 승인 모드(기본 → 자동 편집 → 계획)를 순환하려면 다음을 사용하십시오. /계획 명령을 내리거나 자연어로 에이전트에게 특정 목표에 대한 "계획을 시작하라"고 요청할 수 있습니다. 제미니는 백그라운드에서 에이전트를 호출합니다. 계획 모드 진입 모드를 변경하는 도구입니다.

/plan 명령어를 사용하면 목표를 바로 입력할 수 있어 모드를 전환하면서 동시에 계획을 즉시 시작하려는 경우에 유용합니다. 예를 들어, 다음을 입력합니다. 인증 구현 계획 Gemini를 계획 모드로 전환하고 인증 설계에 대한 요청을 즉시 제출하여 조사 및 분석을 바로 시작합니다.

핵심 워크플로: 조사, 설계, 초안 작성, 승인

계획 모드는 목표 설정, 조사, 설계, 계획 초안 작성, 승인 또는 수정이라는 간단하지만 강력한 작업 흐름으로 구조를 만들어 줍니다. 각 단계는 의도적으로 분리되어 있으므로 사용자가 제어권을 유지하고 예상치 못한 수정이나 위험한 작업을 방지할 수 있습니다.

첫째, 명확한 목표를 제시해야 합니다. "Redis를 사용하여 새로운 알림 서비스를 계획하세요" 또는 "이 데이터베이스를 마이그레이션하는 방법을 조사하세요"와 같이 목표를 설정할 수 있습니다. Gemini는 이러한 목표를 기반으로 계획 모드(활성화되어 있지 않은 경우)에 진입하여 코드베이스, 인프라 및 문서의 관련 부분을 읽기 전용 방식으로 탐색하기 시작합니다.

연구 단계에서 Gemini는 파일 ​​목록 보기, 글로빙, grep 스타일 검색 및 기타 읽기 전용 기능을 사용하여 시스템에 대한 개념도를 구축합니다. 어떤 경우에는 다음과 같은 전문 하위 에이전트에 의존할 수도 있습니다. 코드베이스 조사관 또는 특정 도메인에 맞춘 에이전트 스킬을 활성화하여 종속성 및 아키텍처를 더 잘 이해할 수 있습니다.

에이전트가 충분한 맥락 정보를 확보하면 설계 및 논의 단계로 넘어갑니다. 여기서 제미니는 전략을 제안하고, 장단점을 제시하며, 필요에 따라 질문을 통해 내용을 명확히 하려고 할 수 있습니다. ask_user 이러한 상호 협의를 통해 선택한 접근 방식이 사용자의 선호도, 제약 조건 및 기존 관례와 일치하는지 확인할 수 있습니다.

구두로 방향에 합의하면 Gemini는 공식 구현 계획을 Markdown 파일로 작성하여 전용 계획 디렉토리에 저장합니다. 이 문서는 상세하고 체계적인 구조를 가지고 있으며, 작업, 단계, 종속성, 잠재적 위험, 그리고 경우에 따라 대안까지 열거합니다. 실행 전에 이 문서를 읽고, 편집하고, 주석을 달 수 있습니다.

이 과정의 마지막 단계는 명시적인 승인입니다. Gemini CLI는 계획을 제시하고 "예, 수정 사항을 자동으로 수락" 또는 "예, 수동으로 수정 사항을 수락"과 같은 옵션을 제공하여 구현을 시작할 수 있도록 합니다. 만약 마음에 들지 않는 부분이 있다면 피드백을 보내거나, 계획 파일을 직접 수정하거나, 간단히 계획을 취소할 수 있습니다. 야후! 다른 접근 방식을 시도해 보세요.

계획 수립 과정: 토론, 수정 및 의견 제시

플랜 모드의 가장 큰 장점 중 하나는 플랜을 사용자와 Gemini가 공동으로 편집할 수 있는 공유 아티팩트로 취급한다는 점입니다. 이러한 협업은 복잡한 변화를 자연어 프롬프트만으로 설명하는 것보다 더 정확하고 빠를 수 있습니다.

Gemini가 초안 작성을 완료하고 검토를 위해 계획을 제출하면, 원하는 외부 편집기에서 바로 열 수 있습니다. PR 기사 Ctrl + X CLI 내부에서 실행하면 마크다운 계획이 VS Code, Vim 또는 사용자가 설정한 편집기에서 열립니다. 수동으로 파일을 찾을 필요가 없습니다.

편집기 안에서 원하는 대로 계획을 수정할 수 있습니다. 배포 파이프라인에 맞게 단계 순서를 재배열하거나, 명확성을 위해 특정 작업을 다시 작성하거나, 불필요하다고 생각되는 작업을 제거하거나, 더 자세한 설명이 필요한 부분을 확장할 수 있습니다. 또한 "기존 Logger 클래스를 여기서 재사용해야 할까요?" 또는 "현재 SLO와 비교하여 검증해야 합니다."와 같은 인라인 주석을 추가할 수도 있습니다.

편집기를 저장하고 닫으면 Gemini CLI가 자동으로 변경 사항과 댓글을 감지합니다. 이 시스템은 업데이트된 문서를 분석하고, 사용자의 피드백을 반영하여 전략에 대한 내부 이해를 다듬습니다. 그런 다음, 에이전트는 사용자가 다시 검토할 수 있도록 완성도 높은 계획안을 생성합니다.

편집 → 다듬기 → 검토의 과정을 반복하여 계획에 만족할 때까지 필요한 만큼 여러 번 수정할 수 있습니다. 준비가 되면 명확하게 승인해야 하며, 그제서야 Gemini는 계획 모드를 종료하고 합의된 단계에 따라 실제 편집 또는 명령 실행을 시작합니다.

계획 모드 종료 및 승인 모드 전환

계획 모드를 종료하려면 언제든지 가능합니다. 계획 수립이 완료되었거나 다른 승인 모드로 전환하려는 경우에도 마찬가지입니다. 이 환경을 떠나기 전에 계획을 확정하거나 승인받을 필요는 없습니다.

계획 모드가 종료되는 가장 일반적인 방법은 최종 계획을 승인하는 것입니다. Gemini가 구현을 시작해야 한다는 것을 확인하는 즉시 CLI는 자동으로 계획 모드를 종료하고 승인 설정에 따라 상태를 변경하는 편집 및 도구 호출이 허용되는 보다 관대한 모드로 전환됩니다.

승인 절차 없이 다른 모드로 전환하려면 계획 모드로 들어갈 때 사용하는 것과 동일한 키보드 단축키를 사용하면 됩니다. PR 기사 Shift + Tab 개발 작업에 따라 계획 모드에서 기본 모드 또는 자동 편집 모드로 전환할 수 있습니다.

자연어 명령어를 사용해도 모드 전환이 가능합니다. "계획 모드 종료" 또는 "계획 중지"와 같은 문구를 입력하면 Gemini가 해당 모드 전환 도구를 호출하여 이전 동작으로 복원합니다. 이를 통해 워크플로가 발전함에 따라 계획 컨텍스트로 쉽게 들어가고 나올 수 있습니다.

계획 모드에서 안전 모델 및 허용된 도구

계획 모드는 내부적으로 엄격한 안전 정책에 따라 작동하며, 계획 단계 동안 프로젝트가 읽기 전용 상태를 유지하도록 보장합니다. 이 모드는 Gemini CLI 정책 엔진과 전용 구성 파일(이름은 생략됨)을 통해 지원됩니다. 계획.toml이는 허용되는 도구와 그 작동 방식을 정의합니다.

플랜 모드에 내장된 정책은 1단계 정책으로 간주되며 쓰기 또는 파괴적인 작업을 방지하는 데 항상 중점을 둡니다. 기본적으로 파일 읽기, 검색 또는 목록 보기와 같이 본질적으로 안전한 도구만 허용됩니다. 파일을 변경하거나, 명령을 실행하거나, 외부 시스템을 변경할 수 있는 모든 작업은 명시적으로 규칙을 재정의하지 않는 한 차단됩니다.

정책 엔진은 모드를 지정하지 않은 규칙을 전역적으로 활성화된 규칙으로 처리합니다. 즉, 이러한 규칙은 계획 모드에서도 적용됩니다. 규칙이 플랜 모드가 아닌 다른 모드에서만 적용되도록 하려면 해당 규칙에 대상 모드를 명시적으로 나열해야 합니다. 예를 들어, 다음과 같이 하면 됩니다. npm 테스트 기본 모드와 자동 편집 모드에서는 허용되지만 계획 모드에서는 허용되지 않도록 하려면 계획 모드를 제외하는 모드 목록을 사용하여 구성하면 됩니다.

또 다른 중요한 안전 기능은 지속적인 도구 승인 범위 설정 방식입니다. 기본 모드나 자동 편집 모드처럼 권한이 완화된 모드에서 부여된 승인은 계획 모드로 자동으로 이전되지 않습니다. 이는 연구 단계에 있는 동안 구현에 사용할 것으로 신뢰하는 도구가 자동으로 실행되는 것을 방지하기 위함입니다. 하지만 계획 모드에서 부여된 승인은 의도적인 것으로 간주되어 이후 다른 모드에도 일괄적으로 적용할 수 있습니다.

전반적으로 플랜 모드는 기본적으로 안전하지만, 동시에 높은 수준의 맞춤 설정이 가능합니다. 사용 가능한 도구, 승인 방식, 계획 생성 및 실행 전환과 관련된 추적 또는 로깅 유형을 맞춤 설정할 수 있습니다.

사용자 지정 정책, MCP 도구 및 후크

기본 제공되는 1단계 정책 외에도, 자체 정책 파일을 추가하여 플랜 모드를 조직 또는 개인 워크플로에 맞게 더욱 세밀하게 조정할 수 있습니다. 이들은 ~에 살고 있습니다 ~/.gemini/policies/ 디렉터리이며 2단계로 간주되므로 에 정의된 기본 동작을 개선하거나 확장할 수 있습니다. 계획.toml.

일반적인 사용 사례 중 하나는 계획 모드에서 읽기 전용 모델 컨텍스트 프로토콜(MCP) 도구의 동작 방식을 제어하는 ​​것입니다. 기본적으로 Gemini는 이러한 도구를 실행하기 전에 사용자 확인을 요구할 수 있으며, 이는 비파괴적인 도구인 경우에도 마찬가지입니다. 도구 주석 그리고 mcpName 와일드카드를 사용하면 자동 승인되거나 프롬프트가 덜 필요한 특정 패턴 또는 도구 세트를 정의할 수 있으므로 외부 서비스에 크게 의존하는 환경에서 계획 수립이 더욱 원활해집니다.

계획 모드가 구현 모드로 전환될 때 트리거되는 후크를 연결할 수도 있습니다. 예를 들어, 조직에서 승인된 모든 계획에 대한 감사 추적이 필요한 경우, 다음을 추가할 수 있습니다. 애프터툴 Gemini가 계획 모드를 종료하고 변경 사항 실행을 시작할 때마다 최종 계획 아티팩트를 Google Cloud Storage 또는 다른 아카이브 시스템에 복사하는 후크입니다.

일반적인 후크는 세션 및 계획 파일에 대한 컨텍스트를 수신하는 ~/.gemini/hooks/archive-plan.sh와 같은 스크립트일 수 있습니다. 이를 통해 수동 워크플로를 변경하지 않고도 규정 준수 및 추적성 요구 사항을 시행할 수 있습니다. 계획이 승인될 때마다 나중에 검토하거나 사고 분석을 위해 자동으로 백업됩니다.

사용자 지정 정책과 후크를 결합하면 팀은 자체 방법론을 플랜 모드에 직접 구현할 수 있습니다. 더욱 엄격한 승인 절차, 의무적인 로깅 또는 환경별 도구 제한 등 어떤 기능을 원하든 정책 엔진은 필요한 설정을 제공합니다.

에이전트 역량 및 전문 계획 워크플로

에이전트 스킬은 계획 모드 내에서 Gemini CLI가 특정 작업 범주를 계획하는 방식을 맞춤 설정하는 핵심 메커니즘입니다. 스킬 패키지는 에이전트가 특정 작업을 조사, 설계 및 구성하는 방법을 안내하는 전문적인 지침, 절차적 단계 및 휴리스틱을 포함합니다.

예를 들어, "데이터베이스 마이그레이션" 기술은 모든 계획에 백업 전략, 데이터 유효성 검사 및 롤백 절차가 포함되도록 요구할 수 있습니다. 매번 이러한 세부 사항을 모두 기억하는 대신, 해당 기술을 활용하여 각 마이그레이션 계획이 안전하고 기준에 부합하는지 확인할 수 있습니다.

마찬가지로, "보안 감사" 스킬은 Gemini가 코드베이스 탐색 중에 취약점이나 잘못된 구성을 적극적으로 찾아내도록 유도할 수 있습니다. 이는 에이전트에게 안전하지 않은 기본 설정, 누락된 인증 검사 또는 암호화되지 않은 비밀 정보를 검색하도록 지시한 다음, 발견 사항과 해결 단계를 계획 아티팩트 내에 요약하도록 할 수 있습니다.

프런트엔드 측면에서 "프런트엔드 디자인" 기술은 상담원이 특정 UI 구성 요소 라이브러리 및 접근성 지침을 참조하도록 안내할 수 있습니다. 이 기능을 통해 생성된 도면은 디자인 시스템, ARIA 모범 사례 또는 성능 제약 조건을 자동으로 참조하여 UI의 일관성과 포용성을 유지하는 데 도움이 됩니다.

플랜 모드에서 스킬을 사용하려면 Gemini CLI에 "플랜 모드에서 스킬을 사용하세요"라고 명시적으로 요청할 수 있습니다. "계획을 세우는 기술…" 또는 에이전트가 관련 기술을 자율적으로 활성화할 수 있도록 작업을 설명하는 방식으로 작업을 설명하세요. 일단 활성화되면, 이 기능은 연구 우선순위부터 최종 마크다운 계획의 구조에 이르기까지 계획 단계의 진행 방식을 재구성합니다.

스킬이 플랜 모드의 안전 모델과 원활하게 통합되므로 고도로 전문화된 워크플로우조차도 읽기 전용 보장 및 승인 게이트의 이점을 누릴 수 있습니다. 의도치 않은 부작용 없이 환경에 영향을 주지 않으면서 심층적이고 도메인에 특화된 계획을 수립할 수 있습니다.

모델 라우팅: 계획에는 Pro, 실행에는 Flash를 사용합니다.

Gemini CLI에는 추론 품질과 실행 속도의 균형을 맞추기 위해 계획 모드를 활용하는 자동 모델 라우팅 기능이 포함되어 있습니다. 자동 모델 구성을 사용하면 CLI는 계획 단계인지 구현 단계인지에 따라 다른 Gemini 모델을 선택합니다.

플랜 모드에서는 요청이 Gemini 3.1 Pro와 같은 고성능 Pro 모델로 라우팅됩니다. 이 모델은 복잡한 분석, 건축 설계 결정, 장기적인 맥락 추론 및 정교한 계획 수립에 최적화되어 있습니다. 목표는 더 많은 계산이 필요하더라도 계획 자체의 품질과 견고성을 극대화하는 것입니다.

계획이 승인되고 계획 모드를 종료하면 CLI는 구현 단계가 시작되었음을 감지하고 자동으로 고속 플래시 모델로 전환합니다. 여기서 우선순위는 응답성과 비용 효율성입니다. 에이전트는 거창한 전략적 결정을 내리기보다는 잘 정의된 단계를 실행하는 데 주로 집중하므로, 일반적으로 더 빠른 모델이면 충분합니다.

이 기본 동작은 설계 단계에서는 느리고 신중한 접근 방식을, 구축 단계에서는 빠르고 효율적인 접근 방식을 제공하는 현명한 절충안입니다. 어떤 이유로든 다른 설정을 선호하는 경우 설정에서 자동 전환을 비활성화하고 각 모드에 대해 특정 모델을 수동으로 구성할 수 있습니다.

Gemini 2.5 Flash 및 Gemini 2.5 Flash-Lite와 같은 최신 모델은 이러한 균형을 더욱 개선하고 있습니다. 향상된 도구 사용 능력, 낮은 지연 시간, 그리고 개선된 지침 ​​준수 기능을 통해 토큰 사용량과 비용을 관리하면서 계획 단계를 더욱 안정적으로 실행할 수 있습니다.

세션 유지, 정리 및 사용자 지정 플랜 디렉터리

Gemini CLI는 개발 환경을 깔끔하게 유지하기 위해 세션 데이터와 관련 플랜 파일을 자동으로 관리합니다. 기본적으로 각 세션(계획 및 작업 추적기 포함)은 30일 동안 보존된 후 삭제됩니다.

/settings 명령어를 사용하거나 settings.json 파일을 직접 편집하여 보존 기간을 변경할 수 있습니다. "세션 보존" 설정을 찾아 필요에 따라 조정하세요. 장기 프로젝트의 경우 보존 기간을 길게 설정하는 것이 좋고, 단기 실험의 경우 보존 기간을 짧게 설정하는 것이 좋습니다.

자동 정리 기능 외에도 언제든지 수동으로 세션을 삭제할 수 있습니다. 명령줄에서 다음을 사용하세요. 제미니 -세션 삭제 특정 세션과 해당 세션의 흔적을 제거하려면 다음 명령을 사용하십시오. 또는 세션 브라우저를 여십시오. /요약인터페이스를 사용하여 탐색하고 누르세요. x 선택한 세션을 삭제합니다.

사용자 지정 계획 디렉터리를 구성한 경우 자동 삭제 기능이 해당 계획 파일을 삭제하지 않는다는 점에 유의해야 합니다. 해당 디렉토리는 사용자가 직접 관리해야 하는데, 이는 계획을 영구적인 문서로 취급하거나 코드와 함께 버전 관리 시스템에 저장하려는 경우에 장점이 될 수 있습니다.

이러한 접근 방식은 유연성을 제공합니다. 즉각적인 실행에만 관심이 있을 때는 단기 계획을 사용하고, 향후 참조 및 규정 준수를 위해 전략 계획을 체계적으로 정리한 아카이브를 유지할 수 있습니다.

플랜 모드를 사용한 비대화형 및 CI/CD 워크플로

계획 모드는 대화형 터미널 세션에만 사용되는 것이 아니라 스크립트 및 CI/CD 파이프라인과 같은 비대화형 환경에서도 잘 작동합니다. 이러한 시나리오에서 정책 엔진은 특정 계획 도구를 자동으로 승인하도록 구성되어 워크플로가 사용자 입력을 기다리며 중단되지 않습니다.

구체적으로, Gemini CLI는 비대화형 컨텍스트를 감지하면 enter_plan_mode 및 exit_plan_mode 도구를 자동으로 승인합니다. 즉, 파이프라인을 통해 프로그램 방식으로 계획을 트리거하고, Gemini가 계획을 생성한 다음, 수동 확인 대화 상자 없이 실행 단계로 넘어갈 수 있습니다.

비대화형 워크플로의 또 다른 중요한 차이점은 계획 모드가 완료되고 구현이 시작된 후에 발생하는 일입니다. CLI는 표준 기본 모드로 전환하는 대신 다른 모드로 전환합니다. YOLO 모드이는 대화형 도구 승인 단계에서 멈추지 않고 단계를 자동으로 실행하도록 설계되었습니다.

이러한 자동화 친화적인 동작 덕분에 계획부터 실행까지 전 과정을 스크립트로 자동화하는 워크플로우를 구축할 수 있습니다. 체계적인 계획 단계는 여전히 유용하지만, 계획이 준비되고 정책에 따라 승인되면 파이프라인은 기계적인 속도로 진행될 수 있습니다.

계획 모드 내에서 모델 조향

모델 조향 기능을 사용하면 Gemini가 조사 또는 계획 수립을 진행하는 동안 실시간으로 미세 조정을 할 수 있어 피드백 루프를 크게 강화하고 도움을 줄 수 있습니다. 모델 환각을 완화하다. 전체 과정이 완료될 때까지 기다리는 대신, 도구가 실행되는 동안 힌트나 수정 사항을 삽입할 수 있습니다.

"/plan Redis를 사용하여 새로운 알림 서비스를 구현하고 싶습니다."와 같은 프롬프트로 시작한다고 상상해 보세요. Gemini는 계획 모드로 진입하여 코드베이스를 스캔하고 디렉토리를 탐색하기 시작합니다. 도구가 호출하는 과정을 지켜보면서 (혹은 잘못된 경로를 표시하는 경우) "packages/common/queues에서 기존 Redis 설정을 확인하는 것을 잊지 마세요."와 같은 메시지를 입력할 수 있습니다.

스피너가 작동 중일 때에도 제미니는 그 단서를 현재 연구에 활용할 수 있습니다. 그러면 다음 단계에서 제안된 디렉토리를 검사하고 새 서비스가 있어야 할 위치를 조정하는 것을 볼 수 있습니다.

모델 조종은 초안 작성 단계에서도 마찬가지로 유용합니다. 초기 계획이 단순 큐 아키텍처에 가깝지만 발행/구독 패턴을 선호하는 경우, "이 서비스에는 단순 큐 대신 발행/구독 패턴을 사용합시다."라고 말할 수 있습니다. Gemini는 잠시 작업을 중단하고 설계를 재검토한 후, 사용자의 선호도에 맞춰 새로운 계획 초안 작성을 시작합니다.

조향 장치를 최대한 활용하려면 구체적으로 접근하고 조기에 개입하십시오. "src/utils에 있는 기존 Logger 클래스를 사용하세요" 또는 "이 모듈은 다음 달에 사용 중단될 예정입니다"와 같은 명확한 지침은 정적 코드 분석만으로는 파악하기 어려운 맥락을 제공합니다.

Conductor를 사용한 확장성과 복잡한 워크플로우

규모가 크거나 여러 단계를 거치는 프로젝트의 경우, Conductor 확장 프로그램은 계획 모드가 어떻게 고급 워크플로의 핵심이 될 수 있는지 보여줍니다. Conductor는 컨텍스트 기반 개발을 위해 설계되었으며, 복잡한 마이그레이션, 기능 출시 또는 리팩토링 과정을 안내하는 오케스트레이터 역할을 합니다.

Conductor는 플랜 모드를 활용하여 완전히 안전한 환경에서 포괄적인 비행 전 점검 및 심층적인 연구 과정을 실행할 수 있습니다. 큰 작업을 단계별로 나누고, ask_user 각 단계에서 중요한 결정을 검증하는 도구이며, 담당자가 상위 관리자의 승인 없이 성급하게 변경하지 않도록 보장합니다.

이 과정 전반에 걸쳐 Conductor는 계획 모드의 읽기 전용 원칙과 구조화된 계획을 활용하여 하위 작업과 세부 단계를 생성합니다. 각 점검 단계에서 가정을 확인하고, 누락된 정보를 수집하며, 전반적인 진행 방향을 업데이트하여 최종 구현이 철저하고 전략과 일치하도록 합니다.

`enter_plan_mode` 및 `exit_plan_mode`와 같은 도구를 사용하는 플랜 모드의 설계는 Conductor와 같은 솔루션이 그 위에 구축될 수 있도록 의도적으로 확장 가능하게 만들어졌습니다. 목표는 단순히 안전한 계획 수립 기능을 제공하는 것이 아니라, 사용자가 직접 맞춤 오케스트레이션 레이어와 개발 방법론을 구축하는 데 활용할 수 있는 기반을 마련하는 것입니다.

Gemini CLI 팀은 Conductor를 내장 모드로 핵심 환경에 더욱 가깝게 통합하여 계획, 오케스트레이션 및 실행 간의 경계를 더욱 모호하게 만드는 작업을 진행하고 있습니다. 이러한 방향성은 계획 모드가 구조화된 AI 지원 개발의 미래에 얼마나 중요한 역할을 하는지를 강조합니다.

전반적으로 Gemini CLI의 계획 모드는 단순한 안전 스위치 이상의 기능을 제공합니다. 읽기 전용 탐색, 풍부한 협업 기능, 사용자 정의 가능한 정책, 고도화된 추론 모델, 자동화 친화적인 동작이 조화롭게 어우러진 완벽한 계획 환경입니다. 차기 주요 기능 개발, 마이그레이션 또는 감사를 위해 이 방식을 도입하면 코드 변경이 적용되기 전에 생각하고, 질문하고, 반복할 수 있는 명확한 공간을 확보할 수 있으며, 궁극적으로 더 깔끔한 구현과 예상치 못한 문제 발생 감소로 이어집니다.