Planea, Audita, Construye

El error más común al usar Claude Code: pedirle algo, dejarlo trabajar 30 minutos, abrir lo que hizo y descubrir que no era lo que querías. La solución no es escribir prompts más largos — es usar Plan Mode como momento explícito de revisión antes de que Claude toque archivos. Sumado a auditoría de las herramientas que Claude recomienda y conexión con The Architect, All Deploy y Cyber Neo, transformás "tirar un prompt" en proceso productivo.

Esta nota cubre el ciclo de 3 fases (Planea, Audita, Construye), cuándo usar ultrathink, y cómo encadenar con las skills más potentes del ecosistema.

El problema de "tirar prompts"

Patrón típico que sale mal:

1. Usuario: "Implementame autenticación".
2. Claude empieza a codear inmediato.
3. 30 minutos después, hay 12 archivos creados, Drizzle config tocada, nuevas dependencias instaladas.
4. Usuario abre el resultado: "No, yo quería NextAuth, no esto custom".
5. Hay que hacer rollback parcial o aceptar pisar trabajo.

Costo: 30 minutos + tokens + frustración.

El ciclo correcto: las 3 fases

Fase 1: Planea

El comando es Shift+Tab (o el slash command /plan). Activás Plan Mode.

En Plan Mode, Claude no toca archivos. En su lugar:

1. Lee lo que necesite leer para entender (típico: archivos clave + package.json + CLAUDE.md).

2. Te propone plan estructurado:

   • Qué archivos va a crear/modificar.
   • Qué dependencias va a agregar.
   • Qué decisiones de arquitectura toma.
   • Riesgos identificados.
   • Order de ejecución.

3. Pregunta confirmación.

Hasta que vos digas "go", no toca nada.

Fase 2: Audita

Acá la mayoría se acelera y dice "go" sin leer. Mal movimiento. Lo correcto: auditá el plan.

Preguntas que tenés que hacerle al plan:

• ¿Las herramientas que recomienda son las apropiadas? Si te propone NextAuth pero vos preferís Clerk, hablalo antes.
• ¿Las dependencias nuevas tienen sentido? Cada npm install suma weight a tu proyecto.
• ¿La arquitectura propuesta encaja con lo existente? Si tu repo es monorepo y Claude propone instalar todo en root, mal.
• ¿Los riesgos están manejados? Si propone tocar el config de DB sin migración explícita, peligro.

Si algo no te cierra, en lugar de "go" decís:

> Antes de avanzar: ¿por qué elegiste NextAuth y no Clerk? Mi proyecto 
  ya tiene cuenta paga de Clerk. Reconsiderá el plan.

Claude ajusta. Itera hasta que el plan te convence.

Fase 3: Construye

Cuando el plan es sólido, decís "go" o salís de Plan Mode (Shift+Tab otra vez). Claude ejecuta.

Idealmente, el output cumple el plan acordado. Si algo se desvía sobre la marcha, Claude debería preguntar antes de improvisar (Plan Mode persiste esa actitud).

Cuándo usar Ultrathink

Plan Mode dispara Claude regular. Ultrathink dispara extended thinking — el modo donde Claude piensa más profundo antes de responder.

Cuándo prender Ultrathink + Plan Mode juntos:

• Decisiones de arquitectura grandes (microservicios vs. monolito, monorepo vs. polyrepo, DB choice).
• Refactors que afectan +20 archivos.
• Migraciones críticas (de Postgres a Cockroach, de Webpack a Vite, etc.).
• Diseño inicial de proyecto desde cero.

Cuándo NO:

• Bugs simples (Claude lo soluciona sin ultrathink).
• Features chicas (componentes, endpoints simples).
• Refactors de 1-3 archivos.

Cómo se activa: en claude.ai con toggle de extended thinking, en API con thinking: { type: "enabled" }.

Conexión con The Architect

The Architect es una skill (cubierta en otra nota) que se especializa en arquitectura — diseño de sistemas, decisiones de tecnología, escalabilidad.

Patrón potente:

1. Plan Mode + Ultrathink + The Architect activo.
2. Le pedís el diseño de un sistema entero.
3. Claude piensa profundo, consulta los patterns de The Architect, propone arquitectura completa con justificaciones.
4. Audit el plan (tiempo bien invertido).
5. Construís con el plan en mano (a veces dividís el construir en sub-sesiones).

Conexión con All Deploy

