La IA no entiende tu código porque sea complejo. No lo entiende porque está desordenado.

He probado Claude Code en proyectos bien estructurados vs proyectos caóticos. La diferencia es brutal.

Un https://CLAUDE.md en la raíz con el contexto del proyecto, una carpeta docs/ con decisiones técnicas y un directorio de prompts reutilizables cambian todo.

No es sobre tener la carpeta perfecta. Es sobre que la IA sepa dónde está cada cosa sin que se lo expliques en cada prompt.

Organizar tu proyecto para que lo entienda un agente de IA es lo mismo que organizarlo para que lo entienda un developer nuevo. Buen código es buen código, con o sin IA.

Antes de buscar el prompt perfecto, ordena tu proyecto.