El mapa del proyecto: qué archivo hace qué y dónde está la configuración

Todo proyecto tiene la misma forma

Cambian los nombres, no la lógica. Un proyecto generado por IA casi siempre separa: lo que se ve (frontend), lo que se procesa (backend/lógica), lo que se guarda (datos), lo que se ajusta (configuración) y lo que se pide prestado (dependencias). Si sabes en qué cajón vive cada comportamiento, señalas la ruta correcta en vez de describir síntomas.

Los cinco cajones del proyecto

Presentación
frontend: páginas, componentes, estilos.
Lógica
backend: rutas, reglas, servicios.
Datos
bases de datos, modelos, migraciones.
Configuración
ajustes del entorno, secretos, parámetros.
Dependencias
código de terceros que pediste prestado.

Un mapa real, leído en voz alta

Cada cajón responde una pregunta distinta

bash

mi-crm/\n├── public/            # lo que el navegador descarga (html, css, js)\n│   └── index.html\n├── src/\n│   ├── routes/        # backend: QUÉ endpoints existen (GET /contactos)\n│   ├── services/      # lógica de negocio: CÓMO se valida y calcula\n│   └── models/        # datos: QUÉ forma tienen contacto, empresa, venta\n├── config/            # parámetros: a DÓNDE se conecta (base de datos, APIs)\n├── .env               # SECRETOS: credenciales que NUNCA se suben al repo\n├── package.json       # dependencias: QUÉ paquetes prestados se usan\n└── README.md          # el manual: para qué sirve y cómo arranca

Cuando pidas un cambio, primero decide qué pregunta estás contestando: ¿se ve (public), se procesa (routes/services), se guarda (models), se configura (config/.env)? Con eso, señalas la carpeta.

Para reforzar

Dónde vive cada cambio

Nombrar el archivo en tu prompt no es tecnicismo: es impedir que la IA reintervenga lo estable.
Quieres…	Cajón correcto	No tocarías…
Cambiar un color del botón	frontend (public/src)	los models ni el .env
Agregar un campo «empresa» al contacto	datos (models) + backend (routes)	los estilos
Mover la app a otra base de datos	configuración (config / .env)	la lógica de services
Cambiar el mensaje de error al guardar	lógica (services)	las dependencias

Prueba

Quieres que el teléfono se guarde sin espacios ni guiones. ¿En qué cajón debe vivir el cambio?

Un archivo .env suele contener contraseñas y claves, por eso no debe subirse al repositorio ni compartirse con la IA sin limpiar.

Detecta el cambio fuera de lugar

Pediste «validar que el email tenga formato correcto». La IA tocó cuatro puntos. Señala el cambio mal ubicado que no aporta la validación:

Marca la línea o las líneas con error y pulsa Comprobar.

Pide a la IA el árbol de carpetas de tu proyecto (solo nombres, no contenido). Asigna con una palabra qué hace cada carpeta. La próxima orden que des, señala el cajón exacto.

Un mapa claro en la cabeza se convierte en prompts que la IA no puede malinterpretar.

Tu texto se guarda sólo en este dispositivo.