Plan mode en Gemini CLI: planifica antes de codificar

¿Qué es el plan mode de Gemini CLI y por qué importa?

Si alguna vez has visto cómo un agente de IA modifica archivos en tu repositorio sin que tú lo esperaras, sabes exactamente de qué estamos hablando. Google acaba de resolver uno de los mayores puntos de fricción en el desarrollo asistido por IA: lanzó oficialmente el plan mode para Gemini CLI, disponible por defecto para todos los usuarios desde el 11 de marzo de 2026.

La propuesta es directa: antes de tocar una sola línea de código, el agente entra en un entorno de solo lectura donde puede explorar, analizar y planificar. Sin cambios, sin efectos secundarios, sin sorpresas. Solo pensamiento estratégico antes de la ejecución.

Para founders y equipos técnicos que ya usan IA en su flujo de desarrollo, esto no es un detalle menor. Es un cambio de paradigma.

👥 ¿Quieres ir más allá de la noticia?

En nuestra comunidad discutimos las tendencias, compartimos oportunidades y nos ayudamos entre emprendedores. Sin humo, solo acción.

👥 Unirme a la comunidad

Plan mode: cómo funciona por dentro

El plan mode de Gemini CLI restringe al agente a un subconjunto específico de herramientas de solo lectura: read_file, grep_search y glob. Con estas herramientas, el agente puede recorrer tu codebase, identificar patrones, leer documentación interna y mapear arquitecturas completas, todo sin escribir ni modificar nada.

El flujo de trabajo tiene tres fases bien definidas:

Investigación segura: el agente analiza la solicitud, navega el repositorio y valida sus supuestos con datos reales del código.
Refinamiento conversacional: propone estrategias de forma iterativa, hace preguntas para afinar los requisitos y construye un plan editable contigo.
Aprobación para implementación: solo cuando el plan está validado y aprobado por ti, el agente pasa al modo de ejecución.

Esta separación entre planificación y acción es, en esencia, la diferencia entre un copiloto que piensa antes de actuar y uno que actúa antes de pensar.

Cómo activar y desactivar el plan mode

La buena noticia es que plan mode está habilitado por defecto desde la versión estable de marzo de 2026. Pero tienes múltiples formas de controlarlo según tu flujo de trabajo:

Escribe /plan directamente en la terminal para activarlo en cualquier momento.
Usa Shift+Tab para ciclar entre modos durante una sesión activa.
Lanza Gemini CLI con el flag gemini --approval-mode=plan para forzarlo desde el inicio.
Configura el modo por defecto desde /settings → Default Approval Mode → Plan.

Para iterar sobre el plan antes de aprobarlo, puedes editarlo con Ctrl+X en tu editor externo preferido (VS Code, Vim, etc.), agregar comentarios o simplemente presionar Esc para cancelar y redirigir.

Herramientas MCP: contexto más allá del repositorio

Una de las integraciones más potentes del plan mode es su compatibilidad con herramientas MCP (Model Control Protocol). Estas extensiones permiten que Gemini CLI obtenga contexto externo al repositorio: bases de datos, documentación externa, resultados de pruebas, o incluso servidores en background como el MCP Playwright server para debugging.

Las configuraciones MCP se cargan en paralelo para minimizar el tiempo de inicio, y los administradores de equipo pueden definir qué configuraciones están permitidas. Esto convierte a Gemini CLI en algo más que un analizador de código: es un agente con acceso a contexto real de negocio durante la fase de planificación.

Para un founder técnico que gestiona un producto con múltiples integraciones, esto significa que el plan que genera la IA no vive en el vacío: está informado por el entorno completo donde ese código va a correr.

ask_user y Conductor: los agentes que orquestan la complejidad

Dos componentes merecen atención especial en este ecosistema:

El agente ask_user

Durante la fase de planificación, ask_user actúa como el mecanismo de afinación de requisitos. En lugar de asumir intenciones, el agente formula preguntas específicas para clarificar metas ambiguas. ¿Debería usar el logger existente o crear uno nuevo? ¿La migración debe ser reversible? ¿El nuevo módulo necesita soporte legacy? Estas conversaciones ocurren antes de que se escriba una sola línea, lo que reduce dramáticamente el retrabajo posterior.