All Deploy es el skill que cierra el ciclo: cuando Claude termina código, All Deploy se encarga de llevarlo a producción.

Patrón:

1. Plan Mode → audita → construye.
2. Cuando el código está listo, invocás All Deploy.
3. All Deploy hace: tests automáticos, build de producción, deploy a Vercel/Railway/Fly según config, verificación post-deploy (smoke tests con Agent Browser).

Conexión con Cyber Neo

Cyber Neo (otra skill cubierta aparte) es para hardening de seguridad. Después de construir, antes de deployar:

1. Cyber Neo audita tu código nuevo.
2. Identifica: SQL injection patterns, XSS vectors, exposed secrets, dependencies vulnerables.
3. Te lista findings priorizados.

El ciclo extendido: Planea → Audita → Construye → Cyber Neo → All Deploy.

Ejemplo concreto: feature de billing

Pedido: "Agregame billing con Stripe para mi SaaS".

Sin el ciclo

Claude empieza:

• Instala stripe-node.
• Crea endpoint /api/checkout.
• Genera componente CheckoutButton.
• Te lo entrega.

Problemas que aparecen después:

• No considera webhooks (sin webhook, no sabés cuándo el pago se completó).
• No maneja seats/plans (todo asume single seat).
• No maneja tax (impuestos varían por país).
• No tiene retry logic para webhook failures.

Total: te tira el 30% de lo que necesitás. Refactor enorme.

Con el ciclo

Plan Mode + Ultrathink + The Architect:

> Plan mode + ultrathink + the-architect: necesito billing con Stripe
  para mi SaaS B2B. Plans: Starter $29, Pro $99, Business $299.
  Cobro mensual con anual opcional (20% off). Multi-seat. LatAm con
  impuestos locales. Webhooks para sync de status.

Claude piensa, propone plan que incluye:

1. Stripe Checkout (no embebido para simplificar PCI).
2. Stripe Tax para impuestos automáticos LatAm.
3. Webhooks: checkout.session.completed, customer.subscription.updated, invoice.payment_failed.
4. DB schema: tabla subscriptions con relación a users.
5. Componente <CheckoutButton plan={X}> que genera session via API.
6. Endpoint /api/billing/checkout y /api/billing/webhook.
7. Página /account/billing para gestión.
8. Cron job que reconcilia DB con Stripe cada noche.

Audit: revisás el plan. Te das cuenta que falta:

• Trial period (querés 14 días).
• Manejo de "subscription canceled but still has access until period end".

Decís: "Ajustá el plan incluyendo trial 14 días y access hasta period_end después de cancel".

Claude ajusta.

Build: "go". Claude ejecuta el plan acordado en orden. Tarda 25-40 minutos.

Cyber Neo audita: Tres findings:

• Webhook endpoint no valida signature de Stripe.
• API key de Stripe está en código en lugar de env var.
• No hay rate limiting en /api/billing/checkout.

Aplicás fixes (15 minutos).

All Deploy: corre tests, build, deploy a staging, smoke test, deploy a prod.

Total: ~1.5 horas, billing en producción que aguanta uso real.

Comparado con "tirar prompts": ~3 horas con bugs encontrados en producción 2 semanas después.

Errores comunes con Plan Mode

Error 1: aceptar sin leer

El plan está hecho para que lo leas. Si decís "go" en 5 segundos, perdés el valor de Plan Mode.

Error 2: usar Plan Mode para todo

Pedidos chicos (rename, fix de 3 líneas) no necesitan Plan Mode. Es overhead.

Error 3: no iterar el plan

El plan no es take-it-or-leave-it. Es iterativo. "Ajustá esto, cambiá esto otro". Vas a llegar a un plan mejor que cualquier prompt de un disparo.

Error 4: ultrathink siempre

Ultrathink gasta tokens. Para decisiones rutinarias, Plan Mode regular alcanza.

Conclusión

"Planea, audita, construye" no es opcional para tareas medianas o grandes. Es la diferencia entre Claude Code que te ahorra tiempo y Claude Code que te lo come en cleanup.

Las skills (The Architect, All Deploy, Cyber Neo) son aceleradores que hacen cada fase más rica. Pero el ciclo funciona también sin ellas — con Plan Mode default y disciplina propia.

Empezá hoy con la regla mínima: toda tarea que toca más de 3 archivos, Plan Mode primero. Sin excepciones.

Tags: plan-mode, claude-code, shift-tab, auditoria, ultrathink, the-architect, all-deploy