Guia: Que Modo Usar

Despues de usar Claude Code por meses, estas son las reglas que sigo para elegir el modo correcto sin pensar.

El Flowchart de Decision

┌─────────────────────────────────────────────────────┐
│        ¿Que tipo de tarea vas a hacer?              │
└─────────────────────────────────────────────────────┘
                        │
         ┌──────────────┼──────────────┐
         │              │              │
         ▼              ▼              ▼
   ┌──────────┐  ┌──────────┐  ┌──────────┐
   │  EXPLORAR │  │ EJECUTAR │  │ PLANEAR  │
   │  DEBUGEAR │  │ FEATURE  │  │ REFACTOR │
   └──────────┘  └──────────┘  └──────────┘
         │              │              │
         ▼              ▼              ▼
   ┌──────────┐  ┌──────────┐  ┌──────────┐
   │  DEFAULT │  │   AUTO   │  │   PLAN   │
   │   MODE   │  │   MODE   │  │   MODE   │
   └──────────┘  └──────────┘  └──────────┘

Reglas Simples

Usa DEFAULT Mode Cuando:

Situacion	Por Que
Debuggeando un error	Necesitas ver cada paso
Explorando codigo nuevo	Queres entender antes de cambiar
Preguntando sobre el codigo	No va a modificar nada
Fix puntual (1-2 archivos)	Control total sobre cambios
No estas seguro que hacer	Empeza conservador

Resumen: Cuando queres CONTROL paso a paso.

Usa AUTO Mode Cuando:

Situacion	Por Que
Feature nueva clara	Scope definido, dejalo trabajar
Boilerplate repetitivo	No necesitas aprobar cada archivo
Refactors simples	Rename, mover archivos
Ya tenes feature branch	Podes revertir facil
Generacion de tests	Tests son seguros de generar

Resumen: Cuando queres VELOCIDAD y el scope es claro.

Usa PLAN Mode Cuando:

Situacion	Por Que
Feature compleja	Necesitas un plan antes de codear
Cambio que toca muchos archivos	Queres ver el scope primero
No sabes como implementar	Claude te propone opciones
Decisiones de arquitectura	Evaluas antes de comprometerte
PRD o requirements nuevos	Planea la implementacion

Resumen: Cuando queres ESTRATEGIA antes de accion.

Tabla de Referencia Rapida

Tarea	Modo	Razon
"¿Por que falla este test?"	Default	Exploracion
"Arregla el bug en login"	Default	Fix puntual
"Crea un nuevo componente Button"	Auto	Feature clara
"Agrega tests para todos los utils"	Auto	Boilerplate
"Refactoriza el modulo de auth"	Plan	Cambio grande
"Implementa el nuevo checkout"	Plan	Feature compleja
"¿Que hace esta funcion?"	Default	Pregunta
"Renombra User a Account en todo"	Auto	Refactor simple
"Actualiza las dependencias"	Default	Riesgo de romper
"Crea la API de productos"	Plan	Multiple archivos

Errores Comunes Por Modo

Errores en Default Mode

Error: Aprobar cada cambio sin leer.

Consecuencia: Pasan bugs que hubieras visto.

Solucion: Si vas a aprobar todo sin leer, mejor usa Auto mode con branch.

Errores en Auto Mode

Error: Usarlo en main o sin branch.

Consecuencia: Cambios que no podes revertir facil.

Solucion: SIEMPRE git checkout -b feature/x antes de Auto mode.

Errores en Plan Mode

Error: No revisar el plan antes de ejecutar.

Consecuencia: Claude implementa algo que no querias.

Solucion: Lee el plan completo. Hace preguntas si algo no es claro.

Mi Workflow Diario

# 1. Empiezo el dia, exploro que hay que hacer
claude                        # Default mode
> "¿Que issues hay abiertos?"
 
# 2. Elijo una feature compleja
> Shift+Tab                   # Cambio a Plan mode
> "Implementa el sistema de notificaciones segun el PRD"
> [Reviso el plan, ajusto si es necesario]
> "Ejecuta el plan"
 
# 3. Feature simple o boilerplate
git checkout -b feature/add-tests
> Shift+Tab                   # Cambio a Auto mode
> "Agrega tests para todos los componentes en /components"
 
# 4. Bug report llega
git checkout main
claude                        # Default mode
> "El login falla cuando el email tiene +. Investiga y arregla"

Cambiar de Modo Sin Reiniciar

Usa Shift + Tab para ciclar entre modos sin cerrar Claude:

Default → Auto → Plan → Default → ...

El indicador en la terminal te muestra el modo actual.

Cuando Rompo Mis Propias Reglas

Auto Mode para Debugging

A veces uso Auto mode para debugging cuando:

El bug es claro y puntual
Estoy en feature branch
Confio en que Claude sabe arreglarlo

Plan Mode para Features Simples

A veces uso Plan mode para features simples cuando:

Quiero documentar la decision
Voy a compartir el approach con el equipo
No estoy 100% seguro del approach

Las reglas son guias, no leyes.

Desafio: Prueba Esto

Para la proxima semana, lleva un registro:

Tarea	Modo Usado	¿Funciono?
...	...	Si/No

Despues de 10 tareas, vas a tener tu propia intuicion de que modo usar.

Para Team Leads: Establecer Politicas de Modo

Si lideras un equipo, establece reglas claras:

Template de Politica de Modos

# Politica de Modos - [Tu Equipo]
 
## Auto Mode
- ✅ Permitido: Feature branches, tests, boilerplate
- ❌ Prohibido: Main/master, codigo de pagos, datos de usuarios
 
## Plan Mode Obligatorio
- Features que tocan auth, payments, o PII
- Cambios que afectan >5 archivos
- Cualquier migracion de base de datos
- Integraciones con servicios externos
 
## Documentacion
- Todo plan se pega en la descripcion del PR
- Desviaciones del plan se documentan explicitamente

Beneficios Para el Equipo

Beneficio	Como
Menos PRs rotos	Plan Mode fuerza pensar antes
Code review mas facil	Plan como documentacion
Onboarding mas rapido	Nuevos devs ven el proceso
Menos rollbacks	Auto Mode solo en branches

Resumen

Default: Control, debugging, exploracion
Auto: Velocidad, features claras, boilerplate
Plan: Estrategia, features complejas, arquitectura

En la duda, empieza con Default. Siempre podes cambiar.

Siguiente Paso

Ahora que sabes que modo usar, vamos a profundizar en como mantener la memoria entre sesiones con CLAUDE.md.

Developers