Da contexto antes de dar la tarea
La IA no puede ver tu proyecto como tú lo ves. No conoce la versión de tu (marco de trabajo), la estructura de tus archivos, ni las convenciones que ya has establecido. Cuando te saltas esto, ella adivina, y adivina mal. Peor aún, adivina con confianza, así que el resultado parece plausible hasta que choca con tu código real.
Compara estos dos prompts para la misma petición.
Add a function to validate emails.
This is a TypeScript backend using Express and Zod for validation.
We already validate inputs with Zod schemas in src/schemas/.
Add an email validation schema in that style. Emails must be
lowercase, max 254 chars, and reject disposable domains from
the existing BLOCKED_DOMAINS list in src/config.ts.
El primer produce código genérico que puede usar una expresión regular que no quieres, con un estilo que no coincide con tu código base. El segundo produce código que puedes pegar directamente. La regla: indica el stack (conjunto de tecnologías), las convenciones y las piezas existentes que la IA debe reutilizar.
Un buen prompt apila estas piezas en orden, de abajo hacia arriba: el contexto en la base, la petición real cerca de la cima:
┌──────────────────────────────┐
│ EXAMPLES │ one input → output
├──────────────────────────────┤
│ CONSTRAINTS │ what NOT to do
├──────────────────────────────┤
│ EDGE CASES │ empty, invalid, errors
├──────────────────────────────┤
│ INPUTS / OUTPUTS │ types and shapes
├──────────────────────────────┤
│ GOAL │ one clear task
├──────────────────────────────┤
│ CONTEXT │ stack, files, patterns
└──────────────────────────────┘
foundation first ▲
Una lista de verificación mental útil antes de darle a enter: el lenguaje y el framework (con la versión, si importa), los archivos o módulos relevantes, los patrones ya presentes en el proyecto, y cualquier biblioteca que la IA deba preferir o evitar. No necesitas los cuatro puntos siempre, pero si la respuesta cambiaría según alguno de ellos, nómbralo. Ante la duda, pega la firma, el tipo o la configuración reales contra los que el código nuevo debe encajar. Unas pocas líneas de código existente le enseñan a la IA más sobre tus convenciones de lo que jamás lograría un párrafo de descripción.