Conductor

Conductor es la extensión diseñada para gestionar flujos de trabajo complejos y multi-paso. Funciona con subagentes especializados, como codebase_investigator, que se encargan de tareas específicas dentro de un plan más amplio. Conductor orquesta estos subagentes, maneja dependencias entre tareas y adapta el plan en función del feedback recibido en cada iteración. Es especialmente útil cuando un proyecto involucra múltiples capas: backend, frontend, infraestructura y documentación, todo en un mismo ciclo de planificación.

Casos de uso reales: cuándo usar plan mode

El plan mode no es para todos los cambios; es para los cambios que importan. Aquí los escenarios donde su valor es máximo:

Migraciones de base de datos

Uno de los ejemplos documentados por el propio Google Developers Blog es el comando /plan seguido de «Research how to migrate this database». El agente mapea dependencias, identifica tablas relacionadas, detecta posibles conflictos y propone una secuencia de pasos antes de ejecutar cualquier cambio. Para equipos que han sufrido una migración mal planificada en producción, esto es oro.

Auditorías de código

Usando grep_search y glob, el agente puede recorrer un repositorio completo en busca de patrones de seguridad, deuda técnica o inconsistencias de nomenclatura. Todo en modo lectura, sin riesgo de alterar nada durante el análisis.

Planificación de nuevas features

Antes de implementar una funcionalidad nueva, el agente analiza cómo el código existente estructuraría esa feature, identifica componentes reutilizables y propone una arquitectura coherente con el estilo actual del proyecto. El resultado es un plan que cualquier miembro del equipo puede revisar, editar y aprobar.

Modelos de IA y rendimiento

Desde la versión v0.29.0 (lanzada el 17 de febrero de 2026), Gemini CLI utiliza Gemini 3.1 Pro como modelo base para las tareas de razonamiento complejo dentro del plan mode. Este modelo ya no está detrás de un flag de preview: es el comportamiento predeterminado para todos los usuarios. La elección de un modelo de mayor capacidad para la fase de planificación no es casual; el análisis arquitectónico y la generación de planes coherentes requieren más razonamiento que la edición de código línea a línea.

Gemini CLI vs. otras herramientas del mercado

Vale la pena contextualizar dónde se para plan mode de Gemini CLI frente a otras herramientas que los equipos técnicos ya usan:

Claude CLI: la separación entre planificación y ejecución ha sido un pedido recurrente de la comunidad (visible en discusiones de GitHub), pero no está implementada de forma nativa con el nivel de integración que ofrece Gemini.
GitHub Copilot / Cursor: están optimizados para sugerencias inline dentro del editor. Gemini CLI apunta a algo distinto: mapeo arquitectónico completo desde la terminal, con hooks, skills y MCP para customización profunda.
Aider: tiene modos similares de confirmación antes de ejecutar, pero carece de la integración con subagentes especializados y el ecosistema de herramientas MCP de Gemini.

La ventaja competitiva de Google aquí es la combinación de seguridad por defecto, modelos de última generación y un ecosistema de integraciones que ya existe en muchos stacks técnicos de startups.

Conclusión

El plan mode de Gemini CLI es una de esas funcionalidades que parece simple en la superficie, pero que cambia profundamente cómo un equipo técnico interactúa con la IA. Separar la fase de análisis y planificación de la fase de ejecución no es solo una medida de seguridad; es una forma de elevar la calidad del razonamiento antes de comprometerse con una dirección.

Para founders y CTOs que están incorporando IA en sus flujos de desarrollo, el mensaje es claro: la IA más útil no es la que actúa más rápido, sino la que piensa mejor antes de actuar. Gemini CLI con plan mode disponible por defecto desde el 11 de marzo de 2026 es un paso concreto en esa dirección.

Si tu equipo trabaja con migraciones críticas, auditorías de código o arquitecturas complejas, vale la pena dedicar una hora esta semana a probar este flujo. El costo de una mala decisión en producción siempre supera el tiempo invertido en planificar bien.

Descubre cómo otros founders implementan herramientas como Gemini CLI en sus stacks técnicos. Únete gratis a la comunidad de Ecosistema Startup y aprende con quienes ya están construyendo con IA.

Aprender con founders