Estructura tu proyecto para que la IA pueda navegarlo

Los modelos de IA razonan sobre tu código leyéndolo. Un proyecto desordenado, disperso e inconsistente es tan difícil para ellos como lo es para ti. No necesitas una arquitectura perfecta, pero unos pocos hábitos dan resultado de inmediato:

• Mantén una estructura predecible. El código fuente en un lugar, las pruebas junto al código fuente o reflejando su estructura, la configuración en la raíz.
• Usa nombres claros y descriptivos. calculateMonthlyInvoiceTotal es mejor que calc2. La IA usa los nombres como pistas.
• Prefiere archivos más pequeños. Un archivo de 200 líneas es más fácil de cambiar correctamente que uno de 2.000, tanto para ti como para la IA.
• Agrupa lo relacionado. Cuando el código, los estilos y las pruebas de una función viven juntos, la IA reúne el contexto en una sola lectura.
• Mantén un punto de entrada claro. Un único lugar evidente donde comienza la aplicación le da a la IA un hilo del que tirar cuando está mapeando el proyecto.

Una estructura típica y amigable para la IA podría verse así:

my-app/
├── AGENTS.md            # project rules & context for the AI
├── README.md            # what the project is, how to run it
├── .env.example         # documents needed secrets (no real values)
├── .gitignore           # excludes .env, build output, node_modules
├── package.json         # scripts: dev, test, lint, build
├── src/
│   ├── features/
│   │   └── invoices/    # code + tests for one feature, together
│   ├── lib/             # shared helpers
│   └── index.ts         # entry point
└── tests/               # cross-cutting / integration tests

El beneficio se acumula: cuanto más fácil sea navegar tu proyecto para la IA, más pequeños y quirúrgicos se vuelven sus cambios. Un repositorio bien organizado le permite a la IA tocar tres archivos relevantes en lugar de andar adivinando entre treinta, lo que se traduce en diferencias (diffs) más pequeñas, menos accidentes y revisiones que realmente puedes leer. Si alguna vez ves que la IA hace ediciones amplias y sin foco, la estructura suele ser la verdadera culpable, no el prompt.