들어가며: AI 코딩 에이전트의 '무분별한 수정' 문제
요즘 AI 코딩 어시스턴트가 대세죠. 하지만 막상 써보면 "AI가 내 코드를 마음대로 고쳐버렸어요!" 같은 경험, 한 번쯤 있으실 거예요. 특히 레거시 프로젝트나 대규모 리팩토링할 때, AI가 예상치 못한 파일을 수정해서 난감했던 적, 저도 많았습니다. 😅
이 문제의 근본 원인은 '분석'과 '실행'이 분리되지 않았다는 점이에요. AI가 요청을 받자마자 바로 코드를 수정하려고 하니까, 의도치 않은 사이드 이펙트가 발생하는 거죠.
구글이 이 문제를 정면돌파한 기능, 바로 Gemini CLI의 'Plan Mode' 입니다. 이 글에서는 Plan Mode가 무엇인지, 어떻게 사용하는지, 그리고 실무에서 어떤 점을 주의해야 하는지 자세히 알려드릴게요.
Plan Mode란? (Read-Only 분석 모드)
Plan Mode는 Gemini CLI의 읽기 전용(Read-Only) 모드입니다. 핵심은 간단해요. "일단 분석부터 하자!"
기존에는 AI에게 "이 데이터베이스를 마이그레이션해줘"라고 하면 바로 코드를 수정하기 시작했죠. 하지만 Plan Mode에서는 이렇게 작동합니다:
- 분석 우선: 코드베이스를 탐색하고, 의존성을 파악하며, 변경 계획을 수립합니다.
- 사용자 확인: AI가 계획을 제안하고, 당신이 검토하고 승인합니다.
- 실행: 승인된 계획에 따라서만 실제 코드 수정이 이루어집니다.
# Plan Mode 진입 방법 (3가지)
# 1. 입력창에 /plan 입력
# 2. Shift+Tab 으로 승인 모드 순환
# 3. AI에게 직접 "start a plan for..." 요청
# 예: 데이터베이스 마이그레이션 계획 요청
gemini> research how to migrate this database from MySQL to PostgreSQL
# AI가 분석을 시작하고, 아래와 같은 질문을 할 수 있음
# "마이그레이션 중 다운타임을 허용하시나요?"
# "기존 데이터 크기는 얼마인가요?"
Plan Mode에서 사용되는 주요 도구는 다음과 같습니다:
read_file: 파일 내용 읽기grep_search: 패턴 검색glob: 파일 경로 패턴 매칭codebase_investigator: 복잡한 시스템 의존성 분석ask_user: 사용자에게 직접 질문 (이게 핵심!)
실무 적용 포인트와 주의사항
1. ask_user 도구의 중요성
Plan Mode의 가장 강력한 기능은 AI가 모르는 것을 인정하고 질문한다는 점입니다. 기존 AI 도구들은 추측하거나 기본값을 가정했지만, Plan Mode는 ask_user를 통해:
- 특정 아키텍처 선택에 대한 확인
- 숨겨진 설정 파일의 위치
- 비즈니스 로직의 의도
이런 것들을 직접 물어봅니다. 이는 개발자의 의도를 존중하는 첫걸음이라고 볼 수 있어요.
2. Conductor와의 연계 (고급 기능)
더 복잡한 프로젝트를 다룰 때는 Conductor 확장 기능을 사용할 수 있습니다. Conductor는 Plan Mode를 기반으로 멀티스텝 개발 워크플로우를 오케스트레이션합니다.
예를 들어, 대규모 마이그레이션 프로젝트의 경우:
- 1단계: 사전 검사 및 위험 분석 (Plan Mode)
- 2단계: 각 마일스톤별 확인 (ask_user)
- 3단계: 점진적 실행
이런 식으로 진행됩니다. 아직 Gemini CLI에 내장되지는 않았지만, 곧 기본 모드로 통합될 예정이라고 하니 기대해도 좋을 것 같습니다.
3. 국내 개발 환경에서의 적용 맥락
한국 SI/스타트업 환경에서는 이 기능이 특히 유용할 수 있어요. 이유는:
- 레거시 코드가 많은 환경: 함부로 수정했다가 사이드 이펙트 발생 위험이 큼
- 협업이 중요한 조직: Plan Mode에서 생성된 계획을 팀 리뷰에 활용 가능
- 규제 준수 필요성: 금융/공공 프로젝트에서 '변경 이력'과 '사전 승인' 프로세스에 부합
다만, Plan Mode가 완벽한 것은 아닙니다. 다음과 같은 한계를 인지해야 해요:
- 분석 시간이 오래 걸림: 대규모 프로젝트에서는 초기 분석에 시간이 소요됨
- 질문이 너무 많을 수 있음:
ask_user가 너무 자주 호출되면 오히려 생산성 저하 - 모델 의존성: 높은 추론 능력을 가진 Pro 모델에서 더 정확한 계획 수립 가능
결론: 당신의 워크플로우에 Plan Mode를 통합하는 법
Gemini CLI의 Plan Mode는 AI 코딩 에이전트의 성숙도를 한 단계 끌어올린 기능입니다. 단순히 '코드를 빨리 짜주는 도구'에서 '함께 고민하고 설계하는 파트너'로 진화한 거죠.
바로 적용할 수 있는 팁:
- 새로운 기능을 개발할 때는
/plan으로 시작해보세요. - AI가 제안한 계획을 팀원들과 공유해보세요. 코드 리뷰 시간이 단축될 거예요.
ask_user질문에 성실히 답변할수록 더 좋은 결과를 얻을 수 있습니다.
Plan Mode가 마음에 들지 않는다면 /settings에서 쉽게 비활성화할 수 있으니, 부담 없이 사용해보세요. (설정에서 'Plan' 검색 후 토글)
AI와 함께 일하는 방식을 고민하고 있다면, 지금 바로 Plan Mode를 사용해보시길 추천합니다. 다음 단계로는 Conductor 확장 기능과의 연계를 살펴보시면 더 깊이 있는 워크플로우를 구축할 수 있을 거예요.