Playbook de ingeniería de prompts para programadores

• Los asistentes de codificación con IA no pueden conocer por sí solos la intención del proyecto, así que la calidad del resultado cambia mucho según qué tan bien el desarrollador proporcione contexto, objetivos y ejemplos
• En depuración, en lugar de solo lanzar el código y el error, conviene incluir el comportamiento esperado, el comportamiento real y el entorno de ejecución, además de acotar el problema con un rastreo línea por línea o un ejemplo mínimo reproducible
• El refactor y la optimización no deben pedirse como “hazlo mejor”, sino con criterios de éxito claros como eliminar duplicación, procesamiento en paralelo, mantener el manejo de errores o restricciones de versión
• Para implementar nuevas funciones, es más seguro dividir el trabajo en pasos pequeños —plan, estructura base, manejo de estado, integración de API y casos límite— e ir revisando y ampliando poco a poco en vez de encargar todo de una sola vez
• Las preguntas ambiguas, las solicitudes excesivas, volcar código sin una pregunta concreta y las referencias poco claras afectan el resultado; la IA debe tratarse más como un programador en pareja conversacional e iterativo que como un generador de una sola vez

---

Principios básicos para usar bien los asistentes de codificación con IA

• Los asistentes de codificación con IA pueden ayudar con autocompletado de funciones, sugerencias para corregir bugs e incluso la creación de módulos o MVP, pero la intención específica del proyecto depende de la información que proporcione el usuario
• Un buen prompt trata a la IA como una “colaboradora que interpreta todo literalmente” y guía con claridad el resultado y el formato deseados
• Los principios básicos son los siguientes
  • Proporcionar contexto abundante: incluir lenguaje, framework, librerías, funciones relacionadas o fragmentos de código, mensajes de error exactos y comportamiento esperado
  • Especificar el objetivo: en vez de “¿por qué no funciona?”, acotar la pregunta como “por qué esta función de JavaScript devuelve undefined en lugar del valor esperado y cómo corregirla”
  • Descomponer tareas complejas: no pedir una función grande de una sola vez, sino avanzar secuencialmente, por ejemplo creando la estructura de un componente de React, agregando manejo de estado e integrando llamadas a API
  • Dar ejemplos de entrada y salida: ejemplos como que la entrada [3,1,4] debe devolver [1,3,4] reducen la ambigüedad de los requisitos
  • Asignar un rol: dar un rol como “senior React developer”, “JavaScript performance expert” o “code reviewer” puede ajustar la profundidad y el estilo de la respuesta
  • Iterar y corregir: si la primera respuesta no encaja, se puede redirigir con solicitudes posteriores como usar un bucle en vez de recursión, mejorar nombres de variables o agregar comentarios
  • Mantener claridad en el código: nombres de funciones y variables con significado, formato consistente, comentarios y docstrings ayudan a la IA a entender la intención del código

Patrones de prompts para depuración

• Una solicitud de depuración debe incluir qué se supone que hace el código, qué está fallando realmente y qué error ocurre
• Un buen prompt de depuración suele incluir la siguiente información
  • Lenguaje usado y entorno de ejecución
  • Código con el problema
  • Mensaje de error exacto o salida incorrecta
  • Salida esperada
  • Entrada de ejemplo
  • Métodos que ya se intentaron
• En bugs lógicos complejos, se le puede pedir a la IA un rastreo de ejecución línea por línea para seguir los cambios de estado
  • Ejemplo: “Rastrea cómo cambia el valor de total en cada paso de esta función y encuentra dónde se acumula mal”
• Aunque el codebase sea grande, si puedes crear un fragmento pequeño que reproduzca el bug, conviene presentarlo como ejemplo mínimo reproducible
• Si la primera respuesta solo resulta útil en parte, puedes continuar con preguntas de seguimiento como “muéstrame el código corregido” o “explícame por qué este cambio resuelve el problema”

Ejemplo de depuración: pregunta ambigua y pregunta mejorada

• El código de ejemplo es una función de Node.js/JavaScript mapUsersById(users) que intenta convertir un arreglo de usuarios en un objeto basado en ID
• El bug es `for (let i = 0; i