Lección 47 de 61 · Módulo 06: 15/16
Técnico Nivel · intermedio

Errores de setup que cuestan horas

Por qué te debe importar

Hay setup decisions que toman 15 minutos al inicio y ahorran 10 horas a lo largo del proyecto. Y otras que toman 2 horas pero se arrastran como deuda. Conocer la diferencia antes de empezar es el trabajo del módulo setup.

Idea central

Errores tempranos no se sienten costosos porque son invisibles; se sienten al mes 3 cuando el proyecto pesa.

Los errores que más cuestan

1. No tener CLAUDE.md al inicio

Cada sesión del agente re-explica el proyecto. Costo: 20–40% más tokens, menos consistencia. Fix: 30 min al inicio, ganancia continua.

2. RLS desactivada "por ahora"

"Ya lo activo cuando termine." Al mes 2, descubrir que la app tiene data leak. Fix: política for all using (false) desde minuto 0; abre acceso por policy cuando tengas caso.

3. Ignorar TypeScript errors

El agente deja warnings "para después". Al mes 1, son 200. Debug es imposible. Fix: política "no se cierra PR con warnings nuevos".

4. Dependencias sin auditar

El agente instala npm packages libremente. Al mes 2, lockfile tiene 800 deps. Fix: skill "no agregar deps sin aprobación explícita".

5. No versionar specs/

Los specs viven en Notion, el código en repo. Drift inmediato. Fix: specs/ en repo, versionado con código.

6. Cambiar el stack en semana 3

"Quizás Next.js sería mejor." Costo: reset. Fix: definir stack, comprometerse, no cambiar antes de 3 meses de uso real.

La regla general

Los errores de setup son baratos en tiempo y caros en impacto. Invierte los 30 minutos iniciales. El futuro tú agradece.

Ejemplos en escalera
✓ Checkpoint

Revisa los 6 errores. ¿Cuáles has cometido o estás cometiendo? El que más te duele, arreglo esta semana.

Resumen — tres cosas que deberías recordar
  1. Errores de setup son invisibles al inicio, caros al mes 3.
  2. Los seis: sin CLAUDE.md, sin RLS, TS warnings ignorados, deps sin auditar, specs fuera de repo, stack churn.
  3. 30 minutos al inicio = horas ahorradas continuamente.
Qué sigue
Lección 48 · Setup y prompt Estructura del repo desde el inicio para sesiones largas → Continuar