Lista de verificación de flujo de trabajo con IA para desarrolladores

Un flujo de trabajo fiable con IA no es un solo prompt. Es un bucle repetible: define la tarea, proporciona contexto seguro, pide una salida verificable, comprueba el resultado y conserva un registro de la evidencia.

1. Define la tarea

Escribe la tarea en una frase antes de abrir la herramienta de IA.

Formas de tarea útiles:

• Explica este error y enumera causas probables.
• Redacta pruebas para este comportamiento.
• Compara dos opciones de implementación.
• Refactoriza esta función sin cambiar su contrato público.
• Resume estas notas en requisitos.

Evita prompts amplios de delegación como Build the whole feature a menos que un agente tenga archivos, restricciones y comprobaciones claras.

2. Prepara contexto seguro

Incluye solo el contexto necesario para la tarea:

• Código, logs, documentación o requisitos relevantes.
• Comportamiento esperado y comportamiento actual.
• Restricciones que no deben cambiar.
• Comandos, pruebas o ejemplos existentes.

Elimina secretos, datos privados de clientes, estrategia interna y código fuente que no deba salir de tu entorno.

3. Pide una salida verificable

Haz que la respuesta sea fácil de revisar:

Return:
1. Short diagnosis.
2. Recommended change.
3. Risks and assumptions.
4. Verification steps.

Para trabajo estructurado, pide JSON, tablas Markdown, SQL, casos de prueba o una explicación del tamaño de un parche. Cuanto más concreto sea el formato, más fácil será inspeccionar.

4. Verifica antes de confiar

Usa la evidencia adecuada:

• Código: ejecutar pruebas, comprobaciones de tipos, linting y revisión manual.
• Detalles de API o biblioteca: consultar documentación oficial.
• Trabajo sensible a la seguridad: usar referencias de confianza y política del equipo.
• Contenido: comprobar material fuente, tono, afirmaciones y permisos.
• Transformaciones de datos: comparar entrada y salida de ejemplo.

Si la respuesta no puede verificarse, trátala como una idea, no como un resultado.

5. Registra lo ocurrido

Para trabajo importante, deja una nota breve:

AI assisted with: [task]
Verified by: [docs, tests, command, review]
Remaining risk: [known limitation]

Esto ayuda a futuros revisores a entender dónde se aplicó el criterio humano.

Patrones de fallo comunes

• El prompt oculta la restricción más importante.
• El asistente cambia el comportamiento mientras afirma que solo refactorizó.
• La respuesta cita hechos precisos sin fuentes.
• La tarea incluye datos sensibles que deberían haberse redactado.
• El paso de verificación es vago, falta o es imposible de ejecutar.

Conclusión final

Usa la IA como un colaborador rápido dentro de un flujo de trabajo de ingeniería. Mantén la responsabilidad del contexto, la privacidad, la revisión y la evidencia.