Claude te da planos falsos: deja de delegar la arquitectura

Un desarrollador descubrió que Claude le había generado una estructura de proyecto que funcionaba en apariencia, pero que ocultaba una arquitectura insostenible: dependencias cíclicas, lógica duplicada y una escalabilidad nula. El asistente no detectó el problema porque nunca se le pidió que lo hiciera.

Por qué importa

Cuando delegas decisiones arquitectónicas a una IA, estás subcontratando tu criterio a un modelo que optimiza para parecer correcto, no para ser correcto. Claude no distingue entre una solución que compila y una que es mantenible a largo plazo.

Para equipos pequeños o startups, la tentación de dejar que la IA "diseñe" es enorme. Pero el coste diferido —deuda técnica, bugs difíciles de rastrear, refactorizaciones completas— puede superar cualquier ganancia inicial de velocidad.

Qué dice el contexto

• Claude genera código que pasa pruebas unitarias pero falla en integración o escalabilidad.
• El modelo no tiene conciencia del contexto completo del proyecto: ignora restricciones de negocio, patrones existentes y trade-offs arquitectónicos.
• Los errores más comunes son: acoplamiento excesivo, falta de abstracción, y soluciones que funcionan para un caso pero fallan en el borde.
• La IA no "entiende" la arquitectura: reproduce patrones estadísticos de su entrenamiento, que incluyen tanto buenas como malas prácticas.
• Herramientas como Claude pueden sugerir microservicios donde un monolito bastaría, o viceversa, sin justificación real.

Lo que puedes hacer

1. Usa la IA solo para tareas tácticas, no estratégicas. Pídele que genere una función específica o que refactorice un fragmento, nunca que decida la estructura del proyecto.
2. Exige que la IA justifique sus decisiones. Pregúntale "¿qué alternativas existen?" y "¿cuál es el coste de esta elección?" para forzarla a mostrar sus limitaciones.