Prompt engineering para desarrolladores: técnicas para código, refactor y tests unitarios

La IA y los LLMs (Claude, GPT-4, Gemini) han cambiado la ingeniería de software. Ya no es solo autocomplete: es un pair programmer para arquitectura, profiling y tests unitarios. La calidad del código es proporcional a la claridad del prompt. Un prompt vago da boilerplate genérico, alucinaciones y bugs sutiles de runtime.

Para usar LLMs de verdad en el día a día hay que pasar del chat suelto al prompt engineering estructurado. Técnicas y estructuras de prompt que puede meter ya en el workflow.

1. Anatomía de un prompt de código de calidad

Cuando pida código a un LLM, un prompt que funciona tiene cuatro pilares: rol, contexto, constraints técnicas y formato de salida. Una estructura para copiar y adaptar:

• Persona del sistema: suba el listón. Por ejemplo: «Actúa como ingeniero senior de React, especializado en Next.js App Router, TypeScript y arquitectura de componentes limpia».
• Contexto: explique el entorno. «El proyecto usa Tailwind para estilos, Zustand para state global y TanStack Query para datos de servidor».
• Constraints estrictas: liste lo que hay que evitar. «No instales dependencias NPM. Usa hooks nativos de React. No escribas archivos CSS: solo utility classes inline».
• Formato de salida: defina la respuesta. «Devuelve solo el snippet TypeScript completo en un bloque markdown. Sin intro ni explicaciones».

2. Técnicas avanzadas de prompt engineering, con ejemplos

Prompts estructurados suben precisión y fiabilidad del código. Tres patrones que funcionan:

• Few-shot: dé al modelo 1 o 2 ejemplos de código bueno de su proyecto. Así copia convenciones de nombres, formato e imports.
• Chain of Thought (CoT): obligue al LLM a escribir un plan técnico antes de generar código. «Paso 1: delinea el flujo de state. Paso 2: lista edge cases (vacío, loading). Paso 3: escribe el componente TypeScript que implementa el plan».
• Inyección del system prompt: meta reglas de código en el system prompt del IDE (Cursor, VS Code) para aplicarlas siempre. Evita clásicos: APIs deprecadas o CSS heredado.

3. Plantillas de prompt para el desarrollo diario

Tres prompts que uso para acelerar arquitectura frontend y tests:

• Para refactor: «Analiza este componente React en busca de memory leaks, re-renders de más y legibilidad. Refactóralo con React.memo o useMemo donde toque, convierte bucles anidados en un lookup plano y devuelve TypeScript limpio».
• Para tests unitarios: «Actúa como ingeniero de QA automation. Escribe tests unitarios completos para este componente React con Vitest y React Testing Library. Cubre clics típicos, errores de API, spinners de loading y accesibilidad (aria-attributes)».
• Para conversión de esquema: «Convierte este esquema SQL en un schema Prisma de TypeScript y el Zod correspondiente. Tipa todos los campos y añade mensajes de error de validación a medida».

Conclusión: mejores productos, más rápido

El prompt engineering es una skill de base para el desarrollador de ahora. Si estructura contexto, constraints e instrucciones, el LLM extiende su capacidad. La IA pone los cimientos; verificar, auditar rendimiento e integrar sigue siendo del senior. Meta estas técnicas hoy en sus proyectos Next.js y Web3.