Prompts para Developers: Guía Práctica por Fase de Trabajo
Un buen prompt ahorra horas. Uno malo te manda en la dirección equivocada. Aquí tienes una selección organizada por etapas del flujo de desarrollo, con ejemplos que puedes copiar y adaptar a tu stack.
Ideación y planeación
En la fase de descubrimiento, los LLMs pueden sintetizar requisitos ambiguos en user stories claras, generar matrices de priorización y proponer arquitecturas iniciales. Lo importante es dar contexto suficiente: describe el dominio, las restricciones técnicas y el perfil de usuario. Sin contexto, las respuestas son genéricas.
- "Actúa como product manager. Dado este contexto [X], genera 5 user stories con criterios de aceptación."
- "Analiza estos requisitos y sugiere una arquitectura de componentes React con responsabilidades claras."
- "Genera una matriz de esfuerzo vs impacto para estas 10 features."
Coding asistido
Los prompts más efectivos para implementación incluyen el contexto del código existente y definen estándares claros. En vez de pedir "escríbeme un componente", prueba con "dado este patrón [X] y estas restricciones [Y], genera un componente que siga la misma convención". La diferencia en calidad de respuesta es enorme.
- "Refactoriza esta función para seguir el patrón repository. Mantén la interfaz pública."
- "Genera tests unitarios para esta función con edge cases: null, vacío, y datos malformados."
- "Revisa este PR y sugiere mejoras de legibilidad, naming y performance."
Debugging y troubleshooting
Aquí es donde los LLMs más brillan si les das la información correcta. Incluye siempre: el error completo, el contexto del stack (versiones, runtime), y lo que ya intentaste. Esto reduce idas y vueltas y te da respuestas más útiles desde el primer intento.
"El mejor prompt de debug incluye el error, el contexto y lo que ya descartaste."
Documentación y comunicación
Automatiza la generación de READMEs, changelogs y ADRs (Architecture Decision Records). El truco que mejor funciona es dar un ejemplo del formato que quieres y pedir que lo replique para tu contexto. Así mantienes el tono y la estructura consistentes en todo el proyecto.
- "Genera un ADR para la decisión de migrar de REST a GraphQL con pros, contras y alternativas evaluadas."
- "Escribe un changelog profesional para esta lista de commits siguiendo Keep a Changelog."
- "Documenta esta API endpoint siguiendo OpenAPI 3.0 con ejemplos de request/response."
Checklist accionable
- Crea un repositorio interno de prompts organizados por fase del flujo.
- Define estándares para QA asistido: qué revisar y qué no delegar.
- Mide impacto en tiempos de entrega antes y después de usar prompts estructurados.
- Comparte los mejores prompts en retrospectivas de equipo.
- Versiona los prompts como código: iteración constante.