Prompt Engineering para Código

El prompt engineering es el arte de comunicarse efectivamente con una IA. Imagina que contratas a un consultor brillante que sabe de todo, pero que literalmente solo puede hacer lo que le dices —si tu instrucción es vaga, el resultado será mediocre.

La diferencia entre "escribe código de login" y un prompt detallado con requisitos, lenguaje, librerías y formato de respuesta puede ser la diferencia entre código inútil y código production-ready.

Existen técnicas probadas: Role Prompting (dile a la IA qué experto debe ser), Few-Shot (muéstrale 2-3 ejemplos del formato que esperas), Chain of Thought (pídele que piense paso a paso antes de responder) y Zero-Shot (descripción directa sin ejemplos). Para código, siempre incluye el lenguaje/framework, las librerías permitidas, el formato de salida (¿quieres tipos TypeScript?), y restricciones (¿sin dependencias externas?). Un buen prompt tarda 2 minutos en escribir y ahorra 20 minutos de iteración.

// Técnicas de Prompt Engineering para devs

// ❌ Prompt vago:
// "Escribe una función de login"

// ✅ Prompt detallado:
const promptDetallado = `
Escribe una función de login en Node.js que:
- Reciba email y password como parámetros
- Valide el email con regex
- Verifique el hash de la contraseña con bcrypt
- Devuelva un JWT con { userId, email, role }
- Maneje errores con mensajes específicos
- Incluya tipos TypeScript
Usa las librerías: jsonwebtoken, bcryptjs
`;

// Técnica: Role prompting
const rolPrompt = `
Actúa como un experto en seguridad web.
Revisa este código de autenticación y señala vulnerabilidades:
\`\`\`javascript
${codigoARevisar}
\`\`\`
`;

// Técnica: Few-shot (dar ejemplos)
const fewShotPrompt = `
Convierte estos errores al formato de mi app:

Entrada: "TypeError: Cannot read property 'name' of undefined"
Salida: { code: "NULL_REFERENCE", mensaje: "El objeto no existe", severidad: "error" }

Entrada: "Network timeout after 30s"
Salida: { code: "TIMEOUT", mensaje: "La operación tardó demasiado", severidad: "warning" }

Ahora convierte: "ECONNREFUSED 127.0.0.1:5432"
`;

// Técnica: Chain of Thought (paso a paso)
const chainOfThought = `
Necesito optimizar esta consulta SQL que tarda 10 segundos.
Piensa paso a paso:
1. Analiza la consulta actual
2. Identifica cuellos de botella
3. Propón índices necesarios
4. Reescribe la consulta optimizada

Consulta: ${miQuery}
`;